选择与切换工作区
目标：为项目选择正确的文件位置，并让编辑、命令和预览访问同一份文件。
打开
选择存储位置
| 工作区 | 适合场景 | 需要留意 |
|---|---|---|
| 共享存储目录 | 文档、静态网页、与其他应用共享文件 | 通过系统目录授权；Unix 权限、符号链接和执行能力受限 |
| PRoot 内部目录 | 包含依赖、符号链接、可执行文件的 Linux 项目 | 先选择 Linux ID，再选择内部目录；卸载会删除应用私有数据 |
在工作区选择器中选择“共享存储”或“proot”。PRoot 工作区通过应用私有文件系统访问，通常不需要共享存储授权。不要将 Android 上的显示路径、Linux 内路径、Termux 私有路径当成同一个位置。
验证当前目录
选择后让 AI 列出根目录并读取一个已知文件。工作区文件工具使用相对路径，例如 src/main.js，根目录使用 .。不要向 read_file 传入 /storage/... 或 Termux 私有路径。
当工作区可直接访问时，PRoot 命令可通过 /workspace 访问它。仅有文档提供器 URI 的目录不一定能绑定到 Linux；遇到此问题，使用 PRoot 内部工作区，或可直接访问的共享存储目录。
文件与编辑器入口
侧栏文件管理器负责双栏浏览和整理，代码编辑器负责手动与 AI 编辑。它们的打开路径与当前会话工作区应分别核对。
让 AI 修改已有文件时，先读取目标片段，再使用精确替换或行范围编辑，完成后按变更审查核对结果。
工作区外的文件
global_* 工具处理 Android 共享存储中的工作区外文件，需要对应权限，且仍有限制目录。它们不会获得其他应用私有数据的访问权。优先通过选择正确工作区来完成项目任务，扩大范围时核对绝对路径。
常见问题
- 看不到刚创建的文件： 核对当前会话、工作区、Linux ID，以及文件是否保存在另一套环境。
- 依赖安装失败或符号链接错误： 将项目和依赖放入 PRoot 内部目录；共享存储不提供完整 Linux 文件系统语义。
- 目录授权失效： 在系统选择器重新授权，再列目录验证。
- 删除 Linux 环境前： 先单独备份其中项目；普通应用备份不包含 rootfs。
路径实现和测试见工作区与运行时。