8.3 KiB
8.3 KiB
Prototype(原型需求)—— 第四种任务类型
目标:纯 UI / 交互类需求,从「提交」到「看到效果截图」压到几十分钟以内, 绕开 2 小时以上的编译 + 云端回拉;用户多轮加意见到满意后,再把 「UI 产物 + Frida 脚本 + 源码定位」作为 Context 交给现有 Feature 链路做原生实现。
一句话流程
提交原型需求 ──▶ awaiting_prototype ──▶ prototyping ──▶ prototype_ready ──▶ (加意见) ──▶ awaiting_prototype …
│
└──▶ 「转正式实现」 ──▶ promoted + 新建一个普通 Feature(附接手包)
- 不评估、不确认:没有 eval 阶段,创建即入队。原型本身就是"评估"——效果对不对,人看截图说了算。
- 不编译、不装包:卫星直接拿设备上已经装着的基线 App(Android:设备里的 TikTok-M;iOS:
~/iosapp/TikTokM.app的 macCatalyst 进程),用 Frida 脚本做运行时热改造。 - 不改代码仓:代码仓只允许只读查询(
git grep/git show origin/<base>:<path>),用来把 hook 点映射回源码符号。没有分支、没有 MR。 - 原生实现不另起炉灶:「转正式实现」= 用
createFeature()建一个普通 Feature,remark里塞接手包;后续 eval → 人工确认 → 实现 → MR 全走既有链路。原型行上记promotedFeatureId,Feature 描述里注明来源。
为什么「UI 产物 + Frida 脚本」是有意义的 Context
调研结论(2026-09-09,见飞书《TikTok 私信单条消息自由编辑|Frida 原型与 iOS 源码接手包》):
- Frida hook 点天然就是源码符号。 iOS 的
-[AWEIMUserMessageCellView layoutSubviews]、Android 的com.ss.android.ugc.aweme.xxx.Foo.bar直接能git grep到文件;仓库里shared/src/method_coverage.ts已经在做同一件事的反方向(diff → Frida selector)。那份文档 10 个 hook 点映射到了 14 个源码文件 + 行号,是接手包的骨架。 - 脚本本身是"运行时 diff"。 它记录了:在哪个类的哪个时机、改了什么状态、参数是多少(尺寸/颜色/阈值集中在
CONFIG)。这比一段自然语言需求精确得多,且已被真机验证过。 - 截图是验收基线。 原生实现的验收标准从"实现方案里推断的"变成"和原型截图逐项对齐",评估器少猜很多。
- 但脚本不是实现方案。 Frida 直接改 view、绕过 ViewModel / 组件系统、用全局单例存状态——这些原生实现都不能照搬。所以接手包强制带一节「原型不可照搬之处」,Feature 的 remark 里也明写"脚本用于定位触点和行为契约,不是移植对象"。
状态机(shared/src/types.ts::PrototypeStatus)
| 状态 | 含义 | 出边 |
|---|---|---|
awaiting_prototype |
排队等卫星(创建即此态) | 卫星 claim → prototyping |
prototyping |
卫星上 Agent 在跑 | STATUS: PROTOTYPE_READY → prototype_ready;否则 → prototype_failed;基础设施/鉴权错误 → 回 awaiting_prototype;用户 abort → prototype_failed(failureReason=用户中止) |
prototype_ready |
有截图 + 脚本 + 报告,等人看 | 加意见(/feedback)→ awaiting_prototype(同工作区、同脚本继续迭代,attempts+1,reviewHistory 追加 human 注记);「转正式实现」→ promoted;归档 → archived |
prototype_failed |
Agent 做不出来 / 中止 | 重开 → awaiting_prototype |
promoted |
已建出 Feature(终态) | — |
archived |
搁置(终态,统计记失败) | 重开 → prototype_ready |
cancelled |
用户取消 | — |
数据
- 表
prototypes(drizzle/0026_prototypes.sql),与 features 结构平行但不共用:没有 branch/MR/plan/regen/readable 列;多了baseline(JSON:包名/bundle、版本、build、探测时间)、script(最新hooks/prototype.js全文)、report_markdown(最新ProtoReport.md全文)、promoted_feature_id。 - 表
prototype_rounds(prototype_id, round, script, markdown, created_at):每轮归档,晋升时能回看演进。 - 脚本与报告在卫星每轮结束时随
/api/internal/prototypes/:id/update的 patch 上送,控制面落库并归档到 rounds。文件本体仍在卫星~/taskLog/prototype-<id>/。
卫星(satellite/src/prototype_runner.ts)
- 工作区:
~/taskLog/prototype-<id>/{OriginalIntro.md, hooks/prototype.js, ProtoReport.md, evidence/, logs/}。 - 跑之前机械探测基线:Android
adb shell dumpsys package <pkg>取 versionName/versionCode;iOS 读~/iosapp/TikTokM.app/Contents/Info.plist(macCatalyst 布局)或Info.plist的CFBundleShortVersionString/CFBundleVersion。探测结果写进 prompt 的「基线 App」块和行的baseline字段。探测失败不阻塞,写note。 - Prompt:
shared/src/prototype_prompt.ts的DEFAULT_PROTOTYPE_RUN_FIRST_TEMPLATE/SECOND(阶段 keyprototype.run.first/prototype.run.second,控制面派发时随任务下发代码里的正文,与其他 track 一致)。 - 与 fix 循环同一个 claim 通道(同一台设备不能同时被两个 Agent 驱动),但控制面
claimAnyFixForNode先看 prototypes 再看其它三张表:原型几分钟就完,插队的代价远小于让它排在 2 小时构建后面。要彻底不排队,用clusters标签给原型单独划节点。 - 不需要代码 checkout 锁(不 checkout);不跑 tracking / method-coverage 扫描;不做 KB / TTKB / conditions;不生成可读性报告(面板直接渲染
ProtoReport.md,与 security 一样)。 - 结束时杀掉本工作区拉起的 frida 进程(App 回到基线,是预期行为)。
控制面
/api/prototypes:list / get / create / feedback / promote / archive / reopen / abort / pin / unpin / delete / watchers / description / report / script / rounds / rounds/:round / log-file / logs / evidence* / handover。/api/internal/prototypes/:id/{update,notify}+attachment/:uuid。- 通知卡:
dispatched/prototype_ready/prototype_failed/promoted,深链?prototype_id=。 - 接手包
control-server/src/prototype_promote.ts::buildPrototypeBrief():原始需求 + 反馈脉络 + 最终 ProtoReport 全文 + 脚本全文(fenced js)+ 截图 URL 列表 + 「如何使用这份材料」规则。
前端
- kind
prototype,路由/prototype?id=,legacy?prototype_id=。 - 卡片 chip「原型」;抽屉:ProtoReport 渲染、脚本查看/复制、证据、「添加修改意见」、「转正式实现」(成功后显示到 Feature 的跳转)。
- 分桶:
awaiting_prototype→queued、prototyping→running、prototype_ready→review、prototype_failed/cancelled→failed、promoted→merged、archived→archived。
明确不做(v1)
- Asking(与 Agent 聊)、可读性报告、跨端移植、Meego 写回、TTKB、KB 回灌。
- 让原型脚本"常驻"设备:Frida 退出即恢复,多任务共用设备只能这样。
生产前提
- Android 节点:
frida16.7.19 + 设备上 root 的frida-server(fei-android-01 已验证)。 - iOS 节点:frida attach 必须以 root 跑。 实测(2026-09-10, fei-ios-01 / temp-ios-01):
普通用户
frida -p <pid>必定Failed to attach: timeout was reached,同一条加sudo秒回。 与DevToolsSecurity无关——两台都已-enable、用户也在_developer组,普通用户照样不行。 根因是被测 App 是 adhoc 签名、没有get-task-allow,非 root 拿不到 task port。 所以节点需要一条 NOPASSWD sudoers 规则(见下),否则无人值守的任务用不了 frida:frida 在 iOS 节点装在 pip 目录(# /etc/sudoers.d/streamline-frida (chmod 440) <节点用户> ALL=(root) NOPASSWD: /opt/homebrew/bin/frida, /Users/<用户>/Library/Python/3.9/bin/frida~/Library/Python/3.9/bin),不在 homebrew——两处都写进规则。frida-ps(只枚举进程)不需要 root。 备选通道 不可用:macCatalyst(platform 6)走 iOS 式 AMFI,DYLD_*会被剥离,frida-gadget 注入静默失效。