跳到主要内容

项目与工作区

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

使用现有目录​

项目列表为空时,左侧栏的 项目 分组会直接显示 + 新建项目。点击后选择 本地项目 或 云端项目;云端项目仍需先连接云端。项目数据同步期间不会显示这个空状态入口,避免把尚未加载完成误判为没有项目。

本机项目选择 使用现有目录 后,Wework 会打开系统目录选择器。确认创建会保存一个独立项目,多个项目可以共用相同的源目录。已有项目可直接从项目列表选择,无须再次创建。即使源目录位于 Codex 目录下,已注册项目仍会显示在项目列表中,刷新或重启后也会保留。

在本地模式中,点击 本地项目 后,可以在系统目录选择器里同时选择多个目录。该入口始终使用本机执行设备,即使当前还连接了云设备或远程设备;如需使用其他设备,请选择 云端项目,然后打开已有目录、新建空项目,或输入 Git 仓库地址在目标设备上克隆。Git 项目默认使用仓库名作为目录名,也可以指定分支和目标父目录。提交克隆后弹窗会立即关闭,项目列表会显示克隆进度;失败时可以直接重试或移除记录。

在云端项目创建弹窗中,如果选择的是当前 Wework 的本机执行设备,选择已有和 新建也会打开系统目录选择器;云设备和远程设备继续使用应用内目录选择器,因为 目录必须由对应执行设备读取和创建。桌面自动化环境同样保留应用内选择器,以便 CI 可以稳定控制和验证该流程,普通用户启动的 Wework 不使用这条自动化兼容路径。

选完本地目录后,创建项目弹窗会默认使用第一个源目录的文件夹名作为项目名称,你也可以修改名称或继续添加、移除源目录;确认后,Wework 会把这些目录保存为同一个 Codex 项目,并使用第一个目录作为项目列表和新任务的默认工作区。项目列表只显示一条项目记录,不会展开全部源目录。通过项目菜单中的 编辑项目 可以重命名项目、添加或移除源目录,以及调整主目录。多目录能力目前仅支持本机 Codex 项目,云端和远程项目仍按单目录添加。

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

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

关联项目空间​

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

创建本地或云端项目空间​

协作页左侧固定显示当前设备的 本地空间。本地空间为空时,引导会提供 添加文件夹;选择目录并确认项目名称后,Wework 会先把目录注册为任务项目, 再把它加入本地空间。云端项目仍通过云端空间创建,创建界面会明确显示实际保存位置:

  • 本地项目保存在当前设备,只能在这台设备上使用。
  • 云端项目保存在 Wegent 云端,可在登录同一账号的设备间协作。未登录时选择该入口会先打开登录流程;登录后如果还没有云端空间,Wework 会先创建云端空间,再继续创建项目。

创建云端空间时,按钮会显示 正在创建…,请求完成前不能重复提交。创建失败时, 弹窗会显示错误并保留已填写的内容,可以修改后重试;保存成功后会进入新空间, 或继续之前发起的项目创建。

保存位置在项目创建后不可更改。任务来源(内置任务、GitHub 或 GitLab)只决定任务数据从哪里读取,不会改变项目的本地或云端保存位置。

从模板创建云端协作项目​

在新建项目中通过 从模板发现 选择模板后,模板自带的智能体会使用当前设备和该设备的默认模型。当前设备必须在线,且登录账号具有使用权限;向已有项目导入模板时,还必须具有该项目的设备授权。同一桌面的历史离线设备记录不会阻止创建,也不会被选为执行设备。

如果仍提示当前执行设备不可用,请检查当前设备的云端连接和使用权限;如果同一桌面同时存在多条在线匹配记录,需要先确认实际使用的执行设备。

选择模板后,创建按钮会等待执行设备列表加载完成。加载失败时,执行环境区域会显示错误和 重试 入口;重新加载成功后即可继续创建。

设置本地项目协作者​

Wework 会在本地空间中自动维护 当前设备智能体,无需用户先创建智能体。新建本地项目时,项目协作者默认包含 我 和 当前设备智能体;创建前可以移除智能体,也可以通过 添加协作者 再次加入。创建项目不会自动创建协作小组。

