前言¶
DeepSeek Harness (DSH) 支持通过插件扩展能力，但社区生态庞大，插件来源、依赖与代码逻辑的未知风险较高。DeepAtlas (dsh-deepatlas) 是一个任务感知型插件导航工具，帮助 DSH 用户扫描生态、按任务推荐插件、安装前审计风险，并仅在用户明确同意后执行受控安装。
核心功能¶
DeepAtlas 提供以下能力：
* 任务感知导航：根据跨会话记忆、消息接入、浏览器自动化等能力需求，扫描并推荐候选插件。
* 生态扫描：从 GitHub 与社区来源扫描 dsh-plugin 生态，建立本地索引。
* 来源与证据：基于 provenance 推荐插件，并在完整 commit 下读取 manifest、README 等证据。
* 安装前审计：检查生命周期脚本、依赖形态、native 依赖、bundle patch 源码风险及 Node 兼容性。
* 受控安装：安装前创建 profile 快照，失败时触发恢复流程，仅支持明确授权的安装。
* 本地存储：索引、审计记录和安装状态保存在本地，GitHub Token 仅用于提高 API 配额。
安装与启用¶
DeepAtlas 处于 public preview 阶段，需要 DeepSeek Harness 0.1.1-rc.1 / 0.1.1-rc.2 及 Node.js ^22.19.0 || >=24.0.0。DSH 的插件管理命令会转发给 pnpm。
1. 安装插件¶
使用官方安装命令添加插件：
dsh plugin --profile web add https://codeload.github.com/Oscar-Williams/dsh-deepatlas/tar.gz/refs/tags/v0.2.3
2. 核对配置¶
安装完成后，检查配置是否生效：
dsh --profile web --dump-config
输出中应出现 dsh-deepatlas 或 deepatlas 配置层。
3. 启用真实安装¶
默认情况下 dryRun=true，仅生成计划。若需真实安装，需在 profile 配置中覆盖 deepatlas 配置项：
- id: deepatlas
config:
dryRun: false
典型用法¶
DeepAtlas 提供六个工具：deepatlas_scan、deepatlas_status、deepatlas_find、deepatlas_advise、deepatlas_audit、deepatlas_install。推荐流程为：状态检查 -> 扫描 -> 检索 -> 审计 -> 确认 -> 安装。
1. 描述任务并检索¶
在 DSH 中直接描述需求，宿主模型会调用相应工具。例如：
* “我想给 DSH 增加跨会话记忆，帮我比较合适的插件。”
* “找一个 Telegram 消息接入插件，先列候选和风险信号。”
2. 审计指定 commit¶
在选定候选后，检查指定 commit 的审计结果：
* “检查这个插件的指定 commit；展示审计结果后再询问我是否安装。”
3. 执行安装¶
用户确认后，DeepAtlas 会执行静态审计、兼容检查、快照、锁定安装与恢复流程。
适用场景与注意¶
- 适用场景：需要为 DSH 补充特定能力（如记忆、自动化）时，快速筛选安全候选；在安装陌生插件前，进行详细的代码级审计。
- 权限与安全：插件以当前 DSH 进程权限运行。索引、审计记录保存在本地，请确保
DEEPATLAS_GITHUB_TOKEN环境变量配置正确。 - 当前状态：DeepAtlas 处于 public preview，DeepSeek Harness 处于 Developer Preview。
结语¶
DeepAtlas 为 DSH 插件生态引入了能力覆盖检查与风险审计机制，让插件导航从“盲目选择”变为“证据化决策”。更多细节可参考其目录页或GitHub 仓库。
