1产品总览

1.1 产品定位

小智编程助手是一套"电脑干活、手机遥控、云端串联"的 AI 编程与办公协同系统。它不是又一个聊天窗口，而是把 AI 编程 CLI（Claude Code / Codex / Gemini / Kimi）真正接管起来的一层操作系统级外壳：

1.2 应用亮点

先看这几件事 —— 它们是「装个 AI 聊天窗口」和小智之间最实质的区别：

1.3 三端架构

关键认知：云端不直接操作你的电脑。所有"动手"的动作（终端、文件、构建、部署）都由你电脑上的桌面端执行。云端只做三件事：认出是哪台电脑、把手机上的操作送过去、把电脑上的结果带回来。打个比方：手机是遥控器，电脑是干活的手，云端就是中间那根看不见的信号线。不掏手机也完全没问题 —— 人坐在电脑前直接操作，功能一样完整，只是少了“人不在场也能接着干”这一层。

1.4 核心能力

1.5 新办公形式

1. 早上到工位：打开桌面端，飞书已登录。看一眼「报告」页 —— 昨晚定时跑的三批任务生成了日报，token 消耗和活跃时长一目了然。
2. 交代一整天的话：在编程页任务清单里一次性写 8 条需求（"修 XX bug""补单元测试""更新接口文档"……），点执行，去开会。CLI 一条一条跑完，跑完一条自动进下一条。
3. 开会中：CLI 弹出权限请求，手机震动 + 提醒音，掏出手机点「允许」，全程 10 秒，不用回工位。
4. 午休前：把验证过的发布配置点「发布」，手机上看步骤日志，走到哪看到哪。
5. 下班前：在手机上建一条定时计划 —— 每天 23:30 由电脑自动跑回归测试（低谷时段模型更便宜），保存。
6. 回家路上：手机打开远程预览，看今天改的页面在手机上的真实效果；顺手在终端里补一句"把 README 更新一下"。

W01

新办公形式

六格场景示意：早上到工位 → 提交新一天任务 → 开会中 → 午休前 → 下班前 → 回家路上

images/workflow-1-4.png

2快速上手

这一章只做一件事：让你在十分钟内从零跑到第一条 AI 任务 —— 装好 → 登录 → 连上手机 → 配好模型 → 派一条活。后面的章节都是它的展开。

2.1 安装与启动

1. 下载安装包：桌面端是 Windows 桌面应用。浏览器打开官网 llmtodo.com，点首页上的下载按钮即可拿到安装包。
2. 安装并启动：按向导完成安装。首次启动会自动检查更新：「建议更新」可以稍后或跳过该版本，「强制更新」需完成后才能继续使用。
3. 认识三个入口：启动后右下角会出现悬浮球（桌宠），单击它即可呼出 / 隐藏主窗口；主窗口（1260×720）是日常工作区；标题栏右侧的任务清单按钮会打开独立的任务清单窗。

2.2 登录账号

1. 打开桌面端，按界面引导发起登录，会在默认浏览器里打开飞书授权页。
2. 用你的飞书账号确认授权后回到桌面端即可。全程由第三方授权登录，不需要注册账号，也没有密码要设置或记忆。
3. 登录成功后，这台电脑就注册成一台设备。同一个账号可以登录多台电脑——公司一台、家里一台，互不影响。

2.3 装好手机端

1. 桌面端进入 设置 → 移动端 App，页面上有最新版信息与下载二维码；手机扫码即可下载，也可以点「下载 APK」。
2. 手机安装后打开 App —— 开屏最短 3 秒是固定的启动时长，不是卡顿。
3. 用同一个飞书账号登录。不需要额外配对，App 会自动列出这个账号下所有已登录的电脑。

2.4 让手机连上这台电脑

1. 确认电脑满足三个条件：开着机、联着网、登录了同一个账号。
2. 切换要控制的那台电脑，有两个入口：首页顶部直接点当前电脑名；或从屏幕右侧向左滑出功能区，在功能区顶部切换。
3. 之后在手机上开终端、批权限、下任务、看发布，都会送到这台电脑执行，结果再回到手机。

2.5 跑通第一条 AI 任务

跑第一条任务前要先备好两样东西：一个能用的模型 和 一个开着的 AI 终端。顺序别反——没有模型，终端里的 AI CLI 起不来；没有终端，任务没地方注入。

1. 先添加一个模型（详见 3.5 模型 · 供应商管理）：打开 模型 页，在 Claude Code / Codex / Gemini / Kimi Code 里挑一个 tab，选一张供应商卡片，填好 Base URL 与 API Key，点「启用」 —— 卡片上出现「启用中」徽标就成了。如果这个 CLI 还没装，页面会直接给出安装命令和国内镜像命令，点「直接安装」即可，过程在终端里可见、可中断。
2. 再打开一个 AI 终端：切到 编程 页打开一个 AI CLI 会话。这里是真实终端，跑的就是你本机的 shell，不是网页模拟的假终端；多个终端可以并排，每个用不同模型也没问题。
3. 点主窗口右上角的 任务清单按钮，打开任务清单窗（磁吸贴在主窗口右侧，可拖边调宽；主窗口最小化时它不会跟着隐藏）。
4. 在底部输入框写下第一件事，比如「给这个项目补一份 README 的安装说明」，Enter 提交（Shift + Enter 换行）；想一次交代多件就接着写下一条。
5. 点 执行，队列按顺序注入当前会话逐条跑。这时你可以离开工位，它不需要人盯着。
6. 如果 CLI 弹出权限请求：在电脑上点卡片，或用手机点「允许」（详见 3.1.2 任务队列、4.6.2 权限提醒）。
7. 跑完到 报告页 看今天干了几轮、花了多少 Token。

3桌面端 · 主力工作台

