工作空间
工作空间是 JAcoworks 最强大的功能之一——让 AI Agent 直接访问你的本地文件,实现真正的协同编程和文件处理。
什么是工作空间
工作空间是你指定的一个本地目录。设置后,AI Agent 可以:
- 读取文件: 查看你的代码、文档、配置文件等
- 写入文件: 创建新文件或修改已有文件
- 浏览目录: 了解项目结构
这意味着你可以让 Agent 像一个真正的协作者一样参与你的工作——阅读你的代码、帮你重构、编写文档,而不仅仅是在对话框中给出建议。
如何选择工作目录
- 点击顶部工具栏的 文件夹图标
- 在系统文件选择器中浏览并选择目标目录
- 选择后,工具栏会显示当前工作目录名称
常见使用场景:
选择项目根目录: ~/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 的部分是对话上下文中引用的文件片段
- 工作空间路径保存在本地会话数据中,不会上传到服务器
- 建议避免将包含敏感凭证的目录设为工作空间
最佳实践
- 选择合适的粒度: 选择项目根目录通常是最佳选择,Agent 可以理解完整的项目上下文
- 版本控制: 建议在有 Git 版本控制的目录中使用,便于追踪 Agent 的修改
- 先备份: 对于重要项目,建议在让 Agent 大规模修改前先提交当前更改
- 具体指示: 明确告诉 Agent 要操作哪些文件,避免模糊指令导致意外修改