@cxyhhhhh/dsh-qqbot 0.4.0 → 0.5.0-dev.202610101544

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 (53) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/CHANGELOG_EN.md +84 -0
  3. package/README.md +86 -5
  4. package/README_EN.md +74 -4
  5. package/dist/commands/misc.d.ts +1 -1
  6. package/dist/commands/misc.d.ts.map +1 -1
  7. package/dist/commands/misc.js +25 -3
  8. package/dist/commands/misc.js.map +1 -1
  9. package/dist/features/approval-channel.d.ts +3 -1
  10. package/dist/features/approval-channel.d.ts.map +1 -1
  11. package/dist/features/approval-channel.js +1 -1
  12. package/dist/features/approval-channel.js.map +1 -1
  13. package/dist/index.d.ts +2 -1
  14. package/dist/index.d.ts.map +1 -1
  15. package/dist/index.js +2 -3
  16. package/dist/index.js.map +1 -1
  17. package/dist/setup/bind-routes.d.ts +35 -0
  18. package/dist/setup/bind-routes.d.ts.map +1 -0
  19. package/dist/setup/bind-routes.js +79 -0
  20. package/dist/setup/bind-routes.js.map +1 -0
  21. package/dist/setup/binding-service.d.ts +86 -0
  22. package/dist/setup/binding-service.d.ts.map +1 -0
  23. package/dist/setup/binding-service.js +175 -0
  24. package/dist/setup/binding-service.js.map +1 -0
  25. package/dist/setup/index.d.ts +31 -0
  26. package/dist/setup/index.d.ts.map +1 -0
  27. package/dist/setup/index.js +54 -0
  28. package/dist/setup/index.js.map +1 -0
  29. package/dist/{setup.d.ts → setup/persist.d.ts} +1 -8
  30. package/dist/setup/persist.d.ts.map +1 -0
  31. package/dist/{setup.js → setup/persist.js} +13 -66
  32. package/dist/setup/persist.js.map +1 -0
  33. package/dist/setup/presenters.d.ts +40 -0
  34. package/dist/setup/presenters.d.ts.map +1 -0
  35. package/dist/setup/presenters.js +84 -0
  36. package/dist/setup/presenters.js.map +1 -0
  37. package/dist/setup/qr-svg.d.ts +8 -0
  38. package/dist/setup/qr-svg.d.ts.map +1 -0
  39. package/dist/setup/qr-svg.js +20 -0
  40. package/dist/setup/qr-svg.js.map +1 -0
  41. package/dist/shared/utils.d.ts +8 -3
  42. package/dist/shared/utils.d.ts.map +1 -1
  43. package/dist/shared/utils.js +45 -4
  44. package/dist/shared/utils.js.map +1 -1
  45. package/docs/assets/qqchannel.jpg +0 -0
  46. package/docs/assets/qqgroup.jpg +0 -0
  47. package/lib/client.js +278 -0
  48. package/lib/client.js.map +1 -0
  49. package/package.json +23 -9
  50. package/tsconfig.client.json +19 -0
  51. package/tsdown.client.config.ts +52 -0
  52. package/dist/setup.d.ts.map +0 -1
  53. package/dist/setup.js.map +0 -1
