dsh-archscope：基於證據的 DeepSeek Harness 系統架構偵察

DeepSeek Harness（DSH）插件生態中，當智能體首次進入大型代碼庫時，最容易得到的結果往往是“局部正確但全局錯誤”的結論。例如，僅憑目錄結構假設業務邊界，或者忽略系統間依賴關係。lvxinrong/dsh-archscope 針對這一痛點，提供了一套基於證據的系統架構偵察方案，旨在幫助 AI 真正接管陌生的軟件系統，而非僅僅瀏覽目錄或生成空洞的摘要。

插件定位¶

dsh-archscope 是一個面向 DeepSeek Harness 的工作流插件。它專注於“證據驅動”的系統架構偵察，支持源碼發現、證據收集、系統建模與項目剖析。插件採用分層分析模型來控制結論的邊界，確保從系統世界觀到代碼執行路徑的每一層分析都有據可依。

核心功能¶

插件具備以下核心能力：

Evidence-driven system architecture reconnaissance：基於證據的系統架構偵察，拒絕未經證實的結論。
Source discovery and evidence collection：自動發現源碼並收集證據。
System modeling and project profiling：建立系統世界觀與工程配置檔案。
Layer gates, parallel orchestration, deterministic validation：通過分層門控、並行編排和確定性驗證保證分析質量。
Architecture portal：提供可視化的架構門戶。
Native to plugin runtime：原生適配 DSH 插件運行時（Cordis 服務、能力提供者）。
Multi-repository support：支持多倉庫分析，項目身份基於工作區相對路徑。

分析模型¶

插件採用分層模型來控制分析順序和結論邊界：

System（系統層）：定義世界觀，確定系統的邊界、入口、項目和基礎設施。
Project（項目層）：定義工程配置，明確項目在系統中的角色、構建、運行和連接方式。
Internal map（內部映射）：識別業務能力候選、技術組件和契約組件。
Module study（模塊研究）：分析單一職責的邊界、入口、數據和依賴。
Code trace（代碼追蹤）：追蹤具體端點、任務、消息或異常的執行路徑。

使用方式¶

在使用插件時，應遵循以下流程：

建立世界觀：在剖析項目之前，先確立系統級別的通用事實，確保所有代理共享上下文。
證據驗證：所有重要結論必須指向可審查的證據；未證實的部分必須標記。
信封協議：證據和寫代理通過“短信封”協議接收初始信息，包含運行 ID、項目身份和工具名稱，後續通過只讀工具獲取系統事實和模板。
有界批處理：對於單項目或多項目請求，使用有界批處理引擎，確保每個項目獲得隔離的證據和寫代理。

安裝與狀態¶

目前該插件尚未發佈到 NPM 包管理器，需通過 GitHub 倉庫獲取源碼。插件當前版本爲 v0.3.3，處於活躍開發階段。

package.json 信息

{
  "name": "dsh-archscope",
  "version": "0.3.3",
  "description": "Evidence-driven system architecture reconnaissance for DeepSeek Harness",
  "license": "MIT",
  "type": "module"
}

注意事項¶

運行時證據：運行時證據和恢復編排功能仍在開發中。
項目身份識別：插件的項目身份識別基於工作區相對路徑，而非目錄名稱。這意味着同名目錄或嵌套倉庫不會被靜默合併。
權限與安全：插件作爲 DSH 插件運行，需在安裝前檢查源碼與許可證（MIT）。

對於需要在 DeepSeek Harness 中進行嚴謹架構分析的開發者，ArchScope 提供了一套標準化的偵察協議。

目錄頁：[catalog_url]
GitHub 倉庫：[github_url]