工作状态行动态ccch1mneyyy/working-activity

working-activity

让 agent 的“工作状态行”活过来——实时工具动态与进度、俏皮文案、模型自述、上下文预警。同一套想法，适配两个平台：pi CLI 与 DeepSeek Harness（DSH）。

作者：chimney（@ccch1mneyyy）。社区出品，非官方项目。

本仓库分为 pi 和 dsh 两个版本，两个 npm 包继续独立发布，各自的安装方式不变。

平台一览

| 平台 | npm 包 | 源码位置 | 安装 |
|---|---|---|---|
| pi CLI | pi-working-activity | extensions/ | pi install npm:pi-working-activity |
| DeepSeek Harness | dsh-working-activity | packages/activity/working-activity/ | dsh plugin --profile  add dsh-working-activity |

目录结构

extensions/                             pi 版扩展（唯一源码，无构建）
tests/                                  pi 版测试
package.json                            pi 版包（发布 pi-working-activity）
packages/activity/working-activity/     DSH 版插件（发布 dsh-working-activity）
patches/webui-working-activity.patch    DSH Web UI runtime 补丁
docs/dsh-working-activity.md            DSH 版完整文档（原 dsh 仓库 README）

pi 版

让 pi 的 Working 行活过来——实时工具动态与进度 + 俏皮中文文案 + 稀有彩虹彩蛋 + 模型自述 + 上下文预警。

功能一览

🛠 真实工具活动
监听 tool_execution_start / tool_execution_end，Working 行实时显示正在跑什么——不是假转圈。

翻翻 src/index.ts
改改 package.json
跑命令 npm run build
搜搜 NARRATE_MIN_MS

📈 实时工具进度
监听 tool_execution_update，优先读取工具返回的百分比、阶段和状态；对 bash 等流式输出，也会识别常见的下载、构建、测试和部署进度。

拉取模型权重 · 42% · 8s
跑命令 npm test · Testing integration · 12s
部署一下 staging · Deploying assets · 31s

普通输出不会直接塞进 Working 行，只有结构化进度、百分比和可识别阶段会展示。

⏩ 快工具队列重播
执行时间  嗯…让我捋捋 → 盘一下盘一下 → 大脑转起来了 → 思考.gif → 啾，让我想想 → lol → 别催别催

想太久了自动换档：
- 🕐 30s：转圈圈… 马上马上 嗯，让我细想想
- 🕑 1min：还在努力… 烧脑中… 这题有点东西
- 🕒 5min：还没放弃… 这题真的硬… 我给跪了…

🎰 稀有彩虹彩蛋
约 1/150 概率（每 6–7 分钟一次），Working 行炸出炫彩流光，停留 7.5 秒。

✦ S S R ！ ✦   ✧ 金色传说 ✧   ✶ 你发现我了 ✶

四层特效叠加：平滑色相梯度慢滚 + 亮度波浪呼吸 + 一道带下划线的高光从左扫到右 + 两侧金边花饰轮转。比 1.0 的均匀彩虹有质感得多。

⏵ 模型自述
默认开启。扩展通过 context 事件向模型注入一条约定：每个步骤开始时写 ⏵ 你在做什么（≤20 字）。扩展实时解析流式输出，把自述显示在 Working 行。不需要可在配置里设 "narrate": false 或 /activity narrate off。

⏵ 查一下报错原因        →  Working 行：查一下报错原因 · 搜搜 error.log
⏵ 给补丁跑个验证        →  Working 行：给补丁跑个验证 · 跑命令 node test

📊 实时配速
- 思考中：嗯… · 总1m23s
- 工具中：改改 file.ts · 3s
- 结束后：底部状态区闪现 搞定 ✓ · 4 工具 · 想3s 干2s，同时对话区末尾弹通知 ⏱ 总用时 1m23s · 4 工具 · 想12s 干11s

⚠ 上下文预警
每 3s 检查一次 context 用量。超过阈值（默认 80%）时 Working 行亮黄：

⚠ 上下文85% · 嗯… · 总1m23s

contextWarnAt: 0 关闭。

🔥 连击检测
连续 5+ 工具触发 火力全开×N（并行工具也算连击）。10+ 工具收尾时显示 十连击。

⏱ 慢工具提示
单工具超 30s 亮 这个有点慢 · 前缀。

⏳ 工具剩余时间
工具回报进度百分比时，按已耗时和完成比例推算剩余时间（支持 percent / percentage / progressPercent / current/total）：

拉取模型权重 · 42% · 还剩~11s

没有百分比进度的工具不显示，不影响其他信息。

🌿 git 分支上下文
检测到 git 操作（git/gh 等工具名，或 bash 类命令里带 git ）时，Working 行显示当前分支（缓存 20s，异步获取不阻塞）：

拉代码 · main · 3s

非 git 仓库自动隐藏。

