Preserve isolated local drafts across navigation and reload

2026-10-19 22:47:17 -07:00
parent 9d69629bc8
commit 6a36a49290
16 changed files with 174 additions and 38 deletions
@@ -168,3 +168,14 @@ POST /consultation-credential由普通凭据签发专用token，数据库只存h
 完成与归档前须检查绑定咨询session消息：有queued/claimed/uncertain未完成输入时返回409，保持可交流；completed立即拒绝新咨询POST，历史GET保留。fleet仅在archive_status=archived且本机worker无inflight/pending_completion/needs_reconciliation时停止自有子进程，不终止模型writer。已入队旧通知接收者fresh GET核对revision，过期静默停止，不能由快照直接执行。有限CLI及fleet负责已有绑定的桥接，不自行创建或归档宿主会话。

 真实决策独立会话的创建、绑定后签发有限凭据、桥接、事实核实和完成归档步骤见 [独立决策会话接入](decision-sessions.md)。notifier调用决策通知submitting接口后才向宿主队列外发，保留不可变快照与未知结果保护；不能仅清应用队列冒充取消宿主输入。
+
+
+页面升级与旧草稿：状态同步不会替换已加载的网页代码。服务公布当前前端入口文件，版本变化只提示，不自动整页重载或重发。新版草稿保存机制应在同浏览器、同实例及对应会话/决策范围内恢复输入与重试信息；存储失败或旧页面尚未支持持久保存时明确提示先自行保留内容再重载，不能把复制作为正常持久化方案。旧提交缺expected_revision仍拒绝写入，不猜版本；核对response/history和咨询消息确认落库结果，再由人类入口说明操作。旧版已丢稿无服务证据不得承诺恢复。
+
+## 本地草稿实际存储契约
+
+同源localStorage使用workbench-draft-v1:前缀加JSON数组作用域。沟通为[instance_id, communication, 入口session]；决策为[instance_id, decision, decision_id, revision]；咨询为[instance_id, consultation, decision_id, session_id或unbound, revision]。不包含token，不上传未提交正文。实例或有效版本尚未就绪时禁发，不猜版本；新浏览器、不同源/实例或清理浏览器数据不保证恢复。重新登录不以token作为草稿身份，因此同浏览器同范围可恢复，并非按用户账号隔离。
+
+每次输入写入，POST前先持久保存attempt幂等信息；失败或结果未知保留，刷新后可由用户明确重试，不自动发送。读取/保存失败显示具体风险并阻止发送，可重试保存；清除失败提示旧稿可能残留，不应重复提交。成功只清对应当前版本草稿，比较已存值防迟到响应删掉随后编辑；咨询成功不清决策选择。只确认接口成功不表示模型已回复或业务验收完成。
+
+当前版本无记录时可读取同作用域最近旧版本草稿，保留旧revision，须用户明确重确认，决策旧选项清除后重新选择/检查意见。已完成决策的残留草稿只读，不自动重交。显式单项清除：沟通仅当前session；决策仅该决策所有版本；咨询仅该决策与咨询session范围所有版本，互不影响。清除留下无正文cleared标记防旧版本草稿重新出现。绑定session变化属于不同范围，不承诺自动跨绑定迁移。