codex-text-control

上图是 0.5.5 的历史视觉基线；0.5.9 的画布已改为一个连续 Markdown 文本流，可一次全选、复制和修改，表格不再拆成单元格或逐行输入框。0.5.7 在真实 Codex 中完成了“编辑 -> 原文检查 -> 确认提交”闭环；0.5.9 还保留 0.5.8 的跨进程原子状态转换和原文保真能力，真实宿主复验仍需重新安装。

Codex Text Control 是一个本地 Codex 插件。它不改写已经显示的聊天消息，而是在项目内维护一份后续对话优先读取的权威 Markdown（轻量标记文本格式）。用户在一个连续正文编辑器里直接删、增、改整份文字和表格 Markdown；编辑期间不写盘，只有检查完整原文并点击“确认提交”后，才生成一个不可变修订并更新权威指针。

当前状态：0.5.9 公开预发布版。 0.5.7 已在当前 Windows Codex 桌面宿主完成核心点击闭环；0.5.9 的自动化、跨进程并发、原文保真和连续正文交互检查已通过，但尚未重新安装进真实宿主。项目也还没有跨平台真实宿主结果或外部权威能力基准，因此这里不声称“生产可用”“领先同类”或“任何环境都能安装”。

为什么需要它

长对话里，同一条要求常常被重复解释、修正和补充。继续靠聊天追加会产生三个问题：最新版散落在多条消息里、表格很难精确改、模型为了保持上下文又会重复旧内容。

这个插件把“讨论”和“最终采用的上下文”分开：

1. Codex 把可继续采用或修改的结论稿放进画布。

2. 用户直接修改文字、表格或 Markdown 源码。

3. “完成编辑”先显示即将提交的完整原文，不立即保存。

4. “返回修改”保留草稿；“确认提交”才保存一个新版本。

5. 对话只收到版本号，后续回答再从项目文件读取全文。

结果是聊天保持简洁，项目仍有可检查、可恢复的完整上下文历史。

Related MCP server: story-mcp

快速开始

在 Codex 中使用

对 Codex 说：

打开当前权威上下文画布

然后完成一次闭环：

1. 在“画布”里直接修改连续正文，Markdown 表格也按原文编辑；复杂 Markdown 可以切到“源码”。

2. 点击“完成编辑”。

3. 在弹窗中检查即将提交的完整原文。

4. 需要继续修改就点“返回修改”；确认无误后点“确认提交”。

5. 对话收到 【上下文画布已更新】 和版本号后，插件规则会要求 Codex 重新读取最新版。

编辑、停顿和中文输入法组合期间不会生成中间修订。没有实际修改时，也不会为了点击按钮制造重复版本。

从源码验证

当前公开仓库提供源码、可复现检查和 GitHub 预发布版，但尚未提供一键安装入口：

git clone https://github.com/wendelxia/codex-text-control.git
Set-Location codex-text-control
npm ci --ignore-scripts
npm run quality
npm run verify:candidate

• npm ci --ignore-scripts：使用 npm（Node 包管理器）严格按锁文件安装依赖，并禁用依赖安装脚本。

• npm run quality：运行自动测试、JavaScript 语法检查和 MCP（模型上下文协议）闭环探针。

• npm run verify:candidate：在质量检查之外，连接 npm 官方注册表检查生产依赖已知漏洞、包签名和来源证明。

已配置本机 personal 插件市场的开发者，可以安装当前本地构建：

codex plugin add codex-text-control@personal

这条命令依赖本机个人市场配置，不是公开安装方式。

核心能力

触发范围

会打开画布的典型表达：

直接改上下文
修改这个表格
我来改下
把讨论结果整理成可继续采用的方案

下面这些保持普通对话，不自动弹出画布：

继续
解释一下
重启了
把代码写进文件

判断依据不是回复里有没有表格或编号，而是完整最终回复是否将成为后续要采用或继续修改的上下文。工作过程中的进度、命令输出、日志和报错始终不触发。

数据与边界

.codex-text-control/
  authority-anchor.json  不可变的权威状态起点
  transitions/           每个权威状态最多一个后继转换
  state-proofs/          证明检查点属于权威状态链
  committed-revisions/   防止已提交修订编号被再次复用
  visible-revisions/     只向历史列表发布成功或显式保存的修订
  content-index/         按正文指纹定位修订，避免反复扫描历史
  revisions/             不可变完整 Markdown 快照
  current.json           兼容旧版本的可重建缓存

相同正文会复用已有修订，避免超时重试制造重复文件；并发失败候选不会出现在用户版本历史。载入历史版本只会把内容放回画布；再次确认后才生成新修订。卸载插件不会自动删除项目数据。

工作原理

Codex 读取当前权威上下文
  -> 打开项目绑定的画布
  -> 用户修改文字、表格或源码
  -> 完成编辑并检查完整原文
  -> 用户确认提交
  -> 保存 revisions/<id>.json
  -> 排他发布 transitions/<state>.json
  -> 从 current.json 的链上检查点继续读取；缺失时从锚点恢复
  -> 尽力刷新兼容用 current.json
  -> 对话只收到版本号
  -> 后续回答重新读取当前权威内容

写工具标记为 app-only（仅应用可调用），模型可以读取和打开画布，但不能绕过用户确认直接保存。正文只通过 textContent 或表单 value 进入页面，不作为 HTML（网页标记语言）执行；Widget（小组件）的内容安全策略不允许外部网络、外部资源或嵌套页面。

项目结构

验证现状

以下是内部工程验证，不是外部权威基准：

最新真实宿主提交版本为 rev-1788249723947-c7d6a499，对应 0.5.7。0.5.9 的连续正文结果见 0.5.9 验证记录，底层并发失败复现、修复和原文保真结果见 0.5.8 验证记录。当前缺少适用于“Codex 上下文画布”的外部权威能力基准，因此不能用 GitHub 星数、同类项目知名度或内部测试数量声称能力领先。

已知限制

• 不能原地修改已经显示的历史消息，只能维护后续优先读取的权威上下文。

• 未点击“确认提交”就关闭画布时，当前本地草稿不会写入版本历史，也不承诺恢复。

• 没有逐行差异视图、公开安全联系人或跨平台真实宿主证据；不可变状态转换不是跨机器分布式事务，网络文件系统语义尚未验证。

• 项目目录依赖 Codex 提供当前工作区；缺少目录时会明确拒绝，不会猜测或退回插件安装缓存。

• 当前只适合从源码或 GitHub 预发布快照继续验证；公开预发布不等于已经达到稳定发行或生产可用。

文档导航

贡献与许可证

提交变更前请先运行 npm run quality 和 npm run verify:candidate，并按 CONTRIBUTING.md 记录已证实、未证实、失败项、限制和回退方法。

项目使用 MIT 许可证，另有中文说明。第三方依赖与许可证说明见 THIRD_PARTY_NOTICES.md。

客观评价：这个项目已经从“聊天里再复制一份全文”走到可实际点击的项目级上下文画布；并发覆盖和非目标全文重排也有失败复现与回归测试。公开源码、持续集成和预发布入口已经建立，但距离成熟公开项目仍差 0.5.9 真实宿主复验、公开一键安装、陌生用户复现、跨平台真实宿主结果和外部基准。README（仓库首页说明）只按证据说明当前阶段，不把文档完整度冒充产品成熟度。