前言¶
在 DeepSeek Harness（DSH）里，技能和斜杠命令多以英文名称出现在「/」菜单和「+」面板中。技能一多，靠英文名检索和辨认成本高；命令与技能的默认顺序也未必贴合个人习惯。社区里也有用浏览器插件或改官方文件的做法，升级成本高、回滚麻烦。
dsh-cn-menu-kit 是一类纯客户端 DSH 插件：不改官方文件，通过注入客户端 UI 实现中文标题、中文搜索、悬浮详情，以及命令与技能的可拖拽排序。下面介绍它的定位、能力与安装用法。
这是什么¶
- 名称：
dsh-cn-menu-kit（npm 包名同名） - 维护者：xiao-xiao-bai-ya（package.json 中作者为「小小白」）
- 分类：客户端（
dsh.client.platform为web，通过cordis.patch.yml注入若干@deepseek-ai/dsh-client-ui-*模块） - 版本：1.0.0（以仓库
package.json为准） - 许可证：MIT
插件自述为「DeepSeek Harness 技能与命令的中文增强」：让 / 菜单与「+」面板里的技能带上中文标题，支持中文搜索与悬浮详情，命令与技能顺序可自由拖拽，常用项可固定在上方。卸载后即恢复官方默认 UI。
核心功能¶
以下能力均来自项目 README 与 package.json 说明，安装前可在 GitHub 仓库 自行核对源码与许可。
- 技能中文列表：标题展示为「中文标题（英文名）」；顶部搜索框支持中文即时过滤（例如输入「面试」筛选相关技能）。
- 悬浮详情：悬停技能行弹出完整简介面板，适配深/浅色主题，README 称不会遮挡菜单内容。
- 菜单内拖拽：悬停命令或技能行时出现 ⋮⋮ 把手，可在菜单内直接换位。
- 排序面板：「+」面板增加「技能排序」「命令排序」入口，结构镜像菜单的添加/指令两区，分区内拖拽。
- 顺序持久化：顺序保存在本机，重启保留；「+」菜单与
/菜单共用同一份顺序。 - 中文标题来源：在技能
SKILL.md的description中使用中文标题——描述约定（见下文）；无此前缀时回退显示英文名，不影响选用技能。
安装与启用¶
环境要求：DSH >= 0.2.2-rc.1（见 package.json 中 dsh.engines.dsh）。
任选一种方式安装：
方式一：DSH Market（README 推荐）
在 DSH Market 中搜索 dsh-cn-menu-kit 安装。
方式二：应用内插件页
侧边栏打开 插件 → 安装插件，输入包名 dsh-cn-menu-kit，重启 DSH。
方式三：命令行（Web profile）
dsh plugin --profile web add dsh-cn-menu-kit
README 注明：桌面端应在应用内插件页安装，桌面 profile 由应用托管。
插件在当前 DSH 进程对应的客户端环境中运行（与官方 UI 同权限域）。安装前建议阅读仓库源码与 MIT 许可条款，确认是否符合你的安全策略。
典型用法¶
| 入口 | 操作 |
|---|---|
| 「+」→「技能」 | 中文技能弹层：搜索、悬停看详情、点选插入引用 |
| 「+」→「技能排序」 / 「命令排序」 | 打开拖拽排序面板（分区内拖拽，即时保存） |
/ 菜单「技能（中文）」分组 |
同款中文列表，选中后插入 /英文名 引用 |
/ 菜单内悬停命令行 |
左侧浮现 ⋮⋮ 把手，拖动换位 |
选中技能后，输入框会出现 /英文名 引用；README 说明蓝色表示已被系统识别，发送即加载技能。
让技能显示中文标题¶
在技能的 SKILL.md front matter 中，将 description 开头写成 中文标题—— 形式，插件取 —— 之前的内容作为菜单中的中文标题：
---
name: agent-dev
description: Agent 开发方法论——构建 agent 系统的完整方法论：任务-模型匹配判定、五段式 pipeline 架构……
---
没有该前缀的技能仍显示英文名，功能不受影响。约定与 Agent Skills 生态中的常见写法一致（README 鸣谢部分有说明）。
调试与已知限制¶
需要排查菜单加载或拖拽行为时，可在浏览器 DevTools Console 执行：
localStorage.setItem('dsh-cn-skill-picker:debug', '1')
重启 DSH 后可查看菜单检测、目录加载、拖拽事件等诊断日志。
README 列出的限制包括：
- 菜单行由官方 React 组件渲染，拖拽后的顺序依赖插件在渲染后恢复；官方大版本若改动菜单 DOM，可能需要插件适配。
- 添加/指令两区的归属由官方固定名单决定，跨分区拖拽不生效（属官方语义，非插件 bug）。
适用场景与注意¶
适合长期在 DSH Web 客户端使用大量技能与斜杠命令、希望用中文检索和自定义排序的开发者。不适合期望改服务端行为或离线批处理技能清单的场景——本插件只增强客户端菜单。
DSH 生态理念是「一切皆插件」；SkillHub 目录页 等为社区站点，与 DeepSeek / 幻方无 README 中所述的官方从属关系，安装来源以 Market、应用内插件页或上述命令行为准。
结尾¶
dsh-cn-menu-kit 把中文可读性、搜索与排序收敛到零侵入的客户端插件里，并与 SKILL.md 的 description 约定对齐，便于团队统一技能命名习惯。进一步说明与截图见 GitHub README，目录索引见 SkillHub 插件页。
