dsh-token-slime

dsh-token-slime

养在输入框下方的一只小史莱姆 · DeepSeek Harness 插件

它吃掉模型在当前会话里写出来的 token（outputTokens），沿成长阶段一步步长大、分裂成群， 按工具构成长出头饰，每次上下文压缩蜕一层壳留下年轮。它活着：报错会受伤贴创可贴、 上下文快满会撑得冒汗、久没动静会打瞌睡、摸它一下会开心地冒爱心；偶尔还是稀有变异（水晶/顽强/远古种）， 并写着一篇史莱姆日记。右侧栏的总族群把 dsh 里全部会话装进一个昼夜生态缸，并显示会话总数供你核对。

English

A slime lives under the composer and eats the output tokens the agent writes in the current session. It matures through named life stages, splits into a colony, and wears a headpiece derived from the session's tool mix. It is alive: errors hurt it (bandage), a near-full context makes it sweat, long idle makes it doze, and petting it makes it happy with a heart. Every context compaction grows a ring and sheds a shell. Occasionally it appears as a rare morph (crystal / scrappy / ancient) and keeps a first-person diary. A right-sidebar tab puts every session in dsh into a day/night habitat and shows the session count so you can reconcile it.

Everything is derived from projections the Harness already computes (tokenUsage, contextPressure, plus this plugin's own slime projection). It adds no prompt, no tool, no model call and no session writes, so the pet is a pure function of the session log.

       ╭─ 小黏  第 2 代 ─╮
      (◕‿◕)  ▓▓▓▓▓░░░░░      ← 戴工装帽（bash 最多）
       ╰─── +128 ───────╯        身子上的圈 = 年轮 = 压缩次数

玩法（v0.4）

核心闭环：干活 → token → 成长阶段进度 → 升阶庆祝 → 下一阶段；同时它是个会对你的一举一动做出反应的活物。

机制	规则
吃饭	每个 assistant/message 的 outputTokens 都算一口；面板里的 +N 是刚刚吃掉的一口
成长阶段	按本会话累计 output 走 6 阶段：蛋 → 幼体(≥1) → 少年(≥2.5k) → 成体(≥25k) → 长老(≥120k) → 传说(≥600k)。阶段越高体型越大，长老/传说带光环，传说还会闪光；升阶弹「进化！」
分裂/族群	第 g 代需要 4000 × 1.7^g 个 output token：4k → 6.8k → 11.6k …，最多 9 代。与「阶段」正交：阶段=成熟度，族群=繁殖数
下一阶段提示	dock 常驻一行提示，显示距下一阶段的差额（如「距「成体」还差 22k token」），到顶后显示「已是最终形态」
情绪反应（A）	报错→受伤贴创可贴；报错叠加重试→晕眩转圈眼；上下文占用 ≥85%→撑得冒汗；久无活动（>60s）→打瞌睡冒 zzz；吃饭/被摸→开心
上下文饱食度（A）	身体随 contextPressure 变宽，越满越鼓，压缩后「呼气」恢复——把上下文占用变成看得见的体态
摸头互动（A）	点史莱姆本体它会开心扭动 + 冒爱心（点名字/进度条那侧才是打开图鉴）。纯逗弄，无数值
物种（工具）	按 tool/call 分布：bash/写文件多 → 工装种（安全帽）；web 多 → 探险种（探险帽）；docx/pptx/xlsx/present 多 → 文书种（学士帽）；read/glob/grep 多 → 学者种（圆眼镜）
物种（兜底）	没调用过可分类工具时按缓存命中率：苔藓种（≥72%）→ 草叶种 → 黏土种 → 熔岩种（<20%）
稀有变异（C）	不是解锁，是「偶尔孵出不一样的」：output≥100 万→远古种；缓存命中≥90%→水晶种（冰蓝+宝石+闪光）；错误≥5 次→顽强种（贴满创可贴）。dock 有金色变异徽章
年轮/蜕皮	每次 compaction/start 身体多一圈年轮并蜕下一层壳（动画 + 提示）
史莱姆日记（C）	图鉴里一篇第一人称日记：今天吃了多少、长到哪个阶段、蜕了几次皮（带时刻）、被 bug 吓到几次、是不是稀有变异
特性	食腐（缓存 ≥60%）、话痨（output 占比 ≥10%）、结晶（新写缓存 ≥25%）
蛋	会话还没有任何 token 时，它是一颗会轻轻摇晃的蛋
生态缸（B）	右侧栏「史莱姆族群」页签顶部是一个昼夜生态缸：天空按你本地时间变 day/dusk/night，夜里熄灯冒 zzz；每个会话一只小史莱姆在缸里晃悠，所属会话闲置久了就打盹；地上散落着蜕下的壳
总族群（全量）	生态缸下方聚合 dsh 全部会话＝sessionPersistence.list() 的所有历史会话（含 v3 旧格式）＋未落盘的活会话，按 id 去重。头部显著显示「共 N 个会话」，可与 dsh 实际会话数核对；下方列出全部会话（按食物排序、可滚动）

阶段、物种、年轮、情绪、变异都由会话日志纯推导，重开/重放同一会话结果一致；不新增任何模型调用或会话写入，也不做饥饿掉血之类催你的负罪感设计。

三个新增能力怎么实现的

1. 工具分布决定物种（需要 Host）

浏览器端拿不到工具名，所以 index.js 注册了一个会话投影 slime：

key: 'slime', stateVersion: 2,
stateSchema / init / apply,
// tool/call → 分类计数；compaction/start → 年轮 + 蜕皮时刻；assistant/message → 食物；
// tool/result(isError) → 错误数/最近报错时刻；llm/retry-started → 重试数；
// 各活动事件 → lastActivityAt（供打瞌睡/生态缸睡眠判定）
wire: { summary: false, view, viewSchema }   // 浏览器用 useProjection('slime') 读取

情绪、饱食度、变异、日记都是客户端拿这份投影 + tokenUsage/contextPressure 现算的， 时间判定用事件自带的 time（回放一致），不额外落盘。

分类规则（categoryOfTool，两端各有一份、测试保证一致）：

分类	工具名模式
engineer	run_code bash pwsh write edit str_replace* apply_patch workflow ralph jobs plugin_manager
explorer	web_search web_fetch fetch browse
scribe	docx pptx xlsx pdf office present document
scholar	read glob grep ls find skill session_* workspace*
other	其余（子代理、todo、schedule…）

speciesOfTools 取计数最大的分类（同分按 engineer → explorer → scribe → scholar 顺序稳定取舍）； 一个分类都没有时返回 null，客户端回退到 token 口味物种。

2. 跨会话总族群

GET /dsh-token-slime/colony（webServer.register）全量汇总，覆盖 dsh 里的每一个会话：

• 历史会话：sessionPersistence.list() 列出全部已存会话（含 v3 旧格式），经 sessionProjectionCache.cachedSnapshot(header, ['title','tokenUsage','slime']) 零 I/O 读取检查点。 历史会话没有 slime 行（插件刚启用），就退回到已存储的 tokenUsage 得到食物量； 工具统计与年轮从插件启用后开始累计（面板底部有说明）。
• 活会话：用投影 handle 的 handle.stateOf(session) 直接读折叠状态，标题取 title 投影； 尚未落盘的活会话也会补进来，与已存会话按 id 去重，不重复计数。
• total.sessions 恒为去重后的全量会话数（不受展示行数限制）。面板头部显著显示 「共 N 个会话」，并带 data-session-count，方便与 dsh 实际会话数核对。
• 结果是 8 秒短缓存，面板每 10 秒轮询一次；右侧栏 tab 通过 sidebarRightTabs.register + sidebar.right.pane.tab 注册，sidebarRight.openTab(kind) 打开。

覆盖率已按 id 逐一核对：路由返回的会话集合与磁盘 ~/.dsh/sessions 下的全部会话实体 完全一致（0 遗漏 / 0 多余）；test/host.mjs 有「全量 + 去重」回归测试守住这一点。

3. 压缩蜕皮

同一份 slime 投影统计 compaction/start。客户端：

• 年轮画在身体上（最多 6 圈），面板显示真实总数（年轮 · N 圈）；
• 压缩数增加时弹「蜕皮！」并让一层半透明壳飞出（MoltShell，CSS tsl-molt 动画）；
• 重新打开会话时按历史压缩数静态重绘年轮，不会误触发蜕皮提示。

为什么它不会「偷偷烧钱」

• 零模型调用：不新增提示词、工具、schema，也不请求模型；
• 零会话写入：不往会话日志里写任何东西（投影只读日志）；
• 完全可复现：所有状态都由会话日志的投影推导——重新打开、换设备、重放日志， 都是同一只史莱姆、同一个族群；
• 只有一个本机 HTTP 路由用于汇总面板，数据不出机器。

安装 / 卸载

三种方式：

• 市场：在 dsh-market 里搜索 dsh-token-slime（或 Token slime）一键安装；
• GitHub 源码：dsh plugin --profile <profile> add github:ruaibeite/dsh-token-slime；
• 本地目录：plugin_manager: install_bundle target=/path/to/dsh-token-slime。

插件行由包内 cordis.patch.yml 注入，不需要手改 profile 的 patch 层。 卸载：plugin_manager: remove_bundle（或市场里卸载），然后重启桌面端。

验证

cd dsh-token-slime
npm test        # 21 个 Host 测试 + 36 个渲染测试 = 57 项

• test/host.mjs：工具分类映射、投影 fold（含重试替换语义、坏存档修复、错误/重试/活动时间/蜕皮日记）、 世代阈值、聚合、以及用假 ctx 驱动 apply + 路由的整链路（活会话/缓存/未落盘会话、 HEAD/405、持久化失败降级、短缓存、全量覆盖 + 去重）；
• test/render.mjs：自带迷你 React（hooks + 异步 effect + 多 pass，定时器 unref 不阻塞退出），真实执行组件， 覆盖蛋/成体、四种工具物种与兜底物种、年轮数量、压缩增量触发蜕皮提示、 缺投影降级、locale 覆盖、英文回退、右侧栏 tab 注册与打开、总族群面板渲染与错误态、 六阶段阈值、阶段梯、升阶进化横幅、下一阶段提示、面板会话总数与路由 total 一致、 「成就 UI 已彻底移除」回归，以及摸头冒爱心、报错受伤、重试晕眩、上下文撑满冒汗、久置打瞌睡、 生态缸昼夜/族群/贝壳、水晶/顽强/远古变异、第一人称日记。

已知限制

• 历史会话的工具统计与年轮无法回溯：slime 投影是插件启用后才注册的新 key， 缓存里没有旧记录；食物量可以用已有的 tokenUsage 检查点补齐；
• 总族群按「已持久化 + 当前活会话」统计；从未落盘的会话在重启后会消失；
• 主题色只依赖 --dsw-alias-* 主题变量，变量缺失时回退到中性色。

开发备注

• 调整分裂节奏改 client.js 顶部 FIRST_SPLIT / GROWTH / MAX_GEN （index.js 里有同名常量用于聚合，测试会校验两端一致）；
• 调整成长阶段改 client.js 的 STAGES（阈值 + key），并在 locale/*.json 与内嵌 TEXT 补对应 stage.* 文案，npm test 的 locale 完备性测试会抓缺漏；
• 新增工具分类时同时改 index.js 与 client.js 的 categoryOfTool，npm test 会抓不一致；
• 修改客户端后需要重新安装并刷新页面；修改 Host 端（index.js）在已安装状态下 需要重启桌面端才会加载新的模块代。

License

MIT