# 0.2.0 完成范围与后续工作

本次任务在P0基础上依次实现P1、P2，并将新增的P3定义为可靠性、安全、性能和真实模型验收。P3并不表示达到任意规模的生产SLA或实现原需求之外的全部未来能力。执行证据统一见[VALIDATION](VALIDATION.md)。

## 已实现的边界

| 阶段 | 0.2.0中的实现 |
|---|---|
| P0 | 独立bundle、普通文字与UI规划、21种组合组件、严格DSL、React原生聊天节点、局部状态/受限计算、表格与SVG图表、基本历史恢复 |
| P1 | DSL1.1动作、Host capability目录、scoped Remote、实际principal/Session来源验证、持久化请求账本、Agent bridge、既有工具权限与原生审批、callback、结果过滤与映射、状态回执与不重放恢复 |
| P2 | open/patch/complete/cancel工具、Host游标、节点add/update/remove、完整checkpoint、原生Session传输、稳定节点身份与输入/焦点保留、重复/冲突/缺口/终态、历史恢复 |
| P3 | 真实DeepSeek模型验收、真实Harness工具/审批/存储与浏览器验证、Client响应编解码、并发取消/结果/历史竞态修复、重放/重启/卸载检查、复合资源边界、AJV结构Schema一致性、包检查和有界性能测量 |

高级功能默认关闭，可通过管理员patch分别启用。没有为插件增加核心Agent Loop补丁或自定义Session V4事件。上游公开接口仍处于预览，插件主动锁定验收版本。

## 有意保留的限制

### 1. 模型质量

规划依靠现有Agent、系统章节和工具描述，未建立第二个分类器或额外planner服务。真实模型测试覆盖文字、计算器、数据比较、动作、组件流；样本少，不能推断广泛任务成功率。首次无效DSL会被拒绝并反馈有界诊断，模型可以修复，不应把修复后的成功写成首轮全部正确。

下一步可构建固定自然语言任务集，分别测量“是否需要UI”“选用什么组件”“Schema首轮通过率”“语义结果正确率”和“操作完成率”，固定模型、提示与成本预算进行版本比较。

### 2. 逐Token compiler

0.2.0是组件级流：每次工具提交的JSON都完整可验证，每步保存完整快照。不在未闭合JSON或任意token上挂载组件。

若增加token增量解析，应作为独立生产者层，只产出当前严格协议可接受的节点，保留CPU/队列/字节上限、取消和最后合法快照。不能为更早展示而跳过Schema或让字符串变成代码。

### 3. 工具参数与结果生态

动作参数为最多32个字段的平面标量对象，总16KiB；公开结果为管理员开放的标量字段。不提供任意嵌套对象、原始结果浏览器回传、目录批量删除界面或任意URL action。

复杂文件管理、数据库查询、分页表格等场景需要可信适配工具，把有限业务输入转换为内部调用，并筛选结果。后续可以添加明确的表格/图表数据集结果类型，但要独立限定字段、行数、敏感字段与映射方式，不能开放任意对象复制。

### 4. 可编辑状态持久化

当前Session保存结构/初始值，浏览器保留同代实时输入；刷新重置未提交值，Host只保存明确动作提交参数和结果。这是明确的状态边界，并非遗漏历史UI结构。

跨设备草稿需要单独设计有版本的快照、会话/主体归属、敏感字段策略、过期时间和冲突处理。恢复草稿仍不能触发提交或把历史执行结果重复映射。不能直接把localStorage当作可信操作记录。

### 5. 分布式幂等与外部事务

账本面向单Host持久化服务。容量满后拒绝新增，不自动驱逐旧幂等记录。外部副作用完成、Host未成功记账时可能unknown；没有通用自动重试或回滚。

多Host部署需要提供真正共享事务/原子认领的存储适配，并针对目标外部服务使用幂等键或可查询执行凭证。必须验证租约失效、双主、进程崩溃和网络分区；本插件不把本地文件账本称为分布式exactly-once。

### 6. 性能与兼容

当前UI规模有硬上限，状态更新不调用LLM；完整checkpoint和完整语义验证有可预期的额外字节/CPU成本。本地benchmark仅是所测机器的测量，不代表浏览器60fps、低端手机性能或长期压力测试。

后续优化可按测量结果加入受影响分支计算、Worker或批处理，前提是保留原子验证、状态一致性与取消语义。Desktop、TUI、其他Harness版本和真实模型PTC全链路需要单独兼容矩阵；已有PTC事件fixture通过不等于该全链路验收。

## 接口演进规则

旧DSL1.0继续禁止外部动作字段；新行为不能偷偷改变旧文档含义。结构版本、流generation/seq/revision和action requestId各有独立语义。未知版本安全拒绝，迁移必须显式且可回归。

若上游未来提供“无需LLM但具备真实turn/审批/日志语义的外部工具事务”正式接口，可以替换目前一个模型请求的Agent bridge。届时应保留Host主体校验、持久化保留、工具权限链和结果过滤，并用同一组端到端测试证明没有降低授权边界。