前言¶
在 DSH 里推进项目时，门禁结论、里程碑、任务交接和人员分工往往分散在 project.json 和对话记录里。想一眼看清「当前过到哪道门、谁派给谁、证据在哪」，通常要在文件树和聊天里来回翻。下面介绍社区插件 dsh-workflow-panel（维护者 tucaogege，分类为客户端）：在 DSH 界面右下角提供一块只读面板，把项目组织、任务流、工序与验收结果集中展示，不写账本、不改状态。
这是什么¶
dsh-workflow-panel 是 DeepSeek Harness 的客户端 bundle 插件（当前 package 版本 0.1.1，MIT 许可）。官方简介：DSH workflow panel — read-only project board for DeepSeek Harness（gates, milestones, task flow, roster）。
它解决的是「可视化读项目快照」：数据全部来自你的 project.json，面板只做 GET 与展示，不派单、不审议、不写 state.json 或项目文件。
核心功能¶
装好后，从右下角「工作流面板」胶囊点开，可在一页里看到六段内容：
- 概览——项目名、预算、数据更新时间，以及任务数、完成率、过门率、人数等六格关键指标。
- 门禁六卡——G0 到 G5，每道门显示当前结论、应产出、已有证据；点证据可在面板内看原文。
- 里程碑——横向时间线，按日期排列；缺日期会明确标出。
- 组织模板——当前编制：成员、角色、模型、任务状态、职责。
- 任务流——派单与交接关系；连线按发送方上色，悬停可见任务对应关系。
- 人员卡——评分、模型、职责，以及逐条任务与完成依据。
交互上：面板默认收起为右下角胶囊；标题栏可拖动，右下角可拉伸；Esc 或「收起」关闭；胶囊可拖到屏幕任意位置。
v0.1.x 已知限制（资料原文）：派生层固定显示「派生 0（v1 无数据源）」；面板与胶囊位置重启后不持久化；跨行连线为行级锚点；任务与门禁结论需自行维护在 project.json，面板不负责录入。
安装与启用¶
前提：DSH 桌面版（带 profile / bundles），Node.js ≥ 20。
装之前建议备份 profile 的 package.json 与 cordis.patch.yml：DSH 异常退出后可能收窄 bundles 列表。
- 打开 DSH profile 目录下的
package.json，在dependencies与dsh.profile.bundles中加入插件（保留原有 bundles）：
{
"dependencies": {
"dsh-workflow-panel": "github:tucaogege/dsh-workflow-panel"
},
"dsh": {
"profile": {
"bundles": [
"<原有的 bundles 保持不动>",
"dsh-workflow-panel"
]
}
}
}
-
重启 DSH。宿主会按
dependencies安装（首次需联网拉取仓库）。若未自动安装，在 profile 目录执行pnpm install后再重启。 -
右下角出现「工作流面板」胶囊即表示安装成功。
卸载时：从 dependencies 与 bundles 中移除 dsh-workflow-panel，清理 node_modules 中对应链接，重启 DSH。插件不写文件，无残留数据需清理。
配置（可选）¶
默认自动发现项目文件：在 $DSH_HOME/bot/workspace/*/project.json 中取最近更新的一份。只跟踪一个项目时通常无需配置。
项目文件不在上述路径，或需固定某一项目时，在 profile 配置中指定：
{
"dsh-workflow-panel": {
"projectPath": "<你的项目目录>/project.json"
}
}
环境变量 DWP_PROJECT_PATH 可覆盖配置，优先级为：环境变量 > 配置 > 自动发现。
0.1.1 之前的版本没有自动发现，默认读插件同级的 project.json；若显示「项目文件不存在」，显式配置 projectPath 即可。
典型用法与只读边界¶
日常用法：在 DSH 中正常维护 project.json 与对话派活；需要核对门禁、里程碑或任务流时，打开工作流面板只读查看。证据文档通过面板内链接以 GET 拉取原文，不涉及写操作。
面板仅发 GET（数据快照与证据文档两条接口），不写任何文件。结论若显示「未评级 / 未提供」，表示 project.json 中未记账，而非渲染错误。
适用场景与注意¶
适合：已在 DSH 桌面版用 profile/bundles 管理项目、希望在一屏内只读浏览门禁、里程碑、组织与任务流的用户。
注意：
- 插件以当前 DSH 进程权限运行；安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。
- 已在当前 DSH 桌面版验证；更早版本与非桌面形态未验证（README 说明）。
- 面板数据格式与
project.jsonschema 绑定，格式变更见仓库 CHANGELOG。
DSH 生态理念是「一切皆插件」；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-workflow-panel 把项目快照做成右下角可拖动的只读看板：六段视图对应概览、门禁、里程碑、组织、任务流与人员，安装依赖 profile 的 package.json 与 bundle 声明即可。要进一步了解安装细节与限制，见 GitHub README 与 SkillHub 目录页。
