前言¶
在 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 倉庫。
