周报汇总 Pro
> 定位：从"一条条要点变四段"升级为"多源要点 → 可核对的结构化成稿"。
> 上游轻量件 weekly-report-writer 用"首个命中关键词即归类"，存在顺序偏置
> （工作类关键词最多，容易把什么都吞进工作栏）；本件换成加权打分归类并支持强制分栏。
> 本地运行声明：核心归类引擎随包本地执行（scripts/main.py），只读源文件、不修改不回写；读入与成稿不向任何一方发送要点内容。按次付费时包内仅向官方 402 计费端点发起验付请求，请求体只含结构化参数摘要（要点文件名 + 选项取值），不含任何要点正文。
一、何时使用
触发关键词：周报自动生成、月报撰写、工作周报、自动写周报、汇报材料生成、日报周报、
工作总结、周报汇总。
负向清单（本件不做）：代写实质性业务结论、跨周期趋势分析、对外正式公文润色
→ 此类场景请人工核定或走对应高档件通道（见第九节）。
二、怎么用（本地执行 · 按次计费）
本包为付费件：核心引擎随包本地执行（scripts/main.py），计费经官方 402 计费端点按次结算；付款凭证由 --payment-proof 传入，未携有效凭证时返回 402 账单、不成稿不输出。
cd mid/weekly-report-pro
python scripts/main.py points.txt
python scripts/main.py points.txt --payment-proof <支付凭证>
常用参数示例：
python scripts/main.py a.txt b.txt - --payment-proof <凭证> # 多源合并（`-` 读 stdin）
python scripts/main.py pts.txt --sections-file sections.txt --format text --payment-proof <凭证>
python scripts/main.py pts.txt --title 项目周报 --period 2026-W42 --format json --payment-proof <凭证>
完整参数表与退出码见 scripts/main.py --help。
计费与结算契约（官方 402 计费通道 · 按次结算）：
- 本件按次计费 ¥0.99/次，经官方 402 计费通道按次结算；请求未携有效付款凭证时返回 HTTP 402 与本次账单（含金额、订单号、官方支付地址）；
- 买家完成支付后携付款凭证重试同一调用，官方 402 计费端点验付通过后履约；同一组参数重试派生出同一订单标识（幂等），重复重试不会重复计费；改参数则视为新的一次调用、新订单；
- 唯一出网目标 = 官方 402 计费端点 https://aitoolgate.cn:8443/api/weekly-report-pro，仅用于按次验付；请求体只含结构化参数摘要，不上传任何要点正文；读入、归类与成稿全部在本机完成。
三、判定逻辑（本地规则引擎）
读取多源要点（文件 + stdin，顺序合并）→ 剥离项目符号 → 强制分栏标记 [栏目] / 【栏目】
优先判定 → 其余走加权打分归类（逐栏目累计关键词得分 1 + min(len(kw),4)*0.1，
取最高分，平票取靠前栏目，零命中落兜底栏）→ 去重保序 → 每栏条目上限 → 输出
md / text / json，附统计节（原始条数、去重剔除、入稿、强制标记数、每栏条数、字符数、覆盖率）。
四、样例（异常样例≥2·含真实输出）
$ python scripts/main.py pts1.txt pts2.txt --period 2026-W42 --author 测试员
$ echo $?
3
（本件按次价 ¥0.99，三处同价：服务端账单＝包内 meta＝上架展示。）
$ python scripts/main.py pts1.txt --payment-proof mock-proof-ord_bad000000000000
$ echo $?
3
样例 3 · 凭证含非 ASCII 字符（客户端前置拦截，退出码非 0）
$ python scripts/main.py pts1.txt --payment-proof <含中文的串>
样例 4 · 输入类错误
要点文件不存在、栏目配置缺分隔符、空输入等：文件读取在客户端（缺文件即报错退出）；
空输入与栏目配置校验在本机预校验阶段完成（退出码 2 + 可读提示）：先校验、后计费，不发起计费请求、不产生订单、不计次——不会出现「付了钱才发现没要点」。
五、端到端实测留痕（真实命令与真实输出）
> 示例输入（两文件随本说明给出，便于逐条复跑；本文留痕为按此输入实跑所得，可逐字复现）：
> > # pts1.txt（7 条要点）
> - 完成支付网关联调，上线灰度 5%
> - 完成支付网关联调（重复行测试）
> - 转化率环比提升 12%
> - 营收增长 15%，成本占比下降
> - 数据指标周会纪要整理
> - 下周计划推进移动端适配排期
> - 风险：第三方接口存在阻塞，可能延期
>
> > # sections.txt（用例 B 的自定义栏目）
> 研发交付:完成,上线,联调,重复,整理
> 数据增长:转化,营收,增长,提升,成本
> 计划排期:计划,下周,排期,推进,适配
> 风险问题:风险,阻塞,延期,第三方
>
正常用例 A · 单源默认四栏成稿（402 → 付款 → 验付 → 履约）
$ python scripts/main.py pts1.txt --payment-proof <支付凭证>
# 工作周报
> 成稿时间：2026-10-12
## 本周/本月工作
- 完成支付网关联调，上线灰度 5%
- 完成支付网关联调（重复行测试）
## 关键数据
- 转化率环比提升 12%
- 营收增长 15%，成本占比下降
- 数据指标周会纪要整理
## 待办/下一步
- 下周计划推进移动端适配排期
## 问题与风险
- 风险：第三方接口存在阻塞，可能延期
## 汇总统计
- 原始要点 7 条 / 去重剔除 0 条 / 入稿 7 条
- 栏目覆盖 100%（栏目非空占比）
- 正文字符数 97
> 本机自动归类成稿，仅作草稿；重大事项请自行复核。
（履约回执 order=ord_de80a5e12ed1fdf884）
$ echo $?
0
正常用例 B · 自定义栏目 + text 格式
$ python scripts/main.py pts1.txt --sections-file sections.txt --format text --payment-proof <支付凭证>
工作周报
========================================
【研发交付】
- 完成支付网关联调，上线灰度 5%
- 完成支付网关联调（重复行测试）
- 数据指标周会纪要整理
【数据增长】
- 转化率环比提升 12%
- 营收增长 15%，成本占比下降
【计划排期】
- 下周计划推进移动端适配排期
【风险问题】
- 风险：第三方接口存在阻塞，可能延期
入稿 7 条 / 去重剔除 0 条 / 覆盖 100%
（履约回执 order=ord_a51f4f764e64fd91f0）
$ echo $?
0
（归类与统计与开发态同源内核 Python 实跑逐字一致（7 条入稿／覆盖 100%／打分制判别点同栏），交叉印证移植正确。按次价 ¥0.99＝中档档位价。）
> 说明：两个用例的 402 账单为真后端实际返回；「（履约回执 order=…）」输出到 stderr，不混入 stdout，便于 --format json 管道处理。放行分支以本地回环端点回放同一协议执行（不产生真实扣费），真实付款放行以买家实际支付为准。
> 开发态自测（本机归类引擎 29/29 断言，含 402 契约与幂等）于开发环境留痕存档；发布包不含自测文件与指纹证据，核心引擎 scripts/main.py 随包发布。
六、结果摘要
- 输出：结构化周报（md 缺省 / text / json）+ 汇总统计节。
- 归类：加权打分（非首命中），支持
[栏目]/【栏目】强制分栏。 - 输入：多文件合并 + stdin
-；自动去项目符号、去重保序。 - 可配：自定义栏目与关键词、每栏条目上限、周期/撰写人/区间元信息。
- 统计：原始条数、去重剔除、入稿条数、强制标记数、每栏条数、字符数、栏目覆盖率。
- 边界：关键词规则不理解语义；只读源文件，不成稿也写
-out才落盘。 - 自测：规则引擎开发态自测全通过（开发环境留痕；发布包不含自测文件）。
七、按次权益与交付说明
> 付费件声明：核心引擎随包本地执行；计费经官方 402 计费端点按次结算；验付请求不含任何要点正文。
1. 单次调用即完整功能：每一次调用都启用本件全部能力（多源合并、打分归类、
强制分栏、自定义栏目、三格式输出、统计），不存在功能阉割的"试用态"。
2. 按次调用不交付明文：按次调用以"返回成稿文本"的方式交付，不向使用者交付
本件脚本源码、配置与内部实现等明文产物；使用者拿到的是成稿，不是本件实现文件。
需要源码级交付的场景，请走对应的高档件通道（见第九节）。
3. 调用计数口径（一次算一次，如实计）：
- 一次调用 = 本件被触发一次，并完整执行到成稿输出，计 1 次；
一次调用内传入多个要点文件仍计 1 次（多源合并是单次调用的能力，不按文件数叠加计次）；
- 参数错误、输入不存在、未产出成稿的调用（退出码非 0 且不产出结果）不计次；
- 仅查看用法/版本、未产出结果的调用不计次；
- 中途被中断或未执行完成的调用不计次；
- 同一命令重复执行 N 遍，各计 N 次。
八、更新承诺
承诺：自交付日起 12 个月内，对本件存在的 Bug 提供修复更新。
- 覆盖：归类逻辑错误、合并/去重计数错误、格式渲染错误、崩溃类缺陷；复现用例由使用者提供。
- 不视为 Bug：专业术语密集导致的归类偏差（属规则口径限制，已在本文如实标注）、
业务结论是否恰当、平台环境变更导致的外部失效。
- 修复方式：更新件内脚本后重新交付，历史次的调用结果不受影响。
九、中→高 CTA（文案位）
> 汇报再往上走：跨周/跨月的多周期汇总与对比、把"工作产出"拼成可交付的对外报告、
> 带证据链的结果校对与逐句复核——这类场景已超出本件范围。
> 需要一次成型且能自证的汇报件，请看更高档的汇报套件（详见同系列高档件页面）。
> 本件负责把要点归拢成草稿，高档件负责让这份材料经得起追问。
十、四防声明与"不交付明文"口径
- 防泄露：本件无密钥、无私有数据、无后门；核心引擎随包本地执行（scripts/main.py），验付请求只含结构化参数摘要、不含任何要点正文，无隐藏文件。
- 防转发：请从官方渠道获取；转发请保留本声明。
- 防破解：引擎随包本地执行，无服务端依赖；篡改重打包与本源件指纹不符。
- 防抄袭：原创性指纹由开发方留存备查，不随包发布（AS-IS）。
- 不交付明文：按次调用只交付成稿文本，不交付本件源码与内部实现文件（见第七节第 2 条）。
十一、边界（严格遵守）
- 只读：不修改、移动、删除用户文件；除落盘交付文件与标准输出外不产生其他写动作；按次付费时仅向官方 402 计费端点提交参数摘要以完成验付。
- 不猜：归类基于关键词规则，不理解语义；新颖表述或术语密集的要点可能归类偏差，需复核。
- 不代写结论：只把使用者给的要点重整归类，不补写使用者没写的业务判断。
- 不越权：超出本件范围即升档提示，不硬撑。
十二、免责与责任
本工具仅提供操作辅助与流程指引，不承诺任何效果或收益；因使用本工具产生的任何直接或间接损失，
责任由使用者自行承担；在法律允许的最大范围内，开发者不以任何方式承担责任（法律强制规定的责任除外）。
- 按现状（AS-IS）提供，不附带任何明示或默示保证；
- 成稿为草稿性质，涉及数据口径与对外汇报的内容须使用者自行复核后再发出；
- 输出结果仅供决策参考，重大事项（绩效口径、对外承诺）须使用者自行复核。
