SuperAPI AI 工具集

session-source-fork

智能体与模型

查看项目

更新于 10-16 01:33

技能介绍

用途:session_source 是 OpenRig 的成员级字段,声明新启动的托管席位应如何从先前的运行时会话来源派生初始对话连续性。v1 仅支持一种模式 fork:从先前的原生运行时会话来源启动新席位,且不宣称原席位被延续。模式为运行时中立,实现为运行时特有。

适用:编写需从先前会话 fork 的 rig spec 成员;编写带 session_source 的 rig expand 载荷;判断新席位该用 fork、rebuild、resume 还是 fresh;组合 fork 与 handover。不适用于:恢复(restore)既有席位、基于产物的心智模型重建(应使用 rebuild)、terminal 运行时(schema 层拒绝 session_source)。

规范形态(YAML):members 下含 id、runtime(claude-code 或 codex,terminal 无效)、agent_ref、profile、cwd,以及 session_source:mode: fork,ref: kind: native_id,value: 会话 id。规则:v1 中 mode 仅 fork;ref.kind 仅 native_id,schema 会预先拒绝 artifact_path、name、last、artifact_set。rig expand 接受相同形态。该原语不引入新顶层命令,仅经现有 spec 与扩展路径流转。

状态模型:session_source 是启动时输入,而非长期状态字段。声明→启动时解析(Resolved)→实现(Realized,新席位获得新原生连续性令牌,父令牌绝不写入新席位)→失败(Failed)。实现后基本成为历史;之后恢复的是新席位,而非再次从父级 fork。

失败模式:源会话 id 未找到;源产物路径缺失(超出 v1 范围);不支持的运行时/kind 组合(v1 多被 schema 拒绝预先拦截);解析后 fork 启动失败;持久化不一致。诚实 UX 规则:不得报告“恢复原代理”“恢复原席位”或“快照”,正确表述是“从源会话 fork”或“从先前对话来源启动”。

适配器命令形态:Claude:claude --resume <parent-id> --fork-session;Codex:codex fork <parent-id>;Terminal 在 schema 层拒绝。连续性结果字面量:forked、fresh、resumed、failed。

边界:不引入分歧的 fork 原语;任何 UX 不得报告 restored/resumed/snapshot;不将 session_source 耦合到 AgentSpec;不改变 restore 语义。

验证:源码检出与运行中的 daemon 可能实现不同,授权 fork 前需检查目标 daemon 的构建标识及对请求来源的支持。

已发布(v1,openrig c7b6df1,2026-04-30):schema 接受/拒绝、编解码往返、经 rig expand 的扩展路径、Claude 与 Codex native_id 适配器命令形态、持久化诚实(新令牌)、continuityOutcome: forked。延期:Claude artifact_path 模式、溯源列、跨主机 fork。