> ## Documentation Index
> Fetch the complete documentation index at: https://qitor.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 第三方扩展索引

> Replace mechanisms while preserving their public contracts.

这里列出当前可替换的框架机制，不是全包符号清单或跨版本永久稳定保证。用显式 Python 工厂装配扩展；不要让配置任意导入代码。默认示例只有纯函数工具和 fake provider，其他客户端依赖请查安装页。

| 扩展               | 公共入口                                                                    | 必须保留的契约                                                               |
| ---------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------- |
| Provider         | `qitos.models.base.Model`、`ModelFactory`；composition 的 `model_override` | 模型请求/响应、codec、continuation、typed failure；仅对应客户端需要其 extra              |
| Tool             | `qitos.core.tool.BaseTool.execute`、`ToolRegistry`                       | schema、权限、副作用声明、ToolResult、取消与未知结果                                    |
| Checkpoint store | `qitos.checkpoint.store.CheckpointStore`                                | Session capability、snapshot commit CAS、lineage、fork 与持久性；SQLite 为参考实现 |
| Event sink       | `qitos.tracing.sinks.EventSink`                                         | privacy view、loss、required/optional 失败策略、append/close 契约              |
| Sandbox          | `qitos.core.env.Env`                                                    | capability preflight、有界工具、真实隔离、artifact、cleanup；publication 单独授权      |
| Evaluator        | `qitos.evaluate.base.TrajectoryEvaluator.evaluate`                      | EvaluationContext 到 EvaluationResult、证据、provenance 与 loss             |

[Complete provider/context extension](/zh/guides/third-party-extensions) · [API index](/zh/reference/api)

## Provider stream 生命周期

内置原生 Chat、Responses 和 Anthropic stream 在发布成功前校验 provider 终态。部分工具输入、提前 EOF 和矛盾终态均失败关闭。尾部 usage-only chunk 被收集且不重复计费；缺失 usage 保持 unknown。OpenAI SDK 的 `chat_template_kwargs` 被移动到 `extra_body`，显式输出上限保持不变。

自有 SDK client 和 response iterator 在正常、异常及显式 close/aclose 时关闭。Consumer callback 的错误向上传播。Async 取消无法强制终止 Python 线程；AsyncEngine 保留 worker 所有权直至完成。Client 构造失败可证明未发送；transport 失败保守记录为可能已发送。LiteLLM、Gemini 及本地非原生 fallback 只产生一个完整 chunk，不宣称逐 token streaming。

模型历史重读保留工具实际完成顺序；声明顺序结果仍是派生视图。离线安装包消费者跨三次模型请求验证这一点。