dsh-achievements · DeepSeek Harness 成就系统 为 DeepSeek Harness（DSH）编写的进程级（全局）成就系统插件。观察 agent / session 事件，把工具调用、文件操作、子代理、workflow、goal、preset 切换等行为折叠成成就进度，解锁时弹出 toast 并写入一次性队列，供浏览器画廊、侧栏奖杯与输入坞读条展示。 ## 组成 本仓库发布为三个 npm 包（bundle + 两个子包）： | 包 | 目录 | 说明 | |---|---|---| | @wjnct55555/dsh-achievements-bundle | 仓库根 | 可安装 bundle：声明 dsh.bundle patch，挂载下面两个包 | | @wjnct55555/dsh-achievements | packages/extensions/achievements/ | 宿主侧引擎：事件监听、计数、解锁队列、只读 Remote（list / recent / dock / deepState / setDeepInsights / telemetryState / setTelemetry / rates / stats）与 list_achievements 工具 | | @wjnct55555/dsh-client-ui-achievements | packages/extensions/ui-achievements/ | 浏览器侧界面：设置页画廊、toast 堆栈、侧栏奖杯、输入坞读条、画廊浮层 | ## 设计文档 架构、规则引擎、52 个成就目录、客户端数据流与未来演进方向（参考 AGPA 的可达性审计 / 规则扩展 / hint-tip 引导等候选）见 docs/DESIGN.md。 ## 功能 - 52 个成就，分 启程 / 工具大师 / 文件工匠 / 编排 / 目标 / 技能 / 模型 / 行为 / 联动 / 隐藏 十类，稀有度覆盖 普通 → 稀有 → 史诗 → 传说。 - 本地持久化：计数与解锁写入 ~/.agent-achievements/state.json，重启后完整保留。 - 画廊双排序：按分类（默认）或按难度（稀有度）查看。 - 数据仪表盘：分类进度中空环形图与当月活动日历热力图并排一行（高度对齐，均可折叠）；稀有度分布以按稀有度着色的分段滑条呈现。 - 成就管理：红色「清除成就记录」按钮带二次确认弹窗，一键清空全部进度（匿名统计开关与匿名标识保留）。 - 多 UI 表面：解锁 toast（史诗/传说带彩纸）、侧栏奖杯（未读角标）、输入坞进度读条、设置页画廊与奖杯弹出的全屏画廊。 - 联动成就「吾栖之肤」：检测到 dsh-deep-whale 鲸鱼娘皮肤插件（github.com/Small-tailqwq/dsh-deep-whale）已安装时自动解锁。 - 隐藏成就：达成前名称/描述以 ？？？ 显示。 ## 截图 奖杯按钮弹出的成就画廊（复古终端风格）： ## 隐私 分层设计，默认零上传。 - 基础层（默认）：监听器只读取叶子标量（工具名、成功标志、agent id、事件类型、文件路径、token 计数），从不读取消息正文、文件内容、错误详情或搜索结果。 - 深度洞察层（opt-in，默认关闭）：首次运行通过设置页询问，启用后允许对消息正文正则匹配与历史会话扫描，仅用于成就解锁；正文只在运行时匹配、绝不落盘。 - 匿名统计（opt-in，默认关闭）：为显示「约 x% 用户获得」，用户可在画廊设置中显式开启。开启后仅上报成就 id、稀有度与随机匿名安装标识（POST {endpoint}/unlock），绝不包含会话、工具、文件或内容数据；获得率通过 GET {endpoint}/stats 拉取并本地缓存。未配置 telemetryEndpoint 或未开启时不发生任何网络请求。免费后端参考实现见 docs/telemetry-worker.js（Cloudflare Workers 免费层，零成本）。 - 持久化：只保存成就进度与匿名统计开关到本地 JSON（~/.agent-achievements/state.json），不含任何消息/文件内容。 ### 启用匿名统计 yaml # cordis.yml 中给插件配置统计端点（部署免费 Worker 后替换为你的地址） - plugin: @wjnct55555/dsh-achievements config: telemetryEndpoint: https://your-name.workers.dev 然后在成就画廊设置里打开「匿名统计」开关。开关状态会持久化，重启后保留。 ## 构建与安装 ### 安装（推荐：npm） sh dsh plugin --profile web add @wjnct55555/dsh-achievements-bundle ### 安装（git 方式） sh git clone https://github.com/WJNCT55555/dsh-achievements dsh plugin --profile web add ../dsh-achievements ### 从源码构建 三个包由 DSH 工作区构建（lib/ 产物已随仓库提供；需重新构建时在 DSH checkout 中放入 packages/extensions/）： sh pnpm install --offline pnpm exec tsc -b packages/extensions/achievements packages/extensions/ui-achievements pnpm exec tsdown --env.DSH_BUILD_FACE host # 生成宿主侧 Typert 工件 pnpm --filter @wjnct55555/dsh-client-ui-achievements bundle # 构建浏览器侧 宿主侧依赖 @deepseek-ai/cordis-plugin-loader 读取 Loader 条目以检测联动皮肤。浏览器侧挂载于 settings.section、shell.overlay、sidebar.footer.action、conversation.composer.dock 四个槽位。 ## 测试 sh pnpm exec vitest run packages/extensions/achievements/tests/achievements.spec.ts 覆盖：会话播种、工具计数、连击重置、并发子代理、phoenix 恢复解锁、marathon 回合隔离、联动皮肤检测、token 按会话去重、匿名统计开关与上报等 27 个用例。 ## 许可 MIT。见各包 package.json 与本仓库根目录 LICENSE。