Browse Source

docs(superpowers): 新增规划与设计文档 - 内部沟通/合伙人PPT/家庭挑战参与

asus 1 month ago
parent
commit
1d51481c73

+ 394 - 0
docs/superpowers/plans/2026-08-07-xaf-internal-communication.md

@@ -0,0 +1,394 @@
+# 浠艾福 对外沟通·统一口径(内部版)16 页 PPT 实施计划
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 生成 16 页内部版 PPT(对外沟通·统一口径作战手册),供对外相关团队宣讲与沉淀参考。
+
+**Architecture:** 复用既有 HTML 幻灯片管线:每页一个自包含 HTML(1280×720,内联 CSS + CSS 变量),输出到独立目录 `ppt-output/internal/slides/`,用 Python 生成器产出 iframe 预览页。4 个 Agent 并行生成 4 组页面,随后统一渲染验证。
+
+**Tech Stack:** 纯 HTML/CSS/SVG(无 JS 运行时、无动画)、Python 3(预览生成器)、Chrome DevTools(渲染验证)
+
+## Global Constraints
+
+- **内容唯一来源**: `docs/superpowers/specs/2026-08-07-xaf-internal-communication-design.md`(信息卡在下方 Task 中完整复制,Agent 必须逐条实现,不增删事实)
+- **管线红线**(`ppt-output/runtime/html-spec.md`): body 固定 `width:1280px; height:720px; overflow:hidden`;禁止动画/`@keyframes`/`transition`;禁止伪元素视觉装饰;禁止 `background-image` 放图(用 `<img>`);禁止 SVG 内 `<text>`;禁止 `conic-gradient`(用 SVG circle + stroke-dasharray);禁止 `background-clip:text` 渐变文字;所有颜色必须 `var(--xxx)`(CSS 变量展开自 style.json 的 css_variables 到 `:root`),**禁止硬编码色值**
+- **CSS 变量源**: `ppt-output/style.json`(style_id: tech_blue_warm_orange)——bg-primary `#0A1A2F`、accent-1 `#FF8C42`、五维色 five_earth `#FF8C42` / five_fire `#FF6B9D` / five_metal `#6366F1` / five_wood `#10B981` / five_water `#F59E0B`
+- **内部版专属约束**:
+  - 输出目录 `ppt-output/internal/slides/slide-{N}.html`(N=1..16),**禁止写入/覆盖** `ppt-output/slides/`(外部版 16 页)
+  - 每页右上角固定角标:半透明胶囊「内部 · 统一口径」(如 `position:absolute; top:20px; right:40px`,z-index 高于 header),页脚格式 `内部·统一口径 | NN / 16`
+  - 红线页(slide-11/12/13)红色系强调:警示语义色用 `#EF4444` 系(必须作为 CSS 变量 `--danger: #EF4444` 定义后引用),❌⚠️✅ 语义图标用真实 SVG `<circle>`/`<path>` 或 HTML 字符 + 语义色
+  - Q&A 页(slide-14/15)问答卡布局:Q 行橙色(accent-1)、A 行深蓝底(card-bg-from)——**同一 Q 与其 A 配对成一张卡**,禁止 Q/A 分离
+  - 数字全部 `font-variant-numeric: tabular-nums`;每页 ≥2 种 card_style;accent/elevated 各 ≤1;每页内容卡打 `data-card-id` 标记,装饰节点打 `data-decoration-layer` + `aria-hidden="true"`
+- **写文件注意**: 若目标文件已存在,`write` 会被拒绝(报 "File already exists")——先用 `read` 读一次该文件再 `write`
+- **数据口径铁律**: 对外数据仅限 S5 组(78 城市 / 840 规划师 / 84,994 用户 / 4,423,014 份测评)与设计文档已确认数据;收入/成本/漏斗等内部指标**只出现在红线页作为"禁止外传"示例**,禁止作为正面数据展示
+
+---
+
+## 文件结构
+
+| 文件 | 责任 |
+|------|------|
+| `ppt-output/internal/slides/slide-1~16.html` | 16 页幻灯片(本计划主体产物) |
+| `ppt-output/internal/preview-internal.html` | 16 页预览页(iframe src 引用 slides/,Task 6 生成) |
+| `ppt-output/runtime/gen_preview_internal.py` | 预览生成器(复制 gen_preview16.py 改造) |
+| `docs/superpowers/PROJECT-OVERVIEW.md` | 文档索引同步(Task 7) |
+
+## Task 分解概览
+
+| Task | 内容 | 产出 |
+|------|------|------|
+| 1 | 目录准备 + 参考模板确认 | `ppt-output/internal/slides/` 存在 |
+| 2 | slide-1~4(封面/定位三句话/五维平台/身份话术) | 4 个 HTML |
+| 3 | slide-5~8(成果/平台/检测/案例话术) | 4 个 HTML |
+| 4 | slide-9~12(合作/理念话术 + 红线 2 页) | 4 个 HTML |
+| 5 | slide-13~16(脱敏红线/Q&A×2/行动项) | 4 个 HTML |
+| 6 | 预览生成器 + preview-internal.html | 1 个 py + 1 个 html |
+| 7 | 渲染验证 16 页 + 文档同步 | 验证记录 + PROJECT-OVERVIEW 更新 |
+
+---
+
+### Task 1: 环境准备
+
+**Files:**
+- Create: `ppt-output/internal/slides/`(目录)
+- Read: `ppt-output/runtime/html-spec.md`、`ppt-output/style.json`、`ppt-output/slides/slide-2.html`(参考骨架)
+
+- [ ] **Step 1: 创建输出目录**
+
+```bash
+New-Item -ItemType Directory -Force -Path "D:\workspace\cfc\ppt-output\internal\slides"
+```
+
+- [ ] **Step 2: 确认参考模板可读**
+
+读取 `ppt-output/slides/slide-2.html` 确认骨架:`:root` 变量展开 → `.grid-overlay` → `.slide-header` → `.slide-footer` → 内容区。内部版沿用同一骨架,另加右上角内部角标。
+
+- [ ] **Step 3: 确认无旧产物残留**
+
+确认 `ppt-output/internal/` 为空(或仅含待覆盖文件),且 `ppt-output/slides/slide-1~16.html` 未被触碰(外部版产物)。
+
+---
+
+### Task 2: slide-1~4(第一部分 一句话共识 + 身份话术)
+
+**Files:**
+- Create: `ppt-output/internal/slides/slide-1.html` ~ `slide-4.html`
+
+**Interfaces:**
+- Consumes: html-spec.md 导航骨架(`.slide-header` / `.slide-footer`)、style.json CSS 变量、内部角标规范(Global Constraints)
+- Produces: 4 个自包含 HTML,供 Task 6 预览 iframe 引用、Task 7 渲染验证
+
+**视觉基调**: 第一部分为"共识层"——低到中密度,深蓝底 + 暖橙强调 + 网格点阵;slide-1 封面大字号冲击力(H0 ≥80px),slide-2/3 信息密度逐级上升。
+
+- [ ] **Step 1: 生成 slide-1.html(封面)**
+
+```html
+<!DOCTYPE html><html lang="zh-CN"><head><meta charset="UTF-8">
+<style>
+/* :root 展开 style.json css_variables(含 --danger: #EF4444) */
+/* body 1280×720 overflow:hidden + grid-overlay 点阵 */
+/* 右上角角标 .internal-badge: 半透明胶囊「内部 · 统一口径」 */
+</style>
+```
+
+内容(来自设计文档 S1):
+- 主标题: 对外沟通 · 统一口径(H0,≥80px,字距 -0.02em)
+- 副标题: 让每个家庭的健康,都被提前看见
+- 标注: 内部培训资料 · 面向对外相关团队(商务/市场/运营/管理层)
+- 落款: 浠艾福(Care Family)· 2026
+- 内部角标 + 页脚 `内部·统一口径 | 01 / 16`
+- card_style 混用:标题区 transparent + 落款 outline;装饰节点打标
+
+- [ ] **Step 2: 生成 slide-2.html(定位三句话)**
+
+内容(S2)——三句标准表述,必须逐字一致:
+1. **我们是谁**: 双培强基工程(人民日报《人民周刊》+ 中国科学院心理研究所联合发起)旗下工程品牌"中科心知",落地家庭健康服务平台"浠艾福(Care Family)"
+2. **我们解决什么**: 让家庭健康从"被动等待"走向"主动掌握"——提前预知风险、提前干预
+3. **我们怎么做**: 以五维体系(身·智·富·行·心)为框架,以"检测 → AI 分析 → 个性化方案 → 行为执行 → 复测迭代"闭环为载体
+
+布局:三句横排三卡(递减节奏或主副节奏,禁止等宽等高排一行);每卡编号气泡 01/02/03(真实 div),卡标题(谁/解决什么/怎么做)+ 正文;顶部强调条"电梯陈述 · 对外开场必须一致";底部讲解要点 caption。页脚 `02 / 16`。
+
+- [ ] **Step 3: 生成 slide-3.html(五维平台一页看懂)**
+
+内容(S3):
+- 五维色环(中心):身(主动健康)#FF8C42 / 心(大爱相随)#FF6B9D / 智(赋能未来)#6366F1 / 行(人际和谐)#10B981 / 富(利他创富)#F59E0B——SVG circle + stroke-dasharray 分段环形 + HTML 标签叠加(SVG 内禁止 `<text>`)
+- 四端卡(围绕或下方):家长端(决策与付费)/ 孩子端(行为落地)/ 规划师·供应商端(服务供给)/ 管理端(运营中枢)
+- 三边市场骨架(底部条):家庭 ← 规划师 ← 供应商(数据/服务/产品三边协同)
+- 讲解要点 caption: "这是'平台是什么'的标准图;任何对外介绍从这张图开始,不展开技术细节"
+- 五维色系点缀;页脚 `03 / 16`
+
+- [ ] **Step 4: 生成 slide-4.html(身份话术)**
+
+内容(S4):
+- 标准表述: 双培强基工程——人民日报《人民周刊》与中国科学院心理研究所联合发起的青少年成长素养培育工程;工程品牌"中科心知"承载测评体系;浠艾福(Care Family)是工程成果的市场化落地平台
+- 身份层级链: 工程 → 品牌 → 平台(三阶可视化,箭头连接,真实 div 连线)
+- 关键数据: 学术带头人三卡——魏高峡(核心专家/学术指导)、施建农(核心专家/体系构建)、张挽时(核心专家/临床实践)
+- 口径提示卡(outline 样式): "只表述'联合发起/学术指导',不夸大隶属关系;不单独强调某位专家个人"
+- 页脚 `04 / 16`
+
+- [ ] **Step 5: 生成后自检(每页)**
+
+按 html-spec.md 第 10 节清单自检:body 1280×720、颜色全走变量、无动画/伪元素/background-image、SVG 无 text、card 有 data-card-id、装饰有 data-decoration-layer、≥2 种 card_style、数字 tabular-nums、无溢出。
+
+---
+
+### Task 3: slide-5~8(第二部分 标准话术:成果/平台/检测/案例)
+
+**Files:**
+- Create: `ppt-output/internal/slides/slide-5.html` ~ `slide-8.html`
+
+**Interfaces:**
+- Consumes: 同 Task 2 + slide-1~4 已建立的角标/页脚/骨架约定(跨页一致性合同)
+- Produces: 4 个 HTML,供 Task 6/7 使用
+
+**视觉基调**: 第二部分为"话术层"——中高密度;slide-5 数据页大号水印数字 + Data-Hero(≥64px);slide-8 案例页引入外部版案例表述但**脱敏**(化名小辰)。
+
+- [ ] **Step 1: 生成 slide-5.html(成果话术)**
+
+内容(S5)——核心 KPI 四卡(Data-Hero ≥64px,tabular-nums):
+- **78** 城市覆盖 | **840** 位认证成长规划师 | **84,994** 人注册用户 | **4,423,014** 份累计测评
+- 辅助数据(可选引用,caption 标注"源自运营大屏"): 年龄分布 10-12 岁占 35% / 测评包 A2 占 55% / 区域分布北部 40,913 · 广东 35,958
+- 口径提示卡(outline,黄色 ⚠️ 语义): "这组数据是当前对外公开口径(2026-08 时点);数据更新以运营确认为准(见 S11)"
+- 每 KPI 卡至少一个 CSS 可视化(进度条/对比柱/sparkline);页脚 `05 / 16`
+
+- [ ] **Step 2: 生成 slide-6.html(平台话术)**
+
+内容(S6):
+- 主表述: DAN 素质能力测评体系——"有模型、有算法、有数据"(三列强调,各带图标)
+  - 有模型: A2 六维认知(感知觉/注意力/记忆力/推理/空间/加工速度)+ 大五人格
+  - 有算法: 135 页报告 → 3 页行动方案(AI 报告解析引擎)
+  - 有数据: 4,423,014 份真实测评积累,数据飞轮驱动模型迭代
+- 五环节闭环(底部横贯): 检测 → AI 分析 → 个性化方案 → 行为执行 → 复测迭代(flex 横向 + 真实 div 连线箭头)
+- 讲解要点 caption: "把'技术底座'翻译成对外价值语言——任何产品/服务接入,都建立在同一套可量化、可验证的测评底座上"
+- 页脚 `06 / 16`
+
+- [ ] **Step 3: 生成 slide-7.html(检测话术)**
+
+内容(S7):
+- 三步流程: 居家采样 → 135 页专业报告 → AI 压缩为 3 页行动方案(横排流程,主副节奏)
+- 真实数据点三卡: 健康总分 **73**(均值 75)/ 菌群健康 **53**(偏低·重点调理)/ 检出菌种 **313** 种(均值约 800)——每卡带状态徽章与可视化
+- AI 自动标注三小卡: 维生素 B12 / 苏氨酸 / 丙氨酸("数据→方案"自动化证据)
+- AI 健康教练卡(accent 样式,每页 ≤1): 7×24 智能应答 + 家庭 360° 上下文
+- 讲解要点 caption: "强调'检测不是终点,干预 + 复测才是闭环'"
+- 页脚 `07 / 16`
+
+- [ ] **Step 4: 生成 slide-8.html(案例话术)**
+
+内容(S8):
+- 案例头卡: 真实案例 · 小辰(化名)——11 岁男孩,注意力问题
+- 检测数据三卡: 菌群平衡 **37/100** / 双歧杆菌 **0.22%**(正常 ≥5%)/ 注意力 **49%**
+- 洞察句(强调条,暖橙): "大脑硬件没问题,是运行环境出了问题"
+- 干预闭环三步: 菌群溯源 → 精准调理 → 复测对比
+- 数据原则标注(右下角 caption): 匿名处理,数据来源"浠艾福家庭健康报告"
+- 讲解要点 caption: "案例是转化利器,但必须按 S13 脱敏规则讲;禁止使用非客户案例"
+- 页脚 `08 / 16`
+
+- [ ] **Step 5: 生成后自检(每页)**
+
+同 Task 2 Step 5。
+
+---
+
+### Task 4: slide-9~12(合作/理念话术 + 红线两页)
+
+**Files:**
+- Create: `ppt-output/internal/slides/slide-9.html` ~ `slide-12.html`
+
+**Interfaces:**
+- Consumes: 同前 + slide-11/12 为红线页需引入 `--danger: #EF4444` 与 ❌⚠️✅ 语义图标
+- Produces: 4 个 HTML,供 Task 6/7 使用
+
+**视觉基调**: slide-9 合作话术收束、slide-10 理念话术(五维色再次点亮);slide-11/12 进入红线层——**视觉风格陡变**:红色系强调、警示图标、语义色分级,与前半部分形成"安全提示"区隔。
+
+- [ ] **Step 1: 生成 slide-9.html(合作话术)**
+
+内容(S9):
+- 主表述: 开放平台 · 生态共建
+- 三档合作框架(三卡阶梯递进):
+  1. **产品接入**: 1-2 款产品试点,30 天内跑通"检测 → 推荐 → 复购"最小闭环
+  2. **联合运营**: 共建健康包(检测+产品+复测),双方分成
+  3. **资本合作**: 数据资产与客户池价值开放,共享平台增长红利
+- 目标家庭池 Data-Hero: **1.2 亿户**
+- 口径提示卡(outline): "对外不点名具体企业(洽谈中不透露,见 S12);表述为'面向所有潜在合作伙伴的通用框架'"
+- 页脚 `09 / 16`
+
+- [ ] **Step 2: 生成 slide-10.html(理念话术)**
+
+内容(S10):
+- 主表述(强调条): 主动健康 = 预测/预知——不是等指标异常了才干预,而是提前预知风险、提前干预
+- 五维全景幸福矩阵: 身·智·富·行·心 五维色小徽章行 + "四维补富 → 五维全景";富维度副标"经济安全感是幸福底座之一"
+- 五行动态平衡双卡: 相生(身→智→富→行→心→身)/ 相克(身克富/智克行/富克心/行克身/心克智)
+- 讲解要点 caption: "用于'为什么是五维'的解释场景;五行关系点到为止,不展开哲学细节"
+- 页脚 `10 / 16`
+
+- [ ] **Step 3: 生成 slide-11.html(沟通红线·数据与业绩)**
+
+内容(S11)——红线页,红色系基调:
+- 页标题: 沟通红线 ① 数据与业绩
+- ❌ 不外传(danger 卡 ×2): 转化漏斗、收入/成本/毛利、付费率等内部运营数据;未脱敏原始用户数据与单用户画像明细
+- ⚠️ 测算口径(warning 卡): "单用户年收入 1 万元 × 用户规模"等测算值,必须标注"测算值,不构成业绩承诺";数据时效——对外数据以运营最新确认为准,禁止过期数据
+- ✅ 可讲(success 卡): 对外公开的运营大屏数据、已发布报告引用(注明出处)
+- 顶部或角标强化"红线"标识;❌⚠️✅ 图标为真实 SVG 或 HTML 符号 + 语义色(danger `--danger` / warning `#F59E0B` / success `#10B981`,warning/success 走 CSS 变量)
+- 页脚 `11 / 16`
+
+- [ ] **Step 4: 生成 slide-12.html(沟通红线·合作与合规)**
+
+内容(S12):
+- 页标题: 沟通红线 ② 合作与合规
+- ❌ 不点名未签约合作方(如广药康美)——统一"开放平台、洽谈中不透露"
+- ❌ 不承诺疗效/诊断: "肠漏"表述改为"肠道屏障功能受损(潜在通路)";测评结果非医疗诊断;健康建议不替代医嘱
+- ❌ 不夸大学术关系: 只说"联合发起/学术指导",不虚构隶属
+- ⚠️ 外部数据引用注明出处(如《中国居民营养与慢性病状况报告 2020》)
+- ✅ 合规基础: 团体标准 T/CS 004-2025《体重管理产品质量要求》可作产品合规依据引用
+- 布局: 红橙(danger)区为主体 + 底部黄绿(warning/success)带;页脚 `12 / 16`
+
+- [ ] **Step 5: 生成后自检(每页)**
+
+同前 + 红线页确认语义色全部走 CSS 变量(无硬编码红色)。
+
+---
+
+### Task 5: slide-13~16(脱敏红线 / Q&A×2 / 行动项)
+
+**Files:**
+- Create: `ppt-output/internal/slides/slide-13.html` ~ `slide-16.html`
+
+**Interfaces:**
+- Consumes: 同前 + slide-14/15 问答卡布局约定(Q 橙 accent-1 / A 深蓝底 card-bg-from,Q 与其 A 配对成卡)
+- Produces: 4 个 HTML,供 Task 6/7 使用
+
+- [ ] **Step 1: 生成 slide-13.html(沟通红线·脱敏与案例)**
+
+内容(S13):
+- 页标题: 沟通红线 ③ 脱敏与案例
+- 案例规则卡: 姓名→化名(小辰);日期→模糊("三个月前");学校/家庭住址→不提及
+- 截图规则卡: 敏感信息打码;截图须标注主要内容区域(红框/箭头)与英文术语中文翻译
+- 数据引用卡: 注明来源(如"A2 核心素养评估报告""浠艾福家庭健康报告")
+- ❌ 禁止卡: 使用非客户案例(名人/竞争对手);虚构或夸大成果数据
+- 视觉: 与 slide-11/12 同红线系(danger 强调);页脚 `13 / 16`
+
+- [ ] **Step 2: 生成 slide-14.html(常见问答·基础)**
+
+内容(S14)——四张问答卡(Q 橙 / A 深蓝底配对成卡):
+- **Q1 你们是做什么的?** A: 定位三句话(见 S2)
+- **Q2 测评和医院体检有什么区别?** A: 测评是素质能力/行为/菌群评估(主动健康·预警风险),非医疗诊断;医院体检查器质性病变;两者互补
+- **Q3 数据从哪来、可信吗?** A: DAN 测评体系 + 菌群检测,双培强基工程学术底座,4,423,014 份真实测评积累
+- **Q4 商业模式怎么赚钱?** A: 测评/会员/服务供应链三块收入 + 三边市场网络效应
+- 布局: 2×2 问答卡网格,但**禁止等宽等高排一行**——用主副节奏或交错;页脚 `14 / 16`
+
+- [ ] **Step 3: 生成 slide-15.html(常见问答·敏感)**
+
+内容(S15)——四张问答卡(同 S14 布局语言):
+- **Q5 你们和 XX 合作了吗?** A: "开放平台,正与多家伙伴洽谈生态共建,具体以官方披露为准"
+- **Q6 能保证效果吗?** A: "我们提供检测-干预-复测的循证闭环,效果以复测数据验证为准,不承诺疗效"
+- **Q7 用户数据隐私如何保障?** A: 脱敏存储、角色权限控制、微信生态合规(简述,不展开技术细节)
+- **Q8 和竞争对手差异?** A: 不贬低同行;讲"五维全景 + 家庭为单位 + 检测-干预闭环"的独特性
+- 视觉: 较 S14 更"敏感"——问答卡边框用 outline,顶部加"敏感问题·注意口径"提示条;页脚 `15 / 16`
+
+- [ ] **Step 4: 生成 slide-16.html(结尾·行动项)**
+
+内容(S16):
+- 页标题: 行动项 · 口径速查
+- 使用指引三卡: 对外沟通前先查本手册对应模块(话术查第二层/边界查第三层/疑问查第四层)
+- 口径速查条: 定位三句话(S2)+ 数据速查(S5)+ 红线三禁(不点名 · 不承诺 · 不夸大)——三禁用 danger 色圆点
+- 内部联系窗口卡: 数据口径→运营;合作口径→商务;内容合规→管理层
+- 落款: 浠艾福(Care Family)· 内部资料 · 2026-08
+- 页脚 `16 / 16`
+
+- [ ] **Step 5: 生成后自检(每页)**
+
+同前。
+
+---
+
+### Task 6: 预览生成器 + preview-internal.html
+
+**Files:**
+- Create: `ppt-output/runtime/gen_preview_internal.py`
+- Create: `ppt-output/internal/preview-internal.html`(由脚本生成)
+
+**Interfaces:**
+- Consumes: Task 2-5 的 16 个 HTML(校验存在性)
+- Produces: `preview-internal.html`(iframe src 引用 `slides/slide-{N}.html`,翻页工具栏 + 键盘 ←→ 导航)
+
+- [ ] **Step 1: 编写生成器**
+
+复制 `ppt-output/runtime/gen_preview16.py` 并修改:
+- 输出路径 → `ppt-output/internal/preview-internal.html`
+- SLIDES_DIR → `ppt-output/internal/slides`
+- `<title>` → `浠艾福 · 对外沟通统一口径(内部版 16 页)`
+- iframe `src="slides/slide-{N}.html"`(相对 internal/ 目录)
+- 底部 nav-hint → `← → 翻页 · 内部资料 · 统一口径`
+- 工具栏加"内部"角标样式(`background: rgba(239,68,68,0.15); color:#FCA5A5`)
+
+```python
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""生成 internal/preview-internal.html(16 页内部版预览,iframe src 引用)"""
+import os, html
+
+BASE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))  # ppt-output
+OUT = os.path.join(BASE, 'internal', 'preview-internal.html')
+SLIDES_DIR = os.path.join(BASE, 'internal', 'slides')
+
+SLIDES = [f'slide-{i}.html' for i in range(1, 17)]
+for s in SLIDES:
+    p = os.path.join(SLIDES_DIR, s)
+    if not os.path.exists(p):
+        raise SystemExit(f'缺少 {p}')
+
+# 骨架同 gen_preview16.py:toolbar + stage + iframe(src="slides/slide-{i}.html") + resize/show/nav 脚本
+# title: 浠艾福 · 对外沟通统一口径(内部版 16 页)
+# nav-hint: ← → 翻页 · 内部资料 · 统一口径
+# 工具栏右上角加红色系角标「内部 · 统一口径」
+```
+
+- [ ] **Step 2: 运行并验证**
+
+```bash
+python D:\workspace\cfc\ppt-output\runtime\gen_preview_internal.py
+```
+
+Expected: 输出 `已生成 ...preview-internal.html(16 页...)`;文件存在且含 16 个 iframe。
+
+- [ ] **Step 3: 打开预览确认可翻页**
+
+Chrome 打开 `file:///D:/workspace/cfc/ppt-output/internal/preview-internal.html`,确认第 1 页加载、Next/Prev 与键盘翻页正常(无需逐页截图,Task 7 做)。
+
+---
+
+### Task 7: 渲染验证 16 页 + 文档同步
+
+**Files:**
+- Modify: `docs/superpowers/PROJECT-OVERVIEW.md`
+- Modify: `docs/superpowers/specs/2026-08-07-xaf-internal-communication-design.md`(状态字段)
+
+- [ ] **Step 1: 逐页渲染截图验证(slide-1~16)**
+
+Chrome DevTools 逐页打开 `file:///D:/workspace/cfc/ppt-output/internal/slides/slide-{N}.html` 截图,用 look_at 检查:
+- 内容完整性:每页与设计文档信息卡逐条比对(关键数据:84,994 / 4,423,014 / 78 / 840 / 1.2 亿户 / 37-100 / 0.22% / 49%)
+- 无溢出/截断/重叠;截图正常(本版无大屏截图引用,除必要的装饰元素)
+- 内部角标 16 页全部可见;红线页(11-13)红色系生效;Q&A 页(14-15)Q 橙/A 深蓝配对正确
+- 截图偶发超时(MCP error -32001)时等待 8-15 秒重试
+
+- [ ] **Step 2: 失败修复**
+
+任一页失败 → 定位问题(溢出/数据/角标缺失)→ 用 `edit` 修正该页 → 重新截图验证。禁止批量重写通过的页面。
+
+- [ ] **Step 3: 更新 PROJECT-OVERVIEW.md**
+
+- specs 索引 `2026-08-07-xaf-internal-communication-design.md` → 状态 `✅ 已实施(内部版 16 页交付,对外沟通统一口径)`
+- plans 索引新增 `2026-08-07-xaf-internal-communication.md` → 状态 `✅ 已实施`
+- (参考行格式:`| 文件 | 状态 | 说明 |`)
+
+- [ ] **Step 4: 更新设计文档状态**
+
+`specs/2026-08-07-xaf-internal-communication-design.md` 头部 `- **状态**: 已确认(待实施)` → `- **状态**: 已实施(slide-1~16 全量交付,渲染验证通过)`
+
+---
+
+## Self-Review 记录
+
+- **Spec 覆盖**: S1~S16 信息卡 → Task 2(1-4) / Task 3(5-8) / Task 4(9-12) / Task 5(13-16) 一一对应;视觉规范(角标/红线系/Q&A 布局/文件隔离)→ Global Constraints + 各 Task Step;验收标准 1-5 → Task 6/7;验收标准 6-7 → Task 7 Step 3/4。无缺口。
+- **占位符**: 各 Task 内容为设计文档信息卡完整复制,无 TBD;Task 6 生成器给出脚本框架与必改点(路径/title/nav-hint/角标)。
+- **一致性**: 数据口径全局统一(84,994/4,423,014/78/840/1.2 亿/37-100/0.22%/49%);文件路径 `ppt-output/internal/` 全计划一致;角标文案「内部 · 统一口径」一致;页脚格式 `内部·统一口径 | NN / 16` 一致。