桌面端是整套系统的执行主体：所有真正"动手"的动作都发生在这里。它是 Windows 桌面应用，内置真实终端内核，跑的就是你本机的那个 shell。

应用由四类窗口组成，各有明确分工：

D02

主界面全貌（编程页）

截取完整主窗口：左侧六视图侧栏 + 自绘标题栏 + 终端标签页 + 多窗布局按钮 + 右下桌宠悬浮球

images/D02-main-overview.png

D03

悬浮球 / 桌宠

截取桌面右下角的毛球（circle 形）；可另附一张 sleep 态或 star/heart/moon 形态

images/D03-pet.png

D04

侧栏「更多」菜单 + 本机设置

截取底部更多菜单（最小化/检查更新/关于/意见反馈/退出登录）+ 本机设置弹框（本机名称、desktop- 前缀编号）

images/D04-sidebar-more.png

3.1 编程

编程页是桌面端的主战场。它不是网页模拟的假终端，而是真实的终端环境，跑的就是你本机那个 shell。围绕这层终端，系统提供五项核心能力：会话管理、任务队列、多窗管理、终端设置、编程报告。前四项解决"怎么让 AI 按你的意图干活"，最后一项回答"它到底干了多少"。

3.1.1 会话管理

会话（Preset）是“一个终端要开在哪、跑什么”的配置项，按分组统一管理。共三类：

会话管理弹框里能做什么

• 新建分组 / 新建会话：顶部两个按钮。分组只存名字，会话挂在分组下，支持编辑与删除（删除有二次确认；删分组会连带删掉其下所有会话）。
• 展开 / 合并：分组行可折叠，双击分组名也能切；工具条一键「展开全部 / 合并全部」。
• 双击会话行即打开；底栏显示「所有会话（N）」总数。

新建 / 编辑会话的表单字段

工具条与标签页

• + 新建：开一个新的终端 pane。
• 会话（分体按钮）：左半打开会话管理弹框；右箭头打开快速打开下拉——「常用会话」区可一键 ▶ 开全部，各分组标题行也能一键开该组全部会话。
• 标签页可拖拽排序，顺序会自动保存，重启后仍是这个顺序。
• 全关：一键清空所有终端。

D05

编程页工具栏 + 会话快速打开下拉

截取「+新建 / 会话 / 标签页 / 多窗 / 全关」工具栏，并展开会话下拉，展示常用会话区的 ▶ 一键开全部

images/D05-term-toolbar.png

D06

会话管理弹框

截取分组 + 会话列表，展示本地/SSH/CLI 三种类型图标与颜色标签、分组折叠结构

images/D06-preset-manager.png

3.1.2 任务队列（核心）

基本用法

1. 点击主窗口右上角的任务清单按钮，打开独立任务清单窗口（磁吸贴合主窗口右侧，可拖边调宽；主窗口最小化时它不会跟着隐藏）。
2. 在底部输入框逐条输入需求，Enter 提交（Shift+Enter 换行），发送即进入队列。
3. 点执行，队列按顺序把任务注入当前 CLI 会话，逐条跑。
4. 运行中随时干预：上移下移调序、暂停单条、跳过当前、停止队列、编辑、删除、复制结果。
5. 清单里的任务可以一键「转为定时」——带着这批任务跳到定时计划页预填编辑器（保存成功后才从原清单删除，取消不删）。

支持图片与附件

这是它和普通“命令队列”最大的区别：任务内容不只是文字。

• 直接粘贴：在输入框里 Ctrl+V 粘贴任意文件——截图、设计稿、报错界面、Word / Excel / TXT / Markdown，都会自动存成附件并在光标处插入一个 chip。
• 图文混排：chip 与文字同一行内嵌，可以写成「把按钮圆角按 📷design.png 改成 8px」这种一句话带图的指令。
• 悬浮放大预览：鼠标停在图片 chip 上约 0.25 秒弹出大图，跟着鼠标走。Word / Excel 这类无法预览的文件只显示文件名，不会渲染成一块破图。
• 注入方式：图片不塞进正文（否则 CLI 会收到两遍路径），而是由系统在任务文本末尾另起一段【参考文件】，给出「名称 + 本地绝对路径」——CLI 能直接读取图片和文档。
• 草稿不丢：输入框内容随输入自动存草稿，关窗重开、切换终端都还在，已插入的图片也一起恢复。
• 上传需求文件自动拆解：点「上传需求」选一份文本类文件（.md / .txt / .json / .yaml / .csv / 源码等），AI 自动拆成多条待办，确认后「全部加入」队列——适合把一整份需求文档直接变成可执行清单。

排序与单条操作

队列级控制

D10b

主面板 + 右侧编程任务面板

同一屏幕同时呈现：左侧主窗口（终端工具栏 + 当前 CLI 终端），右侧独立的「编程任务」清单面板。任务是先写到面板里，再由面板派发到左侧终端执行。

images/D10b-theme-with-taskq.png

D09

任务清单独立窗口（磁吸贴合态）

截取贴在主窗口右侧的独立任务清单面板：头部终端下拉 + 任务列表（含状态、来源图标、结果摘要）+ 底部输入条（含图片 chip）

images/D09-taskqueue-window.png

D10

任务详情窗口

截取任务详情窗口：任务描述 + 状态/开始·结束/时长/类型 + 执行总结 + 执行结果（可复制）+ 结构化回答表格

images/D10-taskqueue-detail.png

完成判定机制

系统自己判断"这一条到底跑完了没有"，不需要你盯着屏幕。它同时看几个信号，多个都指向"完成了"才算数：

AI 终端感知

完成判定、编程日报、权限识别都建立在同一套终端感知之上：

权限提示识别同样基于终端画面，覆盖 Claude Code、Codex、Kimi 与通用的 [y/n] 提示。两条实际使用中总结出的规则：

