InkClaw 线上安全通用智能体

要处理的运行事实

长上下文被拆短后，并发准入、异常与恢复散落各处；长尾任务拖住整批，下游明明就绪却在等批次；符号链接可绕过目录边界，包装器可藏住真实命令；冷启动直接落在用户等待里；断线丢进度视图，重启后任务从头重跑。

核心机制

主智能体只拆解建图，执行全部交给编排器，上游结果按需注入下游；校验一次、增量释放，完成一个节点只重算它的直接下游，就绪即启动；先解析真实对象再依据策略放行——文件边界层做一次规范化并展开前缀，命令策略层先还原被包装的真实命令；池化把冷启动摊到部署阶段；事件重放恢复进度视图，状态快照恢复执行。

关键设计与工程参数

• 并发闸门：上限 + 派生间隔 + 密钥租借；统一事件流；心跳保活支撑长连接可观测
• 三色 DFS 发现循环并返回完整环路径；入度队列生成拓扑序；单一状态副本避免分叉
• realpath 边界比较拦截链接绕过；六类黑名单独立开关 + 自定义风险模式
• 调和器目标规模 = 2 常驻 Warm；占位记录防重复创建；资源与时间双控
• 按事件类型分别截断；快照剔除无配对结果的调用；版本跳变走迁移函数

工程价值

把并发、边界与恢复从每个智能体里搬到编排器——任务拆得开、跑得住、断得起，复杂任务的编排结果可复用、可观测、可续跑。

要处理的协作事实

全文重写会破坏未选中内容，改动范围不可控；段落下标随结构变化整体偏移，整篇回写会覆盖未保存内容；定向与广播混在一条通道，消息静默堆积无人消费；主循环自审既贵又把自检文本混进后续推理；各厂商配置形态与流式分片格式互不相同；多个智能体争抢浏览器，登录态与配置互相破坏。

核心机制

结构化文档模型 + 工程约束，标题 · 章节 · 段落 · 表格可单独定位操作；内存双向节点链 + Node ID 稳定寻址，插入新节点后原有标识不变；在数据结构层分流定向与广播；旁路评审不写主对话，先用确定性规则零模型筛查再交快模型限时判定；多种配置形态 → 单点解析 → 统一调用配置 → 协议路由；操作层独占 + 资源层加锁。

关键设计与工程参数

• 写入门控 · 差异检查 · 内容校验 · 操作日志 · 结果回滚；区分建议与正式写入
• 版本连续性检测（跳变即判丢帧，回取该节点快照）；三级恢复：节点同步 → 重建映射 → 整篇重建
• 单条 4096 字符上限；时间戳水位批量标记已读；订阅回调异常逐个隔离不阻断总线
• 定长输入：只收割近期调用、错误与末条输出，逐字段脱敏截断；超时或解析失败放弃本轮
• 统一密钥 · 地址 · 模型名 · 协议标识 · 请求头 · 默认参数；结束前补发用量完成帧
• 显示号与端口确定性派生；分阶段启动，超时则清理已启动进程并返回具体失败环节

工程价值

从「整篇文本回写」转向「节点级定位、事件级同步、变更级审阅」——智能体提出修改，用户保留最终控制权，协作过程可视、留痕、可接管。