@fanglinwei/agent-fit 0.0.0-stage → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +157 -2
  3. package/VERSION +1 -0
  4. package/adapters/codex/modes.json +360 -0
  5. package/adapters/codex/skills/agent-fit/SKILL.md +118 -0
  6. package/adapters/codex/skills/agent-fit/agents/openai.yaml +6 -0
  7. package/adapters/codex/skills/agent-fit/assets/AGENTS.fragment.md +13 -0
  8. package/adapters/codex/skills/agent-fit/assets/codex/agents/task-delegate.toml +18 -0
  9. package/adapters/codex/skills/agent-fit/assets/codex/agents/task-execute.toml +20 -0
  10. package/adapters/codex/skills/agent-fit/assets/codex/agents/task-review.toml +20 -0
  11. package/adapters/codex/skills/agent-fit/assets/codex/agents/task-scan.toml +20 -0
  12. package/adapters/codex/skills/agent-fit/assets/codex/config.toml +17 -0
  13. package/adapters/codex/skills/agent-fit/references/calibration.md +66 -0
  14. package/adapters/codex/skills/agent-fit/references/configuration.md +38 -0
  15. package/adapters/codex/skills/agent-fit/references/failure-policy.md +26 -0
  16. package/adapters/codex/skills/agent-fit/references/task-routing.md +36 -0
  17. package/bin/agent-fit.mjs +246 -0
  18. package/docs/README.md +15 -0
  19. package/docs/implementation-review.md +119 -0
  20. package/docs/usage.md +458 -0
  21. package/lib/accounts.mjs +129 -0
  22. package/lib/codex.mjs +215 -0
  23. package/lib/install.mjs +733 -0
  24. package/lib/model-history.mjs +93 -0
  25. package/lib/models.mjs +376 -0
  26. package/lib/probe.mjs +186 -0
  27. package/lib/scopes.mjs +113 -0
  28. package/lib/server.mjs +200 -0
  29. package/package.json +15 -4
  30. package/web/app.js +744 -0
  31. package/web/index.html +109 -0
  32. package/web/styles.css +407 -0
