dsh-workspace-atlas:在 DSH 里统一管理 AGENTS.md 与 Skills

前言

在 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 四个公开目录整目录安装技能。

核心功能

工作区视图

插件提供两种可随时切换的视图:

  1. 列表(List):按字母序平铺已注册工作区;每项展示根 AGENTS.md 与 SKILL 摘要(含数量)。列表里还有全局卡片,用于编辑 $DSH_HOME/AGENTS.md 和管理 $DSH_HOME/skills。
  2. 树形(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 中的顺序使用:

  1. 在侧栏打开 AGENTS & Skills Studio / AGENTS & Skills 工作台。
  2. 选 List / 列表 做平铺总览,或 Tree / 树形 按路径浏览工作区森林。
  3. 在树形视图中点击节点卡片展开子节点。
  4. 用 SKILL 管理该工作区的原生技能与遗留根 SKILL.md。
  5. 用 AGENTS 编辑该工作区根 AGENTS.md。
  6. 在列表视图中用全局卡片编辑 $DSH_HOME/AGENTS.md 或管理 $DSH_HOME/skills。
  7. 用页眉 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 方式安装,再从侧栏工作台进入试用。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