选择两个及以上智能体时,创建界面会建议把协作者组织成协作小组。确认后,可以选择生成模型,并在任务输入区补充协作要求;Wework 会逐步生成负责人、成员职责、分配原则和建议流程。生成结果可在保存前直接编辑,保存后也可以在项目设置中继续调整。

在项目中使用空间智能体​

在空间的 设置 → 协作参与者 → 智能体 中创建或添加智能体后,项目管理员可以直接在新建或已有 Issue 的 负责人 → 空间智能体 中选择它。保存分配时会先将智能体加入项目,再分配并执行任务。也可以通过 项目设置 → 智能体 → 添加智能体 → 已有智能体 提前加入项目,供成员分配或通过 @ 提及调用。目录使用创建时填写的显示名称;未设置显示名称时使用资源名称。

本地空间会将智能体配置保存到项目,保留资源名称、显示名称、模型策略和工具配置。云端空间共享授予使用权限,项目绑定决定该智能体在哪个项目可用;共享不会授予源智能体的编辑权限。执行前仍需配置项目可用的设备和模型。

添加和创建智能体​

添加智能体时,可以搜索已有智能体的名称或所属空间,也可以进入新建表单。 新建智能体默认使用 自动选择 执行环境,并选中可用云端模型列表的第一项; 基本信息页底部会显示当前环境和模型,无需先打开运行设置即可创建。

需要调整时,打开 运行设置。执行环境依次提供 自动选择、运行时选择 和 指定设备;指定设备先展示项目共享设备,再展示个人设备。列表支持按名称或 设备 ID 搜索,默认只展示在线设备,勾选右下角 显示离线设备 可查看其他设备。 选择具体设备后,模型列表才会补充该设备的本地模型。修改已有智能体时保留其已保存的选择。

云端模型请求超过 10 秒会结束并释放缓存中的待处理请求,之后刷新会重新请求。 设备的本地模型目录加载失败或未返回时,仍可选择并保存云端模型。协作小组的成员列表独立加载; 加载成员失败会显示重试入口,已加载的小组、智能体和小组保存操作仍可使用。

项目基本设置先展示项目属性;展开 标签 后才读取任务标签,加载失败可原地重试。 标签加载完成后,仍可管理任务中使用的标签;重命名和删除会同步更新相关任务。

设置云端看板权限​

云端项目只有 私有 和 公开 两种访问方式。公开项目可为所有登录用户授予 Viewer(只读)或 Developer(可创建和修改 Issue)角色;私有项目只允许已有授权的用户进入。项目角色统一为 Owner、Maintainer、Developer、Viewer。Owner 管理项目和成员,Maintainer 还可管理 Issue 安全级别;Developer 及以上可以指派负责人,Issue 创建者也可以指派自己的 Issue。

Issue 的可见范围在创建项目、项目设置和单个 Issue 中配置。创建时可选择新 Issue 默认是 项目成员可见 还是 仅相关人员可见;Maintainer 可在项目设置或 Issue 中调整。Owner 和 Maintainer 可查看全部 Issue,其余用户只可查看公开给项目成员的 Issue,或与自己相关的 Issue。相关人员包括创建者、负责人、协作者、有效任务关联用户,以及被指派机器人的创建者。无关 Issue 不会出现在看板、表格、执行列表或项目会话中,直接打开也会显示为不存在。

钉钉多维表格的记录权限由钉钉控制;Wework 的项目角色控制表格入口与编辑操作。

向本地空间导入后续项目​

任务页中的本地项目在首次初始化时会自动加入本地空间。之后需要继续添加项目时, 可以打开本地空间右侧的「…」菜单,或项目页右上角的 添加项目 菜单:

  • 导入已有项目:列出任务页中已经存在、但尚未加入本地空间的项目。Wework 会 同时按运行时项目身份和规范化后的工作目录去重,因此已经显示在本地空间中的项目 不会再次出现。
  • 添加文件夹:选择新的本地目录,注册任务项目,并立即加入本地空间。

