项目
项目是你计算机上一个由 OpenChamber 追踪的文件夹 — 通常是一个代码库。切换项目会切换智能体工作所在的文件夹,以及该项目的会话和设置。
添加项目
你可以从几个地方添加项目:
- 命令面板中的 Add project 条目
- 会话侧边栏顶部的 + 按钮
- 选择目录时的文件夹浏览器
将它指向一个文件夹,OpenChamber 就会记住它。名称来自文件夹;你之后可以更改它。
切换项目
从侧边栏选择一个项目使其成为活动项目。一切 — 会话、git、笔记 — 都会跟随你打开的项目。
让项目易于辨认
打开 Settings → Projects 为项目设置自定义名称、颜色或图标。OpenChamber 会尝试自动查找图标 — 参阅 项目图标。
在 VS Code 中,OpenChamber 始终使用你打开的文件夹作为唯一的项目,因此没有要添加或切换的内容。Projects 设置页面在那里是隐藏的。
项目环境
如果项目的工具来自 direnv、devenv 或 Nix shell,Git 钩子、终端和项目操作自己是找不到它们的。打开 设置 → 项目,选择项目,然后在 环境 下:
- 添加只有这个项目需要的变量
- 或者设置一条输出这些变量的 环境命令,例如
direnv export json或devenv print-dev-env --json
命令在项目文件夹中运行;对于 worktree,则在该 worktree 自己的文件夹中运行。当你提交、打开终端或运行操作时,如果上次运行已过去几分钟,它会重新运行;点击 重新运行 会立即运行。仅仅打开项目并不会运行它。输入框下方会显示上次运行添加了多少个变量,或者失败的原因。运行失败时不会添加任何变量,Git 和终端照常工作。
这些变量会传给 Git、终端和项目操作,并叠加在 设置 → 通用 → 环境变量 中的变量之上(参阅环境变量)。OpenCode 用一个进程服务所有项目,所以它拿不到项目变量:智能体需要的变量请放在通用列表里。
这条命令只能由你自己设置。它不会从仓库中读取,所以克隆下来的仓库无法让 OpenChamber 运行任何东西。
相关内容
- 聊天 — 不属于项目的会话,适合随手提问
- 项目笔记、待办与计划 — 为每个项目保留工作笔记
- 项目操作 — 保存你经常运行的命令
- 上下文 — 查看会话占用了模型多少记忆