muse-agent-example/docs/系统架构/新版设计/模块设计/B09-上下文.md

B09 上下文

职责与对象

一次任务真正允许且实际使用的材料集合。

实例归属以总体架构为准；结构、状态和公开外壳分别引用数据模型与接口契约。

公开接口

用例	输入责任	输出与后果
authorize_scope	作者身份、任务目标、用途和选择	只能被收窄的读取范围
search	冻结范围和查询意图	合法候选及省略原因
assemble	必读、预算和固定绑定	角色所需材料
freeze	已执行探索、来源和投影	不可变快照和哈希
replay	快照、原读取身份和当前授权	可回读材料或明确失效
check_dependencies	来源、结构、策略和事务上下文	当前有效性及锁定依据

所有接口在本模块的接口.py 暴露。输入输出类型由同一公开表面导出，外部不导入私有模型或 SQL。

内部职责

文件	职责
接口.py	上下文公开用例和可导入合同
模型.py	上下文稳定对象、外壳及内部状态
存储.py	上下文所属记录的 SQL 与版本读写
任务范围.py	作品、用途、时点和来源权限
来源读取.py	按业务公开接口读取固定来源
混合检索.py	专名精确、关键词与向量合并
材料装配.py	必读、预算、取舍及字段投影
探索回放.py	按同一范围重放工具读取
冻结快照.py	来源、结构、投影和消费片段
依赖校验.py	授权、撤回、结构与数据版本变化
索引维护.py	切块、嵌入、重建与陈旧拒绝

完整路径及运行模板见目标文件清单。逐文件意图、边界与目标见文件合同。

实现约束

• 预组装、探索、回放和采纳复检使用一致范围，不能仅保护预组装。
• 来源数据经各业务公开接口取得，动态字段由 S04 投影；检索只能在已授权集合内缩小。
• 专名和数字有确定性检索路径，向量质量以中文样例验证。
• 实际入选、省略、版本、片段和模型消费有记录；历史可重读不代表仍可用于新任务。

协作与失败

聚合 B01—B07 的查询和 S04 投影，S02 留痕；来源索引是派生物。

其他作品、未来章、未确认或撤回来源拒绝；必读不足返回具体缺项，不能补造材料。

验收行为

• 三阶段工具读取都拒绝越界。
• 结构用途收紧立即影响消费。
• 回放使用相同输入版本。
• 向量命中不绕过真实来源校验。

验收入口和替换条件见迁移与验收；这些条目是目标行为，不是已通过测试的声明。