后台同步不会自动恢复已经归档的本地协作项目,避免用户删除的项目重新出现。用户从 导入已有项目 明确选择该任务项目时,Wework 会恢复对应的本地协作项目;导入完成 后侧栏立即刷新,重新启动应用也不会产生重复项目。

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

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

项目空间列表、默认空间和当前任务关联信息都在后台查询。查询未返回或关联仍在进行时,输入框、图片与文件粘贴、附件上传和消息发送仍可正常使用;查询完成后,Wework 再补充项目上下文或完成任务关联,不会用“正在关联”状态阻塞对话。

初始化项目执行环境​

创建和人工处理 Issue 不要求先初始化执行环境。启动 AI 执行任务时,项目需要在至少一个在线设备上完成执行环境初始化。看到“项目运行设备尚未完成环境初始化”时,选择 去配置执行环境,在项目设置中初始化可用设备,然后返回 Issue 继续执行。

初始化完成后,协作首页会重新读取项目的最新配置和设备状态;不需要刷新页面或重新进入项目。设备显示已完成但首页仍提示未初始化时,请确认该设备保持在线,并重新打开执行环境设置检查初始化结果。

看板快速上手​

即使项目尚未添加设备、设备离线或环境未初始化,也可以直接创建 Issue,不会跳转到执行环境设置。人工处理可继续进行;需要 AI 执行时再完成环境配置。

首次打开空的项目空间看板时,Wework 会在现有看板上方显示一个可收起的三步引导:

  1. 创建第一个 Issue;也可以选择 开发功能、修复问题 或 调研方案 模板快速补齐描述结构。
  2. 打开卡片详情,查看描述、负责人、执行进展和交付结果。
  3. 把卡片从 收集箱 拖到 待开始,确认状态会随看板操作同步。

每一步完成后会自动标记进度,全部完成后引导自动隐藏。可以随时选择 收起 暂时减少占用,或选择 不再显示 为当前用户和项目空间永久关闭引导。已有内容的看板不会主动显示这套首次上手引导。

空列会同时说明该阶段适合放什么,以及当前可执行的创建操作;拖动卡片经过列时也会显示目标状态提示。默认的 我的任务 看板使用“任务”术语,其他项目空间继续使用 “Issue”。

保存和切换看板视图​

原生任务看板右侧的视图下拉菜单集中提供切换、新建和看板设置入口,与 专注视图、已归档 位于同一行。基础看板默认按收集箱、待开始、进行中、待确认、已完成五个状态分组;状态和自定义标签仍是 Issue 上独立的信息。

项目管理员可以创建多个视图,为泳道选择状态或标签、调整顺序、设置标签筛选,并将任一视图设为项目默认视图。进入项目时打开默认视图,随后切换视图只影响当前访问。视图和默认设置会同步给项目成员;删除默认视图后恢复基础看板。卡片显示字段与泳道设置在同一个窗口编辑,一次保存;显示字段应用于项目内所有视图。

可添加一条 其它(未匹配) 泳道,命名为 Backlog / 待规划 并移到最左侧。它展示当前视图筛选范围内、不匹配任何其它状态或标签泳道的 Issue;每个视图最多一条。新建 Issue 未匹配其它泳道时自动进入,业务标签不影响归类。拖回此泳道会移除当前视图绑定的全部阶段标签,保留其它标签和状态;如果当前状态仍匹配其它状态泳道,需要先修改状态。若移除阶段标签会破坏视图筛选,该拖动也不可用。泳道中的新建入口保留项目默认的创建状态,并补充满足视图筛选的标签;默认状态匹配其它泳道,或无法满足筛选时,不显示该入口。

标签名称最多 32 个 Unicode 码点,例如「😀」计为一个。名称保存时不包含首尾空白,泳道和筛选必须引用相同的规范名称。Issue 标签、项目标签、标签泳道和筛选使用相同长度限制;超长输入会显示错误并阻止保存,不会自动截断。历史数据中的长标签仍保留原值,修改标题等无关字段不会改动标签。

每个 Issue 和项目设置中保存的标签目录最多包含 20 个不同标签。已有 19 个标签时可以拖入新的标签泳道;已有 20 个时再次添加会显示错误,原标签和版本保持不变,也不会显示成功反馈。在两个标签泳道之间替换标签仍可执行。标签数量不会被自动截断;历史超限数据在读取和无关字段更新时保留完整集合。

