# 让 AI 操作个人空间

以下是茄总对话中 Agent 的能力，不是沙箱应用的 `platform.*` API。应用仍然只能使用已经授权的 Bridge，也不能直接联网。

## 已经支持的操作

- 文件：搜索文件名、查看目录、创建目录、重命名、移动、删除普通文件和空目录。
- 知识库：读取、搜索、创建和更新笔记，创建目录、移动笔记及目录，收录文件、检查引用。
- 数据库：查询、添加、修改、删除记录；一次添加最多 50 条，任意一条无效时全部拒绝。
- 应用市场：搜索、查看详情、安装。安装创建独立的空数据集，不复制作者记录；重复安装保留现有应用与数据。
- 构建应用对话：创建表和应用、修改表结构、读取多文件源码和更新应用。读取源码默认返回文件清单，指定文件后分段读取，每次最多 40,000 个字符。

示例：“把旅行资料重命名为 2026 年旅行资料”“把这些账单整理成记录”“把这篇笔记移动到工作目录”。

## 图片与后续追问

对话附件支持图片内容理解。最近 20 条消息中，最多 4 张近期图片会继续附带原图内容，发送不含附件的追问也不会立刻丢失图片。每张图片最多 5MB；这项限制同时适用于 Web 和 iOS。

较早图片保留文件名称和编号；需要时 Agent 可以使用 `read_file` 重新读取图片像素，不需要为了阅读而收录进知识库。超出上下文窗口的文件可以先通过文件搜索找到，再按编号读取。每次模型请求最多附带 4 张图片，模型能否正确理解图片仍取决于所选模型的视觉能力。无法访问或不存在的当前附件会明确报错，不会假装已经读取。

## 直接执行，并继续后续步骤

Agent 调用写入工具时就会执行，并留下操作记录，然后继续完成同一段任务里的后续步骤。删除、移动、覆盖修改、批量添加、表结构调整、应用安装、发布，以及修改已经记住的信息，都按这个方式处理。模型不能通过额外参数跳过归属、空目录或冲突检查。

日常写入不会停下来等你逐项批准。只有确实需要你做决定时，Agent 才会在输入框旁边给出选项；你可以直接点一个选项，也可以不点，自己输入答复。Web 和 iOS 使用同一种方式。对话里不再使用「若干项操作需要关注」或查看、隐藏历史这套操作卡片。

一轮任务会一直做到 Agent 给出回复。如果连续处理了很多步还没结束，或者同一步骤反复没有成功，会先停下来。已经完成的修改都保留，你可以让它继续，或换个方式说明。

更早留下、尚未执行的记录不会在启动时自动补执行。这类记录如果已经超过 24 小时，或者对象已经变化，再次执行会被拒绝。字段删除会清除对应记录值，表结构修改不提供一键撤销。

## 操作记录和异常处理

每次写入都有操作记录。删除会话后，操作历史仍然保留。

| 状态 | 含义 |
| --- | --- |
| 等待你的确认 | 更早留下、尚未执行的记录。新的写入不会再停在这个状态 |
| 正在执行 | 可能仍在处理 |
| 已经完成 | 服务端已经执行成功 |
| 没有执行 | 执行前检查未通过 |
| 需要核对结果 | 请求中断，修改可能已经发生 |
| 已经取消 | 不会执行这项更早留下的待确认操作 |
| 已经恢复 | 已经恢复被删除的内容 |

重复提交相同请求不会重复执行。同一会话中仍未执行、正在执行或结果不确定的相同操作不会重新创建。结果不确定时只核对当前内容，不重新执行，也不会把相似内容误认为确定成功。

停止接收回复不代表取消服务端操作。当前不提供断线任务自动续跑或通用跨资源事务。

## 删除恢复

通过 Agent 删除的普通文件、空文件夹、空知识库目录、笔记和记录，可以告诉 Agent 恢复。文件内容与恢复资料私有保存，账号删除时一起清除。

恢复保留原 ID、内容和关联引用，不覆盖后来创建的内容。原目录不存在、数据表结构已经变化或原位置出现冲突时，会拒绝恢复并说明原因。需要先恢复原目录，再恢复其中的内容。

系统知识库根目录不能重命名或删除。普通文件工具不能修改知识库内部文件；应该通过知识库工具操作。此恢复范围仅限经过 Agent 操作记录删除的内容，不代表所有手动删除或覆盖编辑都可以撤销。

### 模型是否支持图片

图片识别能力取决于实际选择的模型。官方默认 DeepSeek Flash 支持图片；DeepSeek 官方接口的 `deepseek-v4-pro` 不支持图片。选择后者时，上传图片会收到明确的切换提示，不会将不能识别误报为上传失败；文字对话仍然可用。切换到「官方默认」后，可以继续询问近期已上传的图片，不需要重新上传，也不会清除保存的自定义模型配置。按需读取图片与知识库图片整理遵循相同检查。

此检查只针对已经确认的服务地址与模型组合；不能根据任意兼容接口的模型名称推断能力，也不表示所有自定义模型均已通过视觉验证。