需检查数据源映射、状态字段规则及推送通道绑定：一、绑定项目系统并同步状态等字段；二、配置阻塞预警等聚合规则；三、编辑支持变量渲染的周报模板；四、设置周五17:00企业微信自动推送；五、验证状态变更至周报更新延迟≤90秒。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已配置WorkBuddy连接项目管理工具但仍未收到项目状态周报，则可能是由于项目数据源未映射、状态字段识别规则缺失或推送通道未绑定。以下是解决此问题的步骤：
一、绑定项目管理系统并启用状态字段同步
WorkBuddy需直连Jira、飞书多维表格或Teambition等平台，提取任务看板中的“状态”“负责人”“截止时间”等结构化字段，确保周报内容具备可量化依据。
1、进入WorkBuddy管理后台「数据源集成」→「项目管理」，点击「添加系统」。
2、选择对应平台（如Jira Cloud），输入API Base URL与Personal Access Token（权限需含Browse Projects与Read Issue）。
3、在字段映射界面，将远程字段“status.name”强制映射至本地标签“项目状态”，将“assignee.displayName”映射至“负责人”，勾选“仅同步状态为‘进行中’‘已完成’‘阻塞’的条目”。
4、点击「测试连接」，确认返回结果中包含至少5条带状态标识的任务记录，且状态值为进行中、已完成、阻塞三类标准枚举值。
二、定义项目状态聚合逻辑与阈值规则
避免周报罗列全部任务，需按项目维度自动聚合计数并标注异常项，例如“阻塞任务超2项即标红预警”，该逻辑由本地规则引擎实时执行。
1、在「项目周报设置」页，点击「新建状态规则集」。
2、输入规则名称：“研发项目-阻塞预警”，设定触发条件为“同一项目下状态=阻塞的任务数≥2”。
3、在动作配置中，选择“在周报头部插入红色警示区块”，内容模板为：⚠️ 项目{{project.name}}存在{{blocked_count}}项阻塞任务，请关注资源协调。
4、为“已完成”任务启用自动归档逻辑：若任务更新时间距今＞72小时且状态为已完成，则不纳入本周统计范围。
三、配置基于项目看板的周报模板与变量注入
模板需支持动态渲染项目分组、状态分布饼图占位符及关键指标卡片，所有变量必须与已授权字段严格对应，否则渲染为空白。
1、进入「模板中心」→「项目状态周报」，点击「编辑HTML模板」。
飞书多维表格AI管家 — 自动化数据清洗、批量录入、报表生成、字段管理和智能摘要。适用于操作飞书多维表格（Bitable）、批量处理数据、自动生成报表/周报、整理数据或管理表格结构。触发词：多维表格、Bitable、飞书表格、自动报表、批量录入、数据清洗、飞书数据。
2、在正文区域插入以下结构化区块：
• 项目分组标题：{{project.name}}（来自Jira Project Key）
• 状态分布：{{status_distribution.pie_chart}}（自动生成SVG占位符）
• 关键指标卡：{{metrics.blocked_tasks}} / {{metrics.total_tasks}}（自动计算比值）
3、为“阻塞任务列表”区块启用条件渲染：仅当{{blocked_tasks.length}} > 0时显示，且每项渲染为“{{task.summary}}（负责人：{{task.assignee}}，超期{{task.overdue_days}}天）”。
4、保存模板前点击「预览渲染」，上传含3个不同状态任务的测试JSON样本，确认所有变量均被正确替换且无undefined字样。
四、设置周五17:00自动触发与企业微信精准推送
推送必须绑定具体群聊Webhook地址并校验key有效性，且仅向配置了“项目管理员”角色的成员发送，防止信息过载。
1、在「自动化任务」中新建任务，类型选择“项目状态周报生成与推送”，触发时间设为每周五17:00。
2、数据源选择已启用的Jira实例，并在过滤器中限定“Project Key IN (PROJ-A, PROJ-B, INFRA)”。
3、推送渠道选择“企业微信”，粘贴经企微后台验证的Webhook URL（格式必须含?key=abc123，且该key已在群机器人设置中启用“仅限群消息”）。
4、接收人配置为“按角色筛选”，勾选“项目管理员”，取消勾选“全体成员”，点击「启用任务」后观察系统日志是否输出[SUCCESS] POST to wecom webhook: 200 OK。
五、验证状态变更实时性与推送完整性
通过人工修改单条任务状态模拟真实场景，验证从数据变更到周报内容更新的端到端延迟是否≤90秒，确保决策依据时效可靠。
1、登录Jira，将某条“进行中”任务的状态手动更改为“阻塞”，保存后等待10秒。
2、在WorkBuddy「数据源监控」页，查看该任务的last_sync_time是否在60秒内刷新，且status字段值已同步为阻塞。
3、立即执行一次「手动触发周报生成」，检查输出PDF中对应项目区块是否新增红色预警，且阻塞任务列表是否包含刚修改的那一条。
4、对比PDF中“总任务数”与Jira项目看板右上角显示数值，误差必须为0，否则需重新校准字段映射关系。
