phabricator 的 workboard 并非独立模块,而是深度集成于 maniphest 与 projects 的可视化功能,需依次启用模块、创建并配置项目(开启 workboards)、自定义列及准入状态、关联任务与项目,并确保状态匹配,方可正常使用。

Phabricator 在 Linux 上部署后,任务追踪看板(Workboard)不是开箱即用的独立模块,而是 Maniphest 任务系统与可视化界面深度集成的功能。它依赖正确配置的项目、任务类型、权限模型和 Web 服务,缺一不可。下面从实际可操作角度分步说明关键配置要点。
确保 Maniphest 和 Projects 模块已启用
Phabricator 默认启用 Maniphest(任务管理)和 Projects(项目组织),但需确认无被意外禁用:
- 登录管理员账户,访问 /config/ → 搜索 maniphest,确认
maniphest.enabled为true - 同理搜索 projects,确保
projects.enabled已开启 - 若使用自定义配置文件(如
conf/local/local.json),检查是否显式关闭了相关模块,如有则删除或设为true
创建项目并启用看板视图
Workboard 是绑定在 Project 上的,必须先创建一个「工作项目」并手动开启看板:
- 进入 /project/create/,填写项目名称(如 前端迭代),选择 Public 或 Members Only 可见性
- 创建完成后,在项目主页右上角点击 ⚙️ Configure → 找到 Features 区域
- 勾选 Workboards 并保存 —— 这一步常被忽略,不勾选就不会显示看板入口
- 刷新页面,左侧菜单会出现 Workboard 选项卡
配置列(Column)与任务流转逻辑
看板默认只有 Backlog 和 Done 两列,需按团队流程自定义:
- 进入项目 Workboard 页面,点击右上角 + Add Column
- 输入列名(如 To Review、In Progress、Blocked),设置排序权重(数字越小越靠左)
- 每列支持设置「允许拖入的任务状态」,例如 To Review 列可限制只接受
needs-review状态的任务 - 任务状态由 Maniphest 的 status 字段控制,可通过
./bin/maniphest edit-status命令或 Web 界面批量更新已有任务状态
让任务自动进入看板的关键设置
新创建的任务不会自动出现在看板上,需建立关联规则:
- 任务必须明确归属到该 Workboard 所属的 Project(创建时选择,或后期编辑任务 → Edit Task → Projects 添加)
- 确保任务状态符合某列的准入条件;例如若某列只接受
open状态,而任务是resolved,就无法显示 - 如需自动化流转(如代码提交触发状态变更),可结合 Harbormaster + Herald 规则:在 /herald/edit/rule/ 中新建规则,当 Differential revision 被接受时,自动将关联 Maniphest 任务状态改为
needs-review
配置完成即可通过拖拽卡片直观管理任务进度。Workboard 本身不存储额外数据,所有状态和归属都回写到 Maniphest 任务记录中,保证数据一致性。不复杂但容易忽略细节。











