codex-style1.1.1

Codex Style

这个 Pi 扩展提供任务 Todo 清单、/init 项目指南生成、持久化 Goal、中文工作提示、严格 Tab 消息队列、Enter steering 消息、Windows 上使用 Niubash 执行 Bash，以及基于 pi-subagents 的 subagent 和 teammate 协作。Token 和上下文用量由 Pi 原生状态栏显示；扩展不再添加重复的累计用量、缓存或费用状态。只加载 token-usage.ts，它会注册其余内部功能。

Codex Todo 清单

对于复杂的多步骤任务，agent 会使用 update_plan 维护有序步骤，状态为 pending、in_progress 或 completed，并将当前清单注入后续回合的上下文。每次更新提交完整清单，同一时刻最多一个进行中的步骤。清单按会话分支持久化，TUI 状态栏显示进度。

用户可以运行 /plan 或 /todos 查看清单，运行 /plan clear 清除。此清单用于当前任务的执行步骤，与跨回合持续目标 /goal 分开。

/init 项目指南

运行 /init 会让 agent 检查当前项目并创建 200–400 词的 AGENTS.md，内容包括项目结构、开发与测试命令、代码风格和提交规范。提示明确要求先检查当前工作目录；如果 AGENTS.md 已存在，不得覆盖或修改。任务繁忙时，初始化请求会排在当前任务之后。

Subagent 与 teammate 协作

安装并启用 Pi 扩展 pi-subagents 后，模型可使用 delegate 将一个有界任务交给指定 agent，或使用 team 并行启动 2–4 个不同职责的 agent。delegate 支持可选的 model 参数，为本次运行覆盖模型；team 的每个成员也可单独指定 model。建议使用 provider/model，例如 openai-codex/gpt-5.6-luna；不指定时沿用 pi-subagents 为该 agent 配置的模型。Team workflow 最长运行 15 分钟；每名成员完成后，其最多 3000 字符的发现会作为 follow-up 发给仍在运行的队友。工具返回后台 run 回执，最终结果由 pi-subagents 的原生完成通知交还；agent 名称和执行能力仍由 pi-subagents 配置及 Pi 权限控制。

{
  "packages": ["npm:pi-subagents", "npm:codex-style"]
}

Token 和上下文用量

使用 Pi 原生状态栏的 token 与上下文指标；扩展不重复显示累计 token、缓存用量或费用。

中文工作状态

模型工作或思考时，扩展会隐藏 Pi 默认的 Working 状态，随机显示并轮换 D:\Downloads\claude-code-zh-cn-main\verbs\zh-CN.json 中的 verbs。默认每 1.6 秒轮换一次，并避免连续显示同一项。

可以用 PI_WORKING_VERBS_FILE 指定其他 JSON 文件。文件格式为：

{
  "mode": "replace",
  "verbs": ["架构中", "推敲中", "生成中"]
}

文件读取失败或列表为空时使用内置中文状态作为 fallback。

Niubash Bash 工具

Windows 上，扩展仅替换 Pi 的 bash 工具执行后端，命令通过 Niubash 的 niu.exe -c 运行；输入参数、输出截断、超时和取消仍使用 Pi 原生 Bash 工具实现。Pi 的 read、edit、write、grep、find、ls、PowerShell 等原生工具不受影响。扩展优先使用 NIU_SHELL 指向的可执行文件，其次在 PATH 中查找 niu.exe；找不到时 Bash 调用会返回明确错误。非 Windows 系统保留 Pi 原生 Bash。

Enter Steering 消息

模型处理任务期间，在编辑器输入普通消息并按 Enter，会按 Pi 原生 steering 行为发送给当前任务处理，不会改排到当前任务结束后的 follow-up 队列。图片和提示模板展开会保留；斜杠命令与空消息继续按 Pi 原有规则处理。

严格 Tab 消息队列

普通消息在编辑器中按 Tab 会进入严格队列；只有上一条消息对应的整个模型任务完全结束后才发送下一条，单个命令或工具执行结束不会提前触发下一条，队列消息不会并发触发多个回合。空输入和以 / 开头的命令保留 Pi 原有行为，因此命令仍可使用 Pi 的 Tab 补全。

队列显示在编辑器上方，支持鼠标 [编辑]、[删除]，也可以使用：

/queue
/queue edit
/queue delete
/queue clear

Claude Sonnet 5.5 和 BLCC Opus 5.5 兼容

对于 api 为 anthropic-messages 的 claude-sonnet-5-5，扩展会修正旧版或自定义模型条目生成的 thinking 参数。BLCC 的 claude-opus-5-5 也会修正，但仅限 provider 为 blcc 的模型条目。启用式 thinking.type: "enabled" 会转换为 Anthropic 接受的 adaptive，关闭式 thinking 字段会省略。已经是 adaptive、between_tools 或未设置 thinking 的请求保持不变；其他模型、provider 和 API 不受影响。

持久化 Goal

直接使用 /goal <objective> 创建并立即开始目标；预算可以放在目标文本中：

/goal 完成插件功能并运行测试 --budget 50000

命令补全会提供保留子命令和预算值；自由格式目标不会被补全吞掉。完整命令如下：

/goal <objective> [--budget N]
/goal start [--budget N] <objective>
/goal status
/goal pause
/goal resume
/goal budget <N|none>
/goal complete
/goal clear
/goal help

模型也可以使用 create_goal、get_goal、update_goal 工具。目标状态、累计 tokens 和预算保存在 Pi 会话分支中；达到预算后会停止自动续做。单次用户请求最多自动续做 8 次，之后可继续发消息或运行 /goal resume。

安装

推荐通过 npm 安装（需要 Pi 1.4.0 或更高版本）：

pi install npm:codex-style

安装后重启 Pi，或在运行中的会话执行 /reload。npm 安装和手动复制是两种互斥方式；使用 npm 包时，请删除 ~/.pi/agent/extensions/token-usage.ts 及其对应的 internal/ 副本，否则同一组工具会被注册两次。

如需手动安装，请将以下文件保持相对路径放入用户扩展目录 ~/.pi/agent/extensions/：

token-usage.ts
internal/goal-feature.ts
internal/init-feature.ts
internal/todo-feature.ts
internal/working-verb.ts
internal/background-task-queue.ts
internal/niubash-feature.ts
internal/subagent-team-feature.ts
internal/strict-message-queue.ts
internal/sonnet-compat-feature.ts

也可以在项目目录中显式加载：

pi --extension ./token-usage.ts

token-usage.ts 使用 Pi 自带的扩展接口；不需要额外安装依赖。

测试

node --experimental-strip-types tests/working-verb.test.ts
node --experimental-strip-types tests/background-task-queue.test.ts
node --experimental-strip-types tests/entrypoint-registration.test.ts
node --experimental-strip-types tests/strict-message-queue.test.ts
node --experimental-strip-types tests/goal-command.test.ts
node --experimental-strip-types tests/init-command.test.ts
node --experimental-strip-types tests/todo-feature.test.ts
node --experimental-strip-types tests/sonnet-compat.test.ts
node --experimental-strip-types tests/niubash-feature.test.ts
node --experimental-strip-types tests/subagent-team-feature.test.ts