+ 165 - 0
docs/superpowers/plans/2026-08-07-xaf-partner-ppt-implementation.md

@@ -0,0 +1,165 @@
+# 浠艾福合作伙伴版 PPT 实施计划
+
+- **日期**: 2026-08-07
+- **状态**: in_progress
+- **设计文档**: `specs/2026-08-07-xaf-partner-ppt-redesign-design.md`(已确认)
+- **前置版本**: `ppt-output/runtime/outline-partner.json`(19 页,已废弃)
+
+## 1. 目标
+
+将已确认的 16 页设计文档落地为 `ppt-output/slides/slide-1.html` ~ `slide-16.html`,
+继承现有生成管线(`runtime/html-spec.md` + `style.json` + 现有 slide 视觉组件),
+并组装 16 页预览页。数据大屏截图(screen/02-06)为主要视觉素材。
+
+## 2. 任务分解
+
+| # | 任务 | 产出 | 验收 |
+|---|------|------|------|
+| 1 | 截图就位 | `ppt-output/images/screen-02.png` ~ `screen-06.png` | 5 张文件存在,可被 `<img>` 引用 |
+| 2 | Agent A: P1-P4 | `slide-1.html` ~ `slide-4.html` | 封面/目录/困境上/困境下 |
+| 3 | Agent B: P5-P8 | `slide-5.html` ~ `slide-8.html` | 身份/底座/成果/DAN(含截图) |
+| 4 | Agent C: P9-P12 | `slide-9.html` ~ `slide-12.html` | 理念演进/四维五维/平台全景/菌群 |
+| 5 | Agent D: P13-P16 | `slide-13.html` ~ `slide-16.html` | 壁垒/案例/价值未来/合作(P15 密度控制) |
+| 6 | 预览组装 | `ppt-output/preview-partner.html`(新版 16 页) | 16 个 iframe 顺序排列,可翻页 |
+| 7 | 渲染验证 | 截图检查每页 | 无溢出、无缺失图、符合 html-spec 红线 |
+
+## 3. 页面信息卡(供 Agent 使用)
+
+### P1 封面
+- 主标题: 让每个家庭的健康,都被提前看见
+- 副题: 从家庭健康困境到主动健康闭环
+- 署名: 双培强基工程 · 工程品牌"中科心知"
+- 视觉: 科技蓝+暖橙家庭感,五维色系点缀,封面页自由发挥
+
+### P2 目录
+- 五部分: ① 家庭健康困境 ② 我们是谁 ③ 我们干了什么 ④ 现在正在干什么 ⑤ 为什么是我们 ⑥ 未来与合作
+- 注: 设计文档中"五部分"实际列了 6 个(困境/我们是谁/我们干了什么/现在正在干什么/为什么是我们/未来与合作),按 6 项呈现
+
+### P3 家庭健康困境(上)— 三大困境 + 三代人焦虑
+- 三大困境: 信息碎片化 / 干预滞后 / 执行断层——"知道却做不到"
+- 孩子: 最关注学业表现、情绪状态、体质健康;焦虑: 成绩压力、注意力不集中、过敏/肥胖/睡眠
+- 成人: 最关注工作压力、家庭关系、自身健康;焦虑: 职业焦虑、育儿焦虑、睡眠不足、体检异常指标
+- 老人: 最关注慢病管理、生活自理、子女陪伴;焦虑: 慢病失控、孤独感、代际隔阂
+- 心理视角核心理念: "一个家庭如果孩子有问题,一定是病的最轻的那个"——孩子只是家庭的产品,通过产品质量验证生产环境(家庭系统)是否合格;进而思考生产环境如何调整
+- 引出: 全家都需要"有人懂、有人管、有人陪"——这就是主动健康的入口
+
+### P4 家庭健康困境(下)— 数据佐证
+- 焦虑检出 48.95%(轻度 23.37%、中度 18.64%、重度 6.54%)(screen/06)
+- 抑郁检出 34.14%(轻度 15.80%、中度 11.64%、重度 0.11%)(screen/06)
+- 青少年超重 8.47% + 肥胖 9.17%(screen/02)
+- 挑食率 59.3%(中国学龄儿童,素材库)
+- 儿童睡眠障碍 37.6%、睡眠不足 42.75%(素材库)
+- 出处: screen/02、screen/06 截图 + 权威报告素材
+
+### P5 我们是谁
+- 双培强基工程: 人民日报《人民周刊》+ 中国科学院心理研究所联合发起
+- 理念: "培育心智、培养志向"
+- 工程品牌"中科心知": 工程对外的学术权威品牌
+- 学术带头人: 魏高峡、施建农、张挽时等核心专家
+- 工程成果载体: DAN 素质能力测评体系
+
+### P6 工程底座(主视觉: screen/02 截图)
+- 智能体: 多智能体协同(分析 Agent / 对话 Agent / 意图识别 / 多模态 / 报告解析)
+- 知识库: 菌群营养知识库 / 报告指标知识库 / 统一知识库服务
+- 截图要点: 认知能力雷达、情绪健康检出率(抑郁 32%/焦虑 46%/自卑 43%/无助 26%)、大五人格画像、亲子关系、青少年肥胖率
+- 安全体系: JWT 认证 + 角色权限 + 敏感字段加密(一句话点到)
+- 工程规模: 15 大模块生产运行(点到为止,不堆砌数字)
+
+### P7 双培强基成果(主视觉: screen/03 截图)
+- 核心 KPI: 78 城市 · 840 指导师 · 84,994 用户 · 4,423,014 份测评
+- 补充: 年龄分布(7-9 岁 24%、10-12 岁 35%、13-15 岁 28%)、测评包分布(A2 55%、A1 15%、B3 12%、B4 9%、B6 9%)、区域(北京 40,913 / 广东 35,958)
+- 一句话: 真实运营规模持续沉淀行为数据
+
+### P8 DAN 测评体系(screen/04/05/06 三张截图)
+- 六维认知: 推理 74.57% / 记忆力 84.89% / 空间 79.88% / 注意力 84.9% / 感知 76.1% / 加工速度 77.96%
+- 拔尖识别: 20,900 人、占比 24.59%(≥120 分)
+- 大五人格 + 自驱力 + 自我概念
+- 心理健康五大维度: 学业压力/人际问题/人格/自我认知/生活习惯
+- 定位: 有模型、有算法、有数据的测评底座
+
+### P9 健康理念演进
+- 理念演进: 治病(被动医疗)→ 治未病(预防)→ 主动健康(预测/预知)
+- 核心论点: 主动健康的难点是预测/预知——不是等指标异常才干预,而是提前预知风险、提前干预
+- 我们做的就是主动健康: 检测 → AI 分析预知风险 → 个性化干预 → 执行 → 复测迭代
+- 为什么强化身维度: 身是健康底座;菌群/营养/睡眠影响认知、情绪、精力;身维度数据是预知能力的入口;身维度已建成全年龄段测评能力
+- 呼应 P3 三代人焦虑
+
+### P10 从四维到五维
+- DAN 体系原为四维(身/心/智/行)
+- 为什么补富: 家庭幸福不只是健康与成长——经济安全感是幸福底座之一;缺"富"则家庭方案不完整
+- 五行相生: 身→智→富→行→心→身;相克: 身克富、智克行、富克心、行克身、心克智
+- 五维动态平衡: 相生让系统前进,相克让系统不翻车
+- 富维度含义: 利他创富——低门槛创客成长生态,家庭"第二收入曲线"
+- 落点: 四维补富 → 五维全景幸福矩阵
+
+### P11 五维平台全景
+- 四端: 家长端(管理/测评/任务/看板/AI 教练)、孩子端(任务/小游戏/打卡/心愿)、规划师/供应商端(套餐/结果/商品)、管理端(审核/配置/数据)
+- 五环节闭环: 检测 → AI 分析 → 个性化方案 → 行为执行 → 复测迭代(数据飞轮)
+- 五维色系: 身 #FF8C42(橙)· 心 #FF6B9D(粉)· 智 #6366F1(蓝)· 行 #10B981(绿)· 富 #F59E0B(金)
+- 商业模式骨架: 三边市场(家庭/规划师/供应商)
+
+### P12 菌群检测 + AI 健康教练
+- 菌群检测: 居家采样 → 135 页专业报告 → AI 解析压缩为 3 页行动方案
+- 真实数据点: 健康总分 73(均值 75)、菌群健康 53 偏低、检出菌种 313 种(均值约 800)
+- AI 自动标注: 维生素 B12(14 分)→ 疲劳/贫血风险;苏氨酸(14 分)→ 肠道屏障受损;丙氨酸(9 分)→ 能量代谢异常
+- AI 健康教练: 7×24 智能应答 + 家庭 360° 上下文 + 后台专业团队人机协同兜底
+- 效果: 替代"跑医院、找专家、花数千元"的传统路径
+
+### P13 三重壁垒
+- 学术壁垒: 中科院心理研究所背书、双培强基工程"国家队"级底座、学术带头人团队
+- 技术壁垒: 五维溯源算法、多智能体协同、RAG 知识库、AI 报告解析引擎
+- 数据护城河: 442 万份真实测评 + 行为数据持续积累(脱敏)、长周期不可复制
+- 一句话: 模型 × 算法 × 数据 = 平台护城河
+
+### P14 真实案例 — 小辰(化名)
+- 背景: 11 岁男孩,家长因注意力问题寻求帮助
+- 检测发现: 菌群平衡 37/100、双歧杆菌 0.22%(正常≥5%)、注意力百分位 49% 唯一短板
+- 洞察: "大脑硬件没问题,是运行环境出了问题"——身维度问题影响智维度表现
+- 干预闭环: 菌群溯源 → 精准调理 → 复测对比
+- 价值: 展示"检测→预知→干预→验证"闭环的真实疗效,身智联动
+- 数据原则: 案例匿名、脱敏、注明"浠艾福家庭健康报告"
+
+### P15 平台价值与未来(密度控制,保持 16 页)
+- 平台价值: 对家庭(一站式主动健康闭环)、对伙伴(获客入口 + 复购引擎 + 数据资产)、对生态(开放平台)
+- 洞(测评覆盖):
+  - 已建成(强): 身维度全年龄段测评;孩子的身/心/智/行测评
+  - 引入中: 成人/老人的心、行测评——已引入北京积极心理学会(心)、中国抗衰促进会(行)部分资源,接入体系化中
+  - 待补齐(洞): 成人/老人的智、富维度测评;富维度体系化
+  - 引申: 洞 = 未来的扩展空间 + 合作切入点(伙伴可参与共建)
+- 未来要干什么:
+  - 测评扩展: 补齐全年龄段全维度测评矩阵
+  - 具身智能: AI 健康教练从"对话框"走进"生活场"
+  - 技术演进路径: 单点 AI(当前)→ 家庭数字孪生 → 具身智能×穿戴 → 开放生态(2029)
+  - 具身载体: 陪伴机器人 / 炒菜机器人 / 智能眼镜 / 手环 / 耳机(简洁呈现)
+
+### P16 通用合作邀请
+- 开放平台/生态共建: 产品接入 / 联合运营 / 资本合作(三档递进,不点名具体企业)
+- 平台资产: 触达 1.2 亿户目标家庭(3 年渗透目标家庭池 <1%)
+- 行动号召: 以 1-2 款产品试点接入,30 天内跑通"检测→推荐→复购"最小闭环
+- 落款: 双培强基工程 · 中科心知 · 浠艾福(Care Family)
+
+## 4. 视觉与管线约束(所有 Agent 必读)
+
+- 必读文件: `ppt-output/runtime/html-spec.md`(管线红线)、`ppt-output/style.json`(风格变量)、参考 `ppt-output/slides/slide-19.html` / `slide-26.html`(组件范例)
+- body 1280×720 overflow:hidden,禁止 scale hack;CSS 内联;颜色走 CSS 变量
+- 禁止动画、伪元素装饰、background-image 放图、SVG 内 <text>
+- 每页 ≥2 种 card 变体,accent/elevated 各 ≤1;data 卡片超级数字 ≥64px;数字 tabular-nums
+- 每个内容卡根节点 `data-card-id="c1"...`;装饰节点 `data-decoration-layer` + aria-hidden
+- 截图引用: `<img src="../images/screen-02.png">` 等;截图为大尺寸图,用 overflow:hidden 容器 + object-fit 裁剪,勿撑爆画布
+- 页脚页码 NN / 16;overline 用 PART 0X 章节名
+- 语言: 中文为主,专有名词中英混排;数据标注出处
+
+## 5. 验证步骤
+
+1. 16 个 HTML 文件存在于 `ppt-output/slides/`
+2. 浏览器逐页截图:无文字溢出、无图片缺失(broken img)、无横向滚动
+3. 对账: 每页 card 有 data-card-id;装饰有 data-decoration-layer
+4. preview-partner.html 可翻页浏览 16 页
+5. 确认 P15 未超载(保持 16 页)
+
+## 6. 完成标准
+
+- [ ] slide-1~16.html 全部生成且通过渲染验证
+- [ ] preview-partner.html 16 页可翻页
+- [ ] PROJECT-OVERVIEW.md 同步更新
+- [ ] 设计文档状态更新为"已实施"

