项目与工作区
项目用于把同一份代码目录下的多次任务组织在一起。每个项目可以关联一个或多个执行设备上的目录。
使用现有目录
本机项目选择 使用现有目录 后,Wework 会打开系统目录选择器。再次添加同一目录时,Wework 会复用已有项目;如果项目曾被移除,则会恢复项目及其历史会话。
在本地模式中,点击 本地项目 后,可以在系统目录选择器里同时选择多个目录。该入口始终使用本机执行设备,即使当前还连接了云设备或远程设备;如需选择其他设备上的目录,请使用 云端项目。选完目录后,创建项目弹窗会默认使用第一个源目录的文件夹名作为项目名称,你也可以修改名称或继续添加、移除源目录;确认后,Wework 会把这些目录保存为同一个 Codex 项目,并使用第一个目录作为项目列表和新任务的默认工作区。项目列表只显示一条项目记录,不会展开全部源目录。通过项目菜单中的 编辑项目 可以重命名项目、添加或移除源目录,以及调整主目录。该能力目前仅支持本机 Codex 项目,云端和远程项目仍按单目录添加。
如果连接的云端设备和当前 Wework 本机执行器指向同一个工作区,随后再把该目录添加为本地项目时,项目列表会把本地和云端记录合并为一条。合并以执行器身份、规范化后的工作区路径、工作区类型和 Worktree 为依据;重启 Wework 后仍保持一条项目记录,云端已有任务也会继续显示在该项目下。
从项目列表移除本机项目不会删除磁盘目录。
关联项目空间
开启 设置 → 通用 → 实验性功能 后,可以在本地项目的 编辑项目 对话框中设置 自动加入项目空间。本地项目是代码与执行工作区,项目空间是任务跟进与协作看板;两者是关联关系,不会互相替代,也不会移动或复制项目文件。
为本地项目选择项目空间后,从该项目开启的新对话会继承这个默认值。发送第一条消息前,输入框底部会显示 加入看板 · 项目空间名称;发送后,Wework 会在对应的本地或云端项目空间中创建任务并关联当前对话。重复同步同一对话不会创建重复看板任务。
默认项目空间是本地项目自身的设置,保存在对应设备的本地项目状态中,不需要项目空间保存反向关联。也可以在发送前通过输入框的 + 菜单为当前对话临时选择、切换或取消项目空间。
项目空间自动化
项目空间看板提供 自动化 页签,用于统一管理机器人成员和执行队列。
机器人成员
拥有项目权限的成员可以添加机器人(AI 成员),并为每个机器人配置名称、模型、系统提示词、可见范围、执行环境(本机或云端)和执行模式。指派给机器人的任务会由对应机器人自动执行。
执行队列
执行队列按列展示等待执行和执行中的任务:
- 我的待办:指派给当前用户且尚未完成的任务。
- 每个机器人一列:指派给该机器人的执行任务。
队列支持按执行状态筛选(待审批、排队、已领取、执行中、失败)和按标题搜索;执行中的任务显示旋转状态图标。设置为人工审批的机器人,任务会先进入待审批状态,审批通过后开始执行。
自动化页签仅对本地、GitHub 和 GitLab 项目空间开放;钉钉多维表格项目空间的数据在外部表格中维护,不显示该页签。
从输入区创建项目
在新对话输入框上方打开项目选择器,可以新建空白项目或添加现有目录。创建完成后,新项目会同时出现在左侧项目列表和输入框上方,并立即成为当前新对话的项目工作区。
如果先切换到不使用项目的普通对话,再点击左侧对应项目的 新对话,Wework 会创建一个新的项目对话并重新选中该项目,不会复用普通对话的输入或会话状态。
创建 Git 项目
- 新建项目并选择 Git 仓库。
- 选择执行设备。
- 选择仓库和默认分支。
- 确认项目名称和目标目录。
- 等待克隆完成。
如果仓库列表为空,在设置中检查 Git 服务连接和 Token 权限。目标目录已存在时,请选择现有目录,或更换新项目的目标目录。
普通工作区与 Worktree
- 普通工作区:任务直接使用项目目录,适合串行处理和小规模修改。
- Worktree:每个任务使用独立的 Git 工作树,适合并行开发和需要隔离分支的任务。
使用 Worktree 时,文件树、终端和内置开发工具都会打开当前任务的工作树路径。归档任务前应先提交或保存仍需保留的修改。
在不同设备上使用项目
同一个项目可以关联本机、云设备或远程设备上的不同目录。新建任务时选择实际存放代码的设备。复制任务到另一台设备时,需要为目标设备选择对应的项目目录。
从终端打开项目
macOS 桌面版会安装 wework 命令。可以在终端中运行:
wework .
wework /path/to/project
Wework 会打开指定目录;应用已经运行时会复用现有窗口。