# Fill Headquarters Weekly Report

> 自动读取上一完整周（周一至周日）的本地排课 Excel，统计班课与一对一课时并核算金额；总部周报模式在每次填写前询问用户一对一附加小时数 n。支持周一上午单独填写金山文档线上课时表，以及周二中午单独填写易企秀“学术中心周报统计”表单。用于填写、更新、核算或分别定时运行两个周报网页；每次运行都报告统计周期、小时数、金额和目标网页状态。

- Skill: `tgozen63/fill-headquarters-weekly-report` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add tgozen63/fill-headquarters-weekly-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tgozen63/fill-headquarters-weekly-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: TGozen63 (https://skillmd.com/u/tgozen63)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tgozen63/fill-headquarters-weekly-report

---


# 分时填写线上课时表与总部周报

## 运行模式与时间

两个定时任务必须独立运行，不能在同一次定时触发中连续填写两个网页：

- `online-sheet`：每周一 10:00（Asia/Shanghai）运行，只填写金山文档线上课时表。
- `headquarters-report`：每周二 12:00（Asia/Shanghai）运行，只填写总部周报表单。

两种模式都执行以下准备步骤：

1. 将“上周”解释为触发日前最近一个完整的周一至周日，包含首尾日期。周一和周二运行时都应得到同一统计周期。
2. `headquarters-report` 模式先按“用户提供的一对一附加课时”取得 n；`online-sheet` 模式不询问 n，n 不得写入线上课时表。
3. 运行 `scripts/prepare_weekly_report.py`。总部周报模式传入 `--headquarters-extra-one-to-one-hours n`；脚本调用 `calculate-teaching-hours/scripts/calculate_hours.py`，同时生成总部周报字段和 `online_sheet.targets`。不得在脚本外自行加总或猜测课时。
4. 在对话中显示统计周期、班课小时数、一对一课表小时数、用户提供的 n、总部周报一对一合计与金额。若 `status` 不是 `ok`，列出 `errors` 并停止本次目标网页填写。
5. `online-sheet` 模式只执行“线上课时表”流程，保存并核对后结束；不得打开或改动总部周报。
6. `headquarters-report` 模式只执行“总部周报表单”流程，核对后保留待确认页面；不得打开或改动金山文档。

## 用户提供的一对一附加课时

仅在 `headquarters-report` 模式执行：

1. 每次运行都在对话中询问用户本次总部周报的一对一附加小时数 n；不得从微信或其他来源自行读取或推断。
2. 只有用户在触发消息或当前对话中明确提供 n 后才继续；即使上次运行给过 n，也不得沿用。用户明确说“没有”“无”或“0”时使用 `0.0`。
3. 将 n 规范为非负、保留一位小数的数字，并传给 `scripts/prepare_weekly_report.py --headquarters-extra-one-to-one-hours n`。脚本输出的 `one_to_one_adjustment` 必须同时显示课表小时数、用户提供的附加小时数和总部周报合计。
4. n 只用于总部周报的“一对一小时数”和“一对一金额”。线上课时表 D 列始终只使用排课 Excel 的一对一小时数。

## 总部周报表单

1. 读取本机 `references/form-config.local.json`，使用浏览器打开其中的 `url`。
2. 保持配置中的公司和教师不变；页面会保留旧值，所有目标字段都使用替换填写，不得追加。
3. 日期框为只读控件，必须通过日期选择器选择 `period.start` 和 `period.end`。
4. 数字字段一律填写一位小数；答疑无特殊说明时填 `0.0`；本周主要工作无特殊说明时沿用网页旧值。
5. 重新读取日期和 6 个数字字段。全部与脚本输出相同后，保留待确认页面并请求用户确认。
6. 页面“提交”会产生外部副作用。定时任务先保留已填写页面并请求确认；确认后只点击一次，以成功提示或结果页验证。

### 字段映射

| 网页字段 | 配置标识 | 脚本值 |
|---|---|---|
| 所属公司 | `form.company` | 保持配置值 |
| 教师名称 | `form.teacher` | 保持配置值 |
| 开始/结束日期 | `form.fields.start_date/end_date` | `period.start/end` |
| 班课小时数/金额 | `form.fields.class_hours/class_amount` | 同名字段 |
| 一对一小时数/金额 | `form.fields.one_to_one_hours/one_to_one_amount` | 同名字段 |
| 答疑小时数/金额 | `form.fields.qa_hours/qa_amount` | 默认 `0.0` |
| 本周主要工作 | `form.fields.main_work` | 默认沿用旧值 |

## 线上课时表

1. 读取本机 `references/online-sheet-config.local.json`，打开 `url`，确认文档标题正确且具有编辑权限。
2. 选择工作表 `sheet_name`（当前为“黄浦江”）。使用页面中唯一的工作表选项定位，不依赖底部标签坐标。
3. 使用脚本返回的每个 `online_sheet.targets[]`。目标包含工作表行号、日期段以及 D–M 列的完整替换值。
4. 对每个单元格：
   - 使用名称框 `input.edit-box` 输入单元格地址（如 `D13`）并按 Enter；
   - 在当前选中单元格输入目标值并按 Enter；
   - 数值使用一位小数；目标为空字符串时清空旧值，防止重跑后残留旧班课数据。
5. 只写 D–M，不写 N“周总计”和 O“季度总计”，这两列由公式自动更新。
6. 写完后逐个重新选择目标单元格，核对显示值；同时确认 N/O 公式结果自动变化。金山文档自动保存，无需点击提交。
7. 若页面结构、工作表名称、目标日期行或公式列与配置不一致，停止该网页填写并报告，不得猜测坐标。

### 线上表格列映射

| 列 | 内容 | 课时分类 |
|---|---|---|
| D | 1v1课时 | 一对一合计 |
| E | 新南（算 OH） | 新南班课 O1/O2 |
| F | 欧亚（不算 OH） | 欧亚预科（落地） |
| G | 英本（不算 OH） | 英本预科 |
| H | 沃隆港 | 伍伦贡/卧龙岗/沃隆港 |
| I | 启程双学分 | 启程 3915 门 |
| J | 云中学 | 英伦云中学一年制/两年制 |
| K | IG | IG |
| L | OSSD | OSSD |
| M | 外地项目 | VET、14800 等外地项目 |
| N/O | 自动汇总 | 禁止写入 |

脚本按表格的实际日期段生成行号；每月 20/21 日附近的一周可能拆成两行。此时按课程日期分别汇总并填写两个目标行。目标行可能包含上次运行已覆盖的日期，脚本会从该行起始日重新统计到本周结束日，保证重复运行不会叠加课时。

## 统计与核算规则

- 课时分类完全采用 `calculate-teaching-hours` 的结果：只有欧亚、云中学、AP 微积分及已知历史班级（沃隆港/伍伦贡/卧龙岗、新南、双学分/启程 3915、英本、IG、OSSD、VET/14800 等）算班课；其他有有效授课时间的课程即使没有一对一后缀也算一对一；家长会与其他会议忽略。
- 班课金额：逐班计算 `课时 × 每小时产出 × 人数` 后求和；配置来自 `references/class-rates.local.json`。
- 总部周报一对一小时数：`排课 Excel 一对一小时数 + 用户提供的 n`；总部周报一对一金额：`总部周报一对一小时数 × one_to_one_hourly_output`。
- 线上课时表一对一小时数只取排课 Excel，不包含用户提供的 n。
- 欧亚 OH 已由课时统计源直接排除，不计入任何课时、金额或线上表格 F 列，并写入 `excluded`；下游不得再次扣减或改算。
- 线上表格 G 列按表头规则排除英本 OH；E 列新南包含 OH。
- 未映射班级、缺失人数/费率、`missing_times` 或网页核对失败时，明确报告并停止相关填写。

## 本机配置

- 费率或人数变化：修改 `references/class-rates.local.json`。
- 总部表单变化：修改 `references/form-config.local.json`。
- 金山文档链接、工作表、锚点行或列映射变化：修改 `references/online-sheet-config.local.json`。
- 三个 `*.local.json` 均为本机配置，不得上传。修改后运行 `scripts/prepare_weekly_report.py --self-check`，再做只读准备测试。