原生项目重命名或删除标签时,标签目录、未删除 Issue 的标签、视图泳道及筛选引用会一起保存。项目版本冲突或任一 Issue 更新失败时,整次操作回滚,修正错误后可重试。外部托管的 Issue 不支持这项跨记录事务操作。表格中批量修改状态失败时,会列出失败任务和原因;已成功的任务取消选中,失败任务保持选中,便于重试。

拖动方向Issue 的变化
状态 → 状态更新状态,保留标签
状态 → 标签添加目标标签,保留状态
标签 → 状态更新状态,保留标签
标签 → 标签移除来源标签、添加目标标签,保留其他标签和状态

同一个 Issue 可以同时出现在匹配的状态泳道和标签泳道中。跨类型拖动后,看板会高亮目标卡片并提示实际修改;拖入标签泳道不会重新打开已完成的 Issue。自定义视图包含进行中或待确认泳道时,同样可以使用专注视图展开执行过程。

已有项目继续使用基础看板,历史 Issue 的状态和标签不需要转换。其他成员同时修改配置时,保存会提示冲突并读取最新配置;由更新版本创建的未知格式视图禁止在旧版本中编辑。

按标签快速筛选​

在看板工具栏点击 全部标签,输入文本查找标签并勾选一个或多个标签。 多选时,只要 Issue 包含任意一个所选标签,就会显示。筛选保留当前泳道分组, 并与看板搜索、自定义视图的条件同时生效。点击旁边的清除按钮可恢复全部标签; 切换项目或看板视图后重置。筛选只影响当前查看,不修改共享视图。

编辑 Issue 属性​

已有 Issue 的标签、状态、优先级、负责人、父任务、时间范围和里程碑修改后直接保存。 标题输入完成后按 Enter 或移开焦点保存。里程碑选择器支持输入文本搜索; 选择 未设置 可以移除关联。创建新 Issue 时,这些值仍随创建操作一起提交。

只有 description 需要点击 保存。修改其他属性不会提交尚未保存的 description; 取消 description 编辑也不会撤销已保存的属性。保存失败时,详情显示错误与重试入口。 连续修改按顺序提交,离开详情后已提交的修改继续完成。

卡片中的子任务进度​

有子任务的 Issue 卡片显示进度环和 子任务 2/5,表示 5 个直接子任务中已有 2 个完成。全部完成时,进度环显示为绿色。点击该入口进入该 Issue 的子任务看板,不会打开详情面板。

进度按当前用户可查看、未归档的直接子任务统计,不累计孙任务;搜索、标签筛选和分组不会改变统计范围。没有符合条件的子任务时,不显示入口。本地和云端项目使用相同展示。

桌面回归:pnpm --filter wework e2e:desktop --segment collaboration-parent-board。新增进度验收与原有父子看板场景共用同一个 CI 检查点和桌面运行环境。

泳道排序​

原生项目空间看板的每个泳道都有独立的 排序方式,默认按优先级从高到低排列。可以添加优先级、创建时间和更新时间的升降序规则,并上移、下移或删除规则。规则从上到下依次比较,前一条相同时才比较下一条;全部相同时保留手动顺序。选择 手动排序 后,状态、优先级、负责人和标签分组均可在泳道内拖动改序,也支持跨泳道插入指定位置。非状态泳道中不同状态的 Issue 也可以混排;列内改序不会改变状态、负责人或标签。手动位置属于项目共享顺序,跨分组复用。设置按当前用户、项目空间、分组和泳道保存在当前设备,重新打开后恢复,不影响其他成员。 拖到泳道尾部空白区域可移到末尾。分组字段和顺序一起保存,保存失败时两者都不会提交。多个窗口修改不同泳道的排序偏好会分别保留,并同步到已打开的看板。

桌面排序回归:pnpm --filter wework e2e:desktop --segment collaboration-board-sorting。该独立 checkpoint 已接入 Core CI,使用真实云端后端和本地 SQLite 验证默认优先级、泳道独立组合规则、窗口重新加载后的恢复、自动排序拒绝列内改序,以及手动拖动和跨泳道移动的持久化。