@@ -0,0 +1,84 @@
1
+ /**
2
+ * 扫码呈现策略(QrPresenter)
3
+ *
4
+ * 绑定协议(qqbot-connector 轮询)与呈现解耦:BindingService 只依赖
5
+ * 本接口,具体实现由宿主形态决定——终端宿主打印 ASCII 二维码与可点击
6
+ * 链接;Desktop 宿主无可见终端,改由端内绑定页(bind-routes)承载。
7
+ */
8
+ import { spawn } from 'node:child_process';
9
+ /**
10
+ * 是否运行在 DSH Desktop 宿主中。
11
+ *
12
+ * Desktop 的 Host 以 ELECTRON_RUN_AS_NODE=1 的 Electron 子进程运行
13
+ * (官方启动约定),stdout 对用户不可见,终端呈现无意义。
14
+ */
15
+ export function isDesktopHost() {
16
+ return process.env.ELECTRON_RUN_AS_NODE === '1' && typeof process.versions?.electron === 'string';
17
+ }
18
+ /** 终端可点击的 OSC 8 超链接(不支持 OSC 8 的终端会忽略控制序列,退化为纯 URL 文本) */
19
+ export function clickableLink(url) {
20
+ return `\u001b]8;;${url}\u001b\\${url}\u001b]8;;\u001b\\`;
21
+ }
22
+ /**
23
+ * 终端呈现(CLI / `dsh web` 运营者通道)
24
+ *
25
+ * ASCII 二维码由 connector 打印(printQrToConsole=true),
26
+ * 本呈现只补打可点击链接与过期提示。
27
+ *
28
+ * 绑定引导是用户直接交互内容,必须用普通 console.log 输出:
29
+ * 不带时间戳/级别前缀(避免打断二维码块),不受日志级别配置影响。
30
+ */
31
+ export function createTerminalPresenter() {
32
+ return {
33
+ id: 'terminal',
34
+ printQrToConsole: true,
35
+ onQrDisplayed(url) {
36
+ console.log('二维码显示异常?点击下方链接,用浏览器打开即可完成扫码:');
37
+ console.log(` ${clickableLink(url)}\n`);
38
+ },
39
+ onQrExpired() {
40
+ console.log('二维码已过期,正在刷新…\n');
41
+ },
42
+ };
43
+ }
44
+ /**
45
+ * 系统浏览器呈现(降级通道)
46
+ *
47
+ * Desktop 端内绑定页不可用时的自救入口:每次绑定会话只自动拉起一次
48
+ * 浏览器(二维码过期刷新不重复弹窗)。默认关闭,通过环境变量
49
+ * QQBOT_BIND_OPEN_BROWSER=1 显式启用。
50
+ */
51
+ export function createBrowserPresenter(logger) {
52
+ let opened = false;
53
+ return {
54
+ id: 'browser',
55
+ printQrToConsole: false,
56
+ onQrDisplayed(url) {
57
+ console.log(`扫码绑定链接: ${url}`);
58
+ if (opened)
59
+ return;
60
+ opened = true;
61
+ openInBrowser(url, logger);
62
+ },
63
+ onQrExpired() {
64
+ console.log('二维码已过期,正在刷新…(如浏览器中页面失效,请点击「刷新二维码」)');
65
+ },
66
+ };
67
+ }
68
+ /** 跨平台拉起系统浏览器打开 URL(失败静默降级为日志输出) */
69
+ function openInBrowser(url, logger) {
70
+ const platform = process.platform;
71
+ const command = platform === 'darwin' ? 'open' : platform === 'win32' ? 'cmd' : 'xdg-open';
72
+ const args = platform === 'win32' ? ['/c', 'start', '', url] : [url];
73
+ try {
74
+ const child = spawn(command, args, { detached: true, stdio: 'ignore', windowsHide: true });
75
+ child.on('error', (err) => {
76
+ logger.warn(`拉起浏览器失败: ${err.message}`);
77
+ });
78
+ child.unref();
79
+ }
80
+ catch (err) {
81
+ logger.warn(`拉起浏览器失败: ${err instanceof Error ? err.message : String(err)}`);
82
+ }
83
+ }
84
+ //# sourceMappingURL=presenters.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"presenters.js","sourceRoot":"","sources":["../../src/setup/presenters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAe3C;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG,IAAI,OAAO,OAAO,CAAC,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC;AACpG,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,aAAa,GAAG,WAAW,GAAG,oBAAoB,CAAC;AAC5D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,EAAE,EAAE,UAAU;QACd,gBAAgB,EAAE,IAAI;QACtB,aAAa,CAAC,GAAW;YACvB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,WAAW;YACT,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,OAAO;QACL,EAAE,EAAE,SAAS;QACb,gBAAgB,EAAE,KAAK;QACvB,aAAa,CAAC,GAAW;YACvB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;YAC9B,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,WAAW;YACT,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,SAAS,aAAa,CAAC,GAAW,EAAE,MAAc;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,OAAO,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;IAC3F,MAAM,IAAI,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3F,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAC/B,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * 将绑定 URL 渲染为 SVG data URL,供端内绑定页 <img> 直接使用。
3
+ *
4
+ * @param url - 二维码内容(q.qq.com 的 connect.html 链接)
5
+ * @returns `data:image/svg+xml;base64,...` 形式的 data URL
6
+ */
7
+ export declare function renderQrSvgDataUrl(url: string): Promise<string>;
8
+ //# sourceMappingURL=qr-svg.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qr-svg.d.ts","sourceRoot":"","sources":["../../src/setup/qr-svg.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrE"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * 扫码 URL → SVG data URL(宿主侧渲染)
3
+ *
4
+ * 二维码图像在宿主生成而非浏览器:客户端 bundle 保持零第三方依赖
5
+ * (externals 仅平台种子表),且二维码由可信源编码,页面无伪造面。
6
+ */
7
+ import QRCode from 'qrcode';
8
+ /** 二维码渲染参数(输出 SVG,含 1 单位留白,240px 宽度适合侧栏展示) */
9
+ const QR_OPTIONS = { type: 'svg', margin: 1, width: 240 };
10
+ /**
11
+ * 将绑定 URL 渲染为 SVG data URL,供端内绑定页 <img> 直接使用。
12
+ *
13
+ * @param url - 二维码内容(q.qq.com 的 connect.html 链接)
14
+ * @returns `data:image/svg+xml;base64,...` 形式的 data URL
15
+ */
16
+ export async function renderQrSvgDataUrl(url) {
17
+ const svg = await QRCode.toString(url, QR_OPTIONS);
18
+ return `data:image/svg+xml;base64,${Buffer.from(svg, 'utf8').toString('base64')}`;
19
+ }
20
+ //# sourceMappingURL=qr-svg.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qr-svg.js","sourceRoot":"","sources":["../../src/setup/qr-svg.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,8CAA8C;AAC9C,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,KAAc,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAClD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACnD,OAAO,6BAA6B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AACpF,CAAC"}
@@ -7,10 +7,15 @@ export declare const PLUGIN_VERSION: string;
7
7
  */
8
8
  export declare function buildUserAgent(): string;
9
9
  /**
10
- * 从插件安装路径推导 profile 目录(node_modules 的父目录)
10
+ * 从插件安装路径推导 profile 目录
11
11
  *
12
- * 逐级向上查找名为 node_modules 的目录并返回其父目录。
13
- * 用 basename/dirname 而非字符串分隔符匹配,兼容 Windows(\)与 pnpm 嵌套结构。
12
+ * 主策略:逐级向上探测 profile 标志文件(cordis.patch.yml / pnpm-workspace.yaml)。
13
+ * Desktop profile 使用 pnpm workspace 布局(profiles/desktop/dependencies/
14
+ * node_modules/.pnpm/<pkg>/node_modules/...),插件嵌套于多级 node_modules,
15
+ * 仅按 node_modules 匹配会命中内层目录而返回错误位置。
16
+ *
17
+ * 兜底:无标志文件时沿用旧启发式(名为 node_modules 的目录的父目录),
18
+ * 覆盖 CLI profile 的浅层 npm 布局与未写入过 patch 的全新 profile。
14
19
  *
15
20
  * @param baseDir - 起始目录,缺省为插件根(可注入便于测试)
16
21
  */
