docs: hand off context snapshots and next-message permission staging

docs/协作/上下文快照与下次权限-交付-01.md

@@ -0,0 +1,37 @@
+# 上下文快照与下次权限：交付 01
+
+2026-10-21。源码 `1a913cdb672588161f0d6d3c8db9dbbff47a6315`。
+基线 `607afd2f399c68fd2e19134bd789cffb3c855d3c`，包含此前思考区优化。
+
+## 上下文分类随会话保存
+
+- 读取已有 cached Claude 内核的 native-summary 分类后，按会话、历史分支、助手/请求/模型、内核实例/group/config 身份在现有会话锁内校验，独立保存 contextBreakdown；不合成或覆盖服务端真实 contextUsage。
+- 分类快照可在运行期间保存。流式/结束 checkpoint 在消息原子修改时保留同请求同模型更新的已保存分类，避免旧克隆擦掉查询快照。
+- 内核关闭、查询失败、应用重开后读取已保存分类；落盘失败保持上一快照，不报告新样本保存成功。不会为统计启动内核或调用模型/逐类计数 API。
+- UI 单独标出分类快照的时间及方法；native-summary 明确为“内核 summary 本地估计”，不再错写为 UTF-8 字节估计。真实总量和分类估计并存也保持不同来源。
+- 从未捕获过分类的旧记录仍可能无数据；不凭空补零，不新建独立 tokenizer 或发送前预估。
+
+## 运行中选择下一消息权限
+
+- 普通对话运行/发送期间可调整 craft 权限偏好，显示“下次发送生效”；全访问风险确认保留，plan/ask 与加载失败限制保留。
+- 当前内核、工具及待处理授权不变。新发送消息在提交时捕获权限，包括提交前已开始但尚未完成的偏好保存；提交后再切换不会追溯改写该消息。
+- 已排队消息保留捕获值；老数据未捕获权限时按 default-sandbox 安全回退。只在 enqueue 边界补充新请求权限，重试/立即追加不借新偏好提升旧请求。
+- 不同权限消息不能 live append/steer 到当前回合：返回 submitted:false，保留队列条目并显示阻塞原因，待下一回合按其权限执行。下一回合才调用 setPolicy。
+- 偏好保存失败不提交错权限；跨会话迟到错误隔离；首次创建会话时后续权限选择迁移，不改变已捕获的第一条消息权限。
+- 保留此前“授权卡独占底部”规则，不向授权卡另插权限工具栏；这不意味着切换偏好可以解决/绕过当前授权。
+
+## 验证与边界
+
+- `npm test`、严格 alignment 11 offline + 8 DOM、完整构建通过。
+- 上下文单元回归、真实 IPC/会话存储与冷重载、checkpoint 覆写/保存失败回归通过。
+- 请求设置 7 组回归、基础及 16 项对抗队列检查、权限 UI 静态渲染通过。
+- `node scripts/test-next-permission-host-isolation.mjs` 实际打包并调用 IPC、turn service、queue，外部 adapter/内核为离线 mock：当前 pending 授权不变、不额外 setPolicy；下一回合应用新权限；旧排队消息保留旧值；不同权限立即追加无附件/资源/append 副作用且条目保留。
+- 核心 chat-store 测试原有固定微任务等待因新增保存等待变得过短，改为有界显式 mock IPC 进入信号；保留重复发送拒绝，并在完成前后断言只有一次 IPC，未放宽业务要求。
+- 独立审查和 CRLF-aware diff 检查通过。证据：[目录](evidence/context-next-permission-01)。
+- 没有真实 SDK/模型调用、Windows UI 或原生端到端验收。不能将 mock host 验证宣称为供应商或真实 CLI 故障矩阵全部通过。
+
+## Windows 验收重点
+
+默认→完全访问、完全访问→默认，在运行中切换后当前工具/授权保持原行为；新排队请求使用新权限，旧队列不变；尝试立即追加不同权限得到明确提示且消息不丢。保存失败/首发建会话/快速切换会话不能串偏好。
+
+打开分类明细取得快照，再停止/切换会话/重开应用核对上次分类和时间仍在，真实用量不被擦除；更换模型/回退分支后不把旧样本误标成新请求精确用量。