前言¶
在 DeepSeek Harness(DSH NEXT)里做智能体开发时,指令往往分散在多处:全局与工作区根目录的 AGENTS.md、项目下的 .dsh/skills/<name>/SKILL.md,还有 $DSH_HOME/skills 里的全局技能。手工在文件管理器和编辑器之间切换,很难一眼看清「哪些工作区配了什么」;从公开仓库挑技能安装,也要自己找目录、拷贝文件。下面介绍社区插件 AGENTS & Skills Studio(包名 dsh-workspace-atlas),它提供全页面工作台,把上述文件集中浏览、编辑,并对接四个公开技能目录。
这是什么¶
AGENTS & Skills Studio 是面向 DSH NEXT Web UI 的全页面插件,由 Asteroid-Code-Channel 维护(当前包版本 0.3.2,许可证 MIT)。README 明确说明:这是社区插件,不是 DeepSeek 官方产品。
它管理两类工作区指令文件:
- 全局
$DSH_HOME/AGENTS.md与各工作区根AGENTS.md - 项目原生技能
<workspace>/.dsh/skills/<name>/SKILL.md、遗留的根目录<workspace>/SKILL.md,以及全局技能目录$DSH_HOME/skills
此外支持本地技能库、URL 导入,以及从 Anthropic、OpenAI、Cursor、Matt Pocock 四个公开目录整目录安装技能。
核心功能¶
工作区视图¶
插件提供两种可随时切换的视图:
- 列表(List):按字母序平铺已注册工作区;每项展示根
AGENTS.md与 SKILL 摘要(含数量)。列表里还有全局卡片,用于编辑$DSH_HOME/AGENTS.md和管理$DSH_HOME/skills。 - 树形(Tree):按工作区路径从左到右展开森林;节点默认折叠,点击展开子节点(220 ms 动画)。树形搜索先只列出匹配节点,选中后会展开祖先与完整子树并滚动到视区内。
每个树节点带有 SKILL 与 AGENTS 按钮:有内容时为绿色,无内容时为橙色;SKILL 还带数量框。
说明:树的父子关系来自 DSH 已注册的工作区路径,不会修改工作区注册表;列表只展示根 AGENTS.md 与 SKILL 摘要,不列出嵌套的 AGENTS.md。
SKILL 与 AGENTS 编辑¶
- SKILL 打开该工作区的技能管理器:原生
.dsh/skills/<name>/SKILL.md、遗留根SKILL.md(单独一行)、新建/编辑/删除、从原始 URL 导入、保存到本地库、从本地库安装。 - AGENTS 打开该工作区根
AGENTS.md编辑器;全局卡片对应$DSH_HOME/AGENTS.md。
编辑能力包括:Markdown 文本编辑并保留 LF/CRLF 与 UTF-8 BOM;Ctrl+S / Cmd+S 保存,Tab 插入两空格;未保存变更跟踪、外部修改冲突检测、重载与删除。写入采用原子写,自动备份目录为 $DSH_HOME/agents-manager-backups/。
新建与编辑原生技能遵循 Agent Skills 规范,表单字段包括 name(必填)、description(必填)、license、compatibility、metadata、allowed-tools 以及 Markdown 正文,生成带 YAML frontmatter 的 SKILL.md。编辑页另有文件标签页,可在技能目录内创建嵌套文件与文件夹、重命名技能父目录(子文件一并移动)、编辑辅助文件、删除文件或目录,并通过路径校验防止逃出技能目录。遗留根 SKILL.md 仍使用纯 Markdown 编辑器。
删除技能时,目录会移到 $DSH_HOME/workspace-atlas/trash/。
技能目录(Skill catalog)¶
页眉 Skill catalog / 技能目录 打开独立目录视图:四张来源卡片,打开时同步索引,可手动刷新;选中卡片展示该仓库下的技能列表;每行可安装到全局技能目录,或打开 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>,且拒绝覆盖已存在的同名技能。
本地技能库路径:$DSH_HOME/workspace-atlas/skills/<name>/SKILL.md。URL 导入仅下载单个 SKILL.md,不会拉取技能的辅助文件。
版本与界面¶
页眉显示已安装版本,点击可检查 GitHub Release 最新版,并可通过 DSH Plugin Manager 一键更新(更新源优先读 bundle 的 cordis.patch.yml 中 updateRepository,否则读 package.json 的 repository)。Host 侧更新后需重启桌面应用。
界面支持中英文,使用 DSH 主题 token,不依赖私有 Harness UI 导入。
安装与启用¶
环境要求(来自 README):
- 带 Web UI 与 Plugin Manager 的 DeepSeek Harness / DSH NEXT
- Node.js >= 22.19.0
在本地已有插件目录的前提下,在 DSH 中打开 Plugin Manager,将该目录作为 bundle 安装到桌面应用使用的 profile;也可让智能体执行等价操作:
请把 <absolute-path-to>/dsh-workspace-atlas 作为 bundle 安装到当前 profile。
或使用 Plugin Manager 的 install_bundle:
plugin_manager
action: install_bundle
target: <absolute-path-to>/dsh-workspace-atlas
安装后刷新 Web UI;若更新了 Host 侧 JavaScript,需重启桌面应用。若使用另一套桌面 UI,需在该 profile 下重复安装。
源码与 bundle 可从 GitHub 仓库获取:https://github.com/Asteroid-Code-Channel/dsh-workspace-atlas。社区插件目录页:https://www.skillhub.cn/plugins/Asteroid-Code-Channel/dsh-workspace-atlas(SkillHub 为独立社区站点,与 DeepSeek / 幻方无官方从属关系)。
典型用法¶
经过上面的安装步骤后,可按 README 中的顺序使用:
- 在侧栏打开 AGENTS & Skills Studio / AGENTS & Skills 工作台。
- 选 List / 列表 做平铺总览,或 Tree / 树形 按路径浏览工作区森林。
- 在树形视图中点击节点卡片展开子节点。
- 用 SKILL 管理该工作区的原生技能与遗留根
SKILL.md。 - 用 AGENTS 编辑该工作区根
AGENTS.md。 - 在列表视图中用全局卡片编辑
$DSH_HOME/AGENTS.md或管理$DSH_HOME/skills。 - 用页眉 Skill catalog 同步并从四源目录向全局安装公开技能。
适用场景与注意¶
适合需要在 DSH 里集中查看多个工作区的 AGENTS.md 与 Skills、希望按 Agent Skills 规范 结构化创建技能、或需要从 Anthropic / OpenAI / Cursor / Matt Pocock 公开目录批量安装到 $DSH_HOME/skills 的开发者。
使用前请注意:
- 插件以当前 DSH 进程权限读写
$DSH_HOME与工作区文件;安装前应阅读源码与 MIT 许可证,确认路径与备份、冲突检测等行为符合预期。 - 社区插件非官方产品;DSH 生态遵循「一切皆插件」,SkillHub 目录页仅作发现入口,不代表官方背书。
- URL 导入与目录安装的覆盖策略不同:URL 只拉单个
SKILL.md;目录安装不会覆盖已有全局技能名。
结尾¶
dsh-workspace-atlas(AGENTS & Skills Studio) 把全局与工作区级的 AGENTS、多技能目录、公开技能库和四源目录安装收进一个全页面面板,并辅以列表/树形视图、搜索、备份与冲突检测。若你已在用 DSH NEXT 管理多工作区智能体配置,可先按 bundle 方式安装,再从侧栏工作台进入试用。