前言¶
在 DeepSeek Harness（DSH）里做项目评估时，选题表单、成本估算、信号可信度、代码/项目图谱往往是几块独立能力，各自有入口、数据也不互通。要在「这个机会值不值得做」上形成一致结论，需要在多个界面之间来回切换，重复填写上下文。
dsh-project-cockpit（维护者 Boris-boomer，分类：客户端）把 GapForm 选题、AI 成本分析、ShipSignal 信号评分、CodeConstellation 图谱四个引擎收进统一的 webServer 路由，并在客户端提供右下角浮动面板，用编排页签一次跑通：一个机会 → 一张决策卡 + 一张图谱。社区目录页见 skillhub.cn，源码与说明见 GitHub。目录站点为社区生态索引，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
一句话定位：DSH 项目驾驶舱总控插件——整合上述四大引擎为统一后端路由 + 浮动 UI，把并排摆放的能力串成可执行工作流。
四个引擎原本独立并列；插件的编排层按固定顺序串联：
scoreMatch：六维评分 + verdict（capability < 0.5一票否决）；verdict=kill则提前终止。assessSignal：评估机会来源可信度。analyze：按能力缺口折算投入规模，计算回本周期。buildProjectGraph：将决策卡挂成图谱节点，与目标项目连边。
输出侧合成 decisionCard：值不值得做、要花多少钱、信不信得过。
当前 package 版本为 0.2.0，许可证 MIT。
核心功能¶
浮动面板与五个页签¶
在 DSH 客户端点击右下角面板入口（README 中以卫星图标标识），可切换五个页签：
| 页签 | 功能 |
|---|---|
| 编排 | 一次输入 → 四引擎串联，输出决策卡 + 图谱 |
| 选题 | 机会/能力结构化表单 → 六维评分条 + 判定徽章 + 差距清单 |
| 成本 | 模型/场景/职业下拉 → 指标卡片 + 回本建议 |
| 信号 | 可验证性/付费/时间序列 → 置信徽章 + 理由清单 |
| 图谱 | 扫描 + 项目/关系编辑 → Canvas 2D 力导向星座图 |
客户端状态收敛在 CockpitStore，跨页签共享同一份机会/能力数据。
webServer 路由¶
所有路由前缀为 /__dsh/project-cockpit，均要求请求头 X-DSH-Request: project-cockpit。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /meta |
模型、职业、场景清单 |
| POST | /match |
六维匹配评分 |
| POST | /cost |
本地部署 vs API 回本分析 |
| POST | /signal |
信号真实性评分 |
| POST | /scan |
目录扫描 |
| POST | /graph |
项目图谱构建 |
| POST | /validate |
能力提取结果校验 |
| POST | /prompt |
能力提取 prompt 构建 |
| POST | /pipeline |
四引擎串联 |
| POST | /pipeline-stages |
编排阶段自述 |
引擎层为纯函数（零 UI 依赖），业务判据集中在 src/engines/constants.mjs，由测试守护。
安装与启用¶
本插件作为 workspace 内插件 使用，安装步骤以 README 为准：
pnpm install
pnpm build # 生成 lib/client.js
在 DSH 的插件配置中挂载本包；仓库内 cordis.patch.yml 已声明 insert 条目，无需手动注册。package.json 中 dsh.client.inject 为 dsh-project-cockpit，dsh.bundle.patch 指向 ./cordis.patch.yml。
注意：lib/ 纳入版本控制；修改 src/client/ 后须先执行 pnpm build 再提交，否则远程上的 client 产物会过期。
典型用法¶
- 在 workspace 中完成
pnpm install与pnpm build，并按 DSH 文档挂载插件包。 - 启动 DSH 后打开右下角驾驶舱面板。
- 若要从零跑完整链路：在 编排 页签输入机会与能力上下文，触发四引擎 pipeline，查看决策卡与图谱结果。
- 若只需单步能力：分别使用 选题、成本、信号、图谱 页签，或直接向对应 POST 路由发请求（需带
X-DSH-Request: project-cockpit）。
开发侧自检命令：
pnpm test # 37 项测试（引擎判据 + 编排判据 + 生命周期）
pnpm run doctor # 自检：patch name / exports / host 入口
pnpm typecheck # tsc --noEmit
适用场景与注意¶
适合谁：在 DSH 里需要结构化评估「机会—能力匹配、成本回本、信号可信度、项目关系」的开发者；希望用一条 pipeline 得到决策卡而不是在多个插件间手工拼结论时，编排页签是主要入口。
权限与安全：插件随当前 DSH 进程运行，具备与该进程相同的文件与网络访问能力。安装前请阅读源码与 MIT 许可证，确认路由与扫描类接口（如 /scan）符合你的 workspace 安全策略。
设计约束（便于二次开发）：资源（DOM、React root、icon、settings slot）通过 ctx.effect 注册 disposer，HMR / dispose 时自动清理；编排逻辑在 src/pipeline.mjs，host 路由在 src/host/（一文件一路由）。
结尾¶
dsh-project-cockpit 把四个原本独立的评估引擎收成统一路由与浮动面板，用编排层把「评分 → 信号 → 成本 → 图谱」连成可复现流程，并输出决策卡。若要浏览插件条目或克隆源码，可分别打开 社区目录页 与 GitHub 仓库。
