hlzd-office-doclisted
Install: claude install-skill Alexxiang2008/hlzd-b2b-export-skills
# HLZD Office Doc (v0.1 lightweight)
最小化 .docx 生成器 — **纯 Python stdlib**（zipfile + xml），无需 libreoffice / pandoc / python-docx。
## v0.1 范围（够用）
| 能力 | 状态 |
|---|---|
| 生成 .docx（title + body + letterhead）| ✅ 跑通 |
| HLZD 默认抬头纸 | ✅ 跑通 |
| XML escape（`<script>` `&` `"` 防注入）| ✅ 跑通 |
| 19 �� pytest 单测 | ✅ 全 pass |
## v0.2 范围（不跑通，留作下版）
- 完整 HLZD 抬头纸模板（logo 占位 / 多语言）
- DOCX ↔ PDF 互转（需 libreoffice）
- DOCX ↔ Excel/PPTX 互转（需 libreoffice / pandoc）
- B2B 模板库（合同 / 发票 / COA / 装箱单标准模板）
- Letterhead PDF 渲染
## 用法
```python
from scripts import lib
# 1) 简单 DOCX
lib.generate_minimal_docx(
"output.docx",
title="报价单 / Quotation",
body_lines=[
"客户: Aramco Trading Co.",
"产品: API 5CT OCTG Casing",
"数量: 5000 meters",
"报价: USD 1450/meter CIF Jeddah",
],
letterhead="深圳海联智达科技有限公司 HLZD",
)
# 2) HLZD 默认抬头
letterhead = lib.standard_letterhead_hlzd()
# 3) 自定义抬头
custom = lib.add_letterhead(
"ACME Industrial",
address="...",
phone="+86 ...",
email="...",
website="...",
)
# 4) End-to-end
result = lib.run_pipeline("out.docx", "Title", ["line1", "line2"])
# -> {"output_path": "...", "size_bytes": ..., ...}
```
## CLI（v0.1 stub）
```bash
# 暂无 CLI; v0.2 加 scripts/cli.py
```
## Related Skills
- `hlzd-cold-outreach` (上游) — 邮件 + 报价正文
- `hlzd-quotation-gen` (上游) — 报价数字
- `hlzd-market-report` (姊妹) — HTML 报告 (非 .docx)
## Versioning
| 版本 | 说明 |
|---|---|
| 0.1.0 | 首版：纯 stdlib DOCX 生成 + letterhead + 19 tests |