前言¶
在 DeepSeek Harness（DSH）里跑长会话时，正式目标、计划步骤和工具活动往往分散在对话与宿主元数据里。想快速回答「AI 做到哪一步、还剩什么」，通常要在消息流里翻找，或依赖记忆拼凑。若你希望在 Web 界面里有一条清晰的只读路线，并能在总览图与步骤列表之间切换，下面介绍社区客户端插件 dsh-plugin-goal-map（目标进展图 / Goal Map）。
这是什么¶
dsh-plugin-goal-map 由维护者 sensen-jo 在 GitHub 公开维护，npm 包作者署名为 sensenzi，当前公开版本为 0.2.0-beta.1，采用 MIT 许可。插件分类为客户端：在 DSH Web 中注入只读的「目标 → 计划进展路线」、会话思维导图与步骤列表，不调用模型、不执行任务、不启动子代理。
一句话定位（与仓库简介一致）：为 DeepSeek Harness Web 提供只读的目标进展路线、思维导图和步骤列表（Goal Map: read-only goal-to-plan progress route and session mindmap）。
核心功能¶
进展路线与进度¶
界面呈现「你的要求 → AI 做到这里 → 距离目标还差」：展示正式目标摘要、已报告完成或当前进行中的步骤，以及全部未完成项，保留原编号并可打开详情。
进度条与完成项数示例为 33% · 已报告 1/3 项。收起路线后仍保留进度与必要的状态核对信息。
进度仅在完整、当前、已同步且有效的计划上计算：floor(已报告完成项数 / 总项数 × 100)，每项等权。计划新增时百分比可能下降；工具返回、子代理结束不会推进计划进度。100% 表示计划项已报告完成，是否满足你的全部要求仍需自行核对。 没有计划、历史快照、未同步、无效或截断计划时不显示百分比。正式目标标为完成但仍有未完计划时会提示核对；没有正式目标时界面会明确使用会话标题作为参考。
目标全景图与步骤列表¶
目标全景图：目标根节点连接到计划、工具活动和直接子代理三个分组；可展开查看保留节点，也可切换为完整步骤列表。
快速定位：支持查找、定位当前、多项进行中时查看全部，以及键盘展开和详情焦点回退；重复打开同一节点会重新定位详情。
布局与主题：根据实际会话栏宽度排列，使用宿主自然滚动；支持深色界面与 75–150% 字号。仓库文档中的桌面、手机尺寸与完成标记核对示意图为更名前 alpha7 功能基线的合成示例，用于说明视图行为，不代表真人验收或新拍摄的 beta.1 截图。
数据边界（只读）¶
插件只使用宿主已公开的 Goal/Todo 投影、已加载工具生命周期以及直接子代理目录/状态。默认不读取聊天、推理、工具参数/返回正文、私有文件或凭据；不遥测、不上传、不添加定时或持久化业务数据。「刷新状态」只重读公开元数据，不会运行下一步或重试工具。正式目标/计划、会话标题和子代理名称可能包含敏感文本，插件不自动脱敏；详见仓库 PRIVACY.md。
兼容与规模上限（文档已声明）：最多保留 600 个进展事件、32 个工具节点、80 个计划项和 48 个直接子代理。图的分支表达分组、路线箭头表达阅读顺序，不推断执行依赖或工具归属。
安装与启用¶
npm beta 发行候选使用固定版本。确认 npm 版本记录 已存在后，可在兼容 DSH 的 插件 → 添加插件 中填写包规格，或运行：
dsh plugin --profile web add dsh-plugin-goal-map@0.2.0-beta.1
也可从仓库 Code → Download ZIP 下载解压，或使用经核对的 tarball；仓库根目录即插件包根目录（含 index.mjs、cordis.patch.yml、lib/client.js），无需再找内部子目录。
启用步骤概括如下：
- 使用上述 npm 固定版本，或本地解压目录、tarball 的绝对路径。
- 在 DSH 插件 → 添加插件 中填写包规格或路径，按宿主提示启用并刷新页面。
- 若会话里已有旧版「开发版会话流程图」bundle，先在插件页禁用旧 bundle，再启用本包；两者复用同一视图目标，不应同时启用。
文档声明已验证的宿主范围为 DSH Web 0.2.0-rc.2、宿主 React 18.3.1、Chromium；package.json 中 engines.dsh 与可选 peer 均为 0.2.0-rc.2。其他 DSH 版本、桌面变体或浏览器尚未在文档中声明验证。构建与测试需要 Node.js >=24（见仓库 README）。
插件以当前 DSH 进程权限运行；安装前请自行查看 源码 与 LICENSE，并固定 beta 版本，不把 beta 视为对所有宿主兼容。
典型用法¶
进入一个非空会话后，在顶部打开 流程图 → 总览图，也可使用 步骤列表（当前界面使用中文标签）。
需要回复模型或确认操作时，应回到对话处理；视图内的刷新仅更新元数据展示。
若从社区目录了解插件，可访问 SkillHub 条目 sensen-jo/dsh-plugin-goal-map 或 1024 Store 社区市场条目。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；静态收录（例如 awesome-deepseek-harness-plugins PR #657 合并）不代表插件运行验收。
适用场景与注意¶
适合谁：需要在 DSH Web 长会话中对照正式目标与计划、核对已报告步骤与剩余项，并希望在总览图/列表中快速定位的开发者或使用者；接受视图只读、进度为等权计划项统计而非验收或工时估计。
不适合或需知限制：依赖插件自动推进任务、改计划或读聊天正文时，本插件不提供这些能力。无有效计划时不应期待百分比；目标完成与计划未完成并存时需按界面提示自行核对。
问题反馈可走 GitHub Issues；描述问题时避免公开真实会话或敏感目标文本。
结尾¶
dsh-plugin-goal-map 把宿主已公开的目标与计划投影成 Web 内的只读路线、思维导图和步骤列表，便于在长会话里对齐「要求—进展—剩余」，而不另起模型或调度器。安装时固定 dsh-plugin-goal-map@0.2.0-beta.1，在 DSH Web 0.2.0-rc.2 环境下启用后，从会话顶部的流程图入口即可使用。
