前言¶
在 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「更新計劃」）。