• 只认真权限提问：必须带有权限专属的选项才算，避免把模型选择这类普通交互误判成权限提示而自动按回车。
• 同一提示不重复处理：同一条提示短时间内只上报一次，避免自动授权时把重复字符敲进输入框。

执行中的权限拦截

当 CLI 停下来问“要不要执行这条命令”时，系统会在屏幕右下角弹出卡片：

• 卡片显示：哪个终端（分组 · 名称）、哪种 CLI、屏幕上抓到的提示摘录。
• 三个选择：允许 / 拒绝 / 自动确认（本次会话以后免打扰）；右上角 × 表示忽略，自己在终端里处理。
• 手机上同步弹窗 + 提醒音，不在电脑前也能批（详见 4.6.2 权限提醒）。
• 任务队列检测到待确认项会自动暂停——这也是“跳过当前”按钮最有用的场景：确认这条已经卡死，直接跳过让它继续跑下一条。

D11

右下角 CLI 权限卡片

截取「终端 XXX · claude 请求权限确认」卡片：含屏幕提示摘录 + 自动确认/允许/拒绝 三个按钮

images/D11-perm-card.png

D12

任务完成提示卡

截取桌面宠物旁弹出的任务完成卡：✅ 任务完成 · 队列剩余数量 + 右上角关闭按钮

images/D12-taskdone-card.png

3.1.3 多窗管理

同时开着好几个终端时，可以一键把它们排成网格同屏，一眼看全所有任务的进度。

• 档位：工具条右侧一排 1 / 2 / 4 / 6 / 8 窗 按钮。1 窗 = 标签页模式（回到传统单终端 + 标签切换），其余为网格同屏。列数自适应：2 窗 2 列、4 窗 2 列、6 窗 3 列、8 窗 4 列。
• 推荐值高亮：系统按“参与多窗的终端数”算出推荐档位并高亮，鼠标悬停提示「当前 N 个终端参与多窗，推荐 X 窗」——不用自己算几个窗合适。
• 参与 / 排除：长驻服务（dev server、SSH 心跳、日志 tail）不想占格子，可在该终端的设置里标为「已排除」——进程照跑，布局跳过它；标签页上会显示一个橙色角标提醒它没在网格里。
• 不中断：不在当前档位里的终端仍然保持挂载运行，缩小档位不会杀掉任何进程，放大档位也不用重开。
• 点击选中：网格态点某个 pane 即选中，键盘输入走它。

D07

多窗布局（4 分屏）

截取 4 个终端同屏，其中一个 pane 头部带「工作指令提炼标签」，体现多任务并行时一眼认出各终端在干什么

images/D07-term-grid4.png

3.1.4 终端设置

每个终端 pane 头部有标题（可点击就地重命名）、工作指令提炼标签、会话报告按钮、打开文件夹按钮、设置齿轮与关闭按钮。齿轮里是六组精细控制：

D08

终端设置菜单（齿轮）

展开任一端终端右上角的设置菜单，完整展示：屏幕模式 / CLI 授权三选 / 多屏显示 / 执行完提示 / 闲置自动关闭 / 重启终端

images/D08-term-settings.png

3.1.5 编程报告

干完活想立刻知道“这一轮到底做了多少”——不用切页面、不用等日报，终端上就有。每个终端 pane 头部都有一个统计按钮，点开即出报告。

会话报告弹框

打开后是两块内容：

• 本会话统计与任务清单：当前会话到此刻的轮次、时长、token，并可一键生成飞书文档。
• 项目统计看板：按“项目目录 + CLI”维度汇总 30 天明细，单个项目到底投入了多少一目了然。

D13

会话报告弹框

截取终端统计弹框：今日行 + ↻ 一键生成飞书文档 + 历史日报告列表（每行可打开/删除）

images/D13-session-report.png

D14

项目统计看板

截取项目统计看板：左侧场次/轮次大纲 + 顶部项目统计卡（场次 / 轮次 / 活跃时长 / token）+ 编程记录逐轮明细

images/D14-project-stats.png

报告单元与生成规则

• 报告单元 = 项目目录 + CLI + 日期，一天一篇。
• 同一文档反复生成只清空重写，飞书链接不变——发给别人的链接不会因为重新生成而失效。
• 今日一行恒在，即使当天还没生成过，也能一键生成。

以上是「终端侧」的报告：随干随看、随手就发出去。全局视角的统计看板、活跃趋势、项目排行与全量日报归档，见 3.4 报告 · 编程日报。

3.2 任务 · 定时计划

定时任务中心把"提醒类"和"编码类"任务统一到一个页面，本地计划与云端提醒任务混排展示。

3.2.1 两类计划

3.2.2 计划编辑器

1. 名称：给计划起个名字。
2. 触发时间：日期 + 时:分（不暴露 cron 语法，直接选）。提供低谷时段快捷项——DeepSeek 峰谷计价中，9:00–12:00 与 14:00–18:00 是高峰价，夜间与周末半价，把批量任务排到低谷能直接省钱。
3. CLI 与执行目录：从终端预设会话里选，或自定义命令 + 目录。
4. 任务列表：逐条输入，Enter 确认后变成只读文本行（可 hover 改）。
5. 底部固定提示：权限自动审批 · 执行完闲置 2 小时自动关闭终端（无人值守默认配置，可改）。

3.2.3 三条关键策略

• 错过不补跑：应用关闭期间到点的计划只记录为「已错过」并汇总通知。这是省钱特性——晚跑就变成高峰价。（≤2 分钟的短暂重启除外，会补跑。）
• 不并发：上轮没跑完又到点，跳过本次并通知，不会开第二轮。
• 多电脑归属：每条计划都绑定一台具体电脑，只在那台电脑上保存与执行；换一台电脑看不到这些计划，也不会重复执行。