🌙 时间感知
- 0–6 点：思考池混入 修仙中… 夜猫子出没 熬夜冠军 等深夜专属文案
- 周末：首次会话弹一句 周末也在卷？ 放假也陪你
🎨 28 个动画预设
/activity 打开交互选择器，或 /activity frames  直接切：

claude braille moon comet spark breathe dots circle star2 flip aesthetic hamburger random …

😐 英文冷幽默
lol hm oh ok um heh uh nah mm wow nice rgrg done again gg ez

混在一堆「嗯…」「盘一下」「啾」中间，冷不丁冒一句面无表情的英语。那种「我也不是真的在笑」的冷感。

❌ 工具失败文案
出错的工具不再只是 ✗，而是随机一句：

翻车了 · 读文件 config.json ✗
权限不对？ · 跑命令 npm i ✗

🤖 子代理计数
并行多个子代理时显示 小弟×N：

派个小弟 修测试 · 小弟×3 · 另 2 项

⚡ ~tok/s 流式速率
showTokPerSec: true 后，按 text_delta 的中英文字符粗估流式 token 速率：

~42 tok/s · 嗯… · 总1m23s

Pi 的流式事件不提供逐段 usage，因此这是实时估算值；收尾摘要里的 token 数仍使用模型返回的实际 usage。

🎄 节假日彩蛋
元旦、春节、情人节、愚人节、劳动节、儿童节、万圣节、平安夜、圣诞、跨年——自动检测，思考池混入节日专属文案，同样用七彩流光渲染。

🔄 模型切换梗
/model 切模型时，Working 行闪一句和模型名相关的梗，1.5s 后恢复。

☕ 累计活跃提醒
默认每累计活跃 3 小时弹一次提示，提醒喝水休息。只有 agent 真正运行的时间计入；workRemindAt: 0 关闭，或改成其他间隔（小时数）。

💰 成本与 token 核算
每轮结束时（≥3s）在通知里追加本轮成本和 token 总量，直接读 Pi 官方核算的 usage.cost.total——和你的账单一致，不是估算。

⏱ 总用时 2m12s · 15 工具 · 想 123s 干 6s · 💰 $0.087 · 🔥 34.2k tok

/activity stats 查看更详细的分项：本轮 / 会话累计花费、缓存命中率、思考 token。

| 字段 | 来源 |
|------|------|
| 💰 成本 | Pi 官方 usage.cost.total（含缓存折扣、阶梯价） |
| 🔥 token | input + output + cacheRead + cacheWrite |
| 缓存命中 | cacheRead / (input + cacheRead) |
| 🧠 思考 | reasoning token（output 的子集，不重复计费） |

🗜️ 上下文压缩感知
监听 session_compact 事件，上下文被压缩时闪现一条通知——和上下文预警形成完整闭环：警告 → 压缩 → 恢复。

🗜️ 上下文已压缩 · 45.0k→12.0k tok · 腾出 73%
🗜️ 溢出自动压缩 · 45.0k→12.0k tok · 腾出 73% · 将重试

压缩调用的成本也会自动累计到本轮/会话统计。

🔧 自定义工具映射
customActions 让你为自己的工具/MCP 定义文案映射，按工具名精确匹配（不执行配置中的正则）：

{
"customActions": {
"my_deploy": ["部署一下", "上线中"],
"format_code": ["格式化", "整理代码"]
}
}

⚙ 交互设置面板
/activity settings 打开可搜索的设置面板，统一调整模式、动画、自述、速率、上下文阈值、活跃提醒和全部特性开关。

面板顶部会使用当前主题实时播放动画和文案预览；每次切换立即持久化，不需要退出面板。

🩺 内置 Doctor
/activity doctor 一次检查：

- 配置 JSON 是否可解析、阈值关系是否有效
- 当前预设和全部动画结构是否完整
- 特性键是否认识
- 当前主题能否提取 RGB accent
- 配置目录与文件是否真正可读写

🎭 双模式 + 特性开关
花埑功能全部可选。总开关一键切换：

/activity mode minimal   →  只显示真实工具 + 计时 + 预警
/activity mode lively    →  全套俏皮文案 + 彩蛋（默认）

单特性独立开关（覆盖模式默认）：

/activity feature              →  列出所有特性状态
/activity feature rareEggs off →  只关彩虹彩蛋
/activity feature shimmer auto →  恢复跟随模式

可开关特性：phrases（俏皮文案）rareEggs（彩虹彩蛋）nightPhrases（深夜文案）weekend（周末问候）holidays（节假日）combo（连击）failPhrases（失败文案）modelQuips（模型梗）shimmer（星辉扫过）continuePhrases（打断接梗）

安装

pi install npm:pi-working-activity

配置

~/.pi/agent/working-activity.json（首次运行自动生成）：

