# 28 天获客证明计划 · 交付说明（plan/）

> **GEO智见Insight 出品 · 公开实验**
> 用同一批 20 个目标问题、同一批 5 大 AI 引擎、同一套判读口径，在第 0 天与第 28 天各测一次；口径、证据与失败可能全部公开。打铁还需自身硬，不主推任何具体工具。

---

## 1. 文件清单

| 文件 | 说明 |
|---|---|
| [`plan/index.html`](index.html) | 战役风格视觉网页：Hero、军令状/可证伪强提示模块、5 项硬指标仪表盘、W0–W4 时间轴、周计划模块、证据存档卡、测量方法、第 28 天复盘目录、CTA、品牌页脚 |
| [`plan/action-poster.html`](action-poster.html) | 行动计划海报源文件（固定画布 540×960，@2x 导出 1080×1920） |
| [`plan/exports/action-poster.png`](exports/action-poster.png) | 行动计划海报 PNG，**1080×1920** |
| [`plan/28天获客证明计划.md`](28天获客证明计划.md) | 可执行文档 Markdown 源稿（唯一内容源，Word 版由它生成） |
| [`docs/28天获客证明计划-可执行文档.docx`](../docs/28天获客证明计划-可执行文档.docx) | Word 可执行文档（封面 / 目录 / 军令状 / 指标口径 / 周任务 / 20 题 / 存档规范 / UTM / 周报 / 复盘目录 / 风险） |
| [`plan/exports/plan-page-preview.png`](exports/plan-page-preview.png) | 网页全页预览（1440px 宽，scale 1，1440×12291） |
| [`plan/exports/plan-page-mobile-390.png`](exports/plan-page-mobile-390.png) | 网页移动端全页预览（390px 宽，scale 1，390×21208） |
| [`plan/exports/checks/`](exports/checks/) | 375 / 1440 两档分区块+首屏自检截图（768 档仅做溢出数值检测） |
| [`plan/build/visual-check.mjs`](build/visual-check.mjs) | 响应式自检脚本：检查横向滚动、文字溢出并输出分区块截图 |
| [`plan/build/build_plan_docx.py`](build/build_plan_docx.py) | 由 Markdown 源稿生成 docx 的构建脚本（含内容校验） |

---

## 2. 本地预览与渲染

> 所有命令均在**工作区根目录** `/workspace/geo_visual_content` 执行。

### 2.1 网页预览

```bash
# 在仓库根目录启动任意静态服务器后访问：
#   http://127.0.0.1:8080/plan/index.html
python3 -m http.server 8080
```

页面引用 `../assets/css/brand.css` 与 `../assets/js/motion.js`，因此必须从仓库根目录作为站点根访问，不要单独双击 HTML 文件。

### 2.2 海报 PNG（1080×1920）

```bash
cd /workspace/geo_visual_content && node scripts/render.mjs \
  --file plan/action-poster.html \
  --selector "#action-poster" \
  --out plan/exports/action-poster.png \
  --scale 2 --width 1080
```

### 2.3 网页全页 / 移动预览

```bash
# 桌面全页预览（scale 1 控制文件体积）
node scripts/render.mjs --file plan/index.html --full-page \
  --width 1440 --scale 1 --out plan/exports/plan-page-preview.png

# 移动端全页预览（390px，scale 1）
node scripts/render.mjs --file plan/index.html --full-page \
  --width 390 --scale 1 --out plan/exports/plan-page-mobile-390.png
```

### 2.4 响应式自检（375 / 768 / 1440）

```bash
node plan/build/visual-check.mjs
# 输出：各档位 scrollWidth/clientWidth、溢出候选列表，以及 plan/exports/checks/*.png
```

### 2.5 WCAG 对比度复核（可选，使用 QA 审计脚本）

```bash
# 只读取 qa/audit.mjs，输出写入 plan/build/qa-final/
NODE_PATH=$(npm root -g) node qa/audit.mjs --site-dir . --pages plan/index.html \
  --viewports 1440x900,375x812 --out plan/build/qa-final --label-prefix final-
```

### 2.6 重新生成 Word 可执行文档

使用 office skill 的 bundled Python（含 python-docx）：

```bash
PY=/mnt/code-cli-agents/deepseek_harness/resources/2a6d8bdca8136e18af357cd6fd24cdb46fed4b21b562773d09de6c2e01ae7211/primary/primary-runtime/dependencies/python/bin/python3
cd /workspace/geo_visual_content && "$PY" plan/build/build_plan_docx.py
```

脚本会自动重新打开生成文件并校验关键内容（军令状、5 项指标、QLIST/ENGINE-LIST、哈希、UTM、风险与应对、品牌署名等）。

---

## 3. 自检结论（本次交付）

- **海报**：`plan/exports/action-poster.png` 实测 **1080×1920**，构图完整、无文字裁切，右下角含品牌水印“GEO智见Insight 出品”。
- **网页响应式**：375 / 768 / 1440 三档 `documentElement.scrollWidth === clientWidth`，**无横向滚动**；未检出文字溢出（inline text overflow 候选为 0）。
- **WCAG AA 对比度**：经 QA 对比度审计，`plan/index.html` 在 1440×900 与 375×812 两档均 **0 项不达标**（分别采样 397 / 391 个文字元素；最低值 3.07 为大号 W2/W4 周次徽章，满足大字 ≥3:1 的 AA 阈值）。军令状/可证伪模块深底文字、指标卡、chip 标签与水印均已通过。
- **品牌与合规**：品牌 “GEO智见Insight” 出现在网页导航、页脚、海报水印、文档封面/署名/页脚；全页所有数字均为设计口径、目标阈值或计划量，统一标注「待验证」。
- **Word 文档**：封面、目录、正文、表格、代码块与页脚版式经 LibreOffice 渲染逐页目视检查，排版完整可读。

## 4. 内容口径与免责声明

- 本计划**不包含任何实验结果数据**；`待验证` 表示尚无实测值，只有口径、基线与目标阈值。
- 允许修改范围为 `plan/**` 与 `docs/28天获客证明计划*`；修改共享视觉资产（`assets/**`、`scripts/**` 等）须先联系 Lead。
- 视觉规范遵循 [`DESIGN_SYSTEM.md`](../DESIGN_SYSTEM.md) 与 [`assets/css/brand.css`](../assets/css/brand.css)。

---

**GEO智见Insight 出品 · 公开实验 · 数据待验证，以公开存档为准**