前言¶
DeepSeek Harness (DSH) 的核心設計理念之一是「一切皆插件」，通過組合原生能力與外部插件來擴展智能體行爲。在處理全棧工程任務時，常見的痛點包括缺乏結構化的執行流程、敏感操作缺乏邊界約束、以及完成狀態缺乏證據支撐。adithya-hmt/fullstack-expert 旨在解決這些問題，它不是更聰明的模型，而是圍繞 DSH 現有能力構建的一套嚴謹的工程循環與安全層。
插件定位¶
名稱：adithya-hmt/fullstack-expert
核心價值：Cordis-native（基於 Cordis 框架）、證據驅動的全棧工程規範。
定位：它爲 DeepSeek Harness 編碼智能體提供了一套工作流與安全機制，將倉庫檢查、垂直切片規劃、敏感操作邊界和驗證證據記錄流程化。
核心功能¶
該插件提供了一套完整的工程化手段，主要包括以下方面：
- 作用域方法論提示：定義了從理解代碼、檢查現狀、設計架構、制定計劃、實現功能、測試、審覈到最終驗證的完整閉環。
- 關鍵操作：
fullstack_plan：用於處理實質性工作，進行有界倉庫檢查並制定垂直切片計劃。fullstack_check：用於結構化檢查、命令驗證或 Supabase 檢查，並記錄非驗證類的審覈事實。
- 安全與治理：
- 敏感操作邊界：明確區分敏感操作。
- 權限分類：對操作進行分類。
- 審批感知預執行門：在執行敏感操作前檢查審批狀態，若無法審批則拒絕執行。
- 複雜度治理決策：基於需求、複用情況、依賴關係和安全控制進行決策。
- 證據與驗證：
- 驗證證據記錄：要求必須通過原生 Harness 的證據記錄才能完成。
- 只讀 Supabase 項目證據檢測：在只讀模式下檢測 Supabase 項目狀態。
- 會話/工具結果觀察：利用 Harness 的
session/event和tools/result進行觀察。
安裝與啓用¶
在安裝前，請確保已安裝 DeepSeek Harness CLI。可以通過以下命令將插件作爲配置文件集安裝：
dsh plugin --profile web add git+https://github.com/adithya-hmt/fullstack-expert.git#v0.1.1
安裝完成後，可以通過 dsh --profile web --dump-config 確認配置已生效，隨後啓動 Harness。若需手動配置，需確保宿主編排包含原生 Harness 行（如 dsh-fs, dsh-shell, dsh-tools 等），並將插件提供的 cordis.patch.yml 疊加到配置中。
使用方法¶
使用該插件時，需遵循特定的操作流程以確保工程規範落地：
- 準備編排環境：啓動一個包含插件和原生 Harness 文件系統/工具/技能行的編排環境。
- 提出任務：向智能體請求功能開發、Bug 修復、代碼審查、重構或應用構建。
- 執行規劃：對於實質性工作，智能體應調用
fullstack_plan進行倉庫檢查，並制定垂直切片計劃。 - 結構檢查：使用
fullstack_check進行結構、命令或 Supabase 的只讀檢查，並記錄審覈事實。 - 完成驗證：只有當通過原生 Harness 的驗證證據記錄且無相關失敗時，才能視爲任務完成。
適用場景與注意事項¶
該插件適用於需要嚴格工程規範和審計痕跡的全棧開發場景。使用時需注意以下幾點：
- 能力邊界：插件本身不提供瀏覽器驅動、Shell 執行器、文件系統後端、Dev Server 註冊表、Supabase SDK、數據庫客戶端、部署適配器或模型提供商。它複用宿主 Harness 的能力，瀏覽器驗證目前僅限於指南加證據記錄（直到穩定的瀏覽器工具組合形成）。
- Supabase 操作：目前 Supabase 操作僅爲檢測和建議，敏感操作（如遷移、登錄、推送等）必須由用戶顯式執行。
- 模型配置：插件假定 GPT-5.6 Max 已在 Harness 模型路由中配置，且配置文件中不應包含憑證。
- 許可證：該插件爲 MIT 許可證。
結語¶
Fullstack Expert 通過定義明確的操作節點（fullstack_plan, fullstack_check）和嚴格的驗證證據要求，幫助 Harness 智能體從「猜測式」編碼轉向「證據驅動」的工程實踐。對於追求代碼質量和操作安全的團隊，這是一個值得納入工作流的插件。
