前言¶
在 DeepSeek Harness（DSH）里长时间做探索、写代码、跑技能或委派任务，会话日志往往只留在对话里，缺少一层「个人进度」的呈现。若希望把真实使用积累可视化，并用同一套规则做勋章、挂件和主题角色收藏，而不把日常记录和抽卡都绑在模型调用上，dsh-achievement-helper 面向的就是这类需求。下面介绍它的定位、能力与安装方式。
这是什么¶
dsh-achievement-helper（成就手记）是由 ghang 维护的 DSH 插件，分类为趣味换装。它为 Harness 提供个人主题成就、勋章与角色收藏：启用后的可见活动可积累进度，解锁成就获得成就点，再用点数在十套题材卡池里十连抽取角色并佩戴到账户旁的展示框。档案保存在本机，日常记录、抽卡和反馈不调用模型；只有「自定义生成成就」或创作区里点击模型生成按钮时，才会发起有界辅助请求。
界面与内置主题、成就、角色文案目前仅提供简体中文（zh-CN），切换 DSH 显示语言不会切换本插件语言。
核心功能¶
主题与成长总览¶
插件支持探索、修仙、赛博朋克、武侠、奇幻、星际、深海、花园、学院和蒸汽十套主题。顶部保留一个主题选择；成就文案、角色卡池、抽卡、自定义生成和调试抽取都跟随当前主题。切换主题会改变文案与外观，已有进度继续保留。成长总览集中展示等级、使用积累、佩戴勋章和下一项成就。
成就与勋章¶
成就收藏以紧凑卡片展示已解锁勋章、条件和当前进度，可筛选、查看详情和调整佩戴。每枚已解锁的唯一成就提供 1 点成就点，已有成就自动计入。内置成就不提供删除；用户自定义成就可以在列表中删除（删除前就地确认），已获得的历史和成就点仍保留，也不退还已花费点数。
「自定义生成」页可勾选数据来源、填写主题方向与模板风格，设置本次数量（1～6 项，默认 3 项），点击「分析并生成成就」后由当前会话选中的模型生成；没有当前会话时使用 DSH 默认模型，且不会把主会话历史发送给生成模型。结果经结构校验且数量恰好符合所选后才会加入档案。
角色收藏与抽卡¶
1 点可十连；重复角色累计份数，不返还点数。基础概率为 N 60%、R 28%、SR 10%、SSR 2%，同主题同稀有度角色均分该概率；若十连没有 SR 及以上，第十张按 SR:SSR=10:2 重新选择。同主题最多 50 张必得 SSR，各题材保底独立。这是不含付费购买的本地个人收藏；切主题、抽卡或创建角色不产生成就点，模型不能修改余额或直接授予角色。
80 个预设角色各有「清爽扁平」「微像素」两种外观；顶部「画风」选择与题材独立，角色 ID、稀有度、份数与抽取概率保持不变。创作区支持模型自动生成同主题角色的名字、图标、稀有度和动画预设，也可手工配置并上传本地 PNG/JPEG/GIF/WebP（每张不超过 256KiB），素材只保存在当前本机档案。
展示框与设置¶
在 DSH 侧栏底部、账户区域旁的展示框打开「成就手记」，或在设置中打开同名页。主题与反馈设置提供紧凑 32px、标准 64px、展示 104px 和 32～160px 自定高度，选择时实时预览、保存后应用。反馈可设为全部、仅解锁或关闭，并可减少动画。
模型工具¶
首次安装增加四项固定工具：achievement_catalog、achievement_query、achievement_configure、achievement_report。可在正常会话中让模型先查询成就目录，再按支持的条件配置成就或角色卡池；模型不能写原始 token、抽卡、修改成就点或直接授予角色及自动成就。
调试模式¶
在主题与反馈设置中可进入调试模式：插件复制当时真实档案到独立临时目录，可快速完成成就、十连并自动佩戴等，变更只保存在调试副本；退出调试或重置后回到真实数据。调试不调用模型生成。
数据位置¶
档案位于当前 DSH_HOME 的 storages/achievement-journal/，含规则、获得历史和佩戴等；不复制源码、会话正文或命令参数。卸载插件会清理调试副本，真实档案保留，重装可恢复。
安装与启用¶
0.2.0 已通过 GitHub Release 和 npm 发布。首次安装到 web profile：
dsh plugin --profile web add dsh-achievement-helper@0.2.0
也可下载 Release 中的预构建 tgz 后安装：
dsh plugin --profile web add /absolute/path/dsh-achievement-helper-0.2.0.tgz
包名自开发期的 dsh-achievement-journal 改为 dsh-achievement-helper；若仍装有旧包，应在空闲回合停宿主并备份插件专属存储，先移除旧包再装新包，不要同时启用两个包。
卸载：
dsh plugin --profile web remove dsh-achievement-helper
插件要求 Node ^22.19.0 || >=24.0.0，DSH 宿主版本 >=0.2.1-rc.2 <0.3.0-0。安装或升级建议在任务间隙使用独立 web profile。
典型用法¶
- 安装完成后，在侧栏展示框或设置中打开「成就手记」；首次为空档案，完成新的工作回合后开始积累。
- 在概览查看等级与最近获得，在收藏查看条件与佩戴，在历程查看获得和升级记录。
- 需要模型协助配置时，可在会话中说明目标，并提示模型先查询成就目录、只配置当前支持的条件；例如 README 中的示例表述：「给我配置一套修仙成就，包含探索、协作和这个项目的纪念。先查询成就目录，只配置当前支持的条件。」
- 用成就点十连抽取当前主题角色，在角色收藏页选择已获角色佩戴；需要新成就定义时，在「自定义生成」页填写数据源与方向后点击生成（会消耗正常模型用量）。
适用场景与注意¶
适合希望在 DSH 里把真实使用与探索进度做成可佩戴、可收藏的个人化呈现、又希望抽卡与计数尽量本地完成的用户。插件以当前 DSH 进程权限运行，读写 DSH_HOME 下存储；安装前应查看 GitHub 仓库 源码与许可证，并自行评估是否纳入工作环境。
只记录启用后的可见活动，不自动导入旧会话。社区目录 SkillHub 插件页 为独立收录站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-achievement-helper 把 Harness 里的积累、探索与协作经历收进本地成就手记，用十套主题统一成就文案与角色卡池，并在账户旁展示佩戴结果；模型只参与可边界明确的配置与生成步骤。更多信息见 SkillHub 目录页 与 GitHub：ghang/dsh-achievement-helper。
