项目与长期上下文
在工作区内用项目组织相关会话,共享工作目录、素材与长期记忆,让每次对话都从正确的背景开始。
项目如何工作
项目是工作区内部的一个文件夹,用来把相关会话和它们共享的素材与背景收在一起。
工作区之间是整套配置相互隔离;项目位于某个工作区之内,沿用该工作区的来源、技能与设置。
会话绑定到项目之后,会继承项目的工作目录,并在系统提示中带上项目上下文。
Agent 因此能在正确的位置、以正确的背景开始工作,手边看到的材料也是对的。
| 能力 | 说明 |
|---|---|
| 工作目录 | 绑定到项目的会话自动使用该项目的工作目录 |
| 项目上下文 | 每个绑定会话的系统提示中都会注入项目上下文 |
| 项目素材 | 项目文件夹下的文件通过素材清单提供给 Agent |
| 长期记忆 | 可选的 MEMORY.md,Agent 在每轮对话中都可以读取 |
| 分组与筛选 | 会话列表可以按项目分组,或只显示某一个项目 |
项目存储
项目保存在工作区目录下,结构简单,可以直接查看和备份。
会话通过项目标识引用项目;删除项目后,原本绑定它的会话仍然保留在列表中,只是解除了绑定关系。
~/.zero-works/workspaces/{workspace-id}/projects/{project-slug}/ ├── config.json # 项目配置(名称、说明、工作目录) ├── MEMORY.md # 可选的长期项目记忆 └── assets/ # 通过素材清单提供的文件
创建项目
- 在侧栏进入项目列表,选择新建项目。
- 填写项目名称和一句说明,并选择这个项目对应的工作目录。
- 保存后项目出现在列表中,新建对话时可以在输入区直接选中它。
把会话绑定到项目
新建对话时在输入区选择项目,会话随后会使用该项目的设置,并在会话列表与项目筛选结果中归到同一组下面。
- 以项目的工作目录作为默认位置,命令和文件操作都从这里开始。
- 系统提示中收到项目名称、说明、工作目录、MEMORY.md 摘要和素材清单。
- 在会话列表与按项目筛选的结果中归入该项目。
- 已经存在的会话,可以从会话菜单移动到另一个项目。
项目上下文:目标、约定与人员
每个绑定到项目的会话,系统提示开头都会拿到一段项目上下文。
这段上下文包含项目名称与说明、工作目录、MEMORY.md 的节选,以及项目文件夹下的素材清单。
MEMORY.md 适合放长期有效的背景:产品目标、团队约定、关键人员与分工,以及任何值得沿用的结论。
它在每一轮对话中都可以被读取,因此要保持简短——注入的内容有长度上限,过长的文件会被截断。
# 项目记忆 ## 产品目标 - 本季度末交付报表看板 v2 - 所有图表补齐无障碍支持 ## 约定 - 新组件统一放在 src/components/,并使用 TypeScript - 测试使用 Vitest,不要提交 .only ## 人员 - 设计负责人:Sam,视觉决策在群内同步
分组与筛选
会话列表支持按项目分组,也可以筛选到某一个项目;多个项目并行推进时,这样更容易定位当前上下文。
- 会话列表:按项目分组,或筛选为单个项目。
- 筛选生效时新建的对话会自动归入当前项目。
- 项目与来源、技能一样属于工作区,切换工作区就会切换到另一批项目。
提示
- 一个代码仓库对应一个项目:工作目录天然对齐,MEMORY.md 正好用来记录仓库约定。
- 让 MEMORY.md 保持简短有效:注入内容有长度上限,过时的结论请及时删除。
- 用清晰的名称区分并行推进的项目:名称是列表里最可靠的区分依据。