排序保存后的刷新恢复回归:pnpm --filter wework e2e:desktop --segment collaboration-board-move-recovery。该独立 checkpoint 已接入 Core CI,使用真实 Developer 成员验证三个可见 Issue 与隐藏同级 Issue 交错时的向后拖动、快照响应中断后的可见顺序、刷新恢复,以及并发移动和快照乱序返回时的字段与顺序。测试只干预真实后端响应的传输,不构造 API 响应,并验证隐藏 Issue 始终不可见。

日历、甘特图与表格视图​

项目空间顶部可以在 看板、日历、甘特 和 表格 之间切换。Issue 详情使用同一个时间范围控件设置开始时间和结束时间;只有一个日期时,日历和甘特图会把它视为单日任务。

  • 日历按月、周或日展示任务。跨天任务显示为连续横条,跨周时会在每一行保留边距并延续到下一行。拖动任意一段会同时移动整个任务,目标日期区域会在拖动期间高亮;日历不提供单独调整起止边界的拖拽手柄。
  • 甘特图按周、月、季度或年展示时间轴。拖动任务条可整体改期并保持持续天数;悬停后拖动左右两端可以分别修改开始日期和结束日期。没有设置时间的任务会显示在下方,可以拖到时间轴上安排日期。
  • 表格默认显示标题、状态、分配、标签、开始时间、结束时间、执行状态和更新时间,不默认显示 Issue ID 或分配来源。点击支持排序的表头可切换升序和降序;状态、分配和标签表头支持过滤。选中多行后可以批量修改状态或批量归档,单行归档使用图标操作。

日历和甘特图中的筛选、分组和排序会先保存为当前设备上的个人设置。选择 恢复项目设置 可放弃个人修改;拥有项目管理权限的成员可以选择 保存为项目设置,让其他成员打开项目时使用同一套默认规则。

项目设置中的执行环境​

在协作项目的 项目设置 → 执行环境 中,可按需添加代码仓库并初始化执行环境。没有代码仓库时可以使用空白工作目录;普通情况下选择仓库或输入 Git 地址即可,名称和目录会从仓库自动带出。只有要自定义名称、目录或分支时才展开 高级选项。初始化步骤同样按需添加,不需要为了保存配置填写占位内容。

人工处理 设置页只说明直接指派成员后的处理与验收流程,不要求项目管理员额外配置表单。具体操作在 Issue 详情中完成,参见处理指派给我的 Issue。

项目会话​

点击看板右侧常驻的 会话 按钮,即可展开右侧聊天栏。也可以从协作左侧栏中项目名称右侧的 新建会话 图标进入。无需配置协作小组、AI 负责人或开启实验功能。本地和云端项目均可使用,新的会话在当前电脑执行,并以当前项目看板为默认上下文;访问和操作仍受当前用户的实际权限约束。

直接发送消息即可开始,不需要另外选择关联项目或执行目录。会话栏顶部显示当前项目名称,并支持新建和切换历史会话;关闭后可再次打开,并从历史会话中继续原会话。本地与云端项目的会话分别记录。本机执行环境不可用时会显示错误,恢复后可再次发送。

此入口只启动用户发起的会话,不会自动启用后台项目统筹。需要跟踪负责人、状态和交付结果的工作,可以创建看板任务并指派成员、机器人或协作小组。

Issue 详情与执行任务​

从项目空间看板打开 Issue 后,详情面板会直接列出该 Issue 的附件,并提供下载、删除和继续上传操作。附件区域与其他详情字段使用一致的分隔和间距;点击包含文件名和大小的整行即可下载。下载期间会显示进度,失败时会保留附件并显示错误,用户可以再次点击重试。附件不会只显示为数量,便于在启动执行任务前确认上下文。

点击详情中的 新建任务 会在右侧打开任务对话栏。先在输入区描述需要执行的工作,再发送以创建并关联执行任务;即使 Issue 已处于 待开始 状态,也不会跳过输入步骤或直接以空内容启动任务。

