spec_v2_flat.md 66 KB
title: 实施规格书_飞舟脚本_2026-10-13
飞舟脚本 App · 实施规格书
配套设计文件：https://ardot.tencent.com/file/734917825641912\
版本：2026-10-13 · 适用于把本设计交付给编码 AI / 开发执行\
**本文档是"可执行规格"，画布只是视觉参考。有冲突时以本文档为准。**
§0 怎么用这份文档
先填 §7 技术栈 —— 不填则 §3 的字段控件类型无法映射，开发只能猜。
§1 是页面边界（特别注意 C1–C5 是同一个页面）。
§2 是导航与状态机 —— 决定跳转与互斥，必须先实现。
§3 是字段清单，§4 是交互规则，§5 是必须替换的假数据。
§6 是设计令牌，直接落成主题变量。
§9 列出了已知的不一致与待确认项，开工前先过一遍。
§1 页面清单（画板 → 页面/状态映射）
底栏只有 3 个 tab：任务 / 记录 / 我的。
|
编号
画板名
节点 ID
类型
归属
|
A1
卡密登录
`16:257`
独立窗口（**无底栏**）
启动入口
|
A2
卡密登录 · 校验中
`16:1491`
A1 的**加载态**
同一页
|
A3
卡密登录 · 校验失败
`16:288`
A1 的**错误态**
同一页
|
A4
权限引导弹窗
`30:738`
弹窗
叠在 **B1** 上
|
B1
任务列表
`30:102`
**一级页**
任务 tab · 默认落点
|
B2
任务列表 · 运行中
`30:203`
B1 的**运行态**
同一页
|
C1
ID提取
`3:1`
**二级页**
任务 › ID提取 · **首屏**
|
C1r
ID提取 · 运行中
`16:138`
C1 的**运行态**
同一页
|
C2
ID提取 · 脚本二三
`16:483`
C1 的**第 2 屏（滚动位置）**
同一页
|
C3
ID提取 · 脚本四
`16:589`
C1 的**第 3 屏**
同一页
|
C4
ID提取 · 功能设置
`16:706`
C1 的**第 4 屏**
同一页
|
C5
ID提取 · 功能设置（滚到底）
`16:965`
C1 的**底部**
同一页
|
C6
UID私信
`3:534`
二级页
任务 › UID私信
|
C7
UID私信 · 脚本一展开
`7:11`
C6 的**展开态**
同一页
|
C8
养号
`3:469`
二级页
任务 › 养号
|
C9
视频功能
`3:629`
二级页
任务 › 视频功能
|
D1
记录列表
`30:871`
**一级页**
记录 tab
|
D2
记录空态
`30:958`
D1 的**空态**
同一页
|
D3
运行详情
`30:1241`
D1 的**二级页**
记录 › 单次运行
|
E1
我的
`7:289`
**一级页**（可滚动）
我的 tab
|
E2
我的 · 解绑确认
`16:850`
弹窗
叠在 E1 上
|
F1
ID提取 · 未选脚本
`16:23`
弹窗
叠在 C1 上
|
F2
ID提取 · 权限拦截
`16:319`
弹窗
叠在 C1 上
|
F3
切换任务确认
`30:1005`
弹窗
叠在 B2 上
|
F4
ID提取 · 运行中卡密到期
`16:1360`
弹窗
叠在 C1r 上
|
F5
脚本报错
`30:1119`
C1r 的**报错态** + 弹窗
同一页
|
H1
悬浮球 · 空闲（收起）
`34:9`
**全局悬浮窗**
浮于**其他应用**之上
|
H2
悬浮球 · 空闲（展开）
`34:23`
同上 · 扇形展开
同一组件
|
H3
悬浮球 · 运行中（展开）
`34:37`
同上 · 运行态
同一组件
|
H4
悬浮球 · 报错（收起）
`34:53`
同上 · 报错态
同一组件
|
H5
悬浮球 · 停止二次确认
`34:121`
弹窗
叠在 H3 上
|
H6
悬浮球 · 退出二次确认
`34:173`
弹窗
叠在 H2 上
|
H7
悬浮球 · 拖到右侧（扇形镜像）
`34:223`
同一组件 · **镜像布局**
位置变体示意（见 §10.11）
⚠️ 最重要的一条
C1 / C1r / C2 / C3 / C4 / C5 是同一个「ID提取」页面的 6 个采样点，不是 6 个页面。\ ID提取 是一个可滚动的长页面：脚本选择（脚本一~四）→ 功能设置（14 项）。\ C2–C5 只是把它滚动到不同位置时的样子。
实际需要实现的页面只有 5 个 + 3 个 tab + 1 个全局悬浮窗
卡密登录（A1/A2/A3 三态）
任务列表（B1/B2 两态）
任务详情（4 种：ID提取 / UID私信 / 养号 / 视频功能）—— ID提取 最长，可滚动
运行记录（D1/D2 两态 + D3 详情）
我的（E1，可滚动）
\+ H 组悬浮球（一个常驻的全局悬浮窗，浮在所有应用之上）—— 详见 §10
§2 导航与状态机
2.1 启动与卡密
启动 → 读本地卡密
├─ 无卡密 / 已过期 → A1 卡密登录
└─ 有效 → B1 任务列表
A1 ──点「登录激活」→ A2（按钮转「登录中…」+ 转圈，禁用防重复点）
├─ 校验失败 → A3（输入框变玫瑰色 + 下方红字提示，仍停在 A1）
└─ 校验成功 → 检查权限
├─ 缺权限 → A4 权限引导弹窗
└─ 权限齐 → B1
2.2 一级 / 二级导航
B1 任务列表 ──点任务卡主体──→ 对应二级页（C1/C6/C8/C9）
二级页 ──点「← 返回」──→ B1
B1/B2/D1/D2/D3/E1 ──点底栏──→ 三个 tab 互切
D1 记录列表 ──点任一条目──→ D3 运行详情
D3 ──点「← 返回」──→ D1
2.3 全局运行状态机（全局单跑）
空闲（idle）
│
│ 发起运行（前置校验全通过）
▼
运行中（running）────────────────────────────┐
│ │
├─ 正常跑完 → 完成（success） │
├─ 点「停止运行」 → 手动停止（stopped） │ 点别的任务「运行」
├─ 卡密到期 → 弹 F4 → 回 A1 ├→ 弹 F3 确认
├─ 脚本报错 → 弹 F5（可看日志） │ └「停止并开始」→ 停旧的，起新的
└─ 权限被关闭 → 归入「报错中断」 │
──┘
所有结束 → 回到「空闲」，并**写入 D1 一条记录**
互斥规则：任何时刻只允许一个脚本在运行（跨任务也互斥）。
运行中，其他任务的「运行」按钮仍然可点，点击后弹 F3 确认，不做禁用。
运行中，不允许在同一运行中切脚本 —— 必须先停。
2.4 全局运行条
位置：顶部，状态栏下方（x=20, y=70, w=335, h=44）
显示条件：仅「运行中」时出现；空闲/完成时整条隐藏（不占高度）
内容：● {任务名} · 脚本X · 运行中 + 右侧等宽字体计时
报错态（F5）：整条变玫瑰红，文案 脚本一 · 执行出错已停止，右侧 已终止
交互：点击整条 → 跳回运行中的那个任务的详情页
职责分工：运行条 = 状态与导航；页面底部 CTA = 启停控制。运行条上不放停止按钮
2.5 运行前置校验顺序
点「开始运行」时，按此顺序校验，任一步不过就拦截：
卡密有效？ → 否：不做提示，直接回 A1
无障碍 + 悬浮窗权限齐？ → 否：弹 F2
已选脚本？ → 否：弹 F1
已有脚本在运行？ → 是：弹 F3；否：直接启动
§3 字段表
C1 ID提取 · 脚本选择
|
字段
控件
默认值
校验 / 备注
|
脚本一 ~ 脚本四
**单选圆点**
脚本一 选中
同一时间仅可运行一个；页面内有说明「单选：同一时间仅可运行一个脚本」
|
自定关注或粉丝页面提 ID
复选框
✓
脚本一展开项
|
自定页面提 ID
复选框
✗
|
主播去重
复选框
✓
|
├ 去重模式
下拉
`ID 模式`
|
└ 进入页面
下拉
`粉丝页`
|
主播 ID
输入
`ID1#ID2#ID3`
多个用 `#` 分隔
|
使用文本 ID
复选框 + 文件选择
✗
路径框**右对齐**；按钮「选择」
|
底部提示
文案
`↓ 下方还有「功能设置」，向下滚动查看`
脚本二/三/四的展开内容见 C2、C3。
C2 ID提取 · 脚本二 / 脚本三（展开态）
脚本二 · 评论页提 ID
|
字段
控件
默认
|
自定评论页面提 ID
复选框
✓
|
提取评论的人的粉丝 ID
复选框
✗
脚本三 · 文本 UID 裂变提 ID
|
字段
控件
默认
|
文本 UID 裂变提 ID
复选框
✗
|
UID 博主去重
复选框
✓
|
进入页面
下拉
`关注页`
|
裂变文本
输入 + 按钮
路径框右对齐 / 按钮「选择」
当前脚本提示条：当前脚本：自定评论页面提 ID（居中、浅色底）
C3 ID提取 · 脚本四（展开态）
|
字段
控件
默认
|
关键词视频提 ID
复选框
✗
|
关键词主播
输入
`关键词`
|
关键词提取主播粉丝 ID
复选框
✗
|
关键词提取评论区 ID
复选框
✗
|
关键词提取评论的人的粉丝 ID
复选框
✗
C4 ID提取 · 功能设置（14 项，C2/C3/C5 共用同一张卡）
|
#
字段
控件
默认值
备注
|
1
过滤私密账户
复选框
✓
|
2
过滤无头像账户
复选框
✓
|
3
提取区域
输入 + 按钮
`国家简码：JP#TW#US` / 按钮「含对应区域ID条款」
说明两行见下
|
—
（说明）
文案
`国家简码：如日本填 JP；台湾：TW，多国则用 # 隔开`
|
—
（说明）
文案
`如：JP#TW#CN#US，不填则匹配所有国家`
|
4
语言区域
下拉
`通杀`
|
5
昵称个签检测
下拉
`通杀`
|
6
云端去重
复选框 + 输入 + 按钮
✓ / `表名：字符` / 按钮「连通测试」
|
7
AI 头像识别
复选框
✓
|
8
AI性别
下拉
`男`
|
9
AI 年龄 >
输入
`20`
|
10
关注量
**区间输入（双框）**
`0` ~ `500000`
数字居中，框宽 56px
|
11
粉丝量
区间输入
`0` ~ `500000`
|
12
获赞量
区间输入
`0` ~ `500000`
|
13
视频量
区间输入
`0` ~ `500000`
|
14
提取符合
输入 + 后缀文案
`0` + `个 ID 后停止`
C6 UID私信
|
分组
字段
控件
默认
|
脚本选择
脚本一 · 已提 UID 私信
单选
✓
|
脚本二 · 自己粉丝私信
单选
✗
|
功能设置
AI 性别
下拉
`男`
|
关注数量
区间输入
`100` ~ `200`
|
私信数量
区间输入
`20` ~ `30`
|
休息时间（秒）
区间输入
`100` ~ `500`
|
私信 / 评论设置
随机私信文本
文件选择
按钮「选择文件」
|
随机评论文本
文件选择
按钮「选择文件」
C7 UID私信 · 脚本一（展开态）
|
分组
字段
控件
默认
|
脚本一（展开）
UID 私信
复选框
✓
|
筛首视频日期
下拉
`7 天内`
|
首视频点赞 / 首视频评论
开关
`都执行`
|
已筛符合的 UID 文本
输入 + 按钮
路径框右对齐 / 按钮「选择」
|
功能设置
进行关注 / 进行私信
开关
`开启`
|
关注数量
区间输入
`100` ~ `200`
|
私信数量
区间输入
`20` ~ `30`
|
去重方式
下拉
`关注+私信去重`
C8 养号
|
分组
字段
控件
默认
|
脚本选择
随机操作养号
单选（已选）
✓
|
养号参数
浏览时长（分钟）
区间输入
`3` ~ `8`
|
点赞概率
下拉
`30%`
|
评论概率
下拉
`10%`
|
关注概率
下拉
`15%`
|
单次操作
区间输入
`10` ~ `30`
|
底部提示
文案
—
`随机浏览、点赞、评论模拟真实活跃度`
C9 视频功能
|
分组
字段
控件
默认
|
脚本选择
关键词视频功能
单选（已选）
✓
|
功能设置
关键词
输入
`搜索`
|
主播区域
输入
`国家简码`
|
停止个数
区间输入
`1` ~ `5`
|
间隔时间（秒）
区间输入
`20` ~ `20`
|
执行操作
4 个开关胶囊
关注 开 / 私信 开 / 点赞 关 / 评论 关
|
私信 / 评论设置
随机私信内容 1-3
文件选择
按钮「选择文件」
|
随机评论内容 1-3
文件选择
按钮「选择文件」
B1/B2 任务列表
|
字段
说明
|
页面标题
`飞舟脚本` / 副标题 `TikTok 自动化脚本 · 选择任务`
|
区标题
`任务` + 说明 `全局单跑：同一时间仅可运行一个脚本`
|
任务卡 ×4
图标 · 任务名 · **状态徽标** · 当前脚本 · 上次运行 · 「运行」按钮
状态徽标取值：空闲（灰） / 运行中（绿） / 未配置（琥珀）\
任务卡副文案：
ID提取 → 当前：脚本一 · 粉丝页提 ID / 上次 10:24 · 提取 128 个 ID
UID私信 → 当前：脚本一 · 已提 UID 私信 / 上次 09:58 · 私信 30 人
养号 → 当前：随机操作养号 / 上次 09:12 · 运行 6 分钟
视频功能 → 当前：关键词视频功能 / 还未运行过
D1/D3 运行记录
|
字段
说明
|
D1 区标题
`运行记录` + `共 3 条 · 点任一条查看执行日志`
|
记录条目
图标 · `{任务} · {脚本}` · **结果标签** · 时间行 · 结果行 · 右箭头
|
**结果标签取值**
`已完成`（绿） / `手动停止`（灰） / `报错中断`（玫瑰红）
|
D3 摘要卡
任务名 · 结果标签 · `时间 · 耗时 · 结果量` · 结果文件名 + 「打开」「分享」
|
D3 日志卡
标题「执行日志」+「复制」按钮 + 等宽字体日志行
|
**日志级别配色**
`INFO` 灰 / `WARN` 琥珀 / `ERROR` 玫瑰红
E1 我的
|
分组
字段
控件
值
|
卡密
卡密状态
标签
`已登录`（绿）
|
卡密到期时间
只读值 + 提醒标签
`2026-12-31 23:59` + `即将到期`（琥珀）
|
解绑卡密
按钮
`解绑`（玫瑰色）
|
应用
TikTok 客户端（未安装态）
标签 + 按钮
`未安装`（灰）+「下载」
|
TikTok 客户端（已安装态）
标签 + 按钮
`已安装 v39.5.4`（绿）+「更新」
|
关于
脚本版本
只读值
`2026.10.10`
|
更新日志
按钮
`查看`
|
检查更新
标签
`已是最新`（绿）
⚠️ 「应用」区两行是**互斥状态对照**，运行时按安装状态**只渲染一行**。
弹窗文案（A4 / F1–F5 / E2）
|
编号
标题
说明
按钮
|
A4
`需要开启权限`
`为正常执行脚本，请先授予以下权限`
权限 3 行（无障碍 已开启 / 悬浮窗 未开启 / **通知 未开启（可选）**）+「去授权」+「稍后再说」
|
F1
`无法开始运行`
`请先选择要运行的脚本`
「知道了」
|
F2
`无法开始运行`
`无障碍与悬浮窗权限未开启，脚本无法执行`
权限 3 行 +「去授权」+「稍后再说」
|
F3
`{任务名}正在运行`
`开始 {目标任务} 将先停止当前脚本（全局单跑）`
「取消」+「停止并开始」
|
F4
`正在运行的脚本已停止`
`卡密已到期，需重新登录后继续使用` + 小字 `确认后将返回卡密登录界面`
**仅「确认」**
|
F5
`脚本执行出错`
`无障碍服务被关闭，脚本已停止运行`
「查看日志」+「知道了」
|
E2
`确认解绑卡密？`
`解绑后需重新输入卡密才能使用` / `正在运行的脚本将立即停止`
「取消」+「确认解绑」（玫瑰色）
A4 与 F2 结构完全一致，仅标题/说明/权限初始状态不同，**可复用同一组件**。
§4 交互规则清单
|
#
触发
行为
|
1
启动且无有效卡密
**自动跳 A1**，不弹提示
|
2
运行中卡密到期
弹 F4 → 点「确认」→ **自动回 A1**
|
3
E1 点「解绑」
弹 E2 → 「确认解绑」→ **自动回 A1**
|
4
点「开始运行」
按 §2.5 顺序校验，不过则拦截
|
5
运行中点其他任务「运行」
弹 F3；「停止并开始」→ 先停旧再起新。**按钮不禁用**
|
6
运行中切换任意页面
顶部运行条**始终可见**（它是全局组件）
|
7
点运行条
跳回运行中的任务详情页
|
8
脚本报错
运行条变红 + 弹 F5；点「查看日志」→ D3
|
9
全局互斥
任何时刻仅一个脚本运行（跨任务）
|
10
记录条目点击
进 D3
|
11
「我的」页内容超出
**页面可滚动**（底部渐隐 + 右侧滚动指示条）
|
12
ID提取 / 功能设置页内容超出
**可滚动**（同上）
|
13
脚本卡点击
展开/收起配置项（箭头方向随之变化）
|
14
二级页「← 返回」
回 B1
|
15
所有运行结束
写一条 D1 记录（含结果分类）
§5 占位值替换表（必须替换，否则会写死假数据）
|
位置
当前占位值
需替换为
|
E1 · 软件/脚本版本
`2026.10.10`
真实脚本版本号规则
|
E1 · 卡密到期时间
`2026-12-31 23:59`
真实到期时间（来自卡密接口）
|
E1 · TikTok 已安装版本
`v39.5.4`
真实适配版本 / 运行时读取
|
C1 · 主播 ID 示例
`ID1#ID2#ID3`
真实示例或留空提示
|
C4 · 提取区域
`JP#TW#US` / `JP#TW#CN#US`
真实默认值
|
C4/C2/C3/C6/C7/C8/C9 · 所有区间值
`0~500000` / `100~200` / `20~30` / `100~500` / `3~8` / `10~30` / `1~5` / `20~20`
真实默认值与上下限
|
C4 · AI 年龄
`20`
真实默认
|
C4 · 提取符合
`0`
真实默认
|
B1 · 任务卡「上次…」
`上次 10:24 · 提取 128 个 ID` 等
读取真实历史记录；无记录显示 `还未运行过`
|
D1/D3 · 记录与日志
3 条示例 + 6 行日志
真实运行记录；日志为**脚本真实输出流**
|
D3 · 结果文件名
`uid_20261013.txt`
真实产物文件名规则
|
A1 · 卡密输入框示例
校验失败态里的 `TK9F-2A7C-8E10-4B55`
仅演示用，不要预填
§6 设计令牌
颜色
|
用途
值
|
页面底色
`#030014`
|
卡片底
`#FFFFFF` @ 4%（部分 6%）
|
卡片描边
`#FFFFFF` @ 8%
|
弹窗底 / 描边
`#17142B` / `#FFFFFF` @ 12%
|
底栏底
`#0A0A17` @ 96%
|
主色（渐变）
`#2EA7FF` → `#9381FF`
|
主色（单色）
`#2EA7FF`（激活/链接 `#7CC7FF`）
|
成功 / 运行中
`#13DDC4`
|
警告 / 未配置 / 即将到期
`#F5C24B`
|
危险 / 报错 / 解绑
`#FF5470`
|
次要紫
`#9381FF`
|
主文字
`#FFFFFF`
|
正文文字
`#CFCCE6` / `#E6E4F5`
|
次要文字
`#9A97B8` / `#8E8BA8`
|
弱提示文字
`#6F6C8A`
字体
|
用途
字体 / 字号
|
中文
`Noto Sans SC`
|
数字 / 设备号 / 日志
`JetBrains Mono`
|
状态栏时间
`Inter`
|
页面标题
22px / SemiBold
|
二级页返回头标题
21px / SemiBold
|
弹窗标题
18px / SemiBold
|
区标题 / 任务卡标题
16px / 15px SemiBold
|
设置名 / 正文
13px Regular
|
标签 / 说明 / 提示
11–12px
尺寸与圆角
|
元素
规格
|
画板
375 × 812
|
状态栏
高 62（**系统绘制，不要实现**）
|
**全局运行条**
`x=20, y=70, w=335, h=44`，圆角 12
|
**返回头**
高 44，返回热区 44×44，圆角 —
|
**底栏**
高 83 = 页签行 49 + 安全区 33
|
底栏页签图标
22×22
|
内容区（空闲）
`y=62, h=595`
|
内容区（运行中·有 CTA）
`y=126, h=531`
|
内容区（运行中·无 CTA）
`y=126, h=591`
|
主 CTA
`x=20, w=335, h=48`，圆角 99
|
卡片
圆角 16 / 14，内边距 14–16
|
**区间输入框**
单框宽 **56**，数字**居中**
|
文件路径输入框
内容**右对齐**
|
底部渐隐
`y=577, h=80`
|
滚动指示条
`x=367, w=3`，圆角 99
触控标准
新组件（任务卡、记录条目、返回头、运行条）按 44pt 实现（如运行按钮 68×44、返回热区 44×44）。
⚠️ 既有控件（设置行、胶囊）视觉仍是 26px —— 建议实现时视觉保持紧凑、热区用透明 padding 撑到 44px（§9 有记录）。
图标
线性图标，stroke-width 1.6，圆角端点，viewBox 0 0 24 24。\
底栏三图标：任务=圆角方框+勾 / 记录=时钟 / 我的=人像。
品牌图标（FluxRpa）
源文件目录 E:\渡梦星舟\飞舟图标\（同一图标的多尺寸，角标数字为圆角半径）：
|
文件
尺寸
圆角
本设计中的用途
|
`FluxRpa_64_13R.png`
64
13
不采用（清晰度不足）
|
`FluxRpa_128_29R.png`
128
29
不采用（清晰度不足）
|
`FluxRpa_256_58R.png`
256
58
备用（原方案给球体用，已被去字标版取代）
|
**`FluxRpa_512_114R.png`**
**512**
114
✅ **登录页 Logo 72×72**（72dp @4x = 288px，仅 512 够）
|
**`FluxRpa_mark_only_412.png`**
**412**
—
✅ **全局悬浮球 Ø48** —— **去字标版**，见下
「去字标版」怎么来的（可复现）
从 FluxRpa_512_114R.png 派生的球体专用图，处理三步：
透明像素填白（保留图标白底观感）；
抹掉字标：实测标记与
FLUXRPA字标的分界在 y = 331（该行彩色像素数为 0，是干净的空隙），\ 331 行以下全部填白；以标记 bbox（
76,96–435,330，宽 360 高 235，中心255.5,213）为中心做正方形裁切，\ 边长取「内容最大半径 192.3px ÷ 0.94 × 2 ≈ 410」→ 取 412，使任何内容点都不被圆形裁切到。
效果：标记从占球直径 **70% → 87.4%**（放大 25%），且 **Ø48 下不再有 6px 的字标噪点、四角不被裁**。\
已交付：`品牌资产/FluxRpa_mark_only_412_悬浮球去字标版.png`（412×412，白底）。
实际用途一览（共 9 处）
|
位置
节点
尺寸
用图
圆角
|
A1 / A2 / A3 登录牌
`16:275` / `16:1513` / `16:309`
72×72
`FluxRpa_512`（**完整图标**，字标在 72px 下清晰）
16（= 114/512×72）
|
H1–H7 悬浮球
`34:18` / `34:32` / `34:48` / `34:64` / `34:124` / `34:175` / `34:225`
Ø48
`mark_only_412`（**去字标**）
99（**圆形裁切**）
登录页保留**完整图标**（含字标）：72px 下字标约 12px 高，可读，且登录页需要完整品牌署名。\
悬浮球用**去字标版**：48px 放不下字标，且球是常驻控件，越简洁越好。
§7 技术栈（开工前必填）
|
项
值
|
运行形态
☐ Android 原生（Compose / View） ☐ WebView + H5 ☐ AutoX.js `ui` 模块 ☐ 其他：\_\_\_\_
|
目标 TikTok 版本
\_\_\_\_
|
卡密校验接口
\_\_\_\_（地址 / 方法 / 请求体 / 返回结构 / 错误码）
|
权限申请方式
无障碍：跳系统设置？悬浮窗：`ACTION_MANAGE_OVERLAY_PERMISSION`？
|
脚本执行与日志回传
AutoX 事件/回调 结构 \_\_\_\_
|
记录与配置的本地存储
\_\_\_\_（SQLite / JSON / MMKV）
|
结果文件落点
\_\_\_\_（目录 / 命名规则 / 是否需上传）
|
更新检查接口
\_\_\_\_（软件更新 / 脚本更新）
|
TikTok 客户端下载源
\_\_\_\_
§8 分批实施顺序（建议）
|
批次
内容
验收
|
**第 1 批 · 静态壳**
A1–A4、B1/B2、C1–C9、D1–D3、E1/E2、F1–F5 的页面与导航 + §6 令牌
能点着走完全部页面，视觉对齐画布
|
**第 2 批 · 状态与规则**
§2.3 全局状态机、§2.5 前置校验、§4 全部 15 条交互、5 类弹窗触发
每种状态都能触发到；互斥不破
|
**第 3 批 · 业务**
卡密校验（A2/A3）、真实权限申请、脚本执行 + 日志流、结果文件落点、记录持久化
真机跑通一个完整任务
每批完成后先出静态预览确认，再进下一批。
§9 已知不一致与待确认项（开工前先过一遍）
|
#
问题
建议
|
1
**C6 与 C7 的「功能设置」字段集不同**：C6 是 `AI 性别 / 关注数量 / 私信数量 / 休息时间`，C7 是 `进行关注·进行私信 / 关注数量 / 私信数量 / 去重方式`
同一页不应有两套，需**二选一统一**（我倾向以 C7 为准，C6 补上开关与去重方式）
|
2
**C1–C5 未在画布上加分组标注**
本规格书 §1 已说明；画布如需标注可另补
|
3
**触控目标**：既有控件视觉高 26px \
实现时热区撑到 44；若要视觉也放大需重排版式
|
4
**E1 / 多个二级页内容余量很小**（E1 空闲态约 548/595）
运行中加运行条后余量更紧；已加底部渐隐，实现时按**可滚动**处理
|
5
**未激活页签旧色 `#7A7794` 对比度 4.4:1** 未达 WCAG AA
已统一改为 `#8E8BA8`（5.6:1），实现时用新值
|
6
**B1 任务卡的「上次运行/结果量」需要数据来源**
依赖任务层提供统计字段，需在 §7 里明确
|
7
悬浮球 Ø48 上字标仅约 6px、四角被圆裁
**已解决**：球体改用**去字标版**（标记放大到球直径 87.4%）。登录页仍用完整图标（72px 下字标清晰），见 §6 品牌图标
|
8
**报错态是否该在球内放警示三角**
已统一为**只换外环颜色**（红环），球内保持品牌图标 —— 与"图标恒定"规则一致
|
7
**多脚本并行不支持**（设计上就是全局单跑）
若未来要支持队列，需重新设计状态机
|
8
**D3 日志的长列表**
日志可能很长，需虚拟滚动；已设计「复制」按钮
§10 悬浮球（H 组 · 全局悬浮窗）
定位：浮在所有应用之上（含 TikTok），是跨 App 唯一的控制入口与运行状态可视处。\ App 前台也显示（用户已确认）。
10.1 默认位置与尺寸
|
项
值
|
默认位置
**屏幕左侧**，左边距 12，**垂直居中** → 球心 `(36, 406)`
|
球体
**Ø48**（透明热区 64），圆角 99；填充 = **FluxRpa 应用图标**（圆形裁切）
|
不透明度
**1.0**（三态统一。球内是图片，半透明会发灰；状态一律靠外环表达）
|
扇形半径
**R = 96**
|
子按钮
Ø48，圆角 99
|
扇形夹角
**60° / 20° / −20° / −60°**（以球心为原点，**向右**展开）
|
标签胶囊
高 24、圆角 99、距按钮右侧 4px、11px 字
|
展开动画
180ms
10.2 按钮坐标（相对屏幕，可直接落码）
|
#
按钮
球心
按钮左上角
标签左上角 / 宽
|
1
运行 / 停止
(84, 322.9)
(60, 299)
(112, 311) / 38
|
2
回到 App
(126.2, 373.2)
(102, 349)
(154, 361) / 59
|
3
隐藏悬浮球
(126.2, 438.8)
(102, 415)
(154, 427) / 71
|
4
退出应用
(84, 489.1)
(60, 465)
(112, 477) / 60
计算式：按钮中心 = 球心 + R·(cosθ, −sinθ)（屏幕坐标 y 向下，故取负 sin）
10.3 扇形里的四个按钮
|
#
按钮
图标
样式
二次确认
|
1
**运行 / 停止**（随状态切换）
播放三角 / 方块
运行＝品牌渐变实底；停止＝`#FF5470` 实底
**停止要确认，运行不要**
|
2
回到 App（任务列表 / 运行详情）
四宫格
白 8% 底 + 白 18% 描边
否
|
3
隐藏悬浮球（收起）
eye-off
同上
否
|
4
退出应用
power
`#FF5470` @14% 底 + 40% 描边，图标与文字 `#FF5470`
**要确认**
**按钮数量上限就是 4 个**。R=96 时相邻按钮间隙约 17.7px，已接近舒适下限；\
若未来要加第 5 个，建议不要继续挤扇形。
10.4 球的三种状态（图标恒定，靠外环表达）
|
状态
外环
外环透明度
呼吸动效
|
空闲
`#6F6C8A`
—（**无**外环）
无
|
**运行中**
`#13DDC4`
0.22
有（外扩到 r=28）
|
**报错**
`#FF5470`
0.20
无（静态外环）
球内**恒定是 FluxRpa 应用图标**，不随状态更换 —— 避免"中间显示播放图标 → 用户以为点了就运行"的歧义；\
点击的语义始终是**展开扇形**，状态一律由**外环颜色**表达。\
⚠️ 报错态**不再**在球内放警示三角（H4 初版曾如此），现统一以红环表达。
10.5 手势
|
手势
阈值
行为
|
单击
—
展开 / 收起扇形
|
按住拖动
位移 > 8px
移动位置；松手**吸附最近边缘**并**记忆位置**
扇形方向自适应：球在左 → 向右展开；球被拖到屏幕右侧 → 必须镜像为向左展开，否则整组按钮出屏。
10.6 二次确认弹窗
|
触发
标题
说明
按钮
|
停止（H5）
`停止当前脚本？`
`脚本一 已运行 12 分 30 秒` / `停止后进度不保留，下次将从开头重新开始`
取消 / **停止运行**（红）
|
退出（H6）
`退出飞舟脚本？`
`将停止正在运行的脚本，并关闭悬浮球` / `脚本进度不保留，下次运行将从开头重新开始`
取消 / **退出应用**（红）
10.7「退出应用」语义（用户已确认）
停止脚本 + 关闭悬浮球 + 退出到桌面（a 方案）。\ 注意：A1 卡密登录页底部已有一个「退出应用」文本按钮，两者语义应保持一致。
10.8 ⚠️ 位置风险（默认改左侧的原因）
右侧垂直居中时球体占 y 382–430，而 TikTok 右侧点赞/评论栏约从 y 447 起 ——\ 只剩约 17px 余量，换屏幕比例不同的机型或 TikTok 改版就可能压上，且那片是高频滑动区。\ 左侧中部相对更空，因此默认放左侧；但拖动 + 吸附 + 记忆位置仍必须实现。
10.9 技术要点
|
#
要点
|
1
需 `SYSTEM_ALERT_WINDOW` —— 这是现有权限弹窗中「悬浮窗权限」**唯一实际用途**，故它是**强阻断项**
|
2
**Android 10+ 后台启动 Activity 受限**：「回到 App」**不能**用裸 `startActivity`，需通知 / `PendingIntent` 方案
|
3
**与无障碍点击冲突**：脚本坐标点击可能点到球；运行时建议降不透明度，脚本侧点击区域避开球位
|
4
悬浮窗须 `FLAG_NOT_FOCUSABLE`，否则会抢输入焦点、影响 TikTok 键盘
10.10 悬浮球与顶部运行条的关系
两者并存，不互相替代：
顶部全局运行条：只在 App 内可见，承载"点击跳回运行中的任务"
悬浮球：只在 App 外（浮于其他应用时）才有意义，承载"跨 App 启停与状态可视"
用户已确认悬浮球在 App 前台**也显示**。若后续觉得重复，最省事的收敛方式是\
**App 前台时把球降到 0.3 透明度**（保留但不抢注意力），而不是隐藏。
10.11 镜像布局（球被拖到屏幕右侧）
球在右边缘时，扇形必须向左镜像展开，标签同步移到按钮左侧。画板：H7 34:223。
球心 (339, 406)（右边距 12，垂直居中不变）：
|
#
按钮
球心
按钮左上角
标签左上角 / 宽
|
1
运行 / 停止
(291, 322.9)
(267, 299)
(225, 311) / 38
|
2
回到 App
(248.8, 373.2)
(225, 349)
(162, 361) / 59
|
3
隐藏悬浮球
(248.8, 438.8)
(225, 415)
(150, 427) / 71
|
4
退出应用
(291, 489.1)
(267, 465)
(203, 477) / 60
镜像公式（屏幕坐标 y 向下）
球心：x_镜像 = 屏宽 − 12 − 球半径
按钮：x_镜像 = 屏宽 − x_原 − 按钮宽，等价于角度取 θ′ = 180° − θ，\
即 60°/20°/−20°/−60° → 120°/160°/200°/240°
标签：由「按钮右侧 + 4」改为「按钮左边 − 4」→ 标签右边 = 按钮左边 − 4
H7 里球体正好压在「参考区」（模拟其他 App 的右侧操作栏）上 ——\
这正是 §10.8 所述重叠风险的可视化，也是必须做**拖动吸附 + 位置记忆**的理由。
附：Ardot 设计文件节点索引（供查证）
A1 16:257 A2 16:1491 A3 16:288 A4 30:738
B1 30:102 B2 30:203
C1 3:1 C1r 16:138 C2 16:483 C3 16:589
C4 16:706 C5 16:965 C6 3:534 C7 7:11
C8 3:469 C9 3:629
D1 30:871 D2 30:958 D3 30:1241
E1 7:289 E2 16:850
F1 16:23 F2 16:319 F3 30:1005 F4 16:1360 F5 30:1119
H1 34:9 H2 34:23 H3 34:37 H4 34:53 H5 34:121 H6 34:173
H7 34:223（球拖到右侧 · 扇形镜像）
组件母版：
底栏 任务激活 30:45 / 记录激活 30:64 / 我的激活 30:81
返回头 ID提取 30:1 / UID私信 30:7 / 养号 30:18 / 视频功能 30:29
悬浮球背景 34:1（其他应用界面示意）
品牌图标：球 Ø48 用 FluxRpa_mark_only_412（**去字标**）/ 登录 Logo 72 用 FluxRpa_512（完整）
登录 Logo 节点：A1 16:275 / A2 16:1513 / A3 16:309
悬浮球节点：H1 34:18 / H2 34:32 / H3 34:48 / H4 34:64 / H5 34:124 / H6 34:175 / H7 34:225
KS_DOC_REVIEWS JZf9xTgLXBFgjXJ4dJWVsU 187475 https://www.workbuddy.cn/space/d/JZf9xTgLXBFgjXJ4dJWVsU