product-playbook 1.0.0

package/i18n/zh-CN/references/rules-document-tools.md

@@ -0,0 +1,126 @@
+# 文件转换工具依赖管理
+
+> 首次触发 `/export` 或 `/parse` 指令时载入。
+
+## 依赖层级
+
+| 层级 | 工具 | 用途 | 安装方式 | 大小 |
+|------|------|------|---------|------|
+| **核心（零安装）** | Claude Read tool (Vision) | PDF 语意解析 | 内建 | 0 |
+| **核心（零安装）** | Playwright MCP | PDF 渲染 | 内建 | 0 |
+| **基础** | pymupdf (fitz) | PDF 文字提取 + 图片渲染 | `pip3 install --break-system-packages pymupdf` | ~23MB |
+| **基础** | pikepdf | PDF 书签注入 + 元数据 | `pip3 install --break-system-packages pikepdf` | ~5MB |
+| **扩充** | pandoc | DOCX / PPTX 转换 | `brew install pandoc` | ~50MB |
+| **Fallback** | tesseract + chi_tra | 离线 OCR（Vision 不可用时） | `brew install tesseract tesseract-lang` | ~150MB |
+| **进阶** | python-docx | 高品质 DOCX 产出 | `pip3 install --break-system-packages python-docx` | ~5MB |
+
+## 启动检测流程
+
+当使用者首次触发文件转换功能时，依以下顺序检测并按需安装：
+
+### 步骤 1：判断需要哪些工具
+
+| 使用者操作 | 需要的工具 |
+|-----------|-----------|
+| `/export pdf` | pymupdf + pikepdf + Playwright MCP |
+| `/export docx` 或 `/export pptx` | pandoc |
+| `/parse [PDF 文件]` | pymupdf（+ Claude Vision 或 tesseract） |
+| `/parse [DOCX/PPTX 文件]` | pandoc |
+
+### 步骤 2：检测已安装的工具
+
+执行以下 Bash 指令（静默检测，不显示输出）：
+
+```bash
+# pymupdf
+python3 -c "import fitz; print(fitz.version)" 2>/dev/null && echo "pymupdf: OK" || echo "pymupdf: MISSING"
+
+# pikepdf
+python3 -c "import pikepdf; print(pikepdf.__version__)" 2>/dev/null && echo "pikepdf: OK" || echo "pikepdf: MISSING"
+
+# pandoc
+which pandoc >/dev/null 2>&1 && echo "pandoc: OK" || echo "pandoc: MISSING"
+
+# tesseract（仅在明确需要时检测）
+which tesseract >/dev/null 2>&1 && tesseract --list-langs 2>&1 | grep -q chi_tra && echo "tesseract: OK" || echo "tesseract: MISSING"
+```
+
+### 步骤 3：自动安装缺少的工具
+
+若检测到缺少的工具，显示以下讯息并自动安装：
+
+```
+📦 文件转换需要安装以下工具：
+  ☐ [工具名称]（[用途]，[大小]）
+  ...
+正在安装，请稍候...
+```
+
+安装指令依序执行：
+
+```bash
+# pymupdf + pikepdf（一次安装）
+pip3 install --break-system-packages pymupdf pikepdf
+
+# pandoc
+brew install pandoc
+
+# tesseract（仅在需要离线 OCR 时）
+brew install tesseract tesseract-lang
+```
+
+安装完成后显示：
+```
+✅ 工具安装完成，继续执行...
+```
+
+### 步骤 4：检测 Playwright MCP
+
+Playwright MCP 是 PDF 渲染的核心依赖。检测方式：
+
+1. 尝试呼叫 `mcp__plugin_playwright_playwright__browser_run_code`
+2. 若 MCP 可用 → 正常使用
+3. 若 MCP 不可用（未连线）→ 显示：
+
+```
+⚠️ Playwright MCP 未连线。PDF 渲染需要 Playwright 浏览器。
+请执行以下操作之一：
+  1. 启动 Playwright MCP（推荐）
+  2. 或输入 ! npx playwright install chromium 安装本地 Chromium
+```
+
+**Playwright Fallback**（MCP 不可用时）：
+
+若使用者安装了本地 Chromium，改用 Bash 执行 Node.js 脚本进行 PDF 渲染：
+```bash
+node -e "
+const { chromium } = require('playwright');
+(async () => {
+  const browser = await chromium.launch();
+  const page = await browser.newPage();
+  await page.setContent(require('fs').readFileSync('/tmp/export.html', 'utf8'));
+  await page.pdf({ path: '${OUTPUT_PATH}', format: 'A4', printBackground: true,
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' } });
+  await browser.close();
+})();
+"
+```
+
+## 工具状态缓存
+
+首次检测结果记录在记忆中（避免每次重复检测）：
+- 在同一个对话 session 中，已确认安装的工具不再重复检测
+- 若安装失败，记录错误讯息，下次触发时重试
+
+## 平台兼容性
+
+| 平台 | pymupdf | pikepdf | pandoc | tesseract | Playwright |
+|------|---------|---------|--------|-----------|------------|
+| macOS (Homebrew) | ✅ pip3 | ✅ pip3 | ✅ brew | ✅ brew | ✅ MCP/npx |
+| Linux (apt) | ✅ pip3 | ✅ pip3 | ✅ apt | ✅ apt | ✅ MCP/npx |
+| Windows (WSL) | ✅ pip3 | ✅ pip3 | ✅ choco | ✅ choco | ✅ MCP/npx |
+
+根据使用者的操作系统自动选择对应的包管理器。检测方式：
+```bash
+[[ "$(uname)" == "Darwin" ]] && echo "macOS" || echo "Linux"
+```

