OfficeWebAddIns-Python

用 Python 从零开发 Office Web 加载项（Add-in） 并打包成 Windows 单文件 EXE 的 Agent Skill。让 LLM 或开发者无需安装 Python/Node 即可在 Excel / Word / PowerPoint / Outlook / OneNote / Visio 中交付即装即用的加载项（任务窗格、功能区命令、事件、对话框、SSO）。

这是一份面向 Agent（LLM 工具调用） 的技能定义，而非普通库。SKILL.md 定义了完整的九步工作流（S1→S9）与门禁质检标准；references/ 提供逐环节方法论，scripts/ 提供可复用的自动化工具。

---

能力概览

• Python 全栈：前端 HTML/JS + Python 后端（FastAPI / Flask / Django 均可用），全程本地离线。
• S0→S9 工作流：规划 → 宿主 → 后端 → 清单 → 前端 → HTTPS → WebView2 → 侧载 → 测试 → 打包，带门禁质检。
• 单文件 EXE：PyInstaller 将加载项打成自解压单 EXE，用户双击即用，无需 Python/Node。
• 原生功能：任务窗格、功能区命令、自定义函数、事件、对话框、上下文选项卡、SSO。
• 自动化验证：scripts/ 提供清单校验、图标尺寸校验、Office COM 宿主验证、功能区验证、烟雾测试等工具。

目录结构

OfficeWebAddIns-Python/
├── SKILL.md               # 技能主定义（S0 规划 → S9 打包，含门禁）
├── docs/                  # 审计与排障文档（troubleshooting 等）
├── references/            # 逐环节方法论（00-15 篇）
├── scripts/               # 可复用自动化工具（构建/校验/COM验证/打包）
├── assets/                # 模板代码片段、示例清单、启动/卸载脚本
├── examples/              # 原创实践项目
│   └── viz-excel/         # 原创示例：类 Power BI 的 Excel 可视化加载项
├── fasthtml-support/      # 原创支撑技能：FastHTML 桌面应用开发（fasthtml-desktop）
├── Office-Add-in-samples/           # 开源引用占位（微软官方示例仓库）
├── office-js-docs-pr-main/          # 开源引用占位（微软官方文档源仓库）
└── office-js-docs-reference-main/   # 开源引用占位（微软官方 API 参考仓库）

开源引用（占位指向仓库链接，不随本仓库分发）

以下目录为开源引用占位，完整内容来自各自的 GitHub 开源仓库，版权归原作者所有，不以文件形式随本仓库分发，仅以 README 占位指向来源仓库链接：

目录	来源仓库	性质
examples/PiForExcel/	https://github.com/tmustier/pi-for-excel	开源示例
examples/Pi4Word/	https://github.com/tmustier/pi-for-word	开源示例
Office-Add-in-samples/	https://github.com/OfficeDev/Office-Add-in-samples	微软官方示例仓库
office-js-docs-pr-main/	https://github.com/OfficeDev/office-js-docs-pr	微软官方文档源
office-js-docs-reference-main/	https://github.com/OfficeDev/office-js-docs-reference	微软官方 API 参考

SKILL.md 中引用的 Office-Add-in-samples/Samples/...、office-js-docs-pr-main/docs/...、office-js-docs-reference-main/docs-ref-autogen/... 等路径，均对应上述开源仓库的完整内容；若你的 Agent 需要这些本地资料，请自行 git clone 对应仓库，或按链接在线查阅。

快速开始

1. 将本技能安装到你的 Agent 技能目录（如 serverdir/user_skills/OfficeWebAddIns-Python）。
2. 参考 SKILL.md 的 S0 门禁流程做任务规划。
3. 按 S1→S9 逐步开发，每个阶段用 scripts/ 中对应工具做质检（如 validate_manifest.py、check_icon_sizes.py、verify_office_host.py）。

原创示例

• examples/viz-excel：类 Power BI 的 Excel 可视化加载项（功能区分组 + 独立图标 + 门禁体系），含 manifest.xml、src/、scripts/、webroot/、启动/卸载脚本。

许可证

• 本仓库原创内容：MIT License（见 LICENSE）。
• 开源引用的微软官方与第三方资料版权归各自权利人所有，见 THIRD_PARTY_NOTICES.md。