pi-wechat-session-hub 0.1.2 → 0.1.5

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/package.json CHANGED
@@ -1,72 +1,73 @@
1
- {
2
- "name": "pi-wechat-session-hub",
3
- "version": "0.1.2",
4
- "description": "通过微信管理本机多个 Pi 会话的 Pi 扩展。",
5
- "keywords": [
6
- "pi-package",
7
- "pi",
8
- "wechat",
9
- "weixin",
10
- "ilink",
11
- "session-manager",
12
- "remote-control"
13
- ],
14
- "license": "AGPL-3.0-or-later",
15
- "author": "yangfeng20",
16
- "repository": {
17
- "type": "git",
18
- "url": "git+https://github.com/yangfeng20/pi-wechat-session-hub.git"
19
- },
20
- "bugs": {
21
- "url": "https://github.com/yangfeng20/pi-wechat-session-hub/issues"
22
- },
23
- "homepage": "https://github.com/yangfeng20/pi-wechat-session-hub#readme",
24
- "type": "module",
25
- "engines": {
26
- "node": ">=22.19.0"
27
- },
28
- "files": [
29
- "extensions/",
30
- "src/",
31
- "scripts/",
32
- "docs/",
33
- "README.md",
34
- "CHANGELOG.md",
35
- "LICENSE",
36
- "tsconfig.json"
37
- ],
38
- "scripts": {
39
- "typecheck": "tsc --noEmit",
40
- "test": "node --experimental-transform-types --test --test-timeout=30000 --test-force-exit tests/config-store.test.ts tests/project-service.test.ts tests/project-command-parser.test.ts tests/registry.test.ts tests/pi-rpc-client.test.ts tests/background-worker.test.ts tests/background-worker-resume.test.ts tests/pi-cli.test.ts tests/durable-message-queue.test.ts tests/gateway-command-parser.test.ts tests/gateway-command-router.test.ts tests/durable-message-queue-context.test.ts tests/turn-health.test.ts tests/wechat-ilink.test.ts tests/credential-store.test.ts tests/ilink-qr-login.test.ts tests/gateway-runtime.test.ts tests/wechat-manager-command-parser.test.ts tests/ui-worker-manager.test.ts tests/windows-terminal-launcher.test.ts tests/gateway-service-controller.test.ts tests/windows-logon-autostart-manager.test.ts tests/ui-session-owner-handoff.test.ts tests/ui-resume-owner-liveness.test.ts tests/wechat-session-hub-command.test.ts",
41
- "test:pi-runtime": "node scripts/pi-rpc-smoke.mjs",
42
- "test:wt-capability": "node --experimental-transform-types scripts/probe-wt-capability.mjs",
43
- "release:check": "node scripts/release-preflight.mjs",
44
- "release:verify": "node scripts/release-preflight.mjs --verify"
45
- },
46
- "peerDependencies": {
47
- "@earendil-works/pi-coding-agent": "*"
48
- },
49
- "devDependencies": {
50
- "@earendil-works/pi-coding-agent": "0.85.1",
51
- "@types/node": "^22.0.0",
52
- "@types/qrcode-terminal": "0.12.2",
53
- "typescript": "^5.9.3"
54
- },
55
- "pi": {
56
- "extensions": [
57
- "./extensions/*.ts"
58
- ]
59
- },
60
- "piCompatibility": {
61
- "testedVersions": [
62
- "0.85.1",
63
- "1.0.0",
64
- "1.3.0"
65
- ],
66
- "supportedRange": ">=0.85.1 <2.0.0"
67
- },
68
- "dependencies": {
69
- "jiti": "^2.7.0",
70
- "qrcode-terminal": "0.12.0"
71
- }
72
- }
1
+ {
2
+ "name": "pi-wechat-session-hub",
3
+ "version": "0.1.5",
4
+ "description": "通过微信管理本机多个 Pi 会话的 Pi 扩展。",
5
+ "keywords": [
6
+ "pi-package",
7
+ "pi",
8
+ "wechat",
9
+ "weixin",
10
+ "ilink",
11
+ "session-manager",
12
+ "remote-control"
13
+ ],
14
+ "license": "AGPL-3.0-or-later",
15
+ "author": "yangfeng20",
16
+ "repository": {
17
+ "type": "git",
18
+ "url": "git+https://github.com/yangfeng20/pi-wechat-session-hub.git"
19
+ },
20
+ "bugs": {
21
+ "url": "https://github.com/yangfeng20/pi-wechat-session-hub/issues"
22
+ },
23
+ "homepage": "https://github.com/yangfeng20/pi-wechat-session-hub#readme",
24
+ "type": "module",
25
+ "engines": {
26
+ "node": ">=22.19.0"
27
+ },
28
+ "files": [
29
+ "extensions/",
30
+ "src/",
31
+ "scripts/",
32
+ "docs/",
33
+ "README.md",
34
+ "CHANGELOG.md",
35
+ "LICENSE",
36
+ "tsconfig.json"
37
+ ],
38
+ "scripts": {
39
+ "typecheck": "tsc --noEmit",
40
+ "test": "node --experimental-transform-types --test --test-timeout=30000 --test-force-exit tests/config-store.test.ts tests/project-service.test.ts tests/project-command-parser.test.ts tests/registry.test.ts tests/pi-rpc-client.test.ts tests/background-worker.test.ts tests/background-worker-resume.test.ts tests/pi-cli.test.ts tests/durable-message-queue.test.ts tests/gateway-command-parser.test.ts tests/gateway-command-router.test.ts tests/durable-message-queue-context.test.ts tests/turn-health.test.ts tests/wechat-ilink.test.ts tests/notification-service.test.ts tests/notification-ingress-server.test.ts tests/wechat-notify-tool.test.ts tests/credential-store.test.ts tests/ilink-qr-login.test.ts tests/gateway-runtime.test.ts tests/wechat-manager-command-parser.test.ts tests/ui-worker-manager.test.ts tests/windows-terminal-launcher.test.ts tests/gateway-service-controller.test.ts tests/windows-logon-autostart-manager.test.ts tests/ui-session-owner-handoff.test.ts tests/ui-native-session-switch.test.ts tests/wechat-session-hub-command.test.ts",
41
+ "test:pi-runtime": "node scripts/pi-rpc-smoke.mjs",
42
+ "test:wt-capability": "node --experimental-transform-types scripts/probe-wt-capability.mjs",
43
+ "release:check": "node scripts/release-preflight.mjs",
44
+ "release:verify": "node scripts/release-preflight.mjs --verify"
45
+ },
46
+ "peerDependencies": {
47
+ "@earendil-works/pi-coding-agent": "*"
48
+ },
49
+ "dependencies": {
50
+ "jiti": "^2.7.0",
51
+ "qrcode-terminal": "0.12.0",
52
+ "typebox": "^1.3.7"
53
+ },
54
+ "devDependencies": {
55
+ "@earendil-works/pi-coding-agent": "0.85.1",
56
+ "@types/node": "^22.0.0",
57
+ "@types/qrcode-terminal": "0.12.2",
58
+ "typescript": "^5.9.3"
59
+ },
60
+ "pi": {
61
+ "extensions": [
62
+ "./extensions/*.ts"
63
+ ]
64
+ },
65
+ "piCompatibility": {
66
+ "testedVersions": [
67
+ "0.85.1",
68
+ "1.0.0",
69
+ "1.3.0"
70
+ ],
71
+ "supportedRange": ">=0.85.1 <2.0.0"
72
+ }
73
+ }
@@ -150,17 +150,25 @@ async function runVerify() {
150
150
 
151
151
  const published = packument.versions?.[version];
152
152
  if (!published) {
153
- fail(`registry 上找不到 ${version}, 发布可能尚未生效`);
153
+ const rawVersions = Object.keys(packument.versions ?? {});
154
+ if (rawVersions.includes("0.0.0-stage") || packument["dist-tags"]?.latest !== version) {
155
+ fail(`registry 上暂时看不到 ${version}: npm 可能正在做发布后安全扫描(网页显示 Validating), 稍等几分钟后重试`);
156
+ } else {
157
+ fail(`registry 上找不到 ${version}, 发布可能尚未生效`);
158
+ }
154
159
  report();
155
160
  return;
156
161
  }
157
162
 
163
+ // 版本级 readme 在正常发布的包里也常为空, 真正影响搜索索引的是顶层 readme,
164
+ // 因此只在顶层也为空时判失败, 避免误报。
158
165
  const packumentReadme = typeof packument.readme === "string" ? packument.readme : "";
159
166
  const versionReadme = typeof published.readme === "string" ? published.readme : "";
160
- if (packumentReadme.trim().length === 0 && versionReadme.trim().length === 0) {
161
- fail("packument 的 readme 为空, 该包无法进入 npm search 索引(0.1.0 的同款问题)");
167
+ if (packumentReadme.trim().length === 0) {
168
+ fail("顶层 readme 为空, 该包可能无法进入 npm search 索引(0.1.0 的同款问题)");
162
169
  } else {
163
- note(`packument readme 长度 ${packumentReadme.length}, 版本 readme 长度 ${versionReadme.length}`);
170
+ const versionNote = versionReadme.trim().length === 0 ? "(版本级为空属正常)" : "";
171
+ note(`顶层 readme ${packumentReadme.length} 字符, 版本级 readme ${versionReadme.length} 字符${versionNote}`);
164
172
  }
165
173
 
166
174
  const latest = packument["dist-tags"]?.latest;
@@ -170,37 +178,81 @@ async function runVerify() {
170
178
  note(`dist-tags.latest = ${version}`);
171
179
  }
172
180
 
173
- if (!versionReadme.includes("daemon-entry") && packumentReadme.length === 0) {
174
- note("README 中未提及 daemon-entry, 如已更新文档可忽略");
181
+ const searchHit = await checkNpmSearch(name).catch((error) => {
182
+ note(`npm search 检查跳过: ${error instanceof Error ? error.message : String(error)}`);
183
+ return undefined;
184
+ });
185
+ if (searchHit === true) {
186
+ note("npm search 已能检索到该包");
187
+ } else if (searchHit === false) {
188
+ note("npm search 暂未收录, 索引有延迟, 通常几分钟到数小时");
175
189
  }
176
190
 
177
- const search = await fetch(
191
+ const galleryHit = await checkGallery(name).catch((error) => {
192
+ note(`pi.dev/packages 检查跳过: ${error instanceof Error ? error.message : String(error)}`);
193
+ return undefined;
194
+ });
195
+ if (galleryHit === true) {
196
+ note("pi.dev/packages 已能搜到该包");
197
+ } else if (galleryHit === false) {
198
+ note("pi.dev/packages 暂未收录, 站点有自己的索引缓存, 需要等待刷新");
199
+ }
200
+
201
+ report();
202
+ }
203
+
204
+ /**
205
+ * 查询 npm search 是否已收录该包。
206
+ *
207
+ * @param {string} name 包名。
208
+ * @returns {Promise<boolean>} 已收录返回 true, 未收录返回 false。
209
+ */
210
+ async function checkNpmSearch(name) {
211
+ const response = await fetchWithTimeout(
178
212
  `${REGISTRY}/-/v1/search?text=${encodeURIComponent(`${name} keywords:pi-package`)}&size=20`,
179
- { headers: { "user-agent": "pi-wechat-session-hub-release-check" } },
180
213
  );
181
- if (search.ok) {
182
- const result = await search.json();
183
- const hit = result.objects?.some((item) => item.package?.name === name);
184
- if (hit) {
185
- note("npm search 已能检索到该包");
186
- } else {
187
- note("npm search 暂未收录, 索引有延迟, 通常几分钟到数小时");
188
- }
214
+ if (!response.ok) {
215
+ throw new Error(`search 接口返回 ${response.status}`);
189
216
  }
217
+ const result = await response.json();
218
+ return Boolean(result.objects?.some((item) => item.package?.name === name));
219
+ }
190
220
 
191
- const gallery = await fetch(`https://pi.dev/packages?name=${encodeURIComponent(name)}`, {
192
- headers: { "user-agent": "pi-wechat-session-hub-release-check" },
193
- });
194
- if (gallery.ok) {
195
- const html = await gallery.text();
196
- if (html.includes(name)) {
197
- note("pi.dev/packages 已能搜到该包");
198
- } else {
199
- note("pi.dev/packages 暂未收录, 站点有自己的索引缓存, 需要等待刷新");
200
- }
221
+ /**
222
+ * 查询 pi.dev 包画廊是否已收录该包。
223
+ *
224
+ * @param {string} name 包名。
225
+ * @returns {Promise<boolean>} 已收录返回 true, 未收录返回 false。
226
+ */
227
+ async function checkGallery(name) {
228
+ const response = await fetchWithTimeout(`https://pi.dev/packages?name=${encodeURIComponent(name)}`);
229
+ if (!response.ok) {
230
+ throw new Error(`pi.dev 返回 ${response.status}`);
201
231
  }
232
+ const html = await response.text();
233
+ return html.includes(name);
234
+ }
202
235
 
203
- report();
236
+ /**
237
+ * 带超时的 fetch。
238
+ *
239
+ * 外部站点(尤其是经 Cloudflare 的 pi.dev)在网络受限时可能长时间不响应,
240
+ * 必须显式限时, 否则会拖住整个校验流程。
241
+ *
242
+ * @param {string} url 请求地址。
243
+ * @returns {Promise<Response>} 响应对象。
244
+ */
245
+ async function fetchWithTimeout(url) {
246
+ const controller = new AbortController();
247
+ const timer = setTimeout(() => controller.abort(), 15000);
248
+ try {
249
+ return await fetch(url, {
250
+ headers: { "user-agent": "pi-wechat-session-hub-release-check" },
251
+ signal: controller.signal,
252
+ });
253
+ } finally {
254
+ clearTimeout(timer);
255
+ }
204
256
  }
205
257
 
206
258
  /**
@@ -0,0 +1,266 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Pi 微信会话枢纽通知入口 CLI。
4
+ *
5
+ * 用法:
6
+ * node wx-notify.mjs "标题" "正文" [--source 标识] [--manager-dir <目录>] [--timeout <毫秒>]
7
+ *
8
+ * 通过本机 named pipe (Windows) 或 unix socket (POSIX) 向 Hub daemon
9
+ * 投递一条通知, 由 daemon 复用最新 context_token 直发微信。
10
+ * 零依赖, 可被任意程序 spawn。
11
+ */
12
+
13
+ import { createHmac, randomUUID } from "node:crypto";
14
+ import { createConnection } from "node:net";
15
+ import { readFile } from "node:fs/promises";
16
+ import { homedir, tmpdir } from "node:os";
17
+ import { isAbsolute, join, resolve } from "node:path";
18
+ import { createHash } from "node:crypto";
19
+
20
+ const DEFAULT_TIMEOUT_MS = 10000;
21
+
22
+ /**
23
+ * 解析命令行参数。
24
+ *
25
+ * @param argv 原始参数数组。
26
+ * @returns 解析结果, 非法时抛错。
27
+ */
28
+ function parseArguments(argv) {
29
+ const positional = [];
30
+ let source;
31
+ let managerDirectory;
32
+ let timeoutMs = DEFAULT_TIMEOUT_MS;
33
+ for (let index = 0; index < argv.length; index += 1) {
34
+ const argument = argv[index];
35
+ if (argument === "--source") {
36
+ source = argv[index + 1];
37
+ if (!source) {
38
+ throw new Error("--source 需要一个值。");
39
+ }
40
+ index += 1;
41
+ continue;
42
+ }
43
+ if (argument === "--manager-dir") {
44
+ managerDirectory = argv[index + 1];
45
+ if (!managerDirectory) {
46
+ throw new Error("--manager-dir 需要一个值。");
47
+ }
48
+ index += 1;
49
+ continue;
50
+ }
51
+ if (argument === "--timeout") {
52
+ timeoutMs = Number(argv[index + 1]);
53
+ if (!Number.isFinite(timeoutMs) || timeoutMs <= 0 || timeoutMs > 60000) {
54
+ throw new Error("--timeout 必须是 1-60000 之间的毫秒数。");
55
+ }
56
+ index += 1;
57
+ continue;
58
+ }
59
+ if (argument === "--help" || argument === "-h") {
60
+ printUsageAndExit(0);
61
+ }
62
+ positional.push(argument);
63
+ }
64
+ if (positional.length < 1 || positional.length > 2) {
65
+ printUsageAndExit(1);
66
+ }
67
+ return {
68
+ title: positional.length === 2 ? positional[0] : undefined,
69
+ text: positional[positional.length - 1],
70
+ source,
71
+ managerDirectory,
72
+ timeoutMs,
73
+ };
74
+ }
75
+
76
+ /**
77
+ * 打印用法并退出。
78
+ *
79
+ * @param code 退出码。
80
+ * @returns 无返回值。
81
+ */
82
+ function printUsageAndExit(code) {
83
+ process.stdout.write([
84
+ "用法: node wx-notify.mjs [标题] <正文> [--source 标识] [--manager-dir <目录>] [--timeout <毫秒>]",
85
+ "",
86
+ "示例:",
87
+ ' node wx-notify.mjs "构建完成" "beacon 项目编译通过, 耗时 2 分钟"',
88
+ ' node wx-notify.mjs "CI 失败" "main 分支测试挂了" --source github-actions',
89
+ "",
90
+ "退出码: 0 成功; 非 0 失败 (原因见 stderr)。",
91
+ ].join("\n"));
92
+ process.stdout.write("\n");
93
+ process.exit(code);
94
+ }
95
+
96
+ /**
97
+ * 推导 Hub manager 数据目录。
98
+ *
99
+ * @param override 显式指定值。
100
+ * @returns 绝对路径。
101
+ */
102
+ function resolveManagerDirectory(override) {
103
+ if (override) {
104
+ return resolve(override);
105
+ }
106
+ const agentDirectory = process.env.PI_CODING_AGENT_DIR;
107
+ const base = agentDirectory?.trim()
108
+ ? (isAbsolute(agentDirectory) ? agentDirectory : join(homedir(), agentDirectory))
109
+ : join(homedir(), ".pi", "agent");
110
+ return join(base, "wechat-session-manager");
111
+ }
112
+
113
+ /**
114
+ * 计算 named pipe / unix socket endpoint, 与服务端同一逻辑。
115
+ *
116
+ * @param managerDirectory manager 数据目录。
117
+ * @returns endpoint 文本。
118
+ */
119
+ function createEndpoint(managerDirectory) {
120
+ const resolved = resolve(managerDirectory);
121
+ const normalized = process.platform === "win32" ? resolved.toLowerCase() : resolved;
122
+ const scope = createHash("sha256").update(normalized).digest("hex").slice(0, 24);
123
+ if (process.platform === "win32") {
124
+ return `\\\\.\\pipe\\pi-wechat-session-hub-${scope}-notify`;
125
+ }
126
+ return join(tmpdir(), `pi-wechat-session-hub-${scope}-notify.sock`);
127
+ }
128
+
129
+ /**
130
+ * 计算与服务端一致的 HMAC proof。
131
+ *
132
+ * @param key hex 共享密钥。
133
+ * @param requestId 请求 ID。
134
+ * @param timestamp 毫秒时间戳。
135
+ * @param payload 规范化 JSON 字符串。
136
+ * @returns base64url proof。
137
+ */
138
+ function computeProof(key, requestId, timestamp, payload) {
139
+ return createHmac("sha256", Buffer.from(key, "hex"))
140
+ .update(`${requestId}\n${timestamp}\n`, "utf8")
141
+ .update(payload, "utf8")
142
+ .digest("base64url");
143
+ }
144
+
145
+ /**
146
+ * 连接 endpoint 并完成一次请求-响应。
147
+ *
148
+ * @param endpoint IPC endpoint。
149
+ * @param frame JSON 帧。
150
+ * @param timeoutMs 超时。
151
+ * @returns 服务端响应对象。
152
+ */
153
+ function requestOnce(endpoint, frame, timeoutMs) {
154
+ return new Promise((resolvePromise, rejectPromise) => {
155
+ const socket = createConnection(endpoint);
156
+ let buffer = "";
157
+ let settled = false;
158
+ const finish = (error, response) => {
159
+ if (settled) {
160
+ return;
161
+ }
162
+ settled = true;
163
+ clearTimeout(timer);
164
+ socket.destroy();
165
+ if (error) {
166
+ rejectPromise(error);
167
+ } else {
168
+ resolvePromise(response);
169
+ }
170
+ };
171
+ const timer = setTimeout(() => finish(new Error("连接 Hub 通知入口超时。")), timeoutMs);
172
+ timer.unref?.();
173
+ socket.on("connect", () => {
174
+ socket.write(`${JSON.stringify(frame)}\n`, "utf8");
175
+ });
176
+ socket.on("data", (chunk) => {
177
+ buffer += chunk;
178
+ const newline = buffer.indexOf("\n");
179
+ if (newline < 0) {
180
+ return;
181
+ }
182
+ const line = buffer.slice(0, newline);
183
+ try {
184
+ finish(undefined, JSON.parse(line));
185
+ } catch {
186
+ finish(new Error("Hub 返回了无效响应。"));
187
+ }
188
+ });
189
+ socket.on("error", (error) => {
190
+ finish(new Error(`无法连接 Hub 通知入口 (${error.code ?? error.message})。Hub 可能未启动。`));
191
+ });
192
+ socket.on("close", () => finish(new Error("连接在收到响应前关闭。")));
193
+ });
194
+ }
195
+
196
+ /**
197
+ * 主流程。
198
+ *
199
+ * @returns 无返回值。
200
+ */
201
+ async function main() {
202
+ const options = parseArguments(process.argv.slice(2));
203
+ const managerDirectory = resolveManagerDirectory(options.managerDirectory);
204
+ const keyPath = join(managerDirectory, "notify-shared.key");
205
+ let key;
206
+ try {
207
+ key = (await readFile(keyPath, "utf8")).trim();
208
+ } catch {
209
+ process.stderr.write([
210
+ `未找到通知入口 key: ${keyPath}`,
211
+ "请先在 Pi TUI 启动 Hub (/wx start), 首次启动会自动生成 key。",
212
+ ].join("\n"));
213
+ process.stderr.write("\n");
214
+ process.exit(2);
215
+ }
216
+ if (!/^[a-f0-9]{64}$/i.test(key)) {
217
+ process.stderr.write("通知入口 key 内容无效, 请重新启动 Hub 生成。");
218
+ process.stderr.write("\n");
219
+ process.exit(2);
220
+ }
221
+
222
+ const requestId = randomUUID();
223
+ const timestamp = Date.now();
224
+ const payload = JSON.stringify({
225
+ ...(options.title ? { title: options.title } : {}),
226
+ text: options.text,
227
+ ...(options.source ? { source: options.source } : {}),
228
+ });
229
+ const frame = {
230
+ requestId,
231
+ timestamp,
232
+ payload,
233
+ proof: computeProof(key, requestId, timestamp, payload),
234
+ };
235
+
236
+ const endpoint = createEndpoint(managerDirectory);
237
+ let response;
238
+ try {
239
+ response = await requestOnce(endpoint, frame, options.timeoutMs);
240
+ } catch (error) {
241
+ process.stderr.write(error instanceof Error ? error.message : String(error));
242
+ process.stderr.write("\n");
243
+ process.exit(3);
244
+ }
245
+
246
+ if (response.ok) {
247
+ const detail = response.code === "queued"
248
+ ? `通知已积压 (第 ${response.position} 条), 你续命后自动补发。`
249
+ : "通知已发送到微信。";
250
+ process.stdout.write(detail);
251
+ process.stdout.write("\n");
252
+ process.exit(0);
253
+ }
254
+ process.stderr.write(`发送失败 (${response.code}): ${response.message ?? "未知原因"}`);
255
+ if (response.retryAfterMs) {
256
+ process.stderr.write(`; 建议 ${Math.ceil(response.retryAfterMs / 1000)} 秒后重试。`);
257
+ }
258
+ process.stderr.write("\n");
259
+ process.exit(4);
260
+ }
261
+
262
+ main().catch((error) => {
263
+ process.stderr.write(error instanceof Error ? error.message : String(error));
264
+ process.stderr.write("\n");
265
+ process.exit(1);
266
+ });