package/i18n/zh-CN/references/rules-end-of-flow.md

@@ -0,0 +1,150 @@
+# 🏁 流程结束规则
+
+> 所有步骤完成时载入。
+
+## ⛔ 结束条件检查
+
+产出最终整合内容前，必须先执行：
+
+1. 确认进度指示器中所有步骤都已标记 ✅
+2. 若有步骤被跳过（使用者明确要求），在最终产出中标记「⚠️ 已跳过」
+3. 若有步骤标记为 ⬜（未执行），不得进入最终产出
+4. **安全性快速检查**：若使用者将进入开发阶段（产出开发交接包），在最终产出中附上安全性提醒，并在产出开发交接包时自动读取 `references/08-security-checklist.md` 生成对应的安全架构段落
+
+违反此规则的行为：自行判断「剩下的步骤不重要」而跳过、将未完成的步骤标记为已完成、合并多个步骤一次产出。
+
+## 🔍 决策一致性检查
+
+在产出最终整合内容之前，扫描所有已完成的步骤，验证跨步骤的一致性：
+
+### 按模式检查项目
+
+**🚀 快速模式**（3 步骤 — 检查 2 项交叉引用）：
+1. JTBD ↔ PR-FAQ：PR-FAQ 是否针对与 JTBD 陈述相同的问题？
+2. PR-FAQ ↔ North Star：北极星指标是否衡量了 PR-FAQ 承诺的成果？
+
+**📦 完整模式**（20 步骤 — 检查全部 7 项）：
+1. 目标用户 — 在 JTBD、定位、PR-FAQ 和 North Star 中是否引用相同的人物画像？
+2. 核心问题 / JTBD — PR-FAQ 针对相同问题？MVP 是否解决？
+3. 定位 — 是否反映在 PR-FAQ 标题和解法方向中？
+4. 解法方向 — 选出的解法是否与 MVP 范围一致？
+5. MVP 范围 — 是否与 PR-FAQ 承诺一致？「不做」的项目是否被遵守？
+6. North Star Metric — 是否衡量 JTBD 成果？在 MVP 范围内是否可达成？
+7. Pre-mortem 风险 — 鉴于最终解法和 MVP，是否仍然相关？
+
+**🔄 改版模式**（12 步骤 — 检查 4 项）：
+1. 既有 JTBD ↔ 痛点 ↔ 定位：重新评估后是否一致？
+2. PR-FAQ ↔ MVP 范围：改版范围是否与 PR-FAQ 描述一致？
+3. North Star ↔ 改版前后：指标比较是否合乎逻辑？
+4. Pre-mortem 风险：对改版后的产品是否仍然相关？
+
+**⚡ 直接实作模式**（7 步骤 — 检查 4 项）：
+1. 问题陈述 ↔ PR-FAQ：是否针对相同问题？
+2. 解法方向 ↔ MVP 范围：选定解法是否与 MVP 一致？
+3. North Star ↔ MVP：指标在 MVP 范围内是否可达成？
+4. Pre-mortem 风险：对最终解法是否仍然相关？
+
+**🔧 功能扩充模式**（4 步骤 — 检查 3 项）：
+1. 问题 ↔ 选定解法：解法是否直接解决所述问题？
+2. 解法 ↔ 执行范围：范围是否正确实作选定解法？
+3. 风险评估：已识别的风险对执行范围是否仍然相关？
+
+**✏️ 自订模式** — 仅检查用户实际执行的步骤之间的交叉引用。跳过未纳入自订选择的步骤检查。
+
+### 执行方式
+1. 将每个核心决策列为一行摘要（例如：「目标用户：早期创业公司创始人」）
+2. 检查步骤之间是否存在矛盾或过时的引用
+3. 若发现不一致：
+   - 显示：「⚠️ 一致性检查在最终产出前发现 [N] 个问题：」
+   - 列出每个问题及受影响的步骤
+   - 询问用户：「是否要在产出最终内容前修正这些问题，还是直接继续？」
+4. 若全部一致：
+   - 显示：「✅ 决策一致性检查通过 — 所有步骤已对齐。」
+   - 继续产出最终内容
+
+### 为什么需要这个检查
+在迭代规划过程中，用户可能修改上游决策（例如：更改 JTBD），而部分下游步骤仍保留过时的内容。此检查能在最终文件产出前捕捉这些落差，避免产出不一致的交付物。
+
+## 📦 产品上下文自动萃取
+
+所有步骤完成后、产出最终整合内容的同时，读取 `references/rules-context.md` Section 8 执行上下文萃取：
+
+1. **检查 `.product-context.md` 是否存在**
+   - 不存在 → 建立新文件
+   - 存在 → 依规则更新（Identity/Core Strategy 覆写，Decision History 追加，Architecture 合并，Insights 合并去重）
+
+2. **萃取内容**（依流程类型对应 `rules-context.md` Section 8 表格）
+
+3. **告知使用者**：在最终产出后显示：
+   「✅ 产品上下文已更新至 `.product-context.md`，下次规划时将自动载入。」
+
+4. **版控提醒**（仅首次建立时）：
+   「⚠️ 建议将 `.product-context.md` 加入 `.gitignore`，此文件可能包含敏感的产品策略资讯。」
+
+## 最佳切入点分析（完整模式适用）
+
+```
+[Persona 痛点] → [JTBD 陈述] → [OST 机会] → [HMW 问题]
+    → [定位（April Dunford）] → [PR-FAQ 验证] → [解法选定]
+        → [Aha Moment] → [北极星指标] → [PMF 等级判定]
+```
+
+分析要点：最值得解决的问题 / 核心 JTBD / 产品定位 / PMF 等级与下一里程碑 / 第一步行动 / Pre-mortem 风险警示
+
+## 各模式最终产出
+
+| 模式 | 最后自动整合产出 |
+|------|----------------|
+| 🔧 功能扩充模式 | 功能开发规格：问题 → 选定解法 → 影响范围 → 执行范围 → 风险 |
+| 🚀 快速模式 | 一页式方向摘要：问题 → 解法 → 成功定义 |
+| 📦 完整模式 | 最佳切入点分析 ＋ 产品规格摘要 |
+| 🔄 改版模式 | 改版产品规格摘要：改版前后对照 + 改什么/不改什么 + 成功指标 |
+| ✏️ 自订模式 | 产品规格摘要（未执行栏位标记「未执行」） |
+| ⚡ 直接实作模式 | 工程师导向的执行摘要 |
+
+### 产出语言覆写
+
+使用者可以要求以不同于规划会议的语言产出文件：
+- 「用日文产出 PR-FAQ」
+- 「用西班牙文输出报告」
+- 「用中文撰写 PRD」
+
+当收到语言覆写请求时：
+1. 以请求的语言生成产出内容
+2. 保持框架名称为英文（JTBD、PR-FAQ、North Star 等）
+3. 产出完成后回到规划会议的原始语言
+4. 注意：这仅影响产出文件的语言，不影响参考文件或规划流程
+
+## 延伸产出询问
+
+完成最终整合产出后，主动询问：
+
+```
+「企划内容已整合完成！需要我帮你产出以下文件吗？
+
+□ 更新版 [文件类型]（基于上传的源文件增量更新）← 仅在上传了源文件时显示
+□ PDF 文件（专业排版，含书签导航，适合正式分享）
+□ HTML 企划报告（互动式，适合线上分享）
+□ Word 文件（适合协作编辑）
+□ PRD 工程师交付包（含流程图、DB schema、UI wireframe）
+□ 简报 PPTX（适合会议报告，产出后建议用 Keynote / PowerPoint 美化）
+□ 开发交接包（CLAUDE.md + TASKS.md + TICKETS.md + 技术架构，可直接在 Claude Code 中开始开发）
+□ 以上都要
+
+也可以说「不用」直接结束，或指定特定文件。
+也可以随时使用 /export [pdf|docx|pptx|html|md] 导出。」
+```
+
+**选项显示规则**：
+- 上传了源文件 → 「更新版 [文件类型]」列在最前，标注「（推荐）」
+- 产出对象为工程师 → PRD 和开发交接包排前
+- 产出对象为老板/高层 → PDF 和简报排前
+- 产出对象为跨部门 → PDF、HTML 报告和简报都列出
+- 快速模式 → 只问是否需要 PDF 或简报
+- 产出对象为自己 → 开发交接包排第一位
+
+**导出触发规则**：
+- 使用者选择 PDF / Word / 简报 PPTX → 载入 `rules-export-document.md`
+- 首次触发文件导出 → 先载入 `rules-document-tools.md` 检查并安装必要工具
+- 使用者选择 HTML 企划报告 → 载入 `06-html-report.md`（现有规则）
+- 使用者选择「以上都要」→ 依序执行各格式导出

