Skip to content
English

App 接入检查 ​

返回开发指南 · API 参考

以下是接入时应有的证据,供开发者按实际启用能力选择;不是每次修改都要执行的全套命令。源码可确认的先审阅,存在具体疑问时运行最小相关检查。离线替身成功不能证明真实模型效果,框架能执行不能证明业务事实正确。

边界应证明什么最小例子
独立消费仅凭交付包、依赖与文档可用独立目录按公开 exports 导入,无应用路径别名
空资料准备没有事实时保持空资料既有项目无来源时,资料文件为空,清单无虚构内容
来源导入忠实保留来源与版本supplied-source 字节一致;锚点非法、重复章节或超限拒绝
注册与引用清单真驱动运行,引用有目标未知节点/tool/reader/章节/check 有明确失败
协议解析schema 与实际输入检查一致未知字段、无效值、错误输出拒绝;parse 无业务副作用
执行只执行允许范围,回执真实模型声称成功但未执行时不得返回成功
资料选择self/subtree/document 边界正确子章节排除/包含、未知 ID、超限和版本变化
隔离身份与状态不串用户另一用户 ID 拒绝;旧请求不混入新目录
取消与预算I/O 与重试都有边界超时、取消、断流、修正预算耗尽正确结束
输出引用和动作状态由程序绑定数字、来源、链接和不完整结果被检查
增长与维护候选不会自动晋升发布准备候选不改生效源;失败保留旧版;引用破坏拒绝
诊断错误可定位且记录不改变执行同一请求关联阶段、代码、耗时,无凭据和未授权正文

选用长期记忆时额外验证消息水位、并发版本、租约恢复、幂等、删除传播和来源优先级;不启用则不必建立这些服务。选用跨端操作时验证真实对端 handler 和回执;不用 Interaction Kit 也不影响接入 Core。

审查同类能力时应横向对照普通循环、Workflow、独立 Runner、工具目录、手写端口及所用 Kit,确认同一保证由实际入口执行,不能只验证推荐 Support 写法。取消分别检查预取消、中途取消、迟到返回及保存中取消;输入分别检查非法预算、注册后替换和跨 await 的可变引用;发布分别检查核验前后及提交前的有效期。

取消用例还应覆盖计数器、检查器、观察器等同步回调内部触发取消,以及同一节点中的多个处理阶段。Provider 替身应分别记录普通 stream() 方法入口和异步迭代器读取,避免只有 generator 的测试掩盖已取消后仍进入 I/O 工厂的问题。读取器忽略取消、证据在读取中到期、发现分页失败后不留下部分可读范围,以及迭代器清理异常不覆盖原始结果,均须按各自边界验证。

报告应区分正常合同下的运行缺陷、非法配置/接入误用的拒绝不足,以及内部加固或性能优化。回归通过只证明其覆盖的边界,不能替代 App 权限事实、真实存储原子性、外部副作用回执或真实模型效果验证,也不构成整体无缺陷的证明。

当前范本的明确范围 ​

开发套件提供已有项目集成指南,以及章节解析与目录编译、候选准备、只读计划和共享校验入口。资料准备时有实际来源则据实整理,无来源保持空文件。生产 App 的身份系统、资料权限、上传解析、存储事务、画像合并、经验发布和索引仍需自行实现。

局部代码示例见快速接入和示例。离线完整示例包含可复制运行的服务问答代码,使用 Support 工具目录和离线 Provider,不需要模型凭据。验证真实模型行为时,需要使用可用模型服务与 App 配置,分别检查语义结果、工具选择和完成性。

接口参考、使用示例与开发指南。