feat(sandbox): 在有界后台工作线程中登记原生实例

2026-09-09 01:30:57 +08:00
parent 96778c02f3
commit 8936974059
6 changed files with 844 additions and 0 deletions
@@ -519,3 +519,15 @@ Core 的独立数据目录目前不等于已授权 Vault。Python 旧笔记写
 - 单元测试覆盖预览对象被改写后实际参数仍冻结、重复确认、跨实例、目录代次、确认前/后过期、条数/字节上限及清理后复用。真实 AppContainer 测试核对预览来源/包/Vault，修改展示副本不会改变实际请求，旧目录凭据被拒绝；新增确认后锁定保险库导致 CREDENTIALS_LOCKED，重新解锁也不能恢复已失效会话。
 - 64 项扩展回归通过，5 项 ignored 为三个父测试驱动 Job 辅助入口及两个显式长时验收，本轮未重跑长时项。desktop 全目标 Clippy -D warnings 通过。日志 `.build/extension-call-binding-tests.log`、`.build/extension-call-binding-clippy.log`。
 - 当前 confirm_call 仍只是 Host 内部组件接口，未登记为 renderer/Core 命令，也没有自动批准策略或真实用户确认 UI。完整产品入口必须通过经过认证的 Host 路由确认用户批准，再与活动安装/在线信任、实例注册和 Core 路由组合；全部沙箱资源与其他生产化验收仍未完成，第三方执行能力保持禁用。
+
+
+## 增量：后台实例注册、串行派发与停止清理
+
+- 新增 extension_instance::Registry。启动先用当前时间核验执行许可，再按执行类型、来源/命名空间/包和 Vault 限制同键单实例；最多 16 个注册项。每个工作线程在自身栈中创建并持有 Profile、PinnedPackage、BoundEntry、Running 与 Session，没有把带裸 SID 的 Profile 强行标为 Send。
+- 工作线程完成包校验、AppContainer/Job 挂起创建后调用 before_resume 复核钩子，再执行带租约恢复和 MCP 初始化/目录发现。该 start API 为 unsafe 内部集成边界，调用者仍须建立完整资源、用户与活动安装授权；本轮没有将“钩子存在”当作在线信任或完整沙箱策略已接通，也未新增 renderer/Core 启动命令。
+- 每实例四槽请求队列，预览参数入队前即执行 256 KiB/结构限制；预览、确认并调用、目录刷新由实例线程串行处理。确认和一次性凭据消费合在同一线程，ApprovedCall 不通过 IPC 返回或另行长期排队。回执等待限于后台，取消/丢弃 Ticket 会通知排队或进行中的工作；超时不证明远端工具尚未产生副作用，后续 Core 路由仍需正确呈现未知完成状态。
+- stop 使用独立原子信号并取消当前请求，不会被满队列阻塞；后台循环持续处理空闲 MCP 通知和租约撤销。终态在原生栈所有者退出后发布，Profile 显式删除失败有稳定错误；Registry 只回收确认已完成的线程，清理失败或 worker panic 的注册项保留隔离，避免直接允许同键替换。Registry 析构会停止并 join 工作线程，因此其生命周期管理不能置于 UI 同步调用中。
+- 真实后台 AppContainer 集成测试覆盖启动/目录就绪、预览与确认调用、重复确认拒绝、停止、线程回收后以新实例 ID 重建、活动工具取消、启动前策略拒绝及保险库锁定自动退出。测试同时确认旧 Endpoint 不能再提交请求，并通过保留的仅测试 Job 观察句柄确认最终 ActiveProcesses=0。
+- 集成测试最初以固定 ActiveProcesses=2 判断工具子进程启动，本机在 Ready 时已计入 2 个进程，导致实际取消的是排队请求。已改为同时确认当前 Ticket 处于执行槽、且进程数超过该实例就绪基线，再触发取消；修正后得到进行中工具的 MCP_CANCELLED 并清空 Job。此前仅凭固定计数的证据不能单独用于识别某个具体后代进程。
+- 新增队列满/输入超限/停止后队列不执行，以及已结束但清理失败的注册项不回收测试。67 项扩展回归通过，5 项 ignored 为三个父测试驱动 Job 辅助入口及两个显式长时验收，本轮未重跑长时项。desktop 全目标 Clippy -D warnings 通过，首次检查的回调类型复杂度提示已通过类型别名修正。日志 `.build/extension-instance-tests.log`、`.build/extension-instance-regression.log`、`.build/extension-instance-clippy.log`。
+- 仍需将注册表纳入实际 Host 依赖与 UI/Core 的认证路由，完成活动安装/在线信任钩子、包对象权限回收/残留检查、全部 Host 创建路径继承审计、scratch/CPU 和完整攻击矩阵；其他同步/部署/安装包验收也继续推进。第三方执行能力保持禁用，完整生产化目标尚未完成。