@fanglinwei/agent-fit 0.7.3 → 0.8.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 +17 -9
- package/VERSION +1 -1
- package/adapters/codex/modes.json +144 -0
- package/adapters/codex/profiles/terra-evaluation.json +134 -0
- package/adapters/codex/skills/agent-fit/SKILL.md +23 -56
- package/adapters/codex/skills/agent-fit/references/calibration.md +29 -1
- package/adapters/codex/skills/agent-fit/references/configuration.md +35 -2
- package/adapters/codex/skills/agent-fit/references/dispatch-contract.md +22 -0
- package/adapters/codex/skills/agent-fit/references/failure-policy.md +13 -3
- package/adapters/codex/skills/agent-fit/references/task-routing.md +23 -3
- package/bin/agent-fit.mjs +3 -3
- package/docs/README.md +1 -1
- package/docs/implementation-review.md +35 -1
- package/docs/usage.md +53 -8
- package/lib/codex.mjs +1 -1
- package/lib/install.mjs +4 -4
- package/lib/model-history.mjs +5 -4
- package/lib/models.mjs +25 -4
- package/lib/probe.mjs +4 -1
- package/lib/skill.mjs +27 -2
- package/package.json +1 -1
- package/web/app.js +3 -3
|
@@ -14,13 +14,13 @@
|
|
|
14
14
|
- 仅支持当前配置格式与版本;不符合时拒绝读写,保持现有文件不变。
|
|
15
15
|
- 业务命令支持 --agent codex 与 --codex-home PATH;帮助/版本不接受目标目录。CLI 安装不自动改智能体配置。
|
|
16
16
|
|
|
17
|
-
|
|
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`
|
|
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
|
+
子代理不是唯一参与者:先读适用规则和实际材料,不撤销他人改动;共享产出只有一个负责人。不能递归派发、修改生产/共享环境/第三方系统/代理配置或自行换模型。主代理保留最终设计、共享裁决、集成、关键验证与完成声明。
|
|
@@ -14,13 +14,23 @@
|
|
|
14
14
|
|
|
15
15
|
备用必须同时满足本任务 task_profile 快照中的 fallback_conditions:用户选择、原预算、宿主模型与 effort 支持、原任务输入及工具能力、原职责与验收、原写入 worker 已停止。条件码是待核对前提,不授予新的委派权限。cut、official、high 以及用户已选择的自定义档位,默认允许原已授权任务自动使用本级非空 fallback,包括按值复制的备用,无需逐次确认;仅创建、保存或预览候选不构成选择,用户明确锁定模型或禁止降级时不切换。自定义本级 fallback 为 null 时阻断该接续,不借用其他档位或 fire 的父代理继承规则。备用耗尽后停止该委派并报告原因、实际组合与部分产出,不尝试其他模型或切换档位。备用使用 task_delegate 显式指定 model/effort,保留原职责;L3、L4 不自动降到 Luna。
|
|
16
16
|
|
|
17
|
+
备用按原能力要求逐条核对,跨模型同名 effort 不证明等价。没有合格备用时保留 null 并停止该接续;保留旧模型也不代表它已经通过校准。主组合校准结果不能直接用于证明备用适配,不因新模型发布批量替换备用。故障恢复后由新任务重新查询主组合,同一任务避免往返切换,沿用原快照与次数。
|
|
18
|
+
|
|
17
19
|
## 质量升级
|
|
18
20
|
|
|
19
21
|
1. **证明未达验收**:主代理核对原测试、证据或明确验收条件,指出具体错误;子代理自报完成、表述不合偏好或未分类故障都不足以升级。资料、工具、环境、凭据或目标冲突先补前提,不能靠换强模型解决。
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
22
|
+
2. **确定下一次为何有用**:方法或交接遗漏可在补正后有限重试原组合;证据显示推理深度不足或新暴露复杂约束时,重评困难部分等级与保障要求。原任务已授权,且用户选择、原预算和宿主能力允许时,由主代理在原任务快照中选择有针对性的同级基线、任务候选或更高等级主组合;职责、允许动作与验收保持不变。显式指定模型/effort,固定角色不匹配时使用 task_delegate;不使用本级 fallback 作为质量升级,不自动切换档位或换供应商。
|
|
23
|
+
3. **比较实际组合**:先比较快照中的同级基线与任务候选,再核对后续等级;指出下一组合针对的具体失败。比如 official/L3 complex 的 Sol/medium 遗漏相互约束、需要更深权衡时,可选择本级 Sol/high 基线。跨模型变化须依据适配证据,不能按模型名构造能力阶梯。Terra 专长路线若暴露更深的视觉/写作约束,可在原快照中重评等级与 effort;若暴露竞争假设或强耦合,则核对同级基线或 uncertain/reasoning,不把专长故障备用的 Sol 当成预设质量升级。Astra/low 结果有推理不足证据时,可在同级 L3/L4 选择已配置 reasoning 的 Astra/medium,计为质量升级;普通自动路由到 medium 后不再提高 Astra 强度。high/fire 的明确选档授权及已选择自定义的显式组合保持有效,详见 [任务候选](task-routing.md)。同级候选或相邻等级组合相同时不重派,继续核对下一不同且适用的组合;到 L4 仍无合适的不同组合时,报告已达当前档位上限。high 的 L3→L4、fire 的任意等级变化都不增加模型或 effort;如有新证据或具体方法修正,可在剩余额度内重试原组合,并如实称为重试。自定义更高等级或不同候选不保证更强,须核对能力证据;不机械执行“先加 effort”或“先换模型”。
|
|
22
24
|
4. **限定接续范围**:先确认旧写入者已停止并检查部分产出,只交接仍困难的部分及必要上下文,保留完整验收。升级后的结果仍由主代理核验;未通过时按剩余额度处理,次数耗尽或无合适候选时停止该委派,返回 PARTIAL/BLOCKED 与未完成部分,继续独立工作。
|
|
23
25
|
|
|
24
26
|
每任务最多三次主代理发起的委派,初次、重试、质量升级与备用共用计数;拆分困难部分不重置计数,同一组合最多额外一次。累计重试等待不超过 30 秒并遵守 Retry-After;宿主已重试或次数未知时不叠加重试。不自动撤销他人修改,异常/部分结果仅作 PARTIAL 证据返回。
|
|
25
27
|
|
|
26
|
-
经济模式的复杂任务不能自动降到 Luna;fire
|
|
28
|
+
经济模式的复杂任务不能自动降到 Luna;fire 检查失败、未完成或最高组合不可用时,按下文 [fire 验证与继承备用](#fire-验证与继承备用) 执行。
|
|
29
|
+
|
|
30
|
+
## fire 验证与继承备用
|
|
31
|
+
|
|
32
|
+
仅内置 fire 启用此门槛。每个会话首次使用前,对目标 model/effort 实际调用验证,要求请求成功、可信运行 metadata 的模型与强度匹配、检查上下文与当前会话一致。目录列出、参数支持、用户口头确认或子代理自报不能代替验证。可使用 `agent-fit models check --verify --model gpt-6-astra --effort ultra`;若宿主无法隔离全部工具、委派及外部副作用,不发送验证请求,按检查未完成处理。
|
|
33
|
+
|
|
34
|
+
同一会话可复用有效验证结果;model、effort、供应商或账号变化后重新验证,不保存跨会话验证缓存。重新委派时仍核对结果适用性;失败或未知结果不能复用为成功。
|
|
35
|
+
|
|
36
|
+
检查失败、未完成或最高组合不可用时,明确说明原因,使用用户明确指定的模型与推理强度;未另行指定时,继承父代理当前实际使用的组合,不切换到 high。使用未固定的 task_delegate,保留原职责、范围和验收。核对全局子代理默认与角色覆盖;需要显式参数才能保证父代理组合时显式传入。无法确认父代理实际组合时仅阻断该委派,不猜测模型或 effort。备用仍须满足原预算、工具能力和写入者已停止等条件;不能绕过认证、额度或权限限制。
|
|
@@ -13,9 +13,29 @@
|
|
|
13
13
|
| complex | L2/L3 | 有界复杂问题,需要局部或多约束权衡 | Sol / medium |
|
|
14
14
|
| uncertain | L3/L4 | 高歧义、强耦合,或高后果且难以验收 | Astra / low |
|
|
15
15
|
| reasoning | L3/L4 | 复杂推理,或证据表明先前结果推理不足 | Astra / medium |
|
|
16
|
-
|
|
|
16
|
+
| visual | L1/L2/L3 | 图像、技术图纸、截图的理解与视觉推理 | Terra 6.1 / low、medium、high |
|
|
17
|
+
| computer | L1/L2/L3 | 已知目标、可核对结果的界面操作 | Terra 6.1 / low、medium、high |
|
|
18
|
+
| writing | L1/L2/L3 | 事实与约束已知的自然写作、修订、提案或表单 | Terra 6.1 / low、medium、high |
|
|
19
|
+
| latency | 任意等级,仅显式配置 | 用户明确时延要求,且该组合满足原质量与能力要求 | 读取自定义候选,不凭名称保证低延迟 |
|
|
17
20
|
|
|
18
|
-
|
|
21
|
+
## Terra 专长与本地映射
|
|
22
|
+
|
|
23
|
+
[官方模型选择指南](https://learn.chatgpt.com/docs/models)将 Terra 定位为日常写作、视觉工作与支持的应用操作;[Terra 模型页](https://developers.openai.com/api/docs/models/gpt-6.1-terra)描述为快速、高效的视觉推理、精确电脑操作与清晰自然写作模型。这支持按任务专长接入,不证明它应替换通用编码或开放研究基线。
|
|
24
|
+
|
|
25
|
+
cut/official 对三个专长使用相同本地映射:L1 low、L2 medium、L3 high;候选自己的故障备用分别为 Sol 6.1 medium、medium、high,仍须满足原输入与工具能力。官方没有 L1–L4 表,也没有证明这些 effort 彼此等效或最优。API 文档列出 none/low/medium/high/xhigh/max,不据宿主通用目录推断 Terra 支持 ultra。
|
|
26
|
+
|
|
27
|
+
仅在主要工作属于上述专长、关键事实和约束已知且结果可核对时选择。L3 可处理多项已知约束下的视觉或写作权衡;若主要困难是竞争假设、强耦合、开放研究或高后果且难验收,采用本级基线、uncertain/reasoning 或重评 L4。不能只因输入有图片、产出是文章、任务发生在界面上就选 Terra。computer 仍保留原职责、工具与外部写入授权,不使只读取证角色获得操作权限。明确格式的抽取/转换仍可选 mechanical;代码实现仍按原通用路线选择。
|
|
28
|
+
|
|
29
|
+
## 基线与候选的选择边界
|
|
30
|
+
|
|
31
|
+
先核对候选是否满足原工具、输入模态、上下文及验收能力,再在合格组合间考虑资源与时延。目录列出和配置合法不证明能力或可调用性;缺少必要能力证据时先补前提。
|
|
32
|
+
|
|
33
|
+
- **基线**:任务不能明确落入候选条件时使用本级基线,仍须通过能力检查;同级候选不是必须经过的步骤。
|
|
34
|
+
- **L2 bounded**:局部方案选择,关键约束已知且能直接验收。L2 complex 需要有限的约束权衡,但关键假设已建立;两者不按文件数或职责划分。
|
|
35
|
+
- **L3 complex**:存在相互影响的约束,但关键假设已建立,约束和完整验收可逐项核对时才选。无法可靠核对或需要更深权衡时采用 L3 基线;高歧义、强耦合或高后果且难验收时选 uncertain,复杂推理或已证实推理不足时选 reasoning。
|
|
36
|
+
- **scan / deep**:仅用于 L1/L2 中方法确定、边界明确的扫描或多步核对。出现相互影响的复杂约束或不确定假设时先重评等级;审查职责本身不决定候选或强度,独立审查仍须独立执行。
|
|
37
|
+
|
|
38
|
+
相同组合不是新的能力层级。例如 official/L2 的 complex 与基线都是 Sol/medium,改标签不能算质量升级。更换模型或提高 effort 仍须说明它为何针对已观察到的问题;不存在固定的 Luna → Terra → Sol → Astra 能力阶梯。
|
|
19
39
|
|
|
20
40
|
普通自动 Astra 路由从 low 开始,复杂推理或有证据的质量升级最多 medium;备用也不能自动引入更高 Astra 强度。只说“Astra”不授权 high/xhigh/max/ultra。用户明确指定完整组合时优先;若当前档位没有该候选,先报告并在获授权的配置中保存,不临时拼模型与 effort。
|
|
21
41
|
|
|
@@ -23,7 +43,7 @@ L1/L2 的 scan、deep 只适用于边界明确的工作;出现强耦合、不
|
|
|
23
43
|
|
|
24
44
|
用户明确选择 high 或 fire,即授权其展示的最高强度组合,包括 Astra/ultra;它们保持原四级主组合,不被普通任务候选降为 low/medium。仅预览、explain、创建或保存定义不构成选择。已选择的自定义档位按保存的基线和候选执行,包括显式保存的高强度组合;复制后尚未选择时同样不构成派发授权。原预算、任务权限、宿主支持及 fire 会话验证仍须满足。
|
|
25
45
|
|
|
26
|
-
低延迟是质量约束内的偏好,不能只凭名称或 effort 声称更快。Terra
|
|
46
|
+
低延迟是质量约束内的偏好,不能只凭名称或 effort 声称更快。Terra 专长候选已内置于 cut/official;能力比较或调优时才按 [校准指南](calibration.md#新模型候选与默认晋升)执行评测。未配置 latency 时,查询返回 TASK_ROUTE_NOT_CONFIGURED;不能静默改用其他模型并声称满足时延。仍可由主会话完成或报告受影响部分。
|
|
27
47
|
|
|
28
48
|
## 查询、快照与编辑
|
|
29
49
|
|
package/bin/agent-fit.mjs
CHANGED
|
@@ -19,7 +19,7 @@ mode configure MODE --level L1|L2|L3|L4 --model MODEL --effort EFFORT
|
|
|
19
19
|
[--fallback-model MODEL --fallback-effort EFFORT | --clear-fallback]
|
|
20
20
|
mode configure MODE --definition-stdin [--dry-run]
|
|
21
21
|
status [--details] [--project PATH]
|
|
22
|
-
explain --level L1|L2|L3|L4 [--task mechanical|bounded|scan|deep|complex|uncertain|reasoning|latency] [--mode MODE] [--role ROLE]
|
|
22
|
+
explain --level L1|L2|L3|L4 [--task mechanical|bounded|scan|deep|complex|uncertain|reasoning|visual|computer|writing|latency] [--mode MODE] [--role ROLE]
|
|
23
23
|
models check [--verify] [--discover] [--expect-catalog HASH] [--model MODEL --effort EFFORT]
|
|
24
24
|
restore [--dry-run]
|
|
25
25
|
serve [--port PORT] [--open]
|
|
@@ -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.
|
|
3
|
+
`agent-fit` 当前版本为 0.8.0,npm 包为 `@fanglinwei/agent-fit`。本工具面向已获授权的 Codex 子任务调配模型与推理资源,本版按全新安装提供。先阅读使用说明;源码研究和校准记录用于追溯依据,不代替当前版本的验收结果。
|
|
4
4
|
|
|
5
5
|
| 文档 | 用途 |
|
|
6
6
|
| --- | --- |
|
|
@@ -1,6 +1,30 @@
|
|
|
1
1
|
# 内测实现与验收
|
|
2
2
|
|
|
3
|
-
当前版本:0.
|
|
3
|
+
当前版本:0.8.0。以下按日期保留实现与验收记录;历史结果不代替当前版本的发布验证。
|
|
4
|
+
|
|
5
|
+
## 2026-11-02 Agent Fit 0.8.0:Terra 按官方专长接入
|
|
6
|
+
|
|
7
|
+
依据官方模型指南与 Terra 模型页,cut/official 增加 visual、computer、writing 三类 L1–L3 候选,使用 Terra low/medium/high 与 Sol 6.1 medium/medium/high 故障备用。共享校验、CLI、网页与规则使用相同任务类型;保留通用基线、编码候选、L4 与 high/fire 的最高强度策略。复杂度优先于专长,高不确定性与高后果且难验收仍按原保障路线处理。
|
|
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与模拟账号/供应商,没有真实模型请求;本轮未执行插件管理界面安装、跨平台验证或付费模型复评。
|
|
4
28
|
|
|
5
29
|
## 2026-10-19 npm 公开包命名
|
|
6
30
|
|
|
@@ -117,3 +141,13 @@ Skill 由 AGENTS 入口及角色指令要求读取,没有宿主委派拦截器
|
|
|
117
141
|
验证:174 项 Node 测试通过;Chrome 集成覆盖四级与候选展示、high/fire 预览、当前/预览区分、自定义候选读取、编辑跳转、作用域继承、键盘焦点、等待状态清除旧结果、失败重试、版本冲突、恢复及原有账号/配置流程。四页在 375/768/1280/1440px 无页面横向溢出,规则页 200% 文字无横向溢出,零脚本错误,导航与查询不触发模型检测。语法检查与 diff 空白检查通过。
|
|
118
142
|
|
|
119
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,未执行真实多模型业务校准。
|
package/docs/usage.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# 使用说明
|
|
2
2
|
|
|
3
|
-
`agent-fit` 0.
|
|
3
|
+
`agent-fit` 0.8.0,npm 包名为 `@fanglinwei/agent-fit`,命令和 Skill 名仍为 `agent-fit`。首版支持 Codex;Node.js 22+。命令、网页和生成的 Skill 使用同一套档位数据。
|
|
4
4
|
|
|
5
5
|
工具只处理当前格式与版本的配置;独立 home 全程使用显式指定的路径。
|
|
6
6
|
|
|
7
7
|
## 安装与配置
|
|
8
8
|
|
|
9
|
-
从
|
|
9
|
+
从 GitHub v0.8.0 Release 下载发行包,或在项目目录运行 `npm pack` 后使用 `npm install -g ./fanglinwei-agent-fit-0.8.0.tgz` 安装。npm registry 获取的是该渠道当前已发布版本;两种方式都需要 Node/npm。本版按全新安装处理,不增加旧配置兼容。已有其他版本配置时,先保留所需自定义方案,用原版本 CLI 对原绑定 home 预览并实际 restore,之后再安装新版并 setup;不自动迁移旧档位或恢复记录。
|
|
10
10
|
|
|
11
11
|
```sh
|
|
12
12
|
npm install -g @fanglinwei/agent-fit
|
|
@@ -124,10 +124,15 @@ L1–L4 保留为推理复杂度;在最终等级内通过 `--task` 选择模
|
|
|
124
124
|
| `complex`:有界复杂任务 | L2/L3 | Sol / medium |
|
|
125
125
|
| `uncertain`:高歧义、高耦合或高后果且难验收 | L3/L4 | Astra / low |
|
|
126
126
|
| `reasoning`:复杂推理或已证实推理不足 | L3/L4 | Astra / medium |
|
|
127
|
-
| `
|
|
127
|
+
| `visual`:视觉理解与图像推理 | L1/L2/L3 | Terra 6.1 / low、medium、high |
|
|
128
|
+
| `computer`:有界电脑操作 | L1/L2/L3 | Terra 6.1 / low、medium、high |
|
|
129
|
+
| `writing`:自然写作与修订 | L1/L2/L3 | Terra 6.1 / low、medium、high |
|
|
130
|
+
| `latency`:明确追求低延迟 | 任意等级 | 须显式配置,不保证实际延迟 |
|
|
128
131
|
|
|
129
132
|
这些是待校准的本地策略,不代表已经验证模型能力或延迟。普通自动 Astra 路由默认 low,复杂推理或有证据的质量升级最多 medium;更高强度需要明确授权。**用户明确选择 high/fire 即授权其展示的最高强度,包含 Astra/ultra**;预览或保存不构成选择,预算、宿主支持和 fire 会话验证继续适用。已选择的自定义档位执行明确保存的组合。
|
|
130
133
|
|
|
134
|
+
先判断等级,再核对组合的工具、输入、上下文与验收能力。无法明确匹配任务候选时使用本级基线,仍需能力检查;候选适用依据与 L2/L3 complex 的边界见 [任务路由](../adapters/codex/skills/agent-fit/references/task-routing.md#基线与候选的选择边界)。同一组合改标签不构成质量升级,也不存在固定的跨模型升级顺序。
|
|
135
|
+
|
|
131
136
|
```sh
|
|
132
137
|
agent-fit explain --level L1 --task mechanical --role task_execute --json
|
|
133
138
|
agent-fit explain --level L1 --task scan --role task_review --json
|
|
@@ -137,7 +142,7 @@ agent-fit explain --level L3 --task reasoning --role task_execute --json
|
|
|
137
142
|
|
|
138
143
|
聊天仍须使用会话作用域及目标项目、线程上下文。`--task` 只查表,不自动分类、切档或发模型请求;不传时返回原等级基线。类型与等级不匹配会被拒绝;明确请求但快照未配置时返回 `TASK_ROUTE_NOT_CONFIGURED`,不能借用包内新值或自行拼组合。旧安装尚无候选时,预览并更新基础配置后再查询;本次基础 Skill 更新部署后仍需重启一次。
|
|
139
144
|
|
|
140
|
-
每级可选 `tasks`,键为上表类型,每项完整包含 `model`、`effort`、`fallback`(可为 null)。复制档位、三层作用域和任务快照均保留候选;单级 CLI 配置只改基线,候选通过整表 JSON 或网页“任务候选 JSON”编辑,`{}`
|
|
145
|
+
每级可选 `tasks`,键为上表类型,每项完整包含 `model`、`effort`、`fallback`(可为 null)。复制档位、三层作用域和任务快照均保留候选;单级 CLI 配置只改基线,候选通过整表 JSON 或网页“任务候选 JSON”编辑,`{}` 清空本级候选。Terra 的三个专长候选分别带有 Sol 6.1 备用;latency 仍须独立显式配置,不能凭模型名承诺低延迟。
|
|
141
146
|
|
|
142
147
|
三个作用域的复制内容均与同一作用域下 `mode show <源档位>` 显示的完整定义一致。源档位对应已部署快照时复制该快照;旧快照没有的候选不会因复制而自动加入。
|
|
143
148
|
|
|
@@ -166,8 +171,7 @@ agent-fit explain --level L4 --role task_review
|
|
|
166
171
|
无需全局安装的 npm 查询,以及本地包查询:
|
|
167
172
|
|
|
168
173
|
```sh
|
|
169
|
-
npm exec --package
|
|
170
|
-
npm exec --package="/path/to/fanglinwei-agent-fit-0.7.3.tgz" -- agent-fit status --details
|
|
174
|
+
npm exec --package="/path/to/fanglinwei-agent-fit-0.8.0.tgz" -- agent-fit status --details
|
|
171
175
|
```
|
|
172
176
|
|
|
173
177
|
## 委派收益检查
|
|
@@ -295,7 +299,7 @@ Astra 不可用:先区分认证、权限、额度、临时故障或能力不
|
|
|
295
299
|
|
|
296
300
|
## 验收失败与质量升级
|
|
297
301
|
|
|
298
|
-
|
|
302
|
+
请求成功而结果未达原验收属于质量问题,不能当作模型不可用。主代理先指出可复核的失败,再区分材料/环境前提、方法或交接遗漏、推理不足;前提缺失先补齐,方法遗漏可补正后有限重试,推理不足或新暴露复杂约束才重评困难部分等级。用户选择、原预算与宿主能力允许时,选择原任务快照中的同级基线、任务候选或更高等级主组合,说明它针对的具体失败,保留原职责和验收;本级 fallback 仅供可用性接续。
|
|
299
303
|
|
|
300
304
|
比较实际 model + effort,相邻等级组合相同不重派;可核对下一不同组合,但自定义高等级不保证能力更强。high 的 L3→L4 与 fire 的升等级都没有实际组合提升,无适合候选时报告上限。若有新证据或具体方法修正,可以在余量内重试原组合,并如实称为重试;不机械地先加 effort 或先换模型。
|
|
301
305
|
|
|
@@ -336,6 +340,37 @@ JSON
|
|
|
336
340
|
|
|
337
341
|
最高 64 KiB UTF-8 JSON;必须明确全部等级与备用/null;每级可选 tasks,候选也须完整提供 model、effort 和 fallback/null,拒绝未知字段、无效类型/等级、缺级、半对参数或主备用相同。与单级参数互斥。活动定义与部署角色同一事务保存;非活动定义只保存,不激活。
|
|
338
342
|
|
|
343
|
+
### Terra 专长路线
|
|
344
|
+
|
|
345
|
+
[官方指南](https://learn.chatgpt.com/docs/models)将 Terra 6.1 用于日常写作、视觉工作和支持的应用操作;[模型说明](https://developers.openai.com/api/docs/models/gpt-6.1-terra)强调视觉推理、电脑操作与自然写作。cut/official 的 visual/computer/writing 使用本地 L1 low、L2 medium、L3 high,故障备用分别为 Sol 6.1 medium、medium、high。官方未制定此等级表,当前映射不代表实测性能优势。high/fire 按原最高强度策略处理这三类任务,L4 不提供 Terra 专长路线。
|
|
346
|
+
|
|
347
|
+
先确定复杂度与保障要求,再核对主要工作是否属于专长、关键事实和约束是否已知、结果是否可核验。开放研究、强耦合或高后果且难验收的任务仍使用基线或 uncertain/reasoning;含有图片或产出文章不足以选择 Terra。电脑操作仍须原工具与写入授权,不能扩大只读职责。
|
|
348
|
+
|
|
349
|
+
```sh
|
|
350
|
+
agent-fit explain --level L1 --task visual --role task_scan --json
|
|
351
|
+
agent-fit explain --level L2 --task computer --role task_execute --json
|
|
352
|
+
agent-fit explain --level L3 --task writing --role task_review --json
|
|
353
|
+
```
|
|
354
|
+
|
|
355
|
+
聊天中补齐 Skill 要求的 session、project 与 thread 参数。已有自定义定义和任务快照不自动合并新候选;可从当前内置定义创建新档位,或通过完整定义编辑。配置与规则同步后重启一次 Codex,随后按新任务查询;不需要先追加模型评测。
|
|
356
|
+
|
|
357
|
+
### Terra 历史候选评估
|
|
358
|
+
|
|
359
|
+
以下保留早期评估复现步骤,不是当前推荐分配。包内 [terra-evaluation.json](../adapters/codex/profiles/terra-evaluation.json) 只将 official 的 L2 bounded、L3 complex 改为 Terra 6.1/medium,实验路由的备用为 null,以分别观察原验收和失败;其他路由保留冻结原值。它不含后来的 visual/computer/writing,保留历史快照,不证明 Terra 比 Luna 或 Sol 更合适。
|
|
360
|
+
|
|
361
|
+
以下命令在包根目录执行。先替换 home、项目及目标聊天 ID;只创建、保存和预览会话自定义档位,不执行 mode set,不修改当前选择。导入的是完整冻结定义,不与本机已有配置逐字段合并。
|
|
362
|
+
|
|
363
|
+
```sh
|
|
364
|
+
evaluation_home=/path/to/codex-home
|
|
365
|
+
evaluation_project=/path/to/project
|
|
366
|
+
evaluation_thread=TARGET_THREAD_ID
|
|
367
|
+
agent-fit mode create "Terra 评估" --from official --scope session --codex-home "$evaluation_home" --project "$evaluation_project" --thread "$evaluation_thread"
|
|
368
|
+
agent-fit mode configure "Terra 评估" --definition-stdin --scope session --codex-home "$evaluation_home" --project "$evaluation_project" --thread "$evaluation_thread" < adapters/codex/profiles/terra-evaluation.json
|
|
369
|
+
agent-fit explain --mode "Terra 评估" --level L2 --task bounded --role task_execute --scope session --codex-home "$evaluation_home" --project "$evaluation_project" --thread "$evaluation_thread" --json
|
|
370
|
+
```
|
|
371
|
+
|
|
372
|
+
L3 预览改为 `--level L3 --task complex`。逐条检查退出码、errors、规则完整性、目标上下文与完整 task_profile;effective_scope 仍表示当前选择的继承来源,不表示预览定义已激活。实际对照使用 task_delegate 显式组合,按 [校准指南](../adapters/codex/skills/agent-fit/references/calibration.md#新模型候选与默认晋升) 冻结样本、预算与验收;实证比较与备用适配分别判定。历史对照不是使用当前专长路线的前置条件。
|
|
373
|
+
|
|
339
374
|
### 配置与模型检查分开执行
|
|
340
375
|
|
|
341
376
|
setup、设置或激活内置/自定义档位、应用当前自定义修改,以及重复设置当前档位只处理本地配置,不启动 Codex 账号/模型检查进程,不查询供应商目录、不发送推理请求,也不生成模型检查记录。配置结果与退出码仅反映本地配置操作,模型不可用或历史记录目录异常不影响配置保存。
|
|
@@ -384,6 +419,16 @@ agent-fit models check --verify --discover
|
|
|
384
419
|
|
|
385
420
|
每轮实际验证私下绑定请求地址、请求头和授权,发请求前、成功响应后及整轮结束时核对。账号切换、退出登录或所用授权变化时返回 `PROBE_AUTH_CHANGED`、`authorization_changed: true`,停止后续请求,整轮结果标为未完成;已检查项目也失去当前可用性证明。授权绑定及其摘要不进入普通 `configuration_revision`、网页或历史;历史仅保留授权是否变化的状态。
|
|
386
421
|
|
|
422
|
+
### 验证报告的不同层次
|
|
423
|
+
|
|
424
|
+
`check_status` 表示检查子结果,`status` 和进程退出码表示整条命令结果。历史保存失败时保留 check_status,status 为 incomplete、history.status 为 failed、退出非零,不能称为已保存或整条命令通过。
|
|
425
|
+
|
|
426
|
+
`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 放行,也不能把这些供应商响应字段称为对其上游路由的独立证明。
|
|
427
|
+
|
|
428
|
+
每个 checked_pairs 条目保存 source_revision 和 valid_for_current_configuration。后者描述本轮检查结束时:检测到配置/授权变化为 false,未完成或无法核实则为 null。历史记录保留当时的值,不在读取时重新认证;历史 matched 或 true 不说明对读取时的配置或聊天仍有效,使用前须重新核对。记录白名单保留这些字段,不保存认证绑定。
|
|
429
|
+
|
|
430
|
+
共享 Skill 通过 manifest 核对文件完整性。status、mode show、explain、skill path 增加 skill_revision、skill_integrity;home 的 configuration_revision 不因共享规则变化而改变。规则不完整、被修改或未登记时,rules.integrity 不再显示 clean,并给出具体诊断;只读查询和安全恢复仍可进行,但新委派必须先核验规则。用户修改不会被自动覆盖。
|
|
431
|
+
|
|
387
432
|
## 本地网页
|
|
388
433
|
|
|
389
434
|
```sh
|
|
@@ -472,7 +517,7 @@ npm pack
|
|
|
472
517
|
|
|
473
518
|
`npm test` 验证安装、档位、查询、恢复和本地服务;安装保护用例覆盖用户配置保留、冲突、符号链接、失败回退及输出脱敏。
|
|
474
519
|
|
|
475
|
-
|
|
520
|
+
浏览器集成入口自动隔离用户 home 与 Codex home,防止安装共享 Skill 到真实用户目录。浏览器集成脚本不安装额外依赖;使用开发环境已存在的 Playwright 和 Chrome:
|
|
476
521
|
|
|
477
522
|
```sh
|
|
478
523
|
PLAYWRIGHT_MODULE=/path/to/playwright CHROME_PATH=/path/to/chrome npm run test:browser
|
package/lib/codex.mjs
CHANGED
|
@@ -6,7 +6,7 @@ import { parse, stringify } from 'smol-toml';
|
|
|
6
6
|
export const PACKAGE_ROOT = fileURLToPath(new URL('../', import.meta.url));
|
|
7
7
|
export const VERSION = (await readFile(new URL('../VERSION', import.meta.url), 'utf8')).trim();
|
|
8
8
|
export const LEVELS = ['L1', 'L2', 'L3', 'L4'];
|
|
9
|
-
export const TASKS = { mechanical: ['L1'], bounded: ['L2'], scan: ['L1', 'L2'], deep: ['L1', 'L2'], complex: ['L2', 'L3'], uncertain: ['L3', 'L4'], reasoning: ['L3', 'L4'], latency: LEVELS };
|
|
9
|
+
export const TASKS = { mechanical: ['L1'], bounded: ['L2'], scan: ['L1', 'L2'], deep: ['L1', 'L2'], complex: ['L2', 'L3'], uncertain: ['L3', 'L4'], reasoning: ['L3', 'L4'], visual: ['L1', 'L2', 'L3'], computer: ['L1', 'L2', 'L3'], writing: ['L1', 'L2', 'L3'], latency: LEVELS };
|
|
10
10
|
export const ROLES = { task_scan: 'L1', task_execute: 'L2', task_review: 'L3', task_delegate: null };
|
|
11
11
|
export const START = '<!-- agent-fit:start -->';
|
|
12
12
|
export const END = '<!-- agent-fit:end -->';
|
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
|
-
|
|
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' :
|
|
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
|
}
|
package/lib/model-history.mjs
CHANGED
|
@@ -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))
|
|
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');
|