package/i18n/zh-CN/references/rules-export-document.md

@@ -0,0 +1,346 @@
+# 多格式文件导出规则
+
+> 使用者触发 `/export [format]` 或在流程结束后选择导出格式时载入。
+> 首次使用时先载入 `rules-document-tools.md` 确认工具已安装。
+
+## 支持的导出格式
+
+| 格式 | 指令 | 转换路径 | 工具 |
+|------|------|---------|------|
+| PDF | `/export pdf` | HTML+CSS → Playwright → pikepdf 书签 | Playwright MCP + pikepdf |
+| DOCX | `/export docx` | MD → Pandoc | pandoc + reference.docx |
+| PPTX | `/export pptx` | MD → Pandoc | pandoc |
+| HTML | `/export html` | 已有 `06-html-report.md` 规则 | 内建 |
+| Markdown | `/export md` | 直接输出 | 内建 |
+
+---
+
+## PDF 导出（核心流程）
+
+### 路径判断
+
+PDF 导出有两条路径，根据来源内容自动选择：
+
+| 来源 | 路径 | 原因 |
+|------|------|------|
+| 规划成果直接导出（PRD / 增量更新 / 规格书） | **路径 A：setContent** | 无外部 JS 依赖，可内嵌所有资源 |
+| HTML 企划报告转 PDF（含 Mermaid 图表 / CDN 字体） | **路径 B：HTTP Server** | 需要载入外部 JS (mermaid.js) 和 CDN 字体 |
+
+### 路径 A：独立文件 → PDF（setContent）
+
+适用于：PRD、功能扩充增量更新、规格书、任何不含外部 JS 的内容。
+
+**步骤 1：生成 HTML 内容**
+
+Claude 读取 `references/templates/prd-style.css`，生成完整的 HTML 文件：
+
+```html
+<!DOCTYPE html>
+<html lang="zh-TW">
+<head>
+<meta charset="UTF-8">
+<style>
+/* 读取 prd-style.css 的完整内容，内嵌于此 */
+</style>
+</head>
+<body>
+
+<!-- 封面页 -->
+<div class="cover-page">
+  <h1>[文件标题]</h1>
+  <div class="subtitle">[副标题或一句话描述]</div>
+  <div class="version-badge">[版本号]</div>
+  <div class="meta-info">
+    <strong>PM</strong> [PM 名称]<br>
+    <strong>日期</strong> [ISO 日期]<br>
+    <strong>状态</strong> [状态]
+  </div>
+</div>
+
+<!-- 图例（仅增量更新文件需要） -->
+<div class="diff-legend">
+  <div class="diff-legend-item"><div class="diff-legend-swatch swatch-new"></div> 本次新增</div>
+  <div class="diff-legend-item"><div class="diff-legend-swatch swatch-upd"></div> 本次修改</div>
+  <div class="diff-legend-item"><div class="diff-legend-swatch swatch-unchanged"></div> 不变</div>
+</div>
+
+<!-- 目录页 -->
+<div class="toc-page">
+  <h2>目录</h2>
+  <ul class="toc">
+    <!-- Claude 根据文件的 h2 标题自动生成目录项目 -->
+    <li>
+      <span class="toc-title">[章节名称]</span>
+      <span class="toc-dots"></span>
+      <span class="toc-page-num">[页码]</span>
+    </li>
+  </ul>
+</div>
+
+<!-- 正文内容 -->
+[正文 HTML]
+
+<!-- 页尾 -->
+<div class="doc-footer">
+  [文件编码] [版本] ｜ [日期] ｜ Generated by Product Playbook
+</div>
+
+</body>
+</html>
+```
+
+**重要**：
+- CSS 必须完全内嵌（不使用外部链接）
+- 字体使用系统字体：`"PingFang TC", "Noto Sans TC", system-ui`（Playwright 会自动嵌入 PDF）
+- 不包含任何 `<script>` 标签或外部资源引用
+- 目录页码为预估值（生成 PDF 后可能需微调）
+
+**步骤 2：Playwright 渲染 PDF**
+
+将 HTML 内容储存到 `/tmp/export-{timestamp}.html`，然后呼叫 Playwright MCP：
+
+```javascript
+// mcp__plugin_playwright_playwright__browser_run_code
+async (page) => {
+  const fs = require('fs');
+  const html = fs.readFileSync('/tmp/export-{timestamp}.html', 'utf8');
+  await page.setContent(html, { waitUntil: 'networkidle' });
+  await page.pdf({
+    path: '{output_path}',
+    format: 'A4',
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' },
+    printBackground: true,
+    displayHeaderFooter: true,
+    headerTemplate: '<div></div>',
+    footerTemplate: '<div style="font-size:8pt;color:#999;text-align:center;width:100%;">p.<span class="pageNumber"></span> / <span class="totalPages"></span></div>'
+  });
+  return 'PDF generated';
+}
+```
+
+> 注意：若 HTML 内容过大（>500KB），setContent 可能超时。此时改用路径 B（HTTP Server）。
+
+**步骤 3：pikepdf 注入书签**
+
+```python
+import pikepdf, re
+
+pdf = pikepdf.open('{output_path}')
+
+# 从 HTML 中提取 h2 标题作为书签
+# Claude 在生成 HTML 时需记录每个 h2 对应的预估页码
+bookmarks = [
+    # (标题, 页码索引 0-based)
+    ("修订纪录", 2),
+    ("User Story", 4),
+    ("开发架构说明", 6),
+    # ... 依实际内容生成
+]
+
+with pdf.open_outline() as outline:
+    for title, page_idx in bookmarks:
+        page_idx = min(page_idx, len(pdf.pages) - 1)
+        outline.root.append(
+            pikepdf.OutlineItem(title, page_idx)
+        )
+
+# 设定 PDF 元数据
+with pdf.open_metadata() as meta:
+    meta['dc:title'] = '[文件标题]'
+    meta['dc:creator'] = ['[PM 名称]']
+    meta['pdf:Producer'] = 'Product Playbook + Playwright'
+
+pdf.save('{output_path}')
+```
+
+**步骤 4：通知使用者**
+
+```
+✅ PDF 已导出至：{output_path}
+  📄 {页数} 页 ｜ {文件大小}
+  📑 含书签导航（{书签数} 个章节）
+```
+
+### 路径 B：HTML 报告 → PDF（HTTP Server）
+
+适用于：含 Mermaid 图表、CDN 字体、互动元素的 HTML 报告。
+
+**步骤 1：HTML 报告已生成**
+
+HTML 报告由 `06-html-report.md` 规则生成，已存为 `/tmp/report-{timestamp}.html`。
+
+**步骤 2：启动 HTTP Server**
+
+```bash
+cd /tmp && python3 -m http.server 18899 &
+echo $!  # 记录 PID
+```
+
+**步骤 3：Playwright 渲染**
+
+```javascript
+// mcp__plugin_playwright_playwright__browser_run_code
+async (page) => {
+  await page.goto('http://localhost:18899/report-{timestamp}.html', {
+    waitUntil: 'networkidle',
+    timeout: 30000
+  });
+  // 等待 Mermaid 图表渲染完成
+  await page.waitForTimeout(3000);
+  // 展开所有手风琴（<details>）元素
+  await page.evaluate(() => {
+    document.querySelectorAll('details').forEach(d => d.open = true);
+  });
+  await page.pdf({
+    path: '{output_path}',
+    format: 'A4',
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' },
+    printBackground: true,
+    displayHeaderFooter: true,
+    headerTemplate: '<div></div>',
+    footerTemplate: '<div style="font-size:8pt;color:#999;text-align:center;width:100%;">p.<span class="pageNumber"></span> / <span class="totalPages"></span></div>'
+  });
+  return 'PDF generated';
+}
+```
+
+**步骤 4：关闭 HTTP Server + pikepdf 书签**
+
+```bash
+kill {SERVER_PID}
+```
+
+然后执行与路径 A 相同的 pikepdf 书签注入步骤。
+
+### Playwright MCP 不可用时的 Fallback
+
+若 Playwright MCP 未连线，使用 Node.js 直接执行：
+
+```bash
+node -e "
+const { chromium } = require('playwright');
+const fs = require('fs');
+(async () => {
+  const browser = await chromium.launch({ headless: true });
+  const page = await browser.newPage();
+  const html = fs.readFileSync('/tmp/export-{timestamp}.html', 'utf8');
+  await page.setContent(html, { waitUntil: 'networkidle' });
+  await page.pdf({
+    path: '${OUTPUT_PATH}',
+    format: 'A4',
+    printBackground: true,
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' }
+  });
+  await browser.close();
+  console.log('PDF generated');
+})();
+"
+```
+
+---
+
+## DOCX 导出
+
+### 步骤 1：生成 Markdown
+
+Claude 将规划成果整理为干净的 Markdown 格式，存为 `/tmp/export-{timestamp}.md`。
+
+### 步骤 2：Pandoc 转换
+
+```bash
+pandoc /tmp/export-{timestamp}.md \
+  -o "{output_path}" \
+  --from markdown \
+  --to docx \
+  --reference-doc="~/.claude/skills/product-playbook/references/templates/reference.docx" \
+  --toc \
+  --toc-depth=2
+```
+
+若无 reference.docx 模板，省略 `--reference-doc` 参数（使用 Pandoc 预设样式）。
+
+### 步骤 3：通知使用者
+
+```
+✅ Word 文件已导出至：{output_path}
+  📄 含目录 ｜ {文件大小}
+```
+
+---
+
+## PPTX 导出
+
+```bash
+pandoc /tmp/export-{timestamp}.md \
+  -o "{output_path}" \
+  --from markdown \
+  --to pptx \
+  --slide-level=2
+```
+
+> 提示：Pandoc PPTX 品质有限，建议使用者将 PPTX 当作大纲，再用 PowerPoint/Keynote 美化。
+
+---
+
+## 增量更新文件的特殊处理
+
+当导出的是 Feature Extension 或 Revision 模式的增量更新文件时：
+
+### Diff 视觉标记规则
+
+1. **`[NEW]` 标记的段落**：
+   - 使用 `<span class="new">NEW</span>` 标记
+   - 所在表格行加 `class="new-row"`
+   - 段落加 `class="diff-added"`
+
+2. **`[UPDATED]` 标记的段落**：
+   - 使用 `<span class="upd">UPDATED</span>` 标记
+   - 所在表格行加 `class="upd-row"`
+   - 若有原始内容，原始内容加 `class="diff-removed"`，新内容加 `class="diff-added"`
+
+3. **未变更的段落**：正常显示，不加任何特殊标记
+
+4. **文件开头加图例**：
+```html
+<div class="diff-legend">
+  <div class="diff-legend-item">
+    <div class="diff-legend-swatch swatch-new"></div> 本次新增
+  </div>
+  <div class="diff-legend-item">
+    <div class="diff-legend-swatch swatch-upd"></div> 本次修改
+  </div>
+  <div class="diff-legend-item">
+    <div class="diff-legend-swatch swatch-unchanged"></div> 无标记 = 不变
+  </div>
+</div>
+```
+
+---
+
+## 输出路径规则
+
+预设输出到 `~/Downloads/`，文件名格式：
+
+```
+[文件编码] [文件标题] [版本].{ext}
+
+范例：
+[D-221] 凯基个人虚拟帐号 v1.0.14 完整合并版.pdf
+Product Planning Report - UPASS Virtual Account.docx
+```
+
+若使用者指定路径，使用使用者指定的路径。
+
+---
+
+## 品质检查清单
+
+导出前，Claude 自我检查：
+
+- [ ] HTML 中无残留的 Markdown 语法（`**`, `##`, `|---|`）
+- [ ] 所有表格的行数和列数与原始内容一致
+- [ ] `[NEW]` / `[UPDATED]` 标记正确套用对应 CSS class
+- [ ] 封面页资讯（标题、版本、PM、日期）正确
+- [ ] 目录项目与正文 h2 标题一致
+- [ ] CSS 完全内嵌（路径 A）或 CDN 可存取（路径 B）
+- [ ] 书签数量与 h2 标题数量一致

