pi-working

把 pi 运行时的状态指示器翻译为中文（可切英文）， 并细分出 pi 原生未区分的三个阶段：请求中 / 响应中 / 执行中。

状态机

pi 的运行阶段	状态文案（中文，默认）	状态文案（英文）
运行中，尚未归入具体阶段	工作中…	Working…
已发出模型请求，尚未收到首个 token	请求中…	Requesting…
已收到首个 token，正在流式生成	响应中…	Responding…
正在执行工具 / 命令等非模型工作	执行中…	Executing…

迁移顺序：

agent_start                 → 工作中
before_provider_request     → 请求中      ← 已请求模型
message_update(首个 token)  → 响应中      ← text/thinking/toolcall 的首个 delta
tool_execution_start        → 执行中      ← 调用工具、命令等非模型工作
before_provider_request     → 请求中      ← 工具结果回填后再次请求
agent_settled               → 清除

判断"首个 token"依据的是 pi 的 AssistantMessageEvent：text_delta、thinking_delta、 toolcall_start 三者之一首次出现，即认为模型已开始响应。

安装

从 npm

pi install npm:@falling-ts/pi-working

从 git

pi install git:github.com/falling-ts/pi-working

软链接（本机开发）

New-Item -ItemType SymbolicLink `
  -Path "$env:USERPROFILE\.pi\agent\extensions\pi-working" `
  -Target "D:\AI\pi-s\pi-working"

单次试用（不写入配置）：

pi -e npm:@falling-ts/pi-working

卸载：pi remove npm:@falling-ts/pi-working（或对应的 git 源）。

语言切换

环境变量 PI_WORKING_LANG：

值	行为
未设置 / 其它值	中文（默认）
en	英文

$env:PI_WORKING_LANG="en"; pi     # 英文
Remove-Item Env:\PI_WORKING_LANG  # 恢复默认中文

PI_WORKING_LANG=en pi             # 英文

命令

命令	作用
/working	显示当前语言与阶段
/working request	预览"请求中"（其余可选：working respond execute clear）
/working clear	清除指示器

已知限制（上游硬编码）

pi 的部分状态文案硬编码在 TUI 组件里，扩展没有对应 API 可改。本扩展只改「工作指示器」 那一行（ctx.ui.setWorkingMessage()），影响范围如下：

pi 的状态	能否改造	说明
Working	✅ 可改	本扩展的主战场
Compacting context… / Auto-compacting… / Context overflow detected…	❌ 不可改	CompactionStatusIndicator 硬编码；且其 kind 不是 working，setWorkingMessage 也影响不到它
Retrying (1/3) in 5s…	❌ 不可改	RetryStatusIndicator 硬编码，且扩展层没有暴露重试事件，无法监听
Summarizing branch…	❌ 不可改	BranchSummaryStatusIndicator 硬编码，同样无事件

为什么不用 footer 兜底：pi 内核自身从不往 footer 写文字（setExtensionStatus 在内核中只有扩展通道一处调用）， 该通道专供扩展。用它补中文只会在屏幕最下方多出一行与工作指示器重复的内容， 而且替换不掉 pi 自己的英文行 —— 净负面，因此本扩展刻意不介入压缩、重试、分支摘要。

此外：

• RPC 模式下 setWorkingMessage 是 no-op（上游注释：需要 TUI loader 访问权），本扩展仅在 TUI 模式生效。
• print / JSON 模式没有 UI，指示器自然不显示，但状态机逻辑照常运行（可用于 /working 排错）。

pi 包规范

• package.json 用 pi.extensions 显式声明入口；
• 宿主包 @earendil-works/pi-coding-agent 只出现在 peerDependencies（">=1.3.0"，即不低于上游最新发布），不得放进 dependencies；
• keywords 含 pi-package，满足 Pi 包画廊 收录条件。

发布为 scoped 包 @falling-ts/pi-working，公开包需带 publishConfig.access: "public"。 发布命令（本机默认 registry 是淘宝镜像，必须显式指定 npmjs）：

npm publish --registry=https://registry.npmjs.org/

License

MIT