{"id":"0dfd25e1-af62-432d-954c-8c849b5f5ad0","entityType":"agent","slug":"clawhub-fyniujin-wps-office-suite","name":"wps-office-suite","canonicalUrl":"https://www.xpersona.co/agent/clawhub-fyniujin-wps-office-suite","canonicalPath":"/agent/clawhub-fyniujin-wps-office-suite","generatedAt":"2026-10-10T03:33:50.107Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T16:12:36.348Z","emptyReason":null},"description":"WPS Office 全家桶 - 四引擎（WPS/MS Office/LibreOffice/纯Python）智能识别用户已安装软件，纯Python模式支持排序/筛选/图表/公式/统计，含文档模板（代码生成）、最佳实践案例、故障排除大章（20+避坑+15 FAQ+15错误ID 统一索引）、自动重试、硬件自适应、环境自检、Skill更新提醒；v5.1新增：kingdoc云端桥接（白名单探测+配置预检+subprocess上传+差异检查）、条件格式/数据验证跨引擎IO（JSON中间格式保真往返）、会议纪要三段式要素化（待办清单+决策记录+风险异议）+说话人标注（MFCC聚类）；v5.2新增：公文一键排版（GB/T 9704 规则库约束+结构识别套版+红头预留位+联合行文）、批量水印与敏感信息打码（身份证/手机号/银行卡/邮箱双轨识别+黑色矩形覆盖+打码清单）、跨文档知识检索与问答（本地TF-IDF零依赖+跳转+可选zwjh记忆桥接）；删除：与contract-review重复的轻量合同审查模块，改为文档互链引导；v5.2.5修复：MS Office引擎下Excel/PPT创建必然失败（错用Word COM对象），新增get_ms_excel/get_ms_ppt及三槽位统一释放release_ms，MS Office路径透传filepath参数;v5.3.0新增：统一CLI入口 wps（registry.json注册表分发，office --app/--action 与 convert 子命令、--list 一屏列出全部命令，薄路由层不改脚本内部逻辑）、全命令 --json 机器可读输出（固定 ok/error_id/elapsed/data 四字段，对齐 E001-E015，wps_error.py 新增 emit_json 统一出口）、_worker 启动优化（wps_pure 改惰性加载，pywin32/python-docx/openpyxl 经核查已惰性导入，ENGINE_CACHE 进程级单例复用，COM 释放统一走 release_ms 三槽位）、转换三入口合并为 convert（format_converter/md_converter/wps_docx_to_ppt 内部按目标格式路由，旧脚本保留为兼容别名并提示新命令，v6.0.0 移除）","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.3K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s177r8w7p1d7cpbys9bn33kwhs89d0xw:wps-office-suite","sourceUrl":"https://clawhub.ai/fyniujin/wps-office-suite","homepage":"https://clawhub.ai/fyniujin/skills/wps-office-suite","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/fyniujin/wps-office-suite","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/fyniujin/skills/wps-office-suite","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":67,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"wps-office-suite technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T16:12:36.348Z","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-09T16:12:36.348Z","emptyReason":null},"stars":null,"forks":null,"downloads":2338,"packageName":null,"latestVersion":"5.3.0","tractionLabel":"2.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T16:12:36.347Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T16:12:36.348Z","lastCrawledAt":"2026-10-09T16:12:36.347Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T16:12:36.348Z","lastVerifiedAt":null,"highlights":[{"version":"5.3.0","createdAt":"2026-10-09T02:37:37.090Z","changelog":"- added 2, updated 6, removed 1 file(s). - Updated SKILL.md and bundle contents.","fileCount":58,"zipByteSize":266588},{"version":"5.2.5","createdAt":"2026-09-22T06:37:06.538Z","changelog":"**修复 MS Office Excel/PPT 创建失败，增强 MS Office 兼容性** - 修复：MS Office引擎下创建Excel/PPT时误用Word COM对象导致失败的问题。 - 新增：增加 get_ms_excel、get_ms_ppt 初始化函数，确保分别调用正确的 COM 对象。 - 优化：实现 release_ms，统一释放MS Office三大对象，避免资源泄露。 - 路径透传：MS Office相关操作支持直接传入filepath参数。 - 文档：移除 skill-card.md，更新使用说明与修复内容。","fileCount":56,"zipByteSize":264431},{"version":"5.2.0","createdAt":"2026-09-19T02:10:04.598Z","changelog":"WPS Office Suite v5.2.0 - 新增公文一键排版：支持GB/T 9704标准结构，自动红头/联合行文模板，内置规则库，处理前自动备份 - 新增批量水印与打码：支持目录批量文字/图片水印，身份证、手机号、银行卡、邮箱敏感信息双轨识别+打码清单 - 新增跨文档知识检索与问答：本地TF-IDF零依赖索引，跨文档内容检索和跳转，支持嵌入式记忆桥接 - 提升会议纪要：支持三要素结构化输出和说话人聚类 - 删除轻量合同审查模块，合并为互链指引（详见contract-review） - 新增/重构脚本，包括条件格式/数据验证IO、公文格式、文档搜索、水印、打码等功能模块","fileCount":56,"zipByteSize":263759},{"version":"5.0.0","createdAt":"2026-09-01T08:56:23.050Z","changelog":"v5.0.0 发布","fileCount":55,"zipByteSize":315344},{"version":"4.9.0","createdAt":"2026-08-24T07:44:53.331Z","changelog":"WPS Office Suite v4.9.0 is a major upgrade with new AI, template, and formula features. - 新增 wps ai --action 统一 9 大 AI 能力，包括续写、改写、扩写等操作 - 增加 llm_bridge 桥接层，支持多模型白名单探测，零配置调用 - 内置模板市场，集成超50套公文/合同/简历/报告等模板，支持用户分享 - NL2Formula 支持歧义澄清与多轮反向校验，使公式生成更可靠 - 结构优化：移除 skill-card.md，增加 clarify.py、llm_bridge.py、template_manager.py 等组件 - 其它细节和稳定性优化","fileCount":44,"zipByteSize":198164},{"version":"4.8.0","createdAt":"2026-08-22T12:57:26.494Z","changelog":"WPS Office Suite v4.8.0 - 新增邮件智能回复（模板匹配 + LLM 个性化、本地多模型降级）。 - 新增周报/月报自动生成，支持结构化报告及可选 LLM 润色。 - 纯Python模式增强，支持条件格式、数据验证、合并单元格、命名区域等。 - 增加 AI 功能统一入口：`wps ai --action`，整合6大 AI 能力。 - 代码结构优化，新增邮件/报表/AI等脚本。 - 删除 skill-card.md，调整和补充 SKILL.md 文档内容。","fileCount":40,"zipByteSize":177069},{"version":"4.7.0","createdAt":"2026-08-19T15:59:05.699Z","changelog":"WPS Office Suite v4.7.0 - 新增 Excel 公式解释器，支持 Excel 公式转自然语言（反向 NL2Formula，纯本地实现） - 新增 Markdown 转 Word / PPT 工具，支持 MD → Word/PPT，自动保留标题层级 - 长文档排版入口统一（long-document --action，8个命令合并） - 长文档排版性能优化：分批处理、单次保存、进度回调 - 增加 scripts/formula_explainer.py、scripts/md_converter.py 等新模块 - skill-card.md 文件移除","fileCount":36,"zipByteSize":149443},{"version":"4.6.1","createdAt":"2026-08-16T11:18:01.120Z","changelog":"- Improved: Enhanced document translation features for better multi-format support (Word/Excel/PPT). - Updated: Refined meeting minutes and document translator scripts for reliability. - Maintenance: Updated dependencies in requirements.txt. - Cleanup: Removed outdated skill-card.md file.","fileCount":34,"zipByteSize":138629}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s177r8w7p1d7cpbys9bn33kwhs89d0xw:wps-office-suite","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s177r8w7p1d7cpbys9bn33kwhs89d0xw:wps-office-suite` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/fyniujin/wps-office-suite before using production credentials."],"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-fyniujin-wps-office-suite/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wps-office-suite/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wps-office-suite/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wps-office-suite/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wps-office-suite/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wps-office-suite/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-10T03:33:50.104Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wps-office-suite/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wps-office-suite/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wps-office-suite/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wps-office-suite/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":"medium","updatedAt":"2026-10-09T16:12:36.348Z","emptyReason":null},"readme":"Skill: wps-office-suite\n\nOwner: fyniujin\n\nSummary: WPS Office 全家桶 - 四引擎（WPS/MS Office/LibreOffice/纯Python）智能识别用户已安装软件，纯Python模式支持排序/筛选/图表/公式/统计，含文档模板（代码生成）、最佳实践案例、故障排除大章（20+避坑+15 FAQ+15错误ID 统一索引）、自动重试、硬件自适应、环境自检、Skill更新提醒；v5.1新增：kingdoc云端桥接（白名单探测+配置预检+subprocess上传+差异检查）、条件格式/数据验证跨引擎IO（JSON中间格式保真往返）、会议纪要三段式要素化（待办清单+决策记录+风险异议）+说话人标注（MFCC聚类）；v5.2新增：公文一键排版（GB/T 9704 规则库约束+结构识别套版+红头预留位+联合行文）、批量水印与敏感信息打码（身份证/手机号/银行卡/邮箱双轨识别+黑色矩形覆盖+打码清单）、跨文档知识检索与问答（本地TF-IDF零依赖+跳转+可选zwjh记忆桥接）；删除：与contract-review重复的轻量合同审查模块，改为文档互链引导；v5.2.5修复：MS Office引擎下Excel/PPT创建必然失败（错用Word COM对象），新增get_ms_excel/get_ms_ppt及三槽位统一释放release_ms，MS Office路径透传filepath参数;v5.3.0新增：统一CLI入口 wps（registry.json注册表分发，office --app/--action 与 convert 子命令、--list 一屏列出全部命令，薄路由层不改脚本内部逻辑）、全命令 --json 机器可读输出（固定 ok/error_id/elapsed/data 四字段，对齐 E001-E015，wps_error.py 新增 emit_json 统一出口）、_worker 启动优化（wps_pure 改惰性加载，pywin32/python-docx/openpyxl 经核查已惰性导入，ENGINE_CACHE 进程级单例复用，COM 释放统一走 release_ms 三槽位）、转换三入口合并为 convert（format_converter/md_converter/wps_docx_to_ppt 内部按目标格式路由，旧脚本保留为兼容别名并提示新命令，v6.0.0 移除）\n\nTags: latest:5.3.0\n\nVersion history:\n\nv5.3.0 | 2026-10-09T02:37:37.090Z | auto\n\n- added 2, updated 6, removed 1 file(s).\n- Updated SKILL.md and bundle contents.\n\nv5.2.5 | 2026-09-22T06:37:06.538Z | auto\n\n**修复 MS Office Excel/PPT 创建失败，增强 MS Office 兼容性**\n\n- 修复：MS Office引擎下创建Excel/PPT时误用Word COM对象导致失败的问题。\n- 新增：增加 get_ms_excel、get_ms_ppt 初始化函数，确保分别调用正确的 COM 对象。\n- 优化：实现 release_ms，统一释放MS Office三大对象，避免资源泄露。\n- 路径透传：MS Office相关操作支持直接传入filepath参数。\n- 文档：移除 skill-card.md，更新使用说明与修复内容。\n\nv5.2.0 | 2026-09-19T02:10:04.598Z | auto\n\nWPS Office Suite v5.2.0\n\n- 新增公文一键排版：支持GB/T 9704标准结构，自动红头/联合行文模板，内置规则库，处理前自动备份\n- 新增批量水印与打码：支持目录批量文字/图片水印，身份证、手机号、银行卡、邮箱敏感信息双轨识别+打码清单\n- 新增跨文档知识检索与问答：本地TF-IDF零依赖索引，跨文档内容检索和跳转，支持嵌入式记忆桥接\n- 提升会议纪要：支持三要素结构化输出和说话人聚类\n- 删除轻量合同审查模块，合并为互链指引（详见contract-review）\n- 新增/重构脚本，包括条件格式/数据验证IO、公文格式、文档搜索、水印、打码等功能模块\n\nv5.0.0 | 2026-09-01T08:56:23.050Z | user\n\nv5.0.0 发布\n\nv4.9.0 | 2026-08-24T07:44:53.331Z | auto\n\nWPS Office Suite v4.9.0 is a major upgrade with new AI, template, and formula features.\n\n- 新增 wps ai --action 统一 9 大 AI 能力，包括续写、改写、扩写等操作\n- 增加 llm_bridge 桥接层，支持多模型白名单探测，零配置调用\n- 内置模板市场，集成超50套公文/合同/简历/报告等模板，支持用户分享\n- NL2Formula 支持歧义澄清与多轮反向校验，使公式生成更可靠\n- 结构优化：移除 skill-card.md，增加 clarify.py、llm_bridge.py、template_manager.py 等组件\n- 其它细节和稳定性优化\n\nv4.8.0 | 2026-08-22T12:57:26.494Z | auto\n\nWPS Office Suite v4.8.0\n\n- 新增邮件智能回复（模板匹配 + LLM 个性化、本地多模型降级）。\n- 新增周报/月报自动生成，支持结构化报告及可选 LLM 润色。\n- 纯Python模式增强，支持条件格式、数据验证、合并单元格、命名区域等。\n- 增加 AI 功能统一入口：`wps ai --action`，整合6大 AI 能力。\n- 代码结构优化，新增邮件/报表/AI等脚本。\n- 删除 skill-card.md，调整和补充 SKILL.md 文档内容。\n\nv4.7.0 | 2026-08-19T15:59:05.699Z | auto\n\nWPS Office Suite v4.7.0\n\n- 新增 Excel 公式解释器，支持 Excel 公式转自然语言（反向 NL2Formula，纯本地实现）\n- 新增 Markdown 转 Word / PPT 工具，支持 MD → Word/PPT，自动保留标题层级\n- 长文档排版入口统一（long-document --action，8个命令合并）\n- 长文档排版性能优化：分批处理、单次保存、进度回调\n- 增加 scripts/formula_explainer.py、scripts/md_converter.py 等新模块\n- skill-card.md 文件移除\n\nv4.6.1 | 2026-08-16T11:18:01.120Z | auto\n\n- Improved: Enhanced document translation features for better multi-format support (Word/Excel/PPT).\n- Updated: Refined meeting minutes and document translator scripts for reliability.\n- Maintenance: Updated dependencies in requirements.txt.\n- Cleanup: Removed outdated skill-card.md file.\n\nv4.6.0 | 2026-08-16T10:25:23.610Z | auto\n\nWPS Office Suite v4.6.0\n\n- 新增 Excel 智能分析统一入口，6大分析命令合并为1个接口，支持 --action 参数智能路由\n- 新增数据图表生成器：自动推荐图表类型并生成嵌入 Excel\n- 新增多格式文档翻译功能，支持 Word、Excel、PPT 跨格式专业翻译，内置多模型降级\n- scripts/chart_recommender.py、scripts/document_translator.py 新增；Excel/Word 脚本显著更新\n- skill-card.md 移除\n- 文档说明全面同步至 v4.6 特性\n\nv4.5.0 | 2026-08-08T14:25:05.031Z | auto\n\nwps-office-suite v4.5.0 introduces meeting minutes automation and COM health checks, with enhanced documentation for troubleshooting.\n\n- 新增会议纪要自动生成：音频转写（ASR）→ LLM 摘要 → Word 文档（支持降级链）\n- 新增 COM 健康检查与释放：检测 WPS/MS Office 状态、清理残留进程、自动释放对象\n- 故障排除文档大幅强化：避坑/FAQ/错误ID 统一索引，便于排查问题\n- 新增 scripts/com_health.py、scripts/meeting_minutes.py 支持相关功能\n- 维护性文档 skill-card.md 移除，结构更精简\n\nv4.4.0 | 2026-07-30T06:35:20.271Z | auto\n\nWPS Office Suite v4.4.0\n\n- 新增：长文档排版自动化，包括目录生成、页眉页脚、标题编号、图表索引、交叉引用、统一格式等能力（见“v4.4新增”）。\n- 新增脚本：long_document.py，支持对超长 Word 文档的结构和格式批量处理。\n- 优化：脚本 wps_word.py、wps_worker.py 增强了对长文档操作的自动化和稳定性。\n- 文档更新：SKILL.md 详细介绍长文档排版特性与升级说明。\n- 清理：移除 skill-card.md，整理无用文档文件。\n\nv4.3.0 | 2026-07-23T04:07:13.066Z | auto\n\nWPS Office Suite v4.3.0 introduces advanced Excel analysis features.\n\n- 新增 Excel 深度分析模块：公式纠错、数据清洗、透视表、数据预测、NL2Formula（自然语言转公式）\n- 新增脚本 `scripts/excel_analyzer.py`，支持智能分析和处理 Excel 数据\n- `scripts/wps_excel.py` 与 `scripts/wps_worker.py` 补充了对分析和数据清洗相关调用\n- 移除 `skill-card.md`，完善了 SKILL.md 说明，更新 v4.3 新特性\n- SKILL.md 现详细介绍所有新增深度分析功能及使用文档\n\nv4.1.0 | 2026-07-17T10:19:39.173Z | auto\n\nWPS Office Suite v4.1.0\n\n- 增加 scripts/ppt_generator.py，实现PPT生成功能\n- 更新 scripts/wps_ppt.py 和 scripts/wps_worker.py，支持调用新的PPT生成器\n- 文档更新：SKILL.md 反映新版功能与用法\n- 移除 skill-card.md，减少冗余文档\n\nv4.0.0 | 2026-07-13T01:35:56.595Z | auto\n\nWPS Office Suite v4.0.0 introduces major new features:\n\n- Added Word→PPT one-click generation, enabling instant conversion of Word content into presentations.\n- Introduced Excel natural language data analysis, supporting direct data insights in Excel via text input.\n- Added Word contract clause review for automatic identification and auditing of key terms in contracts.\n- Enabled Excel invoice OCR entry, allowing invoice data to be recognized and imported using OCR.\n- Updated documentation to reflect new features; removed outdated files and added scripts for each new capability.\n\nv3.0.1 | 2026-07-07T19:15:08.941Z | auto\n\nNo functional or documentation changes in this version.  \n- Version number in the SKILL.md remains at 3.1.0.\n- No files were changed in this release.\n\nv3.1.0 | 2026-07-07T19:14:05.719Z | auto\n\n**Summary:**  \nv3.1.0 introduces code-generated document templates, clearer file size recommendations, and a major expansion of the troubleshooting/FAQ section.\n\n- 全部内置文档模板改为「代码生成」，撤除全部二进制模板文件（.docx/.xlsx/.pptx）；提供 Python 脚本一键生成\n- “避坑指南”升级为20+常见问题，涵盖编码、公式、路径、文件大小、引擎选择等高频/低频错误排查\n- 新增“文件限制速查”，明确单文件 <50MB 推荐，超出建议分片，避免内存溢出\n- 文档模板获取和依赖说明优化，可按需动态生成模板\n- FAQ、最佳实践等内容对齐最新实现，更便于定位问题和自助解决\n\nv3.0.0 | 2026-07-07T00:32:12.546Z | auto\n\nWPS Office Suite v3.0.0 introduces automatic retries, hardware-adaptive performance, and seamless update notifications.\n\n- Added automatic retry mechanism: operations now auto-retry up to 3 times with backoff if WPS or engine fails.\n- Introduced hardware-adaptive mode: auto-detects CPU and memory, dynamically adjusts timeouts and threading for smoother performance on any device.\n- Built-in update checker: notifies users of new versions and provides update instructions.\n- Expanded documentation templates and included sample files.\n- Enhanced documentation with new sections on hardware adaptation, auto-retry logic, and clearer FAQs.\n- Removed outdated references and improved overall user guidance.\n\nv2.5.0 | 2026-07-03T06:20:42.918Z | user\n\nWPS Office 全家桶 v2.5.0 更新\n\nv2.2.0 | 2026-06-30T12:15:56.615Z | user\n\nv2.2.0: WPS办公套件增强更新\n\nv2.1.0 | 2026-06-28T06:43:50.403Z | user\n\nv2.1.0 - 新增 目录生成（wps_toc.py）；新增 环境自检（wps_test.py）；新增 反馈入口（wps_feedback.py）；新增 错误速查手册（10个FAQ编号 E001-E010）；新增 用例库（20个端到端场景）；新增 版本兼容矩阵；新增 AI助手完全指南（对话示例+状态追踪）；包含全部脚本文件（scripts目录+ARCHITECTURE+README+requirements）\n\nv2.0.1 | 2026-06-28T06:00:52.344Z | user\n\nv2.0.1 - 修复：scripts/ 目录及全部脚本文件现已包含在发布包中，用户安装后可直接运行 Python 脚本；三引擎自动切换（WPS → MS Office → 纯 Python）；AI 助手零学习成本调用；一句话操作速查表；三道安全防线\n\nv2.0.0 | 2026-06-28T05:43:00.094Z | user\n\nv2.0.0 - 三引擎自动切换（WPS → MS Office → 纯 Python）；AI 助手零学习成本调用；一句话操作速查表；三道安全防线；高级功能路线图\n\nv1.2.0 | 2026-06-28T02:59:36.548Z | user\n\nv1.2.0 - 子进程隔离架构（WPS 崩了不卡死）、多列排序（--sort-json）、多条件筛选（--filter-json + AND 逻辑）、格式转换明确错误提示、safe_path 中文路径保护\n\nv1.0.1 | 2026-06-27T18:11:34.494Z | user\n\nv1.0.1 - 修复 Excel 排序功能（已完成实现）；修复 PPT 主题应用（映射更灵活）；添加 FAQ 与详细操作示例\n\nv1.0.0 | 2026-06-27T18:05:18.225Z | user\n\nv1.0.0 - 初始版本，三大组件（Word/Excel/PPT）+ 格式转换 + 文档管理\n\nArchive index:\n\nArchive v5.3.0: 58 files, 266588 bytes\n\nFiles: ARCHITECTURE.md (10521b), README.md (958b), references/gongwen_rules.yaml (3506b), registry.json (3646b), requirements.txt (371b), scripts/chart_recommender.py (14816b), scripts/clarify.py (13148b), scripts/com_health.py (26531b), scripts/conditional_format_io.py (15694b), scripts/doc_search.py (11058b), scripts/document_manager.py (5005b), scripts/document_translator.py (19200b), scripts/email_reply.py (34772b), scripts/excel_analyzer.py (49984b), scripts/format_converter.py (6437b), scripts/formula_explainer.py (17493b), scripts/gongwen.py (11014b), scripts/kingdoc_bridge.py (17359b), scripts/llm_bridge.py (14136b), scripts/long_document.py (47917b), scripts/md_converter.py (15916b), scripts/meeting_minutes.py (46320b), scripts/nl2sql_engine.py (29165b), scripts/pipeline_bridge.py (13775b), scripts/ppt_generator.py (36950b), scripts/redact.py (7850b), scripts/report_generator.py (23299b), scripts/schedule_register.py (23066b), scripts/template_manager.py (24136b), scripts/usage_stats.py (22341b), scripts/validation_io.py (9907b), scripts/watch.py (29747b), scripts/watermark.py (10861b), scripts/wps_ai.py (10296b), scripts/wps_common.py (8269b), scripts/wps_docx_to_ppt.py (15597b), scripts/wps_engine.py (4093b), scripts/wps_error.py (11104b), scripts/wps_excel.py (18502b), scripts/wps_feedback.py (2830b), scripts/wps_invoice_ocr.py (12045b), scripts/wps_ms.py (3257b), scripts/wps_nl_analysis.py (13727b), scripts/wps_performance.py (5649b), scripts/wps_ppt.py (5139b), scripts/wps_pure_enhancements.py (23077b), scripts/wps_pure.py (29423b), scripts/wps_test.py (8261b), scripts/wps_toc.py (7484b), scripts/wps_update.py (3689b), scripts/wps_word.py (14694b), scripts/wps_worker.py (32904b), scripts/wps.py (7754b), skill-card.md (2379b), SKILL.md (41276b), templates/generate_templates.py (13622b), templates/templates_index.json (14466b), _meta.json (135b)\n\nFile v5.3.0:SKILL.md\n\n---\nname: wps-office-suite\ndescription: WPS Office 全家桶 - 四引擎（WPS/MS Office/LibreOffice/纯Python）智能识别用户已安装软件，纯Python模式支持排序/筛选/图表/公式/统计，含文档模板（代码生成）、最佳实践案例、故障排除大章（20+避坑+15 FAQ+15错误ID 统一索引）、自动重试、硬件自适应、环境自检、Skill更新提醒；v5.1新增：kingdoc云端桥接（白名单探测+配置预检+subprocess上传+差异检查）、条件格式/数据验证跨引擎IO（JSON中间格式保真往返）、会议纪要三段式要素化（待办清单+决策记录+风险异议）+说话人标注（MFCC聚类）；v5.2新增：公文一键排版（GB/T 9704 规则库约束+结构识别套版+红头预留位+联合行文）、批量水印与敏感信息打码（身份证/手机号/银行卡/邮箱双轨识别+黑色矩形覆盖+打码清单）、跨文档知识检索与问答（本地TF-IDF零依赖+跳转+可选zwjh记忆桥接）；删除：与contract-review重复的轻量合同审查模块，改为文档互链引导；v5.2.5修复：MS Office引擎下Excel/PPT创建必然失败（错用Word COM对象），新增get_ms_excel/get_ms_ppt及三槽位统一释放release_ms，MS Office路径透传filepath参数;v5.3.0新增：统一CLI入口 wps（registry.json注册表分发，office --app/--action 与 convert 子命令、--list 一屏列出全部命令，薄路由层不改脚本内部逻辑）、全命令 --json 机器可读输出（固定 ok/error_id/elapsed/data 四字段，对齐 E001-E015，wps_error.py 新增 emit_json 统一出口）、_worker 启动优化（wps_pure 改惰性加载，pywin32/python-docx/openpyxl 经核查已惰性导入，ENGINE_CACHE 进程级单例复用，COM 释放统一走 release_ms 三槽位）、转换三入口合并为 convert（format_converter/md_converter/wps_docx_to_ppt 内部按目标格式路由，旧脚本保留为兼容别名并提示新命令，v6.0.0 移除）\nversion: 5.3.0\n---\n\n\n# WPS Office 全家桶 v5.3.0 ✅\n\n> 🏗️ **四引擎智能识别**：自动检测用户电脑已安装的软件，按 WPS → MS Office → LibreOffice → 纯Python 顺序选择最合适的引擎\n> ✨ **纯Python模式增强 v4.8**：排序、筛选、图表、公式、统计、条件格式、数据验证、合并单元格、命名区域 — 跨平台全部支持\n> 🔄 **自动重试**：WPS 卡住时自动重试 3 次，不用手动重启\n> ⚡ **硬件自适应**：自动检测 CPU 内存，动态调整超时和线程，不拖累电脑\n> 📚 **文档模板 + 最佳实践 + 故障排除**：代码生成3个即用模板 + 10个最佳实践案例 + 统一故障排除大章\n> 📬 **Skill 更新提醒**：自动检查新版本，7天提醒一次，保持最新\n> 🆕 **文件大小明确限制**：单文件 < 50MB 直接处理，> 50MB 有分片建议\n> 🔬 **Excel 智能分析 v4.6**：6命令合并为 1 个统一入口（--action 参数路由）\n> 📊 **数据图表生成器 v4.6**：基于数据特征自动推荐图表类型 + 生成图表嵌入 Excel\n> 🌐 **文档翻译 v4.6**：Word/Excel/PPT 专业翻译（支持多模型降级）\n> 🎙️ **会议纪要 v4.5**：音频 → ASR 转写 → LLM 摘要 → Word（支持降级链）\n> 🏥 **COM 健康检查 v4.5**：WPS/MS Office 状态检测 + 残留进程清理\n> 🧮 **公式解释器 v4.7**：Excel 公式 → 自然语言解释（反向 NL2Formula，纯本地实现）\n> 📝 **Markdown 转换 v4.7**：MD → Word/PPT（保留标题层级，纯本地实现）\n> 📑 **长文档排版 v4.7**：统一入口 long-document --action（8命令合并），性能优化（分批+单次保存+进度回调）\n> ✉️ **邮件智能回复 v4.8**：模板匹配 + LLM 个性化回复（纯本地，多模型降级）\n> 📊 **周报/月报生成 v4.8**：关键点 → 结构化 Word 报告（模板 + 可选 LLM 润色）\n> 🤖 **AI 统一入口 v4.9**：`wps ai --action` 统一 9 大 AI 功能入口（新增续写/改写/扩写）\n> 🌉 **llm_bridge 桥接层 v4.9**：统一模型层，白名单探测 cn-llm-router，零配置多模型调用\n> 📋 **模板市场 v4.9**：50+ 内置模板（公文/合同/简历/标书/报告/会议），支持用户沉淀和分享\n> 💬 **NL2Formula 多轮澄清 v4.9**：歧义检测 → 槽位填充 → 反向验证，公式生成更精准\n> ⏰ **定时任务 v5.0**：schtasks/crontab 注册管理，周报/月报/数据刷新一键定时\n> 👁️ **目录监听 v5.0**：轮询监听 + YAML规则 + 大文件自动分片 + LibreOffice并发控制\n> 📊 **稳定性中心 v5.0**：SQLite埋点统计 + 引擎健康度 + 全局engine-info + 引擎偏好配置\n> 🏥 **COM自愈 v5.0**：三步自愈（regsvr32 → 修复安装 → 手动指引），每步记录日志\n> 💬 **对话式查询 v5.0**：NL2SQL式意图解析 + 查询计划生成 + 连续追问，Top20关键词模板降级\n> 🔗 **编排引擎桥接 v5.0**：白名单探测 multi-agent-orchestrator，命中注册流水线模板，未装本地串行降级\n> ☁️ **kingdoc 桥接 v5.1**：白名单探测+配置预检+subprocess 上传金山文档，difflib 差异检查\n> 🔄 **跨引擎 IO v5.1**：条件格式/数据验证 JSON 中间格式，WPS↔纯 Python 保真往返\n> 📋 **纪要要素化 v5.1**：三段式结构（待办清单+决策记录+风险异议）+ 说话人标注\n> 📑 **公文一键排版 v5.2**：GB/T 9704 规则库约束 + 结构识别套版，支持红头预留位与联合行文，处理前自动备份\n> 🔒 **批量水印与打码 v5.2**：文字/图片水印（平铺/对角线，批量目录）；敏感信息双轨识别（身份证/手机号/银行卡/邮箱）+ 黑色矩形覆盖 + 打码清单\n> 🔍 **跨文档检索 v5.2**：本地 TF-IDF 零依赖索引，跨文档找内容问答，命中返回文件+段落+跳转，可选 embedding 与 zwjh 记忆桥接\n> 🔗 **合同审查改互链 v5.2**：裁撤重复合同审查模块，完整审查请安装 contract-review（互链引导，无代码依赖）\n> 📧 **建议反馈**：有更好建议？邮箱：[njskills@agent.qq.com](mailto:njskills@agent.qq.com)\n\n---\n\n## 🚀 分钟上手\n\n### 1. 检查环境\n\n```bash\npython scripts/wps_test.py\n```\n\n### 2. 查看当前引擎 + 硬件\n\n```bash\npython scripts/wps_excel.py engine-info\n```\n\n### 3. 创建文件\n\n```bash\npython scripts/wps_word.py create --title \"测试文档\"\npython scripts/wps_excel.py create --name \"预算表\" --sheets \"收入,支出\"\npython scripts/wps_ppt.py create --title \"推广方案\"\n```\n\n### 4. 检查更新\n\n```bash\npython scripts/wps_excel.py check-update\n```\n\n### 5. 生成模板（代码生成，无二进制文件）\n\n```bash\npython templates/generate_templates.py --dir ./output\n```\n\n---\n\n## ⚡ 硬件自适应\n\n| 硬件等级 | CPU / 内存 | 超时 | 并行数 | 适用场景 |\n|---------|-----------|------|-------|---------|\n| 高性能 | 8核+ / 16G+ | 30s | 8线程 | 批量处理、大文件 |\n| 中等 | 4核+ / 8G+ | 60s | 4线程 | 日常办公 |\n| 低性能 | 2核 / 4G | 120s | 1线程 | 轻量任务 |\n\n---\n\n## 🔧 功能矩阵\n\n| 功能 | WPS | MS Office | LibreOffice | 纯Python |\n|------|-----|-----------|-------------|----------|\n| **创建/编辑/格式 — Word** | ✅ | ✅ | ✅（回退） | ✅ |\n| **表格/图片/目录 — Word** | ✅ | ✅ | ❌ | ✅ |\n| **创建/编辑/公式/图表 — Excel** | ✅ | ✅（回退） | ✅（回退） | ✅ |\n| **排序/筛选/统计 — Excel** | ✅ | ✅（回退） | ✅（回避） | ✅ |\n| **条件格式/数据验证 — Excel** | ✅ | ✅（回退） | ❌ | ✅（v4.8 新增） |\n| **幻灯片/主题/插入 — PPT** | ✅ | ❌ | ❌ | ❌ |\n| **PPT 创建/多页 — PPT** | ✅ | ✅ | ✅（回退） | ✅ |\n\n> ✅（回退）= 原生引擎不支持时，自动回退到纯 Python 实现\n\n---\n\n## 📂 文档模板（代码生成，零二进制文件）\n\n| 模板 | 用途 | 生成命令 |\n|------|------|---------|\n| 工作报告 | 周报/月报/汇报 | `python templates/generate_templates.py --dir ./output` |\n| 月度预算 | 收入/支出/汇总 | 同上 |\n| 商务PPT | 项目汇报/方案 | 同上 |\n\n> 模板通过纯 Python 代码动态生成，无需分发二进制文件。首次运行需安装 `python-docx`、`openpyxl`、`python-pptx`。\n\n---\n\n## ⚠️ 文件限制速查\n\n| 限制项 | 阈值建议 | 超出后处理方式 |\n|--------|---------|--------------|\n| **单文件大小** | < 50MB 直接处理 | > 50MB 先分片（拆 Sheet/Section） |\n| **批量文件数** | 建议 ≤ 50 个/批 | 超过时分批调用 |\n| **Excel 行数** | < 100,000 行 | 超过时分 Sheet 存储 |\n| **PPT 页数** | < 100 页 | 拆分为多个文件 |\n| **并发操作** | 同一引擎 1 个实例 | 串行等待，避免并行写同一文件 |\n| **文件名长度** | < 200 字符 | 过短路径避免中文 |\n\n---\n\n## 🔧 故障排除大章（v4.5 合并，统一索引）\n\n### 统一索引表\n\n| 类型 | 问题 | 快速解决 |\n|------|------|---------|\n| 🚫 避坑 | WPS 未安装就调用 | 运行 engine-info 检查引擎 |\n| 🚫 避坑 | 公式写入显示 #NAME? | 按 Ctrl+Alt+F9 重新计算 |\n| 🚫 避坑 | 中文路径编码错误 | 改用英文路径或 raw string |\n| 🚫 避坑 | 大文件内存溢出 | >50MB 分片处理 |\n| 🚫 避坑 | WPS 卡住无响应 | 已自动重试3次，不行就任务管理器结束 |\n| 🚫 避坑 | COM 对象残留 | Worker 自动释放，或运行 com-health release-all |\n| 🚫 避坑 | PPT 添加幻灯片失败 | 仅 WPS 支持，或一次性指定 slides_content |\n| 🚫 避坑 | openpyxl 读取公式为 None | 先 WPS 打开保存一次 |\n| 🚫 避坑 | 排序/筛选/图表错乱 | 确保第一行是表头，列名完全一致 |\n| 🚫 避坑 | 筛选返回空结果 | 数值 value 必须是字符串 |\n| ⚠️ FAQ | 该选哪个引擎？ | 自动检测，无需手动选择 |\n| ⚠️ FAQ | WPS 版本有要求？ | 2019+ 或 WPS 365，安装后必须重启 |\n| ⚠️ FAQ | 纯Python vs WPS 区别？ | 公式计算/图表/添加幻灯片不同 |\n| ⚠️ FAQ | 文件太大怎么办？ | <50MB 直接处理，>50MB 分片 |\n| ⚠️ FAQ | Linux 能用吗？ | 能，安装 LibreOffice |\n| ⚠️ FAQ | WPS 卡住怎么办？ | 自动重试3次，不行结束进程 |\n| ⚠️ FAQ | 纯Python 安装依赖？ | pip install python-docx openpyxl python-pptx |\n| ⚠️ FAQ | 模板如何获取？ | 代码生成，运行 generate_templates.py |\n| ⚠️ FAQ | 批量转换格式？ | format_converter.py batch |\n| ⚠️ FAQ | 多 Sheet 处理？ | 逐 Sheet 调用或 add-sheet |\n| ⚠️ FAQ | 排序/筛选总失败？ | 确保 openpyxl 安装、文件未占用 |\n| ⚠️ FAQ | 如何提交反馈？ | wps_feedback.py email 或发邮件 |\n| ⚠️ FAQ | 公式何时计算？ | 打开文件时由 Excel/WPS 计算 |\n| ⚠️ FAQ | 文件被占用怎么办？ | 关闭程序，等待3-5秒重试 |\n| ⚠️ FAQ | 纯Python 不可用功能？ | 添加幻灯片/插入/主题/VBA/条件格式 |\n| 🚨 错误ID | E001 WPS 未安装或 COM 注册失败 | 安装 WPS 后重启电脑 |\n| 🚨 错误ID | E002 python-docx 未安装 | pip install python-docx openpyxl python-pptx |\n| 🚨 错误ID | E003 文件路径不存在 | 改用英文路径或以管理员运行 |\n| 🚨 错误ID | E004 格式转换失败 | 安装 WPS 或 LibreOffice |\n| 🚨 错误ID | E005 需要 WPS 模式 | 安装 WPS 或改用纯Python模式 |\n| 🚨 错误ID | E006 WPS 卡住无响应 | 任务管理器结束进程；更新到最新版 |\n| 🚨 错误ID | E007 权限不足 | 以管理员运行；检查文件只读属性 |\n| 🚨 错误ID | E008 pywin32 导入失败 | pip uninstall pywin32 && pip install pywin32 |\n| 🚨 错误ID | E009 Python 版本过低 | 升级到 Python 3.8+ |\n| 🚨 错误ID | E010 引擎不支持此功能 | 安装 WPS 或改用 info 查看能力矩阵 |\n| 🚨 错误ID | E011 LibreOffice 未安装 | 下载 LibreOffice 并添加到 PATH |\n| 🚨 错误ID | E012 LibreOffice 转换失败 | 检查源文件是否损坏；避免中文路径 |\n| 🚨 错误ID | E013 文件不存在 | 确认路径正确；未被删除或移动 |\n| 🚨 错误ID | E014 未知运行时错误 | 运行环境自检 wps_test.py；联系反馈 |\n| 🚨 错误ID | E015 不支持的操作或格式 | 输出格式改为 pdf/txt/html |\n\n---\n\n## 🚫 避坑详解（20+ 条）\n\n### 🥇 高频问题（TOP 10）\n\n#### ❌ 坑 1：WPS 没安装就调用 WPS 功能\n\n```\n症状：win32com.com_error 或 \"WPS 未安装\"\n排查：\n  1. 运行 python scripts/wps_excel.py engine-info 检查当前引擎\n  2. 如果显示 PURE 或 LIBREOFFICE，说明 WPS 不可用\n  3. 安装 WPS Office 2019+ 后重启电脑\n```\n\n#### ❌ 坑 2：纯 Python 模式下写公式，打开 Excel 显示 #NAME?\n\n```\n症状：公式写入后打开显示 #NAME? 错误\n排查：\n  1. openpyxl 写的是公式字符串，打开时需 Excel/WPS 重新计算\n  2. 解决：按 Ctrl+Alt+F9 强制重新计算\n  3. 或切换到 WPS 模式自动计算\n```\n\n#### ❌ 坑 3：中文路径编码错误\n\n```\n症状：UnicodeEncodeError 或 FileNotFoundError\n排查：\n  1. 避免中文路径：D:\\docs\\report.docx ✅\n  2. 路径加引号：\"D:\\中文\\报告.docx\" ✅\n  3. 使用 raw string：r\"D:\\中文\\报告.docx\" ✅\n```\n\n#### ❌ 坑 4：大文件内存溢出\n\n```\n症状：MemoryError 或程序卡死\n排查：\n  1. 先运行 python scripts/wps_word.py info --file big.docx 查看大小\n  2. < 50MB 直接处理\n  3. > 50MB 拆分处理：分 Sheet/Section\n  4. 硬件自适应会自动延长超时\n```\n\n#### ❌ 坑 5：WPS 卡住无响应\n\n```\n症状：操作超时（30s/60s/120s）\n排查：\n  1. Skill 已自动重试 3 次（等 1s → 2s → 4s）\n  2. 仍失败则：任务管理器 → 结束 WPS 进程\n  3. 反复出现：pip install --upgrade pywin32\n```\n\n#### ❌ 坑 6：COM 对象残留\n\n```\n症状：第二次调用报 \"RPC 服务器不可用\"\n排查：\n  1. Worker 已内置自动释放（每次操作后调用 release_wps）\n  2. 手动清理：任务管理器 → 结束 kwps.exe\n  3. 避免频繁创建/销毁 Worker，使用 stdin/stdout 协议\n```\n\n#### ❌ 坑 7：PPT 添加幻灯片失败\n\n```\n症状：纯Python模式不支持添加幻灯片\n排查：\n  1. 添加幻灯片、插入内容、主题应用仅 WPS 支持\n  2. 替代方案：用 pure_create_ppt 创建时指定 slides_content 一次生成多页\n  3. 或安装 WPS Office\n```\n\n#### ❌ 坑 8：openpyxl 读取公式为 None\n\n```\n症状：读取含公式的单元格返回 None\n排查：\n  1. openpyxl 默认读取缓存值（data_only=True）\n  2. 如果从未在 Excel 中打开计算，缓存值为 None\n  3. 解决：先在 WPS 中打开保存一次，或改用公式计算\n```\n\n#### ❌ 坑 9：sort 命令排序错乱\n\n```\n症状：排序结果不对\n排查：\n  1. 确保第一行是表头（不参与排序）\n  2. 列名参数 column 需与表头完全一致（区分大小写）\n  3. 多列排序时注意优先级顺序\n```\n\n#### ❌ 坑 10：filter 筛选返回空结果\n\n```\n症状：筛选条件正确但返回空\n排查：\n  1. 条件 column 值需与表头完全一致\n  2. 数值比较时 value 必须是字符串（\"--value\": \"5000\"）\n  3. 检查是否有隐藏空格，使用 trim\n```\n\n### 🥈 中频问题\n\n#### ⚠️ 坑 11：LibreOffice 转换失败\n```\n症状：Word 转 PDF 报错\n排查：先检查 LibreOffice 是否加入 PATH；避免中文路径；确保文件未损坏\n```\n\n#### ⚠️ 坑 12：generate_templates.py 报 ImportError\n```\n症状：缺少 python-docx / openpyxl / python-pptx\n排查：pip install python-docx openpyxl python-pptx\n```\n\n#### ⚠️ 坑 13：_worker 启颈慢\n```\n症状：首次调用需2-3秒\n排查：正常！Worker 启动时检测硬件和引擎\n```\n\n#### ⚠️ 坑 14：MS Office 模式下功能缺失\n```\n症状：纯Python能做的MS Office不行\n排查：MS Office COM 接口并非全功能，部分自动回退到纯Python\n```\n\n#### ⚠️ 坑 15：多 Sheet 引用公式失效\n```\n症状：=SUM(1月:12月!B2) 不计算\n排查：openpyxl 写公式不支持 3D 引用，改用 stats 命令或逐 Sheet 运算\n```\n\n### 🥉 低频但重要\n\n#### ⚡ 坑 16：macOS 上 WPS 部分功能不可用\n```\n症状：Mac 版 WPS COM 不支持某些操作\n排查：回退到纯Python模式（WPS_ENGINE=PURE）\n```\n\n#### ⚡ 坑 17：xlsm 文件宏丢失\n```\n症状：保存后宏功能失效\n排查：openpyxl 不支持宏，xlsm 文件请用 WPS/MS Office 模式\n```\n\n#### ⚡ 坑 18：批量操作时 WPS 弹出对话框\n```\n症状：WPS 弹窗阻断自动化\n排查：弹窗需手动点击；建议在无人值守时关闭 WPS 弹窗\n```\n\n#### ⚡ 坑 19：文件被占用\n```\n症状：PermissionError\n排查：关闭占用文件的程序（WPS/Excel/Word），等待 3-5 秒后重试\n```\n\n#### ⚡ 坑 20：Windows 长路径限制\n```\n症状：Windows 默认最大路径 260 字符\n排查：启用 Windows 长路径支持，或使用短路径\n```\n\n---\n\n## 📋 常见问题 FAQ（Q&A）\n\n### Q1：我应该选择哪个引擎？\n\n**不用选！Skill 自动检测**。运行 `python scripts/wps_excel.py engine-info` 查看。如果强行切换，可以设置环境变量 `WPS_ENGINE=PURE` 强制使用纯 Python。\n\n### Q2：WPS 版本有要求吗？\n\n- WPS Office 2019+ 或 WPS 365\n- 安装后**必须重启电脑**\n- 32/64 位均可\n\n### Q3：纯 Python 模式和 WPS 模式有什么区别？\n\n| | WPS 模式 | 纯 Python 模式 |\n|--|---------|-------------|\n| 公式计算 | ✅ 自动计算 | ⚠️ 写入公式，打开时计算 |\n| 图表 | ✅ 实时预览 | ✅ 嵌入到 Excel |\n| 添加幻灯片 | ✅ 支持 | ❌ 不支持 |\n| 内存占用 | 高（几百 MB） | 低（几十 MB） |\n| 速度 | 快（WPS 优化） | 较慢 |\n\n### Q4：文件太大怎么办？\n\n> Skill 硬件自适应会自动延长超时（最高 5 倍）。\n> 建议：< 50MB 直接处理；> 50MB 先分片处理（拆分 Sheet/Section）。\n> 批量操作时单次建议 ≤ 50 个文件。\n\n### Q5：Linux 上能用吗？\n\n> ✅ 能用！安装 LibreOffice 即可：\n> ```bash\n> sudo apt install libreoffice  # Ubuntu/Debian\n> ```\n> 支持格式转换（Word/Excel/PPT → PDF）；\n> 公式、排序、筛选、图表也能用纯 Python 模式。\n\n### Q6：WPS 卡住怎么办？\n\n> Skill 会自动重试 3 次。如果仍然失败：\n> 1. 打开任务管理器 → 结束 WPS 进程\n> 2. 重新运行命令\n> 3. 如果反复出现，尝试：`pip install --upgrade pywin32`\n\n### Q7：纯 Python 模式如何安装依赖？\n\n```bash\npip install python-docx openpyxl python-pptx\n```\n\n### Q8：模板文件在哪里？如何获取？\n\n> 模板通过代码生成，不包含二进制文件。安装依赖后运行：\n> ```bash\n> python templates/generate_templates.py --dir ./output\n> ```\n> 即可生成 3 个模板：report_template.docx、budget_template.xlsx、business_ppt_template.pptx\n\n### Q9：如何批量转换格式？\n\n```bash\n# 单个文件\npython scripts/wps_word.py export --file report.docx --format pdf\n\n# 批量转换（使用 format_converter.py）\npython scripts/format_converter.py batch --input-dir ./docs --input-format docx --output-format pdf\n```\n\n### Q10：如何同时处理多个 Sheet？\n\n```bash\n# 查看所有 Sheet\npython scripts/wps_excel.py info --file Sales.xlsx\n\n# 为每个 Sheet 添加数据（逐 Sheet 调用）\npython scripts/wps_excel.py input --file Sales.xlsx --sheet Q1 --data '[[\"A\",100]]'\npython scripts/wps_excel.py input --file Sales.xlsx --sheet Q2 --data '[[\"B\",200]]'\n\n# 添加新 Sheet\npython scripts/wps_excel.py add-sheet --file Sales.xlsx --sheet Q4 --headers '[\"产品\",\"价格\"]' --data '[[\"X\",300]]'\n```\n\n### Q11：排序/筛选/图表操作总是失败？\n\n> 纯 Python 模式下这些功能 100% 支持。\n> 1. 确保已安装：`pip install openpyxl`\n> 2. 文件不能正在被占用（关闭 WPS/Excel）\n> 3. 第一行必须是表头（列名）\n> 4. 列名参数需与表头完全一致\n\n### Q12：如何提交反馈？\n\n```bash\npython scripts/wps_feedback.py email  # 打开邮件客户端（自动附带系统信息）\n```\n\n或直接发邮件到：**njskills@agent.qq.com**\n\n### Q13：纯 Python 模式下公式何时计算？\n\n> openpyxl 写入公式字符串，**打开文件时**由 Excel/WPS 计算。\n> 如果需要立即计算，请使用 WPS 模式或 MS Office 模式。\n\n### Q14：文件被占用怎么办？\n\n> 关闭占用文件的程序（WPS/Excel/Word），等待 3-5 秒后重试。\n> 或使用自动重试（Skill 已内置 3 次重试）。\n\n### Q15：哪些功能在纯 Python 模式下不可用？\n\n> v4.8 新增条件格式、数据验证、合并单元格、命名区域支持，纯Python模式覆盖度显著提升。\n\n> - 添加幻灯片（add-slide）\n> - 幻灯片插入内容（insert）\n> - 幻灯片主题（theme）\n> - VBA/宏操作\n> \n> 替代方案：安装 WPS Office 或 MS Office 获取完整功能。\n\n---\n\n## 🏆 最佳实践（10 个案例）\n\n| 案例 | 问题 | 策略（一句话） |\n|------|------|------|\n| BP-1 大文件 | 50MB+ Word 操作慢 | 先 `wps word info` 看大小；>50MB 分片；纯Python读内容；避免频繁保存 |\n| BP-2 周报 | 每周重复同格式周报 | 模板生成→复制→edit 追加→format 设样式→export PDF |\n| BP-3 预算 | 每月手录收支汇总 | 预算模板→input 录入→汇总Sheet公式→stats 校验 |\n| BP-4 商务PPT | 项目汇报PPT | 模板→改标题；多页用 create --slides |\n| BP-5 数据报表 | 每周同格式报表 | 模板含公式/图表→每周 input 新数据→自动更新→export PDF |\n| BP-6 多Sheet | 12月数据年度汇总 | add-sheet 建\"年度汇总\"→stats 逐Sheet校验 |\n| BP-7 条件筛选 | 千条记录筛\"销售额>5000 且 地区=华东\" | `wps excel filter --conditions '[{\\\"column\\\":\\\"销售额\\\",\\\"op\\\":\\\">\\\",\\\"value\\\":\\\"5000\\\"},{\\\"column\\\":\\\"地区\\\",\\\"op\\\":\\\"=\\\",\\\"value\\\":\\\"华东\\\"}]' --logic AND` |\n| BP-8 批量重命名 | 20文件统一命名 | document_manager.py 列出→批量加日期前缀→format_converter 批量转 |\n| BP-9 跨平台转换 | Linux Word→PDF | 装 LibreOffice→引擎自动识别→export --format pdf |\n| BP-10 定时自动化 | 每天凌晨生成报表 | 自动化脚本调 wps_excel/wps_word→WorkBuddy automation 定时执行 |\n\n---\n\n## 🚨 错误速查手册 v3.1（15个错误ID）\n\n### E001-E010：用户可自助解决\n\n| ID | 错误 | 解决 |\n|----|------|------|\n| E001 | WPS 未安装或 COM 注册失败 | 安装 WPS 后重启电脑 |\n| E002 | python-docx 未安装 | `pip install python-docx openpyxl python-pptx` |\n| E003 | 文件路径不存在或无法访问 | 改用英文路径或以管理员运行 |\n| E004 | 格式转换失败（纯Python不支持） | 安装 WPS 或 LibreOffice |\n| E005 | 排序/筛选/图表需要 WPS 模式 | 安装 WPS 或改用纯Python模式 |\n| E006 | WPS/LibreOffice 卡住无响应 | 任务管理器结束进程；更新到最新版 |\n| E007 | 权限不足 | 或以管理员运行；检查文件只读属性 |\n| E008 | pywin32 导入失败 | `pip uninstall pywin32 && pip install pywin32` |\n| E009 | Python 版本过低 | 升级到 Python 3.8+ |\n| E010 | 当前引擎不支持此功能 | 安装 WPS 或改用 info 查看能力矩阵 |\n\n### E011-E015：需要进一步排查\n\n| ID | 错误 | 解决 |\n|----|------|------|\n| E011 | LibreOffice 未安装 | 下载 LibreOffice 并添加到 PATH |\n| E012 | LibreOffice 转换失败 | 检查源文件是否损坏；避免中文路径 |\n| E013 | 文件不存在 | 确认路径正确；未被删除或移动 |\n| E014 | 未知运行时错误 | 运行环境自检 `wps_test.py`；联系反馈 |\n| E015 | 不支持的操作或格式 | 输出格式改为 pdf/txt/html |\n\n---\n\n## ⚠️ 能力边界说明\n\n| 限制项 | 说明 | 解决方案 |\n|--------|------|---------|\n| **文件大小** | 单文件 < 50MB 直接处理 | 大文件先分片处理（硬件自适应自动延长超时） |\n| **批量文件数** | 建议 ≤ 50 个/批 | 超过时分批调用 |\n| **复杂度** | 透视表/VBA/ActiveX 不支持 | 使用 pandas 或手动处理 |\n| **网络文件** | 不支持 HTTP/URL 下载 | 先手动下载到本地，再调用 Skill |\n| **并发限制** | 同一时间只能操作同一引擎的一个实例 | 等待上次操作完成再发起 |\n| **中文名文件路径** | 建议改用英文路径 | 路径中避免中文和特殊字符 |\n| **实时协作** | 不支持多人同时编辑同一文件 | 通过手动分发和合并 |\n\n---\n\n## 🔗 CLI 命令速查（由 registry.json 自动导出）\n\n> v5.3.0 起，全部能力收敛到统一入口 `python scripts/wps`，原 47 个脚本仍可单独调用（100% 兼容）。运行 `python scripts/wps --list` 查看完整动态清单。\n\n### 统一入口用法\n```bash\npython scripts/wps --list                                  # 一屏列出全部命令与一句话用途\npython scripts/wps word create --title 测试 --filepath ./a.docx\npython scripts/wps office --app word --action create --title 测试\npython scripts/wps excel engine-info --json                # 机器可读输出\npython scripts/wps convert --input 报告.docx --output-format pdf\npython scripts/wps --json <任意命令> [参数]                 # 固定四字段 {ok,error_id,elapsed,data}\n```\n\n### 命令一览（一页表）\n| 命令 | 用途 | 底层脚本 |\n|------|------|----------|\n| word | Word：创建/编辑/排版/导出/公文/会议纪要/长文档 | wps_word.py |\n| excel | Excel：创建/输入/公式/排序/筛选/图表/分析/OCR | wps_excel.py |\n| ppt | PPT：创建/生成/导出/主题/Word转PPT | wps_ppt.py |\n| convert | 格式转换：docx/xlsx/pptx ↔ pdf/txt/html/csv/png（合并 format_converter/md_converter/docx_to_ppt） | _convert |\n| long-document | 长文档排版：目录/页眉页脚/编号/交叉引用/图表索引 | long_document.py |\n| gongwen | 公文一键排版：GB/T 9704 规则库，红头预留位/联合行文 | gongwen.py |\n| meeting-minutes | 会议纪要：ASR转写→LLM摘要→Word（待办/决策/风险异议） | meeting_minutes.py |\n| excel-analyze | Excel 深度分析：数据画像/透视/预测/NL2SQL | excel_analyzer.py |\n| invoice-ocr | 发票 OCR 入账：PDF/图片→Excel 本地识别 | wps_invoice_ocr.py |\n| formula-explain | 公式解释：Excel 公式→自然语言解读 | formula_explainer.py |\n| ppt-generate | PPT 智能生成：多源输入/演讲者备注/动画/配色 | ppt_generator.py |\n| docx-to-ppt | Word→PPT：章节分割→大纲→模板 | wps_docx_to_ppt.py |\n| redact | 敏感信息打码：身份证/手机号/银行卡/邮箱双轨识别 | redact.py |\n| watermark | 批量水印：文字/图片，平铺/对角线，docx/pptx/图片 | watermark.py |\n| doc-search | 跨文档检索问答：本地 TF-IDF 零依赖 | doc_search.py |\n| template | 文档模板管理：代码生成类模板 | template_manager.py |\n| report | 报告生成：关键点→结构化 Word | report_generator.py |\n| doc-manager | 文档管理：批量整理/重命名/归档 | document_manager.py |\n| doc-translate | 文档翻译：Word/Excel/PPT 多模型降级 | document_translator.py |\n| email-reply | 邮件智能回复：模板+LLM 个性化 | email_reply.py |\n| schedule | 日程登记：文本/结构化→日历 | schedule_register.py |\n| clarify | 需求澄清：歧义检测→槽位填充 | clarify.py |\n| com-health | COM 健康检查：WPS/MS/残留/强制释放 | com_health.py |\n| usage-stats | 使用统计：SQLite 埋点/引擎健康度 | usage_stats.py |\n| feedback | 反馈提交：邮件/issue | wps_feedback.py |\n| test | 环境自检：引擎/COM/依赖 | wps_test.py |\n| toc | 目录生成：提取/插入 Word 目录 | wps_toc.py |\n| watch | 文件监控：轮询+YAML 规则+大文件分片 | watch.py |\n| chart-recommend | 图表推荐：按数据特征推荐图表类型 | chart_recommender.py |\n\n> 其余脚本可直接 `python scripts/wps <脚本名> [参数]` 调用；`--json` 适用于全部命令。\n\n## 📊 版本兼容矩阵\n\n| Python | WPS Office | LibreOffice | Windows | macOS | Linux | 状态 |\n|--------|-----------|-------------|---------|-------|-------|------|\n| 3.8+ | 2019+ | - | ✅ | ⚠️ | ❌ | 基础 |\n| 3.8+ | 365 | - | ✅ | ✅ | ❌ | 最佳 |\n| 3.8+ | - | 7.0+ | ✅ | ✅ | ✅ | 跨平台推荐 |\n| 3.8+ | - | - | ✅ | ✅ | ✅ | 纯Python |\n\n> ⚠️ = 部分功能受限（纯Python模式），❌ = 对应引擎不可用\n\n---\n\n## ⚠️ 安全须知\n\n**✅ 五道防线保障安全**：\n1. **引擎自检**：启动时自动检测可用引擎，崩溃自动重启\n2. **路径校验**：`safe_path()` 全面校验，拒绝非法路径和特殊字符\n3. **错误中文化**：所有错误 ID 提供详细中文说明和操作步骤\n4. **数据零上传**：所有处理在本地完成，不上传任何内容到互联网\n5. **显式 Opt-in**（v4.6.1 引入）：外部服务（ASR/LLM）仅在用户显式指定 method 时调用，auto 模式仅使用本地引擎\n\n**📝 注意事项**：\n- 批量操作时，桌面会创建 `WPS_Backup` 文件夹保存副本\n- macOS 上 WPS 不支持所有功能\n- 纯 Python 模式下格式设置有限，复杂排版建议安装 WPS\n- 所有文件操作在本地进行，不会联网\n- LibreOffice Headless 模式下不支持实时预览\n- Skill 每 7 天自动检查更新，不会频繁打扰\n- **模板为纯代码生成，不包含二进制文件，更安全可靠**\n- **v4.7 新增公式解释器、MD 转换均为纯本地实现，不读取外部凭证或 API Key**\n\n---\n\n## 更新日志\n\n| 版本 | 日期 | 本次更新 |\n|------|------|---------|\n| v5.3.0 | 2026-10-09 | 增加：统一 CLI 入口 scripts/wps.py（registry.json 注册表分发，office --app word/excel/ppt --action 与 convert 子命令 + --list 一屏列出全部命令，薄路由层不改脚本内部逻辑，原 47 个脚本 100% 兼容）；增加：全命令 --json 机器可读输出（wps_error.py 新增 emit_json 统一出口，固定 ok/error_id/elapsed/data 四字段，error_id 对齐 E001-E015）；优化：_worker 启动速度（wps_worker.py 的 wps_pure 改惰性加载，pywin32/python-docx/openpyxl 经核查已惰性导入，ENGINE_CACHE 进程级单例复用，COM 释放统一走 release_ms 三槽位）；合并：格式转换三入口收敛为 convert 子命令（format_converter/md_converter/wps_docx_to_ppt 内部按目标格式路由），旧脚本保留为兼容别名并提示新命令，v6.0.0 移除；优化：SKILL.md 命令速查改为由 registry.json 自动导出的一页表，主文档体积下降 ≥30% |\n| v5.2.5 | 2026-09-22 | 修复：MS Office 引擎下 Excel/PPT 创建必然失败（ms_create_excel/ms_create_ppt 错用 Word COM 对象，调用 get_ms_word 而非各自 Excel/PPT 对象）；增加：wps_common.py 新增 create_ms_excel/get_ms_excel 与 create_ms_ppt/get_ms_ppt，并新增 MS_EXCEL_CLIENT/MS_PPT_CLIENT 双槽位；修复：release_ms 改为统一释放 Word/Excel/PPT 三槽位并置空；修复：wps_ms.py 与 wps_worker.py 的 MS Office 路径透传 filepath 参数（不再硬编码写入桌面） |\n| v5.2.0 | 2026-09-19 | 增加：公文一键排版 gongwen.py + references/gongwen_rules.yaml（GB/T 9704 党政机关公文格式约束库，结构识别套版，支持红头预留位与联合行文，处理前自动备份原文件）；增加：批量水印 watermark.py（文字/图片水印，平铺与对角线，docx/pptx/图片批量目录处理）；增加：敏感信息打码 redact.py（正则+词典双轨识别身份证/手机号/银行卡/邮箱，黑色矩形覆盖，输出打码清单供人工复核，NER 可选增强）；增加：跨文档知识检索 doc_search.py（本地 TF-IDF char/bigram 自研零依赖，跨文档找内容问答，命中返回文件+段落+跳转，embedding 可选，zwjh 记忆桥接未装则跳过）；删除：与 contract-review 重复的轻量合同审查模块 wps_contract_review.py 及其在 wps_ai/wps_word/wps_worker 的入口命令，SKILL.md 改为文本互链引导（无代码依赖） |\n| v5.1.0 | 2026-09-08 | 增加：kingdoc 云端桥接 kingdoc_bridge.py（白名单探测+配置预检+subprocess JSON 契约上传+ difflib 差异检查，未安装/未配置隐藏入口+可选装提示）；增加：条件格式跨引擎 IO conditional_format_io.py（色阶/数据条/公式条件→JSON 中间格式，跨引擎保真往返 WPS↔纯Python）；增加：数据验证跨引擎 IO validation_io.py（下拉/数值区间/日期→JSON 中间格式，跨引擎保真往返）；优化：meeting_minutes.py 升级为 v5.1 三段式要素化纪要（待办清单+决策记录+风险异议，每节独立页眉）；增加：说话人标注 SpeakerDiarization（MFCC 聚类或显式报名，独立 diarize 子命令）；增加：--diarize/--no-diarize 参数控制说话人标注；增加：--num-speakers 参数指定说话人数 |\n| v5.0.0 | 2026-08-16 | 增加：定时任务注册管理 schedule_register.py（schtasks/crontab 双平台，4个预定义任务，注册前展示命令确认，list/cancel/enable管理）；增加：目录轮询监听 watch.py（轮询间隔3秒无内核依赖，YAML规则表匹配，>50MB自动分片并行处理+合并输出，LibreOffice并发池控制）；增加：使用统计与稳定性中心 usage_stats.py（SQLite埋点：操作数/耗时/引擎命中/失败降级/重试成功率，stats日/周报表+引擎健康度，全局engine-info合并3脚本，引擎偏好优先级配置）；增加：COM三步自愈 com_health.py self-heal子命令（regsvr32重注册→WPS修复安装[用户确认]→手动指引，每步记录SQLite日志）；增加：对话式数据查询 nl2sql_engine.py（意图解析器+查询计划生成器+pandas执行器+对话上下文，Top20关键词模板覆盖sum/avg/max/min/count/filter/groupby/sort/topn/yoy/mom等，无LLM降级）；增加：multi-agent编排引擎桥接 pipeline_bridge.py（白名单探测multi-agent-orchestrator，命中注册5条WPS流水线模板，未装降级watch.py本地串行，同一套规则表两种执行路径） |\n| v4.9.0 | 2026-08-08 | 增加：llm_bridge 统一模型层桥接（白名单探测 cn-llm-router，零配置多模型调用，JSON 契约 text/model/cost）；增加：wps ai 续写/改写/扩写 3 个新 AI 动作（经 llm_bridge 路由，未装 cn-llm-router 回落自配 API + 安装提示）；增加：模板市场 template_manager.py（50+ 内置模板覆盖公文/合同/简历/标书/报告/会议，支持用户沉淀 user_templates + 导出/导入分享包）；增加：NL2Formula 多轮澄清 clarify.py（歧义检测 3 类规则 + 槽位填充 + 反向验证回路，公式生成更精准）；优化：document_translator.py 优先走 llm_bridge 后回落直接 API；优化：report_generator.py 新增 --polish 参数（经 llm_bridge 润色）；优化：meeting_minutes.py 摘要引擎优先走 llm_bridge 后回落本地规则 |\n| v4.8.0 | 2026-08-22 | 增加：邮件智能回复 email_reply.py（模板匹配 + 规则引擎 + 可选 LLM 个性化，纯本地实现）；增加：周报/月报自动生成 report_generator.py（关键点→结构化 Word 报告，模板 + 可选 LLM 润色）；升级：纯 Python 模式能力（条件格式/数据验证/合并单元格/命名区域，基于 openpyxl 扩展）；增加：AI 统一入口 wps ai --action（6 大 AI 功能统一入口）；增加：邮件回复 CLI 子命令（email-reply）；增加：周报月报 CLI 子命令（report）；增加：条件格式/数据验证/合并单元格/命名区域 CLI 子命令 |\n| v4.7.0 | 2026-08-17 | 增加：公式解释器 formula_explainer.py（反向 NL2Formula，Excel 公式→自然语言解释，纯本地实现，80+ 函数映射）；增加：Markdown→Word/PPT 转换器 md_converter.py（保留标题层级/表格/列表/加粗，纯本地实现）；合并：长文档排版 8 命令为 long-document 统一入口（--action 参数路由）；优化：长文档排版性能（分批处理 + 单次保存 + 进度回调，大文档不卡顿）；增加：公式解释器 CLI 子命令（formula-explain）；增加：MD 转换 CLI 子命令（md-convert）；增加：长文档排版 CLI 子命令（long-document） |\n| v4.6.1 | 2026-08-16 | 修复：ASR 引擎改为显式 Opt-in 模式（auto 仅使用本地 whisper-local，不读取外部凭证）；修复：Azure/Google STT 仅在 method 显式指定时调用，首次使用显示凭证读取范围警告；修复：LLM 翻译改为显式 Opt-in 模式（auto 仅使用 local-rule，不读取 API Key）；修复：外部 SDK 依赖（google-cloud-speech / azure-cognitiveservices-speech）补充声明至 requirements.txt |\n| v4.6.0 | 2026-08-16 | 增加：Excel 智能分析统一入口 excel-smart（6 命令合并为 1 个 --action 路由）；增加：数据图表生成器 chart_recommender.py（数据特征分析 + 智能图表推荐 + 图表嵌入 Excel）；增加：文档翻译模块 document_translator.py（Word/Excel/PPT 多格式翻译 + 多模型降级链）；增加：翻译引擎降级链（cn-llm-router → local-rule → pure-template）；增加：图表推荐规则引擎（时间序列/类别对比/相关性/多变量）；增加：硬件自适应（低配禁用复杂图表渲染）；增加：术语表支持（JSON 格式可配置） |\n| v4.5.0 | 2026-08-05 | 增加：会议纪要生成模块 meeting_minutes.py（ASR 转写 → LLM 摘要 → Word 生成）；增加：ASR 降级链（whisper-local → azure-speech → google-stt → template）；增加：LLM 降级链（rule-engine → external-llm → pure-template）；增加：COM 健康检查模块 com_health.py（WPS/MS COM 状态检测 + 残留进程检测 + 自动释放）；增加：6 个 CLI 子命令（transcribe/summarize/generate/batch/wps-check/ms-check/residuals/release-all/full-check）；合并：避坑指南 20+ 条 + FAQ 15 个 + 错误 ID 15 个 → 统一故障排除大章（含统一索引表）；增加：音频分段处理（默认 5 分钟/段）+ 进度回调；增加：硬件自适应（低配禁用并行转写） |\n| v4.4.0 | 2026-07-30 | 增加：长文档排版自动化模块 long_document.py（自动目录生成/页眉页脚自动化/标题编号自动化/图表索引自动化/交叉引用自动化/格式统一/批量排版）；增加：8 个 CLI 子命令（analyze/toc/header/numbering/fig-index/xref/format/all/preview）；增加：多级标题编号引擎（支持中文/阿拉伯/罗马数字三种样式）；增加：图表索引自动生成（图 1-1 xxx / 表 1-1 xxx）；增加：交叉引用验证与自动修复；增加：格式统一预设模板（论文/标书/报告三种风格）；增加：性能优化（分批处理 + 进度回调 + 单次保存） |\n| v4.3.0 | 2026-07-23 | 增加：Excel 智能分析模块 excel_analyzer.py（公式自动纠错/数据清洗辅助/透视表自动生成/数据预测/NL2Formula 自然语言转公式/硬件自适应降级）；增加：6 个 CLI 子命令（profile/fix-formulas/pivot/predict/nl2formula/clean/hardware）；优化：数据类型探测算法（数值/日期/文本自动识别）；优化：透视表智能字段推荐（基于唯一值比例+数据类型）；增加：数据质量评分体系（0-100分） |\n| v4.1.0 | 2026-07-17 | 增加：PPT智能生成深度增强模块 ppt_generator.py（多源输入/演讲者备注/动画建议/配色适配/图表推荐/排练辅助）；增加：4 大工具 CLI 子命令扩展（docx-to-ppt/generate/nl-analyze/invoice/review）；增加：配色方案自动生成引擎；增加：演讲者备注双模式（模板引擎 + 外部 LLM 可选）；优化：PPT 生成流程重构为分层架构 |\n| v4.0.0 | 2026-07-13 | 增加：Word→PPT一键生成；增加：Excel自然语言数据分析；增加：Word合同条款审查标注；增加：Excel发票OCR入账；增加：4 个专用脚本（wps_docx_to_ppt/wps_nl_analysis/wps_contract_review/wps_invoice_ocr）；增加：Worker 路由扩展至 28 个命令 |\n| v3.1.0 | 2026-07-07 | 修复：模板安全问题（删除二进制文件，改为纯Python代码生成）；增加：20+避坑指南；增加：FAQ扩展到15个；增加：文件限制速查表 |\n| v3.0.0 | 2026-07-07 | 增加：自动重试机制（3次指数退避）；增加：硬件自适应（CPU/内存动态调整）；增加：Skill更新检查（7天提醒）；增加：常见问题FAQ（8个Q&A）；增加：CLI参数说明+返回结果示例；增加：反馈邮箱；增加：反模式FAQ（8个常见错误）；增加：最佳实践（10个案例）；增加：wps_performance.py 性能管理 |\n| v2.5.0 | 2026-07-03 | 增加：纯Python模式增强（排序/筛选/图表/公式/统计）；增加：文档模板目录；增加：10个最佳实践案例；增加：反模式FAQ |\n| v2.2.0 | 2026-06-30 | 增加：四引擎智能识别；增加：LibreOffice Headless 跨平台兜底；增加：纯Python格式设置/表格/图片插入 |\n| v2.1.0 | 2026-06-28 | 增加：目录生成；增加：环境自检；增加：反馈入口；增加：错误速查手册 |\n| v1.0.0 | 2026-06-28 | 初始版本，三大组件 + 格式转换 |\n\nFile v5.3.0:README.md\n\n# WPS Office 全家桶\n\n基于自然语言的 WPS Office 自动化 Skill，支持 Word/Excel/PPT 创建、编辑、格式转换。\n\n## 功能\n\n- 📄 **WPS 文字** - 创建/编辑/格式/导出\n- 📊 **WPS 表格** - 数据/公式/图表/筛选\n- 🎬 **WPS 演示** - 创建/幻灯片/主题/导出\n- 🔄 **格式转换** - Word/Excel/PPT/PDF 互转\n- 📁 **文档管理** - 打开/保存/最近文档\n\n## 使用方式\n\n```bash\npython scripts/wps_word.py create --title \"我的文档\"\npython scripts/wps_excel.py create --name \"预算表\"\npython scripts/wps_ppt.py create --title \"汇报\"\npython scripts/format_converter.py convert --input \"D:\\文档\\报告.docx\" --output-format pdf\n```\n\n## 依赖\n\n```bash\npip install -r requirements.txt\n```\n\n## 风险提示\n\n1. **文件安全**：操作前建议备份重要文件\n2. **格式兼容性**：部分复杂格式转换可能丢失原始排版\n3. **依赖要求**：需安装 WPS Office 2019+ 或 WPS 365\n\nFile v5.3.0:_meta.json\n\n{\n  \"ownerId\": \"kn7chdrwbdhaqkwajcyhtfvjx989ddb1\",\n  \"slug\": \"wps-office-suite\",\n  \"version\": \"5.3.0\",\n  \"publishedAt\": 1791513457090\n}\n\nFile v5.3.0:references/gongwen_rules.yaml\n\n# ============================================================\n# GB/T 9704-2012 党政机关公文格式 约束库\n# 用途：gongwen.py 排版引擎读取本文件，按规则对文档逐段套版\n# 设计：可维护、可扩展——新增文种/调整字号只需改本文件，不碰代码\n# ============================================================\n\nstandard: \"GB/T 9704-2012\"\nname: \"党政机关公文格式\"\n\n# ---------- 页面 ----------\npage:\n  size: \"A4\"\n  margin_top: \"37mm\"\n  margin_bottom: \"35mm\"\n  margin_left: \"28mm\"\n  margin_right: \"26mm\"\n  per_page_lines: 22      # 每面 22 行\n  per_line_chars: 28      # 每行 28 字（三号字）\n  grid: true              # 撑满版心\n\n# ---------- 字体规范 ----------\n# size 使用中文办公字号，引擎内部映射为磅值（二号=22pt，三号=16pt，四号=14pt）\nfonts:\n  title:\n    name: \"方正小标宋简体\"\n    fallback: \"宋体\"\n    size: \"二号\"\n    bold: true\n    color: \"000000\"\n    align: \"center\"\n    spacing_after: \"1行\"\n  redhead:                # 红头（发文机关标志）预留位\n    name: \"方正小标宋简体\"\n    fallback: \"宋体\"\n    size: \"初号\"\n    bold: true\n    color: \"FF0000\"\n    align: \"center\"\n  main_send:             # 主送机关\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"left\"\n    first_line_indent: \"0\"\n  body:\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"justify\"\n    first_line_indent: \"2字符\"\n    line_spacing_rule: \"fixed\"\n    line_spacing: \"28pt\"   # 固定值 28 磅 ≈ 一个三号字 + 行距\n  signature:             # 发文机关署名 + 成文日期\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"right\"\n  attachment_note:       # 附件说明\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"left\"\n    first_line_indent: \"2字符\"\n  annotation:            # 附注（居左圆括号）\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"left\"\n  footer:\n    page_number:\n      name: \"宋体\"\n      size: \"四号\"\n      format: \"- {n} -\"     # 页码格式：一字线夹阿拉伯数字\n\n# ---------- 结构层次序数 ----------\n# 公文正文内层级标识与对应字体\nstructure_levels:\n  - level: 1\n    marker: \"一、\"\n    font: \"黑体\"\n    size: \"三号\"\n    bold: true\n  - level: 2\n    marker: \"（一）\"\n    font: \"楷体_GB2312\"\n    fallback: \"楷体\"\n    size: \"三号\"\n  - level: 3\n    marker: \"1.\"\n    font: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    bold: true\n  - level: 4\n    marker: \"（1）\"\n    font: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n\n# ---------- 文种识别关键词 ----------\n# 用于从标题中判断文种，决定版式细节（如函/纪要差异）\ndoc_types:\n  - \"决议\"\n  - \"决定\"\n  - \"命令\"\n  - \"公报\"\n  - \"公告\"\n  - \"通告\"\n  - \"意见\"\n  - \"通知\"\n  - \"通报\"\n  - \"报告\"\n  - \"请示\"\n  - \"批复\"\n  - \"议案\"\n  - \"函\"\n  - \"纪要\"\n\n# ---------- 主送机关识别特征 ----------\n# 段落以这些词结尾（带全角冒号）视为主送机关行\nmain_send_markers:\n  - \"：\"\n  - \":\"\n\n# ---------- 落款识别特征 ----------\nsignature_markers:\n  - \"年\"\n  - \"月\"\n  - \"日\"\n  # 含日期且位于文末 3 段内，视为落款\n\n# ---------- 红头预留位 ----------\nredhead_placeholder: \"[红头：发文机关标志预留位]\"\nredhead_line_gap: 2      # 红头与标题之间的空行数\n\nFile v5.3.0:ARCHITECTURE.md\n\n# WPS Office Suite Skill 架构设计\n\n> **技能名称**：WPS Office Suite  \n> **中文名称**：WPS 全家桶  \n> **版本**：1.0.0  \n> **分类**：办公协作与生产力工具  \n> **目标平台**：Windows / macOS / Web  \n> **目标评分**：★★★★★ (4.8+/5.0)\n\n---\n\n## 一、市场定位与空白分析\n\n### 1.1 当前生态空白\n| 维度 | 现状 | 空白点 |\n|------|------|--------|\n| 国产办公 | SkillHub 仅有腾讯文档 Skill | WPS Office 全家桶（文字/表格/演示）完全空白 |\n| 深度集成 | 现有 Skill 仅做信息查询 | 缺乏\"创建→编辑→协作→格式转换\"全链路闭环 |\n| 用户覆盖 | 开发者导向严重 | 3 亿+ 国内办公人群的刚需未被满足 |\n| 平台互补 | 腾讯文档 Skill 单薄 | 与腾讯文档形成\"双办公生态\"互补 |\n\n### 1.2 目标用户画像\n- **核心用户**：国内办公白领、企业职员、学生群体\n- **使用场景**：日常文档处理、表格制作、演示汇报、格式转换\n- **痛点**：频繁在多个工具间切换、格式不兼容、协作流程繁琐\n\n---\n\n## 二、功能架构设计\n\n```\nWPS Office Suite Skill\n├── 📄 WPS 文字（Word）模块\n│   ├── 创建文档（从模板/空白）\n│   ├── 编辑文档（文本插入、格式设置、段落调整）\n│   ├── 页面设置（页边距、纸张、页眉页脚）\n│   ├── 目录生成与更新\n│   ├── 批注与修订\n│   └── 导出（DOCX/PDF/TXT）\n│\n├── 📊 WPS 表格（Excel）模块\n│   ├── 创建工作簿（多 Sheet 管理）\n│   ├── 数据录入与编辑\n│   ├── 公式与函数（SUM/AVERAGE/VLOOKUP 等常用函数）\n│   ├── 图表生成（柱状图/折线图/饼图）\n│   ├── 数据筛选与排序\n│   ├── 条件格式设置\n│   └── 导出（XLSX/CSV/PDF）\n│\n├── 🎬 WPS 演示（PPT）模块\n│   ├── 创建演示文稿\n│   ├── 幻灯片管理（添加/删除/排序）\n│   ├── 文本与图片插入\n│   ├── 版式与主题应用\n│   ├── 动画与切换效果\n│   └── 导出（PPTX/PDF/图片）\n│\n├── 🔄 格式转换中心\n│   ├── Word ↔ Excel ↔ PPT 互转\n│   ├── PDF → Word/Excel/PPT\n│   ├── Word/Excel/PPT → PDF\n│   └── 批量转换支持\n│\n├── 📁 文档管理\n│   ├── 打开本地文档\n│   ├── 保存到本地\n│   ├── 最近文档列表\n│   └── 文档属性查看\n│\n└── 🤝 协作功能\n    ├── 共享链接生成\n    ├── 协作权限设置\n    └── 版本历史查看\n```\n\n---\n\n## 三、技术架构设计\n\n### 3.1 运行模式\n```\n用户自然语言指令\n    ↓\nSKILL.md 解析与触发\n    ↓\n命令路由（判断模块）\n    ↓\n┌─────────────────────────────────────┐\n│  本地 WPS 应用（优先）               │\n│  ├── COM 接口调用（Windows）         │\n│  ├── AppleScript（macOS）            │\n│  └── WPS WebOffice API（备选）        │\n├─────────────────────────────────────┤\n│  云端 API（备选/混合模式）            │\n│  └── 金山文档开放平台 API             │\n│      ├── 文档操作 API                │\n│      ├── 表格操作 API                │\n│      ├── 格式转换 API                │\n│      └── 协作管理 API                │\n└─────────────────────────────────────┘\n    ↓\n执行结果返回\n    ↓\n自然语言回复用户\n```\n\n### 3.2 技术选型\n| 层级 | 技术方案 | 说明 |\n|------|----------|------|\n| 本地接口 | pywin32 / COM | Windows 下调用 WPS COM 接口 |\n| 本地接口 | appscript / pyobjc | macOS 下调用 WPS |\n| 云端 API | 金山文档开放平台 | 无 WPS 安装时的备选方案 |\n| 格式转换 | WPS 内置引擎 | 利用 WPS 强大的格式兼容能力 |\n| 脚本引擎 | Python 3.8+ | 主要脚本语言 |\n| 文件操作 | python-docx / openpyxl | 备选纯 Python 方案 |\n\n### 3.3 文件结构\n```\nwps-office-suite/\n├── SKILL.md                    # 技能定义文件（核心）\n├── README.md                   # 项目说明\n├── requirements.txt            # Python 依赖\n├── scripts/\n│   ├── wps_word.py             # WPS 文字操作脚本\n│   ├── wps_excel.py            # WPS 表格操作脚本\n│   ├── wps_ppt.py              # WPS 演示操作脚本\n│   ├── format_converter.py     # 格式转换脚本\n│   └── document_manager.py     # 文档管理脚本\n├── templates/\n│   ├── report_template.docx    # 报告模板\n│   ├── budget_template.xlsx    # 预算模板\n│   └── slide_template.pptx     # 演示模板\n├── config/\n│   ├── settings.json           # 配置文件\n│   └── api_keys.json           # API 密钥（用户自行配置）\n└── tests/\n    ├── test_word.py            # 文字模块测试\n    ├── test_excel.py           # 表格模块测试\n    └── test_ppt.py             # 演示模块测试\n```\n\n---\n\n## 四、SKILL.md 核心设计\n\n### 4.1 YAML Frontmatter 规范\n```yaml\n---\nname: wps-office-suite\ndescription: WPS Office 全家桶 - 支持 Word/Excel/PPT 创建、编辑、格式转换，自然语言驱动办公提效\nversion: 1.0.0\nauthor: 你的名字\ntrigger:\n  - \"帮我用WPS写个文档\"\n  - \"WPS文字处理\"\n  - \"WPS表格制作\"\n  - \"WPS演示文稿\"\n  - \"用WPS做个PPT\"\n  - \"WPS格式转换\"\n  - \"把PDF转成Word\"\n  - \"把Excel转成PPT\"\n  - \"WPS全家桶\"\n  - \"wps office\"\n  - \"创建文档\"\n  - \"制作表格\"\n  - \"做PPT\"\n  - \"文档格式转换\"\ncategory: 办公协作与生产力工具\nplatforms:\n  - windows\n  - macos\n  - web\npermission:\n  - 文件系统访问\n  - 应用程序控制（WPS Office）\n  - 网络访问（云端API备选）\ndependency:\n  - \"Python 3.8+\"\n  - \"WPS Office 2019+ 或 WPS 365\"\n  - \"pywin32（Windows）\"\n  - \"appscript（macOS）\"\npricing: 免费\ntags:\n  - WPS\n  - Office\n  - Word\n  - Excel\n  - PPT\n  - 文档处理\n  - 格式转换\n  - 办公提效\n---\n```\n\n### 4.2 触发词设计原则\n| 原则 | 示例 |\n|------|------|\n| 自然语言优先 | \"帮我用WPS写个报告\" 而非 \"WPS-CREATE-DOC\" |\n| 覆盖常见问法 | \"做PPT\" / \"做个演示文稿\" / \"WPS演示\" |\n| 避免歧义 | \"WPS文字处理\" 而非 \"处理文档\" |\n| 中英文兼容 | \"WPS office\" / \"wps office\" / \"WPS全家桶\" |\n\n---\n\n## 五、可运行命令设计\n\n### 5.1 WPS 文字命令\n| 命令 | 功能 | 示例 |\n|------|------|------|\n| `create_word` | 创建 Word 文档 | \"帮我创建一份工作总结\" |\n| `edit_word` | 编辑 Word 文档 | \"在文档末尾加一段\" |\n| `format_word` | 格式设置 | \"标题居中，正文首行缩进\" |\n| `export_word` | 导出文档 | \"把文档导出为PDF\" |\n\n### 5.2 WPS 表格命令\n| 命令 | 功能 | 示例 |\n|------|------|------|\n| `create_excel` | 创建 Excel 表格 | \"帮我做个预算表\" |\n| `input_data` | 数据录入 | \"在A1输入标题\" |\n| `add_formula` | 添加公式 | \"在C列求和\" |\n| `create_chart` | 生成图表 | \"根据数据生成柱状图\" |\n| `filter_data` | 数据筛选 | \"筛选出金额大于1000的\" |\n\n### 5.3 WPS 演示命令\n| 命令 | 功能 | 示例 |\n|------|------|------|\n| `create_ppt` | 创建 PPT | \"帮我做个项目汇报PPT\" |\n| `add_slide` | 添加幻灯片 | \"添加一页内容页\" |\n| `insert_content` | 插入内容 | \"插入标题和要点\" |\n| `apply_theme` | 应用主题 | \"使用商务主题\" |\n\n### 5.4 格式转换命令\n| 命令 | 功能 | 示例 |\n|------|------|------|\n| `convert_format` | 格式转换 | \"把PDF转成Word\" |\n| `batch_convert` | 批量转换 | \"批量把Word转成PDF\" |\n\n---\n\n## 六、安全与合规设计\n\n### 6.1 安全边界\n| 风险项 | 防护措施 |\n|--------|----------|\n| 文件泄露 | 所有操作仅在本地执行，不上传云端 |\n| 恶意代码 | 脚本经过安全扫描，无网络外发行为 |\n| 权限越权 | 仅访问用户明确指定的文件路径 |\n| 数据篡改 | 操作前备份，支持撤销 |\n| 隐私保护 | 不收集用户文档内容，不上传分析 |\n\n### 6.2 风险提示（SKILL.md 必须包含）\n```markdown\n## ⚠️ 风险提示\n\n1. **文件安全**：本技能会操作您的本地文档，建议重要文件提前备份\n2. **格式兼容性**：部分复杂格式转换可能丢失原始排版\n3. **依赖要求**：需要安装 WPS Office 2019 或 WPS 365 版本\n4. **系统权限**：需要文件系统访问和应用程序控制权限\n5. **网络访问**：仅在备选模式下使用云端 API，默认纯本地运行\n```\n\n---\n\n## 七、TRACE 评分优化策略\n\n### 7.1 T — Trust（可信任度）\n- 实名认证开发者\n- 代码开源可审计\n- 明确隐私政策\n- 无恶意行为记录\n\n### 7.2 R — Reliability（可靠性）\n- 完善的异常处理\n- 进度反馈机制\n- 操作结果确认\n- 支持撤销/重做\n\n### 7.3 A — Adaptability（适用性）\n- 支持 Windows/macOS/Web\n- 兼容 WPS 2019/2021/365\n- 支持多种文档格式\n- 适应不同用户习惯\n\n### 7.4 C — Convention（规范性）\n- 严格遵循 SKILL.md 规范\n- 清晰的 YAML frontmatter\n- 完整的 Markdown 文档\n- 语义化版本管理\n\n### 7.5 E — Effectiveness（有效性）\n- 解决真实办公痛点\n- 操作步骤简洁高效\n- 输出质量符合预期\n- 持续迭代优化\n\n---\n\n## 八、开发路线图\n\n### Phase 1：MVP（1-2 周）\n- [ ] 基础框架搭建\n- [ ] Word 创建/编辑/导出\n- [ ] Excel 创建/数据录入\n- [ ] PPT 创建/幻灯片管理\n- [ ] 本地 WPS 接口调用\n\n### Phase 2：增强版（3-4 周）\n- [ ] 格式转换中心\n- [ ] 模板系统\n- [ ] 公式与图表\n- [ ] 批量操作\n- [ ] 云端 API 备选\n\n### Phase 3：完整版（5-6 周）\n- [ ] 协作功能\n- [ ] 版本管理\n- [ ] 高级格式设置\n- [ ] 性能优化\n- [ ] 完整测试\n\n---\n\n## 九、审核准备清单\n\n- [ ] 实名认证完成\n- [ ] SKILL.md 完整规范\n- [ ] 本地测试通过\n- [ ] 安全扫描通过\n- [ ] 文档示例充分\n- [ ] 隐私政策明确\n- [ ] 版本号语义化\n- [ ] 触发词覆盖全面\n\n---\n\n*文档版本：v1.0.0*  \n*最后更新：2026-06-27*  \n*作者：你的名字*\n\nFile v5.3.0:skill-card.md\n\n## Description:\n\nAutomates the creation, editing, conversion, analysis, search, and redaction of office documents using available office software or Python tools.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[fyniujin](https://clawhub.ai/user/fyniujin)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nPeople and teams working with office documents use this skill to create and edit Word, Excel, and PowerPoint files, convert formats, and automate reporting and document workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Scheduled tasks can persistently execute commands; the security assessment also reports a local command-injection bug.\n\nMitigation: Review scheduled commands before use, especially custom --cmd values, and avoid schedule --force unless the exact command is trusted.\n\nRisk: Opening indexed files from untrusted or shared directories can expose the agent to unsafe document content.\n\nMitigation: Use doc-search --open only with trusted directories and review retrieved documents before acting on their contents.\n\nRisk: Optional external AI or cloud services may receive confidential documents.\n\nMitigation: Keep confidential material local unless the selected endpoint and credentials are approved for that data.\n\nRisk: Editing and converting documents can change files or lose complex formatting.\n\nMitigation: Back up important files and review converted or edited documents before distribution.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/fyniujin/skills/wps-office-suite)\n- [Usage and dependencies](README.md)\n- [Architecture](ARCHITECTURE.md)\n- [Official document formatting rules](references/gongwen_rules.yaml)\n\n## Skill Output:\n\n**Output Type(s):** [Files, Text, JSON, Guidance]\n\n**Output Format:** [Office documents, PDF, text, and optional JSON command results]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Output formats and features depend on the available office engine and optional services.]\n\n## Skill Version(s):\n\n5.3.0 (source: frontmatter and server release)\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\nFile v5.3.0:registry.json\n\n{\n  \"version\": \"5.3.0\",\n  \"description\": \"WPS Office 全家桶 统一命令入口注册表。cli_entry.py 查本表将 'wps <命令>' 分发到现有脚本，不改脚本内部逻辑。\",\n  \"apps\": {\n    \"word\": \"wps_word.py\",\n    \"excel\": \"wps_excel.py\",\n    \"ppt\": \"wps_ppt.py\"\n  },\n  \"commands\": {\n    \"word\": {\"script\": \"wps_word.py\", \"app\": \"word\", \"desc\": \"Word：创建/编辑/排版/导出/公文/会议纪要/长文档\"},\n    \"excel\": {\"script\": \"wps_excel.py\", \"app\": \"excel\", \"desc\": \"Excel：创建/输入/公式/排序/筛选/图表/分析/OCR\"},\n    \"ppt\": {\"script\": \"wps_ppt.py\", \"app\": \"ppt\", \"desc\": \"PPT：创建/生成/导出/主题/Word转PPT\"},\n    \"convert\": {\"script\": \"convert（合并 format_converter/md_converter/wps_docx_to_ppt）\", \"desc\": \"格式转换：docx/xlsx/pptx ↔ pdf/txt/html/csv/png（合并 format_converter/md_converter/docx_to_ppt）\"},\n    \"long-document\": {\"script\": \"long_document.py\", \"desc\": \"长文档排版：目录/页眉页脚/编号/交叉引用/图表索引\"},\n    \"gongwen\": {\"script\": \"gongwen.py\", \"desc\": \"公文一键排版：GB/T 9704 规则库，红头预留位/联合行文\"},\n    \"meeting-minutes\": {\"script\": \"meeting_minutes.py\", \"desc\": \"会议纪要：ASR转写→LLM摘要→Word（待办/决策/风险异议）\"},\n    \"excel-analyze\": {\"script\": \"excel_analyzer.py\", \"desc\": \"Excel 深度分析：数据画像/透视/预测/NL2SQL\"},\n    \"invoice-ocr\": {\"script\": \"wps_invoice_ocr.py\", \"desc\": \"发票 OCR 入账：PDF/图片→Excel 本地识别\"},\n    \"formula-explain\": {\"script\": \"formula_explainer.py\", \"desc\": \"公式解释：Excel 公式→自然语言解读\"},\n    \"ppt-generate\": {\"script\": \"ppt_generator.py\", \"desc\": \"PPT 智能生成：多源输入/演讲者备注/动画/配色\"},\n    \"docx-to-ppt\": {\"script\": \"wps_docx_to_ppt.py\", \"desc\": \"Word→PPT：章节分割→大纲→模板\"},\n    \"redact\": {\"script\": \"redact.py\", \"desc\": \"敏感信息打码：身份证/手机号/银行卡/邮箱双轨识别\"},\n    \"watermark\": {\"script\": \"watermark.py\", \"desc\": \"批量水印：文字/图片，平铺/对角线，docx/pptx/图片\"},\n    \"doc-search\": {\"script\": \"doc_search.py\", \"desc\": \"跨文档检索问答：本地 TF-IDF 零依赖\"},\n    \"template\": {\"script\": \"template_manager.py\", \"desc\": \"文档模板管理：代码生成类模板\"},\n    \"report\": {\"script\": \"report_generator.py\", \"desc\": \"报告生成：关键点→结构化 Word\"},\n    \"doc-manager\": {\"script\": \"document_manager.py\", \"desc\": \"文档管理：批量整理/重命名/归档\"},\n    \"doc-translate\": {\"script\": \"document_translator.py\", \"desc\": \"文档翻译：Word/Excel/PPT 多模型降级\"},\n    \"email-reply\": {\"script\": \"email_reply.py\", \"desc\": \"邮件智能回复：模板+LLM 个性化\"},\n    \"schedule\": {\"script\": \"schedule_register.py\", \"desc\": \"日程登记：文本/结构化→日历\"},\n    \"clarify\": {\"script\": \"clarify.py\", \"desc\": \"需求澄清：歧义检测→槽位填充\"},\n    \"com-health\": {\"script\": \"com_health.py\", \"desc\": \"COM 健康检查：WPS/MS/残留/强制释放\"},\n    \"usage-stats\": {\"script\": \"usage_stats.py\", \"desc\": \"使用统计：SQLite 埋点/引擎健康度\"},\n    \"feedback\": {\"script\": \"wps_feedback.py\", \"desc\": \"反馈提交：邮件/issue\"},\n    \"test\": {\"script\": \"wps_test.py\", \"desc\": \"环境自检：引擎/COM/依赖\"},\n    \"toc\": {\"script\": \"wps_toc.py\", \"desc\": \"目录生成：提取/插入 Word 目录\"},\n    \"watch\": {\"script\": \"watch.py\", \"desc\": \"文件监控：轮询+YAML 规则+大文件分片\"},\n    \"chart-recommend\": {\"script\": \"chart_recommender.py\", \"desc\": \"图表推荐：按数据特征推荐图表类型\"}\n  }\n}\n\nFile v5.3.0:templates/templates_index.json\n\n{\n  \"version\": \"4.9.0\",\n  \"total\": 56,\n  \"categories\": {\n    \"official\": {\n      \"label\": \"公文模板\",\n      \"count\": 12,\n      \"description\": \"政府/企业公文标准格式\"\n    },\n    \"contract\": {\n      \"label\": \"合同模板\",\n      \"count\": 10,\n      \"description\": \"各类商务合同范本\"\n    },\n    \"resume\": {\n      \"label\": \"简历模板\",\n      \"count\": 8,\n      \"description\": \"求职简历多种风格\"\n    },\n    \"bid\": {\n      \"label\": \"标书模板\",\n      \"count\": 8,\n      \"description\": \"投标书标准格式\"\n    },\n    \"report\": {\n      \"label\": \"报告模板\",\n      \"count\": 10,\n      \"description\": \"各类工作报告/调研报告\"\n    },\n    \"meeting\": {\n      \"label\": \"会议模板\",\n      \"count\": 8,\n      \"description\": \"会议纪要/议程/记录\"\n    }\n  },\n  \"templates\": [\n    {\n      \"name\": \"通知\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"标准公文通知格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发文单位\", \"日期\"]\n    },\n    {\n      \"name\": \"请示\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"向上级请示标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"请示事项\", \"日期\"]\n    },\n    {\n      \"name\": \"报告\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"向上级报告标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"工作概况\", \"日期\"]\n    },\n    {\n      \"name\": \"函\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"商务往来函标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发函单位\", \"收函单位\", \"日期\"]\n    },\n    {\n      \"name\": \"会议纪要\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"公文会议纪要标准格式\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"参会人员\", \"会议内容\", \"决议事项\"]\n    },\n    {\n      \"name\": \"决定\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"行政决定标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发文单位\", \"日期\"]\n    },\n    {\n      \"name\": \"批复\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"上级批复标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"批复单位\", \"日期\"]\n    },\n    {\n      \"name\": \"通报\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"通报标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发文单位\", \"日期\"]\n    },\n    {\n      \"name\": \"公告\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"公开公告标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发布单位\", \"日期\"]\n    },\n    {\n      \"name\": \"议案\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"人大/政协议案标准格式\",\n      \"placeholders\": [\"案由\", \"理由\", \"办法\", \"提案人\", \"日期\"]\n    },\n    {\n      \"name\": \"工作总结\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"年度/季度工作总结\",\n      \"placeholders\": [\"标题\", \"工作概况\", \"主要成绩\", \"存在问题\", \"下步计划\", \"日期\"]\n    },\n    {\n      \"name\": \"工作计划\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"年度/季度工作计划\",\n      \"placeholders\": [\"标题\", \"指导思想\", \"工作目标\", \"具体措施\", \"时间安排\", \"日期\"]\n    },\n    {\n      \"name\": \"买卖合同\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"标准商品买卖合同范本\",\n      \"placeholders\": [\"买方\", \"卖方\", \"标的物\", \"数量\", \"单价\", \"总价\", \"交货地点\", \"付款方式\", \"违约责任\", \"签订日期\"]\n    },\n    {\n      \"name\": \"租赁合同\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"房屋租赁/设备租赁合同\",\n      \"placeholders\": [\"出租方\", \"承租方\", \"租赁物\", \"租赁期限\", \"租金\", \"押金\", \"签订日期\"]\n    },\n    {\n      \"name\": \"服务合同\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"咨询服务/技术服务合同\",\n      \"placeholders\": [\"委托方\", \"受托方\", \"服务内容\", \"服务期限\", \"费用\", \"签订日期\"]\n    },\n    {\n      \"name\": \"劳动合同\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"标准劳动合同范本\",\n      \"placeholders\": [\"用人单位\", \"劳动者\", \"合同期限\", \"工作地点\", \"岗位\", \"薪资\", \"签订日期\"]\n    },\n    {\n      \"name\": \"保密协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"商业秘密保密协议\",\n      \"placeholders\": [\"甲方\", \"乙方\", \"保密内容\", \"保密期限\", \"违约责任\", \"签订日期\"]\n    },\n    {\n      \"name\": \"竞业限制协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"竞业禁止协议范本\",\n      \"placeholders\": [\"用人单位\", \"劳动者\", \"限制期限\", \"补偿金\", \"签订日期\"]\n    },\n    {\n      \"name\": \"投资协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"股权投资/融资协议\",\n      \"placeholders\": [\"投资方\", \"融资方\", \"投资金额\", \"股权比例\", \"签订日期\"]\n    },\n    {\n      \"name\": \"合伙协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"合伙企业合伙协议\",\n      \"placeholders\": [\"合伙人\", \"出资方式\", \"利润分配\", \"入伙退伙\", \"签订日期\"]\n    },\n    {\n      \"name\": \"委托书\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"授权委托书标准格式\",\n      \"placeholders\": [\"委托人\", \"受托人\", \"委托事项\", \"委托权限\", \"委托期限\", \"日期\"]\n    },\n    {\n      \"name\": \"和解协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"民事/商事和解协议\",\n      \"placeholders\": [\"甲方\", \"乙方\", \"纠纷事实\", \"和解条款\", \"签订日期\"]\n    },\n    {\n      \"name\": \"经典简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"经典简洁风格简历\",\n      \"placeholders\": [\"姓名\", \"联系方式\", \"求职意向\", \"教育背景\", \"工作经历\", \"技能特长\"]\n    },\n    {\n      \"name\": \"现代简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"现代蓝色主题简历\",\n      \"placeholders\": [\"姓名\", \"联系方式\", \"求职意向\", \"教育背景\", \"工作经历\", \"技能特长\"]\n    },\n    {\n      \"name\": \"商务简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"深色商务风格简历\",\n      \"placeholders\": [\"姓名\", \"联系方式\", \"求职意向\", \"教育背景\", \"工作经历\", \"技能特长\"]\n    },\n    {\n      \"name\": \"应届生简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"应届生专用简历模板\",\n      \"placeholders\": [\"姓名\", \"联系方式\", \"求职意向\", \"教育背景\", \"实习经历\", \"获奖情况\"]\n    },\n    {\n      \"name\": \"英文简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"标准英文简历模板\",\n      \"placeholders\": [\"Name\", \"Contact\", \"Objective\", \"Education\", \"Experience\", \"Skills\"]\n    },\n    {\n      \"name\": \"简历封面\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"简历封面页模板\",\n      \"placeholders\": [\"姓名\", \"应聘职位\", \"毕业院校\", \"联系方式\"]\n    },\n    {\n      \"name\": \"自荐信\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"求职自荐信模板\",\n      \"placeholders\": [\"姓名\", \"应聘职位\", \"自我介绍\", \"能力优势\", \"期望薪资\", \"联系方式\"]\n    },\n    {\n      \"name\": \"转岗申请\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"内部转岗申请模板\",\n      \"placeholders\": [\"姓名\", \"现岗位\", \"申请岗位\", \"转岗原因\", \"相关经验\", \"日期\"]\n    },\n    {\n      \"name\": \"投标书封面\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"投标书封面/封套模板\",\n      \"placeholders\": [\"项目名称\", \"招标编号\", \"投标人\", \"日期\"]\n    },\n    {\n      \"name\": \"技术标书\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"技术标书模板（技术方案部分）\",\n      \"placeholders\": [\"项目名称\", \"技术方案\", \"实施计划\", \"项目团队\", \"质量保证\"]\n    },\n    {\n      \"name\": \"商务标书\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"商务标书模板（报价/资质部分）\",\n      \"placeholders\": [\"项目名称\", \"总报价\", \"分项报价\", \"资质证明\", \"业绩证明\"]\n    },\n    {\n      \"name\": \"施工组织设计\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"工程施工组织设计模板\",\n      \"placeholders\": [\"工程名称\", \"编制依据\", \"施工部署\", \"进度计划\", \"资源配置\"]\n    },\n    {\n      \"name\": \"项目管理方案\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"IT项目管理实施方案模板\",\n      \"placeholders\": [\"项目名称\", \"项目范围\", \"实施计划\", \"风险管理\", \"验收标准\"]\n    },\n    {\n      \"name\": \"售后服务承诺\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"售后服务及质保承诺模板\",\n      \"placeholders\": [\"服务承诺\", \"响应时间\", \"质保期限\", \"培训计划\", \"联系方式\"]\n    },\n    {\n      \"name\": \"财务报表\",\n      \"category\": \"bid\",\n      \"format\": \"xlsx\",\n      \"description\": \"财务报表模板（资产负债表/利润表/现金流量表）\",\n      \"placeholders\": [\"编制单位\", \"会计期间\", \"金额\"]\n    },\n    {\n      \"name\": \"报价表\",\n      \"category\": \"bid\",\n      \"format\": \"xlsx\",\n      \"description\": \"分项报价明细表模板\",\n      \"placeholders\": [\"项目名称\", \"规格型号\", \"单位\", \"数量\", \"单价\", \"合价\"]\n    },\n    {\n      \"name\": \"调研报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"调研报告标准模板\",\n      \"placeholders\": [\"调研背景\", \"调研方法\", \"调研结果\", \"分析结论\", \"对策建议\"]\n    },\n    {\n      \"name\": \"市场分析报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"市场分析/行业研究报告模板\",\n      \"placeholders\": [\"报告摘要\", \"行业概况\", \"市场分析\", \"竞争格局\", \"趋势预测\"]\n    },\n    {\n      \"name\": \"项目总结报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"项目完成总结报告模板\",\n      \"placeholders\": [\"项目背景\", \"实施过程\", \"成果效益\", \"经验教训\", \"后续计划\"]\n    },\n    {\n      \"name\": \"财务分析报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"企业财务分析报告模板\",\n      \"placeholders\": [\"报告期间\", \"财务概况\", \"偿债能力\", \"盈利能力\", \"运营能力\", \"发展能力\"]\n    },\n    {\n      \"name\": \"可行性分析报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"项目可行性分析报告模板\",\n      \"placeholders\": [\"项目概述\", \"市场分析\", \"技术方案\", \"投资估算\", \"效益分析\", \"风险分析\"]\n    },\n    {\n      \"name\": \"审计报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"内部审计/离任审计报告模板\",\n      \"placeholders\": [\"审计对象\", \"审计范围\", \"审计发现\", \"审计意见\", \"整改建议\"]\n    },\n    {\n      \"name\": \"尽职调查报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"投资/并购尽职调查报告模板\",\n      \"placeholders\": [\"公司概况\", \"业务分析\", \"财务分析\", \"法律风险\", \"投资建议\"]\n    },\n    {\n      \"name\": \"述职报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"领导干部/员工述职报告模板\",\n      \"placeholders\": [\"岗位职责\", \"履职情况\", \"存在问题\", \"改进方向\", \"工作计划\"]\n    },\n    {\n      \"name\": \"PPT方案汇报\",\n      \"category\": \"report\",\n      \"format\": \"pptx\",\n      \"description\": \"项目方案/工作汇报PPT模板\",\n      \"placeholders\": [\"汇报人\", \"项目名称\", \"核心内容\", \"实施计划\", \"预期成果\"]\n    },\n    {\n      \"name\": \"会议议程\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"会议议程/日程安排模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"会议地点\", \"参会人员\", \"议程安排\"]\n    },\n    {\n      \"name\": \"会议签到表\",\n      \"category\": \"meeting\",\n      \"format\": \"xlsx\",\n      \"description\": \"会议签到/考勤表模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"参会人员\", \"签到时间\"]\n    },\n    {\n      \"name\": \"董事会决议\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"董事会决议标准模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"出席董事\", \"议案内容\", \"表决结果\"]\n    },\n    {\n      \"name\": \"股东会决议\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"股东会决议标准模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"出席股东\", \"议案内容\", \"表决结果\"]\n    },\n    {\n      \"name\": \"办公会纪要\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"总经理办公会/例会纪要模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"主持人\", \"参会人员\", \"议题内容\", \"会议决议\"]\n    },\n    {\n      \"name\": \"培训签到表\",\n      \"category\": \"meeting\",\n      \"format\": \"xlsx\",\n      \"description\": \"培训签到/记录表模板\",\n      \"placeholders\": [\"培训主题\", \"培训时间\", \"培训讲师\", \"参训人员\", \"签到时间\"]\n    },\n    {\n      \"name\": \"会议记录表\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"会议过程详细记录表模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"记录人\", \"发言内容\", \"决议事项\"]\n    },\n    {\n      \"name\": \"工作周报\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"个人工作周报模板\",\n      \"placeholders\": [\"姓名\", \"部门\", \"本周完成\", \"下周计划\", \"需要协调\"]\n    }\n  ]\n}\n\nFile v5.3.0:requirements.txt\n\npywin32>=303; sys_platform == \"win32\"\npython-docx>=0.8.11\nopenpyxl>=3.1.1\nPillow>=9.0.0\npython-pptx>=0.6.21\n\n# 以下为可选依赖，需显式安装使用对应外部服务\n# Google Cloud Speech API（语音转写，可选）\n# pip install google-cloud-speech\n# \n# Azure Cognitive Services Speech（语音转写，可选）\n# pip install azure-cognitiveservices-speech\n\nArchive v5.2.5: 56 files, 264431 bytes\n\nFiles: ARCHITECTURE.md (10521b), README.md (958b), references/gongwen_rules.yaml (3506b), requirements.txt (371b), scripts/chart_recommender.py (14816b), scripts/clarify.py (13148b), scripts/com_health.py (26531b), scripts/conditional_format_io.py (15694b), scripts/doc_search.py (11058b), scripts/document_manager.py (5005b), scripts/document_translator.py (19200b), scripts/email_reply.py (34772b), scripts/excel_analyzer.py (49984b), scripts/format_converter.py (6286b), scripts/formula_explainer.py (17493b), scripts/gongwen.py (11014b), scripts/kingdoc_bridge.py (17359b), scripts/llm_bridge.py (14136b), scripts/long_document.py (47917b), scripts/md_converter.py (15769b), scripts/meeting_minutes.py (46320b), scripts/nl2sql_engine.py (29165b), scripts/pipeline_bridge.py (13775b), scripts/ppt_generator.py (36950b), scripts/redact.py (7850b), scripts/report_generator.py (23299b), scripts/schedule_register.py (23066b), scripts/template_manager.py (24136b), scripts/usage_stats.py (22341b), scripts/validation_io.py (9907b), scripts/watch.py (29747b), scripts/watermark.py (10861b), scripts/wps_ai.py (10296b), scripts/wps_common.py (8269b), scripts/wps_docx_to_ppt.py (15447b), scripts/wps_engine.py (4093b), scripts/wps_error.py (10326b), scripts/wps_excel.py (18502b), scripts/wps_feedback.py (2830b), scripts/wps_invoice_ocr.py (12045b), scripts/wps_ms.py (3257b), scripts/wps_nl_analysis.py (13727b), scripts/wps_performance.py (5649b), scripts/wps_ppt.py (5139b), scripts/wps_pure_enhancements.py (23077b), scripts/wps_pure.py (29423b), scripts/wps_test.py (8261b), scripts/wps_toc.py (7484b), scripts/wps_update.py (3689b), scripts/wps_word.py (14694b), scripts/wps_worker.py (31840b), skill-card.md (2575b), SKILL.md (56833b), templates/generate_templates.py (13622b), templates/templates_index.json (14466b), _meta.json (135b)\n\nFile v5.2.5:SKILL.md\n\n---\nname: wps-office-suite\ndescription: WPS Office 全家桶 - 四引擎（WPS/MS Office/LibreOffice/纯Python）智能识别用户已安装软件，纯Python模式支持排序/筛选/图表/公式/统计，含文档模板（代码生成）、最佳实践案例、故障排除大章（20+避坑+15 FAQ+15错误ID 统一索引）、自动重试、硬件自适应、环境自检、Skill更新提醒；v5.1新增：kingdoc云端桥接（白名单探测+配置预检+subprocess上传+差异检查）、条件格式/数据验证跨引擎IO（JSON中间格式保真往返）、会议纪要三段式要素化（待办清单+决策记录+风险异议）+说话人标注（MFCC聚类）；v5.2新增：公文一键排版（GB/T 9704 规则库约束+结构识别套版+红头预留位+联合行文）、批量水印与敏感信息打码（身份证/手机号/银行卡/邮箱双轨识别+黑色矩形覆盖+打码清单）、跨文档知识检索与问答（本地TF-IDF零依赖+跳转+可选zwjh记忆桥接）；删除：与contract-review重复的轻量合同审查模块，改为文档互链引导；v5.2.5修复：MS Office引擎下Excel/PPT创建必然失败（错用Word COM对象），新增get_ms_excel/get_ms_ppt及三槽位统一释放release_ms，MS Office路径透传filepath参数\nversion: 5.2.5\n---\n\n\n# WPS Office 全家桶 v5.2.5 ✅\n\n> 🏗️ **四引擎智能识别**：自动检测用户电脑已安装的软件，按 WPS → MS Office → LibreOffice → 纯Python 顺序选择最合适的引擎\n> ✨ **纯Python模式增强 v4.8**：排序、筛选、图表、公式、统计、条件格式、数据验证、合并单元格、命名区域 — 跨平台全部支持\n> 🔄 **自动重试**：WPS 卡住时自动重试 3 次，不用手动重启\n> ⚡ **硬件自适应**：自动检测 CPU 内存，动态调整超时和线程，不拖累电脑\n> 📚 **文档模板 + 最佳实践 + 故障排除**：代码生成3个即用模板 + 10个最佳实践案例 + 统一故障排除大章\n> 📬 **Skill 更新提醒**：自动检查新版本，7天提醒一次，保持最新\n> 🆕 **文件大小明确限制**：单文件 < 50MB 直接处理，> 50MB 有分片建议\n> 🔬 **Excel 智能分析 v4.6**：6命令合并为 1 个统一入口（--action 参数路由）\n> 📊 **数据图表生成器 v4.6**：基于数据特征自动推荐图表类型 + 生成图表嵌入 Excel\n> 🌐 **文档翻译 v4.6**：Word/Excel/PPT 专业翻译（支持多模型降级）\n> 🎙️ **会议纪要 v4.5**：音频 → ASR 转写 → LLM 摘要 → Word（支持降级链）\n> 🏥 **COM 健康检查 v4.5**：WPS/MS Office 状态检测 + 残留进程清理\n> 🧮 **公式解释器 v4.7**：Excel 公式 → 自然语言解释（反向 NL2Formula，纯本地实现）\n> 📝 **Markdown 转换 v4.7**：MD → Word/PPT（保留标题层级，纯本地实现）\n> 📑 **长文档排版 v4.7**：统一入口 long-document --action（8命令合并），性能优化（分批+单次保存+进度回调）\n> ✉️ **邮件智能回复 v4.8**：模板匹配 + LLM 个性化回复（纯本地，多模型降级）\n> 📊 **周报/月报生成 v4.8**：关键点 → 结构化 Word 报告（模板 + 可选 LLM 润色）\n> 🤖 **AI 统一入口 v4.9**：`wps ai --action` 统一 9 大 AI 功能入口（新增续写/改写/扩写）\n> 🌉 **llm_bridge 桥接层 v4.9**：统一模型层，白名单探测 cn-llm-router，零配置多模型调用\n> 📋 **模板市场 v4.9**：50+ 内置模板（公文/合同/简历/标书/报告/会议），支持用户沉淀和分享\n> 💬 **NL2Formula 多轮澄清 v4.9**：歧义检测 → 槽位填充 → 反向验证，公式生成更精准\n> ⏰ **定时任务 v5.0**：schtasks/crontab 注册管理，周报/月报/数据刷新一键定时\n> 👁️ **目录监听 v5.0**：轮询监听 + YAML规则 + 大文件自动分片 + LibreOffice并发控制\n> 📊 **稳定性中心 v5.0**：SQLite埋点统计 + 引擎健康度 + 全局engine-info + 引擎偏好配置\n> 🏥 **COM自愈 v5.0**：三步自愈（regsvr32 → 修复安装 → 手动指引），每步记录日志\n> 💬 **对话式查询 v5.0**：NL2SQL式意图解析 + 查询计划生成 + 连续追问，Top20关键词模板降级\n> 🔗 **编排引擎桥接 v5.0**：白名单探测 multi-agent-orchestrator，命中注册流水线模板，未装本地串行降级\n> ☁️ **kingdoc 桥接 v5.1**：白名单探测+配置预检+subprocess 上传金山文档，difflib 差异检查\n> 🔄 **跨引擎 IO v5.1**：条件格式/数据验证 JSON 中间格式，WPS↔纯 Python 保真往返\n> 📋 **纪要要素化 v5.1**：三段式结构（待办清单+决策记录+风险异议）+ 说话人标注\n> 📑 **公文一键排版 v5.2**：GB/T 9704 规则库约束 + 结构识别套版，支持红头预留位与联合行文，处理前自动备份\n> 🔒 **批量水印与打码 v5.2**：文字/图片水印（平铺/对角线，批量目录）；敏感信息双轨识别（身份证/手机号/银行卡/邮箱）+ 黑色矩形覆盖 + 打码清单\n> 🔍 **跨文档检索 v5.2**：本地 TF-IDF 零依赖索引，跨文档找内容问答，命中返回文件+段落+跳转，可选 embedding 与 zwjh 记忆桥接\n> 🔗 **合同审查改互链 v5.2**：裁撤重复合同审查模块，完整审查请安装 contract-review（互链引导，无代码依赖）\n> 📧 **建议反馈**：有更好建议？邮箱：[njskills@agent.qq.com](mailto:njskills@agent.qq.com)\n\n---\n\n## 🚀 分钟上手\n\n### 1. 检查环境\n\n```bash\npython scripts/wps_test.py\n```\n\n### 2. 查看当前引擎 + 硬件\n\n```bash\npython scripts/wps_excel.py engine-info\n```\n\n### 3. 创建文件\n\n```bash\npython scripts/wps_word.py create --title \"测试文档\"\npython scripts/wps_excel.py create --name \"预算表\" --sheets \"收入,支出\"\npython scripts/wps_ppt.py create --title \"推广方案\"\n```\n\n### 4. 检查更新\n\n```bash\npython scripts/wps_excel.py check-update\n```\n\n### 5. 生成模板（代码生成，无二进制文件）\n\n```bash\npython templates/generate_templates.py --dir ./output\n```\n\n---\n\n## ⚡ 硬件自适应\n\n| 硬件等级 | CPU / 内存 | 超时 | 并行数 | 适用场景 |\n|---------|-----------|------|-------|---------|\n| 高性能 | 8核+ / 16G+ | 30s | 8线程 | 批量处理、大文件 |\n| 中等 | 4核+ / 8G+ | 60s | 4线程 | 日常办公 |\n| 低性能 | 2核 / 4G | 120s | 1线程 | 轻量任务 |\n\n---\n\n## 🔧 功能矩阵\n\n| 功能 | WPS | MS Office | LibreOffice | 纯Python |\n|------|-----|-----------|-------------|----------|\n| **创建/编辑/格式 — Word** | ✅ | ✅ | ✅（回退） | ✅ |\n| **表格/图片/目录 — Word** | ✅ | ✅ | ❌ | ✅ |\n| **创建/编辑/公式/图表 — Excel** | ✅ | ✅（回退） | ✅（回退） | ✅ |\n| **排序/筛选/统计 — Excel** | ✅ | ✅（回退） | ✅（回避） | ✅ |\n| **条件格式/数据验证 — Excel** | ✅ | ✅（回退） | ❌ | ✅（v4.8 新增） |\n| **幻灯片/主题/插入 — PPT** | ✅ | ❌ | ❌ | ❌ |\n| **PPT 创建/多页 — PPT** | ✅ | ✅ | ✅（回退） | ✅ |\n\n> ✅（回退）= 原生引擎不支持时，自动回退到纯 Python 实现\n\n---\n\n## 📂 文档模板（代码生成，零二进制文件）\n\n| 模板 | 用途 | 生成命令 |\n|------|------|---------|\n| 工作报告 | 周报/月报/汇报 | `python templates/generate_templates.py --dir ./output` |\n| 月度预算 | 收入/支出/汇总 | 同上 |\n| 商务PPT | 项目汇报/方案 | 同上 |\n\n> 模板通过纯 Python 代码动态生成，无需分发二进制文件。首次运行需安装 `python-docx`、`openpyxl`、`python-pptx`。\n\n---\n\n## ⚠️ 文件限制速查\n\n| 限制项 | 阈值建议 | 超出后处理方式 |\n|--------|---------|--------------|\n| **单文件大小** | < 50MB 直接处理 | > 50MB 先分片（拆 Sheet/Section） |\n| **批量文件数** | 建议 ≤ 50 个/批 | 超过时分批调用 |\n| **Excel 行数** | < 100,000 行 | 超过时分 Sheet 存储 |\n| **PPT 页数** | < 100 页 | 拆分为多个文件 |\n| **并发操作** | 同一引擎 1 个实例 | 串行等待，避免并行写同一文件 |\n| **文件名长度** | < 200 字符 | 过短路径避免中文 |\n\n---\n\n## 🔧 故障排除大章（v4.5 合并，统一索引）\n\n### 统一索引表\n\n| 类型 | 问题 | 快速解决 |\n|------|------|---------|\n| 🚫 避坑 | WPS 未安装就调用 | 运行 engine-info 检查引擎 |\n| 🚫 避坑 | 公式写入显示 #NAME? | 按 Ctrl+Alt+F9 重新计算 |\n| 🚫 避坑 | 中文路径编码错误 | 改用英文路径或 raw string |\n| 🚫 避坑 | 大文件内存溢出 | >50MB 分片处理 |\n| 🚫 避坑 | WPS 卡住无响应 | 已自动重试3次，不行就任务管理器结束 |\n| 🚫 避坑 | COM 对象残留 | Worker 自动释放，或运行 com-health release-all |\n| 🚫 避坑 | PPT 添加幻灯片失败 | 仅 WPS 支持，或一次性指定 slides_content |\n| 🚫 避坑 | openpyxl 读取公式为 None | 先 WPS 打开保存一次 |\n| 🚫 避坑 | 排序/筛选/图表错乱 | 确保第一行是表头，列名完全一致 |\n| 🚫 避坑 | 筛选返回空结果 | 数值 value 必须是字符串 |\n| ⚠️ FAQ | 该选哪个引擎？ | 自动检测，无需手动选择 |\n| ⚠️ FAQ | WPS 版本有要求？ | 2019+ 或 WPS 365，安装后必须重启 |\n| ⚠️ FAQ | 纯Python vs WPS 区别？ | 公式计算/图表/添加幻灯片不同 |\n| ⚠️ FAQ | 文件太大怎么办？ | <50MB 直接处理，>50MB 分片 |\n| ⚠️ FAQ | Linux 能用吗？ | 能，安装 LibreOffice |\n| ⚠️ FAQ | WPS 卡住怎么办？ | 自动重试3次，不行结束进程 |\n| ⚠️ FAQ | 纯Python 安装依赖？ | pip install python-docx openpyxl python-pptx |\n| ⚠️ FAQ | 模板如何获取？ | 代码生成，运行 generate_templates.py |\n| ⚠️ FAQ | 批量转换格式？ | format_converter.py batch |\n| ⚠️ FAQ | 多 Sheet 处理？ | 逐 Sheet 调用或 add-sheet |\n| ⚠️ FAQ | 排序/筛选总失败？ | 确保 openpyxl 安装、文件未占用 |\n| ⚠️ FAQ | 如何提交反馈？ | wps_feedback.py email 或发邮件 |\n| ⚠️ FAQ | 公式何时计算？ | 打开文件时由 Excel/WPS 计算 |\n| ⚠️ FAQ | 文件被占用怎么办？ | 关闭程序，等待3-5秒重试 |\n| ⚠️ FAQ | 纯Python 不可用功能？ | 添加幻灯片/插入/主题/VBA/条件格式 |\n| 🚨 错误ID | E001 WPS 未安装或 COM 注册失败 | 安装 WPS 后重启电脑 |\n| 🚨 错误ID | E002 python-docx 未安装 | pip install python-docx openpyxl python-pptx |\n| 🚨 错误ID | E003 文件路径不存在 | 改用英文路径或以管理员运行 |\n| 🚨 错误ID | E004 格式转换失败 | 安装 WPS 或 LibreOffice |\n| 🚨 错误ID | E005 需要 WPS 模式 | 安装 WPS 或改用纯Python模式 |\n| 🚨 错误ID | E006 WPS 卡住无响应 | 任务管理器结束进程；更新到最新版 |\n| 🚨 错误ID | E007 权限不足 | 以管理员运行；检查文件只读属性 |\n| 🚨 错误ID | E008 pywin32 导入失败 | pip uninstall pywin32 && pip install pywin32 |\n| 🚨 错误ID | E009 Python 版本过低 | 升级到 Python 3.8+ |\n| 🚨 错误ID | E010 引擎不支持此功能 | 安装 WPS 或改用 info 查看能力矩阵 |\n| 🚨 错误ID | E011 LibreOffice 未安装 | 下载 LibreOffice 并添加到 PATH |\n| 🚨 错误ID | E012 LibreOffice 转换失败 | 检查源文件是否损坏；避免中文路径 |\n| 🚨 错误ID | E013 文件不存在 | 确认路径正确；未被删除或移动 |\n| 🚨 错误ID | E014 未知运行时错误 | 运行环境自检 wps_test.py；联系反馈 |\n| 🚨 错误ID | E015 不支持的操作或格式 | 输出格式改为 pdf/txt/html |\n\n---\n\n## 🚫 避坑详解（20+ 条）\n\n### 🥇 高频问题（TOP 10）\n\n#### ❌ 坑 1：WPS 没安装就调用 WPS 功能\n\n```\n症状：win32com.com_error 或 \"WPS 未安装\"\n排查：\n  1. 运行 python scripts/wps_excel.py engine-info 检查当前引擎\n  2. 如果显示 PURE 或 LIBREOFFICE，说明 WPS 不可用\n  3. 安装 WPS Office 2019+ 后重启电脑\n```\n\n#### ❌ 坑 2：纯 Python 模式下写公式，打开 Excel 显示 #NAME?\n\n```\n症状：公式写入后打开显示 #NAME? 错误\n排查：\n  1. openpyxl 写的是公式字符串，打开时需 Excel/WPS 重新计算\n  2. 解决：按 Ctrl+Alt+F9 强制重新计算\n  3. 或切换到 WPS 模式自动计算\n```\n\n#### ❌ 坑 3：中文路径编码错误\n\n```\n症状：UnicodeEncodeError 或 FileNotFoundError\n排查：\n  1. 避免中文路径：D:\\docs\\report.docx ✅\n  2. 路径加引号：\"D:\\中文\\报告.docx\" ✅\n  3. 使用 raw string：r\"D:\\中文\\报告.docx\" ✅\n```\n\n#### ❌ 坑 4：大文件内存溢出\n\n```\n症状：MemoryError 或程序卡死\n排查：\n  1. 先运行 python scripts/wps_word.py info --file big.docx 查看大小\n  2. < 50MB 直接处理\n  3. > 50MB 拆分处理：分 Sheet/Section\n  4. 硬件自适应会自动延长超时\n```\n\n#### ❌ 坑 5：WPS 卡住无响应\n\n```\n症状：操作超时（30s/60s/120s）\n排查：\n  1. Skill 已自动重试 3 次（等 1s → 2s → 4s）\n  2. 仍失败则：任务管理器 → 结束 WPS 进程\n  3. 反复出现：pip install --upgrade pywin32\n```\n\n#### ❌ 坑 6：COM 对象残留\n\n```\n症状：第二次调用报 \"RPC 服务器不可用\"\n排查：\n  1. Worker 已内置自动释放（每次操作后调用 release_wps）\n  2. 手动清理：任务管理器 → 结束 kwps.exe\n  3. 避免频繁创建/销毁 Worker，使用 stdin/stdout 协议\n```\n\n#### ❌ 坑 7：PPT 添加幻灯片失败\n\n```\n症状：纯Python模式不支持添加幻灯片\n排查：\n  1. 添加幻灯片、插入内容、主题应用仅 WPS 支持\n  2. 替代方案：用 pure_create_ppt 创建时指定 slides_content 一次生成多页\n  3. 或安装 WPS Office\n```\n\n#### ❌ 坑 8：openpyxl 读取公式为 None\n\n```\n症状：读取含公式的单元格返回 None\n排查：\n  1. openpyxl 默认读取缓存值（data_only=True）\n  2. 如果从未在 Excel 中打开计算，缓存值为 None\n  3. 解决：先在 WPS 中打开保存一次，或改用公式计算\n```\n\n#### ❌ 坑 9：sort 命令排序错乱\n\n```\n症状：排序结果不对\n排查：\n  1. 确保第一行是表头（不参与排序）\n  2. 列名参数 column 需与表头完全一致（区分大小写）\n  3. 多列排序时注意优先级顺序\n```\n\n#### ❌ 坑 10：filter 筛选返回空结果\n\n```\n症状：筛选条件正确但返回空\n排查：\n  1. 条件 column 值需与表头完全一致\n  2. 数值比较时 value 必须是字符串（\"--value\": \"5000\"）\n  3. 检查是否有隐藏空格，使用 trim\n```\n\n### 🥈 中频问题\n\n#### ⚠️ 坑 11：LibreOffice 转换失败\n```\n症状：Word 转 PDF 报错\n排查：先检查 LibreOffice 是否加入 PATH；避免中文路径；确保文件未损坏\n```\n\n#### ⚠️ 坑 12：generate_templates.py 报 ImportError\n```\n症状：缺少 python-docx / openpyxl / python-pptx\n排查：pip install python-docx openpyxl python-pptx\n```\n\n#### ⚠️ 坑 13：_worker 启颈慢\n```\n症状：首次调用需2-3秒\n排查：正常！Worker 启动时检测硬件和引擎\n```\n\n#### ⚠️ 坑 14：MS Office 模式下功能缺失\n```\n症状：纯Python能做的MS Office不行\n排查：MS Office COM 接口并非全功能，部分自动回退到纯Python\n```\n\n#### ⚠️ 坑 15：多 Sheet 引用公式失效\n```\n症状：=SUM(1月:12月!B2) 不计算\n排查：openpyxl 写公式不支持 3D 引用，改用 stats 命令或逐 Sheet 运算\n```\n\n### 🥉 低频但重要\n\n#### ⚡ 坑 16：macOS 上 WPS 部分功能不可用\n```\n症状：Mac 版 WPS COM 不支持某些操作\n排查：回退到纯Python模式（WPS_ENGINE=PURE）\n```\n\n#### ⚡ 坑 17：xlsm 文件宏丢失\n```\n症状：保存后宏功能失效\n排查：openpyxl 不支持宏，xlsm 文件请用 WPS/MS Office 模式\n```\n\n#### ⚡ 坑 18：批量操作时 WPS 弹出对话框\n```\n症状：WPS 弹窗阻断自动化\n排查：弹窗需手动点击；建议在无人值守时关闭 WPS 弹窗\n```\n\n#### ⚡ 坑 19：文件被占用\n```\n症状：PermissionError\n排查：关闭占用文件的程序（WPS/Excel/Word），等待 3-5 秒后重试\n```\n\n#### ⚡ 坑 20：Windows 长路径限制\n```\n症状：Windows 默认最大路径 260 字符\n排查：启用 Windows 长路径支持，或使用短路径\n```\n\n---\n\n## 📋 常见问题 FAQ（Q&A）\n\n### Q1：我应该选择哪个引擎？\n\n**不用选！Skill 自动检测**。运行 `python scripts/wps_excel.py engine-info` 查看。如果强行切换，可以设置环境变量 `WPS_ENGINE=PURE` 强制使用纯 Python。\n\n### Q2：WPS 版本有要求吗？\n\n- WPS Office 2019+ 或 WPS 365\n- 安装后**必须重启电脑**\n- 32/64 位均可\n\n### Q3：纯 Python 模式和 WPS 模式有什么区别？\n\n| | WPS 模式 | 纯 Python 模式 |\n|--|---------|-------------|\n| 公式计算 | ✅ 自动计算 | ⚠️ 写入公式，打开时计算 |\n| 图表 | ✅ 实时预览 | ✅ 嵌入到 Excel |\n| 添加幻灯片 | ✅ 支持 | ❌ 不支持 |\n| 内存占用 | 高（几百 MB） | 低（几十 MB） |\n| 速度 | 快（WPS 优化） | 较慢 |\n\n### Q4：文件太大怎么办？\n\n> Skill 硬件自适应会自动延长超时（最高 5 倍）。\n> 建议：< 50MB 直接处理；> 50MB 先分片处理（拆分 Sheet/Section）。\n> 批量操作时单次建议 ≤ 50 个文件。\n\n### Q5：Linux 上能用吗？\n\n> ✅ 能用！安装 LibreOffice 即可：\n> ```bash\n> sudo apt install libreoffice  # Ubuntu/Debian\n> ```\n> 支持格式转换（Word/Excel/PPT → PDF）；\n> 公式、排序、筛选、图表也能用纯 Python 模式。\n\n### Q6：WPS 卡住怎么办？\n\n> Skill 会自动重试 3 次。如果仍然失败：\n> 1. 打开任务管理器 → 结束 WPS 进程\n> 2. 重新运行命令\n> 3. 如果反复出现，尝试：`pip install --upgrade pywin32`\n\n### Q7：纯 Python 模式如何安装依赖？\n\n```bash\npip install python-docx openpyxl python-pptx\n```\n\n### Q8：模板文件在哪里？如何获取？\n\n> 模板通过代码生成，不包含二进制文件。安装依赖后运行：\n> ```bash\n> python templates/generate_templates.py --dir ./output\n> ```\n> 即可生成 3 个模板：report_template.docx、budget_template.xlsx、business_ppt_template.pptx\n\n### Q9：如何批量转换格式？\n\n```bash\n# 单个文件\npython scripts/wps_word.py export --file report.docx --format pdf\n\n# 批量转换（使用 format_converter.py）\npython scripts/format_converter.py batch --input-dir ./docs --input-format docx --output-format pdf\n```\n\n### Q10：如何同时处理多个 Sheet？\n\n```bash\n# 查看所有 Sheet\npython scripts/wps_excel.py info --file Sales.xlsx\n\n# 为每个 Sheet 添加数据（逐 Sheet 调用）\npython scripts/wps_excel.py input --file Sales.xlsx --sheet Q1 --data '[[\"A\",100]]'\npython scripts/wps_excel.py input --file Sales.xlsx --sheet Q2 --data '[[\"B\",200]]'\n\n# 添加新 Sheet\npython scripts/wps_excel.py add-sheet --file Sales.xlsx --sheet Q4 --headers '[\"产品\",\"价格\"]' --data '[[\"X\",300]]'\n```\n\n### Q11：排序/筛选/图表操作总是失败？\n\n> 纯 Python 模式下这些功能 100% 支持。\n> 1. 确保已安装：`pip install openpyxl`\n> 2. 文件不能正在被占用（关闭 WPS/Excel）\n> 3. 第一行必须是表头（列名）\n> 4. 列名参数需与表头完全一致\n\n### Q12：如何提交反馈？\n\n```bash\npython scripts/wps_feedback.py email  # 打开邮件客户端（自动附带系统信息）\n```\n\n或直接发邮件到：**njskills@agent.qq.com**\n\n### Q13：纯 Python 模式下公式何时计算？\n\n> openpyxl 写入公式字符串，**打开文件时**由 Excel/WPS 计算。\n> 如果需要立即计算，请使用 WPS 模式或 MS Office 模式。\n\n### Q14：文件被占用怎么办？\n\n> 关闭占用文件的程序（WPS/Excel/Word），等待 3-5 秒后重试。\n> 或使用自动重试（Skill 已内置 3 次重试）。\n\n### Q15：哪些功能在纯 Python 模式下不可用？\n\n> v4.8 新增条件格式、数据验证、合并单元格、命名区域支持，纯Python模式覆盖度显著提升。\n\n> - 添加幻灯片（add-slide）\n> - 幻灯片插入内容（insert）\n> - 幻灯片主题（theme）\n> - VBA/宏操作\n> \n> 替代方案：安装 WPS Office 或 MS Office 获取完整功能。\n\n---\n\n## 🏆 最佳实践（10 个案例）\n\n### BP-1：大文件处理策略\n\n```\n问题：50MB 的 Word 文档操作很慢\n策略：\n  1. 先运行 python scripts/wps_word.py info --file big.docx 查看大小\n  2. 如果 > 50MB，分片处理\n  3. 使用纯 Python 模式读取内容\n  4. 避免频繁保存（每次保存触发全量写入）\n```\n\n### BP-2：周报自动化\n\n```\n问题：每周重复做相同格式的周报\n策略：\n  1. 生成模板：python templates/generate_templates.py --dir ./output\n  2. 复制模板：copy output\\report_template.docx 本周周报.docx\n  3. 用 edit 命令追加内容\n  4. 用 format 命令设置格式\n  5. 用 export 生成 PDF\n```\n\n### BP-3：预算跟踪自动化\n\n```\n问题：每月记录收入支出，手动计算汇总\n策略：\n  1. 生成预算模板：python templates/generate_templates.py --dir ./output\n  2. 每月用 input 命令录入数据\n  3. 汇总 Sheet 含公式自动计算\n  4. 用 stats 命令验证数据\n```\n\n### BP-4：商务PPT快速制作\n\n```\n问题：需要做项目汇报 PPT\n策略：\n  1. 生成模板：python templates/generate_templates.py --dir ./output\n  2. 复制模板并修改标题\n  3. 如有多页内容，创建时指定 --slides 参数\n```\n\n### BP-5：数据报表自动化\n\n```\n问题：每周重复做相同格式的报表\n策略：\n  1. 创建模板文件（含公式和图表位置）\n  2. 每周用 input 命令录入新数据\n  3. 公式和图表自动更新\n  4. 导出 PDF 分发\n```\n\n### BP-6：多 Sheet 数据汇总\n\n```\n问题：12 个月的数据在 12 个 Sheet，需要年度汇总\n策略：\n  1. 用 add-sheet 创建\"年度汇总\"Sheet\n  2. 用 stats 命令逐 Sheet 验证汇总结果\n```\n\n### BP-7：条件筛选导出\n\n```\n问题：从 1000 条记录中筛出\"销售额>5000 且 地区=华东\"\n策略：\n  python scripts/wps_excel.py filter --file data.xlsx --sheet Q1 \\\n    --conditions '[{\"column\":\"销售额\",\"op\":\">\",\"value\":\"5000\"},{\"column\":\"地区\",\"op\":\"=\",\"value\":\"华东\"}]' \\\n    --logic AND\n  ✅ 筛出符合条件的记录\n```\n\n### BP-8：批量文件重命名\n\n```\n问题：20 个文件需要统一命名规范\n策略：\n  1. 用 document_manager.py 列出所有文件\n  2. 批量重命名（加日期前缀）\n  3. 用 format_converter.py 批量转换格式\n```\n\n### BP-9：跨平台文档转换\n\n```\n问题：Linux 服务器上需要把 Word 转 PDF\n策略：\n  1. 安装 LibreOffice：sudo apt install libreoffice\n  2. 引擎自动检测为 LIBREOFFICE\n  3. 直接 export --format pdf\n```\n\n### BP-10：定时自动化\n\n```\n问题：每天凌晨自动生成报表\n策略：\n  1. 编写自动化脚本（调用 wps_excel.py + wps_word.py）\n  2. 使用 WorkBuddy automation 定时执行\n  3. 输出到指定目录\n```\n\n---\n\n## 🚨 错误速查手册 v3.1（15个错误ID）\n\n### E001-E010：用户可自助解决\n\n| ID | 错误 | 解决 |\n|----|------|------|\n| E001 | WPS 未安装或 COM 注册失败 | 安装 WPS 后重启电脑 |\n| E002 | python-docx 未安装 | `pip install python-docx openpyxl python-pptx` |\n| E003 | 文件路径不存在或无法访问 | 改用英文路径或以管理员运行 |\n| E004 | 格式转换失败（纯Python不支持） | 安装 WPS 或 LibreOffice |\n| E005 | 排序/筛选/图表需要 WPS 模式 | 安装 WPS 或改用纯Python模式 |\n| E006 | WPS/LibreOffice 卡住无响应 | 任务管理器结束进程；更新到最新版 |\n| E007 | 权限不足 | 或以管理员运行；检查文件只读属性 |\n| E008 | pywin32 导入失败 | `pip uninstall pywin32 && pip install pywin32` |\n| E009 | Python 版本过低 | 升级到 Python 3.8+ |\n| E010 | 当前引擎不支持此功能 | 安装 WPS 或改用 info 查看能力矩阵 |\n\n### E011-E015：需要进一步排查\n\n| ID | 错误 | 解决 |\n|----|------|------|\n| E011 | LibreOffice 未安装 | 下载 LibreOffice 并添加到 PATH |\n| E012 | LibreOffice 转换失败 | 检查源文件是否损坏；避免中文路径 |\n| E013 | 文件不存在 | 确认路径正确；未被删除或移动 |\n| E014 | 未知运行时错误 | 运行环境自检 `wps_test.py`；联系反馈 |\n| E015 | 不支持的操作或格式 | 输出格式改为 pdf/txt/html |\n\n---\n\n## ⚠️ 能力边界说明\n\n| 限制项 | 说明 | 解决方案 |\n|--------|------|---------|\n| **文件大小** | 单文件 < 50MB 直接处理 | 大文件先分片处理（硬件自适应自动延长超时） |\n| **批量文件数** | 建议 ≤ 50 个/批 | 超过时分批调用 |\n| **复杂度** | 透视表/VBA/ActiveX 不支持 | 使用 pandas 或手动处理 |\n| **网络文件** | 不支持 HTTP/URL 下载 | 先手动下载到本地，再调用 Skill |\n| **并发限制** | 同一时间只能操作同一引擎的一个实例 | 等待上次操作完成再发起 |\n| **中文名文件路径** | 建议改用英文路径 | 路径中避免中文和特殊字符 |\n| **实时协作** | 不支持多人同时编辑同一文件 | 通过手动分发和合并 |\n\n---\n\n## 🔗 CLI 参数速查\n\n### Word\n\n```bash\npython scripts/wps_word.py create --title \"report\" --body \"正文内容\"\npython scripts/wps_word.py edit --file \"report.docx\" --text \"新增内容\"\npython scripts/wps_word.py format --file \"report.docx\" --font \"微软雅黑\" --size 14 --align center --bold --first-indent 0.74\npython scripts/wps_word.py export --file \"report.docx\" --format pdf\npython scripts/wps_word.py info --file \"report.docx\"\npython scripts/wps_word.py engine-info\npython scripts/wps_word.py md-convert --file \"README.md\" --format docx --output \"文档.docx\"\npython scripts/wps_word.py md-convert --file \"README.md\" --format pptx --output \"演示.pptx\"\npython scripts/wps_word.py long-document --file \"report.docx\" --action all --preset thesis\n```\n\n### Excel\n\n```bash\npython scripts/wps_excel.py create --name \"Sales\" --sheets \"Q1,Q2,Q3\"\npython scripts/wps_excel.py input --file \"Sales.xlsx\" --sheet \"Q1\" --data '[[\"A\",100]]'\npython scripts/wps_excel.py formula --file \"Sales.xlsx\" --sheet \"Q1\" --cell \"C1\" --formula \"=SUM(A1:B1)\"\npython scripts/wps_excel.py chart --file \"Sales.xlsx\" --sheet \"Q1\" --type bar --data \"A1:B10\" --title \"销售趋势\"\npython scripts/wps_excel.py sort --file \"Sales.xlsx\" --sheet \"Q1\" --sorts '[{\"column\":\"Price\",\"ascending\":false}]'\npython scripts/wps_excel.py filter --file \"Sales.xlsx\" --sheet \"Q1\" --conditions '[{\"column\":\"Price\",\"op\":\">\",\"value\":\"50\"}]' --logic AND\npython scripts/wps_excel.py add-sheet --file \"Sales.xlsx\" --sheet \"Q4\" --headers '[\"Product\",\"Price\"]' --data '[[\"X\",300]]'\npython scripts/wps_excel.py nl-analyze --file \"Sales.xlsx\" --query \"按月份统计销售额并画出趋势图\"\npython scripts/wps_excel.py invoice --input \"发票.pdf\" --output \"进账台账.xlsx\"\npython scripts/wps_excel.py stats --file \"Sales.xlsx\" --sheet \"Q1\" --column \"B\" --type SUM\npython scripts/wps_excel.py info --file \"Sales.xlsx\"\npython scripts/wps_excel.py engine-info\npython scripts/wps_excel.py check-update\npython scripts/wps_excel.py formula-explain --formula \"=SUM(A1:A10)\"\npython scripts/wps_excel.py formula-explain --file \"data.xlsx\" --cell \"B2\"\npython scripts/wps_excel.py formula-explain --file \"data.xlsx\" --sheet \"Sheet1\"\n```\n\n### PPT\n\n```bash\npython scripts/wps_ppt.py create --title \"Pitch\"\npython scripts/wps_ppt.py add-slide --file \"Pitch.pptx\" --title \"Intro\"\npython scripts/wps_ppt.py insert --file \"Pitch.pptx\" --slide 2 --content \"Key points\"\npython scripts/wps_ppt.py theme --file \"Pitch.pptx\" --name business_blue\npython scripts/wps_ppt.py export --file \"Pitch.pptx\" --format pdf\npython scripts/wps_ppt.py docx-to-ppt --input 报告.docx --output 演示.pptx --title \"项目汇报\" --theme business\npython scripts/wps_ppt.py info --file \"Pitch.pptx\"\npython scripts/wps_ppt.py engine-info\n```\n\n### 🆕 v4.0 新命令（详见下方各组件）\n\n| 功能 | 命令 |\n|------|------|\n| Word→PPT | `python scripts/wps_ppt.py docx-to-ppt --input report.docx --output ppt.pptx` |\n| NL分析 | `python scripts/wps_excel.py nl-analyze --file data.xlsx --query \"按月份统计销售额画趋势图\"` |\n| 合同审查 | 已裁撤（见下方说明）；完整审查请安装 [contract-review](https://skillhub.cn/skills/contract-review) 技能 |\n| 发票OCR | `python scripts/wps_excel.py invoice --input 发票.pdf --output 入账台账.xlsx` |\n| 公式解释器 | `python scripts/wps_excel.py formula-explain --formula \"=SUM(A1:A10)\"` |\n| MD→Word/PPT | `python scripts/wps_word.py md-convert --file README.md --format docx` |\n| 长文档排版 | `python scripts/wps_word.py long-document --file report.docx --action all` |\n| 邮件智能回复 | `python scripts/wps_word.py email-reply --content \"已收到您的来信\" --tone polite` |\n| 周报月报 | `python scripts/wps_word.py report --type weekly --points \"完成A,B,C\"` |\n| AI 统一入口 | `python scripts/wps_ai.py --action meeting --file audio.wav` |\n\n### 🆕 v4.3 Excel 深度分析命令\n\n```bash\npython scripts/excel_analyzer.py profile --file data.xlsx --sheet Sheet1\npython scripts/excel_analyzer.py fix-formulas --file data.xlsx --sheet Sheet1\npython scripts/excel_analyzer.py pivot --file data.xlsx --sheet Sheet1\npython scripts/excel_analyzer.py predict --file data.xlsx --sheet Sheet1 --column 销售额 --method auto --steps 3\npython scripts/excel_analyzer.py nl2formula --query \"同比增长率\"\npython scripts/excel_analyzer.py clean --file data.xlsx --sheet Sheet1\npython scripts/excel_analyzer.py hardware\n```\n\n### 🆕 v4.4 长文档排版命令（已升级为 v4.7 统一入口）\n\n> v4.7 起，长文档排版 8 个命令合并为 `wps_word.py long-document --action` 统一入口，降低记忆成本。\n\n```bash\n# 新统一入口（推荐）\npython scripts/wps_word.py long-document --file report.docx --action all --preset thesis\n\n# 旧命令仍可通过 long_document.py 调用（兼容）\npython scripts/long_document.py all --file report.docx --preset thesis --output 排版后.docx\n```\n\n### 🆕 v4.5 会议纪要 + COM 健康命令\n\n```bash\n# 会议纪要生成\npython scripts/meeting_minutes.py check                    # 检查可用 ASR 引擎\npython scripts/meeting_minutes.py transcribe --file audio.wav --method auto\npython scripts/meeting_minutes.py generate --file audio.wav --output 纪要.docx\npython scripts/meeting_minutes.py batch --input-dir ./audio --output-dir ./docs\n\n# COM 健康检查\npython scripts/com_health.py wps-check                     # WPS COM 状态\npython scripts/com_health.py ms-check                     # MS Office COM 状态\npython scripts/com_health.py residuals                    # 检测残留进程\npython scripts/com_health.py release-all --force           # 强制清理所有\npython scripts/com_health.py full-check --json             # 完整健康报告\n\n# 通过 wps_word.py 调用\npython scripts/wps_word.py meeting-minutes --file audio.wav --output 纪要.docx\npython scripts/wps_word.py com-health --check full\n```\n\n### 🆕 v4.6 Excel 智能分析 + 数据图表 + 文档翻译\n\n```bash\n# Excel 智能分析（6 命令合并为 1 个 --action 路由）\npython scripts/wps_excel.py excel-smart --file data.xlsx --action profile\npython scripts/wps_excel.py excel-smart --file data.xlsx --action fix-formulas\npython scripts/wps_excel.py excel-smart --file data.xlsx --action pivot\npython scripts/wps_excel.py excel-smart --file data.xlsx --action predict --column 销售额 --method auto --steps 3\npython scripts/wps_excel.py excel-smart --file data.xlsx --action nl2formula --query \"同比增长率\"\npython scripts/wps_excel.py excel-smart --file data.xlsx --action clean\npython scripts/wps_excel.py excel-smart --file data.xlsx --action hardware\n\n# 数据图表生成器\npython scripts/wps_excel.py chart-gen --file data.xlsx --action auto        # 一键分析+推荐+生成\npython scripts/wps_excel.py chart-gen --file data.xlsx --action analyze      # 仅分析数据特征\npython scripts/wps_excel.py chart-gen --file data.xlsx --action recommend    # 仅推荐图表类型\npython scripts/wps_excel.py chart-gen --file data.xlsx --action generate --type line  # 生成指定图表\n\n# 文档翻译\npython scripts/wps_word.py translate --file report.docx --output 报告_zh.docx --source en --target zh\npython scripts/wps_word.py translate --input-dir ./docs --output-dir ./translated --source en --target zh\npython scripts/document_translator.py translate --file report.docx --output 报告_zh.docx\npython scripts/document_translator.py batch --input-dir ./docs --output-dir ./translated\npython scripts/document_translator.py check                                  # 检查可用翻译引擎\n```\n\n### 🆕 v4.7 公式解释器 + Markdown 转换 + 长文档统一入口\n\n```bash\n# 公式解释器（反向 NL2Formula，纯本地实现）\npython scripts/wps_excel.py formula-explain --formula \"=SUM(A1:A10)\"\npython scripts/wps_excel.py formula-explain --file data.xlsx --cell B2\npython scripts/wps_excel.py formula-explain --file data.xlsx --sheet Sheet1\n\n# Markdown → Word/PPT\npython scripts/wps_word.py md-convert --file README.md --format docx --output 文档.docx\npython scripts/wps_word.py md-convert --file README.md --format pptx --output 演示.pptx\npython scripts/wps_word.py md-convert --dir ./docs --format docx --output-dir ./output\n\n# 长文档排版统一入口（8 命令合并为 1 个 --action 路由）\npython scripts/wps_word.py long-document --file report.docx --action analyze\npython scripts/wps_word.py long-document --file report.docx --action toc --max-level 3 --insert\npython scripts/wps_word.py long-document --file report.docx --action header --chapter-in-header --page-number\npython scripts/wps_word.py long-document --file report.docx --action numbering --style arabic --max-level 4\npython scripts/wps_word.py long-document --file report.docx --action fig-index --insert\npython scripts/wps_word.py long-document --file report.docx --action xref\npython scripts/wps_word.py long-document --file report.docx --action format --preset thesis\npython scripts/wps_word.py long-document --file report.docx --action all --preset thesis --output 排版后.docx\npython scripts/wps_word.py long-document --file report.docx --action preview --preset thesis\n```\n\n### 🆕 v4.9.0 llm_bridge 桥接层 + AI 动作扩类 + 模板市场 + NL2Formula 多轮澄清\n\n```bash\n# ===== llm_bridge 统一模型层桥接 =====\n# 白名单探测 cn-llm-router，零配置多模型调用\npython scripts/llm_bridge.py check                          # 检查 cn-llm-router 是否可用\npython scripts/llm_bridge.py chat --prompt \"你好\"           # 通过 cn-llm-router 对话\npython scripts/llm_bridge.py translate \"Hello\" en zh         # 翻译\npython scripts/llm_bridge.py summarize \"长文本...\" --max-length 200  # 摘要\npython scripts/llm_bridge.py continue \"未完待续...\" --context \"前文\"  # 续写\npython scripts/llm_bridge.py rewrite \"原文...\" --style formal          # 改写\npython scripts/llm_bridge.py expand \"要点...\" --aspect detail          # 扩写\n\n# ===== wps ai 新增 3 个 AI 动作（续写/改写/扩写）=====\npython scripts/wps_ai.py --action continue --text \"未完待续...\" --context \"前文\"\npython scripts/wps_ai.py --action rewrite --text \"原文...\" --style formal\npython scripts/wps_ai.py --action expand --text \"要点...\" --aspect detail\n\n# ===== 模板市场（50+ 内置模板）=====\npython scripts/template_manager.py list                       # 列出所有模板\npython scripts/template_manager.py list --category contract  # 按分类筛选\npython scripts/template_manager.py get 合同模板               # 获取模板详情\npython scripts/template_manager.py fill 合同模板 --data '{\"甲方\":\"张三\"}' --output 合同.docx\npython scripts/template_manager.py add --source 我的文档.docx --name 自定义模板 --category other\npython scripts/template_manager.py export 合同模板 --output-dir ./exports\npython scripts/template_manager.py import ./imports/模板包\n\n# ===== NL2Formula 多轮澄清 =====\npython scripts/clarify.py detect --query \"统计销售额\"         # 歧义检测\npython scripts/clarify.py clarify --query \"统计销售额\"        # 多轮澄清+公式生成\npython scripts/clarify.py verify --formula \"=SUM(A1:A10)\"     # 公式反向验证\npython scripts/excel_analyzer.py nl2formula --query \"统计销售额\" --clarify  # 启用澄清\n\n# ===== 周报/月报 LLM 润色 =====\npython scripts/report_generator.py generate --type weekly --points \"完成A,B,C\" --output 周报.docx --polish\n\n# ===== 会议纪要 llm_bridge 优先摘要 =====\npython scripts/meeting_minutes.py generate --file audio.wav --output 纪要.docx --summary-method llm_bridge\n\n# ===== 文档翻译 llm_bridge 优先 =====\npython scripts/document_translator.py translate --file report.docx --output 报告_zh.docx --method llm_bridge\n```\n\n### 🆕 v4.8 邮件智能回复 + 周报月报 + 纯Python增强 + AI统一入口\n\n```bash\n# 邮件智能回复（模板匹配 + 可选 LLM 个性化）\npython scripts/wps_word.py email-reply --content \"已收到您的来信，关于项目进度...\" --tone polite\npython scripts/wps_word.py email-reply --content \"请查收附件\" --tone formal --output 回复.docx\npython scripts/email_reply.py reply --content \"谢谢\" --tone friendly\npython scripts/email_reply.py batch --input-dir ./emails --output-dir ./replies\n\n# 周报/月报自动生成\npython scripts/wps_word.py report --type weekly --points \"完成需求A,修复Bug B,启动项目C\"\npython scripts/wps_word.py report --type monthly --points \"上线v2.0,培训3场,客户拜访5家\" --output 月报.docx\npython scripts/report_generator.py generate --type weekly --points \"完成A,B,C\" --output 周报.docx\n\n# 纯 Python 模式增强（条件格式/数据验证/合并单元格/命名区域）\npython scripts/wps_excel.py cond-format --file data.xlsx --sheet Sheet1 --range A1:A100 --type color-scale\npython scripts/wps_excel.py data-validation --file data.xlsx --sheet Sheet1 --range B1:B100 --list \"是,否\"\npython scripts/wps_excel.py merge-cells --file data.xlsx --sheet Sheet1 --range A1:D1\npython scripts/wps_excel.py named-range --file data.xlsx --name \"销售数据\" --range A1:D100\n\n# AI 统一入口（wps ai --action）\npython scripts/wps_ai.py --action email-reply --content \"已收到\" --tone polite\npython scripts/wps_ai.py --action report --type weekly --points \"完成A,B,C\"\npython scripts/wps_ai.py --action meeting --file audio.wav --output 纪要.docx\npython scripts/wps_ai.py --action contract --file 合同.docx --output 审查版.docx\npython scripts/wps_ai.py --action translate --file report.docx --output 报告_zh.docx\npython scripts/wps_ai.py --action formula --formula \"=SUM(A1:A10)\"\n```\n\n### 🆕 v5.0 自动化流水线与稳定性中心\n\n```bash\n# ===== 定时任务 =====\npython scripts/schedule_register.py register --task weekly_report   # 注册周报定时任务（需确认）\npython scripts/schedule_register.py register --task monthly_report  # 注册月报定时任务\npython scripts/schedule_register.py register --task data_refresh   # 注册数据刷新定时任务\npython scripts/schedule_register.py list                           # 列出已注册任务\npython scripts/schedule_register.py cancel --task weekly_report    # 取消任务\npython scripts/schedule_register.py enable --task weekly_report    # 启用/禁用任务\npython scripts/schedule_register.py predefined                     # 查看预定义任务\n\n# ===== 目录监听 =====\npython scripts/watch.py watch --dir ./input --rules watch_rules.yaml  # 启动监听\npython scripts/watch.py scan --dir ./input --rules watch_rules.yaml   # 单次扫描\npython scripts/watch.py rules --dump                                 # 导出默认规则\npython scripts/watch.py init --dir ./input                            # 初始化规则文件\n\n# ===== 稳定性中心（统计+引擎健康+引擎偏好）=====\npython scripts/usage_stats.py stats --period daily    # 日报表\npython scripts/usage_stats.py stats --period weekly   # 周报表\npython scripts/usage_stats.py health                  # 引擎健康度报告\npython scripts/usage_stats.py engine-info             # 全局引擎信息（合并3脚本）\npython scripts/usage_stats.py preference --mode auto  # 引擎偏好：自动模式\npython scripts/usage_stats.py preference --mode fixed --engine wps  # 固定WPS引擎\npython scripts/usage_stats.py log --action create --engine wps --duration 2.5  # 手动埋点\npython scripts/usage_stats.py reset --yes             # 重置统计数据\n\n# ===== COM 三步自愈 =====\npython scripts/com_health.py self-heal                # 交互式三步自愈\npython scripts/com_health.py self-heal --yes          # 自动确认（跳过修复安装确认）\n\n# ===== 对话式数据查询 =====\npython scripts/nl2sql_engine.py query --file data.xlsx --query \"销售额总和是多少\"\npython scripts/nl2sql_engine.py query --file data.xlsx --query \"按部门分组统计平均工资\"\npython scripts/nl2sql_engine.py interactive --file data.xlsx  # 交互式连续追问\npython scripts/nl2sql_engine.py history                  # 查看查询历史\n\n# ===== 编排引擎桥接 =====\npython scripts/pipeline_bridge.py register            # 注册WPS流水线模板\npython scripts/pipeline_bridge.py register --dry-run  # 预览注册内容\npython scripts/pipeline_bridge.py unregister          # 注销模板\npython scripts/pipeline_bridge.py status              # 查看桥接状态\npython scripts/pipeline_bridge.py list                # 列出所有流水线模板\n```\n\n### 🆕 v5.1 在线协同打通（桥接 kingdoc）\n\n```bash\n# ===== kingdoc 桥接 =====\npython scripts/kingdoc_bridge.py status                           # 检查 kingdoc 安装状态\npython scripts/kingdoc_bridge.py upload --file report.docx        # 上传文件到金山文档\npython scripts/kingdoc_bridge.py upload --file report.docx --folder-id xxx  # 指定文件夹\npython scripts/kingdoc_bridge.py diff --file report.docx --doc-id xxx      # 检查本地与云端差异\n\n# ===== 条件格式 IO =====\npython scripts/conditional_format_io.py extract --file data.xlsx              # 提取条件格式为 JSON\npython scripts/conditional_format_io.py extract --file data.xlsx --sheet Sheet1 --output rules.json\npython scripts/conditional_format_io.py apply --file data.xlsx --json-file rules.json  # 应用条件格式\n\n# ===== 数据验证 IO =====\npython scripts/validation_io.py extract --file data.xlsx              # 提取数据验证为 JSON\npython scripts/validation_io.py apply --file data.xlsx --json-file rules.json  # 应用数据验证\n\n# ===== 会议纪要 v5.1 三段式 =====\npython scripts/meeting_minutes.py generate --file audio.wav --output 纪要.docx --diarize --num-speakers 3\npython scripts/meeting_minutes.py diarize --file audio.wav --num-speakers 3  # 独立说话人标注\npython scripts/meeting_minutes.py generate --file audio.wav --no-diarize     # 禁用说话人标注\n```\n\n### 其他工具\n\n```bash\npython scripts/wps_test.py                    # 环境自检（人类可读）\npython scripts/wps_test.py --json             # 环境自检（JSON 格式）\npython scripts/wps_feedback.py page           # 打开反馈页面\npython scripts/wps_feedback.py email          # 打开邮件客户端\npython scripts/wps_update.py --force          # 强制检查更新\npython scripts/wps_toc.py insert --file \"report.docx\"  # 插入目录\npython scripts/format_converter.py batch --input-dir \"D:\\Reports\" --input-format docx --output-format pdf  # 批量转换\npython templates/generate_templates.py --dir ./output  # 生成模板\n\n# --- v5.2 新增 ---\npython scripts/gongwen.py layout --file 公文.docx --redhead --joint          # 公文一键排版（红头预留位+联合行文）\npython scripts/watermark.py add --file 报告.docx --text 机密 --diagonal      # 文字水印（对角线）\npython scripts/watermark.py add --dir ./Docs --image logo.png --tile         # 批量图片水印（平铺）\npython scripts/redact.py run --file 客户.docx --manifest 打码清单.json       # 敏感信息打码+清单\npython scripts/doc_search.py search --dir ./资料库 --query \"质保期两年\" --open # 跨文档检索并打开\npython scripts/doc_search.py search --dir ./资料库 --query \"...\" --deposit    # 检索命中沉淀为长期记忆（桥接 zwjh）\n```\n\n---\n\n## 📊 版本兼容矩阵\n\n| Python | WPS Office | LibreOffice | Windows | macOS | Linux | 状态 |\n|--------|-----------|-------------|---------|-------|-------|------|\n| 3.8+ | 2019+ | - | ✅ | ⚠️ | ❌ | 基础 |\n| 3.8+ | 365 | - | ✅ | ✅ | ❌ | 最佳 |\n| 3.8+ | - | 7.0+ | ✅ | ✅ | ✅ | 跨平台推荐 |\n| 3.8+ | - | - | ✅ | ✅ | ✅ | 纯Python |\n\n> ⚠️ = 部分功能受限（纯Python模式），❌ = 对应引擎不可用\n\n---\n\n## ⚠️ 安全须知\n\n**✅ 五道防线保障安全**：\n1. **引擎自检**：启动时自动检测可用引擎，崩溃自动重启\n2. **路径校验**：`safe_path()` 全面校验，拒绝非法路径和特殊字符\n3. **错误中文化**：所有错误 ID 提供详细中文说明和操作步骤\n4. **数据零上传**：所有处理在本地完成，不上传任何内容到互联网\n5. **显式 Opt-in**（v4.6.1 引入）：外部服务（ASR/LLM）仅在用户显式指定 method 时调用，auto 模式仅使用本地引擎\n\n**📝 注意事项**：\n- 批量操作时，桌面会创建 `WPS_Backup` 文件夹保存副本\n- macOS 上 WPS 不支持所有功能\n- 纯 Python 模式下格式设置有限，复杂排版建议安装 WPS\n- 所有文件操作在本地进行，不会联网\n- LibreOffice Headless 模式下不支持实时预览\n- Skill 每 7 天自动检查更新，不会频繁打扰\n- **模板为纯代码生成，不包含二进制文件，更安全可靠**\n- **v4.7 新增公式解释器、MD 转换均为纯本地实现，不读取外部凭证或 API Key**\n\n---\n\n## 更新日志\n\n| 版本 | 日期 | 本次更新 |\n|------|------|---------|\n| v5.2.5 | 2026-09-22 | 修复：MS Office 引擎下 Excel/PPT 创建必然失败（ms_create_excel/ms_create_ppt 错用 Word COM 对象，调用 get_ms_word 而非各自 Excel/PPT 对象）；增加：wps_common.py 新增 create_ms_excel/get_ms_excel 与 create_ms_ppt/get_ms_ppt，并新增 MS_EXCEL_CLIENT/MS_PPT_CLIENT 双槽位；修复：release_ms 改为统一释放 Word/Excel/PPT 三槽位并置空；修复：wps_ms.py 与 wps_worker.py 的 MS Office 路径透传 filepath 参数（不再硬编码写入桌面） |\n| v5.2.0 | 2026-09-19 | 增加：公文一键排版 gongwen.py + references/gongwen_rules.yaml（GB/T 9704 党政机关公文格式约束库，结构识别套版，支持红头预留位与联合行文，处理前自动备份原文件）；增加：批量水印 watermark.py（文字/图片水印，平铺与对角线，docx/pptx/图片批量目录处理）；增加：敏感信息打码 redact.py（正则+词典双轨识别身份证/手机号/银行卡/邮箱，黑色矩形覆盖，输出打码清单供人工复核，NER 可选增强）；增加：跨文档知识检索 doc_search.py（本地 TF-IDF char/bigram 自研零依赖，跨文档找内容问答，命中返回文件+段落+跳转，embedding 可选，zwjh 记忆桥接未装则跳过）；删除：与 contract-review 重复的轻量合同审查模块 wps_contract_review.py 及其在 wps_ai/wps_word/wps_worker 的入口命令，SKILL.md 改为文本互链引导（无代码依赖） |\n| v5.1.0 | 2026-09-08 | 增加：kingdoc 云端桥接 kingdoc_bridge.py（白名单探测+配置预检+subprocess JSON 契约上传+ difflib 差异检查，未安装/未配置隐藏入口+可选装提示）；增加：条件格式跨引擎 IO conditional_format_io.py（色阶/数据条/公式条件→JSON 中间格式，跨引擎保真往返 WPS↔纯Python）；增加：数据验证跨引擎 IO validation_io.py（下拉/数值区间/日期→JSON 中间格式，跨引擎保真往返）；优化：meeting_minutes.py 升级为 v5.1 三段式要素化纪要（待办清单+决策记录+风险异议，每节独立页眉）；增加：说话人标注 SpeakerDiarization（MFCC 聚类或显式报名，独立 diarize 子命令）；增加：--diarize/--no-diarize 参数控制说话人标注；增加：--num-speakers 参数指定说话人数 |\n| v5.0.0 | 2026-08-16 | 增加：定时任务注册管理 schedule_register.py（schtasks/crontab 双平台，4个预定义任务，注册前展示命令确认，list/cancel/enable管理）；增加：目录轮询监听 watch.py（轮询间隔3秒无内核依赖，YAML规则表匹配，>50MB自动分片并行处理+合并输出，LibreOffice并发池控制）；增加：使用统计与稳定性中心 usage_stats.py（SQLite埋点：操作数/耗时/引擎命中/失败降级/重试成功率，stats日/周报表+引擎健康度，全局engine-info合并3脚本，引擎偏好优先级配置）；增加：COM三步自愈 com_health.py self-heal子命令（regsvr32重注册→WPS修复安装[用户确认]→手动指引，每步记录SQLite日志）；增加：对话式数据查询 nl2sql_engine.py（意图解析器+查询计划生成器+pandas执行器+对话上下文，Top20关键词模板覆盖sum/avg/max/min/count/filter/groupby/sort/topn/yoy/mom等，无LLM降级）；增加：multi-agent编排引擎桥接 pipeline_bridge.py（白名单探测multi-agent-orchestrator，命中注册5条WPS流水线模板，未装降级watch.py本地串行，同一套规则表两种执行路径） |\n| v4.9.0 | 2026-08-08 | 增加：llm_bridge 统一模型层桥接（白名单探测 cn-llm-router，零配置多模型调用，JSON 契约 text/model/cost）；增加：wps ai 续写/改写/扩写 3 个新 AI 动作（经 llm_bridge 路由，未装 cn-llm-router 回落自配 API + 安装提示）；增加：模板市场 template_manager.py（50+ 内置模板覆盖公文/合同/简历/标书/报告/会议，支持用户沉淀 user_templates + 导出/导入分享包）；增加：NL2Formula 多轮澄清 clarify.py（歧义检测 3 类规则 + 槽位填充 + 反向验证回路，公式生成更精准）；优化：document_translator.py 优先走 llm_bridge 后回落直接 API；优化：report_generator.py 新增 --polish 参数（经 llm_bridge 润色）；优化：meeting_minutes.py 摘要引擎优先走 llm_bridge 后回落本地规则 |\n| v4.8.0 | 2026-08-22 | 增加：邮件智能回复 email_reply.py（模板匹配 + 规则引擎 + 可选 LLM 个性化，纯本地实现）；增加：周报/月报自动生成 report_generator.py（关键点→结构化 Word 报告，模板 + 可选 LLM 润色）；升级：纯 Python 模式能力（条件格式/数据验证/合并单元格/命名区域，基于 openpyxl 扩展）；增加：AI 统一入口 wps ai --action（6 大 AI 功能统一入口）；增加：邮件回复 CLI 子命令（email-reply）；增加：周报月报 CLI 子命令（report）；增加：条件格式/数据验证/合并单元格/命名区域 CLI 子命令 |\n| v4.7.0 | 2026-08-17 | 增加：公式解释器 formula_explainer.py（反向 NL2Formula，Excel 公式→自然语言解释，纯本地实现，80+ 函数映射）；增加：Markdown→Word/PPT 转换器 md_converter.py（保留标题层级/表格/列表/加粗，纯本地实现）；合并：长文档排版 8 命令为 long-document 统一入口（--action 参数路由）；优化：长文档排版性能（分批处理 + 单次保存 + 进度回调，大文档不卡顿）；增加：公式解释器 CLI 子命令（formula-explain）；增加：MD 转换 CLI 子命令（md-convert）；增加：长文档排版 CLI 子命令（long-document） |\n| v4.6.1 | 2026-08-16 | 修复：ASR 引擎改为显式 Opt-in 模式（auto 仅使用本地 whisper-local，不读取外部凭证）；修复：Azure/Google STT 仅在 method 显式指定时调用，首次使用显示凭证读取范围警告；修复：LLM 翻译改为显式 Opt-in 模式（auto 仅使用 local-rule，不读取 API Key）；修复：外部 SDK 依赖（google-cloud-speech / azure-cognitiveservices-speech）补充声明至 requirements.txt |\n| v4.6.0 | 2026-08-16 | 增加：Excel 智能分析统一入口 excel-smart（6 命令合并为 1 个 --action 路由）；增加：数据图表生成器 chart_recommender.py（数据特征分析 + 智能图表推荐 + 图表嵌入 Excel）；增加：文档翻译模块 document_translator.py（Word/Excel/PPT 多格式翻译 + 多模型降级链）；增加：翻译引擎降级链（cn-llm-router → local-rule → pure-template）；增加：图表推荐规则引擎（时间序列/类别对比/相关性/多变量）；增加：硬件自适应（低配禁用复杂图表渲染）；增加：术语表支持（JSON 格式可配置） |\n| v4.5.0 | 2026-08-05 | 增加：会议纪要生成模块 meeting_minutes.py（ASR 转写 → LLM 摘要 → Word 生成）；增加：ASR 降级链（whisper-local → azure-speech → google-stt → template）；增加：LLM 降级链（rule-engine → external-llm → pure-template）；增加：COM 健康检查模块 com_health.py（WPS/MS COM 状态检测 + 残留进程检测 + 自动释放）；增加：6 个 CLI 子命令（transcribe/summarize/generate/batch/wps-check/ms-check/residuals/release-all/full-check）；合并：避坑指南 20+ 条 + FAQ 15 个 + 错误 ID 15 个 → 统一故障排除大章（含统一索引表）；增加：音频分段处理（默认 5 分钟/段）+ 进度回调；增加：硬件自适应（低配禁用并行转写） |\n| v4.4.0 | 2026-07-30 | 增加：长文档排版自动化模块 long_document.py（自动目录生成/页眉页脚自动化/标题编号自动化/图表索引自动化/交叉引用自动化/格式统一/批量排版）；增加：8 个 CLI 子命令（analyze/toc/header/numbering/fig-index/xref/format/all/preview）；增加：多级标题编号引擎（支持中文/阿拉伯/罗马数字三种样式）；增加：图表索引自动生成（图 1-1 xxx / 表 1-1 xxx）；增加：交叉引用验证与自动修复；增加：格式统一预设模板（论文/标书/报告三种风格）；增加：性能优化（分批处理 + 进度回调 + 单次保存） |\n| v4.3.0 | 2026-07-23 | 增加：Excel 智能分析模块 excel_analyzer.py（公式自动纠错/数据清洗辅助/透视表自动生成/数据预测/NL2Formula 自然语言转公式/硬件自适应降级）；增加：6 个 CLI 子命令（profile/fix-formulas/pivot/predict/nl2formula/clean/hardware）；优化：数据类型探测算法（数值/日期/文本自动识别）；优化：透视表智能字段推荐（基于唯一值比例+数据类型）；增加：数据质量评分体系（0-100分） |\n| v4.1.0 | 2026-07-17 | 增加：PPT智能生成深度增强模块 ppt_generator.py（多源输入/演讲者备注/动画建议/配色适配/图表推荐/排练辅助）；增加：4 大工具 CLI 子命令扩展（docx-to-ppt/generate/nl-analyze/invoice/review）；增加：配色方案自动生成引擎；增加：演讲者备注双模式（模板引擎 + 外部 LLM 可选）；优化：PPT 生成流程重构为分层架构 |\n| v4.0.0 | 2026-07-13 | 增加：Word→PPT一键生成；增加：Excel自然语言数据分析；增加：Word合同条款审查标注；增加：Excel发票OCR入账；增加：4 个专用脚本（wps_docx_to_ppt/wps_nl_analysis/wps_contract_review/wps_invoice_ocr）；增加：Worker 路由扩展至 28 个命令 |\n| v3.1.0 | 2026-07-07 | 修复：模板安全问题（删除二进制文件，改为纯Python代码生成）；增加：20+避坑指南；增加：FAQ扩展到15个；增加：文件限制速查表 |\n| v3.0.0 | 2026-07-07 | 增加：自动重试机制（3次指数退避）；增加：硬件自适应（CPU/内存动态调整）；增加：Skill更新检查（7天提醒）；增加：常见问题FAQ（8个Q&A）；增加：CLI参数说明+返回结果示例；增加：反馈邮箱；增加：反模式FAQ（8个常见错误）；增加：最佳实践（10个案例）；增加：wps_performance.py 性能管理 |\n| v2.5.0 | 2026-07-03 | 增加：纯Python模式增强（排序/筛选/图表/公式/统计）；增加：文档模板目录；增加：10个最佳实践案例；增加：反模式FAQ |\n| v2.2.0 | 2026-06-30 | 增加：四引擎智能识别；增加：LibreOffice Headless 跨平台兜底；增加：纯Python格式设置/表格/图片插入 |\n| v2.1.0 | 2026-06-28 | 增加：目录生成；增加：环境自检；增加：反馈入口；增加：错误速查手册 |\n| v1.0.0 | 2026-06-28 | 初始版本，三大组件 + 格式转换 |\n\nFile v5.2.5:README.md\n\n# WPS Office 全家桶\n\n基于自然语言的 WPS Office 自动化 Skill，支持 Word/Excel/PPT 创建、编辑、格式转换。\n\n## 功能\n\n- 📄 **WPS 文字** - 创建/编辑/格式/导出\n- 📊 **WPS 表格** - 数据/公式/图表/筛选\n- 🎬 **WPS 演示** - 创建/幻灯片/主题/导出\n- 🔄 **格式转换** - Word/Excel/PPT/PDF 互转\n- 📁 **文档管理** - 打开/保存/最近文档\n\n## 使用方式\n\n```bash\npython scripts/wps_word.py create --title \"我的文档\"\npython scripts/wps_excel.py create --name \"预算表\"\npython scripts/wps_ppt.py create --title \"汇报\"\npython scripts/format_converter.py convert --input \"D:\\文档\\报告.docx\" --output-format pdf\n```\n\n## 依赖\n\n```bash\npip install -r requirements.txt\n```\n\n## 风险提示\n\n1. **文件安全**：操作前建议备份重要文件\n2. **格式兼容性**：部分复杂格式转换可能丢失原始排版\n3. **依赖要求**：需安装 WPS Office 2019+ 或 WPS 365\n\nFile v5.2.5:_meta.json\n\n{\n  \"ownerId\": \"kn7chdrwbdhaqkwajcyhtfvjx989ddb1\",\n  \"slug\": \"wps-office-suite\",\n  \"version\": \"5.2.5\",\n  \"publishedAt\": 1790059026538\n}\n\nFile v5.2.5:references/gongwen_rules.yaml\n\n# ============================================================\n# GB/T 9704-2012 党政机关公文格式 约束库\n# 用途：gongwen.py 排版引擎读取本文件，按规则对文档逐段套版\n# 设计：可维护、可扩展——新增文种/调整字号只需改本文件，不碰代码\n# ============================================================\n\nstandard: \"GB/T 9704-2012\"\nname: \"党政机关公文格式\"\n\n# ---------- 页面 ----------\npage:\n  size: \"A4\"\n  margin_top: \"37mm\"\n  margin_bottom: \"35mm\"\n  margin_left: \"28mm\"\n  margin_right: \"26mm\"\n  per_page_lines: 22      # 每面 22 行\n  per_line_chars: 28      # 每行 28 字（三号字）\n  grid: true              # 撑满版心\n\n# ---------- 字体规范 ----------\n# size 使用中文办公字号，引擎内部映射为磅值（二号=22pt，三号=16pt，四号=14pt）\nfonts:\n  title:\n    name: \"方正小标宋简体\"\n    fallback: \"宋体\"\n    size: \"二号\"\n    bold: true\n    color: \"000000\"\n    align: \"center\"\n    spacing_after: \"1行\"\n  redhead:                # 红头（发文机关标志）预留位\n    name: \"方正小标宋简体\"\n    fallback: \"宋体\"\n    size: \"初号\"\n    bold: true\n    color: \"FF0000\"\n    align: \"center\"\n  main_send:             # 主送机关\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"left\"\n    first_line_indent: \"0\"\n  body:\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"justify\"\n    first_line_indent: \"2字符\"\n    line_spacing_rule: \"fixed\"\n    line_spacing: \"28pt\"   # 固定值 28 磅 ≈ 一个三号字 + 行距\n  signature:             # 发文机关署名 + 成文日期\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"right\"\n  attachment_note:       # 附件说明\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"left\"\n    first_line_indent: \"2字符\"\n  annotation:            # 附注（居左圆括号）\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"left\"\n  footer:\n    page_number:\n      name: \"宋体\"\n      size: \"四号\"\n      format: \"- {n} -\"     # 页码格式：一字线夹阿拉伯数字\n\n# ---------- 结构层次序数 ----------\n# 公文正文内层级标识与对应字体\nstructure_levels:\n  - level: 1\n    marker: \"一、\"\n    font: \"黑体\"\n    size: \"三号\"\n    bold: true\n  - level: 2\n    marker: \"（一）\"\n    font: \"楷体_GB2312\"\n    fallback: \"楷体\"\n    size: \"三号\"\n  - level: 3\n    marker: \"1.\"\n    font: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    bold: true\n  - level: 4\n    marker: \"（1）\"\n    font: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n\n# ---------- 文种识别关键词 ----------\n# 用于从标题中判断文种，决定版式细节（如函/纪要差异）\ndoc_types:\n  - \"决议\"\n  - \"决定\"\n  - \"命令\"\n  - \"公报\"\n  - \"公告\"\n  - \"通告\"\n  - \"意见\"\n  - \"通知\"\n  - \"通报\"\n  - \"报告\"\n  - \"请示\"\n  - \"批复\"\n  - \"议案\"\n  - \"函\"\n  - \"纪要\"\n\n# ---------- 主送机关识别特征 ----------\n# 段落以这些词结尾（带全角冒号）视为主送机关行\nmain_send_markers:\n  - \"：\"\n  - \":\"\n\n# ---------- 落款识别特征 ----------\nsignature_markers:\n  - \"年\"\n  - \"月\"\n  - \"日\"\n  # 含日期且位于文末 3 段内，视为落款\n\n# ---------- 红头预留位 ----------\nredhead_placeholder: \"[红头：发文机关标志预留位]\"\nredhead_line_gap: 2      # 红头与标题之间的空行数\n\nFile v5.2.5:ARCHITECTURE.md\n\n# WPS Office Suite Skill 架构设计\n\n> **技能名称**：WPS Office Suite  \n> **中文名称**：WPS 全家桶  \n> **版本**：1.0.0  \n> **分类**：办公协作与生产力工具  \n> **目标平台**：Windows / macOS / Web  \n> **目标评分**：★★★★★ (4.8+/5.0)\n\n---\n\n## 一、市场定位与空白分析\n\n### 1.1 当前生态空白\n| 维度 | 现状 | 空白点 |\n|------|------|--------|\n| 国产办公 | SkillHub 仅有腾讯文档 Skill | WPS Office 全家桶（文字/表格/演示）完全空白 |\n| 深度集成 | 现有 Skill 仅做信息查询 | 缺乏\"创建→编辑→协作→格式转换\"全链路闭环 |\n| 用户覆盖 | 开发者导向严重 | 3 亿+ 国内办公人群的刚需未被满足 |\n| 平台互补 | 腾讯文档 Skill 单薄 | 与腾讯文档形成\"双办公生态\"互补 |\n\n### 1.2 目标用户画像\n- **核心用户**：国内办公白领、企业职员、学生群体\n- **使用场景**：日常文档处理、表格制作、演示汇报、格式转换\n- **痛点**：频繁在多个工具间切换、格式不兼容、协作流程繁琐\n\n---\n\n## 二、功能架构设计\n\n```\nWPS Office Suite Skill\n├── 📄 WPS 文字（Word）模块\n│   ├── 创建文档（从模板/空白）\n│   ├── 编辑文档（文本插入、格式设置、段落调整）\n│   ├── 页面设置（页边距、纸张、页眉页脚）\n│   ├── 目录生成与更新\n│   ├── 批注与修订\n│   └── 导出（DOCX/PDF/TXT）\n│\n├── 📊 WPS 表格（Excel）模块\n│   ├── 创建工作簿（多 Sheet 管理）\n│   ├── 数据录入与编辑\n│   ├── 公式与函数（SUM/AVERAGE/VLOOKUP 等常用函数）\n│   ├── 图表生成（柱状图/折线图/饼图）\n│   ├── 数据筛选与排序\n│   ├── 条件格式设置\n│   └── 导出（XLSX/CSV/PDF）\n│\n├── 🎬 WPS 演示（PPT）模块\n│   ├── 创建演示文稿\n│   ├── 幻灯片管理（添加/删除/排序）\n│   ├── 文本与图片插入\n│   ├── 版式与主题应用\n│   ├── 动画与切换效果\n│   └── 导出（PPTX/PDF/图片）\n│\n├── 🔄 格式转换中心\n│   ├── Word ↔ Excel ↔ PPT 互转\n│   ├── PDF → Word/Excel/PPT\n│   ├── Word/Excel/PPT → PDF\n│   └── 批量转换支持\n│\n├── 📁 文档管理\n│   ├── 打开本地文档\n│   ├── 保存到本地\n│   ├── 最近文档列表\n│   └── 文档属性查看\n│\n└── 🤝 协作功能\n    ├── 共享链接生成\n    ├── 协作权限设置\n    └── 版本历史查看\n```\n\n---\n\n## 三、技术架构设计\n\n### 3.1 运行模式\n```\n用户自然语言指令\n    ↓\nSKILL.md 解析与触发\n    ↓\n命令路由（判断模块）\n    ↓\n┌─────────────────────────────────────┐\n│  本地 WPS 应用（优先）               │\n│  ├── COM 接口调用（Windows）         │\n│  ├── AppleScript（macOS）            │\n│  └── WPS WebOffice API（备选）        │\n├─────────────────────────────────────┤\n│  云端 API（备选/混合模式）            │\n│  └── 金山文档开放平台 API             │\n│      ├── 文档操作 API                │\n│      ├── 表格操作 API                │\n│      ├── 格式转换 API                │\n│      └── 协作管理 API                │\n└─────────────────────────────────────┘\n    ↓\n执行结果返回\n    ↓\n自然语言回复用户\n```\n\n### 3.2 技术选型\n| 层级 | 技术方案 | 说明 |\n|------|----------|------|\n| 本地接口 | pywin32 / COM | Windows 下调用 WPS COM 接口 |\n| 本地接口 | appscript / pyobjc | macOS 下调用 WPS |\n| 云端 API | 金山文档开放平台 | 无 WPS 安装时的备选方案 |\n| 格式转换 | WPS 内置引擎 | 利用 WPS 强大的格式兼容能力 |\n| 脚本引擎 | Python 3.8+ | 主要脚本语言 |\n| 文件操作 | python-docx / openpyxl | 备选纯 Python 方案 |\n\n### 3.3 文件结构\n```\nwps-office-suite/\n├── SKILL.md                    # 技能定义文件（核心）\n├── README.md                   # 项目说明\n├── requirements.txt            # Python 依赖\n├── scripts/\n│   ├── wps_word.py             # WPS 文字操作脚本\n│   ├── wps_excel.py            # WPS 表格操作脚本\n│   ├── wps_ppt.py              # WPS 演示操作脚本\n│   ├── format_converter.py     # 格式转换脚本\n│   └── document_manager.py     # 文档管理脚本\n├── templates/\n│   ├── report_template.docx    # 报告模板\n│   ├── budget_template.xlsx    # 预算模板\n│   └── slide_template.pptx     # 演示模板\n├── config/\n│   ├── settings.json           # 配置文件\n│   └── api_keys.json           # API 密钥（用户自行配置）\n└── tests/\n    ├── test_word.py            # 文字模块测试\n    ├── test_excel.py           # 表格模块测试\n    └── test_ppt.py             # 演示模块测试\n```\n\n---\n\n## 四、SKILL.md 核心设计\n\n### 4.1 YAML Frontmatter 规范\n```yaml\n---\nname: wps-office-suite\ndescription: WPS Office 全家桶 - 支持 Word/Excel/PPT 创建、编辑、格式转换，自然语言驱动办公提效\nversion: 1.0.0\nauthor: 你的名字\ntrigger:\n  - \"帮我用WPS写个文档\"\n  - \"WPS文字处理\"\n  - \"WPS表格制作\"\n  - \"WPS演示文稿\"\n  - \"用WPS做个PPT\"\n  - \"WPS格式转换\"\n  - \"把PDF转成Word\"\n  - \"把Excel转成PPT\"\n  - \"WPS全家桶\"\n  - \"wps office\"\n  - \"创建文档\"\n  - \"制作表格\"\n  - \"做PPT\"\n  - \"文档格式转换\"\ncategory: 办公协作与生产力工具\nplatforms:\n  - windows\n  - macos\n  - web\npermission:\n  - 文件系统访问\n  - 应用程序控制（WPS Office）\n  - 网络访问（云端API备选）\ndependency:\n  - \"Python 3.8+\"\n  - \"WPS Office 2019+ 或 WPS 365\"\n  - \"pywin32（Windows）\"\n  - \"appscript（macOS）\"\npricing: 免费\ntags:\n  - WPS\n  - Office\n  - Word\n  - Excel\n  - PPT\n  - 文档处理\n  - 格式转换\n  - 办公提效\n---\n```\n\n### 4.2 触发词设计原则\n| 原则 | 示例 |\n|------|------|\n| 自然语言优先 | \"帮我用WPS写个报告\" 而非 \"WPS-CREATE-DOC\" |\n| 覆盖常见问法 | \"做PPT\" / \"做个演示文稿\" / \"WPS演示\" |\n| 避免歧义 | \"WPS文字处理\" 而非 \"处理文档\" |\n| 中英文兼容 | \"WPS office\" / \"wps office\" / \"WPS全家桶\" |\n\n---\n\n## 五、可运行命令设计\n\n### 5.1 WPS 文字命令\n| 命令 | 功能 | 示例 |\n|------|------|------|\n| `create_word` | 创建 Word 文档 | \"帮我创建一份工作总结\" |\n| `edit_word` | 编辑 Word 文档 | \"在文档末尾加一段\" |\n| `format_word` | 格式设置 | \"标题居中，正文首行缩进\" |\n| `export_word` | 导出文档 | \"把文档导出为PDF\" |\n\n### 5.2 WPS 表格命令\n| 命令 | 功能 | 示例 |\n|------|------|------|\n| `create_excel` | 创建 Excel 表格 | \"帮我做个预算表\" |\n| `input_data` | 数据录入 | \"在A1输入标题\" |\n| `add_formula` | 添加公式 | \"在C列求和\" |\n| `create_chart` | 生成图表 | \"根据数据生成柱状图\" |\n| `filter_data` | 数据筛选 | \"筛选出金额大于1000的\" |\n\n### 5.3 WPS 演示命令\n| 命令 | 功能 | 示例 |\n|------|------|------|\n| `create_ppt` | 创建 PPT | \"帮我做个项目汇报PPT\" |\n| `add_slide` | 添加幻灯片 | \"添加一页内容页\" |\n| `insert_content` | 插入内容 | \"插入标题和要点\" |\n| `apply_theme` | 应用主题 | \"使用商务主题\" |\n\n### 5.4 格式转换命令\n| 命令 | 功能 | 示例 |\n|------|------|------|\n| `convert_format` | 格式转换 | \"把PDF转成Word\" |\n| `batch_convert` | 批量转换 | \"批量把Word转成PDF\" |\n\n---\n\n## 六、安全与合规设计\n\n### 6.1 安全边界\n| 风险项 | 防护措施 |\n|--------|----------|\n| 文件泄露 | 所有操作仅在本地执行，不上传云端 |\n| 恶意代码 | 脚本经过安全扫描，无网络外发行为 |\n| 权限越权 | 仅访问用户明确指定的文件路径 |\n| 数据篡改 | 操作前备份，支持撤销 |\n| 隐私保护 | 不收集用户文档内容，不上传分析 |\n\n### 6.2 风险提示（SKILL.md 必须包含）\n```markdown\n## ⚠️ 风险提示\n\n1. **文件安全**：本技能会操作您的本地文档，建议重要文件提前备份\n2. **格式兼容性**：部分复杂格式转换可能丢失原始排版\n3. **依赖要求**：需要安装 WPS Office 2019 或 WPS 365 版本\n4. **系统权限**：需要文件系统访问和应用程序控制权限\n5. **网络访问**：仅在备选模式下使用云端 API，默认纯本地运行\n```\n\n---\n\n## 七、TRACE 评分优化策略\n\n### 7.1 T — Trust（可信任度）\n- 实名认证开发者\n- 代码开源可审计\n- 明确隐私政策\n- 无恶意行为记录\n\n### 7.2 R — Reliability（可靠性）\n- 完善的异常处理\n- 进度反馈机制\n- 操作结果确认\n- 支持撤销/重做\n\n### 7.3 A — Adaptability（适用性）\n- 支持 Windows/macOS/Web\n- 兼容 WPS 2019/2021/365\n- 支持多种文档格式\n- 适应不同用户习惯\n\n### 7.4 C — Convention（规范性）\n- 严格遵循 SKILL.md 规范\n- 清晰的 YAML frontmatter\n- 完整的 Markdown 文档\n- 语义化版本管理\n\n### 7.5 E — Effectiveness（有效性）\n- 解决真实办公痛点\n- 操作步骤简洁高效\n- 输出质量符合预期\n- 持续迭代优化\n\n---\n\n## 八、开发路线图\n\n### Phase 1：MVP（1-2 周）\n- [ ] 基础框架搭建\n- [ ] Word 创建/编辑/导出\n- [ ] Excel 创建/数据录入\n- [ ] PPT 创建/幻灯片管理\n- [ ] 本地 WPS 接口调用\n\n### Phase 2：增强版（3-4 周）\n- [ ] 格式转换中心\n- [ ] 模板系统\n- [ ] 公式与图表\n- [ ] 批量操作\n- [ ] 云端 API 备选\n\n### Phase 3：完整版（5-6 周）\n- [ ] 协作功能\n- [ ] 版本管理\n- [ ] 高级格式设置\n- [ ] 性能优化\n- [ ] 完整测试\n\n---\n\n## 九、审核准备清单\n\n- [ ] 实名认证完成\n- [ ] SKILL.md 完整规范\n- [ ] 本地测试通过\n- [ ] 安全扫描通过\n- [ ] 文档示例充分\n- [ ] 隐私政策明确\n- [ ] 版本号语义化\n- [ ] 触发词覆盖全面\n\n---\n\n*文档版本：v1.0.0*  \n*最后更新：2026-06-27*  \n*作者：你的名字*\n\nFile v5.2.5:skill-card.md\n\n## Description:\n\nWPS Office Suite helps agents automate Word, Excel, PowerPoint, format conversion, document search, watermarking, redaction, templates, and office workflow tasks across WPS Office, Microsoft Office, LibreOffice, and pure Python modes.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[fyniujin](https://clawhub.ai/user/fyniujin)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nEmployees, external users, and developers use this skill to create, edit, analyze, convert, search, and manage office documents through agent-generated commands and guidance. It is suited for office productivity workflows that need local or configurable document automation.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive documents may be processed through optional external LLM or cloud modes.\n\nMitigation: Use local modes for sensitive content unless the endpoint, credentials, and data-handling policy are trusted.\n\nRisk: Opening search results from shared or untrusted folders can expose unsafe files.\n\nMitigation: Avoid doc_search --open on shared or untrusted folders and restrict search paths to trusted directories.\n\nRisk: Watch rules and scheduled tasks can run long-lived automation.\n\nMitigation: Inspect YAML watch rules and scheduled task definitions before enabling automation.\n\nRisk: Office automation and format conversion can modify files or lose complex formatting.\n\nMitigation: Back up important documents and review generated or converted files before distribution.\n\n## Reference(s):\n\n- [WPS Office Suite on ClawHub](https://clawhub.ai/fyniujin/skills/wps-office-suite)\n- [gongwen_rules.yaml](references/gongwen_rules.yaml)\n- [Contract review skill](https://skillhub.cn/skills/contract-review)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance, Files]\n\n**Output Format:** [Markdown guidance with inline shell commands and generated office documents or supporting JSON when relevant]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May create or modify Word, Excel, PowerPoint, PDF, text, template, watermark, redaction, and search index files depending on the selected workflow.]\n\n## Skill Version(s):\n\n5.2.5 (source: frontmatter and server release)\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\nFile v5.2.5:templates/templates_index.json\n\n{\n  \"version\": \"4.9.0\",\n  \"total\": 56,\n  \"categories\": {\n    \"official\": {\n      \"label\": \"公文模板\",\n      \"count\": 12,\n      \"description\": \"政府/企业公文标准格式\"\n    },\n    \"contract\": {\n      \"label\": \"合同模板\",\n      \"count\": 10,\n      \"description\": \"各类商务合同范本\"\n    },\n    \"resume\": {\n      \"label\": \"简历模板\",\n      \"count\": 8,\n      \"description\": \"求职简历多种风格\"\n    },\n    \"bid\": {\n      \"label\": \"标书模板\",\n      \"count\": 8,\n      \"description\": \"投标书标准格式\"\n    },\n    \"report\": {\n      \"label\": \"报告模板\",\n      \"count\": 10,\n      \"description\": \"各类工作报告/调研报告\"\n    },\n    \"meeting\": {\n      \"label\": \"会议模板\",\n      \"count\": 8,\n      \"description\": \"会议纪要/议程/记录\"\n    }\n  },\n  \"templates\": [\n    {\n      \"name\": \"通知\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"标准公文通知格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发文单位\", \"日期\"]\n    },\n    {\n      \"name\": \"请示\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"向上级请示标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"请示事项\", \"日期\"]\n    },\n    {\n      \"name\": \"报告\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"向上级报告标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"工作概况\", \"日期\"]\n    },\n    {\n      \"name\": \"函\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"商务往来函标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发函单位\", \"收函单位\", \"日期\"]\n    },\n    {\n      \"name\": \"会议纪要\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"公文会议纪要标准格式\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"参会人员\", \"会议内容\", \"决议事项\"]\n    },\n    {\n      \"name\": \"决定\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"行政决定标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发文单位\", \"日期\"]\n    },\n    {\n      \"name\": \"批复\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"上级批复标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"批复单位\", \"日期\"]\n    },\n    {\n      \"name\": \"通报\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"通报标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发文单位\", \"日期\"]\n    },\n    {\n      \"name\": \"公告\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"公开公告标准格式\",\n      \"placeholders\": [\"标题\", \"正文\", \"发布单位\", \"日期\"]\n    },\n    {\n      \"name\": \"议案\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"人大/政协议案标准格式\",\n      \"placeholders\": [\"案由\", \"理由\", \"办法\", \"提案人\", \"日期\"]\n    },\n    {\n      \"name\": \"工作总结\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"年度/季度工作总结\",\n      \"placeholders\": [\"标题\", \"工作概况\", \"主要成绩\", \"存在问题\", \"下步计划\", \"日期\"]\n    },\n    {\n      \"name\": \"工作计划\",\n      \"category\": \"official\",\n      \"format\": \"docx\",\n      \"description\": \"年度/季度工作计划\",\n      \"placeholders\": [\"标题\", \"指导思想\", \"工作目标\", \"具体措施\", \"时间安排\", \"日期\"]\n    },\n    {\n      \"name\": \"买卖合同\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"标准商品买卖合同范本\",\n      \"placeholders\": [\"买方\", \"卖方\", \"标的物\", \"数量\", \"单价\", \"总价\", \"交货地点\", \"付款方式\", \"违约责任\", \"签订日期\"]\n    },\n    {\n      \"name\": \"租赁合同\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"房屋租赁/设备租赁合同\",\n      \"placeholders\": [\"出租方\", \"承租方\", \"租赁物\", \"租赁期限\", \"租金\", \"押金\", \"签订日期\"]\n    },\n    {\n      \"name\": \"服务合同\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"咨询服务/技术服务合同\",\n      \"placeholders\": [\"委托方\", \"受托方\", \"服务内容\", \"服务期限\", \"费用\", \"签订日期\"]\n    },\n    {\n      \"name\": \"劳动合同\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"标准劳动合同范本\",\n      \"placeholders\": [\"用人单位\", \"劳动者\", \"合同期限\", \"工作地点\", \"岗位\", \"薪资\", \"签订日期\"]\n    },\n    {\n      \"name\": \"保密协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"商业秘密保密协议\",\n      \"placeholders\": [\"甲方\", \"乙方\", \"保密内容\", \"保密期限\", \"违约责任\", \"签订日期\"]\n    },\n    {\n      \"name\": \"竞业限制协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"竞业禁止协议范本\",\n      \"placeholders\": [\"用人单位\", \"劳动者\", \"限制期限\", \"补偿金\", \"签订日期\"]\n    },\n    {\n      \"name\": \"投资协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"股权投资/融资协议\",\n      \"placeholders\": [\"投资方\", \"融资方\", \"投资金额\", \"股权比例\", \"签订日期\"]\n    },\n    {\n      \"name\": \"合伙协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"合伙企业合伙协议\",\n      \"placeholders\": [\"合伙人\", \"出资方式\", \"利润分配\", \"入伙退伙\", \"签订日期\"]\n    },\n    {\n      \"name\": \"委托书\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"授权委托书标准格式\",\n      \"placeholders\": [\"委托人\", \"受托人\", \"委托事项\", \"委托权限\", \"委托期限\", \"日期\"]\n    },\n    {\n      \"name\": \"和解协议\",\n      \"category\": \"contract\",\n      \"format\": \"docx\",\n      \"description\": \"民事/商事和解协议\",\n      \"placeholders\": [\"甲方\", \"乙方\", \"纠纷事实\", \"和解条款\", \"签订日期\"]\n    },\n    {\n      \"name\": \"经典简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"经典简洁风格简历\",\n      \"placeholders\": [\"姓名\", \"联系方式\", \"求职意向\", \"教育背景\", \"工作经历\", \"技能特长\"]\n    },\n    {\n      \"name\": \"现代简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"现代蓝色主题简历\",\n      \"placeholders\": [\"姓名\", \"联系方式\", \"求职意向\", \"教育背景\", \"工作经历\", \"技能特长\"]\n    },\n    {\n      \"name\": \"商务简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"深色商务风格简历\",\n      \"placeholders\": [\"姓名\", \"联系方式\", \"求职意向\", \"教育背景\", \"工作经历\", \"技能特长\"]\n    },\n    {\n      \"name\": \"应届生简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"应届生专用简历模板\",\n      \"placeholders\": [\"姓名\", \"联系方式\", \"求职意向\", \"教育背景\", \"实习经历\", \"获奖情况\"]\n    },\n    {\n      \"name\": \"英文简历\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"标准英文简历模板\",\n      \"placeholders\": [\"Name\", \"Contact\", \"Objective\", \"Education\", \"Experience\", \"Skills\"]\n    },\n    {\n      \"name\": \"简历封面\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"简历封面页模板\",\n      \"placeholders\": [\"姓名\", \"应聘职位\", \"毕业院校\", \"联系方式\"]\n    },\n    {\n      \"name\": \"自荐信\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"求职自荐信模板\",\n      \"placeholders\": [\"姓名\", \"应聘职位\", \"自我介绍\", \"能力优势\", \"期望薪资\", \"联系方式\"]\n    },\n    {\n      \"name\": \"转岗申请\",\n      \"category\": \"resume\",\n      \"format\": \"docx\",\n      \"description\": \"内部转岗申请模板\",\n      \"placeholders\": [\"姓名\", \"现岗位\", \"申请岗位\", \"转岗原因\", \"相关经验\", \"日期\"]\n    },\n    {\n      \"name\": \"投标书封面\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"投标书封面/封套模板\",\n      \"placeholders\": [\"项目名称\", \"招标编号\", \"投标人\", \"日期\"]\n    },\n    {\n      \"name\": \"技术标书\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"技术标书模板（技术方案部分）\",\n      \"placeholders\": [\"项目名称\", \"技术方案\", \"实施计划\", \"项目团队\", \"质量保证\"]\n    },\n    {\n      \"name\": \"商务标书\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"商务标书模板（报价/资质部分）\",\n      \"placeholders\": [\"项目名称\", \"总报价\", \"分项报价\", \"资质证明\", \"业绩证明\"]\n    },\n    {\n      \"name\": \"施工组织设计\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"工程施工组织设计模板\",\n      \"placeholders\": [\"工程名称\", \"编制依据\", \"施工部署\", \"进度计划\", \"资源配置\"]\n    },\n    {\n      \"name\": \"项目管理方案\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"IT项目管理实施方案模板\",\n      \"placeholders\": [\"项目名称\", \"项目范围\", \"实施计划\", \"风险管理\", \"验收标准\"]\n    },\n    {\n      \"name\": \"售后服务承诺\",\n      \"category\": \"bid\",\n      \"format\": \"docx\",\n      \"description\": \"售后服务及质保承诺模板\",\n      \"placeholders\": [\"服务承诺\", \"响应时间\", \"质保期限\", \"培训计划\", \"联系方式\"]\n    },\n    {\n      \"name\": \"财务报表\",\n      \"category\": \"bid\",\n      \"format\": \"xlsx\",\n      \"description\": \"财务报表模板（资产负债表/利润表/现金流量表）\",\n      \"placeholders\": [\"编制单位\", \"会计期间\", \"金额\"]\n    },\n    {\n      \"name\": \"报价表\",\n      \"category\": \"bid\",\n      \"format\": \"xlsx\",\n      \"description\": \"分项报价明细表模板\",\n      \"placeholders\": [\"项目名称\", \"规格型号\", \"单位\", \"数量\", \"单价\", \"合价\"]\n    },\n    {\n      \"name\": \"调研报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"调研报告标准模板\",\n      \"placeholders\": [\"调研背景\", \"调研方法\", \"调研结果\", \"分析结论\", \"对策建议\"]\n    },\n    {\n      \"name\": \"市场分析报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"市场分析/行业研究报告模板\",\n      \"placeholders\": [\"报告摘要\", \"行业概况\", \"市场分析\", \"竞争格局\", \"趋势预测\"]\n    },\n    {\n      \"name\": \"项目总结报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"项目完成总结报告模板\",\n      \"placeholders\": [\"项目背景\", \"实施过程\", \"成果效益\", \"经验教训\", \"后续计划\"]\n    },\n    {\n      \"name\": \"财务分析报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"企业财务分析报告模板\",\n      \"placeholders\": [\"报告期间\", \"财务概况\", \"偿债能力\", \"盈利能力\", \"运营能力\", \"发展能力\"]\n    },\n    {\n      \"name\": \"可行性分析报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"项目可行性分析报告模板\",\n      \"placeholders\": [\"项目概述\", \"市场分析\", \"技术方案\", \"投资估算\", \"效益分析\", \"风险分析\"]\n    },\n    {\n      \"name\": \"审计报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"内部审计/离任审计报告模板\",\n      \"placeholders\": [\"审计对象\", \"审计范围\", \"审计发现\", \"审计意见\", \"整改建议\"]\n    },\n    {\n      \"name\": \"尽职调查报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"投资/并购尽职调查报告模板\",\n      \"placeholders\": [\"公司概况\", \"业务分析\", \"财务分析\", \"法律风险\", \"投资建议\"]\n    },\n    {\n      \"name\": \"述职报告\",\n      \"category\": \"report\",\n      \"format\": \"docx\",\n      \"description\": \"领导干部/员工述职报告模板\",\n      \"placeholders\": [\"岗位职责\", \"履职情况\", \"存在问题\", \"改进方向\", \"工作计划\"]\n    },\n    {\n      \"name\": \"PPT方案汇报\",\n      \"category\": \"report\",\n      \"format\": \"pptx\",\n      \"description\": \"项目方案/工作汇报PPT模板\",\n      \"placeholders\": [\"汇报人\", \"项目名称\", \"核心内容\", \"实施计划\", \"预期成果\"]\n    },\n    {\n      \"name\": \"会议议程\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"会议议程/日程安排模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"会议地点\", \"参会人员\", \"议程安排\"]\n    },\n    {\n      \"name\": \"会议签到表\",\n      \"category\": \"meeting\",\n      \"format\": \"xlsx\",\n      \"description\": \"会议签到/考勤表模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"参会人员\", \"签到时间\"]\n    },\n    {\n      \"name\": \"董事会决议\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"董事会决议标准模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"出席董事\", \"议案内容\", \"表决结果\"]\n    },\n    {\n      \"name\": \"股东会决议\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"股东会决议标准模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"出席股东\", \"议案内容\", \"表决结果\"]\n    },\n    {\n      \"name\": \"办公会纪要\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"总经理办公会/例会纪要模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"主持人\", \"参会人员\", \"议题内容\", \"会议决议\"]\n    },\n    {\n      \"name\": \"培训签到表\",\n      \"category\": \"meeting\",\n      \"format\": \"xlsx\",\n      \"description\": \"培训签到/记录表模板\",\n      \"placeholders\": [\"培训主题\", \"培训时间\", \"培训讲师\", \"参训人员\", \"签到时间\"]\n    },\n    {\n      \"name\": \"会议记录表\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"会议过程详细记录表模板\",\n      \"placeholders\": [\"会议名称\", \"会议时间\", \"记录人\", \"发言内容\", \"决议事项\"]\n    },\n    {\n      \"name\": \"工作周报\",\n      \"category\": \"meeting\",\n      \"format\": \"docx\",\n      \"description\": \"个人工作周报模板\",\n      \"placeholders\": [\"姓名\", \"部门\", \"本周完成\", \"下周计划\", \"需要协调\"]\n    }\n  ]\n}\n\nFile v5.2.5:requirements.txt\n\npywin32>=303; sys_platform == \"win32\"\npython-docx>=0.8.11\nopenpyxl>=3.1.1\nPillow>=9.0.0\npython-pptx>=0.6.21\n\n# 以下为可选依赖，需显式安装使用对应外部服务\n# Google Cloud Speech API（语音转写，可选）\n# pip install google-cloud-speech\n# \n# Azure Cognitive Services Speech（语音转写，可选）\n# pip install azure-cognitiveservices-speech\n\nArchive v5.2.0: 56 files, 263759 bytes\n\nFiles: ARCHITECTURE.md (10521b), README.md (958b), references/gongwen_rules.yaml (3506b), requirements.txt (371b), scripts/chart_recommender.py (14816b), scripts/clarify.py (13148b), scripts/com_health.py (26531b), scripts/conditional_format_io.py (15694b), scripts/doc_search.py (11058b), scripts/document_manager.py (5005b), scripts/document_translator.py (19200b), scripts/email_reply.py (34772b), scripts/excel_analyzer.py (49984b), scripts/format_converter.py (6286b), scripts/formula_explainer.py (17493b), scripts/gongwen.py (11014b), scripts/kingdoc_bridge.py (17359b), scripts/llm_bridge.py (14136b), scripts/long_document.py (47917b), scripts/md_converter.py (15769b), scripts/meeting_minutes.py (46320b), scripts/nl2sql_engine.py (29165b), scripts/pipeline_bridge.py (13775b), scripts/ppt_generator.py (36950b), scripts/redact.py (7850b), scripts/report_generator.py (23299b), scripts/schedule_register.py (23066b), scripts/template_manager.py (24136b), scripts/usage_stats.py (22341b), scripts/validation_io.py (9907b), scripts/watch.py (29747b), scripts/watermark.py (10861b), scripts/wps_ai.py (10296b), scripts/wps_common.py (5850b), scripts/wps_docx_to_ppt.py (15447b), scripts/wps_engine.py (4093b), scripts/wps_error.py (10326b), scripts/wps_excel.py (18502b), scripts/wps_feedback.py (2830b), scripts/wps_invoice_ocr.py (12045b), scripts/wps_ms.py (3140b), scripts/wps_nl_analysis.py (13727b), scripts/wps_performance.py (5649b), scripts/wps_ppt.py (5139b), scripts/wps_pure_enhancements.py (23077b), scripts/wps_pure.py (29423b), scripts/wps_test.py (8261b), scripts/wps_toc.py (7484b), scripts/wps_update.py (3689b), scripts/wps_word.py (14694b), scripts/wps_worker.py (31808b), skill-card.md (2757b), SKILL.md (56115b), templates/generate_templates.py (13622b), templates/templates_index.json (14466b), _meta.json (135b)\n\nFile v5.2.0:SKILL.md\n\n---\nname: wps-office-suite\ndescription: WPS Office 全家桶 - 四引擎（WPS/MS Office/LibreOffice/纯Python）智能识别用户已安装软件，纯Python模式支持排序/筛选/图表/公式/统计，含文档模板（代码生成）、最佳实践案例、故障排除大章（20+避坑+15 FAQ+15错误ID 统一索引）、自动重试、硬件自适应、环境自检、Skill更新提醒；v5.1新增：kingdoc云端桥接（白名单探测+配置预检+subprocess上传+差异检查）、条件格式/数据验证跨引擎IO（JSON中间格式保真往返）、会议纪要三段式要素化（待办清单+决策记录+风险异议）+说话人标注（MFCC聚类）；v5.2新增：公文一键排版（GB/T 9704 规则库约束+结构识别套版+红头预留位+联合行文）、批量水印与敏感信息打码（身份证/手机号/银行卡/邮箱双轨识别+黑色矩形覆盖+打码清单）、跨文档知识检索与问答（本地TF-IDF零依赖+跳转+可选zwjh记忆桥接）；删除：与contract-review重复的轻量合同审查模块，改为文档互链引导\nversion: 5.2.0\n---\n\n\n# WPS Office 全家桶 v5.2.0 ✅\n\n> 🏗️ **四引擎智能识别**：自动检测用户电脑已安装的软件，按 WPS → MS Office → LibreOffice → 纯Python 顺序选择最合适的引擎\n> ✨ **纯Python模式增强 v4.8**：排序、筛选、图表、公式、统计、条件格式、数据验证、合并单元格、命名区域 — 跨平台全部支持\n> 🔄 **自动重试**：WPS 卡住时自动重试 3 次，不用手动重启\n> ⚡ **硬件自适应**：自动检测 CPU 内存，动态调整超时和线程，不拖累电脑\n> 📚 **文档模板 + 最佳实践 + 故障排除**：代码生成3个即用模板 + 10个最佳实践案例 + 统一故障排除大章\n> 📬 **Skill 更新提醒**：自动检查新版本，7天提醒一次，保持最新\n> 🆕 **文件大小明确限制**：单文件 < 50MB 直接处理，> 50MB 有分片建议\n> 🔬 **Excel 智能分析 v4.6**：6命令合并为 1 个统一入口（--action 参数路由）\n> 📊 **数据图表生成器 v4.6**：基于数据特征自动推荐图表类型 + 生成图表嵌入 Excel\n> 🌐 **文档翻译 v4.6**：Word/Excel/PPT 专业翻译（支持多模型降级）\n> 🎙️ **会议纪要 v4.5**：音频 → ASR 转写 → LLM 摘要 → Word（支持降级链）\n> 🏥 **COM 健康检查 v4.5**：WPS/MS Office 状态检测 + 残留进程清理\n> 🧮 **公式解释器 v4.7**：Excel 公式 → 自然语言解释（反向 NL2Formula，纯本地实现）\n> 📝 **Markdown 转换 v4.7**：MD → Word/PPT（保留标题层级，纯本地实现）\n> 📑 **长文档排版 v4.7**：统一入口 long-document --action（8命令合并），性能优化（分批+单次保存+进度回调）\n> ✉️ **邮件智能回复 v4.8**：模板匹配 + LLM 个性化回复（纯本地，多模型降级）\n> 📊 **周报/月报生成 v4.8**：关键点 → 结构化 Word 报告（模板 + 可选 LLM 润色）\n> 🤖 **AI 统一入口 v4.9**：`wps ai --action` 统一 9 大 AI 功能入口（新增续写/改写/扩写）\n> 🌉 **llm_bridge 桥接层 v4.9**：统一模型层，白名单探测 cn-llm-router，零配置多模型调用\n> 📋 **模板市场 v4.9**：50+ 内置模板（公文/合同/简历/标书/报告/会议），支持用户沉淀和分享\n> 💬 **NL2Formula 多轮澄清 v4.9**：歧义检测 → 槽位填充 → 反向验证，公式生成更精准\n> ⏰ **定时任务 v5.0**：schtasks/crontab 注册管理，周报/月报/数据刷新一键定时\n> 👁️ **目录监听 v5.0**：轮询监听 + YAML规则 + 大文件自动分片 + LibreOffice并发控制\n> 📊 **稳定性中心 v5.0**：SQLite埋点统计 + 引擎健康度 + 全局engine-info + 引擎偏好配置\n> 🏥 **COM自愈 v5.0**：三步自愈（regsvr32 → 修复安装 → 手动指引），每步记录日志\n> 💬 **对话式查询 v5.0**：NL2SQL式意图解析 + 查询计划生成 + 连续追问，Top20关键词模板降级\n> 🔗 **编排引擎桥接 v5.0**：白名单探测 multi-agent-orchestrator，命中注册流水线模板，未装本地串行降级\n> ☁️ **kingdoc 桥接 v5.1**：白名单探测+配置预检+subprocess 上传金山文档，difflib 差异检查\n> 🔄 **跨引擎 IO v5.1**：条件格式/数据验证 JSON 中间格式，WPS↔纯 Python 保真往返\n> 📋 **纪要要素化 v5.1**：三段式结构（待办清单+决策记录+风险异议）+ 说话人标注\n> 📑 **公文一键排版 v5.2**：GB/T 9704 规则库约束 + 结构识别套版，支持红头预留位与联合行文，处理前自动备份\n> 🔒 **批量水印与打码 v5.2**：文字/图片水印（平铺/对角线，批量目录）；敏感信息双轨识别（身份证/手机号/银行卡/邮箱）+ 黑色矩形覆盖 + 打码清单\n> 🔍 **跨文档检索 v5.2**：本地 TF-IDF 零依赖索引，跨文档找内容问答，命中返回文件+段落+跳转，可选 embedding 与 zwjh 记忆桥接\n> 🔗 **合同审查改互链 v5.2**：裁撤重复合同审查模块，完整审查请安装 contract-review（互链引导，无代码依赖）\n> 📧 **建议反馈**：有更好建议？邮箱：[njskills@agent.qq.com](mailto:njskills@agent.qq.com)\n\n---\n\n## 🚀 分钟上手\n\n### 1. 检查环境\n\n```bash\npython scripts/wps_test.py\n```\n\n### 2. 查看当前引擎 + 硬件\n\n```bash\npython scripts/wps_excel.py engine-info\n```\n\n### 3. 创建文件\n\n```bash\npython scripts/wps_word.py create --title \"测试文档\"\npython scripts/wps_excel.py create --name \"预算表\" --sheets \"收入,支出\"\npython scripts/wps_ppt.py create --title \"推广方案\"\n```\n\n### 4. 检查更新\n\n```bash\npython scripts/wps_excel.py check-update\n```\n\n### 5. 生成模板（代码生成，无二进制文件）\n\n```bash\npython templates/generate_templates.py --dir ./output\n```\n\n---\n\n## ⚡ 硬件自适应\n\n| 硬件等级 | CPU / 内存 | 超时 | 并行数 | 适用场景 |\n|---------|-----------|------|-------|---------|\n| 高性能 | 8核+ / 16G+ | 30s | 8线程 | 批量处理、大文件 |\n| 中等 | 4核+ / 8G+ | 60s | 4线程 | 日常办公 |\n| 低性能 | 2核 / 4G | 120s | 1线程 | 轻量任务 |\n\n---\n\n## 🔧 功能矩阵\n\n| 功能 | WPS | MS Office | LibreOffice | 纯Python |\n|------|-----|-----------|-------------|----------|\n| **创建/编辑/格式 — Word** | ✅ | ✅ | ✅（回退） | ✅ |\n| **表格/图片/目录 — Word** | ✅ | ✅ | ❌ | ✅ |\n| **创建/编辑/公式/图表 — Excel** | ✅ | ✅（回退） | ✅（回退） | ✅ |\n| **排序/筛选/统计 — Excel** | ✅ | ✅（回退） | ✅（回避） | ✅ |\n| **条件格式/数据验证 — Excel** | ✅ | ✅（回退） | ❌ | ✅（v4.8 新增） |\n| **幻灯片/主题/插入 — PPT** | ✅ | ❌ | ❌ | ❌ |\n| **PPT 创建/多页 — PPT** | ✅ | ✅ | ✅（回退） | ✅ |\n\n> ✅（回退）= 原生引擎不支持时，自动回退到纯 Python 实现\n\n---\n\n## 📂 文档模板（代码生成，零二进制文件）\n\n| 模板 | 用途 | 生成命令 |\n|------|------|---------|\n| 工作报告 | 周报/月报/汇报 | `python templates/generate_templates.py --dir ./output` |\n| 月度预算 | 收入/支出/汇总 | 同上 |\n| 商务PPT | 项目汇报/方案 | 同上 |\n\n> 模板通过纯 Python 代码动态生成，无需分发二进制文件。首次运行需安装 `python-docx`、`openpyxl`、`python-pptx`。\n\n---\n\n## ⚠️ 文件限制速查\n\n| 限制项 | 阈值建议 | 超出后处理方式 |\n|--------|---------|--------------|\n| **单文件大小** | < 50MB 直接处理 | > 50MB 先分片（拆 Sheet/Section） |\n| **批量文件数** | 建议 ≤ 50 个/批 | 超过时分批调用 |\n| **Excel 行数** | < 100,000 行 | 超过时分 Sheet 存储 |\n| **PPT 页数** | < 100 页 | 拆分为多个文件 |\n| **并发操作** | 同一引擎 1 个实例 | 串行等待，避免并行写同一文件 |\n| **文件名长度** | < 200 字符 | 过短路径避免中文 |\n\n---\n\n## 🔧 故障排除大章（v4.5 合并，统一索引）\n\n### 统一索引表\n\n| 类型 | 问题 | 快速解决 |\n|------|------|---------|\n| 🚫 避坑 | WPS 未安装就调用 | 运行 engine-info 检查引擎 |\n| 🚫 避坑 | 公式写入显示 #NAME? | 按 Ctrl+Alt+F9 重新计算 |\n| 🚫 避坑 | 中文路径编码错误 | 改用英文路径或 raw string |\n| 🚫 避坑 | 大文件内存溢出 | >50MB 分片处理 |\n| 🚫 避坑 | WPS 卡住无响应 | 已自动重试3次，不行就任务管理器结束 |\n| 🚫 避坑 | COM 对象残留 | Worker 自动释放，或运行 com-health release-all |\n| 🚫 避坑 | PPT 添加幻灯片失败 | 仅 WPS 支持，或一次性指定 slides_content |\n| 🚫 避坑 | openpyxl 读取公式为 None | 先 WPS 打开保存一次 |\n| 🚫 避坑 | 排序/筛选/图表错乱 | 确保第一行是表头，列名完全一致 |\n| 🚫 避坑 | 筛选返回空结果 | 数值 value 必须是字符串 |\n| ⚠️ FAQ | 该选哪个引擎？ | 自动检测，无需手动选择 |\n| ⚠️ FAQ | WPS 版本有要求？ | 2019+ 或 WPS 365，安装后必须重启 |\n| ⚠️ FAQ | 纯Python vs WPS 区别？ | 公式计算/图表/添加幻灯片不同 |\n| ⚠️ FAQ | 文件太大怎么办？ | <50MB 直接处理，>50MB 分片 |\n| ⚠️ FAQ | Linux 能用吗？ | 能，安装 LibreOffice |\n| ⚠️ FAQ | WPS 卡住怎么办？ | 自动重试3次，不行结束进程 |\n| ⚠️ FAQ | 纯Python 安装依赖？ | pip install python-docx openpyxl python-pptx |\n| ⚠️ FAQ | 模板如何获取？ | 代码生成，运行 generate_templates.py |\n| ⚠️ FAQ | 批量转换格式？ | format_converter.py batch |\n| ⚠️ FAQ | 多 Sheet 处理？ | 逐 Sheet 调用或 add-sheet |\n| ⚠️ FAQ | 排序/筛选总失败？ | 确保 openpyxl 安装、文件未占用 |\n| ⚠️ FAQ | 如何提交反馈？ | wps_feedback.py email 或发邮件 |\n| ⚠️ FAQ | 公式何时计算？ | 打开文件时由 Excel/WPS 计算 |\n| ⚠️ FAQ | 文件被占用怎么办？ | 关闭程序，等待3-5秒重试 |\n| ⚠️ FAQ | 纯Python 不可用功能？ | 添加幻灯片/插入/主题/VBA/条件格式 |\n| 🚨 错误ID | E001 WPS 未安装或 COM 注册失败 | 安装 WPS 后重启电脑 |\n| 🚨 错误ID | E002 python-docx 未安装 | pip install python-docx openpyxl python-pptx |\n| 🚨 错误ID | E003 文件路径不存在 | 改用英文路径或以管理员运行 |\n| 🚨 错误ID | E004 格式转换失败 | 安装 WPS 或 LibreOffice |\n| 🚨 错误ID | E005 需要 WPS 模式 | 安装 WPS 或改用纯Python模式 |\n| 🚨 错误ID | E006 WPS 卡住无响应 | 任务管理器结束进程；更新到最新版 |\n| 🚨 错误ID | E007 权限不足 | 以管理员运行；检查文件只读属性 |\n| 🚨 错误ID | E008 pywin32 导入失败 | pip uninstall pywin32 && pip install pywin32 |\n| 🚨 错误ID | E009 Python 版本过低 | 升级到 Python 3.8+ |\n| 🚨 错误ID | E010 引擎不支持此功能 | 安装 WPS 或改用 info 查看能力矩阵 |\n| 🚨 错误ID | E011 LibreOffice 未安装 | 下载 LibreOffice 并添加到 PATH |\n| 🚨 错误ID | E012 LibreOffice 转换失败 | 检查源文件是否损坏；避免中文路径 |\n| 🚨 错误ID | E013 文件不存在 | 确认路径正确；未被删除或移动 |\n| 🚨 错误ID | E014 未知运行时错误 | 运行环境自检 wps_test.py；联系反馈 |\n| 🚨 错误ID | E015 不支持的操作或格式 | 输出格式改为 pdf/txt/html |\n\n---\n\n## 🚫 避坑详解（20+ 条）\n\n### 🥇 高频问题（TOP 10）\n\n#### ❌ 坑 1：WPS 没安装就调用 WPS 功能\n\n```\n症状：win32com.com_error 或 \"WPS 未安装\"\n排查：\n  1. 运行 python scripts/wps_excel.py engine-info 检查当前引擎\n  2. 如果显示 PURE 或 LIBREOFFICE，说明 WPS 不可用\n  3. 安装 WPS Office 2019+ 后重启电脑\n```\n\n#### ❌ 坑 2：纯 Python 模式下写公式，打开 Excel 显示 #NAME?\n\n```\n症状：公式写入后打开显示 #NAME? 错误\n排查：\n  1. openpyxl 写的是公式字符串，打开时需 Excel/WPS 重新计算\n  2. 解决：按 Ctrl+Alt+F9 强制重新计算\n  3. 或切换到 WPS 模式自动计算\n```\n\n#### ❌ 坑 3：中文路径编码错误\n\n```\n症状：UnicodeEncodeError 或 FileNotFoundError\n排查：\n  1. 避免中文路径：D:\\docs\\report.docx ✅\n  2. 路径加引号：\"D:\\中文\\报告.docx\" ✅\n  3. 使用 raw string：r\"D:\\中文\\报告.docx\" ✅\n```\n\n#### ❌ 坑 4：大文件内存溢出\n\n```\n症状：MemoryError 或程序卡死\n排查：\n  1. 先运行 python scripts/wps_word.py info --file big.docx 查看大小\n  2. < 50MB 直接处理\n  3. > 50MB 拆分处理：分 Sheet/Section\n  4. 硬件自适应会自动延长超时\n```\n\n#### ❌ 坑 5：WPS 卡住无响应\n\n```\n症状：操作超时（30s/60s/120s）\n排查：\n  1. Skill 已自动重试 3 次（等 1s → 2s → 4s）\n  2. 仍失败则：任务管理器 → 结束 WPS 进程\n  3. 反复出现：pip install --upgrade pywin32\n```\n\n#### ❌ 坑 6：COM 对象残留\n\n```\n症状：第二次调用报 \"RPC 服务器不可用\"\n排查：\n  1. Worker 已内置自动释放（每次操作后调用 release_wps）\n  2. 手动清理：任务管理器 → 结束 kwps.exe\n  3. 避免频繁创建/销毁 Worker，使用 stdin/stdout 协议\n```\n\n#### ❌ 坑 7：PPT 添加幻灯片失败\n\n```\n症状：纯Python模式不支持添加幻灯片\n排查：\n  1. 添加幻灯片、插入内容、主题应用仅 WPS 支持\n  2. 替代方案：用 pure_create_ppt 创建时指定 slides_content 一次生成多页\n  3. 或安装 WPS Office\n```\n\n#### ❌ 坑 8：openpyxl 读取公式为 None\n\n```\n症状：读取含公式的单元格返回 None\n排查：\n  1. openpyxl 默认读取缓存值（data_only=True）\n  2. 如果从未在 Excel 中打开计算，缓存值为 None\n  3. 解决：先在 WPS 中打开保存一次，或改用公式计算\n```\n\n#### ❌ 坑 9：sort 命令排序错乱\n\n```\n症状：排序结果不对\n排查：\n  1. 确保第一行是表头（不参与排序）\n  2. 列名参数 column 需与表头完全一致（区分大小写）\n  3. 多列排序时注意优先级顺序\n```\n\n#### ❌ 坑 10：filter 筛选返回空结果\n\n```\n症状：筛选条件正确但返回空\n排查：\n  1. 条件 column 值需与表头完全一致\n  2. 数值比较时 value 必须是字符串（\"--value\": \"5000\"）\n  3. 检查是否有隐藏空格，使用 trim\n```\n\n### 🥈 中频问题\n\n#### ⚠️ 坑 11：LibreOffice 转换失败\n```\n症状：Word 转 PDF 报错\n排查：先检查 LibreOffice 是否加入 PATH；避免中文路径；确保文件未损坏\n```\n\n#### ⚠️ 坑 12：generate_templates.py 报 ImportError\n```\n症状：缺少 python-docx / openpyxl / python-pptx\n排查：pip install python-docx openpyxl python-pptx\n```\n\n#### ⚠️ 坑 13：_worker 启颈慢\n```\n症状：首次调用需2-3秒\n排查：正常！Worker 启动时检测硬件和引擎\n```\n\n#### ⚠️ 坑 14：MS Office 模式下功能缺失\n```\n症状：纯Python能做的MS Office不行\n排查：MS Office COM 接口并非全功能，部分自动回退到纯Python\n```\n\n#### ⚠️ 坑 15：多 Sheet 引用公式失效\n```\n症状：=SUM(1月:12月!B2) 不计算\n排查：openpyxl 写公式不支持 3D 引用，改用 stats 命令或逐 Sheet 运算\n```\n\n### 🥉 低频但重要\n\n#### ⚡ 坑 16：macOS 上 WPS 部分功能不可用\n```\n症状：Mac 版 WPS COM 不支持某些操作\n排查：回退到纯Python模式（WPS_ENGINE=PURE）\n```\n\n#### ⚡ 坑 17：xlsm 文件宏丢失\n```\n症状：保存后宏功能失效\n排查：openpyxl 不支持宏，xlsm 文件请用 WPS/MS Office 模式\n```\n\n#### ⚡ 坑 18：批量操作时 WPS 弹出对话框\n```\n症状：WPS 弹窗阻断自动化\n排查：弹窗需手动点击；建议在无人值守时关闭 WPS 弹窗\n```\n\n#### ⚡ 坑 19：文件被占用\n```\n症状：PermissionError\n排查：关闭占用文件的程序（WPS/Excel/Word），等待 3-5 秒后重试\n```\n\n#### ⚡ 坑 20：Windows 长路径限制\n```\n症状：Windows 默认最大路径 260 字符\n排查：启用 Windows 长路径支持，或使用短路径\n```\n\n---\n\n## 📋 常见问题 FAQ（Q&A）\n\n### Q1：我应该选择哪个引擎？\n\n**不用选！Skill 自动检测**。运行 `python scripts/wps_excel.py engine-info` 查看。如果强行切换，可以设置环境变量 `WPS_ENGINE=PURE` 强制使用纯 Python。\n\n### Q2：WPS 版本有要求吗？\n\n- WPS Office 2019+ 或 WPS 365\n- 安装后**必须重启电脑**\n- 32/64 位均可\n\n### Q3：纯 Python 模式和 WPS 模式有什么区别？\n\n| | WPS 模式 | 纯 Python 模式 |\n|--|---------|-------------|\n| 公式计算 | ✅ 自动计算 | ⚠️ 写入公式，打开时计算 |\n| 图表 | ✅ 实时预览 | ✅ 嵌入到 Excel |\n| 添加幻灯片 | ✅ 支持 | ❌ 不支持 |\n| 内存占用 | 高（几百 MB） | 低（几十 MB） |\n| 速度 | 快（WPS 优化） | 较慢 |\n\n### Q4：文件太大怎么办？\n\n> Skill 硬件自适应会自动延长超时（最高 5 倍）。\n> 建议：< 50MB 直接处理；> 50MB 先分片处理（拆分 Sheet/Section）。\n> 批量操作时单次建议 ≤ 50 个文件。\n\n### Q5：Linux 上能用吗？\n\n> ✅ 能用！安装 LibreOffice 即可：\n> ```bash\n> sudo apt install libreoffice  # Ubuntu/Debian\n> ```\n> 支持格式转换（Word/Excel/PPT → PDF）；\n> 公式、排序、筛选、图表也能用纯 Python 模式。\n\n### Q6：WPS 卡住怎么办？\n\n> Skill 会自动重试 3 次。如果仍然失败：\n> 1. 打开任务管理器 → 结束 WPS 进程\n> 2. 重新运行命令\n> 3. 如果反复出现，尝试：`pip install --upgrade pywin32`\n\n### Q7：纯 Python 模式如何安装依赖？\n\n```bash\npip install python-docx openpyxl python-pptx\n```\n\n### Q8：模板文件在哪里？如何获取？\n\n> 模板通过代码生成，不包含二进制文件。安装依赖后运行：\n> ```bash\n> python templates/generate_templates.py --dir ./output\n> ```\n> 即可生成 3 个模板：report_template.docx、budget_template.xlsx、business_ppt_template.pptx\n\n### Q9：如何批量转换格式？\n\n```bash\n# 单个文件\npython scripts/wps_word.py export --file report.docx --format pdf\n\n# 批量转换（使用 format_converter.py）\npython scripts/format_converter.py batch --input-dir ./docs --input-format docx --output-format pdf\n```\n\n### Q10：如何同时处理多个 Sheet？\n\n```bash\n# 查看所有 Sheet\npython scripts/wps_excel.py info --file Sales.xlsx\n\n# 为每个 Sheet 添加数据（逐 Sheet 调用）\npython scripts/wps_excel.py input --file Sales.xlsx --sheet Q1 --data '[[\"A\",100]]'\npython scripts/wps_excel.py input --file Sales.xlsx --sheet Q2 --data '[[\"B\",200]]'\n\n# 添加新 Sheet\npython scripts/wps_excel.py add-sheet --file Sales.xlsx --sheet Q4 --headers '[\"产品\",\"价格\"]' --data '[[\"X\",300]]'\n```\n\n### Q11：排序/筛选/图表操作总是失败？\n\n> 纯 Python 模式下这些功能 100% 支持。\n> 1. 确保已安装：`pip install openpyxl`\n> 2. 文件不能正在被占用（关闭 WPS/Excel）\n> 3. 第一行必须是表头（列名）\n> 4. 列名参数需与表头完全一致\n\n### Q12：如何提交反馈？\n\n```bash\npython scripts/wps_feedback.py email  # 打开邮件客户端（自动附带系统信息）\n```\n\n或直接发邮件到：**njskills@agent.qq.com**\n\n### Q13：纯 Python 模式下公式何时计算？\n\n> openpyxl 写入公式字符串，**打开文件时**由 Excel/WPS 计算。\n> 如果需要立即计算，请使用 WPS 模式或 MS Office 模式。\n\n### Q14：文件被占用怎么办？\n\n> 关闭占用文件的程序（WPS/Excel/Word），等待 3-5 秒后重试。\n> 或使用自动重试（Skill 已内置 3 次重试）。\n\n### Q15：哪些功能在纯 Python 模式下不可用？\n\n> v4.8 新增条件格式、数据验证、合并单元格、命名区域支持，纯Python模式覆盖度显著提升。\n\n> - 添加幻灯片（add-slide）\n> - 幻灯片插入内容（insert）\n> - 幻灯片主题（theme）\n> - VBA/宏操作\n> \n> 替代方案：安装 WPS Office 或 MS Office 获取完整功能。\n\n---\n\n## 🏆 最佳实践（10 个案例）\n\n### BP-1：大文件处理策略\n\n```\n问题：50MB 的 Word 文档操作很慢\n策略：\n  1. 先运行 python scripts/wps_word.py info --file big.docx 查看大小\n  2. 如果 > 50MB，分片处理\n  3. 使用纯 Python 模式读取内容\n  4. 避免频繁保存（每次保存触发全量写入）\n```\n\n### BP-2：周报自动化\n\n```\n问题：每周重复做相同格式的周报\n策略：\n  1. 生成模板：python templates/generate_templates.py --dir ./output\n  2. 复制模板：copy output\\report_template.docx 本周周报.docx\n  3. 用 edit 命令追加内容\n  4. 用 format 命令设置格式\n  5. 用 export 生成 PDF\n```\n\n### BP-3：预算跟踪自动化\n\n```\n问题：每月记录收入支出，手动计算汇总\n策略：\n  1. 生成预算模板：python templates/generate_templates.py --dir ./output\n  2. 每月用 input 命令录入数据\n  3. 汇总 Sheet 含公式自动计算\n  4. 用 stats 命令验证数据\n```\n\n### BP-4：商务PPT快速制作\n\n```\n问题：需要做项目汇报 PPT\n策略：\n  1. 生成模板：python templates/generate_templates.py --dir ./output\n  2. 复制模板并修改标题\n  3. 如有多页内容，创建时指定 --slides 参数\n```\n\n### BP-5：数据报表自动化\n\n```\n问题：每周重复做相同格式的报表\n策略：\n  1. 创建模板文件（含公式和图表位置）\n  2. 每周用 input 命令录入新数据\n  3. 公式和图表自动更新\n  4. 导出 PDF 分发\n```\n\n### BP-6：多 Sheet 数据汇总\n\n```\n问题：12 个月的数据在 12 个 Sheet，需要年度汇总\n策略：\n  1. 用 add-sheet 创建\"年度汇总\"Sheet\n  2. 用 stats 命令逐 Sheet 验证汇总结果\n```\n\n### BP-7：条件筛选导出\n\n```\n问题：从 1000 条记录中筛出\"销售额>5000 且 地区=华东\"\n策略：\n  python scripts/wps_excel.py filter --file data.xlsx --sheet Q1 \\\n    --conditions '[{\"column\":\"销售额\",\"op\":\">\",\"value\":\"5000\"},{\"column\":\"地区\",\"op\":\"=\",\"value\":\"华东\"}]' \\\n    --logic AND\n  ✅ 筛出符合条件的记录\n```\n\n### BP-8：批量文件重命名\n\n```\n问题：20 个文件需要统一命名规范\n策略：\n  1. 用 document_manager.py 列出所有文件\n  2. 批量重命名（加日期前缀）\n  3. 用 format_converter.py 批量转换格式\n```\n\n### BP-9：跨平台文档转换\n\n```\n问题：Linux 服务器上需要把 Word 转 PDF\n策略：\n  1. 安装 LibreOffice：sudo apt install libreoffice\n  2. 引擎自动检测为 LIBREOFFICE\n  3. 直接 export --format pdf\n```\n\n### BP-10：定时自动化\n\n```\n问题：每天凌晨自动生成报表\n策略：\n  1. 编写自动化脚本（调用 wps_excel.py + wps_word.py）\n  2. 使用 WorkBuddy automation 定时执行\n  3. 输出到指定目录\n```\n\n---\n\n## 🚨 错误速查手册 v3.1（15个错误ID）\n\n### E001-E010：用户可自助解决\n\n| ID | 错误 | 解决 |\n|----|------|------|\n| E001 | WPS 未安装或 COM 注册失败 | 安装 WPS 后重启电脑 |\n| E002 | python-docx 未安装 | `pip install python-docx openpyxl python-pptx` |\n| E003 | 文件路径不存在或无法访问 | 改用英文路径或以管理员运行 |\n| E004 | 格式转换失败（纯Python不支持） | 安装 WPS 或 LibreOffice |\n| E005 | 排序/筛选/图表需要 WPS 模式 | 安装 WPS 或改用纯Python模式 |\n| E006 | WPS/LibreOffice 卡住无响应 | 任务管理器结束进程；更新到最新版 |\n| E007 | 权限不足 | 或以管理员运行；检查文件只读属性 |\n| E008 | pywin32 导入失败 | `pip uninstall pywin32 && pip install pywin32` |\n| E009 | Python 版本过低 | 升级到 Python 3.8+ |\n| E010 | 当前引擎不支持此功能 | 安装 WPS 或改用 info 查看能力矩阵 |\n\n### E011-E015：需要进一步排查\n\n| ID | 错误 | 解决 |\n|----|------|------|\n| E011 | LibreOffice 未安装 | 下载 LibreOffice 并添加到 PATH |\n| E012 | LibreOffice 转换失败 | 检查源文件是否损坏；避免中文路径 |\n| E013 | 文件不存在 | 确认路径正确；未被删除或移动 |\n| E014 | 未知运行时错误 | 运行环境自检 `wps_test.py`；联系反馈 |\n| E015 | 不支持的操作或格式 | 输出格式改为 pdf/txt/html |\n\n---\n\n## ⚠️ 能力边界说明\n\n| 限制项 | 说明 | 解决方案 |\n|--------|------|---------|\n| **文件大小** | 单文件 < 50MB 直接处理 | 大文件先分片处理（硬件自适应自动延长超时） |\n| **批量文件数** | 建议 ≤ 50 个/批 | 超过时分批调用 |\n| **复杂度** | 透视表/VBA/ActiveX 不支持 | 使用 pandas 或手动处理 |\n| **网络文件** | 不支持 HTTP/URL 下载 | 先手动下载到本地，再调用 Skill |\n| **并发限制** | 同一时间只能操作同一引擎的一个实例 | 等待上次操作完成再发起 |\n| **中文名文件路径** | 建议改用英文路径 | 路径中避免中文和特殊字符 |\n| **实时协作** | 不支持多人同时编辑同一文件 | 通过手动分发和合并 |\n\n---\n\n## 🔗 CLI 参数速查\n\n### Word\n\n```bash\npython scripts/wps_word.py create --title \"report\" --body \"正文内容\"\npython scripts/wps_word.py edit --file \"report.docx\" --text \"新增内容\"\npython scripts/wps_word.py format --file \"report.docx\" --font \"微软雅黑\" --size 14 --align center --bold --first-indent 0.74\npython scripts/wps_word.py export --file \"report.docx\" --format pdf\npython scripts/wps_word.py info --file \"report.docx\"\npython scripts/wps_word.py engine-info\npython scripts/wps_word.py md-convert --file \"README.md\" --format docx --output \"文档.docx\"\npython scripts/wps_word.py md-convert --file \"README.md\" --format pptx --output \"演示.pptx\"\npython scripts/wps_word.py long-document --file \"report.docx\" --action all --preset thesis\n```\n\n### Excel\n\n```bash\npython scripts/wps_excel.py create --name \"Sales\" --sheets \"Q1,Q2,Q3\"\npython scripts/wps_excel.py input --file \"Sales.xlsx\" --sheet \"Q1\" --data '[[\"A\",100]]'\npython scripts/wps_excel.py formula --file \"Sales.xlsx\" --sheet \"Q1\" --cell \"C1\" --formula \"=SUM(A1:B1)\"\npython scripts/wps_excel.py chart --file \"Sales.xlsx\" --sheet \"Q1\" --type bar --data \"A1:B10\" --title \"销售趋势\"\npython scripts/wps_excel.py sort --file \"Sales.xlsx\" --sheet \"Q1\" --sorts '[{\"column\":\"Price\",\"ascending\":false}]'\npython scripts/wps_excel.py filter --file \"Sales.xlsx\" --sheet \"Q1\" --conditions '[{\"column\":\"Price\",\"op\":\">\",\"value\":\"50\"}]' --logic AND\npython scripts/wps_excel.py add-sheet --file \"Sales.xlsx\" --sheet \"Q4\" --headers '[\"Product\",\"Price\"]' --data '[[\"X\",300]]'\npython scripts/wps_excel.py nl-analyze --file \"Sales.xlsx\" --query \"按月份统计销售额并画出趋势图\"\npython scripts/wps_excel.py invoice --input \"发票.pdf\" --output \"进账台账.xlsx\"\npython scripts/wps_excel.py stats --file \"Sales.xlsx\" --sheet \"Q1\" --column \"B\" --type SUM\npython scripts/wps_excel.py info --file \"Sales.xlsx\"\npython scripts/wps_excel.py engine-info\npython scripts/wps_excel.py check-update\npython scripts/wps_excel.py formula-explain --formula \"=SUM(A1:A10)\"\npython scripts/wps_excel.py formula-explain --file \"data.xlsx\" --cell \"B2\"\npython scripts/wps_excel.py formula-explain --file \"data.xlsx\" --sheet \"Sheet1\"\n```\n\n### PPT\n\n```bash\npython scripts/wps_ppt.py create --title \"Pitch\"\npython scripts/wps_ppt.py add-slide --file \"Pitch.pptx\" --title \"Intro\"\npython scripts/wps_ppt.py insert --file \"Pitch.pptx\" --slide 2 --content \"Key points\"\npython scripts/wps_ppt.py theme --file \"Pitch.pptx\" --name business_blue\npython scripts/wps_ppt.py export --file \"Pitch.pptx\" --format pdf\npython scripts/wps_ppt.py docx-to-ppt --input 报告.docx --output 演示.pptx --title \"项目汇报\" --theme business\npython scripts/wps_ppt.py info --file \"Pitch.pptx\"\npython scripts/wps_ppt.py engine-info\n```\n\n### 🆕 v4.0 新命令（详见下方各组件）\n\n| 功能 | 命令 |\n|------|------|\n| Word→PPT | `python scripts/wps_ppt.py docx-to-ppt --input report.docx --output ppt.pptx` |\n| NL分析 | `python scripts/wps_excel.py nl-analyze --file data.xlsx --query \"按月份统计销售额画趋势图\"` |\n| 合同审查 | 已裁撤（见下方说明）；完整审查请安装 [contract-review](https://skillhub.cn/skills/contract-review) 技能 |\n| 发票OCR | `python scripts/wps_excel.py invoice --input 发票.pdf --output 入账台账.xlsx` |\n| 公式解释器 | `python scripts/wps_excel.py formula-explain --formula \"=SUM(A1:A10)\"` |\n| MD→Word/PPT | `python scripts/wps_word.py md-convert --file README.md --format docx` |\n| 长文档排版 | `python scripts/wps_word.py long-document --file report.docx --action all` |\n| 邮件智能回复 | `python scripts/wps_word.py email-reply --content \"已收到您的来信\" --tone polite` |\n| 周报月报 | `python scripts/wps_word.py report --type weekly --points \"完成A,B,C\"` |\n| AI 统一入口 | `python scripts/wps_ai.py --action meeting --file audio.wav` |\n\n### 🆕 v4.3 Excel 深度分析命令\n\n```bash\npython scripts/excel_analyzer.py profile --file data.xlsx --sheet Sheet1\npython scripts/excel_analyzer.py fix-formulas --file data.xlsx --sheet Sheet1\npython scripts/excel_analyzer.py pivot --file data.xlsx --sheet Sheet1\npython scripts/excel_analyzer.py predict --file data.xlsx --sheet Sheet1 --column 销售额 --method auto --steps 3\npython scripts/excel_analyzer.py nl2formula --query \"同比增长率\"\npython scripts/excel_analyzer.py clean --file data.xlsx --sheet Sheet1\npython scripts/excel_analyzer.py hardware\n```\n\n### 🆕 v4.4 长文档排版命令（已升级为 v4.7 统一入口）\n\n> v4.7 起，长文档排版 8 个命令合并为 `wps_word.py long-document --action` 统一入口，降低记忆成本。\n\n```bash\n# 新统一入口（推荐）\npython scripts/wps_word.py long-document --file report.docx --action all --preset thesis\n\n# 旧命令仍可通过 long_document.py 调用（兼容）\npython scripts/long_document.py all --file report.docx --preset thesis --output 排版后.docx\n```\n\n### 🆕 v4.5 会议纪要 + COM 健康命令\n\n```bash\n# 会议纪要生成\npython scripts/meeting_minutes.py check                    # 检查可用 ASR 引擎\npython scripts/meeting_minutes.py transcribe --file audio.wav --method auto\npython scripts/meeting_minutes.py generate --file audio.wav --output 纪要.docx\npython scripts/meeting_minutes.py batch --input-dir ./audio --output-dir ./docs\n\n# COM 健康检查\npython scripts/com_health.py wps-check                     # WPS COM 状态\npython scripts/com_health.py ms-check                     # MS Office COM 状态\npython scripts/com_health.py residuals                    # 检测残留进程\npython scripts/com_health.py release-all --force           # 强制清理所有\npython scripts/com_health.py full-check --json             # 完整健康报告\n\n# 通过 wps_word.py 调用\npython scripts/wps_word.py meeting-minutes --file audio.wav --output 纪要.docx\npython scripts/wps_word.py com-health --check full\n```\n\n### 🆕 v4.6 Excel 智能分析 + 数据图表 + 文档翻译\n\n```bash\n# Excel 智能分析（6 命令合并为 1 个 --action 路由）\npython scripts/wps_excel.py excel-smart --file data.xlsx --action profile\npython scripts/wps_excel.py excel-smart --file data.xlsx --action fix-formulas\npython scripts/wps_excel.py excel-smart --file data.xlsx --action pivot\npython scripts/wps_excel.py excel-smart --file data.xlsx --action predict --column 销售额 --method auto --steps 3\npython scripts/wps_excel.py excel-smart --file data.xlsx --action nl2formula --query \"同比增长率\"\npython scripts/wps_excel.py excel-smart --file data.xlsx --action clean\npython scripts/wps_excel.py excel-smart --file data.xlsx --action hardware\n\n# 数据图表生成器\npython scripts/wps_excel.py chart-gen --file data.xlsx --action auto        # 一键分析+推荐+生成\npython scripts/wps_excel.py chart-gen --file data.xlsx --action analyze      # 仅分析数据特征\npython scripts/wps_excel.py chart-gen --file data.xlsx --action recommend    # 仅推荐图表类型\npython scripts/wps_excel.py chart-gen --file data.xlsx --action generate --type line  # 生成指定图表\n\n# 文档翻译\npython scripts/wps_word.py translate --file report.docx --output 报告_zh.docx --source en --target zh\npython scripts/wps_word.py translate --input-dir ./docs --output-dir ./translated --source en --target zh\npython scripts/document_translator.py translate --file report.docx --output 报告_zh.docx\npython scripts/document_translator.py batch --input-dir ./docs --output-dir ./translated\npython scripts/document_translator.py check                                  # 检查可用翻译引擎\n```\n\n### 🆕 v4.7 公式解释器 + Markdown 转换 + 长文档统一入口\n\n```bash\n# 公式解释器（反向 NL2Formula，纯本地实现）\npython scripts/wps_excel.py formula-explain --formula \"=SUM(A1:A10)\"\npython scripts/wps_excel.py formula-explain --file data.xlsx --cell B2\npython scripts/wps_excel.py formula-explain --file data.xlsx --sheet Sheet1\n\n# Markdown → Word/PPT\npython scripts/wps_word.py md-convert --file README.md --format docx --output 文档.docx\npython scripts/wps_word.py md-convert --file README.md --format pptx --output 演示.pptx\npython scripts/wps_word.py md-convert --dir ./docs --format docx --output-dir ./output\n\n# 长文档排版统一入口（8 命令合并为 1 个 --action 路由）\npython scripts/wps_word.py long-document --file report.docx --action analyze\npython scripts/wps_word.py long-document --file report.docx --action toc --max-level 3 --insert\npython scripts/wps_word.py long-document --file report.docx --action header --chapter-in-header --page-number\npython scripts/wps_word.py long-document --file report.docx --action numbering --style arabic --max-level 4\npython scripts/wps_word.py long-document --file report.docx --action fig-index --insert\npython scripts/wps_word.py long-document --file report.docx --action xref\npython scripts/wps_word.py long-document --file report.docx --action format --preset thesis\npython scripts/wps_word.py long-document --file report.docx --action all --preset thesis --output 排版后.docx\npython scripts/wps_word.py long-document --file report.docx --action preview --preset thesis\n```\n\n### 🆕 v4.9.0 llm_bridge 桥接层 + AI 动作扩类 + 模板市场 + NL2Formula 多轮澄清\n\n```bash\n# ===== llm_bridge 统一模型层桥接 =====\n# 白名单探测 cn-llm-router，零配置多模型调用\npython scripts/llm_bridge.py check                          # 检查 cn-llm-router 是否可用\npython scripts/llm_bridge.py chat --prompt \"你好\"           # 通过 cn-llm-router 对话\npython scripts/llm_bridge.py translate \"Hello\" en zh         # 翻译\npython scripts/llm_bridge.py summarize \"长文本...\" --max-length 200  # 摘要\npython scripts/llm_bridge.py continue \"未完待续...\" --context \"前文\"  # 续写\npython scripts/llm_bridge.py rewrite \"原文...\" --style formal          # 改写\npython scripts/llm_bridge.py expand \"要点...\" --aspect detail          # 扩写\n\n# ===== wps ai 新增 3 个 AI 动作（续写/改写/扩写）=====\npython scripts/wps_ai.py --action continue --text \"未完待续...\" --context \"前文\"\npython scripts/wps_ai.py --action rewrite --text \"原文...\" --style formal\npython scripts/wps_ai.py --action expand --text \"要点...\" --aspect detail\n\n# ===== 模板市场（50+ 内置模板）=====\npython scripts/template_manager.py list                       # 列出所有模板\npython scripts/template_manager.py list --category contract  # 按分类筛选\npython scripts/template_manager.py get 合同模板               # 获取模板详情\npython scripts/template_manager.py fill 合同模板 --data '{\"甲方\":\"张三\"}' --output 合同.docx\npython scripts/template_manager.py add --source 我的文档.docx --name 自定义模板 --category other\npython scripts/template_manager.py export 合同模板 --output-dir ./exports\npython scripts/template_manager.py import ./imports/模板包\n\n# ===== NL2Formula 多轮澄清 =====\npython scripts/clarify.py detect --query \"统计销售额\"         # 歧义检测\npython scripts/clarify.py clarify --query \"统计销售额\"        # 多轮澄清+公式生成\npython scripts/clarify.py verify --formula \"=SUM(A1:A10)\"     # 公式反向验证\npython scripts/excel_analyzer.py nl2formula --query \"统计销售额\" --clarify  # 启用澄清\n\n# ===== 周报/月报 LLM 润色 =====\npython scripts/report_generator.py generate --type weekly --points \"完成A,B,C\" --output 周报.docx --polish\n\n# ===== 会议纪要 llm_bridge 优先摘要 =====\npython scripts/meeting_minutes.py generate --file audio.wav --output 纪要.docx --summary-method llm_bridge\n\n# ===== 文档翻译 llm_bridge 优先 =====\npython scripts/document_translator.py translate --file report.docx --output 报告_zh.docx --method llm_bridge\n```\n\n### 🆕 v4.8 邮件智能回复 + 周报月报 + 纯Python增强 + AI统一入口\n\n```bash\n# 邮件智能回复（模板匹配 + 可选 LLM 个性化）\npython scripts/wps_word.py email-reply --content \"已收到您的来信，关于项目进度...\" --tone polite\npython scripts/wps_word.py email-reply --content \"请查收附件\" --tone formal --output 回复.docx\npython scripts/email_reply.py reply --content \"谢谢\" --tone friendly\npython scripts/email_reply.py batch --input-dir ./emails --output-dir ./replies\n\n# 周报/月报自动生成\npython scripts/wps_word.py report --type weekly --points \"完成需求A,修复Bug B,启动项目C\"\npython scripts/wps_word.py report --type monthly --points \"上线v2.0,培训3场,客户拜访5家\" --output 月报.docx\npython scripts/report_generator.py generate --type weekly --points \"完成A,B,C\" --output 周报.docx\n\n# 纯 Python 模式增强（条件格式/数据验证/合并单元格/命名区域）\npython scripts/wps_excel.py cond-format --file data.xlsx --sheet Sheet1 --range A1:A100 --type color-scale\npython scripts/wps_excel.py data-validation --file data.xlsx --sheet Sheet1 --range B1:B100 --list \"是,否\"\npython scripts/wps_excel.py merge-cells --file data.xlsx --sheet Sheet1 --range A1:D1\npython scripts/wps_excel.py named-range --file data.xlsx --name \"销售数据\" --range A1:D100\n\n# AI 统一入口（wps ai --action）\npython scripts/wps_ai.py --action email-reply --content \"已收到\" --tone polite\npython scripts/wps_ai.py --action report --type weekly --points \"完成A,B,C\"\npython scripts/wps_ai.py --action meeting --file audio.wav --output 纪要.docx\npython scripts/wps_ai.py --action contract --file 合同.docx --output 审查版.docx\npython scripts/wps_ai.py --action translate --file report.docx --output 报告_zh.docx\npython scripts/wps_ai.py --action formula --formula \"=SUM(A1:A10)\"\n```\n\n### 🆕 v5.0 自动化流水线与稳定性中心\n\n```bash\n# ===== 定时任务 =====\npython scripts/schedule_register.py register --task weekly_report   # 注册周报定时任务（需确认）\npython scripts/schedule_register.py register --task monthly_report  # 注册月报定时任务\npython scripts/schedule_register.py register --task data_refresh   # 注册数据刷新定时任务\npython scripts/schedule_register.py list                           # 列出已注册任务\npython scripts/schedule_register.py cancel --task weekly_report    # 取消任务\npython scripts/schedule_register.py enable --task weekly_report    # 启用/禁用任务\npython scripts/schedule_register.py predefined                     # 查看预定义任务\n\n# ===== 目录监听 =====\npython scripts/watch.py watch --dir ./input --rules watch_rules.yaml  # 启动监听\npython scripts/watch.py scan --dir ./input --rules watch_rules.yaml   # 单次扫描\npython scripts/watch.py rules --dump                                 # 导出默认规则\npython scripts/watch.py init --dir ./input                            # 初始化规则文件\n\n# ===== 稳定性中心（统计+引擎健康+引擎偏好）=====\npython scripts/usage_stats.py stats --period daily    # 日报表\npython scripts/usage_stats.py stats --period weekly   # 周报表\npython scripts/usage_stats.py health                  # 引擎健康度报告\npython scripts/usage_stats.py engine-info             # 全局引擎信息（合并3脚本）\npython scripts/usage_stats.py preference --mode auto  # 引擎偏好：自动模式\npython scripts/usage_stats.py preference --mode fixed --engine wps  # 固定WPS引擎\npython scripts/usage_stats.py log --action create --engin\n\nArchive v5.0.0: 55 files, 315344 bytes\n\nFiles: ARCHITECTURE.md (10521b), README.md (958b), requirements.txt (371b), scripts/__pycache__/com_health.cpython-313.pyc (30316b), scripts/__pycache__/nl2sql_engine.cpython-313.pyc (36958b), scripts/__pycache__/pipeline_bridge.cpython-313.pyc (14628b), scripts/__pycache__/schedule_register.cpython-313.pyc (27259b), scripts/__pycache__/usage_stats.cpython-313.pyc (30219b), scripts/__pycache__/watch.cpython-313.pyc (39681b), scripts/chart_recommender.py (14816b), scripts/clarify.py (13148b), scripts/com_health.py (26531b), scripts/document_manager.py (5005b), scripts/document_translator.py (19200b), scripts/email_reply.py (34772b), scripts/excel_analyzer.py (49984b), scripts/format_converter.py (6286b), scripts/formula_explainer.py (17493b), scripts/llm_bridge.py (14136b), scripts/long_document.py (47917b), scripts/md_converter.py (15769b), scripts/meeting_minutes.py (34208b), scripts/nl2sql_engine.py (29165b), scripts/pipeline_bridge.py (13775b), scripts/ppt_generator.py (36950b), scripts/report_generator.py (23299b), scripts/schedule_register.py (23066b), scripts/template_manager.py (24136b), scripts/usage_stats.py (22341b), scripts/watch.py (29747b), scripts/wps_ai.py (11129b), scripts/wps_common.py (5850b), scripts/wps_contract_review.py (9275b), scripts/wps_docx_to_ppt.py (15447b), scripts/wps_engine.py (4093b), scripts/wps_error.py (10326b), scripts/wps_excel.py (18502b), scripts/wps_feedback.py (2830b), scripts/wps_invoice_ocr.py (12045b), scripts/wps_ms.py (3140b), scripts/wps_nl_analysis.py (13727b), scripts/wps_performance.py (5649b), scripts/wps_ppt.py (5139b), scripts/wps_pure_enhancements.py (23077b), scripts/wps_pure.py (29423b), scripts/wps_test.py (8261b), scripts/wps_toc.py (7484b), scripts/wps_update.py (3689b), scripts/wps_word.py (15035b), scripts/wps_worker.py (32086b), skill-card.md (2948b), SKILL.md (51777b), templates/generate_templates.py (13622b), templates/templates_index.json (14466b), _meta.json (135b)\n\nArchive v4.9.0: 44 files, 198164 bytes\n\nFiles: ARCHITECTURE.md (10521b), README.md (958b), requirements.txt (371b), scripts/chart_recommender.py (14816b), scripts/clarify.py (13148b), scripts/com_health.py (15683b), scripts/document_manager.py (5005b), scripts/document_translator.py (19200b), scripts/email_reply.py (34772b), scripts/excel_analyzer.py (49984b), scripts/format_converter.py (6286b), scripts/formula_explainer.py (17493b), scripts/llm_bridge.py (14136b), scripts/long_document.py (47917b), scripts/md_converter.py (15769b), scripts/meeting_minutes.py (34208b), scripts/ppt_generator.py (36950b), scripts/report_generator.py (23299b), scripts/template_manager.py (24136b), scripts/wps_ai.py (11129b), scripts/wps_common.py (5850b), scripts/wps_contract_review.py (9275b), scripts/wps_docx_to_ppt.py (15447b), scripts/wps_engine.py (4093b), scripts/wps_error.py (10326b), scripts/wps_excel.py (18502b), scripts/wps_feedback.py (2830b), scripts/wps_invoice_ocr.py (12045b), scripts/wps_ms.py (3140b), scripts/wps_nl_analysis.py (13727b), scripts/wps_performance.py (5649b), scripts/wps_ppt.py (5139b), scripts/wps_pure_enhancements.py (23077b), scripts/wps_pure.py (29423b), scripts/wps_test.py (8261b), scripts/wps_toc.py (7484b), scripts/wps_update.py (3689b), scripts/wps_word.py (15035b), scripts/wps_worker.py (32086b), skill-card.md (2712b), SKILL.md (46712b), templates/generate_templates.py (13622b), templates/templates_index.json (14466b), _meta.json (135b)\n\nArchive v4.8.0: 40 files, 177069 bytes\n\nFiles: ARCHITECTURE.md (10521b), README.md (958b), requirements.txt (371b), scripts/chart_recommender.py (14816b), scripts/com_health.py (15683b), scripts/document_manager.py (5005b), scripts/document_translator.py (18608b), scripts/email_reply.py (34772b), scripts/excel_analyzer.py (48408b), scripts/format_converter.py (6286b), scripts/formula_explainer.py (17493b), scripts/long_document.py (47917b), scripts/md_converter.py (15769b), scripts/meeting_minutes.py (32865b), scripts/ppt_generator.py (36950b), scripts/report_generator.py (21245b), scripts/wps_ai.py (7528b), scripts/wps_common.py (5850b), scripts/wps_contract_review.py (9275b), scripts/wps_docx_to_ppt.py (15447b), scripts/wps_engine.py (4093b), scripts/wps_error.py (10326b), scripts/wps_excel.py (18502b), scripts/wps_feedback.py (2830b), scripts/wps_invoice_ocr.py (12045b), scripts/wps_ms.py (3140b), scripts/wps_nl_analysis.py (13727b), scripts/wps_performance.py (5649b), scripts/wps_ppt.py (5139b), scripts/wps_pure_enhancements.py (23077b), scripts/wps_pure.py (29423b), scripts/wps_test.py (8261b), scripts/wps_toc.py (7484b), scripts/wps_update.py (3689b), scripts/wps_word.py (15035b), scripts/wps_worker.py (32086b), skill-card.md (2542b), SKILL.md (42853b), templates/generate_templates.py (13622b), _meta.json (135b)\n\nArchive v4.7.0: 36 files, 149443 bytes\n\nFiles: ARCHITECTURE.md (10521b), README.md (958b), requirements.txt (371b), scripts/chart_recommender.py (14816b), scripts/com_health.py (15683b), scripts/document_manager.py (5005b), scripts/document_translator.py (18608b), scripts/excel_analyzer.py (48408b), scripts/format_converter.py (6286b), scripts/formula_explainer.py (17493b), scripts/long_document.py (47917b), scripts/md_converter.py (15769b), scripts/meeting_minutes.py (32865b), scripts/ppt_generator.py (36950b), scripts/wps_common.py (5850b), scripts/wps_contract_review.py (9275b), scripts/wps_docx_to_ppt.py (15447b), scripts/wps_engine.py (4093b), scripts/wps_error.py (10326b), scripts/wps_excel.py (13592b), scripts/wps_feedback.py (2830b), scripts/wps_invoice_ocr.py (12045b), scripts/wps_ms.py (3140b), scripts/wps_nl_analysis.py (13727b), scripts/wps_performance.py (5649b), scripts/wps_ppt.py (5139b), scripts/wps_pure.py (29423b), scripts/wps_test.py (8261b), scripts/wps_toc.py (7484b), scr...","readmeExcerpt":"Skill: wps-office-suite Owner: fyniujin Summary: WPS Office 全家桶 - 四引擎（WPS/MS Office/LibreOffice/纯Python）智能识别用户已安装软件，纯Python模式支持排序/筛选/图表/公式/统计，含文档模板（代码生成）、最佳实践案例、故障排除大章（20+避坑+15 FAQ+15错误ID 统一索引）、自动重试、硬件自适应、环境自检、Skill更新提醒；v5.1新增：kingdoc云端桥接（白名单探测+配置预检+subprocess上传+差异检查）、条件格式/数据验证跨引擎IO（JSON中间格式保真往返）、会议纪要三段式要素化（待办清单+决策记录+风险异议）+说话人标注（MFCC聚类）；v5.2新增：公文一键排版（GB/T 9704 规则库约束+结构识别套版+红头预留位+联合行文）、批量水印与敏感信息打码（身份证/手机号/银行卡/邮箱双轨识别+黑","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python scripts/wps_test.py"},{"language":"bash","snippet":"python scripts/wps_excel.py engine-info"},{"language":"bash","snippet":"python scripts/wps_word.py create --title \"测试文档\"\npython scripts/wps_excel.py create --name \"预算表\" --sheets \"收入,支出\"\npython scripts/wps_ppt.py create --title \"推广方案\""},{"language":"bash","snippet":"python scripts/wps_excel.py check-update"},{"language":"bash","snippet":"python templates/generate_templates.py --dir ./output"},{"language":"text","snippet":"症状：win32com.com_error 或 \"WPS 未安装\"\n排查：\n  1. 运行 python scripts/wps_excel.py engine-info 检查当前引擎\n  2. 如果显示 PURE 或 LIBREOFFICE，说明 WPS 不可用\n  3. 安装 WPS Office 2019+ 后重启电脑"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: wps-office-suite\ndescription: WPS Office 全家桶 - 四引擎（WPS/MS Office/LibreOffice/纯Python）智能识别用户已安装软件，纯Python模式支持排序/筛选/图表/公式/统计，含文档模板（代码生成）、最佳实践案例、故障排除大章（20+避坑+15 FAQ+15错误ID 统一索引）、自动重试、硬件自适应、环境自检、Skill更新提醒；v5.1新增：kingdoc云端桥接（白名单探测+配置预检+subprocess上传+差异检查）、条件格式/数据验证跨引擎IO（JSON中间格式保真往返）、会议纪要三段式要素化（待办清单+决策记录+风险异议）+说话人标注（MFCC聚类）；v5.2新增：公文一键排版（GB/T 9704 规则库约束+结构识别套版+红头预留位+联合行文）、批量水印与敏感信息打码（身份证/手机号/银行卡/邮箱双轨识别+黑色矩形覆盖+打码清单）、跨文档知识检索与问答（本地TF-IDF零依赖+跳转+可选zwjh记忆桥接）；删除：与contract-review重复的轻量合同审查模块，改为文档互链引导；v5.2.5修复：MS Office引擎下Excel/PPT创建必然失败（错用Word COM对象），新增get_ms_excel/get_ms_ppt及三槽位统一释放release_ms，MS Office路径透传filepath参数;v5.3.0新增：统一CLI入口 wps（registry.json注册表分发，office --app/--action 与 convert 子命令、--list 一屏列出全部命令，薄路由层不改脚本内部逻辑）、全命令 --json 机器可读输出（固定 ok/error_id/elapsed/data 四字段，对齐 E001-E015，wps_error.py 新增 emit_json 统一出口）、_worker 启动优化（wps_pure 改惰性加载，pywin32/python-docx/openpyxl 经核查已惰性导入，ENGINE_CACHE 进程级单例复用，COM 释放统一走 release_ms 三槽位）、转换三入口合并为 convert（format_converter/md_converter/wps_docx_to_ppt 内部按目标格式路由，旧脚本保留为兼容别名并提示新命令，v6.0.0 移除）\nversion: 5.3.0\n---\n\n\n# WPS Office 全家桶 v5.3.0 ✅\n\n> 🏗️ **四引擎智能识别**：自动检测用户电脑已安装的软件，按 WPS → MS Office → LibreOffice → 纯Python 顺序选择最合适的引擎\n> ✨ **纯Python模式增强 v4.8**：排序、筛选、图表、公式、统计、条件格式、数据验证、合并单元格、命名区域 — 跨平台全部支持\n> 🔄 **自动重试**：WPS 卡住时自动重试 3 次，不用手动重启\n> ⚡ **硬件自适应**：自动检测 CPU 内存，动态调整超时和线程，不拖累电脑\n> 📚 **文档模板 + 最佳实践 + 故障排除**：代码生成3个即用模板 + 10个最佳实践案例 + 统一故障排除大章\n> 📬 **Skill 更新提醒**：自动检查新版本，7天提醒一次，保持最新\n> 🆕 **文件大小明确限制**：单文件 < 50MB 直接处理，> 50MB 有分片建议\n> 🔬 **Excel 智能分析 v4.6**：6命令合并为 1 个统一入口（--action 参数路由）\n> 📊 **数据图表生成器 v4.6**：基于数据特征自动推荐图表类型 + 生成图表嵌入 Excel\n> 🌐 **文档翻译 v4.6**：Word/Excel/PPT 专业翻译（支持多模型降级）\n> 🎙️ **会议纪要 v4.5**：音频 → ASR 转写 → LLM 摘要 → Word（支持降级链）\n> 🏥 **COM 健康检查 v4.5**：WPS/MS Office 状态检测 + 残留进程清理\n> 🧮 **公式解释器 v4.7**：Excel 公式 → 自然语言解释（反向 NL2Formula，纯本地实现）\n> 📝 **Markdown 转换 v4.7**：MD → Word/PPT（保留标题层级，纯本地实现）\n> 📑 **长文档排版 v4.7**：统一入口 long-document --action（8命令合并），性能优化（分批+单次保存+进度回调）\n> ✉️ **邮件智能回复 v4.8**：模板匹配 + LLM 个性化回复（纯本地，多模型降级）\n> 📊 **周报/月报生成 v4.8**：关键点 → 结构化 Word 报告（模板 + 可选 LLM 润色）\n> 🤖 **AI 统一入口 v4.9**：`wps ai --action` 统一 9 大 AI 功能入口（新增续写/改写/扩写）\n> 🌉 **llm_bridge 桥接层 v4.9**：统一模型层，白名单探测 cn-llm-router，零配置多模型调用\n> 📋 **模板市场 v4.9**：50+ 内置模板（公文/合同/简历/标书/报告/会议），支持用户沉淀和分享\n> 💬 **NL2Formula 多轮澄清 v4.9**：歧义检测 → 槽位填充 → 反向验证，公式生成更精准\n> ⏰ **定时任务 v5.0**：schtasks/crontab 注册管理，周报/月报/数据刷新一键定时\n> 👁️ **目录监听 v5.0**：轮询监听 + YAML规则 + 大文件自动分片 + LibreOffice并发控制\n> 📊 **稳定性中心 v5.0**：SQLite埋点统计 + 引擎健康度 + 全局engine-info + 引擎偏好配置\n> 🏥 **COM自愈 v5.0**：三步自愈（regsvr32 → 修复安装 → 手动指引），每步记录日志\n> 💬 **对话式查询 v5.0**：NL2SQL式意图解析 + 查询计划生成 + 连续追问，Top20关键词模板降级\n> 🔗 **编排引擎桥接 v5.0**：白名单探测 multi-agent-orchestrator，命中注册流水线模板，未装本地串行降级\n> ☁️ **kingdoc 桥接 v5.1**：白名单探测+配置预检+subprocess 上传金山文档，difflib 差异检查\n> 🔄 **跨引擎 IO v5.1**：条件格式/数据验证 JSON 中间格式，WPS↔纯 Python 保真往返\n> 📋 **纪要要素化 v5.1**：三段式结构（待办清单+决策记录+风险异议）+ 说话人标注\n> 📑 **公文一键排版 v5.2**：GB/T 9704 规则库约束 + 结构识别套版，支持红头预留位与联合行文，处理前自动备份\n> 🔒 **批量水印与打码 v5.2**：文字/图片水印（平铺/对角线，批量目录）；敏感信息双轨识别（身份证/手机号/银行卡/邮箱）+ 黑色矩形覆盖 + 打码清单\n> 🔍 **跨文档检索 v5.2**：本地 TF-IDF 零依赖索引，跨文档找"},{"path":"README.md","content":"# WPS Office 全家桶\n\n基于自然语言的 WPS Office 自动化 Skill，支持 Word/Excel/PPT 创建、编辑、格式转换。\n\n## 功能\n\n- 📄 **WPS 文字** - 创建/编辑/格式/导出\n- 📊 **WPS 表格** - 数据/公式/图表/筛选\n- 🎬 **WPS 演示** - 创建/幻灯片/主题/导出\n- 🔄 **格式转换** - Word/Excel/PPT/PDF 互转\n- 📁 **文档管理** - 打开/保存/最近文档\n\n## 使用方式\n\n```bash\npython scripts/wps_word.py create --title \"我的文档\"\npython scripts/wps_excel.py create --name \"预算表\"\npython scripts/wps_ppt.py create --title \"汇报\"\npython scripts/format_converter.py convert --input \"D:\\文档\\报告.docx\" --output-format pdf\n```\n\n## 依赖\n\n```bash\npip install -r requirements.txt\n```\n\n## 风险提示\n\n1. **文件安全**：操作前建议备份重要文件\n2. **格式兼容性**：部分复杂格式转换可能丢失原始排版\n3. **依赖要求**：需安装 WPS Office 2019+ 或 WPS 365"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7chdrwbdhaqkwajcyhtfvjx989ddb1\",\n  \"slug\": \"wps-office-suite\",\n  \"version\": \"5.3.0\",\n  \"publishedAt\": 1791513457090\n}"},{"path":"references/gongwen_rules.yaml","content":"# ============================================================\n# GB/T 9704-2012 党政机关公文格式 约束库\n# 用途：gongwen.py 排版引擎读取本文件，按规则对文档逐段套版\n# 设计：可维护、可扩展——新增文种/调整字号只需改本文件，不碰代码\n# ============================================================\n\nstandard: \"GB/T 9704-2012\"\nname: \"党政机关公文格式\"\n\n# ---------- 页面 ----------\npage:\n  size: \"A4\"\n  margin_top: \"37mm\"\n  margin_bottom: \"35mm\"\n  margin_left: \"28mm\"\n  margin_right: \"26mm\"\n  per_page_lines: 22      # 每面 22 行\n  per_line_chars: 28      # 每行 28 字（三号字）\n  grid: true              # 撑满版心\n\n# ---------- 字体规范 ----------\n# size 使用中文办公字号，引擎内部映射为磅值（二号=22pt，三号=16pt，四号=14pt）\nfonts:\n  title:\n    name: \"方正小标宋简体\"\n    fallback: \"宋体\"\n    size: \"二号\"\n    bold: true\n    color: \"000000\"\n    align: \"center\"\n    spacing_after: \"1行\"\n  redhead:                # 红头（发文机关标志）预留位\n    name: \"方正小标宋简体\"\n    fallback: \"宋体\"\n    size: \"初号\"\n    bold: true\n    color: \"FF0000\"\n    align: \"center\"\n  main_send:             # 主送机关\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"left\"\n    first_line_indent: \"0\"\n  body:\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"justify\"\n    first_line_indent: \"2字符\"\n    line_spacing_rule: \"fixed\"\n    line_spacing: \"28pt\"   # 固定值 28 磅 ≈ 一个三号字 + 行距\n  signature:             # 发文机关署名 + 成文日期\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"right\"\n  attachment_note:       # 附件说明\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"left\"\n    first_line_indent: \"2字符\"\n  annotation:            # 附注（居左圆括号）\n    name: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    align: \"left\"\n  footer:\n    page_number:\n      name: \"宋体\"\n      size: \"四号\"\n      format: \"- {n} -\"     # 页码格式：一字线夹阿拉伯数字\n\n# ---------- 结构层次序数 ----------\n# 公文正文内层级标识与对应字体\nstructure_levels:\n  - level: 1\n    marker: \"一、\"\n    font: \"黑体\"\n    size: \"三号\"\n    bold: true\n  - level: 2\n    marker: \"（一）\"\n    font: \"楷体_GB2312\"\n    fallback: \"楷体\"\n    size: \"三号\"\n  - level: 3\n    marker: \"1.\"\n    font: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n    bold: true\n  - level: 4\n    marker: \"（1）\"\n    font: \"仿宋_GB2312\"\n    fallback: \"仿宋\"\n    size: \"三号\"\n\n# ---------- 文种识别关键词 ----------\n# 用于从标题中判断文种，决定版式细节（如函/纪要差异）\ndoc_types:\n  - \"决议\"\n  - \"决定\"\n  - \"命令\"\n  - \"公报\"\n  - \"公告\"\n  - \"通告\"\n  - \"意见\"\n  - \"通知\"\n  - \"通报\"\n  - \"报告\"\n  - \"请示\"\n  - \"批复\"\n  - \"议案\"\n  - \"函\"\n  - \"纪要\"\n\n# ---------- 主送机关识别特征 ----------\n# 段落以这些词结尾（带全角冒号）视为主送机关行\nmain_send_markers:\n  - \"：\"\n  - \":\"\n\n# ---------- 落款识别特征 ----------\nsignature_markers:\n  - \"年\"\n  - \"月\"\n  - \"日\"\n  # 含日期且位于文末 3 段内，视为落款\n\n# ---------- 红头预留位 ----------\nredhead_placeholder: \"[红头：发文机关标志预留位]\"\nredhead_line_gap: 2      # 红头与标题之间的空行数"},{"path":"ARCHITECTURE.md","content":"# WPS Office Suite Skill 架构设计\n\n> **技能名称**：WPS Office Suite  \n> **中文名称**：WPS 全家桶  \n> **版本**：1.0.0  \n> **分类**：办公协作与生产力工具  \n> **目标平台**：Windows / macOS / Web  \n> **目标评分**：★★★★★ (4.8+/5.0)\n\n---\n\n## 一、市场定位与空白分析\n\n### 1.1 当前生态空白\n| 维度 | 现状 | 空白点 |\n|------|------|--------|\n| 国产办公 | SkillHub 仅有腾讯文档 Skill | WPS Office 全家桶（文字/表格/演示）完全空白 |\n| 深度集成 | 现有 Skill 仅做信息查询 | 缺乏\"创建→编辑→协作→格式转换\"全链路闭环 |\n| 用户覆盖 | 开发者导向严重 | 3 亿+ 国内办公人群的刚需未被满足 |\n| 平台互补 | 腾讯文档 Skill 单薄 | 与腾讯文档形成\"双办公生态\"互补 |\n\n### 1.2 目标用户画像\n- **核心用户**：国内办公白领、企业职员、学生群体\n- **使用场景**：日常文档处理、表格制作、演示汇报、格式转换\n- **痛点**：频繁在多个工具间切换、格式不兼容、协作流程繁琐\n\n---\n\n## 二、功能架构设计\n\n```\nWPS Office Suite Skill\n├── 📄 WPS 文字（Word）模块\n│   ├── 创建文档（从模板/空白）\n│   ├── 编辑文档（文本插入、格式设置、段落调整）\n│   ├── 页面设置（页边距、纸张、页眉页脚）\n│   ├── 目录生成与更新\n│   ├── 批注与修订\n│   └── 导出（DOCX/PDF/TXT）\n│\n├── 📊 WPS 表格（Excel）模块\n│   ├── 创建工作簿（多 Sheet 管理）\n│   ├── 数据录入与编辑\n│   ├── 公式与函数（SUM/AVERAGE/VLOOKUP 等常用函数）\n│   ├── 图表生成（柱状图/折线图/饼图）\n│   ├── 数据筛选与排序\n│   ├── 条件格式设置\n│   └── 导出（XLSX/CSV/PDF）\n│\n├── 🎬 WPS 演示（PPT）模块\n│   ├── 创建演示文稿\n│   ├── 幻灯片管理（添加/删除/排序）\n│   ├── 文本与图片插入\n│   ├── 版式与主题应用\n│   ├── 动画与切换效果\n│   └── 导出（PPTX/PDF/图片）\n│\n├── 🔄 格式转换中心\n│   ├── Word ↔ Excel ↔ PPT 互转\n│   ├── PDF → Word/Excel/PPT\n│   ├── Word/Excel/PPT → PDF\n│   └── 批量转换支持\n│\n├── 📁 文档管理\n│   ├── 打开本地文档\n│   ├── 保存到本地\n│   ├── 最近文档列表\n│   └── 文档属性查看\n│\n└── 🤝 协作功能\n    ├── 共享链接生成\n    ├── 协作权限设置\n    └── 版本历史查看\n```\n\n---\n\n## 三、技术架构设计\n\n### 3.1 运行模式\n```\n用户自然语言指令\n    ↓\nSKILL.md 解析与触发\n    ↓\n命令路由（判断模块）\n    ↓\n┌─────────────────────────────────────┐\n│  本地 WPS 应用（优先）               │\n│  ├── COM 接口调用（Windows）         │\n│  ├── AppleScript（macOS）            │\n│  └── WPS WebOffice API（备选）        │\n├─────────────────────────────────────┤\n│  云端 API（备选/混合模式）            │\n│  └── 金山文档开放平台 API             │\n│      ├── 文档操作 API                │\n│      ├── 表格操作 API                │\n│      ├── 格式转换 API                │\n│      └── 协作管理 API                │\n└─────────────────────────────────────┘\n    ↓\n执行结果返回\n    ↓\n自然语言回复用户\n```\n\n### 3.2 技术选型\n| 层级 | 技术方案 | 说明 |\n|------|----------|------|\n| 本地接口 | pywin32 / COM | Windows 下调用 WPS COM 接口 |\n| 本地接口 | appscript / pyobjc | macOS 下调用 WPS |\n| 云端 API | 金山文档开放平台 | 无 WPS 安装时的备选方案 |\n| 格式转换 | WPS 内置引擎 | 利用 WPS 强大的格式兼容能力 |\n| 脚本引擎 | Python 3.8+ | 主要脚本语言 |\n| 文件操作 | python-docx / openpyxl | 备选纯 Python 方案 |\n\n### 3.3 文件结构\n```\nwps-office-suite/\n├── SKILL.md                    # 技能定义文件（核心）\n├── README.md                   # 项目说明\n├── requirements.txt            # Python 依赖\n├── scripts/\n│   ├── wps_word.py             # WPS 文字操作脚本\n│   ├── wps_excel.py            # WPS 表格操作脚本\n│   ├── wps_ppt.py              # WPS 演示操作脚本\n│   ├── format_converter.py     # 格式转换脚本\n│   └── document_manager.py     # 文档管理脚本\n├── templates/\n│   ├── report_template.docx    # 报告模板\n│   ├── budget_template.xlsx    # 预算模板\n│   └── slide_template.pptx     # 演示模板\n├── config/\n│   ├── settings.json           # 配置文件\n│   └── api_keys.json           # API 密钥（用户自行配置）\n└── tests/\n    ├── test_word.py            # 文字模块测试\n    ├── test_excel.py           # 表格模块测试\n    └── test_p"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1092,"uniquenessScore":42,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T16:12:36.348Z","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-09T16:12:36.348Z","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-10T03:33:50.107Z","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"}]}}}