项目
文件工作台与项目生命周期
浏览、搜索、预览和编辑项目文件，并理解临时目录、缓存和删除边界。
打开一个项目会话后，右侧 Workspace 面板以项目目录为根显示文件。
文件能力
| 能力 | 说明 |
|---|---|
| 文件树 | 按目录逐层浏览，并保留常用展开状态 |
| 搜索 | 在 Workspace 文件列表中筛选并展开匹配项 |
| 预览 | 打开文本、代码、Markdown、图片、HTML、PDF 和 Office 文件 |
| 编辑 | 直接编辑支持的文本、代码、Markdown 和 HTML |
| Diff | 查看 Agent 造成的文件变化，并使用可用的快照能力 |
| 导入 | 通过选择、粘贴或拖拽把文件复制到 Workspace |
| 加入聊天 | 把文件或目录作为消息上下文交给 Agent |
| 外部打开 | 在桌面端用 VS Code、终端或系统文件管理器打开长期项目 |
预览支持多个标签。相同项目的会话之间切换时，文件树和预览状态可以复用；切换到不同目录时会关闭旧项目预览，避免误看上一个项目的文件。
把文件交给 Agent
- 从文件树选择文件或目录并加入输入框；
- 拖入外部文件会把它复制到 Workspace，再用于消息；
- 引用目录时先确认范围，避免把缓存、依赖或隐私文件整体加入上下文；
- 大文件和二进制文件是否可读，取决于当前 Agent 和技能。
预览格式
SoniBot 可预览常见 Office 文件、PDF、代码、Markdown、HTML、图片与 Diff。部分格式由转换器生成预览，源文件不会因为预览而自动转换成另一种格式。
文本、Markdown、代码和 HTML 的编辑会真实写入项目目录。编辑前确认当前标签对应的路径。
临时 Workspace 与长期项目
| 特性 | 临时 Workspace | 用户项目 |
|---|---|---|
| 创建方式 | 不选择目录时自动创建 | 用户选择本地目录 |
| 侧边栏项目分组 | 通常不进入 Projects | 按路径分组 |
| 外部打开 | 通常隐藏 | 桌面端可用 |
| 长期成果 | 不推荐 | 推荐 |
重要成果应导出或移动到用户维护的长期目录。
路径与权限边界
项目根目录为文件 UI 和 Agent 提供工作上下文，但它不是绝对安全沙箱。真实文件操作仍取决于运行时、工具权限和软链接处理。
不要因为选择了一个项目，就假定 Agent 永远无法访问目录外文件。使用逐次确认、检查命令目标，并避免把家目录或磁盘根目录作为项目。
当前侧边栏按路径字符串识别项目。软链接路径、大小写差异或等价路径表达在少数情况下可能形成重复分组。
删除与恢复
- 在文件工作台删除文件会影响真实磁盘；
- 移除项目不会删除磁盘目录；
- 删除会话会删除消息与相关运行状态；
- Diff 和快照能力是否可恢复某次改动，取决于文件类型与当前快照状态；
- 执行大范围更改前，应使用版本控制或独立备份。