前言¶
在 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 插件页。