前言¶
在 DeepSeek Harness（DSH）里装多了 Skill 之后，单靠名字很难判断哪个负责写代码、哪个负责文档或表格。官方列表能展示已加载的 Skill，但缺少「按你的工作方式分组、多套视图切换、快速复制 /skill-name」这类面向日常编排的入口。下面介绍社区插件 dsh-skill-map（维护者 kissfirembx，分类：客户端）：在 Web 客户端右侧栏增加 Skill Map 页签，把当前加载的 Skills 列在一页，由你自定义分类并持久化到本机。
这是什么¶
dsh-skill-map 是 DSH 的客户端插件（npm 包名 @kissfire/dsh-skill-map）。README 的定位是：all your loaded skills, sorted into your own categories, in a right-sidebar tab——在右侧栏单独占一页，汇总已加载 Skill，并按你定义的分类排序。分类结果保存在本机，升级插件版本不会清空你的分组。
核心功能¶
以下能力均来自项目 README 与说明文档。
界面与多工作区¶
- 右侧栏多一个专用于 Skills 的页签（安装并重启
dsh web后显示为 Skill Map）。 - 一个工作区（workspace）对应一套分类方式；顶部小页签可切换不同工作区。
- 点击 + 新建工作区；双击页签重命名；点 × 删除（会先确认）。
分类与拖拽¶
- 首次打开可让 AI 一次性为全部 Skill 提议分类；也可先自建分类，再让 AI 只把仍未归类的 Skill 填入已有分类——你已手动放置的项不会被挪动。
- 分类可重命名、拖拽排序或删除；Skill 可拖到其他分类。
- 暂时不确定归类的 Skill 可放在列表底部的 Unassigned。
列表、搜索与调用¶
- 每个 Skill 一行：名称 + 一句用途说明；悬停可看到来源 GitHub 项目与更长描述。
- 搜索框按名称与描述匹配。
- 点击一行会复制
/skill-name，便于粘贴到 Composer。 - 若描述过短，可按 Update 让 AI 补写；AI 不会覆盖你自己写过的行。
存储与展示位置¶
- 分类数据写在
$DSH_HOME/skill-map/map.json；文件缺失或损坏时回退到「尚无工作区」，不会擅自写入未确认的分类。 - 若已安装
dsh-better-sidebar，Skill Map 作为该侧栏的一个页签；否则在官方右侧栏@deepseek-ai/dsh-client-ui-sidebar-right中（首次加载时打开一次）。两侧栏都不可用时，会退到中央面板并在面板列表中提供入口。
描述语言¶
- 页头齿轮可切换说明语言：使用 Skill 原文，或使用
$DSH_HOME/skill-map/descriptions.<lang>.json中的翻译缓存；缓存中无对应行时仍显示 Skill 自带文本。
配置项（可选）¶
| Key | 类型 | 含义 |
|---|---|---|
enabled |
boolean | 宿主路由总开关 |
customSkillDirs |
string[] | 除官方路径外额外扫描的 Skill 根目录 |
dshHome |
string | 覆盖 DSH home；工作区文档在其下 |
agentsHome |
string | 覆盖 agents home（默认 ~/.agents） |
syncModel |
string | Update 与自动分类使用的模型路由（provider/model）；默认与当前 profile 的 agent 模型一致 |
限制与安全（README 说明）¶
- 最多 20 个工作区，每个工作区最多 200 个分类；分类为扁平结构，不支持嵌套。
- 路由仅监听 loopback（或配对设备）；Skill 根目录只读；插件只在 DSH home 下写入自有文件。
- Update 与自动分类依赖 profile 中的
llm服务；无可用 LLM 时会报告不可用，空工作区的方案提议会回退到内置表。 - 客户端每天（UTC）发送一次匿名安装心跳（随机 id + 包名），见仓库
src/client/telemetry.ts。
安装与启用¶
先安装 DSH。在终端执行（命令来自 README）：
dsh plugin --profile web add @kissfire/dsh-skill-map
重启 dsh web 后，右侧栏应出现 Skill Map 页签。
若上述方式不可用，可安装 GitHub 最新 release 的预构建包（README 称该链接始终指向最新版）：
dsh plugin --profile web add https://github.com/kissfirembx/dsh-skill-map/releases/latest/download/kissfire-dsh-skill-map.tgz
package.json 要求 DSH 引擎 >=0.2.0-rc.2，客户端面向 web profile。
典型用法¶
- 安装并重启
dsh web，打开右侧 Skill Map。 - 首次整理：选择让 AI 一次性分类，或先创建若干分类（例如「代码」「文档」「表格」「常用」），再触发 AI 只填充未归类项。
- 日常维护：拖拽调整分类顺序与 Skill 归属；不确定的放进 Unassigned。
- 调用 Skill：在列表中搜索名称或描述，点击行复制
/skill-name到 Composer。 - 补全描述：对说明过短的行使用 Update（需 profile 配置好
llm）；需要多语言说明时通过齿轮切换描述语言。 - 多套视图：用顶部 + 新建工作区（例如「按项目」与「按频率」两套），双击页签改名，用 × 删除不需要的工作区。
适用场景与注意¶
适合：已在 DSH 中加载较多 Skill、需要在 Web 界面快速浏览、分组和复制调用路径的开发者。
注意：
- 插件以当前 dsh 进程权限运行；安装前请阅读 GitHub 仓库 源码与 MIT License。
- 社区插件目录 SkillHub 条目 为独立生态站点，与 DeepSeek / 幻方无官方从属关系。
- AI 分类与描述更新依赖 LLM；无服务时相关功能不可用或回退内置逻辑。
结尾¶
dsh-skill-map 把「已加载 Skill 一览 + 自定义分类 + 多工作区 + 一键复制 /skill-name」收进右侧栏，并把分组写在本机 map.json，适合 Skill 数量上来之后做日常编排。更多信息见 SkillHub 目录页 与 GitHub：kissfirembx/dsh-skill-map。
