# 鸣跃智能体 Ultra 使用说明书 {#top}

> v3.2.1「刃牙」 · 鸣跃智能体 Ultra · 飞天.锐出品 · 基于 LiteCode 底层基础架构
>
> 写给第一次用的人：不讲原理，只讲「我想做什么 → 怎么点 / 怎么说 → 会看到什么」。
> 文中的截图都是真实界面，红框上的数字对应文字里的「①②③」。
> 文中的实测数字来自内置的仿真业务系统与虚构数据，不是任何人的真实业务数据，用于说明能力；实际耗时和结果取决于你接入的数据和系统。

**这份说明书怎么读**：想马上用起来，看第 1、2 章；要接公司数据，看第 3、4 章；要做自动化，看第 5、6 章；要管团队，看第 9、10 章；出问题，直接翻第 11 章。

---

## 1. 5 分钟上手 {#s1}

### 1.1 它是什么 {#s1-1}

一句话：**一个装在你自己电脑或服务器上的 AI 助手，会自己动手把活干完。**

你说一句话（打字或说话都行），它自己拆任务、查资料、算数、写文档、调用你接进来的业务系统，做完把成品交给你。对话和文件保存在你自己的机器上；只有你主动接入外部模型或外部服务时，相关内容才会发给那个服务。

### 1.2 怎么打开它 {#s1-2}

| 你的情况 | 怎么装 / 怎么开 |
|---|---|
| 一台 Windows 电脑，想马上用 | 装 **Windows 安装包**（离线安装包，约 1.9 GB）。要求：Windows 10 2004 及以上或 Windows 11（64 位），磁盘留 15 GB，电脑里开着虚拟化（任务管理器 →「性能」→「CPU」里看到「虚拟化：已启用」就行），安装用的账户是管理员。装完桌面有图标，双击就开。 |
| 有一台一直开着的服务器（Linux） | 用 Docker 部署（由你的管理员或部署人员完成）。装好后，在浏览器里打开 `http://服务器地址:18790`。 |
| 手机 | 装 **安卓 App**（网页版外壳，连接你自己的服务器）；或者直接用手机浏览器打开服务器网页，页面已经适配手机。 |
| 想先看看 | 打开官网，点「在线体验」（体验站，里面是内置的仿真业务系统和虚构数据）。 |

> 下载地址以官网「下载」页为准。Windows 安装包的版本号以下载页显示的为准，**请看下载页**，这份说明书不替它保证。

**Windows 安装包安装步骤**

1. 双击安装包。Windows 弹出「已保护你的电脑」时，点「更多信息」→「仍要运行」（安装包没有买代码签名证书，这是正常的）。
2. 一路点「下一步」。中间要填三项：**模型地址**（例如 `http://地址:端口/v1`）、**模型名称**、**API Key**（没有就留空）。这三项就是告诉它「用哪个大模型干活」，不会填可以先跳过，装完在设置里再改。
3. 如果电脑从没开过 WSL（Windows 里跑 Linux 的官方功能），安装包会请求一次管理员权限去开启，然后提示重启。重启后它会自己接着装，不用再点。
4. 最后一步「接入本机操控」会再请求一次管理员权限。这一步是让它能在这台电脑上开软件、截图、点按钮。不想要就点「否」，以后托盘菜单里随时能补。
5. 装完，右下角托盘常驻，开机自启。窗口地址是 `http://127.0.0.1:18790`，**只有这台电脑自己能访问**。

**安卓 App 安装步骤**

1. 把 APK 传到手机，点开安装。系统提示「禁止安装未知来源」时，到设置里允许你当前用的浏览器或文件管理器安装应用。
2. 小米、华为、OPPO、vivo 等可能弹「风险提示」，原因是 App 没上架应用商店。选「继续安装」即可。App 本身不带广告和统计，也不要通讯录、短信、定位权限。
3. 第一次打开，填**服务器地址**。公网地址写 `https://` 开头；局域网地址可以写 `http://192.168.x.x:18790` 这类（明文 http 只允许内网地址）。点「连接」，连不上会给人话提示。
4. 已知限制：没有推送通知；更新要手动装新 APK（同一签名直接覆盖，数据保留）。

### 1.3 登录 {#s1-3}

![登录页](manual_img/01_login.webp)

- **个人模式**（默认）：只有一个密码框。Windows 安装包的默认密码是 `admin`，**进去后第一件事：设置 → 修改密码**。
- **企业模式**：要填「登录名 + 密码」（图中就是这个样子）。账号由管理员建，第一次登录会被要求先改密码。
- 看到「登录已过期，请重新登录」不用慌，你刚输入的内容会保留，重新登录就能接着发。

### 1.4 第一次对话 {#s1-4}

**我想做什么**：让它帮我查点东西。

**怎么点**：登录后看到首页，直接在输入框里打字，回车发送。也可以点输入框下面的快捷按钮（「总结 PDF」「每日简报」「深度搜索」「搭一条流水线」……）。

![首页](manual_img/02_home.webp)

首页上这几个位置先认识一下：①新对话 ②今日（流水线、定时任务送来的结果） ③输入框 ④输入框下面的小按钮（换模型、思考强度、推演） ⑤工具箱、技能、设置。

**会看到什么**：它一边做一边显示每一步（调了什么、用了多久），做完把结果给你。下面是一次真实对话：问「AU 主力合约现在价格多少，我的持仓浮动盈亏多少」，它自己去查了接进来的仿真期货系统（数据是虚构的）：

![一次真实对话](manual_img/03_chat_result.webp)

①点开能看它每一步做了什么；②结果直接渲染成表格；③可以复制、朗读、重试。

做的过程中你可以随时插话：**回车是「补充一句」，点「⚡ 立即」是「打断它并按我的新话调整」**。

### 1.5 个人模式 vs 企业模式 {#s1-5}

| | 个人模式（默认） | 企业模式 |
|---|---|---|
| 谁在用 | 就你一个人 | 多个账号，每人自己登录 |
| 能做什么 | 全部放行，不设限 | 默认全开；管理员可以按角色、按人关掉某项；只读账号默认不能调用能力 |
| 数据 | 都是你的 | 会话、记忆、工作区文件、知识库、日历按人隔离；管理员能管账号，但**看不到别人的会话内容** |
| 切换 | 设置 → 团队 / 企业 → 开启企业模式 | 管理员可以关回个人模式（其他人的数据原地保留，不删） |

开启企业模式很简单：设置 → 「团队 / 企业」→ 输入当前登录口令确认 → 点「开启企业模式」。当前登录会失效，用登录名 `admin` 加刚才的口令重新登录。立即生效，不用重启。

![开启企业模式](manual_img/22_enable_ent.webp)

### 1.6 三端对照：网页、命令行、微信 / 企业微信 {#s1-6}

同一个后台，三种用法。**网页功能最全**，命令行和微信 / 企业微信是它的一部分。下表按 3.2 发版前的自动化回归如实列出（「—」表示这一端目前没有）：

| 能力 | 网页 | 命令行 | 微信 / 企业微信 |
|---|---|---|---|
| 对话、工具调用、会话续聊 | 有 | 有 | 有 |
| 技能、记忆、搜索、子代理等后端改进 | 生效 | 生效 | 生效 |
| 消息时间和日期分隔 | 有 | 会话查看里有 | — |
| 技能命中提示 | 有 | —（技能照常生效，只是不显示） | — |
| 定时任务（新建、运行、查看、删除） | 有，含停止条件和补跑设置 | 能新建查看运行删除；停止条件和补跑设置只能在网页里设 | 完成后通知到聊天 |
| 今日卡片、任务中心、日志中心、告警与预算、探索空间 | 有 | — | — |
| 命令面板 | 有 | —（终端没有这个概念） | — |
| 费用 / 用量 | 分开显示云端和自建 | 有，但是原始数据，没有分开排版 | — |
| 企业版成员登录 | 有 | 有 | 企业版暂不支持绑定，默认拒绝 |
| 插话（运行中追加指令） | 有 | —（后台有接口，命令行还没封装） | 有 |

微信 / 企业微信里发出的内容会统一清洗：系统提示、完成标记、工具调用文本、思考内容不会漏到聊天里。企业微信收到文件目前会被忽略。

---

## 2. 对话怎么用 {#s2}

### 2.1 发消息、插话、停下 {#s2-1}

