工作空间

工作空间是 JAcoworks 最强大的功能之一——让 AI Agent 直接访问你的本地文件,实现真正的协同编程和文件处理。

什么是工作空间

工作空间是你指定的一个本地目录。设置后,AI Agent 可以:

  • 读取文件: 查看你的代码、文档、配置文件等
  • 写入文件: 创建新文件或修改已有文件
  • 浏览目录: 了解项目结构

这意味着你可以让 Agent 像一个真正的协作者一样参与你的工作——阅读你的代码、帮你重构、编写文档,而不仅仅是在对话框中给出建议。

如何选择工作目录

  1. 点击顶部工具栏的 文件夹图标
  2. 在系统文件选择器中浏览并选择目标目录
  3. 选择后,工具栏会显示当前工作目录名称

常见使用场景

选择项目根目录:  ~/Projects/my-app
选择文档目录:    ~/Documents/reports
选择特定子目录:  ~/Projects/my-app/src

你可以随时切换工作目录,切换后 Agent 将访问新目录。

Agent 如何访问文件

Agent 在本地模式下通过 sidecar 进程直接操作文件系统。常见操作示例:

读取文件

请阅读 src/index.ts 并解释这段代码的作用

Agent 会读取指定文件内容,然后给出分析。

修改文件

在 README.md 中添加安装说明部分

Agent 会读取现有内容,生成修改后的版本并写入文件。

浏览项目结构

列出当前项目的目录结构,帮我理解代码组织方式

Agent 会遍历目录并给出结构化的分析。

创建新文件

帮我创建一个 .gitignore 文件,适用于 Node.js 项目

Agent 会在工作目录中创建新文件。

安全与权限

访问范围限制

  • Agent 只能访问你选择的工作目录及其子目录
  • 无法访问工作目录之外的文件
  • 无法执行系统命令或访问系统文件

操作确认

  • Agent 在进行文件写入操作时,会在对话中明确告知即将进行的更改
  • 你可以在 Agent 操作前审查其计划

数据安全

  • 文件内容在本地处理,仅发送给 LLM 的部分是对话上下文中引用的文件片段
  • 工作空间路径保存在本地会话数据中,不会上传到服务器
  • 建议避免将包含敏感凭证的目录设为工作空间

最佳实践

  1. 选择合适的粒度: 选择项目根目录通常是最佳选择,Agent 可以理解完整的项目上下文
  2. 版本控制: 建议在有 Git 版本控制的目录中使用,便于追踪 Agent 的修改
  3. 先备份: 对于重要项目,建议在让 Agent 大规模修改前先提交当前更改
  4. 具体指示: 明确告诉 Agent 要操作哪些文件,避免模糊指令导致意外修改