dsh-skill-browser 1.8.4 → 1.8.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/CHANGELOG.md +105 -0
  2. package/README-es.md +41 -0
  3. package/README-hi.md +41 -0
  4. package/README-pt.md +41 -0
  5. package/README-zh.md +41 -0
  6. package/icon.svg +11 -0
  7. package/lib/index.js +1 -1
  8. package/locale/en.json +6 -0
  9. package/locale/zh.json +6 -0
  10. package/package.json +80 -64
package/CHANGELOG.md ADDED
@@ -0,0 +1,105 @@
1
+ # Changelog
2
+
3
+ ## 1.8.6 — 2026-10-14
4
+
5
+ ### 合规性改进（无功能改动）
6
+
7
+ 本次为**纯元数据与文档改动，未触碰任何运行代码**（`lib/*.js` 与上一版逐字节一致）：
8
+
9
+ - **包元数据**：`engines.node` 对齐 DSH 运行时（`^22.19.0 || >=24.0.0`）；补 `packageManager`；`files` 白名单补上裸目录 `lib`、`locale/*.json`、`icon.svg` 与多语言 README；`exports` 补 `./locale/*.json` 与 `./icon`。
10
+ - **交付元数据**（官方插件契约要求）：新增 `locale/en.json` 与 `locale/zh.json`（含 `meta.title` / `meta.description`），新增 `icon.svg`（插件管理器显示用图标，不再显示裸 id）。
11
+ - **多语言文档**：新增 `README-zh.md` 中文说明；`README-es/pt/hi.md` 标题与主 README 对齐。
12
+
13
+ 以上改动使插件通过官方 `dsh-plugin-dev check` 全部检查项（`P=12 F=0 W=0`）。
14
+
15
+ ### Compliance improvements (no functional changes)
16
+
17
+ This release is **metadata and documentation only — no runtime code was touched** (`lib/*.js` is byte-identical to the previous version):
18
+
19
+ - **Package metadata**: `engines.node` aligned with the DSH runtime (`^22.19.0 || >=24.0.0`); `packageManager` added; `files` allowlist now includes the bare `lib` directory, `locale/*.json`, `icon.svg` and the multi-language READMEs; `exports` gained `./locale/*.json` and `./icon`.
20
+ - **Display metadata** (required by the official plugin contract): added `locale/en.json` and `locale/zh.json` with `meta.title` / `meta.description`, plus `icon.svg` so the plugin manager shows a real name and icon instead of a bare id.
21
+ - **Multi-language docs**: added `README-zh.md`; `README-es/pt/hi.md` headings aligned with the main README.
22
+
23
+ With these changes the packages pass every official `dsh-plugin-dev check` item (`P=12 F=0 W=0`).
24
+
25
+ ---
26
+
27
+ ## 1.8.5 - 补齐 npm 包元数据（repository / homepage）
28
+
29
+ 本版无功能变更，仅修正包元数据——它直接决定插件市场能否采集到本插件的下载量。
30
+
31
+ - **补 `repository` 字段**：此前 `package.json` 缺 `repository`，导致上游
32
+ awesome-dsh-plugin 的 `scripts/probe-npm.mjs` 在「npm 包是否属于该仓库」这一步
33
+ 判定失败（该脚本读取 registry 里 `latest` 版本的 `repository`，要求包含对应
34
+ GitHub 仓库路径），于是 `data/npm-map.json` 不收录本条目、`downloads` 在
35
+ `plugins.json` 里落成 `null`。
36
+ - **症状**：插件市场列表与详情页**不显示下载量数字**（看起来像"一个下载都没有"），
37
+ 实际 npm 近30天有 1700+ 次下载；同时收录条目会降级为 `github:` 安装方式、
38
+ 不展示 npm 版本号。
39
+ - **补 `homepage` 字段**：指向仓库 README，用于 npm 页面与市场条目的主页链接。
40
+ - **`files` 白名单补 `CHANGELOG.md`**：此前变更日志未入 npm 包。
41
+
42
+ ## 1.8.4 - 官方 DSH 兼容声明与引擎版本口径修正
43
+
44
+ 依照 DeepSeek Harness **官方规范**（`packages/boot/app-boot/README.md`）修正兼容性声明。
45
+
46
+ - **新增官方 DSH 兼容声明**：内核检查的是 `peerDependencies` 中的
47
+ `@deepseek-ai/dsh` / `@deepseek-ai/dsh-*` 范围，**不读取 `engines.dsh`**。
48
+ 现已在 `peerDependencies` 与 `devDependencies` 同范围声明：
49
+ `@deepseek-ai/cordis` `^4.0.2`、`@deepseek-ai/dsh` `>=0.1.7-rc.1`。
50
+ - **引擎口径修正为内核版本**：此前 `engines` 只写 `node`，未声明 DSH 内核要求；
51
+ 现补 `engines.dsh = >=0.1.7-rc.1`（内核版本口径，非客户端/外壳版本）。
52
+ - 说明：`^0.1.7` **不匹配**预发布内核 `0.1.7-rc.2`，故范围使用显式预发布下限。
53
+
54
+ 无功能变更。
55
+
56
+
57
+ ## 1.5.6 (2026-09-07)
58
+ - 默认位改为与字体悬浮球右下角水平并列（right:74px bottom:18px），迁移 v4 自动复位
59
+ - 设置分区推荐插件位回归（照片显示器/字体插件 + Star）
60
+ - 🎯 一键恢复升级为探测式双球联动：检测到字体插件已运行才挂载字体球复位，按钮文案动态显示「双球」
61
+
62
+ ## 1.5.5 (2026-09-06)
63
+ - 版本号对齐修复：host 端 VERSION 常量此前停在 1.5.1，现统一
64
+
65
+ ## 1.5.5 (2026-09-06)
66
+ - 版本号对齐修复：host 端 `lib/index.js` 的 VERSION 常量此前停在 1.5.1，未随 1.5.2~1.5.4 同步，`/health` 误报 1.5.1；现统一为 1.5.5
67
+
68
+ ## 1.5.4 (2026-09-05)
69
+ - 移除技能列表每页末尾追加的「💡 悬浮球显隐设置」提示卡；技能列表只展示技能卡片本身
70
+
71
+ ## 1.5.3 (2026-09-05)
72
+ - DSH 设置页「悬浮球导航」新增「🎯 一键恢复悬浮球默认位置（右下角）」按钮：悬浮球被拖出屏幕外卡住时，点击立即清除位置记忆 / 恢复显示 / 解除收起状态，无需重启
73
+ - 推荐插件位收敛：技能列表每页末尾与 DSH 设置页不再显示推荐广告卡，仅保留面板 ⚙ 设置展开区（技能库位置下方）一处
74
+
75
+ ## 1.5.2 (2026-09-05)
76
+ - 复位迁移升级到 v3：客户端加载时自动恢复悬浮球显示、清除收起小圆点与拖拽位置记忆（针对"球找不到"的自救机制）
77
+
78
+ ## 1.5.1 (2026-09-04)
79
+ - **台账搜索制**：初始化时全库搜索台账文件（文件名含「失效台账 / 失败台账 / 生效-失效」等，约定路径 `skill-master/references/` 优先）；搜到则复用（人工内容不动、首接管备份），没搜到才创建默认台账
80
+ - **默认台账模板**：对齐现行台账格式（〇铁律 / 一登记时机 / 二登记口令 / 三统计表 / 四失败明细 + 🤖 自动登记区块），表头与解析器严格兼容，零隐私内容
81
+ - **登记口令**：对话里说「触发失败，登记」/「登记失败：技能名 原因」→ AI 调上报接口写入台账；面板人工台账空态显示口令引导
82
+ - **文件夹选择器修复**：改由宿主端 spawn PowerShell 弹 Windows 原生 FolderBrowserDialog（`POST /pick-dir`），路径 100% 准确；renderer 侧 File API 方案（webkitdirectory）在 Electron 32+ 不可靠，已弃用
83
+ - **零机器路径**：插件本体不含任何预设/硬编码技能库路径；解析顺序 = 设置页覆盖 → 环境变量 `DSH_SKILLS_DIR` → 插件 config → `~/.dsh/skills`；未配置时面板引导选择
84
+ - **内置中文简介字典脱敏**：移除全部私有项目与个人技能条目，仅保留通用描述；未收录技能回退 frontmatter description
85
+ - 面板新增推荐插件卡（照片显示器 / 字体插件）与悬浮球显隐引导说明
86
+ - 修复：换根后 ledgerPath 未重置；ledgerEffectivePath 路径拼接错误
87
+ - 测试扩展至 38 项
88
+
89
+ ## 1.4.0 - 1.4.4 (2026-09-04)
90
+ - 初始化检查（空库自动创建 skill-master 技能 + 台账，幂等不覆盖人工内容）
91
+ - 失效台账自动登记引擎（`tools/result` 事件监听 + JSONL 流水 + 标记区块增量写入）
92
+ - 技能库位置可配置（设置页可视化覆盖 / 环境变量 / 官方默认根自动探测）
93
+ - 官方 directoryPicker seam 与 webkitdirectory 选择器尝试（桌面端环境限制，1.5.1 已替换）
94
+
95
+ ## 1.3.0 (2026-09-04)
96
+ - 失效台账自动登记（自动/人工分区显示）、技能库位置配置雏形
97
+
98
+ ## 1.2.0 (2026-09-03)
99
+ - DSH 设置页「悬浮球导航」分区（settings.section）、双悬浮球视觉统一
100
+
101
+ ## 1.1.0 (2026-09-03)
102
+ - 「📋 失效台账」Tab、悬浮球拖拽/收起、面板内设置
103
+
104
+ ## 1.0.0 (2026-09-03)
105
+ - 首版：悬浮球 + 面板（技能浏览/分类/搜索/全文查看）
package/README-es.md ADDED
@@ -0,0 +1,41 @@
1
+ # Skill Browser
2
+
3
+ > Browse, search and inspect the local skill library, with per-skill detail pages and quick routing.
4
+
5
+ > Full documentation: [English README](./README.md)
6
+
7
+ ## 功能
8
+
9
+ > 📖 [Leer esta sección en el README principal](./README.md#功能)
10
+
11
+ ## 🎨 三球共享 128 皮肤
12
+
13
+ > 📖 [Leer esta sección en el README principal](./README.md#🎨-三球共享-128-皮肤)
14
+
15
+ ## Highlights (English)
16
+
17
+ > 📖 [Leer esta sección en el README principal](./README.md#highlights-english)
18
+
19
+ ## 安装（desktop profile）
20
+
21
+ > 📖 [Leer esta sección en el README principal](./README.md#安装desktop-profile)
22
+
23
+ ## ⚠️ 安装须知 Install Notice
24
+
25
+ > 📖 [Leer esta sección en el README principal](./README.md#⚠️-安装须知-install-notice)
26
+
27
+ ## 台账自动登记原理
28
+
29
+ > 📖 [Leer esta sección en el README principal](./README.md#台账自动登记原理)
30
+
31
+ ## API（宿主端，仅回环可访问）
32
+
33
+ > 📖 [Leer esta sección en el README principal](./README.md#api宿主端仅回环可访问)
34
+
35
+ ## 测试
36
+
37
+ > 📖 [Leer esta sección en el README principal](./README.md#测试)
38
+
39
+ ## License
40
+
41
+ > 📖 [Leer esta sección en el README principal](./README.md#license)
package/README-hi.md ADDED
@@ -0,0 +1,41 @@
1
+ # Skill Browser
2
+
3
+ > Browse, search and inspect the local skill library, with per-skill detail pages and quick routing.
4
+
5
+ > Full documentation: [English README](./README.md)
6
+
7
+ ## 功能
8
+
9
+ > 📖 [यह अनुभाग मुख्य README में पढ़ें](./README.md#功能)
10
+
11
+ ## 🎨 三球共享 128 皮肤
12
+
13
+ > 📖 [यह अनुभाग मुख्य README में पढ़ें](./README.md#🎨-三球共享-128-皮肤)
14
+
15
+ ## Highlights (English)
16
+
17
+ > 📖 [यह अनुभाग मुख्य README में पढ़ें](./README.md#highlights-english)
18
+
19
+ ## 安装（desktop profile）
20
+
21
+ > 📖 [यह अनुभाग मुख्य README में पढ़ें](./README.md#安装desktop-profile)
22
+
23
+ ## ⚠️ 安装须知 Install Notice
24
+
25
+ > 📖 [यह अनुभाग मुख्य README में पढ़ें](./README.md#⚠️-安装须知-install-notice)
26
+
27
+ ## 台账自动登记原理
28
+
29
+ > 📖 [यह अनुभाग मुख्य README में पढ़ें](./README.md#台账自动登记原理)
30
+
31
+ ## API（宿主端，仅回环可访问）
32
+
33
+ > 📖 [यह अनुभाग मुख्य README में पढ़ें](./README.md#api宿主端仅回环可访问)
34
+
35
+ ## 测试
36
+
37
+ > 📖 [यह अनुभाग मुख्य README में पढ़ें](./README.md#测试)
38
+
39
+ ## License
40
+
41
+ > 📖 [यह अनुभाग मुख्य README में पढ़ें](./README.md#license)
package/README-pt.md ADDED
@@ -0,0 +1,41 @@
1
+ # Skill Browser
2
+
3
+ > Browse, search and inspect the local skill library, with per-skill detail pages and quick routing.
4
+
5
+ > Full documentation: [English README](./README.md)
6
+
7
+ ## 功能
8
+
9
+ > 📖 [Ler esta seção no README principal](./README.md#功能)
10
+
11
+ ## 🎨 三球共享 128 皮肤
12
+
13
+ > 📖 [Ler esta seção no README principal](./README.md#🎨-三球共享-128-皮肤)
14
+
15
+ ## Highlights (English)
16
+
17
+ > 📖 [Ler esta seção no README principal](./README.md#highlights-english)
18
+
19
+ ## 安装（desktop profile）
20
+
21
+ > 📖 [Ler esta seção no README principal](./README.md#安装desktop-profile)
22
+
23
+ ## ⚠️ 安装须知 Install Notice
24
+
25
+ > 📖 [Ler esta seção no README principal](./README.md#⚠️-安装须知-install-notice)
26
+
27
+ ## 台账自动登记原理
28
+
29
+ > 📖 [Ler esta seção no README principal](./README.md#台账自动登记原理)
30
+
31
+ ## API（宿主端，仅回环可访问）
32
+
33
+ > 📖 [Ler esta seção no README principal](./README.md#api宿主端仅回环可访问)
34
+
35
+ ## 测试
36
+
37
+ > 📖 [Ler esta seção no README principal](./README.md#测试)
38
+
39
+ ## License
40
+
41
+ > 📖 [Ler esta seção no README principal](./README.md#license)
package/README-zh.md ADDED
@@ -0,0 +1,41 @@
1
+ # dsh-skill-browser
2
+
3
+ > 浏览、检索与查看本地技能库，提供技能详情页与快速路由。
4
+
5
+ > 完整文档以 [English README](./README.md) 为准，本页提供中文导读与关键信息速查。
6
+
7
+ ## 功能
8
+
9
+ 浏览本地技能库、关键词检索、查看技能详情与触发词、快速路由到目标技能。
10
+
11
+ ## 🎨 三球共享 128 皮肤
12
+
13
+ 本节内容详见 [English README](./README.md)。
14
+
15
+ ## Highlights (English)
16
+
17
+ 本节内容详见 [English README](./README.md)。
18
+
19
+ ## 安装（desktop profile）
20
+
21
+ 本节内容详见 [English README](./README.md)。
22
+
23
+ ## ⚠️ 安装须知 Install Notice
24
+
25
+ 本节内容详见 [English README](./README.md)。
26
+
27
+ ## 台账自动登记原理
28
+
29
+ 本节内容详见 [English README](./README.md)。
30
+
31
+ ## API（宿主端，仅回环可访问）
32
+
33
+ 本节内容详见 [English README](./README.md)。
34
+
35
+ ## 测试
36
+
37
+ 本节内容详见 [English README](./README.md)。
38
+
39
+ ## License
40
+
41
+ MIT
package/icon.svg ADDED
@@ -0,0 +1,11 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="dsh-skill-browser">
2
+ <defs>
3
+ <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
4
+ <stop offset="0%" stop-color="#4F6BED"/>
5
+ <stop offset="100%" stop-color="#7C3AED"/>
6
+ </linearGradient>
7
+ </defs>
8
+ <rect x="2" y="2" width="60" height="60" rx="14" fill="url(#g)"/>
9
+ <text x="32" y="41" font-family="-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif"
10
+ font-size="26" font-weight="700" fill="#ffffff" text-anchor="middle">SB</text>
11
+ </svg>
package/lib/index.js CHANGED
@@ -19,7 +19,7 @@ import {
19
19
  import { ZH, UI_TEXT } from "./zh.js";
20
20
 
21
21
  var PREFIX = "/dsh-skill-browser";
22
- var VERSION = "1.7.4";
22
+ var VERSION = "1.8.5";
23
23
  var CACHE_TTL_MS = 30 * 1000;
24
24
  var DIAG_FILE = join(homedir(), ".dsh", "data", "dsh-skill-browser", "diag.log");
25
25
  var CONFIG_FILE = join(homedir(), ".dsh", "data", "dsh-skill-browser", "config.json");
package/locale/en.json ADDED
@@ -0,0 +1,6 @@
1
+ {
2
+ "meta": {
3
+ "title": "Skill Browser",
4
+ "description": "Browse, search and inspect the local skill library, with per-skill detail pages and quick routing."
5
+ }
6
+ }
package/locale/zh.json ADDED
@@ -0,0 +1,6 @@
1
+ {
2
+ "meta": {
3
+ "title": "技能浏览器",
4
+ "description": "浏览、检索与查看本地技能库，提供技能详情页与快速路由。"
5
+ }
6
+ }
package/package.json CHANGED
@@ -1,64 +1,80 @@
1
- {
2
- "name": "dsh-skill-browser",
3
- "version": "1.8.4",
4
- "description": "DSH 技能浏览器：悬浮球面板浏览共享技能库（分类/中文简介/搜索/失效台账/全文查看），含 DSH 设置页悬浮球显隐开关与一键恢复默认位置按钮、技能库位置可配置（原生目录选择框）与技能失效台账自动登记（自动/人工分开显示）；推荐插件位仅保留面板设置展开区一处。Skill library browser panel with categories, Chinese descriptions, configurable skill root with native directory chooser, one-click ball position reset and automatic skill-failure ledger.",
5
- "type": "module",
6
- "main": "lib/index.js",
7
- "sideEffects": false,
8
- "engines": {
9
- "node": "\u003e=18",
10
- "dsh": "\u003e=0.1.7-rc.1"
11
- },
12
- "exports": {
13
- ".": "./lib/index.js",
14
- "./client": "./lib/client.js",
15
- "./package.json": "./package.json"
16
- },
17
- "files": [
18
- "lib/**/*.js",
19
- "lib/**/*.ps1",
20
- "cordis.patch.yml",
21
- "README.md",
22
- "LICENSE",
23
- "lib/orb/*.html",
24
- "docs/images/**"
25
- ],
26
- "license": "MIT",
27
- "keywords": [
28
- "dsh-plugin",
29
- "deepseek-harness",
30
- "skill",
31
- "技能",
32
- "skills-browser",
33
- "skill-browser",
34
- "fluent",
35
- "cfd",
36
- "分类",
37
- "category",
38
- "chinese",
39
- "中文简介"
40
- ],
41
- "dsh": {
42
- "bundle": {
43
- "patch": "./cordis.patch.yml"
44
- },
45
- "client": {
46
- "inject": [
47
- "@deepseek-ai/dsh-client-connection",
48
- "@deepseek-ai/dsh-client-runtime",
49
- "@deepseek-ai/dsh-client-ui-settings",
50
- "@deepseek-ai/dsh-client-ui-slots",
51
- "@deepseek-ai/dsh-client-locale"
52
- ],
53
- "platform": "web"
54
- }
55
- },
56
- "peerDependencies": {
57
- "@deepseek-ai/cordis": "^4.0.2",
58
- "@deepseek-ai/dsh": "\u003e=0.1.7-rc.1"
59
- },
60
- "devDependencies": {
61
- "@deepseek-ai/cordis": "^4.0.2",
62
- "@deepseek-ai/dsh": "\u003e=0.1.7-rc.1"
63
- }
64
- }
1
+ {
2
+ "name": "dsh-skill-browser",
3
+ "version": "1.8.6",
4
+ "description": "DSH 技能浏览器：悬浮球面板浏览共享技能库（分类/中文简介/搜索/失效台账/全文查看），含 DSH 设置页悬浮球显隐开关与一键恢复默认位置按钮、技能库位置可配置（原生目录选择框）与技能失效台账自动登记（自动/人工分开显示）；推荐插件位仅保留面板设置展开区一处。Skill library browser panel with categories, Chinese descriptions, configurable skill root with native directory chooser, one-click ball position reset and automatic skill-failure ledger.",
5
+ "type": "module",
6
+ "main": "lib/index.js",
7
+ "sideEffects": false,
8
+ "engines": {
9
+ "dsh": ">=0.1.7-rc.1",
10
+ "node": "^22.19.0 || >=24.0.0"
11
+ },
12
+ "exports": {
13
+ ".": "./lib/index.js",
14
+ "./client": "./lib/client.js",
15
+ "./package.json": "./package.json",
16
+ "./locale/*.json": "./locale/*.json",
17
+ "./icon": "./icon.svg"
18
+ },
19
+ "files": [
20
+ "lib",
21
+ "lib/**/*.js",
22
+ "lib/**/*.ps1",
23
+ "cordis.patch.yml",
24
+ "README.md",
25
+ "CHANGELOG.md",
26
+ "LICENSE",
27
+ "lib/orb/*.html",
28
+ "docs/images/**",
29
+ "locale/*.json",
30
+ "icon.svg",
31
+ "README-zh.md",
32
+ "README-es.md",
33
+ "README-pt.md",
34
+ "README-hi.md"
35
+ ],
36
+ "license": "MIT",
37
+ "keywords": [
38
+ "dsh-plugin",
39
+ "deepseek-harness",
40
+ "skill",
41
+ "技能",
42
+ "skills-browser",
43
+ "skill-browser",
44
+ "fluent",
45
+ "cfd",
46
+ "分类",
47
+ "category",
48
+ "chinese",
49
+ "中文简介"
50
+ ],
51
+ "dsh": {
52
+ "bundle": {
53
+ "patch": "./cordis.patch.yml"
54
+ },
55
+ "client": {
56
+ "inject": [
57
+ "@deepseek-ai/dsh-client-connection",
58
+ "@deepseek-ai/dsh-client-runtime",
59
+ "@deepseek-ai/dsh-client-ui-settings",
60
+ "@deepseek-ai/dsh-client-ui-slots",
61
+ "@deepseek-ai/dsh-client-locale"
62
+ ],
63
+ "platform": "web"
64
+ }
65
+ },
66
+ "peerDependencies": {
67
+ "@deepseek-ai/cordis": "^4.0.2",
68
+ "@deepseek-ai/dsh": ">=0.1.7-rc.1"
69
+ },
70
+ "devDependencies": {
71
+ "@deepseek-ai/cordis": "^4.0.2",
72
+ "@deepseek-ai/dsh": ">=0.1.7-rc.1"
73
+ },
74
+ "repository": {
75
+ "type": "git",
76
+ "url": "git+https://github.com/loyalchiiina/dsh-skill-browser.git"
77
+ },
78
+ "homepage": "https://github.com/loyalchiiina/dsh-skill-browser#readme",
79
+ "packageManager": "pnpm@11.7.0"
80
+ }