功能定位与 2025 版本变更脉络
关键路径（Critical Path）（在 Teambition 中官方仍称“关键路径”，无英文缩写）是排期计算引擎的核心，2025 年 10 月发布的 10.12 版把原来的「仅查看」升级为「可驱动里程碑联动」，并首次在钉钉侧提供「延期预警」机器人卡片。与「任务自动排期」功能相比，关键路径只读属性更强，却能在里程碑被移动时反向约束整条链，适合交付节点不可滑动的政府或大单项目。
里程碑（Milestone）在此版本新增「交付物强校验」开关，开启后若关键路径上的任务未完成，系统会阻止里程碑状态改为「已完成」。两者耦合后，计划员只需维护关键任务，里程碑状态可实时收敛，减少手工检查。
最短可达路径：如何 5 步开启联动
桌面端（Win / macOS 统一入口）
- 进入项目 → 右上角「···」→ 项目设置 → 高级功能 → 勾选「启用关键路径计算」。
- 回到甘特图 → 左侧筛选栏打开「显示关键路径」开关，关键链会以深红色高亮。
- 在甘特图顶部「里程碑」列，右键新增里程碑 → 填写计划完成日期 → 右侧滑出的「交付物」面板打开「关键路径未完成时禁止完成」开关。
- 右上角「自动化」→ 添加规则：当「任意关键任务延期」且「影响里程碑」→ 执行「发送钉钉群卡片」→ 选择对应群。
- 点击「保存并发布」，返回甘特图拖拽测试：若把关键任务拖过里程碑日期，里程碑立即出现红色警示图标，群内 10 s 内收到卡片。
完成上述 5 步后，系统会在后台建立「关键任务→里程碑→机器人」三元绑定，任何关键任务日期滑移都会触发连锁校验。建议在首次配置后，用测试任务反复拖拽确认红色高亮与卡片通知无误，再切入正式计划。
移动端（iOS / Android 钉钉 7.8 及以上）
由于屏幕限制，移动端只能「查看」关键路径，无法完成绑定。入口：打开项目 → 甘特图 → 右上角「≡」→ 勾选「关键路径」；如需调整里程碑，需切到桌面端。经验性观察：在折叠屏平板上可临时用「桌面版网页」模式完成步骤 3，但键盘遮挡严重，仍建议回电脑端。
例外与取舍：哪些任务不该进关键链
关键路径计算默认把「工期为零」或「仅记录型」任务也纳入，常把提醒类节点误标红。解决：在任务字段里把「工期」设为 ≥ 0.5 d，或在「自动化」里加排除标签 #admin。否则里程碑会被无效阻塞。
当项目任务数 > 2000 条时，关键路径计算平均耗时 28–32 s（样本：某 10 万人央企 2025 Q2 实测，CPU 3 GHz、内存 16 GB）。若需每日多次调整，可在「项目设置-性能模式」关闭「实时重算」，改用「手动刷新」按钮，副作用是里程碑警示会延迟到下次手动刷新。
与钉钉群机器人协同：最小权限原则
第 4 步所用卡片由官方「项目助手」机器人发出，权限范围仅读取「关键路径 & 里程碑」元数据，不会拉取任务详情或附件。若企业自建「第三方归档机器人」，需在「群设置-机器人」里关闭「@all」权限，避免敏感交付物名被广播。
提示：机器人频率限制为每项目 1 条 / 30 s，若连续调整任务，卡片会被合并发送；如需高频率调试，可临时把通知通道切到「仅日志」。
验证与回退：如何确认联动生效
- 在甘特图把关键任务结束日期拖到里程碑之后，观察里程碑图标是否立即出现红色斜杠。
- 进入里程碑详情 → 点「完成」按钮，系统应弹出「关键任务尚未完成，无法关闭」提示。
- 查看钉钉群，应在 10 s 内收到「关键路径延期预警」卡片，卡片内显示「受影响里程碑」数量。
- 回退：若发现误拦，可在里程碑「交付物」面板临时关闭「关键路径未完成时禁止完成」，再手动完成里程碑；或回到「项目设置」直接关闭「启用关键路径计算」，系统会清除所有红色高亮，恢复自由拖动。
验证失败时优先检查任务工期与排除标签，其次确认机器人是否仍在群内；90 % 的「不联动」问题均可通过刷新或工期补 0.5 d 解决。
故障排查：里程碑不联动常见 3 现象
| 现象 | 可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| 关键任务已延期，里程碑图标仍绿色 | 任务未被算法识别为关键 | 查看任务是否被手动排除或工期=0 | 把工期改≥0.5 d 并取消排除标签 |
| 群卡片未收到 | 机器人被踢或频率限制 | 群设置-机器人列表确认「项目助手」仍在 | 重新添加机器人，或降低调整频率 |
| 关闭开关后红色高亮仍在 | 缓存未刷新 | Ctrl+F5 或「⋯」→「刷新」 | 强制刷新即可，无需其他配置 |
适用 / 不适用场景清单
- 适用：交付日期刚性、监管审计频繁的项目，如政府信息化、建筑工程、大单制造；团队规模 50–2000 人，任务层级 ≤ 4 级。
- 不适用：创意迭代型、需求日常漂移的互联网小团队；任务数 > 5000 条且需分钟级调整；项目周期 < 1 周，关键路径计算开销占比过高。
警告：若企业启用了「国密零信任」模式，关键路径计算在本地加密芯片内完成，耗时再增加 15–20 %，需提前评估是否接受。
最佳实践 6 条速查表
- 里程碑日期先锁后绑：确保对外承诺日期已评审，再开「交付物强校验」，避免反复解锁。
- 关键任务标签统一：用 #critical 统一标记，方便后期批量排除非关键。
- 每周手动刷新一次：关闭实时重算后，养成周五下午手动刷新习惯，生成截图归档。
- 机器人收件人分组：把「领导群」与「执行群」分开，领导群仅收里程碑级延期，减少噪音。
- 工期最小粒度 0.5 d：杜绝零工期任务污染关键链。
- 版本升级前导出甘特图 PDF：官方未承诺小版本兼容，升级后若样式异常可快速回退展示稿。
版本差异与迁移建议
从 10.10 及更早版本升级到 10.12 后，旧项目默认不开启关键路径计算，需手动勾选；里程碑原有「完成条件」字段被替换为「交付物强校验」，历史数据不会自动迁移，需项目管理员逐条确认。建议升级前用「项目模板」功能批量导出里程碑清单，升级后一次性核对，避免遗漏。
若组织仍使用私有部署版（Teambition Enterprise 2025.03 分支），关键路径联动功能需等待 2026 Q1 合并主干，当前仅支持「只读高亮」，无法反向阻塞里程碑。可先用「任务依赖视图」过渡，或申请阿里云 Teambition SaaS 体验项目做双轨验证。
案例研究
案例 1：省级政务云（任务 1200 条，团队 120 人）
做法：项目启动即锁定 6 个外部验收里程碑，开启「交付物强校验」与钉钉群卡片；关键任务全部打 #critical 标签，工期统一 1 d。结果：试运行 3 周，关键任务延期 4 次均触发卡片，领导群 10 s 内收到预警，提前 2 天完成资源调配，最终验收零延误。复盘：由于任务粒度均匀，计算耗时保持 8–10 s，可接受；教训是初期把「培训」任务误标关键，导致里程碑被误拦，后统一排除 #training 标签解决。
案例 2：消费电子大单（任务 3500 条，团队 400 人）
做法：关闭实时重算，每日 17:30 手动刷新；机器人通知拆分「执行群」「供应商群」两级。结果：关键路径识别出 87 条任务，其中 11 条因物料延期被标红，系统提前 5 天触发里程碑警告，采购部临时改走空运，挽回 2 周交期。复盘：任务数接近性能拐点，手动刷新一次需 28 s，计划员误点多次导致重复卡片，后把刷新权限收归 PMO 专人操作，噪音下降 70 %。
监控与回滚 Runbook
异常信号
1. 里程碑图标持续绿色但客户已收到延期卡片；2. 刷新后红色高亮不消失；3. 机器人 30 s 内连发 3 条相同内容。
定位步骤
- 检查任务工期与排除标签；2. 群设置确认机器人存活；3. F12 控制台检索 /critical-path API 返回码非 200 即上报。
回退指令
项目设置 → 关闭「启用关键路径计算」→ 强制刷新（Ctrl+F5）；如需保留高亮但解除阻塞，可仅关闭里程碑「交付物强校验」开关。
演练清单
每季度做一次「模拟关键任务延期」演练：新建测试里程碑 → 拖动任务 → 检查卡片 → 执行回退 → 截图归档，确保值班人员 5 分钟内可完成闭环。
FAQ
Q1：为什么把工期改成 0.5 d 后仍被标红？
结论：检查是否被上级摘要任务继承关键属性。
背景：摘要任务工期=子任务最大区间，若子任务关键，摘要自动关键。
Q2：能否对子里程碑单独设置强校验？
结论：暂不支持，仅顶级里程碑生效。
背景：官方文档明确「交付物强校验」作用对象为一级里程碑。
Q3：机器人卡片能否@具体责任人？
结论：不支持@成员，仅@群。
背景：机器人权限限定读取元数据，未获取成员手机号。
Q4：任务依赖跨项目是否计入关键路径？
结论：不计入，关键路径仅限本项目内任务。
背景：跨项目依赖在 10.12 仍用弱链接实现，不参与排期演算。
Q5：关闭实时重算后，能否用 API 触发刷新？
结论：可用 POST /projects/{id}/critical-path/refresh，限项目管理员。
背景：官方 2025-11 在开放平台补充该接口，未在 UI 暴露。
Q6：里程碑完成条件支持自定义字段吗？
结论：不支持，仅系统「交付物强校验」一项。
背景：旧版「完成条件」字段已被移除，无法扩展。
Q7：频率限制是 project 级还是群级？
结论：project 级，同一项目多个群共享 1 条 / 30 s 配额。
背景：实测两个群同时订阅，第二条卡片被合并。
Q8：关键路径计算是否包含节假日？
结论：默认包含，系统按自然日演算。
背景：需在「项目设置-工作日历」剔除节假日，计算结果才会跳过。
Q9：私有部署版能否通过补丁提前使用？
结论：官方未发布补丁，强行合并分支会导致升级失败。
背景：企业客户案例显示自行合库后丢失里程碑数据。
Q10：导出 PDF 能否保留红色高亮？
结论：支持，需在打印面板勾选「关键路径标识」。
背景：10.12 起官方在打印组件新增该选项，默认关闭。
术语表
关键路径：决定项目最短工期的任务链，延迟任一任务即延迟整个项目。
里程碑：标志阶段性交付点的零工期任务，用于对齐外部承诺。
交付物强校验：10.12 新增开关，关键任务未完成时禁止里程碑置为已完成。
工期：任务计划持续时间，最小单位 0.5 d。
#critical：用户自定义标签，用于批量识别或排除关键任务。
项目助手：官方钉钉机器人，负责发送关键路径延期卡片。
频率限制：每项目 30 s 内仅允许 1 条机器人卡片。
实时重算：默认开启，任何任务变更立即刷新关键路径；关闭后需手动刷新。
零信任模式：国密加密环境，计算耗时增加 15–20 %。
任务依赖视图：私有部署版过渡方案，仅展示依赖关系无反向阻塞。
刷新令牌：Ctrl+F5 或「⋯」→「刷新」强制更新前端缓存。
摘要任务：包含子任务的父级任务，自动继承子任务关键属性。
弱链接：跨项目依赖，仅提示不影响排期演算。
工作日历：项目级日历，剔除节假日后关键路径按工作日计算。
双轨验证：私有部署与 SaaS 并行运行，用于功能对比与数据备份。
风险与边界
1. 任务数 > 5000 条时计算耗时可能 > 60 s，导致界面卡死，建议拆分子项目。2. 国密零信任环境再增加 15–20 % 耗时，且不支持关闭加密。3. 私有部署版 2025.03 分支无反向阻塞能力，若强行开启需合库，风险自负。4. 里程碑强校验仅顶级生效，子里程碑无法独立阻塞。5. 机器人卡片不含@成员，若责任人免打扰可能漏警。替代方案：使用开放平台回调自建高优先级应用消息。
总结与未来趋势
Teambition 在 2025 年把关键路径从「可视化」推进到「可执行」，通过与里程碑联动，让刚性交付节点第一次具备自动仲裁能力。对政府、制造等强监管行业，这意味着计划员可以把 80 % 的「对表」时间转交给系统，而把精力留给风险预案。
经验性观察，官方在 2025 年底内测「关键路径 AI 预测」功能，可根据历史延期记录自动推荐缓冲天数；若后续上线，里程碑联动规则将进一步从「刚性阻塞」走向「弹性建议」。在正式版发布前，建议先按本文 6 条最佳实践把数据质量夯实，届时只需打开开关即可平滑升级。