Files
streamline/docs/eddy/compat-knowledge-v2.md
T
2026-11-16 17:26:44 -08:00

6.7 KiB
Raw Blame History

兼容知识流程:分发与客户端应用

问题归属与症状分开记录:source-bug(源码,只记录)、devicesim(通用运行层,可启动独立源码修复任务)、app-compat(特定 App 构建的兼容知识)。unknown 保留待分类材料,confidence=suspected 明确假设,不能用 Catalyst 单端结果证明真机无问题。

Agent 蒸馏读取本任务明确关联的聊天、观察、真实脚本与回执。eddy task chat <id> --agent codex --session-id <id> 或 --file <JSONL> 建立关联;不搜集其他聊天。提交 JSON knowledge 包含 category/confidence/summary/cause/solution/validation/rollback;可附 advisory 文字和 Frida JS / launch-config。源码和 DeviceSim 类型只提交文字。

./eddy compat propose 'hang:layout' --category app-compat \
  --knowledge-file knowledge.json --tier frida-guard --payload guard.js --title '修复限定场景的布局递归'

基线下载发布与知识提交解耦,不要求 App 在官方目录上架。补丁目标包含 baseline、bundle/version/build、arm64、Catalyst platform=6、完整主程序 UUID、主程序 SHA-256,以及所 hook 的嵌入库 hash(自动收集 Core.framework,其他库缺少身份时先提交文字)。不能仅按市场版本号匹配。版本记录不可变,相同内容重交幂等,修改产生新修订。

认证和检查

提交共享知识与反馈需要 SSO 或已有 Streamline Open Platform API key。客户端配置 EDDY_STREAMLINE_TOKEN 或 installation.json 的 streamline.token;用户名 header 仅署名,不能认证。失败时本地候选保留,401 不冒充提交成功。不要把 token 写进聊天、报告或仓库。

Streamline 接收经过认证的上报,验证基础格式、载体文件名与声明 hash。新提交的 app-compat 文字建议、Frida JS 和 launch-config 保存后即分发,不等待服务端 Agent/模型检查或卫星复验。源码、DeviceSim 和待分类材料仅记录。基线下载是否上架不影响知识分发。native-dylib 暂不进入此自动应用协议,保留为待处理材料。

管理员可在问题行修改分类,并对旧记录点击「确认分发」,或对已分发的材料停用/恢复;操作记录 actor、时间、auto/admin 来源以及原 manifest/payload hash。修改分类不改动不可变的载体和清单;旧记录不会因升级或补分类而自动发布。改为非基线兼容分类会停用关联的已分发材料,后续上报不能覆盖管理员分类。重复提交同一载体不会重新启用已停用修订,迟到复验也不能复活它;确认分发不伪造或覆盖安全检查结果。

distribution 是目录分发决定,独立于历史 safety。新客户端声明 X-Eddy-Compat-Protocol: 3,收到绑定当前 manifest/payload 的 eddy-distribution-v1 回执。旧客户端收到新分发记录的 candidate 状态,避免把分发误作执行许可。较旧可用修订不会因新修订停用而回退启用。

客户端核对精确二进制身份、manifest 和 payload;有本机 Agent CLI 时使用用户选择的 CLI 快速安全检查(60 秒上限,按 server/manifest/payload/CLI/policy 缓存)。Codex 在临时目录只读运行,关闭 shell/apps/plugins/多 Agent/浏览器和搜索,忽略用户配置;Claude 使用空工具集与严格空 MCP。检查阻止、未知或不可用时保留为未应用并提示。未安装 CLI 时不做模型检查,仍执行身份、完整性和运行合约校验,不声称服务端已审核。知识文本不是执行工具调用的授权。

分发不要求旧记录已经补全可执行身份:它可以先被同步、阅读,但缺少主程序 SHA-256 等字段的旧补丁不能自动应用。控制面显示这一边界。历史模型检查仅供参考,不再阻止管理员分发;真正的客户端应用状态由安装回执反馈。

应用时机与恢复

安装基线后和启动前召回;Portal/启动器运行时每 5 分钟同步已安装基线。同步只准备下次启动的 active.json,不重启、重新附加或改写当前 demo。必须在窗口前安装的 guard 使用第一行 // eddy-compat-install: bootstrap。

guard 安装异常先调用 dispose 尝试清理,隔离失败的 fix@rev 并回传结果;后续启动跳过失败修订,不循环拉起 App。当前任务、产品 registry 和容器数据保留。无法可靠判定哪个补丁导致进程崩溃时不随意归因;通用物理内存上限仍独立生效。服务端停用会在下次同步影响后续启动,已经装入的补丁不会在演示中途被强制重启卸载。

本地验证

Python 回归使用 PYTHONPATH=vendor/site-packages ./vendor/python/bin/python3 -m unittest discover -s tests;JS 合约使用 node --test tests/test_engine_compat.mjs。stub/control_plane.py 保留旧协议回归用途,不代表正式服务的安全检查;完整 v2 流程在 Streamline 的隔离 PostgreSQL 集成测试验证。

Streamline 运维接入

部署按正常迁移流程应用 drizzle/0029_eddy_knowledge.sql 和 drizzle/0030_eddy_distribution.sql(开发空库可使用 drizzle-kit push)。需要更新 control-server、control-web 和 Eddy 客户端。分发不要求在线 satellite;DeviceSim 源码修复仍需支持的节点。

  • 服务端不再启动安全审核队列,保留 satellite 安全检查能力供独立诊断使用;它不修改目录分发状态。
  • DeviceSim 修复节点:设置 EDDY_DEVICESIM_REPO 为 ugc-android/DeviceSim 本地 Git 仓库,必须由维护者同步到要修的源码;用 EDDY_DEVICESIM_AGENT=codex|claude 选择 CLI,可配置 EDDY_DEVICESIM_AGENT_BIN 和 EDDY_DEVICESIM_JOBS。节点报告 eddy-devicesim-v1。管理台点击后,从该 checkout 的 HEAD 创建独立 worktree/branch;Codex 使用 workspace-write 沙盒,Claude 使用限定工具,保存日志、报告和 git diff。不自动注入 App、提交代码、推 MR 或部署;维护者可审查差异后按正常 DeviceSim 流程提交。节点重启显示 interrupted,保留工作区。
  • 管理台分别显示可编辑分类、真实分发状态、具体建议与载体、验证/撤销说明。历史服务端检查折叠显示,避免将模型判断混为分发状态。
  • 写 API 复用 Open Platform key;并非发布流水线的 EDDY_RELEASE_TOKEN,也不信任 X-Eddy-User。管理员继续用原 SSO 管理。

集成测试必须显式设置 TEST_DATABASE_URL 为隔离本地 PostgreSQL,运行 bun test control-server/test/eddy_flow.integration.test.ts;没有该变量时跳过。该测试明确不提供安全扫描节点,验证无模型依赖的自动分发、管理员分类/确认、只读旧载体、幂等、停止保护和客户端协议兼容。