文件浏览与代码编辑

侧边栏顶部的「文件」标签页用来浏览当前工作区，点文件会打开全屏的代码编辑页。本地工作区和远程 SSH 工作区都支持，读写方式按当前模式自动决定。

浏览文件

「文件」页是一棵从工作区根就地展开的缩进文件树。

• 第一行是工作区根 workspace，它自己也能折叠展开（默认展开），右侧有个刷新按钮。
• 点目录在原地展开或折叠，点文件直接打开编辑页——不用一层层"进入下一级、返回上一级"。
• 目录排在文件前面，同类按名称排序。
• 文件按类型显示不同图标，主流语言（PHP、Java、Python、JS/TS、Go、Rust、C/C++、Kotlin 等）有各自的彩色图标。
• 着色规则类似 VS Code：. 开头的隐藏文件显示为浅色弱化，被工作区根 .gitignore 命中的条目显示为橙色（只看根目录的 .gitignore，不解析子目录里的）。
• 路径很深或文件名很长也不怕：整棵树共享一个横向滚动，名称不会截断成省略号，左右滑动就能看全。
• 你展开或折叠过的目录会按工作区记住，关掉 App 再打开、或者切走再切回同一个工作区，都会恢复上次的展开状态。
• 浏览范围限定在工作区内，不能退到工作区外面。

从对话里点开文件

AI 在对话中引用代码时会把路径写成可点击的链接（带下划线的 文件路径:行号）。点这类链接会直接打开编辑页，带行号的还会自动滚动到那一行。

支持工作区内的文件、AI 配置目录（~/.aicode/...）以及容器系统文件（/etc/...、/root/...），远程 SSH 工作区下同样可点开。指向普通网址的链接不受影响，仍然用系统浏览器打开。

点到不存在的路径、目录，或超过大小上限的文件时，编辑页会给出对应的失败提示。

列表刷新

本地工作区下文件变动会自动刷新，不限于 AI 改的——你在终端里跑命令、或者用别的 App 改动同样会被感知。

它监听的是工作区根和当前所有已展开的目录，不递归整棵树，所以大仓库下也不会吃掉大量系统资源；折叠某个目录后就不再监听它。

另外两个刷新时机：每次打开侧边栏会重读一次；工作区根那行右侧的刷新按钮可以随时手动重读。

远程 SSH 工作区无法监听远程文件系统的变动，只能靠这两个时机刷新，发现列表和实际不符时点一下刷新按钮。远程模式下读目录要走网络，可能有短暂的加载状态，失败时会在列表位置显示具体原因。

新建、重命名、删除

长按目录行（包括最顶部的工作区根），从底部菜单里选「新建文件」或「新建文件夹」，新建的条目落在该目录下。如果长按的是折叠状态的目录，会先自动展开好让你看到结果。

名称只能是单个条目名：含 /、\ 或者是 .、.. 时确认按钮点不动——避免一不小心创建到别的目录去。同名条目已存在或目录不可写时会提示失败，不会覆盖原有文件。

长按文件或子目录行可以重命名和删除（工作区根节点只能新建）：

• 重命名：只在同一目录内改名，不做跨目录移动。
• 删除：文件直接删除；文件夹会连同里面全部内容递归删除，所以会先弹确认框。

删除不可撤销

删除不进回收站，也不受检查点保护。确认前想清楚，尤其是删文件夹。

代码编辑页

点文件后侧边栏收起，进入全屏编辑页。

顶部左上是返回，右上依次是撤销、重做、保存、设置。撤销和重做在没有可操作内容时置灰，保存按钮只在有未保存改动时可点。

• 撤销按输入停顿分步：连续快速输入算一步，停顿约半秒后再输入就算新的一步。一路撤销回打开时的样子后，文件名前的星号消失、保存按钮置灰，此时退出也不会再问你要不要保存。
• 打开 Markdown 文件时，撤销按钮左边会多一个预览切换按钮，点一下切到渲染效果，再点切回源码。预览和源码共用同一编辑状态，切换不会丢失未保存的修改。
• 导航栏下面有一条文件名小栏：左边是文件名（有未保存改动时前面加星号），右边是光标的行列位置和文件编码。
• 底部快捷符号栏可横向滚动，最左是缩进（Tab）和光标左右移动，后面是编程常用符号（括号、引号、运算符、; : | & 等），点一下就在光标处插入。软键盘弹出时符号栏会浮在键盘上方。
• 有未保存改动时，点返回或按系统返回键会先弹确认框，可以选「不保存」或「保存并退出」。

语法高亮

内置了这些语言：Kotlin、Java、Python、JavaScript/JSX、TypeScript/TSX、JSON/JSONC、YAML、Shell、Go、Rust、C/C++、CSS、XML、HTML、Markdown、PHP、Lua。.kts 按 Kotlin 高亮。未识别的类型按纯文本显示，不影响编辑。

配色用的是 VS Code 默认主题（深色 Dark+ / 浅色 Light+），随应用主题自动切换，编辑过程中切主题不会丢失未保存的内容。

编辑器设置

点右上角设置按钮进入独立的设置页，改动即时生效并记住，下次打开沿用：

• 字体大小：滑块调节。
• 自动换行：开启后长行折行显示，不再横向滚动。
• 显示缩进参考线：默认开启。
• 显示自动换行箭头：自动换行开启时在折行处画指示箭头，默认关闭。
• 显示空白符号：把空格、Tab、换行可视化，默认关闭。

保存与并发

保存是整份覆盖写回，成功后提示「已保存」。

不做外部并发检测

AI 工具或终端可能同时在改同一个文件，而保存会直接用编辑器里的内容覆盖，不会提示文件已被外部改动。如果你和 AI 可能同时动同一个文件，先让一方改完再动手，避免互相覆盖。

限制

• 文件大小上限 2 MB。超过的不打开——内容需要整份读进内存，再大会明显卡顿甚至崩溃。
• 不支持二进制文件。打开时会嗅探文件开头，识别为二进制（图片、可执行文件、压缩包等）会直接提示，不会把乱码当文本载入。