Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
UI 模拟数据:免登录看真实界面
读取时机:要在 Desktop 或 Mobile 上检查界面、截图、做 UI 回归,又不想登录真实 账号或碰真实数据时;新增或修改模拟任务、
--mock启动参数时。
Desktop 与 Mobile 共用一套模拟数据:展示项目、不同状态的回归任务和它们的消息。开发版
加 --mock 启动后直接进入主界面,不登录、不连服务器,也不碰任何正式或共享数据。适合检查
任务列表、任务页、消息渲染、深浅色和多语言这类只关心界面的改动;登录、发送、跨设备、
真实 Agent 运行仍要用真实账号验证。
| 端 | 启动 | 数据落在哪 |
|---|---|---|
| Desktop | pnpm restart:desktop:remote -- --mock |
独立沙箱 ui-mock(与 dev 沙箱、正式版分开) |
| Mobile 模拟器 | pnpm mobile:sim:start -- --mock(whoami、rebuild 同样加 --mock) |
只在 App 进程内存里 |
一套数据,两端共用
正本在 packages/maker-shared/src/uiMock.ts(@cindy/maker-shared/ui-mock):
UI_MOCK_PROJECTS:orbit-garden-zh/orbit-garden-en展示项目,以及原有cindy-demo、design-system回归项目和对应文件。UI_MOCK_TASKS:运行中、等待确认、排队、置顶、超长标题、英文、无文件夹对话、自动化、 已归档等任务;登录页窄窗口错位排查一条覆盖标题、表格、代码块、列表、引用、思考与工具 调用。buildUiMockRows():按 Desktop 数据库行的格式生成任务与消息。Mobile 平时从电脑收到的 也是这些行,所以两端看到的是同一份内容。
visual-* 开头的任务 id 被 Mobile 用来叠加运行时状态(运行中、权限确认、排队消息);
这些状态在 Desktop 上来自真实 Agent,不在数据库里,所以 Desktop 只把它们显示成普通任务。
Mobile 另外保留双端一致性测试用的 session-primary 与 Orca 两条任务
(SHARED_REMOTE_CONTROL_FIXTURE)。
要加一种界面状态,就在 UI_MOCK_TASKS 里加一条任务,两端会一起出现。只用 Desktop
已有的消息格式(user、assistant、thinking、工具调用与结果),不要为模拟数据新增
数据库字段或协议。
Desktop
pnpm restart:desktop:remote -- --mock
pnpm restart:desktop:remote -- --mock --isolated=<名字> # 另开一份模拟沙箱,可与别的 worktree 并行
- 默认沙箱名
ui-mock,其余规则与「Agent 启动入口」的隔离沙箱完全一致;仍以DESKTOP_DEV_VERDICT=ready为启动成功的唯一依据。 - 新沙箱首次启动直接进入免账号的「未登录」模式(相当于点过一次「跳过登录」)。之后在 沙箱里自己登录或切换模式,以你的选择为准。
- 每次本地数据库就绪时补齐缺失的模拟任务;已存在的任务不覆盖,测试中改名、归档、删消息等
改动会保留,删掉的模拟任务下次启动重新出现。演示项目写在沙箱的
ui-mock/projects/。 - 想回到初始状态:退出这个实例后删除沙箱目录(启动日志里
Isolated dev user data一行 给出的路径),再启动一次。 - 生效条件同时满足才会写入:源码运行(非安装包)、
--mock、隔离沙箱、免账号的本地数据 所有者。--mock与--shared、--preserve-running组合直接拒绝;安装包或共享 profile 里即使环境变量残留也会被忽略。实现见apps/desktop/src/main/index.ts、localDb/uiMockSeed.ts。 - 单个组件的改动仍优先用
pnpm ui:check(几秒出全部场景截图);--mock用于需要完整 主界面、真实路由和侧栏交互的检查。
Mobile 模拟器
pnpm mobile:sim:start -- --mock
pnpm mobile:sim:whoami -- --mock --json
- 只换 JS bundle 的环境变量
EXPO_PUBLIC_CINDY_MOBILE_VISUAL_MOCK=1,不改原生指纹,已装的 开发包可以直接用。 - 开关是 Metro 环境的一部分:在真实数据和模拟数据之间切换时,
sim:start会提示 Metro 是旧 环境,加--takeover重启;whoami不带相同的--mock会判定环境不一致。 - App 里是一台在线的模拟电脑和一台离线电脑,任务、消息、插件演示、文件浏览都由
apps/mobile/src/debug/visualMock.ts在内存里提供,写操作只在本次进程内生效,重启即还原。 - 生效条件是开发构建(
__DEV__);正式包不包含这条路径。
可复用的展示项目:Orbit Garden
共享目录现在包含 orbit-garden-zh / orbit-garden-en:同一个虚构独立游戏的中英文
演示项目。数据定义在 packages/maker-shared/src/uiMockShowcase.ts,原有边界/异常回归
任务保持不变。用现有 --mock 入口即可加载,不需要导入个人聊天或访问真实账号。
场景 ID 后缀(前缀 ui-mock-showcase-) |
内容 |
|---|---|
feedback-zh / feedback-en |
240 条合成反馈、四轮引导完成率、图表与复盘报告 |
plan-zh / plan-en |
可调人数/范围,实时计算工作量和制作天数;没有发送动作 |
review-zh / review-en |
合成代码审查场景,明确不是实际测试结果 |
release-zh / release-en |
未发送的试玩邀请草稿 |
项目中的 data/feedback.csv、data/completion.csv、reports/playtest.md 与
plans/next-build.md 和回答使用同一组数字。Desktop 创建这些小文件;Mobile 的 mock
文件浏览通道读取同一目录,支持子目录、预览和搜索。两端仍是独立回放,不代表已验证
真实设备同步、远程桌面或 Agent 执行。
Mobile 只对 UI_MOCK_SHOWCASE_PROJECTS 中的展示项目启用这套文件读取;旧的
cindy-demo、design-system 保留原有 Markdown 长文、翻页文件与媒体缩略图回归场景。
建议截图分工:桌面显示任务+回答+文件侧栏;笔记本聚焦回答;手机显示单栏;Duo 用真实 展开布局显示任务与回答。不要裁掉错误提示后把结果当作验证通过,也不要将屏幕拉伸成 另一种设备的布局。网页标注「真实界面 · 示例数据」。
复用时记录源码版本/dirty 标识、场景 ID、区域、语言、主题、窗口尺寸或模拟器 UDID。
切换界面语言不会翻译消息,需选择对应语言的任务。Desktop seed 不覆盖已有内容;修改
文案后使用新的专用沙箱,不清空他人常用开发环境。截图只导航/查看/调整本地控件,不点
发送;Desktop --mock 不是阻止真实模型调用的防火墙。
数字与富回答协议回归:packages/maker-shared/src/__tests__/uiMockShowcase.test.ts。
手机文件一致性回归:apps/mobile/src/__tests__/visualMock.test.ts。
数据边界
- 模拟数据只用于开发与界面验收,不进安装包逻辑,不上传,不触发真实 Agent。
- 不在模拟数据里放真实姓名、邮箱、路径或聊天内容;要用真实数据预览手机界面时用
apps/mobile/scripts/export-realdata-visual-snapshot.mjs,它导出的是敏感数据,按脚本 里的限制使用。 - PR 截图来自模拟数据时要写明,不能当作真实账号、真实 Agent 行为已验证的证据。