Week Work Report

A Codex skill that converts research-meeting slides into an evidence-grounded Chinese draft, an approved English report, and a formatted Word document.

一个面向科研组会场景的周报生成 Skill。它从 PPT/PPTX 中提取文本与候选图片，先生成可修改的中文草稿，经用户确认后再翻译为英文，并沿用历史 Word 模板生成最终 .docx。

项目状态：工作流与脚本可用｜需要人工确认中文稿｜不自动补造实验结果

解决什么问题

科研周报通常同时要求内容准确、表达简洁、图文对应和格式稳定。直接从组会 PPT 一步生成英文 Word 容易出现三类问题：

• 幻灯片信息不完整时，模型可能擅自补全实验事实
• 中文逻辑尚未确认就翻译，修改成本会被放大
• 重新创建 Word 段落会破坏实验室既有格式

本项目把生成过程拆成可检查的阶段，并把“内容确认”放在翻译和排版之前。

工作流

flowchart LR
    A[组会 PPT / PPTX] --> B[提取页面文本与候选图片]
    B --> C[基于证据生成中文 Markdown]
    C --> D{用户确认中文稿?}
    D -->|修改| C
    D -->|确认| E[术语一致的学术英文翻译]
    E --> F[套用历史 Word 格式]
    F --> G[英文周报 .docx]

Loading

README 与 SKILL.md 的分工

• README.md：给使用者和仓库访客看，说明项目价值、输入输出和使用方法
• SKILL.md：给 Codex/Agent 执行，定义严格的步骤、确认节点和禁止事项

设计原则

原则	实现方式
事实可追溯	只基于 PPT 内容撰写，不补造实验、数值、图表或结论
先内容后翻译	中文稿确认后才生成英文版本
缺失信息显式化	用 待补充 标记；推断的下周计划注明可编辑
图文对应	提取候选图片并在 Markdown 中使用明确图注
格式可复用	克隆模板段落格式，不从零重建 Word 样式

环境准备

需要 Python 3.10 或更高版本，以及：

python -m pip install python-pptx python-docx Pillow

使用方式

1. 提取 PPT 内容

python scripts/extract_ppt_assets.py "path/to/weekly-meeting.pptx" --output output

输出目录包含：

• 逐页文本和结构化提取结果
• 通过尺寸与版面条件筛选的候选图片
• 供后续写作引用的图片目录

2. 生成并确认中文稿

按照 references/writing-guidelines.md 组织内容，使用 references/terminology.md 保持术语一致。中文稿需要由用户明确确认，才能进入英文翻译阶段。

3. 生成最终 Word

python scripts/build_week_report_docx.py output/final_en.md \
  --output output/week-report-final.docx \
  --images output/images

默认格式来源：

assets/templates/week-report-format-source.docx

Markdown 支持标题、段落、列表和图片：

![Fig. 1. Stress-strain response under different confining pressures.](images/slide-03-image-01.png)

输入与输出

输入
├── weekly-meeting.pptx
├── 汇报人姓名（可选）
├── 报告日期（可选）
└── 用户对中文稿的修改意见

输出
├── 中文 Markdown 草稿
├── 最终英文 Markdown
├── 周报 Word 文档
└── 最终报告实际使用的图片

项目结构

week-work-report/
├── SKILL.md                              # Agent 执行规范
├── agents/openai.yaml                    # Skill 元数据
├── scripts/
│   ├── extract_ppt_assets.py             # PPT 文本与图片提取
│   └── build_week_report_docx.py          # Word 生成
├── references/
│   ├── writing-guidelines.md             # 中文写作约束
│   ├── terminology.md                    # 中英术语
│   └── sample-format.md                   # 样例格式说明
└── assets/templates/
    └── week-report-format-source.docx     # 历史格式来源

脚本核验

python scripts/extract_ppt_assets.py --help
python scripts/build_week_report_docx.py --help

本次仓库核验中，两条命令均成功返回参数说明。

当前边界

• 只处理带有可读取结构的 PPTX；扫描图片中的文字不会自动 OCR。
• 没有证据的实验事实必须保留为 待补充，不能自动补造。
• 下周计划只在 PPT 未提供时做有限推断，并明确标记为可编辑。
• Word 输出依赖当前模板的段落结构；更换模板后需要重新核对格式映射。
• 当前仓库没有捆绑模型调用代码，内容生成由执行该 Skill 的 Agent 完成。

使用说明

本仓库目前用于个人作品展示与科研工作流验证，未附开源许可证。