@hugesb/dsh-stream-agent 0.0.0-stage → 0.3.2
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/CHANGELOG.md +622 -0
- package/CONTRIBUTING.md +72 -0
- package/LICENSE +202 -0
- package/README.en.md +349 -0
- package/README.md +300 -3
- package/cordis.patch.yml +77 -0
- package/dist/entry/action-gate.js +206 -0
- package/dist/entry/adapter-kit.js +192 -0
- package/dist/entry/context-render.js +119 -0
- package/dist/entry/control-bar-cli.js +289 -0
- package/dist/entry/control-bar.js +123 -0
- package/dist/entry/control-session.js +115 -0
- package/dist/entry/control-state.js +125 -0
- package/dist/entry/cordis-compat.js +95 -0
- package/dist/entry/eval-probe.js +112 -0
- package/dist/entry/intent-log.js +121 -0
- package/dist/entry/json-persistence.js +306 -0
- package/dist/entry/loop.js +4163 -0
- package/dist/entry/mock-provider.js +549 -0
- package/dist/entry/obs-broker.js +178 -0
- package/dist/entry/ptc-bridge.js +405 -0
- package/dist/entry/state-handle.js +217 -0
- package/dist/entry/takeover-registry.js +60 -0
- package/dist/kernel/control-bar.js +559 -0
- package/dist/kernel/final.js +62 -0
- package/dist/kernel/gate.js +464 -0
- package/dist/kernel/modes.js +253 -0
- package/dist/kernel/obs.js +517 -0
- package/dist/kernel/parser.js +1081 -0
- package/dist/kernel/render.js +466 -0
- package/dist/kernel/state.js +416 -0
- package/dist/version.js +9 -0
- package/docs/TEST-PROPOSITIONS.md +139 -0
- package/docs/adr-001-segment-boundary.md +61 -0
- package/docs/architecture.md +104 -0
- package/docs/desktop-ui-feasibility.md +277 -0
- package/docs/disabled-lines-audit.md +53 -0
- package/docs/limitations.md +181 -0
- package/docs/protocol.md +99 -0
- package/docs/v0.4.0-plan.md +50 -0
- package/eval/METRICS.md +128 -0
- package/eval/RESULTS.md +246 -0
- package/eval/tasks/fixtures/big-report.md +298 -0
- package/eval/tasks/fixtures/build-manifest.txt +5 -0
- package/eval/tasks/fixtures/deploy.yaml +4 -0
- package/eval/tasks/fixtures/error.log +200 -0
- package/eval/tasks/fixtures/features.yaml +4 -0
- package/eval/tasks/fixtures/pipeline.yaml +4 -0
- package/eval/tasks/fixtures/sales-q1.csv +61 -0
- package/eval/tasks/fixtures/settings.yaml +4 -0
- package/eval/tasks/fixtures/users-roster.json +304 -0
- package/eval/tasks/fixtures/users-scores.json +20 -0
- package/eval/tasks/gen-fixtures.cjs +80 -0
- package/eval/tasks/tasks.json +150 -0
- package/eval/tools/f6-kill-drill.cjs +176 -0
- package/eval/tools/f6-kill-drill.worker.cjs +131 -0
- package/eval/tools/gen-results.cjs +191 -0
- package/eval/tools/machine-test.cjs +200 -0
- package/eval/tools/manual-code-scenarios.md +59 -0
- package/eval/tools/replay-check.cjs +311 -0
- package/eval/tools/runner.cjs +219 -0
- package/eval/tools/session-log.cjs +106 -0
- package/eval/tools/summarize.cjs +185 -0
- package/eval/tools/t3-cells.cjs +173 -0
- package/package.json +73 -6
- package/patches/adapters-smoke.yml +41 -0
- package/patches/eval-account.yml +36 -0
- package/patches/eval-baseline.yml +33 -0
- package/patches/eval-stream-code-off.yml +46 -0
- package/patches/eval-stream-code-on.yml +47 -0
- package/patches/eval-stream.yml +54 -0
- package/patches/takeover.yml +42 -0
- package/patches/test-preset.yml +23 -0
- package/preset/stream/cordis.patch.yml +39 -0
- package/preset/stream/package.json +13 -0
- package/preset.yml +56 -0
- package/profiles/stream/README.md +66 -0
- package/profiles/stream/cordis.patch.yml +12 -0
- package/profiles/stream/package.json +17 -0
- package/profiles/stream-headless/package.json +16 -0
- package/scripts/build.mjs +103 -0
- package/scripts/check-consistency.mjs +146 -0
- package/scripts/gate.mjs +138 -0
- package/scripts/install-check.mjs +116 -0
- package/scripts/install-cycle.mjs +88 -0
- package/scripts/release.mjs +428 -0
- package/scripts/repair-session-logs.mjs +498 -0
- package/src/entry/action-gate.ts +206 -0
- package/src/entry/adapter-kit.ts +192 -0
- package/src/entry/context-render.ts +119 -0
- package/src/entry/control-bar-cli.ts +289 -0
- package/src/entry/control-bar.ts +123 -0
- package/src/entry/control-session.ts +115 -0
- package/src/entry/control-state.ts +125 -0
- package/src/entry/cordis-compat.ts +95 -0
- package/src/entry/eval-probe.ts +112 -0
- package/src/entry/intent-log.ts +121 -0
- package/src/entry/json-persistence.ts +306 -0
- package/src/entry/loop.ts +4163 -0
- package/src/entry/mock-provider.ts +549 -0
- package/src/entry/obs-broker.ts +178 -0
- package/src/entry/ptc-bridge.ts +405 -0
- package/src/entry/state-handle.ts +217 -0
- package/src/entry/takeover-registry.ts +60 -0
- package/src/kernel/control-bar.ts +559 -0
- package/src/kernel/final.ts +62 -0
- package/src/kernel/gate.ts +464 -0
- package/src/kernel/modes.ts +253 -0
- package/src/kernel/obs.ts +517 -0
- package/src/kernel/parser.ts +1081 -0
- package/src/kernel/render.ts +466 -0
- package/src/kernel/state.ts +416 -0
- package/src/version.ts +9 -0
- package/test/activation.test.ts +187 -0
- package/test/adapters.test.ts +676 -0
- package/test/control-bar.test.ts +486 -0
- package/test/desktop-ui.test.ts +359 -0
- package/test/eval-probe.test.ts +139 -0
- package/test/f5-plan.test.ts +221 -0
- package/test/f6-intent.test.ts +168 -0
- package/test/f7-segment.test.ts +190 -0
- package/test/fix-limits.test.ts +599 -0
- package/test/gate.test.ts +380 -0
- package/test/helpers/stub-loop.ts +240 -0
- package/test/host-conformance.test.ts +418 -0
- package/test/kernel/obs.test.ts +329 -0
- package/test/kernel/parser.test.ts +451 -0
- package/test/loop.test.ts +1393 -0
- package/test/mock-provider.test.ts +386 -0
- package/test/ptc-bridge.test.ts +356 -0
- package/test/render.test.ts +418 -0
- package/test/s2-install-check.test.ts +46 -0
- package/test/scenarios/3-file-basic.json +13 -0
- package/test/scenarios/5-file-basic.json +22 -0
- package/test/scenarios/burn-more.json +9 -0
- package/test/scenarios/degraded-final.json +10 -0
- package/test/scenarios/fault-abort-xml.json +11 -0
- package/test/scenarios/fault-malformed-command.json +12 -0
- package/test/scenarios/fault-midstream-abort.json +11 -0
- package/test/scenarios/fault-saturating-output.json +9 -0
- package/test/scenarios/fault-timeout.json +9 -0
- package/test/scenarios/peek-first.json +11 -0
- package/test/scenarios/peek-second.json +11 -0
- package/test/scenarios/peek-third.json +10 -0
- package/test/scenarios/recover-final.json +10 -0
- package/test/scenarios/reroute-first.json +17 -0
- package/test/scenarios/reroute-second.json +16 -0
- package/test/scenarios/starvation-final.json +10 -0
- package/test/scenarios/starvation-promote.json +11 -0
- package/test/scenarios/wait-tools-continue.json +10 -0
- package/test/scenarios/wait-tools-xml.json +22 -0
- package/test/scenarios/wait-tools.json +15 -0
- package/test/session-format.test.ts +234 -0
- package/test/state.test.ts +335 -0
- package/test/stream-v02.test.ts +264 -0
- package/test/v031-display.test.ts +333 -0
- package/test/v032-conflict.test.ts +191 -0
- package/test/v032-truncation.test.ts +291 -0
- package/ui/client.js +576 -0
- package/ui/index.js +282 -0
- package/ui/package.json +26 -0
|
@@ -0,0 +1,486 @@
|
|
|
1
|
+
// test/control-bar.test.ts —— 控制栏(v0.2.1)
|
|
2
|
+
//
|
|
3
|
+
// 验收口径:
|
|
4
|
+
// · 四个模式全部有中英双语字段,且 en 里不允许出现中文、zh 里必须有中文(防"翻译漏了");
|
|
5
|
+
// · 面板/引导/帮助在 56-92 列下每一行的显示宽度完全一致(盒子不错位);
|
|
6
|
+
// · 结构字符只用 ASCII(· → ↑↓ … 这类东亚宽度不确定字符会让中英终端错位);
|
|
7
|
+
// · 按键语义:1-4 选模式、Up/Down 移动、Enter 应用、l 切语言、r 重置、? 帮助、q 退出;
|
|
8
|
+
// · 状态落盘:读写往返、坏文件回默认且告警、env 覆盖、装配显式配置最高优先。
|
|
9
|
+
|
|
10
|
+
import test from 'node:test';
|
|
11
|
+
import assert from 'node:assert/strict';
|
|
12
|
+
import { mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
|
|
13
|
+
import { tmpdir } from 'node:os';
|
|
14
|
+
import { join } from 'node:path';
|
|
15
|
+
|
|
16
|
+
import {
|
|
17
|
+
AVAILABILITY_TEXT,
|
|
18
|
+
DEFAULT_MODE,
|
|
19
|
+
MODES,
|
|
20
|
+
SAVING_TEXT,
|
|
21
|
+
getMode,
|
|
22
|
+
isModeId,
|
|
23
|
+
modeByOrder,
|
|
24
|
+
modeConfig,
|
|
25
|
+
publicModeCatalog,
|
|
26
|
+
} from '../src/kernel/modes.ts';
|
|
27
|
+
import {
|
|
28
|
+
DEFAULT_LANG,
|
|
29
|
+
createControlState,
|
|
30
|
+
displayWidth,
|
|
31
|
+
interpretKey,
|
|
32
|
+
isLang,
|
|
33
|
+
modeSummary,
|
|
34
|
+
moveFocus,
|
|
35
|
+
otherLang,
|
|
36
|
+
panelWidth,
|
|
37
|
+
renderBanner,
|
|
38
|
+
renderHelp,
|
|
39
|
+
renderJson,
|
|
40
|
+
renderPanel,
|
|
41
|
+
renderStatusBar,
|
|
42
|
+
t,
|
|
43
|
+
textKeys,
|
|
44
|
+
truncate,
|
|
45
|
+
wrapText,
|
|
46
|
+
} from '../src/kernel/control-bar.ts';
|
|
47
|
+
import { controlFileOf, readPersistedControl, resolveControlState, writePersistedControl } from '../src/entry/control-state.ts';
|
|
48
|
+
import { ControlSession } from '../src/entry/control-session.ts';
|
|
49
|
+
import { splitKeys } from '../src/entry/control-bar-cli.ts';
|
|
50
|
+
import { VERSION } from '../src/version.ts';
|
|
51
|
+
|
|
52
|
+
const V = { version: VERSION, columns: 80 };
|
|
53
|
+
|
|
54
|
+
function uniformWidth(lines: readonly string[]): boolean {
|
|
55
|
+
const widths = new Set(lines.map((line) => displayWidth(line)));
|
|
56
|
+
return widths.size === 1;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
test('模式目录:四个模式,id 与序号唯一,默认模式在目录里', () => {
|
|
60
|
+
assert.equal(MODES.length, 4);
|
|
61
|
+
assert.equal(new Set(MODES.map((m) => m.id)).size, 4);
|
|
62
|
+
assert.deepEqual(MODES.map((m) => m.order), [1, 2, 3, 4]);
|
|
63
|
+
assert.ok(isModeId(DEFAULT_MODE));
|
|
64
|
+
assert.equal(modeByOrder(2)?.id, 'lean');
|
|
65
|
+
assert.equal(modeByOrder(9), undefined);
|
|
66
|
+
assert.equal(isModeId('nope'), false);
|
|
67
|
+
assert.equal(getMode('nope').id, DEFAULT_MODE, '未知模式回落到默认');
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
test('模式双语:每一条面向用户的文案两种语言都有,且语言不串味', () => {
|
|
71
|
+
const hasCjk = (s: string): boolean => /[\u4e00-\u9fff]/.test(s);
|
|
72
|
+
const hasLatin = (s: string): boolean => /[A-Za-z]/.test(s);
|
|
73
|
+
for (const mode of MODES) {
|
|
74
|
+
for (const field of ['label', 'tagline', 'useWhen', 'tradeoff'] as const) {
|
|
75
|
+
const zh = mode[field].zh;
|
|
76
|
+
const en = mode[field].en;
|
|
77
|
+
assert.ok(zh.trim() !== '' && en.trim() !== '', `${mode.id}.${field} 两种语言都不能为空`);
|
|
78
|
+
assert.ok(hasCjk(zh), `${mode.id}.${field}.zh 必须包含中文`);
|
|
79
|
+
assert.equal(hasCjk(en), false, `${mode.id}.${field}.en 不允许混入中文:${en}`);
|
|
80
|
+
if (field === 'useWhen' || field === 'tradeoff') assert.ok(hasLatin(en), `${mode.id}.${field}.en 必须可读`);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
});
|
|
84
|
+
|
|
85
|
+
test('模式只映射既有配置项:默认模式与 0.3.0 出厂默认等价(K1:tf-code 默认关闭)', () => {
|
|
86
|
+
const balanced = modeConfig('balanced');
|
|
87
|
+
assert.equal(balanced.selfReadFeedback, 'receipt');
|
|
88
|
+
assert.equal(balanced.enableCode, false, 'K1(0.3.0):balanced 不再自动开 tf-code,协议段默认 0 字符');
|
|
89
|
+
assert.equal(balanced.persistFallback, true);
|
|
90
|
+
assert.equal(balanced.maxParallelToolCalls, 3);
|
|
91
|
+
assert.equal(balanced.maxReentries, 8);
|
|
92
|
+
assert.equal(balanced.budgetTokens, undefined);
|
|
93
|
+
|
|
94
|
+
const lean = modeConfig('lean');
|
|
95
|
+
assert.ok((lean.budgetTokens ?? 0) > 0, 'lean 必须真的更省:预算阶梯要能触发');
|
|
96
|
+
assert.equal(lean.enableCode, false);
|
|
97
|
+
|
|
98
|
+
const compat = modeConfig('compat');
|
|
99
|
+
assert.equal(compat.selfReadFeedback, 'full', 'compat 恢复全文回灌');
|
|
100
|
+
assert.equal(compat.maxParallelToolCalls, 1, 'compat 串行执行,便于对照');
|
|
101
|
+
|
|
102
|
+
const power = modeConfig('power');
|
|
103
|
+
assert.equal(power.enableCode, true, 'power 显式开启 tf-code');
|
|
104
|
+
|
|
105
|
+
// 返回副本:调用方改它不得污染目录
|
|
106
|
+
lean.maxReentries = 99;
|
|
107
|
+
assert.notEqual(modeConfig('lean').maxReentries, 99);
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
test('文案表:每个 key 中英都非空(结构性一致)', () => {
|
|
111
|
+
for (const key of textKeys()) {
|
|
112
|
+
const zh = t(key, 'zh');
|
|
113
|
+
const en = t(key, 'en');
|
|
114
|
+
assert.ok(zh.trim() !== '', `${key}.zh 为空`);
|
|
115
|
+
assert.ok(en.trim() !== '', `${key}.en 为空`);
|
|
116
|
+
assert.equal(/[\u4e00-\u9fff]/.test(en), false, `${key}.en 混入中文:${en}`);
|
|
117
|
+
}
|
|
118
|
+
});
|
|
119
|
+
|
|
120
|
+
test('渲染:面板 / 引导 / 帮助在 56-92 列下每行等宽(盒子不错位)', () => {
|
|
121
|
+
for (const columns of [56, 60, 72, 80, 100, 120]) {
|
|
122
|
+
for (const lang of ['zh', 'en'] as const) {
|
|
123
|
+
for (const mode of ['balanced', 'lean', 'compat', 'power'] as const) {
|
|
124
|
+
const state = createControlState({ mode, lang });
|
|
125
|
+
const panel = renderPanel(state, { version: VERSION, columns });
|
|
126
|
+
const banner = renderBanner(state, { version: VERSION, columns });
|
|
127
|
+
const help = renderHelp(state, { version: VERSION, columns });
|
|
128
|
+
assert.ok(uniformWidth(panel), `panel 行宽不一致 lang=${lang} mode=${mode} columns=${columns}`);
|
|
129
|
+
assert.ok(uniformWidth(banner), `banner 行宽不一致 lang=${lang} mode=${mode} columns=${columns}`);
|
|
130
|
+
assert.ok(uniformWidth(help), `help 行宽不一致 lang=${lang} mode=${mode} columns=${columns}`);
|
|
131
|
+
assert.ok(panel.length > 8 && banner.length > 8 && help.length > 12);
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
});
|
|
136
|
+
|
|
137
|
+
test('渲染:不出现东亚宽度不确定字符(· → ↑↓ … ①),结构只用 ASCII', () => {
|
|
138
|
+
const banned = /[·→↑↓…①②③④]/;
|
|
139
|
+
for (const lang of ['zh', 'en'] as const) {
|
|
140
|
+
const state = createControlState({ lang });
|
|
141
|
+
const text = [
|
|
142
|
+
...renderPanel(state, { version: VERSION }),
|
|
143
|
+
...renderBanner(state, { version: VERSION }),
|
|
144
|
+
...renderHelp(state, { version: VERSION }),
|
|
145
|
+
renderStatusBar(state, { version: VERSION }),
|
|
146
|
+
].join('\n');
|
|
147
|
+
assert.equal(banned.test(text), false, `渲染里出现了歧义宽度字符:${text.match(banned)?.[0]}`);
|
|
148
|
+
}
|
|
149
|
+
});
|
|
150
|
+
|
|
151
|
+
test('渲染:中英切换后语言标记与文案都跟着变,模式信息保持不变', () => {
|
|
152
|
+
const zh = createControlState({ mode: 'lean', lang: 'zh' });
|
|
153
|
+
const en = createControlState({ mode: 'lean', lang: 'en' });
|
|
154
|
+
const zhText = renderPanel(zh, { version: VERSION }).join('\n');
|
|
155
|
+
const enText = renderPanel(en, { version: VERSION }).join('\n');
|
|
156
|
+
|
|
157
|
+
assert.ok(zhText.includes('精简') && zhText.includes('语言: zh'));
|
|
158
|
+
assert.ok(enText.includes('Lean') && enText.includes('Language: en'));
|
|
159
|
+
assert.equal(/[\u4e00-\u9fff]/.test(enText.replace(/#[\w-]+/g, '')), false, 'en 面板不允许残留中文');
|
|
160
|
+
assert.ok(zhText.includes('并行 2') && enText.includes('parallel 2'), '模式参数不随语言变化');
|
|
161
|
+
assert.equal(modeSummary(getMode('lean'), 'zh').includes('预算'), true);
|
|
162
|
+
assert.equal(modeSummary(getMode('lean'), 'en').includes('budget'), true);
|
|
163
|
+
});
|
|
164
|
+
|
|
165
|
+
test('渲染:状态条是单行且不超过面板宽度', () => {
|
|
166
|
+
for (const lang of ['zh', 'en'] as const) {
|
|
167
|
+
const state = createControlState({ lang });
|
|
168
|
+
const line = renderStatusBar(state, { version: VERSION, columns: 60 });
|
|
169
|
+
assert.equal(line.includes('\n'), false);
|
|
170
|
+
assert.ok(displayWidth(line) <= panelWidth(60), `状态条超宽:${displayWidth(line)}`);
|
|
171
|
+
assert.ok(line.includes(VERSION));
|
|
172
|
+
}
|
|
173
|
+
});
|
|
174
|
+
|
|
175
|
+
test('模式目录:四个模式都标了省 token 档位与可用性,默认模式只有一个', () => {
|
|
176
|
+
const savings = new Set(['most', 'more', 'baseline', 'least']);
|
|
177
|
+
const availabilities = new Set(['default', 'ready', 'needs-ptc']);
|
|
178
|
+
|
|
179
|
+
for (const mode of MODES) {
|
|
180
|
+
assert.ok(savings.has(mode.saving), `${mode.id}.saving 取值非法:${mode.saving}`);
|
|
181
|
+
assert.ok(availabilities.has(mode.availability), `${mode.id}.availability 取值非法:${mode.availability}`);
|
|
182
|
+
for (const lang of ['zh', 'en'] as const) {
|
|
183
|
+
assert.ok(SAVING_TEXT[mode.saving][lang].trim() !== '', `${mode.id} 缺 ${lang} 省 token 文案`);
|
|
184
|
+
assert.ok(AVAILABILITY_TEXT[mode.availability][lang].trim() !== '', `${mode.id} 缺 ${lang} 可用性文案`);
|
|
185
|
+
assert.ok(mode.note[lang].trim().length >= 20, `${mode.id}.note.${lang} 太短,讲不清口径`);
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
// 默认模式必须且只能标一个 default,否则"装好即用"这句话就自相矛盾。
|
|
190
|
+
assert.deepEqual(MODES.filter((m) => m.availability === 'default').map((m) => m.id), [DEFAULT_MODE]);
|
|
191
|
+
// 四张卡的标注不能全一样,否则这列没有信息量。
|
|
192
|
+
assert.ok(new Set(MODES.map((m) => m.saving)).size >= 3, '省 token 档位区分度不足');
|
|
193
|
+
assert.ok(new Set(MODES.map((m) => m.availability)).size >= 2, '可用性区分度不足');
|
|
194
|
+
});
|
|
195
|
+
|
|
196
|
+
test('模式目录:对外投影一次生成,CLI --json 与桌面路由共用同一份字段', () => {
|
|
197
|
+
const catalog = publicModeCatalog();
|
|
198
|
+
assert.equal(catalog.length, 4);
|
|
199
|
+
for (const mode of catalog) {
|
|
200
|
+
assert.ok(mode.savingLabel.zh && mode.savingLabel.en, `${mode.id} 缺省 token 标签`);
|
|
201
|
+
assert.ok(mode.availabilityLabel.zh && mode.availabilityLabel.en, `${mode.id} 缺可用性标签`);
|
|
202
|
+
assert.ok(mode.note.zh && mode.note.en, `${mode.id} 缺标注`);
|
|
203
|
+
assert.equal((mode as Record<string, unknown>).config, undefined, '投影不应把 config 发到网络上');
|
|
204
|
+
}
|
|
205
|
+
const parsed = JSON.parse(renderJson(createControlState({ mode: 'power', lang: 'zh' }), { version: VERSION }));
|
|
206
|
+
assert.deepEqual(parsed.modes, catalog);
|
|
207
|
+
});
|
|
208
|
+
|
|
209
|
+
test('渲染:帮助页逐模式带"省多少 / 能不能用",面板展开当前模式的标注全文', () => {
|
|
210
|
+
for (const lang of ['zh', 'en'] as const) {
|
|
211
|
+
const state = createControlState({ mode: 'power', lang });
|
|
212
|
+
const help = renderHelp(state, { version: VERSION }).join('\n');
|
|
213
|
+
for (const mode of MODES) {
|
|
214
|
+
assert.ok(
|
|
215
|
+
help.includes(SAVING_TEXT[mode.saving][lang]),
|
|
216
|
+
`${lang} 帮助页缺 ${mode.id} 的省 token 标注`,
|
|
217
|
+
);
|
|
218
|
+
}
|
|
219
|
+
assert.ok(help.includes(AVAILABILITY_TEXT['needs-ptc'][lang]), `${lang} 帮助页缺 PTC 前提标注`);
|
|
220
|
+
|
|
221
|
+
const panel = renderPanel(state, { version: VERSION }).join('\n');
|
|
222
|
+
const flat = panel.replace(/\s+/g, ' ');
|
|
223
|
+
assert.ok(flat.includes(t('saving', lang)), `${lang} 面板缺"省 token"标签`);
|
|
224
|
+
assert.ok(flat.includes(SAVING_TEXT[getMode('power').saving][lang]), `${lang} 面板缺当前模式档位`);
|
|
225
|
+
assert.ok(flat.includes(AVAILABILITY_TEXT['needs-ptc'][lang]), `${lang} 面板缺可用性`);
|
|
226
|
+
const noteHead = getMode('power').note[lang].replace(/\s+/g, ' ').slice(0, 16);
|
|
227
|
+
assert.ok(flat.includes(noteHead), `${lang} 面板缺标注全文`);
|
|
228
|
+
}
|
|
229
|
+
});
|
|
230
|
+
|
|
231
|
+
test('渲染:--json 结构稳定,含四个模式与当前配置', () => {
|
|
232
|
+
const parsed = JSON.parse(renderJson(createControlState({ mode: 'power', lang: 'en' }), { version: VERSION })) as {
|
|
233
|
+
version: string; active: boolean; mode: { id: string; config: { enableCode: boolean } }; lang: string; modes: unknown[];
|
|
234
|
+
};
|
|
235
|
+
assert.equal(parsed.version, VERSION);
|
|
236
|
+
assert.equal(parsed.active, true);
|
|
237
|
+
assert.equal(parsed.mode.id, 'power');
|
|
238
|
+
assert.equal(parsed.mode.config.enableCode, true);
|
|
239
|
+
assert.equal(parsed.lang, 'en');
|
|
240
|
+
assert.equal(parsed.modes.length, 4);
|
|
241
|
+
});
|
|
242
|
+
|
|
243
|
+
test('按键:1-4 / Up Down / Enter / l / r / ? / q 各自映射到正确意图', () => {
|
|
244
|
+
assert.deepEqual(interpretKey('1'), { kind: 'select', mode: 'balanced' });
|
|
245
|
+
assert.deepEqual(interpretKey('3'), { kind: 'select', mode: 'compat' });
|
|
246
|
+
assert.deepEqual(interpretKey('\x1b[A'), { kind: 'move', delta: -1 });
|
|
247
|
+
assert.deepEqual(interpretKey('\x1b[B'), { kind: 'move', delta: 1 });
|
|
248
|
+
assert.deepEqual(interpretKey('k'), { kind: 'move', delta: -1 });
|
|
249
|
+
assert.deepEqual(interpretKey('j'), { kind: 'move', delta: 1 });
|
|
250
|
+
assert.deepEqual(interpretKey('\r'), { kind: 'apply' });
|
|
251
|
+
assert.deepEqual(interpretKey('\n'), { kind: 'apply' });
|
|
252
|
+
assert.deepEqual(interpretKey('l'), { kind: 'toggle-lang' });
|
|
253
|
+
assert.deepEqual(interpretKey('r'), { kind: 'reset' });
|
|
254
|
+
assert.deepEqual(interpretKey('?'), { kind: 'toggle-help' });
|
|
255
|
+
assert.deepEqual(interpretKey('q'), { kind: 'quit' });
|
|
256
|
+
assert.deepEqual(interpretKey('q', { helpOpen: true }), { kind: 'close-help' }, '帮助页里 q 是返回');
|
|
257
|
+
assert.deepEqual(interpretKey('9'), { kind: 'none' });
|
|
258
|
+
assert.deepEqual(interpretKey('z'), { kind: 'none' });
|
|
259
|
+
});
|
|
260
|
+
|
|
261
|
+
test('焦点移动:环状前进/后退,未知焦点从第一个开始', () => {
|
|
262
|
+
assert.equal(moveFocus('balanced', 1), 'lean');
|
|
263
|
+
assert.equal(moveFocus('power', 1), 'balanced');
|
|
264
|
+
assert.equal(moveFocus('balanced', -1), 'power');
|
|
265
|
+
assert.equal(moveFocus('power', -1), 'compat');
|
|
266
|
+
});
|
|
267
|
+
|
|
268
|
+
test('语言工具:otherLang / isLang / 默认值', () => {
|
|
269
|
+
assert.equal(otherLang('zh'), 'en');
|
|
270
|
+
assert.equal(otherLang('en'), 'zh');
|
|
271
|
+
assert.equal(isLang('zh'), true);
|
|
272
|
+
assert.equal(isLang('jp'), false);
|
|
273
|
+
assert.equal(createControlState().lang, DEFAULT_LANG);
|
|
274
|
+
assert.equal(createControlState({ mode: 'bad', lang: 'bad' }).mode, DEFAULT_MODE);
|
|
275
|
+
});
|
|
276
|
+
|
|
277
|
+
test('文本工具:truncate 与 wrapText 按显示列宽工作(CJK 记 2 列)', () => {
|
|
278
|
+
assert.equal(displayWidth('中文'), 4);
|
|
279
|
+
assert.equal(displayWidth('abc'), 3);
|
|
280
|
+
assert.equal(truncate('abcdef', 4), 'a...');
|
|
281
|
+
assert.equal(truncate('中文中文', 5), '中...');
|
|
282
|
+
const wrapped = wrapText('中文中文中文', 4);
|
|
283
|
+
assert.deepEqual(wrapped, ['中文', '中文', '中文']);
|
|
284
|
+
assert.deepEqual(wrapText('short', 10), ['short']);
|
|
285
|
+
});
|
|
286
|
+
|
|
287
|
+
test('折行:填满整行、不切英文单词、行首不放标点、末行不留孤字', () => {
|
|
288
|
+
// 中文里夹 ASCII token 时,旧实现会在空格处提前回退,行尾剩十几列空白。
|
|
289
|
+
const mixed = '宿主没有 ctx.ptcRuntime 时 tf-code 通道自动关闭(协议不声明);协议段更长,固定成本略高。';
|
|
290
|
+
const lines = wrapText(mixed, 66);
|
|
291
|
+
assert.ok(lines.length >= 2, '应当折行');
|
|
292
|
+
for (const line of lines.slice(0, -1)) {
|
|
293
|
+
assert.ok(displayWidth(line) > 66 - 12, `非末行没填满:${displayWidth(line)} 列 -> ${line}`);
|
|
294
|
+
}
|
|
295
|
+
// 英文单词/路径不能被从中间切开
|
|
296
|
+
for (const token of ['ctx.ptcRuntime', 'tf-code']) {
|
|
297
|
+
assert.ok(lines.some((line) => line.includes(token)), `${token} 被切开了:${lines.join(' | ')}`);
|
|
298
|
+
}
|
|
299
|
+
// 行首不能是闭合标点(避头点)
|
|
300
|
+
for (const line of lines.slice(1)) {
|
|
301
|
+
assert.equal(/^[。,、;:!?)】,.;:!?]/.test(line), false, `行首出现标点:${line}`);
|
|
302
|
+
}
|
|
303
|
+
// 末行不留孤字:只剩 1 个单位时,从上一行借一个下来
|
|
304
|
+
const orphan = wrapText('数据加工类任务省最多(结果句柄化,中间结果不进上下文);普通读写任务反而略高于默认。宿主无 PTC 时自动回落为默认参数。未单独实测。', 66);
|
|
305
|
+
const tail = orphan[orphan.length - 1];
|
|
306
|
+
assert.ok(displayWidth(tail) >= 4, `末行只剩 ${displayWidth(tail)} 列:${tail}`);
|
|
307
|
+
// 折行不丢字:拼回去等于原文(行尾空白裁掉是唯一允许的差异)
|
|
308
|
+
assert.equal(lines.join('').replace(/\s+/g, ''), mixed.replace(/\s+/g, ''));
|
|
309
|
+
});
|
|
310
|
+
|
|
311
|
+
test('状态落盘:写入 → 读取往返(原子替换,字段齐全)', () => {
|
|
312
|
+
const dir = mkdtempSync(join(tmpdir(), 'tf-control-'));
|
|
313
|
+
const file = writePersistedControl(createControlState({ mode: 'lean', lang: 'en' }), dir);
|
|
314
|
+
assert.equal(file, controlFileOf(dir));
|
|
315
|
+
const raw = JSON.parse(readFileSync(file, 'utf8')) as { mode: string; lang: string; schema: number; updatedAt: string };
|
|
316
|
+
assert.equal(raw.mode, 'lean');
|
|
317
|
+
assert.equal(raw.lang, 'en');
|
|
318
|
+
assert.equal(raw.schema, 1);
|
|
319
|
+
assert.ok(!Number.isNaN(Date.parse(raw.updatedAt)));
|
|
320
|
+
|
|
321
|
+
const read = readPersistedControl(dir);
|
|
322
|
+
assert.equal(read.found, true);
|
|
323
|
+
assert.deepEqual(read.state, { mode: 'lean', lang: 'en' });
|
|
324
|
+
});
|
|
325
|
+
|
|
326
|
+
test('状态读取:坏 JSON / 未知字段回默认并告警,不抛错', () => {
|
|
327
|
+
const dir = mkdtempSync(join(tmpdir(), 'tf-control-bad-'));
|
|
328
|
+
writeFileSync(controlFileOf(dir), '{ not json', 'utf8');
|
|
329
|
+
const warnings: string[] = [];
|
|
330
|
+
const read = readPersistedControl(dir, (message) => warnings.push(message));
|
|
331
|
+
assert.equal(read.found, false);
|
|
332
|
+
assert.deepEqual(read.state, { mode: DEFAULT_MODE, lang: DEFAULT_LANG });
|
|
333
|
+
assert.equal(warnings.length, 1);
|
|
334
|
+
|
|
335
|
+
writeFileSync(controlFileOf(dir), JSON.stringify({ mode: 'unknown-mode', lang: 'fr' }), 'utf8');
|
|
336
|
+
assert.deepEqual(readPersistedControl(dir).state, { mode: DEFAULT_MODE, lang: DEFAULT_LANG });
|
|
337
|
+
|
|
338
|
+
const missing = readPersistedControl(mkdtempSync(join(tmpdir(), 'tf-control-none-')));
|
|
339
|
+
assert.equal(missing.found, false);
|
|
340
|
+
});
|
|
341
|
+
|
|
342
|
+
test('状态解析优先级:装配显式 config > 环境变量 > control.json > 默认', () => {
|
|
343
|
+
const dir = mkdtempSync(join(tmpdir(), 'tf-control-prio-'));
|
|
344
|
+
writePersistedControl(createControlState({ mode: 'compat', lang: 'zh' }), dir);
|
|
345
|
+
|
|
346
|
+
const fromFile = resolveControlState({}, dir);
|
|
347
|
+
assert.equal(fromFile.mode, 'compat');
|
|
348
|
+
assert.equal(fromFile.modeSource, 'file');
|
|
349
|
+
assert.equal(fromFile.langSource, 'file');
|
|
350
|
+
assert.ok(Number.isFinite(Date.parse(readPersistedControl(dir).updatedAt ?? '')), '落盘必须带可解析的 updatedAt(桌面控制页的并发栅栏)');
|
|
351
|
+
|
|
352
|
+
const previousMode = process.env.STREAM_AGENT_MODE;
|
|
353
|
+
const previousLang = process.env.STREAM_AGENT_LANG;
|
|
354
|
+
try {
|
|
355
|
+
process.env.STREAM_AGENT_MODE = 'lean';
|
|
356
|
+
process.env.STREAM_AGENT_LANG = 'en';
|
|
357
|
+
assert.equal(resolveControlState({}, dir).mode, 'lean');
|
|
358
|
+
assert.equal(resolveControlState({}, dir).modeSource, 'env');
|
|
359
|
+
assert.equal(resolveControlState({}, dir).lang, 'en');
|
|
360
|
+
assert.equal(resolveControlState({}, dir).langSource, 'env');
|
|
361
|
+
|
|
362
|
+
const pinned = resolveControlState({ mode: 'power', lang: 'zh' }, dir);
|
|
363
|
+
assert.equal(pinned.mode, 'power');
|
|
364
|
+
assert.equal(pinned.modeSource, 'config');
|
|
365
|
+
assert.equal(pinned.lang, 'zh');
|
|
366
|
+
assert.equal(pinned.langSource, 'config');
|
|
367
|
+
|
|
368
|
+
process.env.STREAM_AGENT_MODE = 'not-a-mode';
|
|
369
|
+
assert.equal(resolveControlState({}, dir).mode, 'compat', '非法 env 不得覆盖落盘值');
|
|
370
|
+
} finally {
|
|
371
|
+
if (previousMode === undefined) delete process.env.STREAM_AGENT_MODE; else process.env.STREAM_AGENT_MODE = previousMode;
|
|
372
|
+
if (previousLang === undefined) delete process.env.STREAM_AGENT_LANG; else process.env.STREAM_AGENT_LANG = previousLang;
|
|
373
|
+
}
|
|
374
|
+
});
|
|
375
|
+
|
|
376
|
+
// ---------------------------------------------------------------------------
|
|
377
|
+
// 交互会话:把"按键 → 状态 → 画面 → 落盘"整条链路跑起来(不需要 pty)
|
|
378
|
+
// ---------------------------------------------------------------------------
|
|
379
|
+
|
|
380
|
+
test('交互会话:l 键在中英之间往返,画面与落盘同步(两个方向都验)', () => {
|
|
381
|
+
const dir = mkdtempSync(join(tmpdir(), 'tf-session-lang-'));
|
|
382
|
+
const session = new ControlSession(createControlState({ mode: 'balanced', lang: 'zh' }), {
|
|
383
|
+
save: (next) => writePersistedControl(next, dir),
|
|
384
|
+
columns: () => 80,
|
|
385
|
+
});
|
|
386
|
+
|
|
387
|
+
assert.ok(session.frame().includes('控制栏'));
|
|
388
|
+
assert.equal(readPersistedControl(dir).state.lang, 'zh');
|
|
389
|
+
|
|
390
|
+
session.handle('l');
|
|
391
|
+
const enFrame = session.frame();
|
|
392
|
+
assert.match(enFrame, /CONTROL BAR/);
|
|
393
|
+
assert.equal(/[\u4e00-\u9fff]/.test(enFrame), false, '切到英文后画面不允许残留中文');
|
|
394
|
+
assert.equal(readPersistedControl(dir).state.lang, 'en');
|
|
395
|
+
assert.equal(session.state.lang, 'en');
|
|
396
|
+
|
|
397
|
+
session.handle('l');
|
|
398
|
+
const zhFrame = session.frame();
|
|
399
|
+
assert.ok(zhFrame.includes('控制栏'));
|
|
400
|
+
assert.ok(zhFrame.includes('语言: zh'));
|
|
401
|
+
assert.equal(readPersistedControl(dir).state.lang, 'zh');
|
|
402
|
+
});
|
|
403
|
+
|
|
404
|
+
test('交互会话:数字键直接切模式并落盘,焦点跟随;画面显示对应语言的模式名', () => {
|
|
405
|
+
const dir = mkdtempSync(join(tmpdir(), 'tf-session-mode-'));
|
|
406
|
+
const session = new ControlSession(createControlState({ mode: 'balanced', lang: 'en' }), {
|
|
407
|
+
save: (next) => writePersistedControl(next, dir),
|
|
408
|
+
columns: () => 80,
|
|
409
|
+
});
|
|
410
|
+
|
|
411
|
+
session.handle('2');
|
|
412
|
+
assert.equal(session.state.mode, 'lean');
|
|
413
|
+
assert.equal(session.focus, 'lean');
|
|
414
|
+
assert.equal(readPersistedControl(dir).state.mode, 'lean');
|
|
415
|
+
assert.match(session.frame(), /Lean/);
|
|
416
|
+
assert.ok(session.note.includes('saved'), '落盘成功要给一行回执');
|
|
417
|
+
|
|
418
|
+
session.handle('l');
|
|
419
|
+
assert.equal(session.state.lang, 'zh', 'l 从 en 切到 zh');
|
|
420
|
+
session.handle('4');
|
|
421
|
+
assert.equal(session.state.mode, 'power');
|
|
422
|
+
assert.equal(readPersistedControl(dir).state.mode, 'power');
|
|
423
|
+
assert.equal(readPersistedControl(dir).state.lang, 'zh');
|
|
424
|
+
assert.match(session.frame(), /增强/);
|
|
425
|
+
assert.match(session.frame(), /code 开/);
|
|
426
|
+
});
|
|
427
|
+
|
|
428
|
+
test('交互会话:Up/Down 只移动焦点,Enter 才应用;r 回默认但保留语言', () => {
|
|
429
|
+
const dir = mkdtempSync(join(tmpdir(), 'tf-session-focus-'));
|
|
430
|
+
const session = new ControlSession(createControlState({ mode: 'balanced', lang: 'en' }), {
|
|
431
|
+
save: (next) => writePersistedControl(next, dir),
|
|
432
|
+
columns: () => 80,
|
|
433
|
+
});
|
|
434
|
+
|
|
435
|
+
session.handle('\x1b[B');
|
|
436
|
+
assert.equal(session.focus, 'lean');
|
|
437
|
+
assert.equal(session.state.mode, 'balanced', '移动焦点不得改模式');
|
|
438
|
+
assert.equal(readPersistedControl(dir).state.mode, 'balanced');
|
|
439
|
+
|
|
440
|
+
session.handle('\r');
|
|
441
|
+
assert.equal(session.state.mode, 'lean');
|
|
442
|
+
assert.equal(readPersistedControl(dir).state.mode, 'lean');
|
|
443
|
+
|
|
444
|
+
session.handle('3');
|
|
445
|
+
assert.equal(session.state.mode, 'compat');
|
|
446
|
+
session.handle('r');
|
|
447
|
+
assert.equal(session.state.mode, 'balanced', 'r 重置回默认模式');
|
|
448
|
+
assert.equal(session.state.lang, 'en', '重置模式不应顺手改语言');
|
|
449
|
+
});
|
|
450
|
+
|
|
451
|
+
test('交互会话:? 打开全模式指南,q 先返回面板,再 q 才退出', () => {
|
|
452
|
+
const session = new ControlSession(createControlState({ lang: 'zh' }), {
|
|
453
|
+
save: (next) => writePersistedControl(next, mkdtempSync(join(tmpdir(), 'tf-session-help-'))),
|
|
454
|
+
columns: () => 80,
|
|
455
|
+
});
|
|
456
|
+
|
|
457
|
+
assert.deepEqual(session.handle('?'), { quit: false, changed: true });
|
|
458
|
+
assert.equal(session.helpOpen, true);
|
|
459
|
+
assert.ok(session.frame().includes('全模式指南'));
|
|
460
|
+
assert.ok(session.frame().includes('精简') && session.frame().includes('增强'), '指南要覆盖四个模式');
|
|
461
|
+
|
|
462
|
+
assert.deepEqual(session.handle('q'), { quit: false, changed: true });
|
|
463
|
+
assert.equal(session.helpOpen, false);
|
|
464
|
+
assert.deepEqual(session.handle('q'), { quit: true, changed: false });
|
|
465
|
+
});
|
|
466
|
+
|
|
467
|
+
test('交互会话:未知键不产生重绘;落盘失败只提示不回滚内存状态', () => {
|
|
468
|
+
const session = new ControlSession(createControlState({ lang: 'zh' }), {
|
|
469
|
+
save: () => { throw new Error('disk full'); },
|
|
470
|
+
columns: () => 80,
|
|
471
|
+
});
|
|
472
|
+
|
|
473
|
+
assert.deepEqual(session.handle('z'), { quit: false, changed: false });
|
|
474
|
+
assert.deepEqual(session.handle('9'), { quit: false, changed: false });
|
|
475
|
+
|
|
476
|
+
session.handle('3');
|
|
477
|
+
assert.equal(session.state.mode, 'compat', '落盘失败不能回滚本次运行内的选择');
|
|
478
|
+
assert.match(session.note, /状态写入失败/);
|
|
479
|
+
assert.match(session.frame(), /compat/);
|
|
480
|
+
});
|
|
481
|
+
|
|
482
|
+
test('按键拆分:方向键三字节序列与普通键能被正确分开', () => {
|
|
483
|
+
assert.deepEqual(splitKeys('\x1b[A1'), ['\x1b[A', '1']);
|
|
484
|
+
assert.deepEqual(splitKeys('\x1b[B\x1b[A'), ['\x1b[B', '\x1b[A']);
|
|
485
|
+
assert.deepEqual(splitKeys('q'), ['q']);
|
|
486
|
+
});
|