前言¶
DeepSeek Harness（DSH）的生态设计强调「一切皆插件」。在开发过程中，管理文件引用、技能调用、历史会话和插件状态往往需要分散的操作入口。dsh-atlas 插件旨在解决这一碎片化问题，通过一个统一的 @ 触发器，将所有资源类型集中到一个菜单中。
这是什么¶
dsh-atlas 是一个 DSH 客户端插件，核心口号是 “AT Last, All Sources. One @ . Jump anywhere.”。
它为 DeepSeek Harness 的 Web GUI 提供统一的 @ 提及功能，允许用户在一个菜单中访问：
* 工作区文件和文件夹
* 可发现技能
* 历史会话
* 已安装插件
* 工作区 Git 变更
* 第三方插件注册的自定义类别
插件通过元数据注入引用标记，而非直接注入文件内容，从而保持引用的轻量化和可控性。所有者：jameswatt139240-crypto，许可证：MIT。
核心功能¶
统一资源菜单¶
输入 @ 即可触发菜单，包含五个内置分类以及一个内置的 @git 分类（用于查看工作区变更）。第三方插件可以通过注册机制将自己的类别添加到同一个菜单中。
引用机制与约束¶
- 元数据注入：引用通过标记（如
<workspace-reference>,<skill-reference>）注入，插件读取目录元数据，Agent 在需要时才读取文件本身。 - 约束管理：插件对版本和配置有约束管理能力，确保环境一致性。
工作区 Git 集成¶
内置 @git 分类，用于查看工作区的文件变更（路径 + 增删行数），提供变更追踪能力。
安装与启用¶
安装前需确保已安装带有 web profile 的 DSH。
dsh plugin --profile web add github:jameswatt139240-crypto/dsh-ATLAS
安装或更新后，重启 dsh web 以确保 Host 和浏览器客户端加载相同版本。
典型用法¶
触发菜单¶
在编辑器中输入 @ 即可唤起包含所有类别的菜单。
分类前缀与快捷键¶
不同资源类型使用特定前缀和快捷键：
* file: - 文件 (F)
* folder: - 文件夹 (D)
* skill: - 技能 (S)
* chat: - 历史会话 (C)
* plugin: - 插件 (P)
搜索与过滤¶
- 快速搜索：输入字母可快速搜索所有类别。
- 范围限定：使用文件夹引用限定文件搜索范围。例如
@e:/work/docs/ @file:将限定搜索该目录下的文件。 - 会话切换：点击会话引用可直接切换当前会话。
适用场景与注意¶
适用场景¶
适合需要在一个界面中频繁切换不同类型资源（文件、技能、对话、Git 变更）的开发者或智能体工作流。
兼容性注意¶
- 互斥性：该插件与
dsh-at-file互斥，只能安装其中一个，不能同时运行。 - 配置要求：配置中必须提供
scopes和testedOn。 - 内存限制：引用和步骤有严格的内存预算限制（16 KiB/引用，48 KiB/步骤）。
- 权限与安全：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
总结¶
dsh-atlas 通过统一的 @ 触发器和元数据驱动的引用机制，为 DSH 提供了一个集中式的资源导航入口。它支持 Git 变更查看和第三方扩展，旨在简化智能体开发中的资源管理流程。
