README.zh.md 2.0 KB
description: "文本 spill 能力家族的包映射：存储服务、本地后端与结果策略各自提供什么。"
kind: "package-group"
spill/：文本 spill 能力家族
English | 中文
概述
spill/ 组在模型上下文之外保存全文，并返回定位信息与取回指引。该家族拆分为 spill/ 中的存储服务、spill-local/ 中的本地文件系统后端，以及 spill-policy/ 中的工具结果策略。工具结果 spill 通过 maxInlineBytes 按需启用，存储失败时保留原始结果。会话引用也直接使用存储来保存已捕获但被截断的 transcript（文本记录），并自行提供预览和失败通知；它不需要工具结果策略。
目录
包
三个包分别承担 spill 相关角色；完整的词汇定义和约定以子系统参考文档为准。
| 包 | 职责 | ctx 键 |
|---|---|---|
spill/ |
存储服务：保存超大文本并返回定位信息与取回指引 | ctx.spillStore |
spill-local/ |
将 spill 文本保存到本机的私有会话级文件 | 注册到 ctx.spillStore |
spill-policy/ |
用预览和定位信息替换过大的纯文本工具结果 | 监听 ctx.tools |
相关文档
先从子系统参考文档了解共享词汇，再看设计决策。
- spill 子系统——
SaveTextSpill/SpillRef词汇、归属与后端关系。 - 工具输出 spill 决策——存储、保留与工具自有输出处理之间的能力边界。