场景与递进示例

同一业务从最小配置开始，再增加复用、绑定、策略或自定义实现。TypeScript 与 JavaScript 使用相同运行合同；Node.js 与 NestJS 只在宿主装配边界区分。

Core · 接口与运行保证

• Agent：先运行，再逐步绑定 Tool 与依赖：Engine 执行有界循环；绑定 Workflow 后，每次只传状态中变化的数据。
• Workflow：节点、路由与局部状态更新：用一份真实参与运行的节点定义，集中展示执行顺序、分支、错误去向和结束条件。
• 复用基础 Workflow 与 Agent 分支：add 保留旧 Workflow，生成组合后的新 Workflow；fork 继承已有绑定及分支来源。
• route：生成完整配置，沉淀常用判断：route 函数组生成普通 WorkflowRoute 配置；手写对象与生成配置遵守同一个合同。
• 过程监听与节点报告：App 订阅 Core 执行事实；节点报告自身 usedModel，并用实例式子日志先记意图、再补结果，Loop 负责身份和日志。
• 尝试预算与错误归属：将尝试次数、数据无效和流程合同错误分别表达，不把所有失败都转成成功正文。
• ContextJournal：回执的请求内投影：将真实调用回执变成可用于后续上下文的请求内记录，不另起持久日志系统。
• ModelRunner：输入可以省写，输出合同保持一致：用真实 Provider 端口执行一次模型交互，返回 value 和本次 invocation。
• 实际请求测量与同次准备快照：需要提前处理上下文时才 prepare；多次测量与最终发送复用同一次传输准备。
• 一次绑定，单次多模型与跨次切换：构造时提供稳定模型配置；请求用配置 ID 选择，不反复注入 Provider。
• 子执行：隔离记录，共享祖先额度：子 Runner 不继承对话和输出接收器，但不能绕过父级预算、取消和期限。
• 模型 Tool 与传输：完整校验后才得到类型化选择：Tool 定义提供 Schema 与 resolver；传输将 wire 输出翻译为统一的模型选择合同。
• 真实工具调用与请求内运行时：Core 注册并执行真实工具，返回带 invocation 的回执；业务授权由 App 注册的实现拥有。
• 协议目录：同一清单驱动匹配和校验：按 App 自己的协议 ID 登记规范；Core 不内置业务阶段名称。
• 上下文片段：明确来源、信任和预算：Core 识别片段与装配合同，校验来源元数据和预算，不内置业务压缩算法。
• 宿主已选定调用的同步执行适配：为宿主已经选定的同步调用统一记录开始、完成和失败，不替代选工具与授权。
• 结构查询键与文本公共前缀：用于稳定比较与用量分析的小型纯函数，不是授权、散列或语义去重系统。

Support · 推荐实现与策略

• JSON 值传输：直接校验结构化结果：从输出 Schema 生成 JSON 收集与解析实现，不增加 Tool 选择 envelope，返回统一的模型回执。
• 推理策略：显式 wire 格式与自然档位：Support 按显式选择的协议格式生成推理参数，保留精确覆盖与自定义映射。
• 模型策略：显式选择与推荐预算：从已登记的模型和推理配置中选择，以本地预算档位补全 Core 设置，并保留逐字段精确覆盖。
• Schema：保留 JSON 声明与实际解析的同一合同：Support 生成规范的 SchemaAdapter，Core 只要求 jsonSchema 与同步 parse 合同。
• 工具最佳实践：一份定义生成模型 Tool 与执行运行时：把 Schema、授权、执行和输出校验登记一次，按请求绑定 App，避免维护两份工具清单。
• 能力组合与声明式安装：集中列出模块、工具引用和注册顺序；通用循环只消费这份实际清单。
• 模型传输与阶段投影：从 Tool 定义生成封存目录与阶段投影，原生函数和 JSON 适配复用同一 Tool 合同。
• 兼容 Provider 与自定义 Provider：Support 负责常见 Chat Completions HTTP/SSE 生命周期；App 可替换为自己的 ChatProvider。
• 正文预览：有序输出，不代替最终接受：按已登记的 stage/tool/字段路径提取可展示正文，拒绝把控制提议当作已执行结果。
• Provider 观察与 App 自己的记录目标：稳定 Provider 绑定观察规则，本次请求只关联自己的目标，子作用域继承关联。
• 拒绝检查、首个匹配与顺序处理：使用真实清单表达多项检查和枚举分发；单个普通判断仍可直接使用 if。
• SSE、JSON 帧与有界事件流：复用传输机制，保持取消和背压；协议解析与业务校验仍各自负责。
• 仅在特定模型协议失败时显式回退：处理不支持的并行提议，不接管 App 的全部重试和业务错误。
• 上下文装配：稳定元数据配置一次：Support 提前绑定片段元数据、格式化和顺序，请求只提供变化的业务输入。
• 上下文处理是普通 Workflow 节点：通过正常节点与路由接入选择、裁切、压缩，Core 统一记录并调度它们。
• 上下文策略：验证、缩减与审计：Support 给出可替换的策略实现，Core 保留最终输入合同和预算检查。
• 选择缩减步骤：顺序、固定、自动或模型：一套类型化策略表达多种场景，保留精确参数与 App 自定义选择。
• 压缩器与选择器：推荐实现和自定义算法：将提示词、输出解析和算法绑定为 handler；模型 I/O 通过同一请求的 callModel。
• Support：推荐用法的聚合入口：Support 聚合推荐的构造、策略与同源配置生成；Core 运行不依赖这个命名空间。
• 从历史语义生成处理策略：复用片段身份与硬预算，生成 recent 或 continuity 的完整步骤和引用。
• 从 Tool 与阶段声明生成预览规则：复用实际 Schema 与阶段引用，只为明确允许展示的 Tool 生成规则。
• 子任务组合：顺序执行与受控并行：复用 createChild 和共享预算，检查全部结果后按声明顺序提交。
• 装饰器：处理类与已有实例方法：类装饰代办定义实例化，方法装饰绑定原对象；输出仍走原 define、构造和 bind。

