前言¶
DeepSeek Harness（DSH）可以通过插件扩展能力。对于希望把本地使用过程记录为可回看、可展示、可清除的成就记录的场景，WJNCT55555/dsh-achievements 提供了一个进程级全局成就系统插件。
下面介绍它的定位、核心功能、安装方式、典型用法，以及安装前需要确认的权限与许可证事项。
这是什么¶
dsh-achievements 是 WJNCT55555 维护的 DeepSeek Harness 插件，用于在 DSH 中提供进程级全局成就系统。
它的 GitHub 仓库地址是：
https://github.com/WJNCT55555/dsh-achievements
许可证为 MIT。安装命令使用 npm 包名：
dsh plugin --profile web add @wjnct55555/dsh-achievements-bundle
核心功能¶
成就目录¶
插件提供 52 个成就，分为十类：
- 启程
- 工具大师
- 文件工匠
- 编排
- 目标
- 技能
- 模型
- 行为
- 联动
- 隐藏
成就稀有度覆盖：
- 普通
- 稀有
- 史诗
- 传说
成就画廊与仪表盘¶
成就画廊支持两种查看方式：
- 按分类查看
- 按难度或稀有度查看
数据仪表盘包括：
- 分类进度中空环形图
- 当月活动日历热力图
- 稀有度分布分段滑条
本地持久化¶
成就计数与解锁状态会保存到：
~/.agent-achievements/state.json
重启后状态保留。
多界面展示¶
插件支持多个 UI 表面：
- 解锁 toast
- 侧栏奖杯
- 输入坞进度读条
- 设置页画廊
- 全屏画廊
清除成就记录¶
插件提供清除成就记录按钮，并带有二次确认弹窗，可一键清空全部进度。
清除后会清空全部成就进度，但保留匿名统计开关与匿名标识。
隐藏成就¶
隐藏成就在达成前，名称和描述以 ？？？ 显示。
联动成就¶
联动成就「吾栖之肤」会在检测到 dsh-deep-whale 鲸鱼娘皮肤插件已安装时自动解锁。
该联动检测依赖 dsh-deep-whale 是否安装。
宿主侧接口¶
宿主侧提供只读 Remote 和 list_achievements 工具。
安装与启用¶
使用 npm 安装¶
执行下面命令：
dsh plugin --profile web add @wjnct55555/dsh-achievements-bundle
该命令安装的是 DSH 插件 bundle 包。
使用 git 安装¶
先克隆仓库：
git clone https://github.com/WJNCT55555/dsh-achievements
再执行本地安装命令：
dsh plugin --profile web add ../dsh-achievements
从源码构建¶
如果要从源码构建，依次执行：
pnpm install --offline
pnpm exec tsc -b
pnpm exec tsdown
pnpm --filter @wjnct55555/dsh-client-ui-achievements bundle
运行测试¶
运行成就相关测试：
pnpm exec vitest run packages/extensions/achievements/tests/achievements.spec.ts
典型用法¶
查看成就¶
安装后，可以从成就画廊查看成就。画廊支持按分类查看，也支持按难度或稀有度查看。
清除进度¶
在成就管理入口使用「清除成就记录」按钮。系统会给出二次确认弹窗，确认后清空全部成就进度。
注意：匿名统计开关与匿名标识不会被清除。
启用匿名统计¶
匿名统计默认关闭。启用时，先在 cordis.yml 中给 @wjnct55555/dsh-achievements 配置 telemetryEndpoint。
示例配置如下：
# cordis.yml
- plugin: @wjnct55555/dsh-achievements
config:
telemetryEndpoint: https://your-endpoint.example
把 https://your-endpoint.example 替换为你实际使用的端点地址。
配置完成后，在成就画廊设置里打开匿名统计开关。开关状态会持久化，重启后保留。
开启后，仅上报：
- 成就 id
- 稀有度
- 随机匿名安装标识
未配置 telemetryEndpoint，或未开启匿名统计时，不发生任何网络请求。
深度洞察层¶
深度洞察层为 opt-in，默认关闭。
启用后，允许对消息正文进行正则匹配与历史会话扫描。消息正文只在运行时匹配，不落盘。
联动成就¶
如果你已经安装 dsh-deep-whale 插件，dsh-achievements 检测到该插件后，会自动解锁联动成就「吾栖之肤」。
适用场景与注意¶
适合在 DSH 中使用插件能力，并希望本地保留成就进度、画廊展示与可清除记录的用户。
安装前需要注意：
- 插件随当前
dsh进程权限运行。 - 安装前应检查源码与许可证。
- 本仓库许可证为
MIT。 - 默认零上传。
- 基础层只读取工具名、成功标志、
agent id、事件类型、文件路径、token计数等叶子标量，不读取消息正文、文件内容、错误详情或搜索结果。 - 深度洞察层默认关闭，启用后才允许消息正文正则匹配与历史会话扫描。
- 匿名统计默认关闭，开启后仅上报成就 id、稀有度与随机匿名安装标识。
- 清除成就记录会清空全部进度，但保留匿名统计开关与匿名标识。
结尾¶
dsh-achievements 为 DSH 提供了一组本地持久化、可展示、可清除、可联动的成就记录。它默认零上传，并对深度洞察和匿名统计都保持 opt-in 设计。
GitHub 仓库：
https://github.com/WJNCT55555/dsh-achievements
已核实资料未给出目录页 URL。安装前建议先检查源码与许可证。
