前言¶
用 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。
