refactor(pi-bridge): 定下 lib/ 与 test/lib/ 的边界 —— 三个测试侧模块原来会随部署进 /opt
pi 复核后指出：`lib/` 会被 `cp -a "$SRC/." "$STAGING/"` **整份打进生产快照**
（排除清单只有 `test/`、`.git`、`node_modules/.cache`），而我们那三个测试侧模块
（`tmp-space.mjs`、`env-error.mjs`、`session-fixtures.mjs`）都住在 `lib/` 里。
后果不是几 KB，而是"漂移 N 处"这个数字**虚高**、哈希清单变长 ——
而"手抄哈希清单"正是我们刚定性为会过期的东西。
## 规则写成**可判定的**，不写成约定
lib/ = 从生产入口可达的模块（会进快照）
test/lib/ = 只被测试引用的模块（test/ 不部署、也不被注册进套件）
`test/lib/reach.mjs` 真去走一遍 import 闭包（种子 = `src/index.mjs` +
源码里 `new URL('./x.mjs', import.meta.url)` 这类**按路径 fork 的子进程入口**）。
★ 顺带纠正 pi 的规则表述：他写的是"被 `src/` import"，但实测 22 个 `lib/` 模块里
有 4 个 `src` **直接**引用数是 0 —— `addressing.js`（被 `lib/inbox-format.js` 引）、
`user-question.js`（走前缀动态 import）、`mail-session-id.js`、`crash-notify.mjs`。
**直接引用数不是可达性**，所以判据真走图而不是 grep。
★ 也纠正他的排除清单名字：脚本里没有 `EXCLUDE_DIRS` 这个变量，就是一条 `rm -rf`。
## 本规则多抓到一个 pi 没发现的
`lib/user-question.js` 也是**只被测试引用**（只有 `test/user-question.test.mjs` 用它）
⇒ 同样会进快照。已一并移到 `test/lib/`。剩下 `mail-session-id.js` 与
`crash-notify.mjs` 是**谁都不用**（生产与测试都不可达）—— 那是遗留物，
不动它们（不属本次范围），但记录在此。
## 新增：因果**无关**的运行期判据
`test/lib/run-suite.mjs`：跑套件并从**同一次运行的 TAP**里数结果行，任何用例名
出现两次就红。为什么需要：静态那条（测试文件不许互相 import）只能发现**已知成因**。
实测跨文件重名**不会被 runner 拦**：两个文件各写一个同名用例 ⇒
`# tests 2 / # pass 2 / # fail 0`，两句 `ok`，零警告。
判据锚在 `^(ok|not ok) <n> - <名字>`（**结果行**），不是"名字出现过"——
pi 先前那条 `grep -c '<名字>'` 给 4 是因为 TAP 里名字既出现在 `# Subtest:` 头、
又出现在结果行，**2 倍效应 + 2 倍噪声恰好同值**，若行种类是 3 就会把两次读成三次。
本脚本自带 `--self-check`（干净样本放行 / 重复样本点名 / 只出现在头里的不算重复 /
名字含 `#` 不被截断）。
`package.json` 的 `test` 改为：
node test/lib/env-preflight.mjs && node test/lib/run-suite.mjs
## 判据全进套件
`test/layout-boundaries.test.mjs`（新）：生产可达性不碰 `test/`、`test/lib/` 里不许藏
运行时模块、测试文件不许互相 import、`npm test` 必须接上 run-suite 那一层。
原来放在 `env-guard.test.mjs` 里那条"夹具不在测试文件里"已移到这里（集中边界判据）。
## 变异自检（两条都实测红了才留下）
- 造一个与巨行用例**同名**的探针文件 ⇒ `npm test` exit 1 并点名
`2× ★巨大的 message 行不进内存也不影响解析`；
- 往 `src/gateway.mjs` 加一行指向 `test/lib/run-suite.mjs` 的真 import ⇒
边界判据红并指出 `生产可达了测试代码：test/lib/run-suite.mjs`。
两条探针均已删除、`src/gateway.mjs` 用 `git checkout` 还原并 `cmp` 校验一致。
顺带修一处路径：`env-guard.test.mjs` 里 `PREFLIGHT` 仍指向旧的 `test/env-preflight.mjs`
（前置脚本已移入 `test/lib/`）。
验证：`npm test` **462/462**、结果行重复检查 0 个重名、set 全绿。
This commit is contained in:
55
plugins/pi-mail-bridge/test/lib/env-error.mjs
Normal file
55
plugins/pi-mail-bridge/test/lib/env-error.mjs
Normal file
@ -0,0 +1,55 @@
|
||||
/**
|
||||
* 「临时目录写不进去」⇒ 人话。**纯函数，可被反面样本喂**。
|
||||
*
|
||||
* # 为什么它必须是一个函数，而不是散在写点里的 try/catch
|
||||
*
|
||||
* 2026-09-14 实测：`/tmp` 是满的 tmpfs，`bavail` 一度真是 **0**。此时这条
|
||||
* `npm test` 红的是
|
||||
*
|
||||
* not ok 323 - ★巨大的 message 行不进内存也不影响解析
|
||||
* error: 'ENOSPC: no space left on device, write'
|
||||
*
|
||||
* 那条红的**形状指向内存**（用例名里就写着"不进内存"，而它恰好是往临时目录
|
||||
* 写文件的用例）⇒ 下一个踩到的人会去 `session-scan.mjs` 找一个**不存在**的
|
||||
* 内存缺陷。翻译成人话（"这是环境问题，不是内存缺陷"）就治这个。
|
||||
*
|
||||
* # 为什么抽出来（只有一个调用点也值得抽）
|
||||
*
|
||||
* **不是为了复用，是为了可被反面样本喂**：`translateEnvError` 能被直接喂一个
|
||||
* 构造出来的 ENOSPC 错误，验"该翻译的翻译了、不该翻译的原样返回"。
|
||||
* 反例：第一版把这个判断留在 `session-scan.test.mjs` 里，判据只能靠**读源码文本**
|
||||
* （断言文件里出现 `/ENOSPC/`）—— 而那段解释性注释里本来就有 "ENOSPC" 这个词，
|
||||
* 于是**删掉整个翻译逻辑、只留注释，判据照样绿**。这正是
|
||||
* `permission-note.test.mjs` 警告过的"钉装饰不钉机制"。
|
||||
*
|
||||
* # 为什么不去和 `deploy/check-deploy-drift.mjs` 的 `describeEnvError` 合并
|
||||
*
|
||||
* 判据相同、措辞不同，看起来该合并 —— 但不合：**`deploy/` 的独立性比去重值钱**
|
||||
* （那份文件头整段在讲"服务不该依赖仓库是否存在"，`deploy/` 下的工具同理，
|
||||
* 让它 import 插件目录里的模块等于把它绑死在插件的目录结构上）。
|
||||
* **第三份拷贝出现时再考虑共用。**
|
||||
*
|
||||
* # 变异自检的纪律（这条是踩出来的）
|
||||
*
|
||||
* 验证本函数"真的被接上"要注入变异（删掉调用、看判据红不红）。做这件事时：
|
||||
* **先证明你能撤回来，再注入**；而且**还原路径不能依赖被测对象** ——
|
||||
* 2026-09-14 那次把备份写进 `/tmp`（正是当时被占满的那个资源），备份没写成，
|
||||
* 变异却已经覆盖了源文件。现在只对"已在 HEAD 里干净提交"的文件做变异，
|
||||
* 还原一律走 `git checkout HEAD -- <file>`。
|
||||
*
|
||||
* @param {unknown} e 捕获到的错误
|
||||
* @returns {{ translated: boolean, error: Error }} 翻译过的新错误，或原样返回
|
||||
*/
|
||||
export function translateEnvError(e) {
|
||||
const message = e && typeof e.message === 'string' ? e.message : String(e ?? '');
|
||||
const isEnospc = (e && e.code === 'ENOSPC') || /no space left on device/i.test(message);
|
||||
if (!isEnospc) return { translated: false, error: e };
|
||||
|
||||
const err = new Error(
|
||||
'环境不足：临时目录写不进去（ENOSPC）—— 这是环境问题，不是内存缺陷。' +
|
||||
'药方：TMPDIR=<有空间的目录> npm test'
|
||||
);
|
||||
err.code = 'ENOSPC';
|
||||
err.cause = e;
|
||||
return { translated: true, error: err };
|
||||
}
|
||||
99
plugins/pi-mail-bridge/test/lib/env-preflight.mjs
Normal file
99
plugins/pi-mail-bridge/test/lib/env-preflight.mjs
Normal file
@ -0,0 +1,99 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 测试前置自检：**临时目录还有空间吗**。
|
||||
*
|
||||
* 名字**不带 `.test.`** —— 所以它不会被 `node --test 'test/*.test.mjs'` 收进去
|
||||
* 当用例跑；它由 `package.json` 的 `test` 脚本**先**跑一次。
|
||||
*
|
||||
* # 它在挡什么
|
||||
*
|
||||
* 2026-09-14 实测：`/tmp` 是 tmpfs，被别的项目/别的 agent 的东西占满，
|
||||
* `bavail` 只剩 0.70 MiB。此时 `npm test` 会红一条
|
||||
* `★巨大的 message 行不进内存也不影响解析`（`ENOSPC`）—— 那条红**长得像内存缺陷**，
|
||||
* 而真相是环境不足。这个脚本把"环境不足"在**跑测试之前**就大声说出来。
|
||||
*
|
||||
* # 退出码约定（与 `deploy/redeploy-plugin.sh` 同一套）
|
||||
*
|
||||
* 0 = 环境够用，继续跑测试
|
||||
* 2 = **环境问题**（不是断言失败）
|
||||
*
|
||||
* 写清 `2` 的意义很关键：CI 或人看到 `1` 会去查代码，看到 `2` 才知道去查机器。
|
||||
*/
|
||||
|
||||
import { tmpdir } from 'node:os';
|
||||
|
||||
import { judgeSpace, measureAvailBytes, MIN_FREE_BYTES } from './tmp-space.mjs';
|
||||
|
||||
/*
|
||||
* 两个**只为测试存在**的开关（`src/pool.mjs` 的 `workerPath` 是同一手法）。
|
||||
*
|
||||
* 为什么需要：端到端那条判据要验"不足 ⇒ exit 2"，而本机 `/tmp` 现在恰好是满的。
|
||||
* 靠"机器恰好是满的"来验，等于把判据绑在一个**会变**的环境上 —— `/tmp` 一被清空，
|
||||
* 那条判据就自动跳过、无声失效。开关让同一个行为在任何机器上都验得了。
|
||||
*
|
||||
* --measure=<dir> 只量并打印 JSON（`{"dir":…,"availBytes":…}`），总是 exit 0
|
||||
* --inject-avail=<n> 绕过测量，直接按 `n` 字节判定（`null` 表示"没测到"）
|
||||
*/
|
||||
const argOf = (name) => {
|
||||
const hit = process.argv.find((a) => a.startsWith(`--${name}=`));
|
||||
return hit ? hit.slice(name.length + 3) : undefined;
|
||||
};
|
||||
|
||||
/** 未知参数一律拒绝（exit 2，与"环境/参数问题"同义）。
|
||||
* 静默忽略未知参数会让 `--inject-avail=abc` 这类笔误退化成"没测到 ⇒ 放行" ——
|
||||
* 在这条链上就等于**悄悄跳过守卫**。拼错参数必须炸，不能忍。 */
|
||||
const KNOWN = ['--measure', '--inject-avail'];
|
||||
for (const a of process.argv.slice(2)) {
|
||||
if (!KNOWN.some((k) => a.startsWith(`${k}=`))) {
|
||||
console.error(`[env-preflight] 不认识这个参数：${a}\n用法：--measure=<dir> | --inject-avail=<字节数|null>`);
|
||||
process.exit(2);
|
||||
}
|
||||
}
|
||||
|
||||
const measureDir = argOf('measure');
|
||||
if (measureDir !== undefined) {
|
||||
console.log(JSON.stringify({ dir: measureDir, availBytes: measureAvailBytes(measureDir) }));
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
const injected = argOf('inject-avail');
|
||||
const dir = tmpdir();
|
||||
let availBytes;
|
||||
if (injected === undefined) {
|
||||
availBytes = measureAvailBytes(dir);
|
||||
} else if (injected === 'null') {
|
||||
availBytes = null;
|
||||
} else {
|
||||
availBytes = Number(injected);
|
||||
// `Number('abc')` = NaN ⇒ 判据会当成"没测到"而**放行**。笔误在这条链上等于跳过守卫，
|
||||
// 所以非法值按参数错误处理（exit 2），不给它静默放行的机会。
|
||||
if (!Number.isFinite(availBytes) || availBytes < 0) {
|
||||
console.error(`[env-preflight] --inject-avail 的值不合法：${injected}（要字节数或 null）`);
|
||||
process.exit(2);
|
||||
}
|
||||
}
|
||||
const verdict = judgeSpace({ availBytes });
|
||||
|
||||
if (verdict.ok) {
|
||||
console.log(`[env-preflight] 临时目录 ${dir}：${verdict.note}`);
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
console.error(`
|
||||
[env-preflight] 环境不足：临时目录写不下，**这是环境不足，不是断言失败**。
|
||||
|
||||
目录 ${dir}
|
||||
可用 ${(availBytes / 1048576).toFixed(1)} MiB
|
||||
需要 ${(MIN_FREE_BYTES / 1048576).toFixed(1)} MiB
|
||||
判定 ${verdict.note}
|
||||
|
||||
测试用例会往临时目录写十几 MiB 的文件。空间不够时它报的是 ENOSPC，
|
||||
而那看起来像代码缺陷 —— 曾经就是这么误导过一次。
|
||||
|
||||
药方（任选其一）：
|
||||
TMPDIR=<有空间的目录> npm test # 换临时目录，最省事
|
||||
清理 ${dir} 下不属于你的东西之前先问主人 # 别误删别人的缓存
|
||||
|
||||
退出码 2 = 环境问题（与 deploy/redeploy-plugin.sh 的 2 同义），不是代码问题。
|
||||
`);
|
||||
process.exit(2);
|
||||
137
plugins/pi-mail-bridge/test/lib/reach.mjs
Normal file
137
plugins/pi-mail-bridge/test/lib/reach.mjs
Normal file
@ -0,0 +1,137 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* `lib/` 与 `test/lib/` 的边界：**从生产入口出发的 import 闭包**。
|
||||
*
|
||||
* # 为什么需要这条判据
|
||||
*
|
||||
* 2026-09-14 发现：`lib/tmp-space.mjs`、`lib/env-error.mjs`、`lib/session-fixtures.mjs`
|
||||
* 这三个模块**只有测试用**，却住在 `lib/` 里 ⇒ 部署脚本 `cp -a "$SRC/." "$STAGING/"`
|
||||
* 会把它们**打进生产快照**（`EXCLUDE` 只排掉 `test/`、`.git`、`node_modules/.cache`）。
|
||||
* 后果不是"多几 KB"，而是：
|
||||
*
|
||||
* - "漂移 N 处"这个数字**虚高**（其中两三处根本不是运行时代码）；
|
||||
* - 部署验收要核的哈希清单变长，而我们刚把"手抄哈希清单"定性为会过期的东西。
|
||||
*
|
||||
* # 规则（写成**可判定的**，不写成"约定"）
|
||||
*
|
||||
* `lib/` = 从生产入口可达的模块（会进快照）
|
||||
* `test/lib/` = 只被测试引用的模块（`test/` 不部署、也不被注册进套件）
|
||||
*
|
||||
* 判据：**`src/` 下任何文件都不得（直接或间接）引用 `test/` 下的任何文件。**
|
||||
* 这是单向的 —— 测试引用 `lib/` 完全正常（本仓库就是这么做的）。
|
||||
*
|
||||
* ⚠️ 别把规则写成"被 `src/` **直接** import"：实测 22 个 `lib/` 模块里有 4 个
|
||||
* `src` 直接引用数是 0 —— `addressing.js`（被 `lib/inbox-format.js` 引用）、
|
||||
* `user-question.js`（走前缀动态 import）、`mail-session-id.js`、`crash-notify.mjs`。
|
||||
* **直接引用数不是可达性**。所以这里真去走一遍图。
|
||||
*
|
||||
* ⚠️ 也别漏掉"按路径 fork 的子进程入口"：`src/pool.mjs` 里是
|
||||
* `fileURLToPath(new URL('./worker.mjs', import.meta.url))` —— worker 不是 `import`
|
||||
* 进来的，但它是生产代码。因此种子 = `src/index.mjs` + 源码里 `new URL('./x.mjs', …)`
|
||||
* 这类**按路径解析**的本地文件。
|
||||
*
|
||||
* 退出码：0 = 边界干净；1 = 有违规（`src/` 可达 `test/`）；2 = 环境/前置问题。
|
||||
*/
|
||||
|
||||
import { readFileSync, readdirSync, existsSync } from 'node:fs';
|
||||
import { dirname, join, resolve, relative } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import process from 'node:process';
|
||||
|
||||
const HERE = dirname(fileURLToPath(import.meta.url)); // …/test/lib
|
||||
const ROOT = resolve(HERE, '../..'); // 插件根
|
||||
|
||||
/** 从一份源码里取出它引用的**本地**文件（相对路径）。
|
||||
* 三类都收：静态 `from './x'`、动态 `import('./x')`、以及按路径解析的
|
||||
* `new URL('./x', import.meta.url)`（子进程入口就是这个形状）。 */
|
||||
export function localRefs(src) {
|
||||
const out = new Set();
|
||||
const patterns = [
|
||||
/\bfrom\s*['"](\.[^'"]+)['"]/g,
|
||||
/\bimport\s*\(\s*['"](\.[^'"]+)['"]\s*\)/g,
|
||||
/\bnew\s+URL\s*\(\s*['"](\.[^'"]+)['"]/g,
|
||||
];
|
||||
for (const re of patterns) {
|
||||
for (const m of src.matchAll(re)) out.add(m[1]);
|
||||
}
|
||||
return [...out];
|
||||
}
|
||||
|
||||
/** 把 `./x` 这种相对引用解析成一个真实存在的文件（补 .mjs/.js 后缀）。 */
|
||||
function resolveRef(fromFile, ref) {
|
||||
const base = resolve(dirname(fromFile), ref);
|
||||
for (const cand of [base, `${base}.mjs`, `${base}.js`, join(base, 'index.mjs')]) {
|
||||
if (existsSync(cand) && !cand.endsWith('/')) {
|
||||
try {
|
||||
if (readFileSync(cand) !== null) return cand;
|
||||
} catch { /* 目录会抛 —— 跳过 */ }
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/** 从种子出发走一遍 import 闭包，返回插件根下的相对路径集合。 */
|
||||
export function reachable(seeds) {
|
||||
const seen = new Set();
|
||||
const queue = [...seeds];
|
||||
while (queue.length) {
|
||||
const f = queue.pop();
|
||||
if (seen.has(f)) continue;
|
||||
seen.add(f);
|
||||
let src;
|
||||
try {
|
||||
src = readFileSync(f, 'utf8');
|
||||
} catch {
|
||||
continue;
|
||||
}
|
||||
for (const ref of localRefs(src)) {
|
||||
const r = resolveRef(f, ref);
|
||||
if (r && !seen.has(r)) queue.push(r);
|
||||
}
|
||||
}
|
||||
return new Set([...seen].map((f) => relative(ROOT, f)));
|
||||
}
|
||||
|
||||
/** 生产种子：部署脚本的 ENTRY + 源码里按路径解析的本地文件（子进程入口）。 */
|
||||
export function productionSeeds() {
|
||||
const entry = join(ROOT, 'src', 'index.mjs');
|
||||
const seeds = [entry];
|
||||
const srcDir = join(ROOT, 'src');
|
||||
for (const f of readdirSync(srcDir)) {
|
||||
if (!f.endsWith('.mjs')) continue;
|
||||
const full = join(srcDir, f);
|
||||
const src = readFileSync(full, 'utf8');
|
||||
// `new URL('./worker.mjs', import.meta.url)` —— fork 的入口按路径找，不走 import
|
||||
for (const m of src.matchAll(/\bnew\s+URL\s*\(\s*['"](\.[^'"]+)['"]/g)) {
|
||||
const r = resolveRef(full, m[1]);
|
||||
if (r) seeds.push(r);
|
||||
}
|
||||
}
|
||||
return seeds;
|
||||
}
|
||||
|
||||
function main() {
|
||||
const reach = reachable(productionSeeds());
|
||||
const offenders = [...reach].filter((p) => p.startsWith('test/') || p.startsWith('test\\'));
|
||||
|
||||
console.log('生产可达性（从 src/index.mjs 出发，含按路径 fork 的子进程入口）：');
|
||||
const srcFiles = [...reach].filter((p) => p.startsWith('src/') || p.startsWith('lib/')).sort();
|
||||
for (const p of srcFiles) console.log(` 可达 ${p}`);
|
||||
const testFiles = [...reach].filter((p) => p.startsWith('test/'));
|
||||
console.log(`\n src/ + lib/ 可达 ${srcFiles.length} 个；lib/ 总共有 ${
|
||||
readdirSync(join(ROOT, 'lib')).length} 个文件`);
|
||||
|
||||
if (offenders.length) {
|
||||
console.error('\n✗ 生产代码引用了 test/ 下的文件：');
|
||||
for (const p of offenders) console.error(` ${p}`);
|
||||
console.error(' ⇒ 要么把它移到 lib/（如果生产真的需要），要么切断这条引用。');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('✓ 生产代码没有引用 test/ 下的任何文件（边界干净）');
|
||||
if (testFiles.length === 0) console.log('（本次闭包里没有 test/ 文件）');
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
if (process.argv[1] && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url))) {
|
||||
main();
|
||||
}
|
||||
172
plugins/pi-mail-bridge/test/lib/run-suite.mjs
Normal file
172
plugins/pi-mail-bridge/test/lib/run-suite.mjs
Normal file
@ -0,0 +1,172 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 跑套件，并从**同一次运行的 TAP 输出**里数结果行 —— 任何用例名出现两次就红。
|
||||
*
|
||||
* # 为什么需要它：这是一条**因果无关**的判据
|
||||
*
|
||||
* `test/env-guard.test.mjs` 里那条"测试文件之间不许互相 import"只能发现**已知的
|
||||
* 那个成因**。同族的另一种成因它看不见，比如**两个文件里恰好同名**的用例 ——
|
||||
* `node --test` 按文件注册，跨文件重名**不会被拦**。2026-09-14 实测确认：
|
||||
*
|
||||
* 两个文件各写一个 `test('同名用例')` ⇒ `# tests 2 / # pass 2 / # fail 0`
|
||||
* （两条 `ok`，没有任何警告）
|
||||
*
|
||||
* 本脚本不挑成因：**只数结果行**。它同时也能抓住"二次注册"那类问题，
|
||||
* 所以和那条静态判据是**互补**的（静态那条更早、能指认是哪个文件引了哪个；
|
||||
* 这条更晚、但因果无关）。
|
||||
*
|
||||
* # 判据锚在哪一行（这条是被人纠正出来的）
|
||||
*
|
||||
* 锚 `^(ok|not ok) <n> - <name>` —— **结果行**。pi 先前给的一条验证命令是
|
||||
* `grep -c '<用例名>'`，那个数的是**字符串出现次数**：TAP 里同一个用例名既出现在
|
||||
* `# Subtest:` 头、又出现在结果行 ⇒ 2 倍效应 + 2 倍噪声，**两个因子恰好同值**，
|
||||
* 于是"4"看起来还能解释。若行种类是 3，就会把"两次注册"读成"三次"。
|
||||
* 规矩：**判据必须锚在与结论一一对应的那一行上**，而不是"出现过"。
|
||||
*
|
||||
* # 退出码（与 `env-preflight.mjs`、`redeploy-plugin.sh` 同一套）
|
||||
*
|
||||
* 0 = 套件全绿 **且**没有重名
|
||||
* 1 = 断言失败（套件红了）**或**发现重名（这是真问题，要看代码）
|
||||
* 2 = 环境/参数问题（临时目录不足等）
|
||||
*
|
||||
* `--self-check`：不跑套件，只用两段合成的 TAP 样本验本脚本自己
|
||||
* （干净样本必须放行、重复样本必须点名）—— 这就是"判据自检"，与
|
||||
* `check-deploy-drift.mjs --self-check` 同一形状。
|
||||
*/
|
||||
|
||||
import { spawnSync } from 'node:child_process';
|
||||
import process from 'node:process';
|
||||
|
||||
/** TAP 结果行：`ok 12 - 名字` / `not ok 12 - 名字`（名字里可能有 `#` 之类，照收）。 */
|
||||
const RESULT_RE = /^(not ok|ok) (\d+) - (.*)$/;
|
||||
|
||||
/** 只认"用例"行：跳过整份文件的汇总行（形如 `ok 1 - test/xxx.test.mjs` 也算结果行，
|
||||
* 所以不能只靠这一条区分）。这里用"出现次数"来做判断，不区分文件级与用例级 —— */
|
||||
export function findDuplicates(tapText) {
|
||||
const counts = new Map();
|
||||
for (const line of tapText.split('\n')) {
|
||||
const m = RESULT_RE.exec(line);
|
||||
if (!m) continue;
|
||||
const name = m[3].trim();
|
||||
counts.set(name, (counts.get(name) || 0) + 1);
|
||||
}
|
||||
return [...counts.entries()]
|
||||
.filter(([, n]) => n > 1)
|
||||
.map(([name, n]) => ({ name, count: n }))
|
||||
.sort((a, b) => b.count - a.count || a.name.localeCompare(b.name));
|
||||
}
|
||||
|
||||
/** 从 TAP 里取汇总：`# tests N` / `# pass N` / `# fail N`。取不到就是没跑完。 */
|
||||
export function summaryOf(tapText) {
|
||||
const grab = (k) => {
|
||||
const m = new RegExp(`^# ${k} (\\d+)$`, 'm').exec(tapText);
|
||||
return m ? Number(m[1]) : null;
|
||||
};
|
||||
return { tests: grab('tests'), pass: grab('pass'), fail: grab('fail') };
|
||||
}
|
||||
|
||||
const SELF_CHECK_SAMPLES = [
|
||||
{
|
||||
what: '干净样本：每个名字只出现一次 → 必须放行',
|
||||
tap: [
|
||||
'# Subtest: 甲',
|
||||
'ok 1 - 甲',
|
||||
'# Subtest: 乙',
|
||||
'ok 2 - 乙',
|
||||
'1..2',
|
||||
'# tests 2',
|
||||
'# pass 2',
|
||||
'# fail 0',
|
||||
].join('\n'),
|
||||
expect: [],
|
||||
},
|
||||
{
|
||||
what: '★重复样本：同名两次（正是跨文件重名的形状）→ 必须点名',
|
||||
tap: [
|
||||
'# Subtest: 同名用例',
|
||||
'ok 1 - 同名用例',
|
||||
'# Subtest: 同名用例',
|
||||
'ok 2 - 同名用例',
|
||||
'1..2',
|
||||
'# tests 2',
|
||||
'# pass 2',
|
||||
'# fail 0',
|
||||
].join('\n'),
|
||||
expect: ['同名用例'],
|
||||
},
|
||||
{
|
||||
what: '★噪声样本：名字只出现在 `# Subtest:` 头里（没有结果行）→ 不算重复',
|
||||
tap: ['# Subtest: 只在头里', '1..0', '# tests 0', '# pass 0', '# fail 0'].join('\n'),
|
||||
expect: [],
|
||||
},
|
||||
{
|
||||
what: '★名字里带 `#` 也要能取对（别把名字截断成前缀）',
|
||||
tap: ['ok 1 - ★0 字节不是「不知道」', 'ok 2 - ★0 字节不是「不知道」', '1..2'].join('\n'),
|
||||
expect: ['★0 字节不是「不知道」'],
|
||||
},
|
||||
];
|
||||
|
||||
function selfCheck() {
|
||||
let bad = 0;
|
||||
for (const s of SELF_CHECK_SAMPLES) {
|
||||
const got = findDuplicates(s.tap).map((d) => d.name);
|
||||
const ok = JSON.stringify(got) === JSON.stringify(s.expect);
|
||||
console.log(` ${ok ? '通过' : '失败'} ${s.what}`);
|
||||
if (!ok) {
|
||||
bad += 1;
|
||||
console.log(` 期望 ${JSON.stringify(s.expect)}，实际 ${JSON.stringify(got)}`);
|
||||
}
|
||||
}
|
||||
console.log(bad === 0 ? '\n判据自检：全部通过。' : `\n判据自检：${bad} 条失败。`);
|
||||
process.exit(bad === 0 ? 0 : 1);
|
||||
}
|
||||
|
||||
if (process.argv.includes('--self-check')) selfCheck();
|
||||
|
||||
// ── 跑套件 ────────────────────────────────────────────────────────
|
||||
// `--test-reporter=tap` 让报告格式稳定（`--test` 在 TTY 下会自动换格式，
|
||||
// 那样就锚不住结果行）。输出走管道，本进程负责原样转写到 stderr。
|
||||
const args = ['--test', '--test-reporter=tap', 'test/*.test.mjs'];
|
||||
const r = spawnSync(process.execPath, args, {
|
||||
encoding: 'utf8',
|
||||
env: process.env,
|
||||
maxBuffer: 256 * 1024 * 1024,
|
||||
});
|
||||
|
||||
if (r.error) {
|
||||
console.error(`[tap-dup] 起不了测试进程：${r.error.message}`);
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
const tap = r.stdout || '';
|
||||
process.stderr.write(tap);
|
||||
|
||||
// 环境不足（前置脚本那套约定的 2）原样透传 —— 这一层不替环境问题下结论。
|
||||
if (r.status === 2) {
|
||||
console.error('[tap-dup] 套件以 2 退出（环境问题），不据此判重名。');
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
const s = summaryOf(tap);
|
||||
if (s.tests === null) {
|
||||
console.error('[tap-dup] 拿不到 `# tests` 汇总 —— 套件没跑完（可能崩了）。');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const dups = findDuplicates(tap);
|
||||
const failed = (s.fail ?? 0) > 0 || r.status !== 0;
|
||||
|
||||
if (dups.length > 0) {
|
||||
console.error('\n[tap-dup] 有用例名在同一次运行里出现多次：');
|
||||
for (const d of dups) console.error(` ${d.count}× ${d.name}`);
|
||||
console.error(' 跨文件重名不会被 runner 拦下（按文件注册）⇒ 这多半是两个文件里有同名用例，');
|
||||
console.error(' 也可能是某个测试文件被二次注册（例如别的测试文件 import 了它）。');
|
||||
}
|
||||
|
||||
console.log(`\n# 结果行重复检查：${s.tests} 条结果，${dups.length} 个名字重复`);
|
||||
if (failed) {
|
||||
console.error(`[tap-dup] 套件红：pass ${s.pass} / fail ${s.fail}`);
|
||||
process.exit(1);
|
||||
}
|
||||
if (dups.length > 0) process.exit(1);
|
||||
console.log('[tap-dup] 套件全绿，且没有重名。');
|
||||
61
plugins/pi-mail-bridge/test/lib/session-fixtures.mjs
Normal file
61
plugins/pi-mail-bridge/test/lib/session-fixtures.mjs
Normal file
@ -0,0 +1,61 @@
|
||||
/**
|
||||
* 会话文件的测试夹具（**不是测试模块**）。
|
||||
*
|
||||
* # 一、为什么放在 `lib/` 而不是 `test/` 里
|
||||
*
|
||||
* `node --test` 默认**每个文件一个子进程**，但 `import` 是进程内的。所以
|
||||
* `env-guard.test.mjs` 里 `import { writeSession } from './session-scan.test.mjs'`
|
||||
* 会把**整个 `session-scan.test.mjs` 的用例在那个进程里再注册一遍** ——
|
||||
* 2026-09-14 实测确认：巨行用例（单条写 ~12 MiB）在 TAP 里出现**两次**
|
||||
* （`ok 87` 与 `ok 353`），也就是那条用例被跑了两次、往临时目录写了两次。
|
||||
* 这台机器的 `/tmp` 正是被这次事件的主角（tmpfs 满）—— 判据自己加倍压它是自伤。
|
||||
*
|
||||
* 这跟 `translateEnvError` 被抽到 `test/lib/env-error.mjs` 是同一个手法、同一个理由：
|
||||
* **可被别的模块引用，而不被注册进套件。**
|
||||
*
|
||||
* # 二、写点必须全部被兜住
|
||||
*
|
||||
* `session-scan.test.mjs` 的第一版只把 `writeFileSync` 包在 try 里，
|
||||
* 而 `mkdirSync` 在 try 之外 —— 目录建不出来时（ENOSPC 也可能从这里出来）
|
||||
* 抛的仍是原始英文堆栈。所以这里**整段**包一层，与 `selfCheck()` 那条同一个形状：
|
||||
* **覆盖范围不能取决于"我以为的入口/哪一行"**。
|
||||
*
|
||||
* ENOSPC 一律翻译成"环境不足"（`test/lib/env-error.mjs`）—— 不管套件是怎么被调起来的
|
||||
* （`npm test` 会先跑 `test/env-preflight.mjs`，但 `node --test 'test/*.test.mjs'`
|
||||
* 会绕过它，那就只剩这一道）。
|
||||
*/
|
||||
|
||||
import { mkdirSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
|
||||
import { translateEnvError } from './env-error.mjs';
|
||||
|
||||
/**
|
||||
* 写一条会话文件。`lines` 是 header 之后的行（对象，会被 JSON 化）。
|
||||
*
|
||||
* `write` 只为测试存在（默认 `writeFileSync`）：让"ENOSPC 被翻译"这件事
|
||||
* 能被**行为**判据验证 —— 喂一个必然 ENOSPC 的假写，而不是去 grep 源码文本
|
||||
* （注释里本来就有 "ENOSPC" 这个词，文本判据会被注释满足）。
|
||||
*
|
||||
* @param {string} root 根目录
|
||||
* @param {string} cwdSlug 该 cwd 的子目录名
|
||||
* @param {string} fileName 文件名
|
||||
* @param {object} header 会话 header
|
||||
* @param {object[]} lines 后续行
|
||||
* @param {(file: string, body: string) => void} [write] 写实现（测试用接缝）
|
||||
* @returns {string} 写出的文件路径
|
||||
*/
|
||||
export function writeSession(root, cwdSlug, fileName, header, lines = [], write = writeFileSync) {
|
||||
const dir = join(root, cwdSlug);
|
||||
const file = join(dir, fileName);
|
||||
const body = [JSON.stringify({ type: 'session', version: 3, ...header })]
|
||||
.concat(lines.map((l) => JSON.stringify(l)))
|
||||
.join('\n');
|
||||
try {
|
||||
mkdirSync(dir, { recursive: true });
|
||||
write(file, `${body}\n`);
|
||||
} catch (e) {
|
||||
throw translateEnvError(e).error;
|
||||
}
|
||||
return file;
|
||||
}
|
||||
94
plugins/pi-mail-bridge/test/lib/tmp-space.mjs
Normal file
94
plugins/pi-mail-bridge/test/lib/tmp-space.mjs
Normal file
@ -0,0 +1,94 @@
|
||||
/**
|
||||
* 临时目录空间：**测量与判据分开**。
|
||||
*
|
||||
* # 为什么要有这个东西
|
||||
*
|
||||
* 2026-09-14 实测（本机）：`/tmp` 是 tmpfs，9.8G 被占满，`bavail` 只剩
|
||||
* **0.70 MiB**（`statfs` 实读）。此时跑 `npm test` 会红一条
|
||||
* `★巨大的 message 行不进内存也不影响解析`，报 `ENOSPC`。
|
||||
*
|
||||
* 那条红**看起来像内存缺陷**（用例名里就写着"不进内存"，而它恰好是往临时目录
|
||||
* 写文件的用例）。下一次踩到的人会去读 `session-scan.mjs` 找内存 bug —— 找的是
|
||||
* 一个**不存在**的东西。环境不足伪装成断言失败，是这个文件存在的全部理由。
|
||||
*
|
||||
* # 判据的形状（与仓库既有约定一致）
|
||||
*
|
||||
* - 这里只有**纯函数**：喂进"还剩多少字节"，吐出"够不够"。测量在
|
||||
* `measureAvailBytes()`（同文件导出，因为它要能被喂"不存在的目录"做反面样本），
|
||||
* 纯函数才可被反面样本喂。
|
||||
* - **读不到不判红**：`availBytes` 为 `null`（`statfsSync` 抛错 / 平台不支持 /
|
||||
* `statfs.bsize` 为 0 ⇒ 测量层返回 `null`）时返回 `ok: true` 并注明"不据此判定"。
|
||||
* **不知道 ≠ 不对** —— 不确定就放行，否则会在不认识的文件系统上制造一条总在亮的
|
||||
* 红灯，而"总在亮的红灯"会被人学会忽略（`deploy/check-deploy-drift.mjs` 文件头骂过）。
|
||||
* - ★ 但**可用字节数为 0 不是"没测到"**，是"真的没有"：它必须判红。第一版把
|
||||
* `<= 0` 一并当"不知道"，于是 `bavail` 只剩 712 字节时前置自检放行、紧接着
|
||||
* 17 条用例 ENOSPC 全红 —— 守卫装在最该拦的时候放行，等于没装。
|
||||
* （2026-09-14 踩的；这条注释写错过一次，pi 读第一遍就误读成了"0 也算不知道"，
|
||||
* 所以这里把两个 case 分开写死。）
|
||||
*/
|
||||
|
||||
import { statfsSync } from 'node:fs';
|
||||
|
||||
/** 单条用例的最大临时写入量（实测）：`test/session-scan.test.mjs` 那条用例
|
||||
* 写 3 条 3 MiB 的行（两条巨行 + 一条正常行）⇒ 约 12 MiB。 */
|
||||
export const MEASURED_MAX_CASE_WRITE = 12 * 1024 * 1024;
|
||||
|
||||
/**
|
||||
* 前置自检要求的最小可用空间。
|
||||
*
|
||||
* 取"实测用例写入量 × 2 + 8 MiB 机动"＝ 32 MiB，**不是**总容量的百分比：
|
||||
* 百分比在 9.8G 的 tmpfs 上会给出一个和这套测试毫无关系的数，而这里要挡的是
|
||||
* "一条 12 MiB 的用例写不进去"。×2 是因为临时目录可能同时有别的写入方
|
||||
* （本机 `npm test` 之外还跑着 agent 的会话文件）。
|
||||
*/
|
||||
export const MIN_FREE_BYTES = MEASURED_MAX_CASE_WRITE * 2 + 8 * 1024 * 1024;
|
||||
|
||||
const mib = (n) => `${(n / 1048576).toFixed(1)} MiB`;
|
||||
|
||||
/**
|
||||
* 测量：进程**实际能写**的字节数。读不到返回 `null`。
|
||||
*
|
||||
* 放在这里（而不是 `test/env-preflight.mjs` 里）的唯一理由是**可被反面样本喂**：
|
||||
* `measureAvailBytes('/definitely/not/here')` 这条判据在任何机器上都跑得了，
|
||||
* 而"读不到 ⇒ null ⇒ 放行"这一支否则就没有不依赖机器状态的判据覆盖
|
||||
* —— 端到端那条一旦因 `/tmp` 被清空而跳过，就没人管这一支了。
|
||||
*
|
||||
* @param {string} dir 要量的目录，默认 `os.tmpdir()`
|
||||
* @returns {number|null} 可用字节数；读不到/不支持/`bsize` 为 0 ⇒ `null`
|
||||
*/
|
||||
export function measureAvailBytes(dir) {
|
||||
try {
|
||||
if (typeof statfsSync !== 'function') return null; // Node < 18.15
|
||||
if (typeof dir !== 'string' || dir === '') return null;
|
||||
const s = statfsSync(dir);
|
||||
if (!s || !s.bsize) return null; // bsize=0 ⇒ 量不出字节数
|
||||
// 用 `bavail`（非特权进程可用的块数），**不是** `bfree`（含 root 保留块）：
|
||||
// 这里回答的是"我写不写得进去"，不是"机器上空闲多少"。
|
||||
return s.bavail * s.bsize;
|
||||
} catch {
|
||||
return null; // 不知道 ≠ 不对
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param {{ availBytes: number|null, needBytes?: number }} args
|
||||
* `availBytes` 为 `null` 表示"没测到"（读不到、平台不支持、`bsize` 为 0）。
|
||||
* @returns {{ ok: boolean, known: boolean, note: string }}
|
||||
*/
|
||||
export function judgeSpace({ availBytes, needBytes = MIN_FREE_BYTES }) {
|
||||
// `null` / `NaN` 才是"没测到"。**注意 0 不是"没测到"** ——
|
||||
// `statfsSync` 说不出话时会抛（已在测量层转成 null），它若返回 0，
|
||||
// 意思就是"真的一点空间都没有"（实测踩过：把 `<= 0` 一并当"不知道"，
|
||||
// 于是 `bavail` 只剩 712 字节时前置自检放行，接着 17 条用例 ENOSPC 全红）。
|
||||
if (availBytes === null || availBytes === undefined || Number.isNaN(availBytes)) {
|
||||
return { ok: true, known: false, note: '没测到可用空间（读不到或平台不支持）—— 不据此判定' };
|
||||
}
|
||||
if (availBytes >= needBytes) {
|
||||
return { ok: true, known: true, note: `可用 ${mib(availBytes)} ≥ 需要 ${mib(needBytes)}` };
|
||||
}
|
||||
return {
|
||||
ok: false,
|
||||
known: true,
|
||||
note: `可用 ${mib(availBytes)} < 需要 ${mib(needBytes)}`,
|
||||
};
|
||||
}
|
||||
176
plugins/pi-mail-bridge/test/lib/user-question.js
Normal file
176
plugins/pi-mail-bridge/test/lib/user-question.js
Normal file
@ -0,0 +1,176 @@
|
||||
/**
|
||||
* `ask_user_question` ↔ AgentMail 询问邮件 的双向映射（纯函数）。
|
||||
*
|
||||
* # 为什么需要它
|
||||
*
|
||||
* DSH 的 `ask_user_question` 走 `ctx.userQuestions` 这个 UI seam，而邮件驱动的
|
||||
* 会话**没有本地 UI**。不桥接的后果是模型主动提问后永久挂死：`ask()` 的
|
||||
* promise 永远不 resolve，那一轮工具调用卡在那里，人却什么也看不到。
|
||||
*
|
||||
* # 两个模型的形状差异
|
||||
*
|
||||
* DSH：`{ questions: [{ id, question, header?, options?: [{label, description?}],
|
||||
* multiSelect? }] }` → `{ answers: [{ id, selected[], custom? }] }`
|
||||
* - 一次可以问**多个**问题，每个问题可有自己的选项与多选语义
|
||||
* - 答案按问题 id 回填，选项用 label 字符串
|
||||
*
|
||||
* AgentMail：一封询问邮件 = 一个问题 + 一个选项列表 + 一个 multi_select 标志
|
||||
* - 只有单问题结构，因此多问题时必须摊平
|
||||
*
|
||||
* # 摊平策略（多问题时）
|
||||
*
|
||||
* 选项取所有问题 label 的并集（去重、保持首次出现顺序），并把每个问题的
|
||||
* 原文、选项与说明枚举进 context 正文。回信时按「label 属于哪个问题」把
|
||||
* 选择分配回去。这比「一问一封邮件」简单得多 —— 后者要等人分别回复多封
|
||||
* 才能凑齐一次 `ask()` 的答案，而 `ask()` 是**单次**调用，凑不齐就还是挂死。
|
||||
*
|
||||
* # fail closed
|
||||
*
|
||||
* 认不出的答案一律不猜测；没有匹配到任何选项的问题返回空选择 + 把自由文本
|
||||
* 放进 custom，而不是随便挑一个 label 放行。
|
||||
*/
|
||||
|
||||
/** 问题是否带可选项。 */
|
||||
export function hasOptions(question) {
|
||||
return Array.isArray(question?.options) && question.options.length > 0;
|
||||
}
|
||||
|
||||
/** 一个 DSH 问题的可选项 label 列表（保序）。 */
|
||||
export function optionLabels(question) {
|
||||
if (!hasOptions(question)) return [];
|
||||
return question.options
|
||||
.map((o) => (typeof o === 'string' ? o : o?.label))
|
||||
.filter((l) => typeof l === 'string' && l.length > 0);
|
||||
}
|
||||
|
||||
/** 一个问题的展示标题：header 有就用它做前缀，否则只用 question。 */
|
||||
export function questionTitle(question) {
|
||||
const header = typeof question?.header === 'string' ? question.header.trim() : '';
|
||||
const text = typeof question?.question === 'string' ? question.question.trim() : '';
|
||||
if (header && text) return `${header}: ${text}`;
|
||||
return header || text || '(未提供问题)';
|
||||
}
|
||||
|
||||
/**
|
||||
* 把 DSH 的 questions 摊平成一封 AgentMail 询问邮件的正文与元数据。
|
||||
*
|
||||
* @param {Array<object>} questions DSH AskUserQuestionItem[]
|
||||
* @returns {{ question: string, options: string[], context: string, multiSelect: boolean }}
|
||||
*/
|
||||
export function flattenQuestions(questions) {
|
||||
const list = Array.isArray(questions) ? questions.filter(Boolean) : [];
|
||||
if (list.length === 0) {
|
||||
throw new Error('ask_user_question 至少需要一个 question');
|
||||
}
|
||||
|
||||
const lines = [];
|
||||
const options = [];
|
||||
const seen = new Set();
|
||||
let anyMulti = false;
|
||||
|
||||
list.forEach((q, i) => {
|
||||
const title = questionTitle(q);
|
||||
lines.push(`${i + 1}. ${title}`);
|
||||
const detail = typeof q?.detail === 'string' ? q.detail.trim() : '';
|
||||
if (detail) lines.push(` ${detail}`);
|
||||
|
||||
const labels = optionLabels(q);
|
||||
if (labels.length > 0) {
|
||||
lines.push(` 可选项：${labels.join(' / ')}${q.multiSelect ? '（可多选）' : ''}`);
|
||||
for (const label of labels) {
|
||||
if (!seen.has(label)) {
|
||||
seen.add(label);
|
||||
options.push(label);
|
||||
}
|
||||
}
|
||||
} else {
|
||||
lines.push(' （请直接填写回答）');
|
||||
}
|
||||
if (q?.multiSelect === true) anyMulti = true;
|
||||
});
|
||||
|
||||
// 多问题时必须允许多选：不同问题的选项要能一起勾选。
|
||||
const multiSelect = list.length > 1 ? options.length > 0 : anyMulti;
|
||||
|
||||
const question = list.length === 1 ? questionTitle(list[0]) : `${list.length} 个问题待回答`;
|
||||
const context = [
|
||||
list.length === 1 ? '' : '模型提出了多个问题，请在「回复」里一并回答：',
|
||||
...lines,
|
||||
'',
|
||||
options.length > 0
|
||||
? '可直接勾选下方的选项；补充说明写在备注里。'
|
||||
: '这题没有预设选项，请把回答写在备注里。',
|
||||
].filter((l) => l !== '').join('\n');
|
||||
|
||||
return { question, options, context, multiSelect };
|
||||
}
|
||||
|
||||
/**
|
||||
* 把人类的决策回写成 DSH 的 answers[]。
|
||||
*
|
||||
* @param {Array<object>} questions 原始 DSH questions（回填 id 用）
|
||||
* @param {string} decision 人类选的选项原文（多选时前端用换行分隔）
|
||||
* @param {string} [note] 自由文本/备注
|
||||
* @returns {{ answers: Array<{id: string, selected: string[], custom?: string}> }}
|
||||
*/
|
||||
export function answersFromDecision(questions, decision, note) {
|
||||
const list = Array.isArray(questions) ? questions.filter(Boolean) : [];
|
||||
const labels = String(decision || '')
|
||||
.split('\n')
|
||||
.map((s) => s.trim())
|
||||
.filter(Boolean);
|
||||
const custom = typeof note === 'string' ? note.trim() : '';
|
||||
|
||||
// 单问题：忠实映射（选项 → selected，备注 → custom）。
|
||||
if (list.length === 1) {
|
||||
const q = list[0];
|
||||
const id = String(q?.id ?? '0');
|
||||
if (!hasOptions(q)) {
|
||||
// 无选项题：人类把答案写在决策文本或备注里，都属于「自由文本回答」。
|
||||
const text = custom || labels.join('\n');
|
||||
return { answers: [{ id, selected: [], ...(text ? { custom: text } : {}) }] };
|
||||
}
|
||||
return {
|
||||
answers: [{
|
||||
id,
|
||||
selected: labels,
|
||||
...(custom ? { custom } : {}),
|
||||
}],
|
||||
};
|
||||
}
|
||||
|
||||
// 多问题：按 label 归属把选择分配给各自的问题；备注归给第一个问题。
|
||||
let customUsed = false;
|
||||
const answers = list.map((q, i) => {
|
||||
const id = String(q?.id ?? String(i));
|
||||
const labels_q = optionLabels(q);
|
||||
const selected = labels.filter((l) => labels_q.includes(l));
|
||||
let qCustom;
|
||||
if (custom && !customUsed) {
|
||||
qCustom = custom;
|
||||
customUsed = true;
|
||||
}
|
||||
// 无选项题且人没写备注：退而把决策文本整段给它（否则它的答案永远是空的）。
|
||||
if (qCustom === undefined && !hasOptions(q) && note === undefined) {
|
||||
const text = labels.join('\n');
|
||||
if (text) qCustom = text;
|
||||
}
|
||||
return { id, selected, ...(qCustom ? { custom: qCustom } : {}) };
|
||||
});
|
||||
|
||||
return { answers };
|
||||
}
|
||||
|
||||
/**
|
||||
* 决策是否「什么都没答」——用来在提交前拦住空回答（不把空答案喂给模型）。
|
||||
*
|
||||
* 允许多选时空 selected 但有 custom 也算答了；两者都空才算没答。
|
||||
*/
|
||||
export function isBlankAnswer(questions, decision, note) {
|
||||
const labels = String(decision || '').split('\n').map((s) => s.trim()).filter(Boolean);
|
||||
const custom = typeof note === 'string' ? note.trim() : '';
|
||||
if (labels.length > 0 || custom) return false;
|
||||
// 全部问题都没有选项、人也没写字 → 确实什么都没答
|
||||
const list = Array.isArray(questions) ? questions.filter(Boolean) : [];
|
||||
return list.some((q) => hasOptions(q)) || list.length === 0;
|
||||
}
|
||||
Reference in New Issue
Block a user