Initial import of streamline
This commit is contained in:
@@ -0,0 +1,47 @@
|
||||
# 兼容知识流程:分发与客户端应用
|
||||
|
||||
问题归属与症状分开记录:`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 类型只提交文字。
|
||||
|
||||
```sh
|
||||
./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`;没有该变量时跳过。该测试明确不提供安全扫描节点,验证无模型依赖的自动分发、管理员分类/确认、只读旧载体、幂等、停止保护和客户端协议兼容。
|
||||
Reference in New Issue
Block a user