前言¶
DSH 的插件理念是「一切皆插件」：常用能力可以拆成独立插件，按 profile 安装。社区目录是独立站点，与 DeepSeek 或幻方没有官方从属关系，也不等同于官方应用商店。
对长期在 DSH 中让 agent 工作的开发者来说，回合、工具调用、新会话、每日活动这些数据往往分散在不同会话里。dsh-achievements 为 DeepSeek Harness（DSH）提供一个成就与游戏化层，把这些使用轨迹整理成可查询的徽章、分享卡片和 Agent Wrapped。它不改核心，只监听官方 session/event 事件。
这是什么¶
dsh-achievements 是一个 DSH 成就与游戏化插件。已核实资料给出的维护者/仓库 owner 为 Blaczz，许可证为 MIT，仓库地址为：
https://github.com/Blaczz/dsh-achievements
它解决的问题是：在不改 DSH 核心的前提下，把跨会话使用记录变成可查、可分享、可扩展的成就状态，并为第三方插件提供注册成就的开放 SDK。
核心功能¶
68 个成就¶
插件提供 68 个成就，分三条产品线：
- 7 条五档终身成长线
- 10 个会话行为徽章
- 20 个会话轨迹成就
成就卡片展示图标、稀有度、描述、进度、XP 和解锁时间。
实时解锁与设置页面板¶
新成就解锁时，插件通过 SSE 推送到浏览器，并提供 30 秒轮询兜底；页面刷新或可见性变化时也会更新。
设置页成就面板包含：
- 个人资料卡
- 稀有度统计
- 终身计数器
- 徽章墙
徽章墙按七条成长路线和 special/trajectory chains 分组，支持 all / locked / unlocked 过滤。
分享卡片与 Agent Wrapped¶
插件提供分享卡片与 Agent Wrapped。
隐私方面，分享文本、分享卡片、Agent Wrapped 和成就链只读取聚合计数、成就元数据、persona 和等级；文件路径和命令字符串不离开引擎。
开放 SDK¶
第三方 Host 插件可通过 ctx.achievements.register / ctx.achievements.registerPack 注册成就；客户端插件可通过 ctx.achievementsState 读取状态。
已核实资料未提供完整注册代码示例，本文不补全调用参数。
零核心改动与状态持久化¶
插件以零核心改动实现：只监听官方 session/event 事件，均为只读事件，无核心补丁。
状态持久化为 DSH home 目录中的 JSON 文件；v1 状态可无损迁移。
测试¶
插件核心为三层纯函数流水线，并附 19 个测试文件、251 个测试。
安装与启用¶
前置条件：
- DSH 的
dsh web可用 - Node >= 22.19
从 GitHub 安装时，已核实资料给出的命令为：
dsh plugin --profile web add "github:luumod/dsh-achievements#main"
安装后需要重启已运行的 dsh web 进程。
从本地安装时，可按以下步骤操作：
cd dsh-achievements && npm install --legacy-peer-deps && npm run build
npm pack --ignore-scripts
然后用生成的 dsh-achievements-0.1.0.tgz 绝对路径添加：
dsh plugin --profile web add "/absolute/path/dsh-achievements-0.1.0.tgz"
注意：已核实资料中的安装命令使用 luumod，仓库页 owner 为 Blaczz。本文只转写资料中已给命令，不据此判断两者为同一发布方。
典型用法¶
1、安装后重启 dsh web，然后正常使用；首个完成回合会解锁第一个成就。
2、聊天并让 agent 工作：回合、工具调用、新会话和每日活动会静默累积，新成就解锁时弹出提示。
3、在 Settings → 成就 中查看个人资料卡、终身计数器、徽章墙、会话报告、Agent Wrapped 和 Share。
4、在徽章墙中按七条成长路线和 special/trajectory chains 查看成就，并使用 all / locked / unlocked 过滤。
5、开发者在 Host 插件中使用 ctx.achievements.register / ctx.achievements.registerPack 注册成就；在客户端插件中使用 ctx.achievementsState 读取状态。
适用场景与注意¶
适合：
- 长期在 DSH 中使用 agent，并希望查看跨会话累计情况的开发者
- 想要把工具调用、会话行为、轨迹数据变成可查成就的使用者
- 准备基于开放 SDK 扩展第三方成就包的插件开发者
注意：
- 插件以当前
dsh进程权限运行。安装前应检查源码、依赖与许可证。 - 许可证为 MIT。
- 资料中
package.json的 peerDependencies 里@deepseek-ai/cordis版本约束被截断，无法确认完整约束；升级 DSH 或相关依赖前，应按仓库说明核对。 - 资料未提供完整开发者 SDK 代码，本文只列出已核实的接口名，不补全调用示例。
- 目录页 URL 未在已核实资料中出现，本文不给出具体目录页链接。
结尾¶
dsh-achievements 的价值在于把 DSH 的使用轨迹整理成可查询的成就状态：跨会话累计、实时解锁、设置页面板、分享卡片和开放 SDK，同时保持零核心改动。
GitHub 仓库：
https://github.com/Blaczz/dsh-achievements
目录页 URL 未提供。