+ 175 - 0
docs/superpowers/specs/2026-08-07-xaf-internal-communication-design.md

@@ -0,0 +1,175 @@
+# 浠艾福 对外沟通·统一口径(内部版)PPT 设计
+
+- **日期**: 2026-08-07
+- **状态**: 已实施
+- **前置版本**: 无(全新内部版;素材取自 `ppt-output/slides/slide-1~16.html` 合作伙伴版 + PROJECT-OVERVIEW + README 已确认事实)
+- **关联外部版**: `specs/2026-08-07-xaf-partner-ppt-redesign-design.md`(16 页问题驱动式,已实施)
+
+## 1. 背景与目标
+
+刚交付的外部合作伙伴版 16 页 PPT 面向商业合作伙伴(说服、促成合作),论证式叙事。但对外沟通不只是商务一个角色——市场、运营、管理层都可能与伙伴/客户/投资人接触。为避免"十个团队十套说法",需要一份**内部统一口径手册**:
+
+- **受众**: 对外相关团队(商务 / 市场 / 运营 / 管理层)
+- **目的**: 战略对齐·统一口径——对外沟通前团队达成共识,对外对内一套话术
+- **场景**: 宣讲一次(30-45 分钟培训)+ 之后沉淀为对外沟通标准参考(每页自包含,可随时查阅)
+- **核心差异**: 外部版回答"为什么选我们"(论证);内部版回答"对外怎么说 + 什么不能说"(口径与边界)
+- **页数**: 16 页(与外部版同规模,内容完全独立)
+
+## 2. 已确认决策记录
+
+| # | 决策 | 结论 |
+|---|------|------|
+| 1 | 核心目的 | 战略对齐·统一口径(非进展同步、非外部版预演评审) |
+| 2 | 受众 | 仅对外相关团队(商务/市场/运营/管理层),不含全员 |
+| 3 | 使用场景 | 宣讲一次 + 沉淀为对外沟通标准参考(手册化) |
+| 4 | 内容结构 | 方案 A:四层作战手册(一句话共识 → 标准话术 → 沟通红线 → 常见问答) |
+| 5 | 身份口径 | 与外部版一致:双培强基工程 + 中科心知 + 浠艾福(统一口径的意义) |
+| 6 | 数据口径 | 对外只讲 S5 组脱敏数据(78 城市/840/84,994/4,423,014);内部指标(收入/漏斗/成本)进红线 |
+| 7 | 合作口径 | 未签约合作方不点名(如广药康美);统一"开放平台、洽谈中不透露" |
+| 8 | 医学表述边界 | "肠漏"→"肠道屏障功能受损(潜在通路)";测评非医疗诊断;不承诺疗效 |
+| 9 | 文件隔离 | 内部版独立目录 `ppt-output/internal/`,不覆盖外部版 slide-1~16 |
+| 10 | 视觉 | 沿用外部版管线与设计 Token;新增"内部·统一口径"角标区分内外;红线页用红色系强调 |
+
+## 3. 页面地图(16 页)
+
+```
+第一部分 一句话共识(3 页): S1 封面 → S2 定位三句话 → S3 五维平台一页看懂
+第二部分 标准话术(7 页): S4 身份 → S5 成果 → S6 平台 → S7 检测 → S8 案例 → S9 合作 → S10 理念
+第三部分 沟通红线(3 页): S11 数据与业绩 → S12 合作与合规 → S13 脱敏与案例
+第四部分 常见问答(2 页): S14 Q&A 基础 → S15 Q&A 敏感
+结尾(1 页): S16 行动项·口径速查
+```
+
+## 4. 各页信息卡
+
+### S1 封面
+- **主标题**: 对外沟通 · 统一口径
+- **副标题**: 让每个家庭的健康,都被提前看见
+- **标注**: 内部培训资料 · 面向对外相关团队(商务/市场/运营/管理层)
+- **落款**: 浠艾福(Care Family)· 2026
+- **目标**: 开场定调——今天讲的是"对外怎么说",不是产品发布
+
+### S2 定位三句话
+- **标准表述(必须一致,任何对外场景的开场)**:
+  1. 我们是谁:双培强基工程(人民日报《人民周刊》+ 中国科学院心理研究所联合发起)旗下工程品牌"中科心知",落地家庭健康服务平台"浠艾福(Care Family)"
+  2. 我们解决什么:让家庭健康从"被动等待"走向"主动掌握"——提前预知风险、提前干预
+  3. 我们怎么做:以五维体系(身·智·富·行·心)为框架,以"检测 → AI 分析 → 个性化方案 → 行为执行 → 复测迭代"闭环为载体
+- **讲解要点**: 三句话是电梯陈述,要求团队背下来;对任何人(伙伴/客户/投资人)开场一致
+
+### S3 五维平台一页看懂
+- **五维色环**: 身(主动健康)#FF8C42 / 心(大爱相随)#FF6B9D / 智(赋能未来)#6366F1 / 行(人际和谐)#10B981 / 富(利他创富)#F59E0B
+- **四端**: 家长端(决策与付费)/ 孩子端(行为落地)/ 规划师·供应商端(服务供给)/ 管理端(运营中枢)
+- **三边市场骨架**: 家庭 ← 规划师 ← 供应商(数据/服务/产品三边协同)
+- **讲解要点**: 这是"平台是什么"的标准图;任何对外介绍从这张图开始,不展开技术细节
+
+### S4 身份话术
+- **标准表述**: 双培强基工程——人民日报《人民周刊》与中国科学院心理研究所联合发起的青少年成长素养培育工程;工程品牌"中科心知"承载测评体系;浠艾福(Care Family)是工程成果的市场化落地平台
+- **关键数据**: 学术带头人——魏高峡(核心专家/学术指导)、施建农(核心专家/体系构建)、张挽时(核心专家/临床实践)
+- **讲解要点/口径**: 身份层级固定为"工程 → 品牌 → 平台";只表述"联合发起/学术指导",不夸大隶属关系;不单独强调某位专家个人(团队整体背书)
+
+### S5 成果话术
+- **标准表述**: 覆盖 78 个城市、认证成长规划师 840 位、注册用户 84,994 人、累计完成 4,423,014 份测评
+- **辅助数据(可选引用)**: 年龄分布 10-12 岁占 35%、测评包 A2 占 55%、区域分布北部 40,913 / 广东 35,958(源自运营大屏)
+- **讲解要点/口径**: 这组数据是当前对外公开口径(2026-08 时点);数据更新以运营确认为准(S11);内部指标不在此页
+
+### S6 平台话术
+- **标准表述**: DAN 素质能力测评体系——"有模型、有算法、有数据"
+  - 有模型:A2 六维认知(感知觉/注意力/记忆力/推理/空间/加工速度)+ 大五人格
+  - 有算法:135 页报告 → 3 页行动方案(AI 报告解析引擎)
+  - 有数据:4,423,014 份真实测评积累,数据飞轮驱动模型迭代
+- **五环节闭环**: 检测 → AI 分析 → 个性化方案 → 行为执行 → 复测迭代
+- **讲解要点**: 把"技术底座"翻译成对外价值语言——任何产品/服务接入,都建立在同一套可量化、可验证的测评底座上
+
+### S7 检测话术
+- **标准表述**: 居家采样 → 135 页专业报告 → AI 压缩为 3 页行动方案
+- **真实数据点**: 健康总分 73(均值 75)/ 菌群健康 53(偏低·重点调理)/ 检出菌种 313 种(均值约 800)
+- **AI 自动标注**: 维生素 B12 / 苏氨酸 / 丙氨酸("数据→方案"自动化的证据)
+- **AI 健康教练**: 7×24 智能应答 + 家庭 360° 上下文
+- **讲解要点**: 强调"检测不是终点,干预 + 复测才是闭环"
+
+### S8 案例话术
+- **标准表述**: 真实案例·小辰(化名)——11 岁男孩,注意力问题
+  - 检测:菌群平衡 37/100、双歧杆菌 0.22%(正常 ≥5%)、注意力 49%
+  - 洞察:"大脑硬件没问题,是运行环境出了问题"
+  - 干预闭环:菌群溯源 → 精准调理 → 复测对比
+- **数据原则**: 匿名处理,数据来源标注"浠艾福家庭健康报告"
+- **讲解要点**: 案例是转化利器,但必须按 S13 脱敏规则讲;禁止使用非客户案例
+
+### S9 合作话术
+- **标准表述**: 开放平台 · 生态共建
+- **三档合作框架**:
+  1. 产品接入:1-2 款产品试点,30 天内跑通"检测 → 推荐 → 复购"最小闭环
+  2. 联合运营:共建健康包(检测+产品+复测),双方分成
+  3. 资本合作:数据资产与客户池价值开放,共享平台增长红利
+- **目标家庭池**: 1.2 亿户
+- **讲解要点/口径**: 对外不点名具体企业(洽谈中不透露,见 S12);表述为"面向所有潜在合作伙伴的通用框架"
+
+### S10 理念话术
+- **标准表述**: 主动健康 = 预测/预知——不是等指标异常了才干预,而是提前预知风险、提前干预
+- **五维全景幸福矩阵**: 身·智·富·行·心;四维补富 → 五维全景;富维度表述为"经济安全感是幸福底座之一"
+- **五行动态平衡**: 相生(身→智→富→行→心→身);相克(身克富/智克行/富克心/行克身/心克智)
+- **讲解要点**: 用于"为什么是五维"的解释场景;五行关系点到为止,不展开哲学细节
+
+### S11 沟通红线·数据与业绩
+- **❌ 不外传**: 转化漏斗、收入/成本/毛利、付费率等内部运营数据;未脱敏原始用户数据与单用户画像明细
+- **⚠️ 测算口径**: "单用户年收入 1 万元 × 用户规模"等测算值,必须标注"测算值,不构成业绩承诺"
+- **⚠️ 数据时效**: 对外数据(S5)更新以运营最新确认为准,禁止用过期数据
+- **✅ 可讲**: 对外公开的运营大屏数据、已发布报告引用(注明出处)
+
+### S12 沟通红线·合作与合规
+- **❌ 不点名未签约合作方**(如广药康美)——统一"开放平台、洽谈中不透露"
+- **❌ 不承诺疗效/诊断**: "肠漏"表述改为"肠道屏障功能受损(潜在通路)";测评结果非医疗诊断;健康建议不替代医嘱
+- **❌ 不夸大学术关系**: 只说"联合发起/学术指导",不虚构隶属
+- **⚠️ 外部数据引用注明出处**(如《中国居民营养与慢性病状况报告 2020》)
+- **✅ 合规基础**: 团体标准 T/CS 004-2025《体重管理产品质量要求》可作产品合规依据引用
+
+### S13 沟通红线·脱敏与案例
+- **案例规则**: 姓名→化名(小辰);日期→模糊("三个月前");学校/家庭住址→不提及
+- **截图规则**: 敏感信息打码;截图须标注主要内容区域(红框/箭头)与英文术语中文翻译
+- **数据引用**: 注明来源(如"A2 核心素养评估报告""浠艾福家庭健康报告")
+- **❌ 禁止**: 使用非客户案例(名人/竞争对手);虚构或夸大成果数据
+
+### S14 常见问答·基础(每问 = 问题 + 标准回答要点)
+- **Q1 你们是做什么的?** → 定位三句话(S2)
+- **Q2 测评和医院体检有什么区别?** → 测评是素质能力/行为/菌群评估(主动健康·预警风险),非医疗诊断;医院体检查器质性病变;两者互补
+- **Q3 数据从哪来、可信吗?** → DAN 测评体系 + 菌群检测,双培强基工程学术底座,4,423,014 份真实测评积累
+- **Q4 商业模式怎么赚钱?** → 测评/会员/服务供应链三块收入 + 三边市场网络效应
+
+### S15 常见问答·敏感
+- **Q5 你们和 XX 合作了吗?** → "开放平台,正与多家伙伴洽谈生态共建,具体以官方披露为准"
+- **Q6 能保证效果吗?** → "我们提供检测-干预-复测的循证闭环,效果以复测数据验证为准,不承诺疗效"
+- **Q7 用户数据隐私如何保障?** → 脱敏存储、角色权限控制、微信生态合规(简述,不展开技术细节)
+- **Q8 和竞争对手差异?** → 不贬低同行;讲"五维全景 + 家庭为单位 + 检测-干预闭环"的独特性
+
+### S16 结尾·行动项
+- **对外沟通前**: 先查本手册对应模块(话术查第二层、边界查第三层、疑问查第四层)
+- **口径速查**: 定位三句话(S2)+ 数据速查(S5)+ 红线三禁(不点名·不承诺·不夸大)
+- **内部联系窗口**: 数据口径→运营;合作口径→商务;内容合规→管理层
+- **落款**: 浠艾福(Care Family)· 内部资料 · 2026-08
+
+## 5. 视觉规范
+
+- **沿用外部版管线红线**(`ppt-output/runtime/html-spec.md`): `width:1280px; height:720px; overflow:hidden`、禁止动画、禁止伪元素装饰、禁止 background-image 放图、SVG 内 `<text>`、conic-gradient、渐变文字、全部颜色走 CSS 变量、禁止硬编码色值
+- **设计 Token 同源**: 技术蓝 `#0A1A2F` + 暖橙 `#FF8C42` + 五维色系(身#FF8C42 心#FF6B9D 智#6366F1 行#10B981 富#F59E0B)
+- **新增区分元素**:
+  - 每页右上角固定角标"内部 · 统一口径"(半透明胶囊,区分内外)
+  - 第三部分红线页(S11-S13)以红色系强调(警示图标 + 边框色 `#EF4444` 系),❌/⚠️/✅ 语义色
+  - 第四部分 Q&A 页(S14-S15)用问答卡布局(Q 橙色 / A 深蓝底)
+- **文件隔离**: 独立目录 `ppt-output/internal/slides/slide-1~16.html`(不覆盖外部版 `ppt-output/slides/`);预览页 `ppt-output/internal/preview-internal.html`(iframe src 引用,由生成脚本产出)
+- **页脚**: "内部·统一口径 | NN / 16"
+
+## 6. 内容来源与口径约束
+
+- 所有事实性内容取自已确认素材:16 页合作伙伴版(S4-S10 的数据/身份/案例/合作框架)、PROJECT-OVERVIEW、README、运营大屏截图(screen-02~06)
+- **不新增未确认事实**;不确定的数据一律归入红线("以运营确认为准")
+- 红线规则由外部版设计决策提炼:决策 7(收入测算口径)、决策 9(合作不点名)、决策 11(心理视角表述),另补充通用合规/脱敏规则
+
+## 7. 验收标准
+
+1. 16 页全部生成于 `ppt-output/internal/slides/`,渲染验证无溢出/截断/重叠
+2. 每页包含对应信息卡的全部"标准表述"内容;数据与外部版一致(84,994 用户、4,423,014 份测评等)
+3. 红线三页完整覆盖:数据业绩(S11)/ 合作合规(S12)/ 脱敏案例(S13),❌⚠️✅ 语义清晰
+4. Q&A 两页覆盖 8 个标准问题,每问含标准回答要点
+5. 内部角标在全部页面可见;红线页红色系强调生效;与外部版视觉可区分
+6. `preview-internal.html` 可完整浏览 16 页
+7. PROJECT-OVERVIEW.md 同步更新(specs 索引 + 状态)

+ 241 - 0
docs/superpowers/specs/2026-08-07-xaf-partner-ppt-redesign-design.md

@@ -0,0 +1,241 @@
+# 浠艾福合作伙伴版 PPT 重构设计
+
+- **日期**: 2026-08-07
+- **状态**: 已实施(slide-1~16 全量交付,渲染验证通过;2026-08-08 扩为 18 页后同日收敛回 16 页:P9 重做"什么是主动健康"、P10 菌群报告→身维度、P11 富维度、P12 平台全景(原 P11+P14 合并)、P13 135 页→3 页行动方案、P14 三重壁垒(乱码修复)、P15 真实案例(报告截图说明)、P16 开放平台;删除原 P17)
+- **前置版本**: `ppt-output/runtime/outline-partner.json`(19 页合作版,将废弃)
+
+## 1. 背景与目标
+
+现有合作伙伴版 PPT(outline-partner.json,19 页)叙事为"机会→科普→痛点→平台→粘性→合作",
+已无法满足当前对外展示需求。本次**完全重做**,采用"问题驱动式"叙事:
+
+**封面 → 家庭健康困境 → 我们是谁 → 我们干了什么 → 现在正在干什么 → 为什么是我们 → 未来与合作**
+
+- **受众**: 商业合作伙伴(广药康美等)
+- **目标行动**: 促成通用合作意向(开放平台、生态共建),不点名具体企业
+- **页数**: 16 页(含封面/目录;2026-08-08 扩为 18 页后收敛回 16 页)
+- **内容策略**: 完全重做;现有素材只取精华作证据;数据大屏截图+简单说明为主视觉
+- **身份锚点**: 双培强基工程 + 工程品牌"中科心知"(学术权威性)
+
+## 2. 已确认决策记录
+
+| # | 决策 | 结论 |
+|---|------|------|
+| 1 | 目标受众 | 商业合作伙伴(康美等),方向延续 |
+| 2 | 内容取舍 | 完全重做,页数精简(16 页) |
+| 3 | 身份主角 | 双培强基工程 + 中科心知(工程品牌名,与中科院心理所强绑定) |
+| 4 | 结尾定位 | 通用合作邀请(不点名康美,面向所有潜在合作伙伴) |
+| 5 | 结构方案 | 方案 C:问题驱动式 |
+| 6 | 工程表述 | "控制器"→"智能体"、"实体"→"知识库" |
+| 7 | 收入预测口径 | 单用户年收入 1 万元 × 用户规模(测算值,不构成业绩承诺) |
+| 8 | 第9页补充 | 主动健康的难点是**预测/预知**,必须表达 |
+| 9 | 第15页"洞" | 测评覆盖的洞:强在身维度全年龄段 + 孩子的心/智/行;成人/老人的心/行测评**已引入外部资源**(北京积极心理学会、中国抗衰促进会)但仍未体系化整合;成人/老人的智/富维度、富维度体系化仍是洞 |
+| 10 | 封面主标题 | A. 让每个家庭的健康,都被提前看见 |
+| 11 | P3 核心理念 | 心理视角:"一个家庭如果孩子有问题,一定是病的最轻的那个"——孩子只是家庭的产品,通过产品质量验证生产环境是否合格,进而思考生产环境如何调整 |
+
+## 3. 叙事结构与页面地图(16 页)
+
+### 叙事骨架
+
+```
+困境(2页) → 身份(2页) → 成果(2页) → 测评(1页) → 理念演进(2页) → 平台(2页) → 菌群报告价值(2页) → 壁垒(2页) → 未来(2页) → 合作(1页)
+```
+
+### 页面地图(16 页,2026-08-08 收敛版)
+
+| 页 | 标题 | PART |
+|----|------|------|
+| P1 | 封面 | — |
+| P2 | 目录 | 00 |
+| P3-P4 | 家庭健康困境 | 01 |
+| P5-P6 | 我们是谁 | 02 |
+| P7-P8 | 我们干了什么 | 03 |
+| P9 | 什么是主动健康(WHO + 健康中国 2030 定义 + 政策截图 + 难点) | 04 |
+| P10 | 为什么强化"身"维度(菌群报告→家庭价值) | 04 |
+| P11 | 为什么补上"富"维度(幸福与金钱无关,有关系的是财富观) | 04 |
+| P12 | 五维平台全景(四端协同 · 四维画像 · 价值闭环,原 P11+P14 合并) | 04 |
+| P13 | 从 135 页报告到 3 页行动方案 | 04 |
+| P14 | 三重壁垒 | 05 |
+| P15 | 真实案例(报告截图说明) | 05 |
+| P16 | 开放平台 · 生态共建 | 06 |
+
+### 页面明细
+
+#### P1 封面
+- 主标题: **A. 让每个家庭的健康,都被提前看见**
+- 副题: 从家庭健康困境到主动健康闭环
+- 署名: 双培强基工程 · 工程品牌"中科心知"
+- 视觉: 科技蓝+暖橙家庭感,五维色系点缀
+
+#### P2 目录
+- 五部分导航:困境 → 我们是谁 → 我们干了什么 → 现在正在干什么 → 为什么是我们 → 未来与合作
+
+#### P3 家庭健康困境(上)— 三大困境 + 三代人焦虑
+- **三大困境**: 信息碎片化 / 干预滞后 / 执行断层——"知道却做不到"
+- **孩子**: 最关注学业表现、情绪状态、体质健康;焦虑来源:成绩压力、注意力不集中、过敏/肥胖/睡眠
+- **成人**: 最关注工作压力、家庭关系、自身健康;焦虑来源:职业焦虑、育儿焦虑、睡眠不足、体检异常指标
+- **老人**: 最关注慢病管理、生活自理、子女陪伴;焦虑来源:慢病失控、孤独感、代际隔阂
+- **心理视角核心理念**: "一个家庭如果孩子有问题,一定是病的最轻的那个"——孩子只是家庭的产品,通过产品质量验证生产环境(家庭系统)是否合格;进而思考:生产环境如何调整
+- 引出: 全家都需要"有人懂、有人管、有人陪"——这就是主动健康的入口
+
+#### P4 家庭健康困境(下)— 数据佐证
+- 焦虑检出 48.95%(含轻度 23.37%、中度 18.64%、重度 6.54%)(screen/06 心理健康大屏)
+- 抑郁检出 34.14%(轻度 15.80%、中度 11.64%、重度 0.11%)(screen/06)
+- 青少年超重 8.47% + 肥胖 9.17%(screen/02 青少年肥胖率)
+- 挑食率 59.3%(中国学龄儿童,素材库)
+- 儿童睡眠障碍 37.6%、睡眠不足 42.75%(素材库)
+- 数据出处: screen/02、screen/06 截图 + 权威报告素材
+
+#### P5 我们是谁 — 双培强基工程 + 中科心知
+- 双培强基工程: 人民日报《人民周刊》+ 中国科学院心理研究所联合发起
+- 理念: "培育心智、培养志向"
+- 工程品牌"中科心知": 工程对外的学术权威品牌
+- 学术带头人: 魏高峡、施建农、张挽时等核心专家
+- 工程成果载体: DAN 素质能力测评体系
+
+#### P6 工程底座 — 智能体 + 知识库(screen/02 截图)
+- 主视觉: **screen/02 数智心理教练智慧平台数据中心大屏截图**
+- **智能体**: 多智能体协同(分析 Agent / 对话 Agent / 意图识别 / 多模态 / 报告解析)
+- **知识库**: 菌群营养知识库 / 报告指标知识库 / 统一知识库服务
+- 截图要点: 认知能力雷达、情绪健康检出率(抑郁 32%/焦虑 46%/自卑 43%/无助 26%)、大五人格画像、亲子关系、青少年肥胖率
+- 安全体系: JWT 认证 + 角色权限 + 敏感字段加密(一句话点到)
+- 工程规模: 15 大模块生产运行(点到为止,不堆砌 48/47 等数字)
+
+#### P7 双培强基成果 — 运营数据总览(screen/03 截图)
+- 主视觉: **screen/03 数据大屏截图**(简单说明文字叠加)
+- 核心 KPI: 78 城市 · 840 指导师 · 84,994 用户 · 4,423,014 份测评(2026-08 真实数据)
+- 补充信息(从截图中提取): 年龄分布(7-9 岁 24%、10-12 岁 35%、13-15 岁 28%)、测评包分布(A2 55%、A1 15%、B3 12%、B4 9%、B6 9%)、区域分布(北京 40,913 / 广东 35,958 等)
+- 一句话: 真实运营规模持续沉淀行为数据
+
+#### P8 DAN 测评体系(screen/04/05/06 三张截图)
+- 主视觉: **screen/04 拔尖创新数据统计 + screen/05 多元评价与个性化培养 + screen/06 心理健康数据统计**
+- 核心内容:
+  - 六维认知: 推理 74.57% / 记忆力 84.89% / 空间 79.88% / 注意力 84.9% / 感知 76.1% / 加工速度 77.96%(screen/04)
+  - 拔尖人才识别: 拔尖人数 20,900 人、占比 24.59%(≥120 分)(screen/04)
+  - 大五人格 + 自驱力 + 自我概念(screen/04/05)
+  - 心理健康五大维度: 学业压力/人际问题/人格/自我认知/生活习惯(screen/06)
+- 定位: 有模型、有算法、有数据的测评底座
+
+#### P9 什么是主动健康 — WHO 与健康中国的共同答案(2026-08-08 重做)
+- **定义卡 ×2**(顶部):
+  - WHO 世界卫生组织: 健康不只是"没病、不虚弱",而是身体、心理与社会适应的完好状态
+  - 健康中国 2030 · 国家战略: 以人民健康为中心,将健康融入所有政策,从"以治病为中心"转向"以健康为中心"
+- **中栏 · 政策截图 + 难点分析**:
+  - 主视觉: **发改委官网《"健康中国2030"规划纲要》截图**(health-china-2030.png)——构建全方位、全周期健康促进体系
+  - 核心论点: 主动健康的难点是**预测/预知**——不是等指标异常了才干预,而是提前预知风险、提前干预
+  - 三难: 信号(风险在指标异常前潜伏,家庭看不见早期信号)/ 专业(报告门槛高,读不懂"信号")/ 坚持(知道≠做到,方案坚持不下去)
+- **底部闭环**: 检测 → AI 分析(预知风险)→ 个性化干预 → 执行 → 复测迭代
+- 呼应 P3 三代人焦虑: 主动健康正回应"全家都需要被预知、被管理"
+
+#### P10 为什么强化"身"维度 — 一份菌群报告,给家庭带来了什么(2026-08-08 由原 P13 移至 P10)
+- **定位**: 承接 P9 主动健康 → 深挖"菌群报告产出后对家庭的价值";PART 04
+- **左区 · 报告里有什么**(重点,肥胖/代谢为焦点,2×2 指标卡):
+  - 肠型分型: 拟杆菌型 vs 厚壁菌型(F/B 比值↑与肥胖相关)
+  - 菌群多样性: 检出 313 种 vs 均值约 800(多样性不足)
+  - 营养合成: B12 14 分 → 疲劳/贫血/认知专注力
+  - 代谢风险: 苏氨酸 14 分 / 丙氨酸 9 分 → 屏障受损/代谢异常
+- **左区下方 · 还能评估**(非重点,一行列表 + 科学背书):
+  - 睡眠 · 过敏 · 便秘/腹泻 · 抑郁 · 自闭 · 疾病风险
+  - 副标注: 身体状态与认知、情绪、社会性直接相关(肠脑轴——迷走神经/神经递质/短链脂肪酸/免疫炎症四大通路,Cryan 2019)
+- **右区 · 家庭得到什么**(价值链 ×4,与指标一一对应):
+  - 预知: 看不见的肥胖/代谢风险提前发现(对应肠型分型)
+  - 省时: 135 页 → 3 页 AI 方案,替代"跑医院、找专家、花数千元"(对应 313 种)
+  - 精准: 缺什么补什么(B12 缺乏→精准营养),非泛泛建议(对应营养合成)
+  - 可见: 复测对比,调理效果可量化(对应代谢风险)
+- **底部横幅**: AI 健康教练 7×24 兜底,低至 CAC 15-25 元的家庭健康管理
+- 设计原则: 肥胖是焦点(配合体重管理主线);扩展项仅列表无大数字,不喧宾夺主
+
+#### P11 为什么补上"富"维度 — 幸福与金钱无关,有关系的是财富观(2026-08-08 重做)
+- **左区 · 五维节点图**: 身(主动健康)/ 智(赋能未来)/ 富(利他创富)/ 行(人际和谐)/ 心(大爱相随),中心"五维全景·幸福矩阵"
+- **右区 · 逻辑面板 ×4**:
+  - 幸福与金钱无关: 收入超过基本所需后,金钱对幸福感的影响急剧递减;真正拉开差距的不是钱的多少,而是如何看待与使用钱
+  - 有关系的是财富观: 财富观 = 家庭对"钱"的态度与能力——利他创富 · 量入为出 · 规划传承;正确的财富观让钱服务幸福,而非被钱绑架
+  - 五行动态平衡: 相生(身→智→富→行→心→身)让系统前进,相克(身克富/智克行/富克心/行克身/心克智)让系统不翻车
+  - "富"的定义: 利他创富——低门槛创客成长生态,在利他分享中实现家庭的"第二收入曲线"
+- 落点: 四维补富 → 五维全景幸福矩阵
+
+#### P12 五维平台全景 — 四端协同 · 四维画像 · 价值闭环(2026-08-08 由原 P11+P14 合并重做)
+- **A 行 · 四端协同**: 家长端(家庭管理/测评预约/任务下发/AI 教练)、孩子端(任务/打卡/心愿/小游戏)、规划师/供应商端(套餐/结果录入/商品供应)、管理端(审核/配置/数据分析)
+- **B 行 · 四维完整画像**: 身(菌群报告)+ 智(DAN 测评 A2 六维认知+大五人格)+ 行(行为执行)+ 心(情绪心理)= **身智联动**,同一数据架构;菌群报告补足「身」——四维补富 → 五维全景
+- **C 行 · 价值闭环**: 检测(DAN 测评/菌群检测)→ AI 分析(风险预知/状态画像)→ 个性化方案 → 行为执行 → 复测迭代(数据飞轮)
+- **D 行 · 双价值面板 + 免责声明**:
+  - 对平台的价值: 数据资产(菌群+测评同架构沉淀,数据飞轮越用越准)/ 复购引擎(检测→干预→复测闭环,复购率 78.3%,行业均值 30-40%,标注"内部测算")/ 获客入口(CAC 15-25 元、LTV/CAC 80-330 倍)
+  - 对伙伴的价值: 精准触达(报告揭示需求→药食同源产品精准对接)/ 效果证据链(复测对比证明产品效果)/ 合作闭环(补齐"有产品、无个性化方案"短板)
+  - 免责声明: 复购率等为平台内部测算值,不构成业绩承诺;不点名具体合作企业
+- 商业模式骨架: 三边市场(家庭/规划师/供应商)
+
+#### P13 从 135 页报告到 3 页行动方案(2026-08-08 由原 P12 移至 P13)
+- **菌群检测**: 居家采样 → 135 页专业报告 → AI 解析压缩为 3 页行动方案
+- 真实数据点: 健康总分 73(均值 75)、菌群健康 53 偏低、检出菌种 313 种(均值约 800)
+- AI 自动标注: 维生素 B12(14 分)→ 疲劳/贫血风险;苏氨酸(14 分)→ 肠道屏障受损;丙氨酸(9 分)→ 能量代谢异常
+- **AI 健康教练**: 7×24 智能应答 + 家庭 360° 上下文 + 后台专业团队人机协同兜底
+- 效果: 替代"跑医院、找专家、花数千元"的传统路径
+
+#### P14 三重壁垒(2026-08-08 乱码修复,内容不变)
+- **学术壁垒**: 中科院心理研究所背书、双培强基工程"国家队"级底座、学术带头人团队
+- **技术壁垒**: 五维溯源算法、多智能体协同、RAG 知识库、AI 报告解析引擎
+- **数据护城河**: 442 万份真实测评 + 行为数据持续积累(脱敏)、长周期不可复制
+- 一句话: 模型 × 算法 × 数据 = 平台护城河
+
+#### P15 真实案例 — 小辰(化名)(2026-08-08 重做,报告截图说明)
+- 背景: 11 岁男孩,家长因注意力问题寻求帮助
+- **左区 · 真实报告截图 ×2**(匿名脱敏):
+  - report-score.png: 健康总分看板——总分 73 · 菌群健康 53 · 肠道预测年龄 1.37 岁
+  - report-gut-age.png: 肠道年龄评估——预测 1.37 岁(6 万人队列深度学习模型)
+- **右区 · KPI 网格 + 洞察 + 闭环**:
+  - 菌群健康 53 分(偏低 · 需重点调理)/ 菌群平衡度 31/100(中等 · 待改善)/ 检出菌种 313 种(均值约 800 · 多样性不足)/ 感染性腹泻风险 0.41(唯一「注意」级风险项)
+  - 洞察: "大脑硬件没问题,是运行环境出了问题"——身维度(肠道菌群)失衡 → 影响神经递质 → 导致智维度(注意力)表现下降
+  - 身→智联动可视化 + 干预闭环三步走: 菌群溯源 → 精准调理 → 复测对比
+  - 核心价值: 展示"检测→预知→干预→验证"闭环的真实疗效,身智联动
+- 数据原则: 案例匿名、脱敏、注明"肠道菌群健康风险评估报告"
+
+#### P16 开放平台 · 生态共建(2026-08-08 由原 P18 移至 P16)
+- 开放平台/生态共建: 产品接入(LEVEL 01)/ 联合运营(LEVEL 02)/ 资本合作(LEVEL 03)三档递进,不点名具体企业
+- 平台资产: 触达 1.2 亿户目标家庭(3 年渗透目标家庭池 <1%)
+- 行动号召: 以 1-2 款产品试点接入,30 天内跑通"检测→推荐→复购"最小闭环
+- 落款: 双培强基工程 · 中科心知 · 浠艾福(Care Family)
+
+## 4. 视觉规范(沿用既定锚点)
+
+| 项 | 值 |
+|----|-----|
+| 风格 | 科技蓝 + 暖橙家庭感 |
+| 五维色系 | 身 #FF8C42 / 心 #FF6B9D / 智 #6366F1 / 行 #10B981 / 富 #F59E0B |
+| 页面密度 | balanced(自阅材料需信息完整) |
+| 配图 | 每页配图;screen/02-06 截图为主要视觉素材 |
+| 语言 | 中文为主,专有名词中英混排 |
+| 字体 | PingFang SC / Microsoft YaHei / Inter 显示字体 |
+| 尺寸 | 1280×720,16:9 |
+
+## 5. 数据与截图素材清单
+
+| 素材 | 来源 | 用途 |
+|------|------|------|
+| screen/02 数智心理教练数据中心 | https://admin.zkxz.org.cn/screen/02 | P6 工程底座 |
+| screen/03 运营数据总览 | https://admin.zkxz.org.cn/screen/03 | P7 双培强基成果 |
+| screen/04 拔尖创新数据统计 | https://admin.zkxz.org.cn/screen/04 | P8 DAN 测评 |
+| screen/05 多元评价与个性化培养 | https://admin.zkxz.org.cn/screen/05 | P8 DAN 测评 |
+| screen/06 心理健康数据统计 | https://admin.zkxz.org.cn/screen/06 | P8 DAN 测评 + P4 数据 |
+| 具身智能素材 | ~~现有 slide-26.html + images/~~(P17 已删除,不再使用) | ~~P15 未来~~ |
+| 案例素材 | 报告截图(docs/screenshots/policy/01-cover ~ 10-diet) | P15 真实案例 |
+| 政策截图 | docs/screenshots/policy/health_china_2030.png → images/health-china-2030.png | P9 主动健康定义 |
+
+## 6. 待定项
+
+- ~~P15 页密度~~: 2026-08-08 已解决——P17(价值+洞+具身智能)删除,其价值面板内容并入 P12 双价值面板,案例改用报告截图说明
+- 截图标注: P15 报告截图的敏感信息(姓名/日期)在实施时已用匿名脱敏 + 数据来源标注处理
+
+## 7. 实施约束
+
+- 仅使用本设计文档 + 上述素材来源,不外部搜索
+- 数据标注"测算值,不构成业绩承诺"(收入预测)
+- 案例匿名脱敏
+- 不夸大未实现功能(具身智能部分明确为未来规划/演进路径)
+- 生成 HTML 单页 1280×720,沿用现有 slides/ 生成管线与视觉组件
+
+## 8. 变更记录
+
+| 日期 | 变更 | 页码影响 |
+|------|------|----------|
+| 2026-08-08 | 新增 P13(菌群报告→家庭价值)、P14(菌群+DAN 四维→平台/伙伴价值) | 16 → 18 页;原 P13~16 顺延为 P15~18;slide-13~16 文件重编号为 slide-15~18;`gen_preview16.py` → 18 页 |
+| 2026-08-08(同日收敛) | 按评审意见收敛回 16 页:P9 重做"什么是主动健康"(WHO+健康中国 2030 定义卡 + 政策截图 + 难点分析 + 闭环)、P10 菌群报告→身维度(原 P13 移至 P10)、P11 重做"为什么补上富维度"(幸福与金钱无关,有关系的是财富观)、P12 平台全景(原 P11+P14 合并,双价值面板)、P13 135 页→3 页、P14 三重壁垒(git 底稿修复乱码)、P15 案例改报告截图说明(report-score/gut-age + KPI 53/31/313/0.41)、P16 开放平台;删除 P17 | 18 → 16 页;slide-13~18 重排为 slide-10/12/13/14/15/16 语义;`gen_preview16.py` 回到 16 页;全量页脚统一 NN/16 |

+ 308 - 0
docs/superpowers/specs/2026-08-08-family-challenge-participation-design.md

@@ -0,0 +1,308 @@
+# 家庭挑战参与与同意机制设计(含方向性关系评分)
+
+> **版本**:v1.1(✅ 已确认)
+> **日期**:2026-08-08
+> **状态**:✅ **设计已确认**(2026-08-08 用户拍板:C3 只扣沟通,其余按建议默认)
+> **范围**:家庭挑战(`family_challenge`)参与机制重构:任意成员发起、可选成员、全体同意后开始、方向性关系评分。圈子挑战(`circle_challenge`)不在范围。
+> **前置基线**:`2026-08-06-family-challenge-flow-design.md`(现状断点清单)
+> **输入确认**:brainstorming 6 轮澄清 + 3 轮追问(作用对象/时机/方向性语义)
+
+---
+
+## 1. 背景与目标
+
+**现状一句话**(来自基线文档):挑战只能由**家长**手动创建,创建即 `active`、默认全员参与、无角色检查、无打卡 UI、无奖励发放。
+
+**本次要解决的核心问题**:
+
+| # | 问题 | 现状 |
+|---|------|------|
+| 1 | 挑战只能家长发起 | 孩子/其他成员无发起入口 |
+| 2 | 创建即开始,无成员确认环节 | 无"同意"概念,强制全员参与 |
+| 3 | 无法选择参与成员 | 固定全员 |
+| 4 | 参与行为无任何激励/反馈 | 发起/同意/拒绝不产生分数变化 |
+| 5 | 关系分数无方向性 | `family_members` 只有成员级分数,A对B=B对A |
+
+**目标**:
+- 任何家庭成员可发起挑战,可**选择全员或部分成员**参与
+- 挑战创建后进入 **pending(待同意)** 状态,**所有参与成员同意后才开始**
+- 发起/同意/拒绝**即时结算**方向性关系评分(信任/亲近/沟通)+ 行能量,数值**后台可配置**
+- 结算/打卡只统计**参与成员**(排除拒绝者)
+
+---
+
+## 2. 已确认规则(brainstorming 结论,用户拍板)
+
+| # | 规则 | 结论 |
+|---|------|------|
+| 1 | 发起人 | **任何家庭成员**(家长/孩子/规划师)均可发起 |
+| 2 | 参与成员选择 | 创建时可选**全员或部分成员** |
+| 3 | 发起人 | **自动同意**,必参与,自动计入参与成员 |
+| 4 | 拒绝 | 拒绝者**剔除出挑战**,其余参与成员同意后开始 |
+| 5 | 同意/拒绝入口 | **首页挑战卡片**直接操作(不用进管理页) |
+| 6 | 结算口径 | 只统计**参与成员**(agreed,排除 rejected) |
+| 7 | 打卡 | **仅参与成员可打卡**;pending 成员不可打卡 |
+| 8 | 管理页 | 放开门控,所有家庭成员可进入创建 |
+| 9 | 待同意状态 | **不限时**(pending 可长期挂起) |
+| 10 | 评分时机 | **动作发生时立即结算** |
+| 11 | 评分数值 | 默认 **±1 分**,后台可配置 |
+| 12 | 方向性 | **信任/亲近/沟通是有方向的成对分数**:A对B ≠ B对A |
+| 13 | 发起评分 | 能量+、沟通+、亲近+(**不加信任**) |
+| 14 | 同意评分 | 能量+、沟通+、亲近+、信任+(**四项全加**) |
+| 15 | 拒绝评分 | 能量-;发起人→拒绝人 信任/亲近/沟通全 -;拒绝人→发起人 仅沟通 +;已同意成员→拒绝人 仅沟通 -(见 §4.3) |
+
+---
+
+## 3. 数据模型
+
+### 3.1 新表 `family_challenge_participant`(参与成员表)
+
+```
+family_challenge_participant
+├── id               BIGINT AUTO_INCREMENT PK
+├── challenge_id     BIGINT NOT NULL          -- 挑战ID
+├── member_id        BIGINT NOT NULL          -- 成员ID
+├── status           VARCHAR(20) NOT NULL     -- pending / agreed / rejected
+├── agreed_at        DATETIME NULL            -- 同意时间(rejected 可复用记录拒绝时间)
+├── created_at       DATETIME DEFAULT NOW
+├── updated_at       DATETIME DEFAULT NOW ON UPDATE NOW
+├── UNIQUE KEY uk_challenge_member (challenge_id, member_id)
+└── INDEX idx_member (member_id)
+```
+
+**用途**:替代"创建即全员参与"的隐式模型,显式记录每个成员在挑战中的参与状态。
+
+### 3.2 新表 `family_relationship_scores`(方向性关系分数表)
+
+```
+family_relationship_scores
+├── id               BIGINT AUTO_INCREMENT PK
+├── family_id        BIGINT NOT NULL
+├── from_member_id   BIGINT NOT NULL          -- 分数持有方(A对B的分,记在 A→B 行)
+├── to_member_id     BIGINT NOT NULL          -- 分数对象方
+├── trust_score      DECIMAL(5,2) DEFAULT 0   -- A对B的信任
+├── intimacy_score   DECIMAL(5,2) DEFAULT 0   -- A对B的亲近
+├── communication_score DECIMAL(5,2) DEFAULT 0 -- A对B的沟通
+├── created_at       DATETIME DEFAULT NOW
+├── updated_at       DATETIME DEFAULT NOW ON UPDATE NOW
+├── UNIQUE KEY uk_from_to (from_member_id, to_member_id)
+└── INDEX idx_family (family_id)
+```
+
+**为什么要新表**:
+- 现有 `family_members` 的三列是**成员级、无方向**(问卷提交时被 `updateMemberScores` 压平)
+- 现有 `family_relationships` 是成对表但只存辈分/关系标签,无分数列,且语义是"族谱"
+- 方向性分数(A对B ≠ B对A)需要独立成对存储,新表是**最小侵入**方案
+- **初始化**:成员首次被挑战动作触及时,若无方向行则用该成员在 `family_members` 的对应成员级分数作为初始基线;基线缺失则默认 60.00
+
+### 3.3 `family_challenge` 表变更
+
+| 变更 | 说明 |
+|------|------|
+| 状态机 | `active` / `completed` / `cancelled` 之外新增 **`pending`**(待同意) |
+| 兼容 | 存量 `active` 挑战无 participant 行 → 迁移时为其补全 participant 行(全员 agreed),不破坏旧数据 |
+
+### 3.4 评分配置(后台可配置)
+
+**方案**:新建 `family_challenge_score_config` 简单配置表 + cfc-web 管理页(复用 `AdminEnergyConfigController` 风格):
+
+```
+family_challenge_score_config
+├── id             BIGINT AUTO_INCREMENT PK
+├── action         VARCHAR(20) NOT NULL    -- initiate / agree / reject
+├── score_type     VARCHAR(20) NOT NULL    -- energy / trust / intimacy / communication
+├── value          INT NOT NULL DEFAULT 0  -- 增减值(可正可负,默认 ±1)
+├── enabled        TINYINT DEFAULT 1
+├── updated_at     DATETIME
+└── UNIQUE KEY uk_action_type (action, score_type)
+```
+
+**默认值**(按已确认规则 13-15):
+
+| action | energy | trust | intimacy | communication |
+|--------|:------:|:-----:|:--------:|:-------------:|
+| initiate | +1 | 0 | +1 | +1 |
+| agree | +1 | +1 | +1 | +1 |
+| reject | -1 | -1 | -1 | +1 |
+
+> 说明:reject 行的**通信方向**由代码固定(拒绝人→发起人 +、发起人→拒绝人 -;已同意成员→拒绝人 仅沟通 -1,见 §4.3 C3),`value` 只控制增减幅度。能量非方向属性,作用于个人。
+
+---
+
+## 4. 评分规则详解
+
+### 4.1 基本约定
+
+- **方向性分数**(trust/intimacy/communication):成对存储于 `family_relationship_scores`,行 `(A→B)` 表示"A 对 B 的分数"。**动作执行者(actor)永远是被加/被减的主体**——加分/减分落点在 actor 的行上。
+- **能量**(行能量):非方向属性,作用于 actor 本人(`EnergyService.awardEnergy` / `deductEnergyByCode`,维度 code `action`)。
+
+### 4.2 同意(agree)— 已确认
+
+> 用户原话:"同意只是加同意人相对其他成员的,不影响其他成员对同意人的"
+
+成员 X 同意挑战时:
+
+| 落点 | trust | intimacy | communication | energy |
+|------|:-----:|:--------:|:-------------:|:------:|
+| X→其他每个参与成员 | +1 | +1 | +1 | — |
+| X 本人(能量) | — | — | — | +1 |
+| 其他成员→X(反向) | 0 | 0 | 0 | — |
+
+即:**只有 X 的"出向"行加分**,反向行不动。
+
+### 4.3 拒绝(reject)— 已确认
+
+> 用户原话:"拒绝人对发起人的沟通加,发起人对拒绝人的沟通减"
+> 用户拍板(2026-08-08):C1 ✅ -1、C2 ✅ 不变、C3 ✅ 只扣沟通、C4 ✅ I+A 每人 -1
+
+成员 X 拒绝、发起人为 I、已同意成员集合为 A:
+
+| 落点 | trust | intimacy | communication | energy |
+|------|:-----:|:--------:|:-------------:|:------:|
+| I→X | -1 | -1 | **-1** | — |
+| X→I | 0 | 0 | **+1** | — |
+| A 中每个成员→X | 0 | 0 | -1(只扣沟通) | — |
+| I / A 能量 | — | — | — | -1(I+A 每人 -1) |
+
+### 4.4 发起(initiate)— 已确认
+
+> Q1 结论:"发起/同意时所有参与成员一起加"。方向性语义下,发起人与同意人的模式完全平行(发起人出向加分)。
+
+发起人 I 创建挑战(参与成员集合 P,含 I):
+
+| 落点 | trust | intimacy | communication | energy |
+|------|:-----:|:--------:|:-------------:|:------:|
+| I→P 中每个其他成员 | 0(不加信任) | +1 | +1 | — |
+| I 本人(能量) | — | — | — | +1(仅发起人) |
+| P 中其他成员→I(反向) | 0 | 0 | 0 | — |
+
+---
+
+## 5. 接口设计
+
+> 全部 `@PostMapping`(项目规范)。前缀沿用 `/api/health/challenge/`。
+
+### 5.1 创建挑战(改造)
+
+`POST /api/health/challenge/create`
+
+```json
+{
+  "title": "全家运动周",
+  "type": "sports",
+  "goalMode": "aggregate",
+  "goalValue": 100,
+  "rewardPoints": 50,
+  "startDate": "2026-08-10",
+  "endDate": "2026-08-17",
+  "participantMemberIds": [1001, 1002, 1003]   // 新增:参与成员,含发起人自身
+}
+```
+
+- 校验:发起人必须是家庭成员;`participantMemberIds` 必须包含发起人且均属本家庭
+- 行为:写入 `family_challenge`(status=`pending`)→ 写 participant 行(发起人 `agreed`,其余 `pending`)→ **立即结算发起评分**(§4.4)→ 发起人能量 +1
+
+### 5.2 同意 / 拒绝(新增)
+
+`POST /api/health/challenge/respond`
+
+```json
+{
+  "challengeId": 123,
+  "action": "agree"          // 或 "reject"
+}
+```
+
+- 校验:调用者必须是该挑战 participant 且 status=`pending`;挑战必须处于 `pending`
+- agree:status→`agreed`、agreed_at=now → **立即结算同意评分**(§4.2)→ 若除 rejected 外的参与成员全部 agreed → 挑战 status→`active`
+- reject:status→`rejected` → **立即结算拒绝评分**(§4.3)→ 若除发起人外无剩余参与成员 → 挑战自动 `cancelled`(待确认,见 §6 Q6)
+
+### 5.3 列表(改造)
+
+`POST /api/health/challenge/list`
+
+- 返回每张卡片**我的参与状态**(`myStatus`: pending/agreed/rejected),前端据此渲染同意/拒绝按钮
+- `pending` 状态挑战:显示"等待成员确认(X/Y)"进度文案
+
+### 5.4 打卡(改造校验)
+
+`POST /api/health/challenge/progress`
+
+- 新增校验:调用者必须是对应挑战 participant 且 status=`agreed`;pending/rejected 返回"仅参与成员可打卡"
+
+### 5.5 结算(改造口径)
+
+- `settleChallenge()`:参与成员集合 = status=`agreed` 的成员(排除 rejected)
+- 结算仅发放给 agreed 成员
+
+### 5.6 评分配置(管理端)
+
+`POST /api/admin/challenge-score-config/list` / `update`(cfc-web 新增管理页,风格参照 `EnergyBehaviorConfig.vue`)
+
+---
+
+## 6. 确认清单 ✅(2026-08-08 已全部拍板)
+
+| # | 问题 | 结论 |
+|---|------|------|
+| C1 | 拒绝时 I→X 的 trust/intimacy 是否也 -1 | ✅ -1(与 communication 一致) |
+| C2 | 拒绝时 X→I 的 trust/intimacy 是否不变 | ✅ 不变(只加沟通) |
+| C3 | 拒绝时已同意成员 A→X 方向是否也扣 | ✅ **只扣沟通 -1**(trust/intimacy 不扣) |
+| C4 | 拒绝时能量 -1 落点 | ✅ I+A 每人 -1 |
+| D1 | 发起时 I→其他成员 是否 +1(intimacy/communication) | ✅ +1(平行同意模式) |
+| D2 | 发起时其他成员→I 反向是否不动 | ✅ 不动 |
+| D3 | 发起时能量 +1 是仅发起人还是全员 | ✅ 仅发起人("发起人加能量") |
+| Q6 | 除发起人外全员拒绝时挑战如何处置 | ✅ 自动 cancelled |
+
+---
+
+## 7. 前端改动
+
+| 文件 | 改动 |
+|------|------|
+| `pages/health/challenge-manage.vue` | ①移除角色门控(L173-174);②创建表单新增"参与成员多选"(默认全选);③展示 pending 状态 |
+| `components/FamilyChallengeCard.vue` | ①pending 状态渲染:"等待确认(已同意 x/y)";②**同意/拒绝按钮**(仅我的状态=pending 时显示);③rejected 成员卡片显示"已拒绝"徽标 |
+| `pages/index-home/index.vue` | 已加"管理 →"入口(已完成 `7bdf6aa8`) |
+| `utils/api.js` | 新增 `respondChallenge(challengeId, action)`;list 响应解析 myStatus |
+
+---
+
+## 8. 后端改动清单
+
+| 文件 | 改动 |
+|------|------|
+| `entity/FamilyChallengeParticipant.java` | 新建实体 |
+| `entity/FamilyRelationshipScore.java` | 新建实体(方向分数) |
+| `entity/FamilyChallengeScoreConfig.java` | 新建实体(评分配置) |
+| `mapper/` 对应 3 个 Mapper | 新建 |
+| `service/FamilyChallengeService.java` | createChallenge 改 pending+participant 落库;新增 respondChallenge();打卡/结算校验接入 participant |
+| `service/ChallengeScoreService.java` | **新建**:方向分数读取/初始化/增减 + 能量发放/扣减(读 config 表),供发起/同意/拒绝调用 |
+| `controller/FamilyChallengeController.java` | 新增 `respond` 端点;create 校验 participant 列表;list 返回 myStatus |
+| `controller/admin/AdminChallengeScoreConfigController.java` | 新建:配置 CRUD |
+| `config/DatabaseInitializer.java` | 迁移:3 张新表 + `family_challenge.status` 兼容说明 |
+| `resources/schema.sql` | 同步 3 张新表 DDL |
+| `cfc-web/src/views/admin/ChallengeScoreConfig.vue` | 新建管理页 |
+
+---
+
+## 9. 验收标准
+
+- [ ] 任意角色成员可发起挑战并选择参与成员
+- [ ] 创建后挑战为 pending,发起人自动 agreed
+- [ ] 参与成员在首页卡片可同意/拒绝,状态即时更新
+- [ ] 全部参与成员同意后挑战自动转 active
+- [ ] 除发起人外全员拒绝 → 挑战自动取消(按 Q6 确认结果)
+- [ ] 发起/同意/拒绝时方向性分数与能量按 §4 矩阵立即落账
+- [ ] 分数矩阵单元格与配置表一致(后台改 value 立即生效)
+- [ ] pending/rejected 成员打卡被拒绝;结算只统计 agreed 成员
+- [ ] 存量 active 挑战迁移后正常显示(participant 补全)
+
+---
+
+## 10. 范围外(后续迭代)
+
+- 挑战完成奖励(rewardPoints 能量发放、徽章)— 与本次参与机制正交,另起 spec
+- 到期自动结算定时任务
+- 打卡 UI(本次只做校验收紧,打卡按钮另起)
+- 通知(邀请同意/开始提醒)
+- 方向性分数在其他页面(家庭关系图/互动记录)的展示打通