dsh-dpharness 0.6.3 → 0.6.4

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 CHANGED
@@ -88,6 +88,30 @@ dateKey = YYYY-MM-DD(**固定 UTC+8**,不是本地时区)
88
88
  设置页里的三个开关与别处**共用同一个状态源**(都读共享 store 并走同一条写路径),
89
89
  所以不会出现「在通用里开了、到插件页签里还显示关」的错位。
90
90
 
91
+ ## 社群与订阅入口(v0.6.4)
92
+
93
+ 一条卡,三处出现,内容相同、版式不同:
94
+
95
+ | 位置 | 版式 | 说明 |
96
+ |---|---|---|
97
+ | 页签「严选插件」 | 宽版(通栏) | 挂在「待重启」横幅同一层,**不随列表滚走** |
98
+ | 全站浮窗 | compact | 面板底部;省掉说明行,二维码与表单各占一行 |
99
+ | 设置 → 插件 → 严选插件 | 宽版 · 无外框 | 开关之后、更新日志之前,用一条分隔线接入 |
100
+
101
+ **交流群**:QQ 群与飞书群两个入口,二维码**默认收起**,点「查看二维码」才展开
102
+ (展开约 +120px,页签首屏会被列表挤走)。二维码不存图 —— 取站点 `GET /qr?url=…`
103
+ 按群链接现生成 PNG,换群链接后码自动跟着变。尺寸 **84px 是下限**(站点实测:64px
104
+ 时 jsQR 已解不出,72px 是临界),不要再改小。
105
+
106
+ **邮件订阅**:插件内直接填邮箱即可,不必跳站。提交经本机 host 的
107
+ `POST /api/dpharness/subscribe` 转发到站点 —— 站点 `/api/subscribe` 是 double opt-in
108
+ (入库 pending → 发确认信 → 点链接才 confirmed),且**不带 CORS 头**,浏览器跨源直发
109
+ 不成立(与埋点代理同一条实测结论)。
110
+
111
+ > 群链接的真源在站点 `lib/community.ts`(首页右栏 / 文章页 CTA / 全站页脚三处读它)。
112
+ > 本插件是独立 npm 包,不能 import 站点代码,`lib/client.js` 里保留一份副本 ——
113
+ > **换群或改链接要两处同时改**。
114
+
91
115
  ## 更新检查与红点(v0.5.0)
92
116
 
93
117
  「更新」视图一次回答两件事:**本插件自己**要不要升、**你装的其它 dsh 插件**里哪些有新版。
@@ -455,6 +479,7 @@ dateKey = YYYY-MM-DD(**固定 UTC+8**,不是本地时区)
455
479
  | `GET /api/dpharness/updates` | 本插件 + 已装插件的更新检查(逐包问 npmmirror,并补上中文名与说明),缓存 10 分钟;`?refresh=1` 绕过但 30 秒只放行一次 |
456
480
  | `GET /api/dpharness/postinstall?pkg=&via=&at=` | 安装后回执(只读:进程启动时间 + profile 加载清单) |
457
481
  | `POST /api/dpharness/event` | 埋点代理 → `dpharness.com/api/track/event` |
482
+ | `POST /api/dpharness/subscribe` | `{ email }`,订阅代理 → `dpharness.com/api/subscribe`(站点点 CORS 头不可直发);只转发邮箱 + `source=dsh-plugin`,不落盘、不写日志;60 秒 5 次预算 |
458
483
  | `POST /api/dpharness/install` | `{ pkg }`,spawn `dsh plugin add`;返回 202 + 任务启动 |
459
484
  | `GET /api/dpharness/install` | 安装任务进度与结果 |
460
485
  | `GET /api/dpharness/meta` | 版本、profile、路由清单、缓存与安装状态 |
@@ -478,6 +503,9 @@ dateKey = YYYY-MM-DD(**固定 UTC+8**,不是本地时区)
478
503
  与红点确认标记(清了会让刚关掉的红点立刻又亮)。
479
504
  - 更新检查**只读本地文件与只读 registry**:不上传你装了哪些包,也不代替你安装任何东西。
480
505
  - 埋点经本地 host 转发(站点端点不带 CORS 头),失败静默忽略,绝不影响操作。
506
+ - **订阅邮箱只在你主动填并点「订阅」时才离开本机**:经 host 转发到
507
+ `dpharness.com/api/subscribe`,插件侧不存、不写日志、不附 visitorId;
508
+ 站点的确认信里带退订入口,退订走站点自己的通道。不填就一个字节也不发。
481
509
  - 安装失败时展示的 pnpm 输出(卡片上的诊断行)**展示前统一脱敏**:
482
510
  `.npmrc` 形态的凭据(`_authToken` / `_auth` / `_password` / `token=`)、
483
511
  `Authorization: Bearer …` 以及裸 `npm_…` token 一律替换为 `***`。
