跳到主要内容

项目与工作区

项目用于把同一份代码目录下的多次任务组织在一起。每个项目可以关联一个或多个执行设备上的目录。

使用现有目录

本机项目选择 使用现有目录 后,Wework 会打开系统目录选择器。再次添加同一目录时,Wework 会复用已有项目;如果项目曾被移除,则会恢复项目及其历史会话。

在本地模式中,点击 本地项目 后,可以在系统目录选择器里同时选择多个目录。该入口始终使用本机执行设备,即使当前还连接了云设备或远程设备;如需选择其他设备上的目录,请使用 云端项目。选完目录后,创建项目弹窗会默认使用第一个源目录的文件夹名作为项目名称,你也可以修改名称或继续添加、移除源目录;确认后,Wework 会把这些目录保存为同一个 Codex 项目,并使用第一个目录作为项目列表和新任务的默认工作区。项目列表只显示一条项目记录,不会展开全部源目录。通过项目菜单中的 编辑项目 可以重命名项目、添加或移除源目录,以及调整主目录。该能力目前仅支持本机 Codex 项目,云端和远程项目仍按单目录添加。

如果连接的云端设备和当前 Wework 本机执行器指向同一个工作区,随后再把该目录添加为本地项目时,项目列表会把本地和云端记录合并为一条。合并以执行器身份、规范化后的工作区路径、工作区类型和 Worktree 为依据;重启 Wework 后仍保持一条项目记录,云端已有任务也会继续显示在该项目下。

从项目列表移除本机项目不会删除磁盘目录。

关联项目空间

开启 设置 → 通用 → 实验性功能 后,可以在本地项目的 编辑项目 对话框中设置 自动加入项目空间。本地项目是代码与执行工作区,项目空间是任务跟进与协作看板;两者是关联关系,不会互相替代,也不会移动或复制项目文件。

为本地项目选择项目空间后,从该项目开启的新对话会继承这个默认值。发送第一条消息前,输入框底部会显示 加入看板 · 项目空间名称;发送后,Wework 会在对应的本地或云端项目空间中创建任务并关联当前对话。重复同步同一对话不会创建重复看板任务。

默认项目空间是本地项目自身的设置,保存在对应设备的本地项目状态中,不需要项目空间保存反向关联。也可以在发送前通过输入框的 + 菜单为当前对话临时选择、切换或取消项目空间。

项目空间自动化

项目空间看板提供 自动化 页签,用于统一管理机器人成员和执行队列。

机器人成员

拥有项目权限的成员可以添加机器人(AI 成员),并为每个机器人配置名称、模型、系统提示词、可见范围、执行环境(本机或云端)和执行模式。指派给机器人的任务会由对应机器人自动执行。

执行队列

执行队列按列展示等待执行和执行中的任务:

  • 我的待办:指派给当前用户且尚未完成的任务。
  • 每个机器人一列:指派给该机器人的执行任务。

队列支持按执行状态筛选(待审批、排队、已领取、执行中、失败)和按标题搜索;执行中的任务显示旋转状态图标。设置为人工审批的机器人,任务会先进入待审批状态,审批通过后开始执行。

自动化页签仅对本地、GitHub 和 GitLab 项目空间开放;钉钉多维表格项目空间的数据在外部表格中维护,不显示该页签。

从输入区创建项目

在新对话输入框上方打开项目选择器,可以新建空白项目或添加现有目录。创建完成后,新项目会同时出现在左侧项目列表和输入框上方,并立即成为当前新对话的项目工作区。

如果先切换到不使用项目的普通对话,再点击左侧对应项目的 新对话,Wework 会创建一个新的项目对话并重新选中该项目,不会复用普通对话的输入或会话状态。

创建 Git 项目

  1. 新建项目并选择 Git 仓库
  2. 选择执行设备。
  3. 选择仓库和默认分支。
  4. 确认项目名称和目标目录。
  5. 等待克隆完成。

如果仓库列表为空,在设置中检查 Git 服务连接和 Token 权限。目标目录已存在时,请选择现有目录,或更换新项目的目标目录。

普通工作区与 Worktree

  • 普通工作区:任务直接使用项目目录,适合串行处理和小规模修改。
  • Worktree:每个任务使用独立的 Git 工作树,适合并行开发和需要隔离分支的任务。

使用 Worktree 时,文件树、终端和内置开发工具都会打开当前任务的工作树路径。归档任务前应先提交或保存仍需保留的修改。

在不同设备上使用项目

同一个项目可以关联本机、云设备或远程设备上的不同目录。新建任务时选择实际存放代码的设备。复制任务到另一台设备时,需要为目标设备选择对应的项目目录。

从终端打开项目

macOS 桌面版会安装 wework 命令。可以在终端中运行:

wework .
wework /path/to/project

Wework 会打开指定目录;应用已经运行时会复用现有窗口。