dsh-skill-navigator

Readme

# dsh-skill-navigator

DeepSeek Harness（DSH）技能速查与管理插件。在助手消息操作栏新增 ⚡ 按钮，一键打开速查面板：按大类目浏览、按名称/用途搜索（含中文 2-gram 命中）、查看收藏与最近使用、让模型推荐技能，或进入管理视图。

## Compatibility

- DSH >= 0.1.1（web profile），Node 22/24，React 18。
- 与 dsh-skills-manager / dsh-skill-hub / dsh-client-ui-skill-explorer 并存（本插件聚焦调用侧组织与速查，不占用设置页技能分区）。

## What it does

- 消息操作栏入口（conversation.chat.assistant-actions）+ 速查面板。
- 12 个内置分类 + 标签；本地评分（名称精确 > 名称 token > 描述/中文 2-gram 共现 > 分类/标签），含收藏/最近加成。
- 「让模型推荐」填入推荐指令到输入框。
- 管理视图：全量浏览、筛选、隐藏（本地）、用户技能启停（frontmatter 改写，可逆）、删除（移 .trash 可恢复）、分类/标签编辑、收藏。
- Host 路由 /api/skill-navigator/*（list / set-enabled / delete / restore），环回信任围栏；写操作仅限用户技能根（user-dsh / user-agents / custom 目录）。

## Install

- 构建：npm install && npm run build。
- 装入 profile（路径含空格需先复制到无空格临时目录）：
-   dsh plugin --profile web add <path>/dsh-skill-navigator-<version>.tgz
- 重启桌面应用以加载新 bundle。

## Configuration

- slotOrder：操作栏按钮顺序（默认 60）。
- dshHome / agentsHome / customSkillDirs：写操作所用用户技能根目录的覆盖配置。
- skillsmpApiKey：可选的 SkillsMP API Key（也可在面板设置里填写；仅用于你自己的搜索请求，只发送给 skillsmp.com）。

## Privacy

本插件**不采集任何遥测数据与个人信息**，除你主动触发的市场搜索外，不向任何第三方发送数据：

- 技能数据、分类、最近使用、面板偏好以及可选的 SkillsMP API Key 均**仅存本地**（浏览器 localStorage + `$DSH_HOME/skill-navigator-backups/ui-state.json`）。API Key 不会离开你的机器，除非它随你自己的请求发往 skillsmp.com。
- 「最近使用 / 调用统计」只读取**本地会话日志**，不会上传任何内容。
- 市场搜索/安装仅在你选择的市场（SkillHub / LobeHub / SkillsMP）发起；无其他出站请求。
- 写操作（启停/删除/更新）只作用于用户技能根；环回围栏阻止非本地调用者。
- 包内不嵌入任何机器相关路径；用户路径在运行时按当前用户主目录解析。

## Development

- src/shared：纯逻辑（match / store / categories），vitest 覆盖。
- src/client：浏览器半（esbuild → lib/client.js，window.__ModuleLoader__ 产物）。
- src/routes.ts + src/index.ts：host 半（身份、配置、web 路由）。
- 门禁：npm run typecheck && npm test && dsh-plugin-dev check --strict。

## License

Apache-2.0