工作区图谱 Asteroid-Code-Channel/dsh-workspace-atlas

工作区图谱

工作区图谱、AGENTS 编辑器，以及多来源技能目录，适用于 DeepSeek Harness / DSH NEXT。

工作区图谱给 DSH Web UI 加了一个整页面板，用来浏览已注册的工作区，并编辑其中的全局与工作区级指令文件。

这是社区插件，不是 DeepSeek 官方产品。

中文简介：工作区图谱是 DSH 的工作区关系图与根文件编辑器。列表视图按名称平铺工作区，只显示根 AGENTS.md 和 SKILL 汇总；树形视图按路径生成从左向右的森林。每个节点的 SKILL 按钮显示技能数量，点击进入技能管理器，支持 .dsh/skills/<name>/SKILL.md 的增删改、URL 导入和本地技能仓库。支持搜索定位、展开动画、备份、冲突检测和路径逃逸防护。

功能

- 两种视图，随时切换：
- 列表 —— 平铺工作区，按字母排序；每个工作区显示根 AGENTS.md 和带数量的 SKILL 汇总。
- 树形 —— 按工作区路径生成从左向右的森林。
- 树节点默认折叠。点击节点展开子节点。展开与折叠使用 220 ms 平滑动画。
- 树形搜索先只列出匹配的节点。选中结果后，展开它的祖先节点和完整子树，再滚动到可见位置。
- 每个树节点都有 SKILL 和 AGENTS 按钮：
- 有内容时显示绿色
- 无内容时显示橙色
- SKILL 还带一个数量框
- SKILL 打开多项目技能管理器：
- 原生技能位于 <workspace>/.dsh/skills/<name>/SKILL.md
- 旧版根 SKILL.md 单独保留一行
- 新建、编辑、删除、从原始 URL 导入、保存到本地库、从库安装
- 本地技能库位于 $DSH_HOME/workspace-atlas/skills。
- AGENTS 打开工作区根 AGENTS.md 编辑器。
- 全局 AGENTS.md 编辑器：$DSH_HOME/AGENTS.md。
- Markdown 文本编辑，保留 LF/CRLF 与 UTF-8 BOM。
- Ctrl+S / Cmd+S 保存，Tab 插入两个空格。
- 跟踪未保存改动、检测外部改动冲突、重新加载、删除。
- 页头版本按钮，检查 GitHub Release，并通过 DSH Plugin Manager 一键更新。
- 原子写入，自动备份到 $DSH_HOME/agents-manager-backups/。
- 全局技能管理位于 $DSH_HOME/skills。
- 中英文语言环境，使用 DSH 主题 token，不引入 Harness 私有 UI。

截图

Workspace list

Workspace tree

Skill catalog

技能目录

页头的 Skill catalog / 技能目录 按钮打开独立的目录视图：

- 四张来源卡片：Anthropic、OpenAI、Cursor、Matt Pocock
- 打开时同步目录，也可手动刷新
- 选中卡片后显示该仓库的技能
- 每行可安装到全局技能目录，或在 GitHub 上打开来源目录
- 索引缓存于 $DSH_HOME/workspace-atlas/catalog.json

来源：

| 卡片 | 仓库 |
| Anthropic | anthropics/skills |
| OpenAI | openai/skills |
| Cursor | cursor/plugins |
| Matt Pocock | mattpocock/skills |

从目录安装会下载所选技能目录里的全部文件，不只是 SKILL.md。安装位置是 $DSH_HOME/skills/<name>，已存在的技能不会被覆盖。

安装

要求：

- DeepSeek Harness / DSH NEXT，带 Web UI 和 Plugin Manager
- Node.js >=22.19.0

克隆本仓库，再把该目录作为 bundle 安装到桌面应用所用的配置档：

git clone https://github.com/Asteroid-Code-Channel/dsh-workspace-atlas.git

在 DSH 中打开 Plugin Manager，安装克隆下来的目录；也可以让智能体执行：

请把 <absolute-path-to>\dsh-workspace-atlas 作为 bundle 安装到当前 profile。

等价的 plugin_manager 调用：

plugin_manager
action: install_bundle
target: <absolute-path-to>\dsh-workspace-atlas

安装完成后刷新 Web UI。更新 Host 侧 JavaScript 后，重启桌面应用。

如果用的是其他桌面 UI，就在那个配置档里重复一遍安装。

使用

1. 打开侧边栏中名为 Workspace Atlas / 工作区图谱 的入口。
2. 选 List / 列表，按字母顺序平铺查看。
3. 选 Tree / 树形，查看工作区森林。
4. 点击节点卡片即可展开。
5. 用 SKILL 管理该工作区的原生技能和遗留的根 SKILL.md。
6. 用 AGENTS 编辑工作区根目录的 AGENTS.md。
7. 在列表视图里用全局卡片编辑 $DSH_HOME/AGENTS.md，或管理 $DSH_HOME/skills。
8. 用页头的 Skill catalog 全局同步并安装公开技能。