@@ -0,0 +1,246 @@
1
+ #!/usr/bin/env node
2
+ import { parseArgs } from 'node:util';
3
+ import { realpath } from 'node:fs/promises';
4
+ import { pathToFileURL } from 'node:url';
5
+ import { VERSION, LEVELS, TASKS, ROLES, argumentError, validateDefinition, validatePair, explainSelection, inspectProject } from '../lib/codex.mjs';
6
+
7
+ const HELP = `agent-fit ${VERSION} — Codex 子代理委派配置
8
+ 需要 Node.js 22+。npm 安装仅安装命令;setup 显式配置 Codex。
9
+ 用法:agent-fit <命令> [选项]。
10
+
11
+ setup [--mode MODE] [--dry-run]
12
+ mode set MODE [--dry-run]
13
+ mode clear [--dry-run]
14
+ mode delete MODE [--dry-run]
15
+ mode list | mode show [MODE]
16
+ mode create NAME [--from MODE] [--dry-run]
17
+ mode configure MODE --level L1|L2|L3|L4 --model MODEL --effort EFFORT
18
+ [--fallback-model MODEL --fallback-effort EFFORT | --clear-fallback]
19
+ mode configure MODE --definition-stdin [--dry-run]
20
+ status [--details] [--project PATH]
21
+ explain --level L1|L2|L3|L4 [--task mechanical|bounded|scan|deep|complex|uncertain|reasoning|latency] [--mode MODE] [--role ROLE]
22
+ models check [--verify] [--discover] [--expect-catalog HASH] [--model MODEL --effort EFFORT]
23
+ restore [--dry-run]
24
+ serve [--port PORT] [--open]
25
+
26
+ 路由命令支持 --scope global|project|session、--project PATH、--thread ID。
27
+ CLI 默认 global;聊天 Skill 切换默认 session。项目和会话选择可用 mode clear 恢复继承。
28
+ 会话 > 项目 > 全局;查询显示有效档位及来源。局部选择只影响后续新任务。
29
+
30
+ 内置档位:cut(经济)、official(官方,首次配置默认)、high(高级)、fire(全开)。
31
+ cut/official 支持同级任务候选;明确选择 high/fire 即授权所示最高强度,包括 Astra/ultra,预算与 fire 验证仍适用。
32
+ 省略 --agent 时默认使用 codex;也可显式指定 --agent codex。
33
+ 目标目录支持 --codex-home PATH;默认 CODEX_HOME 或 ~/.codex。
34
+ 查询及写命令支持 --json;写命令支持 --expect-revision REV。
35
+ --help [--json] | --version [--json]
36
+ 安装与档位设置只修改本地配置,不自动检查账号、模型目录或发送验证请求。
37
+ 需要时显式运行 models check;--verify 会实际调用模型,可能产生费用。
38
+ 首次安装、更新基础规则或恢复后请重启 Codex;日常切档无需重启,后续新任务读取新配置。
39
+ 完整说明:https://github.com/fanglinwei/agent-fit/blob/main/docs/usage.md`;
40
+
41
+ const strings = ['agent', 'codex-home', 'mode', 'from', 'level', 'task', 'model', 'effort', 'fallback-model', 'fallback-effort', 'expect-revision', 'role', 'project', 'scope', 'thread', 'port', 'expect-catalog'];
42
+ const booleans = ['dry-run', 'json', 'details', 'clear-fallback', 'definition-stdin', 'verify', 'discover', 'open', 'help', 'version'];
43
+ const optionTypes = Object.fromEntries([...strings.map(k => [k, { type: 'string' }]), ...booleans.map(k => [k, { type: 'boolean' }])]);
44
+ const common = ['agent', 'codex-home', 'json'];
45
+ const write = [...common, 'dry-run', 'expect-revision'];
46
+ const scoped = ['scope', 'project', 'thread'];
47
+ const commands = {
48
+ setup: [...write, 'mode'], set: [...write, ...scoped], clear: [...write, ...scoped], delete: [...write, ...scoped], list: [...common, ...scoped], show: [...common, ...scoped],
49
+ create: [...write, ...scoped, 'from'], configure: [...write, ...scoped, 'level', 'model', 'effort', 'fallback-model', 'fallback-effort', 'clear-fallback', 'definition-stdin'],
50
+ status: [...common, ...scoped, 'details'], explain: [...common, ...scoped, 'level', 'task', 'mode', 'role'],
51
+ models: [...common, ...scoped, 'discover', 'expect-catalog', 'verify', 'model', 'effort', 'expect-revision'], restore: write,
52
+ serve: ['agent', 'codex-home', 'project', 'thread', 'port', 'open'],
53
+ };
54
+
55
+ export function parseCommand(argv) {
56
+ let parsed;
57
+ try { parsed = parseArgs({ args: argv, options: optionTypes, allowPositionals: true, strict: true, tokens: true }); }
58
+ catch { throw argumentError('未知参数或缺少参数值;使用 --help 查看命令。'); }
59
+ const { values, positionals, tokens } = parsed;
60
+ const seen = new Set();
61
+ for (const token of tokens) if (token.kind === 'option') {
62
+ if (seen.has(token.name)) throw argumentError('参数不能重复。');
63
+ seen.add(token.name);
64
+ }
65
+ if (values.help || values.version) {
66
+ if (positionals.length || Object.keys(values).some(k => !['help', 'version', 'json'].includes(k)) || (values.help && values.version)) throw argumentError('帮助/版本仅支持 --json。');
67
+ return { action: values.help ? 'help' : 'version', values, options: {} };
68
+ }
69
+ let action = positionals[0], selector;
70
+ let count = 1;
71
+ if (action === 'mode') {
72
+ action = positionals[1]; count = 2;
73
+ if (!['set', 'clear', 'delete', 'list', 'show', 'create', 'configure'].includes(action)) throw argumentError('未知 mode 子命令。');
74
+ if (!['list', 'clear'].includes(action) && (action !== 'show' || positionals[2] !== undefined)) { selector = positionals[2]; count = 3; }
75
+ } else if (action === 'models') {
76
+ if (positionals[1] !== 'check') throw argumentError('models 仅支持 check。');
77
+ count = 2;
78
+ }
79
+ if (!commands[action] || positionals.length !== count || ((count === 3) && !selector)) throw argumentError('命令或位置参数无效;使用 --help。');
80
+ if (Object.keys(values).some(k => !commands[action].includes(k))) throw argumentError('该命令不支持给定参数。');
81
+ if (values.agent !== undefined && values.agent !== 'codex') throw argumentError('首版仅支持 --agent codex。', 'AGENT_UNSUPPORTED');
82
+ if (values.scope !== undefined && !['global', 'project', 'session'].includes(values.scope)) throw argumentError('作用域必须是 global、project 或 session。');
83
+ if (values.level !== undefined && !LEVELS.includes(values.level)) throw argumentError('任务等级必须是 L1–L4。');
84
+ if (values.role !== undefined && !Object.hasOwn(ROLES, values.role)) throw argumentError('委派角色无效。');
85
+ if (action === 'explain' && !values.level) throw argumentError('explain 需要 --level。');
86
+ if (values.task !== undefined && (!Object.hasOwn(TASKS, values.task) || !TASKS[values.task].includes(values.level))) throw argumentError('任务类型与复杂度等级不匹配。');
87
+ if (action === 'models' && Boolean(values.model) !== Boolean(values.effort)) throw argumentError('--model 与 --effort 必须成对。');
88
+ if (action === 'models' && (values.discover && (!values.verify || values.model) || values['expect-catalog'] && (!values.discover || !/^[a-f0-9]{64}$/.test(values['expect-catalog'])))) throw argumentError('--discover 需要 --verify,且不能同时指定模型;目录版本须为 SHA-256。');
89
+ if (action === 'models' && values.model) validatePair({ model: values.model, effort: values.effort });
90
+ if (action === 'configure') {
91
+ const fields = ['level', 'model', 'effort', 'fallback-model', 'fallback-effort', 'clear-fallback'];
92
+ if (values['definition-stdin']) {
93
+ if (fields.some(k => Object.hasOwn(values, k))) throw argumentError('整表 stdin 与单级参数互斥。');
94
+ } else {
95
+ if (!values.level || !values.model || !values.effort) throw argumentError('单级配置需要 --level、--model、--effort。');
96
+ validatePair({ model: values.model, effort: values.effort });
97
+ if (Boolean(values['fallback-model']) !== Boolean(values['fallback-effort']) || (values['clear-fallback'] && values['fallback-model'])) throw argumentError('备用参数必须成对,且与 --clear-fallback 互斥。');
98
+ if (values['fallback-model']) validatePair({ model: values['fallback-model'], effort: values['fallback-effort'] });
99
+ }
100
+ }
101
+ if (action === 'serve' && values.port !== undefined && (!/^\d+$/.test(values.port) || (Number(values.port) !== 0 && (Number(values.port) < 1024 || Number(values.port) > 65535)))) throw argumentError('端口必须是 0 或 1024–65535。');
102
+ const options = Object.fromEntries(Object.entries(values).map(([key, value]) => [key.replace(/-([a-z])/g, (_, c) => c.toUpperCase()), value]));
103
+ if (action === 'create') options.name = selector;
104
+ else if (selector) options.mode = selector;
105
+ return { action, values, options };
106
+ }
107
+
108
+ async function readDefinition() {
109
+ const chunks = []; let length = 0;
110
+ for await (const chunk of process.stdin) {
111
+ length += chunk.length;
112
+ if (length > 65536) throw argumentError('整表输入超过 64 KiB。');
113
+ chunks.push(chunk);
114
+ }
115
+ let value;
116
+ try { value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks))); }
117
+ catch { throw argumentError('整表输入必须是有效 UTF-8 JSON。'); }
118
+ return { levels: validateDefinition(value) };
119
+ }
120
+
121
+ function terminalText(value) {
122
+ return value.replace(/[\p{Cc}\p{Cf}\p{Cs}]/gu, char => `\\u${char.codePointAt(0).toString(16).padStart(4, '0')}`);
123
+ }
124
+
125
+ function emit(data, errors, json) {
126
+ if (json) process.stdout.write(JSON.stringify({ report_schema_version: 1, data, errors }) + '\n');
127
+ else {
128
+ if (data) {
129
+ if (data.help) process.stdout.write(data.help + '\n');
130
+ else if (data.cli_version && Object.keys(data).length === 1) process.stdout.write(data.cli_version + '\n');
131
+ else process.stdout.write(renderHuman(data) + '\n');
132
+ }
133
+ for (const error of errors) process.stderr.write(`${terminalText(error.code)}: ${terminalText(error.message)}\n`);
134
+ }
135
+ }
136
+
137
+ function renderHuman(data) {
138
+ const lines = [];
139
+ const pair = value => value ? `${value.model} / ${value.effort ?? '供应商默认参数'}` : '无';
140
+ const levels = definition => {
141
+ for (const [level, value] of Object.entries(definition.levels || {})) {
142
+ lines.push(`${level} ${pair(value)} 备用:${definition.kind === 'builtin' && definition.id === 'fire' ? '用户指定,否则继承父代理' : pair(value.fallback)}`);
143
+ for (const [task, candidate] of Object.entries(value.tasks ?? {})) lines.push(` ${task} ${pair(candidate)} 备用:${pair(candidate.fallback)}`);
144
+ }
145
+ };
146
+ if (data.installation) {
147
+ lines.push(`Codex home:${data.home}`, `工具 ${data.cli_version} · 配置 ${data.configuration_version || '未安装'}`, `状态:${data.installation} · 完整性:${data.integrity}`, `已配置档位:${data.mode?.name || '无'}${data.mode ? ` (${data.mode.id})` : ''}`, `恢复基线:${data.restoration.status}`);
148
+ if (data.mode) levels(data.mode);
149
+ if (data.rules.summary.length) {
150
+ lines.push('', '职责与规则:');
151
+ for (const role of data.roles) lines.push(`${role.name} ${role.configured_model || '未固定'} / ${role.configured_effort || '未固定'}`);
152
+ lines.push(...data.rules.summary.map(rule => `- ${rule}`), '', '相关配置与检查范围:', ...JSON.stringify({ related_config: data.related_config, inspection: data.inspection }, null, 2).split('\n'));
153
+ }
154
+ if (data.verification?.required) lines.push('fire:每个会话首次委派前须实际验证;失败时使用用户指定组合,否则继承父代理模型与推理强度。');
155
+ lines.push(...data.warnings);
156
+ } else if (data.result) {
157
+ lines.push(`操作:${data.action} · ${data.result} · ${data.configuration_status}`, `Codex home:${data.home}`, `档位:${data.mode?.name || '无'} · 变化文件:${data.changed_files?.length || 0}`);
158
+ if (data.created_mode) lines.push(`已创建:${data.created_mode.name} (${data.created_mode.id}),${data.mode?.id === data.created_mode.id ? '已在当前作用域选择。' : '尚未设为当前档位。'}`);
159
+ if (data.result === 'preview') lines.push(...(data.changes || []).map(change => `${change.action} ${change.path}`));
160
+ if (data.custom_modes_removed?.length) lines.push(`清理自定义档位:${data.custom_modes_removed.join('、')}`);
161
+ if (data.restart?.message) lines.push(data.restart.message);
162
+ lines.push(...(data.warnings || []));
163
+ } else if (data.modes) {
164
+ lines.push(...data.modes.map(mode => `${mode.active ? '*' : ' '} ${mode.id} ${mode.name} ${mode.kind}`));
165
+ } else if (data.definition) {
166
+ lines.push(`${data.definition.name} (${data.definition.id}) · ${data.active ? '当前已配置' : '定义预览'}`, `来源:${data.source} · 定义版本:${data.definition_version || VERSION}`); levels(data.definition);
167
+ } else if (data.dispatch_role) {
168
+ lines.push(`${data.mode_name} · ${data.level}${data.task ? ` · ${data.task}` : ''}`, `主组合:${pair(data.primary)} · 备用:${pair(data.fallback)}`, `职责:${data.requested_role} → 委派角色:${data.dispatch_role}`, `权限契约:${data.permission_contract}`, `原因:${data.reason_codes.join('、')}`);
169
+ if (data.verification?.required) lines.push('先完成本会话实际验证;失败时使用 task_delegate,采用用户指定组合,否则继承父代理模型与推理强度。');
170
+ } else if (data.catalog) {
171
+ lines.push(`账号状态:${data.account.status} · 目录:${data.catalog.status} (${data.catalog.models.length} 个模型)`);
172
+ if (data.catalog.source) lines.push(`目录来源:${data.catalog.source}`);
173
+ if (data.availability) lines.push(`可调用:${data.availability.available} · 不可用:${data.availability.unavailable} · 未确认:${data.availability.unconfirmed}`);
174
+ for (const value of data.checked_pairs) lines.push(`${pair(value)} · 参数:${value.parameter_support} · 调用权限:${value.access} · ${value.reason_code}`);
175
+ if (data.history) lines.push(data.history.status === 'saved' ? `检查记录已保存:${data.history.id}` : '检查结果未保存:MODEL_HISTORY_UNAVAILABLE;请核对记录目录权限。');
176
+ } else lines.push(JSON.stringify(data, null, 2));
177
+ for (const item of data.diagnostics || []) lines.push(`${item.code} [${item.status}] ${item.message}`);
178
+ if (data.runtime_verification) lines.push(`运行生效:${data.runtime_verification}`);
179
+ if (data.scope) lines.push(`查询/修改作用域:${data.scope}${data.effective_scope ? ` · 有效来源:${data.effective_scope}${data.inherited ? '(继承)' : ''}` : ''}`);
180
+ return lines.map(terminalText).join('\n');
181
+ }
182
+
183
+ async function main() {
184
+ const argv = process.argv.slice(2);
185
+ const json = argv.includes('--json');
186
+ try {
187
+ if (Number(process.versions.node.split('.')[0]) < 22) throw argumentError('需要 Node.js 22 或更新版本。', 'NODE_UNSUPPORTED');
188
+ const { action, options } = parseCommand(argv);
189
+ if (action === 'help' || action === 'version') { emit(action === 'help' ? { help: HELP } : { cli_version: VERSION }, [], json); return; }
190
+ if (action === 'configure' && options.definitionStdin) options.definition = await readDefinition();
191
+ const installer = await import('../lib/install.mjs');
192
+ const home = installer.resolveHome(options.codexHome);
193
+ if (action === 'serve') {
194
+ const { serveLocal } = await import('../lib/server.mjs');
195
+ const service = await serveLocal({ home, project: options.project ?? process.cwd(), thread: options.thread ?? process.env.CODEX_THREAD_ID ?? null, port: Number(options.port || 0), open: Boolean(options.open) });
196
+ process.stdout.write(`本地配置页面:${service.url}\n目标 Codex home:${terminalText(home)}\n按 Ctrl+C 停止。\n`);
197
+ const stop = async () => { process.off('SIGINT', stop); process.off('SIGTERM', stop); await service.close(); };
198
+ process.on('SIGINT', stop); process.on('SIGTERM', stop);
199
+ return;
200
+ }
201
+ let data; let code = 0;
202
+ if (action === 'status') {
203
+ for (let attempt = 0; attempt < 2; attempt++) {
204
+ data = await installer.statusReport(home, options);
205
+ const related = await inspectProject(options.project || process.cwd());
206
+ if ((await installer.readSnapshot(home)).configuration_revision !== data.configuration_revision) {
207
+ if (!attempt) continue;
208
+ throw Object.assign(new Error('配置读取期间变化;请刷新。'), { code: 'BUSY', exitCode: 1 });
209
+ }
210
+ data.related_config.project_candidates = related.candidates;
211
+ data.inspection.checked_paths.push(...related.checked);
212
+ data.inspection.skipped_paths.push(...related.skipped);
213
+ data.diagnostics.push(...related.diagnostics);
214
+ break;
215
+ }
216
+ }
217
+ else if (action === 'list') data = await installer.listReport(home, options);
218
+ else if (action === 'show') data = await installer.showReport(home, options.mode, options);
219
+ else if (action === 'explain') {
220
+ let snapshot, shown;
221
+ for (let attempt = 0; attempt < 2; attempt++) {
222
+ snapshot = await installer.readSnapshot(home);
223
+ if (!options.mode && !snapshot.mode) throw Object.assign(new Error('尚无有效当前档位;先 setup,或用 --mode 明确预览内置档位。'), { code: 'NOT_INSTALLED', exitCode: 1 });
224
+ shown = await installer.showReport(home, options.mode, options);
225
+ if (snapshot.configuration_revision === shown.configuration_revision) break;
226
+ if (attempt) throw Object.assign(new Error('配置读取期间变化;请刷新。'), { code: 'BUSY', exitCode: 1 });
227
+ }
228
+ data = { configuration_revision: shown.configuration_revision, diagnostics: shown.diagnostics, source: shown.source, definition_version: shown.definition_version, scope: shown.scope, effective_scope: shown.effective_scope, context: shown.context, inherited: shown.inherited, task_profile: shown.definition, ...explainSelection({ definition: shown.definition, level: options.level, task: options.task, role: options.role || 'task_delegate', selected: shown.active, active: options.scope === undefined && shown.active && shown.effective_scope === 'global' }) };
229
+ } else if (action === 'models') {
230
+ const { recordedModelCheck } = await import('../lib/model-history.mjs');
231
+ data = await recordedModelCheck({ home, scope: options.scope, project: options.project, thread: options.thread, verify: Boolean(options.verify), discover: Boolean(options.discover), expectCatalog: options.expectCatalog, target: options.model ? { model: options.model, effort: options.effort } : undefined, expectRevision: options.expectRevision });
232
+ code = data.exit_code || 0; delete data.exit_code;
233
+ } else {
234
+ data = await installer.mutate(home, action, options);
235
+ }
236
+ const errors = ['status', 'list', 'show', 'explain'].includes(action) ? (data.diagnostics || []).filter(item => item.status === 'fail').map(item => ({ code: item.code, message: item.message })) : [];
237
+ if (errors.length) code = 1;
238
+ emit(data, errors, json); process.exitCode = code;
239
+ } catch (error) {
240
+ const known = typeof error.code === 'string' && (error.exitCode === 1 || error.exitCode === 2 || error.exitCode === 3);
241
+ emit(error.details?.report || null, [{ code: known ? error.code : 'IO_ERROR', message: known ? error.message : '操作未完成;请检查路径、权限与配置格式。' }], json);
242
+ process.exitCode = known ? error.exitCode : 1;
243
+ }
244
+ }
245
+
246
+ if (process.argv[1] && import.meta.url === pathToFileURL(await realpath(process.argv[1])).href) await main();
package/docs/README.md ADDED
@@ -0,0 +1,15 @@
1
+ # 文档导航
2
+
3
+ `agent-fit` 当前版本为 0.7.1,npm 包为 `@fanglinwei/agent-fit`。先阅读使用说明;源码研究和校准记录用于追溯依据,不代替当前版本的验收结果。
4
+
5
+ | 文档 | 用途 |
6
+ | --- | --- |
7
+ | [使用说明](usage.md) | 安装、命令、档位与同级任务候选、模型检查、网页、冲突与恢复 |
8
+ | [实施验收记录](implementation-review.md) | 当前实现、测试与使用边界 |
9
+ | [Skill](https://github.com/fanglinwei/agent-fit/blob/main/adapters/codex/skills/agent-fit/SKILL.md) | 启动与每次委派前的简洁流程 |
10
+ | [校准记录](https://github.com/fanglinwei/agent-fit/tree/main/docs/calibration) | 冻结输入、预期与实际结果,保留失败和未知项 |
11
+ | [参考项目比较](https://github.com/fanglinwei/agent-fit/blob/main/docs/research/2026-10-13-plan-review-reference-projects.md) | 固定提交的借鉴来源与宿主差异 |
12
+
13
+ npm 安装只安装工具;显式 setup 才配置绑定 home。网页保存或应用会执行实际 CLI,仅处理本地配置;网页账号配置页只管理授权与登录,模型目录查询通过 CLI 手动发起;当前档位主模型也可在档位页点击检测。首次安装、基础规则更新或恢复后重启 Codex;日常全局、项目和会话切档无需重启,后续新任务读取新配置。目录结果不证明调用权限。restore 只撤销当前版本的本工具改动。只处理当前格式与版本的配置。
14
+
15
+ 实际页面随 npm 包交付,通过 `agent-fit serve` 打开。当前版本仅验收 macOS 配置和接口;宿主加载、其他系统和真实推理分别记录未知范围。
@@ -0,0 +1,119 @@
1
+ # 内测实现与验收
2
+
3
+ 当前版本:0.7.1。以下按日期保留实现与验收记录;历史结果不代替当前版本的发布验证。
4
+
5
+ ## 2026-10-19 npm 公开包命名
6
+
7
+ npm 注册表以与现有 agentfit 名称过于相似为由拒绝发布无作用域的 agent-fit;v0.7.0 仅完成 GitHub 发布。经用户确认,v0.7.1 改用 npm 公开包 @fanglinwei/agent-fit;GitHub 仓库、可执行命令和 Skill 名继续使用 agent-fit。安装、卸载、npm exec 与本地打包文档同步采用实际包名和文件名,历史版本与校准证据保留原文。此补丁只调整包名、版本、文档及对应的包入口断言,不改变运行逻辑。
8
+
9
+ ## 2026-10-19 Agent Fit 0.7.0 发布验证
10
+
11
+ GitHub 仓库、npm 包、CLI 和 Skill 统一使用 agent-fit,展示名称为 Agent Fit。本版汇总三层作用域、同级任务候选、自定义档位快照、委派路由总览、账号管理、手动主模型检测及配置操作零模型请求等当前功能。README 按安装、选择、查询和恢复重写;仓库链接与当前版本文档同步更新。只支持当前格式与版本,不增加旧用户迁移或兼容入口,历史校准输入保留原文。
12
+
13
+ 发布复核修复了恢复页只统计当前作用域的问题:预览和最终确认改用后端的全 home 自定义档位清单,预览前不再断言不存在自定义档位。新增浏览器场景在项目与会话各建独有档位,从全局页面恢复,核对两处清单均完整;新回归在旧实现下失败,修复后通过。同时纠正自定义档位删除说明,并明确故障备用从本任务有效作用域的 task_profile 快照读取,避免误用全局基线。
14
+
15
+ 本版 Node 测试 184 项通过,0 失败或跳过。Chrome 完整配置、自定义、三层作用域、路由查询、账号与恢复流程通过;四页在 375/768/1280/1440px 无横向溢出,零脚本错误。语法与 diff 空白检查通过。配置与浏览器测试使用临时 home 和模拟账号/供应商,不修改真实 home,也不执行真实模型推理;这些结果不证明模型能力或供应商可调用性。
16
+
17
+ ## 2026-10-19 同级任务候选与 Astra 授权
18
+
19
+ L1–L4 保持推理复杂度分级,cut/official 每级可包含 tasks 候选及各自备用。查询新增 --task,按 mechanical、bounded、scan、deep、complex、uncertain、reasoning 选择完整组合;latency 仅使用显式配置,不自动启用 Terra。旧定义可继续查等级基线,显式候选缺失或类型/等级不符时拒绝查询,不从包内映射猜值。
20
+
21
+ 普通自动 Astra 候选为 low/medium;有推理不足证据时可在同级由 low 升 medium,继续计入原任务三次总额。依用户确认,high/fire 保留最高强度,明确选择即授权其展示组合,预览不构成授权;预算、宿主支持、fire 验证与写入者停止规则保持有效。查询区分已选择的最高强度和仅预览。
22
+
23
+ 候选随复制、自定义保存、三层作用域与完整任务快照保存。单级修改保留任务候选,整表 JSON 或网页每级候选 JSON 可编辑或清空;无效输入、刷新与冲突保留草稿,错误链接可聚焦编辑框。网页新增任务类型查询,修正等级名称与职责混用。手动模型检测覆盖基线和候选的去重主组合,排除备用;official 当前为 9 个组合,确认框展示数量与费用提示,不自动执行检测。
24
+
25
+ Node 测试 171 项全部通过;Chrome 完整配置、候选编辑/查询、无效 JSON 保留、三层切换、账号与恢复通过,四页在 375/768/1280/1440px 无溢出且零脚本错误。Skill 校验通过。此次仅验证规则与配置链路,没有执行真实模型推理、比较成本或延迟,候选能力仍待独立任务校准;未部署至真实 home。
26
+
27
+ ## 2026-10-19 日常切档无需重启
28
+
29
+ 普通全局、项目和会话切档、活动自定义档位的模型/effort 调整及重复设置统一返回无需重启。首次安装、基础 Skill/AGENTS/角色职责更新及实际恢复仍要求重启;卸载前先恢复的规则保持有效。共享写报告区分基础规则变化和路由数据变化,CLI、网页结果与预览沿用同一判断;状态查询不再无条件提示重启。
30
+
31
+ Node 测试 167 项通过,包含全局切档、活动自定义更新、三层作用域、预览零写入,以及已归属的旧 Skill、AGENTS 和角色职责更新仍提示重启。Chrome 配置、账号、三层切换、自定义与恢复流程通过;375/768/1280/1440px 四页无溢出,零脚本错误。Skill 校验与 diff 空白检查通过。
32
+
33
+ 宿主证据来自 Codex 0.162.1:同一进程、同一会话下一轮重新加载全局角色模型/effort 绑定。该证据只证明配置加载,未运行子代理云端推理,不证明实际模型身份。已开始任务沿用原快照;本次源码更新未自动部署至真实 home。
34
+
35
+ ## 2026-10-19 更名为 Agent Fit
36
+
37
+ 项目目录、npm 包、唯一可执行命令、Skill 名称及目录统一为 agent-fit,展示名称为 Agent Fit。入口为 bin/agent-fit.mjs;新安装使用 skills/agent-fit、.agent-fit、.agent-fit-checks 和 agent-fit AGENTS 标记。档位、模型映射、角色名称及三层作用域行为保持原有语义。GitHub 仓库地址暂沿用原地址,冻结的研究与校准证据不改写。
38
+
39
+ 只管理 agent-fit 的当前安装状态。配置格式、版本、归属、摘要、锁和恢复基线仍按当前安装校验。
40
+
41
+ 移除旧安装识别与阻断、迁移说明及两项专用测试后,Node 测试 166 项全部通过。Skill 校验及 diff 空白检查通过;实际 home 只读查询成功,网页应用按钮正常启用,无脚本错误,未执行配置写入或模型验证。
42
+
43
+ ## 2026-10-19 三层作用域
44
+
45
+ 有效档位按会话 > 项目 > 全局整份解析。新增 home 内受管理的 scopes.json,复用既有锁、版本预检、原子替换、回滚与恢复基线;已有同版本全局安装可直接读取,无需迁移。项目以规范化 worktree 根隔离,会话以目标线程隔离;非 Git 项目显式指定路径,缺少会话身份不降为全局。
46
+
47
+ CLI 新增 --scope/--project/--thread、清除选择和受引用保护的自定义删除。局部修改上层自定义档位先复制,清除选择保留定义。显式作用域 explain 使用未固定的 task_delegate,返回完整 task_profile 与来源供主代理保存任务快照;重试、升级和备用沿用快照属于 Skill 指令约束,工具不拦截宿主派发。
48
+
49
+ 网页明确选择作用域,展示有效来源,线程未绑定时禁用会话选项;上下文由服务绑定,不接受网页任意传入其他项目或线程。手动主模型检查使用页面作用域的有效档位,去重并排除备用;配置与切换不触发模型请求。
50
+
51
+ Node 测试 166 项通过;包含三层优先级、项目与线程隔离、局部复制、引用保护、清除继承、预览零写入、并发版本冲突、回滚、权限、损坏配置阻断、完整任务快照及作用域主模型检查。Chrome 完整配置/账号/恢复流程与三层切换、继承来源、页面恢复通过;375/768/1280/1440px 四页无溢出、零脚本错误。RPC 超时测试使用已就绪快照隔离文件系统负载,仍验证超时分类与子进程关闭。
52
+
53
+ 未执行真实模型推理,也未在桌面宿主创建、恢复或 fork 聊天验证实际模型 metadata。临时 home 与模拟供应商证明工具解析和请求边界,不证明模型可用性或主代理遵循 Skill 的运行结果。
54
+
55
+ ## 2026-10-19 派发角色与接续规则核验
56
+
57
+ 非活动档位及未安装时的 explain 预览统一返回 task_delegate,候选 model/effort 与原权限契约保持不变;只有活动档位的匹配固定角色可被推荐,L4 仍使用 task_delegate。回归先出现预期失败,再通过修复;覆盖内置与自定义预览、未安装预览、活动自定义、同组合候选以及查询零配置改动。
58
+
59
+ 自定义档位的本级非空 fallback 在用户选择该档位且满足原条件与预算后允许自动接续,包括复制的备用;仅创建、保存或预览不构成选择。null、用户模型锁定及其他停止条件继续阻断接续,不套用 fire 的继承规则。
60
+
61
+ Node 测试 157 项通过,零失败或跳过;Skill 校验与 diff 空白检查通过。源码 docs/calibration/ 中保留冻结输入、独立预期和完整决策记录:改动前一批 11/12 符合目标验收,自定义授权语义未闭环;更新后一批 12/12 符合。两个批次均只读判断,未执行案例 worker,实际模型身份及宿主接续未验证;不据此调整 L1–L4 或默认映射,不构成模型能力比较。
62
+
63
+ ## 当前约定
64
+
65
+ - 内置档位的命令、配置 id、状态记录、生成 JSON、查询和网页统一为 `cut / official / high / fire`,不保留名称映射。
66
+ - Skill 名称、目录和调用方式统一为 `agent-fit` / `skills/agent-fit` / `$agent-fit`;CLI 为 `agent-fit`。
67
+ - 仅支持当前状态格式和版本,只管理 agent-fit 安装。
68
+ - 不支持的状态格式、路径或档位引用返回 `STATE_INVALID`;版本不一致返回 `VERSION_MISMATCH`。校验在写入前完成,不转换或覆盖已有配置。
69
+ - 当前版本的同版本重复配置、档位切换、自定义和首次恢复基线保持有效。
70
+
71
+ ## 保留的能力
72
+
73
+ 四种内置档位、自定义四级主/备用组合、状态和选择解释、CLI 账号/目录检查、网页账号配置及真实 CLI 配置操作,以及首次安装、基础规则更新与恢复后的重启提醒;日常档位切换无需重启。安装、设置/激活及应用自定义修改不自动检查模型;网页账号页只管理授权与登录,目录查询通过 CLI 手动发起,当前主模型可在档位页点击检测。
74
+
75
+ 状态与恢复记录、文件归属、路径、符号链接、权限、摘要、版本冲突和独占锁继续校验。逐文件原子替换、普通失败回退和并发编辑保护继续生效。恢复保留安装前内容、管理区块外修改及无关文件。
76
+
77
+ 委派规则继续保留用户选择优先、难度与职责分离、禁止递归、独占写入、局部阻断、最小充分验证及 PARTIAL 返回。
78
+
79
+ ## 验证
80
+
81
+ 环境:macOS、Node.js 26.12.0,以及已有 Chrome / Playwright。所有配置测试使用临时 home。
82
+
83
+ | 检查 | 结果 |
84
+ | --- | --- |
85
+ | Node 测试 | 157 项通过,0 失败或跳过;包含统一 id、配置与生成 JSON 一致、不支持格式/版本零写入、冲突、回退、查询、恢复与服务验证 |
86
+ | Chrome 集成 | 配置、自定义创建/保存/激活、冲突保留与比较、账号状态/登录/取消授权/退出登录与零模型请求、规则解释、恢复和键盘焦点通过;四页在 375/768/1280/1440px 无页面溢出,零脚本错误;不支持的配置版本明确报错、禁用应用且零写入 |
87
+ | 隔离 npm 包 | 29 个公开运行/文档资产,仅提供 agent-fit;无 Python/旧 Skill 资产;安装、四档 id、自定义和恢复通过 |
88
+
89
+ 已删除专属于移除功能的升级迁移测试、Python 兼容入口和历史安装器 fixture;配置安全与恢复回归测试继续运行。
90
+
91
+ ## 配置操作零模型请求验收
92
+
93
+ 临时 Codex home 中的 setup、重复 setup/同档设置、内置/自定义激活、活动定义应用、预览、查询及恢复均不启动账号/模型检查进程、不访问供应商目录或推理接口,也不写模型检查记录。回归使用可观测的模拟 Codex 可执行文件和 loopback 供应商,断言检查进程及 GET/POST 请求均为零。
94
+
95
+ 手动模型验证仍使用独立 Responses 请求并保存结果;模拟认证失败仅影响手动检查,记录目录权限异常不影响档位设置。旧自动检查历史文件继续保留,不作为跨会话 fire 验证缓存。浏览器同步移除自动验证的等待、费用与结果提示,重复设置只执行配置操作。
96
+
97
+ ## 网页账号配置验收
98
+
99
+ 原模型检查页改为账号配置页,保留已有授权状态、ChatGPT 浏览器授权、设备码、API Key 登录、取消授权和退出登录。移除目录、可用性验证、检查记录及其网页请求路径,后端拒绝 models/history 动作;独立 CLI 检查与已有历史文件保留。浏览器回归断言进入页面、刷新、登录和退出全过程的 models/history 请求为零。
100
+
101
+ ## 当前档位主模型手动检测
102
+
103
+ 档位配置页新增用户点击、确认后触发的主模型检测,按已配置的 L1–L4 model/effort 去重,排除备用。网页 verify 动作只接受必填配置版本,固定映射为 `models check --verify`;不开放单独模型、目录或批量扫描参数。复用已有期限、配置冲突保护、身份核验与记录保存。浏览器覆盖未安装/非当前/草稿禁用、取消零请求、执行中防重复、成功与失败反馈、配置变化失效,原配置与账号流程不自动检测。
104
+
105
+ ## 使用边界
106
+
107
+ Skill 由 AGENTS 入口及角色指令要求读取,没有宿主委派拦截器。模型目录列出不证明账号请求权限;实际验证使用独立 Responses 请求,无工具和项目材料;请求成功与供应商报告的身份分别核验。缺少身份元数据仍不通过,不验证供应商内部上游路由。此前 0.6.0 验收时,真实供应商对 Astra/ultra 返回 HTTP 400 / model_not_found,失败记录已保存。当时从该供应商 /models 读取到 13 个候选,其中无 Astra;目录来源及结果已按 home 保存,未自动执行真实批量推理。第三方候选通过自己的 /responses 验证,默认参数可调用与指定强度严格验证分别呈现,目录变化后停止批量调用。
108
+
109
+ 未验证其他操作系统、全部 Node 22.x、真实桌面会话加载、读屏器、真实 ChatGPT OAuth 推理或系统凭据库授权验证。多文件操作不保证断电/崩溃时整体原子;残留锁需人工核对。并发保护不提供对恶意本机进程的内核级比较交换。
110
+
111
+ ## 2026-10-19 委派规则页重设计
112
+
113
+ 按确认方案将职责优先的四下拉框查询改为等级与任务路由总览:默认显示当前作用域的生效档位及继承来源,其他档位明确只读预览;L1–L4 默认组合和各级适用任务候选直接可见,缺失候选明确标记,不从包内定义补入已安装快照。点击路由查询依据、备用及条件,职责权限和技术信息按需展开;high/fire 的最高强度授权边界与 fire 会话验证要求保持可见。编辑入口前往档位配置,不直接写入。
114
+
115
+ 桌面右侧固定详情区域,窄屏将详情移到所选等级下。查询前清除旧解释,失败可重试;报告版本、档位、等级、任务、作用域及主组合须与当前展示一致,版本冲突后刷新再查。修复键盘选择路由后因加载期间禁用按钮造成的焦点丢失;正常完成后恢复焦点,错误时保留错误反馈焦点。
116
+
117
+ 验证:174 项 Node 测试通过;Chrome 集成覆盖四级与候选展示、high/fire 预览、当前/预览区分、自定义候选读取、编辑跳转、作用域继承、键盘焦点、等待状态清除旧结果、失败重试、版本冲突、恢复及原有账号/配置流程。四页在 375/768/1280/1440px 无页面横向溢出,规则页 200% 文字无横向溢出,零脚本错误,导航与查询不触发模型检测。语法检查与 diff 空白检查通过。
118
+
119
+ 本地实际 home 仅做只读查询:当前 official 旧快照的缺失任务候选显示“未配置”,cut 包定义可只读预览完整候选;桌面与手机两次浏览器实测均无配置写入、无模型请求。未更新真实 home 的规则或档位;未执行真实模型推理、读屏器及其他浏览器验证。截图保存在当前任务的可视化目录,未加入发布资产。