track-fund-progress-default/TUTORIAL.md

数据管理、对话任务与定时任务是本技能三种平行的用法：科研秘书在表上录台账、点播报，走数据管理；PI 想随口问一句自己的经费，走对话；每月 5 号自动播报，走定时任务。

本技能做什么

技能维护一份"项目台账"（编号、名称、负责人、立项/到账/报销/暂付款、执行期），播报时对每个在研项目计算实际支出率与序时进度，按阈值诊断出 严重滞后 / 支出异常偏快 / 正常，并给出暂付款冲销、结题报销提醒，最后生成带柱状图的《经费执行简报》。播报历史会保存下来供查询与统计。

开始前

• 准备项目台账数据：至少要有项目编号、负责人、已到账、已报销、执行期起止（金额单位为元）
• 管理员确认预警阈值符合学校口径（缺省：严重滞后 10%、异常偏快 20%、暂付款账龄 90 天、结题预警 90 天）
• 想用月度定时播报，请先确认宿主支持定时任务并已建好（见入口三）

入口一：数据管理

左侧表列表中能看到本技能的三张表：项目台账、播报记录、预警规则。

录入/维护项目台账

1. 点左侧"项目台账"表，再点表顶栏的「录入项目台账」按钮
2. 在表单里填写项目编号（必填）、名称、负责人、总立项经费、已到账、已报销、暂付款、执行期起止后提交；同一编号再次提交即为更新（未填字段不会被覆盖）
3. 也可以直接在表格里双击编辑金额与日期字段

播报经费进度

1. 在"项目台账"表点表顶栏的「经费进度播报」按钮
2. 缺省播报全部"在研"项目；也可以只填某个项目编号或负责人
3. 提交后稍等片刻，表格提示播报完成；切到"播报记录"表查看每个项目的状态与偏差

查看《经费执行简报》

1. 在"播报记录"表点表顶栏的「生成经费简报」按钮（不选行时重建最近 10 份）
2. 左侧 HTML 报告区出现 report-编号（单项目）与 brief-批次（月度汇总）条目，点开即可预览进度柱状图与三段式摘要

调整预警阈值

1. 打开"预警规则"表，找到要调整的规则（如 lag_threshold）
2. 点该行操作列的「更新预警阈值」，填入新值提交；下一次播报即按新阈值诊断

入口二：对话任务

新建任务，选择本技能后直接说事。

查询自己的项目进度

查一下我的国自然经费执行得怎么样，我是张三

助手会按负责人播报其名下在研项目，并用三段式播报文本回复（现状 / 诊断 / 建议）；可以继续追问"哪个项目滞后最严重""我的暂付款要不要处理"。

录入与批量导入

录入一个项目：编号 HX2026010，负责人李四，总立项 50 万，已到账 40 万，已报销 35 万，2026-01-01 到 2026-12-31

批量导入时把台账 JSON 数组发给助手（可从财务系统导出后整理），助手逐条校验导入并回报新增/更新数量。

查历史与统计

• "上次播报哪些项目滞后了" → 返回播报历史（可只看严重滞后）
• "全校经费执行统计一下" → 返回状态分布、滞后 Top 与暂付款总额

重建简报

重新生成一下经费简报

助手重建最近 10 份简报，去数据管理 HTML 报告区打开即可。

入口三：定时任务

本技能提供月度无人值守播报（对应"每月 5 号上午 9:00 自动执行"的场景）：

1. 在宿主"定时任务"里新建任务，类型选"技能直调"，选择本技能的「月度经费播报」
2. 执行时刻按学校要求设置（建议每月 5 号上午，错开月底报销高峰；具体时间由你在宿主配置）
3. 到点自动播报全部在研项目并生成月度汇总简报；执行过程与结果可在任务中心查看，无需人在场

月度播报只做本地计算与记录写入，不改任何外部系统，可放心无人值守。

主能力对照表

能力	数据管理	对话任务	定时任务
经费进度播报	「经费进度播报」按钮（可指定项目/负责人）	直接说事由+负责人	月度播报自动执行
月度汇总简报	由播报自动生成	由月度播报自动生成	每月自动生成
录入/更新台账	顶栏按钮 + 表格直改	对话说明项目信息	不适用
批量导入	不支持	粘贴 JSON 给助手	不适用
查看简报	「生成经费简报」按钮 + 侧栏预览	让助手重建后去侧栏打开	自动生成
调整预警阈值	行级「更新预警阈值」	也可以让助手改	不适用
历史与统计	查看播报记录表	对话查询	不适用

常见卡住怎么办

• 播报提示"没有可播报的项目"：台账里没有"在研"项目或筛选条件不匹配；先在"项目台账"录入或调整状态
• 执行率显示"—"：该项目已到账为 0（未到账）或台账缺数字；到账后自动恢复，或补录金额
• 状态一直是"待补录"：台账缺总立项经费、到账、报销或执行期起止中的某项，按提示补齐后重新播报
• 诊断结果和预期不一致：检查预警阈值（"预警规则"表）与台账数据基准日；播报口径为"已到账"分母
• 看不到简报：先在"播报记录"表点一次「生成经费简报」，再到左侧 HTML 报告区打开
• 月度定时没跑：检查宿主定时任务是否启用、指向的 Action 是否为「月度经费播报」，任务中心有无失败记录