@fanglinwei/agent-fit 0.7.3 → 0.7.4

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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-fit",
3
- "version": "0.7.3",
3
+ "version": "0.7.4",
4
4
  "description": "为 Codex 已获授权的子任务选择模型、推理强度和备用组合;需要 agent-fit CLI。",
5
5
  "author": {
6
6
  "name": "fanglinwei",
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Agent Fit
2
2
 
3
- **为 Codex 子任务匹配模型与推理强度。**
3
+ **面向 Codex 子任务的 AI 模型与推理资源调配工具。**
4
4
 
5
- Agent Fit 将任务复杂度、模型档位和委派职责放进一套可查询、可配置、可恢复的规则中。先判断是否值得委派,再为需要委派的任务选择模型、推理强度和备用组合,适用于研究、写作、数据分析、规划、开发与审查。
5
+ Agent Fit 根据任务复杂度、质量要求和预算,为已获授权的子任务匹配模型、推理强度和备用组合。先判断是否值得委派,再决定投入多少推理资源;支持研究、写作、数据分析、规划、开发与审查。模型档位、委派职责与配置来源均可查询和恢复。
6
6
 
7
7
  [快速开始](#快速开始) · [四种档位](#四种档位) · [作用域](#按会话项目或全局配置) · [完整文档](docs/usage.md) · [更新记录](https://github.com/fanglinwei/agent-fit/releases)
8
8
 
@@ -13,27 +13,31 @@ Agent Fit 将任务复杂度、模型档位和委派职责放进一套可查询
13
13
  - **会话、项目、全局三层作用域**:优先级为会话 > 项目 > 全局。聊天切换默认仅影响当前聊天,项目按 Git worktree 隔离,已开始任务沿用原快照。
14
14
  - **CLI 与本地配置页面**:查看和编辑档位、浏览委派路由与选择依据、管理账号授权、预览和执行恢复。网页操作复用 CLI,只监听 `127.0.0.1`。
15
15
  - **配置与模型检测分开**:安装、切档和保存配置只处理本地文件。需要时手动查询目录或验证模型,网页检测前确认主组合和费用。
16
+ - **配置与规则完整性分别检查**:识别共享 Skill 文件缺失、内容修改和清单异常,分别报告配置与规则修订号;规则异常时保留查询和安全恢复能力。
17
+ - **受控接续与完整交接**:区分前提缺失、质量升级与故障备用,保存任务完整快照;交接明确职责、权限、独占范围和验收,所有接续共用次数与预算。
16
18
  - **可检查、可恢复**:提供状态诊断、职责核对、配置冲突保护及首次安装前的恢复基线;保留无关配置和管理区块之外的修改。
17
19
 
18
- 当前面向 **Codex**,需要 **Node.js 22+** 和支持独立角色 TOML 的 Codex 客户端。已在 macOS 与 Codex CLI 0.162.1 验证相关配置和账号接口,其他环境的验证范围见[实施验收记录](docs/implementation-review.md)。项目处于内测阶段,处理当前配置,并支持 0.7.1 旧目录布局的显式迁移。
20
+ 当前面向 **Codex**,需要 **Node.js 22+** 和支持独立角色 TOML 的 Codex 客户端。已在 macOS 与 Codex CLI 0.162.1 验证相关配置和账号接口,其他环境的验证范围见[实施验收记录](docs/implementation-review.md)。项目处于内测阶段;v0.7.4 按全新安装提供,不增加旧版本配置兼容。
19
21
 
20
22
  ## 快速开始
21
23
 
22
- 安装命令行工具,预览并应用官方档位:
24
+ 从 [v0.7.4 Release](https://github.com/fanglinwei/agent-fit/releases/tag/v0.7.4) 下载 `fanglinwei-agent-fit-0.7.4.tgz`,在下载目录安装,预览并应用官方档位:
23
25
 
24
26
  ```sh
25
- npm install -g @fanglinwei/agent-fit
27
+ npm install -g ./fanglinwei-agent-fit-0.7.4.tgz
26
28
  agent-fit setup --mode official --dry-run
27
29
  agent-fit setup --mode official
28
30
  ```
29
31
 
30
- npm 包名为 [`@fanglinwei/agent-fit`](https://www.npmjs.com/package/@fanglinwei/agent-fit),安装后的命令和 Skill 名为 `agent-fit`。
32
+ npm 包名为 [`@fanglinwei/agent-fit`](https://www.npmjs.com/package/@fanglinwei/agent-fit),安装后的命令和 Skill 名为 `agent-fit`。也可用 `npm install -g @fanglinwei/agent-fit` 获取 npm 当前已发布版本;GitHub Release 与 npm registry 的版本以各自页面为准。
33
+
34
+ **已有其他版本配置时,不要直接用新版覆盖。** 先保留需要的自定义方案,并用原版本 CLI 对原绑定 home 按[恢复与卸载](#恢复与卸载)完成预览及实际恢复,再安装新版并重新 setup。v0.7.4 不自动迁移旧档位或恢复记录。
31
35
 
32
36
  **首次配置完成后重启 Codex。** 安装 npm 包本身不会修改 Codex;`setup` 才会写入四个委派角色、AGENTS 管理区块和档位数据,并在共享 Skill 不存在时安装规则。默认目标为 `CODEX_HOME` 或 `~/.codex`,可通过 `--codex-home "/path/to/codex-home"` 指定独立目录。
33
37
 
34
38
  Skill 默认放在 `~/.agents/skills/agent-fit/`,可由 CCSwitch 统一管理。动态档位存于对应 home 的 `.agent-fit/current-mode.json`,多个 home 共用规则但配置独立。`status`、`explain` 和 `skill path` 只读;日常切档和 `restore` 不改写或删除共享 Skill。
35
39
 
36
- 从 0.7.1 迁移时,先执行 `agent-fit setup --dry-run`,再执行 `agent-fit setup`。旧目录保留、移除或软链接到共享目录均可识别;迁移验证安装记录,冲突时保留现场。已有共享规则需要更新时,显式执行 `agent-fit skill update --dry-run` 和 `agent-fit skill update`。完整边界见[目录与迁移](docs/usage.md#skill-目录与旧安装迁移)。
40
+ 已有共享规则需要单独更新:先执行 `agent-fit skill update --dry-run`,核对后再执行 `agent-fit skill update`;`setup` 不覆盖现有共享规则。发现用户修改或归属冲突时保留现场,不直接删除目录来绕过保护。完整边界见[Skill 目录说明](docs/usage.md#skill-目录与旧安装迁移)。
37
41
 
38
42
  打开本地配置页面:
39
43
 
@@ -134,7 +138,7 @@ agent-fit models check --verify
134
138
 
135
139
  网页账号页管理已有授权、登录、取消授权和退出登录;档位页的“检测当前档位主模型”按组合去重,排除备用,并在执行前确认。保存或切换配置不会自动检测模型。
136
140
 
137
- 实际验证通过独立 Responses 请求进行,不启动带项目材料的 Codex 任务或工具执行器。请求成功、供应商返回的身份与配置是否生效分别核验;检测结果不代替 `fire` 的会话验证。供应商目录、批量可用性检查和验证边界见[模型检查](docs/usage.md#模型检查)。
141
+ 实际验证通过独立 Responses 请求进行,不启动带项目材料的 Codex 任务或工具执行器。请求成功、供应商返回的身份与当前聊天上下文匹配分别报告;独立 CLI 检查通过不代替 `fire` 的会话验证。失败、未完成或矛盾的流式终止结果不计为成功;检查历史保存失败时,整条命令报告未完成。供应商目录、批量可用性检查和验证边界见[模型检查](docs/usage.md#模型检查)。
138
142
 
139
143
  ## 委派规则如何生效
140
144
 
@@ -142,6 +146,8 @@ agent-fit models check --verify
142
146
 
143
147
  共同规则包括先权衡委派收益与协调成本、保留用户授权和预算、区分复杂度与职责、明确独占写入范围、禁止递归委派,以及完成最小充分验证。质量升级与故障备用分别判断,初次派发、重试和接续共用每任务最多三次委派。
144
148
 
149
+ `status`、`mode show`、`explain` 和 `skill path` 分别报告配置与共享规则的状态。委派前核对 `skill_integrity` 为 `clean`,并保存 `skill_revision` 与完整任务档位快照;CLI 查询成功不等于规则完整,也不证明模型实际可用。共享规则异常时先修复受影响部分。
150
+
145
151
  这些规则由宿主读取并遵循;工具提供配置与解释,不自动派发任务,也没有宿主级委派拦截器。实际模型身份、能力和成本需要独立证据。完整契约见 [Skill](adapters/codex/skills/agent-fit/SKILL.md),预设评估方法见[离线校准指南](adapters/codex/skills/agent-fit/references/calibration.md)。
146
152
 
147
153
  ## 恢复与卸载
@@ -168,7 +174,7 @@ npm test
168
174
  npm pack
169
175
  ```
170
176
 
171
- 本地打包产物为 `fanglinwei-agent-fit-0.7.3.tgz`,可用 `npm install -g ./fanglinwei-agent-fit-0.7.3.tgz` 安装。浏览器集成使用已有 Playwright 与 Chrome,运行方法见[开发验证](docs/usage.md#开发验证)。唯一运行依赖为 [smol-toml](https://github.com/squirrelchat/smol-toml)。
177
+ 本地打包产物为 `fanglinwei-agent-fit-0.7.4.tgz`,可用 `npm install -g ./fanglinwei-agent-fit-0.7.4.tgz` 安装。浏览器集成使用已有 Playwright 与 Chrome,运行方法见[开发验证](docs/usage.md#开发验证)。唯一运行依赖为 [smol-toml](https://github.com/squirrelchat/smol-toml)。
172
178
 
173
179
  ## License
174
180
 
package/VERSION CHANGED
@@ -1 +1 @@
1
- 0.7.3
1
+ 0.7.4
@@ -6,34 +6,28 @@ license: MIT
6
6
 
7
7
  # Agent Fit
8
8
 
9
- Codex 启动后读取本 Skill;每次创建、重新委派或切换子智能体模型前,执行下面流程。新任务通过绑定 Codex home 的 CLI 按下述作用域查询有效档位。本 Skill 不指定主代理模型,不授予委派权限,不替代专业规则。
9
+ 目标是在满足原验收与预算的前提下,为已获授权的子任务匹配模型与推理强度。在启动和每次已获授权的派发、重试或换模型前使用本流程。不指定主代理模型,不授予委派权限,不替代项目或专业规则。CLI 查询和规则是辅助契约,不是宿主派发拦截器。
10
10
 
11
- 本目录只保存可共享的规则与说明,可由 CCSwitch 放在 `~/.agents/skills/agent-fit/`。当前档位、项目与会话配置属于各自 Codex home;全局快照存于 `<home>/.agent-fit/current-mode.json`,有效配置通过 `agent-fit explain` 查询。目录中遗留的 `references/current-mode.json` 是旧安装文件,不能作为当前配置。规则入口用 `agent-fit skill path --codex-home <绑定 home> --json` 查询;退出码为 0 且 `errors` 为空后读取 `data.path`。
11
+ 先用 `agent-fit skill path --codex-home <绑定 home> --json` 定位并读取规则。退出码须为 0、`errors` 为空;核对 `data.skill_integrity`,规则未核验或不完整时先修复受影响的派发前提。通用规则可共享在 `~/.agents/skills/agent-fit/`;动态档位属于绑定 home,不读取 Skill 目录内旧 `references/current-mode.json`。
12
12
 
13
- ## Marketplace 插件前提
13
+ ## 派发流程
14
14
 
15
- 通过 marketplace 安装本 Skill 后,仍需 Node.js 22+、`@fanglinwei/agent-fit` CLI 和已完成 `setup` 的目标 Codex home。插件安装仅提供规则,不自动安装 CLI、写入角色或切换档位。
15
+ 1. **是否委派**:按下节核对授权、收益、预算、依赖和空闲容量。主会话能完成的短任务直接做,独立读取优先工具并行。
16
+ 2. **判需求**:按歧义、耦合及错误后果与可验证性确定 L1–L4,再选 task 和原职责;不调用额外分类模型。
17
+ 3. **查配置**:按“任务复杂度与组合选择”中的命令查询。核对退出码、封套、上下文、所选组合及规则完整性;失败时读取 [配置查询与失败分流](references/configuration.md#配置查询与失败分流)。
18
+ 4. **冻结证据**:保存 `configuration_revision`、`skill_revision`、`effective_scope` 和完整 `task_profile`(含全部候选与备用)。接续沿用原快照及次数;途中切档或编辑仅影响新任务。
19
+ 5. **派发完整契约**:使用 [派发契约模板](references/dispatch-contract.md)。固定角色仅在 model 和 effort 同时匹配时使用;L4、不匹配、用户指定或继承时用 task_delegate,保留原职责。作用域查询使用 task_delegate,显式 model + effort 和 `fork_turns="none"`,完整交接;核对宿主默认,省略参数不证明继承。
20
+ 6. **核验并返回**:完成下文权限与返回要求。首次失败后先读 [失败处理](references/failure-policy.md) 再决定接续;仅内置 fire 在首次使用前另读 [fire 门槛](references/failure-policy.md#fire-验证与继承备用)。评测或调优时才读 [校准指南](references/calibration.md)。
16
21
 
17
- 首次使用先确认 `agent-fit --version` 可用,再用 `agent-fit status --codex-home <绑定 home> --json` 检查配置。CLI 缺失或尚未配置时,说明缺少的前提并提供 README 中的安装与 setup 步骤;不凭预设猜测有效档位,不自动执行安装或 setup。用户已授权初始化时可按其范围完成配置。插件缓存中的规则由插件更新管理;`agent-fit skill update` 管理的是共享 Skill,不更新插件缓存。
22
+ ## 安装与作用域
18
23
 
19
- ## 卸载前恢复
20
-
21
- 执行本工具的卸载指令(包括 `npm uninstall`、`npm remove`)前,必须先按恢复流程,用可用的本工具版本对原绑定 home 执行 `agent-fit restore --dry-run` 预览,再执行实际 `agent-fit restore`。使用独立 home 时,两步均显式传入相同的 `--codex-home <原路径>`;涉及多个 home 时逐一恢复,不能只恢复默认 home。
22
-
23
- 只有实际恢复成功后才可卸载;退出码须为 0,使用 JSON 时还须确认 `errors` 为空。`--dry-run` 仅预览,不算恢复完成。恢复失败、结果未知或目标 home 无法确认时,停止卸载,保留命令工具、状态与恢复记录,报告原因;不得直接删除包、Skill 或状态目录来代替恢复。
24
+ 首次使用确认 CLI 版本和 `status --codex-home <绑定 home> --json`。插件只提供规则,仍需 Node.js 22+、CLI 和已 setup 的 home;前提缺失时说明安装步骤,不自动安装或初始化。安装/迁移、规则更新、作用域编辑或恢复时读取 [配置说明](references/configuration.md)。插件缓存由插件更新管理,skill update 不更新插件缓存。
24
25
 
25
- ## 全局、项目与会话
26
+ 有效档位为会话 > 项目 > 全局,整份选择,不逐字段合并。聊天切档默认仅 `--scope session`,用户明确指定才改项目/全局。会话必须确认目标主聊天线程 ID;子代理环境 ID 不能冒充,缺失时阻断会话操作,不降为全局。Git 项目按 worktree 根隔离;非 Git 项目显式指定 --project。不同 home 独立,新聊天/fork 不继承会话覆盖;完整清除、复制和引用保护规则见配置说明。
26
27
 
27
- 有效档位优先级为 **会话 > 项目 > 全局**,整份选择 L1–L4 主组合与备用,不逐字段合并。配置仅管理子代理路由,不改变主会话模型或账号认证。
28
-
29
- - 聊天中调用本 Skill 并要求切换档位时,默认执行 `agent-fit mode set <档位> --scope session --project <项目根>`;只有用户明确要求才用 `--scope project` 或 `--scope global`。单纯读取本 Skill 不改变任何选择。
30
- - 会话绑定目标聊天的线程 ID。主会话工具中的 `CODEX_THREAD_ID` 可作为默认值,其他调用者必须显式传入 `--thread <目标聊天 ID>`;子代理的环境 ID 不是主聊天 ID。无法确认目标线程时阻断会话操作,不降为全局。
31
- - Git 项目以当前 worktree 根目录为准;子目录共用,不同 worktree 独立。非 Git 项目明确指定 `--project`,不要把随意的工具工作目录当项目。不同 home 的配置独立。
32
- - 项目/会话选择及其自定义档位保存在绑定 home 的 `.agent-fit/scopes.json`。恢复同一聊天保留选择,新聊天或 fork 不继承会话覆盖。项目移动路径后重新选择项目档位。
33
- - `mode clear --scope session|project` 仅清除该层选择,保留定义并恢复继承;全局 clear 恢复 official。删除自定义定义用 `mode delete`,存在选择引用时阻止删除。较小作用域修改上层自定义档位时先生成局部副本,不覆盖共享定义。
34
- - 每个任务首次派发前记录查询的 `configuration_revision`、`effective_scope` 和完整 `task_profile`,作为该任务快照。后续重试、质量升级与备用接续从此快照按等级取值;途中切换或编辑档位只影响新任务,不重置原任务次数。新任务重新查询。
28
+ ## 卸载前恢复
35
29
 
36
- 作用域查询返回 `task_delegate`,显式传入 model + effort;当前宿主显式组合使用 `fork_turns="none"`,因此交接中必须包含完整目标、必要上下文、原职责与验收。不要为局部切换重写全局角色或主会话模型。首次安装、更新基础规则或恢复原配置后重启宿主;普通全局、项目和会话切档及模型/effort 调整无需重启,全局角色在下一轮加载,后续新任务重新查询。但静态配置和请求参数不证明实际模型身份。
30
+ 卸载前必须对原绑定 home 先 `restore --dry-run`,再实际 `restore`,两步成功且 errors 为空才卸载;多个 home 逐一完成。失败、结果未知或 home 无法确认时停止卸载,保留工具与记录,禁止直接删除代替恢复。[完整恢复规则](references/configuration.md#卸载前恢复)。
37
31
 
38
32
  ## 委派收益检查
39
33
 
@@ -77,36 +71,17 @@ L1–L4 表示任务需求,档位表示资源策略,model + effort 是最终
77
71
 
78
72
  按“档位 id + 最终等级”及同级任务类型(如有)核对同一条配置中的 model、effort;两者含义不同,但按配置成对选择,不临时拼出未配置组合。不假定不同模型的同名 effort 等效,也不假定更高 effort 总比换模型合适。用一句话说明档位 id、等级、任务类型、复杂度依据、保障调整(如有)与所选组合;用户明确组合与原预算优先,无法满足时报告受影响部分。
79
73
 
80
- 复杂度、任务类型与职责由主代理判断;配置查表与 JSON 解析由主代理直接使用工具完成,不为读取映射额外派发子代理。使用 `agent-fit explain --codex-home <绑定 home> --scope session --project <项目根> --level <最终等级> --task <任务类型> --role <原职责> --json`;退出码为 0、顶层 `errors` 为空,且 `data.scope`、`data.context`、`data.effective_scope`、`data.mode_id`、`data.level`、`data.task`、`data.requested_role` 均符合本次目标上下文与选择后,才使用 `data.primary`、`data.dispatch_role`、`data.permission_contract`。定义没有候选或明确使用基线时省略 --task;明确请求的候选缺失则阻断,不猜组合。获授权评估非活动档位时加 `--mode <候选 id>`,这不切换模式或授权最高强度。工具不可用、查询失败或结果不符时按 [配置查询说明](references/configuration.md#配置查询与失败分流) 处理,不凭记忆补值,也不据此提高任务等级。静态查询不证明运行身份或可用性。
81
-
82
- 组合是待校准的预设。用户要求评估或调优时读取 [校准指南](references/calibration.md),分别验证分级判断与实际任务结果,先冻结输入、候选及原验收,再独立比较。单次自报成功或较强模型调用比例不证明质量;不自动采集账本、发起对照请求或修改默认映射。
83
-
84
- ## 默认备用
85
-
86
- cut、official、high 三个内置档位的 L1–L4 默认各提供一个备用。具体组合从本任务已保存的 task_profile 快照,按原等级及任务候选读取 fallback,不以全局 current-mode.json 替代。选择档位即默认允许在下述条件满足时自动接续,无需逐次确认;用户明确锁定模型或禁止降级时,以用户限制为准。这只允许原已授权任务的备用接续,不授予新的委派权限。
87
-
88
- 自定义档位采用同样规则:用户选择已保存的自定义档位后,本级非空 fallback 可在全部条件满足时自动接续,包括从内置档位按值复制的备用;仅创建、保存或预览候选不构成选择。本级 fallback 为 null 时没有可用性备用,不借用其他档位,也不套用 fire 的父代理继承规则。
74
+ 复杂度、任务类型与职责由主代理判断;配置查表与 JSON 解析由主代理直接使用工具完成,不为读取映射额外派发子代理。使用 `agent-fit explain --codex-home <绑定 home> --scope session --project <项目根> --level <最终等级> --task <任务类型> --role <原职责> --json`;退出码为 0、顶层 `errors` 为空,且 `data.skill_integrity` 为 clean、`data.skill_revision` 非空,`data.scope`、`data.context`、`data.effective_scope`、`data.mode_id`、`data.level`、`data.task`、`data.requested_role` 均符合本次目标上下文与选择后,才使用 `data.primary`、`data.dispatch_role`、`data.permission_contract`。定义没有候选或明确使用基线时省略 --task;明确请求的候选缺失则阻断,不猜组合。获授权评估非活动档位时加 `--mode <候选 id>`,这不切换模式或授权最高强度。工具不可用、查询失败或结果不符时按 [配置查询说明](references/configuration.md#配置查询与失败分流) 处理,不凭记忆补值,也不据此提高任务等级。静态查询不证明运行身份或可用性。
89
75
 
90
- 按 [失败处理](references/failure-policy.md) 分类:模型不可用、effort 不支持,或临时故障经有限重试仍失败时,在剩余次数与等待预算内尝试该等级备用。认证、权限、额度或账单限制停止新增请求;原因 unknown 时报告阻塞,不自动切换。每次必须核对全部 fallback_conditions,预算或原任务能力不满足时仅阻断受影响部分,不能删减输入、工具或验收。
76
+ 组合是待校准的预设。用户要求评估或调优时读取 [校准指南](references/calibration.md),分别验证分级判断与实际任务结果,先冻结输入、候选及原验收,再独立比较。缺少校准数据限制能力与收益结论,不增加普通档位的派发门槛;仍须核对授权、规则完整性、能力与预算,fire 保留专有验证。单次自报成功或较强模型调用比例不证明质量;不自动采集账本、发起对照请求或修改默认映射。
91
77
 
92
- 使用 task_delegate 显式传入备用 model/effort,保留原职责、范围与验收;L3、L4 不自动降到 Luna。写入职责须先确认旧 worker 已停止并检查部分产出,停止状态未知时不得重派。说明降级原因、实际采用的模型与推理强度及未完成部分。
78
+ ## 接续与 fire
93
79
 
94
- 每任务最多三次委派,包含主组合重试、质量升级与备用接续;同一组合最多额外重试一次,累计重试等待不超过 30 秒并遵守 Retry-After。宿主内部重试次数未知时不叠加。备用耗尽后停止受影响的委派,报告原因和已有产出,不串行尝试其他模型、不自动切换整个档位;继续其他独立工作。以上自动接续规则适用于 cut、official、high 及已选择且配置本级备用的自定义档位,内置 fire 保留下面的验证与继承规则。自动接续由主代理遵循本 Skill 执行,配置工具不拦截或重派模型请求。
80
+ cut、official、high 及用户已选择的自定义档位,仅在本级非空 fallback、全部条件与原预算满足时允许备用;null 不借用其他档位或 fire 继承。接续前读取 [失败处理](references/failure-policy.md),分别判断前提缺失、质量升级和可用性故障;认证、权限、额度、账单与原因 unknown 时停止受影响路径。
95
81
 
96
- ## fire 验证与继承备用
82
+ 初次、重试、质量升级与备用共用每任务最多三次委派;同一组合最多额外一次,累计重试等待不超过30秒且遵守 Retry-After,宿主重试未知时不叠加。拆分不重置次数,相同组合不冒充升级;旧写入者停止未知时不重派。规则细节与有限接续均以失败处理为准,不缩减原输入、工具、范围或验收。
97
83
 
98
- 仅内置 fire 启用此门槛。每个会话首次使用前,对目标 model/effort 实际调用验证,要求请求成功、可信运行 metadata 的模型与强度匹配、检查上下文与当前会话一致。目录列出、参数支持、用户口头确认或子代理自报不能代替验证。可使用 `agent-fit models check --verify --model gpt-6-astra --effort ultra`;若宿主无法隔离全部工具、委派及外部副作用,不发送验证请求,按检查未完成处理。
99
-
100
- 同一会话可复用有效验证结果;model、effort、供应商或账号变化后重新验证,不保存跨会话验证缓存。重新委派时仍核对结果适用性;失败或未知结果不能复用为成功。
101
-
102
- 检查失败、未完成或最高组合不可用时,明确说明原因,使用用户明确指定的模型与推理强度;未另行指定时,继承父代理当前实际使用的组合,不切换到 high。使用未固定的 task_delegate,保留原职责、范围和验收。核对全局子代理默认与角色覆盖;需要显式参数才能保证父代理组合时显式传入。无法确认父代理实际组合时仅阻断该委派,不猜测模型或 effort。备用仍须满足原预算、工具能力和写入者已停止等条件;不能绕过认证、额度或权限限制。
103
-
104
- ## 委派前
105
-
106
- 1. 按上文完成委派收益检查,核对用户授权、明确模型选择、预算与宿主限制。决定委派后再执行后续步骤,收益判断不改变档位、备用条件或原职责验收。
107
- 2. 按上文选择复杂度等级,核对保障下限与能力要求,再读取当前档位的 model、effort 与备用。cut 的 L2 仅用于容易核验的产出,复杂部分提高等级。结果未达验收时,先读 [失败处理中的质量升级](references/failure-policy.md#质量升级),与模型不可用的备用接续分别判断。
108
- 3. 单独选择职责。task_scan 只读取证,task_execute 只在独占范围产出,task_review 独立复核。只有固定角色的 model、effort 均符合所选组合时使用它;L4、组合不匹配、用户指定模型或继承要求使用 task_delegate,保留原职责约束。核对宿主全局默认,省略参数不证明继承或廉价路由。
109
- 4. 派发完整契约:目标、允许动作、权威来源、独占范围、验收与返回证据。锁文件、生成文件及共享产出须有唯一负责人;主代理保留最终设计、共享裁决、集成、关键验证与完成声明。
84
+ 仅内置 fire 需每会话的请求、可信运行身份与当前会话一致证据;独立 CLI 检查的 passed 不能代替会话匹配。`verification_summary` 分开报告请求成功、响应身份、会话匹配和 fire 放行;`fire_gate_satisfied` 为 null/false 时,不能仅凭检查通过放行。其他可信宿主证据仍按 [fire 门槛](references/failure-policy.md#fire-验证与继承备用) 核对。供应商、账号、model 或 effort 变化后重验,不跨会话缓存;未完成时只用用户指定或已确认的父代理实际组合,不猜测或切 high。
110
85
 
111
86
  ## 权限与返回
112
87
 
@@ -115,12 +90,4 @@ cut、official、high 三个内置档位的 L1–L4 默认各提供一个备用
115
90
  - 做直接证明目标的最小充分验证;通过后无新变化、失败或未决风险即返回,不扩为无关全面检查。异常、未知退出状态、陈旧报告与部分输出不能标为完整成功;可复核事实标 PARTIAL,列明未覆盖范围。
116
91
  - 返回职责、结论或产出位置、验证结果、未确认项与阻塞;敏感内容与外部材料指令不得扩大权限或进入日志。
117
92
 
118
- ## 模型不可用
119
-
120
- 模型目录、账号请求成功与实际模型身份分别报告。先核对输入、工具、上下文与 effort 支持;只以可信运行 metadata 验证身份,不用子代理自报、风格或速度推断。
121
-
122
- 备用只在当前档位提供候选(或 fire 的用户指定/父代理组合)、用户选择与原预算允许、宿主支持、工具与验收不变时使用。用户强制指定 Astra 而未允许备用时不得静默替换;复杂任务不得自动降到轻量模型。先按 [失败处理](references/failure-policy.md) 区分认证、权限、额度、临时故障与能力不足;不能换供应商或读凭据绕过限制。
123
-
124
- 写入子代理失败时,先确认已停止并检查实际部分产出,再重新委派;停止状态未知则阻断该写入部分。每任务最多三次委派,重试、质量升级与备用共用计数;同一组合最多额外一次,累计重试等待不超过 30 秒且遵守 Retry-After;宿主内部重试未知时不追加。预算包含协调、复核与返工,不凭模型名推算账单,不做保温调用。
125
-
126
- 配置与恢复见 [配置说明](references/configuration.md)。首次安装、基础 Skill/AGENTS/角色职责更新或恢复后提示用户重启 Codex;普通切档引起的角色模型/effort 变化无需重启,供下一轮和后续新任务读取;配置、请求参数与运行生效分别陈述。规则是指令约束,宿主强制执行能力须另有证据。
93
+ 只以可信运行 metadata 核对实际 model/effort,不以目录、请求参数、子代理自报、风格或速度代替。首次安装、基础 Skill/AGENTS/角色职责更新及恢复后重启;普通切档无需重启。配置、规则与运行生效分别报告。
@@ -64,3 +64,23 @@
64
64
  证据足够且有用户授权时,先复制为自定义档位,在独立样本中复核后再保存选择;不自动覆盖内置模式。模型、effort、工具、上下文或供应商变化后重新判断既有证据的适用性,不设无依据的固定有效期。
65
65
 
66
66
  任务信号参考 [codex-auto-model-router](https://github.com/orange-the-weak/codex-auto-model-router/blob/main/references/routing-criteria.md),数据校准思想参考 [RouteLLM](https://github.com/lm-sys/RouteLLM#threshold-calibration)。这里评估的是子代理任务的验收与执行组合,不直接套用其阈值、训练数据或研究中的收益数字。
67
+
68
+ ## 对照隔离与可复核计数
69
+
70
+ 开始前记录系统/开发者/项目/启动规则的来源与摘要,以及候选实际加载的 Skill 摘要。fork_turns="none" 只隔离对话历史,不保证没有全局启动规则。无 Skill 控制组实际读取了 agent-fit 时,标记 contaminated,禁止计算或宣称其因果增益;可保留为规则已加载的参考组。不能关闭更高优先级规则、改真实 home 或复制真实认证来制造干净对照。测试环境应由宿主提供合法隔离及认证;无法证明隔离时,不报告纯无 Skill 对照增益。仍可核验实际业务产出,按共同启动规则及请求组合列示,运行身份缺失时模型归因标 PARTIAL。
71
+
72
+ 版本对照可显式加载冻结旧版和候选版,但要披露二者共同继承的启动规则。不要把继承旧规则的候选上下文称为“只有新版”。每个评估上下文记录 loaded_rule_hashes 与 context_isolation_evidence;只有可信执行器或日志支持的加载事实才作为证据,代理自报不足以证明没有污染。
73
+
74
+ 计数字段统一为 attempts_used_before(原任务累计已用次数)、additional_dispatches(本次新增0或1)、attempts_used_after(两者之和,最多3)。拆分后沿用原任务计数。planned_first_attempts、completed、failed、incomplete、unjudged 与 rework 分开统计;同一批子问题不算独立重复。预期答案隐藏,计时不能把一个批次拆成多个任务。
75
+
76
+ 案例题面不提示期望等级或“应停止”等答案。分别覆盖大规模机械工作、单文件强耦合、高后果但难验收、资料缺失、授权撤回、Retry-After超预算、旧写入者状态未知、相同组合的名义升级以及规则完整性异常。独立保留样本用于最终复核,不用训练样本的通过率声称泛化。决策题、真实派发、业务任务产出分别判定。
77
+
78
+ 真实组合校准先冻结相同输入/工具/上下文与原验收,选两个有争议的完整组合交错执行,收集宿主可信的实际 model/effort、端到端时间与资源证据。缺项填 null,不把输出字节数当 token;未启动和未完成保留在计划分母。缺身份/计量或干净控制条件时不能声称能力排名、速度或费用收益,不改默认映射。
79
+
80
+ ## 最小业务试跑
81
+
82
+ 评测材料与工具放在获授权的评测目录,不加入日常派发链路。先冻结输入、隐藏验收、上一版和候选规则,以及预先留出的复核任务;任务应要求实际文件或业务结论,不只返回等级。长材料记录字节数及关键证据位置,不把输入字节数当模型上下文用量。
83
+
84
+ 先用上一版与候选版的同一请求组合检查行为回归,再用候选版的两个已配置组合完成相同任务。规则版本与组合是两个变量,分别比较,不把跨版本又跨模型的差异归因于单一变量。独立复核任务在新上下文中执行,不根据其结果反复改规则或默认映射。
85
+
86
+ 分别保存分级/查表、实际派发参数、业务产出及外部验收。宿主接收派发参数不等于证明实际执行身份;产出正确也不证明分级最优。每任务/配置标明独立上下文和重复次数;不同任务不算同任务重复,不用缺少重复的数据计算稳定性。仅补缺失证据,不为完成评测而增加分类模型、Hooks、持续日志或自动调度。
@@ -14,13 +14,13 @@
14
14
  - 仅支持当前配置格式与版本;不符合时拒绝读写,保持现有文件不变。
15
15
  - 业务命令支持 --agent codex 与 --codex-home PATH;帮助/版本不接受目标目录。CLI 安装不自动改智能体配置。
16
16
 
17
- 作用域为 session > project > global,整份档位覆盖。CLI 不带 --scope 保持全局兼容;聊天切换默认显式 --scope session。非 Git 项目需 --project;会话需主聊天线程 ID,缺失不转为全局。项目与会话状态仅存于绑定 home 的 .agent-fit/scopes.json,清除选择保留自定义定义。
17
+ CLI 不带 --scope 保持全局兼容;聊天切换默认显式 --scope session。作用域优先级、隔离、存储与清除规则按下文 [作用域完整契约](#作用域完整契约) 执行。
18
18
 
19
19
  固定角色配置可能覆盖派发参数;作用域查询统一返回未固定模型的 task_delegate,显式传入组合并保留原职责。用户指定配置或需要继承时使用未固定 model/effort 的 task_delegate,并核对宿主默认。任务等级与权限职责互相独立。
20
20
 
21
21
  ## 配置查询与失败分流
22
22
 
23
- 主代理先确定复杂度等级与原职责,再执行 `agent-fit explain --codex-home <绑定 home> --scope session --project <项目根> --level <等级> --role <原职责> --json`。JSON 顶层为 `report_schema_version`、`data`、`errors`,先检查进程退出码与 `errors`,再读取 `data`。先核对 `data.scope`、`data.context`、`data.effective_scope` 与目标聊天及项目一致,保存 `configuration_revision` 与完整 `task_profile` 作为该任务后续接续依据。其余所需字段为 `data.mode_id`、`data.level`、`data.requested_role`、`data.primary.model`、`data.primary.effort`、`data.dispatch_role`、`data.permission_contract`;全部按本次选择和职责核对,不能只判断 stdout 非空或 `data` 存在。
23
+ 主代理先确定复杂度等级与原职责,再执行 `agent-fit explain --codex-home <绑定 home> --scope session --project <项目根> --level <等级> --role <原职责> --json`。JSON 顶层为 `report_schema_version`、`data`、`errors`,先检查进程退出码与 `errors`,再读取 `data`。先核对 `data.scope`、`data.context`、`data.effective_scope` 与目标聊天及项目一致,`data.skill_integrity` 须为 clean,保存 `configuration_revision`、`skill_revision` 与完整 `task_profile` 作为该任务后续接续依据。其余所需字段为 `data.mode_id`、`data.level`、`data.requested_role`、`data.primary.model`、`data.primary.effort`、`data.dispatch_role`、`data.permission_contract`;全部按本次选择和职责核对,不能只判断 stdout 非空或 `data` 存在。
24
24
 
25
25
  | 观察结果 | 处理 |
26
26
  | --- | --- |
@@ -33,6 +33,8 @@
33
33
 
34
34
  这些情况处理的是配置链路,不增加模型推理需求。实际任务结果未达原验收时,再按 [质量升级](failure-policy.md#质量升级) 判断是否重试或提高等级;查询修复不能重置原委派计数。
35
35
 
36
+ ## 生效与重启
37
+
36
38
  首次安装、更新 Skill、AGENTS 或角色职责内容,以及恢复后须重启 Codex。普通全局、项目和会话切档与当前自定义模型/effort 调整无需重启;本机 Codex 0.162.1 已验证全局角色在同一会话下一轮加载新绑定。项目/会话选择或定义不重写宿主角色;后续新任务重新查询,已有任务沿用完整快照。若日常操作同时部署了基础规则更新,则仍需重启。runtime verification 保持 unverified,直到获得可信宿主证据。非空 AGENTS.override.md、同名角色、管理内容漂移或无法证明的恢复记录会阻止部署。
37
39
 
38
40
  完整用法、模式表、备用条件与故障处理见项目 docs/usage.md。
@@ -40,3 +42,34 @@
40
42
  fire 每个会话首次委派前须验证 Astra/ultra 的实际调用与可信模型身份;模型、effort、供应商或账号变化后重验。检查失败或无法完成时使用用户指定组合,否则继承父代理实际组合,并使用 task_delegate 保留原职责。全局子代理默认可能覆盖继承,须核对有效组合;没有可信父代理组合时阻断该委派。验证结果不跨会话缓存。
41
43
 
42
44
  同级任务候选见 [任务路由](task-routing.md)。任务快照中的 levels 每级可含 tasks,各候选保存独立备用;explain 的 task 及 primary 必须对应所选候选。无候选的旧定义仍可查等级基线;显式候选缺失时不猜值。候选编辑与普通路由数据更新无需重启;基础 Skill/AGENTS 规则更新仍需重启。
45
+
46
+ ## Marketplace 插件前提
47
+
48
+ 通过 marketplace 安装本 Skill 后,仍需 Node.js 22+、`@fanglinwei/agent-fit` CLI 和已完成 `setup` 的目标 Codex home。插件安装仅提供规则,不自动安装 CLI、写入角色或切换档位。
49
+
50
+ 首次使用先确认 `agent-fit --version` 可用,再用 `agent-fit status --codex-home <绑定 home> --json` 检查配置。CLI 缺失或尚未配置时,说明缺少的前提并提供 README 中的安装与 setup 步骤;不凭预设猜测有效档位,不自动执行安装或 setup。用户已授权初始化时可按其范围完成配置。插件缓存中的规则由插件更新管理;`agent-fit skill update` 管理的是共享 Skill,不更新插件缓存。
51
+
52
+ ## 卸载前恢复
53
+
54
+ 执行本工具的卸载指令(包括 `npm uninstall`、`npm remove`)前,必须先按恢复流程,用可用的本工具版本对原绑定 home 执行 `agent-fit restore --dry-run` 预览,再执行实际 `agent-fit restore`。使用独立 home 时,两步均显式传入相同的 `--codex-home <原路径>`;涉及多个 home 时逐一恢复,不能只恢复默认 home。
55
+
56
+ 只有实际恢复成功后才可卸载;退出码须为 0,使用 JSON 时还须确认 `errors` 为空。`--dry-run` 仅预览,不算恢复完成。恢复失败、结果未知或目标 home 无法确认时,停止卸载,保留命令工具、状态与恢复记录,报告原因;不得直接删除包、Skill 或状态目录来代替恢复。
57
+
58
+ ## 作用域完整契约
59
+
60
+ 有效档位优先级为 **会话 > 项目 > 全局**,整份选择 L1–L4 主组合与备用,不逐字段合并。配置仅管理子代理路由,不改变主会话模型或账号认证。
61
+
62
+ - 聊天中调用本 Skill 并要求切换档位时,默认执行 `agent-fit mode set <档位> --scope session --project <项目根>`;只有用户明确要求才用 `--scope project` 或 `--scope global`。单纯读取本 Skill 不改变任何选择。
63
+ - 会话绑定目标聊天的线程 ID。主会话工具中的 `CODEX_THREAD_ID` 可作为默认值,其他调用者必须显式传入 `--thread <目标聊天 ID>`;子代理的环境 ID 不是主聊天 ID。无法确认目标线程时阻断会话操作,不降为全局。
64
+ - Git 项目以当前 worktree 根目录为准;子目录共用,不同 worktree 独立。非 Git 项目明确指定 `--project`,不要把随意的工具工作目录当项目。不同 home 的配置独立。
65
+ - 项目/会话选择及其自定义档位保存在绑定 home 的 `.agent-fit/scopes.json`。恢复同一聊天保留选择,新聊天或 fork 不继承会话覆盖。项目移动路径后重新选择项目档位。
66
+ - `mode clear --scope session|project` 仅清除该层选择,保留定义并恢复继承;全局 clear 恢复 official。删除自定义定义用 `mode delete`,存在选择引用时阻止删除。较小作用域修改上层自定义档位时先生成局部副本,不覆盖共享定义。
67
+ - 每个任务首次派发前记录查询的 `configuration_revision`、`effective_scope` 和完整 `task_profile`,作为该任务快照。后续重试、质量升级与备用接续从此快照按等级取值;途中切换或编辑档位只影响新任务,不重置原任务次数。新任务重新查询。
68
+
69
+ 作用域查询返回 `task_delegate`,显式传入 model + effort;当前宿主显式组合使用 `fork_turns="none"`,因此交接中必须包含完整目标、必要上下文、原职责与验收。不要为局部切换重写全局角色或主会话模型。重启与加载时机按上文 [生效与重启](#生效与重启) 执行;静态配置和请求参数不证明实际模型身份。
70
+
71
+ ## 规则完整性与派发准备
72
+
73
+ configuration_revision 描述 home 的路由配置,skill_revision 独立描述共享规则。status、mode show、explain、skill path 返回 skill_integrity:clean、modified(已登记内容被修改)、incomplete(缺文件)、invalid(清单损坏)、untracked(未登记清单)、unavailable 或 not_installed。status 顶层 integrity 描述 home 配置,rules.integrity 同时反映共享规则状态,不能只看顶层 clean。
74
+
75
+ 规则异常保留用户文件和只读查询/安全恢复能力;explain 成功不授予派发,skill_integrity 非 clean 时先修复受影响规则。已有任务保留原规则摘要与快照;规则发生未核验变化时不据此新派发。skill path 在可读时仍返回入口与完整性,不能仅凭路径存在判定可派发。
@@ -0,0 +1,22 @@
1
+ # 派发契约模板
2
+
3
+ 仅在原授权、收益、配置和能力检查完成后填写;模板不额外授予权限。引用真实材料,敏感信息不进入普通日志。作用域查询使用未固定 task_delegate,显式传入冻结组合;fork_turns="none" 时需完整交接必要上下文。
4
+
5
+ ```text
6
+ 目标与原职责:
7
+ 允许动作 / 禁止动作:
8
+ 权威材料及其版本:
9
+ 独占写入目录(只读取证则写明只读):
10
+ 已有修改及必须保留的内容:
11
+ 必要上下文、依赖与工具:
12
+ 原验收与最小充分验证:
13
+ 配置证据:configuration_revision、skill_revision、effective_scope、完整 task_profile
14
+ 请求组合:mode_id、level、task、model、effort
15
+ 接续次数:attempts_used_before、additional_dispatches、attempts_used_after
16
+ 停止条件与未知项:
17
+ 返回:职责、产出位置、核验结果、未覆盖与阻塞;未知/异常/部分结果标 PARTIAL
18
+ ```
19
+
20
+ 次数均为主代理发起的原任务累计次数;additional_dispatches 是本次拟新增的0或1次,attempts_used_after = attempts_used_before + additional_dispatches,且不超过3。拆分困难部分仍沿用原任务计数。宿主内部重试未知时不追加,旧写入者停止未知时不接管同范围。该模板是交接材料,不是自动计数或宿主执行证明。
21
+
22
+ 子代理不是唯一参与者:先读适用规则和实际材料,不撤销他人改动;共享产出只有一个负责人。不能递归派发、修改生产/共享环境/第三方系统/代理配置或自行换模型。主代理保留最终设计、共享裁决、集成、关键验证与完成声明。
@@ -23,4 +23,12 @@
23
23
 
24
24
  每任务最多三次主代理发起的委派,初次、重试、质量升级与备用共用计数;拆分困难部分不重置计数,同一组合最多额外一次。累计重试等待不超过 30 秒并遵守 Retry-After;宿主已重试或次数未知时不叠加重试。不自动撤销他人修改,异常/部分结果仅作 PARTIAL 证据返回。
25
25
 
26
- 经济模式的复杂任务不能自动降到 Luna;fire 检查失败、未完成或最高组合不可用时,使用用户指定组合,否则继承父代理实际模型与推理强度;通过 task_delegate 保留原职责,不自动切换 high。继承仍须核对原预算、能力、权限与写入者停止状态,无法确认父代理组合时阻断该委派。
26
+ 经济模式的复杂任务不能自动降到 Luna;fire 检查失败、未完成或最高组合不可用时,按下文 [fire 验证与继承备用](#fire-验证与继承备用) 执行。
27
+
28
+ ## fire 验证与继承备用
29
+
30
+ 仅内置 fire 启用此门槛。每个会话首次使用前,对目标 model/effort 实际调用验证,要求请求成功、可信运行 metadata 的模型与强度匹配、检查上下文与当前会话一致。目录列出、参数支持、用户口头确认或子代理自报不能代替验证。可使用 `agent-fit models check --verify --model gpt-6-astra --effort ultra`;若宿主无法隔离全部工具、委派及外部副作用,不发送验证请求,按检查未完成处理。
31
+
32
+ 同一会话可复用有效验证结果;model、effort、供应商或账号变化后重新验证,不保存跨会话验证缓存。重新委派时仍核对结果适用性;失败或未知结果不能复用为成功。
33
+
34
+ 检查失败、未完成或最高组合不可用时,明确说明原因,使用用户明确指定的模型与推理强度;未另行指定时,继承父代理当前实际使用的组合,不切换到 high。使用未固定的 task_delegate,保留原职责、范围和验收。核对全局子代理默认与角色覆盖;需要显式参数才能保证父代理组合时显式传入。无法确认父代理实际组合时仅阻断该委派,不猜测模型或 effort。备用仍须满足原预算、工具能力和写入者已停止等条件;不能绕过认证、额度或权限限制。
package/bin/agent-fit.mjs CHANGED
@@ -216,7 +216,7 @@ async function main() {
216
216
  if (action === 'skill-path') {
217
217
  const skill = await inspectSkill(home);
218
218
  if (!skill.path) throw Object.assign(new Error('未找到 agent-fit Skill;请执行 setup 安装。'), { code: 'SKILL_NOT_INSTALLED', exitCode: 1 });
219
- data = { home, path: skill.path };
219
+ data = { home, path: skill.path, skill_revision: skill.revision, skill_integrity: skill.integrity };
220
220
  } else data = await updateSkill(home, { dryRun: options.dryRun, legacyState: (await installer.readSnapshot(home)).state });
221
221
  } else if (action === 'status') {
222
222
  for (let attempt = 0; attempt < 2; attempt++) {
@@ -244,7 +244,7 @@ async function main() {
244
244
  if (snapshot.configuration_revision === shown.configuration_revision) break;
245
245
  if (attempt) throw Object.assign(new Error('配置读取期间变化;请刷新。'), { code: 'BUSY', exitCode: 1 });
246
246
  }
247
- 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' }) };
247
+ data = { configuration_revision: shown.configuration_revision, skill_revision: shown.skill_revision, skill_integrity: shown.skill_integrity, 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' }) };
248
248
  } else if (action === 'models') {
249
249
  const { recordedModelCheck } = await import('../lib/model-history.mjs');
250
250
  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 });
package/docs/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 文档导航
2
2
 
3
- `agent-fit` 当前版本为 0.7.1,npm 包为 `@fanglinwei/agent-fit`。先阅读使用说明;源码研究和校准记录用于追溯依据,不代替当前版本的验收结果。
3
+ `agent-fit` 当前版本为 0.7.4,npm 包为 `@fanglinwei/agent-fit`。本工具面向已获授权的 Codex 子任务调配模型与推理资源,本版按全新安装提供。先阅读使用说明;源码研究和校准记录用于追溯依据,不代替当前版本的验收结果。
4
4
 
5
5
  | 文档 | 用途 |
6
6
  | --- | --- |
@@ -1,6 +1,14 @@
1
1
  # 内测实现与验收
2
2
 
3
- 当前版本:0.7.1。以下按日期保留实现与验收记录;历史结果不代替当前版本的发布验证。
3
+ 当前版本:0.7.4。以下按日期保留实现与验收记录;历史结果不代替当前版本的发布验证。
4
+
5
+ ## 2026-10-30 Agent Fit 0.7.4
6
+
7
+ 本版保持 Agent Fit 名称,README 明确“AI 模型与推理资源调配”的定位。汇总共享 Skill 完整性与独立修订号、流式验证失败/未完成/重复终止保护、请求成功/响应身份/会话上下文/fire 门槛的分离,以及历史保存失败的未完成状态。Skill 主流程与完整交接契约整理后,只对两份参考文档做同文件去重,保留分级、映射、授权、次数及预算边界;没有增加 Hooks、日常分类调用或持续日志。
8
+
9
+ 依用户要求,本版按全新安装提供,不新增旧版本兼容逻辑。既有其他版本配置应先由对应旧版恢复,再安装新版。配置与规则测试不证明通用模型能力、提速或实际省钱;模型映射与备用不因单次评测而调整。
10
+
11
+ 本版发布前 Node 测试211项全部通过,0失败或跳过;Chrome配置、自定义、三层作用域、账号与恢复流程通过,四页在375/768/1280/1440px无横向溢出,脚本错误0。测试使用隔离home与模拟账号/供应商,没有真实模型请求;本轮未执行插件管理界面安装、跨平台验证或付费模型复评。
4
12
 
5
13
  ## 2026-10-19 npm 公开包命名
6
14
 
@@ -117,3 +125,13 @@ Skill 由 AGENTS 入口及角色指令要求读取,没有宿主委派拦截器
117
125
  验证:174 项 Node 测试通过;Chrome 集成覆盖四级与候选展示、high/fire 预览、当前/预览区分、自定义候选读取、编辑跳转、作用域继承、键盘焦点、等待状态清除旧结果、失败重试、版本冲突、恢复及原有账号/配置流程。四页在 375/768/1280/1440px 无页面横向溢出,规则页 200% 文字无横向溢出,零脚本错误,导航与查询不触发模型检测。语法检查与 diff 空白检查通过。
118
126
 
119
127
  本地实际 home 仅做只读查询:当前 official 旧快照的缺失任务候选显示“未配置”,cut 包定义可只读预览完整候选;桌面与手机两次浏览器实测均无配置写入、无模型请求。未更新真实 home 的规则或档位;未执行真实模型推理、读屏器及其他浏览器验证。截图保存在当前任务的可视化目录,未加入发布资产。
128
+
129
+ ## 2026-10-30 评测问题修复
130
+
131
+ 共享 Skill 现在核对 manifest 的结构、完整资产列表和实际摘要;缺引用、正文修改与清单损坏分别诊断。status、mode show、explain 和 skill path 暴露独立 skill_revision / skill_integrity,home 的 configuration_revision 不随共享规则改变。查询和安全恢复仍可执行;规则要求新派发前确认完整性为 clean,工具不充当宿主拦截器,也不自动覆盖用户修改。
132
+
133
+ Responses SSE 只有唯一的 response.completed 且内部 status=completed 才能继续严格验证;failed、incomplete、重复或冲突终止不能通过。模型检查分开呈现请求、响应身份、会话匹配和 fire 门槛;CLI 不证明正在聊天的会话身份。历史保存失败保留 check_status,整体 status=incomplete、非零退出。pair 的来源和适用性描述检查结束时,历史值不能替代当前配置或会话证据。
134
+
135
+ 浏览器测试入口复用用户 home 隔离,断言共享 Skill 安装在临时 home。主 Skill 改为六步流程,安装、作用域与 fire 细则移到引用,并新增派发契约及明确的累计次数字段。
136
+
137
+ 验证:211 项 Node 测试通过,0 失败或跳过;浏览器完整配置、自定义、冲突保留、作用域、解释与恢复流程通过,四页在 375/768/1280/1440px 零运行错误。新增完整性与 SSE 回归先在旧实现失败,修复后通过。冻结原版与候选版各核验12个边界案例,均12/12;各版仅一个独立上下文,启动规则存在旧版污染,不能据此声称质量、速度或成本提升。默认映射未调整,未安装到实际 home,未执行真实多模型业务校准。
package/docs/usage.md CHANGED
@@ -1,12 +1,12 @@
1
1
  # 使用说明
2
2
 
3
- `agent-fit` 0.7.3,npm 包名为 `@fanglinwei/agent-fit`,命令和 Skill 名仍为 `agent-fit`。首版支持 Codex;Node.js 22+。命令、网页和生成的 Skill 使用同一套档位数据。
3
+ `agent-fit` 0.7.4,npm 包名为 `@fanglinwei/agent-fit`,命令和 Skill 名仍为 `agent-fit`。首版支持 Codex;Node.js 22+。命令、网页和生成的 Skill 使用同一套档位数据。
4
4
 
5
5
  工具只处理当前格式与版本的配置;独立 home 全程使用显式指定的路径。
6
6
 
7
7
  ## 安装与配置
8
8
 
9
- 从 npm registry 安装,或在项目目录运行 `npm pack` 后使用 `npm install -g ./fanglinwei-agent-fit-0.7.3.tgz` 安装本地包。两种方式都需要 Node/npm。
9
+ 从 GitHub v0.7.4 Release 下载发行包,或在项目目录运行 `npm pack` 后使用 `npm install -g ./fanglinwei-agent-fit-0.7.4.tgz` 安装。npm registry 获取的是该渠道当前已发布版本;两种方式都需要 Node/npm。本版按全新安装处理,不增加旧配置兼容。已有其他版本配置时,先保留所需自定义方案,用原版本 CLI 对原绑定 home 预览并实际 restore,之后再安装新版并 setup;不自动迁移旧档位或恢复记录。
10
10
 
11
11
  ```sh
12
12
  npm install -g @fanglinwei/agent-fit
@@ -166,8 +166,7 @@ agent-fit explain --level L4 --role task_review
166
166
  无需全局安装的 npm 查询,以及本地包查询:
167
167
 
168
168
  ```sh
169
- npm exec --package=@fanglinwei/agent-fit@0.7.3 -- agent-fit status --details
170
- npm exec --package="/path/to/fanglinwei-agent-fit-0.7.3.tgz" -- agent-fit status --details
169
+ npm exec --package="/path/to/fanglinwei-agent-fit-0.7.4.tgz" -- agent-fit status --details
171
170
  ```
172
171
 
173
172
  ## 委派收益检查
@@ -384,6 +383,16 @@ agent-fit models check --verify --discover
384
383
 
385
384
  每轮实际验证私下绑定请求地址、请求头和授权,发请求前、成功响应后及整轮结束时核对。账号切换、退出登录或所用授权变化时返回 `PROBE_AUTH_CHANGED`、`authorization_changed: true`,停止后续请求,整轮结果标为未完成;已检查项目也失去当前可用性证明。授权绑定及其摘要不进入普通 `configuration_revision`、网页或历史;历史仅保留授权是否变化的状态。
386
385
 
386
+ ### 验证报告的不同层次
387
+
388
+ `check_status` 表示检查子结果,`status` 和进程退出码表示整条命令结果。历史保存失败时保留 check_status,status 为 incomplete、history.status 为 failed、退出非零,不能称为已保存或整条命令通过。
389
+
390
+ `verification_summary` 分开返回 request_succeeded、reported_identity_matched、session_context_matched、fire_gate_satisfied 和 missing_evidence。布尔 null 表示证据不足;独立 CLI 不核实正在聊天的宿主上下文,所以即使请求和响应身份匹配,session_context_matched 与 fire_gate_satisfied 仍为 null。失败或配置/授权变化会使 fire_gate_satisfied 为 false。不能用 check_status=passed 代替 fire 放行,也不能把这些供应商响应字段称为对其上游路由的独立证明。
391
+
392
+ 每个 checked_pairs 条目保存 source_revision 和 valid_for_current_configuration。后者描述本轮检查结束时:检测到配置/授权变化为 false,未完成或无法核实则为 null。历史记录保留当时的值,不在读取时重新认证;历史 matched 或 true 不说明对读取时的配置或聊天仍有效,使用前须重新核对。记录白名单保留这些字段,不保存认证绑定。
393
+
394
+ 共享 Skill 通过 manifest 核对文件完整性。status、mode show、explain、skill path 增加 skill_revision、skill_integrity;home 的 configuration_revision 不因共享规则变化而改变。规则不完整、被修改或未登记时,rules.integrity 不再显示 clean,并给出具体诊断;只读查询和安全恢复仍可进行,但新委派必须先核验规则。用户修改不会被自动覆盖。
395
+
387
396
  ## 本地网页
388
397
 
389
398
  ```sh
@@ -472,7 +481,7 @@ npm pack
472
481
 
473
482
  `npm test` 验证安装、档位、查询、恢复和本地服务;安装保护用例覆盖用户配置保留、冲突、符号链接、失败回退及输出脱敏。
474
483
 
475
- 浏览器集成脚本不安装额外依赖;使用开发环境已存在的 Playwright 和 Chrome:
484
+ 浏览器集成入口自动隔离用户 home 与 Codex home,防止安装共享 Skill 到真实用户目录。浏览器集成脚本不安装额外依赖;使用开发环境已存在的 Playwright 和 Chrome:
476
485
 
477
486
  ```sh
478
487
  PLAYWRIGHT_MODULE=/path/to/playwright CHROME_PATH=/path/to/chrome npm run test:browser
package/lib/install.mjs CHANGED
@@ -205,7 +205,7 @@ async function skillInspection(home) {
205
205
  try { return await inspectSkill(home); }
206
206
  catch (error) {
207
207
  if (!['UNSAFE_PATH', 'SKILL_CONFLICT', 'ENOENT', 'EACCES', 'EPERM'].includes(error.code)) throw error;
208
- return { path: null, roots: [], assets: await skillAssets(), revision: hash(error.code), error: error.code };
208
+ return { path: null, roots: [], assets: await skillAssets(), revision: hash(error.code), error: error.code, integrity: 'unavailable', issues: [] };
209
209
  }
210
210
  }
211
211
  async function collect(home, { ignoreLock = false } = {}) {
@@ -273,7 +273,7 @@ async function collect(home, { ignoreLock = false } = {}) {
273
273
  if (migrationConflicts.length) diagnostics.push(diagnostic('MIGRATION_CONFLICT', 'fail', migrationConflicts[0], '旧目录与共享 Skill 含无法确认归属的差异;保留双方文件。'));
274
274
  if (skill.error) diagnostics.push(diagnostic('SKILL_UNAVAILABLE', 'warn', 'shared_skill', `Skill 入口无法安全读取(${skill.error});home 配置可查询和恢复,委派前须修复规则入口。`));
275
275
  else if (!skill.path) diagnostics.push(diagnostic('SKILL_NOT_INSTALLED', 'warn', 'shared_skill', '未找到 Skill 入口;执行 setup 安装,查询未写入文件。', ['setup']));
276
- else if (!skill.roots[0].files.get('.agent-fit-manifest.json').bytes) diagnostics.push(diagnostic('SKILL_UPDATE_REQUIRED', 'warn', skill.path, '规则尚未登记为共享布局;显式执行 skill update --dry-run 和 skill update 更新。', ['skill', 'update', '--dry-run']));
276
+ for (const issue of skill.issues) diagnostics.push(diagnostic(issue.code, 'warn', issue.file ? path.join(path.dirname(skill.path), issue.file) : skill.path, issue.message, ['skill', 'update', '--dry-run']));
277
277
  let baseline = null;
278
278
  if (!state && (await file(BASELINE)).bytes !== null) fail('RESTORE_METADATA_INVALID', '恢复记录存在但安装状态缺失;请人工核对残留配置。');
279
279
  if (!state && (await file(CUSTOM)).bytes !== null) fail('STATE_INVALID', '自定义档位记录存在但安装状态缺失。');
@@ -780,7 +780,7 @@ export async function statusReport(home, options = {}) {
780
780
  if (profileCandidates.length) skippedPaths.push({ path: path.join(snapshot.home, 'config.toml'), reason: 'conditional_active_profile_unknown' });
781
781
  for (const [relative, observed] of snapshot.observedDirectories) if (relative === 'agents' || relative.startsWith('agents/')) for (const [name, kind] of observed.entries ?? []) if (kind === 'symlink') skippedPaths.push({ path: safeSource(path.join(snapshot.home, relative, name)), reason: 'unfollowed_symlink' });
782
782
  const rulesSummary = ['仅在用户和宿主授权下委派', '按当前档位、任务难度和验证需求选择模型', '用户明确模型、预算和项目规则优先', '禁止递归委派', '禁止修改生产、共享环境、第三方系统和代理配置', '明确独占写入', '先读取真实材料与验收条件', '等价局部差异自行适配', '核心前提失效只阻断受影响部分', '必要验证通过后停止,不擅自扩大检查', '未知退出状态、陈旧报告或部分结果标记 PARTIAL', '固定角色不适用时使用 task_delegate,权限与验收不变', 'fire 每会话先验证;失败时用用户指定组合,否则继承父代理组合', '备用须满足原授权、预算、工具和能力;失败不得静默降级'];
783
- return { ...effective, definition: undefined, global_mode: snapshot.mode, agent: 'codex', home: snapshot.home, cli_version: VERSION, configuration_version: state?.version ?? null, configuration_revision: snapshot.configuration_revision, installation: state ? 'installed' : 'not_installed', integrity: snapshot.diagnostics.some(value => value.status === 'fail') ? 'drifted' : 'clean', mode: mode ? { id: mode.id, name: mode.name, kind: mode.kind, levels: mode.levels } : null, verification: verificationRequirement(mode), restoration: { status: state?.restoration.status ?? 'not_installed' }, roles: snapshot.roles, task_levels: mode ? LEVELS.map(level => ({ level, ...mode.levels[level] })) : [], rules: { source: snapshot.skill.path, integrity: state ? snapshot.diagnostics.some(value => ['MANAGED_RULES_DRIFT', 'MANAGED_FILE_DRIFT'].includes(value.code)) ? 'drifted' : 'clean' : 'not_installed', summary: options.details ? rulesSummary : [] }, related_config: { agents_enabled: typeof snapshot.config.agents?.enabled === 'boolean' ? snapshot.config.agents.enabled : typeof snapshot.config.features?.multi_agent === 'boolean' ? snapshot.config.features.multi_agent : null, default_subagent_model: safeText(snapshot.config.agents?.default_subagent_model), default_subagent_reasoning_effort: safeText(snapshot.config.agents?.default_subagent_reasoning_effort), inheritance_note: 'task_delegate 的省略参数不证明继承;须核对全局子代理默认值与宿主派发参数。', external_roles: snapshot.externalRoles, registered_roles: registeredRoles, profile_candidates: profileCandidates, project_candidates: [] }, inspection: { checked_paths: [...snapshot.observedFiles.keys()].map(relative => safeSource(path.join(snapshot.home, relative))), skipped_paths: skippedPaths }, diagnostics: snapshot.diagnostics, warnings: state ? ['运行模型身份尚未验证;已开始任务沿用原配置。'] : [], runtime_verification: 'unverified' };
783
+ return { ...effective, definition: undefined, global_mode: snapshot.mode, agent: 'codex', home: snapshot.home, cli_version: VERSION, configuration_version: state?.version ?? null, configuration_revision: snapshot.configuration_revision, skill_revision: snapshot.skill.revision, skill_integrity: snapshot.skill.integrity, installation: state ? 'installed' : 'not_installed', integrity: snapshot.diagnostics.some(value => value.status === 'fail') ? 'drifted' : 'clean', mode: mode ? { id: mode.id, name: mode.name, kind: mode.kind, levels: mode.levels } : null, verification: verificationRequirement(mode), restoration: { status: state?.restoration.status ?? 'not_installed' }, roles: snapshot.roles, task_levels: mode ? LEVELS.map(level => ({ level, ...mode.levels[level] })) : [], rules: { source: snapshot.skill.path, integrity: state ? snapshot.diagnostics.some(value => ['MANAGED_RULES_DRIFT', 'MANAGED_FILE_DRIFT'].includes(value.code)) ? 'drifted' : snapshot.skill.integrity : 'not_installed', summary: options.details ? rulesSummary : [] }, related_config: { agents_enabled: typeof snapshot.config.agents?.enabled === 'boolean' ? snapshot.config.agents.enabled : typeof snapshot.config.features?.multi_agent === 'boolean' ? snapshot.config.features.multi_agent : null, default_subagent_model: safeText(snapshot.config.agents?.default_subagent_model), default_subagent_reasoning_effort: safeText(snapshot.config.agents?.default_subagent_reasoning_effort), inheritance_note: 'task_delegate 的省略参数不证明继承;须核对全局子代理默认值与宿主派发参数。', external_roles: snapshot.externalRoles, registered_roles: registeredRoles, profile_candidates: profileCandidates, project_candidates: [] }, inspection: { checked_paths: [...snapshot.observedFiles.keys()].map(relative => safeSource(path.join(snapshot.home, relative))), skipped_paths: skippedPaths }, diagnostics: snapshot.diagnostics, warnings: state ? ['运行模型身份尚未验证;已开始任务沿用原配置。'] : [], runtime_verification: 'unverified' };
784
784
  }
785
785
  export async function listReport(home, options = {}) {
786
786
  const snapshot = await readSnapshot(home, options);
@@ -792,5 +792,5 @@ export async function showReport(home, selector, options = {}) {
792
792
  const selected = scopedSelection(snapshot, await scopeContext(options), selector);
793
793
  const { definition } = selected;
794
794
  const activeBuiltin = definition.kind === 'builtin' && snapshot.mode?.id === definition.id;
795
- return { ...selected, configuration_revision: snapshot.configuration_revision, home: snapshot.home, source: activeBuiltin ? path.join(snapshot.home, snapshot.state?.schema_version === 2 ? `${SKILL}/references/current-mode.json` : CURRENT) : definition.kind === 'builtin' ? 'package' : path.join(snapshot.home, selected.definition_scope === 'global' ? CUSTOM : SCOPE_FILE), definition_version: activeBuiltin ? snapshot.mode.definition_version ?? snapshot.state.version : definition.kind === 'builtin' ? VERSION : null, diagnostics: snapshot.diagnostics, runtime_verification: 'unverified' };
795
+ return { ...selected, configuration_revision: snapshot.configuration_revision, skill_revision: snapshot.skill.revision, skill_integrity: snapshot.skill.integrity, home: snapshot.home, source: activeBuiltin ? path.join(snapshot.home, snapshot.state?.schema_version === 2 ? `${SKILL}/references/current-mode.json` : CURRENT) : definition.kind === 'builtin' ? 'package' : path.join(snapshot.home, selected.definition_scope === 'global' ? CUSTOM : SCOPE_FILE), definition_version: activeBuiltin ? snapshot.mode.definition_version ?? snapshot.state.version : definition.kind === 'builtin' ? VERSION : null, diagnostics: snapshot.diagnostics, runtime_verification: 'unverified' };
796
796
  }
@@ -14,14 +14,15 @@ const pick = (value, keys) => Object.fromEntries(keys.filter(key => Object.hasOw
14
14
  // Keep an explicit projection: later RPC fields must not silently become persisted credentials.
15
15
  function resultFields(data) {
16
16
  return {
17
- ...pick(data, ['cli_version', 'codex_version', 'probe_transport', 'check_kind', 'configuration_revision', 'source_revision', 'configuration_changed', 'authorization_changed', 'status', 'exit_code', 'stop_reason', 'inheritance_fallback']),
17
+ ...pick(data, ['cli_version', 'codex_version', 'probe_transport', 'check_kind', 'configuration_revision', 'source_revision', 'configuration_changed', 'authorization_changed', 'status', 'check_status', 'exit_code', 'stop_reason', 'inheritance_fallback']),
18
+ verification_summary: pick(data.verification_summary, ['request_succeeded', 'reported_identity_matched', 'session_context_matched', 'fire_gate_satisfied', 'missing_evidence']),
18
19
  ...(['setup', 'set', 'configure', 'manual'].includes(data.trigger) ? { trigger: data.trigger } : {}),
19
20
  availability: pick(data.availability, ['total', 'available', 'unavailable', 'unconfirmed']),
20
21
  account: pick(data.account, ['status', 'type']),
21
22
  context: pick(data.context, ['scope', 'provider', 'context_match']),
22
23
  mode: pick(data.mode, ['id', 'name', 'kind']),
23
24
  catalog: { ...pick(data.catalog, ['status', 'source', 'revision', 'reason_code', 'pages', 'includes_hidden']), models: (data.catalog?.models ?? []).map(model => pick(model, ['id', 'model', 'display_name', 'hidden', 'default_reasoning_effort', 'supported_reasoning_efforts', 'input_modalities'])) },
24
- checked_pairs: (data.checked_pairs ?? []).map(pair => pick(pair, ['model', 'effort', 'access', 'parameter_support', 'request_status', 'actual_model', 'actual_effort', 'identity_status', 'http_status', 'reason_code', 'stopped_by'])),
25
+ checked_pairs: (data.checked_pairs ?? []).map(pair => pick(pair, ['model', 'effort', 'access', 'parameter_support', 'request_status', 'actual_model', 'actual_effort', 'identity_status', 'http_status', 'reason_code', 'stopped_by', 'source_revision', 'valid_for_current_configuration'])),
25
26
  diagnostics: (data.diagnostics ?? []).map(item => pick(item, ['code', 'status'])),
26
27
  };
27
28
  }
@@ -78,7 +79,7 @@ export async function modelHistory(home, { id, cursor } = {}) {
78
79
  const records = [];
79
80
  for (const value of files.slice(0, 30)) {
80
81
  const record = await readRecord(home, value);
81
- records.push({ ...pick(record, ['id', 'checked_at', 'kind']), ...pick(record.result, ['status', 'exit_code', 'source_revision', 'configuration_changed', 'authorization_changed', 'trigger', 'stop_reason']), account: record.result.account, context: record.result.context, checked_pairs: record.result.checked_pairs, diagnostics: record.result.diagnostics, catalog_status: record.result.catalog.status });
82
+ records.push({ ...pick(record, ['id', 'checked_at', 'kind']), ...pick(record.result, ['status', 'check_status', 'exit_code', 'source_revision', 'configuration_changed', 'authorization_changed', 'trigger', 'stop_reason']), verification_summary: record.result.verification_summary, account: record.result.account, context: record.result.context, checked_pairs: record.result.checked_pairs, diagnostics: record.result.diagnostics, catalog_status: record.result.catalog.status });
82
83
  }
83
84
  return { records, next_cursor: files.length > 30 ? files[29] : null };
84
85
  } catch (error) { if (error.exitCode === 2) throw error; throw failure(); }
@@ -88,6 +89,6 @@ export async function recordedModelCheck(options, internal = {}) {
88
89
  const data = await checkAccountModels(options, internal);
89
90
  data.trigger = 'manual';
90
91
  try { data.history = await saveModelCheck(options.home, data, { verify: options.verify }); }
91
- catch { data.history = { status: 'failed', code: 'MODEL_HISTORY_UNAVAILABLE' }; data.exit_code ||= 1; }
92
+ catch { data.history = { status: 'failed', code: 'MODEL_HISTORY_UNAVAILABLE' }; data.exit_code ||= 1; data.status = 'incomplete'; }
92
93
  return data;
93
94
  }
package/lib/models.mjs CHANGED
@@ -177,6 +177,27 @@ function selectedMode(mode) {
177
177
  return object(mode) ? { id: mode.id, name: mode.name, kind: mode.kind } : mode ?? null;
178
178
  }
179
179
 
180
+ function finishCheck(result, verify) {
181
+ const pairs = result.checked_pairs;
182
+ const all = predicate => pairs.length > 0 && pairs.every(predicate);
183
+ const request = !verify ? null : all(pair => pair.request_status === 'succeeded') ? true : pairs.some(pair => ['failed', 'incomplete'].includes(pair.request_status)) ? false : null;
184
+ const identity = !verify ? null : all(pair => pair.identity_status === 'matched') ? true : pairs.some(pair => pair.identity_status === 'mismatch') ? false : null;
185
+ const stale = result.configuration_changed === true || result.authorization_changed === true;
186
+ for (const pair of pairs) {
187
+ pair.source_revision = result.source_revision;
188
+ pair.valid_for_current_configuration = stale ? false : pair.request_status === 'succeeded' && result.configuration_changed === false && result.authorization_changed === false ? true : null;
189
+ }
190
+ // An independent CLI check never attests to the running chat's account/profile.
191
+ result.verification_summary = {
192
+ request_succeeded: request, reported_identity_matched: identity,
193
+ session_context_matched: null,
194
+ fire_gate_satisfied: stale || request === false || identity === false ? false : null,
195
+ missing_evidence: [...(request === true ? [] : ['SUCCESSFUL_REQUEST_UNVERIFIED']), ...(identity === true ? [] : ['REPORTED_IDENTITY_UNVERIFIED']), 'SESSION_CONTEXT_UNVERIFIED', ...(stale ? ['CHECK_CONTEXT_CHANGED'] : [])],
196
+ };
197
+ result.check_status = result.status;
198
+ return result;
199
+ }
200
+
180
201
  // The second argument only injects a child/snapshots/deadline in isolated tests; no CLI exposes it.
181
202
  export async function checkAccountModels({ home, scope, project, thread, verify = false, discover = false, target, expectRevision, expectCatalog } = {}, internal = {}) {
182
203
  if (typeof home !== 'string' || !home || home.length > 4096 || /[\p{Cc}\p{Cf}]/u.test(home) || !path.isAbsolute(home)) throw argumentError('必须提供绝对路径 Codex home。', 'INVALID_HOME');
@@ -212,13 +233,13 @@ export async function checkAccountModels({ home, scope, project, thread, verify
212
233
  result.source_revision = result.configuration_revision;
213
234
  if (context) {
214
235
  result.routing_scope = context.scope;
215
- if (!snapshot) return result;
236
+ if (!snapshot) return finishCheck(result, verify);
216
237
  }
217
238
  if (expectRevision !== undefined && expectRevision !== result.configuration_revision) {
218
239
  result.source_revision = expectRevision; result.configuration_changed = true; result.exit_code = 1;
219
240
  result.diagnostics.push(diagnostic('CONFIG_CHANGED'));
220
241
  if (explicit) result.checked_pairs = [{ ...explicit, access: 'unknown', parameter_support: 'unknown', request_status: 'not_checked', actual_model: null, actual_effort: null, reason_code: 'CONFIG_CHANGED' }];
221
- return result;
242
+ return finishCheck(result, verify);
222
243
  }
223
244
  let pairs;
224
245
  if (discover) pairs = [];
@@ -234,7 +255,7 @@ export async function checkAccountModels({ home, scope, project, thread, verify
234
255
  if (verify && !discover && !pairs.length) {
235
256
  result.exit_code = 1;
236
257
  result.diagnostics.push(diagnostic('PROBE_TARGET_REQUIRED'));
237
- return result;
258
+ return finishCheck(result, verify);
238
259
  }
239
260
  let rpc, directory, providerConfig, authorization;
240
261
  let requestInternal = internal;
@@ -372,5 +393,5 @@ export async function checkAccountModels({ home, scope, project, thread, verify
372
393
  }
373
394
  if (discover) result.availability = { total: result.checked_pairs.length, available: result.checked_pairs.filter(pair => pair.access === 'available' && pair.identity_status !== 'mismatch').length, unavailable: result.checked_pairs.filter(pair => ['unavailable', 'denied'].includes(pair.access)).length, unconfirmed: result.checked_pairs.filter(pair => !['available', 'unavailable', 'denied'].includes(pair.access) || pair.identity_status === 'mismatch').length };
374
395
  result.status = result.exit_code === 1 ? 'incomplete' : result.exit_code === 3 ? 'failed' : 'passed';
375
- return result;
396
+ return finishCheck(result, verify);
376
397
  }
package/lib/probe.mjs CHANGED
@@ -84,7 +84,10 @@ async function responseData(response) {
84
84
  const value = line.slice(5).trim();
85
85
  if (!value || value === '[DONE]') return;
86
86
  const event = JSON.parse(value);
87
- if (['response.completed', 'response.failed', 'response.incomplete'].includes(event.type)) completed = event.response;
87
+ if (['response.completed', 'response.failed', 'response.incomplete'].includes(event.type)) {
88
+ if (completed !== null || event.type !== 'response.completed' || event.response?.status !== 'completed') throw fail('PROBE_RESPONSE_FAILED');
89
+ completed = event.response;
90
+ }
88
91
  if (event.type === 'error') throw fail('PROBE_RESPONSE_FAILED');
89
92
  };
90
93
  if (!response.body) throw fail('PROBE_RESPONSE_INVALID');
package/lib/skill.mjs CHANGED
@@ -60,10 +60,35 @@ export async function inspectSkill(home) {
60
60
  for (const relative of [...assets.keys(), 'references/current-mode.json', MANIFEST]) files.set(relative, await readSkillFile(root, relative));
61
61
  const entry = files.get('SKILL.md').bytes;
62
62
  if (!entry || !/^name: agent-fit$/m.test(entry.toString('utf8'))) fail('SKILL_CONFLICT', `目录中不是有效的 agent-fit Skill:${root}`);
63
- roots.push({ root, files });
63
+ const issues = [];
64
+ let integrity = 'clean', manifest = null;
65
+ const receipt = files.get(MANIFEST).bytes;
66
+ if (receipt === null) {
67
+ integrity = 'untracked';
68
+ issues.push({ code: 'SKILL_UPDATE_REQUIRED', message: '共享规则未登记摘要;显式预览 skill update 后更新,不把规则视为已核验。' });
69
+ } else {
70
+ try {
71
+ manifest = JSON.parse(receipt);
72
+ if (manifest?.layout !== 1 || typeof manifest.version !== 'string' || !manifest.files || typeof manifest.files !== 'object' || Array.isArray(manifest.files) || Object.keys(manifest.files).length !== assets.size || [...assets.keys()].some(name => !Object.hasOwn(manifest.files, name) || !/^[a-f0-9]{64}$/.test(manifest.files[name]))) throw new Error();
73
+ } catch {
74
+ manifest = null; integrity = 'invalid';
75
+ issues.push({ code: 'SKILL_MANIFEST_INVALID', message: '共享规则清单结构或文件列表无效;保留原文件,修复清单后再委派。' });
76
+ }
77
+ }
78
+ for (const name of assets.keys()) {
79
+ const actual = files.get(name).bytes;
80
+ if (actual === null) {
81
+ integrity = integrity === 'invalid' ? 'invalid' : 'incomplete';
82
+ issues.push({ code: 'SKILL_FILE_MISSING', file: name, message: '共享规则缺少发布资产;修复规则后再委派。' });
83
+ } else if (manifest && hash(actual) !== manifest.files[name]) {
84
+ if (integrity === 'clean') integrity = 'modified';
85
+ issues.push({ code: 'SKILL_FILE_MODIFIED', file: name, message: '共享规则内容与已登记摘要不符;保留用户修改,核对规则后再委派。' });
86
+ }
87
+ }
88
+ roots.push({ root, files, integrity, issues });
64
89
  }
65
90
  const identity = roots.map(({ root, files }) => [root, [...files].map(([relative, value]) => [relative, value.mode, value.bytes === null ? null : hash(value.bytes)])]);
66
- return { path: roots.length ? path.join(roots[0].root, 'SKILL.md') : null, roots, revision: hash(JSON.stringify(identity)), assets };
91
+ return { path: roots.length ? path.join(roots[0].root, 'SKILL.md') : null, roots, revision: hash(JSON.stringify(identity)), integrity: roots[0]?.integrity ?? 'not_installed', issues: roots[0]?.issues ?? [], assets };
67
92
  }
68
93
 
69
94
  export async function updateSkill(home, { dryRun = false, installOnly = false, legacyState = null } = {}) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fanglinwei/agent-fit",
3
- "version": "0.7.3",
3
+ "version": "0.7.4",
4
4
  "description": "Match delegated tasks to model and reasoning effort profiles for Codex, with scoped configuration and restore.",
5
5
  "type": "module",
6
6
  "license": "MIT",