package/lib/changelog.js CHANGED
@@ -37,6 +37,17 @@ export function npmLatestUrl(pkg) {
37
37
  * (用户要看的是行为变化,不是我们的 commit 分类)。
38
38
  */
39
39
  export const CHANGELOG = [
40
+ {
41
+ version: "0.6.4",
42
+ date: "2026-10-20",
43
+ title: "插件里可以直接进群与订阅周报",
44
+ items: [
45
+ "页签顶部多了一张「交流群 + 周报」卡:点「查看二维码」展开 QQ 群与飞书群两枚码,手机扫码进群。",
46
+ "填一行邮箱就能订阅周报,不用跳站;站点会发一封确认信,点开邮件里的链接才算订阅成功,之后随时可以退订。",
47
+ "右下浮窗底部与「设置 → 插件 → 严选插件」也各有一份同样的入口,在哪个界面都能进群或订阅。",
48
+ "二维码是现生成的:群链接换了码就跟着变,不会出现扫到旧群的情况。",
49
+ ],
50
+ },
40
51
  {
41
52
  version: "0.6.3",
42
53
  date: "2026-10-19",
package/lib/client.js CHANGED
@@ -235,6 +235,34 @@ window.__ModuleLoader__.load({
235
235
  ".dph_railCard .dph_instRow{flex-direction:column;align-items:stretch;gap:4px}",
236
236
  ".dph_railCard .dph_instHint{word-break:break-all}",
237
237
  "@media (max-width:900px){.dph_work{grid-template-columns:minmax(0,1fr)}.dph_rail{display:contents}.dph_workHead,.dph_tabbar{order:0}.dph_dailySlot{order:1}.dph_mainCol{order:2}.dph_railSlot{order:3}.dph_railCard .dph_instRow{flex-direction:row;align-items:center}.dph_cmdbarCol{flex-direction:row;align-items:center}.dph_cmdbarCol .dph_cmdbarCode{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}}",
238
+ /* ──────────────── 社群 + 订阅(2026-10-20) ────────────────
239
+ 一条通栏卡,三处共用:会话页签(宽)/ 右下浮窗(compact)/ 设置页(无外框)。
240
+ ⚠️ 二维码 84px 是站点实测的下限(64px 时 jsQR 已解不出,72px 是临界),
241
+ 这里不改小 —— 扫不出来的二维码等于没有入口。
242
+ 二维码**默认收起**:展开后高度约 +120px,页签首屏会被列表挤走,
243
+ 「入口存在但看不见」比没有入口更糟。 */
244
+ ".dph_join{flex:none;display:flex;flex-direction:column;gap:7px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;background:var(--dsw-alias-bg-layer-1);padding:10px 12px}",
245
+ ".dph_joinHead{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap}",
246
+ ".dph_joinTitle{font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary)}",
247
+ ".dph_joinSub{font-size:11px;line-height:1.5;color:var(--dsw-alias-label-tertiary)}",
248
+ ".dph_joinRow{display:flex;align-items:center;gap:8px;flex-wrap:wrap}",
249
+ ".dph_qrRow{display:flex;gap:16px;flex-wrap:wrap;padding:2px 0 1px}",
250
+ ".dph_qrItem{display:flex;flex-direction:column;align-items:center;gap:4px;min-width:0}",
251
+ ".dph_qrImg{display:block;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:#fff;padding:3px}",
252
+ ".dph_qrHint{font-size:10px;color:var(--dsw-alias-label-tertiary);text-align:center}",
253
+ ".dph_qrLink{font-size:11px;color:var(--dsw-alias-state-business-primary);text-decoration:none}",
254
+ ".dph_qrLink:hover{text-decoration:underline}",
255
+ ".dph_subForm{display:flex;align-items:center;gap:6px;flex-wrap:wrap;flex:1;min-width:0}",
256
+ ".dph_subInput{flex:1;min-width:150px;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-primary);border-radius:6px;padding:5px 9px;font:inherit;font-size:12px;outline:none}",
257
+ ".dph_subInput:focus{border-color:var(--dsw-alias-state-business-primary)}",
258
+ ".dph_joinMsg{font-size:11px;line-height:1.5;color:var(--dsw-alias-label-secondary)}",
259
+ ".dph_joinOk{color:var(--dsw-alias-state-business-primary)}",
260
+ ".dph_joinBad{color:var(--dsw-alias-state-error-primary)}",
261
+ ".dph_joinNote{font-size:10px;line-height:1.5;color:var(--dsw-alias-label-tertiary)}",
262
+ /* 浮窗 400px:省掉说明行,二维码与表单各占一行,不再并排 */
263
+ ".dph_joinCompact .dph_joinSub{display:none}",
264
+ /* 设置页里是「卡中卡」:去掉外框,用一条分隔线接在更新日志之后 */
265
+ ".dph_joinInSet{border:0;border-top:1px solid var(--dsw-alias-border-l2);border-radius:0;background:transparent;padding:12px 0 0}",
238
266
  ].join("");
239
267
  const tagId = "dsh-dpharness/client.css";
240
268
  if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
@@ -250,6 +278,34 @@ window.__ModuleLoader__.load({
250
278
  /* 目录站点;改这里的同时要改 host 侧 lib/index.js 的 SITE / UPSTREAM / TRACK。 */
251
279
  const SITE = "https://dpharness.com";
252
280
  const TAKE_OPTIONS = [30, 60, 100];
281
+ /**
282
+ * 社群入口(2026-10-20)。
283
+ *
284
+ * 真源在站点 `lib/community.ts`(首页右栏 / 文章页 CTA / 全站页脚三处读它)。
285
+ * 插件是**独立 npm 包,不能 import 站点代码**,所以这里保留一份副本:
286
+ * 换群或改链接时两处都要改,否则插件里进的是旧群。
287
+ *
288
+ * 二维码不存图:站点 `app/qr/route.ts` 按 url 现生成 PNG(`/qr?url=…`),
289
+ * 换群链接后二维码自动跟着变,不存在「图没换」这种事故。
290
+ */
291
+ const COMMUNITY_GROUPS = [
292
+ {
293
+ key: "qq",
294
+ labelKey: "join.qq",
295
+ scanKey: "join.scanQq",
296
+ name: "DPharness QQ 群",
297
+ url: "https://qm.qq.com/q/CwSG74aKdi",
298
+ },
299
+ {
300
+ key: "feishu",
301
+ labelKey: "join.feishu",
302
+ scanKey: "join.scanFeishu",
303
+ name: "DPharness 飞书群",
304
+ /* applink 深链:装了飞书直接唤起飞书,没装会跳下载引导页 —— 预期行为 */
305
+ url: "https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=640sc405-cb7b-4ba8-b75d-0d21949251a6",
306
+ },
307
+ ].map((group) => Object.assign({}, group, { qr: SITE + "/qr?url=" + encodeURIComponent(group.url) }));
308
+ const NEWSLETTER_URL = SITE + "/newsletter";
253
309
  const zh = {
254
310
  "view.tab": "严选插件",
255
311
  "view.title": "dsh 严选插件",
@@ -499,6 +555,26 @@ window.__ModuleLoader__.load({
499
555
  "need.required": "必备",
500
556
  "need.enhance": "增强",
501
557
  "need.optional": "可选",
558
+ /* 社群 + 订阅(页签 / 浮窗 / 设置页三处共用一套文案) */
559
+ "join.title": "插件交流群已开放",
560
+ "join.sub": "用法、报错、新插件,群里问更快",
561
+ "join.showQr": "查看二维码",
562
+ "join.hideQr": "收起二维码",
563
+ "join.qq": "QQ 群",
564
+ "join.feishu": "飞书群",
565
+ "join.scanQq": "手机 QQ 扫码进群",
566
+ "join.scanFeishu": "飞书扫码进群",
567
+ "join.joinGroup": "加入{label}",
568
+ "join.newsletter": "每周一封插件周报",
569
+ "join.newsletterSub": "新插件、精选评测与福利,周一早上发",
570
+ "join.email": "你的邮箱",
571
+ "join.subscribe": "订阅",
572
+ "join.sending": "发送中…",
573
+ "join.subscribeOk": "确认信已发出,请到邮箱点确认",
574
+ "join.subscribeFailed": "订阅失败,请稍后再试",
575
+ "join.needEmail": "请先填邮箱",
576
+ "join.note": "邮箱只用于周报,可随时退订。",
577
+ "join.past": "往期周报 →",
502
578
  "footer.hint": "网页无法自动安装:复制命令到终端执行,装完重启 dsh 才会生效。命令里的 --profile 已按你本机填好,别改成别的。",
503
579
  "telemetry.on": "匿名统计(不含搜索内容)",
504
580
  "install.action": "安装",
@@ -766,6 +842,25 @@ window.__ModuleLoader__.load({
766
842
  "need.required": "Core",
767
843
  "need.enhance": "Enhance",
768
844
  "need.optional": "Optional",
845
+ "join.title": "Community group is open",
846
+ "join.sub": "Usage, install errors and new plugins — asking in the group is faster",
847
+ "join.showQr": "Show QR codes",
848
+ "join.hideQr": "Hide QR codes",
849
+ "join.qq": "QQ group",
850
+ "join.feishu": "Feishu group",
851
+ "join.scanQq": "Scan with mobile QQ",
852
+ "join.scanFeishu": "Scan with Feishu",
853
+ "join.joinGroup": "Join {label}",
854
+ "join.newsletter": "Weekly plugin digest",
855
+ "join.newsletterSub": "New plugins, reviews and perks — Monday mornings",
856
+ "join.email": "Your email",
857
+ "join.subscribe": "Subscribe",
858
+ "join.sending": "Sending…",
859
+ "join.subscribeOk": "Confirmation sent — open your inbox and click the link",
860
+ "join.subscribeFailed": "Subscription failed, please try again later",
861
+ "join.needEmail": "Enter your email first",
862
+ "join.note": "Used for the digest only; unsubscribe anytime.",
863
+ "join.past": "Past issues →",
769
864
  "footer.hint": "A web page cannot install plugins: copy the command into a terminal, then restart dsh. The --profile in it is already set to this machine's — leave it as is.",
770
865
  "telemetry.on": "Anonymous stats (no search text)",
771
866
  "install.action": "Install",
@@ -3997,6 +4092,9 @@ window.__ModuleLoader__.load({
3997
4092
  switchRow("daily", "settings.daily", "settings.dailyHint", state.daily, (next) => setDaily(next, "settings")),
3998
4093
  switchRow("check", "settings.check", "settings.checkHint", state.autoCheck, (next) => setAutoCheck(next, "settings")),
3999
4094
  switchRow("tel", "settings.telemetry", "settings.about", state.telemetry, setTelemetry),
4095
+ /* 社群 + 订阅:放在开关之后、更新日志之前 —— 它属于「这个插件还能给你什么」,
4096
+ 不是「版本改了什么」。inSet 去掉外框,只留一条分隔线,避免卡中卡。 */
4097
+ h(JoinCard, { key: "join", inSet: true }),
4000
4098
  changelogSection(cl, pending),
4001
4099
  h("div", { className: "dph_setGroup", key: "reset" }, [
4002
4100
  h("div", { className: "dph_setRow", key: "row" }, [
@@ -4026,6 +4124,150 @@ window.__ModuleLoader__.load({
4026
4124
  }, option.label)));
4027
4125
  }
4028
4126
 
4127
+ /**
4128
+ * 社群 + 订阅入口(2026-10-20)。
4129
+ *
4130
+ * 三处共用:会话页签(宽)/ 右下浮窗(compact)/ 设置 → 插件(宽、无外框)。
4131
+ *
4132
+ * 两个必须守住的点:
4133
+ * 1) **订阅必须经本机 host 转发**(`/api/dpharness/subscribe`)。站点
4134
+ * `/api/subscribe` 不带 CORS 头,浏览器跨源直发不成立 —— 与 track()
4135
+ * 下面那条注释是同一个实测结论。邮箱只发给站点、只用于周报,卡内写明。
4136
+ * 2) 二维码默认收起、点开才显示,尺寸不小于 84px(站点实测:64px 时
4137
+ * jsQR 已解不出)。「入口在但看不见」和「码扫不出来」都是把入口做成摆设。
4138
+ */
4139
+ function JoinCard(props) {
4140
+ const compact = !!(props && props.compact);
4141
+ const inSet = !!(props && props.inSet);
4142
+ const [open, setOpen] = react.useState(false);
4143
+ const [email, setEmail] = react.useState("");
4144
+ const [sub, setSub] = react.useState(null);
4145
+ const busy = !!sub && sub.phase === "sending";
4146
+
4147
+ function submit(event) {
4148
+ if (event && event.preventDefault) event.preventDefault();
4149
+ if (busy) return;
4150
+ const value = String(email || "").trim();
4151
+ if (!value) {
4152
+ setSub({ phase: "bad", text: t("join.needEmail") });
4153
+ return;
4154
+ }
4155
+ setSub({ phase: "sending" });
4156
+ track("plugin_hub", { action: "subscribe_submit" });
4157
+ fetch("/api/dpharness/subscribe", {
4158
+ method: "POST",
4159
+ headers: { "content-type": "application/json" },
4160
+ body: JSON.stringify({ email: value, source: "dsh-plugin" }),
4161
+ })
4162
+ .then((response) =>
4163
+ response.json().catch(() => ({})).then((data) => ({ response, data })),
4164
+ )
4165
+ .then((pair) => {
4166
+ const data = pair.data || {};
4167
+ if (!pair.response.ok || data.ok === false) {
4168
+ /* 服务端的 error 是中文人话(邮箱格式 / 频率限制),直接透出 */
4169
+ setSub({ phase: "bad", text: data.error || t("join.subscribeFailed") });
4170
+ return;
4171
+ }
4172
+ setEmail("");
4173
+ setSub({ phase: "ok", text: data.message || t("join.subscribeOk") });
4174
+ track("plugin_hub", { action: "subscribe_ok" });
4175
+ })
4176
+ .catch(() => setSub({ phase: "bad", text: t("join.subscribeFailed") }));
4177
+ }
4178
+
4179
+ const qrRow = open
4180
+ ? h("div", { className: "dph_qrRow", key: "qr" }, COMMUNITY_GROUPS.map((group) =>
4181
+ h("div", { className: "dph_qrItem", key: group.key }, [
4182
+ h("a", {
4183
+ key: "img",
4184
+ href: group.url,
4185
+ target: "_blank",
4186
+ rel: "noopener noreferrer",
4187
+ onClick: () => track("plugin_hub", { action: "community_join", scope: group.key }),
4188
+ }, h("img", {
4189
+ className: "dph_qrImg",
4190
+ src: group.qr,
4191
+ width: 84,
4192
+ height: 84,
4193
+ alt: group.name + " · " + t(group.scanKey),
4194
+ })),
4195
+ h("a", {
4196
+ className: "dph_qrLink",
4197
+ key: "link",
4198
+ href: group.url,
4199
+ target: "_blank",
4200
+ rel: "noopener noreferrer",
4201
+ onClick: () => track("plugin_hub", { action: "community_join", scope: group.key }),
4202
+ }, format(t("join.joinGroup"), { label: t(group.labelKey) })),
4203
+ h("span", { className: "dph_qrHint", key: "hint" }, t(group.scanKey)),
4204
+ ]),
4205
+ ))
4206
+ : null;
4207
+
4208
+ return h("div", {
4209
+ className: "dph_join" + (compact ? " dph_joinCompact" : "") + (inSet ? " dph_joinInSet" : ""),
4210
+ }, [
4211
+ h("div", { className: "dph_joinHead", key: "gh" }, [
4212
+ h("span", { className: "dph_joinTitle", key: "title" }, "💬 " + t("join.title")),
4213
+ h("span", { className: "dph_joinSub", key: "sub" }, t("join.sub")),
4214
+ h("span", { className: "dph_spacer", key: "gap" }),
4215
+ h("button", {
4216
+ className: "dph_btn dph_btnSm",
4217
+ key: "toggle",
4218
+ type: "button",
4219
+ "aria-expanded": open ? "true" : "false",
4220
+ onClick: () => {
4221
+ if (!open) track("plugin_hub", { action: "community_open" });
4222
+ setOpen(!open);
4223
+ },
4224
+ }, open ? t("join.hideQr") : t("join.showQr")),
4225
+ ]),
4226
+ qrRow,
4227
+ h("div", { className: "dph_joinHead", key: "nh" }, [
4228
+ h("span", { className: "dph_joinTitle", key: "title" }, "✉️ " + t("join.newsletter")),
4229
+ h("span", { className: "dph_joinSub", key: "sub" }, t("join.newsletterSub")),
4230
+ ]),
4231
+ h("form", { className: "dph_subForm", key: "form", onSubmit: submit }, [
4232
+ h("input", {
4233
+ className: "dph_subInput",
4234
+ key: "input",
4235
+ type: "email",
4236
+ value: email,
4237
+ placeholder: t("join.email"),
4238
+ autoComplete: "email",
4239
+ onChange: (event) => setEmail(event.target.value),
4240
+ }),
4241
+ h("button", {
4242
+ className: "dph_btn dph_btnPrimary",
4243
+ key: "go",
4244
+ type: "submit",
4245
+ disabled: busy,
4246
+ }, busy ? t("join.sending") : t("join.subscribe")),
4247
+ ]),
4248
+ sub
4249
+ ? h("div", {
4250
+ className:
4251
+ "dph_joinMsg" +
4252
+ (sub.phase === "ok" ? " dph_joinOk" : sub.phase === "bad" ? " dph_joinBad" : ""),
4253
+ key: "msg",
4254
+ role: "status",
4255
+ }, sub.text)
4256
+ : null,
4257
+ h("div", { className: "dph_joinNote", key: "note" }, [
4258
+ t("join.note") + " ",
4259
+ h("a", {
4260
+ className: "dph_qrLink",
4261
+ key: "past",
4262
+ href: NEWSLETTER_URL,
4263
+ target: "_blank",
4264
+ rel: "noopener noreferrer",
4265
+ onClick: () => track("plugin_hub", { action: "site_click", scope: "newsletter" }),
4266
+ }, t("join.past")),
4267
+ ]),
4268
+ ]);
4269
+ }
4270
+
4029
4271
  function controls(cat) {
4030
4272
  return h("div", { className: "dph_bar", key: "bar" }, [
4031
4273
  h("input", {
@@ -4307,6 +4549,9 @@ window.__ModuleLoader__.load({
4307
4549
  ]),
4308
4550
  /* 待重启横幅挂在区标题之下、结果区之上:不跟着卡片滚走,切视图也在 */
4309
4551
  h(RestartBanner, { scope: "tab", key: "rbanner" }),
4552
+ /* 社群 + 订阅:与待重启横幅同一层(常驻、不随列表滚走)。展开二维码后
4553
+ 会把列表往下推约 120px —— 可接受,因为它是点击后的主动结果。 */
4554
+ h(JoinCard, { key: "join" }),
4310
4555
  ...body,
4311
4556
  h("div", { className: "dph_footer", key: "hint" }, t("footer.hint")),
4312
4557
  h("div", { className: "dph_footer", key: "tel" }, h("div", { className: "dph_footToggles" }, [telemetryToggle(), floatToggle()])),
@@ -4577,6 +4822,9 @@ window.__ModuleLoader__.load({
4577
4822
  h("div", { className: "dph_panelBody", key: "bbody" }, renderBest(bestData, best.copiedCmd, best.markCopied)),
4578
4823
  ]),
4579
4824
  h("div", { className: "dph_panelFoot", key: "foot" }, [
4825
+ /* 浮窗里也放一份:浮窗是曝光最高的入口,只有页签有等于大半用户看不到。
4826
+ compact 版省掉说明行,二维码默认收起(面板只有 400px 宽)。 */
4827
+ h(JoinCard, { key: "join", compact: true }),
4580
4828
  h("div", { className: "dph_footRow", key: "row" }, [
4581
4829
  telemetryToggle(),
4582
4830
  h("button", {
package/lib/index.js CHANGED
@@ -10,6 +10,7 @@
10
10
  * GET /api/dpharness/updates
11
11
  * GET /api/dpharness/postinstall?pkg=<pkg>&via=<local|market>&at=<epochMs>
12
12
  * POST /api/dpharness/event → relayed to https://dpharness.com/api/track/event
13
+ * POST /api/dpharness/subscribe → relayed to https://dpharness.com/api/subscribe
13
14
  * POST /api/dpharness/install → spawns `dsh plugin --profile <p> add <pkg>`
14
15
  * GET /api/dpharness/install → progress of the one in-flight install job
15
16
  *
@@ -47,7 +48,7 @@ export const name = "dpharness";
47
48
  /** The dsh web server service used to register HTTP routes. */
48
49
  export const inject = ["webServer"];
49
50
 
50
- export const VERSION = "0.6.3";
51
+ export const VERSION = "0.6.4";
51
52
 
52
53
  /**
53
54
  * 本插件在 npm 上的包名 —— 与 dsh 的插件 id(上面的 `name = "dpharness"`)**不是一回事**,
@@ -137,6 +138,20 @@ const BEST_UPSTREAM = "https://dpharness.com/api/best";
137
138
  const SETS_UPSTREAM = "https://dpharness.com/api/sets";
138
139
  const SITE = "https://dpharness.com";
139
140
  const TRACK = "https://dpharness.com/api/track/event";
141
+ /**
142
+ * Newsletter subscription relay target.
143
+ *
144
+ * The site's `/api/subscribe` is double opt-in: it stores the address as
145
+ * pending and sends the confirmation mail itself. This host only forwards the
146
+ * address — it never stores it. It has to be a local route because the site
147
+ * sends no CORS headers (measured; same reason the event relay exists).
148
+ */
149
+ const SUBSCRIBE = "https://dpharness.com/api/subscribe";
150
+ const SUBSCRIBE_TIMEOUT_MS = 10 * 1000;
151
+ const SUBSCRIBE_WINDOW_MS = 60 * 1000;
152
+ /** Kept tight on purpose: a stuck UI must not be able to spray the site. */
153
+ const SUBSCRIBE_MAX_PER_WINDOW = 5;
154
+ const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
140
155
  const DEFAULT_TAKE = 30;
141
156
  const MAX_TAKE = 100;
142
157
  const CACHE_TTL_MS = 5 * 60 * 1000;
@@ -703,6 +718,8 @@ let bestCache = { at: 0, value: null };
703
718
  /** /api/sets 单键缓存(套装同样每月才同步一次,缓存策略与 /best 一致) */
704
719
  let setsCache = { at: 0, value: null };
705
720
  let eventWindow = { startedAt: 0, count: 0 };
721
+ /* 订阅走独立窗口:与埋点共用预算会让「点了一次订阅」挤掉后续埋点(反之亦然) */
722
+ let subscribeWindow = { startedAt: 0, count: 0 };
706
723
 
707
724
  /**
708
725
  * 分类中文名 —— 抄自站点 `lib/category.ts` 的 `CATEGORY_LABEL`(2026-09-17)。
@@ -1070,6 +1087,16 @@ function withinEventBudget() {
1070
1087
  return eventWindow.count <= EVENT_MAX_PER_WINDOW;
1071
1088
  }
1072
1089
 
1090
+ /** Same sliding-window shape as withinEventBudget, separate budget. */
1091
+ function withinSubscribeBudget() {
1092
+ const now = Date.now();
1093
+ if (now - subscribeWindow.startedAt > SUBSCRIBE_WINDOW_MS) {
1094
+ subscribeWindow = { startedAt: now, count: 0 };
1095
+ }
1096
+ subscribeWindow.count += 1;
1097
+ return subscribeWindow.count <= SUBSCRIBE_MAX_PER_WINDOW;
1098
+ }
1099
+
1073
1100
  const clampText = (value, max) => (typeof value === "string" ? value.slice(0, max) : "");
1074
1101
 
1075
1102
  /**
@@ -1719,6 +1746,74 @@ export function apply(ctx) {
1719
1746
  }
1720
1747
  });
1721
1748
 
1749
+ /**
1750
+ * Newsletter subscription relay (2026-10-20).
1751
+ *
1752
+ * Why it lives here and not in the browser: the site's `/api/subscribe` sends
1753
+ * no CORS headers (measured — the event relay above exists for the same
1754
+ * reason), so a cross-origin POST from the dsh web GUI is refused before it
1755
+ * ever reaches the route.
1756
+ *
1757
+ * Scope is deliberately narrow — one field in, one result out. No visitor id,
1758
+ * no inbox storage, no address logged. The site owns double opt-in: it stores
1759
+ * the address as pending and mails the confirmation link itself, so this
1760
+ * handler returning `ok` only means "the site accepted the request".
1761
+ */
1762
+ registerRoute(ctx, "/api/dpharness/subscribe", async (req, res) => {
1763
+ if (req.method !== "POST") {
1764
+ res.writeHead(405, { allow: "POST" });
1765
+ res.end();
1766
+ return;
1767
+ }
1768
+ if (!withinSubscribeBudget()) {
1769
+ sendJson(res, 429, { ok: false, error: "操作太频繁,请稍后再试" });
1770
+ return;
1771
+ }
1772
+ let input;
1773
+ try {
1774
+ input = JSON.parse((await readBody(req, 2048)) || "{}");
1775
+ } catch (error) {
1776
+ sendJson(res, 400, { ok: false, error: "请求格式不正确" });
1777
+ return;
1778
+ }
1779
+ const email = String((input && input.email) || "").trim().toLowerCase().slice(0, 254);
1780
+ if (!EMAIL_RE.test(email)) {
1781
+ sendJson(res, 400, { ok: false, error: "邮箱格式不正确" });
1782
+ return;
1783
+ }
1784
+ const controller = new AbortController();
1785
+ const timer = setTimeout(() => controller.abort(), SUBSCRIBE_TIMEOUT_MS);
1786
+ try {
1787
+ const response = await fetch(SUBSCRIBE, {
1788
+ method: "POST",
1789
+ headers: {
1790
+ "content-type": "application/json",
1791
+ accept: "application/json",
1792
+ "user-agent": `dsh-dpharness/${VERSION}`,
1793
+ },
1794
+ body: JSON.stringify({ email, source: "dsh-plugin" }),
1795
+ signal: controller.signal,
1796
+ });
1797
+ const data = await response.json().catch(() => ({}));
1798
+ if (!response.ok) {
1799
+ /* 站点的 error 是给人看的中文(格式/频率),优先透出;没有就自己兜一句 */
1800
+ sendJson(res, 502, { ok: false, error: (data && data.error) || "订阅服务暂时不可用,请稍后再试" });
1801
+ return;
1802
+ }
1803
+ sendJson(res, 200, {
1804
+ ok: !(data && data.ok === false),
1805
+ message: typeof (data && data.message) === "string" ? data.message : "",
1806
+ already: !!(data && data.already === true),
1807
+ error: typeof (data && data.error) === "string" ? data.error : "",
1808
+ });
1809
+ } catch (error) {
1810
+ const message = error && error.name === "AbortError" ? "订阅请求超时,请稍后再试" : "无法连接 dpharness.com";
1811
+ sendJson(res, 502, { ok: false, error: message });
1812
+ } finally {
1813
+ clearTimeout(timer);
1814
+ }
1815
+ });
1816
+
1722
1817
  /**
1723
1818
  * One-click install.
1724
1819
  *
@@ -1995,6 +2090,7 @@ export function apply(ctx) {
1995
2090
  "/api/dpharness/best",
1996
2091
  "/api/dpharness/sets",
1997
2092
  "/api/dpharness/event",
2093
+ "/api/dpharness/subscribe",
1998
2094
  "/api/dpharness/install",
1999
2095
  "/api/dpharness/postinstall",
2000
2096
  "/api/dpharness/toggle",
package/lib/usage.js ADDED
@@ -0,0 +1,307 @@
1
+ /**
2
+ * usage.js — 插件使用频次引擎(本机、只读、离线)。
3
+ *
4
+ * 数据源(2026-10-16 实测):
5
+ * · 会话真源 `~/.dsh/sessions/<cwd>/session-<id>/session.v4.jsonl.zstd`
6
+ * —— **多帧 zstd** JSONL;`tool/call` 事件含 `{name, callId, time}`。
7
+ * ⚠️ Node 原生 zstd 只解首帧(sync 与 stream 都不跨帧),这里按帧魔数
8
+ * (`28 B5 2F FD`) 切片逐帧解压,并对每帧做「全行可 JSON 解析」校验以
9
+ * 丢弃压缩流内部的伪魔数。实测全量 30 天扫描约 1.5s。
10
+ *
11
+ * 归属策略(v1,静态表;动态归属见设计方案 M2 原型):
12
+ * · 只有**确定归属**的工具才计入单插件(前缀/精确表);
13
+ * · `web_search`/`web_fetch`/`read_page` 是「通道类」——由多个提供方动态
14
+ * 接管(实测:某会话里 web_search 由 modsearch 服务、web_fetch 由
15
+ * free-search 服务),v1 单列通道桶,不计给任何单一插件;
16
+ * · 内核工具(bash/read/write/…)不进表 → 未归属桶。
17
+ *
18
+ * 三态纪律:引擎不可用 / 插件无可归属工具 → 不产出结论(由调用方标
19
+ * 「无法度量」),**绝不**把「没测到」写成「没在用」。
20
+ *
21
+ * 缓存:`~/.dsh/dpharness/usage-cache.json`(按文件 size+mtime 增量,
22
+ * 只重解析变化过的会话文件;删除的文件自动修剪)。
23
+ */
24
+ import fs from "node:fs";
25
+ import os from "node:os";
26
+ import path from "node:path";
27
+ import zlib from "node:zlib";
28
+
29
+ /** 统计窗口(天)。拍板值:30。 */
30
+ export const USAGE_WINDOW_DAYS = 30;
31
+
32
+ /** 缓存超过该时长就在下次读取时重扫(毫秒)。 */
33
+ const CACHE_MAX_AGE_MS = 6 * 60 * 60 * 1000;
34
+
35
+ /** 前缀归属:[正则, 包名]。 */
36
+ const TOOL_PREFIX_OWNERS = [
37
+ [/^ego_/u, "dsh-ego-browser"],
38
+ [/^mnemon_/u, "dsh-mnemon"],
39
+ ];
40
+
41
+ /** 精确归属(实测自各插件注册名)。 */
42
+ const TOOL_EXACT_OWNERS = {
43
+ advanced_search: "dsh-free-search",
44
+ cache_search: "dsh-free-search",
45
+ domain_search: "dsh-free-search",
46
+ compress: "billion-context",
47
+ decompress: "billion-context",
48
+ };
49
+
50
+ /** 通道类工具:多提供方动态接管,v1 不计单插件归属。 */
51
+ const CHANNEL_TOOLS = new Set(["web_search", "web_fetch", "read_page"]);
52
+
53
+ /** 有可归属工具的包集合(即使 0 次调用,也算「可度量」)。 */
54
+ export const PKGS_WITH_TOOLS = new Set([
55
+ ...TOOL_PREFIX_OWNERS.map(([, pkg]) => pkg),
56
+ ...Object.values(TOOL_EXACT_OWNERS),
57
+ ]);
58
+
59
+ /** 工具名 → 归属包(null = 通道或未归属)。 */
60
+ export function ownerOfTool(name) {
61
+ if (typeof name !== "string" || name === "") return null;
62
+ if (CHANNEL_TOOLS.has(name)) return null;
63
+ for (const [re, pkg] of TOOL_PREFIX_OWNERS) {
64
+ if (re.test(name)) return pkg;
65
+ }
66
+ return TOOL_EXACT_OWNERS[name] ?? null;
67
+ }
68
+
69
+ /**
70
+ * 保留价值等级(供 rows 直接下发)。
71
+ * @param enabled - true/false/null(null = 宿主查不到启用状态,不下结论)
72
+ * @param usage - usage 对象或 null(null = 引擎不可用)
73
+ */
74
+ export function classifyUsage(enabled, usage) {
75
+ if (enabled === false) return "disabled";
76
+ if (usage === null || usage === undefined) return "unknown";
77
+ if (!usage.measurable) return "unmeasurable";
78
+ const calls = Number(usage.calls) || 0;
79
+ const sessions = Number(usage.sessions) || 0;
80
+ if (calls >= 20 && sessions >= 3) return "core";
81
+ if (calls >= 5) return "common";
82
+ if (calls >= 1) return "occasional";
83
+ return "silent";
84
+ }
85
+
86
+ function dshHome() {
87
+ return process.env.DSH_HOME || path.join(os.homedir(), ".dsh");
88
+ }
89
+
90
+ function cachePath() {
91
+ return path.join(dshHome(), "dpharness", "usage-cache.json");
92
+ }
93
+
94
+ const FRAME_MAGIC = Buffer.from([0x28, 0xb5, 0x2f, 0xfd]);
95
+
96
+ /** 解一个多帧 zstd 缓冲 → 逐帧文本(校验失败/伪魔数的帧丢弃)。 */
97
+ export function decompressFrames(buf) {
98
+ const offsets = [];
99
+ let at = buf.indexOf(FRAME_MAGIC, 0);
100
+ while (at >= 0) {
101
+ offsets.push(at);
102
+ at = buf.indexOf(FRAME_MAGIC, at + 4);
103
+ }
104
+ const out = [];
105
+ for (const off of offsets) {
106
+ let text;
107
+ try {
108
+ text = zlib.zstdDecompressSync(buf.subarray(off)).toString("utf8");
109
+ } catch {
110
+ continue;
111
+ }
112
+ if (!text) continue;
113
+ let ok = true;
114
+ for (const line of text.split("\n")) {
115
+ if (!line.trim()) continue;
116
+ try {
117
+ JSON.parse(line);
118
+ } catch {
119
+ ok = false;
120
+ break;
121
+ }
122
+ }
123
+ if (ok) out.push(text);
124
+ }
125
+ return out;
126
+ }
127
+
128
+ /** 解析单个会话真源 → { calls, tools: {name:[count,lastMs]}, maxMs }。 */
129
+ function parseSessionFile(file) {
130
+ const buf = fs.readFileSync(file);
131
+ const tools = {};
132
+ let calls = 0;
133
+ let maxMs = 0;
134
+ for (const text of decompressFrames(buf)) {
135
+ for (const line of text.split("\n")) {
136
+ if (!line.trim()) continue;
137
+ let ev;
138
+ try {
139
+ ev = JSON.parse(line);
140
+ } catch {
141
+ continue;
142
+ }
143
+ if (!ev || ev.type !== "tool/call") continue;
144
+ const name = ev.data && typeof ev.data.name === "string" ? ev.data.name : "";
145
+ if (!name) continue;
146
+ const time = Number(ev.time) || 0;
147
+ calls += 1;
148
+ if (time > maxMs) maxMs = time;
149
+ const prev = tools[name];
150
+ tools[name] = prev ? [prev[0] + 1, Math.max(prev[1], time)] : [1, time];
151
+ }
152
+ }
153
+ return { calls, tools, maxMs };
154
+ }
155
+
156
+ /** 枚举会话真源文件(~/.dsh/sessions/<slug>/session-<id>/session.v4.jsonl.zstd)。 */
157
+ function listSessionFiles() {
158
+ const root = path.join(dshHome(), "sessions");
159
+ const files = [];
160
+ let slugs;
161
+ try {
162
+ slugs = fs.readdirSync(root, { withFileTypes: true });
163
+ } catch {
164
+ return files;
165
+ }
166
+ for (const slug of slugs) {
167
+ if (!slug.isDirectory()) continue;
168
+ const slugDir = path.join(root, slug.name);
169
+ let sessions;
170
+ try {
171
+ sessions = fs.readdirSync(slugDir, { withFileTypes: true });
172
+ } catch {
173
+ continue;
174
+ }
175
+ for (const session of sessions) {
176
+ if (!session.isDirectory() || !session.name.startsWith("session-")) continue;
177
+ const file = path.join(slugDir, session.name, "session.v4.jsonl.zstd");
178
+ try {
179
+ const st = fs.statSync(file);
180
+ if (st.isFile()) files.push({ file, size: st.size, mtimeMs: st.mtimeMs });
181
+ } catch {
182
+ /* 没有真源文件的会话(如仅投影)跳过 */
183
+ }
184
+ }
185
+ }
186
+ return files;
187
+ }
188
+
189
+ function readCache() {
190
+ try {
191
+ const parsed = JSON.parse(fs.readFileSync(cachePath(), "utf8"));
192
+ if (parsed && parsed.version === 1 && parsed.files && typeof parsed.files === "object") return parsed;
193
+ } catch {
194
+ /* 无缓存 / 损坏 → 重建 */
195
+ }
196
+ return { version: 1, generatedAtMs: 0, files: {} };
197
+ }
198
+
199
+ function writeCache(cache) {
200
+ try {
201
+ const file = cachePath();
202
+ fs.mkdirSync(path.dirname(file), { recursive: true });
203
+ const tmp = `${file}.tmp-${process.pid}`;
204
+ fs.writeFileSync(tmp, JSON.stringify(cache));
205
+ fs.renameSync(tmp, file);
206
+ } catch {
207
+ /* 写不进缓存不是错误:下次重扫即可 */
208
+ }
209
+ }
210
+
211
+ /**
212
+ * 增量扫描 + 聚合。
213
+ * @param options.force - true 时忽略缓存新鲜度,重扫变化文件
214
+ * @param options.now - 注入时钟(测试用)
215
+ */
216
+ export function getUsageReport(options = {}) {
217
+ const now = Number(options.now) || Date.now();
218
+ const windowDays = Number(options.windowDays) || USAGE_WINDOW_DAYS;
219
+ const cutoff = now - windowDays * 24 * 3600 * 1000;
220
+ const cache = readCache();
221
+ const fresh = cache.generatedAtMs && now - cache.generatedAtMs < CACHE_MAX_AGE_MS;
222
+ let parsedFiles = 0;
223
+
224
+ if (!fresh || options.force === true) {
225
+ const files = listSessionFiles();
226
+ const seen = new Set();
227
+ for (const entry of files) {
228
+ seen.add(entry.file);
229
+ const prev = cache.files[entry.file];
230
+ if (prev && prev.size === entry.size && prev.mtimeMs === entry.mtimeMs) continue;
231
+ try {
232
+ const parsed = parseSessionFile(entry.file);
233
+ cache.files[entry.file] = { size: entry.size, mtimeMs: entry.mtimeMs, ...parsed };
234
+ parsedFiles += 1;
235
+ } catch {
236
+ /* 单文件失败不影响其它会话 */
237
+ }
238
+ }
239
+ for (const key of Object.keys(cache.files)) {
240
+ if (!seen.has(key)) delete cache.files[key];
241
+ }
242
+ cache.generatedAtMs = now;
243
+ writeCache(cache);
244
+ }
245
+
246
+ /* ---- 聚合(窗口内文件) ---- */
247
+ const perPkg = {};
248
+ const unattributed = {};
249
+ const channel = {};
250
+ let filesInWindow = 0;
251
+ let sessionsWithCalls = 0;
252
+ let totalCalls = 0;
253
+ for (const [file, info] of Object.entries(cache.files)) {
254
+ if (!info || info.mtimeMs < cutoff) continue;
255
+ filesInWindow += 1;
256
+ if (info.calls > 0) sessionsWithCalls += 1;
257
+ const touchedPkgs = new Set();
258
+ for (const [tool, pair] of Object.entries(info.tools || {})) {
259
+ const count = pair[0];
260
+ const lastMs = pair[1] || 0;
261
+ totalCalls += count;
262
+ const owner = ownerOfTool(tool);
263
+ if (owner === null) {
264
+ if (CHANNEL_TOOLS.has(tool)) channel[tool] = (channel[tool] || 0) + count;
265
+ else unattributed[tool] = (unattributed[tool] || 0) + count;
266
+ continue;
267
+ }
268
+ const slot = perPkg[owner] || (perPkg[owner] = { calls: 0, sessions: 0, lastUsedMs: 0, tools: {} });
269
+ slot.calls += count;
270
+ slot.tools[tool] = (slot.tools[tool] || 0) + count;
271
+ if (lastMs > slot.lastUsedMs) slot.lastUsedMs = lastMs;
272
+ if (!touchedPkgs.has(owner)) {
273
+ touchedPkgs.add(owner);
274
+ slot.sessions += 1;
275
+ }
276
+ }
277
+ }
278
+
279
+ /* 可归属但窗口内没有调用的包补零,保证「可度量 + 沉默」可被区分 */
280
+ for (const pkg of PKGS_WITH_TOOLS) {
281
+ if (!perPkg[pkg]) perPkg[pkg] = { calls: 0, sessions: 0, lastUsedMs: 0, tools: {} };
282
+ }
283
+
284
+ const plugins = {};
285
+ for (const [pkg, slot] of Object.entries(perPkg)) {
286
+ plugins[pkg] = {
287
+ measurable: true,
288
+ calls: slot.calls,
289
+ sessions: slot.sessions,
290
+ lastUsedMs: slot.lastUsedMs || null,
291
+ tools: Object.entries(slot.tools)
292
+ .sort((a, b) => b[1] - a[1])
293
+ .slice(0, 6),
294
+ };
295
+ }
296
+
297
+ return {
298
+ ok: true,
299
+ windowDays,
300
+ generatedAtMs: cache.generatedAtMs || null,
301
+ cacheAgeMs: cache.generatedAtMs ? now - cache.generatedAtMs : null,
302
+ scanned: { files: filesInWindow, parsed: parsedFiles, sessions: sessionsWithCalls, calls: totalCalls },
303
+ plugins,
304
+ channel,
305
+ unattributed,
306
+ };
307
+ }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "dsh-dpharness",
3
3
  "icon": "./icon.svg",
4
- "version": "0.6.3",
4
+ "version": "0.6.4",
5
5
  "description": "Curated dpharness.com plugin catalog inside the DeepSeek Harness Web GUI: a conversation-view tab, a sidebar entry and a dismissible site-wide floating panel, offering a searchable full catalog, a monthly by-category shortlist, a daily pick and an update check (this plugin plus every installed plugin) with a red-dot reminder, with one-click install via dshmarket or the dsh CLI. Includes a settings page (General row + Plugins tab) for the widget visibility, the daily pick, the update check and the opt-out telemetry relay covering the full install funnel.",
6
6
  "author": "zhanghao3693 <zhanghao3693@qq.com>",
7
7
  "repository": {
@@ -58,6 +58,7 @@
58
58
  "files": ["icon.svg", "locale", "lib/index.js",
59
59
  "lib/changelog.js",
60
60
  "lib/client.js",
61
+ "lib/usage.js",
61
62
  "README.md",
62
63
  "cordis.patch.yml"],
63
64
  "keywords": [