dsh-dpharness 0.4.4 → 0.5.2
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.
- package/README.md +358 -16
- package/icon.svg +11 -0
- package/lib/changelog.js +208 -0
- package/lib/client.js +2902 -361
- package/lib/index.js +1026 -27
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +18 -7
package/README.md
CHANGED
|
@@ -3,49 +3,306 @@
|
|
|
3
3
|
在 DeepSeek Harness(dsh)里浏览、搜索 [dpharness.com](https://dpharness.com) 的 dsh 插件目录,
|
|
4
4
|
**并可直接一键安装**。
|
|
5
5
|
|
|
6
|
-
##
|
|
6
|
+
## 五个视图
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
浮窗与页签**共用同一套视图与同一组文案**,顶部都能在五个视图间切换,默认都停在「严选推荐」
|
|
9
9
|
(同一功能在两处换默认值,最容易被当成 bug):
|
|
10
10
|
|
|
11
11
|
| 视图 | 数据来源 | 回答的问题 |
|
|
12
12
|
|---|---|---|
|
|
13
|
-
| **严选推荐** | `GET /api/plugins`(全量目录) | 「我知道要什么,帮我找」——可搜索、可按 Star
|
|
13
|
+
| **严选推荐** | `GET /api/plugins`(全量目录) | 「我知道要什么,帮我找」——可搜索、可按 Star 排序;卡片最左可**加对比**(最多 3 个,并排看星标/验证/已装/分类/卖点) |
|
|
14
14
|
| **分类精选** | `GET /api/best`(月度策展,与站点 [/best](https://dpharness.com/best) 同一份数据) | 「我该装哪几个」——按大类 → 小类分组,每小类只留 2~3 个 |
|
|
15
|
+
| **套装**(v0.5.0) | `GET /api/sets`(组合方案,与站点 [/sets](https://dpharness.com/sets) 同一份数据) | 「我这件整事该配哪一套」——跨插件**纵向**组合:一整套 + 安装顺序 + 冲突提示 + 批量命令 |
|
|
16
|
+
| **每日推荐**(v0.5.0) | 同上榜单,按自然日取一条 | 「今天装哪个」——当天唯一一条,所有用户一致 |
|
|
17
|
+
| **我的插件**(v0.5.0) | 本机 profile + npmmirror | 「我装的这些该升级了吗」——本插件自身 + 已装插件逐包比对;**兼管理入口**:当场卸载(两步确认)、忽略某个版本、**收藏待装**(攒着一起装)、福利专区入口。标签原为「更新」,2026-10-13 改名 —— 它已经不只是"看更新",而是管理这一屏 |
|
|
15
18
|
|
|
16
19
|
分类精选视图刻意保留两项元数据:**小类内名次**与**上榜理由**(如「小类第 1 · 实装验证通过 · 周下载 12.8 万」)。
|
|
20
|
+
|
|
21
|
+
套装的每条是**槽位**而不是插件名:锚点槽位人工固定,滚动槽位每月跟随「分类精选」择优替换 ——
|
|
22
|
+
所以界面渲染的是「这个位置是干什么的」(`slotRole`),不是「现在是哪个插件」。
|
|
23
|
+
套装内必要性(`need`:必备/增强/可选)与插件生态分层(`tier`:core/related)**同名不同义**,
|
|
24
|
+
传输层已把后者改名为 `pluginTier`,别拿错。
|
|
17
25
|
去掉它们,这份清单就只是又一个列表;它们的价值恰恰在于「为什么是它」可复核。
|
|
18
26
|
入榜门槛(站点侧规则):通过静态安装检查或 CI 实装验证 + 汉化完成;每月 1 日重算并公开淘汰原因。
|
|
19
27
|
|
|
20
|
-
|
|
28
|
+
### 每日推荐怎么选出来的(v0.5.0)
|
|
29
|
+
|
|
30
|
+
不是随机,也不是服务端下发 —— 站点当时没有 `/api/daily`(`/api/daily`、`/api/today`、
|
|
31
|
+
`/api/recommend` 实测全 404,只有 `/api/best` 可用),所以**从月度榜单里按日期确定性取一条**:
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
候选 = 展平 best.categories[].subs[].items[] (2026-10-12 实测:124 条唯一候选)
|
|
35
|
+
候选按 fullName 稳定排序 ← 不排序的话,站点重算榜单当天就会换人
|
|
36
|
+
index = FNV1a(dateKey) % 候选数
|
|
37
|
+
dateKey = YYYY-MM-DD(**固定 UTC+8**,不是本地时区)
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
三条不变式(`test-local.mjs` 逐条断言):
|
|
41
|
+
|
|
42
|
+
1. **同一自然日恒定同一条** —— 浮窗、页签、卡片三处调用结果必须一致;
|
|
43
|
+
2. **上游分组顺序抖动不影响结果** —— 排序键是条目自身的唯一键,与上游顺序无关;
|
|
44
|
+
3. **跨天会换** —— 否则「每日」是假的。
|
|
45
|
+
|
|
46
|
+
- 时区固定 UTC+8:用本地时区会让同一天不同地区的用户看到不同的一条,而「今日推荐」的语义
|
|
47
|
+
本来就是「今天大家看到的是同一条」。
|
|
48
|
+
- 页面长期不关(dsh 是常驻页)时靠 `visibilitychange` + **60s 轮询**比对日键来跨天刷新。
|
|
49
|
+
- 当天候选池 124 条 ⇒ **124 天不重复**;榜单每月 1 日重算,换月后可能与前月重复(可接受)。
|
|
50
|
+
- 榜单不可用 / 返回空 → 卡片显示「今日推荐暂不可用」,**不影响**其余视图(不是静默消失)。
|
|
51
|
+
- 想换成编辑每天点选(真正的「每日一荐」),只需把 `pickDaily()` 的数据源换成站点新接口,
|
|
52
|
+
界面不用动。
|
|
53
|
+
|
|
54
|
+
## 五个入口
|
|
21
55
|
|
|
22
56
|
| 入口 | 位置 | 说明 |
|
|
23
57
|
|---|---|---|
|
|
24
58
|
| 页签「严选插件」 | 会话视图区 | 完整页:视图切换 + 搜索 + 排序 + 批量浏览 |
|
|
25
|
-
| 左下入口 | 侧边栏底部(`sidebar.footer.action`) |
|
|
59
|
+
| 左下入口 | 侧边栏底部(`sidebar.footer.action`) | 浮窗**可见**时 = 展开/收起面板;关掉后 = 两步确认恢复(第一下上劲,5 秒内第二下才叫回胶囊) |
|
|
26
60
|
| 全站浮窗 | 右下角(`shell.overlay`,跨路由含首页) | 随手查:随时搜、随时装 |
|
|
61
|
+
| **设置 → 通用**(v0.5.0) | `settings.general.item` | 一行:浮窗显隐开关(最高频的那个) |
|
|
62
|
+
| **设置 → 插件 → 严选插件**(v0.5.0) | `settings.plugins.tab` | 完整设置页:浮窗 / 每日推荐 / 匿名统计 + 更新日志 + 恢复默认 |
|
|
63
|
+
|
|
64
|
+
设置页里的三个开关与别处**共用同一个状态源**(都读共享 store 并走同一条写路径),
|
|
65
|
+
所以不会出现「在通用里开了、到插件页签里还显示关」的错位。
|
|
66
|
+
|
|
67
|
+
## 更新检查与红点(v0.5.0)
|
|
68
|
+
|
|
69
|
+
「更新」视图一次回答两件事:**本插件自己**要不要升、**你装的其它 dsh 插件**里哪些有新版。
|
|
70
|
+
再加三处红点,让你不用主动去看也能知道。
|
|
71
|
+
|
|
72
|
+
**检查怎么做的**
|
|
73
|
+
|
|
74
|
+
| 环节 | 做法 | 依据 |
|
|
75
|
+
|---|---|---|
|
|
76
|
+
| 装了哪些 | 读 profile 的 `dependencies`(本机磁盘,零网络) | `~/.dsh/profiles/<p>/package.json` |
|
|
77
|
+
| 是不是插件 | `package.json` 有 `dsh` 字段,或依赖里出现 `@deepseek-ai/dsh` | **按插件契约判,不按 `dsh-` 前缀猜**(第三方包名五花八门);与站点 `lib/detect.ts` 分层判据同源 |
|
|
78
|
+
| 装了哪个版本 | 读 `node_modules/<pkg>/package.json` 的 `version` | 读不到 = 未知,不是「不是插件」 |
|
|
79
|
+
| 最新是哪个版本 | 逐包问 `registry.npmmirror.com/<pkg>/latest` | 站点 `/api/plugins` **不提供版本字段**,所以拿不了目录当版本源 |
|
|
80
|
+
|
|
81
|
+
代价与护栏(实测:本机 24 个依赖 → 21 个插件,**约 1 秒**):
|
|
82
|
+
|
|
83
|
+
- 并发上限 6(全串行十几秒,全并发容易被镜像限流);
|
|
84
|
+
- host 侧整体缓存 **10 分钟**,「检查更新」按钮用 `?refresh=1` 绕过缓存,但 **30 秒内只放行一次**;
|
|
85
|
+
- 客户端的结果是**模块级共享 store**:三处红点 + 「更新」视图共用一次请求(否则一次页面加载会打四遍)。
|
|
86
|
+
|
|
87
|
+
**红点怎么亮、怎么灭**
|
|
88
|
+
- 亮:**签名变化**才亮。签名 = 「包名@目标版本」排序后的串;只要出现比上次确认过的更新的版本,红点重新亮;
|
|
89
|
+
- 灭:你**看过「更新」视图**即视为已确认,签名落盘(`dph-hub-updates-acked`)。
|
|
90
|
+
这套思路与用户已有的 `check-updates` 本地补丁一致(那里存 acked-version),目的都是避免红点长期常亮;
|
|
91
|
+
- 三处都亮:侧边栏底部按钮、浮窗胶囊、设置页「更新日志」节标题旁。
|
|
92
|
+
首次检查由**始终挂着的侧边栏按钮**触发 —— 这正是"用户根本不知道有新版本"的解法所在;
|
|
93
|
+
- 红点带视觉隐藏文案:只有颜色没有文字,对读屏用户等于不存在。
|
|
94
|
+
|
|
95
|
+
> ⚠️ **三态**:`outdated` 为 `true` / `false` / `null`。任一端(本机版本或 npm 最新版)拿不到就记 `null`,
|
|
96
|
+
> 界面显示「查不到最新版」。**绝不写成「已是最新」** —— 本机 4 个只在本地开发、没发布到 npm 的插件
|
|
97
|
+
> 正是这种情况,混为一谈会让它们永远看起来是最新的。
|
|
98
|
+
|
|
99
|
+
**「这是谁」——中文名与说明从哪来**
|
|
100
|
+
|
|
101
|
+
只列 `dsh-context`、`billion-context` 这种包名,用户认不出是哪个插件,「更新」页的价值就塌了一半。
|
|
102
|
+
两个来源**互补、且单用都不完整**(2026-10-12 实测本机 desktop profile 的 20 个依赖):
|
|
103
|
+
|
|
104
|
+
| 来源 | 覆盖 | 特点 |
|
|
105
|
+
|---|---|---|
|
|
106
|
+
| 本机 `<pkg>/locale/zh.json` 的 `meta.title` / `meta.description` | **15/20** | 离线、零请求,**包自己声明**的,最贴近"这是谁" |
|
|
107
|
+
| 站点目录(一次 `take=500`;目录共 17304 条) | 9/20 | 补上了本机完全没有的那 5 个 |
|
|
108
|
+
| **并集** | **20/20** | 实测最终 19/19 条目都有中文名与中文说明,零裸包名 |
|
|
109
|
+
|
|
110
|
+
- 中文名优先显示,**包名退到第二行**(用户要靠它去搜或核对);`meta.title` 里常见的
|
|
111
|
+
「模型优惠时钟 (dsh-client-ui-model-clock)」这种重复包名会被去掉。
|
|
112
|
+
- 两个来源都拿不到时,显示包名 + 本机 `package.json` 的原文描述,并标注**「未汉化」** ——
|
|
113
|
+
**不翻译、不编造**(与卡片同一口径)。
|
|
114
|
+
|
|
115
|
+
**哪些包不该出现在"可升级"里(2026-10-12 实测修正)**
|
|
116
|
+
|
|
117
|
+
更新检查只看 npm 上有没有新版本,但**能不能升**还取决于 profile 清单里这个包是怎么写的。
|
|
118
|
+
实测本机 desktop profile 的 20 个依赖(同一天踩到两次误报):
|
|
119
|
+
|
|
120
|
+
| 清单里的写法 | 数量 | 能否靠 `plugin add` 升级 | 现在的处理 |
|
|
121
|
+
|---|---|---|---|
|
|
122
|
+
| `link:/Users/…/dsh-foo`(**本地链接**) | **11** | **不该升**:版本来自本机源码,升级会去装 npm 版本并**替换掉你的链接** | **不参与更新检查**,末尾单列一行说明 + 可展开看链接目标 |
|
|
123
|
+
| `0.5.27`(**精确锁定**,无 `^`) | 4 | `plugin add` 挪不动它(实测版本号纹丝不动) | 保留条目并打「清单锁定」标签,附一句"要升请先改成范围" |
|
|
124
|
+
| `^0.8.5`(范围) | 5 | 可以 | 正常显示可升级 |
|
|
125
|
+
|
|
126
|
+
> ⚠️ `link:` 的判定只看清单里写的是不是 `link:` / `file:`(`classifySpec()`),**不猜语义**。
|
|
127
|
+
> 它们的版本跟 npm 上的最新版没有关系,把"npm 上有新版本"当成"你该升级"是错的 ——
|
|
128
|
+
> 用户点一次、失败一次,而且方向本来就是错的(那 11 个里包括本插件自己)。
|
|
129
|
+
|
|
130
|
+
> ⚠️ **复制出去的安装命令必须用本机真实 profile**(同日修正的另一处):原先照抄站点详情页的
|
|
131
|
+
> `--profile web`,而 desktop profile 的用户拿去执行会装进 **web** profile —— 桌面版里永远看不到
|
|
132
|
+
> 那个插件,用户只会得出「安装不成功」。站点无法知道你本机用哪个 profile,所以这一处**必须分歧**。
|
|
133
|
+
|
|
134
|
+
> ⚠️ **`@latest` 在 dsh 这条路上是空转的 —— 升级目标必须写具体版本号**(2026-10-12 实测;
|
|
135
|
+
> 用户为此报了两次「升级不成功」)。同一台机器、同一个命令、只差版本写法:
|
|
136
|
+
>
|
|
137
|
+
> | 命令 | 结果 |
|
|
138
|
+
> |---|---|
|
|
139
|
+
> | `dsh plugin --profile desktop add dsh-context@latest` | `pnpm.log` **0 字节**、版本纹丝不动、**无任何报错**(静默空转) |
|
|
140
|
+
> | `dsh plugin --profile desktop add dsh-context@0.69.1` | `Done in 1.7s`,清单与安装目录都变成 `0.69.1` |
|
|
141
|
+
>
|
|
142
|
+
> 更新检查本来就知道目标版本,所以升级目标一律写成 `<包名>@<具体版本>`,**不走 `@latest`**;
|
|
143
|
+
> 复制出去的升级命令同理。副作用(实测):dsh 会往 profile 的 `pnpm-workspace.yaml` 写一条
|
|
144
|
+
> `minimumReleaseAgeExclude`(目标版本太新时),并可能精简依赖树(本次 `Packages: +2 -26`)。
|
|
145
|
+
>
|
|
146
|
+
> ⚠️ 另:**退出码 0 不等于装上了**。host 在安装任务结束后**亲自读磁盘**比对版本
|
|
147
|
+
> (`changed = 装前 !== 装后`),不一致时界面直说「dsh 报告成功,但什么都没装」,
|
|
148
|
+
> 并且不给「立即重启」按钮 —— 报「已安装」是撒谎。
|
|
149
|
+
|
|
150
|
+
> ⚠️ **偶发失败会重试一次**(只一次,不是循环):同一台机器、同一条命令,紧挨着的多次操作会抢同一个
|
|
151
|
+
> `pnpm-lock.yaml` 而报 `Command failed with exit code 1`(dsh 的日志**只记命令行、不记 pnpm 输出**),
|
|
152
|
+
> 隔几分钟单独跑一次就成功 —— 实测就是这样。重试是幂等的(`pnpm add 同一个版本`),
|
|
153
|
+
> 且宿主侧本来就单飞(并发直接 409)。埋点上记 `way=retry`,能看出有多少次是第一把失败。
|
|
154
|
+
|
|
155
|
+
|
|
156
|
+
> ⚠️ 装完**立即重取清单**:host 在安装成功时会作废自己的更新缓存,客户端装完(单条与批量收尾)再拉一次。
|
|
157
|
+
> 否则行上还是旧版本号 —— 用户看到的"可升级"和实际结果对不上,自然会判定"升级没成功"。
|
|
158
|
+
|
|
159
|
+
**一个被用户实测撞出来的语义坑:`outcome` 不是布尔**
|
|
160
|
+
|
|
161
|
+
装完由 host 读盘比对,结果是**三态**,不能压成一个布尔(2026-10-12 实测被误导过一次):
|
|
162
|
+
|
|
163
|
+
| `outcome` | 含义 | 界面 |
|
|
164
|
+
|---|---|---|
|
|
165
|
+
| `changed` | 真的装上了 / 升级了 | 「已安装」+ 本地通道给「立即重启」 |
|
|
166
|
+
| `same` | **本来就是目标版本** | 「已经装的就是这个版本」—— 这是**成功**,不是失败 |
|
|
167
|
+
| `none` | 装前装后都查不到 | 「dsh 报告成功,但什么都没装」(真的什么都没发生) |
|
|
168
|
+
|
|
169
|
+
> 起因:用户在目录卡片上点「安装」装一个**早就装好**的插件(`dsh-prompt-manager`,1.5.2 == npm 最新),
|
|
170
|
+
> 旧版把 `changed === false` 一律说成「什么都没装」—— 用户自然读成"安装失败"。
|
|
171
|
+
> 同一轮还加了**目录卡片的「已安装 vX」标注**(`/search` 与 `/best` 下发时补 `installed`,
|
|
172
|
+
> **不进缓存**,装完立刻可见):让用户一眼看出这东西已经在跑了,而不是反复点「安装」再判定失败。
|
|
173
|
+
|
|
174
|
+
|
|
175
|
+
|
|
176
|
+
**装完 ≠ 生效:待重启横幅(v0.5.0)**
|
|
177
|
+
|
|
178
|
+
桌面 profile 实测**没有 dshmarket**(只有 `dsh-restart` 的链接),所以一键安装在桌面端
|
|
179
|
+
**全走本地通道** —— 每一次安装/升级都要重启 dsh 才生效。「装了没启用」是实装验证率最大的
|
|
180
|
+
漏点,所以本地通道装成之后:
|
|
181
|
+
|
|
182
|
+
- 记一条 `dph-hub-restart-pending`(名字**合并去重**,连装几个只出一条),在面板与页签
|
|
183
|
+
**顶部常驻横幅**:已装了什么 + 「立即重启」(**两步确认**,重启会掐断当前会话)+
|
|
184
|
+
「知道了」(用户自己认领,清掉提醒)。**跨视图、跨会话** —— 行内提示会跟着卡片滚走。
|
|
185
|
+
- 横幅挂载时读 `/api/dpharness/meta` 的 `startedAt`:**它比 `pending.at` 新 = 重启发生过**,
|
|
186
|
+
横幅改口说「已生效」,不再催(与 host `post_install` 回执用的是同一个信号;
|
|
187
|
+
取不到就按未重启处理 —— 宁可多提醒一次,也不把提醒悄悄吞掉)。
|
|
188
|
+
- 市场通道(热挂载)与 `same` / `none`(版本没动)**不记**:没什么可重启的。
|
|
189
|
+
|
|
190
|
+
**一键升级 / 全部升级**
|
|
191
|
+
|
|
192
|
+
升级**复用安装那条通道**(同一个 `InstallRow`,只换 `kind`):二次确认 → 进度 → 失败原因 → 重启提示。
|
|
193
|
+
目标写成 `<包名>@<具体版本>`(**不是 `@latest`** —— 见上:「`@latest` 在 dsh 上是空转的」)。
|
|
194
|
+
|
|
195
|
+
- 「全部升级」**必须串行**:宿主同一时刻只允许一个安装任务(并发只会拿到 409),
|
|
196
|
+
所以是逐个 `await` + 总进度(`3/13`)+ **可中止**(中止后未轮到的项保持原状,不做任何事)。
|
|
197
|
+
- 升级完**需要重启 dsh** 才生效,批量结束后统一给重启出口。
|
|
198
|
+
- ⚠️ **dsh 自己就是那道闸门**(修正:早期版本这里写的是「没有兼容性校验」,**错了**):
|
|
199
|
+
`dsh plugin add` 会拿**目标版本**的 `peerDependencies` 跟本机 dsh 比对,不匹配就**硬拒绝**
|
|
200
|
+
(dsh 的原话:*Running it may cause crashes or data loss*)。实测本机 `dsh 0.2.0-rc.2`:
|
|
201
|
+
|
|
202
|
+
| 插件最新版 | 声明的 peer 范围 | 结果 |
|
|
203
|
+
|---|---|---|
|
|
204
|
+
| `dsh-context@0.69.1` | `>=0.1.7-rc.2`(无上界) | ✅ 放行 |
|
|
205
|
+
| `dsh-cost-meter@1.8.22` | `… \|\| >=0.2.0-rc.1 <0.3.0-0` | ✅ 放行 |
|
|
206
|
+
| `dsh-mnemon@0.5.28` / `dsh-free-search@0.8.8` | `^0.1.7-rc.x \|\| ^0.2.0-rc.1` | ✅ 放行 |
|
|
207
|
+
| `dsh-restart@0.1.2` | `^0.1.1-rc.2` | ❌ **被拒** |
|
|
208
|
+
| `dsh-deepseek-web@1.0.3` | `^0.1.0-rc.7` | ❌ **被拒** |
|
|
209
|
+
|
|
210
|
+
⇒ 同一份「可升级」列表里**既有装得上的、也有装不上的**,取决于各插件有没有把 peer 范围跟上——
|
|
211
|
+
这不是本插件能决定的,界面必须把两件事都说清楚。
|
|
212
|
+
- 被拒时界面给的是**原因 + 两端版本 + 放行通道**(dsh 自己的 `dsh plugin allow-version`,
|
|
213
|
+
或插件管理器里的「精确版本豁免」),并明确**不代用户放行** —— 那道闸门防的正是崩溃与数据损坏。
|
|
214
|
+
⚠️ 这里踩过一个坑:dsh 那句拒绝文本里**没有** `ERR_` / `error` / `failed` 任何关键词,
|
|
215
|
+
通用的错误提取器抓不到它,界面只剩一句 `dsh: nothing was installed.`,用户完全看不出为什么
|
|
216
|
+
—— 所以 host 侧加了专用解析器 `incompatibleFrom()`,把它变成闭集原因 `why=incompatible`
|
|
217
|
+
(可单独统计),而不是"某次失败"。
|
|
218
|
+
- 被拒过的版本记在本机(`dph-hub-blocked`),下次直接在行上标「dsh 不兼容」,省掉一次白点。
|
|
219
|
+
**不做预判**:预判要自己实现 semver 范围求值,猜错会误伤(宁可让用户点一次看到真实结果)。
|
|
220
|
+
- 界面上始终保留「复制升级命令」作为可核对的退路。
|
|
221
|
+
- 埋点上**升级与安装分开记账**:`install*` 与 `upgrade*` 两套事件名 ——
|
|
222
|
+
「装新插件」(发现)与「把已装的升到最新」(维护)混成一个数,两边都读不出结论。
|
|
223
|
+
|
|
224
|
+
|
|
225
|
+
> ⚠️ 「恢复默认」**刻意不清**红点的确认标记:它是"我看过了",不是"我的偏好";
|
|
226
|
+
> 一并清掉只会让用户刚关掉的红点立刻又亮起来。
|
|
227
|
+
|
|
228
|
+
> 💡 升级命令里的 profile 用**本机真实值**拼(桌面版是 `desktop` 而不是 `web`)。
|
|
229
|
+
> 本插件只给命令、不代你安装。
|
|
230
|
+
|
|
231
|
+
> ⚠️ **改了插件代码 ≠ 立即生效**:客户端是刷新页面即生效,但 **host 的路由要重启 dsh 才会注册**。
|
|
232
|
+
> 这个窗口期里 `/api/dpharness/updates` 会落到 dsh 静态前端的兜底上、返回**纯文本**(实测
|
|
233
|
+
> 桌面版 `not found`、无凭据时 `unauthorized`)。界面因此给出「本机 host 还没提供这个接口 ——
|
|
234
|
+
> 通常是 dsh 未重启」,并在本机装了 `dsh-restart` 时给一个**两步确认**的重启按钮。
|
|
235
|
+
> 早期版本在这里直接把 `response.json()` 的解析错误抛给用户
|
|
236
|
+
> (`Unexpected token 'o', "not found" is not valid JSON`),真实原因被彻底掩盖 —— 已修:
|
|
237
|
+
> 四个取数 hook 现在共用 `readHostJson()`,先取文本再解析,解析失败一律标成「路由未注册」。
|
|
27
238
|
|
|
28
239
|
## 浮窗可以彻底关掉(v0.4.4)
|
|
29
240
|
|
|
30
241
|
`shell.overlay` 是**跨路由常驻**的:胶囊在首页、会话页、任何页面都在。
|
|
31
|
-
`open` 只表示「展开 /
|
|
242
|
+
`open` 只表示「展开 / 收起」,此前用户**没有**把这块东西从屏幕上拿掉的手段。现在四条路径:
|
|
32
243
|
|
|
33
244
|
| 关闭 | 位置 |
|
|
34
245
|
|---|---|
|
|
35
246
|
| 胶囊右端的 `×` | 悬浮胶囊上(直接关) |
|
|
36
247
|
| 面板底部的「隐藏浮窗」 | 展开状态下面板页脚 |
|
|
37
248
|
| 「严选插件」页底部取消勾选「显示右下角浮窗」 | 会话端页签页脚 |
|
|
249
|
+
| **设置 → 通用 / 设置 → 插件**(v0.5.0) | 显式的设置入口 |
|
|
38
250
|
|
|
39
|
-
关闭 = `hidden` 状态,写进 `localStorage`(`dph-hub-hidden
|
|
251
|
+
关闭 = `hidden` 状态,写进 `localStorage`(`dph-hub-hidden`),**下次进来仍然是关的**;
|
|
252
|
+
关闭后**没有任何路径会自动把它弹回来**(`open: true` 在全文件只出现在右下角胶囊的
|
|
253
|
+
用户点击里,`test-local.mjs` 对这一点有静态断言)。
|
|
40
254
|
|
|
41
|
-
> ⚠️ 关闭必须配恢复入口,否则就变成"关掉找不回来"
|
|
42
|
-
> ①
|
|
43
|
-
> ②
|
|
255
|
+
> ⚠️ 关闭必须配恢复入口,否则就变成"关掉找不回来"。三个恢复入口(误点都不会复活浮窗):
|
|
256
|
+
> ① 「严选插件」页签底部的「显示右下角浮窗」开关(只取消隐藏,不强行弹面板)
|
|
257
|
+
> ② 设置 → 通用 / 设置 → 插件 → 严选插件 的「右下角浮窗」开关(v0.5.0)
|
|
258
|
+
> ③ 侧边栏底部「严选插件」按钮 —— **两步确认**:隐藏态第一下只上劲(按钮描边 +
|
|
259
|
+
> 标记脉冲 + 提示「再点一次恢复浮窗」,5 秒内有效),第二下才把胶囊叫回来。
|
|
260
|
+
>
|
|
261
|
+
> 为什么是两步而不是一步(2026-10-13 用户反馈:「胶囊用户关闭了就别默认打开了」
|
|
262
|
+
> —— 10-12 那版点一次就叫回胶囊,等于没关掉);而纯无反应的按钮又被用户当成
|
|
263
|
+
> 「没生效」。两步两头都照顾:习惯性误点不会复活浮窗,真想找回也只要两下,
|
|
264
|
+
> 且按钮永远有可见反馈。只有浮窗**可见**时,点它才展开/收起面板。
|
|
265
|
+
>
|
|
44
266
|
> 判定顺序写死在代码里:`state.hidden` 时**整块浮窗(胶囊 + 面板)都不渲染**。
|
|
45
267
|
>
|
|
46
268
|
> 胶囊上的 `×` 是胶囊的**兄弟节点**(绝对定位盖在右端),不是它的子节点 ——
|
|
47
269
|
> `<button>` 里套 `<button>` 是非法 HTML,且 `pointerdown` 会冒泡到胶囊上把点击变成拖动。
|
|
48
270
|
|
|
271
|
+
> 💡 **老宿主兼容**:`settings.general.item` / `settings.plugins.tab` 在旧版 dsh 上可能不存在。
|
|
272
|
+
> `slots.inject` 在槽位未声明时只是登记等待、永不激活,因此**不会报错、也不会拖累插件加载**
|
|
273
|
+
> —— 表现为这两个设置入口干脆不出现,其余功能照常。(依据:`@deepseek-ai/dsh-client-runtime`
|
|
274
|
+
> `src/client/slots.ts` 的 `inject` 实现,2026-10-12 查证。)
|
|
275
|
+
|
|
276
|
+
|
|
277
|
+
## 更新日志与「你装的不是最新版」(v0.5.0)
|
|
278
|
+
|
|
279
|
+
放在 **设置 → 插件 → 严选插件** 的最底部。一次给出三件事,缺一件就不好用:
|
|
280
|
+
|
|
281
|
+
| 给出 | 来源 | 说明 |
|
|
282
|
+
|---|---|---|
|
|
283
|
+
| 你装的是哪个版本 | host 的代码常量 `VERSION` | 客户端读不到 `package.json`,版本只可能由 host 提供 |
|
|
284
|
+
| 有没有更新的版本 | `registry.npmmirror.com/dsh-dpharness/latest` | **三态**:`true` / `false` / `null`(`null` = 没查到,**绝不显示成「已是最新」**) |
|
|
285
|
+
| 怎么升 | 本机真实 profile 拼出的 `dsh plugin --profile <p> add dsh-dpharness@latest` | profile 名按本机填好(桌面版是 `desktop` 不是 `web`),点一下复制 |
|
|
286
|
+
|
|
287
|
+
**日志正文的权威源只有一份**:`lib/changelog.js`。客户端**不持有副本** —— 双份数据必然漂移
|
|
288
|
+
(本站在「安装命令口径」上已经栽过一次)。客户端读的是**本机 host** 的只读路由,
|
|
289
|
+
于是「内置数据」与「离线可用」两个性质同时成立。
|
|
290
|
+
|
|
291
|
+
内容优先级(`mergeChangelog()` 的规则,逐条有单测):
|
|
292
|
+
|
|
293
|
+
1. GitHub 有对应版本的 Release → **用 Release 正文覆盖内置**(Release 才是发版当时的正式说明,且能事后修正);
|
|
294
|
+
2. Release 正文为空 → **不覆盖**(空 release 很常见,覆盖等于丢信息);
|
|
295
|
+
3. Release 有、内置没有的版本 → 补进来;
|
|
296
|
+
4. 其余用内置底稿;输出按版本号从新到旧(顺序本身就是信息)。
|
|
297
|
+
|
|
298
|
+
> ⚠️ **发版纪律(有测试兜底)**:`lib/changelog.js` 里**第一条的版本号必须等于 `package.json` 的
|
|
299
|
+
> `version`**,否则「更新日志」会悄悄落后于实际发版 —— 那比没有更新日志更糟。
|
|
300
|
+
> `test-local.mjs` 对这两处(代码常量与 package.json)双向断言。
|
|
301
|
+
|
|
302
|
+
> 💡 远端当前**没有任何 Release**(`api.github.com/.../releases` 实测返回 `[]`),
|
|
303
|
+
> 故 `source` 恒为 `builtin`,日志直接来自内置底稿。想让 Release 生效,
|
|
304
|
+
> 先在 GitHub 上按 `vX.Y.Z` 的 tag 发 Release,之后同名版本会以 Release 正文为准。
|
|
305
|
+
|
|
49
306
|
## 卡片显示什么
|
|
50
307
|
|
|
51
308
|
按「汉化优先」组织,缺汉化时明确标注而不是假装有:
|
|
@@ -78,6 +335,17 @@
|
|
|
78
335
|
- 只有站点给出 `installCheck.status === "pass"` 的条目才显示安装按钮
|
|
79
336
|
(校验未过时 npm 上的同名包**可能属于别人**)。
|
|
80
337
|
- 安装前有二次确认,展示将要执行的包名。
|
|
338
|
+
- **CLI 入口按宿主自动定位**(2026-09-30 修复):
|
|
339
|
+
- 常规 `dsh web`(launchd/终端):复用启动本 host 的 `process.argv[1]`,即 `<prefix>/bin/dsh`;
|
|
340
|
+
- **Electron 桌面版**(`@deepseek-ai/dsh-desktop`):host 跑在 Electron 进程里,
|
|
341
|
+
`argv[1]` 是 `--expose-internals` 而非路径 —— 旧逻辑在这里必然返回 null,
|
|
342
|
+
表现为**每次安装都失败**(`cannot locate the dsh entry point (process.argv[1])`)。
|
|
343
|
+
现改为使用 app 自带的 `<Contents>/Resources/runtime/cli/bin/dsh`(该脚本自己设
|
|
344
|
+
`ELECTRON_RUN_AS_NODE=1` 并指向 `dsh-desktop-host/lib/cli.js`)。
|
|
345
|
+
**未识别到 Electron 壳时不去猜路径**,宁可如实报错也不乱 spawn。
|
|
346
|
+
- profile 也按宿主判定:桌面版把 profile 目录作为位置参数传入
|
|
347
|
+
(实测 `…/.dsh/profiles/desktop`),只认磁盘上真实存在的 profile 目录;
|
|
348
|
+
否则会 fallback 成 `web`,把插件装进错误的 profile。
|
|
81
349
|
- dshmarket 返回 **409**(有 agent 正在运行)时**不降级**,直接报错 —— 避免和正在工作的 agent 抢插件文件。
|
|
82
350
|
- 目标包名过字符白名单校验;子进程环境会剥掉宿主的 safe-delete shim(否则 pnpm 清理临时文件被拦)。
|
|
83
351
|
- 失败时展示 pnpm 的错误码行(如 `[ERR_PNPM_FETCH_404] …`),而不是一堆进度日志。
|
|
@@ -92,18 +360,49 @@
|
|
|
92
360
|
|---|---|---|
|
|
93
361
|
| `hello` | 插件被加载 | 有哪些版本在用(老版本发不出新事件,空值必须能和「没人做」区分) |
|
|
94
362
|
| `open` / `search` / `best_open` | 打开面板 / 搜索 / 切到分类精选 | 入口有没有用 |
|
|
95
|
-
| `
|
|
363
|
+
| `sets_open` | 切到「套装」取数成功(带 `n` = 方案数) | 方案入口有没有人用 |
|
|
364
|
+
| `set_copy` / `set_site` | 复制某套装的批量命令 / 点「看方案详情」(带 `slug`) | 哪几套真被拿去装、哪几套被深读 |
|
|
365
|
+
| `set_install_ask` / `set_install_start` / `set_install_done` | 一键安装整套:上劲 / 开跑 / 收尾(带 `slug` 与 `n`) | 方案包有没有人整包装、装完几个 |
|
|
366
|
+
| `remove_ask` / `remove_cancel` / `remove_start` / `remove_ok` / `remove_noop` / `remove_failed` | 卸载的完整漏斗(`noop` = 报成功但磁盘没变,与安装的 same 同类) | 卸载有没有人用、卡在哪 |
|
|
367
|
+
| `ignore_on` / `ignore_off` | 忽略此版本 / 取消忽略(带 `pkg`、`v`) | 「别提醒我这一版」是不是真需求 |
|
|
368
|
+
| `compare_on` / `compare_off` / `compare_clear` / `compare_copy` | 加入对比 / 移出 / 清空 / 从对比表复制命令 | 对比有没有人真用(服务「内容评测」那条差异化) |
|
|
369
|
+
| `fav_on` / `fav_off` / `fav_copy` / `fav_install_ask` | 收藏待装:加入 / 移出 / 从收藏复制命令 / 一键装全部 | 「先攒后装」是不是真需求 |
|
|
370
|
+
| `site_click`(`scope=benefits`) | 点福利专区入口 | 资源位有没有人看 |
|
|
371
|
+
| `hide` / `show` | 手动关闭浮窗 / 重新打开(页签底部与设置页共用同一条写路径) | 有多少人嫌这个浮窗碍事(`scope` 区分是胶囊、面板、页签还是设置触发的) |
|
|
372
|
+
| `daily_toggle` | 每日推荐开关(`scope=settings:on` / `settings:off`) | 「每天一条」有没有人嫌多余 |
|
|
373
|
+
| `changelog_open` | 打开设置页时**发现自己是旧版** | 有多少人停在旧版本上(只上报「确实有新版」的情况) |
|
|
374
|
+
| `upgrade_copy` | 复制升级命令 | 看完日志真的去升级的比例 |
|
|
375
|
+
| `upgrade_ask` / `upgrade_cancel` / `upgrade` / `upgrade_done` / `upgrade_failed` | 一键升级的完整漏斗(**与安装分开记账**) | 升级这条路走不走得通;「装新插件」与「升级已装」不能混成一个数 |
|
|
376
|
+
| `upgrade_all_ask` / `upgrade_all_stop` / `upgrade_all_done` | 全部升级:发起 / 中止 / 收尾(带 `n`) | 批量是不是真有人用、会不会半途被中止 |
|
|
377
|
+
| `updates_check` | 点「检查更新」(`scope` 区分浮窗/页签) | 有多少人会主动查 |
|
|
378
|
+
| `updates_ack` | 打开「更新」视图确认更新(带 `n` = 确认了几项) | 红点有没有被看见(没 ack 说明三处入口都没被注意到) |
|
|
379
|
+
| `prefs_reset` | 设置页点「恢复默认」 | 有多少人需要回到出厂状态(往往意味着某个默认值不合适) |
|
|
96
380
|
| `install_ask` | 点「安装」(弹出确认框) | 有多少人真的动了安装的念头 |
|
|
97
381
|
| `install_cancel` | 确认框点取消 | 被确认框劝退的人(文案/门槛的优化对象) |
|
|
98
382
|
| `install` | 确认后开始安装 | 真正发起的安装 |
|
|
99
383
|
| `install_failed` | 安装失败(含 `via` 阶段与 `why` 原因) | 失败卡在哪一步 |
|
|
100
384
|
| `installed_market` / `installed_local` | 安装成功(热挂载 / 需重启) | 装成了多少 |
|
|
101
|
-
| `
|
|
385
|
+
| `restart_ask` | 点「立即重启」(进入两步确认,`scope` 区分横幅 / 更新视图 / 安装行) | 有多少人走到重启这一步(与真重启的差 = 被确认框劝退) |
|
|
386
|
+
| `restart_click` | 点「立即重启」的第二步(确认) | 需重启的那批里有多少人真的重启了 |
|
|
387
|
+
| `restart_ack` | 点「知道了」(认领提醒 / 确认已生效) | 有多少人选择自己重启,或已经确认生效 |
|
|
102
388
|
| `post_install` | **下一次加载时**回查 | 重启发生没发生、装的包进了加载清单没有 |
|
|
103
389
|
|
|
104
|
-
`why` 是**闭集枚举**(`busy` / `
|
|
105
|
-
`cli_exit` / `timeout` / `restart_http`),不是错误原文 —— 原文含本地路径与包名,
|
|
106
|
-
|
|
390
|
+
`why` 是**闭集枚举**(`busy` / `http_<status>` / `network` / `local_rejected` /
|
|
391
|
+
`poll_unreachable` / `cli_exit` / `timeout` / `restart_http`),不是错误原文 —— 原文含本地路径与包名,
|
|
392
|
+
既不可聚合也不该外发。市场的 HTTP 失败细分成 `http_<status>`(`http_405` = 路由缺席、
|
|
393
|
+
`http_403` = 被拦、`http_5xx` = 上游故障),只匹配到「通道不可用」时另发
|
|
394
|
+
`market_unavailable` 事件并照常降级到本地通道。
|
|
395
|
+
|
|
396
|
+
> 💡 **新增 action 值不需要改站点**:站点 `/api/track/event` 的白名单校验的是 **`type`**
|
|
397
|
+
> (`plugin_hub` / `copy_install`),而 `action` 是拼进 `value` 的自由文本
|
|
398
|
+
> (host 侧 `clean(detail.action, 24)`,只做字符收紧与截断)。所以 v0.5.0 的
|
|
399
|
+
> `daily_toggle` / `prefs_reset` 不需要跨仓库放行。
|
|
400
|
+
|
|
401
|
+
> ⚠️ 搜索结果里的 **`total` 才是命中总数**,`count` 只是本次返回条数(等于 `take`)。
|
|
402
|
+
> 站点的 `GET /api/plugins` 两者都给,早期版本只取 `list.length` 当结果数,于是
|
|
403
|
+
> 「共 N 条结果」里的 N 恒等于 30 —— **搜索前后数字不变**,用户据此判定「搜索不生效」
|
|
404
|
+
> (2026-09-30 实测:搜「统计」真实命中 106 条,面板却写死「共 30 条结果」)。
|
|
405
|
+
> 现在卡片上方的副标题是「共 106 条结果 · 已显示前 30 条」,重新搜索期间显示「搜索中…」。
|
|
107
406
|
|
|
108
407
|
### 「安装成功之后」怎么验证
|
|
109
408
|
|
|
@@ -126,8 +425,10 @@
|
|
|
126
425
|
|
|
127
426
|
| 路由 | 说明 |
|
|
128
427
|
|---|---|
|
|
129
|
-
| `GET /api/dpharness/search?q=&take=&sort=stars` | 目录查询,字段裁剪后返回,按 `q+take+sort` 缓存 5
|
|
428
|
+
| `GET /api/dpharness/search?q=&take=&sort=stars` | 目录查询,字段裁剪后返回,按 `q+take+sort` 缓存 5 分钟。响应含 `count`(本次返回条数)与 `total`(该筛选下的真实命中总数,**展示口径以它为准**) |
|
|
130
429
|
| `GET /api/dpharness/best` | 分类精选榜单(站点 `/api/best` 的代理 + 字段裁剪),缓存 5 分钟 |
|
|
430
|
+
| `GET /api/dpharness/changelog` | 更新日志(内置底稿 + 可选 GitHub Releases)+ 当前/最新版本比对 + 升级命令,缓存 5 分钟 |
|
|
431
|
+
| `GET /api/dpharness/updates` | 本插件 + 已装插件的更新检查(逐包问 npmmirror,并补上中文名与说明),缓存 10 分钟;`?refresh=1` 绕过但 30 秒只放行一次 |
|
|
131
432
|
| `GET /api/dpharness/postinstall?pkg=&via=&at=` | 安装后回执(只读:进程启动时间 + profile 加载清单) |
|
|
132
433
|
| `POST /api/dpharness/event` | 埋点代理 → `dpharness.com/api/track/event` |
|
|
133
434
|
| `POST /api/dpharness/install` | `{ pkg }`,spawn `dsh plugin add`;返回 202 + 任务启动 |
|
|
@@ -146,7 +447,48 @@
|
|
|
146
447
|
来源靠 `path=/dsh-plugin` 区分。
|
|
147
448
|
- 回执查询只读本机 profile 的清单文件,结果仅两个布尔量。
|
|
148
449
|
- 浮窗与页签底部都有**匿名统计开关**,可随时关闭;页签底部另有**浮窗显示开关**。
|
|
450
|
+
- **所有偏好只存在本机 `localStorage`,一项也不上传**:`dph-hub-hidden`(浮窗显隐)、
|
|
451
|
+
`dph-hub-pos`(浮窗位置)、`dph-hub-daily`(每日推荐开关)、`dph-hub-telemetry`(统计开关)、
|
|
452
|
+
`dph-hub-updates-acked`(已确认过的可升级集合签名,用于熄灭红点)。
|
|
453
|
+
设置页的「恢复默认」只清前四项,**刻意不动**访客 ID(统计口径的连续性)、安装回执(一次性凭据)
|
|
454
|
+
与红点确认标记(清了会让刚关掉的红点立刻又亮)。
|
|
455
|
+
- 更新检查**只读本地文件与只读 registry**:不上传你装了哪些包,也不代替你安装任何东西。
|
|
149
456
|
- 埋点经本地 host 转发(站点端点不带 CORS 头),失败静默忽略,绝不影响操作。
|
|
457
|
+
- 安装失败时展示的 pnpm 输出(卡片上的诊断行)**展示前统一脱敏**:
|
|
458
|
+
`.npmrc` 形态的凭据(`_authToken` / `_auth` / `_password` / `token=`)、
|
|
459
|
+
`Authorization: Bearer …` 以及裸 `npm_…` token 一律替换为 `***`。
|
|
460
|
+
pnpm 多数时候会自己打成 `Bearer npm_[hidden]`,但那不是契约 —— 这里按最坏情况兜底。
|
|
461
|
+
**判据是"展示路径是否存在",不是"凭据是否已泄露"**:路径还在,换 token 也没用。
|
|
462
|
+
- 脱敏顺序固定为**先截断(600 字)后替换**:反过来的话,截断会把 token 切成半截,
|
|
463
|
+
半截既匹配不上模式、又照样是泄露。
|
|
464
|
+
|
|
465
|
+
## 发布前回归(有真实用户后必做)
|
|
466
|
+
|
|
467
|
+
发版前把下面三步走一遍 —— 每一步都能留下可核对的输出,不是"看着像没问题":
|
|
468
|
+
|
|
469
|
+
1. **干净 profile 安装**(验打包与 bundle 声明):
|
|
470
|
+
`"<App>/Contents/Resources/runtime/cli/bin/dsh" plugin --profile <临时名> add <本仓库绝对路径>`
|
|
471
|
+
然后核对三件事:profile 的 `dependencies` 里有本插件、`dsh.profile.bundles` 里有 `dpharness`、
|
|
472
|
+
`files` 清单里的文件**全部落地**(漏一个客户端就白屏 —— 这一步专门防它)。
|
|
473
|
+
2. **host 侧边界回归**:用 `DSH_DPHARNESS_PROFILE=<临时名>` 把 `lib/index.js` 跑一遍八条路由,
|
|
474
|
+
重点是**空环境**(除自己外 0 个插件)不崩:`counts` 自洽、`locals` 含自己、`self` 有中文名、
|
|
475
|
+
`/search` 每条都带 `installed`、`postinstall` 能查到 `dep`/`bundled`。
|
|
476
|
+
3. **客户端渲染回归**:`test-local.mjs` 的参数化断言 **+ 面板展开态 / 每日 / 分类精选 / 更新视图的 SSR 渲染**。
|
|
477
|
+
后者是 `node --check` 抓不到的那一层 —— 实测它抓到过一个 `batchAsk` 用错组件的 `ReferenceError`
|
|
478
|
+
(`node --check` 与参数化断言都放过了它)。
|
|
479
|
+
|
|
480
|
+
> ⚠️ 桌面版 CLI 会自己注入 profile:`dsh web --profile X` 会报 `select a profile only once`,
|
|
481
|
+
> 所以第 2 步用模块级 harness,而不是另起一个实例。
|
|
482
|
+
|
|
483
|
+
## 权限与外部服务(上架声明)
|
|
484
|
+
|
|
485
|
+
- **网络**:访问 `dpharness.com` 站点端点(目录 / 榜单 / 埋点回执)、`api.github.com`(**只读** releases,用于补全更新日志;当前仓库未发过 Release,故此路通常返回空)与 `registry.npmmirror.com`(**只读** `<包名>/latest`:既用于判断本插件是否最新,也用于逐包检查你已安装的插件)。三处都只发 GET,任一失败都静默降级、不影响功能;一键安装走 `dsh` CLI,本插件不直接下载第三方包。
|
|
486
|
+
- **网络量级(明确声明)**:更新检查会对 profile 的**每一个直接依赖**各发一次只读 registry 请求(本机实测 24 个依赖 / 约 1 秒,并发上限 6);另外为补「这是谁」会向本插件自己的站点发**一次**目录请求(`take=500`,30 分钟缓存,只在有缺口时发)。host 侧整体缓存 10 分钟;不点「检查更新」时每个页面加载最多触发一轮。检查结果只留在本机。
|
|
487
|
+
- **文件**:只读 DSH Profile 内的清单文件(回执查询);不写 Profile 之外的任何路径。
|
|
488
|
+
- **命令**:不执行 shell 命令;「一键安装」是把安装命令复制到剪贴板/交给宿主 CLI,由用户触发。
|
|
489
|
+
- **凭据**:不读取、不存储任何凭据;也**不在任何展示或上报路径里输出凭据**(安装日志统一脱敏,见「隐私」)。
|
|
490
|
+
- **失败边界**:埋点与回执失败一律静默降级,不影响目录浏览与宿主稳定性。
|
|
491
|
+
- **兼容性**:DSH 逐版本声明见 `package.json` 的 `dsh.compatibility.dshReleases`(当前 `0.2.0-rc.2: compatible`,v0.4.3 起实装验证);Node `>=22`。
|
|
150
492
|
|
|
151
493
|
## 安装本插件
|
|
152
494
|
|
package/icon.svg
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64" role="img" aria-label="严">
|
|
2
|
+
<defs>
|
|
3
|
+
<linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
|
|
4
|
+
<stop offset="0" stop-color="hsl(333 68% 56%)"/>
|
|
5
|
+
<stop offset="1" stop-color="hsl(5 72% 42%)"/>
|
|
6
|
+
</linearGradient>
|
|
7
|
+
</defs>
|
|
8
|
+
<rect width="64" height="64" rx="15" fill="url(#g)"/>
|
|
9
|
+
<path d="M0 46c14 8 34 10 64 4v14H0z" fill="#fff" opacity="0.08"/>
|
|
10
|
+
<text x="32" y="41" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif" font-size="30" font-weight="600" fill="#ffffff">严</text>
|
|
11
|
+
</svg>
|