|
5 | 5 | ## 目录与子文档索引 |
6 | 6 | 当用户询问特定模块时,请使用 `readFile` 进一步读取对应的子文档: |
7 | 7 | 1. **基础概念与工作区**:见本文档第 1、2、3 节。 |
8 | | -2. **AI 提供商与模型配置 (Providers)**:请读取 `/root/.aicode/docs/providers-and-models.md` |
9 | | -3. **MCP 服务器与扩展工具 (MCP)**:请读取 `/root/.aicode/docs/mcp-and-skills.md` |
10 | | -4. **远程服务器与云端工作区 (Remote Servers)**:请读取 `/root/.aicode/docs/remote-servers.md` |
11 | | -5. **日志查看、私有目录挂载与后台保活**:请读取 `/root/.aicode/docs/logs-and-private-dir.md` |
12 | | -6. **容器镜像 (Container)**:请读取 `/root/.aicode/docs/container-image.md` |
13 | | -7. **备份与还原 (Backup)**:请读取 `/root/.aicode/docs/backup-and-restore.md` |
| 8 | +2. **AI 提供商与模型配置 (Providers)**:请读取 `~/.aicode/docs/providers-and-models.md` |
| 9 | +3. **MCP 服务器与扩展工具 (MCP)**:请读取 `~/.aicode/docs/mcp-and-skills.md` |
| 10 | +4. **远程服务器与云端工作区 (Remote Servers)**:请读取 `~/.aicode/docs/remote-servers.md` |
| 11 | +5. **日志查看、私有目录挂载与后台保活**:请读取 `~/.aicode/docs/logs-and-private-dir.md` |
| 12 | +6. **容器镜像 (Container)**:请读取 `~/.aicode/docs/container-image.md` |
| 13 | +7. **备份与还原 (Backup)**:请读取 `~/.aicode/docs/backup-and-restore.md` |
| 14 | +8. **Git 版本管理**:请读取 `~/.aicode/docs/git-page.md` |
14 | 15 |
|
15 | 16 | --- |
16 | 17 |
|
17 | | -## 1. 顶部标题栏与工作区 (Workspace) |
18 | | -在 App 的最顶部,显示着当前正在操作的“工作区”名称。 |
19 | | -* **如何切换**:点击顶部标题栏,会打开文件选择器。 |
20 | | -* **核心理念**:用户可以指定 Android 手机里的某个文件夹作为当前项目工作区。AI 所有的代码读写和执行命令,都被严密沙盒隔离在这个文件夹内,保证用户设备其余文件的绝对安全。 |
| 18 | +## 1. 顶部标题栏 (ChatHeader) |
| 19 | +App 最顶部是聊天页标题栏,包含: |
| 20 | +* **菜单按钮**(左上):打开侧边抽屉,管理会话列表、新建会话。 |
| 21 | +* **会话标题**:当前会话名称。 |
| 22 | +* **模型名**:当前启用的模型名称。 |
| 23 | +* **终端入口**:跳转到终端页。 |
| 24 | +* **Git 入口**:跳转到 Git 版本管理页。 |
| 25 | +* **新建会话**:开始一个新的聊天。 |
21 | 26 |
|
22 | 27 | --- |
23 | 28 |
|
24 | | -## 2. 左下角:核心模式切换按钮 (Plan vs Build) |
25 | | -在聊天输入框的左侧,有一个颜色可变的圆角按钮: |
26 | | -* **PLAN (紫色状态 - 计划模式)**:进入此模式后,系统物理级锁死 AI 的写操作权限。AI 只能进行代码阅读、检索和方案构思,绝不会修改任何文件。 |
27 | | -* **BUILD (绿色状态 - 构建模式)**:全功能模式,解锁写权限。AI 可以帮用户写文件、修改代码以及运行构建命令。 |
28 | | -* *提示:除了用户手动点按钮切换,AI 自己在规划清晰后,也可以通过调用 `switchMode` 工具向用户发送切换到 BUILD 模式的请求,用户在界面上一键批准即可。* |
| 29 | +## 2. 聊天输入框下方工具栏 |
| 30 | +输入框下方一行是操作工具栏,从左到右依次为: |
| 31 | +* **模式按钮**:点击在 BUILD → PLAN → AUTO 间循环切换(详见下节)。 |
| 32 | +* **模型按钮**:显示当前启用的 AI 模型,点击可快速切换模型或跳转到设置管理提供商。 |
| 33 | +* **工作区按钮**:显示当前工作区名称,点击弹出工作区管理面板(底部弹窗): |
| 34 | + * 列出所有已创建的工作区,点击切换。若当前有正在运行的 AI 会话或终端标签,会弹出确认框提示切换会停止它们。 |
| 35 | + * 可新建工作区(输入名称创建)。 |
| 36 | + * 可删除已有工作区。 |
| 37 | + * 工作区是 AI 操作的代码项目根目录,每个工作区对应手机上的一个独立文件夹,AI 的代码读写和命令执行都被沙盒隔离在当前工作区内。 |
| 38 | +* **文件按钮**(文件图标):上传文件作为附件,AI 可读取其内容。非忙碌时可用。 |
| 39 | +* **图片按钮**(图片图标):上传图片作为附件,AI 可识别图片内容。需当前模型支持图片输入,非忙碌时可用。 |
| 40 | +* **发送按钮**:发送当前输入;生成中变为停止按钮。 |
| 41 | +* 上传的附件会以预览卡形式显示在输入框上方,可移除后再发送。 |
29 | 42 |
|
30 | 43 | --- |
31 | 44 |
|
32 | | -## 3. 设置首页菜单项 |
| 45 | +## 3. 核心模式切换 (Plan / Build / Auto) |
| 46 | +工具栏左侧的模式按钮点击在三种模式间循环切换:**BUILD → PLAN → AUTO → BUILD**。 |
| 47 | +* **BUILD (构建模式)**:全功能模式,解锁写权限。AI 可以帮用户写文件、修改代码以及运行构建命令。 |
| 48 | +* **PLAN (计划模式)**:进入此模式后,系统物理级锁死 AI 的写操作权限。AI 只能进行代码阅读、检索和方案构思,绝不会修改任何文件。 |
| 49 | +* **AUTO (自动模式)**:权限全放行模式。所有工具调用(写文件、执行命令、终端操作等)自动批准,不弹权限确认窗。仅灾难性删除(`rm` 根目录/系统目录等)仍被拦截。该模式权限极大,适合用户已明确知晓风险、希望 AI 全自动完成批量任务的场景。 |
| 50 | +* *提示:除了用户手动点按钮切换,AI 自己在规划清晰后,也可以通过调用 `switchMode` 工具向用户发送切换模式的请求,用户在界面上一键批准即可。注意:AUTO 模式只能由用户在界面上手动进入,AI 无法通过工具切换到 AUTO;但处于 AUTO 模式时,AI 可通过 `switchMode` 切换到 PLAN 模式退出自动模式(这是 AI 退出 AUTO 的唯一路径)。* |
| 51 | + |
| 52 | +--- |
| 53 | + |
| 54 | +## 4. 设置首页菜单项 |
33 | 55 | “设置”首页以卡片列表呈现各二级入口,自上而下依次为: |
34 | 56 | * **AI 提供商**:显示已添加数量与当前启用提供商;进入「AI 提供商」二级页管理(详见 providers-and-models.md)。 |
35 | 57 | * **识图模型**:显示“跟随当前聊天模型”或专用提供商·模型;进入「识图模型」二级页。 |
|
46 | 68 |
|
47 | 69 | --- |
48 | 70 |
|
49 | | -## 4. 外观主题 |
| 71 | +## 5. 外观主题 |
50 | 72 | “设置”首页「外观主题」行内联下拉框切换 App 明暗外观: |
51 | 73 | * **自动**:跟随系统当前的明暗主题。 |
52 | 74 | * **深色**:固定使用深色主题。 |
|
55 | 77 |
|
56 | 78 | --- |
57 | 79 |
|
58 | | -## 5. 关于 (About) |
| 80 | +## 6. 关于 (About) |
59 | 81 | “设置”首页「关于」入口(图标为信息圆圈)。这是一个纯展示型页面,无任何持久化设置,点击进入后展示下列信息: |
60 | 82 | * **应用信息**:顶部卡片左侧显示 App 图标,右上为应用名 `AiCode`,右下为一句简介。 |
61 | 83 | * **版本(点击检查更新)**:单独一行卡片,显示当前版本号 `v<versionName>`(通过系统 PackageManager 读取,即对外发布版本,与 git tag `v<versionName>` 一致)。点击该行会自动通过 GitHub API `https://api.github.com/repos/jieapi/aicode/releases/latest` 查询最新 Release 的 tag,与当前版本号比对: |
|
0 commit comments