Files
ai-video-fullstack/implement-stage/task-backends/ASSUMPTIONS.md
T

4.1 KiB
Raw Blame History

Assumption Ledger — Speaker / Task Backend

ID Under-determined Chosen Class Source
B-001 支持范围 仅提示词 Pipeline;可关闭后端,或选择 reasoner/opencode;一个助手最多一个任务后端 semantic user
B-002 产品资源 独立 TaskBackendResource,普通 Tool 仅 HTTP/MCP/client;Speaker 委派由平台内建函数自动注册 interface user
B-003 配置形状 后端API使用 id/name/type/description/config/secrets/enabled;助手 taskBackend 使用 backendId/instructionSource/instructions;接口 camelCase interface default
B-004 策略归属 模型、工具白名单、技能和时限配置在可复用后端资源;助手绑定可补充任务指令。提交时冻结完整解析快照 semantic default
B-005 内置执行 复用 BackendLLMWorker 与现有 ToolExecutor;每个任务独立模型实例、上下文和变量,应用级拥有者发原生 Jobs semantic user
B-006 Reasoner权限 仅资源显式绑定的 HTTP/MCP 服务端工具;拒绝 client/system/task 和循环委派;技能不增加权限 semantic default
B-007 推理强度 provider_default 或 low/medium/high;非默认值要求模型资源显式声明 supportsReasoningEffort,按 reasoning_effort 参数发送,不支持时拒绝 semantic default
B-008 技能 Reasoner 使用后端资源中的命名技能正文;OpenCode 使用远端原生技能/agent,平台仅保存说明,不伪装远程安装或权限隔离 semantic default
B-009 外部选择 OpenCode保留地址/目录/服务鉴权,新增可选 agent 与 modelProviderId/modelId;推理强度及沙箱由远端管理 interface default
B-010 执行结果 Reasoner通过明确完成/提问控制函数返回业务结果;idle、普通文本、接收回执不能直接证明成功 semantic default
B-011 生命周期与取消 语音断线继续;取消停止当前任务;原生取消不代表外部工具或远端副作用被回滚,需核查远端停止 semantic user
B-012 恢复 OpenCode只观察已有句柄;内置Reasoner重启标记中断,不自动重放工具;历史任务保留旧恢复语义 semantic default
B-013 时限与并发 新任务保存截止时间,排队和执行均计时;全局原生串行并发1,保留远端状态未确认时阻止新提交策略 semantic default
B-014 迁移 自动复制旧task工具连接/凭据至后端资源,迁移助手绑定和instruction来源;保留历史task_id、连接快照和旧时限语义 semantic default
B-015 自动测试与鉴权 沿用管理员鉴权;自动测试不得访问真实后端任务,使用显式模拟;无真实服务地址不声称联调完成 semantic default
B-016 MVP执行环境 内置Reasoner不提供宿主机Shell/文件沙箱;编码由OpenCode处理,界面明确实际权限由执行端配置 semantic default
B-017 F0过渡 Walking skeleton短暂兼容旧tool提交入口以保持累计检查;迁移阶段移除该过渡入口,不保留为新产品接口 interface default
B-018 回退迁移 0027为数据语义迁移,downgrade明确拒绝,需备份恢复;不能把新的Reasoner配置静默回退成旧task工具 semantic default
B-019 切换Realtime 已绑定任务后端时复用现有配置移除确认交互,确认切换后解除绑定,后端资源保留 semantic default
B-020 配置有效性 后端配置拒绝未知字段;资源编辑验证已绑定助手,模型/工具失效时阻止保存和执行,不静默漏掉能力 semantic default
B-021 类型与凭据 后端资源可切换类型,但必须提交完整合法配置;OpenCode转Reasoner清除服务凭据,同类型空值/掩码保留原凭据 interface default
B-022 指令模板 助手绑定 instructions 的 {{变量}} 使用任务接受时冻结的变量单次渲染;资源 instructions 和技能正文按字面使用,不访问密钥变量 semantic default