D15

定时任务中心

截取状态过滤标签（全部/待执行/已完成/已过期/已停用）+ 今天列表的计划卡（单次/每日、CLI、cwd、任务项数、立即执行/复制/编辑）+ 历史记录

images/D15-schedule-list.png

D16

定时计划编辑器

截取编辑任务页：任务名称（可一键生成）+ 执行时间（日期 + 时:分）+ 执行终端（从终端会话选 / 自定义）+ 任务清单（多条可拖动排序）+ 底部「闲置 2h 关闭 / 立即执行 / 保存」

images/D16-plan-editor.png

3.3 发布中心

发布中心把"本地构建 → 上传 → 服务器按步骤执行 → 健康检查 → 出问题时回滚"整条链路产品化。

3.3.1 三步配置，一次生效

1. 选来源：本地构建上传（前端 dist / Java jar）｜服务器 git 构建｜仅重启。填本地项目目录后点「项目体检」，系统扫描 package.json / pom.xml / build.gradle / Dockerfile，自动识别项目类型、推荐构建命令、判定产物形态与路径，并列出判定依据。
2. 排步骤：发布流程是一串可拖拽排序的步骤（备份 → 上传 → 更新 → 重启 → 健康检查…）。「检验全流程」会检查缺命令步骤、上架目录、备份与更新的先后顺序、上传步骤位置、备份根目录缺失后果，并给出疑问清单让你确认。
3. 定目标：用「单步演练」真连服务器把这一步跑一遍，下半屏 AI 实时把你敲过的命令提炼成带 # 注释的步骤命令（自动剔除 cd/ls 噪音），确认即回填；用「上传目标」真连服务器 cd 到目标目录，实时把它变成上传目标（文件制品覆盖文件，目录制品整目录覆盖）。全程不用手敲 scp。

3.3.2 执行与回滚

• 发布：本地构建 → 定位制品 → scp 上传（密码自动注入）→ 连接服务器按步骤执行 → 健康检查定成败。每一步的输出还会交给 AI 判断成功还是失败，失败给出一句话诊断与可自动应用的修正命令。
• 交互问答：执行中遇到问题会弹问答框（重试 / 跳过 / 中止 + 自由输入）。手机发起时 10 分钟无应答自动中止。
• 回滚：版本历史里每个版本可单独回滚，回滚前展示该版本的还原命令（由备份步骤反向推导，认不出就如实提示"没有可用的还原映射"，不猜）。可配置保留版本数（1–20，默认 5）。
• 并发：同一配置同一时刻只跑一轮（防自我踩），不同配置可并发。

D17

发布中心

截取左列配置卡（按分组）+ 右列当前版本条（发布/回滚/编辑）+ 版本历史 + 配置摘要

images/D17-deploy-home.png

D18

新建发布配置

截取新建发布配置：基础信息（分组/名称/服务器）+ 制品来源三选 + 本地目录与构建命令 + 发布流程步骤骨架

images/D18-deploy-editor.png

D19

添加服务器配置

截取服务器管理列表：名称/账号/端口/密钥 + 连通测试 + 编辑/删除 + 「从 SSH 会话导入」入口

images/D19-server-manager.png

D20

编排发布流程

截取发布配置编辑器：项目体检结论 evidence + 上架根目录识别 + 备份步骤的命令列表

images/D20-deploy-editor.png

D21

AI 提取发布流程

截取单步演练弹层：上半真连服务器的 SSH 终端 + 下半 AI 提炼区（带 # 注释的命令）+ 重置/确认保存按钮

images/D21-step-coach.png

D22

执行发布过程

截取发布进行中：步骤列表逐条亮起 + 上传文件进度 + 日志流 + 终止发布按钮

images/D22-deploy-running.png

3.4 报告 · 编程日报

报告页是全局视角的度量中心，回答一个此前没人能回答的问题：AI 到底帮你干了多少活儿。终端侧随手看的会话报告见 3.1.5 编程报告，这里负责跨项目、跨时间的汇总与归档。

3.4.1 页面结构

• 全局统计卡：项目数、总场次、总活跃时长、总 token（含缓存读/写，与 cc-switch 等 CLI 用量统计同口径）。
• 活跃趋势折线 + 项目排行条形图：与终端「项目统计看板」共用同一份实现。
• 项目日报浏览器：左边选项目，右边看该项目逐日日报；今日一行恒在（未生成也能一键生成），点行打开飞书文档，支持单行删除与批量删除。
• 工具条：刷新 / 立即生成今日日报 / 打开飞书多维表格 / 配置。

D23

报告页

截取完整统计页：用量/编程统计切换 + 供应商 / 模型 / 时间筛选 + 4 张统计卡（项目 / 场次 / 活跃时长 / token）+ 活跃趋势折线 + 项目排行 + 请求日志表

images/D23-report-panel.png

3.4.2 数据采集与口径

每轮 AI 编程对话结束后自动采集并归档。只统计 AI CLI 会话，聊天里动用工具的轮次不纳入，边界清晰。轮次数据优先取 CLI 自己上报的提问原文、完成总结与真实 token；其他 CLI 也能从终端画面中提取，不会漏统计。

3.5 模型 · 供应商管理

这一页管理的是内嵌终端里 AI CLI 用哪个模型供应商（小智自己的对话模型另行配置）。

页面按 Claude Code / Codex / Gemini / Kimi Code 四个 CLI 分 tab，每个 tab 里是一组供应商卡片：卡片上直接标出「启用中」徽标、密钥未配置的红标、baseUrl 与模型名，卡片可拖拽排序；右上角齿轮打开全局面板。

3.5.1 页面能力

