{"id":"11082a77-3474-491f-bfa5-1d5aa34a9562","entityType":"agent","slug":"clawhub-jobzhao15-huo15-doc-template","name":"huo15-doc-template / 火一五文档模板","canonicalUrl":"https://www.xpersona.co/agent/clawhub-jobzhao15-huo15-doc-template","canonicalPath":"/agent/clawhub-jobzhao15-huo15-doc-template","generatedAt":"2026-10-11T15:20:43.215Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T11:59:24.755Z","emptyReason":null},"description":"【版权：青岛火一五信息科技有限公司 账号：huo15】Word/文档生成首选技能。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、... Skill: huo15-doc-template / 火一五文档模板 Owner: jobzhao15 Summary: 【版权：青岛火一五信息科技有限公司 账号：huo15】Word/文档生成首选技能。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、... Tags: doc:1.3.4, document:1.0.4, huo15:1.3.4, latest:1.4.0, template:1.3.4, word:1.3.4 Version history: v1.4.0 | 2026-04-01T03:11:34.675Z | user 修复 YAML frontmatter 格式错误导致技能无法加载的问题：去掉 description 中","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s1721m5ed1yrr23ar908enm64s83vbsk:huo15-doc-template","sourceUrl":"https://clawhub.ai/jobzhao15/huo15-doc-template","homepage":"https://clawhub.ai/jobzhao15/skills/huo15-doc-template","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/jobzhao15/huo15-doc-template","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/jobzhao15/skills/huo15-doc-template","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"【版权：青岛火一五信息科技有限公司 账号：huo15】Word/文档生成首选技能。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:59:24.755Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:59:24.755Z","emptyReason":null},"stars":null,"forks":null,"downloads":1070,"packageName":null,"latestVersion":"1.4.0","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:59:24.682Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T11:59:24.755Z","lastCrawledAt":"2026-10-11T11:59:24.682Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T11:59:24.682Z","lastVerifiedAt":null,"highlights":[{"version":"1.4.0","createdAt":"2026-04-01T03:11:34.675Z","changelog":"修复 YAML frontmatter 格式错误导致技能无法加载的问题：去掉 description 中的粗体语法，移动 markdown 内容到正确位置","fileCount":3,"zipByteSize":7879},{"version":"1.3.4","createdAt":"2026-03-31T04:58:49.020Z","changelog":"1.3.4: 修复触发机制，使用标准description格式","fileCount":2,"zipByteSize":6611},{"version":"1.3.3","createdAt":"2026-03-31T03:25:59.912Z","changelog":"1.3.3: 愿景理念移至文档末尾，分两行左对齐","fileCount":2,"zipByteSize":6750},{"version":"1.3.2","createdAt":"2026-03-31T03:23:48.349Z","changelog":"1.3.2: 改为fuzzy模糊匹配触发","fileCount":2,"zipByteSize":6728},{"version":"1.3.1","createdAt":"2026-03-31T03:16:27.266Z","changelog":"huo15-doc-template 1.3.1 - 增强公司信息与 LOGO 获取逻辑，支持自动优先获取公司系统(Odoo)配置、愿景理念、LOGO，失败时自动降级本地及备用 LOGO。 - 新增一键式 `create_formatted_doc` 示例，支持插入公司愿景。 - 优化 LOGO 路径和下载兼容性，提升新版 Odoo 环境下的操作兼容。 - 精简与整合文档开头示例及强制检查清单，简化新手快速上手流程。 - 移除冗余说明，核心函数和配置规则更聚焦实际用法。","fileCount":2,"zipByteSize":6595},{"version":"1.3.0","createdAt":"2026-03-30T03:42:32.069Z","changelog":"触发关键词大幅扩展，覆盖所有Word/文档生成场景（写word、写文档、写合同、写报价单、写会议纪要、公文、标书、通知、请示、报告、函、.docx等），确保所有文档生成请求自动优先使用本技能。","fileCount":2,"zipByteSize":9709},{"version":"1.2.2","createdAt":"2026-03-19T13:31:10.001Z","changelog":"修复：LOGO路径硬编码问题，改用用户目录~/.huo15/assets/logo.png，支持跨公司自动下载LOGO","fileCount":2,"zipByteSize":9692},{"version":"1.2.0","createdAt":"2026-03-19T06:19:10.561Z","changelog":"新增2026-03-19经验总结：不要依赖pip安装包，代码模板就在SKILL.md中；修复简化版说明中的误导性pip导入语句","fileCount":2,"zipByteSize":9762}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1721m5ed1yrr23ar908enm64s83vbsk:huo15-doc-template","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T15:20:43.214Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jobzhao15-huo15-doc-template/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T11:59:24.755Z","emptyReason":null},"readme":"Skill: huo15-doc-template / 火一五文档模板\n\nOwner: jobzhao15\n\nSummary: 【版权：青岛火一五信息科技有限公司 账号：huo15】Word/文档生成首选技能。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、...\n\nTags: doc:1.3.4, document:1.0.4, huo15:1.3.4, latest:1.4.0, template:1.3.4, word:1.3.4\n\nVersion history:\n\nv1.4.0 | 2026-04-01T03:11:34.675Z | user\n\n修复 YAML frontmatter 格式错误导致技能无法加载的问题：去掉 description 中的粗体语法，移动 markdown 内容到正确位置\n\nv1.3.4 | 2026-03-31T04:58:49.020Z | user\n\n1.3.4: 修复触发机制，使用标准description格式\n\nv1.3.3 | 2026-03-31T03:25:59.912Z | user\n\n1.3.3: 愿景理念移至文档末尾，分两行左对齐\n\nv1.3.2 | 2026-03-31T03:23:48.349Z | user\n\n1.3.2: 改为fuzzy模糊匹配触发\n\nv1.3.1 | 2026-03-31T03:16:27.266Z | auto\n\nhuo15-doc-template 1.3.1\n\n- 增强公司信息与 LOGO 获取逻辑，支持自动优先获取公司系统(Odoo)配置、愿景理念、LOGO，失败时自动降级本地及备用 LOGO。\n- 新增一键式 `create_formatted_doc` 示例，支持插入公司愿景。\n- 优化 LOGO 路径和下载兼容性，提升新版 Odoo 环境下的操作兼容。\n- 精简与整合文档开头示例及强制检查清单，简化新手快速上手流程。\n- 移除冗余说明，核心函数和配置规则更聚焦实际用法。\n\nv1.3.0 | 2026-03-30T03:42:32.069Z | user\n\n触发关键词大幅扩展，覆盖所有Word/文档生成场景（写word、写文档、写合同、写报价单、写会议纪要、公文、标书、通知、请示、报告、函、.docx等），确保所有文档生成请求自动优先使用本技能。\n\nv1.2.2 | 2026-03-19T13:31:10.001Z | user\n\n修复：LOGO路径硬编码问题，改用用户目录~/.huo15/assets/logo.png，支持跨公司自动下载LOGO\n\nv1.2.0 | 2026-03-19T06:19:10.561Z | user\n\n新增2026-03-19经验总结：不要依赖pip安装包，代码模板就在SKILL.md中；修复简化版说明中的误导性pip导入语句\n\nv1.1.0 | 2026-03-19T05:21:02.843Z | user\n\n新增：(1)强制检查清单 (2)简化函数create_formatted_doc()，一条命令完成所有格式配置\n\nv1.0.9 | 2026-03-19T05:18:10.204Z | user\n\n新增文档命名规则（文档类型_客户名称_项目名称_日期_版本.docx），包含自动命名函数\n\nv1.0.8 | 2026-03-19T04:57:54.231Z | auto\n\nhuo15-doc-template 1.0.8\n\n- Documentation updated: No functional changes in code; only the SKILL.md documentation was edited.\n- All usage instructions, formatting rules, and examples remain as before, without modification.\n- Ensured no new features, bug fixes, or behavior changes were introduced in this version.\n\nv1.0.7 | 2026-03-19T04:56:57.649Z | auto\n\n- 页眉公司信息实现改为“动态获取”方案：优先辉火云企业系统，其次本地配置，最后默认（包含 LOGO 路径下载与配置说明）\n- 新增公司信息配置文件说明和 JSON 示例\n- 页眉生成和 LOGO 获取逻辑调整为自动下载及容错\n- 原有 LOGO 路径等硬编码替换为动态获取/配置\n- 文档其他规范和代码示例未变\n\nv1.0.6 | 2026-03-15T14:23:40.969Z | auto\n\nhuo15-doc-template 1.0.6 Changelog\n\n- Updated metadata in _meta.json; no functional or user-facing changes.\n- Maintained all template rules, usage scenarios, and markdown conversion guidance unchanged.\n- No modifications to code logic, documentation structure, or skill descriptions.\n- This release contains only documentation/metadata update.\n\nv1.0.5 | 2026-03-14T13:13:31.627Z | auto\n\nhuo15-doc-template 1.0.5 Changelog\n\n- Documentation updated for clarity and coverage of all formatting/compatibility requirements.\n- No user-facing code or behavior changes; content focuses on stricter Word/WPS formatting enforcement, function usage, and stricter LOGO presence in document templates.\n\nv1.0.4 | 2026-03-14T04:16:07.570Z | auto\n\nhuo15-doc-template 1.0.4 changelog:\n\n- 修改技能名称，现为“huo15-doc-template / 火一五文档模板”。\n- 优化描述文本表述，无功能性逻辑变更。\n- 其余模板规则、使用说明、示例代码保持不变。\n\nv1.0.3 | 2026-03-14T04:15:56.331Z | auto\n\nhuo15-doc-template 1.0.3\n\n- 增加中英文名展示，名称变更为“huo15-doc-template / 火一五文档”\n- 其他已有内容、规范和示例未改动\n- 文件SKILL.md部分内容顺序及排版稍作微调，未涉及功能更改\n\nv1.0.2 | 2026-03-14T03:38:11.919Z | auto\n\nVersion 1.0.2\n\n- Added _meta.json file to the project.\n- No other changes to code or documentation.\n\nv1.0.1 | 2026-03-14T02:22:46.066Z | auto\n\n- 增加了版权声明及公司账号信息在 SKILL.md 文件头部。\n- 其余文档内容未发生变化，仅对头部 meta 信息做小幅调整。\n\nv1.0.0 | 2026-03-14T02:20:14.875Z | auto\n\nVersion 1.0.0 – Initial release\n\n- Introduces standardized company document templates for contracts, quotes, technical docs, and meeting minutes.\n- Enforces strict font, page margin, header (with required LOGO), and footer (with page numbers) rules per company and GB/T 9704-2012 standards.\n- Provides Python code snippets and detailed instructions for font compatibility between Word and WPS, including mandatory font domain settings.\n- Mandates proper Markdown-to-Word conversion (no raw Markdown in Word docs) with ready-to-use code samples.\n- Includes comprehensive pre-generation checklists to ensure compliance before document output.\n\nArchive index:\n\nArchive v1.4.0: 3 files, 7879 bytes\n\nFiles: _meta.json (137b), skill-card.md (2389b), SKILL.md (19087b)\n\nFile v1.4.0:SKILL.md\n\n---\nname: huo15-doc-template / 火一五文档模板\ndescription: 【版权：青岛火一五信息科技有限公司 账号：huo15】Word/文档生成首选技能。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、合同模板、报价单模板、文档模板、公司文档、正式文档、公文、标书、方案文档、年度报告、通知、请示、报告、函。所有 Word 文档、.docx 文件、公文、合同、报价单、说明书、会议纪要、发货单、PDA 单据等文档生成任务自动使用本技能。\n---\n\n## 重要：此为首选文档技能\n所有 Word 文档生成任务都必须使用此技能\n\n\n## ⚠️ 强制检查清单（生成文档前必须完成）\n\n> **新用户必读！每次生成文档前对照检查，否则文档不合格！**\n\n- [ ] **LOGO 是否添加？** —— 页眉必须有 LOGO + 公司名称 + 底线\n- [ ] **页码是否添加？** —— 页脚必须有\"第 X 页 共 Y 页\"\n- [ ] **字体是否正确？** —— 正文仿宋，标题黑体/楷体\n- [ ] **页面边距是否正确？** —— 上下 3.7/3.5cm，左右 2.8/2.6cm\n- [ ] **命名是否规范？** —— 文档类型_客户名称_日期.docx\n\n**如果没有完成以上检查，文档不允许交付！**\n\n---\n\n## 🚀 快速开始\n\n> **重要**：代码模板直接写在 SKILL.md 中，复制使用即可！无需 pip install！\n\n```python\n# 一步创建符合公司规范的文档\ndoc = create_formatted_doc(\n title=\"销售合同\",\n company_name=\"青岛火一五信息科技有限公司\",\n insert_vision=True # 可选：插入公司愿景理念\n)\ndoc.add_paragraph(\"合同正文内容...\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n```\n\n> **LOGO/公司信息会自动从公司系统获取**，无需手动配置！\n\n---\n\n# 文档模板技能\n\n## 快速开始\n\n1. **字体设置**：默认使用仿宋，小四（12pt）\n2. **页面边距**：上下 3.7/3.5cm，左右 2.8/2.6cm\n3. **页眉**：LOGO + 公司名称 + 底线\n4. **页脚**：页码居中，格式\"第 X 页 共 Y 页\"，仿宋小四\n\n---\n\n## 配置规则\n\n### 字体规范\n- **默认正文**：仿宋，小四（12pt）\n- **一级标题**：黑体，小三（15pt），加粗\n- **二级标题**：楷体，小四（12pt），加粗\n- **三级标题**：仿宋，小四（12pt），加粗\n\n**WPS 字体兼容**：\n- 汉字字体：使用 `仿宋`\n- 每个 run 都要设置字体域 `w:eastAsia`\n\n---\n\n## ⚠️ 重要：Markdown 语法转换规则\n\n### 禁止直接在 Word 中使用 Markdown 语法\n\n**严禁将 Markdown 语法直接写入 Word 文档**，例如：\n- ❌ 错误：`**加粗文本**` → Word 中会显示星号\n- ❌ 错误：`| 列1 | 列2 |` → Word 中会显示管道符\n- ❌ 错误：`# 一级标题` → Word 中会显示井号\n\n### 正确转换方法\n\n#### 1. 加粗转换\n- Markdown：`**这是加粗**`\n- Word：设置 `run.bold = True`\n\n```python\n# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗\n```\n\n#### 2. 表格转换\n- Markdown：\n```\n| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |\n```\n- Word：使用 `doc.add_table()` 创建表格\n\n```python\n# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)\n```\n\n#### 3. 标题转换\n- Markdown：`# 一级标题`\n- Word：添加段落并设置样式\n\n```python\n# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)\n```\n\n### 自检清单（生成文档前必查）\n\n生成文档后，检查以下内容：\n- [ ] 文档中是否有 `**`、`__`、`#` 等 Markdown 符号？\n- [ ] 表格是否使用了 `|` 管道符？\n- [ ] 链接是否显示了 `[文字](URL)` 格式？\n- [ ] 列表是否显示了 `-` 或 `*` 前缀？\n\n**如果有任何一项为\"是\"，则文档不合格，需要重新生成**\n\n---\n\n## 🚀 核心函数（必须使用）\n\n### 公司信息获取函数\n\n```python\nimport ssl\nimport json\nimport os\nimport urllib.request\nimport xmlrpc.client\n\n# ============== 公司信息配置 ==============\nUSER_HOME = os.path.expanduser(\"~\")\nLOGO_DIR = os.path.join(USER_HOME, \".huo15\", \"assets\")\nDEFAULT_LOGO_PATH = os.path.join(LOGO_DIR, \"logo.png\")\n\n# 备用 LOGO URL\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_LOGO_URL = 'https://huihuoyun.huo15.com/web/image/website/1/logo'\n\ndef get_company_info_from_system():\n \"\"\"\n 从公司系统(Odoo)获取公司信息\n 返回: dict {\n 'company_name': str,\n 'logo_path': str,\n 'vision': str, # 公司愿景\n 'philosophy': str, # 公司理念\n 'slogan': str # slogan\n }\n \"\"\"\n company_info = {\n 'company_name': '青岛火一五信息科技有限公司',\n 'vision': '推动B端用户向全场景人工智能机器人转变',\n 'philosophy': '打破信息孤岛，用一套系统驱动企业增长',\n 'slogan': '',\n 'logo_path': None\n }\n \n # 1. 尝试从公司系统获取\n try:\n # 读取 Odoo 配置\n agent_id = os.environ.get('OC_AGENT_ID', 'main')\n agents_dir = os.path.expanduser('~/.openclaw/agents')\n creds_file = os.path.join(agents_dir, agent_id, 'odoo_creds.json')\n \n if os.path.exists(creds_file):\n with open(creds_file, 'r') as f:\n creds = json.load(f)\n \n # 获取全局配置\n openclaw_cfg_file = os.path.expanduser('~/.openclaw/openclaw.json')\n if os.path.exists(openclaw_cfg_file):\n with open(openclaw_cfg_file, 'r') as f:\n cfg = json.load(f)\n odoo_env = cfg.get('skills', {}).get('entries', {}).get('huo15-odoo', {}).get('env', {})\n url = odoo_env.get('ODOO_URL', 'https://huihuoyun.huo15.com')\n db = odoo_env.get('ODOO_DB', 'huo15_prod')\n user = creds.get('user', '')\n password = creds.get('password', '')\n \n if user and password:\n # 连接 Odoo\n ctx = ssl.create_default_context()\n ctx.check_hostname = False\n ctx.verify_mode = ssl.CERT_NONE\n \n common = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/common', context=ctx)\n uid = common.authenticate(db, user, password, {})\n \n if uid:\n models = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/object', context=ctx)\n \n # 获取公司配置 (res.company)\n company_data = models.execute_kw(db, uid, password, 'res.company', 'search_read',\n [[('id', '=', 1)]], {'fields': ['name', 'logo'], 'limit': 1})\n \n if company_data:\n company_info['company_name'] = company_data[0].get('name', company_info['company_name'])\n logo_id = company_data[0].get('logo')\n if logo_id:\n # 下载 LOGO\n logo_url = f'{url}/web/image/res.company/{logo_id}/logo'\n ensure_logo_downloaded(logo_url, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 获取系统参数 (ir.config_parameter) - 愿景/理念\n vision_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.vision')]], {'fields': ['value'], 'limit': 1})\n if vision_config and vision_config[0].get('value'):\n company_info['vision'] = vision_config[0]['value']\n \n philosophy_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.philosophy')]], {'fields': ['value'], 'limit': 1})\n if philosophy_config and philosophy_config[0].get('value'):\n company_info['philosophy'] = philosophy_config[0]['value']\n \n slogan_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.slogan')]], {'fields': ['value'], 'limit': 1})\n if slogan_config and slogan_config[0].get('value'):\n company_info['slogan'] = slogan_config[0]['value']\n else:\n # 无凭证，使用备用 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n except Exception as e:\n print(f\"获取公司信息失败，使用默认信息: {e}\")\n # 备用：下载默认 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 确保 LOGO 存在\n if not company_info['logo_path'] or not os.path.exists(company_info['logo_path']):\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n return company_info\n\ndef ensure_logo_downloaded(url, dest_path):\n \"\"\"确保 LOGO 已下载\"\"\"\n if os.path.exists(dest_path) and os.path.getsize(dest_path) > 1000:\n return dest_path\n \n os.makedirs(os.path.dirname(dest_path), exist_ok=True)\n try:\n urllib.request.urlretrieve(url, dest_path)\n print(f\"✓ LOGO 已下载: {dest_path}\")\n except Exception as e:\n print(f\"⚠ LOGO 下载失败: {e}\")\n # 尝试备用 URL\n try:\n urllib.request.urlretrieve(FALLBACK_LOGO_URL, dest_path)\n print(f\"✓ 备用 LOGO 已下载: {dest_path}\")\n except:\n pass\n return dest_path\n```\n\n### 字体设置函数\n\n```python\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n```\n\n### 页眉函数（含 LOGO + 公司名称 + 底线）\n\n```python\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉：LOGO + 公司名称 + 底线\"\"\"\n if logo_path is None or company_name is None:\n info = get_company_info_from_system()\n logo_path = logo_path or info.get('logo_path') or DEFAULT_LOGO_PATH\n company_name = company_name or info.get('company_name', '青岛火一五信息科技有限公司')\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n section.header_distance = Cm(1.5)\n \n # 添加 LOGO + 公司名称\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n # 添加 LOGO\n if os.path.exists(logo_path):\n try:\n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n except:\n pass\n \n # 添加公司名称\n run = paragraph.add_run(f' {company_name}')\n set_chinese_font(run, '黑体', 10)\n \n # 添加底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n \n return header\n```\n\n### 页脚函数（页码）\n\n```python\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚：第 X 页 共 Y 页\"\"\"\n section = doc.sections[0]\n section.footer_distance = Cm(1.5)\n footer = section.footer\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n for text, is_field in [(\"第\", False), (\"PAGE\", True), (\"页 共\", False), (\"NUMPAGES\", True), (\"页\", False)]:\n run = paragraph.add_run(text)\n set_chinese_font(run, '仿宋', 12)\n if is_field:\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText = OxmlElement('w:instrText')\n instrText.text = text\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run._element.clear()\n run._element.append(fldChar1)\n run._element.append(instrText)\n run._element.append(fldChar2)\n```\n\n### 创建文档主函数\n\n```python\ndef create_formatted_doc(title=\"\", logo_path=None, company_name=None, insert_vision=False):\n \"\"\"\n 🚀 一条命令创建符合公司规范的 Word 文档\n \n 参数:\n title: 文档标题（可选）\n logo_path: LOGO 图片路径（可选，默认自动获取）\n company_name: 公司名称（可选，默认自动获取）\n insert_vision: 是否在公司名称后插入愿景理念（可选，默认False）\n \n 返回:\n doc: python-docx Document 对象\n \n 使用示例:\n doc = create_formatted_doc(\"销售合同\")\n doc.add_paragraph(\"合同正文内容...\")\n doc.save(\"CONTRACT_客户_20250319.docx\")\n \"\"\"\n # 1. 创建文档\n doc = Document()\n \n # 2. 设置页面边距（GB/T 9704-2012）\n for section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n \n # 3. 添加页眉（LOGO + 公司名）\n add_header_with_logo(doc, logo_path, company_name)\n \n # 4. 添加页脚（页码）\n add_footer_with_page_numbers(doc)\n \n # 5. 设置默认字体\n style = doc.styles['Normal']\n style.font.name = '仿宋'\n style.font.size = Pt(12)\n style._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n \n # 6. 添加标题（如果提供）\n if title:\n p = doc.add_paragraph(title)\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in p.runs:\n set_chinese_font(run, '黑体', 22, True)\n \n return doc\n\ndef add_vision_paragraph(doc, company_info=None):\n \"\"\"\n 在文档末尾添加公司愿景理念段落（分两行，左对齐）\n 用于需要展示公司文化的正式文档\n \"\"\"\n if company_info is None:\n company_info = get_company_info_from_system()\n \n vision = company_info.get('vision', '')\n philosophy = company_info.get('philosophy', '')\n \n if not vision and not philosophy:\n return\n \n # 添加分隔线\n p = doc.add_paragraph()\n run = p.add_run('─' * 40)\n set_chinese_font(run, '仿宋', 10)\n \n # 愿景（左对齐）\n if vision:\n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.LEFT\n run = p.add_run(f'【愿景】{vision}')\n set_chinese_font(run, '楷体', 11)\n \n # 理念（左对齐）\n if philosophy:\n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.LEFT\n run = p.add_run(f'【理念】{philosophy}')\n set_chinese_font(run, '楷体', 11)\n```\n\n---\n\n## 📁 文档命名规则（必须遵循）\n\n### 命名格式\n\n```\n[文档类型]_[客户名称]_[项目名称]_[日期]_[版本].docx\n```\n\n### 命名元素说明\n\n| 元素 | 说明 | 示例 | 必填 |\n|------|------|------|------|\n| 文档类型 | 具体文档类型 | 合同、报价单、发货单、会议纪要、技术方案 | ✅ |\n| 客户名称 | 客户公司简称 | 阿里、腾讯、华为、海尔 | ✅ |\n| 项目名称 | 项目名称（可选） | ERP、MES、WMS、OA | ○ |\n| 日期 | 文档日期，格式 YYYYMMDD | 20250319 | ✅ |\n| 版本 | 版本号 v1.0（可选，默认 v1.0） | v1.0、v1.1、v2.0 | ○ |\n\n### 自动命名函数\n\n```python\nimport datetime\n\ndef generate_doc_name(doc_type, customer_name, project_name=\"\", version=\"v1.0\"):\n \"\"\"\n 生成符合规范的文档名称\n \n 参数:\n doc_type: 文档类型编码（如 CONTRACT, QUOTE）\n customer_name: 客户名称\n project_name: 项目名称（可选）\n version: 版本号（可选，默认 v1.0）\n \n 返回:\n 文档名称字符串，如 CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n \"\"\"\n date_str = datetime.datetime.now().strftime(\"%Y%m%d\")\n customer = customer_name.replace(\"有限公司\", \"\").replace(\"股份有限公司\", \"\").replace(\"集团\", \"\").strip()\n project = project_name.strip() if project_name else \"\"\n \n parts = [doc_type, customer]\n if project:\n parts.append(project)\n parts.append(date_str)\n \n if version and version != \"v1.0\":\n parts.append(version)\n \n return \"_\".join(parts) + \".docx\"\n```\n\n---\n\n## 公司信息\n\n- 公司名称：青岛火一五信息科技有限公司\n- 默认愿景：推动B端用户向全场景人工智能机器人转变\n- 默认理念：打破信息孤岛，用一套系统驱动企业增长\n- LOGO：从公司系统自动获取\n\n---\n\n## 文档结构\n\n1. 合同标题 - 居中，黑体二号加粗\n2. 合同编号 - 居中，仿宋三号\n3. 签订日期 - 居中，仿宋三号\n4. 一，二，三...章 - 楷体三号加粗\n5. 签署栏 - 盖章、法定代表人、日期\n\n---\n\n## 触发关键词\n\n**文档生成类（自动触发本技能）：**\n- 写word、写文档、写个文档\n- 生成word、生成文档、创建word、创建文档\n- 导出word、导出文档、下载word、下载文档\n- .docx、word文档、Word文档、Word生成、生成Word\n\n**具体文档类（自动触发本技能）：**\n- 写合同、写报价单、写说明书、写会议纪要\n- 合同模板、报价单模板、文档模板、公司文档\n\n**正式文档类（自动触发本技能）：**\n- 正式文档、公文、标书、方案文档\n- 年度报告、通知、请示、报告、函\n\nFile v1.4.0:_meta.json\n\n{\n \"ownerId\": \"kn7b0rmtgvbq55rc54rhp69r79822ym9\",\n \"slug\": \"huo15-doc-template\",\n \"version\": \"1.4.0\",\n \"publishedAt\": 1775013094675\n}\n\nFile v1.4.0:skill-card.md\n\n## Description:\n\nProvides Chinese Word document template guidance and Python snippets for generating Huo15-branded .docx documents with prescribed fonts, margins, headers, footers, page numbers, and naming conventions.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[jobzhao15](https://clawhub.ai/user/jobzhao15)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and business users use this skill to create formal Chinese Word documents such as contracts, quotes, meeting minutes, reports, notices, and specification documents with consistent company formatting.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can automatically use local Odoo credentials while generating documents.\n\nMitigation: Install only where Huo15-branded Chinese documents are intended and require explicit user approval before credential-backed company-system access.\n\nRisk: The embedded Odoo retrieval code disables TLS certificate verification.\n\nMitigation: Restore TLS verification before using the retrieval code and constrain access to approved endpoints.\n\nRisk: Company identity details and logo assets may be pulled from external Huo15 endpoints.\n\nMitigation: Confirm the endpoint scope and data handling expectations before enabling automatic company-system retrieval.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/jobzhao15/skills/huo15-doc-template)\n- [Huo15 company system](https://huihuoyun.huo15.com)\n- [Huo15 website logo endpoint](https://huihuoyun.huo15.com/web/image/website/1/logo)\n- [Huo15 fallback logo asset](https://tools.huo15.com/uploads/images/system/logo-colours.png)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, configuration, guidance, files]\n\n**Output Format:** [Markdown guidance with Python code snippets and generated .docx files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses Chinese Word/WPS formatting conventions and may retrieve company logo and profile information from configured Huo15 Odoo services.]\n\n## Skill Version(s):\n\n1.4.0 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.3.4: 2 files, 6611 bytes\n\nFiles: _meta.json (137b), SKILL.md (19095b)\n\nFile v1.3.4:SKILL.md\n\n---\nname: huo15-doc-template / 火一五文档模板\ndescription: 【版权：青岛火一五信息科技有限公司 账号：huo15】**Word/文档生成首选技能**。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、合同模板、报价单模板、文档模板、公司文档、正式文档、公文、标书、方案文档、年度报告、通知、请示、报告、函。所有 Word 文档、.docx 文件、公文、合同、报价单、说明书、会议纪要、发货单、PDA 单据等文档生成任务自动使用本技能。\n\n## 重要：此为首选文档技能\n**所有 Word 文档生成任务都必须使用此技能**\n\n---\n\n## ⚠️ 强制检查清单（生成文档前必须完成）\n\n> **新用户必读！每次生成文档前对照检查，否则文档不合格！**\n\n- [ ] **LOGO 是否添加？** —— 页眉必须有 LOGO + 公司名称 + 底线\n- [ ] **页码是否添加？** —— 页脚必须有\"第 X 页 共 Y 页\"\n- [ ] **字体是否正确？** —— 正文仿宋，标题黑体/楷体\n- [ ] **页面边距是否正确？** —— 上下 3.7/3.5cm，左右 2.8/2.6cm\n- [ ] **命名是否规范？** —— 文档类型_客户名称_日期.docx\n\n**如果没有完成以上检查，文档不允许交付！**\n\n---\n\n## 🚀 快速开始\n\n> **重要**：代码模板直接写在 SKILL.md 中，复制使用即可！无需 pip install！\n\n```python\n# 一步创建符合公司规范的文档\ndoc = create_formatted_doc(\n title=\"销售合同\",\n company_name=\"青岛火一五信息科技有限公司\",\n insert_vision=True # 可选：插入公司愿景理念\n)\ndoc.add_paragraph(\"合同正文内容...\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n```\n\n> **LOGO/公司信息会自动从公司系统获取**，无需手动配置！\n\n---\n\n# 文档模板技能\n\n## 快速开始\n\n1. **字体设置**：默认使用仿宋，小四（12pt）\n2. **页面边距**：上下 3.7/3.5cm，左右 2.8/2.6cm\n3. **页眉**：LOGO + 公司名称 + 底线\n4. **页脚**：页码居中，格式\"第 X 页 共 Y 页\"，仿宋小四\n\n---\n\n## 配置规则\n\n### 字体规范\n- **默认正文**：仿宋，小四（12pt）\n- **一级标题**：黑体，小三（15pt），加粗\n- **二级标题**：楷体，小四（12pt），加粗\n- **三级标题**：仿宋，小四（12pt），加粗\n\n**WPS 字体兼容**：\n- 汉字字体：使用 `仿宋`\n- 每个 run 都要设置字体域 `w:eastAsia`\n\n---\n\n## ⚠️ 重要：Markdown 语法转换规则\n\n### 禁止直接在 Word 中使用 Markdown 语法\n\n**严禁将 Markdown 语法直接写入 Word 文档**，例如：\n- ❌ 错误：`**加粗文本**` → Word 中会显示星号\n- ❌ 错误：`| 列1 | 列2 |` → Word 中会显示管道符\n- ❌ 错误：`# 一级标题` → Word 中会显示井号\n\n### 正确转换方法\n\n#### 1. 加粗转换\n- Markdown：`**这是加粗**`\n- Word：设置 `run.bold = True`\n\n```python\n# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗\n```\n\n#### 2. 表格转换\n- Markdown：\n```\n| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |\n```\n- Word：使用 `doc.add_table()` 创建表格\n\n```python\n# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)\n```\n\n#### 3. 标题转换\n- Markdown：`# 一级标题`\n- Word：添加段落并设置样式\n\n```python\n# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)\n```\n\n### 自检清单（生成文档前必查）\n\n生成文档后，检查以下内容：\n- [ ] 文档中是否有 `**`、`__`、`#` 等 Markdown 符号？\n- [ ] 表格是否使用了 `|` 管道符？\n- [ ] 链接是否显示了 `[文字](URL)` 格式？\n- [ ] 列表是否显示了 `-` 或 `*` 前缀？\n\n**如果有任何一项为\"是\"，则文档不合格，需要重新生成**\n\n---\n\n## 🚀 核心函数（必须使用）\n\n### 公司信息获取函数\n\n```python\nimport ssl\nimport json\nimport os\nimport urllib.request\nimport xmlrpc.client\n\n# ============== 公司信息配置 ==============\nUSER_HOME = os.path.expanduser(\"~\")\nLOGO_DIR = os.path.join(USER_HOME, \".huo15\", \"assets\")\nDEFAULT_LOGO_PATH = os.path.join(LOGO_DIR, \"logo.png\")\n\n# 备用 LOGO URL\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_LOGO_URL = 'https://huihuoyun.huo15.com/web/image/website/1/logo'\n\ndef get_company_info_from_system():\n \"\"\"\n 从公司系统(Odoo)获取公司信息\n 返回: dict {\n 'company_name': str,\n 'logo_path': str,\n 'vision': str, # 公司愿景\n 'philosophy': str, # 公司理念\n 'slogan': str # slogan\n }\n \"\"\"\n company_info = {\n 'company_name': '青岛火一五信息科技有限公司',\n 'vision': '推动B端用户向全场景人工智能机器人转变',\n 'philosophy': '打破信息孤岛，用一套系统驱动企业增长',\n 'slogan': '',\n 'logo_path': None\n }\n \n # 1. 尝试从公司系统获取\n try:\n # 读取 Odoo 配置\n agent_id = os.environ.get('OC_AGENT_ID', 'main')\n agents_dir = os.path.expanduser('~/.openclaw/agents')\n creds_file = os.path.join(agents_dir, agent_id, 'odoo_creds.json')\n \n if os.path.exists(creds_file):\n with open(creds_file, 'r') as f:\n creds = json.load(f)\n \n # 获取全局配置\n openclaw_cfg_file = os.path.expanduser('~/.openclaw/openclaw.json')\n if os.path.exists(openclaw_cfg_file):\n with open(openclaw_cfg_file, 'r') as f:\n cfg = json.load(f)\n odoo_env = cfg.get('skills', {}).get('entries', {}).get('huo15-odoo', {}).get('env', {})\n url = odoo_env.get('ODOO_URL', 'https://huihuoyun.huo15.com')\n db = odoo_env.get('ODOO_DB', 'huo15_prod')\n user = creds.get('user', '')\n password = creds.get('password', '')\n \n if user and password:\n # 连接 Odoo\n ctx = ssl.create_default_context()\n ctx.check_hostname = False\n ctx.verify_mode = ssl.CERT_NONE\n \n common = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/common', context=ctx)\n uid = common.authenticate(db, user, password, {})\n \n if uid:\n models = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/object', context=ctx)\n \n # 获取公司配置 (res.company)\n company_data = models.execute_kw(db, uid, password, 'res.company', 'search_read',\n [[('id', '=', 1)]], {'fields': ['name', 'logo'], 'limit': 1})\n \n if company_data:\n company_info['company_name'] = company_data[0].get('name', company_info['company_name'])\n logo_id = company_data[0].get('logo')\n if logo_id:\n # 下载 LOGO\n logo_url = f'{url}/web/image/res.company/{logo_id}/logo'\n ensure_logo_downloaded(logo_url, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 获取系统参数 (ir.config_parameter) - 愿景/理念\n vision_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.vision')]], {'fields': ['value'], 'limit': 1})\n if vision_config and vision_config[0].get('value'):\n company_info['vision'] = vision_config[0]['value']\n \n philosophy_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.philosophy')]], {'fields': ['value'], 'limit': 1})\n if philosophy_config and philosophy_config[0].get('value'):\n company_info['philosophy'] = philosophy_config[0]['value']\n \n slogan_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.slogan')]], {'fields': ['value'], 'limit': 1})\n if slogan_config and slogan_config[0].get('value'):\n company_info['slogan'] = slogan_config[0]['value']\n else:\n # 无凭证，使用备用 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n except Exception as e:\n print(f\"获取公司信息失败，使用默认信息: {e}\")\n # 备用：下载默认 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 确保 LOGO 存在\n if not company_info['logo_path'] or not os.path.exists(company_info['logo_path']):\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n return company_info\n\ndef ensure_logo_downloaded(url, dest_path):\n \"\"\"确保 LOGO 已下载\"\"\"\n if os.path.exists(dest_path) and os.path.getsize(dest_path) > 1000:\n return dest_path\n \n os.makedirs(os.path.dirname(dest_path), exist_ok=True)\n try:\n urllib.request.urlretrieve(url, dest_path)\n print(f\"✓ LOGO 已下载: {dest_path}\")\n except Exception as e:\n print(f\"⚠ LOGO 下载失败: {e}\")\n # 尝试备用 URL\n try:\n urllib.request.urlretrieve(FALLBACK_LOGO_URL, dest_path)\n print(f\"✓ 备用 LOGO 已下载: {dest_path}\")\n except:\n pass\n return dest_path\n```\n\n### 字体设置函数\n\n```python\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n```\n\n### 页眉函数（含 LOGO + 公司名称 + 底线）\n\n```python\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉：LOGO + 公司名称 + 底线\"\"\"\n if logo_path is None or company_name is None:\n info = get_company_info_from_system()\n logo_path = logo_path or info.get('logo_path') or DEFAULT_LOGO_PATH\n company_name = company_name or info.get('company_name', '青岛火一五信息科技有限公司')\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n section.header_distance = Cm(1.5)\n \n # 添加 LOGO + 公司名称\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n # 添加 LOGO\n if os.path.exists(logo_path):\n try:\n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n except:\n pass\n \n # 添加公司名称\n run = paragraph.add_run(f' {company_name}')\n set_chinese_font(run, '黑体', 10)\n \n # 添加底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n \n return header\n```\n\n### 页脚函数（页码）\n\n```python\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚：第 X 页 共 Y 页\"\"\"\n section = doc.sections[0]\n section.footer_distance = Cm(1.5)\n footer = section.footer\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n for text, is_field in [(\"第\", False), (\"PAGE\", True), (\"页 共\", False), (\"NUMPAGES\", True), (\"页\", False)]:\n run = paragraph.add_run(text)\n set_chinese_font(run, '仿宋', 12)\n if is_field:\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText = OxmlElement('w:instrText')\n instrText.text = text\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run._element.clear()\n run._element.append(fldChar1)\n run._element.append(instrText)\n run._element.append(fldChar2)\n```\n\n### 创建文档主函数\n\n```python\ndef create_formatted_doc(title=\"\", logo_path=None, company_name=None, insert_vision=False):\n \"\"\"\n 🚀 一条命令创建符合公司规范的 Word 文档\n \n 参数:\n title: 文档标题（可选）\n logo_path: LOGO 图片路径（可选，默认自动获取）\n company_name: 公司名称（可选，默认自动获取）\n insert_vision: 是否在公司名称后插入愿景理念（可选，默认False）\n \n 返回:\n doc: python-docx Document 对象\n \n 使用示例:\n doc = create_formatted_doc(\"销售合同\")\n doc.add_paragraph(\"合同正文内容...\")\n doc.save(\"CONTRACT_客户_20250319.docx\")\n \"\"\"\n # 1. 创建文档\n doc = Document()\n \n # 2. 设置页面边距（GB/T 9704-2012）\n for section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n \n # 3. 添加页眉（LOGO + 公司名）\n add_header_with_logo(doc, logo_path, company_name)\n \n # 4. 添加页脚（页码）\n add_footer_with_page_numbers(doc)\n \n # 5. 设置默认字体\n style = doc.styles['Normal']\n style.font.name = '仿宋'\n style.font.size = Pt(12)\n style._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n \n # 6. 添加标题（如果提供）\n if title:\n p = doc.add_paragraph(title)\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in p.runs:\n set_chinese_font(run, '黑体', 22, True)\n \n return doc\n\ndef add_vision_paragraph(doc, company_info=None):\n \"\"\"\n 在文档末尾添加公司愿景理念段落（分两行，左对齐）\n 用于需要展示公司文化的正式文档\n \"\"\"\n if company_info is None:\n company_info = get_company_info_from_system()\n \n vision = company_info.get('vision', '')\n philosophy = company_info.get('philosophy', '')\n \n if not vision and not philosophy:\n return\n \n # 添加分隔线\n p = doc.add_paragraph()\n run = p.add_run('─' * 40)\n set_chinese_font(run, '仿宋', 10)\n \n # 愿景（左对齐）\n if vision:\n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.LEFT\n run = p.add_run(f'【愿景】{vision}')\n set_chinese_font(run, '楷体', 11)\n \n # 理念（左对齐）\n if philosophy:\n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.LEFT\n run = p.add_run(f'【理念】{philosophy}')\n set_chinese_font(run, '楷体', 11)\n```\n\n---\n\n## 📁 文档命名规则（必须遵循）\n\n### 命名格式\n\n```\n[文档类型]_[客户名称]_[项目名称]_[日期]_[版本].docx\n```\n\n### 命名元素说明\n\n| 元素 | 说明 | 示例 | 必填 |\n|------|------|------|------|\n| 文档类型 | 具体文档类型 | 合同、报价单、发货单、会议纪要、技术方案 | ✅ |\n| 客户名称 | 客户公司简称 | 阿里、腾讯、华为、海尔 | ✅ |\n| 项目名称 | 项目名称（可选） | ERP、MES、WMS、OA | ○ |\n| 日期 | 文档日期，格式 YYYYMMDD | 20250319 | ✅ |\n| 版本 | 版本号 v1.0（可选，默认 v1.0） | v1.0、v1.1、v2.0 | ○ |\n\n### 自动命名函数\n\n```python\nimport datetime\n\ndef generate_doc_name(doc_type, customer_name, project_name=\"\", version=\"v1.0\"):\n \"\"\"\n 生成符合规范的文档名称\n \n 参数:\n doc_type: 文档类型编码（如 CONTRACT, QUOTE）\n customer_name: 客户名称\n project_name: 项目名称（可选）\n version: 版本号（可选，默认 v1.0）\n \n 返回:\n 文档名称字符串，如 CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n \"\"\"\n date_str = datetime.datetime.now().strftime(\"%Y%m%d\")\n customer = customer_name.replace(\"有限公司\", \"\").replace(\"股份有限公司\", \"\").replace(\"集团\", \"\").strip()\n project = project_name.strip() if project_name else \"\"\n \n parts = [doc_type, customer]\n if project:\n parts.append(project)\n parts.append(date_str)\n \n if version and version != \"v1.0\":\n parts.append(version)\n \n return \"_\".join(parts) + \".docx\"\n```\n\n---\n\n## 公司信息\n\n- 公司名称：青岛火一五信息科技有限公司\n- 默认愿景：推动B端用户向全场景人工智能机器人转变\n- 默认理念：打破信息孤岛，用一套系统驱动企业增长\n- LOGO：从公司系统自动获取\n\n---\n\n## 文档结构\n\n1. 合同标题 - 居中，黑体二号加粗\n2. 合同编号 - 居中，仿宋三号\n3. 签订日期 - 居中，仿宋三号\n4. 一，二，三...章 - 楷体三号加粗\n5. 签署栏 - 盖章、法定代表人、日期\n\n---\n\n## 触发关键词\n\n**文档生成类（自动触发本技能）：**\n- 写word、写文档、写个文档\n- 生成word、生成文档、创建word、创建文档\n- 导出word、导出文档、下载word、下载文档\n- .docx、word文档、Word文档、Word生成、生成Word\n\n**具体文档类（自动触发本技能）：**\n- 写合同、写报价单、写说明书、写会议纪要\n- 合同模板、报价单模板、文档模板、公司文档\n\n**正式文档类（自动触发本技能）：**\n- 正式文档、公文、标书、方案文档\n- 年度报告、通知、请示、报告、函\n\nFile v1.3.4:_meta.json\n\n{\n \"ownerId\": \"kn7b0rmtgvbq55rc54rhp69r79822ym9\",\n \"slug\": \"huo15-doc-template\",\n \"version\": \"1.3.4\",\n \"publishedAt\": 1774933129020\n}\n\nArchive v1.3.3: 2 files, 6750 bytes\n\nFiles: _meta.json (137b), SKILL.md (19376b)\n\nFile v1.3.3:SKILL.md\n\n---\nname: huo15-doc-template / 火一五文档模板\ndescription: 【版权：青岛火一五信息科技有限公司 账号：huo15】**Word/文档生成首选技能**。所有 Word 文档、.docx 文件、公文、合同、报价单、说明书、会议纪要、发货单、PDA 单据等文档生成任务自动触发。\ntrigger:\n - type: fuzzy\n patterns:\n - \"写word\"\n - \"写文档\"\n - \"写个文档\"\n - \"重新写\"\n - \"重新生成\"\n - \"生成word\"\n - \"生成文档\"\n - \"创建word\"\n - \"创建文档\"\n - \"导出word\"\n - \"导出文档\"\n - \"下载word\"\n - \"下载文档\"\n - \"docx\"\n - \"word文档\"\n - \"Word文档\"\n - \"写合同\"\n - \"写报价单\"\n - \"写说明书\"\n - \"写会议纪要\"\n - \"合同模板\"\n - \"报价单模板\"\n - \"文档模板\"\n - \"公司文档\"\n - \"正式文档\"\n - \"公文\"\n - \"标书\"\n - \"方案文档\"\n - \"年度报告\"\n - \"通知\"\n - \"请示\"\n - \"报告\"\n - \"函\"\n\n## 重要：此为首选文档技能\n**所有 Word 文档生成任务都必须使用此技能**\n\n---\n\n## ⚠️ 强制检查清单（生成文档前必须完成）\n\n> **新用户必读！每次生成文档前对照检查，否则文档不合格！**\n\n- [ ] **LOGO 是否添加？** —— 页眉必须有 LOGO + 公司名称 + 底线\n- [ ] **页码是否添加？** —— 页脚必须有\"第 X 页 共 Y 页\"\n- [ ] **字体是否正确？** —— 正文仿宋，标题黑体/楷体\n- [ ] **页面边距是否正确？** —— 上下 3.7/3.5cm，左右 2.8/2.6cm\n- [ ] **命名是否规范？** —— 文档类型_客户名称_日期.docx\n\n**如果没有完成以上检查，文档不允许交付！**\n\n---\n\n## 🚀 快速开始\n\n> **重要**：代码模板直接写在 SKILL.md 中，复制使用即可！无需 pip install！\n\n```python\n# 一步创建符合公司规范的文档\ndoc = create_formatted_doc(\n title=\"销售合同\",\n company_name=\"青岛火一五信息科技有限公司\",\n insert_vision=True # 可选：插入公司愿景理念\n)\ndoc.add_paragraph(\"合同正文内容...\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n```\n\n> **LOGO/公司信息会自动从公司系统获取**，无需手动配置！\n\n---\n\n# 文档模板技能\n\n## 快速开始\n\n1. **字体设置**：默认使用仿宋，小四（12pt）\n2. **页面边距**：上下 3.7/3.5cm，左右 2.8/2.6cm\n3. **页眉**：LOGO + 公司名称 + 底线\n4. **页脚**：页码居中，格式\"第 X 页 共 Y 页\"，仿宋小四\n\n---\n\n## 配置规则\n\n### 字体规范\n- **默认正文**：仿宋，小四（12pt）\n- **一级标题**：黑体，小三（15pt），加粗\n- **二级标题**：楷体，小四（12pt），加粗\n- **三级标题**：仿宋，小四（12pt），加粗\n\n**WPS 字体兼容**：\n- 汉字字体：使用 `仿宋`\n- 每个 run 都要设置字体域 `w:eastAsia`\n\n---\n\n## ⚠️ 重要：Markdown 语法转换规则\n\n### 禁止直接在 Word 中使用 Markdown 语法\n\n**严禁将 Markdown 语法直接写入 Word 文档**，例如：\n- ❌ 错误：`**加粗文本**` → Word 中会显示星号\n- ❌ 错误：`| 列1 | 列2 |` → Word 中会显示管道符\n- ❌ 错误：`# 一级标题` → Word 中会显示井号\n\n### 正确转换方法\n\n#### 1. 加粗转换\n- Markdown：`**这是加粗**`\n- Word：设置 `run.bold = True`\n\n```python\n# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗\n```\n\n#### 2. 表格转换\n- Markdown：\n```\n| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |\n```\n- Word：使用 `doc.add_table()` 创建表格\n\n```python\n# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)\n```\n\n#### 3. 标题转换\n- Markdown：`# 一级标题`\n- Word：添加段落并设置样式\n\n```python\n# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)\n```\n\n### 自检清单（生成文档前必查）\n\n生成文档后，检查以下内容：\n- [ ] 文档中是否有 `**`、`__`、`#` 等 Markdown 符号？\n- [ ] 表格是否使用了 `|` 管道符？\n- [ ] 链接是否显示了 `[文字](URL)` 格式？\n- [ ] 列表是否显示了 `-` 或 `*` 前缀？\n\n**如果有任何一项为\"是\"，则文档不合格，需要重新生成**\n\n---\n\n## 🚀 核心函数（必须使用）\n\n### 公司信息获取函数\n\n```python\nimport ssl\nimport json\nimport os\nimport urllib.request\nimport xmlrpc.client\n\n# ============== 公司信息配置 ==============\nUSER_HOME = os.path.expanduser(\"~\")\nLOGO_DIR = os.path.join(USER_HOME, \".huo15\", \"assets\")\nDEFAULT_LOGO_PATH = os.path.join(LOGO_DIR, \"logo.png\")\n\n# 备用 LOGO URL\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_LOGO_URL = 'https://huihuoyun.huo15.com/web/image/website/1/logo'\n\ndef get_company_info_from_system():\n \"\"\"\n 从公司系统(Odoo)获取公司信息\n 返回: dict {\n 'company_name': str,\n 'logo_path': str,\n 'vision': str, # 公司愿景\n 'philosophy': str, # 公司理念\n 'slogan': str # slogan\n }\n \"\"\"\n company_info = {\n 'company_name': '青岛火一五信息科技有限公司',\n 'vision': '推动B端用户向全场景人工智能机器人转变',\n 'philosophy': '打破信息孤岛，用一套系统驱动企业增长',\n 'slogan': '',\n 'logo_path': None\n }\n \n # 1. 尝试从公司系统获取\n try:\n # 读取 Odoo 配置\n agent_id = os.environ.get('OC_AGENT_ID', 'main')\n agents_dir = os.path.expanduser('~/.openclaw/agents')\n creds_file = os.path.join(agents_dir, agent_id, 'odoo_creds.json')\n \n if os.path.exists(creds_file):\n with open(creds_file, 'r') as f:\n creds = json.load(f)\n \n # 获取全局配置\n openclaw_cfg_file = os.path.expanduser('~/.openclaw/openclaw.json')\n if os.path.exists(openclaw_cfg_file):\n with open(openclaw_cfg_file, 'r') as f:\n cfg = json.load(f)\n odoo_env = cfg.get('skills', {}).get('entries', {}).get('huo15-odoo', {}).get('env', {})\n url = odoo_env.get('ODOO_URL', 'https://huihuoyun.huo15.com')\n db = odoo_env.get('ODOO_DB', 'huo15_prod')\n user = creds.get('user', '')\n password = creds.get('password', '')\n \n if user and password:\n # 连接 Odoo\n ctx = ssl.create_default_context()\n ctx.check_hostname = False\n ctx.verify_mode = ssl.CERT_NONE\n \n common = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/common', context=ctx)\n uid = common.authenticate(db, user, password, {})\n \n if uid:\n models = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/object', context=ctx)\n \n # 获取公司配置 (res.company)\n company_data = models.execute_kw(db, uid, password, 'res.company', 'search_read',\n [[('id', '=', 1)]], {'fields': ['name', 'logo'], 'limit': 1})\n \n if company_data:\n company_info['company_name'] = company_data[0].get('name', company_info['company_name'])\n logo_id = company_data[0].get('logo')\n if logo_id:\n # 下载 LOGO\n logo_url = f'{url}/web/image/res.company/{logo_id}/logo'\n ensure_logo_downloaded(logo_url, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 获取系统参数 (ir.config_parameter) - 愿景/理念\n vision_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.vision')]], {'fields': ['value'], 'limit': 1})\n if vision_config and vision_config[0].get('value'):\n company_info['vision'] = vision_config[0]['value']\n \n philosophy_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.philosophy')]], {'fields': ['value'], 'limit': 1})\n if philosophy_config and philosophy_config[0].get('value'):\n company_info['philosophy'] = philosophy_config[0]['value']\n \n slogan_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.slogan')]], {'fields': ['value'], 'limit': 1})\n if slogan_config and slogan_config[0].get('value'):\n company_info['slogan'] = slogan_config[0]['value']\n else:\n # 无凭证，使用备用 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n except Exception as e:\n print(f\"获取公司信息失败，使用默认信息: {e}\")\n # 备用：下载默认 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 确保 LOGO 存在\n if not company_info['logo_path'] or not os.path.exists(company_info['logo_path']):\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n return company_info\n\ndef ensure_logo_downloaded(url, dest_path):\n \"\"\"确保 LOGO 已下载\"\"\"\n if os.path.exists(dest_path) and os.path.getsize(dest_path) > 1000:\n return dest_path\n \n os.makedirs(os.path.dirname(dest_path), exist_ok=True)\n try:\n urllib.request.urlretrieve(url, dest_path)\n print(f\"✓ LOGO 已下载: {dest_path}\")\n except Exception as e:\n print(f\"⚠ LOGO 下载失败: {e}\")\n # 尝试备用 URL\n try:\n urllib.request.urlretrieve(FALLBACK_LOGO_URL, dest_path)\n print(f\"✓ 备用 LOGO 已下载: {dest_path}\")\n except:\n pass\n return dest_path\n```\n\n### 字体设置函数\n\n```python\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n```\n\n### 页眉函数（含 LOGO + 公司名称 + 底线）\n\n```python\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉：LOGO + 公司名称 + 底线\"\"\"\n if logo_path is None or company_name is None:\n info = get_company_info_from_system()\n logo_path = logo_path or info.get('logo_path') or DEFAULT_LOGO_PATH\n company_name = company_name or info.get('company_name', '青岛火一五信息科技有限公司')\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n section.header_distance = Cm(1.5)\n \n # 添加 LOGO + 公司名称\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n # 添加 LOGO\n if os.path.exists(logo_path):\n try:\n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n except:\n pass\n \n # 添加公司名称\n run = paragraph.add_run(f' {company_name}')\n set_chinese_font(run, '黑体', 10)\n \n # 添加底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n \n return header\n```\n\n### 页脚函数（页码）\n\n```python\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚：第 X 页 共 Y 页\"\"\"\n section = doc.sections[0]\n section.footer_distance = Cm(1.5)\n footer = section.footer\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n for text, is_field in [(\"第\", False), (\"PAGE\", True), (\"页 共\", False), (\"NUMPAGES\", True), (\"页\", False)]:\n run = paragraph.add_run(text)\n set_chinese_font(run, '仿宋', 12)\n if is_field:\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText = OxmlElement('w:instrText')\n instrText.text = text\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run._element.clear()\n run._element.append(fldChar1)\n run._element.append(instrText)\n run._element.append(fldChar2)\n```\n\n### 创建文档主函数\n\n```python\ndef create_formatted_doc(title=\"\", logo_path=None, company_name=None, insert_vision=False):\n \"\"\"\n 🚀 一条命令创建符合公司规范的 Word 文档\n \n 参数:\n title: 文档标题（可选）\n logo_path: LOGO 图片路径（可选，默认自动获取）\n company_name: 公司名称（可选，默认自动获取）\n insert_vision: 是否在公司名称后插入愿景理念（可选，默认False）\n \n 返回:\n doc: python-docx Document 对象\n \n 使用示例:\n doc = create_formatted_doc(\"销售合同\")\n doc.add_paragraph(\"合同正文内容...\")\n doc.save(\"CONTRACT_客户_20250319.docx\")\n \"\"\"\n # 1. 创建文档\n doc = Document()\n \n # 2. 设置页面边距（GB/T 9704-2012）\n for section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n \n # 3. 添加页眉（LOGO + 公司名）\n add_header_with_logo(doc, logo_path, company_name)\n \n # 4. 添加页脚（页码）\n add_footer_with_page_numbers(doc)\n \n # 5. 设置默认字体\n style = doc.styles['Normal']\n style.font.name = '仿宋'\n style.font.size = Pt(12)\n style._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n \n # 6. 添加标题（如果提供）\n if title:\n p = doc.add_paragraph(title)\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in p.runs:\n set_chinese_font(run, '黑体', 22, True)\n \n return doc\n\ndef add_vision_paragraph(doc, company_info=None):\n \"\"\"\n 在文档末尾添加公司愿景理念段落（分两行，左对齐）\n 用于需要展示公司文化的正式文档\n \"\"\"\n if company_info is None:\n company_info = get_company_info_from_system()\n \n vision = company_info.get('vision', '')\n philosophy = company_info.get('philosophy', '')\n \n if not vision and not philosophy:\n return\n \n # 添加分隔线\n p = doc.add_paragraph()\n run = p.add_run('─' * 40)\n set_chinese_font(run, '仿宋', 10)\n \n # 愿景（左对齐）\n if vision:\n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.LEFT\n run = p.add_run(f'【愿景】{vision}')\n set_chinese_font(run, '楷体', 11)\n \n # 理念（左对齐）\n if philosophy:\n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.LEFT\n run = p.add_run(f'【理念】{philosophy}')\n set_chinese_font(run, '楷体', 11)\n```\n\n---\n\n## 📁 文档命名规则（必须遵循）\n\n### 命名格式\n\n```\n[文档类型]_[客户名称]_[项目名称]_[日期]_[版本].docx\n```\n\n### 命名元素说明\n\n| 元素 | 说明 | 示例 | 必填 |\n|------|------|------|------|\n| 文档类型 | 具体文档类型 | 合同、报价单、发货单、会议纪要、技术方案 | ✅ |\n| 客户名称 | 客户公司简称 | 阿里、腾讯、华为、海尔 | ✅ |\n| 项目名称 | 项目名称（可选） | ERP、MES、WMS、OA | ○ |\n| 日期 | 文档日期，格式 YYYYMMDD | 20250319 | ✅ |\n| 版本 | 版本号 v1.0（可选，默认 v1.0） | v1.0、v1.1、v2.0 | ○ |\n\n### 自动命名函数\n\n```python\nimport datetime\n\ndef generate_doc_name(doc_type, customer_name, project_name=\"\", version=\"v1.0\"):\n \"\"\"\n 生成符合规范的文档名称\n \n 参数:\n doc_type: 文档类型编码（如 CONTRACT, QUOTE）\n customer_name: 客户名称\n project_name: 项目名称（可选）\n version: 版本号（可选，默认 v1.0）\n \n 返回:\n 文档名称字符串，如 CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n \"\"\"\n date_str = datetime.datetime.now().strftime(\"%Y%m%d\")\n customer = customer_name.replace(\"有限公司\", \"\").replace(\"股份有限公司\", \"\").replace(\"集团\", \"\").strip()\n project = project_name.strip() if project_name else \"\"\n \n parts = [doc_type, customer]\n if project:\n parts.append(project)\n parts.append(date_str)\n \n if version and version != \"v1.0\":\n parts.append(version)\n \n return \"_\".join(parts) + \".docx\"\n```\n\n---\n\n## 公司信息\n\n- 公司名称：青岛火一五信息科技有限公司\n- 默认愿景：推动B端用户向全场景人工智能机器人转变\n- 默认理念：打破信息孤岛，用一套系统驱动企业增长\n- LOGO：从公司系统自动获取\n\n---\n\n## 文档结构\n\n1. 合同标题 - 居中，黑体二号加粗\n2. 合同编号 - 居中，仿宋三号\n3. 签订日期 - 居中，仿宋三号\n4. 一，二，三...章 - 楷体三号加粗\n5. 签署栏 - 盖章、法定代表人、日期\n\n---\n\n## 触发关键词\n\n**文档生成类（自动触发本技能）：**\n- 写word、写文档、写个文档\n- 生成word、生成文档、创建word、创建文档\n- 导出word、导出文档、下载word、下载文档\n- .docx、word文档、Word文档、Word生成、生成Word\n\n**具体文档类（自动触发本技能）：**\n- 写合同、写报价单、写说明书、写会议纪要\n- 合同模板、报价单模板、文档模板、公司文档\n\n**正式文档类（自动触发本技能）：**\n- 正式文档、公文、标书、方案文档\n- 年度报告、通知、请示、报告、函\n\nFile v1.3.3:_meta.json\n\n{\n \"ownerId\": \"kn7b0rmtgvbq55rc54rhp69r79822ym9\",\n \"slug\": \"huo15-doc-template\",\n \"version\": \"1.3.3\",\n \"publishedAt\": 1774927559912\n}\n\nArchive v1.3.2: 2 files, 6728 bytes\n\nFiles: _meta.json (137b), SKILL.md (19370b)\n\nFile v1.3.2:SKILL.md\n\n---\nname: huo15-doc-template / 火一五文档模板\ndescription: 【版权：青岛火一五信息科技有限公司 账号：huo15】**Word/文档生成首选技能**。所有 Word 文档、.docx 文件、公文、合同、报价单、说明书、会议纪要、发货单、PDA 单据等文档生成任务自动触发。\ntrigger:\n - type: fuzzy\n patterns:\n - \"写word\"\n - \"写文档\"\n - \"写个文档\"\n - \"重新写\"\n - \"重新生成\"\n - \"生成word\"\n - \"生成文档\"\n - \"创建word\"\n - \"创建文档\"\n - \"导出word\"\n - \"导出文档\"\n - \"下载word\"\n - \"下载文档\"\n - \"docx\"\n - \"word文档\"\n - \"Word文档\"\n - \"写合同\"\n - \"写报价单\"\n - \"写说明书\"\n - \"写会议纪要\"\n - \"合同模板\"\n - \"报价单模板\"\n - \"文档模板\"\n - \"公司文档\"\n - \"正式文档\"\n - \"公文\"\n - \"标书\"\n - \"方案文档\"\n - \"年度报告\"\n - \"通知\"\n - \"请示\"\n - \"报告\"\n - \"函\"\n\n## 重要：此为首选文档技能\n**所有 Word 文档生成任务都必须使用此技能**\n\n---\n\n## ⚠️ 强制检查清单（生成文档前必须完成）\n\n> **新用户必读！每次生成文档前对照检查，否则文档不合格！**\n\n- [ ] **LOGO 是否添加？** —— 页眉必须有 LOGO + 公司名称 + 底线\n- [ ] **页码是否添加？** —— 页脚必须有\"第 X 页 共 Y 页\"\n- [ ] **字体是否正确？** —— 正文仿宋，标题黑体/楷体\n- [ ] **页面边距是否正确？** —— 上下 3.7/3.5cm，左右 2.8/2.6cm\n- [ ] **命名是否规范？** —— 文档类型_客户名称_日期.docx\n\n**如果没有完成以上检查，文档不允许交付！**\n\n---\n\n## 🚀 快速开始\n\n> **重要**：代码模板直接写在 SKILL.md 中，复制使用即可！无需 pip install！\n\n```python\n# 一步创建符合公司规范的文档\ndoc = create_formatted_doc(\n title=\"销售合同\",\n company_name=\"青岛火一五信息科技有限公司\",\n insert_vision=True # 可选：插入公司愿景理念\n)\ndoc.add_paragraph(\"合同正文内容...\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n```\n\n> **LOGO/公司信息会自动从公司系统获取**，无需手动配置！\n\n---\n\n# 文档模板技能\n\n## 快速开始\n\n1. **字体设置**：默认使用仿宋，小四（12pt）\n2. **页面边距**：上下 3.7/3.5cm，左右 2.8/2.6cm\n3. **页眉**：LOGO + 公司名称 + 底线\n4. **页脚**：页码居中，格式\"第 X 页 共 Y 页\"，仿宋小四\n\n---\n\n## 配置规则\n\n### 字体规范\n- **默认正文**：仿宋，小四（12pt）\n- **一级标题**：黑体，小三（15pt），加粗\n- **二级标题**：楷体，小四（12pt），加粗\n- **三级标题**：仿宋，小四（12pt），加粗\n\n**WPS 字体兼容**：\n- 汉字字体：使用 `仿宋`\n- 每个 run 都要设置字体域 `w:eastAsia`\n\n---\n\n## ⚠️ 重要：Markdown 语法转换规则\n\n### 禁止直接在 Word 中使用 Markdown 语法\n\n**严禁将 Markdown 语法直接写入 Word 文档**，例如：\n- ❌ 错误：`**加粗文本**` → Word 中会显示星号\n- ❌ 错误：`| 列1 | 列2 |` → Word 中会显示管道符\n- ❌ 错误：`# 一级标题` → Word 中会显示井号\n\n### 正确转换方法\n\n#### 1. 加粗转换\n- Markdown：`**这是加粗**`\n- Word：设置 `run.bold = True`\n\n```python\n# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗\n```\n\n#### 2. 表格转换\n- Markdown：\n```\n| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |\n```\n- Word：使用 `doc.add_table()` 创建表格\n\n```python\n# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)\n```\n\n#### 3. 标题转换\n- Markdown：`# 一级标题`\n- Word：添加段落并设置样式\n\n```python\n# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)\n```\n\n### 自检清单（生成文档前必查）\n\n生成文档后，检查以下内容：\n- [ ] 文档中是否有 `**`、`__`、`#` 等 Markdown 符号？\n- [ ] 表格是否使用了 `|` 管道符？\n- [ ] 链接是否显示了 `[文字](URL)` 格式？\n- [ ] 列表是否显示了 `-` 或 `*` 前缀？\n\n**如果有任何一项为\"是\"，则文档不合格，需要重新生成**\n\n---\n\n## 🚀 核心函数（必须使用）\n\n### 公司信息获取函数\n\n```python\nimport ssl\nimport json\nimport os\nimport urllib.request\nimport xmlrpc.client\n\n# ============== 公司信息配置 ==============\nUSER_HOME = os.path.expanduser(\"~\")\nLOGO_DIR = os.path.join(USER_HOME, \".huo15\", \"assets\")\nDEFAULT_LOGO_PATH = os.path.join(LOGO_DIR, \"logo.png\")\n\n# 备用 LOGO URL\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_LOGO_URL = 'https://huihuoyun.huo15.com/web/image/website/1/logo'\n\ndef get_company_info_from_system():\n \"\"\"\n 从公司系统(Odoo)获取公司信息\n 返回: dict {\n 'company_name': str,\n 'logo_path': str,\n 'vision': str, # 公司愿景\n 'philosophy': str, # 公司理念\n 'slogan': str # slogan\n }\n \"\"\"\n company_info = {\n 'company_name': '青岛火一五信息科技有限公司',\n 'vision': '推动B端用户向全场景人工智能机器人转变',\n 'philosophy': '打破信息孤岛，用一套系统驱动企业增长',\n 'slogan': '',\n 'logo_path': None\n }\n \n # 1. 尝试从公司系统获取\n try:\n # 读取 Odoo 配置\n agent_id = os.environ.get('OC_AGENT_ID', 'main')\n agents_dir = os.path.expanduser('~/.openclaw/agents')\n creds_file = os.path.join(agents_dir, agent_id, 'odoo_creds.json')\n \n if os.path.exists(creds_file):\n with open(creds_file, 'r') as f:\n creds = json.load(f)\n \n # 获取全局配置\n openclaw_cfg_file = os.path.expanduser('~/.openclaw/openclaw.json')\n if os.path.exists(openclaw_cfg_file):\n with open(openclaw_cfg_file, 'r') as f:\n cfg = json.load(f)\n odoo_env = cfg.get('skills', {}).get('entries', {}).get('huo15-odoo', {}).get('env', {})\n url = odoo_env.get('ODOO_URL', 'https://huihuoyun.huo15.com')\n db = odoo_env.get('ODOO_DB', 'huo15_prod')\n user = creds.get('user', '')\n password = creds.get('password', '')\n \n if user and password:\n # 连接 Odoo\n ctx = ssl.create_default_context()\n ctx.check_hostname = False\n ctx.verify_mode = ssl.CERT_NONE\n \n common = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/common', context=ctx)\n uid = common.authenticate(db, user, password, {})\n \n if uid:\n models = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/object', context=ctx)\n \n # 获取公司配置 (res.company)\n company_data = models.execute_kw(db, uid, password, 'res.company', 'search_read',\n [[('id', '=', 1)]], {'fields': ['name', 'logo'], 'limit': 1})\n \n if company_data:\n company_info['company_name'] = company_data[0].get('name', company_info['company_name'])\n logo_id = company_data[0].get('logo')\n if logo_id:\n # 下载 LOGO\n logo_url = f'{url}/web/image/res.company/{logo_id}/logo'\n ensure_logo_downloaded(logo_url, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 获取系统参数 (ir.config_parameter) - 愿景/理念\n vision_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.vision')]], {'fields': ['value'], 'limit': 1})\n if vision_config and vision_config[0].get('value'):\n company_info['vision'] = vision_config[0]['value']\n \n philosophy_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.philosophy')]], {'fields': ['value'], 'limit': 1})\n if philosophy_config and philosophy_config[0].get('value'):\n company_info['philosophy'] = philosophy_config[0]['value']\n \n slogan_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.slogan')]], {'fields': ['value'], 'limit': 1})\n if slogan_config and slogan_config[0].get('value'):\n company_info['slogan'] = slogan_config[0]['value']\n else:\n # 无凭证，使用备用 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n except Exception as e:\n print(f\"获取公司信息失败，使用默认信息: {e}\")\n # 备用：下载默认 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 确保 LOGO 存在\n if not company_info['logo_path'] or not os.path.exists(company_info['logo_path']):\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n return company_info\n\ndef ensure_logo_downloaded(url, dest_path):\n \"\"\"确保 LOGO 已下载\"\"\"\n if os.path.exists(dest_path) and os.path.getsize(dest_path) > 1000:\n return dest_path\n \n os.makedirs(os.path.dirname(dest_path), exist_ok=True)\n try:\n urllib.request.urlretrieve(url, dest_path)\n print(f\"✓ LOGO 已下载: {dest_path}\")\n except Exception as e:\n print(f\"⚠ LOGO 下载失败: {e}\")\n # 尝试备用 URL\n try:\n urllib.request.urlretrieve(FALLBACK_LOGO_URL, dest_path)\n print(f\"✓ 备用 LOGO 已下载: {dest_path}\")\n except:\n pass\n return dest_path\n```\n\n### 字体设置函数\n\n```python\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n```\n\n### 页眉函数（含 LOGO + 公司名称 + 底线）\n\n```python\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉：LOGO + 公司名称 + 底线\"\"\"\n if logo_path is None or company_name is None:\n info = get_company_info_from_system()\n logo_path = logo_path or info.get('logo_path') or DEFAULT_LOGO_PATH\n company_name = company_name or info.get('company_name', '青岛火一五信息科技有限公司')\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n section.header_distance = Cm(1.5)\n \n # 添加 LOGO + 公司名称\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n # 添加 LOGO\n if os.path.exists(logo_path):\n try:\n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n except:\n pass\n \n # 添加公司名称\n run = paragraph.add_run(f' {company_name}')\n set_chinese_font(run, '黑体', 10)\n \n # 添加底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n \n return header\n```\n\n### 页脚函数（页码）\n\n```python\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚：第 X 页 共 Y 页\"\"\"\n section = doc.sections[0]\n section.footer_distance = Cm(1.5)\n footer = section.footer\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n for text, is_field in [(\"第\", False), (\"PAGE\", True), (\"页 共\", False), (\"NUMPAGES\", True), (\"页\", False)]:\n run = paragraph.add_run(text)\n set_chinese_font(run, '仿宋', 12)\n if is_field:\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText = OxmlElement('w:instrText')\n instrText.text = text\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run._element.clear()\n run._element.append(fldChar1)\n run._element.append(instrText)\n run._element.append(fldChar2)\n```\n\n### 创建文档主函数\n\n```python\ndef create_formatted_doc(title=\"\", logo_path=None, company_name=None, insert_vision=False):\n \"\"\"\n 🚀 一条命令创建符合公司规范的 Word 文档\n \n 参数:\n title: 文档标题（可选）\n logo_path: LOGO 图片路径（可选，默认自动获取）\n company_name: 公司名称（可选，默认自动获取）\n insert_vision: 是否在公司名称后插入愿景理念（可选，默认False）\n \n 返回:\n doc: python-docx Document 对象\n \n 使用示例:\n doc = create_formatted_doc(\"销售合同\")\n doc.add_paragraph(\"合同正文内容...\")\n doc.save(\"CONTRACT_客户_20250319.docx\")\n \"\"\"\n # 1. 创建文档\n doc = Document()\n \n # 2. 设置页面边距（GB/T 9704-2012）\n for section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n \n # 3. 添加页眉（LOGO + 公司名）\n add_header_with_logo(doc, logo_path, company_name)\n \n # 4. 添加页脚（页码）\n add_footer_with_page_numbers(doc)\n \n # 5. 设置默认字体\n style = doc.styles['Normal']\n style.font.name = '仿宋'\n style.font.size = Pt(12)\n style._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n \n # 6. 添加标题（如果提供）\n if title:\n p = doc.add_paragraph(title)\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in p.runs:\n set_chinese_font(run, '黑体', 22, True)\n \n return doc\n\ndef add_vision_paragraph(doc, company_info=None):\n \"\"\"\n 在文档开头添加公司愿景理念段落\n 用于需要展示公司文化的正式文档\n \"\"\"\n if company_info is None:\n company_info = get_company_info_from_system()\n \n vision = company_info.get('vision', '')\n philosophy = company_info.get('philosophy', '')\n \n if not vision and not philosophy:\n return\n \n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n if vision:\n run = p.add_run(f'【愿景】{vision}')\n set_chinese_font(run, '楷体', 11)\n \n if vision and philosophy:\n run = p.add_run(' | ')\n set_chinese_font(run, '楷体', 11)\n \n if philosophy:\n run = p.add_run(f'【理念】{philosophy}')\n set_chinese_font(run, '楷体', 11)\n \n # 添加分隔线\n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n run = p.add_run('─' * 30)\n set_chinese_font(run, '仿宋', 10)\n```\n\n---\n\n## 📁 文档命名规则（必须遵循）\n\n### 命名格式\n\n```\n[文档类型]_[客户名称]_[项目名称]_[日期]_[版本].docx\n```\n\n### 命名元素说明\n\n| 元素 | 说明 | 示例 | 必填 |\n|------|------|------|------|\n| 文档类型 | 具体文档类型 | 合同、报价单、发货单、会议纪要、技术方案 | ✅ |\n| 客户名称 | 客户公司简称 | 阿里、腾讯、华为、海尔 | ✅ |\n| 项目名称 | 项目名称（可选） | ERP、MES、WMS、OA | ○ |\n| 日期 | 文档日期，格式 YYYYMMDD | 20250319 | ✅ |\n| 版本 | 版本号 v1.0（可选，默认 v1.0） | v1.0、v1.1、v2.0 | ○ |\n\n### 自动命名函数\n\n```python\nimport datetime\n\ndef generate_doc_name(doc_type, customer_name, project_name=\"\", version=\"v1.0\"):\n \"\"\"\n 生成符合规范的文档名称\n \n 参数:\n doc_type: 文档类型编码（如 CONTRACT, QUOTE）\n customer_name: 客户名称\n project_name: 项目名称（可选）\n version: 版本号（可选，默认 v1.0）\n \n 返回:\n 文档名称字符串，如 CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n \"\"\"\n date_str = datetime.datetime.now().strftime(\"%Y%m%d\")\n customer = customer_name.replace(\"有限公司\", \"\").replace(\"股份有限公司\", \"\").replace(\"集团\", \"\").strip()\n project = project_name.strip() if project_name else \"\"\n \n parts = [doc_type, customer]\n if project:\n parts.append(project)\n parts.append(date_str)\n \n if version and version != \"v1.0\":\n parts.append(version)\n \n return \"_\".join(parts) + \".docx\"\n```\n\n---\n\n## 公司信息\n\n- 公司名称：青岛火一五信息科技有限公司\n- 默认愿景：推动B端用户向全场景人工智能机器人转变\n- 默认理念：打破信息孤岛，用一套系统驱动企业增长\n- LOGO：从公司系统自动获取\n\n---\n\n## 文档结构\n\n1. 合同标题 - 居中，黑体二号加粗\n2. 合同编号 - 居中，仿宋三号\n3. 签订日期 - 居中，仿宋三号\n4. 一，二，三...章 - 楷体三号加粗\n5. 签署栏 - 盖章、法定代表人、日期\n\n---\n\n## 触发关键词\n\n**文档生成类（自动触发本技能）：**\n- 写word、写文档、写个文档\n- 生成word、生成文档、创建word、创建文档\n- 导出word、导出文档、下载word、下载文档\n- .docx、word文档、Word文档、Word生成、生成Word\n\n**具体文档类（自动触发本技能）：**\n- 写合同、写报价单、写说明书、写会议纪要\n- 合同模板、报价单模板、文档模板、公司文档\n\n**正式文档类（自动触发本技能）：**\n- 正式文档、公文、标书、方案文档\n- 年度报告、通知、请示、报告、函\n\nFile v1.3.2:_meta.json\n\n{\n \"ownerId\": \"kn7b0rmtgvbq55rc54rhp69r79822ym9\",\n \"slug\": \"huo15-doc-template\",\n \"version\": \"1.3.2\",\n \"publishedAt\": 1774927428349\n}\n\nArchive v1.3.1: 2 files, 6595 bytes\n\nFiles: _meta.json (137b), SKILL.md (19112b)\n\nFile v1.3.1:SKILL.md\n\n---\nname: huo15-doc-template / 火一五文档模板\ndescription: 【版权：青岛火一五信息科技有限公司 账号：huo15】**Word/文档生成首选技能**。所有 Word 文档、.docx 文件、公文、合同、报价单、说明书、会议纪要、发货单、PDA 单据等文档生成任务自动触发。触发关键词：写word、写文档、写个文档、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、Word生成、生成Word、写合同、写报价单、写说明书、写会议纪要、合同模板、报价单模板、文档模板、公司文档、正式文档、公文、标书、方案文档、年度报告、通知、请示、报告、函等任何文档生成请求。\n\n## 重要：此为首选文档技能\n**所有 Word 文档生成任务都必须使用此技能**\n\n---\n\n## ⚠️ 强制检查清单（生成文档前必须完成）\n\n> **新用户必读！每次生成文档前对照检查，否则文档不合格！**\n\n- [ ] **LOGO 是否添加？** —— 页眉必须有 LOGO + 公司名称 + 底线\n- [ ] **页码是否添加？** —— 页脚必须有\"第 X 页 共 Y 页\"\n- [ ] **字体是否正确？** —— 正文仿宋，标题黑体/楷体\n- [ ] **页面边距是否正确？** —— 上下 3.7/3.5cm，左右 2.8/2.6cm\n- [ ] **命名是否规范？** —— 文档类型_客户名称_日期.docx\n\n**如果没有完成以上检查，文档不允许交付！**\n\n---\n\n## 🚀 快速开始\n\n> **重要**：代码模板直接写在 SKILL.md 中，复制使用即可！无需 pip install！\n\n```python\n# 一步创建符合公司规范的文档\ndoc = create_formatted_doc(\n title=\"销售合同\",\n company_name=\"青岛火一五信息科技有限公司\",\n insert_vision=True # 可选：插入公司愿景理念\n)\ndoc.add_paragraph(\"合同正文内容...\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n```\n\n> **LOGO/公司信息会自动从公司系统获取**，无需手动配置！\n\n---\n\n# 文档模板技能\n\n## 快速开始\n\n1. **字体设置**：默认使用仿宋，小四（12pt）\n2. **页面边距**：上下 3.7/3.5cm，左右 2.8/2.6cm\n3. **页眉**：LOGO + 公司名称 + 底线\n4. **页脚**：页码居中，格式\"第 X 页 共 Y 页\"，仿宋小四\n\n---\n\n## 配置规则\n\n### 字体规范\n- **默认正文**：仿宋，小四（12pt）\n- **一级标题**：黑体，小三（15pt），加粗\n- **二级标题**：楷体，小四（12pt），加粗\n- **三级标题**：仿宋，小四（12pt），加粗\n\n**WPS 字体兼容**：\n- 汉字字体：使用 `仿宋`\n- 每个 run 都要设置字体域 `w:eastAsia`\n\n---\n\n## ⚠️ 重要：Markdown 语法转换规则\n\n### 禁止直接在 Word 中使用 Markdown 语法\n\n**严禁将 Markdown 语法直接写入 Word 文档**，例如：\n- ❌ 错误：`**加粗文本**` → Word 中会显示星号\n- ❌ 错误：`| 列1 | 列2 |` → Word 中会显示管道符\n- ❌ 错误：`# 一级标题` → Word 中会显示井号\n\n### 正确转换方法\n\n#### 1. 加粗转换\n- Markdown：`**这是加粗**`\n- Word：设置 `run.bold = True`\n\n```python\n# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗\n```\n\n#### 2. 表格转换\n- Markdown：\n```\n| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |\n```\n- Word：使用 `doc.add_table()` 创建表格\n\n```python\n# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)\n```\n\n#### 3. 标题转换\n- Markdown：`# 一级标题`\n- Word：添加段落并设置样式\n\n```python\n# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)\n```\n\n### 自检清单（生成文档前必查）\n\n生成文档后，检查以下内容：\n- [ ] 文档中是否有 `**`、`__`、`#` 等 Markdown 符号？\n- [ ] 表格是否使用了 `|` 管道符？\n- [ ] 链接是否显示了 `[文字](URL)` 格式？\n- [ ] 列表是否显示了 `-` 或 `*` 前缀？\n\n**如果有任何一项为\"是\"，则文档不合格，需要重新生成**\n\n---\n\n## 🚀 核心函数（必须使用）\n\n### 公司信息获取函数\n\n```python\nimport ssl\nimport json\nimport os\nimport urllib.request\nimport xmlrpc.client\n\n# ============== 公司信息配置 ==============\nUSER_HOME = os.path.expanduser(\"~\")\nLOGO_DIR = os.path.join(USER_HOME, \".huo15\", \"assets\")\nDEFAULT_LOGO_PATH = os.path.join(LOGO_DIR, \"logo.png\")\n\n# 备用 LOGO URL\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_LOGO_URL = 'https://huihuoyun.huo15.com/web/image/website/1/logo'\n\ndef get_company_info_from_system():\n \"\"\"\n 从公司系统(Odoo)获取公司信息\n 返回: dict {\n 'company_name': str,\n 'logo_path': str,\n 'vision': str, # 公司愿景\n 'philosophy': str, # 公司理念\n 'slogan': str # slogan\n }\n \"\"\"\n company_info = {\n 'company_name': '青岛火一五信息科技有限公司',\n 'vision': '推动B端用户向全场景人工智能机器人转变',\n 'philosophy': '打破信息孤岛，用一套系统驱动企业增长',\n 'slogan': '',\n 'logo_path': None\n }\n \n # 1. 尝试从公司系统获取\n try:\n # 读取 Odoo 配置\n agent_id = os.environ.get('OC_AGENT_ID', 'main')\n agents_dir = os.path.expanduser('~/.openclaw/agents')\n creds_file = os.path.join(agents_dir, agent_id, 'odoo_creds.json')\n \n if os.path.exists(creds_file):\n with open(creds_file, 'r') as f:\n creds = json.load(f)\n \n # 获取全局配置\n openclaw_cfg_file = os.path.expanduser('~/.openclaw/openclaw.json')\n if os.path.exists(openclaw_cfg_file):\n with open(openclaw_cfg_file, 'r') as f:\n cfg = json.load(f)\n odoo_env = cfg.get('skills', {}).get('entries', {}).get('huo15-odoo', {}).get('env', {})\n url = odoo_env.get('ODOO_URL', 'https://huihuoyun.huo15.com')\n db = odoo_env.get('ODOO_DB', 'huo15_prod')\n user = creds.get('user', '')\n password = creds.get('password', '')\n \n if user and password:\n # 连接 Odoo\n ctx = ssl.create_default_context()\n ctx.check_hostname = False\n ctx.verify_mode = ssl.CERT_NONE\n \n common = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/common', context=ctx)\n uid = common.authenticate(db, user, password, {})\n \n if uid:\n models = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/object', context=ctx)\n \n # 获取公司配置 (res.company)\n company_data = models.execute_kw(db, uid, password, 'res.company', 'search_read',\n [[('id', '=', 1)]], {'fields': ['name', 'logo'], 'limit': 1})\n \n if company_data:\n company_info['company_name'] = company_data[0].get('name', company_info['company_name'])\n logo_id = company_data[0].get('logo')\n if logo_id:\n # 下载 LOGO\n logo_url = f'{url}/web/image/res.company/{logo_id}/logo'\n ensure_logo_downloaded(logo_url, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 获取系统参数 (ir.config_parameter) - 愿景/理念\n vision_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.vision')]], {'fields': ['value'], 'limit': 1})\n if vision_config and vision_config[0].get('value'):\n company_info['vision'] = vision_config[0]['value']\n \n philosophy_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.philosophy')]], {'fields': ['value'], 'limit': 1})\n if philosophy_config and philosophy_config[0].get('value'):\n company_info['philosophy'] = philosophy_config[0]['value']\n \n slogan_config = models.execute_kw(db, uid, password, 'ir.config_parameter', 'search_read',\n [[('key', '=', 'huo15.company.slogan')]], {'fields': ['value'], 'limit': 1})\n if slogan_config and slogan_config[0].get('value'):\n company_info['slogan'] = slogan_config[0]['value']\n else:\n # 无凭证，使用备用 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n except Exception as e:\n print(f\"获取公司信息失败，使用默认信息: {e}\")\n # 备用：下载默认 LOGO\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n # 确保 LOGO 存在\n if not company_info['logo_path'] or not os.path.exists(company_info['logo_path']):\n ensure_logo_downloaded(FALLBACK_LOGO_URL, DEFAULT_LOGO_PATH)\n company_info['logo_path'] = DEFAULT_LOGO_PATH\n \n return company_info\n\ndef ensure_logo_downloaded(url, dest_path):\n \"\"\"确保 LOGO 已下载\"\"\"\n if os.path.exists(dest_path) and os.path.getsize(dest_path) > 1000:\n return dest_path\n \n os.makedirs(os.path.dirname(dest_path), exist_ok=True)\n try:\n urllib.request.urlretrieve(url, dest_path)\n print(f\"✓ LOGO 已下载: {dest_path}\")\n except Exception as e:\n print(f\"⚠ LOGO 下载失败: {e}\")\n # 尝试备用 URL\n try:\n urllib.request.urlretrieve(FALLBACK_LOGO_URL, dest_path)\n print(f\"✓ 备用 LOGO 已下载: {dest_path}\")\n except:\n pass\n return dest_path\n```\n\n### 字体设置函数\n\n```python\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n```\n\n### 页眉函数（含 LOGO + 公司名称 + 底线）\n\n```python\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉：LOGO + 公司名称 + 底线\"\"\"\n if logo_path is None or company_name is None:\n info = get_company_info_from_system()\n logo_path = logo_path or info.get('logo_path') or DEFAULT_LOGO_PATH\n company_name = company_name or info.get('company_name', '青岛火一五信息科技有限公司')\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n section.header_distance = Cm(1.5)\n \n # 添加 LOGO + 公司名称\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n # 添加 LOGO\n if os.path.exists(logo_path):\n try:\n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n except:\n pass\n \n # 添加公司名称\n run = paragraph.add_run(f' {company_name}')\n set_chinese_font(run, '黑体', 10)\n \n # 添加底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n \n return header\n```\n\n### 页脚函数（页码）\n\n```python\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚：第 X 页 共 Y 页\"\"\"\n section = doc.sections[0]\n section.footer_distance = Cm(1.5)\n footer = section.footer\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n for text, is_field in [(\"第\", False), (\"PAGE\", True), (\"页 共\", False), (\"NUMPAGES\", True), (\"页\", False)]:\n run = paragraph.add_run(text)\n set_chinese_font(run, '仿宋', 12)\n if is_field:\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText = OxmlElement('w:instrText')\n instrText.text = text\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run._element.clear()\n run._element.append(fldChar1)\n run._element.append(instrText)\n run._element.append(fldChar2)\n```\n\n### 创建文档主函数\n\n```python\ndef create_formatted_doc(title=\"\", logo_path=None, company_name=None, insert_vision=False):\n \"\"\"\n 🚀 一条命令创建符合公司规范的 Word 文档\n \n 参数:\n title: 文档标题（可选）\n logo_path: LOGO 图片路径（可选，默认自动获取）\n company_name: 公司名称（可选，默认自动获取）\n insert_vision: 是否在公司名称后插入愿景理念（可选，默认False）\n \n 返回:\n doc: python-docx Document 对象\n \n 使用示例:\n doc = create_formatted_doc(\"销售合同\")\n doc.add_paragraph(\"合同正文内容...\")\n doc.save(\"CONTRACT_客户_20250319.docx\")\n \"\"\"\n # 1. 创建文档\n doc = Document()\n \n # 2. 设置页面边距（GB/T 9704-2012）\n for section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n \n # 3. 添加页眉（LOGO + 公司名）\n add_header_with_logo(doc, logo_path, company_name)\n \n # 4. 添加页脚（页码）\n add_footer_with_page_numbers(doc)\n \n # 5. 设置默认字体\n style = doc.styles['Normal']\n style.font.name = '仿宋'\n style.font.size = Pt(12)\n style._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n \n # 6. 添加标题（如果提供）\n if title:\n p = doc.add_paragraph(title)\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in p.runs:\n set_chinese_font(run, '黑体', 22, True)\n \n return doc\n\ndef add_vision_paragraph(doc, company_info=None):\n \"\"\"\n 在文档开头添加公司愿景理念段落\n 用于需要展示公司文化的正式文档\n \"\"\"\n if company_info is None:\n company_info = get_company_info_from_system()\n \n vision = company_info.get('vision', '')\n philosophy = company_info.get('philosophy', '')\n \n if not vision and not philosophy:\n return\n \n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n if vision:\n run = p.add_run(f'【愿景】{vision}')\n set_chinese_font(run, '楷体', 11)\n \n if vision and philosophy:\n run = p.add_run(' | ')\n set_chinese_font(run, '楷体', 11)\n \n if philosophy:\n run = p.add_run(f'【理念】{philosophy}')\n set_chinese_font(run, '楷体', 11)\n \n # 添加分隔线\n p = doc.add_paragraph()\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n run = p.add_run('─' * 30)\n set_chinese_font(run, '仿宋', 10)\n```\n\n---\n\n## 📁 文档命名规则（必须遵循）\n\n### 命名格式\n\n```\n[文档类型]_[客户名称]_[项目名称]_[日期]_[版本].docx\n```\n\n### 命名元素说明\n\n| 元素 | 说明 | 示例 | 必填 |\n|------|------|------|------|\n| 文档类型 | 具体文档类型 | 合同、报价单、发货单、会议纪要、技术方案 | ✅ |\n| 客户名称 | 客户公司简称 | 阿里、腾讯、华为、海尔 | ✅ |\n| 项目名称 | 项目名称（可选） | ERP、MES、WMS、OA | ○ |\n| 日期 | 文档日期，格式 YYYYMMDD | 20250319 | ✅ |\n| 版本 | 版本号 v1.0（可选，默认 v1.0） | v1.0、v1.1、v2.0 | ○ |\n\n### 自动命名函数\n\n```python\nimport datetime\n\ndef generate_doc_name(doc_type, customer_name, project_name=\"\", version=\"v1.0\"):\n \"\"\"\n 生成符合规范的文档名称\n \n 参数:\n doc_type: 文档类型编码（如 CONTRACT, QUOTE）\n customer_name: 客户名称\n project_name: 项目名称（可选）\n version: 版本号（可选，默认 v1.0）\n \n 返回:\n 文档名称字符串，如 CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n \"\"\"\n date_str = datetime.datetime.now().strftime(\"%Y%m%d\")\n customer = customer_name.replace(\"有限公司\", \"\").replace(\"股份有限公司\", \"\").replace(\"集团\", \"\").strip()\n project = project_name.strip() if project_name else \"\"\n \n parts = [doc_type, customer]\n if project:\n parts.append(project)\n parts.append(date_str)\n \n if version and version != \"v1.0\":\n parts.append(version)\n \n return \"_\".join(parts) + \".docx\"\n```\n\n---\n\n## 公司信息\n\n- 公司名称：青岛火一五信息科技有限公司\n- 默认愿景：推动B端用户向全场景人工智能机器人转变\n- 默认理念：打破信息孤岛，用一套系统驱动企业增长\n- LOGO：从公司系统自动获取\n\n---\n\n## 文档结构\n\n1. 合同标题 - 居中，黑体二号加粗\n2. 合同编号 - 居中，仿宋三号\n3. 签订日期 - 居中，仿宋三号\n4. 一，二，三...章 - 楷体三号加粗\n5. 签署栏 - 盖章、法定代表人、日期\n\n---\n\n## 触发关键词\n\n**文档生成类（自动触发本技能）：**\n- 写word、写文档、写个文档\n- 生成word、生成文档、创建word、创建文档\n- 导出word、导出文档、下载word、下载文档\n- .docx、word文档、Word文档、Word生成、生成Word\n\n**具体文档类（自动触发本技能）：**\n- 写合同、写报价单、写说明书、写会议纪要\n- 合同模板、报价单模板、文档模板、公司文档\n\n**正式文档类（自动触发本技能）：**\n- 正式文档、公文、标书、方案文档\n- 年度报告、通知、请示、报告、函\n\nFile v1.3.1:_meta.json\n\n{\n \"ownerId\": \"kn7b0rmtgvbq55rc54rhp69r79822ym9\",\n \"slug\": \"huo15-doc-template\",\n \"version\": \"1.3.1\",\n \"publishedAt\": 1774926987266\n}\n\nArchive v1.3.0: 2 files, 9709 bytes\n\nFiles: _meta.json (137b), SKILL.md (30050b)\n\nFile v1.3.0:SKILL.md\n\n---\nname: huo15-doc-template / 火一五文档模板\ndescription: 【版权：青岛火一五信息科技有限公司 账号：huo15】**Word/文档生成首选技能**。所有 Word 文档、.docx 文件、公文、合同、报价单、说明书、会议纪要、发货单、PDA 单据等文档生成任务自动触发。触发关键词：写word、写文档、写个文档、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、Word生成、生成Word、写合同、写报价单、写说明书、写会议纪要、合同模板、报价单模板、文档模板、公司文档、正式文档、公文、标书、方案文档、年度报告、通知、请示、报告、函等任何文档生成请求。\n\n## 重要：此为首选文档技能\n**所有 Word 文档生成任务都必须使用此技能**\n\n---\n\n## ⚠️ 强制检查清单（生成文档前必须完成）\n\n> **新用户必读！每次生成文档前对照检查，否则文档不合格！**\n\n- [ ] **LOGO 是否添加？** —— 页眉必须有 LOGO + 公司名称 + 底线\n- [ ] **页码是否添加？** —— 页脚必须有\"第 X 页 共 Y 页\"\n- [ ] **字体是否正确？** —— 正文仿宋，标题黑体/楷体\n- [ ] **页面边距是否正确？** —— 上下 3.7/3.5cm，左右 2.8/2.6cm\n- [ ] **命名是否规范？** —— 文档类型_客户名称_日期.docx\n\n**如果没有完成以上检查，文档不允许交付！**\n\n---\n\n## 🚀 简化版：一条命令完成所有格式\n\n> **重要**：不需要 pip install huo15_doc！代码模板直接写在 SKILL.md 中，复制使用即可！\n\n```python\n# 直接从 SKILL.md 中复制以下代码到你的Python脚本：\n# （函数定义参考 SKILL.md 中的 \"简化函数\" 部分）\n\n# LOGO 会自动从公司系统下载，无需手动配置！\ndoc = create_formatted_doc(\n title=\"合同标题\",\n company_name=\"青岛火一五信息科技有限公司\"\n)\n\n# 然后直接添加内容...\ndoc.add_paragraph(\"合同正文内容\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n```\n\n> **强烈建议**：使用简化函数，告别手动配置！\n> **重要**：LOGO 会自动从公司系统下载，无需手动配置！\n\n---\n\n## 技能分工规则（格式引用 vs 文档操作）\n\n### 格式引用 → huo15-doc-template\n- 字体规范（仿宋、黑体、楷体字号）\n- 页面边距（GB/T 9704-2012 公文格式）\n- 页眉页脚（LOGO、公司名称、页码）\n- 公文格式排版\n\n### 文档操作 → office-document-specialist-suite\n- 创建/编辑 Word 文档\n- 内容填充、排版调整\n- 表格操作、段落设置\n\n### 组合使用流程\n1. 用 `office-document-specialist-suite` 处理文档内容\n2. 用 `huo15-doc-template` 处理格式规范\n3. 最终生成符合公司规范的正式文档\n\n---\n\n# 文档模板技能\n\n## 快速开始\n\n1. **字体设置**：默认使用仿宋，小四（12pt）\n2. **页面边距**：上下 3.7/3.5cm，左右 2.8/2.6cm\n3. **页眉**：LOGO + 公司名称 + 底线\n4. **页脚**：页码居中，格式\"第 X 页 共 Y 页\"，仿宋小四\n\n---\n\n## 配置规则\n\n### 字体规范\n- **默认正文**：仿宋，小四（12pt）\n- **一级标题**：黑体，小三（15pt），加粗\n- **二级标题**：楷体，小四（12pt），加粗\n- **三级标题**：仿宋，小四（12pt），加粗\n\n**WPS 字体兼容**：\n- 汉字字体：使用 `仿宋`\n- 每个 run 都要设置字体域 `w:eastAsia`\n\n---\n\n## ⚠️ 重要：Markdown 语法转换规则\n\n### 禁止直接在 Word 中使用 Markdown 语法\n\n**严禁将 Markdown 语法直接写入 Word 文档**，例如：\n- ❌ 错误：`**加粗文本**` → Word 中会显示星号\n- ❌ 错误：`| 列1 | 列2 |` → Word 中会显示管道符\n- ❌ 错误：`# 一级标题` → Word 中会显示井号\n\n### 正确转换方法\n\n#### 1. 加粗转换\n- Markdown：`**这是加粗**`\n- Word：设置 `run.bold = True`\n\n```python\n# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗\n```\n\n#### 2. 表格转换\n- Markdown：\n```\n| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |\n```\n- Word：使用 `doc.add_table()` 创建表格\n\n```python\n# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)\n```\n\n#### 3. 标题转换\n- Markdown：`# 一级标题`\n- Word：添加段落并设置样式\n\n```python\n# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)\n```\n\n### 自检清单（生成文档前必查）\n\n生成文档后，检查以下内容：\n- [ ] 文档中是否有 `**`、`__`、`#` 等 Markdown 符号？\n- [ ] 表格是否使用了 `|` 管道符？\n- [ ] 链接是否显示了 `[文字](URL)` 格式？\n- [ ] 列表是否显示了 `-` 或 `*` 前缀？\n\n**如果有任何一项为\"是\"，则文档不合格，需要重新生成**\n\n### ⚠️ 字体问题根本原因\n\n**问题**：WPS 和 Word 对字体的渲染方式不同，WPS 需要显式设置字体域才能正确识别中文字体。\n\n**解决方案**：每个 run 都必须设置以下三个属性：\n1. `run.font.name = font_name` - 设置字体名称\n2. `run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)` - 设置字体域（WPS兼容）\n3. `run.font.size = Pt(font_size)` - 设置字号\n\n### 字体设置正确示范\n\n```python\nfrom docx.oxml.ns import qn\n\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n # 1. 设置西文字体名称\n run.font.name = font_name\n # 2. 设置字体域（WPS兼容关键）\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n # 3. 设置字号\n run.font.size = Pt(font_size)\n # 4. 设置加粗\n run.bold = bold\n return run\n```\n\n### ❌ 常见错误\n\n| 错误做法 | 后果 |\n|---------|------|\n| 只设置 `run.font.name` | Word显示正确，WPS显示为宋体 |\n| 不设置 `w:eastAsia` 字体域 | WPS无法识别中文字体 |\n| 只在第一个run设置字体 | 后续文字字体丢失 |\n| 使用 `set_font()` 但没有设置字体域 | WPS显示不正确 |\n\n### ✅ 正确做法\n\n```python\n# 正确：每个run都设置字体\np = doc.add_paragraph()\nrun = p.add_run('这是正文')\nset_chinese_font(run, '仿宋', 12) # ✅ 每个run都调用\n\n# 错误：只设置一次\np = doc.add_paragraph()\nrun = p.add_run('这是正文')\nrun.font.name = '仿宋' # ❌ 缺少字体域\n```\n\n---\n\n### 完整函数模板（必须复制使用）\n\n```python\nfrom docx import Document\nfrom docx.shared import Pt, Cm\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nimport os\n\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n```\n\n### 页面设置（GB/T 9704-2012 公文格式）\n- 上边距：3.7cm\n- 下边距：3.5cm\n- 左边距：2.8cm\n- 右边距：2.6cm\n- 纸张：A4\n\n### 页眉（必须包含 LOGO）\n- LOGO 路径：`/Users/jobzhao/.openclaw/workspace/assets/logo.png`\n- 内容：LOGO 图片 + 公司名称（紧挨着）\n- 字体：仿宋，小四（12pt）\n- **必须添加页眉底线**（细线）\n\n### ⚠️ 公司信息获取规则（重要）\n\n**获取顺序**：\n1. 首先从**辉火云企业套件系统**获取公司名称和 LOGO\n2. 如果获取失败，使用**本地配置文件**中的备选信息\n3. 如果配置文件也没有，使用**默认信息**\n\n**默认公司信息**：\n- 公司名称：**青岛火一五信息科技有限公司**\n- 默认 LOGO：`/Users/jobzhao/.openclaw/workspace/assets/logo.png`（从 https://tools.huo15.com/uploads/images/system/logo-colours.png 下载）\n\n**公司信息配置位置**：`/Users/jobzhao/.openclaw/workspace/config/company_info.json`\n\n```json\n{\n \"company_name\": \"青岛火一五信息科技有限公司\",\n \"logo_path\": \"/Users/jobzhao/.openclaw/workspace/assets/logo.png\",\n \"logo_url\": \"https://huihuoyun.huo15.com/web/image/website/1/logo\",\n \"fallback_logo_url\": \"https://tools.huo15.com/uploads/images/system/logo-colours.png\"\n}\n```\n\n**页眉代码示例（动态获取公司信息）**：\n\n```python\nfrom docx.shared import Pt, Cm\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nimport os\nimport json\nimport urllib.request\n\n# 公司信息配置\nCOMPANY_CONFIG_PATH = '/Users/jobzhao/.openclaw/workspace/config/company_info.json'\nDEFAULT_LOGO_PATH = '/Users/jobzhao/.openclaw/workspace/assets/logo.png'\n\n# 默认公司信息（当无法获取时使用）\nDEFAULT_COMPANY_NAME = '青岛火一五信息科技有限公司'\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_LOGO_URL = 'https://huihuoyun.huo15.com/web/image/website/1/logo'\n\ndef get_company_info():\n \"\"\"\n 获取公司信息，自动确保LOGO存在\n 返回: (company_name, logo_path)\n \n 注意：LOGO会自动下载到用户目录 ~/.huo15/assets/logo.png\n \"\"\"\n company_name = COMPANY_NAME\n logo_path = ensure_logo_exists() # 确保LOGO存在\n return company_name, logo_path\n\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉，包含 LOGO 图片 + 公司名称 + 底线\"\"\"\n # 获取公司信息\n if logo_path is None or company_name is None:\n company_name, logo_path = get_company_info()\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n \n # 设置页眉高度\n section.header_distance = Cm(1.5)\n \n # 添加段落（左对齐）\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n # 1. 添加 LOGO 图片（如果存在）\n if os.path.exists(logo_path):\n try:\n # 添加图片，高度 1cm，宽度自动\n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n except Exception as e:\n # 如果图片加载失败，继续添加文字\n pass\n \n # 2. 添加公司名称（紧挨着 LOGO）\n run = paragraph.add_run(f' {company_name}')\n set_font(run, '黑体', 10)\n \n # 3. 添加页眉底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n \n return header\n```\n\n**重要提醒（强制执行）**：\n- 生成文档时**必须调用** `add_header_with_logo(doc)` 函数\n- LOGO 图片路径：`/Users/jobzhao/.openclaw/workspace/assets/logo.png`\n- 如果图片不存在，**自动从公司系统下载**，或使用备用 LOGO\n- 公司名称与 LOGO 之间保留一个空格，紧挨着显示\n- **公司信息会自动从辉火云企业套件系统获取**，无需手动配置\n\n**LOGO 添加检查清单（每次生成文档前必须自检）**：\n- [ ] LOGO 图片文件是否存在于 `/Users/jobzhao/.openclaw/workspace/assets/logo.png`\n- [ ] 代码中是否调用了 `add_picture()` 方法添加 LOGO\n- [ ] 页眉中是否包含 LOGO + 公司名称 + 底线 三个元素\n- [ ] 是否设置了页眉底线（`w:bottom` 边框）\n\n**常见错误及解决方案**：\n\n| 错误 | 原因 | 解决方案 |\n|------|------|----------|\n| 文档没有 LOGO | 代码中缺少 `add_picture()` 调用 | 必须调用 `run.add_picture(logo_path, height=Cm(1.0))` |\n| LOGO 路径错误 | 图片路径写错或文件不存在 | 使用绝对路径，生成前检查 `os.path.exists(logo_path)` |\n| LOGO 太大/太小 | 高度设置不合理 | 使用 `height=Cm(1.0)` 标准高度 |\n| LOGO 和文字分开 | 没有在同一 paragraph 中添加 | LOGO 和公司名称必须在同一个 paragraph 中 |\n\n**完整调用示例**：\n\n```python\nfrom docx import Document\nfrom docx.shared import Cm\nimport os\n\n# 创建文档\ndoc = Document()\n\n# 1. 设置页面格式\nfor section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n\n# 2. 添加页眉（必须包含 LOGO）\nlogo_path = '/Users/jobzhao/.openclaw/workspace/assets/logo.png'\n\n# 检查 LOGO 是否存在\nif not os.path.exists(logo_path):\n raise FileNotFoundError(f\"LOGO 图片不存在：{logo_path}\")\n\nsection = doc.sections[0]\nheader = section.header\nheader.paragraphs.clear()\nsection.header_distance = Cm(1.5)\n\nparagraph = header.add_paragraph()\nparagraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n\n# 添加 LOGO\nrun = paragraph.add_run()\nrun.add_picture(logo_path, height=Cm(1.0))\n\n# 添加公司名称\nrun = paragraph.add_run(' 青岛火一五信息科技有限公司')\nset_font(run, '黑体', 10)\n\n# 添加底线\n# ...（参考上方完整代码）\n\n# 3. 继续添加文档内容\n# ...\n```\n\n### 页脚（GB/T 9704-2012 公文格式）\n- **内容**：页码（如\"第 1 页 共 3 页\"）\n- **位置**：页面下边缘居中\n- **字体**：仿宋，小四（12pt）\n- **WPS 兼容格式**：\n - 使用 `w:eastAsia` 字体域确保 WPS 识别\n - 数字同样使用仿宋字体\n- **示例**：`第 1 页 共 3 页`\n\n### 页脚代码示例（WPS 兼容）\n\n```python\nfrom docx.shared import Pt, Cm\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\n\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚，包含当前页和总页数，WPS 兼容\"\"\"\n section = doc.sections[0]\n \n # 设置页脚距离页面底部边距\n section.footer_distance = Cm(1.5)\n \n # 获取或创建页脚\n footer = section.footer\n \n # 添加段落（居中）\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n # 添加\"第\"字\n run1 = paragraph.add_run(\"第\")\n run1.font.name = '仿宋'\n run1._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run1.font.size = Pt(12)\n \n # 插入当前页码域（PAGE）\n run2 = paragraph.add_run()\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText1 = OxmlElement('w:instrText')\n instrText1.text = 'PAGE'\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run2._element.append(fldChar1)\n run2._element.append(instrText1)\n run2._element.append(fldChar2)\n run2.font.name = '仿宋'\n run2._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run2.font.size = Pt(12)\n \n # 添加\"页 共\"文字\n run3 = paragraph.add_run(\"页 共\")\n run3.font.name = '仿宋'\n run3._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run3.font.size = Pt(12)\n \n # 插入总页数域（NUMPAGES）\n run4 = paragraph.add_run()\n fldChar3 = OxmlElement('w:fldChar')\n fldChar3.set(qn('w:fldCharType'), 'begin')\n instrText2 = OxmlElement('w:instrText')\n instrText2.text = 'NUMPAGES'\n fldChar4 = OxmlElement('w:fldChar')\n fldChar4.set(qn('w:fldCharType'), 'end')\n run4._element.append(fldChar3)\n run4._element.append(instrText2)\n run4._element.append(fldChar4)\n run4.font.name = '仿宋'\n run4._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run4.font.size = Pt(12)\n \n # 添加\"页\"字\n run5 = paragraph.add_run(\"页\")\n run5.font.name = '仿宋'\n run5._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run5.font.size = Pt(12)\n```\n\n---\n\n## 📁 文档命名规则（必须遵循）\n\n### 命名格式\n\n```\n[文档类型]_[客户名称]_[项目名称]_[日期]_[版本].docx\n```\n\n### 命名元素说明\n\n| 元素 | 说明 | 示例 | 必填 |\n|------|------|------|------|\n| 文档类型 | 具体文档类型 | 合同、报价单、发货单、会议纪要、技术方案 | ✅ |\n| 客户名称 | 客户公司简称 | 阿里、腾讯、华为、海尔 | ✅ |\n| 项目名称 | 项目名称（可选） | ERP、MES、WMS、OA | ○ |\n| 日期 | 文档日期，格式 YYYYMMDD | 20250319 | ✅ |\n| 版本 | 版本号 v1.0（可选，默认 v1.0） | v1.0、v1.1、v2.0 | ○ |\n\n### 文档类型编码\n\n| 文档类型 | 编码 | 说明 |\n|----------|------|------|\n| 合同 | CONTRACT | 销售合同、服务合同 |\n| 报价单 | QUOTE | 产品报价、项目报价 |\n| 发货单 | DELIVERY | 发货清单、送货单 |\n| 会议纪要 | MEMO | 会议记录、洽谈纪要 |\n| 技术方案 | PROPOSAL | 解决方案、技术方案 |\n| 功能说明书 | SPEC | 产品功能说明、需求规格 |\n| 验收报告 | ACCEPTANCE | 项目验收、交付验收 |\n| 发票 | INVOICE | 增值税发票、普通发票 |\n\n### 命名示例\n\n```\n# 完整格式\nCONTRACT_阿里_钉钉OA_20250319_v1.0.docx\nQUOTE_腾讯_云ERP_20250318.docx\nDELIVERY_海尔_WMS_20250317_v1.0.docx\nMEMO_华为_技术洽谈_20250316.docx\nPROPOSAL_海信_MES系统_20250315_v2.0.docx\n\n# 无项目名称\nCONTRACT_京东_20250319.docx\nQUOTE_字节跳动_20250318.docx\n\n# 有版本迭代\nCONTRACT_小米_智能制造_20250319_v1.1.docx\nSPEC_美团_外卖系统_20250314_v1.2.docx\n```\n\n### ⚠️ 命名规则\n\n1. **使用下划线 `_` 分隔各元素**（不要用空格或连字符）\n2. **客户名称使用中文简称**，去除\"有限公司\"、\"股份有限公司\"等后缀\n3. **日期必须为 8 位数字**（YYYYMMDD）\n4. **版本号格式为 vX.X**（如 v1.0、v2.1）\n5. **禁止出现特殊字符**：`\\/:*?\"<>|`\n6. **文件后缀必须为 .docx**\n\n### 自动命名函数\n\n```python\nimport datetime\n\ndef generate_doc_name(doc_type, customer_name, project_name=\"\", version=\"v1.0\"):\n \"\"\"\n 生成符合规范的文档名称\n \n 参数:\n doc_type: 文档类型编码（如 CONTRACT, QUOTE）\n customer_name: 客户名称\n project_name: 项目名称（可选）\n version: 版本号（可选，默认 v1.0）\n \n 返回:\n 文档名称字符串，如 CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n \"\"\"\n # 日期\n date_str = datetime.datetime.now().strftime(\"%Y%m%d\")\n \n # 清理客户名称（去除公司后缀）\n customer = customer_name.replace(\"有限公司\", \"\").replace(\"股份有限公司\", \"\").replace(\"集团\", \"\").strip()\n \n # 清理项目名称\n project = project_name.strip() if project_name else \"\"\n \n # 构建名称\n parts = [doc_type, customer]\n if project:\n parts.append(project)\n parts.append(date_str)\n \n # 添加版本（如果不是默认版本）\n if version and version != \"v1.0\":\n parts.append(version)\n \n # 拼接并添加后缀\n doc_name = \"_\".join(parts) + \".docx\"\n \n return doc_name\n\n# 使用示例\n# generate_doc_name(\"CONTRACT\", \"阿里巴巴有限公司\", \"钉钉OA\", \"v1.0\")\n# -> CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n\n# generate_doc_name(\"QUOTE\", \"腾讯科技有限公司\")\n# -> QUOTE_腾讯_20250319.docx\n```\n\n### 检查清单（生成文档前必查）\n\n- [ ] 文档名称是否包含文档类型？\n- [ ] 客户名称是否为简称（去除有限公司等）？\n- [ ] 日期是否为 8 位数字格式？\n- [ ] 版本号格式是否正确（vX.X）？\n- [ ] 是否使用了下划线分隔？\n- [ ] 是否包含了 .docx 后缀？\n- [ ] 是否有禁止的特殊字符？\n\n---\n\n## 🚀 简化函数：一条命令完成文档格式\n\n```python\nfrom docx import Document\nfrom docx.shared import Pt, Cm\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nimport os\nimport urllib.request\nimport json\n\n# ============== 配置区域 ==============\n# 使用用户目录下的 .huo15 目录，跨平台通用\nUSER_HOME = os.path.expanduser(\"~\")\nLOGO_DIR = os.path.join(USER_HOME, \".huo15\", \"assets\")\nDEFAULT_LOGO_PATH = os.path.join(LOGO_DIR, \"logo.png\")\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_NAME = '青岛火一五信息科技有限公司'\n\ndef ensure_logo_exists(logo_path=DEFAULT_LOGO_PATH):\n \"\"\"确保 LOGO 存在，不存在则自动下载到用户目录\"\"\"\n if os.path.exists(logo_path) and os.path.getsize(logo_path) > 0:\n return logo_path\n \n # 创建目录并下载\n os.makedirs(os.path.dirname(logo_path), exist_ok=True)\n try:\n urllib.request.urlretrieve(FALLBACK_LOGO_URL, logo_path)\n print(f\"✓ LOGO 已自动下载: {logo_path}\")\n except Exception as e:\n raise FileNotFoundError(f\"❌ LOGO 下载失败: {e}\\n请检查网络后重试\")\n \n return logo_path\n\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"设置中文字体（WPS/Word兼容）\"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉：LOGO + 公司名称 + 底线\n \n 注意：LOGO会自动下载，无需手动配置\n \"\"\"\n # 获取公司信息和LOGO路径\n _company_name, _logo_path = get_company_info()\n logo_path = logo_path or _logo_path\n company_name = company_name or _company_name\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n section.header_distance = Cm(1.5)\n \n # 添加 LOGO + 公司名称\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n \n run = paragraph.add_run(f' {company_name}')\n set_chinese_font(run, '黑体', 10)\n \n # 添加底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚：第 X 页 共 Y 页\"\"\"\n section = doc.sections[0]\n section.footer_distance = Cm(1.5)\n footer = section.footer\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n # 构建页码域\n for text, is_field in [(\"第\", False), (\"PAGE\", True), (\"页 共\", False), (\"NUMPAGES\", True), (\"页\", False)]:\n run = paragraph.add_run(text)\n set_chinese_font(run, '仿宋', 12)\n if is_field:\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText = OxmlElement('w:instrText')\n instrText.text = text\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run._element.clear()\n run._element.append(fldChar1)\n run._element.append(instrText)\n run._element.append(fldChar2)\n\ndef create_formatted_doc(title=\"\", logo_path=None, company_name=None):\n \"\"\"\n 🚀 一条命令创建符合公司规范的 Word 文档\n \n 参数:\n title: 文档标题（可选）\n logo_path: LOGO 图片路径（可选，默认自动查找/下载）\n company_name: 公司名称（可选，默认\"青岛火一五信息科技有限公司\"）\n \n 返回:\n doc: python-docx Document 对象\n \n 使用示例:\n doc = create_formatted_doc(\"销售合同\")\n doc.add_paragraph(\"合同正文内容...\")\n doc.save(\"CONTRACT_客户_20250319.docx\")\n \"\"\"\n # 1. 创建文档\n doc = Document()\n \n # 2. 设置页面边距（GB/T 9704-2012）\n for section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n \n # 3. 添加页眉（LOGO + 公司名）\n add_header_with_logo(doc, logo_path, company_name)\n \n # 4. 添加页脚（页码）\n add_footer_with_page_numbers(doc)\n \n # 5. 设置默认字体\n style = doc.styles['Normal']\n style.font.name = '仿宋'\n style.font.size = Pt(12)\n style._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n \n # 6. 添加标题（如果提供）\n if title:\n p = doc.add_paragraph(title)\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in p.runs:\n set_chinese_font(run, '黑体', 22, True)\n \n return doc\n```\n\n### 简化函数使用流程\n\n```python\n# 步骤1：一条命令创建文档（自动包含 LOGO + 页码 + 字体）\ndoc = create_formatted_doc(\n title=\"销售合同\",\n company_name=\"青岛火一五信息科技有限公司\"\n)\n\n# 步骤2：添加文档内容\ndoc.add_paragraph(\"第一条：...\")\n\n# 步骤3：保存文档（按命名规范）\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n\n# 完成！✅\n```\n\n> **重要**：使用 `create_formatted_doc()` 函数会自动处理：\n> - ✅ 页面边距（3.7/3.5/2.8/2.6cm）\n> - ✅ 页眉 LOGO + 公司名称 + 底线\n> - ✅ 页脚页码（第 X 页 共 Y 页）\n> - ✅ 默认字体（仿宋小四）\n> - ✅ LOGO 不存在时自动下载\n\n---\n\n## 公司信息\n- 公司名称：青岛火一五信息科技有限公司\n- 社会信用代码：91370203MA3CKR364A\n- 地址：青岛市市南区南京路 8 号创联工场 6 楼 615\n- 电话：18554898815\n- 邮箱：postmaster@huo15.com\n\n## 文档结构\n\n1. 合同标题 - 居中，黑体二号加粗\n2. 合同编号 - 居中，仿宋三号\n3. 签订日期 - 居中，仿宋三号\n4. 一，二，三...章 - 楷体三号加粗\n5. 签署栏 - 盖章、法定代表人、日期\n\n## 表格样式\n- 表头：加粗，仿宋小四\n- 正文：仿宋，小四（12pt）\n- 边框：Table Grid\n\n---\n\n## 实践经验总结（2026-03-14）\n\n### WPS页码兼容问题解决方案\n\n**问题**：之前生成的文档在WPS中页码显示不正确\n\n**根因**：页码域代码实现方式不正确\n\n**最终解决方案（2026-03-14验证通过）**：\n\n```python\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\n\n# 关键：正确添加域代码的方式\nrun2 = paragraph.add_run()\nfldChar1 = OxmlElement('w:fldChar')\nfldChar1.set(qn('w:fldCharType'), 'begin')\ninstrText1 = OxmlElement('w:instrText')\ninstrText1.text = 'PAGE'\nfldChar2 = OxmlElement('w:fldChar')\nfldChar2.set(qn('w:fldCharType'), 'end')\nrun2._element.append(fldChar1) # 注意：用append不是set\nrun2._element.append(instrText1)\nrun2._element.append(fldChar2)\nrun2.font.name = '仿宋'\nrun2._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\nrun2.font.size = Pt(12)\n```\n\n**关键要点**：\n1. 必须使用 `run._element.append()` 添加域元素，而不是其他方式\n2. 每个run都要设置字体域：`run._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')`\n3. 同时设置 `run.font.name = '仿宋'`\n4. PAGE域显示当前页，NUMPAGES域显示总页数\n\n**验证结果**：WPS和Word均正确显示页码\n\n### WPS字体兼容性问题解决方案\n\n**问题**：生成的文档在WPS中字体显示不正确（显示为宋体而非仿宋/黑体等）\n\n**根因**：\n1. 只设置了 `run.font.name`，没有设置 `w:eastAsia` 字体域\n2. WPS 和 Word 对字体的渲染机制不同\n\n**实践经验（2026-03-14验证通过）**：\n\n```python\n# 正确：每个run都要设置字体域\nrun.font.name = '仿宋'\nrun._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋') # 关键！\nrun.font.size = Pt(12)\n```\n\n**关键要点**：\n1. **每个run都要设置字体域**：不能只设置一次，必须对每个run调用\n2. **同时设置两个属性**：`run.font.name` + `run._element.rPr.rFonts.set()`\n3. **正文样式也要设置**：\n```python\nstyle = doc.styles['Normal']\nstyle.font.name = \"仿宋\"\nstyle.font.size = Pt(12)\nstyle._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n```\n4. **字体域必须用正确的命名空间**：`qn('w:eastAsia')`\n\n**验证结果**：WPS和Word均正确显示字体\n\n---\n\n## 实践经验总结（2026-03-19）\n\n### 不要依赖pip安装包，代码模板就在SKILL.md中\n\n**问题**：初次使用技能时，误以为需要 `pip install huo15_doc` 安装Python包才能使用\n\n**根因**：看到SKILL.md中的 `from huo15_doc import create_formatted_doc` 就以为需要pip包\n\n**经验教训**：\n1. `huo15-doc-template` 是一个**文档模板规范技能**，不是pip包\n2. 代码模板**直接写在SKILL.md中**，可以直接复制使用\n3. 不需要任何pip安装，直接复制SKILL.md中的Python代码即可\n\n**正确使用流程**：\n1. 打开 `~/.openclaw/workspace/skills/huo15-doc-template/SKILL.md`\n2. 找到\"简化函数\"部分的代码模板\n3. 直接复制到Python脚本中使用\n4. 确保LOGO文件存在（如不存在会自动下载）\n\n**简化函数一键使用**：\n```python\n# 直接从SKILL.md复制此函数，无需pip安装！\ndoc = create_formatted_doc(\n title=\"知本元项目情况汇总\",\n company_name=\"青岛火一五信息科技有限公司\"\n)\n# 添加内容...\ndoc.save(\"文档名.docx\")\n```\n\n**验证结果**：成功生成符合公司规范的Word文档\n\nFile v1.3.0:_meta.json\n\n{\n \"ownerId\": \"kn7b0rmtgvbq55rc54rhp69r79822ym9\",\n \"slug\": \"huo15-doc-template\",\n \"version\": \"1.3.0\",\n \"publishedAt\": 1774842152069\n}\n\nArchive v1.2.2: 2 files, 9692 bytes\n\nFiles: _meta.json (137b), SKILL.md (29918b)\n\nFile v1.2.2:SKILL.md\n\n---\nname: huo15-doc-template / 火一五文档模板\ndescription: 【版权：青岛火一五信息科技有限公司 账号：huo15】火一五文档技能（别名）。文档模板生成工具。用于生成公司正式文档（合同、报价单、功能说明书、发货单、PDA 单据、会议纪要等），包含公司信息、字体规范、页面设置等模板规则/PDF 文档时。**生成 Word 默认使用此技能**。触发场景：(1) 生成合同或报价单 (2) 创建 Word 文档模板 (3) 按公司规范排版文档 (4) 使用公文格式生成文档 (5) 用户说\"写个文档\"、\"生成文档\"、\"创建文档\"、\"生成会议纪要\"等\n\n## 重要：此为首选文档技能\n**所有 Word 文档生成任务都必须使用此技能**\n\n---\n\n## ⚠️ 强制检查清单（生成文档前必须完成）\n\n> **新用户必读！每次生成文档前对照检查，否则文档不合格！**\n\n- [ ] **LOGO 是否添加？** —— 页眉必须有 LOGO + 公司名称 + 底线\n- [ ] **页码是否添加？** —— 页脚必须有\"第 X 页 共 Y 页\"\n- [ ] **字体是否正确？** —— 正文仿宋，标题黑体/楷体\n- [ ] **页面边距是否正确？** —— 上下 3.7/3.5cm，左右 2.8/2.6cm\n- [ ] **命名是否规范？** —— 文档类型_客户名称_日期.docx\n\n**如果没有完成以上检查，文档不允许交付！**\n\n---\n\n## 🚀 简化版：一条命令完成所有格式\n\n> **重要**：不需要 pip install huo15_doc！代码模板直接写在 SKILL.md 中，复制使用即可！\n\n```python\n# 直接从 SKILL.md 中复制以下代码到你的Python脚本：\n# （函数定义参考 SKILL.md 中的 \"简化函数\" 部分）\n\n# LOGO 会自动从公司系统下载，无需手动配置！\ndoc = create_formatted_doc(\n title=\"合同标题\",\n company_name=\"青岛火一五信息科技有限公司\"\n)\n\n# 然后直接添加内容...\ndoc.add_paragraph(\"合同正文内容\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n```\n\n> **强烈建议**：使用简化函数，告别手动配置！\n> **重要**：LOGO 会自动从公司系统下载，无需手动配置！\n\n---\n\n## 技能分工规则（格式引用 vs 文档操作）\n\n### 格式引用 → huo15-doc-template\n- 字体规范（仿宋、黑体、楷体字号）\n- 页面边距（GB/T 9704-2012 公文格式）\n- 页眉页脚（LOGO、公司名称、页码）\n- 公文格式排版\n\n### 文档操作 → office-document-specialist-suite\n- 创建/编辑 Word 文档\n- 内容填充、排版调整\n- 表格操作、段落设置\n\n### 组合使用流程\n1. 用 `office-document-specialist-suite` 处理文档内容\n2. 用 `huo15-doc-template` 处理格式规范\n3. 最终生成符合公司规范的正式文档\n\n---\n\n# 文档模板技能\n\n## 快速开始\n\n1. **字体设置**：默认使用仿宋，小四（12pt）\n2. **页面边距**：上下 3.7/3.5cm，左右 2.8/2.6cm\n3. **页眉**：LOGO + 公司名称 + 底线\n4. **页脚**：页码居中，格式\"第 X 页 共 Y 页\"，仿宋小四\n\n---\n\n## 配置规则\n\n### 字体规范\n- **默认正文**：仿宋，小四（12pt）\n- **一级标题**：黑体，小三（15pt），加粗\n- **二级标题**：楷体，小四（12pt），加粗\n- **三级标题**：仿宋，小四（12pt），加粗\n\n**WPS 字体兼容**：\n- 汉字字体：使用 `仿宋`\n- 每个 run 都要设置字体域 `w:eastAsia`\n\n---\n\n## ⚠️ 重要：Markdown 语法转换规则\n\n### 禁止直接在 Word 中使用 Markdown 语法\n\n**严禁将 Markdown 语法直接写入 Word 文档**，例如：\n- ❌ 错误：`**加粗文本**` → Word 中会显示星号\n- ❌ 错误：`| 列1 | 列2 |` → Word 中会显示管道符\n- ❌ 错误：`# 一级标题` → Word 中会显示井号\n\n### 正确转换方法\n\n#### 1. 加粗转换\n- Markdown：`**这是加粗**`\n- Word：设置 `run.bold = True`\n\n```python\n# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗\n```\n\n#### 2. 表格转换\n- Markdown：\n```\n| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |\n```\n- Word：使用 `doc.add_table()` 创建表格\n\n```python\n# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)\n```\n\n#### 3. 标题转换\n- Markdown：`# 一级标题`\n- Word：添加段落并设置样式\n\n```python\n# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)\n```\n\n### 自检清单（生成文档前必查）\n\n生成文档后，检查以下内容：\n- [ ] 文档中是否有 `**`、`__`、`#` 等 Markdown 符号？\n- [ ] 表格是否使用了 `|` 管道符？\n- [ ] 链接是否显示了 `[文字](URL)` 格式？\n- [ ] 列表是否显示了 `-` 或 `*` 前缀？\n\n**如果有任何一项为\"是\"，则文档不合格，需要重新生成**\n\n### ⚠️ 字体问题根本原因\n\n**问题**：WPS 和 Word 对字体的渲染方式不同，WPS 需要显式设置字体域才能正确识别中文字体。\n\n**解决方案**：每个 run 都必须设置以下三个属性：\n1. `run.font.name = font_name` - 设置字体名称\n2. `run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)` - 设置字体域（WPS兼容）\n3. `run.font.size = Pt(font_size)` - 设置字号\n\n### 字体设置正确示范\n\n```python\nfrom docx.oxml.ns import qn\n\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n # 1. 设置西文字体名称\n run.font.name = font_name\n # 2. 设置字体域（WPS兼容关键）\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n # 3. 设置字号\n run.font.size = Pt(font_size)\n # 4. 设置加粗\n run.bold = bold\n return run\n```\n\n### ❌ 常见错误\n\n| 错误做法 | 后果 |\n|---------|------|\n| 只设置 `run.font.name` | Word显示正确，WPS显示为宋体 |\n| 不设置 `w:eastAsia` 字体域 | WPS无法识别中文字体 |\n| 只在第一个run设置字体 | 后续文字字体丢失 |\n| 使用 `set_font()` 但没有设置字体域 | WPS显示不正确 |\n\n### ✅ 正确做法\n\n```python\n# 正确：每个run都设置字体\np = doc.add_paragraph()\nrun = p.add_run('这是正文')\nset_chinese_font(run, '仿宋', 12) # ✅ 每个run都调用\n\n# 错误：只设置一次\np = doc.add_paragraph()\nrun = p.add_run('这是正文')\nrun.font.name = '仿宋' # ❌ 缺少字体域\n```\n\n---\n\n### 完整函数模板（必须复制使用）\n\n```python\nfrom docx import Document\nfrom docx.shared import Pt, Cm\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nimport os\n\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n```\n\n### 页面设置（GB/T 9704-2012 公文格式）\n- 上边距：3.7cm\n- 下边距：3.5cm\n- 左边距：2.8cm\n- 右边距：2.6cm\n- 纸张：A4\n\n### 页眉（必须包含 LOGO）\n- LOGO 路径：`/Users/jobzhao/.openclaw/workspace/assets/logo.png`\n- 内容：LOGO 图片 + 公司名称（紧挨着）\n- 字体：仿宋，小四（12pt）\n- **必须添加页眉底线**（细线）\n\n### ⚠️ 公司信息获取规则（重要）\n\n**获取顺序**：\n1. 首先从**辉火云企业套件系统**获取公司名称和 LOGO\n2. 如果获取失败，使用**本地配置文件**中的备选信息\n3. 如果配置文件也没有，使用**默认信息**\n\n**默认公司信息**：\n- 公司名称：**青岛火一五信息科技有限公司**\n- 默认 LOGO：`/Users/jobzhao/.openclaw/workspace/assets/logo.png`（从 https://tools.huo15.com/uploads/images/system/logo-colours.png 下载）\n\n**公司信息配置位置**：`/Users/jobzhao/.openclaw/workspace/config/company_info.json`\n\n```json\n{\n \"company_name\": \"青岛火一五信息科技有限公司\",\n \"logo_path\": \"/Users/jobzhao/.openclaw/workspace/assets/logo.png\",\n \"logo_url\": \"https://huihuoyun.huo15.com/web/image/website/1/logo\",\n \"fallback_logo_url\": \"https://tools.huo15.com/uploads/images/system/logo-colours.png\"\n}\n```\n\n**页眉代码示例（动态获取公司信息）**：\n\n```python\nfrom docx.shared import Pt, Cm\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nimport os\nimport json\nimport urllib.request\n\n# 公司信息配置\nCOMPANY_CONFIG_PATH = '/Users/jobzhao/.openclaw/workspace/config/company_info.json'\nDEFAULT_LOGO_PATH = '/Users/jobzhao/.openclaw/workspace/assets/logo.png'\n\n# 默认公司信息（当无法获取时使用）\nDEFAULT_COMPANY_NAME = '青岛火一五信息科技有限公司'\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_LOGO_URL = 'https://huihuoyun.huo15.com/web/image/website/1/logo'\n\ndef get_company_info():\n \"\"\"\n 获取公司信息，自动确保LOGO存在\n 返回: (company_name, logo_path)\n \n 注意：LOGO会自动下载到用户目录 ~/.huo15/assets/logo.png\n \"\"\"\n company_name = COMPANY_NAME\n logo_path = ensure_logo_exists() # 确保LOGO存在\n return company_name, logo_path\n\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉，包含 LOGO 图片 + 公司名称 + 底线\"\"\"\n # 获取公司信息\n if logo_path is None or company_name is None:\n company_name, logo_path = get_company_info()\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n \n # 设置页眉高度\n section.header_distance = Cm(1.5)\n \n # 添加段落（左对齐）\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n # 1. 添加 LOGO 图片（如果存在）\n if os.path.exists(logo_path):\n try:\n # 添加图片，高度 1cm，宽度自动\n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n except Exception as e:\n # 如果图片加载失败，继续添加文字\n pass\n \n # 2. 添加公司名称（紧挨着 LOGO）\n run = paragraph.add_run(f' {company_name}')\n set_font(run, '黑体', 10)\n \n # 3. 添加页眉底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n \n return header\n```\n\n**重要提醒（强制执行）**：\n- 生成文档时**必须调用** `add_header_with_logo(doc)` 函数\n- LOGO 图片路径：`/Users/jobzhao/.openclaw/workspace/assets/logo.png`\n- 如果图片不存在，**自动从公司系统下载**，或使用备用 LOGO\n- 公司名称与 LOGO 之间保留一个空格，紧挨着显示\n- **公司信息会自动从辉火云企业套件系统获取**，无需手动配置\n\n**LOGO 添加检查清单（每次生成文档前必须自检）**：\n- [ ] LOGO 图片文件是否存在于 `/Users/jobzhao/.openclaw/workspace/assets/logo.png`\n- [ ] 代码中是否调用了 `add_picture()` 方法添加 LOGO\n- [ ] 页眉中是否包含 LOGO + 公司名称 + 底线 三个元素\n- [ ] 是否设置了页眉底线（`w:bottom` 边框）\n\n**常见错误及解决方案**：\n\n| 错误 | 原因 | 解决方案 |\n|------|------|----------|\n| 文档没有 LOGO | 代码中缺少 `add_picture()` 调用 | 必须调用 `run.add_picture(logo_path, height=Cm(1.0))` |\n| LOGO 路径错误 | 图片路径写错或文件不存在 | 使用绝对路径，生成前检查 `os.path.exists(logo_path)` |\n| LOGO 太大/太小 | 高度设置不合理 | 使用 `height=Cm(1.0)` 标准高度 |\n| LOGO 和文字分开 | 没有在同一 paragraph 中添加 | LOGO 和公司名称必须在同一个 paragraph 中 |\n\n**完整调用示例**：\n\n```python\nfrom docx import Document\nfrom docx.shared import Cm\nimport os\n\n# 创建文档\ndoc = Document()\n\n# 1. 设置页面格式\nfor section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n\n# 2. 添加页眉（必须包含 LOGO）\nlogo_path = '/Users/jobzhao/.openclaw/workspace/assets/logo.png'\n\n# 检查 LOGO 是否存在\nif not os.path.exists(logo_path):\n raise FileNotFoundError(f\"LOGO 图片不存在：{logo_path}\")\n\nsection = doc.sections[0]\nheader = section.header\nheader.paragraphs.clear()\nsection.header_distance = Cm(1.5)\n\nparagraph = header.add_paragraph()\nparagraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n\n# 添加 LOGO\nrun = paragraph.add_run()\nrun.add_picture(logo_path, height=Cm(1.0))\n\n# 添加公司名称\nrun = paragraph.add_run(' 青岛火一五信息科技有限公司')\nset_font(run, '黑体', 10)\n\n# 添加底线\n# ...（参考上方完整代码）\n\n# 3. 继续添加文档内容\n# ...\n```\n\n### 页脚（GB/T 9704-2012 公文格式）\n- **内容**：页码（如\"第 1 页 共 3 页\"）\n- **位置**：页面下边缘居中\n- **字体**：仿宋，小四（12pt）\n- **WPS 兼容格式**：\n - 使用 `w:eastAsia` 字体域确保 WPS 识别\n - 数字同样使用仿宋字体\n- **示例**：`第 1 页 共 3 页`\n\n### 页脚代码示例（WPS 兼容）\n\n```python\nfrom docx.shared import Pt, Cm\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\n\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚，包含当前页和总页数，WPS 兼容\"\"\"\n section = doc.sections[0]\n \n # 设置页脚距离页面底部边距\n section.footer_distance = Cm(1.5)\n \n # 获取或创建页脚\n footer = section.footer\n \n # 添加段落（居中）\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n # 添加\"第\"字\n run1 = paragraph.add_run(\"第\")\n run1.font.name = '仿宋'\n run1._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run1.font.size = Pt(12)\n \n # 插入当前页码域（PAGE）\n run2 = paragraph.add_run()\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText1 = OxmlElement('w:instrText')\n instrText1.text = 'PAGE'\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run2._element.append(fldChar1)\n run2._element.append(instrText1)\n run2._element.append(fldChar2)\n run2.font.name = '仿宋'\n run2._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run2.font.size = Pt(12)\n \n # 添加\"页 共\"文字\n run3 = paragraph.add_run(\"页 共\")\n run3.font.name = '仿宋'\n run3._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run3.font.size = Pt(12)\n \n # 插入总页数域（NUMPAGES）\n run4 = paragraph.add_run()\n fldChar3 = OxmlElement('w:fldChar')\n fldChar3.set(qn('w:fldCharType'), 'begin')\n instrText2 = OxmlElement('w:instrText')\n instrText2.text = 'NUMPAGES'\n fldChar4 = OxmlElement('w:fldChar')\n fldChar4.set(qn('w:fldCharType'), 'end')\n run4._element.append(fldChar3)\n run4._element.append(instrText2)\n run4._element.append(fldChar4)\n run4.font.name = '仿宋'\n run4._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run4.font.size = Pt(12)\n \n # 添加\"页\"字\n run5 = paragraph.add_run(\"页\")\n run5.font.name = '仿宋'\n run5._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run5.font.size = Pt(12)\n```\n\n---\n\n## 📁 文档命名规则（必须遵循）\n\n### 命名格式\n\n```\n[文档类型]_[客户名称]_[项目名称]_[日期]_[版本].docx\n```\n\n### 命名元素说明\n\n| 元素 | 说明 | 示例 | 必填 |\n|------|------|------|------|\n| 文档类型 | 具体文档类型 | 合同、报价单、发货单、会议纪要、技术方案 | ✅ |\n| 客户名称 | 客户公司简称 | 阿里、腾讯、华为、海尔 | ✅ |\n| 项目名称 | 项目名称（可选） | ERP、MES、WMS、OA | ○ |\n| 日期 | 文档日期，格式 YYYYMMDD | 20250319 | ✅ |\n| 版本 | 版本号 v1.0（可选，默认 v1.0） | v1.0、v1.1、v2.0 | ○ |\n\n### 文档类型编码\n\n| 文档类型 | 编码 | 说明 |\n|----------|------|------|\n| 合同 | CONTRACT | 销售合同、服务合同 |\n| 报价单 | QUOTE | 产品报价、项目报价 |\n| 发货单 | DELIVERY | 发货清单、送货单 |\n| 会议纪要 | MEMO | 会议记录、洽谈纪要 |\n| 技术方案 | PROPOSAL | 解决方案、技术方案 |\n| 功能说明书 | SPEC | 产品功能说明、需求规格 |\n| 验收报告 | ACCEPTANCE | 项目验收、交付验收 |\n| 发票 | INVOICE | 增值税发票、普通发票 |\n\n### 命名示例\n\n```\n# 完整格式\nCONTRACT_阿里_钉钉OA_20250319_v1.0.docx\nQUOTE_腾讯_云ERP_20250318.docx\nDELIVERY_海尔_WMS_20250317_v1.0.docx\nMEMO_华为_技术洽谈_20250316.docx\nPROPOSAL_海信_MES系统_20250315_v2.0.docx\n\n# 无项目名称\nCONTRACT_京东_20250319.docx\nQUOTE_字节跳动_20250318.docx\n\n# 有版本迭代\nCONTRACT_小米_智能制造_20250319_v1.1.docx\nSPEC_美团_外卖系统_20250314_v1.2.docx\n```\n\n### ⚠️ 命名规则\n\n1. **使用下划线 `_` 分隔各元素**（不要用空格或连字符）\n2. **客户名称使用中文简称**，去除\"有限公司\"、\"股份有限公司\"等后缀\n3. **日期必须为 8 位数字**（YYYYMMDD）\n4. **版本号格式为 vX.X**（如 v1.0、v2.1）\n5. **禁止出现特殊字符**：`\\/:*?\"<>|`\n6. **文件后缀必须为 .docx**\n\n### 自动命名函数\n\n```python\nimport datetime\n\ndef generate_doc_name(doc_type, customer_name, project_name=\"\", version=\"v1.0\"):\n \"\"\"\n 生成符合规范的文档名称\n \n 参数:\n doc_type: 文档类型编码（如 CONTRACT, QUOTE）\n customer_name: 客户名称\n project_name: 项目名称（可选）\n version: 版本号（可选，默认 v1.0）\n \n 返回:\n 文档名称字符串，如 CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n \"\"\"\n # 日期\n date_str = datetime.datetime.now().strftime(\"%Y%m%d\")\n \n # 清理客户名称（去除公司后缀）\n customer = customer_name.replace(\"有限公司\", \"\").replace(\"股份有限公司\", \"\").replace(\"集团\", \"\").strip()\n \n # 清理项目名称\n project = project_name.strip() if project_name else \"\"\n \n # 构建名称\n parts = [doc_type, customer]\n if project:\n parts.append(project)\n parts.append(date_str)\n \n # 添加版本（如果不是默认版本）\n if version and version != \"v1.0\":\n parts.append(version)\n \n # 拼接并添加后缀\n doc_name = \"_\".join(parts) + \".docx\"\n \n return doc_name\n\n# 使用示例\n# generate_doc_name(\"CONTRACT\", \"阿里巴巴有限公司\", \"钉钉OA\", \"v1.0\")\n# -> CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n\n# generate_doc_name(\"QUOTE\", \"腾讯科技有限公司\")\n# -> QUOTE_腾讯_20250319.docx\n```\n\n### 检查清单（生成文档前必查）\n\n- [ ] 文档名称是否包含文档类型？\n- [ ] 客户名称是否为简称（去除有限公司等）？\n- [ ] 日期是否为 8 位数字格式？\n- [ ] 版本号格式是否正确（vX.X）？\n- [ ] 是否使用了下划线分隔？\n- [ ] 是否包含了 .docx 后缀？\n- [ ] 是否有禁止的特殊字符？\n\n---\n\n## 🚀 简化函数：一条命令完成文档格式\n\n```python\nfrom docx import Document\nfrom docx.shared import Pt, Cm\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nimport os\nimport urllib.request\nimport json\n\n# ============== 配置区域 ==============\n# 使用用户目录下的 .huo15 目录，跨平台通用\nUSER_HOME = os.path.expanduser(\"~\")\nLOGO_DIR = os.path.join(USER_HOME, \".huo15\", \"assets\")\nDEFAULT_LOGO_PATH = os.path.join(LOGO_DIR, \"logo.png\")\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_NAME = '青岛火一五信息科技有限公司'\n\ndef ensure_logo_exists(logo_path=DEFAULT_LOGO_PATH):\n \"\"\"确保 LOGO 存在，不存在则自动下载到用户目录\"\"\"\n if os.path.exists(logo_path) and os.path.getsize(logo_path) > 0:\n return logo_path\n \n # 创建目录并下载\n os.makedirs(os.path.dirname(logo_path), exist_ok=True)\n try:\n urllib.request.urlretrieve(FALLBACK_LOGO_URL, logo_path)\n print(f\"✓ LOGO 已自动下载: {logo_path}\")\n except Exception as e:\n raise FileNotFoundError(f\"❌ LOGO 下载失败: {e}\\n请检查网络后重试\")\n \n return logo_path\n\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"设置中文字体（WPS/Word兼容）\"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉：LOGO + 公司名称 + 底线\n \n 注意：LOGO会自动下载，无需手动配置\n \"\"\"\n # 获取公司信息和LOGO路径\n _company_name, _logo_path = get_company_info()\n logo_path = logo_path or _logo_path\n company_name = company_name or _company_name\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n section.header_distance = Cm(1.5)\n \n # 添加 LOGO + 公司名称\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n \n run = paragraph.add_run(f' {company_name}')\n set_chinese_font(run, '黑体', 10)\n \n # 添加底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚：第 X 页 共 Y 页\"\"\"\n section = doc.sections[0]\n section.footer_distance = Cm(1.5)\n footer = section.footer\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n # 构建页码域\n for text, is_field in [(\"第\", False), (\"PAGE\", True), (\"页 共\", False), (\"NUMPAGES\", True), (\"页\", False)]:\n run = paragraph.add_run(text)\n set_chinese_font(run, '仿宋', 12)\n if is_field:\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText = OxmlElement('w:instrText')\n instrText.text = text\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run._element.clear()\n run._element.append(fldChar1)\n run._element.append(instrText)\n run._element.append(fldChar2)\n\ndef create_formatted_doc(title=\"\", logo_path=None, company_name=None):\n \"\"\"\n 🚀 一条命令创建符合公司规范的 Word 文档\n \n 参数:\n title: 文档标题（可选）\n logo_path: LOGO 图片路径（可选，默认自动查找/下载）\n company_name: 公司名称（可选，默认\"青岛火一五信息科技有限公司\"）\n \n 返回:\n doc: python-docx Document 对象\n \n 使用示例:\n doc = create_formatted_doc(\"销售合同\")\n doc.add_paragraph(\"合同正文内容...\")\n doc.save(\"CONTRACT_客户_20250319.docx\")\n \"\"\"\n # 1. 创建文档\n doc = Document()\n \n # 2. 设置页面边距（GB/T 9704-2012）\n for section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n \n # 3. 添加页眉（LOGO + 公司名）\n add_header_with_logo(doc, logo_path, company_name)\n \n # 4. 添加页脚（页码）\n add_footer_with_page_numbers(doc)\n \n # 5. 设置默认字体\n style = doc.styles['Normal']\n style.font.name = '仿宋'\n style.font.size = Pt(12)\n style._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n \n # 6. 添加标题（如果提供）\n if title:\n p = doc.add_paragraph(title)\n p.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in p.runs:\n set_chinese_font(run, '黑体', 22, True)\n \n return doc\n```\n\n### 简化函数使用流程\n\n```python\n# 步骤1：一条命令创建文档（自动包含 LOGO + 页码 + 字体）\ndoc = create_formatted_doc(\n title=\"销售合同\",\n company_name=\"青岛火一五信息科技有限公司\"\n)\n\n# 步骤2：添加文档内容\ndoc.add_paragraph(\"第一条：...\")\n\n# 步骤3：保存文档（按命名规范）\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n\n# 完成！✅\n```\n\n> **重要**：使用 `create_formatted_doc()` 函数会自动处理：\n> - ✅ 页面边距（3.7/3.5/2.8/2.6cm）\n> - ✅ 页眉 LOGO + 公司名称 + 底线\n> - ✅ 页脚页码（第 X 页 共 Y 页）\n> - ✅ 默认字体（仿宋小四）\n> - ✅ LOGO 不存在时自动下载\n\n---\n\n## 公司信息\n- 公司名称：青岛火一五信息科技有限公司\n- 社会信用代码：91370203MA3CKR364A\n- 地址：青岛市市南区南京路 8 号创联工场 6 楼 615\n- 电话：18554898815\n- 邮箱：postmaster@huo15.com\n\n## 文档结构\n\n1. 合同标题 - 居中，黑体二号加粗\n2. 合同编号 - 居中，仿宋三号\n3. 签订日期 - 居中，仿宋三号\n4. 一，二，三...章 - 楷体三号加粗\n5. 签署栏 - 盖章、法定代表人、日期\n\n## 表格样式\n- 表头：加粗，仿宋小四\n- 正文：仿宋，小四（12pt）\n- 边框：Table Grid\n\n---\n\n## 实践经验总结（2026-03-14）\n\n### WPS页码兼容问题解决方案\n\n**问题**：之前生成的文档在WPS中页码显示不正确\n\n**根因**：页码域代码实现方式不正确\n\n**最终解决方案（2026-03-14验证通过）**：\n\n```python\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\n\n# 关键：正确添加域代码的方式\nrun2 = paragraph.add_run()\nfldChar1 = OxmlElement('w:fldChar')\nfldChar1.set(qn('w:fldCharType'), 'begin')\ninstrText1 = OxmlElement('w:instrText')\ninstrText1.text = 'PAGE'\nfldChar2 = OxmlElement('w:fldChar')\nfldChar2.set(qn('w:fldCharType'), 'end')\nrun2._element.append(fldChar1) # 注意：用append不是set\nrun2._element.append(instrText1)\nrun2._element.append(fldChar2)\nrun2.font.name = '仿宋'\nrun2._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\nrun2.font.size = Pt(12)\n```\n\n**关键要点**：\n1. 必须使用 `run._element.append()` 添加域元素，而不是其他方式\n2. 每个run都要设置字体域：`run._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')`\n3. 同时设置 `run.font.name = '仿宋'`\n4. PAGE域显示当前页，NUMPAGES域显示总页数\n\n**验证结果**：WPS和Word均正确显示页码\n\n### WPS字体兼容性问题解决方案\n\n**问题**：生成的文档在WPS中字体显示不正确（显示为宋体而非仿宋/黑体等）\n\n**根因**：\n1. 只设置了 `run.font.name`，没有设置 `w:eastAsia` 字体域\n2. WPS 和 Word 对字体的渲染机制不同\n\n**实践经验（2026-03-14验证通过）**：\n\n```python\n# 正确：每个run都要设置字体域\nrun.font.name = '仿宋'\nrun._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋') # 关键！\nrun.font.size = Pt(12)\n```\n\n**关键要点**：\n1. **每个run都要设置字体域**：不能只设置一次，必须对每个run调用\n2. **同时设置两个属性**：`run.font.name` + `run._element.rPr.rFonts.set()`\n3. **正文样式也要设置**：\n```python\nstyle = doc.styles['Normal']\nstyle.font.name = \"仿宋\"\nstyle.font.size = Pt(12)\nstyle._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n```\n4. **字体域必须用正确的命名空间**：`qn('w:eastAsia')`\n\n**验证结果**：WPS和Word均正确显示字体\n\n---\n\n## 实践经验总结（2026-03-19）\n\n### 不要依赖pip安装包，代码模板就在SKILL.md中\n\n**问题**：初次使用技能时，误以为需要 `pip install huo15_doc` 安装Python包才能使用\n\n**根因**：看到SKILL.md中的 `from huo15_doc import create_formatted_doc` 就以为需要pip包\n\n**经验教训**：\n1. `huo15-doc-template` 是一个**文档模板规范技能**，不是pip包\n2. 代码模板**直接写在SKILL.md中**，可以直接复制使用\n3. 不需要任何pip安装，直接复制SKILL.md中的Python代码即可\n\n**正确使用流程**：\n1. 打开 `~/.openclaw/workspace/skills/huo15-doc-template/SKILL.md`\n2. 找到\"简化函数\"部分的代码模板\n3. 直接复制到Python脚本中使用\n4. 确保LOGO文件存在（如不存在会自动下载）\n\n**简化函数一键使用**：\n```python\n# 直接从SKILL.md复制此函数，无需pip安装！\ndoc = create_formatted_doc(\n title=\"知本元项目情况汇总\",\n company_name=\"青岛火一五信息科技有限公司\"\n)\n# 添加内容...\ndoc.save(\"文档名.docx\")\n```\n\n**验证结果**：成功生成符合公司规范的Word文档\n\nFile v1.2.2:_meta.json\n\n{\n \"ownerId\": \"kn7b0rmtgvbq55rc54rhp69r79822ym9\",\n \"slug\": \"huo15-doc-template\",\n \"version\": \"1.2.2\",\n \"publishedAt\": 1773927070001\n}\n\nArchive v1.2.0: 2 files, 9762 bytes\n\nFiles: _meta.json (137b), SKILL.md (30573b)\n\nFile v1.2.0:SKILL.md\n\n---\nname: huo15-doc-template / 火一五文档模板\ndescription: 【版权：青岛火一五信息科技有限公司 账号：huo15】火一五文档技能（别名）。文档模板生成工具。用于生成公司正式文档（合同、报价单、功能说明书、发货单、PDA 单据、会议纪要等），包含公司信息、字体规范、页面设置等模板规则/PDF 文档时。**生成 Word 默认使用此技能**。触发场景：(1) 生成合同或报价单 (2) 创建 Word 文档模板 (3) 按公司规范排版文档 (4) 使用公文格式生成文档 (5) 用户说\"写个文档\"、\"生成文档\"、\"创建文档\"、\"生成会议纪要\"等\n\n## 重要：此为首选文档技能\n**所有 Word 文档生成任务都必须使用此技能**\n\n---\n\n## ⚠️ 强制检查清单（生成文档前必须完成）\n\n> **新用户必读！每次生成文档前对照检查，否则文档不合格！**\n\n- [ ] **LOGO 是否添加？** —— 页眉必须有 LOGO + 公司名称 + 底线\n- [ ] **页码是否添加？** —— 页脚必须有\"第 X 页 共 Y 页\"\n- [ ] **字体是否正确？** —— 正文仿宋，标题黑体/楷体\n- [ ] **页面边距是否正确？** —— 上下 3.7/3.5cm，左右 2.8/2.6cm\n- [ ] **命名是否规范？** —— 文档类型_客户名称_日期.docx\n\n**如果没有完成以上检查，文档不允许交付！**\n\n---\n\n## 🚀 简化版：一条命令完成所有格式\n\n> **重要**：不需要 pip install huo15_doc！代码模板直接写在 SKILL.md 中，复制使用即可！\n\n```python\n# 直接从 SKILL.md 中复制以下代码到你的Python脚本：\n# （函数定义参考 SKILL.md 中的 \"简化函数\" 部分）\n\ndoc = create_formatted_doc(\n title=\"合同标题\",\n company_name=\"青岛火一五信息科技有限公司\",\n logo_path=\"/Users/jobzhao/.openclaw/workspace/assets/logo.png\"\n)\n\n# 然后直接添加内容...\ndoc.add_paragraph(\"合同正文内容\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n```\n\n> **强烈建议**：使用简化函数，告别手动配置！\n\n---\n\n## 技能分工规则（格式引用 vs 文档操作）\n\n### 格式引用 → huo15-doc-template\n- 字体规范（仿宋、黑体、楷体字号）\n- 页面边距（GB/T 9704-2012 公文格式）\n- 页眉页脚（LOGO、公司名称、页码）\n- 公文格式排版\n\n### 文档操作 → office-document-specialist-suite\n- 创建/编辑 Word 文档\n- 内容填充、排版调整\n- 表格操作、段落设置\n\n### 组合使用流程\n1. 用 `office-document-specialist-suite` 处理文档内容\n2. 用 `huo15-doc-template` 处理格式规范\n3. 最终生成符合公司规范的正式文档\n\n---\n\n# 文档模板技能\n\n## 快速开始\n\n1. **字体设置**：默认使用仿宋，小四（12pt）\n2. **页面边距**：上下 3.7/3.5cm，左右 2.8/2.6cm\n3. **页眉**：LOGO + 公司名称 + 底线\n4. **页脚**：页码居中，格式\"第 X 页 共 Y 页\"，仿宋小四\n\n---\n\n## 配置规则\n\n### 字体规范\n- **默认正文**：仿宋，小四（12pt）\n- **一级标题**：黑体，小三（15pt），加粗\n- **二级标题**：楷体，小四（12pt），加粗\n- **三级标题**：仿宋，小四（12pt），加粗\n\n**WPS 字体兼容**：\n- 汉字字体：使用 `仿宋`\n- 每个 run 都要设置字体域 `w:eastAsia`\n\n---\n\n## ⚠️ 重要：Markdown 语法转换规则\n\n### 禁止直接在 Word 中使用 Markdown 语法\n\n**严禁将 Markdown 语法直接写入 Word 文档**，例如：\n- ❌ 错误：`**加粗文本**` → Word 中会显示星号\n- ❌ 错误：`| 列1 | 列2 |` → Word 中会显示管道符\n- ❌ 错误：`# 一级标题` → Word 中会显示井号\n\n### 正确转换方法\n\n#### 1. 加粗转换\n- Markdown：`**这是加粗**`\n- Word：设置 `run.bold = True`\n\n```python\n# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗\n```\n\n#### 2. 表格转换\n- Markdown：\n```\n| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |\n```\n- Word：使用 `doc.add_table()` 创建表格\n\n```python\n# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)\n```\n\n#### 3. 标题转换\n- Markdown：`# 一级标题`\n- Word：添加段落并设置样式\n\n```python\n# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)\n```\n\n### 自检清单（生成文档前必查）\n\n生成文档后，检查以下内容：\n- [ ] 文档中是否有 `**`、`__`、`#` 等 Markdown 符号？\n- [ ] 表格是否使用了 `|` 管道符？\n- [ ] 链接是否显示了 `[文字](URL)` 格式？\n- [ ] 列表是否显示了 `-` 或 `*` 前缀？\n\n**如果有任何一项为\"是\"，则文档不合格，需要重新生成**\n\n### ⚠️ 字体问题根本原因\n\n**问题**：WPS 和 Word 对字体的渲染方式不同，WPS 需要显式设置字体域才能正确识别中文字体。\n\n**解决方案**：每个 run 都必须设置以下三个属性：\n1. `run.font.name = font_name` - 设置字体名称\n2. `run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)` - 设置字体域（WPS兼容）\n3. `run.font.size = Pt(font_size)` - 设置字号\n\n### 字体设置正确示范\n\n```python\nfrom docx.oxml.ns import qn\n\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n # 1. 设置西文字体名称\n run.font.name = font_name\n # 2. 设置字体域（WPS兼容关键）\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n # 3. 设置字号\n run.font.size = Pt(font_size)\n # 4. 设置加粗\n run.bold = bold\n return run\n```\n\n### ❌ 常见错误\n\n| 错误做法 | 后果 |\n|---------|------|\n| 只设置 `run.font.name` | Word显示正确，WPS显示为宋体 |\n| 不设置 `w:eastAsia` 字体域 | WPS无法识别中文字体 |\n| 只在第一个run设置字体 | 后续文字字体丢失 |\n| 使用 `set_font()` 但没有设置字体域 | WPS显示不正确 |\n\n### ✅ 正确做法\n\n```python\n# 正确：每个run都设置字体\np = doc.add_paragraph()\nrun = p.add_run('这是正文')\nset_chinese_font(run, '仿宋', 12) # ✅ 每个run都调用\n\n# 错误：只设置一次\np = doc.add_paragraph()\nrun = p.add_run('这是正文')\nrun.font.name = '仿宋' # ❌ 缺少字体域\n```\n\n---\n\n### 完整函数模板（必须复制使用）\n\n```python\nfrom docx import Document\nfrom docx.shared import Pt, Cm\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nimport os\n\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"\n 设置中文字体，确保WPS和Word兼容\n 必须对每个run都调用此函数！\n \"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n```\n\n### 页面设置（GB/T 9704-2012 公文格式）\n- 上边距：3.7cm\n- 下边距：3.5cm\n- 左边距：2.8cm\n- 右边距：2.6cm\n- 纸张：A4\n\n### 页眉（必须包含 LOGO）\n- LOGO 路径：`/Users/jobzhao/.openclaw/workspace/assets/logo.png`\n- 内容：LOGO 图片 + 公司名称（紧挨着）\n- 字体：仿宋，小四（12pt）\n- **必须添加页眉底线**（细线）\n\n### ⚠️ 公司信息获取规则（重要）\n\n**获取顺序**：\n1. 首先从**辉火云企业套件系统**获取公司名称和 LOGO\n2. 如果获取失败，使用**本地配置文件**中的备选信息\n3. 如果配置文件也没有，使用**默认信息**\n\n**默认公司信息**：\n- 公司名称：**青岛火一五信息科技有限公司**\n- 默认 LOGO：`/Users/jobzhao/.openclaw/workspace/assets/logo.png`（从 https://tools.huo15.com/uploads/images/system/logo-colours.png 下载）\n\n**公司信息配置位置**：`/Users/jobzhao/.openclaw/workspace/config/company_info.json`\n\n```json\n{\n \"company_name\": \"青岛火一五信息科技有限公司\",\n \"logo_path\": \"/Users/jobzhao/.openclaw/workspace/assets/logo.png\",\n \"logo_url\": \"https://huihuoyun.huo15.com/web/image/website/1/logo\",\n \"fallback_logo_url\": \"https://tools.huo15.com/uploads/images/system/logo-colours.png\"\n}\n```\n\n**页眉代码示例（动态获取公司信息）**：\n\n```python\nfrom docx.shared import Pt, Cm\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nimport os\nimport json\nimport urllib.request\n\n# 公司信息配置\nCOMPANY_CONFIG_PATH = '/Users/jobzhao/.openclaw/workspace/config/company_info.json'\nDEFAULT_LOGO_PATH = '/Users/jobzhao/.openclaw/workspace/assets/logo.png'\n\n# 默认公司信息（当无法获取时使用）\nDEFAULT_COMPANY_NAME = '青岛火一五信息科技有限公司'\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_LOGO_URL = 'https://huihuoyun.huo15.com/web/image/website/1/logo'\n\ndef get_company_info():\n \"\"\"\n 获取公司信息，优先从本地配置或远程获取\n 返回: (company_name, logo_path)\n \"\"\"\n company_name = DEFAULT_COMPANY_NAME\n logo_path = DEFAULT_LOGO_PATH\n \n # 1. 尝试从本地配置文件读取\n config_dir = os.path.dirname(COMPANY_CONFIG_PATH)\n if os.path.exists(COMPANY_CONFIG_PATH):\n try:\n with open(COMPANY_CONFIG_PATH, 'r', encoding='utf-8') as f:\n config = json.load(f)\n company_name = config.get('company_name', DEFAULT_COMPANY_NAME)\n logo_path = config.get('logo_path', DEFAULT_LOGO_PATH)\n return company_name, logo_path\n except Exception:\n pass\n \n # 2. 检查本地 LOGO 是否存在\n if os.path.exists(logo_path):\n return company_name, logo_path\n \n # 3. 尝试下载公司 LOGO\n os.makedirs(os.path.dirname(logo_path), exist_ok=True)\n \n # 优先尝试公司系统 LOGO\n for url in [COMPANY_LOGO_URL, FALLBACK_LOGO_URL]:\n try:\n urllib.request.urlretrieve(url, logo_path)\n if os.path.exists(logo_path) and os.path.getsize(logo_path) > 0:\n break\n except Exception:\n continue\n \n return company_name, logo_path\n\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉，包含 LOGO 图片 + 公司名称 + 底线\"\"\"\n # 获取公司信息\n if logo_path is None or company_name is None:\n company_name, logo_path = get_company_info()\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n \n # 设置页眉高度\n section.header_distance = Cm(1.5)\n \n # 添加段落（左对齐）\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n # 1. 添加 LOGO 图片（如果存在）\n if os.path.exists(logo_path):\n try:\n # 添加图片，高度 1cm，宽度自动\n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n except Exception as e:\n # 如果图片加载失败，继续添加文字\n pass\n \n # 2. 添加公司名称（紧挨着 LOGO）\n run = paragraph.add_run(f' {company_name}')\n set_font(run, '黑体', 10)\n \n # 3. 添加页眉底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bottom)\n pPr.append(pBdr)\n paragraph._element.insert(0, pPr)\n \n return header\n```\n\n**重要提醒（强制执行）**：\n- 生成文档时**必须调用** `add_header_with_logo(doc)` 函数\n- LOGO 图片路径：`/Users/jobzhao/.openclaw/workspace/assets/logo.png`\n- 如果图片不存在，**自动从公司系统下载**，或使用备用 LOGO\n- 公司名称与 LOGO 之间保留一个空格，紧挨着显示\n- **公司信息会自动从辉火云企业套件系统获取**，无需手动配置\n\n**LOGO 添加检查清单（每次生成文档前必须自检）**：\n- [ ] LOGO 图片文件是否存在于 `/Users/jobzhao/.openclaw/workspace/assets/logo.png`\n- [ ] 代码中是否调用了 `add_picture()` 方法添加 LOGO\n- [ ] 页眉中是否包含 LOGO + 公司名称 + 底线 三个元素\n- [ ] 是否设置了页眉底线（`w:bottom` 边框）\n\n**常见错误及解决方案**：\n\n| 错误 | 原因 | 解决方案 |\n|------|------|----------|\n| 文档没有 LOGO | 代码中缺少 `add_picture()` 调用 | 必须调用 `run.add_picture(logo_path, height=Cm(1.0))` |\n| LOGO 路径错误 | 图片路径写错或文件不存在 | 使用绝对路径，生成前检查 `os.path.exists(logo_path)` |\n| LOGO 太大/太小 | 高度设置不合理 | 使用 `height=Cm(1.0)` 标准高度 |\n| LOGO 和文字分开 | 没有在同一 paragraph 中添加 | LOGO 和公司名称必须在同一个 paragraph 中 |\n\n**完整调用示例**：\n\n```python\nfrom docx import Document\nfrom docx.shared import Cm\nimport os\n\n# 创建文档\ndoc = Document()\n\n# 1. 设置页面格式\nfor section in doc.sections:\n section.top_margin = Cm(3.7)\n section.bottom_margin = Cm(3.5)\n section.left_margin = Cm(2.8)\n section.right_margin = Cm(2.6)\n\n# 2. 添加页眉（必须包含 LOGO）\nlogo_path = '/Users/jobzhao/.openclaw/workspace/assets/logo.png'\n\n# 检查 LOGO 是否存在\nif not os.path.exists(logo_path):\n raise FileNotFoundError(f\"LOGO 图片不存在：{logo_path}\")\n\nsection = doc.sections[0]\nheader = section.header\nheader.paragraphs.clear()\nsection.header_distance = Cm(1.5)\n\nparagraph = header.add_paragraph()\nparagraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n\n# 添加 LOGO\nrun = paragraph.add_run()\nrun.add_picture(logo_path, height=Cm(1.0))\n\n# 添加公司名称\nrun = paragraph.add_run(' 青岛火一五信息科技有限公司')\nset_font(run, '黑体', 10)\n\n# 添加底线\n# ...（参考上方完整代码）\n\n# 3. 继续添加文档内容\n# ...\n```\n\n### 页脚（GB/T 9704-2012 公文格式）\n- **内容**：页码（如\"第 1 页 共 3 页\"）\n- **位置**：页面下边缘居中\n- **字体**：仿宋，小四（12pt）\n- **WPS 兼容格式**：\n - 使用 `w:eastAsia` 字体域确保 WPS 识别\n - 数字同样使用仿宋字体\n- **示例**：`第 1 页 共 3 页`\n\n### 页脚代码示例（WPS 兼容）\n\n```python\nfrom docx.shared import Pt, Cm\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\n\ndef add_footer_with_page_numbers(doc):\n \"\"\"添加页脚，包含当前页和总页数，WPS 兼容\"\"\"\n section = doc.sections[0]\n \n # 设置页脚距离页面底部边距\n section.footer_distance = Cm(1.5)\n \n # 获取或创建页脚\n footer = section.footer\n \n # 添加段落（居中）\n paragraph = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n \n # 添加\"第\"字\n run1 = paragraph.add_run(\"第\")\n run1.font.name = '仿宋'\n run1._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run1.font.size = Pt(12)\n \n # 插入当前页码域（PAGE）\n run2 = paragraph.add_run()\n fldChar1 = OxmlElement('w:fldChar')\n fldChar1.set(qn('w:fldCharType'), 'begin')\n instrText1 = OxmlElement('w:instrText')\n instrText1.text = 'PAGE'\n fldChar2 = OxmlElement('w:fldChar')\n fldChar2.set(qn('w:fldCharType'), 'end')\n run2._element.append(fldChar1)\n run2._element.append(instrText1)\n run2._element.append(fldChar2)\n run2.font.name = '仿宋'\n run2._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run2.font.size = Pt(12)\n \n # 添加\"页 共\"文字\n run3 = paragraph.add_run(\"页 共\")\n run3.font.name = '仿宋'\n run3._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run3.font.size = Pt(12)\n \n # 插入总页数域（NUMPAGES）\n run4 = paragraph.add_run()\n fldChar3 = OxmlElement('w:fldChar')\n fldChar3.set(qn('w:fldCharType'), 'begin')\n instrText2 = OxmlElement('w:instrText')\n instrText2.text = 'NUMPAGES'\n fldChar4 = OxmlElement('w:fldChar')\n fldChar4.set(qn('w:fldCharType'), 'end')\n run4._element.append(fldChar3)\n run4._element.append(instrText2)\n run4._element.append(fldChar4)\n run4.font.name = '仿宋'\n run4._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run4.font.size = Pt(12)\n \n # 添加\"页\"字\n run5 = paragraph.add_run(\"页\")\n run5.font.name = '仿宋'\n run5._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')\n run5.font.size = Pt(12)\n```\n\n---\n\n## 📁 文档命名规则（必须遵循）\n\n### 命名格式\n\n```\n[文档类型]_[客户名称]_[项目名称]_[日期]_[版本].docx\n```\n\n### 命名元素说明\n\n| 元素 | 说明 | 示例 | 必填 |\n|------|------|------|------|\n| 文档类型 | 具体文档类型 | 合同、报价单、发货单、会议纪要、技术方案 | ✅ |\n| 客户名称 | 客户公司简称 | 阿里、腾讯、华为、海尔 | ✅ |\n| 项目名称 | 项目名称（可选） | ERP、MES、WMS、OA | ○ |\n| 日期 | 文档日期，格式 YYYYMMDD | 20250319 | ✅ |\n| 版本 | 版本号 v1.0（可选，默认 v1.0） | v1.0、v1.1、v2.0 | ○ |\n\n### 文档类型编码\n\n| 文档类型 | 编码 | 说明 |\n|----------|------|------|\n| 合同 | CONTRACT | 销售合同、服务合同 |\n| 报价单 | QUOTE | 产品报价、项目报价 |\n| 发货单 | DELIVERY | 发货清单、送货单 |\n| 会议纪要 | MEMO | 会议记录、洽谈纪要 |\n| 技术方案 | PROPOSAL | 解决方案、技术方案 |\n| 功能说明书 | SPEC | 产品功能说明、需求规格 |\n| 验收报告 | ACCEPTANCE | 项目验收、交付验收 |\n| 发票 | INVOICE | 增值税发票、普通发票 |\n\n### 命名示例\n\n```\n# 完整格式\nCONTRACT_阿里_钉钉OA_20250319_v1.0.docx\nQUOTE_腾讯_云ERP_20250318.docx\nDELIVERY_海尔_WMS_20250317_v1.0.docx\nMEMO_华为_技术洽谈_20250316.docx\nPROPOSAL_海信_MES系统_20250315_v2.0.docx\n\n# 无项目名称\nCONTRACT_京东_20250319.docx\nQUOTE_字节跳动_20250318.docx\n\n# 有版本迭代\nCONTRACT_小米_智能制造_20250319_v1.1.docx\nSPEC_美团_外卖系统_20250314_v1.2.docx\n```\n\n### ⚠️ 命名规则\n\n1. **使用下划线 `_` 分隔各元素**（不要用空格或连字符）\n2. **客户名称使用中文简称**，去除\"有限公司\"、\"股份有限公司\"等后缀\n3. **日期必须为 8 位数字**（YYYYMMDD）\n4. **版本号格式为 vX.X**（如 v1.0、v2.1）\n5. **禁止出现特殊字符**：`\\/:*?\"<>|`\n6. **文件后缀必须为 .docx**\n\n### 自动命名函数\n\n```python\nimport datetime\n\ndef generate_doc_name(doc_type, customer_name, project_name=\"\", version=\"v1.0\"):\n \"\"\"\n 生成符合规范的文档名称\n \n 参数:\n doc_type: 文档类型编码（如 CONTRACT, QUOTE）\n customer_name: 客户名称\n project_name: 项目名称（可选）\n version: 版本号（可选，默认 v1.0）\n \n 返回:\n 文档名称字符串，如 CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n \"\"\"\n # 日期\n date_str = datetime.datetime.now().strftime(\"%Y%m%d\")\n \n # 清理客户名称（去除公司后缀）\n customer = customer_name.replace(\"有限公司\", \"\").replace(\"股份有限公司\", \"\").replace(\"集团\", \"\").strip()\n \n # 清理项目名称\n project = project_name.strip() if project_name else \"\"\n \n # 构建名称\n parts = [doc_type, customer]\n if project:\n parts.append(project)\n parts.append(date_str)\n \n # 添加版本（如果不是默认版本）\n if version and version != \"v1.0\":\n parts.append(version)\n \n # 拼接并添加后缀\n doc_name = \"_\".join(parts) + \".docx\"\n \n return doc_name\n\n# 使用示例\n# generate_doc_name(\"CONTRACT\", \"阿里巴巴有限公司\", \"钉钉OA\", \"v1.0\")\n# -> CONTRACT_阿里_钉钉OA_20250319_v1.0.docx\n\n# generate_doc_name(\"QUOTE\", \"腾讯科技有限公司\")\n# -> QUOTE_腾讯_20250319.docx\n```\n\n### 检查清单（生成文档前必查）\n\n- [ ] 文档名称是否包含文档类型？\n- [ ] 客户名称是否为简称（去除有限公司等）？\n- [ ] 日期是否为 8 位数字格式？\n- [ ] 版本号格式是否正确（vX.X）？\n- [ ] 是否使用了下划线分隔？\n- [ ] 是否包含了 .docx 后缀？\n- [ ] 是否有禁止的特殊字符？\n\n---\n\n## 🚀 简化函数：一条命令完成文档格式\n\n```python\nfrom docx import Document\nfrom docx.shared import Pt, Cm\nfrom docx.enum.text import WD_ALIGN_PARAGRAPH\nfrom docx.oxml.ns import qn\nfrom docx.oxml import OxmlElement\nimport os\nimport urllib.request\nimport json\n\n# ============== 配置区域 ==============\nDEFAULT_LOGO_PATH = '/Users/jobzhao/.openclaw/workspace/assets/logo.png'\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_NAME = '青岛火一五信息科技有限公司'\n\ndef ensure_logo_exists(logo_path=DEFAULT_LOGO_PATH):\n \"\"\"确保 LOGO 存在，不存在则自动下载\"\"\"\n if os.path.exists(logo_path) and os.path.getsize(logo_path) > 0:\n return logo_path\n \n os.makedirs(os.path.dirname(logo_path), exist_ok=True)\n try:\n urllib.request.urlretrieve(FALLBACK_LOGO_URL, logo_path)\n print(f\"✓ LOGO 已下载: {logo_path}\")\n except Exception as e:\n raise FileNotFoundError(f\"❌ LOGO 下载失败: {e}\\n请手动下载 LOGO 放到: {logo_path}\")\n \n return logo_path\n\ndef set_chinese_font(run, font_name='仿宋', font_size=12, bold=False):\n \"\"\"设置中文字体（WPS/Word兼容）\"\"\"\n run.font.name = font_name\n run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)\n run.font.size = Pt(font_size)\n run.bold = bold\n return run\n\ndef add_header_with_logo(doc, logo_path=None, company_name=None):\n \"\"\"添加页眉：LOGO + 公司名称 + 底线\"\"\"\n logo_path = logo_path or DEFAULT_LOGO_PATH\n company_name = company_name or COMPANY_NAME\n \n # 确保 LOGO 存在\n logo_path = ensure_logo_exists(logo_path)\n \n section = doc.sections[0]\n header = section.header\n header.paragraphs.clear()\n section.header_distance = Cm(1.5)\n \n # 添加 LOGO + 公司名称\n paragraph = header.add_paragraph()\n paragraph.alignment = WD_ALIGN_PARAGRAPH.LEFT\n \n run = paragraph.add_run()\n run.add_picture(logo_path, height=Cm(1.0))\n \n run = paragraph.add_run(f' {company_name}')\n set_chinese_font(run, '黑体', 10)\n \n # 添加底线\n pPr = OxmlElement('w:pPr')\n pBdr = OxmlElement('w:pBdr')\n bottom = OxmlElement('w:bottom')\n bottom.set(qn('w:val'), 'single')\n bottom.set(qn('w:sz'), '6')\n bottom.set(qn('w:space'), '1')\n bottom.set(qn('w:color'), '000000')\n pBdr.append(bott\n\nArchive v1.1.0: 2 files, 9315 bytes\n\nFiles: _meta.json (137b), SKILL.md (29312b)\n\nArchive v1.0.9: 2 files, 8018 bytes\n\nFiles: _meta.json (137b), SKILL.md (22460b)","readmeExcerpt":"Skill: huo15-doc-template / 火一五文档模板 Owner: jobzhao15 Summary: 【版权：青岛火一五信息科技有限公司 账号：huo15】Word/文档生成首选技能。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、... Tags: doc:1.3.4, document:1.0.4, huo15:1.3.4, latest:1.4.0, template:1.3.4, word:1.3.4 Version history: v1.4.0 | 2026-04-01T03:11:34.675Z | user 修复 YAML frontmatter 格式错误导致技能无法加载的问题：去掉 description 中","codeSnippets":[],"executableExamples":[{"language":"python","snippet":"# 一步创建符合公司规范的文档\ndoc = create_formatted_doc(\n title=\"销售合同\",\n company_name=\"青岛火一五信息科技有限公司\",\n insert_vision=True # 可选：插入公司愿景理念\n)\ndoc.add_paragraph(\"合同正文内容...\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")"},{"language":"python","snippet":"# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗"},{"language":"text","snippet":"| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |"},{"language":"python","snippet":"# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)"},{"language":"python","snippet":"# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)"},{"language":"python","snippet":"import ssl\nimport json\nimport os\nimport urllib.request\nimport xmlrpc.client\n\n# ============== 公司信息配置 ==============\nUSER_HOME = os.path.expanduser(\"~\")\nLOGO_DIR = os.path.join(USER_HOME, \".huo15\", \"assets\")\nDEFAULT_LOGO_PATH = os.path.join(LOGO_DIR, \"logo.png\")\n\n# 备用 LOGO URL\nFALLBACK_LOGO_URL = 'https://tools.huo15.com/uploads/images/system/logo-colours.png'\nCOMPANY_LOGO_URL = 'https://huihuoyun.huo15.com/web/image/website/1/logo'\n\ndef get_company_info_from_system():\n \"\"\"\n 从公司系统(Odoo)获取公司信息\n 返回: dict {\n 'company_name': str,\n 'logo_path': str,\n 'vision': str, # 公司愿景\n 'philosophy': str, # 公司理念\n 'slogan': str # slogan\n }\n \"\"\"\n company_info = {\n 'company_name': '青岛火一五信息科技有限公司',\n 'vision': '推动B端用户向全场景人工智能机器人转变',\n 'philosophy': '打破信息孤岛，用一套系统驱动企业增长',\n 'slogan': '',\n 'logo_path': None\n }\n \n # 1. 尝试从公司系统获取\n try:\n # 读取 Odoo 配置\n agent_id = os.environ.get('OC_AGENT_ID', 'main')\n agents_dir = os.path.expanduser('~/.openclaw/agents')\n creds_file = os.path.join(agents_dir, agent_id, 'odoo_creds.json')\n \n if os.path.exists(creds_file):\n with open(creds_file, 'r') as f:\n creds = json.load(f)\n \n # 获取全局配置\n openclaw_cfg_file = os.path.expanduser('~/.openclaw/openclaw.json')\n if os.path.exists(openclaw_cfg_file):\n with open(openclaw_cfg_file, 'r') as f:\n cfg = json.load(f)\n odoo_env = cfg.get('skills', {}).get('entries', {}).get('huo15-odoo', {}).get('env', {})\n url = odoo_env.get('ODOO_URL', 'https://huihuoyun.huo15.com')\n db = odoo_env.get('ODOO_DB', 'huo15_prod')\n user = creds.get('user', '')\n password = creds.get('password', '')\n \n if user and password:\n # 连接 Odoo\n ctx = ssl."}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: huo15-doc-template / 火一五文档模板\ndescription: 【版权：青岛火一五信息科技有限公司 账号：huo15】Word/文档生成首选技能。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、合同模板、报价单模板、文档模板、公司文档、正式文档、公文、标书、方案文档、年度报告、通知、请示、报告、函。所有 Word 文档、.docx 文件、公文、合同、报价单、说明书、会议纪要、发货单、PDA 单据等文档生成任务自动使用本技能。\n---\n\n## 重要：此为首选文档技能\n所有 Word 文档生成任务都必须使用此技能\n\n\n## ⚠️ 强制检查清单（生成文档前必须完成）\n\n> **新用户必读！每次生成文档前对照检查，否则文档不合格！**\n\n- [ ] **LOGO 是否添加？** —— 页眉必须有 LOGO + 公司名称 + 底线\n- [ ] **页码是否添加？** —— 页脚必须有\"第 X 页 共 Y 页\"\n- [ ] **字体是否正确？** —— 正文仿宋，标题黑体/楷体\n- [ ] **页面边距是否正确？** —— 上下 3.7/3.5cm，左右 2.8/2.6cm\n- [ ] **命名是否规范？** —— 文档类型_客户名称_日期.docx\n\n**如果没有完成以上检查，文档不允许交付！**\n\n---\n\n## 🚀 快速开始\n\n> **重要**：代码模板直接写在 SKILL.md 中，复制使用即可！无需 pip install！\n\n```python\n# 一步创建符合公司规范的文档\ndoc = create_formatted_doc(\n title=\"销售合同\",\n company_name=\"青岛火一五信息科技有限公司\",\n insert_vision=True # 可选：插入公司愿景理念\n)\ndoc.add_paragraph(\"合同正文内容...\")\ndoc.save(\"CONTRACT_客户名_20250319.docx\")\n```\n\n> **LOGO/公司信息会自动从公司系统获取**，无需手动配置！\n\n---\n\n# 文档模板技能\n\n## 快速开始\n\n1. **字体设置**：默认使用仿宋，小四（12pt）\n2. **页面边距**：上下 3.7/3.5cm，左右 2.8/2.6cm\n3. **页眉**：LOGO + 公司名称 + 底线\n4. **页脚**：页码居中，格式\"第 X 页 共 Y 页\"，仿宋小四\n\n---\n\n## 配置规则\n\n### 字体规范\n- **默认正文**：仿宋，小四（12pt）\n- **一级标题**：黑体，小三（15pt），加粗\n- **二级标题**：楷体，小四（12pt），加粗\n- **三级标题**：仿宋，小四（12pt），加粗\n\n**WPS 字体兼容**：\n- 汉字字体：使用 `仿宋`\n- 每个 run 都要设置字体域 `w:eastAsia`\n\n---\n\n## ⚠️ 重要：Markdown 语法转换规则\n\n### 禁止直接在 Word 中使用 Markdown 语法\n\n**严禁将 Markdown 语法直接写入 Word 文档**，例如：\n- ❌ 错误：`**加粗文本**` → Word 中会显示星号\n- ❌ 错误：`| 列1 | 列2 |` → Word 中会显示管道符\n- ❌ 错误：`# 一级标题` → Word 中会显示井号\n\n### 正确转换方法\n\n#### 1. 加粗转换\n- Markdown：`**这是加粗**`\n- Word：设置 `run.bold = True`\n\n```python\n# 错误示例（不要这样写！）\np = doc.add_paragraph(\"**这是加粗**\") # ❌ 会显示星号\n\n# 正确示例\np = doc.add_paragraph(\"这是加粗\")\np.runs[0].bold = True # ✅ 真正加粗\n```\n\n#### 2. 表格转换\n- Markdown：\n```\n| 列1 | 列2 | 列3 |\n|------|------|------|\n| 内容 | 内容 | 内容 |\n```\n- Word：使用 `doc.add_table()` 创建表格\n\n```python\n# 正确示例\ntable = doc.add_table(rows=2, cols=3)\ntable.style = 'Table Grid'\n\n# 设置表头\nheader_cells = table.rows[0].cells\nheader_cells[0].text = \"列1\"\nheader_cells[1].text = \"列2\"\nheader_cells[2].text = \"列3\"\n\n# 设置表头样式\nfor cell in header_cells:\n for paragraph in cell.paragraphs:\n paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER\n for run in paragraph.runs:\n run.bold = True\n run.font.name = '黑体'\n run.font.size = Pt(12)\n```\n\n#### 3. 标题转换\n- Markdown：`# 一级标题`\n- Word：添加段落并设置样式\n\n```python\n# 正确示例\np = doc.add_paragraph(\"一级标题\")\np.runs[0].bold = True\np.runs[0].font.name = '黑体'\np.runs[0].font.size = Pt(15)\n```\n\n### 自检清单（生成文档前必查）\n\n生成文档后，检查以下内容：\n- [ ] 文档中是否有 `**`、`__`、`#` 等 Markdown 符号？\n- [ ] 表格是否使用了 `|` 管道符？\n- [ ] 链接是否显示了 `[文字](URL)` 格式？\n- [ ] 列表是否显示了 `-` 或 `*` 前缀？\n\n**如果有任何一项为\"是\"，则文档不合格，需要重新生成**\n\n---\n\n## 🚀 核心函数（必须使用）\n\n### 公司信息获取函数\n\n```python\nimport ssl\nimport json\nimport os\nimport urllib.request\nimport xmlrpc.client\n\n# ============== 公司信息配置 ==============\nUSER_HOME = os.path.expanduser(\"~\")\nLOGO_DIR = os.path.join(USER_HOME, \".huo15\", \"assets\")\nDEFAULT_LOGO_PATH = os.path."},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7b0rmtgvbq55rc54rhp69r79822ym9\",\n \"slug\": \"huo15-doc-template\",\n \"version\": \"1.4.0\",\n \"publishedAt\": 1775013094675\n}"},{"path":"skill-card.md","content":"## Description:\n\nProvides Chinese Word document template guidance and Python snippets for generating Huo15-branded .docx documents with prescribed fonts, margins, headers, footers, page numbers, and naming conventions.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[jobzhao15](https://clawhub.ai/user/jobzhao15)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and business users use this skill to create formal Chinese Word documents such as contracts, quotes, meeting minutes, reports, notices, and specification documents with consistent company formatting.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can automatically use local Odoo credentials while generating documents.\n\nMitigation: Install only where Huo15-branded Chinese documents are intended and require explicit user approval before credential-backed company-system access.\n\nRisk: The embedded Odoo retrieval code disables TLS certificate verification.\n\nMitigation: Restore TLS verification before using the retrieval code and constrain access to approved endpoints.\n\nRisk: Company identity details and logo assets may be pulled from external Huo15 endpoints.\n\nMitigation: Confirm the endpoint scope and data handling expectations before enabling automatic company-system retrieval.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/jobzhao15/skills/huo15-doc-template)\n- [Huo15 company system](https://huihuoyun.huo15.com)\n- [Huo15 website logo endpoint](https://huihuoyun.huo15.com/web/image/website/1/logo)\n- [Huo15 fallback logo asset](https://tools.huo15.com/uploads/images/system/logo-colours.png)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, configuration, guidance, files]\n\n**Output Format:** [Markdown guidance with Python code snippets and generated .docx files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses Chinese Word/WPS formatting conventions and may retrieve company logo and profile information from configured Huo15 Odoo services.]\n\n## Skill Version(s):\n\n1.4.0 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"【版权：青岛火一五信息科技有限公司 账号：huo15】Word/文档生成首选技能。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、... Skill: huo15-doc-template / 火一五文档模板 Owner: jobzhao15 Summary: 【版权：青岛火一五信息科技有限公司 账号：huo15】Word/文档生成首选技能。触发词：写word、写文档、写个文档、重新写、重新生成、生成word、生成文档、创建word、创建文档、导出word、导出文档、下载word、下载文档、.docx、word文档、Word文档、写合同、写报价单、写说明书、写会议纪要、... Tags: doc:1.3.4, document:1.0.4, huo15:1.3.4, latest:1.4.0, template:1.3.4, word:1.3.4 Version history: v1.4.0 | 2026-04-01T03:11:34.675Z | user 修复 YAML frontmatter 格式错误导致技能无法加载的问题：去掉 description 中","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":779,"uniquenessScore":56,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T11:59:24.755Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T11:59:24.755Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T15:20:43.215Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}