| 键 | 类型 | 默认值 | 说明 |
|---|------|--------|------|
| frames | string | "moon" | 动画预设名，"random" 每轮随机 |
| narrate | boolean | true | ⏵ 模型自述开关（默认开，显式 false 关闭） |
| contextWarnAt | number | 80 | 上下文预警阈值（百分比），0 关闭 |
| contextDangerAt | number | 95 | 上下文危险阈值，超过后变红 |
| showTokPerSec | boolean | false | 流式输出时显示 ~tok/s 估算速率 |
| workRemindAt | number | 3 | 累计活跃 N 小时提醒喝水，0 关闭 |
| customPhrases | string[] | [] | 追加到思考文案池的自定义短句 |
| customActions | object | — | 自定义工具→文案映射，如 {"my_tool": ["搞一下","整一个"]} |
| debugLog | boolean | false | 调试日志（~/.pi/agent/working-activity-debug.log，>512KB 自动截断） |
| mode | string | "lively" | "minimal" 只保留功能性信息 |
| features | object | — | 单特性开关，如 {"rareEggs": false}，覆盖 mode 默认 |

命令

| 命令 | 说明 |
|------|------|
| /activity settings | 打开可搜索设置面板，实时预览动画和文案 |
| /activity doctor | 检查配置、主题、预设和持久化权限 |
| /activity | 打开动画预设交互选择器 |
| /activity frames  | 直接切换预设，如 /activity frames claude |
| /activity frames random | 每轮随机一个预设 |
| /activity narrate on\|off | 开关模型自述 |
| /activity mode lively\|minimal | 总开关：花哨 / 极简 |
| /activity feature | 列出所有特性开关状态 |
| /activity feature  on\|off\|auto | 单特性开关，auto 恢复跟随模式 |
| /activity status | 显示当前所有配置 |
| /activity warn  | 修改上下文预警阈值，0=关闭 |
| /activity danger  | 修改红色危险阈值，必须不低于 warn 阈值 |
| /activity tps on\|off | 开关流式 ~tok/s 估算显示 |
| /activity remind  | 设置累计活跃提醒间隔，0=关闭 |
| /activity phrase add  | 追加自定义思考短语 |
| /activity phrase list | 列出所有自定义短语 |
| /activity stats | 本轮+会话统计：工具数、想/干比、💰成本、🔥token、缓存命中、思考 token |
| /activity config export | 导出当前配置 JSON 到当前目录 working-activity.export.json |
| /activity config import  | 从文件导入配置并立即生效（自动校验） |

模型自述原理

1. 扩展通过 before_agent_start 把约定追加到该轮 system prompt：「每一步写 ⏵ 你正在做的事（≤20 字）」
2. 模型在流式输出中写下 ⏵ 查一下报错原因
3. 扩展实时解析 text_delta，提取最新 ⏵ 行展示在 Working 行
4. 每个 LLM turn 重置等待态；自述最低展示 2s，流式活跃时不消失，安静 5s 后退回普通文案

文案风格

- 中文：短、口语、俏皮，不说教不摆谱
- 英文：面无表情的冷幽默，穿插在中文文案中制造反差
- 游戏梗（SSR、金色传说、gg、ez）只放在稀有彩蛋池（1/150 爆率），不影响日常使用

DSH 版

DeepSeek Harness 的实时"工作状态行"插件:模型的实时活动——俏皮思考文案、真正在跑的工具、已耗时、收尾摘要——在 agent 干活时展示在 Web UI 与 dsh-cc 终端上。

安装

dsh plugin --profile  add dsh-working-activity

装好 dsh-cc-tui 后同装本插件,dsh-cc 状态栏会消费 activity/status 事件流渲染工作状态行。Web 端需要额外的 runtime 补丁,见下方文档。

文档

- DSH 版完整文档(原 dsh-working-activity 仓库 README:特性、挂载机制、配置、已知限制)
- 插件包 README:packages/activity/working-activity/README.md(英文)与 README.zh.md

开发

cd packages/activity/working-activity
pnpm install && pnpm run build   # 构建(host tsc + client tsc,产物进 lib/)
pnpm run build:client           # 构建浏览器 bundle(tsdown → lib/client.js)
pnpm test                        # 单测 + 集成测试(状态机/文案/自述/集成)

已知限制

- 单一状态行:每会话一条,Web/终端消费端显示最近活跃会话。
- 无进度百分比:DSH 没有工具进度事件,长工具只显示已耗时。
- publish 默认关闭:追加 activity/status 会话事件目前会导致会话日志无法 resume,仅对支持 ignorable append 的宿主开启(详见插件 README)。

隐私与安全

两个版本都不采集、不上传任何数据,无网络请求、无遥测。pi 版配置与文案只存在本地;DSH 版 activity/status 仅写入本地会话日志(log-only 事件,模型不可见,回放忽略)。

License

根仓库文档与 pi 版:MIT。DSH 插件包(packages/activity/working-activity/):BSD-3-Clause(见其 package.json 与 LICENSE)。