• 未安装 CLI 的引导：页面直接给出安装命令行（可复制）、「直接安装」按钮与国内镜像命令（--registry=https://registry.npmmirror.com），安装过程在终端里可见、可中断。没装 Node.js 时给官方 LTS 直链。
• cc-switch 导入：只读扫描本机已有的 cc-switch 数据，把供应商批量导进来；指向 cc-switch 本地反代端口的端点会自动替换成真实端点或直接跳过并点名。
• 恢复官方配置：按"写入痕迹 + 值匹配"回滚，被 cc-switch 或你手动改过的键跳过并在结果里点名；改动前自动备份（留最近 5 份）。
• 导入/导出：导出为 JSON（可多选 CLI），导入按 Base URL + API Key 判重。注意：API Key 只有本机能解开，换机导入时 key 为空。
• 1M 上下文声明：勾选后模型名带 [1M] 后缀。这是个悬崖不是保险——声明后 CLI 会按 1M 窗口计算压缩时机，一次大工具输出就可能把会话顶死。因此勾选时应用会一并写入压缩上限作为安全阀。
• 终端编码感知开关：关闭后编程日报拿不到提问原文/完成总结/token，任务队列完成判定退回画面启发式。

D24

模型页 · 供应商列表

截取 4 个 CLI tab + 供应商卡片（启用中/未启用徽标、baseUrl、模型名、启用 / 余额 / 编辑 / 更多）+ 拖拽把手 + 右上「添加供应商」与齿轮

images/D24-model-list.png

D25

供应商编辑弹框

截取 claude 四档模型下拉（Sonnet/Opus/Haiku/Fable）+ 模型名后的「1M」复选框 + 自定义下拉菜单展开态

images/D25-provider-edit.png

D26

未安装 CLI 的教程卡

截取「没有检测到 Claude Code 的 AI CLI」卡片：安装命令行 + 直接安装 / 国内镜像安装 / 配置全局镜像源三个按钮

images/D26-cli-install-guide.png

3.6 设置

基础设置

更新

• 应用启动后自动检查更新：先看有没有已下载待安装的版本，没有再去线上查新版本。
• 建议更新可「稍后 / 跳过此版本」；强制更新不可关闭，只能立即更新。
• 四阶段：提示 → 下载（带进度条）→ 下载完成 → 安装并重启。
• 更新管理 tab 仅超级管理员可见：可上传新版本包、设置强制/建议、删除版本。

D27

设置 · 基础

截取基础设置页：基础 / 更新 tab + 页面设置（关闭窗口 / 编程任务面板 / 悬浮宠物）+ 移动端下载二维码 + 宠物样式 + 外观主题卡片 + 背景图片网格

images/D27-settings.png

外观主题

设置 › 外观提供四套预设主题，点卡片即时切换，不用重启。切换后面板、终端、弹框、右键菜单会一起变，不会出现「一半跟着变、一半没变」的拼接感。

• 暗夜：默认主题。深色底配蓝色，夜间或长时间盯着终端时更舒服。
• 明亮：浅灰底配白色面板，日间办公、环境光强或需要投屏演示时用。
• 纸墨：米色底配墨绿，画面对比柔和，适合读文档、写报告。
• 赛博：深紫底配紫青撞色，风格更个性，强调色最跳眼。

D28

暗夜

默认主题。截主页面：深色底 + 蓝色强调色的按钮/激活态 + 终端配色

images/D28-theme-dark.png

D29

明亮

切到「明亮」后截同一位置，便于与暗色系直接对比

images/D29-theme-light.png

D30

纸墨

米色底 + 墨绿强调色，建议截带文档的页面体现阅读观感

images/D30-theme-paper.png

D31

赛博

紫青撞色，建议截有渐变按钮和高亮态的页面

images/D31-theme-cyber.png

4移动端 · 手机遥控器

4.1 首页

App 采用侧边栏分区（不是底部 Tab）：窄屏时是抽屉（右滑打开），宽屏时是常驻侧栏。八个分区：

切换当前要控制的电脑，不看「我的」，看这两个地方：首页顶部的在线状态条（在线 · 电脑名 / 离线，点它即展开电脑列表）；或右侧滑出的功能区抽屉，抽屉顶部就是「电脑端」面板（电脑列表 + 添加电脑）。选中哪台，之后手机上所有操作就送到哪台。

M02

移动端首页

截取顶部在线状态条 + 6 张渐变功能卡（编码/任务/发布/报告/模型/设置）

images/M02-home.jpg

M03

侧边抽屉 + 电脑端面板

截取抽屉打开态：顶部「电脑端」面板（电脑列表 + 在线/离线状态 + 添加电脑）+ 6 个主分区 + 2 个底部分区，右侧为「选择电脑端」弹窗

images/M03-drawer.jpg

4.2 编程

4.2.1 会话列表

• 顶部四个工具按钮：分组会话抽屉、跳任务、远程预览、新建终端。
• 会话卡片网格（2 列），每张卡显示：类型徽标（AI·CLI / SSH / 手机创建 / 桌面创建 / 已超时）、状态点（执行中琥珀闪烁 / 空闲绿 / 超时红）、分组名与会话名、任务摘要跑马灯、已运行时长。
• 卡片可重命名与关闭终端。

4.2.2 进入会话

• 终端画面在手机端实时渲染，电脑端的输出实时推送到手机。
• 底部输入条：输入文本发送，或仅按 ↵。
• 快捷键盘面板：按 CLI 类型自适应生成。Claude 给出 /clear /compact /resume /model /init /cost /review Tab ⇧Tab；Codex 给出 /init /model /review /diff /status /plan /mcp；另有导航键（↑↓←→ Home End PgUp PgDn）与 Ctrl+C / Esc 中断键。
• 两种屏幕适配：手机屏（按手机宽度重排输出）／电脑屏（保持原始列宽，横向平移查看）。
• 终端设置面板还可改授权模式、闲置自动关闭（永久/2h/8h/1天/7天）、中断当前命令、关闭终端。