文件规则

- 树形的父子关系由已注册的工作区路径推导得出。DSH 工作区注册表不会被修改。
- 没有已注册祖先的工作区，会成为一棵根树。
- 原生项目技能：<workspace>/.dsh/skills/<name>/SKILL.md。
- 如果存在遗留的根 <workspace>/SKILL.md，SKILL 也会显示它。
- AGENTS 编辑工作区根目录的 AGENTS.md。
- 删除技能时，技能目录会被移到 $DSH_HOME/workspace-atlas/trash/。
- 本地技能库是 $DSH_HOME/workspace-atlas/skills/<name>/SKILL.md。
- URL 导入只下载一个 SKILL.md，不会抓取技能的辅助文件。
- 列表只显示根 AGENTS.md 和 SKILL 摘要；嵌套的 AGENTS.md 不列出。

版本更新

页头显示已安装的版本。点击它可检查最新的 GitHub Release。

更新源按以下顺序解析：

1. bundle 的 cordis.patch.yml 行配置里的 updateRepository
2. package.json 里的 repository

取值用 owner/repo 格式。创建 GitHub 仓库后，加上：

"repository": {
"type": "git",
"url": "https://github.com/Asteroid-Code-Channel/dsh-workspace-atlas.git"
}
有更新的 Release 时，对话框可以调用 DSH Plugin Manager 的 installBundle，参数为 github:<owner>/<repo>#<tag>。Host 更新后需要重启。如果 Plugin Manager 没有暴露 installBundle，对话框仍会给出 Release 页面链接，供你手动更新。

Host API

Host 这一半注册以下同源端点：

| 方法 | 路径 | 用途 |
| GET | /api/dsh-agents-manager/state | 全局文件、工作区、AGENTS/SKILL 元数据、版本 |
| POST | /api/dsh-agents-manager/read | 读取目标 |
| POST | /api/dsh-agents-manager/save | 原子保存 + 备份 |
| POST | /api/dsh-agents-manager/delete | 删除 + 备份 |
| POST | /api/dsh-agents-manager/skills/list | 列出原生技能与旧版技能 |
| POST | /api/dsh-agents-manager/skills/create | 创建原生技能 |
| POST | /api/dsh-agents-manager/skills/import | 从 URL 导入 SKILL.md |
| POST | /api/dsh-agents-manager/skills/delete | 把原生技能移入回收站 |
| GET | /api/dsh-agents-manager/skills/library | 列出本地技能库 |
| POST | /api/dsh-agents-manager/skills/library/save | 把工作区技能复制到技能库 |
| POST | /api/dsh-agents-manager/skills/library/install | 把技能库中的技能安装到工作区 |
| GET | /api/dsh-agents-manager/catalog | 同步 GitHub 技能目录 |
| POST | /api/dsh-agents-manager/catalog/install | 全局安装目录中的技能 |
| GET | /api/dsh-agents-manager/update | 检查 GitHub Releases |
| POST | /api/dsh-agents-manager/update/apply | 安装校验通过的 release tag |

目标：

{ "scope": "global" }
{ "scope": "global", "skillName": "my-skill" }
{ "scope": "workspace", "workspaceId": "…", "file": "agents" } { "scope": "workspace", "workspaceId": "…", "file": "skill" } { "scope": "workspace", "workspaceId": "…", "skillName": "my-skill" }

写操作要求 Host 为回环地址，且 Origin 匹配、带 x-dsh-agents-manager: 1、Content-Type: application/json。工作区目标会经过 realpath 校验；..、绝对路径、符号链接逃逸、以及受管集合之外的文件名一律拒绝。单文件上限 2 MiB。

开发

node --check .\index.js
node --check .\lib\store.js
node --check .\client.js
node .\test\store.test.mjs
node .\test\http.test.mjs
node .\test\client.test.mjs
node .\test\update.test.mjs
node .\test\catalog.test.mjs

测试使用工作区内的临时目录，不会写入真实的 $DSH_HOME。

已知限制

- 全局/工作区的 AGENTS.md 文件只有在启用 @deepseek-ai/dsh-agent-instructions（或当前配置档对应的加载器）时才影响模型。在测试过的桌面配置档中，这一项是关闭的。
- 编辑文件不会重写已经注入到打开会话中的历史。
- Workspace Atlas 直接管理 .dsh/skills 目录，但不是完整的技能市场：不支持浏览 GitHub 仓库树、解析依赖、启用/禁用策略，也没有指令预算。
- URL 导入只下载单个 SKILL.md；辅助文件需要手动添加。
- 旧版根目录 SKILL.md 仍受支持，以保持向后兼容，但它不是 DSH 原生项目技能。

许可证

MIT。见 LICENSE。