工作空间

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

什么是工作空间

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

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

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

如何选择工作目录

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

常见使用场景

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

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

AI 助手如何访问文件

设置工作空间后,AI 助手会在你授权的目录里读取和修改文件。常见操作示例:

读取文件

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

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

修改文件

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

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

浏览项目结构

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

AI 助手会遍历目录并给出结构化的分析。

创建新文件

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

AI 助手会在工作目录中创建新文件。

安全与权限

访问范围限制

  • AI 助手 只能访问你选择的工作目录及其子目录
  • 无法访问工作目录之外的文件

操作确认

  • AI 助手在进行文件写入操作时,会在对话中说明即将修改的内容
  • 你可以继续追问并要求它先预览再落盘

数据安全

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

最佳实践

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