前言¶
DeepSeek Harness（DSH）里技能可以来自用户目录和项目目录，数量多了之后，很难一眼看清「当前进程里到底有哪些技能在生效」。停用一个技能若只能改文件或挪路径，既容易误改内容，也不方便临时对比开关前后的行为。
dshx-skill-manager 在客户端增加 设置 → 技能管理 页面，列出 DSH 当前解析到的全部技能，并为每个技能提供开关和一行简短概述，在不改动技能文件的前提下控制可见性。
这是什么¶
- 名称：dshx-skill-manager（仓库 callaumyan-design/dshx-skill-manager）
- 维护者：callaumyan-design
- 分类：客户端插件
- 定位：DSH 设置页插件，用于浏览已安装技能、按技能启用/停用，并展示简短说明。
核心功能¶
技能列表与开关¶
页面会列出用户级、项目级等来源下，DSH 当前能解析到的所有技能。每个技能对应一个开关。
插件在自身生命周期内包装技能注册表的 snapshot() 与 get()。停用的技能对以下入口不可见：
- 模型目录中的技能展示
skill工具/skill命令
技能源文件不会被修改；卸载本插件后，包装逻辑移除，行为与未安装插件时一致。
简短概述¶
每个技能旁会显示一句简短中文概述，便于在列表里快速区分用途。
- 默认可通过 DSH 的默认模型批量生成概述，并带缓存：仅当技能描述变化时才重新生成。
- 若未生成或未启用 AI 概述，则使用技能描述中的第一句话作为展示文本。
概述长度与是否调用模型，见下文配置项。
配置¶
配置写在插件的 cordis.patch.yml 中，常用字段如下：
| 字段 | 默认 | 说明 |
|---|---|---|
summarize |
true |
是否用默认模型生成概述 |
summaryMaxChars |
60 |
概述长度上限 |
stateFile |
空 | 状态文件路径；留空时使用 $DSH_HOME/dshx-skill-manager/state.json |
按需修改后，按 DSH 插件配置方式生效（安装后若已运行 DSH，通常需重启，见安装一节）。
安装与启用¶
插件面向 web 与 desktop 两种 profile，安装后需 重启 DSH。marketplace 元数据标明 requiresRestart: true。
Web profile：
dsh plugin --profile web add github:callaumyan-design/dshx-skill-manager
Desktop profile（使用 DSH Desktop 自带的 dsh；安装前请从托盘完全退出 Desktop）：
dsh plugin --profile desktop add github:callaumyan-design/dshx-skill-manager
卸载示例（将 <profile> 换成 web 或 desktop）：
dsh plugin --profile <profile> remove dshx-skill-manager
典型用法¶
- 按上节命令安装对应 profile 的插件，并重启 DSH。
- 打开 设置 → 技能管理，查看当前解析到的技能列表与概述。
- 对暂时不需要的技能关闭开关，确认模型目录、
skill工具与/skill中已不再出现该技能。 - 若不需要 AI 生成概述，或将概述改短，在
cordis.patch.yml中调整summarize、summaryMaxChars等字段后按你的环境重新加载配置。
本仓库为纯 JavaScript，无构建步骤、无安装脚本；README 写明在 DeepSeek Harness 0.2.0-rc.2（desktop / web profile）上开发与使用。
适用场景与注意¶
适合：经常在同一台机器或同一项目里切换大量技能、希望用 UI 做启用/停用且不想动技能文件内容的 DSH 用户；需要在设置里快速扫一眼「当前有哪些技能、各自一句话是做什么」的场景。
注意：
- 插件以当前 DSH 进程的权限运行，安装前请自行查看 GitHub 源码 与 MIT 许可证（若仓库根目录提供）。
- 停用仅影响本插件包装下的注册表视图，不删除磁盘上的技能文件；彻底移除技能仍需按 DSH 技能管理惯例处理文件或目录。
- 社区插件目录 SkillHub 上的条目 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；安装命令以仓库 README 为准。
结尾¶
dshx-skill-manager 把「已安装技能一览 + 按技能开关 + 简短概述」收进 DSH 设置页，适合作为日常管理技能可见性的客户端补充。更多信息见 SkillHub 目录页 与 GitHub 仓库。
