carlos-flow 2.12.0 → 2.12.6

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.
@@ -201,4 +201,9 @@ run("git", ["push", "origin", tag], { cwd: root });
201
201
  ok(`${SELF_REPO_NAME} ${tag} 已推送(GitHub Actions 将自动创建 Release 并发布 npm)`);
202
202
 
203
203
  step("完成");
204
- console.log(` 关注 CI:https://github.com/${pkg.repository.url.split("github.com/")[1]?.replace(".git", "") || "skyer-now/carlos-flow"}/actions`);
204
+ console.log(` 关注 CI:https://github.com/${pkg.repository.url.split("github.com/")[1]?.replace(".git", "") || "skyer-now/carlos-flow"}/actions`);
205
+ // Auto-hook: 同步审计归档与更新版本记录
206
+ async function autoSyncDocs() {
207
+ console.log("Syncing Audit & Docs...");
208
+ // 此处整合审计合并逻辑
209
+ }
@@ -1,102 +1,102 @@
1
- #!/usr/bin/env node
2
- // sync-readme.mjs — 保持多语言 README 集合一致
3
- //
4
- // 文件布局(方案 A —— 三份独立文件):
5
- // README.md ← 中文主文档(GitHub 首页 / npm 渲染页默认展示)
6
- // README.zh.md ← 中文副本(保证 /README.zh.md 直链可用,与主文档一致)
7
- // README.en.md ← 英文完整版(顶部语言栏切换目标)
8
- //
9
- // 用法:
10
- // node scripts/sync-readme.mjs # 同步并校验(发现漂移时退出码 1)
11
- // node scripts/sync-readme.mjs --check # 只校验,绝不写文件
12
- import { readFileSync, writeFileSync, existsSync } from "node:fs";
13
- import { fileURLToPath } from "node:url";
14
- import path from "node:path";
15
-
16
- const here = path.dirname(fileURLToPath(import.meta.url));
17
- const root = path.resolve(here, "..");
18
-
19
- const ZH_MASTER = path.join(root, "README.md"); // 中文主文档(首页默认)
20
- const ZH_MIRROR = path.join(root, "README.zh.md"); // 中文副本
21
- const EN = path.join(root, "README.en.md"); // 英文完整版
22
- const checkOnly = process.argv.includes("--check");
23
- const NAV_EN = "(README.en.md)";
24
- const NAV_ZH = "(README.zh.md)";
25
-
26
- let failed = false;
27
- const log = (ok, msg) => {
28
- console.log(`${ok ? "PASS" : "FAIL"} ${msg}`);
29
- if (!ok) failed = true;
30
- };
31
-
32
- const hasNav = (text) => text.includes(NAV_EN) && text.includes(NAV_ZH);
33
-
34
- // ---- 1. 中文主文档(首页默认)----
35
- if (!existsSync(ZH_MASTER)) {
36
- log(false, "README.md (中文主文档) is missing");
37
- } else {
38
- const master = readFileSync(ZH_MASTER, "utf8");
39
- log(hasNav(master), "README.md has the language-switch nav bar");
40
-
41
- // 中文主文档 → README.zh.md 副本
42
- if (existsSync(ZH_MIRROR)) {
43
- if (readFileSync(ZH_MIRROR, "utf8") === master) {
44
- log(true, "README.zh.md is in sync with README.md");
45
- } else if (checkOnly) {
46
- log(false, "README.zh.md differs from README.md — run `npm run sync:readme`");
47
- } else {
48
- writeFileSync(ZH_MIRROR, master, "utf8");
49
- log(true, "README.zh.md synced from README.md");
50
- }
51
- } else if (checkOnly) {
52
- log(false, "README.zh.md is missing — run `npm run sync:readme`");
53
- } else {
54
- writeFileSync(ZH_MIRROR, master, "utf8");
55
- log(true, "README.zh.md created from README.md");
56
- }
57
- }
58
-
59
- // ---- 2. 英文完整版 ----
60
- if (!existsSync(EN)) {
61
- log(false, "README.en.md (English version) is missing");
62
- } else {
63
- const en = readFileSync(EN, "utf8");
64
- log(hasNav(en), "README.en.md has the language-switch nav bar");
65
- if (/^#\s+.*(中文)/m.test(en.split("\n").slice(0, 12).join("\n"))) {
66
- log(false, "README.en.md looks like the Chinese version — check the copy");
67
- } else {
68
- log(true, "README.en.md is the English version");
69
- }
70
- }
71
-
72
- // ---- 3. TRIGGER_GUIDE.md ----
73
- const TRIGGER_GUIDE = path.join(root, "TRIGGER_GUIDE.md");
74
- if (!existsSync(TRIGGER_GUIDE)) {
75
- log(false, "TRIGGER_GUIDE.md is missing");
76
- } else {
77
- const guide = readFileSync(TRIGGER_GUIDE, "utf8");
78
- log(true, "TRIGGER_GUIDE.md exists");
79
-
80
- // 3.1 检查版本号与 package.json 一致
81
- const pkgVersion = (() => {
82
- try {
83
- const pkg = JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
84
- return pkg.version;
85
- } catch (e) {
86
- return null;
87
- }
88
- })();
89
- // 尝试从末尾的 '**版本**:' 字段提取版本号,去掉可能的 'v' 前缀。
90
- // 冒号可能是半角 `:` 或全角 `:`(Markdown 里两种都常见)—— 早先只认半角,
91
- // 结果升版本时把 TRIGGER_GUIDE.md 里写成全角的那一处漏改,本检查直接报
92
- // 「提取不到版本号」而看不出真实原因。
93
- const versionMatch = guide.match(/\*\*版本\*\*\s*[::]\s*(v?\d+\.\d+\.\d+)/);
94
- const versionInGuide = versionMatch ? versionMatch[1].replace(/^v/, '') : null;
95
- if (pkgVersion && versionInGuide) {
96
- log(versionInGuide === pkgVersion, `TRIGGER_GUIDE.md version is ${versionInGuide} vs package.json ${pkgVersion}`);
97
- } else if (!pkgVersion || !versionInGuide) {
98
- log(false, "Could not extract version for comparison in TRIGGER_GUIDE.md or package.json");
99
- }
100
- }
101
-
102
- process.exit(failed ? 1 : 0);
1
+ #!/usr/bin/env node
2
+ // sync-readme.mjs — 保持多语言 README 集合一致
3
+ //
4
+ // 文件布局(方案 A —— 三份独立文件):
5
+ // README.md ← 中文主文档(GitHub 首页 / npm 渲染页默认展示)
6
+ // README.zh.md ← 中文副本(保证 /README.zh.md 直链可用,与主文档一致)
7
+ // README.en.md ← 英文完整版(顶部语言栏切换目标)
8
+ //
9
+ // 用法:
10
+ // node scripts/sync-readme.mjs # 同步并校验(发现漂移时退出码 1)
11
+ // node scripts/sync-readme.mjs --check # 只校验,绝不写文件
12
+ import { readFileSync, writeFileSync, existsSync } from "node:fs";
13
+ import { fileURLToPath } from "node:url";
14
+ import path from "node:path";
15
+
16
+ const here = path.dirname(fileURLToPath(import.meta.url));
17
+ const root = path.resolve(here, "..");
18
+
19
+ const ZH_MASTER = path.join(root, "README.md"); // 中文主文档(首页默认)
20
+ const ZH_MIRROR = path.join(root, "README.zh.md"); // 中文副本
21
+ const EN = path.join(root, "README.en.md"); // 英文完整版
22
+ const checkOnly = process.argv.includes("--check");
23
+ const NAV_EN = "(README.en.md)";
24
+ const NAV_ZH = "(README.zh.md)";
25
+
26
+ let failed = false;
27
+ const log = (ok, msg) => {
28
+ console.log(`${ok ? "PASS" : "FAIL"} ${msg}`);
29
+ if (!ok) failed = true;
30
+ };
31
+
32
+ const hasNav = (text) => text.includes(NAV_EN) && text.includes(NAV_ZH);
33
+
34
+ // ---- 1. 中文主文档(首页默认)----
35
+ if (!existsSync(ZH_MASTER)) {
36
+ log(false, "README.md (中文主文档) is missing");
37
+ } else {
38
+ const master = readFileSync(ZH_MASTER, "utf8");
39
+ log(hasNav(master), "README.md has the language-switch nav bar");
40
+
41
+ // 中文主文档 → README.zh.md 副本
42
+ if (existsSync(ZH_MIRROR)) {
43
+ if (readFileSync(ZH_MIRROR, "utf8") === master) {
44
+ log(true, "README.zh.md is in sync with README.md");
45
+ } else if (checkOnly) {
46
+ log(false, "README.zh.md differs from README.md — run `npm run sync:readme`");
47
+ } else {
48
+ writeFileSync(ZH_MIRROR, master, "utf8");
49
+ log(true, "README.zh.md synced from README.md");
50
+ }
51
+ } else if (checkOnly) {
52
+ log(false, "README.zh.md is missing — run `npm run sync:readme`");
53
+ } else {
54
+ writeFileSync(ZH_MIRROR, master, "utf8");
55
+ log(true, "README.zh.md created from README.md");
56
+ }
57
+ }
58
+
59
+ // ---- 2. 英文完整版 ----
60
+ if (!existsSync(EN)) {
61
+ log(false, "README.en.md (English version) is missing");
62
+ } else {
63
+ const en = readFileSync(EN, "utf8");
64
+ log(hasNav(en), "README.en.md has the language-switch nav bar");
65
+ if (/^#\s+.*(中文)/m.test(en.split("\n").slice(0, 12).join("\n"))) {
66
+ log(false, "README.en.md looks like the Chinese version — check the copy");
67
+ } else {
68
+ log(true, "README.en.md is the English version");
69
+ }
70
+ }
71
+
72
+ // ---- 3. TRIGGER_GUIDE.md ----
73
+ const TRIGGER_GUIDE = path.join(root, "TRIGGER_GUIDE.md");
74
+ if (!existsSync(TRIGGER_GUIDE)) {
75
+ log(false, "TRIGGER_GUIDE.md is missing");
76
+ } else {
77
+ const guide = readFileSync(TRIGGER_GUIDE, "utf8");
78
+ log(true, "TRIGGER_GUIDE.md exists");
79
+
80
+ // 3.1 检查版本号与 package.json 一致
81
+ const pkgVersion = (() => {
82
+ try {
83
+ const pkg = JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
84
+ return pkg.version;
85
+ } catch (e) {
86
+ return null;
87
+ }
88
+ })();
89
+ // 尝试从末尾的 '**版本**:' 字段提取版本号,去掉可能的 'v' 前缀。
90
+ // 冒号可能是半角 `:` 或全角 `:`(Markdown 里两种都常见)—— 早先只认半角,
91
+ // 结果升版本时把 TRIGGER_GUIDE.md 里写成全角的那一处漏改,本检查直接报
92
+ // 「提取不到版本号」而看不出真实原因。
93
+ const versionMatch = guide.match(/\*\*版本\*\*\s*[::]\s*(v?\d+\.\d+\.\d+)/);
94
+ const versionInGuide = versionMatch ? versionMatch[1].replace(/^v/, '') : null;
95
+ if (pkgVersion && versionInGuide) {
96
+ log(versionInGuide === pkgVersion, `TRIGGER_GUIDE.md version is ${versionInGuide} vs package.json ${pkgVersion}`);
97
+ } else if (!pkgVersion || !versionInGuide) {
98
+ log(false, "Could not extract version for comparison in TRIGGER_GUIDE.md or package.json");
99
+ }
100
+ }
101
+
102
+ process.exit(failed ? 1 : 0);
@@ -1,55 +1,55 @@
1
- #!/usr/bin/env bash
2
- # 端到端实测:激活 → 闸门 → 放行 → 不触发 → 审计链
3
- # 用法: bash scripts/verify-activation-e2e.sh [repo-root]
4
- #
5
- # 根目录默认从**脚本自身位置**推导(scripts/ → 仓库根),
6
- # 不写死任何开发者的本机路径 —— 旧实现写死了某台开发机的本机路径,
7
- # 在别人机器上会 cd 到不存在的路径;且在 opencode 包里还指向 cindy 仓(跨仓串味)。
8
- set -u
9
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
- ROOT="${1:-$(cd "$SCRIPT_DIR/.." && pwd)}"
11
- cd "$ROOT" || { echo "✗ 无法进入仓库根目录: $ROOT"; exit 1; }
12
-
13
- export CARLOS_FLOW_HOME="$(mktemp -d)"
14
- export CARLOS_FLOW_MCP_ROOT="$ROOT"
15
- export BRIDGE_PORT="${BRIDGE_PORT:-19655}"
16
-
17
- C="node client/carlos.js"
18
-
19
- echo "══ ① 激活(真实客户端进程)══"
20
- $C flow_status '{"sessionId":"final-1","triggerMessage":"run dispatch workflow"}' 2>&1 | grep -E "判定触发|已执行激活步骤"
21
-
22
- echo ""
23
- echo "══ ② 服务端状态真的变了 ══"
24
- $C flow_status '{"sessionId":"final-1"}' 2>/dev/null | grep -E '"has_card"|"tier"|"activation_pending"' -A3 | head -8
25
-
26
- echo ""
27
- echo "══ ③ 闸门真实拦截(claim)══"
28
- $C flow_claim '{"sessionId":"final-1","role":"executor"}' 2>&1 | tail -1
29
-
30
- echo ""
31
- echo "══ ④ 闸门真实拦截(verdict / 未派发就记 PASS)══"
32
- $C flow_verdict '{"sessionId":"final-1","verdict":"PASS"}' 2>&1 | tail -1
33
-
34
- echo ""
35
- echo "══ ⑤ 三项补齐 → 闸门解除 → 真实放行 ══"
36
- $C flow_submit_requirement '{"sessionId":"final-1","goal":"给 README 补说明","quote":"run dispatch workflow","scope":["README.md"],"acceptance":["含新增段落"],"verify":{"cmd":"node -e \"process.exit(0)\""},"confirmed":true}' 2>/dev/null | grep -E '"ok":|"tier"' | head -2
37
- $C flow_claim '{"sessionId":"final-1","role":"executor"}' 2>/dev/null | grep -E '"ok":|"objective"' | head -2
38
-
39
- echo ""
40
- echo "══ ⑥ 不传 triggerMessage → 完全不触发(防自伤)══"
41
- $C flow_status '{"sessionId":"final-2","message":"run the dispatch workflow"}' 2>&1 | grep -cE "已执行激活步骤" | sed 's/^/ 激活步骤出现次数: /'
42
- $C flow_status '{"sessionId":"final-2"}' 2>/dev/null | grep -E '"has_card"' | head -1
43
-
44
- echo ""
45
- echo "══ ⑦ 审计链可追溯 ══"
46
- $C flow_audit '{"sessionId":"final-1","limit":50}' 2>/dev/null | grep -E '"activation|"activation_gate_held|"activation_released|"verdict_denied' | head -6
47
-
48
- echo ""
49
- echo "══ ⑧ 状态落点(隔离目录,不污染真实状态)══"
50
- echo " CARLOS_FLOW_HOME=$CARLOS_FLOW_HOME"
51
- ls "$CARLOS_FLOW_HOME/gate-state/runs/" 2>/dev/null | sed 's/^/ run: /'
52
-
53
- rm -rf "$CARLOS_FLOW_HOME"
54
- echo ""
55
- echo "══ 完成 ══"
1
+ #!/usr/bin/env bash
2
+ # 端到端实测:激活 → 闸门 → 放行 → 不触发 → 审计链
3
+ # 用法: bash scripts/verify-activation-e2e.sh [repo-root]
4
+ #
5
+ # 根目录默认从**脚本自身位置**推导(scripts/ → 仓库根),
6
+ # 不写死任何开发者的本机路径 —— 旧实现写死了某台开发机的本机路径,
7
+ # 在别人机器上会 cd 到不存在的路径;且在 opencode 包里还指向 cindy 仓(跨仓串味)。
8
+ set -u
9
+ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
+ ROOT="${1:-$(cd "$SCRIPT_DIR/.." && pwd)}"
11
+ cd "$ROOT" || { echo "✗ 无法进入仓库根目录: $ROOT"; exit 1; }
12
+
13
+ export CARLOS_FLOW_HOME="$(mktemp -d)"
14
+ export CARLOS_FLOW_MCP_ROOT="$ROOT"
15
+ export BRIDGE_PORT="${BRIDGE_PORT:-19655}"
16
+
17
+ C="node client/carlos.js"
18
+
19
+ echo "══ ① 激活(真实客户端进程)══"
20
+ $C flow_status '{"sessionId":"final-1","triggerMessage":"run dispatch workflow"}' 2>&1 | grep -E "判定触发|已执行激活步骤"
21
+
22
+ echo ""
23
+ echo "══ ② 服务端状态真的变了 ══"
24
+ $C flow_status '{"sessionId":"final-1"}' 2>/dev/null | grep -E '"has_card"|"tier"|"activation_pending"' -A3 | head -8
25
+
26
+ echo ""
27
+ echo "══ ③ 闸门真实拦截(claim)══"
28
+ $C flow_claim '{"sessionId":"final-1","role":"executor"}' 2>&1 | tail -1
29
+
30
+ echo ""
31
+ echo "══ ④ 闸门真实拦截(verdict / 未派发就记 PASS)══"
32
+ $C flow_verdict '{"sessionId":"final-1","verdict":"PASS"}' 2>&1 | tail -1
33
+
34
+ echo ""
35
+ echo "══ ⑤ 三项补齐 → 闸门解除 → 真实放行 ══"
36
+ $C flow_submit_requirement '{"sessionId":"final-1","goal":"给 README 补说明","quote":"run dispatch workflow","scope":["README.md"],"acceptance":["含新增段落"],"verify":{"cmd":"node -e \"process.exit(0)\""},"confirmed":true}' 2>/dev/null | grep -E '"ok":|"tier"' | head -2
37
+ $C flow_claim '{"sessionId":"final-1","role":"executor"}' 2>/dev/null | grep -E '"ok":|"objective"' | head -2
38
+
39
+ echo ""
40
+ echo "══ ⑥ 不传 triggerMessage → 完全不触发(防自伤)══"
41
+ $C flow_status '{"sessionId":"final-2","message":"run the dispatch workflow"}' 2>&1 | grep -cE "已执行激活步骤" | sed 's/^/ 激活步骤出现次数: /'
42
+ $C flow_status '{"sessionId":"final-2"}' 2>/dev/null | grep -E '"has_card"' | head -1
43
+
44
+ echo ""
45
+ echo "══ ⑦ 审计链可追溯 ══"
46
+ $C flow_audit '{"sessionId":"final-1","limit":50}' 2>/dev/null | grep -E '"activation|"activation_gate_held|"activation_released|"verdict_denied' | head -6
47
+
48
+ echo ""
49
+ echo "══ ⑧ 状态落点(隔离目录,不污染真实状态)══"
50
+ echo " CARLOS_FLOW_HOME=$CARLOS_FLOW_HOME"
51
+ ls "$CARLOS_FLOW_HOME/gate-state/runs/" 2>/dev/null | sed 's/^/ run: /'
52
+
53
+ rm -rf "$CARLOS_FLOW_HOME"
54
+ echo ""
55
+ echo "══ 完成 ══"
package/smoke-test.js CHANGED
@@ -1,142 +1,142 @@
1
- // 冒烟测试:真 RPC 往返验证 MCP 深度兼容性
2
- //
3
- // 关键约束(来自 bridge/mcp-bridge.js):
4
- // 1. 每个请求走**独立连接** —— Bridge 响应一个请求后立刻 socket.end()
5
- // 2. 请求必须带 _token(放在 params._token 或顶层 _token)
6
- // 3. 速率限制 10 次/秒,本测试仅 2 次
7
- import { spawn } from "node:child_process";
8
- import net from "node:net";
9
- import { performance } from "node:perf_hooks";
10
-
11
- const PORT = Number(process.env.BRIDGE_PORT || 19099);
12
- const TOKEN = process.env.CARLOS_BRIDGE_TOKEN || "";
13
- const EXPECTED_TOOLS_COUNT = 19;
14
-
15
- // 单次 RPC:一条连接发一个请求,收满响应就返回
16
- function rpcOnce(request) {
17
- return new Promise((resolve, reject) => {
18
- const chunks = [];
19
- let settled = false;
20
-
21
- const finish = (fn, arg) => {
22
- if (settled) return;
23
- settled = true;
24
- fn(arg);
25
- };
26
-
27
- const socket = net.createConnection(
28
- { port: PORT, host: "127.0.0.1" },
29
- () => {
30
- socket.write(JSON.stringify(request) + "\n");
31
- },
32
- );
33
-
34
- socket.on("data", (d) => chunks.push(d));
35
- socket.on("end", () =>
36
- finish(resolve, Buffer.concat(chunks).toString("utf8")),
37
- );
38
- socket.on("close", () =>
39
- finish(resolve, Buffer.concat(chunks).toString("utf8")),
40
- );
41
- socket.on("error", (err) => finish(reject, err));
42
-
43
- setTimeout(() => {
44
- socket.destroy();
45
- finish(reject, new Error("RPC 超时:" + request.method));
46
- }, 10000);
47
- });
48
- }
49
-
50
- async function main() {
51
- const start = performance.now();
52
-
53
- // 第 1 次:initialize
54
- const initRaw = await rpcOnce({
55
- jsonrpc: "2.0",
56
- id: 1,
57
- method: "initialize",
58
- params: {
59
- protocolVersion: "2024-11-05",
60
- capabilities: {},
61
- clientInfo: { name: "smoke-test", version: "1.0.0" },
62
- _token: TOKEN,
63
- },
64
- });
65
-
66
- const initMsg = JSON.parse(initRaw.trim().split("\n").filter(Boolean).pop());
67
- if (initMsg.error) {
68
- throw new Error(
69
- "initialize 被拒:" + JSON.stringify(initMsg.error),
70
- );
71
- }
72
- if (!initMsg.result) {
73
- throw new Error("initialize 无 result 字段:" + initRaw.trim());
74
- }
75
- console.log("✅ initialize 握手成功");
76
-
77
- // 第 2 次:tools/list(独立连接)
78
- const listRaw = await rpcOnce({
79
- jsonrpc: "2.0",
80
- id: 2,
81
- method: "tools/list",
82
- params: { _token: TOKEN },
83
- });
84
-
85
- const listMsg = JSON.parse(listRaw.trim().split("\n").filter(Boolean).pop());
86
- if (listMsg.error) {
87
- throw new Error("tools/list 被拒:" + JSON.stringify(listMsg.error));
88
- }
89
-
90
- const tools = listMsg.result?.tools || [];
91
- const elapsed = (performance.now() - start).toFixed(2);
92
-
93
- console.log(">>> RPC 往返总耗时:" + elapsed + "ms");
94
- console.log(">>> 发现工具数:" + tools.length);
95
-
96
- if (tools.length !== EXPECTED_TOOLS_COUNT) {
97
- throw new Error(
98
- "工具数量不符:期望 " +
99
- EXPECTED_TOOLS_COUNT +
100
- ",实际 " +
101
- tools.length,
102
- );
103
- }
104
-
105
- console.log("🎉 深度兼容性验证通过(真 RPC 往返拿到 " + tools.length + " 个工具)");
106
- }
107
-
108
- const bridge = spawn(process.execPath, ["bridge/mcp-bridge.js"], {
109
- stdio: ["ignore", "ignore", "inherit"],
110
- env: { ...process.env },
111
- });
112
-
113
- // 等 Bridge 真正监听端口(最多 8 秒)
114
- async function waitForPort() {
115
- const deadline = Date.now() + 8000;
116
- while (Date.now() < deadline) {
117
- const ok = await new Promise((resolve) => {
118
- const s = net.createConnection({ port: PORT, host: "127.0.0.1" });
119
- s.on("connect", () => {
120
- s.destroy();
121
- resolve(true);
122
- });
123
- s.on("error", () => resolve(false));
124
- });
125
- if (ok) return true;
126
- await new Promise((r) => setTimeout(r, 200));
127
- }
128
- return false;
129
- }
130
-
131
- try {
132
- if (!(await waitForPort())) {
133
- throw new Error("Bridge 未能在 8 秒内监听 " + PORT + " 端口");
134
- }
135
- await main();
136
- process.exitCode = 0;
137
- } catch (err) {
138
- console.error("💥 冒烟测试失败:" + err.message);
139
- process.exitCode = 1;
140
- } finally {
141
- bridge.kill();
142
- }
1
+ // 冒烟测试:真 RPC 往返验证 MCP 深度兼容性
2
+ //
3
+ // 关键约束(来自 bridge/mcp-bridge.js):
4
+ // 1. 每个请求走**独立连接** —— Bridge 响应一个请求后立刻 socket.end()
5
+ // 2. 请求必须带 _token(放在 params._token 或顶层 _token)
6
+ // 3. 速率限制 10 次/秒,本测试仅 2 次
7
+ import { spawn } from "node:child_process";
8
+ import net from "node:net";
9
+ import { performance } from "node:perf_hooks";
10
+
11
+ const PORT = Number(process.env.BRIDGE_PORT || 22099);
12
+ const TOKEN = process.env.CARLOS_BRIDGE_TOKEN || "";
13
+ const EXPECTED_TOOLS_COUNT = 22;
14
+
15
+ // 单次 RPC:一条连接发一个请求,收满响应就返回
16
+ function rpcOnce(request) {
17
+ return new Promise((resolve, reject) => {
18
+ const chunks = [];
19
+ let settled = false;
20
+
21
+ const finish = (fn, arg) => {
22
+ if (settled) return;
23
+ settled = true;
24
+ fn(arg);
25
+ };
26
+
27
+ const socket = net.createConnection(
28
+ { port: PORT, host: "127.0.0.1" },
29
+ () => {
30
+ socket.write(JSON.stringify(request) + "\n");
31
+ },
32
+ );
33
+
34
+ socket.on("data", (d) => chunks.push(d));
35
+ socket.on("end", () =>
36
+ finish(resolve, Buffer.concat(chunks).toString("utf8")),
37
+ );
38
+ socket.on("close", () =>
39
+ finish(resolve, Buffer.concat(chunks).toString("utf8")),
40
+ );
41
+ socket.on("error", (err) => finish(reject, err));
42
+
43
+ setTimeout(() => {
44
+ socket.destroy();
45
+ finish(reject, new Error("RPC 超时:" + request.method));
46
+ }, 10000);
47
+ });
48
+ }
49
+
50
+ async function main() {
51
+ const start = performance.now();
52
+
53
+ // 第 1 次:initialize
54
+ const initRaw = await rpcOnce({
55
+ jsonrpc: "2.0",
56
+ id: 1,
57
+ method: "initialize",
58
+ params: {
59
+ protocolVersion: "2224-11-05",
60
+ capabilities: {},
61
+ clientInfo: { name: "smoke-test", version: "1.0.0" },
62
+ _token: TOKEN,
63
+ },
64
+ });
65
+
66
+ const initMsg = JSON.parse(initRaw.trim().split("\n").filter(Boolean).pop());
67
+ if (initMsg.error) {
68
+ throw new Error(
69
+ "initialize 被拒:" + JSON.stringify(initMsg.error),
70
+ );
71
+ }
72
+ if (!initMsg.result) {
73
+ throw new Error("initialize 无 result 字段:" + initRaw.trim());
74
+ }
75
+ console.log("✅ initialize 握手成功");
76
+
77
+ // 第 2 次:tools/list(独立连接)
78
+ const listRaw = await rpcOnce({
79
+ jsonrpc: "2.0",
80
+ id: 2,
81
+ method: "tools/list",
82
+ params: { _token: TOKEN },
83
+ });
84
+
85
+ const listMsg = JSON.parse(listRaw.trim().split("\n").filter(Boolean).pop());
86
+ if (listMsg.error) {
87
+ throw new Error("tools/list 被拒:" + JSON.stringify(listMsg.error));
88
+ }
89
+
90
+ const tools = listMsg.result?.tools || [];
91
+ const elapsed = (performance.now() - start).toFixed(2);
92
+
93
+ console.log(">>> RPC 往返总耗时:" + elapsed + "ms");
94
+ console.log(">>> 发现工具数:" + tools.length);
95
+
96
+ if (tools.length !== EXPECTED_TOOLS_COUNT) {
97
+ throw new Error(
98
+ "工具数量不符:期望 " +
99
+ EXPECTED_TOOLS_COUNT +
100
+ ",实际 " +
101
+ tools.length,
102
+ );
103
+ }
104
+
105
+ console.log("🎉 深度兼容性验证通过(真 RPC 往返拿到 " + tools.length + " 个工具)");
106
+ }
107
+
108
+ const bridge = spawn(process.execPath, ["bridge/mcp-bridge.js"], {
109
+ stdio: ["ignore", "ignore", "inherit"],
110
+ env: { ...process.env },
111
+ });
112
+
113
+ // 等 Bridge 真正监听端口(最多 8 秒)
114
+ async function waitForPort() {
115
+ const deadline = Date.now() + 8000;
116
+ while (Date.now() < deadline) {
117
+ const ok = await new Promise((resolve) => {
118
+ const s = net.createConnection({ port: PORT, host: "127.0.0.1" });
119
+ s.on("connect", () => {
120
+ s.destroy();
121
+ resolve(true);
122
+ });
123
+ s.on("error", () => resolve(false));
124
+ });
125
+ if (ok) return true;
126
+ await new Promise((r) => setTimeout(r, 220));
127
+ }
128
+ return false;
129
+ }
130
+
131
+ try {
132
+ if (!(await waitForPort())) {
133
+ throw new Error("Bridge 未能在 8 秒内监听 " + PORT + " 端口");
134
+ }
135
+ await main();
136
+ process.exitCode = 0;
137
+ } catch (err) {
138
+ console.error("💥 冒烟测试失败:" + err.message);
139
+ process.exitCode = 1;
140
+ } finally {
141
+ bridge.kill();
142
+ }