M04

编码页 · 终端列表

截取 2 列会话卡片网格：状态点、kind 徽标、任务摘要跑马灯、顶部 4 个工具按钮

images/M04-code-list.jpg

M05

终端会话 + 快捷键盘

截取终端实屏 + 底部输入框 + 展开的快捷键网格（如 /clear /compact Tab ⇧Tab）

images/M05-terminal-keys.jpg

4.2.3 分组会话抽屉与新建终端

抽屉里是常用会话（最多 6 个）+ 可折叠分组，点条目即在电脑上开一个对应会话。新建终端时，工作目录可以点「浏览」直接列你电脑上的目录（远程目录浏览器，支持 Windows 路径）。

M06

分组会话抽屉

截取常用会话区（≤6 个）+ 可折叠分组，体现"从桌面预设一键开会话"

images/M06-preset-drawer.jpg

M07

远程目录浏览

新建终端时点「浏览」，直接列出电脑上的目录；可逐级进入，点「选择当前目录」即回填

images/M07-dir-browser.jpg

4.2.4 远程预览

把电脑上跑起来的开发服务器，直接在手机上打开看效果。

使用步骤

1. 编码页点 Globe 按钮打开「在手机上预览」抽屉。
2. 系统会从终端输出里自动发现电脑上正在运行的 dev server 端口，并且真的连得上才会列出来（兼容只监听 IPv6 的 Node 服务）。也可手动填端口。
3. 点开即进入全屏预览页：右下角悬浮球菜单可切显示模式（手机自适应 / fit 等比缩放 / screen 虚拟显示器）、分辨率（1920×1080 / 2560×1440 / 1600×900 / 1366×768）、横竖屏，还能后退、刷新、关闭。

M08

远程预览 · 虚拟显示器

截取全屏预览页：横屏虚拟显示器按 1920×1080 显示电脑上的页面，右侧悬浮按钮可打开显示模式菜单

images/M08-preview.jpg

4.3 任务

任务页包含两块：定时计划与 CLI 任务队列。

4.3.1 定时计划

• 卡片显示：名称、启用开关、徽标（编码任务 / 会话任务已下线）、触发时间文案（每天 HH:MM / 每周X·Y HH:MM / 单次 MM/DD HH:MM）、任务条数、@电脑名、手机 徽标、CLI 与目录、上次执行结果（错过 / 中断 / 摘要）。
• 新建/编辑：纯 JS 滚轮选择器，各机型上表现一致；日期年/月/日三列、时间时/分两列，带"今天/明天/后天/现在"快捷 chip；CLI 与目录可从桌面端预设里挑，也能远程浏览电脑目录。
• 提交时自动绑定当前选中的电脑，并采用无人值守默认配置（自动审批 + 永不闲置关闭）；卡片上会标出这条计划来自手机。

M09

任务页 · 计划列表

截取计划卡片：名称 + 启用开关 + 触发时间文案 + @电脑名 + 手机徽标 + 上次执行结果

images/M09-plan-list.jpg

M10

新建 / 编辑任务

截取任务编辑页：基本信息 + 触发时间（每天/每周/单次 + 日期时间滚轮）+ 任务清单（逐条可排序编辑）+ CLI 与目录

images/M10-task-editor.jpg

4.3.2 CLI 任务队列

• 抽屉里显示任务条目：来源图标、标题、结果摘要、状态 chip（排队中 / 已暂停 / 执行中 / 已完成 / 需确认 / 已中止）。
• 可上移下移改序、暂停/恢复、删除；底栏显示「待执行 N 项」并有暂停/恢复/停止/清空已完成。
• 底部输入条直接追加任务（发送即自动执行），状态变化实时同步到手机。

4.4 发布

发布页显示电脑端传来的发布目标与服务器配置（保存在电脑端本地数据库），并支持远程执行。

• 列表：目标卡片带徽标（草稿 / 已检验 / 未检验）、制品来源（服务器构建 / 本地构建上传 / 仅重启）、服务器名、最近一次执行结果；草稿态禁用发布按钮。
• 详情：概要（服务器 / 上架目录 / 保留版本数）+ 制品来源 + 发布步骤（$ cmd 形式，上传步骤带注解）+ 可展开的执行记录（带手机发起 / 电脑发起徽标）。
• 实时执行：步骤状态逐条亮起 + 日志行滚动；失败时弹出问答卡（中止发布 / 已启动跳过 / 重试 + 自由输入）；随时「停止发布」。
• 状态自动校正：网络抖动时，手机端会主动与电脑端的执行记录核对一次进度，之后定期核对——不会让页面一直卡在"执行中"。

M11

发布页 · 目标列表

截取发布目标卡片：名称 + 检验徽标 + 制品来源 + 服务器名 + 最近一次结果 + 「发布」按钮

images/M11-deploy-list.jpg

4.5 报告

• 一级页：4 张统计卡（项目数 / 总场次 / 总活跃时长 / 总 token）+ 项目列表（名称、CLI 徽标、N 场 · Xh · N token）。
• 二级页（月历）：周一起始网格，有日报的日期显示绿点 + 文档图标，格内显示轮次与活跃时长；点日期直接打开飞书日报文档。月切换支持箭头与左右滑动，顶部有月度汇总卡（日报数 / 场次 / 轮次 / 活跃时长）。

M12

报告页 · 统计 + 月历

截取报告月历：日期格显示轮次与活跃时长，带文档图标的日期可打开当天日报，底部为月度汇总卡

images/M12-report-calendar.jpg

4.6 模型

4.6.1 模型页