- **发送**：回车。**换行**：Shift + 回车。**关弹层**：Esc。
- 它在做事的时候，你再发的话分两种：**回车 = 补充**（它看到后继续做）；**点「⚡ 立即」= 打断并调整**。
- 对话太长时，系统会自动压缩上下文：前面的内容整理成一份 9 段的检查点（你定的约束放最前，没做完的待办原样带上，写进去的文件路径会和原文核对）。觉得乱了，新开一个对话更清爽。
- 整理好的检查点会接着用：下一回合直接复用，不用每次重新压缩，所以长对话里发消息前不会再先等十几到几十秒；只有新增的内容又太多时，才把「旧检查点 + 新增部分」再整理一次。
- 左上角搜索框能搜**标题和聊天内容**，搜到的对话能直接整理，见 [2.10](#s2-10)。

**运行中：怎么看任务还在跑、怎么停止与插话（3.2）**

![运行中的停止键](manual_img/59_running_glow.webp)

- **做什么**：让你一眼分清「还在干活」和「卡住了」，并随时插话或停下。
- **怎么用**：
  1. 任务运行时，输入框上方有「正在处理中 · 用时 · 停止」状态条，发送键旁出现圆形**停止键**，外圈转动并带一圈暖色微光（图下半是放大的四个瞬间）。
  2. 想补充一句：直接输入，回车（它看到后继续做）。
  3. 想打断并按新想法调整：点「⚡ 立即」。
  4. 想停下来：点「停止」（状态条上的和发送键旁的都行）。
- **常见问题**：转圈就是它没动静吗？不是，转圈只说明任务还在进行；想确认有没有进展，点回复上的「▸ 查看过程」看步骤和用时。点了停止还在转？停下来需要一点时间收尾；过了很久还没停，到任务中心里确认它的状态（见 [2.8](#s2-8)）。
- **小提示**：转圈是纯视觉提示，不影响速度；想要一直盯着看，把展示设置调到「详细」（见 [2.6](#s2-6)）。

### 2.2 输入框下面的小按钮 {#s2-2}

![输入框小按钮](manual_img/04_composer_chips.webp)

① **📎 附件** ② **🤖 模型**（只影响当前对话） ③ **⚡ 自动执行** ④ **🧠 思考强度** ⑤ **🎭 推演**

> **3.2 起**：输入框默认只留 📎 附件、🎤 语音、🤖 模型、「⋯」和发送键，其余按钮（自动执行、思考强度、推演、展示……）收进「⋯ 输入选项」面板，详见 [2.20](#s2-20)。下面的老截图是 3.2 之前的样子，按钮名字和作用没变。

**附件上传（≤200 MB）**

- 点 📎，或者直接把截图 Ctrl/⌘+V 粘进输入框。
- 单个文件最大 **200 MB**，图片一次最多 6 张。支持文档、表格、代码、图片、音频。
- 选文件时就检查大小，超了会立刻提示，不会传到一半才失败。
- 当前模型不能看图时，系统会自动把带图的请求临时交给配好的「识图兜底模型」，答完切回，不改你的默认模型。

**语音**

- 点 🎤：点一下开始说，再点一下停止，说的话会变成文字。
- 回答下面有 🔊 朗读，可以让它念给你听。
- 手机上第一次用，系统会问你要麦克风权限，允许即可。

**技能**

- 技能就是「它学会的一套做事方法」（比如做 PPT、查资料、数据分析）。
- 在输入框里打 `/` 会弹出技能列表，选一个；也可以不选，它会自己挑合适的（回答下面会显示「本轮技能」）。
- 左下角「技能」可以管理，也能从技能市场装更多。

**思考强度（🧠）**

- 点一下切换。按钮只会显示**当前这个模型真正支持的档位**：有的只有「开 / 关」，有的是「关 / 低 / 中 / 高」，有的常开不可调。换模型会自动适配。
- 只影响当前对话；全局默认在设置里改。
- 做多步任务（查数据、写报告）建议保持「开」，关掉会更快，但难题更容易出错。

**模型切换（🤖）**

![换模型](manual_img/05_model_switch.webp)

- 点 🤖（①），选「跟随默认」或某个具体模型，**从下一条消息起生效**，只管这一个对话。
- 也可以直接发 `/model 模型名`。
- 想改全局默认模型：设置 → 常用 → 模型列表里点「设为默认」。「测试」按钮可以检查这个模型通不通。

**自动执行开关（⚡）**

- **默认是开的**（个人和企业模式都一样）：它要执行命令、写文件、下单、出入库、远程操控电脑时，直接做，不再每次弹「要不要执行」，也不会在回答末尾问「需要我继续吗」。**每一步照样记审计日志**。
- 想更稳：设置 → 常用 → 顶部「⚡ 自动执行（推荐）」把总开关关掉，之后危险操作会先弹确认卡片（写清后果），你点「允许」才执行。
- 只想管某一个对话：点输入框旁的「⚡ 自动执行」小按钮，只改这个对话。
- 两条底线不受这个开关影响：网页、邮件、接口返回里夹带的「指令」不会被执行（防注入）；Windows 电脑首次接入的扫码 / 口令绑定照常保留。
- 在微信、企业微信里弹不出卡片，关闭自动执行后，危险操作会直接说明「这一步没执行」。

![自动执行开关](manual_img/21_auto_exec.webp)

①总开关 ②说明。企业模式下，管理员还能在这里按角色选「跟随全局 / 开 / 关」。

### 2.3 画布、项目、今日、看板 {#s2-3}

- **画布**：它写出代码、网页这类东西时，结果块上有「在画布打开」，点一下在旁边大窗口里看，可以全屏。
- **项目归组**：左侧「项目」。点「＋」新建一个项目（选类型：通用、代码、小说、报告、研究等），再把相关对话归进去，对话多了不会乱。
- **今日**：左上「☀️ 今日」。流水线、定时任务、探索课题做完的结果，会变成卡片放在这里（详见第 5 章）。
- **看板（用量）**：左上「📊 看板」。看今天、7 天、30 天用了多少 token、调用了多少次、哪个时段最活跃，可以导出 CSV 或 HTML 报告。

![用量看板](manual_img/27_usage.webp)

- **分享**：对话右上角「🔗 分享」可以生成**只读**分享链接。

### 2.4 手机端特别说明 {#s2-4}

手机上屏幕小，部分按钮收进了面板里（3.2 起统一叫「⋯ 输入选项」，从底部升起，见 [2.20](#s2-20)；下面老截图里的「＋」就是它的前身）。

![手机首页](manual_img/06_m_home.webp)

首页输入条上：①📎 附件 ②🎤 语音 ③＋ 更多 ④发送。

![手机加号面板](manual_img/07_m_plus.webp)

进入对话后，点 ＋ 会弹出面板（①）：**⚡ 自动执行开 / 关**、**🧠 思考**、**🎭 推演**。②就是那个 ＋ 按钮。

![手机侧栏](manual_img/08_m_drawer.webp)

点左上角「☰」打开侧栏：①今日 ②工具箱、技能、设置都在最下面。

![手机上的对话](manual_img/09_m_chat.webp)

小提示：

- 运行中的「停止」键贴在输入区上方，不会盖住输入条。
- 切后台回来页面总是重新加载：把 App 的省电策略设成「无限制」。

### 2.5 全局录屏与录屏存档 {#s2-5}

**全局录屏**：打开后，你的每个对话、每一轮都会自动录成一段 mp4（只录 LiteCode 自己的对话窗口，不录你的桌面；画面固定是「完整过程」，不受专注模式影响，左下角叠当前步骤、右下角叠时间）。因为是服务器在虚拟屏上录的，**手机、APP、电脑都能用**，不需要浏览器支持录屏。

- 开关：侧栏「工具箱 → 录屏存档」页顶部，或 设置 → 常用 →「全局录屏」。默认关。
- 单个对话想临时开 / 关：输入框旁（电脑在「⋯」菜单里）的「⏺ 录屏」。跟全局一致时等于「跟随全局」。
- 手动录屏（🎥）只在电脑浏览器可用，且要用 https 或 localhost 访问；手机 / APP 点它会提示改用全局录屏。

**录屏存档**：按时间列出所有录屏，每条有缩略图、时长、大小、所属对话和到期日，可以播放、下载 mp4、改名、删除（删除先进回收站，7 天内可撤销）。

- 保留策略：默认保留 30 天、总容量 20 GB（你可以改）；到期或超容量时最旧的自动进回收站。
- 提醒：每次录完弹「已存档：xxx · 查看」；容量用到 80%、磁盘不足、3 天内到期、录制失败 / 被自动停止，都会弹提示条并写明原因。
- 资源保护（管理员可调）：每轮最长 120 分钟、同时最多 2 路、服务器磁盘低于 5 GB 自动停录；企业模式下管理员还能让全员一律录 / 一律不录。
- 企业模式按账号隔离：每个人只看得到自己的录屏，管理员可看全部。

### 2.6 展示设置：聊天里显示多少过程 {#s2-6}

聊天里除了答案本身，AI 做事的过程也可以显示出来：搜了什么、写了哪个文件、想了什么、命令输出了什么。**显示多少，由你决定。** 设置 → 常用 →「👁 展示设置」，或输入框旁的「👁 展示」（手机在「＋」里，只改当前这个对话）。

**不管怎么选，这两样永远显示：**

- **正文**：AI 写给你的文字，包括它动手前说的那几句话（比如「我先查一下仙居天气…」）。
- **卡片**：做出来的文件、网页、图片、表格、音视频，以及卡片上的「预览 ↗」「↓ 下载」按钮。

**三个预设**

| 预设 | 看到什么 |
|---|---|
| 极简 | 只有正文和结果卡片，加一个输入框上方的状态胶囊，例如「正在渲染视频 · 61% · 已 1:05 · 停止」（有真实进度才带百分比）。过程都收在回复上的「▸ 查看过程」里。 |
| 标准（默认） | 极简 + 一行一个动作的摘要，例如 `▸ 正在：搜索「杭州 到 仙居南站 高铁」`、`▸ 写文件 xianju_plan.html (+197 −0) ✓ 1.2s`；连续的同类动作合并成一句人话（`读取了 12 个文件`、`运行了 5 条命令`，点一下看每一条；失败的那一次单独成行、标红，不被合并）。思考、命令原始输出、识图原文都收起来。 |
| 详细 | 全部显示，和旧版一样：思考、每次工具调用、命令输出、用量统计，都展开给你看。 |

3.2.1 对三档做了增强，切档位的位置、胶囊、合并行、失败标红、极简档「查看过程」见 [2.24](#s2-24)。

**自定义勾选**：在「展示设置」里点开「自定义」，每个元素一个开关，旁边有一行说明和小预览：状态胶囊、动作摘要行（可选「合并相同调用」「最多显示几行」）、文件改动摘要、技能徽标、步骤计数与用时、思考 / 推理内容、工具调用详情、命令 / 脚本原始输出、识图 / OCR 结果原文、子代理 / 流水线过程、重试与换方法提示、token / 模型名 / 时间、复制 / 重试等操作栏。

- 没勾选的内容**不会丢**：点回复上的「▸ 查看过程」，完整的过程都在里面。
- 设置按账号保存在服务器，换手机、换电脑都一样；输入框旁的「👁 展示」只改当前对话，选「跟随默认」可撤销。
- 这只影响显示，不影响 AI 怎么做事，也不影响导出、分享、微信里的内容。

### 2.7 产出物中心：AI 做出来的成果都在这里 {#s2-7}

AI 帮你做的 PPT、Word、Excel、PDF、网页、图片、视频、音频，不管是在聊天里做的、流水线跑出来的、探索课题交付的，还是定时任务和录屏，**都会自动收进「产出物中心」**，不用再回到某次对话里翻。入口：工具箱 →「产出物」。

- **第一次打开会自动把以前做过的都收进来**（只读扫描，不会动你的任何文件）；之后新做的实时进来。文件还是放在原来的地方，这里只记「它是什么、从哪来的」。
- **找**：顶上的搜索框能搜文件名、来源会话的标题、文件里的内容（PPT/Word/Excel/网页/PDF 都会读一小段摘要）和标签；关键词会高亮。横着一排按钮按类型分：PPT、文档、表格、PDF、网页、图片、视频、音频……；「筛选」里还能按来源（聊天 / 流水线 / 探索课题 / 定时 / 录屏）、项目、标签、只看收藏、排序。手机上「筛选」是从底部拉出来的抽屉。
- **整理**：每个成果右边的 ☆ 收藏（收藏的排最前）；「⋯」里可以改名（只改这里显示的名字，原文件不动）、加标签、归到项目。点「多选」可以批量：**打包下载（zip）**、打标签、收藏、移入回收站。
- **看**：点「预览」直接在页面里看——PPT / Word / Excel / PDF 会转成一页页的图片，网页在隔离的沙箱里打开，图片、视频、音频直接播放。点「在来源中打开」回到它是在哪次对话 / 课题 / 流水线里做出来的。
- **删了能反悔**：移入回收站不会弹确认，屏幕下方会出现「撤销」，回收站里能保留 30 天；「彻底移除」只是从这里拿掉记录，**原文件仍然留在会话里**。
- **聊天里也能整理**：聊天中每个文件卡片上有「📦 已收入产出物」小标记，旁边的 ☆ 一键收藏、🏷 加标签。
- **显示什么你定**：右上角「显示」里有「极简 / 标准 / 详细」，也可以逐项勾选缩略图、大小、来源、标签、时间、内容摘要、项目。
- **企业模式**：每个人只能看到自己的成果，别人的打不开、改不了；管理员默认也只看自己的，需要时勾「看全部成员的成果」。

还没有成果时，这里会给你三个「试试」：做一份 PPT、写本周周报、整理成表格，点一下就把提示词填进输入框。

### 2.8 任务中心：正在做和做完了的事 {#s2-8}

取代原来的「后台任务」。它不再列一堆进程号，而是按「事」来列：**长对话、流水线运行、定时任务、探索课题、录屏、生成图片/视频/音乐的任务**，每条用人话写着：叫什么、哪来的、什么状态（排队 / 运行中 / 暂停 / 已完成 / 部分完成 / 失败 / 已中断）、做到哪了（步骤 3/5、第 4 回合）、用了多久、做出了什么。入口：工具箱 →「任务」。

- **运行中的排最上面**；上面一排按钮在「全部 / 进行中 / 需要处理 / 已完成」间切换，「筛选」里还能按类型、时间，也能搜名字。
- **能直接操作**：运行中可「停止」；失败的可「重试」，流水线还能「从失败处继续」；暂停的探索课题可「继续」；「查看过程」跳到对应的对话 / 课题 / 流水线。
- **成果就在行里**：做完的任务下面会列出它产出的文件，点一下进产出物中心，并且只看这个任务的成果。
- **完成提示条**：任务做完或失败时，输入框上方会弹一条轻提示（和「录屏已存档」一样的样式），点「看成果」或「去看看」跳过去；不想要就在任务中心「显示」里关掉「任务完成 / 失败时提醒我」。侧栏「任务」旁的小数字是正在进行的任务数。
- **后台命令（进程号、结束进程）收在最底下的「高级」里**，平时不打扰你。
- 企业模式下每个人只看到自己的任务。


**3.2 改版：**

![任务中心](manual_img/42_task_center.webp)

- ①顶部看板：运行中、今日完成、今日失败、平均耗时、今日 token。②「全部 / 进行中 / 需要处理 / 已完成」切换，右边「筛选」「显示」。③**子代理缩进挂在发起它的任务下面**，左边的小三角可以折叠。
- 每次运行有一个唯一编号 **run_id**（形如 `r_` 加一串字母数字）。日志、用量账本、产物和今日卡片里都带着它，用来把「同一次运行」的记录串起来。
- **价目核验**（3.2.1）：模型价目的核对（手动点，或按周期自动跑）也会出现在任务中心，类型叫「价目核验」，带 $ 图标，可在「筛选」里按类型选出来；点「查看核对结果」直接跳到用量看板的「价目与核对」。见 [2.27](#s2-27)。
- 状态统一成七个词：排队中、运行中、暂停、已完成、部分完成、失败、已中断；没跑完的会写清原因，例如「迭代次数用尽，已带回已收集的资料」「运行超时，已带回已收集的资料」「已强停（检测到重复调用循环）」。
- 「历史」页签按天翻页，翻得到多远取决于日志保留天数（`config.json` 的 `logs.keep_days`，默认 14 天）；可以导出 CSV（最多 5 万行）。重启服务后任务记录仍在。

![任务详情](manual_img/43_task_drawer.webp)

点任意一行打开详情：①状态与来源　②来源、归属人、起止时间、耗时、token　③**run_id（点「复制」）**、父任务、子任务　④状态与原因　⑤耗时条，并写出同类任务的中位数和 P90　⑥子代理汇报（迭代 / 续跑 / 工具调用次数、状态、结论、证据来源）。

### 2.9 文件预览：点开就能看，不是一坨代码 {#s2-9}

聊天里的文件卡片、产出物中心、流水线输出、探索课题的产物、工作区文件列表，**点「预览」或「↗」都会打开同一个预览层**，能渲染的都渲染出来；顶上有「上一个 / 下一个」「↓ 下载」「🔗 复制链接」「全屏」。手机上点系统返回键就能关。

- **网页（.html）**：像浏览器一样运行（在隔离沙箱里，读不到你的登录信息，默认不联网），旁边有「源码」「静态渲染」「联网渲染」。页面脚本出错或一片空白时，会自动退回静态渲染并告诉你原因；页面引用了 CDN 等外部资源被拦截时，会提示你点「联网渲染」。**Markdown** 渲染成带表格、代码高亮的文章，可切「源码」。
- **PDF / PPT / Word**：转成一页页的图片，左边缩略图、中间大图，可翻页、缩放、连续滚动或单页（幻灯片默认整页放进窗口）。Office 文件第一次需要转换（几秒到几十秒，有进度），转好后会缓存，再开是秒开。手机和 App 里也一样用。
- **Excel / CSV**：渲染成表格，多个工作表有页签，首行固定，先显示前 200 行再点「加载更多」；5 万行的大表也不会卡（服务器只取你要看的部分）。图表和图片在下载的文件里看，这里只显示单元格数据。
- **压缩包（zip / tar / gz / 7z）**：列出前 100 项（名称、大小、修改时间），文件夹可展开，显示总文件数和压缩前后大小；里面小的文本、图片点一下就能看。**不会解压到磁盘**；有密码的只提示需要密码，不会尝试破解；疑似「压缩炸弹」和带 `..` 的危险路径会标红提醒。
- **图片 / 视频 / 音频**：图片可缩放拖动（手机双指）；视频是播放器，mov / avi / mkv 等浏览器放不了的会自动转成 mp4 预览版；音频带波形，点波形跳转。
- **代码 / 日志 / JSON / 笔记本**：高亮 + 行号，缩进块可折叠；大文件只先读开头，点「加载更多」或「跳到末尾」；JSON 是可折叠的树；`.ipynb` 渲染成笔记本。不认识的类型显示类型、大小、修改时间和下载按钮，不会显示乱码。
- **复制链接**：生成 24 小时有效的临时链接，拿到的人不用登录就能看这一个文件。
- 预览缓存默认最多占用 2GB（超过自动删最久没看的），管理员可在 `config.json` 的 `preview.cache_max_mb` 调整。

### 2.10 会话搜索：搜到的对话直接整理 {#s2-10}

左上角搜索框输入一句聊天里说过的话，下面会出现「内容匹配」，命中的字会高亮。**搜到的每一条，和普通会话行一样能操作：**

- 鼠标移上去，行尾有 ⇄（归到个人版 / 企业版）、📁（移到项目）、☆（置顶）、✕（删除）。
- **右键**（手机上**长按**）弹出菜单：置顶 · 重命名 · 移到项目 · 归到个人版 / 企业版 · 删除。
- **重命名**就在这一行里改，回车保存，不弹窗；改完搜索结果里马上是新名字。
- **删除不弹确认**，屏幕下方出现「已删除『…』 撤销」，**6 秒内点「撤销」就回来**；过了 6 秒才真正删掉（进回收站）。
- 置顶的排在「内容匹配」最前面，前面有 ★。

![会话搜索结果的右键菜单](manual_img/36_search_ops.webp)

### 2.11 思考内容在哪看 {#s2-11}

会思考的模型，想的过程**一律收进折叠的「💭 推理过程 · N 字符」**，不会混进正文。

- 每段思考结束（开始调用工具、开始写正文、思考太长被截断、回合结束）就自动收起；下一段思考另起一块。点一下展开。
- 「还在思考中」「思考过长」这类提示单独显示一行，不再插进思考或正文中间。
- 正文和思考里的 emoji 正常显示，不会变成乱码或问号。
- 看不看得到思考，由「展示设置」里的「思考 / 推理内容」决定（详细预设默认显示，标准和极简收在「▸ 查看过程」里）。

![思考内容收进折叠区](manual_img/39_think_fold.webp)

### 2.12 消息时间：几点说的、花了多久 {#s2-12}

![消息时间](manual_img/40_timestamps.webp)

- ①跨天自动加**日期分隔条**（「昨天」「今天」「10月24日 周六」）。②每条消息下方显示几点几分，**鼠标移上去看完整日期和时间**；同一分钟里连续的消息只显示一次。③助手回复后面带**开始时间和用时**，例如「00:04 · 用时 1m25s」。
- 老会话里没有真实时间的消息，只显示日期分隔，**不会编造几点几分**。
- 这些时间只用来显示，**不会发给模型**。

### 2.13 命令面板与快捷键 {#s2-13}

按 **Ctrl+K**（Mac 上是 **⌘+K**）打开命令面板，输入功能名回车直达；手机上点侧栏顶部的「🔍 搜索与跳转」。

![命令面板](manual_img/41_cmdk.webp)

①输入关键词（这里输入「任务」）；②匹配到的功能，回车打开；③底部是按键提示：↑↓ 选择、回车打开、Esc 关闭、`/` 在面板里搜索。能直达任务中心、定时器、日志、告警等。

**快捷键一览**

| 按键 | 作用 | 说明 |
|---|---|---|
| **Ctrl/⌘ + K** | 打开命令面板 | **3.2 起**；以前这个键是「切换工具结果全文」 |
| **Ctrl/⌘ + Shift + K** | 切换工具结果「截断 / 全文」 | **3.2 起改到这里**（原来是 Ctrl/⌘ + K） |
| `/` | 光标跳到输入框 | 打开了面板时，`/` 留给面板里的搜索 |
| Ctrl + L | 对话滚到最顶 | 只认 Ctrl，不认 ⌘ |
| Ctrl/⌘ + O | 展开 / 折叠思考内容 | |
| Ctrl/⌘ + V | 粘贴截图到输入框 | |
| Ctrl/⌘ + Z | 撤销一次自动优化 | 刚预填充完、还没改动输入框时有效 |
| **Alt + O** | 立即优化输入框里的话 | **3.2 新**，不用等停笔，见 [2.21](#s2-21)；Ctrl/⌘+O 是展开思考，别混 |
| Esc | 逐层关闭 | 一次关最上面一层：输入选项面板、命令面板、各种弹层，再按再关下一层；输入选项面板关闭后光标回到「⋯」 |

### 2.14 日志中心：出了问题在这里查 {#s2-14}

原来「最近错误」的入口，现在叫「**日志**」（也可以 Ctrl/⌘+K 后输入「日志」）。

![日志中心](manual_img/44_logs_filter.webp)

①「日志 / 工具统计」两个页签。②搜索框（消息、工具名、错误内容）、级别（图中是「警告及以上」）、时间范围（图中是「近 24 小时」）、「更多筛选」。③一键切换类型：错误、工具调用、子代理、审计、压缩，「回合追踪」把一次对话回合的记录串起来；「导出 CSV」（最多 5 万行）、「清除筛选」。

- 支持自动刷新、「还有更多」继续加载；点一条记录看详情。
- 日志按天轮转归档，在线保留天数由 `config.json` 的 `logs.keep_days` 决定（默认 14 天）。
- 企业版里普通成员只能看到自己的日志，管理员看得到全部。

![工具统计](manual_img/45_logs_tools.webp)

「工具统计」：①总调用、失败、失败率、工具数；②每个工具的调用次数、失败次数、失败率条、P50 和 P95 耗时；③最近一次失败的时间和原因，点「看日志」跳到那条记录。用量看板里的工具排行也加了「失败率」和「P95」两列。

### 2.15 告警、预算与今日摘要 {#s2-15}

侧栏的「🔔 告警」带未读角标。告警由后台定期评估这些规则产生：**任务失败、同类错误反复出现、工具失败率偏高、子代理异常结束、预算接近或用完、定时任务被自动暂停**。同一个问题合并成一条并累计次数，不会刷屏；问题消失一段时间后自动标为「已恢复」。

![告警详情](manual_img/47_alert_drawer.webp)

①级别、状态、规则、累计次数、首次和最近出现时间；②**处理建议**；③按钮：「确认」、「静音…」（选时长）、「转任务」（变成日历里的待办）、「查看日志」、「任务中心」。列表分「待处理 / 已确认 / 已静音 / 已恢复」四个页签。

**用量预算**（设置 →「用量预算」）：

![用量预算](manual_img/48_budget_card.webp)

- ①勾选「启用预算提醒」，选单位，填每日和每月预算。②「把自建模型的折算费用 / token 也计入」默认不勾：自建模型不实际花钱。
- 用到 80% 和 100% 时各出一条告警，并按近 7 天的日均花费估算「预计几点用完」。
- **只提醒，不会停任务。** 探索空间和定时任务各自的 token 预算是单个任务的上限，和这里互不影响。没定价的模型按灰色估算，不计入金额。

**今日卡片看板顶部的摘要条**：

![今日摘要](manual_img/46_today_summary.webp)

①今日完成、失败 / 中断、运行中、待处理告警、今日花费（云端，下面一行是自建折算）、今日预算进度。②告警会以卡片形式出现在今日里，带「查看日志」「任务中心」「用量看板」「处理告警」等按钮，可以直达。

> 注意：这里的「今日」是**今日卡片看板**（流水线、定时任务送来的结果卡片），不是日历里的「今日」。

### 2.16 费用与预算：云端和自建分开算 {#s2-16}

![用量看板的预算进度](manual_img/49_usage_cost.webp)

**做什么**：告诉你今天、本月花了多少钱、离预算还有多远，并把「真花钱的云端模型」和「自己机器上跑的模型」分开算，不混在一起吓人。

**怎么用**：

1. 打开「用量看板」（工具箱里，或 Ctrl/⌘+K 输入「用量」）。顶部是**今日 / 本月预算进度条**，写着已用、预算，以及按近 7 天日均估算「预计几点用完」。
2. 看总览卡里的两行：**「云端花费」是实际要付的钱**；**「自建折算」只是按等价价格估算的参考值，标注「不计费」**，默认不计入预算。
3. 右边的「改看 ¥」可以在美元和人民币之间切换。
4. 设预算：设置 → 常用 →「用量预算」，勾选「启用预算提醒」，选单位，填每日和每月预算（详见 [2.15](#s2-15)）。

![预算进度条与未定价](manual_img/58_cost_unpriced.webp)

①今日 / 本月预算进度；②云端花费与自建折算；③**未定价**的 token 单列；④改看 ¥。

**「未定价」是什么意思**：价目表里没有这个模型的价格，系统**不会悄悄当成 0 元**，而是把它的 token 数单独列出来、给一个估算值，**不计入上面的金额和预算**。你可以在价目表里补上价格，补完就会计入。

**常见问题**：

- 为什么「自建折算」不算进预算？自建模型不实际花钱，折算只是帮你比较。想算进去，在预算设置里勾「把自建模型的折算费用 / token 也计入」。
- 预算用完了任务会停吗？**不会**，只提醒：用到 80% 和 100% 各出一条告警。
- 金额对不上账单？这里是按价目表和 token 数算的估算，以服务商账单为准；价目表可以自己改。
- 成员能看到别人的用量吗？成员只看自己的；预算设置在管理员（个人版就是你自己）名下。

**小提示**：「未定价」不为 0 才有意义——看到它先补价目；探索空间和定时任务各有自己的 token 上限，和这里的预算互不影响。

### 2.17 AI 怎么理解你的请求：意图识别与多角度分析 {#s2-17}

自动进行，不用设置。

- **复杂的请求**，AI 会先理清你要的结果、成功标准和没明说的要求；有歧义但能做的，先说明它的假设再动手；找不到你指的是哪个文件，会先问你。
- **需要比较、判断的问题**，会从多个角度分析，不只给一种答案。
- **简单问题**仍然直接回答，不绕弯；同一个对话里这段提示只加一次。
- 我们做过一次内部离线对比（21 条请求）：「明说假设」「多角度分析」的比例明显上升。样本很小、判分是关键词规则，**只能看趋势**，不代表每次都这样。

### 2.18 重点搜索与排障 {#s2-18}

对话里说「**重点搜索**」「深挖」「查清楚」，或者直接贴一段报错，AI 会走这两个技能：

- **重点搜索**：把问题拆成 3 到 6 条互补的查询，按来源等级（官方文档和源码 > 官方博客 > 高赞问答 > 其它）排序去重，抓取靠前的来源并只抽取相关片段，返回「证据片段 + 来源链接 + 日期 + 可信度」。抓不到网页正文时退回搜索摘要并注明；多轮搜索有预算。「可信度」只表示独立来源够不够多、有没有一手来源，**不代表结论一定正确**。
- **排障闭环**：复现 → 定位 → 提 2 到 3 个假设按成本排序验证 → 最小修复 → 回归 → 总结根因。**同一个错误失败两次，必须换思路或先搜索**，不再原样重试第三次。
- 另附代码定位小助手：找定义和引用、按报错栈定位到文件行、看文件最近改动和相关测试。

### 2.19 长任务更稳：你能感觉到的变化 {#s2-19}

- 对话太长、上游报「上下文超限」时，会逐级瘦身请求（去掉旧图片、截短过长的工具结果）再重试，不再把整段会话丢掉。
- 只思考、不产出的空转，超过 4 分钟就停下来善后（配置项 `agent.think_idle_cap_seconds`，默认 240 秒）。
- 合法的轮询（sleep 加 tail 看进度）不再被当成死循环；真正重复的调用才拦截。
- **子代理**：按「有没有真进展」决定要不要续跑；强停、手动停止、迭代用完、超时各自如实标注（不再一律「已完成」）；迭代用完或超时会带回已收集的资料并标「部分完成」；同一目标重复派发会被拦下；产物有清单，汇报分「结论 / 证据 / 产物」。
- 子代理面板在 3.2.1 里整理过：只显示运行中和最近 2 小时的，已结束的可以清除，见 [2.25](#s2-25)。
- **记忆**：压缩完成就写盘；校验缺段时补段而不是整份丢弃；你自己的指令不再被误标成「外部内容」；垃圾记忆会被过滤；召回加了关键词索引。
- 定时任务重启后按设置**补跑一次**；连续失败会自动暂停并出告警。

### 2.20 输入选项面板：把常用开关收进「⋯」 {#s2-20}

![输入选项面板](manual_img/52_composer_panel.webp)

**做什么**：输入框默认只留 📎 附件、🎤 语音、🤖 模型、「⋯」和发送键，不再被一排小按钮挤满；思考强度、展示模式、自动执行、推演这些都收进「⋯ 输入选项」。图上半是默认折叠的输入框，下半是展开的面板。

**怎么用**：

1. **展开 / 折叠**：点输入框里的「⋯」展开面板；再点一次、点面板外面、或按 **Esc** 收起（收起后光标回到「⋯」）。键盘上：回车打开，↑↓ 逐项移动，←/→ 在分段选择器里切档。
2. **选思考强度和展示模式**：这两项是分段选择器，直接点某一档。思考强度只显示当前模型真正支持的档位（有的模型只有「关 / 开」）；展示模式是「极简 / 标准 / 详细」（含义见 [2.6](#s2-6)）。改完立刻生效，只影响当前对话。
3. **开关类**：「自动执行」「权谋推演」是开关，点一下切换。「本会话模型」点开后进入原来的模型选择卡。
4. **固定常用项**：每项右边有个图钉，点它就固定到输入框的工具栏上（电脑宽屏最多 4 个，中等宽度最多 2 个，手机不固定）。
5. **恢复默认**：面板底部的「恢复默认布局」会取消所有固定项；它**不会**改你的思考强度、展示模式等设置。
6. **看当前状态**：「⋯」右上有个小圆点，说明有非默认设置（自动执行关、思考自设、展示非标准、推演开）；鼠标悬停（手机长按）能看到一行摘要，例如「⚡手动确认 · 🧠开 · 👁详细」。

![手机上的输入选项](manual_img/53_composer_mobile.webp)

**手机上**：点「⋯」，面板从屏幕底部升起，是一个抽屉；每一组（模型、思考与推演、执行与展示、工具与技能）都可以点标题折叠，点按区域加大。关闭：点抽屉外的遮罩。手机上不支持把项固定到工具栏。

**常见问题**：

- 之前输入框上的 ⚡ / 🧠 / 🎭 按钮不见了？都在「⋯」里，没有少。
- 找不到「自动」「✨优化」这类后来加的按钮？工具条放不下时，它们同样会收进「⋯」面板。
- 固定的项换了电脑就没了？固定项记在当前浏览器里，换浏览器、换设备或清了站点数据都要重新固定。
- 手机抽屉能往下拖着关吗？暂时不能，点遮罩或按返回。

**小提示**：每天都要切的那一两项（比如展示模式）固定到工具栏，其余留在面板里，输入框最清爽。

### 2.21 自动优化提示词：停笔后帮你把话说清楚 {#s2-21}

![优化提示词](manual_img/54_prompt_prefill.webp)

**做什么**：你随手打的话常常缺对象、缺要求（「把刚才那份表格里华东的数据拿出来」）。打完字停笔，系统会**结合本会话的上下文**，把它补全成更明确的版本，**直接填进输入框，由你检查后自己发送**。**它不会自动发送，也不会在你点发送时偷偷替换你的话。**

**怎么用**：

1. **触发**：在输入框里打完字，停下约 1.8 秒（输入法还在组字时不算停笔），输入框里的话会被换成优化版，上方出现提示栏：「✨ 已按上下文优化 · 撤销 · 查看改动 · 重新优化」。
2. **撤销**：点「撤销」或按 Ctrl/⌘+Z，恢复你的原话。
3. **查看改动**：点「查看改动」，左边是「你的原话」，右边是「优化后」，下面写着「改了什么」。**3.2.1 起，右边「优化后」里系统替你新增的片段会有淡色底和「新增」标记，你的原话不加底色**，一眼就能分清哪些是你说的、哪些是系统补的（见下图）。底下可以选强度「轻 / 标准 / 深度」，点「用此强度重新优化」重来，或点「追加到输入框」把优化版接在原有内容后面。
4. **立即优化**：不想等停笔，按 **Alt+O**（或点工具条上的「✨优化」）。立即优化不受下面「不触发」规则的限制。
![查看改动：新增片段高亮](manual_img/69_prompt_diff.webp)

5. **输入框是空的时**：会出现几个「你接下来可能想问」的建议胶囊（如下图），点一下就填入输入框。

![建议胶囊](manual_img/55_prompt_suggest.webp)

6. **关闭**：设置 → 常用 →「自动优化提示词（预填充）」是全局开关；输入框工具条上的「自动」小开关只关 / 开**当前这个会话**（先发一条消息才能单独设置本会话）。
7. **这一句想原样发**：话以 `!` 或「原样:」开头，就不会被优化。

**什么时候不触发**：输入太短（不足 2 个字）或太长（超过 800 字）；粘贴的日志、代码、大段内容；「好的」「谢谢」「继续」这类简短回应（「继续」在有上下文时例外）；以 `/` 开头的斜杠命令；已经写清对象、要求和交付物的长指令；普通提问；只带附件没有文字；任务正在运行时；还没停笔时。

**常见问题**：

- 为什么有时没反应？可能被上面的规则跳过；也可能模型 3 秒内没返回，系统会**静默放弃**，什么都不改。
- 它会改成我没说过的东西吗？**会，编造率不为零。** 内部小样本评测里出现过编造，例如把助手的建议写成你「已经做过」的事。所以**采用前请看一眼**，不对就撤销，或加 `!` 原样发。缺的关键信息它会写成「请确认」，而不是替你猜。
- 我的密钥、口令会被送出去吗？送给模型前会先脱敏；它只读取本会话的上下文。
- 管理员看别人的会话时能用吗？只读视图里不能编辑，也不会触发。
- 用量怎么算？每次优化都会走模型，记在用量账本里，来源标为「优化提示词」。

**小提示**：觉得老被打扰，就在设置里关掉，只在需要时按 Alt+O；写长指令时直接写清「做什么、给谁看、要什么格式」，系统会自动跳过。

### 2.22 交付物自动出卡：视频、PDF、压缩包直接预览下载（3.2.1） {#s2-22}

![自动补出的三张交付物卡](manual_img/60_deliver_cards.webp)

**在哪里看到**：对话里，助手这一条回复的下面。

**做什么**：助手做完事，最后常常只写一句「成品放在 out/某某/ 目录里」，或者真正的文件路径只出现在中间的操作步骤里。过去这样就没有卡片；3.2.1 起，系统会在这条回复渲染完后，自动找出这一轮产出的交付类文件，在回复下面补出文件卡。

**怎么用**：不用设置。看到卡片后，用卡片上的三个按钮：

1. **预览**：在页面里直接看（视频播放、PDF / Office 转成图片）。
2. **预览 ↗**：在新标签页打开。
3. **↓ 下载**：下载到本机。

**哪些文件会出卡**：

- 类型：视频（mp4、mov、webm、mkv）、文档（pdf、docx、pptx、xlsx 等）、压缩包（zip、7z、tar、gz 等）、图片、音频。网页、Markdown、表格数据、代码文件不在这里补卡，它们走原来的卡片逻辑。
- 数量：一次最多 12 张；超过 6 张先折叠，点「展开其余 N 个文件」；被挡掉的会提示「另有 N 个未列出」。
- 同名同大小的重复文件只留一份。

**哪些不会出卡（安全）**：只会列出你自己有权看的文件，和预览下载走同一套权限检查；私钥、配置、令牌这类敏感文件、空文件、隐藏文件、过程和缓存目录里的文件都不出卡；企业模式下成员只能看到自己范围内的文件。

**已知局限**（以下是现在真实存在的行为）：

- 用保留旧修改时间的方式拷贝的文件（如 `cp -p`），可能被当成旧文件而漏掉；
- 回合结束之后才写完的后台文件、别的机器（远程）上的文件，看不到；
- 压缩包和包里同名的文件，可能各出一张；
- 卡片排序没有「成品 / 中间产物」的概念。

### 2.23 长任务进度条与状态胶囊（3.2.1） {#s2-23}

![渲染视频时的进度胶囊](manual_img/61_progress_pill.webp)

**在哪里看到**：渲染视频这类要跑几分钟的工具运行时——极简档在输入框上方的胶囊里；标准档和详细档在对话里该工具那一行，以及折叠头里。

**怎么看**：胶囊拼成一行：**动作 · 进度 · 已用时**，例如「正在渲染视频 · 61% · 已 1:05」，右边是进度条和「停止」。

- **进度百分比**由工具自己上报（渲染视频上报的是「第 n/N 帧」）。**只有拿到真实百分比才显示数字**；没有进度数据的任务，只显示一条流动的进度条和已用时间，**不编造、不估算**。
- 工具一结束，进度条就收起。
- 20 秒没有任何新进展，动作那段会换成「还在处理，已 N 秒」，此时不再写百分比，并出现「查看过程」（见 [2.24](#s2-24)）。

**局限**：手机窄屏上，较长的提示（如「还在处理，已 N 秒」）可能被截成省略号，点开仍能看全；百分比准不准取决于各工具自己上报的进度。

### 2.24 展示三档增强：极简 / 标准 / 详细（3.2.1） {#s2-24}

![同一条回复的三档对比](manual_img/62_modes_compare.webp)

**在哪里切档**：

- 全局：设置 → 常用 →「展示设置」，选「极简 / 标准 / 详细」，按账号保存，换设备也一样；
- 只改当前对话：输入框右下的「⋯」面板里的「展示模式」（选「跟随默认」可撤销）。

**默认仍是「标准」**，3.2.1 没有改默认值。

**三档现在各是什么样**：

| 档 | 你看到 |
|---|---|
| 极简 | 正文和结果卡片。过程收起；任务出错时，回复上方有红字「N 步出错 · 查看过程」。运行中输入框上方有状态胶囊（见 [2.23](#s2-23)）。 |
| 标准 | 一行一个动作的摘要；连续的同类动作合并成一句人话，如「读取了 12 个文件」「运行了 5 条命令」「搜索了 3 次」，点一下展开每一条。 |
| 详细 | 每次工具调用都展开，含命令输出、思考和用量。 |

![标准档：合并行展开，失败单独标红](manual_img/63_modes_merged.webp)

**失败怎么显示**：失败的那一次**不合并**，单独一行并标红；前后的成功动作也不会越过它合并。例如 12 次成功读取 → 1 次失败 → 1 次成功读取，显示为三行。

**极简档的「查看过程」**：当某条正在进行的回复出现失败，或超过 20 秒没有新进展，输入框上方的胶囊上会出现「查看过程」。点一下，**只展开这一条回复**的动作摘要，按钮变成「收起过程」；**不会改你的档位**，下一条回复仍是极简。

![手机上的三种显示](manual_img/64_modes_mobile.webp)

**手机上**：同样三档；窄屏胶囊里放不下的长提示会被截成省略号。

**局限**：

- 极简档默认不展开过程；
- 回复结束之后，想看失败详情，用回复上方红色的「N 步出错 · 查看过程」条（它和运行中的「查看过程」是两个入口）；
- 设置页「恢复默认」会清掉你保存的展示偏好，各对话里临时选的档位不受影响。

### 2.25 子代理面板：只看正在做的，已结束的可以清除（3.2.1） {#s2-25}

![子代理面板](manual_img/65_subagent_panel.webp)

**在哪里看到**：对话输入框上方的「子代理」条（例如「运行中 1 · 已结束 7」），点开是面板。

**面板显示规则**：

- 主区：**所有运行中的**，加上**最近 2 小时内结束的**；
- 底部折叠条「更早的 N 条（已折叠）」：结束时间早于 2 小时的，点一下展开 / 收起；运行中的永远在主区。

**服务重启之后**：重启前遗留的「运行中」记录，现在会标成「已中断（服务重启）」，灰显、不转圈，并注明「服务重启前的记录 · 已结束」。注意这只是记录被标成已结束——那个子代理重启时本来就已经停了，不会自动续跑。

**怎么清除**：

1. 点头部的「**清除已结束**」，面板里会先出现一条确认：「清除本会话 N 条已结束记录？运行中的不受影响，任务中心里的历史运行记录与日志保留。」点「确认清除」才动手，点「取消」放弃。
2. 只想去掉某一条，点它上面的「**移除**」。运行中的子代理没有「移除」，要先「停止」。

![点清除已结束先确认](manual_img/66_subagent_clear.webp)

清除只影响**本会话**，**永久**生效（没有回收站）；任务中心里的运行记录和日志不受影响，还能从那里追溯。

![手机上的子代理面板](manual_img/67_subagent_mobile.webp)

**局限**：系统对已结束记录本来就只保留一段时间（已取走结果的约 1 小时，没取走结果的后台子代理约 24 小时），所以「更早的」折叠区里通常装得不多；3.2.1 没有把保留时间变长。

### 2.26 优化提示词：查看改动里高亮新增内容（3.2.1） {#s2-26}

用法见 [2.21](#s2-21)。3.2.1 的变化只有一处：点「查看改动」后，右边「优化后」里**系统替你新增的片段**有淡色底和「新增」标记，你原来的话不加底色；左边仍是你的原话。仍然**只预填充、不自动发送**，编造率不为零，采用前请看一眼，不对就撤销。

### 2.27 价目核对进任务中心（3.2.1） {#s2-27}

![任务中心里的价目核验](manual_img/68_task_pricing.webp)

**在哪里看到**：工具箱 →「任务」。模型价目的核对（在用量看板里手动点，或按周期自动跑）现在和别的任务一样，作为一行出现，类型叫「价目核验」，带 $ 图标；「筛选」里可以按类型选出来。

**怎么用**：点这一行的「查看核对结果」，直接跳到用量看板的「价目与核对」弹窗。核对的具体结果和说明仍在那里看；任务中心只是让它不再悄悄跑完。

<!-- 3.2-PENDING: 会话知识库 -->

---

## 3. 能力卡与公共域 / 私人域 {#s3}

### 3.1 什么是能力卡 {#s3-1}

**模型负责「想」，能力卡负责「手脚」。** 想让它能画图、做视频、配音、识别语音、上网搜索、发通知、存文件，就接一张对应的卡。

**一张卡 = 一个名字 + 一段大白话**。这段话写三样：①这服务是干什么的 ②Key（密钥） ③一条能跑通的调用示例。它读了就会用。

### 3.2 怎么添加 {#s3-2}

入口：左上角「🔌 能力接入」。

![能力接入](manual_img/10_prov_cards.webp)

①「能力卡」页签 ②按「公共 / 我的私有」筛选 ③「＋ 新增」。左边按类型分组：生图、生视频、语音合成、语音识别、音乐、搜索、通知、对象存储……带 ✅ 的是已经通了的；🟡 是地址通但 Key 没验证；⚪ 是还没测试通过。

三种加法，选一种：

1. **用预设**：点「＋ 新增」→ 选一个常用服务 → 按提示把 Key 贴进去 →「测试并保存」。
2. **自己写**：「其他服务（自己写）」→ 把那段大白话贴进去 →「测试并保存」。
3. **一句话**：直接在对话里说「帮我接入这个搜索：文档……，key 是……」，它自己写卡、测试、告诉你通没通。

保存后系统会：自动识别类型 → 真测一次 → 同一类第一张卡自动当默认 → 对话里自动用上。想点名用某一张，在输入框打 `@` 选卡。

> Key 只存在服务端，界面上不会被模型看到，回复里也不会复述完整的 Key。**不要把带 Key 的截图发给别人。**

### 3.3 公共域和私人域 {#s3-3}

每张卡（和每个资源）都有一个「域」：

| | 公共域 🌐 | 私人域 🔒 |
|---|---|---|
| 谁登记 | 管理员 | 用户自己 |
| 谁能用 | 所有人（使用者看不到 Key） | **只有本人**，以及本人的对话、流水线、定时任务；企业模式下别人看不到这张卡，管理员在界面里也看不到 |
| 典型用法 | 团队共用的搜索卡、生图卡、**只读**的业务查询 | 个人账号的邮箱、**带写权限**的业务系统 |

规则：

- 同名时**私人域优先**，调用结果里会写明用的是哪个域。
- 对话里「一句话新建」的卡，默认进私人域；管理员可以改成公共。
- 流水线和定时任务以**创建者**的身份运行，所以能用创建者的私人卡。把流水线分享给别人，别人运行时用的是**他自己**的私人卡，缺卡会提示「缺少资源，请先在能力接入里接入」，不会泄露你的 Key。
- **个人模式下没有「别人」**，域只是个标签，不限制。

**个人版 / 企业版分开放**：新建的资源、能力卡会记下属于哪个版本，另一版本里看不到（老数据和内置的演示资源两边都能看到）；企业版的记忆也单独一份，从空开始，不和个人版混。课题、定时任务、今日卡片、日历（日程 / 待办 / 习惯）、流水线、资源，每条记录上都有「⇄」，点开选「归到个人版」或「归到企业版」，只改归类，不动内容和归属。想对照时打开侧栏的「显示另一版本」（各面板顶部也有同样的小开关），另一版本的条目变淡、带徽标、只读。

![归到个人版 / 企业版](manual_img/38_edition_menu.webp)

---

## 4. 业务数据怎么接入 {#s4}

### 4.1 这是干什么的 {#s4-1}

你公司有报价系统、仓库系统、数据库，想让 AI 直接查、直接算、直接出报表，甚至帮你建单据。办法：把它们登记成「**资源**」。

**资源和能力卡的区别**：能力卡是「调一个服务」；资源是「读一堆数据、或改业务数据」，而且**只能按你登记好的模板访问**，AI 不能自己手写命令。

入口：「🔌 能力接入」→「资源 · 数据 · 业务系统」页签。

![资源列表](manual_img/11_res_list.webp)

①资源页签 ②公共域里的只读业务系统（黄金期货行情、WMS 库存查询、报价查询、业务库 MySQL 只读，都是内置的仿真业务系统）。最上面「演示资源」是内置的虚拟数据，不联网、不需要账号，可以拿来练手。

### 4.2 三步接入 {#s4-2}

支持的类型：邮箱（IMAP）、对象存储（S3 / OSS / COS）、本机目录 / NAS、服务器（SSH 只读命令）、HTTP 只读接口，以及 3.0.0 新增的 **业务 HTTP 接口** 和 **MySQL 数据库**。

![新增资源](manual_img/12_res_new.webp)

**第一步：选类型。** ①点「业务 HTTP 接口」或「MySQL 数据库」。

**第二步：填信息。** 名称、地址、凭据，再填**范围**：

- 业务接口：填「允许的路径前缀」和「端点清单」（每个端点写清 id、方法、路径、中文标题、参数说明）。
- MySQL：填数据库账号（**建议用只读账号**）、口令、「可读的表」（每行一个）。要让 AI 能改数据，另填「可写的表」，并勾选「允许写操作」。
- 范围必须写清楚，**AI 读不出这个范围**。②选「私有」还是「公共」：只读的放公共，可写的放私有。

**第三步：保存并测试。** ③点「保存并测试」，系统会真连一次，通了显示 ✅。

> 登记业务接口和 MySQL 要用服务器自己的网络身份去连，所以**只有管理员能登记**这两类。个人模式下你就是管理员。
> 凭据只存在服务端，AI 看不到，日志里会打码。

登记好以后，点开资源能看到它「可用模板」，以及能「试一试」。

![资源详情](manual_img/13_res_detail.webp)

①这个资源是私有域、可写（标 L4）；②AI 只能在这些模板里选，不能自己写命令。写操作（下单、建单、提交、入出库、改库）只能走「写模板」，属于 L4 外部动作。

### 4.3 对话里怎么用 {#s4-3}

直接用人话问，不用提资源名也行（它会自己找）。下面是在内置仿真业务系统上的实测结果（耗时用的是默认模型，你的网速和模型不同，时间会有差别）：

| 你说 | 它做了什么 | 耗时与结果 |
|---|---|---|
| 「AU 主力合约现在价格多少，我的持仓浮动盈亏多少」 | 查行情、持仓、账户，算浮盈 | 约 18 秒，数字与系统接口一致 |
| 「限价下 1 手 AU 主力多单，比现价低 2 元」，接着「把刚才这笔委托撤单」 | 下单（挂单）、再撤单 | 约 22 秒 + 14 秒；个人模式没弹确认，审计里有记录 |
| 「查 WMS 里低于安全库存的 SKU，按缺口从大到小列表」 | 调库存预警接口，排序成表 | 约 18 秒，13 条与接口逐项一致 |
| 「用 MySQL 统计上个月各部门销售额并画柱状图」 | 写聚合 SQL，出表和图 | 约 74 秒，各部门金额与直接查库一致 |
| 「给客户 北京海淀云计算服务有限公司 生成一份报价单并提交审批」 | 先试算，再建单，再提交；三步都是写操作 | 约 3 分钟，建出待审批单，毛利都高于下限 |
| 「从 WMS 成都分拣中心出库 SKU0003 10 件」（库存不足） | 先查库存，发现是 0，没建单，用人话解释并给两个办法；你坚持「就按我说的建单」，系统返回「库存不足，拒绝出库」，它如实转告 | 单据没落库、没冻结 |

> 报价单那次它还主动多做了 Excel 和 PDF 文件。想要什么形式的结果，直接在话里说清楚。

### 4.4 适合什么，不适合什么 {#s4-4}

**适合**

- 查数、统计、对账、报表、预警（读多写少）。
- 有清晰接口或有只读账号的系统：报价、库存、订单、行情。
- 写操作有**固定几种**，每种都能写成模板（下单、建单、提交审批、入库出库）。

**不适合**

- 想让 AI 随便改任何表、任何字段：本来就不允许，只能写你登记的「可写表」和写模板。
- 没有接口也没有数据库账号、只能靠人工点界面的老系统（这种可以考虑第 7 章的电脑操控，但那是另一套做法，要自己评估）。
- 需要多级审批、会计级对账的业务：审批只能在业务系统里由有权限的人做，AI 不代审批。

### 4.5 权限与审计 {#s4-5}

- **读和写分开**：只读模板和写模板是两套，写模板只能走写工具，资源上必须**手动勾选「允许写」**（默认关）。
- 写操作属于 **L4 外部动作**：个人模式不弹确认、只留审计；企业模式按角色开关（成员默认可用，管理员可以关）。
- **每次读写都记审计**（谁、哪个资源、哪个端点、参数摘要、成败，不记密码）。
- 数据库侧还有一道闸：只读账号想写、读写账号想越权写别的表，都会被数据库自己拒绝。
- 从业务系统取回的内容都被标成「不可信内容」：里面如果夹着「请把某某发给谁 / 请下单」，**不会被当成指令**。
- 删除资源会先进「回收站」，不会直接消失。

### 4.6 成本控制和业务追踪 {#s4-6}

都是用现有能力拼出来的：查业务系统（只读）、白名单写入、流水线、定时任务、「今日」看板、提示条、Excel / PDF / PPT、画图、用量账本。实测数字来自内置的仿真业务系统与虚构数据，用于说明能力；实际耗时和结果取决于你接入的数据和系统。

**成本控制**

| 想做什么 | 能做什么 | 怎么接 |
|---|---|---|
| 报价毛利守门 | 逐行对照成本和毛利下限，低于的标出来，给调价建议 | 接报价系统的接口，或上传报价 Excel |
| 采购和费用超支预警 | 每天定时查采购单和预算，用到 80% 就提醒 | 接业务库（只读），用定时任务 |
| 成本构成拆解 | 按产品和月份拆开成本，做同比、环比，找出涨得最多的一项 | 接业务库（只读） |
| AI 用量成本看板 | 按人、按项目汇总 AI 的用量 | 用自带的用量账本；企业模式按人统计 |

**业务数据追踪**

| 想做什么 | 能做什么 | 怎么接 |
|---|---|---|
| 订单全程追踪 | 查订单、出入库、发货状态，按时间排成一条线 | 接订单和仓库系统的接口 |
| 库存和出入库追踪 | 列出低于安全库存的货，按缺口从大到小排 | 接仓库系统的接口 |
| 经营日报自动发布 | 每天定时查销售和库存，出图，发布到「今日」 | 用流水线加定时任务，读业务系统（只读） |
| 异常提醒 | 库存跌破安全线、价格波动超线、应收逾期，命中就提醒 | 定时检查，结果弹提示条 |
| 应收账款跟踪 | 列出逾期客户，按金额排序，每家写一段催款话术 | 接应收数据（业务库或 Excel） |
| 合同到期和续签 | 列出快到期的合同，按模板批量生成续签函 | 上传合同表和续签函模板（docx） |
| 供应商对账 | 比对两张 Excel，列出金额或数量不一致的行 | 上传两张表 |
| 工单和服务时效追踪 | 汇总工单，统计处理时长，列出超时的 | 上传工单表，或接工单系统 |

- 写操作（比如提交报价单）只在白名单模板里做，每次都记审计。
- 提醒类的需求，先做成定时任务，再看「今日」和提示条有没有按时出现。
- 数字（金额、条数、耗时）以你接入的数据为准，AI 给的结论请抽查一两条对原系统。

### 4.7 适合学校、培训机构、中小公司 {#s4-7}

读上传的 Excel / Word、接入的业务系统、定时任务、「今日」看板、文书与 PPT 生成，都是现有能力。实测数字来自内置的仿真业务系统与虚构数据，用于说明能力；实际耗时和结果取决于你接入的数据和系统。涉及学生、客户的名单，请只在你自己的机器里处理，抽查几条再发出去。

**学校**

| 想做什么 | 能做什么 | 怎么接 |
|---|---|---|
| 备课与课件 | 按课题一句话出 PPT 和教案，可编辑，页面里直接预览 | 直接在对话里说课题和课时 |
| 出题与组卷 | 按年级和难度出题，排成试卷，附答案页 | 在对话里说年级、科目、题量 |
| 成绩与学情汇总 | 读成绩表，按班级算均分，画分数段分布图 | 上传成绩 Excel |
| 家校通知批量生成 | 按名单和模板，一人一份通知，名字和班级不串 | 上传名单和通知模板 |
| 课表与考勤汇总 | 读考勤表，按班级汇总异常人次，列出前几名 | 上传考勤表 |
| 校内报修与工单追踪 | 汇总报修工单，标出超过时限的 | 上传报修表，或接报修系统 |
| 校规制度问答 | 在手册里找条款，说明出自哪一章哪一条 | 上传手册（Word），或放进知识库 |
| 作业识图和批注建议 | 识图读出作业内容，列出可能的错处和批注建议 | 上传作业照片 |

**培训机构**

| 想做什么 | 能做什么 | 怎么接 |
|---|---|---|
| 招生线索跟进与转化漏斗 | 按阶段统计线索、试听、报名，画漏斗图 | 上传线索表，或接 CRM / 数据库 |
| 试听预约提醒 | 试听前一天，提醒老师和家长 | 用定时任务查预约表 |
| 报名缴费对账 | 比对报名表和收款流水，列出对不上的 | 上传两张表 |
| 课消与续费提醒 | 定时检查剩余课时，不足的列清单，写好提醒话术 | 接学员数据（数据库或 Excel） |
| 学员成长报告批量生成 | 按成绩和出勤表，一人一份成长报告，打成 zip | 上传成绩表和报告模板 |
| 教师课时与课酬核算 | 读排课表，按课时单价算课酬，出汇总表 | 上传排课表和单价表 |
| 课表排期与教室占用检查 | 找出同一时间同一教室的冲突 | 上传排课表 |
| 校区经营日报 | 每天定时查各校区的报名、收费、课消，出图发布到「今日」 | 用流水线加定时任务，读业务系统（只读） |

**中小公司（含销售管理）**

| 想做什么 | 能做什么 | 怎么接 |
|---|---|---|
| 报价单一句话生成并提交审批 | 先试算，再建单、提交，回读核对 | 接报价系统的接口（只读试算，白名单写入） |
| 客户线索池与跟进提醒 | 按阶段整理线索，到期的客户每天提醒，附一句开场话 | 接 CRM、数据库，或上传客户表 |
| 销售漏斗与业绩排行 | 查订单和线索，按人、按阶段汇总，出图 | 接订单库或上传 Excel |
| 报价、订单、回款一条线 | 把报价、订单、回款三张表串起来，统计转化和回款进度 | 接 ERP 或数据库，或上传三张表 |
| 回款与应收跟踪 | 列出逾期客户，按金额排序，写好催款话术 | 接应收数据 |
| 库存预警与出入库追踪 | 列出低于安全库存的货，按缺口从大到小排 | 接仓库系统的接口 |
| 合同到期与批量续签 | 列出快到期的合同，按模板批量出续签函 | 上传合同表和续签函模板 |
| 经营日报、周报、月报自动发布 | 每天定时查销售和库存，出图、汇总，发布到「今日」 | 用流水线加定时任务 |

销售管理这一块，接入你现有的 CRM、ERP、Excel 或数据库就行：客户线索、跟进提醒、销售漏斗、业绩排行、报价、订单、回款一条线，一句话查、一句话出报表。写操作（比如提交报价单）只在白名单模板里做，每次都记审计。

---

## 5. 流水线（DAG）与定时任务 {#s5}

### 5.1 流水线是什么 {#s5-1}

**把一件要反复做的事，拆成几个步骤，存下来，以后一点就跑。** 每次跑一次叫一个 **Build**（构建），能看到每一步的输入、输出、耗时和失败原因。（心里把它当成「AI 版的自动化流水线」就行。）

### 5.2 一句话生成 {#s5-2}

**怎么点**：工具箱 →「DAG 编排」→「＋ 新 Pipeline」→ 在「用自然语言生成」里写需求 →「生成」。

![一句话生成](manual_img/14_dag_gen.webp)

我们用的需求原话：

> 每天 9 点：WMS 库存预警 + 报价毛利低于下限检查 + 期货持仓风险摘要，输出表格与卡片并发布到今日

**会看到什么**：十几秒内生成一张图，每个方块是一步。这次生成了 9 步：5 个「取数」步（直接调接进来的业务系统）+ 3 个「分析」步 + 1 个「汇总成晨报」步。

![生成的流水线](manual_img/15_dag_editor.webp)

①节点图 ②「💾 保存」 ③「▶ Build」。点「🧪 检查」可以先检查有没有写错。

> 同一句话每次生成的步骤数和写法可能不一样（它是 AI 现想的），**生成后请看一眼节点图再保存**。

### 5.3 运行和 Build 历史 {#s5-3}

点「▶ Build」就开始跑，约 40 秒。跑完是这样：

![Build 页](manual_img/16_build_done.webp)

①状态：9/9 完成，用时 42 秒 ②勾选「发布到今日」③左边每一步的耗时 ④右边「最终结果」按类型渲染——文字、表格（点表头排序）、图表、卡片、网页、图片、音频、视频、文件都行。

**看以前跑过的**：流水线列表里点「🕘 历史」，每次 Build 一行，点进去就是上面那个页面。

![Build 历史](manual_img/17_dag_hist.webp)

- 失败的 Build **不会**自动发布到今日；手动发布时会让你确认，并标上「失败」。
- 想中途停：Build 页右上「⊘ 中止」。
- 在聊天里说「跑一下日报流水线」也行，聊天里会逐个显示节点、缩进显示子流程，完成后直接渲染最终结果。

### 5.4 发布到今日 {#s5-4}

- 在 Build 页勾选「发布到今日」，选**可见范围**（仅自己 / 指定角色 / 全团队）；也可以对某一次运行点「把本次结果发到今日」手动发。
- 结果出现在左上「☀️ 今日」：

![今日卡片](manual_img/18_today.webp)

①卡片 ②「展开」看全文 ③「接着聊」把这张卡带回对话继续问。

手机上的样子：

![手机今日](manual_img/28_m_today.webp)

> 注意：卡片上的「🚫」是「**不再推送这类**」，点了以后同一来源不再出卡片（可以在底部恢复），别当成「删除这张卡」去点。

### 5.5 定时任务 {#s5-5}

**我想让它每天自动跑一次。** 工具箱 →「定时任务」→「＋ 新建」，选**周期（cron）**或**单次**，填时间，动作选「流水线」并选你存好的那条。

![定时任务](manual_img/26_timer.webp)

常用时间写法：

| 写法 | 意思 |
|---|---|
| `*/5 * * * *` | 每 5 分钟 |
| `0 9 * * *` | 每天 9:00 |
| `0 9 * * 1-5` | 工作日 9:00 |
| `0 0 1 * *` | 每月 1 号 0:00 |

每个任务可以：▶ 立即执行、⏸ 暂停、🗑 删除，点进去看历史。例如：新建一条 `0 9 * * *` 指向流水线，点「▶ 执行」，约 32 秒跑完，结果也发到了今日，定时历史里有记录。

**要知道的几件事**

- 服务器版：电脑关了定时任务也照跑。Windows 个人版：电脑得开着。
- 定时任务和流水线**以创建人的身份运行**。创建人被停用、删除、降级后，流水线会自动暂停并告诉你原因（不会偷偷用管理员身份跑）。
- 企业模式下，成员能不能建流水线和定时任务，由管理员在权限里决定（默认可以）。

**做完自己停**：新建或编辑时可以填「最多次数」「截止时间」，也可以在对话里说清楚「下载完就停」——关联的任务全部完成、或 AI 判断这件事已经做完，定时任务会自动停用。轮询类的 AI 定时任务如果什么都没设，**默认最多 48 次、24 小时**，不会一直跑下去。停了以后，定时任务面板和今日卡片上都写着「已自动停止：原因」；想再跑，点「重新启用」，次数从头算。

**今日里只留一张卡**：同一个定时任务当天每跑一次，都在同一张卡上原地更新，卡上写着「第 N 次运行 · 更新于几点」，前几次的结果收在下面的历史里，可以收起或删除，不会一跑就多一张。

![今日里的定时任务卡片](manual_img/37_timer_today.webp)

---

## 6. 探索空间 {#s6}

### 6.1 它是什么 {#s6-1}

**探索空间 = 一个沙盒。** 你给一个主题和目标，它就自己一回合一回合往下做：查资料、读数据、算、写，最后给出结论和一份网页报告。你不用盯着，也不用一句句催。

沙盒的意思是：**你这个账号有权限用的东西，它都能用**——能力卡、业务资源、工具、技能、音乐 / 生图 / 语音、知识库等等。你没有权限的，它也用不了。

它做出来的网页也一样能用。网页里带一个平台桥 `window.LC`（列出能力 `list`、调用 `call`、对话 `chat`、写歌 `music`、画图 `diagram`），点一下按钮就能真的去生成：按课题主人的身份调用，权限、限流、审计照常，密钥不会发到网页里。这个开关在课题表单里有（默认开），管理员也有全局开关（默认开），不想让网页调平台能力，关掉即可。

### 6.2 怎么建一个课题 {#s6-2}

**怎么点**：工具箱 →「探索空间」→「＋ 新建课题」。第一次进来会有「先看样例」的小引导，可以先点一个样例，主题和目标会自动填好。

![新建课题](manual_img/19_explore_form.webp)

要填的：

- **主题**和**目标**（想得到什么、给谁看、要什么产出；也可以点 🎤 直接说）。
- **预算**：有两个上限，互相独立，随时可改。**token 上限**有 20 万 / 100 万 / 500 万 / 2000 万 / 不限几档，也可以自己填数字；**最多回合数**可填数字，也可以选「不限」。拿不准就用默认，不够再往上调。
- **能力等级上限**：L1 搜索与读取、L2 生成、L3 重资源、L4 外部动作。你不勾，它就用不到更高等级的工具（AI 连看都看不到）。
- **允许读的资源**（图中①）：只列出你能用的。想让它分析业务数据，就勾上对应资源。**写操作的资源（私有域里可写的那些）别随手勾**。
- **什么时候运行**（②）：手动，或每天自动跑一次新的。还可以勾「结论发布到今日看板」。
- ③「创建并开始」，或「只创建」稍后再开始。

### 6.3 回合、预算和「用完了怎么办」 {#s6-3}

- **回合**：AI 完成一次完整回复算一个回合。这一回合里它可以调很多次工具（读资料、写文件、生图都算在里面）。一个回合没做完，会自动开下一回合。
- **预算怎么记**：按「新增输入 + 输出」记。缓存命中的输入不占预算，只在用量里单独列出来给你看。
- **用完只是暂停，不会卡住**：token 或回合数到了上限，课题状态变成「暂停」（或「部分完成」），已经做出来的网页和文件都在，页面上会列出来，能直接打开试用。
- **继续**：在课题页点「调整上限」，改 token 上限或回合数（运行中也能改），再点「保存并继续」，它从停下的地方接着做。

![调整上限并继续](manual_img/34_explore_limits.webp)

上图是一个暂停的课题：①暂停提示和已有产物；②token 上限的快捷档位，含「不限」；③最多回合数的快捷档位；④「保存并继续」。

状态有四种：**完成**、**部分完成**（有产出但还没到目标）、**暂停**（到了你设的上限，调高就能继续）、**中断**（出错或被你停掉）。

### 6.4 它怎么跑、跑完看什么 {#s6-4}

- **自动续跑**：每个回合结束，它自己判断「做完没有」，没做完且上限没到就自动接着做；到 **75%** 额度提醒它收尾。连续没进展、连续出错或一直复读，会自动停下并告诉你原因。
- **网页报告**：结论默认生成一份单文件网页，在隔离的沙箱里显示（页面里的脚本碰不到你的登录信息，只能通过上面说的平台桥办事），可以全屏、可以下载。
- **子课题**：结论卡片上点「🔍 深入这一点」，以这一条为目标建一个子课题，继承资源范围，预算可以从父课题剩余里划拨。
- **随时接管**：「在对话中打开」就能像普通对话一样继续追问。
- 想重来：「重新运行」用量清零；想接着做：「继续」用量累计。

- **3.2：过程自动折叠，先看交付成果。** 课题跑的过程（搜索、写文件、思考）折叠成一行摘要；跑完后主视图是「交付成果」，带用时、用量、回合数、文件数和结论条数，**查不到出处的结论会标「未核实」**。想看过程点「返回过程」。

![交付成果主视图](manual_img/51_explore_delivery.webp)

①已完成的课题和它的操作按钮；②「交付成果」卡片：用时、用量、回合数、文件数、结论数（含未核实条数）；③全屏 / 新窗口 / 下载 HTML / 返回过程；④报告正文。

![探索结果](manual_img/20_explore_done.webp)

这是我们用演示业务系统跑的一次：主题「仓库与报价经营看板」，读 4 个只读资源。①状态「已完成」，用了 91.7 万 / 100 万 token；②这排按钮是：重新运行、继续、在对话中打开、固化成流水线、发布到今日；③用量明细。最终给出 7 条带来源的结论和一份网页报表，耗时约 4 分钟。

![手机探索空间](manual_img/30_m_explore.webp)

### 6.5 让它做「点点鼠标就能生成」的网页 {#s6-5}

想要一个点几下就能出结果的网页，直接说需求，比如「做个点点就能生成歌曲的网页」。它会先从 6 个互动页范例里挑最接近的一个，**先交付一个能运行的最小版本**，你试过再提意见，它接着改。

| 范例 | 点一下能做什么 |
|---|---|
| 歌曲 | 填风格和歌词，生成一首歌并播放、下载 |
| 点选生成图 | 选图类型（流程图、时序图等），自动选择渲染方式出图；时序图、类图、用例图、活动图、状态图、甘特图、思维导图都可画（PlantUML / Mermaid / Graphviz），PlantUML 首选，新版镜像已自带 Java |
| 报价单 | 选产品和数量，查价格、算合计、出报价单 |
| 数据图表 | 读业务数据，点选维度出柱状图、折线图 |
| 海报 / 配图 | 填标题和风格，生成海报或配图 |
| PPT 大纲 | 填主题和听众，生成一份分页大纲 |

![AI 做的互动页](manual_img/35_explore_sandbox_page.webp)

图里是它做的歌曲页：点①这个页面里的「生成这首歌」，真的会调用平台的音乐能力，生成后在页面里直接播放、下载。

### 6.6 用的时候注意 {#s6-6}

- **预算可以先小后大**：先用默认档跑一遍最小版本，不够再「调整上限并继续」，不用一开始就给很大。
- 每个结论后面会写**来源**；没来源的会标「未核实」。
- 数据口径、取了多少条，请看报告里的「限制」说明（比如它自己写明了「报价只取了最近 50 张」）。
- 网页里调用能力用的是你的权限和额度，生成音乐、图片这类重资源会占用对应的额度，也受限流约束。
- 课题对话也会出现在左侧对话列表里，标题带 🧭。

### 6.7 找课题、翻页和「今日灵感」 {#s6-7}

- **搜索**：课题列表上方的搜索框，按标题、目标和课题里的内容（结论、摘要）找，打字停下来就自动搜。
- **翻页**：课题多了不会一次全摊开，每页 24 个，底部「上一页 / 下一页」；有子课题的会跟着父课题一起显示。
- **顶部很干净**：只有「探索空间」、「＋ 新建课题」、「⋯」和关闭。「完成提醒」「关闭所有提示」「重新显示引导」都在「⋯」菜单里。
- **今日灵感**：标题下面每天换一批创意（点选生成 PlantUML 图、3D 火箭小游戏、报价单生成器、MySQL 部门销售分析、周末行程 PDF……），拿不定主意就点「🎲 随心一动」。点一条只是**打开新建课题并帮你填好标题和目标**，可以改，确认后再点创建，不会直接开跑。
- **过程看得全**：课题页的「过程」就是这次课题对话的完整消息流——AI 说的话、思考、每一次工具调用的输入和输出——和在网页对话里看到的一样，不会折叠，也不受「展示设置」影响；失败时显示工具返回的原话。
- 课题做出来的文件会自动进「产出物中心」，来源标「探索课题」。

---

## 7. Windows 远程操控 {#s7}

### 7.1 它能做什么 {#s7-1}

让 AI 在一台 Windows 电脑上**像人一样操作**：开软件、截图、认屏幕上的字（OCR）、按控件名点按钮、输入文字、传文件，也能读改 Word / Excel / PPT、导出 PDF。可以接多台电脑，让它们并行干活。

> 前提：那台 Windows 必须**已经登录且没锁屏**才能操作桌面。锁屏、断线时它会告诉你原因和办法，而不是装作成功。

### 7.2 接入一台电脑 {#s7-2}

![添加 Windows](manual_img/25_win.webp)

**怎么点**：

1. 工具箱 →「添加 Windows」。
2. ①给这台电脑起个代号（系统自动给了一个，可以改）。需要的话勾选「初始化时允许 PowerShell 命令执行」（默认不勾）。
3. ②点「生成接入命令」，复制那条命令。
4. 在**要被控制的那台电脑**上：右键开始按钮 →「终端（管理员）」→ 粘贴命令回车。
5. 等一会儿，回到页面，「已登记节点」里出现这台电脑就是接好了。

它会自己装好 OpenSSH、生成并授权一把专用密钥（只用密钥、不用密码），由**那台电脑主动连回来**，所以你**不用在路由器上开端口**。装好后有「看门狗」：程序卡死、掉线会自动拉起并回连。

> 页面上如果提示「当前地址使用 HTTP，凭据和截图会在网络上明文传输」，说明你是用 `http://` 访问的服务器。放到公网时请配好 HTTPS。

### 7.3 怎么用 {#s7-3}

接好后，就在对话里用人话说：

- 「在电脑 xxx 上打开记事本，写一句话保存到桌面」（换成你的电脑代号和路径）
- 「把 D 盘下载文件夹里本周的 Excel 整理到一个新文件夹」
- 「截个图看看现在屏幕上是什么」

它有几种做法，会自己选：**命令**（最快最稳）→ **界面控件**（给可点的东西编号，说「点 12 号」）→ **找屏幕上的字**（OCR）→ **按坐标点**。点完它会核对界面有没有变化，还能自动关掉弹窗、处理「另存为」。

**办公文件通道**：读改 xlsx / docx / pptx、导出 PDF、整理文件，需要在节点面板里打开「办公通道」（默认测试机开、用户机关；管理员可以开关）。改完会带「改前改后」的校验回读。

### 7.4 安全提示（请认真看） {#s7-4}

- **接入码一次性**，只在第一次登记有效；每台电脑领独立的随机凭据，一台的凭据管不了另一台。凭据在电脑上用系统加密存放。
- **这台电脑上的程序拥有安装用户的权限**，所以管理 LiteCode 的账号和服务器是**可信的控制端**。只让可信的人当管理员。
- 操作文件限定在桌面、文档、下载和 `LiteCodeWork` 目录；拒绝 `..`、网络路径等越界写法；删除走回收站。
- 远程操控属于 **L4 外部动作**：企业模式下管理员可以对角色或个人关闭。
- 「自动执行」开着时，它不会逐步问你；想每步确认，请先把自动执行关掉（见 2.2）。
- 微信这类需要你**在手机上点确认**的登录，它会停下来等你，不会替你点。
- 不想用了：节点面板可以撤销；卸载脚本会删掉节点代理、启动任务和本机凭据，**不会删你电脑上的其他文件**。
- 节点代理会**自动更新**：电脑空闲时校验通过才替换，失败自动回滚，正在做的任务不会被打断。

---

## 8. 文书处理与日常事务 {#s8}

### 8.1 Word / Excel / PPT / PDF {#s8-1}

- **生成**：直接说需求，例如「查一下今天的 A 股大盘，用表格总结，生成一份 Word 报告」。做完的文件在回答里直接预览、下载。
- **读和改**：把文件用 📎 传上去，说「把第三张表的合计列改成含税价」之类。Windows 电脑上也可以通过办公通道直接改电脑里的文件（见 7.3）。
- **PDF**：可以生成，也可以读取；扫描件能做文字识别（OCR）。
- **PPT 和文档的质量检查**：生成后系统会自动检查产物质量；每个会话的产出物会留快照，**同名文件不会互相覆盖**。 PPT 的新体验见 [8.8](#s8-8)。
- **业务报表**：报价单场景中它主动多做了 Excel 和 PDF；MySQL 场景出了柱状图（png）加数据表（csv）。

> 想要什么格式，直接在话里写清楚：「做成 Excel，每个部门一个 Sheet」。成品太复杂时，先让它出一版，再分几次改。

### 8.2 日常事务 {#s8-2}

| 我想 | 怎么说 / 怎么做 |
|---|---|
| 记住我的习惯 | 直接说「以后给我的报告都用表格开头」，它会记进「记忆」，工具箱 →「记忆」里可查可删 |
| 建知识库 | 工具箱 →「知识库」上传文档；提问时它自动检索，答案带出处。（知识库需要部署时启用，没启用面板会提示） |
| 记日程、提醒 | 对它说「明天下午 3 点提醒我开会」，或工具箱 →「日历」。到点在网页（和绑定的微信）里叫你 |
| 每天早上收到简报 | 工具箱 →「定时任务」建一个，或点首页快捷按钮「每日简报」 |
| 微信里用 | 工具箱 →「微信」扫码绑定。注意：一个微信号同一时间只能绑一个 |
| 看产出的所有文件 | 工具箱 →「产出物」「工作区」 |

### 8.3 把表格和文档直接丢给它 {#s8-3}

没有接口、没有数据库也能用：点输入框左边的 📎，把 Excel、CSV、Word 传上去（可多选），再用一句人话说要什么。下面是在虚构数据上的几个例子，耗时用的是默认模型。

| 你传的 | 你说 | 结果 |
|---|---|---|
| 人员表 + 考勤表（xlsx） | 按部门统计上个月出勤异常（迟到、早退、缺勤，请假不算）的人次和涉及人数，再列出异常最多的前 3 个人，存成 Excel | 5 分 18 秒；131 人次、涉及 51 人，各部门数字与直接用表格算的一致；第 3 名有并列，它自己标了出来 |
| 员工手册（docx） | 我入职满 4 年，一年有几天年假？病假请了 12 天工资怎么算？说明出自哪一条 | 24 秒；年假 7 天（第一章 1.1 条），病假前 10 天全薪、后 2 天按 60%（第二章 2.1、2.2 条），并提醒手册没写「基本工资」怎么定义 |
| 考勤表（xlsx） | 做一份 9 月第 4 周的考勤周报 Word，简单一页，不用封面目录：各部门异常人次、前 3 人、三句话小结 | 8 分 52 秒；283 人天、31 人次，各部门数字一致 |
| 门店日销售表（csv） | 昨天各门店销售额排名，比前一天环比多少，下滑最多的是哪家，再给 10 月累计前三，画张柱状图 | 2 分 51 秒；东门店 28,906 元居首，北苑店 −69.5%，它提醒先查是不是停业或漏单 |
| 客服工单表（csv） | 各问题分类的工单数量、没解决的有多少、处理最慢的 5 张，最后给 3 条改进建议 | 1 分 43 秒；300 张工单，物流延迟 98 张最多，未解决 51 张 |
| 10 个散乱命名的项目文件 | 按项目分文件夹，统一改成 项目-类型-序号，打成 zip，再列新旧名字对照表 | 46 秒；10 个文件归入 3 个项目，逐个核对内容没变 |

![考勤表汇总](manual_img/31_hr_attendance.webp)

①你说的话 ②各部门迟到、早退、缺勤和合计 ③异常最多的人，并列时它会主动说明。

![门店日销售](manual_img/33_store_daily.webp)

①你说的话 ②结论 ③它画的柱状图，红色的是比前一天下滑的店。

**小提示**

- 要什么形式，直接说清楚：「简单一页，不用封面目录」「存成 Excel」。不说的话，做 Word 时它可能花很多时间排版，做到很讲究。
- 它会把口径讲出来（比如「请假不算异常」「并列第 3」）。你不同意，直接说一句，它改。
- 一次上传的文件不要太多：上传接口每分钟限 10 次，一次选 12 个文件会少 2 个，它会如实告诉你少了哪些。
- 数字别只信一遍：重要的汇总，让它「再用另一种算法核对一次」，或者自己抽几行对。

### 8.4 批量生成文书、定时提醒 {#s8-4}

一份模板（或者一段要求）加一张表，一个人一份，格式统一：

| 你传的 | 你说 | 结果 |
|---|---|---|
| 人员表（xlsx） | 找出转正日期在 2026 年 11 月的员工，每人生成一份转正通知 Word，文件名用「转正通知_姓名」，打成 zip | 1 分 42 秒；9 人 9 份，姓名、部门、日期逐份对过，没有串名 |
| 合同续签提醒函模板（docx）+ 待续签客户表（xlsx） | 按模板，给表里每个客户生成一份续签提醒函，文件名用合同编号，打成 zip | 1 分 54 秒；6 家客户 6 份，模板里的 5 个占位符全部换好，没有残留，样式和模板一致 |
| 不用传文件（直接取报价系统的数据） | 把报价系统里所有待审批的报价按客户汇总单数、总额、平均毛利，做成一页 Word 周报，再加两三句小结 | 10 分 59 秒；11 张单、9 家客户，合计 2,486,028.01 元，毛利 31.19%，和系统接口算出来的一致；它还发现有 3 张单一模一样，提醒你确认 |
| 不用传文件 | 每周一早上 9 点提醒我跟进三个快到期的客户，每个都问一句有没有续签意向 | 21 秒；建成一条每周一 9:00 永久重复的日程，提前 10 分钟也提醒一次，首次是下周一 |

![合同续签提醒函](manual_img/32_contract_notice.webp)

①你说的话 ②生成的清单：文件名、客户、到期日、金额 ③做法和核对结果。

- 模板里的占位符写成 `{{客户名称}}` 这样的双大括号，表头和占位符对得上最省事。
- 落款、称呼这类模板里写死的文字，它会提醒你「发出前换成自己公司的」；缺的信息（比如性别）它不猜，会问你。
- 邮件和通知草稿：说要点，它写标题和正文，你改完再发。


### 8.5 一句话做 3D 小游戏 {#s8-5}

在对话里说「做一个火箭发射的 3D 小游戏」，可以选：火箭发射、3D 射击、太空飞行、塔防。做出来是**一个 .html 文件，不联网**，聊天里的文件卡片上点「运行」，就在对话里直接玩。

- 手机：触屏摇杆和按钮；电脑：键盘和鼠标。游戏里有「暂停、重开、说明、声音」。
- 想改难度或玩法，接着说一句就行。
- 游戏在隔离沙箱里运行，读不到你的登录信息。要在新标签页或全屏玩，用文件预览里的按钮。
- 手机太旧或浏览器不支持 WebGL 时，会提示原因，不会白屏。

<!-- 3.2-PENDING: 新增技能（提醒日程 / 知识库问答 / 显卡选型） -->

### 8.6 文档排版检查与文档审阅 {#s8-6}

对话里说「检查一下这份文档的排版」或「帮我审阅这份报告」，把文件拖进来。**只出问题清单，不改你的原文件。**

- **排版检查**（Word / PPT / PDF / Markdown / HTML）：先做结构检查——标题跳级、字体混用、表格超宽、图片模糊、页码缺失、PPT 字太小或溢出、中英文空格与全半角标点；再把每页渲染成图做视觉复核；给出「位置、严重度、建议、能否自动修复」的清单和逐页评分。需要时可以生成一份修复后的副本。
- **文档审阅**（校对和逻辑审阅）：把文档切成带位置（章节路径和段落 / 页码）的块，先机械检查——错别字候选、重复词、的地得、单位和术语不统一、日期和数字前后矛盾、图表编号和引用对不上；再由模型分块审阅逻辑跳跃、论据不足、结论与数据不符、语气不统一。输出分级的意见清单；Word 可以生成**带批注的审阅稿**；引用的来源标「已核对 / 未核对」。
- 两个技能分工明确：排版字体表格页码找「排版检查」，文字和逻辑找「文档审阅」。
- **说明**：我们用内置的缺陷样例文档（排版有问题的 Word / PPT、有错别字和矛盾的文稿）做了自动化测试；真实文档里的效果因文档而异，意见请当作参考，重要文件仍请人看一遍。

### 8.7 音视频切片与质量分析 {#s8-7}

**切片**（说「按静音把这段录音切开」「把这个横屏视频裁成竖屏」）：

- 可以按时间点或区间、按静音、按场景变化、按字幕或语音识别的句子切，也可以固定时长并在静音处对齐；横屏视频可裁成 9:16 竖屏（480×864 或 720×1280）。
- 输出切片文件和一份清单，并**逐片校验**：时长误差、切点是不是切在声音中间、首尾有没有爆音、音画是否同步。**不会改原文件。**

**质量分析**（说「看一下这段配音的质量」「成片检查」）：

- 音频：响度（LUFS、LRA、真峰值）、削波、首尾静音、噪声底与信噪比估计、直流偏移、频谱截止（低码率转码的迹象）、立体声相位与单声道兼容；可与参考音频 A/B 对比；输出波形、频谱和响度曲线的合成图；**按用途**（播客、配音、歌曲、短视频、电话）判定是否合格。
- 视频：黑帧、冻结帧、音画同步、字幕区域检查。
- 指标测不出的——歌词唱对没有、音色像不像、情绪对不对——**仍需要人来听**。

### 8.8 做 PPT 的新体验：好找、不空、有备注 {#s8-8}

![PPT 文件卡与缩略图](manual_img/56_ppt_cards.webp)

**做什么**：一句话让 AI 做出 .pptx，成品直接进本会话的产出物，附一张缩略图总览，方便你先扫一眼再下载。

**怎么用**：

1. **怎么说需求**：把主题、页数、受众、风格讲清楚，例如「做一个 3 页的 PPT，介绍咖啡的种类」「做一份面向管理层的 Q3 销售汇报，要有图表」。数据要真实的，请把数据（或文件）一起给它；没给时它会用示例数据，并在页面上写明「示例数据」。
2. **页数**：以你说的为准，**含封面**。页数对不上时会告警并让模型修正。
3. **主题配色**：不说颜色时，按主题关键词自动选一套暖色主题（咖啡、琥珀、沙、玫瑰），暖白底、深色字，封面和结尾用深色底。想要别的颜色，直接说「用蓝色商务风」。若你的部署设了品牌色，会优先用品牌色。
4. **在哪下载 .pptx**：聊天里回复下方的文件卡，点「下载」或「预览」；同一份也在「产出物中心」里（见 [2.7](#s2-7)）。文件卡里**只会有 .pptx 和一张缩略图**，中间生成的 JSON、页图、PDF 不再出现。
5. **演讲备注**：没写备注的页会自动补 1 到 3 句演讲备注，在 PowerPoint 的「备注」窗格里看；不想要，就在需求里说「不要演讲备注」。
6. **自检提示**：生成后会自动渲染成图做一轮检查（文字溢出、元素重叠、对比度、空白页），发现问题由模型按提示改一轮。回复里看到「视觉复核」就是这一步；不会再多弹提示。

![缩略图总览（8 页示例）](manual_img/57_ppt_sheet.webp)

**常见问题**：

- 内容有点薄？内容的厚度取决于模型，系统只保证版式不空洞；可以追问「第 3 页加一个对比表」「每页再补一个案例」。
- 为什么我要咖啡棕，出来是蓝色？部署里设置了品牌色会优先用品牌色；直接在需求里指明颜色。
- 没有自检结果？视觉自检依赖识图能力，当前模型看不了图时会静默跳过。
- 能自动配图吗？配图只在技能指引里提到，目前没有实测，别指望。
- 回复里还有「加载 PPT 技能…」这类过程话？偶尔会有，不影响成品，可忽略。

**小提示**：先让它做 3 页看风格，再说「照这个风格做 10 页」；同名文件不会互相覆盖，放心多版本对比。

---

## 9. 安全与权限 {#s9}

### 9.1 能力四级 L1–L4 {#s9-1}

权限只管一件事：**允许 / 不允许**。没有审批流。

| 级别 | 含义 | 举例 |
|---|---|---|
| **L1 只读** | 搜索、读网页、识别、读知识库、读只读资源 | 联网搜索、读业务库 |
| **L2 生成** | 生成内容 | 生图、配音、文档、网页报表 |
| **L3 重资源** | 占显卡的 | 生视频、生音乐 |
| **L4 外部动作** | 会对外面产生动作的 | 发微信 / 企微、执行命令、远程操控、删文件、业务系统写操作 |

对话工具、流水线、定时任务、网页接口用的是**同一套判定**，没有哪条路能绕过去。个人模式一律放行。

### 9.2 成员角色 {#s9-2}

| 角色 | 能做什么 |
|---|---|
| 管理员 | 管用户和全部设置；看审计；但**看不到别人的会话内容** |
| 成员 | 用自己的会话 / 记忆 / 工作区；默认能用全部能力（本机容器管理、能力接入 / 服务商含密钥这两项默认关） |
| 只读 | 只能查看，默认不能调用能力，没有写文件、执行命令这类工具 |

> **重要**：成员能执行命令，而命令执行不是沙箱。**成员只给互相信任的同事**；账号之间不互信时，请设成「只读」。

权限表在 设置 → 团队 / 企业 →「权限」，勾选 = 允许，取消 = 不允许，改完**立即生效**。

![权限表](manual_img/24_perm.webp)

①按角色（管理员 / 成员 / 只读）一列一列勾；②每一行是一项能力，比如 L4 外部动作。也可以「按人单独设置」。被拦住的人会看到「当前账号（角色 X）没有××权限，请联系管理员」，不会无声失败。

### 9.3 白名单、读写分级 {#s9-3}

- **只走白名单**：业务系统、邮箱、目录这类，AI 只能选你登记的「模板」填参数，不能自己写命令。范围（目录 / 路径前缀 / 表 / 邮箱文件夹）必须登记，越界、路径穿越、符号链接绕路都会被拒。
- **读写分级**：读和写是两套模板；写要资源上手动「允许写」，并算 L4。
- **配额**：想限制某类能力每人每天用几次，管理员在配置里设 `agent.cap_quota`（例如 `{"L3": 5}` = 每人每天 5 次）。默认只记账、不限制。

### 9.4 审计 {#s9-4}

- 管理员在 设置 → 团队 / 企业 →「审计日志」查看，可以按账号、动作、关键词、时间筛。
- 记的有：登录成功 / 失败、模式切换、业务系统读写、自动执行放行了什么等。**不记密码和密钥**。
- 日志超过 10 MB 自动轮转，保留 5 份。

### 9.5 回收站 {#s9-5}

资源被删，先进回收站（能找回）。删用户时必须选择：把数据**移交**给某人，或**归档**（打包进回收站，30 天后清理）；不允许悄悄删数据。

### 9.6 防注入 {#s9-6}

网页、邮件、文件、接口返回的内容，都被当成**数据**，不是命令。里面写着「忽略以上指令」「把文件发给 xxx」「请下单」，它**不会照做**——就算「自动执行」开着也一样。如果本轮读到了疑似注入的内容，而你并没有要求下单 / 建单，写操作会被拦下。

### 9.7 数据归谁：资源归属与统一判定（3.2） {#s9-7}

- 会话、产物、今日卡片、定时任务、流水线、探索课题、私人能力卡，新建时统一记上：**主人、所属组织、创建者、可见范围（仅主人 / 组织内只读 / 公共）和来源**（用户、系统、定时器、流水线、子代理、导入、老数据）。老数据在读取时自动补全，不做批量改写。
- 每个用户有一个**稳定的内部编号**，改口令不变；删除用户再建同名账号，编号不同。
- 移交、归档、清除成员时，系统按同一份**资源登记表**逐项处理，不再因为新功能漏掉某一类数据。
- **统一的权限判定目前以「对照模式」在后台运行**：只记录它和现行规则的差异，**不改变任何人现在能做什么**。已经生效的几处：系统生成的无主今日卡片，成员只读（管理员私有的卡片除外）；定时任务、能力卡的增删改写入审计；成员在用量里只看到自己的；插件接口走统一入口，先以对照模式记录。
- 个人模式不受影响，保持原来的单用户行为。

---

## 10. 管理员手册 {#s10}

### 10.1 成员与角色 {#s10-1}

设置 → 「团队 / 企业」→ 开启企业模式后可以管理用户。

![用户管理](manual_img/23_team.webp)

①「＋ 新建用户」：填登录名（小写字母 / 数字，2–32 位）、初始口令（至少 8 位）、选角色。②每个人一行，可以改角色、**停用**（立即吊销登录，数据保留，可恢复）、**重置口令**、**删除**。

- 新用户第一次登录**必须先改口令**。
- 重置他人口令后，对方所有登录立即失效，且也要先改口令。
- 不能删除 / 停用 / 降级**最后一个管理员**；管理员不能停用自己。
- 唯一的管理员忘了口令：界面里找不回，需要部署人员在服务器上处理，所以**至少留两个管理员**。
- 企业模式切回个人模式（仅管理员，需勾「我已了解」）：其他人的数据**保留但不可见**，再开企业模式就恢复；他们的登录和个人令牌失效，定时任务暂停。我们反复切换过 3 次，会话、流水线、定时任务、能力卡都没有丢。

### 10.2 模型配置 {#s10-2}

- **接哪些模型**：设置 → 常用 →「模型」列表；「添加模型」填**地址**（OpenAI 兼容格式，以 `/v1` 结尾）、**模型名**（和接口里一字不差）、**Key**（没有就填 `EMPTY`）。每个模型有「测试」「设为默认」「删除」。
- 也可以在对话里说「帮我加一个模型，地址是……，名字是……」，它自己添加、测试、再切过去。
- 3.0.0 在用的：**DeepSeek Flash**（默认，40 万上下文）、**Qwen3.6-35B**（自建服务，能识图）。模型越会调用工具，长任务越稳；太小的模型容易绕圈。
- 「识图兜底模型」：主模型看不了图时，带图请求临时交给它。
- 上传上限：默认 **200 MB**；如果前面还有一层网页服务器（反向代理），记得同步放大它的请求体上限，否则大文件会被它截掉。

### 10.3 配额与限流 {#s10-3}

- 用量：看板里看 token；企业模式下用量**按用户记账，仅管理员可看**。
- 能力次数：`agent.cap_quota`（见 9.3）。用户管理里旧的「配额」字段**暂未生效**，别依赖它。
- 登录限流默认**关闭**（放在反向代理后，大家共用一个出口地址，开了会误锁全员）。要放公网防暴力破解，部署时设环境变量 `LITECODE_LOGIN_RATE_LIMIT=1`。
- 自动执行：设置 → 常用 → 总开关；企业模式下可整体、按角色、按人关闭。

### 10.4 升级 {#s10-4}

**Windows 桌面版（装了安装包的电脑）**

- 托盘每天自动检查一次。有新版弹窗问你，点「是」就自动下载、校验、替换，大约 1 分钟，对话和设置都保留；新版起不来会**自动回滚**。
- 手动检查：托盘右键 →「检查更新」。

**Windows 节点（被远程操控的电脑）**

- 节点上的代理自己更新：电脑空闲时下载、逐个校验、全部通过才替换；正在做的任务不会被打断；失败自动回滚。节点面板里能看到「运行版本」。

**服务器版（换镜像）——请先备份再换**

1. 先确认用户 / 口令 / 审计 / 今日卡片 / 分享链接 / 回收站这些「状态文件」是放在**挂载出来的状态目录**里，而不只是容器内部。**如果它们只在容器里，直接重建容器会让用户、口令、审计、今日卡片丢失，已删的会话还会复活。**
2. 备份整个状态目录和 `config.json`（里面有密钥，请只存在你自己信任的地方）。
3. 换镜像前后各做一次「状态快照对比」，确认文件数、会话数没少。
4. 换之前先确认没有人在用、没有后台任务在跑（正在跑的对话和流水线会被打断）。
5. 换完后：登录、发一句话、打开资源页看 ✅、打开今日看板，四步过一遍。

> 这几步涉及你们服务器上的具体目录和脚本，建议由部署人员按部署文档执行。

### 10.5 备份 {#s10-5}

要备份的东西：

| 东西 | 说明 |
|---|---|
| 状态目录（用户、口令摘要、审计、今日卡片、分享、回收站、定时任务、日历） | 最重要 |
| 会话和工作区文件 | 对话记录、产出物 |
| `config.json` | 模型、能力卡、资源（含密钥，别外传） |

Windows 安装包用户：数据在 `%LOCALAPPDATA%\LiteCode`。**卸载会删掉 LiteCode 子系统和里面的对话文件**，卸载前先导出要留的东西。

### 10.6 查看成员的会话（只读）（3.2） {#s10-6}

企业模式下，管理员可以**只读**查看全部成员的会话，用于排查问题和审计。

![管理员视图](manual_img/50_admin_view.webp)

- ①侧栏「会话范围」下拉：「我的 / 全部成员的会话 / 某个成员」。默认列表仍然是你自己的；选了「全部」后，每个会话行前有**所有者小标**，可按成员筛选、搜索聊天内容、导出。
- ②打开别人的会话是**只读**的（③是当前登录的管理员账号）：顶部横幅写着「正在查看 xxx 的会话（只读）」，**输入区禁用**，重试、编辑、分享按钮隐藏；**不能代发消息、改名、删除、插话或中断**。
- **每次查看都写审计**（`admin_view_session`；同一会话 5 分钟内合并为一条），在「设置 → 审计」里能看到谁看了谁的哪个会话。
- 普通成员看不到别人的会话、定时器和日志；越权操作会被拒绝。
- 不想开放这个功能：把 `config.json` 里 `multi_user.admin_view_sessions` 设为 `false`（缺省为开）。设置里有一段可见性说明，成员也能看到「管理员可只读查看」。
- 个人模式没有这个功能。

---

## 11. 常见问题与排错 {#s11}

### 11.1 报错对照（人话版） {#s11-1}

| 你看到的 | 意思 | 怎么办 |
|---|---|---|
| 登录已过期，请重新登录 | 登录状态过期了 | 点「重新登录」，输入的内容会保留 |
| 对话太长，超出了模型能处理的长度 | 上下文满了 | 直接重试一次（系统已自动压缩）；仍不行就新开对话或换上下文更长的模型 |
| 所选模型不存在或暂不可用 | 模型名写错或服务没开 | 换个模型；自建的先确认服务在跑、名字对得上 |
| 密钥无效或没有权限 (401/403) | Key 填错、过期或欠费 | 设置里检查这个模型 / 服务的 Key |
| 请求过于频繁 / 额度 | 被限流或额度用完 | 等一会儿再试，或换模型 |
| SSH 连不上目标主机 | 主机别名、地址、端口、密钥有问题 | 检查目标机开机、SSH 服务在跑、密钥有效 |
| 当前账号（角色 X）没有××权限，请联系管理员 | 你的角色被关了这项能力 | 找管理员在「权限」里开 |
| 缺少资源，请先在能力接入里接入 | 流水线用到了你没有的私人卡或资源 | 在「能力接入」里接上，或让创建人改成公共域 |
| 这条流水线已暂停：主人「xxx」的账号已停用… | 流水线的创建人被停用 / 降级 | 管理员恢复账号，或把流水线交给别人重建 |
| 库存不足，拒绝出库 | 业务系统的风控拒绝了 | 这是业务系统在把关，按提示换仓库或先入库 |
| 不在交易时段（`E_NOT_TRADING_TIME`） | 仿真期货系统按真实交易时间开盘 | 到交易时段再试（日盘 09:00–10:15、10:30–11:30、13:30–15:00，夜盘 21:00–02:30） |
| 疑似提示注入，已拦截 | 读到的内容里夹着指令 | 看提示里说的原因；确实是你要做的，请你自己明确说一遍 |
| 节点正在更新，请稍后重试 | Windows 节点在自更新 | 等 1–2 分钟 |
| Windows 提示锁屏 / 无法操作桌面 | 桌面被锁了 | 先解锁并登录那台电脑 |
| 文字识别只能认英文 | 电脑没装中文 OCR 语言包 | 需要管理员权限安装，**必须你同意后再装**，它不会偷偷装 |
| 探索课题暂停了 | token 或回合数到了你设的上限 | 在课题页点「调整上限」，调高后点「保存并继续」；不想限就选「不限」 |
| 任务详情里写着「迭代次数用尽，已带回已收集的资料」 | 子代理跑满了迭代次数，没完全做完，但已把查到的资料带回来 | 看汇报里的结论和证据，需要的话让它从这里接着做 |
| 任务写着「已强停（检测到重复调用循环）」 | 子代理在重复同一个调用，被系统拦下了 | 换个说法重新派发，或给它更具体的目标 |
| 告警「今日预算已达 80%」 | 用量接近你设的每日预算 | 只是提醒，不会停任务；去用量看板看谁花得多，或调高预算 |

### 11.2 常见问题 {#s11-2}

**Q：发了消息一直转圈？**
先看顶部有没有错误条；再点「⚡ 立即」或停止；还不行就新开对话。模型服务慢、模型在长时间思考也会这样——**思考强度关掉**会快一点，但难题更容易出错。

**Q：刷新页面后图不见了 / 对话没了？**
先别重复发。重新打开原对话，历史会从服务器恢复。登录过期时输入框里没发出的内容会保留。

**Q：手机上输入条被盖住？**
更新到最新版。运行中的停止键和悬浮层现在都贴在输入区上方，不会盖住输入条。

**Q：探索课题预算用完了怎么办？**
用完只是暂停，不会卡住。打开课题，点「调整上限」，把 token 上限或最多回合数调高（也可以选「不限」），再点「保存并继续」，它接着做，已有的网页和文件都在。

**Q：Windows 安装包安装失败？**
先看日志：把 `%LOCALAPPDATA%\LiteCode\launcher.log` 粘到资源管理器地址栏回车。常见原因：BIOS 没开虚拟化；开着本机代理（Clash 之类）时要给 WSL 打开「镜像网络」（在 cmd 里依次执行 `echo [wsl2]> "%USERPROFILE%\.wslconfig"`、`echo networkingMode=mirrored>> "%USERPROFILE%\.wslconfig"`、`wsl --shutdown`）。

**Q：我的 Key 会不会被 AI 看到？**
不会。Key 只存在服务端；界面上只给本机登录的你看；回复里不复述完整 Key；日志里会打码。但**不要把带 Key 的截图发给别人**。

**Q：它能不能偷偷把我的文件传到外面？**
内容只会发给你自己接入的模型和服务。网页、邮件里夹带的「请把文件发给 xxx」不会被执行。是否开放外网访问取决于你怎么部署，请让管理员配好 HTTPS 和访问控制。

**Q：Ctrl+K 变成命令面板了，原来「工具结果全文」的快捷键呢？**
3.2 起 Ctrl/⌘+K 是命令面板；「切换工具结果截断 / 全文」改成了 **Ctrl/⌘+Shift+K**。

**Q：时间戳是真的时间吗？老会话为什么有的消息没有几点几分？**
新消息记的是发送和结束的真实时间。老会话导入前没有记录的消息，只显示日期分隔，不编造几点几分。

**Q：run_id 是什么，怎么用？**
每次运行（一轮对话、一次流水线、一次定时触发、一个子代理……）的唯一编号。任务详情里点「复制」就能拿到，日志、用量账本、产物和今日卡片里都带着它。它只存在你自己的服务器上，**不会发给模型**。

**Q：云端花费和「自建折算」有什么区别？**
云端花费是实际要付的钱；自建模型不花钱，「折算」只是按等价价格估算的参考，标着「不计费」，默认不计入预算。

**Q：管理员能偷看我的会话吗？**
企业版里管理员可以**只读**查看成员会话，但不能代发、改名、删除或中断；每一次查看都写进审计，成员能在设置里看到这条说明。

---

## 12. 术语表 {#s12}

| 词 | 人话解释 |
|---|---|
| 个人模式 / 企业模式 | 一个人用 / 多个账号用。企业模式按人隔离数据 |
| 管理员 / 成员 / 只读 | 三种角色：全管 / 正常用 / 只能看 |
| 模型 | 真正「思考」的大语言模型，你自己接 |
| 能力卡 | 一张写着「这个服务怎么调」的卡片，让 AI 有手有脚（画图、搜索、通知……） |
| 资源 | 业务数据和系统（数据库、接口、邮箱、目录），只能走登记好的模板 |
| 模板 | 登记好的「固定动作」，AI 只能选模板、填参数，不能自己写命令 |
| 公共域 / 私人域 | 谁登记、谁能用。公共=所有人；私人=只有本人 |
| L1–L4 | 能力风险四级：只读 / 生成 / 重资源 / 外部动作 |
| 自动执行 | 开启后危险操作不再逐次请示，但仍记审计 |
| 审计 | 谁在什么时候做了什么的记录 |
| 防注入 | 外部内容里夹带的指令不执行 |
| 技能 | AI 学会的一套做事方法，输入 `/` 选择 |
| 流水线（DAG） | 把一件事拆成多步并存下来，可以反复运行 |
| Build | 流水线跑一次的记录 |
| 今日 | 结果卡片的看板 |
| 定时任务 | 到点自动跑 |
| cron | 一种写时间的格式，如 `0 9 * * *` = 每天 9 点 |
| 探索空间 | 一个沙盒：AI 自己一回合一回合做下去，能用你账号有权限的所有能力，并给出网页报告 |
| 回合 | AI 完成一次完整回复算一个回合，中间可以调很多次工具 |
| token | 模型计量文字的单位，约 1 个 token ≈ 1.5 个汉字 |
| 节点 | 被接入、可被远程操控的一台 Windows 电脑 |
| 看门狗 | 节点上盯着程序的小守卫，卡死了自动拉起 |
| OCR | 把屏幕或图片里的字认出来 |
| 回收站 | 删除先放这里，能找回 |
| WSL | Windows 里运行 Linux 的官方功能，Windows 安装包靠它运行 |
| run / run_id | 一次「从开始到结束」的运行（一轮对话、一次流水线、一次定时触发、一个子代理……）和它的唯一编号 |
| 部分完成 | 没完全做完（迭代用尽或超时），但已带回已收集的资料 |
| 命令面板 | Ctrl/⌘+K 打开的跳转面板，输入功能名直达 |
| 告警 | 后台发现问题（任务失败、错误反复出现、预算快用完……）时给你的提醒，同类合并 |
| 自建折算 | 自建模型按等价价格估算的参考费用，不是实际花费 |
| 意图识别 | AI 动手前先理清你要什么、成功标准是什么 |

---

<sub>鸣跃智能体 Ultra · 飞天.锐出品 · 基于 LiteCode 底层基础架构 · 本说明书对应 v3.2.1「刃牙」。界面截图均来自隔离测试环境，数据为内置仿真业务系统与虚构数据。</sub>