Issue 动态中的评论有两种不同的执行语义:

  • 在底部输入框发送新的顶层评论,会基于 Issue 的标题、描述、附件和当前项目配置创建一条新的独立执行任务。新任务可以读取 Issue 上下文,但不会自动继承其他执行任务的会话历史。
  • 在某条执行动态中选择 回复,会继续该动态所属的原执行任务和模型会话。适合补充要求、追问结果或要求修正;不会再创建一条并行任务。

详情中的 执行任务 区域会分别列出这些独立任务。任务数量增加通常表示发送了新的顶层评论;在线程内回复只会在原任务中增加一轮执行。

普通关联任务的执行状态由 Executor 根据运行时生命周期统一写入 Issue。看板和任务输入区上方的 Issue 摘要不会各自写状态;同一个任务开始新一轮执行或进入终态时,它们使用生命周期变化作为刷新信号并重新读取 Issue,因此已打开的看板无需手动重载即可在 进行中、等待确认 等列之间同步。协作小组的 Issue 状态由负责人智能体在收到成员结果后判断并迁移。

不再需要的 Issue 可以从看板卡片菜单、表格行操作或详情面板的「…」菜单中删除。删除是软删除:Issue 及其子任务从看板隐藏,数据仍然保留;仍在执行的任务会先被取消,不会留下无人管理的执行进程。

项目空间文件​

项目空间的 文件 页签统一展示共享文件和交付快照。共享文件支持上传、新建目录、重命名或移动、删除和打开;交付文件可在对应 Issue 的交付详情中编辑。点击任一文件、交付快照或本地任务附件旁的预览按钮,会在右侧复用工作区文件预览面板打开内容,原有的下载或打开操作仍然保留。

本地项目空间和远程项目空间的共享规则不同。本地项目空间会把任务对话过程中用户发送和 AI 生成的附件默认聚合到 任务附件 区域;远程项目空间不会直接暴露原始任务附件,只有任务完成并显式交付后,交付快照中的文件才会出现在项目空间文件页签。远程项目交付时默认不会带入整个会话,需要手动选择要纳入快照的聊天消息、会话附件以及本地文件或文件夹。

云端项目空间中的看板任务被另一名成员指派给你时,已连接该云端且允许系统通知的 Wework 桌面端会发送一条系统通知。重复指派给同一负责人或自己指派给自己不会重复提醒。

项目空间自动化​

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

机器人成员​

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

执行队列​

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

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

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

PR 自动修复​

在 自动化 页签的 PR 自动修复 中,可以选择哪些异常状态自动继续原任务并让 AI 修复。当前支持检查失败、合并冲突、Merge Queue 失败、Merge Queue 超时和 Merge Queue 冲突,也可以配置发送给 AI 的附加指令。配置保存在项目空间中,拥有项目管理权限的成员可以修改。

自动修复复用看板和任务侧边栏的 PR/MR 状态监控结果。触发后系统继续关联的原任务会话,不会创建替代任务;PR/MR 已关闭时不会触发。自动修复需要执行任务的设备在线,并且该设备上的 gh 或 glab 能读取对应仓库。

自动化规则与 AI 托管​

自动化规则可以按时间表运行,也可以由新任务等项目事件或 Webhook 触发。规则支持启停、立即运行、查看运行历史和取消尚未完成的运行;时间表由服务端调度,因此不要求 Wework 客户端持续在线。

协作小组处理 Issue 时,始终先由负责人智能体读取 Issue 和可分配成员,再制定工作流计划。负责人为每个子任务生成具体执行提示词;成员收到的是该次分配的提示词,而不是小组设置中的静态职责说明。成员提交结果后,负责人再综合判断是否继续执行、请求确认或完成 Issue。此流程不依赖预设阶段或协作模式选项。

Issue 动态以“项目负责人 将「任务标题」分配给成员”的形式展示任务分配,不重复添加“负责人”标签;有关联执行时,可通过 查看执行 打开详情。