四个 CLI tab，列出电脑上已配置的供应商（手机端只显示"是否已配置密钥"，拿不到密钥本身），点选即切换；选择"官方默认"即可恢复原厂配置。未配置密钥的条目会被拦截并提示"请到电脑端先配置密钥"。依赖 需桌面端 ≥ v0.1.13。

M13

模型页 · 供应商切换

截取手机端模型页：四个 CLI tab + 供应商卡片（名称 / 地址 / 使用中徽标 / 开关）+ 下拉展开

images/M13-model-picker.jpg

4.6.2 权限提醒（联动核心）

全局监听云端推送，收到权限请求立刻弹窗 + 播放提醒音：

弱网、息屏、切到后台都不会漏消息：连接断开会自动重建，App 切回前台时还会再核对一遍。提醒音可在设置里关掉。

M14

权限请求弹窗（联动核心）

截取「终端权限确认」或「工具权限请求」弹窗 + 选项按钮，最好带上电脑名与命令摘要

images/M14-perm-dialog.png

4.7 设置 · 我的

• 设置：四套主题（暗夜 / 明亮 / 纸墨 / 赛博）、授权提醒音开关（可试听）、版本号与构建号。
• 我的：偏好设置、检查更新（长按可看更新诊断详情 / 取消跳过某版本）、关于、退出登录。注意：切换要控制的电脑不在这里，用首页顶部的在线状态条，或右侧滑出的功能区抽屉。

M15

设置页

截取设置页：外观四张主题卡（暗夜 / 明亮 / 纸墨 / 赛博）+ 授权提醒音开关 + 版本号与构建号

images/M15-settings.jpg

M16

我的页

截取我的页：头像与账号 + 连接状态 / 电脑端 / 偏好设置 / 检查更新 / 关于 / 退出登录

images/M16-profile.jpg

5云端服务

云端是手机与电脑之间的中转枢纽，本身不参与你电脑上的任何操作。它只负责四件事：飞书登录授权、版本升级管理、把手机和电脑连起来、终端流与消息的中转。你的编程数据——会话、日报、计划、发布记录、任务队列等——全部保存在电脑端的本地数据库中，云端不保存任何编程内容。

5.1 云端负责什么

5.2 手机如何找到你的电脑

1. 多台电脑登录同一账号：每台电脑的桌面端用同一个账号（飞书）登录一次，就会各自注册成一台设备。
2. 手机自动识别：手机端登录同一个账号后，无需额外配对，应用会自动列出该账号下所有已登录的电脑终端。
3. 切换控制任意一台：在手机首页顶部点当前电脑名，或从屏幕右侧向左滑出功能区、在功能区顶部选中要操作的那台。之后开终端、发指令、批权限、看发布，云端都会把请求送到你选中的电脑，再把结果带回来。

• 电脑关机不会从列表消失：会显示为「离线」，重新开机联网后自动恢复。
• 只能操作自己的电脑：别人账号下的设备无法访问，也不会收到你的提醒。
• 多台电脑随意切换：公司电脑、家里电脑用同一账号登录后同时出现在手机里，切换后各页面都跟着切换目标。

5.3 六个典型联动场景

5.4 登录 · 升级 · 数据

飞书登录

• 桌面端登录会在浏览器打开飞书授权页；手机端可直接扫码或跳转飞书确认。
• 登录授权状态由云端维护，不需要在每台设备上重复输入密码。
• 退出登录后，这台设备与手机的联动立即断开，已下载到本机的数据不受影响。

版本升级

• 桌面端启动后自动检查更新；手机端在「我的 → 检查更新」里查看。
• 更新分「建议更新」与「强制更新」：建议更新可以稍后或跳过该版本，强制更新需完成后才能继续使用。
• 管理员可在桌面端「设置 → 更新管理」上传安装包、设置更新方式。

授权与数据

• 云端只保存第三方登录的授权状态，以及这次登录下已注册的电脑列表。
• 主题、字号等外观偏好只存在各自设备上，不上传云端。
• 会话、定时计划、发布配置、任务队列、日报与统计等编程数据，全部保存在当前这台电脑的本地数据库中，不会上传云端。
• 换一台电脑登录，看到的是那台电脑自己的数据；本机执行目录、正在运行的终端、API Key 也只留在那台电脑上。

5.5 电脑离线时还能做什么

• 照常可用 已登录电脑列表与连接状态（由云端维护）、主题等本机外观设置——都不依赖电脑上线。
• 还能对话 手机里的对话会自动改用云端模型回答，适合问问题、查资料、做轻量分析；它不会读取你电脑上的编程数据。
• 需要电脑在线 远程终端、任务队列、权限审批、发布执行、模型切换、远程预览，以及日报与统计、计划与发布记录——这些数据都保存在电脑端，必须由你电脑上的桌面端提供。

5.6 数据与隐私

6效率提升总览

6.1 场景对比总表

把全文的能力落回具体场景：左边是现在的干法，右边是用小智之后的干法。按四类场景分组。

6.2 价值总结

7常见问题

按使用场景归类。标注「待确认 / 待补充」的答案目前只是初稿，需要结合实际情况核对后再定稿。

7.1 安装 · 连接 · 登录

手机里看不到我的电脑，怎么办？

按顺序确认三件事：① 电脑开着机（关机不会从列表消失，但会显示为「离线」）；② 电脑联网；③ 电脑和手机登录了同一个飞书账号。三项都满足后，在手机首页顶部（或右侧滑出的功能区顶部）选中它。

换了网络环境（公司 → 家里）就连不上了？

不需要额外配置。电脑是主动连上云端的，公司网络、家里 WiFi、路上用流量都一样，不需要公网 IP、端口映射、内网穿透或 VPN。若仍连不上，先看电脑端是否还显示在线。