package/i18n/zh-CN/references/rules-file-integration.md

@@ -0,0 +1,65 @@
+# 📎 文件整合指引
+
+> 使用者上传补充材料时载入。
+
+## 可直接处理的文件类型
+
+| 文件类型 | 常见场景 | 整合方式 |
+|---------|---------|---------|
+| **图片** | 竞品截图、白板照片、用户旅程手绘图、App 界面截图、数据报表截图 | 辨识内容后整合到对应步骤 |
+| **PDF** | 市场报告、内部文件、用户调研报告、旧版 PRD | 载入 `rules-import-document.md` 进行三层解析（pymupdf 直提 → Claude Vision 语意解析 → Tesseract fallback）。首次使用时载入 `rules-document-tools.md` 检查工具。 |
+| **CSV / Excel** | 用户行为数据、留存数据、NPS 调查结果、销售数据 | 分析数据后用于量化评估 |
+| **文字档** | 访谈逐字稿、既有需求文件、会议纪录 | 提取 Persona 线索、痛点、JTBD 证据 |
+| **DOCX** | 既有 PRD、产品规格书、用户研究报告 | 载入 `rules-import-document.md`，使用 Pandoc 转 Markdown 后整合。首次使用时载入 `rules-document-tools.md` 检查工具。 |
+| **PPTX** | 既有简报、产品介绍投影片 | 载入 `rules-import-document.md`，使用 Pandoc 转 Markdown 后整合。 |
+
+## 无法直接处理但可引导的
+
+| 文件类型 | 引导方式 |
+|---------|---------|
+| **影片** | 请使用者描述关键场景，或提供逐字稿/字幕档 |
+| **Figma / Sketch** | 请使用者截图后上传 |
+| **Protobuf / Swagger** | 请使用者汇出为 JSON 或文字格式 |
+
+## 文件 → 步骤自动对应表
+
+| 上传内容 | 自动对应步骤 | 整合动作 |
+|---------|------------|---------|
+| 竞品 App / 网站截图 | Positioning | 识别为「竞争替代品」，分析差异化 |
+| 白板手绘流程图 | Journey Map / OST | 辨识流程后转化为结构化表格 |
+| 用户访谈逐字稿 | Persona + JTBD | 提取痛点、现行做法、情绪反应、Job 陈述 |
+| 用户行为数据（CSV） | 机会评估 + North Star + PMF | 用真实数据替代假设性评分 |
+| NPS / 满意度调查 | PMF + Sean Ellis Score | 直接计算 Score；判断 PMF 等级 |
+| 既有 PRD / 需求文件 | 改版模式 S1 + MVP | 提取既有功能清单和决策历史 |
+| 市场报告 PDF | 机会评估 + Strategy | 提取市场规模、趋势、竞争格局 |
+| 销售数据 | 商业模式 + GTM | 分析营收结构、客户分布、渠道效果 |
+| App 界面截图 | Aha Moment + Journey | 分析当前体验路径 |
+
+## 整合规则
+
+1. **主动辨识**：先说明「我看到你上传了 [文件类型]，我会把其中的 [关键资讯] 整合到 [步骤名称] 中。」
+2. **不覆盖已有产出**：将上传内容标记为「补充数据」并更新产出，同时触发变更传播规则
+3. **标记来源**：在产出中标注哪些内容来自上传文件（例如：「✦ 来自上传的用户调研报告」）
+4. **数据优先**：真实数据和先前假设有冲突时，以真实数据为准
+5. **跨步骤影响**：一份文件可能同时影响多个步骤，应一次性列出所有受影响的步骤
+
+## 📎 源文件识别与增量更新
+
+当用户在**功能扩展**或**改版模式**中上传文件时，判断该文件是否为「源文件」（应根据新规划产出进行增量更新的文件）：
+
+### 识别条件
+- 文件类型：PRD、产品规格书、架构文档、需求文档、设计文档
+- 用户明确表示：「这是我们目前的 PRD」、「更新这份文档」、「在这份规格上扩展」等
+- 在功能扩展或改版模式的 S1（上下文收集）阶段上传
+
+### 识别到源文件时
+1. 标记提示：「📎 检测到源文件——最终产出将基于此文件进行增量更新」
+2. 解析文档结构（章节标题、格式惯例、命名模式）
+3. 记录文档的格式与风格，确保产出一致性
+4. 在 S1 阶段，利用该文件预填已有系统背景（技术栈、模块、功能）
+
+### 增量产出规则（于最终产出阶段应用）
+- 新内容插入对应章节，标记为 `[NEW]`
+- 修改内容标记为 `[UPDATED]`，原始内容以注释方式保留
+- 与新功能无关的章节保持不变
+- 产出文档维持原始文件的格式、风格与命名惯例