每条规则只选择一种分配方式:

  • 手动选择:固定选择一个项目机器人。规则触发后,原始看板任务立即指派给该机器人,并完整复用普通任务指派给机器人的现有执行流程。
  • AI 托管:AI 调度员通过受限 MCP 读取原始任务,以及当前可用项目成员和项目机器人的能力说明,选择最合适的对象后直接完成指派;没有合适对象时保持未分配。调度员不会执行原始任务,也不会成为任务负责人,最终文本只作为判断记录,不参与指派。

AI 托管可以使用两种调度员来源。自定义 AI 选择模型和本地或云端设备,通过 Wework 的现有运行通道调用“读取任务、读取候选人、指派任务”三个 MCP 工具;Wegent 智能体 使用当前用户可访问且配置完整的智能体,由 Backend 创建标准 Task/Subtask,并提供同样受当前项目、任务和自动化运行约束的 MCP。选择项目机器人时,真正执行任务的是该机器人;选择项目成员时,系统只完成负责人指派。

选定机器人后,系统调用与人工指派完全相同的看板分配链。项目机器人继续使用自己的当前模型、设备、代码工作区和执行模式;本地设备离线时任务保持“排队中”,设备上线后由 Wework 领取,云端任务由 Backend 分发。执行记录不保存模型凭据,开始运行时才从机器人或调度规则的当前配置中读取。

AI 调度员的判断保存在一条独立父评论中;选中的项目机器人开始工作后,会另建自己的执行评论。只有项目机器人的完成结果才能把原始任务推进到待验收,调度员完成选择本身不会改变任务完成状态。

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

从输入区创建项目​

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

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

创建 Git 项目​

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

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

选择和创建分支​

在输入区的分支菜单中,可以搜索、切换本地分支,或创建并检出新分支。列表不包含标签和远程跟踪引用;当前本地分支优先显示。分支列表与当前分支查询使用兼容旧版 Git 的命令,不依赖 git branch --format 或 --show-current。处于 detached HEAD 状态时,当前分支名为空,仍可从列表选择本地分支。

选择分支会在执行设备上实际执行检出,即使名称与界面上次显示的分支相同,也不会因为缓存状态而跳过 detached HEAD 的恢复。

推送也使用兼容旧版 Git 的当前分支查询。处于 detached HEAD 状态时,需要先检出分支再推送。

如果其他设备仍提示 unknown option,请确认该设备使用的 Wework 执行器已更新。通过云端连接使用云设备或远程设备时,还需更新连接的 Wegent 服务端。Git 查询在工作区所属的执行设备上运行,更新另一台机器上的 Git 不会改变该设备的查询行为。

查看拉取请求和合并请求状态​

打开或切换任务时,Wework 会并行读取分支、远端地址、PR/MR 状态和变更统计。PR/MR 状态准备好后会立即显示,不会等待较慢的 diff 统计;变更文件数和增删行数随后独立更新。执行这些 Git 查询时不会启动用户的登录 Shell,因此 Shell 启动脚本、SDK 初始化或其他个人环境配置不会阻塞环境面板。

手动刷新环境信息时,Wework 会在新 diff 统计完成前保留同一设备、同一工作区的上一份变更统计,避免分支或 PR/MR 中间结果让计数短暂显示为零。切换到其他设备或工作区时不会复用旧统计。

任务使用 GitHub 或 GitLab 工作区时,环境面板会根据当前分支查询已关联的拉取请求(PR)或合并请求(MR)。请求编号和标题保持单行显示;左侧主图标用颜色区分开放、关闭等请求状态,右下角的小图标显示检查中、检查通过或检查失败。存在合并冲突时,红色冲突图标会优先于检查结果显示。GitHub PR 进入 merge queue 后,即使分支检查已经全部通过,Wework 仍以黄色图标显示“合并队列中”等待状态,直到 PR 退出队列或完成合并。Merge Queue 失败后向同一 PR 推送新提交时,Wework 会忽略早于当前最新提交的历史失败事件,并显示新提交的检查状态。GitHub 同一个工作流检查存在多轮运行时,Wework 使用最新一轮结果,已被后续运行替代的取消或失败结果不会覆盖当前状态。点击状态图标会打开操作菜单;点击菜单外部、按 Esc 或选择菜单操作都会关闭菜单。选择 打开 PR/MR 可以在浏览器中打开对应请求。