退出登录后，我电脑上的东西会丢吗？

不会。退出登录只断开这台设备与手机的联动，已在本机的数据不受影响（会话、日报、计划、发布配置都存在本机）。

一个账号能登录几台电脑？手机上怎么切？

同一个账号可以绑定多台电脑，手机登录后自动识别。在首页顶部或功能区顶部选目标电脑，之后所有操作都送到这台，各页面也跟着切换目标。

7.2 任务 · 权限 · 定时

定时任务错过了，会自动补跑吗？

不会，这是刻意设计的省钱特性：应用关闭期间到点的计划只记录为「已错过」并通知，因为晚跑就等于跑到高峰价。（≤2 分钟的短暂重启除外，会补跑。）

上一条还没跑完，又到点了会怎样？

不并发：上轮没跑完又到点，跳过本次并通知，不会开第二轮。同一配置同一时刻只跑一轮。

CLI 卡在权限请求，人又不在电脑前？

这正是手机端最刚需的场景：CLI 弹出权限请求时，手机会震动 + 提醒音，在手机上点「允许」即可。也可以在终端设置里改用自动确认档位（三档含义见 3.1.4 终端设置）。

突然断电或强退，正在跑的任务算完成了吗？

不确定，所以系统会给它打一个中断标记——既不静默跳过导致漏做，也不盲目重跑。确认完成就点行内 ✓，否则重新执行。

任务队列能改顺序、能插队吗？

可以，运行中随时干预：上移下移调序、暂停单条、跳过当前、停止队列、编辑、删除、复制结果。已完成的任务不能调序，执行中的不能删（需先停止）。

7.3 发布 · 预览 · 模型

发布失败会自动回滚吗？

发布中心提供版本历史一键回滚，并会先展示还原命令；配置里有健康检查环节，异常时会停下来由你决策。待确认 健康检查失败是否支持自动触发回滚，需确认产品实际行为后补写。

手机上打不开远程预览？

先确认电脑上真的跑着开发服务——列表里只会出现真正连得上的端口（只在终端打印了地址、但服务没起来的不会列出）。也可以手动填端口。另注意预览里热更新不可用，改完代码需手动下拉刷新。

手机上能改 API Key 吗？

不能。密钥只在电脑端加密保存，手机端只能看到「是否已配置」并切换已配置好的供应商。这样设计是为了让密钥不离开你的电脑。

切换模型有什么前置条件？

手机端切换模型需桌面端 ≥ v0.1.13。供应商在电脑端界面里配置，切换时会自动备份、可一键恢复官方默认。

7.4 数据 · 授权 · 支持

我的代码和数据会上传到云端吗？

不会。会话、日报、计划、发布配置、任务队列、终端画面、API Key、源码与构建产物全部只存在你的电脑上。云端只保存第三方登录的授权状态和已登录电脑列表；主题等偏好只存在本机。终端画面只是经云端实时转发，不落地保存。

换一台电脑登录，之前的数据还在吗？

看不到。每台电脑的数据都存在各自本机的数据库里，换一台登录看到的是那台电脑自己的数据。好处是不会串号，代价是需要提前规划好在哪台机器上跑。

电脑关机了，手机上还能做什么？

还能看已登录电脑列表与连接状态，主题等本机设置也照常可用，也能用手机里的对话问问题（此时改用云端模型回答，不读取你电脑上的编程数据）。但远程终端、任务执行、权限审批、发布执行、模型切换、远程预览，以及日报与统计都需要电脑在线。

弱网或断网会怎样？

终端流经云端双向转发，弱网会自动重连；电脑短暂离线不会丢数据，重新开机联网后自动恢复。期间的定时计划不会补跑。

遇到问题怎么反馈？

桌面端侧栏底部「更多」里有意见反馈入口；手机端「我的 → 检查更新」长按可看更新诊断详情。待补充 支持邮箱 / 群组 / 工单地址。

附附录 A · 名词解释

文档里反复出现的几个词，先在这里对齐一次。

附附录 B · 已知行为与注意事项

以下是使用过程中容易被误解或容易踩到的点，提前说明可以少走弯路。

定时与任务

• 定时任务错过不补跑：应用关闭期间到点的计划只记录为「已错过」并通知。这是省钱特性（晚跑 = 高峰价），不是缺陷。
• 编程数据只存在电脑上：报告、发布记录、计划、任务队列等都保存在电脑端本地数据库，云端不保存副本；电脑离线时这些页面暂时无法查看，已登录电脑列表仍可看到。
• 强退或断电后的任务带中断标记：系统没收到完成信号，不确定它跑完没有。确认完成就点行内 ✓，否则重新执行——既不漏做也不盲目重跑。
• 同一配置同一时刻只跑一轮：发布不会自我踩踏；不同配置之间可以并发。

模型与预览

• 1M 上下文声明是悬崖不是保险：勾选后 CLI 会按 1M 窗口计算压缩时机，一次大工具输出就可能把会话顶死。应用已自动写入压缩上限作为安全阀，但仍需谨慎。
• 模型页有版本门槛：手机端切换模型需桌面端 ≥ v0.1.13。
• Gemini 只认官方协议端点：DeepSeek / GLM / Kimi 需经中转；项目目录里的 .env 会遮蔽全局配置。
• 手机预览热更新不可用：改完代码需手动下拉刷新。
• 手机预览只显示真正连得上的端口：只在终端里打印了地址、但服务没起来的端口不会出现在列表里。

移动端

• 开屏最短 3 秒：这是固定的启动时长，不是卡顿。
• 授权提醒音默认开启：可在「设置 → 提醒」关闭。
• 电脑离线时部分功能不可用：远程终端、任务执行、权限审批、发布执行需要电脑在线，详情见 5.5 电脑离线时还能做什么。