前言¶
在 DeepSeek Harness（DSH）里做对话式助手时，游戏攻略类问题往往缺少「玩家真实进度」：模型只能根据你口述的等级和区域猜，容易和实际存档不一致。通用网页检索也帮不上忙——它不知道你杀了哪些 Boss、漏了哪些篝火。
下面介绍社区插件 dsh-darksouls-guide（仓库 plankton12138/dsh-darkSoulGuide）。它在本地读取 PC 版《黑暗之魂3》的 DS30000.sl2 存档，把等级、位置、Boss、篝火、收集缺口等写进对话上下文，再回答「接下来该干什么」一类问题。游戏知识走本地参考数据，README 明确说明不会把存档或问题发到第三方攻略站。
这是什么¶
dsh-darksouls-guide 是 DSH 的 bundle 插件，npm 包名 dsh-darksouls-guide，当前版本 0.11.4（README 标注为 0.x 开发者预览，接口与界面可能继续变）。维护者为 plankton12138，在 SkillHub 社区目录中归类为模型推理类插件；代码以 MIT 发布。
插件声明的 DSH 兼容范围为 engines.dsh: >=0.2.1-rc.1 <0.3.0。不满足时，市场会标记不兼容，强行启用可能导致工具与面板不加载。
核心功能¶
能力以 README 中的说明为准，进度按「还差什么」报告，而不是百分比。
| 方向 | 行为 |
|---|---|
| 角色与 build | 九项属性、当前装备、质变缺口 |
| 进度 | 等级、当前区域、游戏时长、24 个主线与 DLC 主要 Boss 完成情况 |
| 探索 | 按区域分组列出未点亮的篝火 |
| 收集 | 按背包判定戒指、法术、誓约；戒指按家族计数（+1/+2/+3 不重复计） |
| 即时收益 | 已击败但未兑换的 Boss 灵魂、教团还差几枚等 |
| 成就与结局 | 读 Steam 成就并列出未解锁项；三个有成就的结局可查；夺火存档无法核验，助手不会猜测 |
| 物品与路线 | 物品位置三段式指引；路线规划区分传送与步行 |
客户端侧提供两类界面（README 有示意图）：输入框左侧的进度药丸（等级、位置、六条进度轴、快捷提问芯片）；左侧栏进度图（19 个区域连通、篝火完成度、「下一步」建议）。侧栏进度页不依赖对话预设；读存档并注入模型工具只在「黑魂3 攻略」预设下生效。
存档解析由 Python 脚本 tools/ds3/dump_save.py 完成，依赖 cryptography。插件只读存档，不写回。
明确不做或尚未完成的事项包括：不联网拉攻略；区域内「从哪个门进」的导航仍在计划中；默认只读存档里第一个角色；多角色切换在更新计划中。
安装与启用¶
安装前请知悉：插件以当前 DSH 进程权限运行，会访问本机存档路径与 Python 环境。安装前应自行查看仓库源码与许可证。
环境要求（摘自 README）
| 前置 | 要求 |
|---|---|
| 系统与存档 | Windows + PC 版《黑暗之魂3》，且至少创建并保存过一个角色；默认查找 %APPDATA%\DarkSoulsIII\*\DS30000.sl2 |
| Python | Python 3，且 python / python3 / py 之一在 PATH 上 |
| cryptography | pip install cryptography |
| DSH | >=0.2.1-rc.1 且 <0.3.0 |
从 npm 安装
在 Harness 会话中让 agent 执行：
plugin_manager action=install_bundle target=dsh-darksouls-guide@0.11.4
或使用 DSH CLI：
npx @deepseek-ai/dsh plugin add dsh-darksouls-guide
本地开发可从仓库目录安装（README 示例）：
plugin_manager install_bundle target=<本目录绝对路径>
装好后重启 DSH。若缺 Python 或依赖，侧栏检查表会把异常项标黄并给出可复制的修复命令；修好后点「重新读取」即可，无需重启。
典型用法¶
经过上面的安装与重启，按下面步骤使用对话能力。
- 新建对话，选择预设「黑魂3 攻略」 —— 不选该预设时，助手不会读存档，回答只能依赖猜测；侧栏进度页仍可用。
- 直接提问，例如「我现在该去哪儿」「还差哪些篝火」。
- 使用界面上的快捷芯片或进度图里可点击的数字/区域，把问题填入输入框，确认后再发送。
无存档时，面板会说明查找路径与需要先在游戏中存盘；示例提示形如：
读不到存档：没有找到《黑暗之魂3》存档
默认查找 %APPDATA%\DarkSoulsIII\*\DS30000.sl2 —— 请确认游戏至少创建过一个角色并保存过。
不依赖 DSH 也可单独验证解析器：
pip install cryptography
python tools\ds3\dump_save.py
适用场景与注意¶
适合：在 Windows 上玩 PC 版《黑暗之魂3》，已安装 DSH 0.2.x，希望在 Harness 里基于真实存档问 build、Boss、篝火、收集与路线，并愿意安装 Python 与 cryptography 的用户。
注意：
- 仅支持 Windows 与上述存档路径；Linux/macOS 玩家不在 README 支持范围内。
- 开 NG+ 后 Boss 与进度旗标会被游戏重置，显示为新周目是正常行为；Steam 成就仍跨周目保留。
- 没装 Steam 时，成就相关能力会降级为「读不出」，不会编造。
- SkillHub 目录（plankton12138/dsh-darkSoulGuide）与 GitHub 由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态本身是「一切皆插件」，本插件是其中一例。
结尾¶
dsh-darksouls-guide 把《黑暗之魂3》存档解析、本地知识库和 DSH 对话预设绑在一起：选「黑魂3 攻略」预设后，问答会引用存档里的具体数字与区域名，而不是泛泛攻略。项目仍在更新（NPC 任务线、区域内导航、知识库与多角色等见 README「更新计划」）。
