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]