Kit · 可选业务库

• Knowledge：资料、章节与证据快照：同一份资料合同支持普通对象与带锚点的文本；选读后得到明确版本的证据快照。
• Answering 目录：任务、资料读取与检查引用：同一任务定义关联输入 Schema、reader、output 和 check，装配时验证真实引用。
• Answering Flow：逐项生成、复核与局部修正：对已拆分的问题批次保留覆盖关系，修复失败项，不重新生成已经通过的项。
• Presentation：字段所有权与最终输出：模型只填写被分配的字段；固定文字、绑定值和语义键由程序拥有。
• 模板、语义槽与表达选择：程序拥有模板和偏好顺序，插入值只替换一次，变体随机源由 App 提供。
• 答复事件：文本分片和气泡边界：把已经接受的答复变成可等待的文本/气泡事件，保留取消和交付背压。
• Domain Tools：Tool 声明与范围关系：同一清单提供可用 Tool、允许 delegate、范围别名、来源和工具关系。
• Agent Catalog：从真实注册结果生成 Tool 菜单：Tool、范围和工具菜单由真实目录投影，不单独维护一份提示词 Tool 清单。
• Interaction：声明命令并绑定本地处理器：命令的字段、目的、选择器、检查和 handler 来自同一声明，模型不能添加可执行处理器。
• Tools：App 工具生命周期与内容贡献：对已有复杂 App 工具统一登记工具调用、输出规则、上下文贡献和交付处理。
• Normalization：有顺序的值转换：把清理、替换和停止条件集中为一份实际参与执行的转换清单。
• Delivery：顺序交付与显式结束：每个交付阶段明确 continue 或 complete；一个阶段完成后立即结束。
• Projection：按预算投影内容：先缩短文本，再减少条目；源数据、投影结果和预算由 App 显式区分。
• Aggregation：查询汇总与稳定合并：顺序读取 App 数据，将重复项如何合并留在同一份配置中。
• Retrieval：有额度的同步检索生命周期：把规范化、校验、去重、授权、读取和后续效果放在一条确定的调用路径中。
• Evidence：用真实观察检查完成性：用 App 定义的证据语义检查需求，避免把模型的“完成了”当成真实回执。
• Policies：全部命中与首个恢复：策略集收集所有匹配理由；恢复链按顺序选择第一个显式 handled 结果。
• Candidates：有界候选封套：同一结果可以是单项提议或候选清单；候选权限与数量由应用控制。
• TextSkills：只读文本 Skill：校验已登记的文本工作说明，读取由 App 提供；不运行文件里的代码。
• TextBlocks：长文本结构分片：把长文本切成有界结构块，为分页读取或索引保留原文与偏移。
• TextSearch：App 侧全文索引：按已声明字段建立局部索引，查询必须给出应用过滤器。
• VectorSearch：有边界的精确余弦检索：给定同一个向量空间，先过滤文档，再按余弦相似度排序。
• Rank Fusion：按名次融合多个检索结果：融合全文与向量结果的名次，避免直接相加语义不同的原始分数。
• ModelCalls：外部推理绑定：为 embedding 等 App 自定义 I/O 绑定身份、校验、取消与统一调用回执。
• Artifacts：按引用解析真实产物：引用只包含 resolverId、artifactId 和可选 revision，真实内容由 App 的解析器提供。
• Durable：显式检查点与受控恢复：App 提供实际检查点存储和排他锁，任务沿同一定义与累计额度显式运行或恢复。
• MockGPT：直接生成与 Provider 注入：直接取得字符串或 JSON；需要检验模型通信时，将同一个实例注入 Provider。
• MockGPT：响应描述与场景生成器：固定结果用于严格回归，输入相关生成器用于探索接线，显式响应描述用于故障和流式场景。
• MockGPT Node：最小模型服务与 HTTP 挂载：同一 MockGPT 配置作为独立模型 API，或挂入现有 Node HTTP 服务。
• MockGPT Web：可信来源与本地摘要：从真实网页或可信 load 取得正文，再交给输入相关生成器。
• 日志复盘：授权元数据与证据报告：App 提供获准证据源，复盘任务通过普通模型与工具合同生成有来源的报告。
• Agent 分支：版本、合并与显式启用：在真实 CAS 存储上管理数据分支，候选版本经检查和授权后显式启用。
• 知识候选：编译检查与显式发布：候选准备与发布复用 Knowledge 编译器，真实存储通过 CAS 提交正式资料。