@fanglinwei/agent-fit 0.8.0 → 0.9.0
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/.codex-plugin/plugin.json +1 -1
- package/README.md +33 -131
- package/VERSION +1 -1
- package/adapters/codex/model-bindings.json +7 -0
- package/adapters/codex/modes.json +112 -112
- package/adapters/codex/skills/agent-fit/SKILL.md +11 -10
- package/adapters/codex/skills/agent-fit/assets/AGENTS.fragment.md +2 -2
- package/adapters/codex/skills/agent-fit/assets/codex/agents/task-execute.toml +0 -2
- package/adapters/codex/skills/agent-fit/assets/codex/agents/task-review.toml +0 -2
- package/adapters/codex/skills/agent-fit/assets/codex/agents/task-scan.toml +0 -2
- package/adapters/codex/skills/agent-fit/evals/evals.json +44 -0
- package/adapters/codex/skills/agent-fit/references/calibration.md +8 -2
- package/adapters/codex/skills/agent-fit/references/configuration.md +11 -2
- package/adapters/codex/skills/agent-fit/references/dispatch-contract.md +15 -1
- package/adapters/codex/skills/agent-fit/references/failure-policy.md +4 -4
- package/adapters/codex/skills/agent-fit/references/task-routing.md +19 -19
- package/bin/agent-fit.mjs +16 -5
- package/docs/README.md +10 -12
- package/docs/implementation-review.md +24 -140
- package/docs/usage.md +78 -154
- package/lib/codex.mjs +24 -3
- package/lib/install.mjs +85 -21
- package/lib/models.mjs +6 -3
- package/lib/scopes.mjs +1 -1
- package/package.json +1 -1
- package/web/app.js +3 -3
- package/adapters/codex/profiles/terra-evaluation.json +0 -134
|
@@ -1,153 +1,37 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 验证范围
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
本页保留最近版本的已有验收及限制,不是实时发布状态。操作方法见[使用说明](usage.md),版本过程见 [Git 历史](https://github.com/fanglinwei/agent-fit/commits/main/)。
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## 0.8.1 验收记录
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
记录日期:2026-11-18。环境为 macOS、Node.js 26.12.0、npm 12.2.0;本次修改委派规则、说明文档与测试资料,不改 CLI 或网页运行逻辑。
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
Node 测试 213 项全部通过;Chrome 验证专长查询与备用展示,并通过既有配置、作用域和恢复流程,四页在 375/768/1280/1440px 无溢出、零脚本错误。语法及 diff 空白检查通过;这些检查使用隔离 home 和模拟模型接口,本次未追加真实模型推理评测。
|
|
12
|
-
|
|
13
|
-
## 2026-11-02 Terra 候选与分发边界
|
|
14
|
-
|
|
15
|
-
保留四个内置档位的原基线、候选与备用。Terra 6.1 保存为独立冻结定义,仅替换 official 的 L2 bounded 和 L3 complex,实验路由的备用为 null;通过现有自定义档位导入与非活动预览,不增加第五个内置档位或自动分类调用。
|
|
16
|
-
|
|
17
|
-
规则明确能力检查、基线与候选的选择边界、同级基线的质量接续及相同组合不算升级。新模型先在独立任务上校准,主组合与备用分别判定;缺少证据时保留默认。
|
|
18
|
-
|
|
19
|
-
Node 测试 212 项全部通过,新增 CLI 回归核对导入、预览、空备用、完整快照及当前选择与角色保持不变。发布包预检包含候选定义,网页脚本语法及 diff 空白检查通过。未修改真实 home,未执行真实模型对照或浏览器回归;配置结果不证明能力、提速或费用优势。
|
|
20
|
-
|
|
21
|
-
## 2026-10-30 Agent Fit 0.7.4
|
|
22
|
-
|
|
23
|
-
本版保持 Agent Fit 名称,README 明确“AI 模型与推理资源调配”的定位。汇总共享 Skill 完整性与独立修订号、流式验证失败/未完成/重复终止保护、请求成功/响应身份/会话上下文/fire 门槛的分离,以及历史保存失败的未完成状态。Skill 主流程与完整交接契约整理后,只对两份参考文档做同文件去重,保留分级、映射、授权、次数及预算边界;没有增加 Hooks、日常分类调用或持续日志。
|
|
24
|
-
|
|
25
|
-
依用户要求,本版按全新安装提供,不新增旧版本兼容逻辑。既有其他版本配置应先由对应旧版恢复,再安装新版。配置与规则测试不证明通用模型能力、提速或实际省钱;模型映射与备用不因单次评测而调整。
|
|
26
|
-
|
|
27
|
-
本版发布前 Node 测试211项全部通过,0失败或跳过;Chrome配置、自定义、三层作用域、账号与恢复流程通过,四页在375/768/1280/1440px无横向溢出,脚本错误0。测试使用隔离home与模拟账号/供应商,没有真实模型请求;本轮未执行插件管理界面安装、跨平台验证或付费模型复评。
|
|
28
|
-
|
|
29
|
-
## 2026-10-19 npm 公开包命名
|
|
30
|
-
|
|
31
|
-
npm 注册表以与现有 agentfit 名称过于相似为由拒绝发布无作用域的 agent-fit;v0.7.0 仅完成 GitHub 发布。经用户确认,v0.7.1 改用 npm 公开包 @fanglinwei/agent-fit;GitHub 仓库、可执行命令和 Skill 名继续使用 agent-fit。安装、卸载、npm exec 与本地打包文档同步采用实际包名和文件名,历史版本与校准证据保留原文。此补丁只调整包名、版本、文档及对应的包入口断言,不改变运行逻辑。
|
|
32
|
-
|
|
33
|
-
## 2026-10-19 Agent Fit 0.7.0 发布验证
|
|
34
|
-
|
|
35
|
-
GitHub 仓库、npm 包、CLI 和 Skill 统一使用 agent-fit,展示名称为 Agent Fit。本版汇总三层作用域、同级任务候选、自定义档位快照、委派路由总览、账号管理、手动主模型检测及配置操作零模型请求等当前功能。README 按安装、选择、查询和恢复重写;仓库链接与当前版本文档同步更新。只支持当前格式与版本,不增加旧用户迁移或兼容入口,历史校准输入保留原文。
|
|
36
|
-
|
|
37
|
-
发布复核修复了恢复页只统计当前作用域的问题:预览和最终确认改用后端的全 home 自定义档位清单,预览前不再断言不存在自定义档位。新增浏览器场景在项目与会话各建独有档位,从全局页面恢复,核对两处清单均完整;新回归在旧实现下失败,修复后通过。同时纠正自定义档位删除说明,并明确故障备用从本任务有效作用域的 task_profile 快照读取,避免误用全局基线。
|
|
38
|
-
|
|
39
|
-
本版 Node 测试 184 项通过,0 失败或跳过。Chrome 完整配置、自定义、三层作用域、路由查询、账号与恢复流程通过;四页在 375/768/1280/1440px 无横向溢出,零脚本错误。语法与 diff 空白检查通过。配置与浏览器测试使用临时 home 和模拟账号/供应商,不修改真实 home,也不执行真实模型推理;这些结果不证明模型能力或供应商可调用性。
|
|
40
|
-
|
|
41
|
-
## 2026-10-19 同级任务候选与 Astra 授权
|
|
42
|
-
|
|
43
|
-
L1–L4 保持推理复杂度分级,cut/official 每级可包含 tasks 候选及各自备用。查询新增 --task,按 mechanical、bounded、scan、deep、complex、uncertain、reasoning 选择完整组合;latency 仅使用显式配置,不自动启用 Terra。旧定义可继续查等级基线,显式候选缺失或类型/等级不符时拒绝查询,不从包内映射猜值。
|
|
44
|
-
|
|
45
|
-
普通自动 Astra 候选为 low/medium;有推理不足证据时可在同级由 low 升 medium,继续计入原任务三次总额。依用户确认,high/fire 保留最高强度,明确选择即授权其展示组合,预览不构成授权;预算、宿主支持、fire 验证与写入者停止规则保持有效。查询区分已选择的最高强度和仅预览。
|
|
46
|
-
|
|
47
|
-
候选随复制、自定义保存、三层作用域与完整任务快照保存。单级修改保留任务候选,整表 JSON 或网页每级候选 JSON 可编辑或清空;无效输入、刷新与冲突保留草稿,错误链接可聚焦编辑框。网页新增任务类型查询,修正等级名称与职责混用。手动模型检测覆盖基线和候选的去重主组合,排除备用;official 当前为 9 个组合,确认框展示数量与费用提示,不自动执行检测。
|
|
48
|
-
|
|
49
|
-
Node 测试 171 项全部通过;Chrome 完整配置、候选编辑/查询、无效 JSON 保留、三层切换、账号与恢复通过,四页在 375/768/1280/1440px 无溢出且零脚本错误。Skill 校验通过。此次仅验证规则与配置链路,没有执行真实模型推理、比较成本或延迟,候选能力仍待独立任务校准;未部署至真实 home。
|
|
50
|
-
|
|
51
|
-
## 2026-10-19 日常切档无需重启
|
|
52
|
-
|
|
53
|
-
普通全局、项目和会话切档、活动自定义档位的模型/effort 调整及重复设置统一返回无需重启。首次安装、基础 Skill/AGENTS/角色职责更新及实际恢复仍要求重启;卸载前先恢复的规则保持有效。共享写报告区分基础规则变化和路由数据变化,CLI、网页结果与预览沿用同一判断;状态查询不再无条件提示重启。
|
|
54
|
-
|
|
55
|
-
Node 测试 167 项通过,包含全局切档、活动自定义更新、三层作用域、预览零写入,以及已归属的旧 Skill、AGENTS 和角色职责更新仍提示重启。Chrome 配置、账号、三层切换、自定义与恢复流程通过;375/768/1280/1440px 四页无溢出,零脚本错误。Skill 校验与 diff 空白检查通过。
|
|
56
|
-
|
|
57
|
-
宿主证据来自 Codex 0.162.1:同一进程、同一会话下一轮重新加载全局角色模型/effort 绑定。该证据只证明配置加载,未运行子代理云端推理,不证明实际模型身份。已开始任务沿用原快照;本次源码更新未自动部署至真实 home。
|
|
58
|
-
|
|
59
|
-
## 2026-10-19 更名为 Agent Fit
|
|
60
|
-
|
|
61
|
-
项目目录、npm 包、唯一可执行命令、Skill 名称及目录统一为 agent-fit,展示名称为 Agent Fit。入口为 bin/agent-fit.mjs;新安装使用 skills/agent-fit、.agent-fit、.agent-fit-checks 和 agent-fit AGENTS 标记。档位、模型映射、角色名称及三层作用域行为保持原有语义。GitHub 仓库地址暂沿用原地址,冻结的研究与校准证据不改写。
|
|
62
|
-
|
|
63
|
-
只管理 agent-fit 的当前安装状态。配置格式、版本、归属、摘要、锁和恢复基线仍按当前安装校验。
|
|
64
|
-
|
|
65
|
-
移除旧安装识别与阻断、迁移说明及两项专用测试后,Node 测试 166 项全部通过。Skill 校验及 diff 空白检查通过;实际 home 只读查询成功,网页应用按钮正常启用,无脚本错误,未执行配置写入或模型验证。
|
|
66
|
-
|
|
67
|
-
## 2026-10-19 三层作用域
|
|
68
|
-
|
|
69
|
-
有效档位按会话 > 项目 > 全局整份解析。新增 home 内受管理的 scopes.json,复用既有锁、版本预检、原子替换、回滚与恢复基线;已有同版本全局安装可直接读取,无需迁移。项目以规范化 worktree 根隔离,会话以目标线程隔离;非 Git 项目显式指定路径,缺少会话身份不降为全局。
|
|
70
|
-
|
|
71
|
-
CLI 新增 --scope/--project/--thread、清除选择和受引用保护的自定义删除。局部修改上层自定义档位先复制,清除选择保留定义。显式作用域 explain 使用未固定的 task_delegate,返回完整 task_profile 与来源供主代理保存任务快照;重试、升级和备用沿用快照属于 Skill 指令约束,工具不拦截宿主派发。
|
|
72
|
-
|
|
73
|
-
网页明确选择作用域,展示有效来源,线程未绑定时禁用会话选项;上下文由服务绑定,不接受网页任意传入其他项目或线程。手动主模型检查使用页面作用域的有效档位,去重并排除备用;配置与切换不触发模型请求。
|
|
74
|
-
|
|
75
|
-
Node 测试 166 项通过;包含三层优先级、项目与线程隔离、局部复制、引用保护、清除继承、预览零写入、并发版本冲突、回滚、权限、损坏配置阻断、完整任务快照及作用域主模型检查。Chrome 完整配置/账号/恢复流程与三层切换、继承来源、页面恢复通过;375/768/1280/1440px 四页无溢出、零脚本错误。RPC 超时测试使用已就绪快照隔离文件系统负载,仍验证超时分类与子进程关闭。
|
|
76
|
-
|
|
77
|
-
未执行真实模型推理,也未在桌面宿主创建、恢复或 fork 聊天验证实际模型 metadata。临时 home 与模拟供应商证明工具解析和请求边界,不证明模型可用性或主代理遵循 Skill 的运行结果。
|
|
78
|
-
|
|
79
|
-
## 2026-10-19 派发角色与接续规则核验
|
|
80
|
-
|
|
81
|
-
非活动档位及未安装时的 explain 预览统一返回 task_delegate,候选 model/effort 与原权限契约保持不变;只有活动档位的匹配固定角色可被推荐,L4 仍使用 task_delegate。回归先出现预期失败,再通过修复;覆盖内置与自定义预览、未安装预览、活动自定义、同组合候选以及查询零配置改动。
|
|
82
|
-
|
|
83
|
-
自定义档位的本级非空 fallback 在用户选择该档位且满足原条件与预算后允许自动接续,包括复制的备用;仅创建、保存或预览不构成选择。null、用户模型锁定及其他停止条件继续阻断接续,不套用 fire 的继承规则。
|
|
84
|
-
|
|
85
|
-
Node 测试 157 项通过,零失败或跳过;Skill 校验与 diff 空白检查通过。源码 docs/calibration/ 中保留冻结输入、独立预期和完整决策记录:改动前一批 11/12 符合目标验收,自定义授权语义未闭环;更新后一批 12/12 符合。两个批次均只读判断,未执行案例 worker,实际模型身份及宿主接续未验证;不据此调整 L1–L4 或默认映射,不构成模型能力比较。
|
|
86
|
-
|
|
87
|
-
## 当前约定
|
|
88
|
-
|
|
89
|
-
- 内置档位的命令、配置 id、状态记录、生成 JSON、查询和网页统一为 `cut / official / high / fire`,不保留名称映射。
|
|
90
|
-
- Skill 名称、目录和调用方式统一为 `agent-fit` / `skills/agent-fit` / `$agent-fit`;CLI 为 `agent-fit`。
|
|
91
|
-
- 仅支持当前状态格式和版本,只管理 agent-fit 安装。
|
|
92
|
-
- 不支持的状态格式、路径或档位引用返回 `STATE_INVALID`;版本不一致返回 `VERSION_MISMATCH`。校验在写入前完成,不转换或覆盖已有配置。
|
|
93
|
-
- 当前版本的同版本重复配置、档位切换、自定义和首次恢复基线保持有效。
|
|
94
|
-
|
|
95
|
-
## 保留的能力
|
|
96
|
-
|
|
97
|
-
四种内置档位、自定义四级主/备用组合、状态和选择解释、CLI 账号/目录检查、网页账号配置及真实 CLI 配置操作,以及首次安装、基础规则更新与恢复后的重启提醒;日常档位切换无需重启。安装、设置/激活及应用自定义修改不自动检查模型;网页账号页只管理授权与登录,目录查询通过 CLI 手动发起,当前主模型可在档位页点击检测。
|
|
98
|
-
|
|
99
|
-
状态与恢复记录、文件归属、路径、符号链接、权限、摘要、版本冲突和独占锁继续校验。逐文件原子替换、普通失败回退和并发编辑保护继续生效。恢复保留安装前内容、管理区块外修改及无关文件。
|
|
100
|
-
|
|
101
|
-
委派规则继续保留用户选择优先、难度与职责分离、禁止递归、独占写入、局部阻断、最小充分验证及 PARTIAL 返回。
|
|
102
|
-
|
|
103
|
-
## 验证
|
|
104
|
-
|
|
105
|
-
环境:macOS、Node.js 26.12.0,以及已有 Chrome / Playwright。所有配置测试使用临时 home。
|
|
106
|
-
|
|
107
|
-
| 检查 | 结果 |
|
|
9
|
+
| 检查 | 已记录结果 |
|
|
108
10
|
| --- | --- |
|
|
109
|
-
| Node 测试 |
|
|
110
|
-
|
|
|
111
|
-
|
|
|
11
|
+
| Node 测试 | 213 项通过,0 失败;旧试验导入案例已改为自包含候选,保留配置导入、预览与不激活的断言 |
|
|
12
|
+
| Skill 与文档 | 官方 `quick_validate.py`、相对链接、版本一致性与 diff 空白检查通过;校验依赖仅装在临时虚拟环境 |
|
|
13
|
+
| 发行包 | 隔离安装、setup 预览及实际配置、Terra 专长查询、Skill 完整性、restore 预览及实际恢复通过 |
|
|
14
|
+
| 委派场景 | 3 个场景中新旧版均通过 12/12 项断言;[结果与限制](https://github.com/fanglinwei/agent-fit/blob/main/docs/calibration/2026-11-18-delegation-principles.md)不证明实际性能提升 |
|
|
15
|
+
| 资料清理 | 73 个旧校准文件、试验定义及试跑产物已在仓库外归档并核对 SHA-256;现役回归与委派场景保留,历史证据入口已更新 |
|
|
112
16
|
|
|
113
|
-
|
|
17
|
+
源码规则、README 与使用说明已同步;已安装 Codex Skill 的完整文件摘要未变化。未重新执行浏览器回归、真实模型推理或跨平台验证;0.8.0 的浏览器结果仅作为历史记录。
|
|
114
18
|
|
|
115
|
-
##
|
|
19
|
+
## 0.8.0 验收记录
|
|
116
20
|
|
|
117
|
-
|
|
21
|
+
记录日期:2026-11-02。环境为 macOS、Node.js 和 Chrome / Playwright;配置与模型接口测试使用隔离 home 及模拟响应。
|
|
118
22
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
## 当前档位主模型手动检测
|
|
23
|
+
| 检查 | 已记录结果 |
|
|
24
|
+
| --- | --- |
|
|
25
|
+
| Node 测试 | 213 项通过;覆盖配置、三层作用域、自定义与任务候选、规则完整性、查询、恢复、账号、模型检查及本地服务 |
|
|
26
|
+
| Chrome 集成 | 专长查询及备用展示、配置、作用域和恢复通过;四页在 375/768/1280/1440px 无横向溢出,零脚本错误 |
|
|
27
|
+
| 静态检查 | 语法与 diff 空白检查通过 |
|
|
126
28
|
|
|
127
|
-
|
|
29
|
+
上述检查不证明模型能力、供应商可调用性或当前安装已更新。复验命令见[开发验证](usage.md#开发验证);本页不会把旧计数当作后续提交的验证结果。
|
|
128
30
|
|
|
129
31
|
## 使用边界
|
|
130
32
|
|
|
131
|
-
Skill
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
按确认方案将职责优先的四下拉框查询改为等级与任务路由总览:默认显示当前作用域的生效档位及继承来源,其他档位明确只读预览;L1–L4 默认组合和各级适用任务候选直接可见,缺失候选明确标记,不从包内定义补入已安装快照。点击路由查询依据、备用及条件,职责权限和技术信息按需展开;high/fire 的最高强度授权边界与 fire 会话验证要求保持可见。编辑入口前往档位配置,不直接写入。
|
|
138
|
-
|
|
139
|
-
桌面右侧固定详情区域,窄屏将详情移到所选等级下。查询前清除旧解释,失败可重试;报告版本、档位、等级、任务、作用域及主组合须与当前展示一致,版本冲突后刷新再查。修复键盘选择路由后因加载期间禁用按钮造成的焦点丢失;正常完成后恢复焦点,错误时保留错误反馈焦点。
|
|
140
|
-
|
|
141
|
-
验证:174 项 Node 测试通过;Chrome 集成覆盖四级与候选展示、high/fire 预览、当前/预览区分、自定义候选读取、编辑跳转、作用域继承、键盘焦点、等待状态清除旧结果、失败重试、版本冲突、恢复及原有账号/配置流程。四页在 375/768/1280/1440px 无页面横向溢出,规则页 200% 文字无横向溢出,零脚本错误,导航与查询不触发模型检测。语法检查与 diff 空白检查通过。
|
|
142
|
-
|
|
143
|
-
本地实际 home 仅做只读查询:当前 official 旧快照的缺失任务候选显示“未配置”,cut 包定义可只读预览完整候选;桌面与手机两次浏览器实测均无配置写入、无模型请求。未更新真实 home 的规则或档位;未执行真实模型推理、读屏器及其他浏览器验证。截图保存在当前任务的可视化目录,未加入发布资产。
|
|
144
|
-
|
|
145
|
-
## 2026-10-30 评测问题修复
|
|
146
|
-
|
|
147
|
-
共享 Skill 现在核对 manifest 的结构、完整资产列表和实际摘要;缺引用、正文修改与清单损坏分别诊断。status、mode show、explain 和 skill path 暴露独立 skill_revision / skill_integrity,home 的 configuration_revision 不随共享规则改变。查询和安全恢复仍可执行;规则要求新派发前确认完整性为 clean,工具不充当宿主拦截器,也不自动覆盖用户修改。
|
|
148
|
-
|
|
149
|
-
Responses SSE 只有唯一的 response.completed 且内部 status=completed 才能继续严格验证;failed、incomplete、重复或冲突终止不能通过。模型检查分开呈现请求、响应身份、会话匹配和 fire 门槛;CLI 不证明正在聊天的会话身份。历史保存失败保留 check_status,整体 status=incomplete、非零退出。pair 的来源和适用性描述检查结束时,历史值不能替代当前配置或会话证据。
|
|
150
|
-
|
|
151
|
-
浏览器测试入口复用用户 home 隔离,断言共享 Skill 安装在临时 home。主 Skill 改为六步流程,安装、作用域与 fire 细则移到引用,并新增派发契约及明确的累计次数字段。
|
|
152
|
-
|
|
153
|
-
验证:211 项 Node 测试通过,0 失败或跳过;浏览器完整配置、自定义、冲突保留、作用域、解释与恢复流程通过,四页在 375/768/1280/1440px 零运行错误。新增完整性与 SSE 回归先在旧实现失败,修复后通过。冻结原版与候选版各核验12个边界案例,均12/12;各版仅一个独立上下文,启动规则存在旧版污染,不能据此声称质量、速度或成本提升。默认映射未调整,未安装到实际 home,未执行真实多模型业务校准。
|
|
33
|
+
- Skill 与 AGENTS 提供指令约束,CLI 不拦截宿主派发,也不强制执行自然语言权限。
|
|
34
|
+
- 磁盘配置、宿主加载、供应商响应身份和当前会话匹配分别核验;独立 CLI 检查不能替代 fire 的会话验证。
|
|
35
|
+
- 校准结果只覆盖冻结任务。当前委派场景与历史校准证据从[文档导航](README.md)查阅;过期试验定义与原始输出不随发行包交付,不据此承诺通用质量、提速或费用优势。
|
|
36
|
+
- Linux/Windows、其他客户端、全部 Node 22.x、读屏器、真实 ChatGPT OAuth 推理、系统凭据库及长期稳定性仍需分别验证。
|
|
37
|
+
- 多文件更新采用逐文件原子替换和普通失败回退;不保证断电或崩溃时整体原子,也不防御恶意本机进程。残留锁须人工核对。
|