前言¶
用 DeepSeek Harness（DSH）跑智能體會話時，工作區裏往往會有一份由 agent-pathfinder 維護的結構化記錄（目錄 .pf/）。這類記錄裏通常有指令、節點細節、責任關係圖、問題池等，單靠終端或零散文件很難一眼看清全貌。下面介紹社區插件 dsh-pathfinder（維護者 infraredsqy，分類爲客戶端）：它把同一份記錄接到 DSH 網關，在 Web UI 側邊欄以 Pathfinder Center 面板呈現，面板上的寫入也會回寫到工作區裏的記錄。
這是什麼¶
dsh-pathfinder 是 DSH 插件，官方簡介爲：在 DSH Web UI 中將 agent-pathfinder 記錄渲染爲面板。實現上分爲「宿主半身」與「瀏覽器半身」：宿主按當前所選會話對應工作區讀取 .pf/ 記錄並經網關提供數據；瀏覽器在側邊欄繪製 Pathfinder Center。界面上看到的指令、節點詳情、誰欠誰的關係圖、問題池等均來自該記錄。
插件處於早期階段，與 DSH 開發者預覽綁定；manifest 中聲明瞭 engines.dsh 版本區間，DSH 在區間外會拒絕安裝或啓動（incompatible-version，另有可選豁免命令）。記錄格式隨 agent-pathfinder 演進，兩側都可能出現破壞性變更，使用前需留意版本說明。
核心功能¶
經 README 覈實，安裝後可獲得：
- Web UI 側邊欄 Pathfinder Center：對記錄的多種視圖——關係圖、詳情、指令、問題池，以及面板內設置。
- DSH 全局設置中的 Pathfinder Settings：例如是否顯示已歸檔指令、是否顯示已關閉 issue。
- 數據邊界：讀取的是當前選中會話的工作區；未選中會話時界面會明確提示。工作區需已有 agent-pathfinder 記錄，且環境中
pf在PATH上（與 agent-pathfinder 工具鏈一致）。
安裝與啓用¶
前提：已安裝 DSH 並有所用的 profile；目標工作區裏存在 agent-pathfinder 記錄（.pf/）。
安裝包爲預構建產物，安裝過程不執行構建步驟。從本倉庫 Releases 下載 .tgz，再指向 DSH：
dsh plugin --profile <name> add ./dsh-pathfinder-<version>.tgz
dsh plugin --profile <name> add dsh-pathfinder
第二行與第一行指向同一製品，按包名從 npm 安裝。pnpm 可能出現若干 missing peer 警告；README 說明這些 peer 由 DSH 在運行時提供，一般可忽略。
package.json 中當前聲明的 DSH 引擎範圍爲：
"engines": {
"dsh": ">=0.2.1-rc.2 <0.3.0-0"
}
安裝後可用下面命令覈對插件是否進入配置：
dsh --profile <name> --dump-config
在輸出中查找 # == dsh-pathfinder 段。
典型用法¶
1、在 agent-pathfinder 已寫入記錄的工作區中啓動或選擇 DSH 會話，確保該會話工作區含 .pf/。
2、打開 DSH Web UI，在側邊欄進入 Pathfinder Center，按視圖查看關係圖、節點與指令、問題池等。
3、在 Pathfinder Settings（DSH 設置內）按需開關「已歸檔指令」「已關閉 issue」的展示。
4、在面板內的編輯會寫回同一 .pf/ 記錄；具體字段與語義以 agent-pathfinder 文檔爲準。
適用場景與注意¶
適合：已在用或計劃用 agent-pathfinder 管理會話管線，並希望在 DSH Web UI 裏集中查看與輕量編輯記錄的團隊或個人。
注意：
- 插件以當前 DSH 進程權限運行；安裝前應閱讀 GitHub 源碼 與 MIT 許可證，確認符合你的安全與合規要求。
- 勿憑插件名自行拼接
dsh plugin add github:owner/repo；官方路徑爲 Releases 的.tgz或dsh-pathfinder包名安裝。 - 社區插件目錄 SkillHub 條目 爲獨立站點信息，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，版本與兼容性以倉庫 README 與 manifest 爲準。
結尾¶
dsh-pathfinder 把 agent-pathfinder 的工作區記錄搬進 DSH Web UI，減少在文件與終端之間來回切換。進一步瞭解可訪問目錄頁 infraredsqy/dsh-pathfinder 與倉庫 github.com/infraredsqy/dsh-pathfinder。