同一任务在左侧任务列表、项目空间看板和右侧环境面板中复用同一份 PR/MR 监控快照、状态优先级和图标。检查失败、合并冲突、Merge Queue、草稿、关闭和已合并等状态会在三处同步更新;右侧环境面板不会继续显示已经被共享监控结果判定为不存在的旧 PR/MR。

PR/MR 状态查询由共享监控器统一执行;环境面板只单独读取分支和 diff,不会再发起第二套状态查询。同一仓库的多个任务会合并为一次批量查询,运行时任务列表仅重建了等价对象时也不会立即重复查询。状态仍会按监控周期、手动刷新以及提交或推送后的显式刷新更新;CLI 未安装、未登录和查询失败等结构化状态会通过同一份快照同步到所有入口。

查询命令在任务实际使用的执行设备和工作区中运行:GitHub 使用 gh,GitLab 使用 glab。单机使用 Wework 时由本机执行器直接运行命令,不要求额外配置云端 Git 服务连接,但需要在本机安装并登录相应 CLI:

gh auth login
glab auth login

可在 设置 → 代码托管 中查看本机 gh 和 glab 的安装、登录状态,打开安装指引或复制登录命令。该页面还提供 显示 PR / MR 状态 开关;关闭后 Wework 不再执行状态查询,但仍保留创建 PR/MR 的入口。Wework 只读取 CLI 返回的状态,不保存访问令牌。

如果 glab 配置了多个 GitLab 实例,只要至少一个实例认证成功,设置页就会显示 GitLab CLI 已就绪;某个失效或未登录的实例不会掩盖其他可用实例。具体仓库的 MR 查询仍根据该工作区的 Git 远端选择对应的 GitLab 实例,因此仓库所属实例也必须保持有效登录。

如果当前分支还没有 PR/MR,环境面板继续显示创建入口。如果 CLI 未安装、未登录或查询暂时失败,创建入口也会保留,并显示对应的处理提示。提交并推送或仅推送后,Wework 会刷新环境信息;重新打开环境面板也会重新查询最新状态。

普通工作区与 Worktree​

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

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

在不同设备上使用项目​

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

从终端打开项目​

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

wework .
wework /path/to/project

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

编辑交付物​

交付时可以设置标题和备注,并选择要收录的聊天消息、文件及文件夹。标题默认使用当前任务标题,备注支持 Markdown。

在任务中确认交付后,保存成功会自动关闭交付窗口,并打开关联 Issue 的详情抽屉,可继续查看交付记录。保存失败时保留交付窗口并显示错误,便于重试。

交付会保存到关联 Issue 所在的项目空间。

交付后,在 Issue 的交付记录中打开交付物,点击 编辑,即可修改标题和备注、增删或替换文件,以及调整收录的聊天消息。补选来源会话消息 读取当前仍有权限访问的来源会话;会话离线、删除或失去访问权限时,已有消息仍可保留或移除。被交付要求引用的附件不能直接移除。

保存修改 更新同一条交付记录,保留交付链接、来源任务和首次交付时间,不重复完成任务或推进工作流,也不提供历史版本界面。取消编辑不会写入。保存失败时表单保留;多人同时修改发生冲突时,可先保留自己的内容,再选择 重新加载(放弃本次修改) 查看最新交付物。

本地项目空间离线可编辑,云端项目空间要求当前用户仍可查看对应 Issue,并具有 Developer 或更高项目角色。文件页展示保存后的附件。

桌面回归命令:pnpm --filter wework e2e:desktop --segment collaboration-delivery-editing。该检查点接入 Core CI,独立创建项目和交付记录,验证编辑、取消、版本冲突及重载后的持久化。

复制 Issue 网页链接​

打开云端项目空间中的 Issue,点击详情头部的 复制网页链接,即可复制当前连接的 Wegent 网站中该 Issue 的地址。复制成功后按钮显示 已复制;复制失败时可再次点击重试。打开链接的人仍需登录并具有对应项目的访问权限。

本地项目空间的 Issue 没有对应的 Wegent 网页,因此不显示此入口。尚未取得云端网站地址时也不显示。