@@ -1 +1 @@
1
- {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAcA,sDAAsD;AACtD,eAAO,MAAM,cAAc,QAAsB,CAAC;AAYlD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAoB,GAAG,MAAM,GAAG,IAAI,CAS1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOtD"}
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAcA,sDAAsD;AACtD,eAAO,MAAM,cAAc,QAAsB,CAAC;AAYlD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAoB,GAAG,MAAM,GAAG,IAAI,CAwB1E;AAuBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOtD"}
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * 纯函数与常量,供插件入口与其他模块复用。
5
5
  */
6
- import { readFileSync } from 'node:fs';
6
+ import { existsSync, readFileSync } from 'node:fs';
7
7
  import os from 'node:os';
8
8
  import { fileURLToPath } from 'node:url';
9
9
  import { basename, dirname, resolve } from 'node:path';
@@ -31,14 +31,32 @@ export function buildUserAgent() {
31
31
  return `dsh-qqbot/${PLUGIN_VERSION} (Node/${process.versions.node}; ${os.platform()})`;
32
32
  }
33
33
  /**
34
- * 从插件安装路径推导 profile 目录(node_modules 的父目录)
34
+ * 从插件安装路径推导 profile 目录
35
35
  *
36
- * 逐级向上查找名为 node_modules 的目录并返回其父目录。
37
- * 用 basename/dirname 而非字符串分隔符匹配,兼容 Windows(\)与 pnpm 嵌套结构。
36
+ * 主策略:逐级向上探测 profile 标志文件(cordis.patch.yml / pnpm-workspace.yaml)。
37
+ * Desktop profile 使用 pnpm workspace 布局(profiles/desktop/dependencies/
38
+ * node_modules/.pnpm/<pkg>/node_modules/...),插件嵌套于多级 node_modules,
39
+ * 仅按 node_modules 匹配会命中内层目录而返回错误位置。
40
+ *
41
+ * 兜底:无标志文件时沿用旧启发式(名为 node_modules 的目录的父目录),
42
+ * 覆盖 CLI profile 的浅层 npm 布局与未写入过 patch 的全新 profile。
38
43
  *
39
44
  * @param baseDir - 起始目录,缺省为插件根(可注入便于测试)
40
45
  */
41
46
  export function getProfileDir(baseDir = PLUGIN_ROOT) {
47
+ // 主策略:跨过 node_modules 边界后,优先命中 cordis.patch.yml(凭据写入
48
+ // 目标),其次 pnpm-workspace.yaml。跨越守卫是关键——插件包自身随包携带
49
+ // cordis.patch.yml(dsh.bundle.patch 分发物)、源码 checkout 根也有同名
50
+ // 仓库文件,二者都会让「从 PLUGIN_ROOT 起步的探测」命中插件自己;只有
51
+ // 位于 node_modules 之上的目录才可能是拥有该插件的 profile。
52
+ const byPatch = findProfileAncestor(baseDir, (dir) => existsSync(resolve(dir, 'cordis.patch.yml')) ? dir : null);
53
+ if (byPatch !== null)
54
+ return byPatch;
55
+ const byWorkspace = findProfileAncestor(baseDir, (dir) => existsSync(resolve(dir, 'pnpm-workspace.yaml')) ? dir : null);
56
+ if (byWorkspace !== null)
57
+ return byWorkspace;
58
+ // 兜底:npm 浅层布局 / 尚未写入任何标志文件的全新 profile
59
+ // (第一个 node_modules 目录的父目录,与旧版行为一致)
42
60
  let dir = baseDir;
43
61
  for (let i = 0; i < 32; i++) {
44
62
  if (basename(dir) === 'node_modules')
@@ -50,6 +68,29 @@ export function getProfileDir(baseDir = PLUGIN_ROOT) {
50
68
  }
51
69
  return null;
52
70
  }
71
+ /**
72
+ * 沿目录树向上探测 profile 候选:仅接受「已经跨过至少一个名为
73
+ * node_modules 的路径组件」之后命中的目录(兼容 Windows 分隔符与
74
+ * pnpm 嵌套结构;dev 源码 checkout 不跨边界 → 返回 null → 环境变量引导)。
75
+ */
76
+ function findProfileAncestor(baseDir, probe) {
77
+ let crossedNodeModules = false;
78
+ let dir = baseDir;
79
+ for (let i = 0; i < 32; i++) {
80
+ if (basename(dir) === 'node_modules')
81
+ crossedNodeModules = true;
82
+ if (crossedNodeModules) {
83
+ const hit = probe(dir);
84
+ if (hit !== null)
85
+ return hit;
86
+ }
87
+ const parent = dirname(dir);
88
+ if (parent === dir)
89
+ break;
90
+ dir = parent;
91
+ }
92
+ return null;
93
+ }
53
94
  /**
54
95
  * 解析环境变量占位配置
55
96
  */
@@ -1 +1 @@
1
- {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAEhD,sDAAsD;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;AAElD,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAyB,CAAC;QAC9E,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,aAAa,cAAc,UAAU,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC;AACzF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,WAAW;IACzD,IAAI,GAAG,GAAG,OAAO,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,cAAc;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,MAAc;IAC5D,IAAI,WAAW,IAAI,WAAW,KAAK,cAAc,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5F,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAW;IAC5C,IAAI,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAC7B,IAAI,IAAI,GAAG,MAAM;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,GAAG,SAAS;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;IAC/D,IAAI,IAAI,GAAG,UAAU;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC;IACnE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC;AAC/C,CAAC"}
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"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"}
Binary file
Binary file
package/lib/client.js ADDED
@@ -0,0 +1,278 @@
1
+ window.__ModuleLoader__.load({
2
+ id: "@tencent-connect/dsh-qqbot",
3
+ factory: (require) => {
4
+ var module = { exports: {} };
5
+ var exports = module.exports;
6
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
7
+ let react = require("react");
8
+ //#region src/client/bind-page.ts
9
+ /**
10
+ * 端内绑定页 — 二维码展示与状态轮询
11
+ *
12
+ * 宿主插件在「待绑定」时注册 /qqbot/im-qqbot/bind 状态路由,本组件
13
+ * 轮询该路由渲染二维码与实时状态;扫码成功后宿主写入 profile 并经
14
+ * HMR 重载,路由随之消失(404),页面显示完成态。
15
+ *
16
+ * 运行时仅依赖 react(dsh 客户端平台种子表提供);宿主通信走同源 fetch,
17
+ * Desktop 下由壳的 IPC 桥自动附加 Host 认证转发。
18
+ */
19
+ /** 状态查询路由(宿主 bind-routes 注册) */
20
+ const BIND_STATE_URL = "/qqbot/im-qqbot/bind";
21
+ /** 刷新路由 */
22
+ const BIND_REFRESH_URL = "/qqbot/im-qqbot/bind/refresh";
23
+ /** 轮询间隔(毫秒):活跃轮询 / 失败退避 */
24
+ const ACTIVE_POLL_MS = 2e3;
25
+ const RETRY_POLL_MS = 3e3;
26
+ const CONTAINER = {
27
+ display: "flex",
28
+ flexDirection: "column",
29
+ alignItems: "center",
30
+ justifyContent: "center",
31
+ gap: "14px",
32
+ padding: "24px",
33
+ height: "100%",
34
+ textAlign: "center",
35
+ fontSize: "14px"
36
+ };
37
+ const QR_IMAGE = {
38
+ borderRadius: "8px",
39
+ background: "#fff",
40
+ padding: "10px",
41
+ maxWidth: "100%"
42
+ };
43
+ const TITLE = {
44
+ margin: 0,
45
+ fontSize: "16px",
46
+ fontWeight: 600
47
+ };
48
+ const HINT = {
49
+ margin: 0,
50
+ opacity: .75,
51
+ lineHeight: 1.6
52
+ };
53
+ const LINK = {
54
+ fontSize: "13px",
55
+ opacity: .85
56
+ };
57
+ const BUTTON = {
58
+ padding: "6px 16px",
59
+ borderRadius: "6px",
60
+ border: "1px solid currentColor",
61
+ background: "transparent",
62
+ color: "inherit",
63
+ cursor: "pointer",
64
+ fontSize: "13px"
65
+ };
66
+ const STATUS_ICON = {
67
+ fontSize: "32px",
68
+ lineHeight: 1
69
+ };
70
+ /**
71
+ * 绑定页主体(注册在 sidebar.right.pane.tab 席位)。
72
+ *
73
+ * 组件只消费框架注入的渲染位置,不依赖业务注入面;
74
+ * 状态来自宿主路由轮询,卸载(Tab 关闭/隐藏)时停止轮询。
75
+ */
76
+ function BindBody() {
77
+ const [state, setState] = (0, react.useState)(null);
78
+ const [gone, setGone] = (0, react.useState)(false);
79
+ const [refreshing, setRefreshing] = (0, react.useState)(false);
80
+ (0, react.useEffect)(() => {
81
+ let stopped = false;
82
+ let timer;
83
+ const schedule = (ms) => {
84
+ timer = setTimeout(() => {
85
+ tick();
86
+ }, ms);
87
+ };
88
+ const tick = async () => {
89
+ if (stopped) return;
90
+ try {
91
+ const res = await fetch(BIND_STATE_URL, { cache: "no-store" });
92
+ if (res.status === 404) {
93
+ if (!stopped) setGone(true);
94
+ return;
95
+ }
96
+ if (!res.ok) {
97
+ schedule(RETRY_POLL_MS);
98
+ return;
99
+ }
100
+ const body = await res.json();
101
+ if (stopped) return;
102
+ setState(body);
103
+ schedule(body.phase === "saving" ? 500 : ACTIVE_POLL_MS);
104
+ return;
105
+ } catch {}
106
+ schedule(RETRY_POLL_MS);
107
+ };
108
+ tick();
109
+ return () => {
110
+ stopped = true;
111
+ if (timer !== void 0) clearTimeout(timer);
112
+ };
113
+ }, []);
114
+ const refresh = (0, react.useCallback)(async () => {
115
+ setRefreshing(true);
116
+ try {
117
+ await fetch(BIND_REFRESH_URL, { method: "POST" });
118
+ setState({ phase: "starting" });
119
+ } catch (err) {
120
+ console.error("[im-qqbot] 刷新二维码失败", err);
121
+ } finally {
122
+ setRefreshing(false);
123
+ }
124
+ }, []);
125
+ if (gone) return (0, react.createElement)("div", { style: CONTAINER }, (0, react.createElement)("div", { style: STATUS_ICON }, "✅"), (0, react.createElement)("p", { style: HINT }, "绑定已完成,或插件未启用。"));
126
+ if (state === null || state.phase === "starting") return (0, react.createElement)("div", { style: CONTAINER }, (0, react.createElement)("p", { style: HINT }, "正在生成二维码…"));
127
+ if (state.phase === "saving") return (0, react.createElement)("div", { style: CONTAINER }, (0, react.createElement)("div", { style: STATUS_ICON }, "🎉"), (0, react.createElement)("p", { style: TITLE }, "扫码成功"), (0, react.createElement)("p", { style: HINT }, "凭据已保存,插件正在重载,稍后即可开始对话。"));
128
+ if (state.phase === "failed") return (0, react.createElement)("div", { style: CONTAINER }, (0, react.createElement)("div", { style: STATUS_ICON }, "⚠️"), (0, react.createElement)("p", { style: TITLE }, "绑定失败"), (0, react.createElement)("p", { style: HINT }, state.reason), (0, react.createElement)("button", {
129
+ style: BUTTON,
130
+ disabled: refreshing,
131
+ onClick: () => {
132
+ refresh();
133
+ }
134
+ }, "重试"));
135
+ return (0, react.createElement)("div", { style: CONTAINER }, state.qrSvg === void 0 ? null : (0, react.createElement)("img", {
136
+ src: state.qrSvg,
137
+ alt: "QQ 扫码二维码",
138
+ width: 220,
139
+ height: 220,
140
+ style: QR_IMAGE
141
+ }), (0, react.createElement)("p", { style: TITLE }, "QQ Bot 绑定"), (0, react.createElement)("p", { style: HINT }, "请使用手机 QQ 扫描上方二维码,完成机器人绑定"), (0, react.createElement)("a", {
142
+ href: state.url,
143
+ target: "_blank",
144
+ rel: "noreferrer noopener",
145
+ style: LINK
146
+ }, "在浏览器中打开扫码页"), (0, react.createElement)("button", {
147
+ style: BUTTON,
148
+ disabled: refreshing,
149
+ onClick: () => {
150
+ refresh();
151
+ }
152
+ }, refreshing ? "正在刷新…" : "刷新二维码"));
153
+ }
154
+ //#endregion
155
+ //#region src/client/index.ts
156
+ const name = "im-qqbot-client";
157
+ const inject = [
158
+ "slots",
159
+ "sidebarRight",
160
+ "sidebarRightTabs"
161
+ ];
162
+ /** 侧栏 Tab 类型(ui-sidebar-right 契约的局部投影) */
163
+ const TAB_KIND = "qqbot-bind";
164
+ /** 席位注册 key(Tab 类型 id,body/title 席位按其分发) */
165
+ const TAB_ID = "@tencent-connect/dsh-qqbot/bind";
166
+ /** 绑定入口图标(机器人轮廓,跟随主题 currentColor) */
167
+ function BindGuideIcon() {
168
+ return (0, react.createElement)("svg", {
169
+ width: 24,
170
+ height: 24,
171
+ viewBox: "0 0 24 24",
172
+ fill: "none",
173
+ "aria-hidden": true
174
+ }, (0, react.createElement)("path", {
175
+ d: "M12 3a6 6 0 0 1 6 6v1.5a4.5 4.5 0 0 1 0 9H6a4.5 4.5 0 0 1 0-9V9a6 6 0 0 1 6-6Z",
176
+ fill: "currentColor",
177
+ fillOpacity: .9
178
+ }), (0, react.createElement)("circle", {
179
+ cx: 9.5,
180
+ cy: 12,
181
+ r: 1.4,
182
+ fill: "#fff"
183
+ }), (0, react.createElement)("circle", {
184
+ cx: 14.5,
185
+ cy: 12,
186
+ r: 1.4,
187
+ fill: "#fff"
188
+ }), (0, react.createElement)("path", {
189
+ d: "M9.5 15.5a3 3 0 0 0 5 0",
190
+ stroke: "#fff",
191
+ strokeWidth: 1.2,
192
+ strokeLinecap: "round"
193
+ }));
194
+ }
195
+ function apply(ctx) {
196
+ const tabs = ctx.sidebarRightTabs;
197
+ const right = ctx.sidebarRight;
198
+ const slots = ctx.slots;
199
+ if (tabs === void 0 || slots === void 0) return;
200
+ const disposers = [
201
+ tabs.register({
202
+ id: TAB_ID,
203
+ kind: TAB_KIND,
204
+ title: () => "QQ Bot 绑定",
205
+ guide: [{
206
+ id: "bind",
207
+ order: 90,
208
+ title: () => "QQ Bot 绑定",
209
+ description: () => "扫码将 QQ 机器人绑定到当前配置",
210
+ icon: BindGuideIcon
211
+ }]
212
+ }),
213
+ slots.inject("sidebar.right.pane.tab", () => slots.register({
214
+ name: "sidebar.right.pane.tab",
215
+ key: TAB_ID
216
+ }, BindBody)),
217
+ watchAndPrompt(right)
218
+ ];
219
+ ctx.effect(() => () => {
220
+ for (const dispose of disposers.reverse()) dispose();
221
+ }, "im-qqbot-client.binding");
222
+ }
223
+ /**
224
+ * 轮询绑定状态:待绑定时自动打开绑定页。
225
+ *
226
+ * - 页面隐藏时降频轮询(可见时立即恢复节拍)
227
+ * - 404(已绑定/未安装)时退避到 30s,保持低成本常驻探测
228
+ * - 每次页面加载至多自动打开一次(用户手动关闭后不打扰)
229
+ */
230
+ function watchAndPrompt(right) {
231
+ let stopped = false;
232
+ let opened = false;
233
+ let timer;
234
+ const schedule = (ms) => {
235
+ timer = setTimeout(() => {
236
+ tick();
237
+ }, ms);
238
+ };
239
+ const tick = async () => {
240
+ if (stopped) return;
241
+ if (typeof document !== "undefined" && document.visibilityState === "hidden") {
242
+ schedule(5e3);
243
+ return;
244
+ }
245
+ try {
246
+ const res = await fetch(BIND_STATE_URL, { cache: "no-store" });
247
+ if (res.ok) {
248
+ if ((await res.json()).phase === "waiting" && !opened) {
249
+ opened = true;
250
+ try {
251
+ right?.openTab(TAB_KIND);
252
+ } catch (err) {
253
+ console.error("[im-qqbot] 打开绑定页失败", err);
254
+ }
255
+ }
256
+ schedule(3e3);
257
+ return;
258
+ }
259
+ schedule(3e4);
260
+ return;
261
+ } catch {}
262
+ schedule(1e4);
263
+ };
264
+ tick();
265
+ return () => {
266
+ stopped = true;
267
+ if (timer !== void 0) clearTimeout(timer);
268
+ };
269
+ }
270
+ //#endregion
271
+ exports.apply = apply;
272
+ exports.inject = inject;
273
+ exports.name = name;
274
+ return module.exports;
275
+ }
276
+ });
277
+
278
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","names":["useState","useCallback","createElement","createElement"],"sources":["../src/client/bind-page.ts","../src/client/index.ts"],"sourcesContent":["/**\n * 端内绑定页 — 二维码展示与状态轮询\n *\n * 宿主插件在「待绑定」时注册 /qqbot/im-qqbot/bind 状态路由,本组件\n * 轮询该路由渲染二维码与实时状态;扫码成功后宿主写入 profile 并经\n * HMR 重载,路由随之消失(404),页面显示完成态。\n *\n * 运行时仅依赖 react(dsh 客户端平台种子表提供);宿主通信走同源 fetch,\n * Desktop 下由壳的 IPC 桥自动附加 Host 认证转发。\n */\nimport { createElement, useCallback, useEffect, useState, type CSSProperties, type ReactNode } from 'react';\n\n/** 状态查询路由(宿主 bind-routes 注册) */\nexport const BIND_STATE_URL = '/qqbot/im-qqbot/bind';\n\n/** 刷新路由 */\nconst BIND_REFRESH_URL = '/qqbot/im-qqbot/bind/refresh';\n\n/** 轮询间隔(毫秒):活跃轮询 / 失败退避 */\nconst ACTIVE_POLL_MS = 2000;\nconst RETRY_POLL_MS = 3000;\n\n/** 宿主路由的序列化状态(与 src/setup/bind-routes.ts 的协议保持一致) */\ntype BindStateWire =\n | { phase: 'starting' }\n | { phase: 'waiting'; url: string; qrSvg?: string; issuedAt: number }\n | { phase: 'saving' }\n | { phase: 'failed'; reason: string };\n\nconst CONTAINER: CSSProperties = {\n display: 'flex',\n flexDirection: 'column',\n alignItems: 'center',\n justifyContent: 'center',\n gap: '14px',\n padding: '24px',\n height: '100%',\n textAlign: 'center',\n fontSize: '14px',\n};\n\nconst QR_IMAGE: CSSProperties = {\n borderRadius: '8px',\n background: '#fff',\n padding: '10px',\n maxWidth: '100%',\n};\n\nconst TITLE: CSSProperties = { margin: 0, fontSize: '16px', fontWeight: 600 };\nconst HINT: CSSProperties = { margin: 0, opacity: 0.75, lineHeight: 1.6 };\nconst LINK: CSSProperties = { fontSize: '13px', opacity: 0.85 };\nconst BUTTON: CSSProperties = {\n padding: '6px 16px',\n borderRadius: '6px',\n border: '1px solid currentColor',\n background: 'transparent',\n color: 'inherit',\n cursor: 'pointer',\n fontSize: '13px',\n};\n\nconst STATUS_ICON: CSSProperties = { fontSize: '32px', lineHeight: 1 };\n\n/**\n * 绑定页主体(注册在 sidebar.right.pane.tab 席位)。\n *\n * 组件只消费框架注入的渲染位置,不依赖业务注入面;\n * 状态来自宿主路由轮询,卸载(Tab 关闭/隐藏)时停止轮询。\n */\nexport function BindBody(): ReactNode {\n const [state, setState] = useState<BindStateWire | null>(null);\n const [gone, setGone] = useState(false);\n const [refreshing, setRefreshing] = useState(false);\n\n useEffect(() => {\n let stopped = false;\n let timer: ReturnType<typeof setTimeout> | undefined;\n\n const schedule = (ms: number): void => {\n timer = setTimeout(() => { void tick(); }, ms);\n };\n\n const tick = async (): Promise<void> => {\n if (stopped) return;\n try {\n const res = await fetch(BIND_STATE_URL, { cache: 'no-store' });\n if (res.status === 404) {\n // 已绑定(插件重载后路由消失)或插件未启用\n if (!stopped) setGone(true);\n return;\n }\n if (!res.ok) {\n schedule(RETRY_POLL_MS);\n return;\n }\n const body = (await res.json()) as BindStateWire;\n if (stopped) return;\n setState(body);\n schedule(body.phase === 'saving' ? 500 : ACTIVE_POLL_MS);\n return;\n } catch {\n // 宿主启动窗口期不可达:退避重试\n }\n schedule(RETRY_POLL_MS);\n };\n\n void tick();\n return () => { stopped = true; if (timer !== undefined) clearTimeout(timer); };\n }, []);\n\n const refresh = useCallback(async (): Promise<void> => {\n setRefreshing(true);\n try {\n await fetch(BIND_REFRESH_URL, { method: 'POST' });\n setState({ phase: 'starting' });\n } catch (err) {\n console.error('[im-qqbot] 刷新二维码失败', err);\n } finally {\n setRefreshing(false);\n }\n }, []);\n\n if (gone) {\n return createElement('div', { style: CONTAINER },\n createElement('div', { style: STATUS_ICON }, '✅'),\n createElement('p', { style: HINT }, '绑定已完成,或插件未启用。'),\n );\n }\n\n if (state === null || state.phase === 'starting') {\n return createElement('div', { style: CONTAINER },\n createElement('p', { style: HINT }, '正在生成二维码…'),\n );\n }\n\n if (state.phase === 'saving') {\n return createElement('div', { style: CONTAINER },\n createElement('div', { style: STATUS_ICON }, '🎉'),\n createElement('p', { style: TITLE }, '扫码成功'),\n createElement('p', { style: HINT }, '凭据已保存,插件正在重载,稍后即可开始对话。'),\n );\n }\n\n if (state.phase === 'failed') {\n return createElement('div', { style: CONTAINER },\n createElement('div', { style: STATUS_ICON }, '⚠️'),\n createElement('p', { style: TITLE }, '绑定失败'),\n createElement('p', { style: HINT }, state.reason),\n createElement('button', { style: BUTTON, disabled: refreshing, onClick: () => { void refresh(); } }, '重试'),\n );\n }\n\n return createElement('div', { style: CONTAINER },\n state.qrSvg === undefined\n ? null\n : createElement('img', { src: state.qrSvg, alt: 'QQ 扫码二维码', width: 220, height: 220, style: QR_IMAGE }),\n createElement('p', { style: TITLE }, 'QQ Bot 绑定'),\n createElement('p', { style: HINT }, '请使用手机 QQ 扫描上方二维码,完成机器人绑定'),\n createElement('a', { href: state.url, target: '_blank', rel: 'noreferrer noopener', style: LINK }, '在浏览器中打开扫码页'),\n createElement('button', { style: BUTTON, disabled: refreshing, onClick: () => { void refresh(); } },\n refreshing ? '正在刷新…' : '刷新二维码'),\n );\n}\n","/**\n * im-qqbot 浏览器半边 —— QQ Bot 端内扫码绑定入口\n *\n * 宿主插件在凭据缺失时注册 /qqbot/im-qqbot/bind 状态路由;本插件在\n * Web / Desktop 的右侧栏注册「QQ Bot 绑定」页,并在检测到待绑定状态时\n * 自动打开(每次页面加载至多一次)。\n *\n * 运行时依赖仅 react(客户端平台种子表提供);宿主侧栏服务经 ctx 注入,\n * 以防御式探测访问——组合缺失(如未来精简构建)时静默退出,不阻塞浏览器启动。\n */\nimport type { Context } from '@deepseek-ai/cordis';\nimport { createElement } from 'react';\nimport { BindBody, BIND_STATE_URL } from './bind-page.ts';\n\nexport const name = 'im-qqbot-client';\nexport const inject = ['slots', 'sidebarRight', 'sidebarRightTabs'];\n\n/** 侧栏 Tab 类型(ui-sidebar-right 契约的局部投影) */\nconst TAB_KIND = 'qqbot-bind';\n/** 席位注册 key(Tab 类型 id,body/title 席位按其分发) */\nconst TAB_ID = '@tencent-connect/dsh-qqbot/bind';\n\n/** ui-sidebar-right 的 Tab 注册表服务(局部投影) */\ninterface TabRegistryLike {\n register(definition: {\n id: string;\n kind: string;\n title: (address: string) => string;\n guide?: ReadonlyArray<{\n id: string;\n order: number;\n title: () => string;\n description: () => string;\n icon: unknown;\n }>;\n }): () => void;\n}\n\n/** ui-sidebar-right 的导航控制器服务(局部投影) */\ninterface SidebarRightLike {\n openTab(kind: string, options?: Record<string, unknown>): unknown;\n}\n\n/** ui-slots 的席位系统服务(局部投影) */\ninterface SlotsLike {\n inject(slotName: string, register: () => (() => void)): () => void;\n register(spec: { name: string; key: string }, component: unknown): () => void;\n}\n\n/** 绑定入口图标(机器人轮廓,跟随主题 currentColor) */\nfunction BindGuideIcon(): unknown {\n return createElement('svg', { width: 24, height: 24, viewBox: '0 0 24 24', fill: 'none', 'aria-hidden': true },\n createElement('path', { d: 'M12 3a6 6 0 0 1 6 6v1.5a4.5 4.5 0 0 1 0 9H6a4.5 4.5 0 0 1 0-9V9a6 6 0 0 1 6-6Z', fill: 'currentColor', fillOpacity: 0.9 }),\n createElement('circle', { cx: 9.5, cy: 12, r: 1.4, fill: '#fff' }),\n createElement('circle', { cx: 14.5, cy: 12, r: 1.4, fill: '#fff' }),\n createElement('path', { d: 'M9.5 15.5a3 3 0 0 0 5 0', stroke: '#fff', strokeWidth: 1.2, strokeLinecap: 'round' }),\n );\n}\n\nexport function apply(ctx: Context): void {\n const tabs = (ctx as unknown as { sidebarRightTabs?: TabRegistryLike }).sidebarRightTabs;\n const right = (ctx as unknown as { sidebarRight?: SidebarRightLike }).sidebarRight;\n const slots = (ctx as unknown as { slots?: SlotsLike }).slots;\n // 侧栏组合缺失:静默退出(宿主绑定路由与终端呈现仍然可用)\n if (tabs === undefined || slots === undefined) return;\n\n const disposers: Array<() => void> = [\n // 1. Tab 类型注册(guide 入口 + 打开时的标题捕获)\n tabs.register({\n id: TAB_ID,\n kind: TAB_KIND,\n title: () => 'QQ Bot 绑定',\n guide: [{\n id: 'bind',\n order: 90,\n title: () => 'QQ Bot 绑定',\n description: () => '扫码将 QQ 机器人绑定到当前配置',\n icon: BindGuideIcon,\n }],\n }),\n // 2. Tab 主体(keyed 席位按 Tab 类型 id 分发)\n slots.inject('sidebar.right.pane.tab', () => slots.register(\n { name: 'sidebar.right.pane.tab', key: TAB_ID },\n BindBody,\n )),\n // 3. 待绑定检测与自动引导\n watchAndPrompt(right),\n ];\n\n (ctx as unknown as { effect(fn: () => () => void, name?: string): void }).effect(() => () => {\n for (const dispose of disposers.reverse()) dispose();\n }, 'im-qqbot-client.binding');\n}\n\n/**\n * 轮询绑定状态:待绑定时自动打开绑定页。\n *\n * - 页面隐藏时降频轮询(可见时立即恢复节拍)\n * - 404(已绑定/未安装)时退避到 30s,保持低成本常驻探测\n * - 每次页面加载至多自动打开一次(用户手动关闭后不打扰)\n */\nfunction watchAndPrompt(right: SidebarRightLike | undefined): () => void {\n let stopped = false;\n let opened = false;\n let timer: ReturnType<typeof setTimeout> | undefined;\n\n const schedule = (ms: number): void => {\n timer = setTimeout(() => { void tick(); }, ms);\n };\n\n const tick = async (): Promise<void> => {\n if (stopped) return;\n if (typeof document !== 'undefined' && document.visibilityState === 'hidden') {\n schedule(5000);\n return;\n }\n try {\n const res = await fetch(BIND_STATE_URL, { cache: 'no-store' });\n if (res.ok) {\n const body = (await res.json()) as { phase?: string };\n if (body.phase === 'waiting' && !opened) {\n opened = true;\n try {\n right?.openTab(TAB_KIND);\n } catch (err) {\n console.error('[im-qqbot] 打开绑定页失败', err);\n }\n }\n schedule(3000);\n return;\n }\n // 404:已绑定或插件未启用\n schedule(30000);\n return;\n } catch {\n // 宿主暂不可达(启动窗口期):退避重试\n }\n schedule(10000);\n };\n\n void tick();\n return () => { stopped = true; if (timer !== undefined) clearTimeout(timer); };\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cxyhhhhh/dsh-qqbot",
3
- "version": "0.4.0",
3
+ "version": "0.5.0-dev.202610101544",
4
4
  "description": "QQ Bot IM channel plugin for deepseek-harness (dsh)",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -9,15 +9,20 @@
9
9
  ".": {
10
10
  "types": "./dist/index.d.ts",
11
11
  "import": "./dist/index.js"
12
+ },
13
+ "./client": {
14
+ "default": "./lib/client.js"
12
15
  }
13
16
  },
14
17
  "scripts": {
15
- "build": "tsc",
18
+ "build": "tsc && tsdown --config tsdown.client.config.ts",
19
+ "build:client": "tsdown --config tsdown.client.config.ts",
16
20
  "dev": "tsc --watch",
17
21
  "prepublishOnly": "npm run build",
18
22
  "lint": "eslint src/",
19
23
  "test": "vitest run",
20
- "clean": "rm -rf dist",
24
+ "typecheck:client": "tsc -p tsconfig.client.json",
25
+ "clean": "rm -rf dist lib",
21
26
  "ci:prepare-test-pkg": "node scripts/prepare-test-pkg.js"
22
27
  },
23
28
  "keywords": [
@@ -29,7 +34,7 @@
29
34
  ],
30
35
  "license": "MIT",
31
36
  "engines": {
32
- "node": ">=18"
37
+ "node": ">=20.3.0"
33
38
  },
34
39
  "repository": {
35
40
  "type": "git",
@@ -42,12 +47,16 @@
42
47
  "dsh": {
43
48
  "bundle": {
44
49
  "patch": "./cordis.patch.yml"
50
+ },
51
+ "client": {
52
+ "platform": "web"
45
53
  }
46
54
  },
47
55
  "dependencies": {
48
56
  "@tencent-connect/qqbot-connector": "1.2.0",
49
57
  "@tencent-connect/qqbot-nodejs": "^1.0.4",
50
- "js-yaml": "^4.1.0"
58
+ "js-yaml": "^4.1.0",
59
+ "qrcode": "^1.5.4"
51
60
  },
52
61
  "peerDependencies": {
53
62
  "@deepseek-ai/cordis": ">=4.0.1",
@@ -80,13 +89,18 @@
80
89
  },
81
90
  "devDependencies": {
82
91
  "@deepseek-ai/cordis": "4.0.1",
83
- "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
84
- "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
85
- "@deepseek-ai/dsh-session": "0.1.0-rc.6",
86
- "@deepseek-ai/dsh-user-approval": "0.1.0-rc.6",
92
+ "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
93
+ "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
94
+ "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
95
+ "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
96
+ "@deepseek-ai/dsh-user-approval": "^0.1.0-rc.6",
87
97
  "@deepseek-ai/schemastery": "3.18.1",
88
98
  "@types/js-yaml": "^4.0.9",
89
99
  "@types/node": "^26.2.0",
100
+ "@types/qrcode": "^1.5.5",
101
+ "@types/react": "~18.3.1",
102
+ "react": "^18.2.0",
103
+ "tsdown": "^0.22.2",
90
104
  "typescript": "^5.5.0",
91
105
  "vitest": "^4.1.8"
92
106
  }