必须通过结构化模块注入方式集成自定义kpi字段与计算逻辑：一、在模板“成果汇总”后添加“自定义kpi区块”并启用自动填充；二、配置字段名、单位、目标值及数据源路径；三、设置评分规则与可视化样式；四、生成周报时显式引用模块名称；五、支持excel手动注入数据作为离线备用方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在WorkBuddy中生成基础周报，但需嵌入部门或岗位特有的KPI指标（如客服团队的首次响应时长、研发团队的单元测试覆盖率），则必须通过结构化模块注入方式将自定义KPI字段与计算逻辑集成至报告正文。以下是实现该目标的步骤：
一、在周报模板中预留KPI模块插入点
WorkBuddy周报引擎支持在预设章节后动态追加结构化模块，插入点需明确定义字段类型与数据绑定路径，确保AI可识别并渲染为可交互表格。
1、进入WorkBuddy主界面，点击左侧「报表」→「周报模板管理」。
2、选择当前使用的周报模板，点击右侧「编辑结构」按钮。
3、在「成果汇总」章节下方，点击「+添加模块」→「自定义KPI区块」。
4、在弹出面板中输入模块名称：客户服务时效KPI，勾选「启用自动数据填充」选项。
二、配置KPI字段语义与数据源映射
每个自定义KPI模块需声明字段名、单位、目标值及原始数据来源路径，系统据此从已授权数据源中提取数值并执行公式运算。
1、在模块编辑页点击「字段配置」标签页。
2、点击「新增字段」，依次填写：首次响应平均时长（秒）、单位“秒”、目标值“≤60”。
3、在「数据源路径」栏输入：企微客服后台/工单日志表/first_response_time_avg。
4、重复步骤2–3，添加字段：客户满意度CSAT（%），目标值“≥92”，数据源路径为：CRM系统/服务评价表/csatisfaction_rate。
三、设置KPI评分规则与可视化样式
评分规则决定字段数值如何转换为绩效等级，样式配置影响报告输出时的呈现效果，包括颜色标识、进度条与异常标红逻辑。
1、切换至「评分逻辑」标签页，点击「新建规则组」。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、为“首次响应平均时长（秒）”设置：实际值≤60得100分，每超5秒扣8分，低于40分标红显示。
3、为“客户满意度CSAT（%）”设置：≥92得100分，90–91.9得85分，＜90得60分，结果以绿色/黄色/红色圆点标识。
4、在「样式配置」中勾选「显示趋势箭头」，系统将自动比对上周数值并渲染↑或↓图标。
四、将KPI模块绑定至周报生成指令
仅完成模块配置不触发自动嵌入，需在调用周报生成时显式引用该模块，否则AI默认跳过未声明的自定义区块。
1、返回首页，在顶部搜索框输入：生成2026年4月第2周周报，包含客户服务时效KPI模块。
2、按下回车后，系统识别到模块名称并加载对应字段配置。
3、若提示「未找到匹配模块」，请核对模块名称是否与模板中完全一致，包括空格与标点。
4、确认生成后，预览页中「客户服务时效KPI」区块将显示带评分、颜色标识及趋势箭头的双字段表格。
五、通过Excel手动注入KPI数据（离线备用方案）
当数据源未接入或API临时不可用时，可上传本地Excel作为替代数据源，系统将按列名匹配字段并覆盖原数值。
1、准备Excel文件，首行为字段名，须与模块中配置的字段名完全一致，例如：首次响应平均时长（秒）、客户满意度CSAT（%）。
2、在周报生成预览页点击右上角「数据替换」→「上传Excel」。
3、选择该Excel文件，勾选「按列名自动匹配」，点击「应用」。
4、系统立即刷新KPI区块数值，并保留原有评分规则与样式渲染效果。
