前言¶
在 DSH（DeepSeek Harness）裏讓智能體參與「從需求到上線」的全流程時，常見問題是：先寫代碼、後補 UX 與安全，RAG 與 subagent 沒有退出標準，發佈時只剩一串鏈接、沒有可覈驗的證據。dsh-fullstack-engineer（倉庫 yinbo-liao/DSH-full-stack-engineer-plugin）不是代碼生成器，而是一套規劃與評審工具：用固定工程順序和門禁，把「可交付」拆成可檢查的工件。社區目錄見 SkillHub 插件頁；分類爲工作流，與 DSH「一切皆插件」的生態一致，目錄站點獨立於 DeepSeek / 幻方，並非官方應用商店。
這是什麼¶
維護者 yinbo-liao。包名 dsh-fullstack-engineer，當前版本 0.1.0（MIT）。插件向智能體提供 full-stack engineering operating contract：範圍化需求、UX 模式、安全與可靠性、基於 LangChain / LangGraph 的分步 RAG，以及面向 subagent 的 harness / loop 工程約定。README 明確：它是 planning and review instrument，不替你把應用生成出來，而是強制順序與證據，使應用具備可發佈條件。插件本身無網絡、文件系統或進程訪問；實際校驗由宿主或 CI 承擔。
核心工具與輸出¶
下面六個工具在 README 中有對應輸出說明；另有一份系統提示片段 fullstack-engineer:playbook，寫明不可妥協的工程順序。
| 工具 | 主要輸出 |
|---|---|
fullstack_plan |
Jobs、非目標、驗收標準、UX 流/狀態、架構、威脅模型、SLO、交付門禁、完成定義 |
fullstack_ux_review |
按屏狀態矩陣、模式匹配、可訪問性、文案規則、反模式 |
fullstack_security_review |
設計級威脅模型（對象授權、租戶隔離、注入、SSRF、密鑰、CSRF、審計、AI 邊界）及控制與測試 |
fullstack_rag_blueprint |
十步 RAG：源與 ACL 清單 → 攝入 → 解析 → 分塊 → 嵌入/索引 → 混合檢索/重排 → grounded 生成 → 評估 → 觀測 → 運營 |
fullstack_subagent_plan |
Supervisor 與 worker 契約、允許工具、循環預算、無進展/停止規則、harness 要求、門禁、紅隊用例 |
fullstack_gate |
針對命名工件的 pass/hold，及關門所需證據記錄 |
插件強制的工程順序¶
README 將流程固定爲六步，與門禁鏈 scope → ux → build → reliability → rag → harness → release → outcome 一致（GATE_G 僅用於擴展；KPI/護欄失敗不阻塞發佈或回滾）。
- Frame：用戶、jobs、非目標、約束、驗收、單一成功 KPI。
- UX：流程與各狀態（
default、loading、empty、partial、error、offline、permission-denied、success），可訪問性與文案。 - Contract：API、數據模型、授權、遷移、回滾。
- Threat model：對象授權、多租戶、注入、SSRF、密鑰、CSRF/會話、審計；AI 側含 prompt 注入、RAG ACL 泄漏、工具濫用。
- Evaluate：語料歸屬/ACL、golden set、閾值；在 RAG 或 subagent 之前先定義回滾。
- Release evidence：記錄須含 producer、commit、範圍與新鮮度，不能只有 URI。
RAG 藍圖要點（LangChain / LangGraph）¶
fullstack_rag_blueprint 採用分步設計，每階段有退出標準。LangChain 作爲組件工具集（如 DocumentLoader、TextSplitter、VectorStore、Retriever、RunnableParallel、reranker）；需要有界多步狀態時用 LangGraph 編排。設計要點包括：混合檢索（BM25 + 向量）、評分前 ACL 過濾、top-20 召回後重排至 5；500–800 token 分塊、15% overlap、父文檔擴展；引用或拒絕、不給出無依據答案；50+ 題的 golden set（含拒絕與注入）；閾值示例 recall@5 ≥ 0.85、faithfulness ≥ 0.90、citation precision ≥ 0.90、refusal correctness ≥ 0.95；token/成本/延遲預算與周反饋循環。
Subagent harness¶
fullstack_subagent_plan 產出 supervisor + 類型化 worker（product、UX、backend、frontend、security、verifier），一次只路由一個、上下文預算紀律、迭代/工具調用上限、無進展規則、停止條件、審批門禁、僅追加審計預期，以及「自批證據」「跳過 verifier」等紅隊場景。
與 dsh-secure-mesh 的集成¶
若已安裝 dsh-secure-mesh，提示會引導智能體對外部 HTTP 使用 secure_fetch（禁止裸出口）、不可逆/高影響操作前 request_human_approval（僅 approved: true 授權）、對 SQL/Python/金融類主張使用 validate_claim，並對檢索與外部文本應用不可信數據圍欄規則。
安裝與啓用¶
包聲明瞭 dsh.bundle.patch，可按任意 DSH bundle 方式安裝。README 原文步驟如下。
- 發佈/安裝包
dsh-fullstack-engineer@0.1.0，或使用 Git checkout。 - 在 Plugins 頁面添加 bundle，或將
cordis.patch.yml中的fullstack-engineer條目寫入 profile。 - 重啓或重載 profile。
依賴要求（package.json）：engines.dsh 爲 >=0.2.0 <0.3.0；peer 含 @deepseek-ai/cordis、@deepseek-ai/dsh-system-prompt、@deepseek-ai/dsh-tools 等對應版本區間。
本地開發可先構建與 stub 測試：
npm install
npm run build
npm run test:stub
在禁止 Node 測試子進程的沙箱中，可按 README 使用 in-process 測試命令（node --test --test-isolation=none 等）。與真實 profile 聯調時，README 示例爲本地路徑添加插件後跑 integration.real.test.mjs（路徑因環境而異，以你本機 checkout 爲準）。
配置項¶
| Key | 默認 | 作用 |
|---|---|---|
rigor |
standard |
lean、standard 或 regulated；regulated 增加審批/審計預期 |
defaultStack |
FastAPI + PostgreSQL + React |
brief 未指定棧時的默認 |
prompt |
true |
是否向系統提示貢獻 playbook 段 |
plan、uxReview、securityReview、ragBlueprint、subagentPlan、gate |
true |
是否註冊各工具 |
maxOpenQuestions |
8 |
開放問題上限（3–20） |
典型用法（工作流層面）¶
資料未給出單條 CLI 對話示例，但工具設計暗示可按門禁順序調用：先用 fullstack_plan 定範圍與驗收，再用 fullstack_ux_review / fullstack_security_review 對齊界面與安全設計；若要上 RAG，在實現前跑 fullstack_rag_blueprint 對齊十步與閾值；多智能體方案用 fullstack_subagent_plan；各階段產出齊全後由 fullstack_gate 判定 pass/hold。Playbook 段（prompt: true 時）會把上述順序寫進系統提示，減少智能體跳步。
適用場景與限制¶
適合：需要在 DSH 裏做全棧/feature 交付規劃、評審 UX 與安全、起草 RAG 或 subagent 方案、用統一門禁收束證據的團隊或個人。
注意（均來自 README）：
- 規劃是確定性強、帶觀點的，不能替代產品發現。
- 威脅模型在設計層，列的是應有測試，不聲稱已執行。
- 不部署、不遷移、不調提供商、不寫代碼。
- 證據真僞由宿主/CI 驗證；gate 只說明必須具備什麼。
- 安裝前請自行審閱倉庫源碼與 MIT 許可證；插件在 DSH 進程權限下運行，與其他插件疊加時需評估整體暴露面。
結尾¶
dsh-fullstack-engineer 把全棧交付從「憑感覺做完」改成「按順序產出、用證據過門」——規劃、UX、契約、威脅模型、評估與發佈記錄一環扣一環，並單獨覆蓋 RAG 十步與 subagent harness。若你在 Harness 裏做複雜功能而不是單次腳本，可把該 bundle 當作工作流基線。
- 目錄頁：https://www.skillhub.cn/plugins/yinbo-liao/DSH-full-stack-engineer-plugin
- GitHub：https://github.com/yinbo-liao/DSH-full-stack-engineer-plugin
