pi install git:github.com/eachann1024/pi-mini-mode

这张已有截图展示页脚配置，不代表新增图片、折叠与子代理功能的当前界面。设置预览使用示例数据。

首次进入交互式 TUI 会话时，Pi Mini Mode 显示设置预览。「仅显示分支」「缓存 token」「MCP」默认关闭；「仅显示分支」与「项目与分支」互斥。之后可用 /pi-mini-mode-settings 再改。

以下示例开启了可选的 Cached 和 MCP 字段：

deepseek-v4-flash  high  Total 45K  Cached 25K  CH 40.0%  $0.012  ◇ MCP 3  500/1.0M  ⣿⣀⣀⣀⣀⣀⣀⣀⣀⣀  1%  120 tok/s

首次设置会提供 保留默认、打开浏览器设置 和 应用推荐配置。保留默认值会保存默认字段选择、保持极简输出开启，并且不再显示首次设置提示；立即配置会直接在浏览器中打开 HTML 设置页。应用推荐配置会让你选择内置的 cc-dark 或 cc-light 主题，通过 Pi 官方设置 API 保存该主题和全局 tuiMode=fullscreen，立即应用主题，并提示重启 Pi（全屏渲染器在启动时决定）。项目设置和命令行参数可能覆盖全局设置。按 Esc／取消不会完成首次设置，下次交互式会话会再次提示。Print、JSON 等非交互模式不会显示提示。

设置保存在 Pi 的 agent 目录中，通常是 ~/.pi/agent/pi-mini-mode.json；如果 Pi 使用其他配置目录，则保存在对应目录。文件缺失或格式错误时会安全回退到默认设置。设置示例：

{
  "pi-mini-mode-project-branch-show": true,
  "pi-mini-mode-branch-show": false,
  "pi-mini-mode-model-show": true,
  "pi-mini-mode-thinking-show": true,
  "pi-mini-mode-ch-show": true,
  "pi-mini-mode-session-tokens-show": true,
  "pi-mini-mode-cache-tokens-show": false,
  "pi-mini-mode-cache-miss-show": true,
  "pi-mini-mode-cost-show": true,
  "pi-mini-mode-mcp-show": false,
  "pi-mini-mode-context-show": true,
  "pi-mini-mode-context-dots-show": true,
  "pi-mini-mode-context-percent-show": true,
  "pi-mini-mode-speed-show": true,
  "pi-mini-mode-speed-unit-show": true,
  "pi-mini-mode-minimal-show": true,
  "pi-mini-mode-input-enhancements": true,
  "onboardingCompleted": true
}

生成速度设置中的 显示 tok/s 单位 是 显示最新生成速度 下方的缩进子设置。关闭它只会移除 tok/s，保留速度数字；即使隐藏生成速度，该子设置仍会保留。

设置命令需要 Pi 交互会话，并在浏览器中打开设置页。修改会自动保存，并在当前渲染器支持时立即生效。选中预览字段后按左右方向键，或拖拽字段，可调整状态栏顺序。预览使用固定示例数据，费用为估算值。恢复默认会重置功能开关、图片预览方式、字段显示与排序。

会话总量来自当前会话分支中每一条已完成的 assistant 和 toolResult 记录。工具报告的嵌套 LLM 工作（例如子 Agent）会准确计入一次。若 provider 提供 totalTokens，Total 使用该值；较旧或自定义结果没有该字段时，则使用输入、输出、缓存读取和缓存写入令牌之和。Cached 是缓存读取与写入之和（包含在 Total 中）；CH 是缓存读取量除以输入量与缓存读取量之和。只有已持久化的最终用量会计入，因此流式更新不会重复累计。

助手生成过程中，页脚显示最近一秒的解码速度，每 500ms 刷新一次。provider 的 usage.output 在前进时作为 token 数；如果这个样本不再增长、正文仍在流出，速度改为跟随已流出的文本，而不是停在过期的累计值上。助手消息结束后，指示器切换为本轮平均速度（输出 token 除以第一个输出 token 之后的时间，不含首字等待）。鼠标悬停在指示器上会在状态栏上方打开一块浮动面板，显示平均速度、生成过程中的实时速度、首字吐字时间，以及 provider 实际报告的用量；没有的指标不会编造。之后的助手消息如果只是调用工具或等待输出，完成时的平均速度会保留，直到新回复产生实时速度。嵌套工具里的 LLM 用量不会覆盖已测量的主回复速度；只有还没有任何速度时，嵌套完成才能写入页脚。过短或单 token 突发不显示，避免虚高的 tok/s。倒退的输出样本和不递增的时间戳会被忽略。

在获得可测量响应前，速度字段完全不显示，不会出现 -- tok/s 占位符。速度位于页脚最右侧；启用上下文百分比时，百分比紧邻其左侧。颜色遵循 Pi 主题语义：至少 30 tok/s 为成功色，10–29.9 tok/s 为警告色，低于 10 tok/s 为错误色。费用是基于当前分支已完成用量和配置的每百万令牌费率得出的估算，并非 provider 账单。窄终端中，页脚会丢弃或截断优先级较低的内容，确保保持单行且不溢出。

开发时只安装本地副本；同时安装 npm 版本和本地版本会导致扩展重复注册：

pi remove npm:@each1024/pi-mini-mode && pi install /path/to/pi-mini-mode
npm run check
npm run check:syntax

修改源码后，在已打开的 Pi 会话中运行 /reload。npm run check 检查扩展与 lib 中的全部 TypeScript，包含未使用声明和参数；npm run check:syntax 只解析检查脚本、维护脚本及设置页的 JavaScript，不执行检查脚本。

需要定位具体回归时，先用 npm run check:focused -- --list 列出已有检查，再指定一个名称，例如 npm run check:focused -- settings-web。npm test 使用相同入口，必须指定名称，不再默认执行全量套件。test/minimal-pty.py 保留供明确要求的终端问题调查使用。

开发依赖 @earendil-works/pi-server 是 Pi 0.85.0 的实验性模块间接导入所需，上游该版本漏写了依赖声明；升级 Pi 并确认上游修复后才能移除。

推到 main（含 PR 合并）且 extensions/、lib/、themes/、package.json 或 lockfile 有变化时，.github/workflows/publish.yml 自动发布：package.json 版本高于 npm 已发布的最高版本就用它，否则在最高版本上末位 +1，发布 npm 后把版本号以 [skip ci] 提交回 main，并创建同名标签和 GitHub Release。只改文档或 CI 不发布；同一版本不会重复发布。Pi 插件目录从 npm 收录，无需另外上传。

npm 认证优先使用指向本仓库 publish.yml 的 Trusted Publisher（OIDC）；也可配置仓库 Secret NPM_TOKEN。