操作手册→解决方案建议书 转换技能

将操作手册从"如何使用"升级为"为何使用、如何成功"的系统解决方案。

Manual → Solution Proposal Conversion Skill

Transform operation manuals from "how to use" into "why use it and how to succeed" — a complete system solution proposal.

工作流程 / Workflow

Step 1: 解析操作手册 / Parse the Manual

读取用户上传的操作手册（DOCX/PDF/Markdown），提取：

Read the user-uploaded operation manual (DOCX/PDF/Markdown) and extract:

• 系统名称与定位 / System name & positioning
• 功能模块清单 / Feature module inventory（一级+二级+功能要点 / L1 + L2 + key points）
• 用户角色 / User roles
• 核心业务流程 / Core business processes（审批链、状态机等 / approval chains, state machines, etc.）
• 技术特征 / Technical characteristics（GIS、物联网、消息推送等 / GIS, IoT, push notifications, etc.）

Step 2: 差距分析 / Gap Analysis

对照功能清单，识别：

Cross-reference the feature list and identify:

• ✅ 已覆盖的能力 / Capabilities already covered
• ⚠️ 需补充/扩展的能力 / Capabilities to supplement or extend（移动端、集成接口、智能推荐等 / mobile, integration APIs, smart recommendations, etc.）

Step 3: 按七层框架生成方案 / Generate Proposal with the 7-Layer Framework

读取 references/methodology.md 获取完整方法论，按以下七层逐层展开：

Read references/methodology.md for the full methodology, then expand layer by layer:

操作手册 (What)                          Operation Manual (What)
  ↓
业务价值重构 (Why)                        Business Value Reframing (Why)
  ↓                                       → pain point mapping, quantified goals, scenario storylines
解决方案全景设计 (How↑)                    Solution Blueprint (How↑)
  ↓                                       → technical architecture, integration design
实施与运营规划 (How↓)                      Implementation & Operations Plan (How↓)
  ↓                                       → phased roadmap, WBS, risk management
保障体系构建 (With)                        Assurance Framework (With)
  ↓                                       → security & compliance, training & knowledge transfer
商业价值呈现 (For)                         Business Value Presentation (For)
  ↓                                       → TCO / ROI analysis
系统解决方案文档（交付物）                  System Solution Document (Deliverable)

Step 4: 生成配图 / Generate Diagrams

运行 scripts/generate_diagrams.py 生成6类标准配图：

Run scripts/generate_diagrams.py to produce 6 standard diagram types:

python3 /scripts/generate_diagrams.py  [--font ]

生成的配图（PNG格式）/ Generated diagrams (PNG):

1. 技术架构图 / Technical Architecture Diagram — 六层/多层架构全景 / multi-layer architecture overview
2. 业务流程图 / Business Process Diagram — 核心审批/业务流程 / key approval/business flows
3. 实施路线图 / Implementation Roadmap — 分阶段时间线 / phased timeline
4. 投资回报图 / ROI Chart — 成本构成饼图 + 收益柱图 / cost breakdown pie + benefit bar chart
5. 价值映射图 / Value Mapping — 痛点→功能→价值对应关系 / pain point → feature → value mapping
6. 安全架构图 / Security Architecture — 安全体系五大支柱 / five pillars of security framework

注意 / Note：脚本需要 matplotlib。首次运行前执行：

The script requires matplotlib. Run before first use:

pip install matplotlib --break-system-packages -q

字体要求 / Fonts: 确保系统有中文字体（Noto Sans CJK SC / WenQuanYi / SimHei）。

Ensure Chinese fonts are available (Noto Sans CJK SC / WenQuanYi / SimHei).

用 fc-list :lang=zh 检查。如无中文字体，脚本将使用英文fallback。

Check with fc-list :lang=zh. If no Chinese fonts are found, the script falls back to English.

Step 5: 构建DOCX文档 / Build DOCX Document

读取 references/doc_structure.md 获取标准文档结构模板。

Read references/doc_structure.md for the standard document structure template.

运行 scripts/build_docx.py 将方案内容和配图合并为DOCX：

Run scripts/build_docx.py to merge the proposal content and diagrams into a DOCX:

python3 /scripts/build_docx.py    [--title