dsh-skill-store 0.1.0 → 0.1.1

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 (3) hide show
  1. package/README.md +75 -69
  2. package/README.zh-CN.md +190 -0
  3. package/package.json +11 -4
package/README.md CHANGED
@@ -1,50 +1,56 @@
1
1
  # dsh-skill-store
2
2
 
3
3
  [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
4
+ [![npm version](https://img.shields.io/npm/v/dsh-skill-store)](https://www.npmjs.com/package/dsh-skill-store)
5
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-skill-store)](https://www.npmjs.com/package/dsh-skill-store)
4
6
  [![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/cxy9204/dsh-skill-store)
5
7
 
6
- **DeepSeek Harness 社区技能商店** —— 在应用内浏览、搜索并一键安装来自三个数据源的 **14 万+** 个 Agent Skills，按星标 / 下载量排序，中文分类直达。
8
+ **English** | [简体中文](README.zh-CN.md)
7
9
 
8
- 装了它之后：打开 DSH Web 界面，进入「设置 → 技能商店」，就能直接搜技能、看热度、点一下装到本地，不用再去 GitHub 手动翻仓库、下载 ZIP、解压到 skills 目录。
10
+ **A community skill marketplace for DeepSeek Harness.** Browse, search, and one-click install **140,000+ Agent Skills** from three registries right inside the DSH Web UI — sorted by stars / downloads, with Chinese category support.
11
+
12
+ After installing this plugin, open DSH Web and go to **Settings → Skill Store**: search skills, check popularity, and click to install them locally. No more browsing GitHub repos, downloading ZIPs, or manually unzipping into your skills directory.
9
13
 
10
14
  ---
11
15
 
12
- ## 三个数据源
16
+ ## The Three Data Sources
13
17
 
14
- > 数量为本机 2026-09-02 实测，源站在持续增长，实际以界面显示为准。
18
+ > Counts measured locally on 2026-09-02; the upstream sites keep growing, so the numbers shown in the UI are authoritative.
15
19
 
16
- | 数据源 | 技能数 | 星标 | 下载量 | 分类 | 内容下载 |
17
- |---|---:|:---:|:---:|:---:|:---:|
18
- | **SkillHub**（默认推荐） | 134,262 | ✅ | ✅ | ✅ 13 个中英双语大类 | ✅ |
19
- | **ClawHub** | 6,632 | ✅ 最高 3982★ | ✅ 最高 47 万 | ✅ 1694 个 topics | ✅ |
20
- | **GitHub 镜像**（awesome-skills-cn） | 2,063 | ❌ 目录非仓库 | ❌ | ⚠️ 11 个 collection 级 | ✅ |
20
+ | Source | Skills | Stars | Downloads | Categories | Content Fetch |
21
+ |---|---|---:|:---:|:---:|:---:|:---:|
22
+ | **SkillHub** (default, recommended) | 134,262 | ✅ | ✅ | ✅ 13 bilingual categories | ✅ |
23
+ | **ClawHub** | 6,632 | ✅ up to 3,982★ | ✅ up to 470k | ✅ 1,694 topics | ✅ |
24
+ | **GitHub mirror** (awesome-skills-cn) | 2,063 | ❌ dirs, not repos | ❌ | ⚠️ 11 collection-level | ✅ |
21
25
 
22
- 三个生态互不重叠（SkillHub 与 ClawHub 名称匹配率仅 0.2%），因此设计为**并列切换**而非合并。
26
+ The three ecosystems barely overlap (only 0.2% of SkillHub names match ClawHub), so the plugin presents them as **parallel switchable tabs** rather than a merged list.
23
27
 
24
- ### GitHub 源的分类标签与上游可信度
28
+ ### GitHub Source — Categories & Upstream Trust
25
29
 
26
- | Collection | 分类 | 上游仓库 |
30
+ | Collection | Category | Upstream repo |
27
31
  |---|---|---|
28
- | `anthropics-skills` | Anthropic 官方 | anthropics/skills |
29
- | `openai-skills` | OpenAI 官方 | openai/skills |
30
- | `claude-scientific-skills` | 科学研究 | K-Dense-AI/claude-scientific-skills |
32
+ | `anthropics-skills` | Anthropic official | anthropics/skills |
33
+ | `openai-skills` | OpenAI official | openai/skills |
34
+ | `claude-scientific-skills` | Scientific research | K-Dense-AI/claude-scientific-skills |
31
35
  | `huggingface-skills` | HuggingFace | huggingface/skills |
32
36
  | `obsidian-skills` | Obsidian | kepano/obsidian-skills |
33
- | 其余 6 个 | 社区合集 | 见源码 `COLLECTIONS` |
37
+ | 6 more | Community collections | see `COLLECTIONS` in source |
34
38
 
35
- 上游仓库 Star 数会显示在卡片上，作为来源可信度参考。
39
+ Upstream repo star counts are shown on the cards as a trust signal for each source.
36
40
 
37
41
  ---
38
42
 
39
- ## 安装
43
+ ## Installation
44
+
45
+ The plugin is **published on the npm registry** (`dsh-skill-store@0.1.x`). Install it directly:
40
46
 
41
47
  ```bash
42
48
  dsh plugin --profile web add dsh-skill-store
43
49
  ```
44
50
 
45
- 安装后**重启 DSH Web** 即可在设置中看到「技能商店」入口。
51
+ After installation, **restart DSH Web** — the "Skill Store" entry will appear under Settings.
46
52
 
47
- 从源码安装：
53
+ Install from source:
48
54
 
49
55
  ```bash
50
56
  git clone https://github.com/cxy9204/dsh-skill-store.git
@@ -53,7 +59,7 @@ npm install
53
59
  dsh plugin --profile web add file:./path/to/dsh-skill-store
54
60
  ```
55
61
 
56
- 卸载：
62
+ Uninstall:
57
63
 
58
64
  ```bash
59
65
  dsh plugin --profile web remove dsh-skill-store
@@ -61,19 +67,19 @@ dsh plugin --profile web remove dsh-skill-store
61
67
 
62
68
  ---
63
69
 
64
- ## 功能
70
+ ## Features
65
71
 
66
- - **三源切换** —— 顶部按钮切换 GitHub / ClawHub / SkillHub，切到后两者会出现排序下拉框
67
- - **热度排序** —— 按星标 / 下载量 / 安装量 / 名称排序，热门技能一目了然
68
- - **分类筛选** —— 下拉选择分类，每项标注技能数量
69
- - **全文搜索** —— 同时匹配技能名与描述
70
- - **一键安装** —— 技能写入 `~/.dsh/skills/<name>/SKILL.md`，装完即可用
71
- - **详情预览** —— 点卡片看完整 SKILL.md 正文与热度数据
72
- - **渐进式加载** —— 骨架索引秒开，描述与热度在后台逐步填充，进度可查
72
+ - **Three-source switching** — toggle between GitHub / ClawHub / SkillHub with the top buttons; a sort dropdown appears for the latter two
73
+ - **Popularity sorting** — by stars / downloads / installs / name
74
+ - **Category filter** — dropdown with per-category skill counts
75
+ - **Full-text search** — matches both skill name and description
76
+ - **One-click install** — skills are written to `~/.dsh/skills/<name>/SKILL.md`, ready to use immediately
77
+ - **Detail preview** — click a card to see the full SKILL.md body and popularity data
78
+ - **Progressive loading** — skeleton index appears instantly; descriptions and popularity fill in the background with visible progress
73
79
 
74
- ## 实机输出
80
+ ## Live Status Output
75
81
 
76
- 插件挂载后的真实运行状态（DSH Web 默认 `127.0.0.1:3080`）：
82
+ Real runtime state after the plugin is mounted (DSH Web defaults to `127.0.0.1:3080`):
77
83
 
78
84
  ```bash
79
85
  $ curl -s http://127.0.0.1:3080/api/dsh-skill-store/status
@@ -89,9 +95,9 @@ $ curl -s http://127.0.0.1:3080/api/dsh-skill-store/status
89
95
  }
90
96
  ```
91
97
 
92
- `skillhub.count` 小于 `progress.total` 是渐进加载的正常中间态：索引边跑边用，可用技能数持续增长直至全量。
98
+ `skillhub.count` being smaller than `progress.total` is the normal progressive-loading intermediate state: the index builds while in use, and the number of usable skills keeps growing until fully loaded.
93
99
 
94
- 单个技能的真实元数据（SkillHub API 原文截取）：
100
+ A real skill record (excerpt from the SkillHub API):
95
101
 
96
102
  ```json
97
103
  {
@@ -104,81 +110,81 @@ $ curl -s http://127.0.0.1:3080/api/dsh-skill-store/status
104
110
  }
105
111
  ```
106
112
 
107
- 界面入口：**设置 → 技能商店**。顶部三源切换按钮、搜索框、分类下拉、排序下拉（ClawHub / SkillHub 下出现），卡片显示名称、描述与星标 / 下载量，点击卡片弹出详情预览与安装按钮。
113
+ UI entry: **Settings → Skill Store**. Top bar has the three-source switcher, search box, category dropdown, and sort dropdown (shown for ClawHub / SkillHub). Cards show name, description, and stars / downloads; clicking a card opens the detail preview and install button.
108
114
 
109
- ## 设计说明
115
+ ## Design Notes
110
116
 
111
- **为什么 GitHub 源没有星标？** 单个技能在仓库里是一个**目录**而不是一个仓库，本身不存在独立的 star 字段。实测原始仓库 frontmatter 中 `tags` 覆盖率仅 2%、`category` 6%，全仓库只有 8 个不同 tag —— 所以「全是未分类」是数据源缺陷而非 bug。本插件改为按 collection 归类并标注上游仓库 Star 作为替代。
117
+ **Why does the GitHub source have no per-skill stars?** A skill in that repo is a **directory**, not a repository, so it has no independent star field. Measured coverage in the upstream frontmatter is only 2% for `tags` and 6% for `category`, with just 8 distinct tags across the whole repo — "everything is uncategorized" is a data-source limitation, not a bug. This plugin groups by collection and shows the upstream repo's stars instead.
112
118
 
113
- **网络适配（国内可用）**：`raw.githubusercontent.com` 在国内常被 DNS 阻断（报错 `ENOTFOUND`，且**不抛异常、只表现为数据为空**，极难排查）。本插件改用 jsDelivr CDN 多镜像回退，并记忆上次成功的源：
119
+ **Network adaptation (China-friendly)**: `raw.githubusercontent.com` is frequently DNS-blocked in mainland China (fails with `ENOTFOUND`, and — worst of all — **throws no exception, it just returns empty data**, which is very hard to debug). This plugin fetches through jsDelivr CDN mirrors with automatic fallback, and remembers the last working mirror:
114
120
 
115
121
  ```
116
122
  cdn.jsdelivr.net → gcore.jsdelivr.net → fastly.jsdelivr.net → raw.githubusercontent.com
117
123
  ```
118
124
 
119
- **两阶段加载**：全量抓取 13 万个 SKILL.md 不现实。骨架只遍历目录树（十几秒），详情按需单拉 + 后台渐进填充，每 60 条落盘，重启续跑。
125
+ **Two-phase loading**: fetching all 130k+ SKILL.md files upfront is impractical. The skeleton phase only walks the directory tree (a few seconds); details are fetched on demand plus background progressive enrichment, persisted every 60 records, resuming after restart.
120
126
 
121
127
  ---
122
128
 
123
- ## 权限与外部服务
129
+ ## Permissions & External Services
124
130
 
125
- 本插件会向以下外部服务发出**只读** HTTPS 请求：
131
+ This plugin sends **read-only** HTTPS requests to:
126
132
 
127
- | 服务 | 用途 |
133
+ | Service | Purpose |
128
134
  |---|---|
129
- | `api.github.com` | 读取 awesome-skills-cn 目录树 |
130
- | `*.jsdelivr.net` | 读取 SKILL.md 文件内容（CDN 镜像） |
131
- | `clawhub.ai` | ClawHub 技能注册表与文件内容 |
132
- | `api.skillhub.cn` | SkillHub 技能注册表与文件内容 |
135
+ | `api.github.com` | read awesome-skills-cn directory tree |
136
+ | `*.jsdelivr.net` | read SKILL.md file contents (CDN mirrors) |
137
+ | `clawhub.ai` | ClawHub skill registry & file contents |
138
+ | `api.skillhub.cn` | SkillHub skill registry & file contents |
133
139
 
134
- 本地写入仅限：
135
- - `~/.dsh/skills/` —— 安装技能的目标目录
136
- - `~/.dsh/skill-store-cache/` —— 索引缓存
140
+ Local writes are limited to:
141
+ - `~/.dsh/skills/` — target directory for installed skills
142
+ - `~/.dsh/skill-store-cache/` — index cache
137
143
 
138
- **无遥测、无数据上传、不需要任何账号或 Token。** 设置 `GITHUB_TOKEN` 环境变量只是把 GitHub API 限额从 60 次/小时提升到 5000 次/小时，不设置也能正常使用。
144
+ **No telemetry, no data upload, no account or token required.** Setting the `GITHUB_TOKEN` environment variable only raises the GitHub API rate limit from 60 to 5,000 requests/hour; everything works fine without it.
139
145
 
140
- ## 兼容性
146
+ ## Compatibility
141
147
 
142
- - **Profile**：`web`（需要 web 界面，headless 下 UI 不可用，API 端点仍可用）
143
- - **注入依赖**：`@deepseek-ai/dsh-client-ui-settings`、`@deepseek-ai/dsh-client-ui-slots`
144
- - **React**：18.x（可选 peerDependency，由宿主提供）
145
- - **Node.js**：≥ 20（依赖内置 `fetch` 与 ESM）
148
+ - **Profile**: `web` (requires the web UI; in headless mode the UI is unavailable but the API endpoints still work)
149
+ - **Injected dependencies**: `@deepseek-ai/dsh-client-ui-settings`, `@deepseek-ai/dsh-client-ui-slots`
150
+ - **React**: 18.x (optional peerDependency, provided by the host)
151
+ - **Node.js**: ≥ 20 (relies on built-in `fetch` and ESM)
146
152
 
147
- ## 开发
153
+ ## Development
148
154
 
149
155
  ```bash
150
156
  git clone https://github.com/cxy9204/dsh-skill-store.git
151
157
  cd dsh-skill-store
152
- node --check lib/index.js # 语法检查
158
+ node --check lib/index.js # syntax check
153
159
  ```
154
160
 
155
- 源码结构：
161
+ Source layout:
156
162
 
157
163
  ```
158
- lib/index.js 主插件：路由、GitHub 源索引、安装逻辑
159
- lib/client.js 前端 UI（React，宿主注入）
160
- lib/clawhub.js ClawHub 数据源
161
- lib/skillhub.js SkillHub 数据源
162
- cordis.patch.yml DSH 插件装载声明
164
+ lib/index.js Main plugin: routes, GitHub source index, install logic
165
+ lib/client.js Frontend UI (React, injected by the host)
166
+ lib/clawhub.js ClawHub data source
167
+ lib/skillhub.js SkillHub data source
168
+ cordis.patch.yml DSH plugin mount declaration
163
169
  ```
164
170
 
165
- 调试接口：
171
+ Debug endpoints:
166
172
 
167
173
  ```bash
168
174
  curl http://localhost:<port>/api/dsh-skill-store/status
169
175
  curl "http://localhost:<port>/api/dsh-skill-store/sources"
170
176
  ```
171
177
 
172
- ## 常见问题
178
+ ## FAQ
173
179
 
174
- **首次打开显示 0 个技能？** SkillHub 源首次索引约需 1-3 分钟在后台跑，刷新即可。访问 `/status` 端点可查看实时进度。
180
+ **The first open shows 0 skills?** The SkillHub source takes about 1-3 minutes to build its first index in the background — just refresh. Hit the `/status` endpoint to watch the live progress.
175
181
 
176
- **ClawHub 技能安装失败？** ClawHub 存在同名歧义（如 `github` 有 6 个作者），插件会自动选第一个（通常最热）。若装错，请从详情页确认作者。
182
+ **ClawHub skill installs the wrong one?** ClawHub has name collisions (e.g. `github` has 6 authors). The plugin picks the first match (usually the most popular). If it installed the wrong one, check the author on the detail page first.
177
183
 
178
- **安装后界面没出现？** DSH 插件需要重启 Web 进程才能完成前端注入。
184
+ **UI does not appear after install?** DSH plugins need a Web process restart to complete frontend injection.
179
185
 
180
- ## 许可证
186
+ ## License
181
187
 
182
188
  MIT © 2026 cxy9204
183
189
 
184
- 本项目为独立社区项目，与 DeepSeek AI 无隶属关系。
190
+ This is an independent community project, not affiliated with DeepSeek AI.
package/README.zh-CN.md ADDED
@@ -0,0 +1,190 @@
1
+ # dsh-skill-store
2
+
3
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
4
+ [![npm version](https://img.shields.io/npm/v/dsh-skill-store)](https://www.npmjs.com/package/dsh-skill-store)
5
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-skill-store)](https://www.npmjs.com/package/dsh-skill-store)
6
+ [![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/cxy9204/dsh-skill-store)
7
+
8
+ [English](README.md) | **简体中文**
9
+
10
+ **DeepSeek Harness 社区技能商店** —— 在应用内浏览、搜索并一键安装来自三个数据源的 **14 万+** 个 Agent Skills，按星标 / 下载量排序，中文分类直达。
11
+
12
+ 装了它之后：打开 DSH Web 界面，进入「设置 → 技能商店」，就能直接搜技能、看热度、点一下装到本地，不用再去 GitHub 手动翻仓库、下载 ZIP、解压到 skills 目录。
13
+
14
+ ---
15
+
16
+ ## 三个数据源
17
+
18
+ > 数量为本机 2026-09-02 实测，源站在持续增长，实际以界面显示为准。
19
+
20
+ | 数据源 | 技能数 | 星标 | 下载量 | 分类 | 内容下载 |
21
+ |---|---|---|---:|:---:|:---:|:---:|:---:|
22
+ | **SkillHub**（默认推荐） | 134,262 | ✅ | ✅ | ✅ 13 个中英双语大类 | ✅ |
23
+ | **ClawHub** | 6,632 | ✅ 最高 3982★ | ✅ 最高 47 万 | ✅ 1694 个 topics | ✅ |
24
+ | **GitHub 镜像**（awesome-skills-cn） | 2,063 | ❌ 目录非仓库 | ❌ | ⚠️ 11 个 collection 级 | ✅ |
25
+
26
+ 三个生态互不重叠（SkillHub 与 ClawHub 名称匹配率仅 0.2%），因此设计为**并列切换**而非合并。
27
+
28
+ ### GitHub 源的分类标签与上游可信度
29
+
30
+ | Collection | 分类 | 上游仓库 |
31
+ |---|---|---|
32
+ | `anthropics-skills` | Anthropic 官方 | anthropics/skills |
33
+ | `openai-skills` | OpenAI 官方 | openai/skills |
34
+ | `claude-scientific-skills` | 科学研究 | K-Dense-AI/claude-scientific-skills |
35
+ | `huggingface-skills` | HuggingFace | huggingface/skills |
36
+ | `obsidian-skills` | Obsidian | kepano/obsidian-skills |
37
+ | 其余 6 个 | 社区合集 | 见源码 `COLLECTIONS` |
38
+
39
+ 上游仓库 Star 数会显示在卡片上，作为来源可信度参考。
40
+
41
+ ---
42
+
43
+ ## 安装
44
+
45
+ 插件已发布到 **npm registry**（`dsh-skill-store@0.1.x`），推荐直接安装：
46
+
47
+ ```bash
48
+ dsh plugin --profile web add dsh-skill-store
49
+ ```
50
+
51
+ 安装后**重启 DSH Web** 即可在设置中看到「技能商店」入口。
52
+
53
+ 从源码安装：
54
+
55
+ ```bash
56
+ git clone https://github.com/cxy9204/dsh-skill-store.git
57
+ cd dsh-skill-store
58
+ npm install
59
+ dsh plugin --profile web add file:./path/to/dsh-skill-store
60
+ ```
61
+
62
+ 卸载：
63
+
64
+ ```bash
65
+ dsh plugin --profile web remove dsh-skill-store
66
+ ```
67
+
68
+ ---
69
+
70
+ ## 功能
71
+
72
+ - **三源切换** —— 顶部按钮切换 GitHub / ClawHub / SkillHub，切到后两者会出现排序下拉框
73
+ - **热度排序** —— 按星标 / 下载量 / 安装量 / 名称排序，热门技能一目了然
74
+ - **分类筛选** —— 下拉选择分类，每项标注技能数量
75
+ - **全文搜索** —— 同时匹配技能名与描述
76
+ - **一键安装** —— 技能写入 `~/.dsh/skills/<name>/SKILL.md`，装完即可用
77
+ - **详情预览** —— 点卡片看完整 SKILL.md 正文与热度数据
78
+ - **渐进式加载** —— 骨架索引秒开，描述与热度在后台逐步填充，进度可查
79
+
80
+ ## 实机输出
81
+
82
+ 插件挂载后的真实运行状态（DSH Web 默认 `127.0.0.1:3080`）：
83
+
84
+ ```bash
85
+ $ curl -s http://127.0.0.1:3080/api/dsh-skill-store/status
86
+ ```
87
+
88
+ ```json
89
+ {
90
+ "github": { "total": 2063, "enriched": 0, "pending": 2063,
91
+ "activeMirror": "https://gcore.jsdelivr.net/gh/lingxling/awesome-skills-cn@main" },
92
+ "clawhub": { "loaded": true, "count": 6632, "builtAt": "2026-09-02T07:10:44.288Z" },
93
+ "skillhub":{ "loaded": true, "count": 2005, "builtAt": "2026-09-02T07:08:05.871Z",
94
+ "progress": { "pages": 20, "fetched": 2005, "total": 134262 } }
95
+ }
96
+ ```
97
+
98
+ `skillhub.count` 小于 `progress.total` 是渐进加载的正常中间态：索引边跑边用，可用技能数持续增长直至全量。
99
+
100
+ 单个技能的真实元数据（SkillHub API 原文截取）：
101
+
102
+ ```json
103
+ {
104
+ "name": "B站视频分析",
105
+ "slug": "bilibili-content-research",
106
+ "canonicalName": "@user_825d9e7e/bilibili-content-research",
107
+ "category": "content-creation",
108
+ "subCategories": ["自媒体运营", "选题策划"],
109
+ "stars": 1, "downloads": 167, "version": "1.0.2"
110
+ }
111
+ ```
112
+
113
+ 界面入口：**设置 → 技能商店**。顶部三源切换按钮、搜索框、分类下拉、排序下拉（ClawHub / SkillHub 下出现），卡片显示名称、描述与星标 / 下载量，点击卡片弹出详情预览与安装按钮。
114
+
115
+ ## 设计说明
116
+
117
+ **为什么 GitHub 源没有星标？** 单个技能在仓库里是一个**目录**而不是一个仓库，本身不存在独立的 star 字段。实测原始仓库 frontmatter 中 `tags` 覆盖率仅 2%、`category` 6%，全仓库只有 8 个不同 tag —— 所以「全是未分类」是数据源缺陷而非 bug。本插件改为按 collection 归类并标注上游仓库 Star 作为替代。
118
+
119
+ **网络适配（国内可用）**：`raw.githubusercontent.com` 在国内常被 DNS 阻断（报错 `ENOTFOUND`，且**不抛异常、只表现为数据为空**，极难排查）。本插件改用 jsDelivr CDN 多镜像回退，并记忆上次成功的源：
120
+
121
+ ```
122
+ cdn.jsdelivr.net → gcore.jsdelivr.net → fastly.jsdelivr.net → raw.githubusercontent.com
123
+ ```
124
+
125
+ **两阶段加载**：全量抓取 13 万个 SKILL.md 不现实。骨架只遍历目录树（十几秒），详情按需单拉 + 后台渐进填充，每 60 条落盘，重启续跑。
126
+
127
+ ---
128
+
129
+ ## 权限与外部服务
130
+
131
+ 本插件会向以下外部服务发出**只读** HTTPS 请求：
132
+
133
+ | 服务 | 用途 |
134
+ |---|---|
135
+ | `api.github.com` | 读取 awesome-skills-cn 目录树 |
136
+ | `*.jsdelivr.net` | 读取 SKILL.md 文件内容（CDN 镜像） |
137
+ | `clawhub.ai` | ClawHub 技能注册表与文件内容 |
138
+ | `api.skillhub.cn` | SkillHub 技能注册表与文件内容 |
139
+
140
+ 本地写入仅限：
141
+ - `~/.dsh/skills/` —— 安装技能的目标目录
142
+ - `~/.dsh/skill-store-cache/` —— 索引缓存
143
+
144
+ **无遥测、无数据上传、不需要任何账号或 Token。** 设置 `GITHUB_TOKEN` 环境变量只是把 GitHub API 限额从 60 次/小时提升到 5000 次/小时，不设置也能正常使用。
145
+
146
+ ## 兼容性
147
+
148
+ - **Profile**：`web`（需要 web 界面，headless 下 UI 不可用，API 端点仍可用）
149
+ - **注入依赖**：`@deepseek-ai/dsh-client-ui-settings`、`@deepseek-ai/dsh-client-ui-slots`
150
+ - **React**：18.x（可选 peerDependency，由宿主提供）
151
+ - **Node.js**：≥ 20（依赖内置 `fetch` 与 ESM）
152
+
153
+ ## 开发
154
+
155
+ ```bash
156
+ git clone https://github.com/cxy9204/dsh-skill-store.git
157
+ cd dsh-skill-store
158
+ node --check lib/index.js # 语法检查
159
+ ```
160
+
161
+ 源码结构：
162
+
163
+ ```
164
+ lib/index.js 主插件：路由、GitHub 源索引、安装逻辑
165
+ lib/client.js 前端 UI（React，宿主注入）
166
+ lib/clawhub.js ClawHub 数据源
167
+ lib/skillhub.js SkillHub 数据源
168
+ cordis.patch.yml DSH 插件装载声明
169
+ ```
170
+
171
+ 调试接口：
172
+
173
+ ```bash
174
+ curl http://localhost:<port>/api/dsh-skill-store/status
175
+ curl "http://localhost:<port>/api/dsh-skill-store/sources"
176
+ ```
177
+
178
+ ## 常见问题
179
+
180
+ **首次打开显示 0 个技能？** SkillHub 源首次索引约需 1-3 分钟在后台跑，刷新即可。访问 `/status` 端点可查看实时进度。
181
+
182
+ **ClawHub 技能安装失败？** ClawHub 存在同名歧义（如 `github` 有 6 个作者），插件会自动选第一个（通常最热）。若装错，请从详情页确认作者。
183
+
184
+ **安装后界面没出现？** DSH 插件需要重启 Web 进程才能完成前端注入。
185
+
186
+ ## 许可证
187
+
188
+ MIT © 2026 cxy9204
189
+
190
+ 本项目为独立社区项目，与 DeepSeek AI 无隶属关系。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-skill-store",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Community skill marketplace for DeepSeek Harness: browse, search, and one-click install skills from awesome-skills-cn and the wider Claude Code / OpenClaw skill ecosystem.",
5
5
  "license": "MIT",
6
6
  "author": "cxy9204",
@@ -23,6 +23,7 @@
23
23
  "files": [
24
24
  "LICENSE",
25
25
  "README.md",
26
+ "README.zh-CN.md",
26
27
  "lib",
27
28
  "cordis.patch.yml"
28
29
  ],
@@ -32,8 +33,12 @@
32
33
  "react-dom": "^18.0.0"
33
34
  },
34
35
  "peerDependenciesMeta": {
35
- "react": { "optional": true },
36
- "react-dom": { "optional": true }
36
+ "react": {
37
+ "optional": true
38
+ },
39
+ "react-dom": {
40
+ "optional": true
41
+ }
37
42
  },
38
43
  "dsh": {
39
44
  "client": {
@@ -43,7 +48,9 @@
43
48
  "@deepseek-ai/dsh-client-ui-slots"
44
49
  ]
45
50
  },
46
- "bundle": { "patch": "./cordis.patch.yml" }
51
+ "bundle": {
52
+ "patch": "./cordis.patch.yml"
53
+ }
47
54
  },
48
55
  "keywords": [
49
56
  "deepseek-harness",