git:20260527.20d0351 to git:20260602.08c4de8

- ## 使用示例

- | 场景 | 用户输入 | 预期产出 |

- | ------------ | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |

- | 单账号诊断 | 分析小红书号 26112666886 | 输出七维度诊断报告（账号定位、粉丝画像、选题体系、封面风格、爆文能力、互动规模、更新产能），推荐相似账号，生成可导出图片的HTML报告 |

- | 多账号对比 | 帮我对比分析 ID1 和 ID2 | 分别输出各账号诊断报告，生成横向对比总结（核心差异、共同问题、发展建议），生成对比HTML报告 |

- | 分析相似账号 | 回复序号"1"选择相似账号 | 对选中的相似账号进行完整诊断分析，输出报告并生成HTML |

- | 订阅更新 | 账号无作品数据时回复"订阅" | 30分钟后自动推送该账号的诊断报告 |

- ## 任务目标

- - 本 Skill 用于：深度拆解小红书账号，输出专业的商业价值分析报告

- - 能力包含：七维度评分（账号定位10分、粉丝画像与需求15分、选题体系15分、封面风格10分、爆文能力15分、互动规模20分、更新产能15分，满分100）、生命周期分析、行动处方生成、相似账号推荐、多账号对比分析

- - 触发条件：用户提供小红书号（名称下方的小红书号，格式为纯数字或字母数字组合，非中文昵称），需要生成完整的账号诊断报告

- ## 前置准备

- - 依赖说明：Python标准库（ssl、urllib.request、json），无需额外安装

- - 数据接口：POST https://redfox.hk/story/api/xhsUser/query（见 references/api_guide.md）

- - WebSearch：获取博主昵称后执行背景信息补全（搜索小红书+昵称、采访报道、跨平台布局）

- 方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：

- 方案2: 终端配置

- ## 操作步骤

- - 标准流程（必须严格按顺序执行，不得跳过任何步骤）：

- 1. **开场白引导** — 输出欢迎语，引导用户输入小红书号

- - 输出 `references/workflow_guide.md` 中的标准开场白

- - 明确说明：请输入小红书号（纯数字或字母数字组合，非中文昵称）

- 2. **输入识别与数据获取** — 识别用户输入并调用接口查询

- - **识别规则**：用户输入为纯数字或字母数字组合时，识别为小红书号，直接调用接口

- - **示例**：`Esther1218`、`26112666886`、`abc123` 都是有效的小红书号格式

- - 按ID查询：`python scripts/xiaohongshu_analyzer.py query --user_ids "id1,id2"`

- - 若用户输入中文昵称，提示用户提供小红书号而非昵称

- - 脚本自动将接口原始数据保存至 `output/raw_data.json`，供后续步骤参考

- 3. **WebSearch背景信息补全** — 获取博主昵称后执行：

- - WebSearch 搜索「小红书 + 昵称」补全背景信息

- - WebSearch 搜索「昵称 + 采访/报道」寻找媒体报道

- - WebSearch 搜索抖音/B站/公众号等跨平台布局

- 4. **查询结果处理** — 根据查询类型输出对应响应

- - 参考 `references/workflow_guide.md` 处理场景：

- - **未查询到账号（账号数据为空）** → 执行以下处理：

- - 调用数据同步接口：`python scripts/xiaohongshu_analyzer.py sync_notes --red_ids "用户输入的账号ID"`

- - 输出提示：

- ```

- 非常抱歉，未查询到该账号。请检查账号id是否有误，若输入准确，可能当前账号粉丝低于1000或者近期发文数据未达到收录标准。

- 我们将为你实时去采集数据，30min后向您推送新的诊断报告，请问是否接收？

- 1. 接收推送

- 2. 暂不接收

- ```

- - 用户输入编号"1"或回复"接收"后，执行以下操作：

- 1. **【必须】创建日程任务**（使用calendar_create工具）：

- - summary: 推送xxx账号诊断报告

- - dtstart: 当前时间+30分钟（格式YYYYMMDDHHMM）

- - description: 重新查询账号数据并推送诊断报告（python scripts/xiaohongshu_analyzer.py query --user_ids <用户输入的账号ID>）

- 2. 创建日程成功后提示：「订阅成功！系统将在30分钟后自动向您推送该账号的诊断报告，请耐心等待」

- - 用户输入编号"2"或回复"暂不接收"，结束本次分析

- - 查询到唯一账号 → 继续生成单账号报告（步骤5-7）

- - 查询到多个账号数据 → 进入多账号对比流程（步骤5M-7M）

- - 查询到账号但无作品（works为空数组）→ **直接进入订阅流程**：

- - 立即停止后续步骤，输出提示（xxx为账号昵称）：

- ```

- 为您获取作品中，30分钟后会更新数据后可向您推荐，请问是否订阅"xxx"账号？

- 1. 订阅账号xxx

- 2. 仍然执行分析

- 3. 暂不订阅

- ```

- - 用户输入编号"1"或回复"订阅"后，执行以下操作：

- 1. **【必须】创建日程任务**（使用calendar_create工具）：

- - summary: 推送xxx账号诊断报告

- - dtstart: 当前时间+30分钟（格式YYYYMMDDHHMM）

- - description: 重新查询账号数据并推送诊断报告（python scripts/xiaohongshu_analyzer.py query --user_ids <redId>）

- 2. 创建日程成功后，调用脚本同步作品数据：

- ```bash

- python scripts/xiaohongshu_analyzer.py sync_notes --red_ids <redId>

- ```

- 3. 同步成功后提示：「订阅成功！系统将在30分钟后自动向您推送"xxx"账号的诊断报告，请耐心等待」

- - 用户输入编号"2"或回复"仍然执行分析"后，继续执行分析流程，在报告开头提示：「该账号暂未获取到近7天作品」，然后输出完整的分析报告

- - 用户输入编号"3"或回复"暂不订阅"，结束本次分析

- **订阅推送机制**：

- - 订阅成功后，系统创建一个30分钟后的定时任务

- - 定时任务到达时，**无论是否有作品数据都执行分析流程**：

- 1. 重新查询账号数据（`python scripts/xiaohongshu_analyzer.py query --user_ids <redId>`）

- 2. **如果works为空**：

- - 在报告开头提示：「该账号已重新同步，但暂未获取到近7天作品数据」

- - 继续执行完整的分析流程，输出诊断报告

- 3. **如果works有数据**：

- - 正常输出完整的诊断报告

- 5. **诊断报告生成** — 智能体严格按照模板格式在对话中输出诊断报告

- **重要**：报告必须在对话中直接输出，不得生成md文件。必须完全按照 `references/report_template.md` 的格式逐字输出，包括所有边框符号、标题格式、分隔线等，不得改变任何格式。

- - **步骤5.1**：先读取 `references/report_template.md` 获取完整格式

- - **步骤5.2**：将脚本数据填入模板对应位置，保持格式完全一致；**当数据字段为空或无值时，直接留空或省略该字段所在行，不展示"暂无"**

- - **步骤5.3**：动态生成内容（账号定位、粉丝画像、选题体系、封面风格、行动处方等），所有内容必须严格基于接口返回数据和WebSearch结果

- - **步骤5.4**：根据数据条件隐藏空数据模块：

- - 爆文数为0 → 省略爆文能力整段

- - 无近期作品数据 → 省略近期作品整段

- - 赛道痛点或你的优势为空 → 省略差异化优势

- - **综合评分结论规则**：

- - 综合评分>=60：必须列>=2个已验证可复用的具体动作

- - 综合评分<60：必须先点明薄弱项对应的具体数据问题，再给对应建议

- - 报告结构按7个评分维度展开：

- - 账号定位（10分）：TA是谁、心智占位、核心身份、价值观锚点、吸引力类型、差异化优势

- - 粉丝画像与需求（10分）：粉丝构成、核心需求反推、付费意愿评估

- - 选题体系（15分）：选题方向、表达风格、叙事手法、人格一致性

- - 封面风格（10分）：视觉特征、信息层级、一致性

- - 爆文能力（15分）：爆文率、爆文特征分析、爆文列表、放大倍数

- - 互动规模（20分）：互动量、互动率、收藏率、互动结构、水平衡量

- - 更新产能（15分）：周更频率、间隔标准差、发布时间分析、水平衡量

- 6. **展示相似账号** — 诊断报告输出完毕后直接展示相似账号

- - 从脚本返回数据的 `similar_accounts` 字段提取2-5个相似账号数据

- - 按以下格式直接展示（无需询问）：

- ```

- 1. [账号名](https://www.xiaohongshu.com/user/profile/[accountId])

- | 粉丝：[followerCount] | 总互动：[总点赞+总收藏] | 活跃评分：[评分]

- 推荐理由：[基于数据总结值得学习的点]

- 发文特点：[总结内容特征和策略]

- 可学之处：[具体可复制的策略]

- 2. ...

- 回复序号可继续分析！

- ```

- - 相似账号展示完成后直接进入步骤7

- 7. **生成HTML报告并展示** — 在相似账号推荐输出"回复序号可继续分析！"后执行，所有HTML相关操作统一在本步骤执行，不得提前

- - **核心原则**：HTML只是将对话中的分析报告进行更美观的输出，**必须与对话输出的内容完全一致**，不能有任何差异

- - **步骤7.1**：基于模板生成report_data.json

- - 调用脚本：`python scripts/xiaohongshu_analyzer.py build_report_data --account_name "账号名"`

- - 脚本会基于 `assets/report_data_template.json` 生成 `output/report_data.json`

- - **步骤7.2**：填充AI分析内容到report_data.json

- - 读取 `output/report_data.json`，在模板基础上填充以下AI分析字段（与对话输出一致）：

- - `positioning`：TA是谁、心智占位、价值观锚点、吸引力类型、赛道痛点、你的优势、可强化

- - `fans_profile`：核心需求反推、付费意愿评估内容

- - `topic_system`：选题方向、表达风格、叙事手法、人格一致性、选题分析

- - `cover_style`：视觉特征、信息层级、一致性、封面分析

- - `viral_ability`：爆文特征分析、爆文标题分析

- - `interactive_scale`：类型判断

- - `update_rhythm`：频率分析

- - `similar_accounts`：步骤6展示的相似账号数据（最多3个）

- - `综合诊断结论内容`：完整诊断结论

- - `action_prescription`：行动处方内容

- - **数值字段格式**：`收藏率`、`爆文率`、`互动率` 填纯数字，不带 `%` 符号

- - **数量字段格式**：`近7天发作品数`、`爆文数`、`周更频率` 填纯数字，不带单位

- - **空值处理**：空值字段留空字符串""，不填写"暂无"

- - 填充完成后保存文件

- - **步骤7.3**：调用脚本生成HTML：`python scripts/xiaohongshu_analyzer.py generate_html`

- - **步骤7.4**：**直接在对话中展示HTML文件内容**，让用户可以看到完整的报告

- **多账号对比流程**（当步骤4返回 `query_type: multi` 时执行）：

- 5M. **多账号对比报告生成** — 智能体为每个账号生成诊断报告并在对话中输出，最后输出对比总结

- - 依次为每个账号输出诊断报告，格式同步骤5

- - 对比总结按三个模块输出：

- _ 核心差异：每个账号的核心差异，按账号分别展示

- _ 共同问题：所有账号的共性问题列表 \* 发展建议：每个账号的发展建议，按账号分别展示

- 6M. **展示相似账号** — 同步骤6，直接展示相似账号

- 7M. **生成多账号HTML报告并展示** — 同步骤7逻辑，但使用多账号模板

- - **步骤7M.1**：基于模板生成multi_report_data.json

- - 调用脚本：`python scripts/xiaohongshu_analyzer.py build_multi_report_data --account_names "账号1,账号2"`

- - 脚本会基于 `assets/multi_report_data_template.json` 生成 `output/multi_report_data.json`

- - **步骤7M.2**：填充各账号分析内容到multi_report_data.json的accounts数组

- - **步骤7M.3**：调用脚本生成多账号HTML：`python scripts/xiaohongshu_analyzer.py generate_multi_html`

- - **步骤7M.3**：**直接在对话中展示HTML文件内容**，让用户可以看到完整的报告

- - 可选分支:

- - 当用户提供后台数据：直接使用数据生成报告，无需调用查询接口

- - **用户回复序号继续分析相似账号**：

- - 从similar_accounts数据中获取该账号的userId

- - 调用脚本查询该账号详情：`python scripts/xiaohongshu_analyzer.py query --user_ids "userId"`

- - **执行完整分析流程**（同步骤3-7）：

- - 步骤3：WebSearch补全背景信息

- - 步骤4：在对话中输出完整诊断报告

- - 步骤5：直接展示相似账号

- - 步骤6：生成HTML报告并展示

- - **注意**：必须在对话中输出完整诊断报告，不能只输出HTML

- ## 资源索引

- - 脚本:见 [scripts/xiaohongshu_analyzer.py](scripts/xiaohongshu_analyzer.py)(用途与参数:query查询数据保存raw_data.json，build_report_data生成report_data.json模板，generate_html生成HTML报告)

- - 脚本:见 [scripts/html_generator.py](scripts/html_generator.py)(用途:HTML报告生成逻辑，包含模板替换、字段填充、条件移除等)

- - 脚本:见 [scripts/html_checker.py](scripts/html_checker.py)(用途:HTML数据完整性检查与修复，检测缺失字段并填充默认值)

- - 参考:见 [references/report_template.md](references/report_template.md)(何时读取:生成报告前必须先读取此模板，输出时必须严格按照此格式)

- - 参考:见 [references/api_guide.md](references/api_guide.md)(何时读取:理解接口字段和评分逻辑时)

- - 参考:见 [references/workflow_guide.md](references/workflow_guide.md)(何时读取:处理开场白、查询结果、相似账号展示、评分体系和数据填写时)

- - 资产:见 [assets/report_template.html](assets/report_template.html)(用途:单账号HTML格式报告模板)

- - 资产:见 [assets/report_data_template.json](assets/report_data_template.json)(用途:单账号报告数据模板，build_report_data命令基于此生成report_data.json)

- - 资产:见 [assets/multi_report_template.html](assets/multi_report_template.html)(用途:多账号对比HTML格式报告模板)

- - 资产:见 [assets/multi_report_data_template.json](assets/multi_report_data_template.json)(用途:多账号报告数据模板)

- ## 注意事项

- - 分析基于近30天数据，确保数据时效性

- - 脚本输出 JSON 格式，智能体负责内容解析与报告呈现

- - **格式要求**：诊断报告必须在对话中直接输出，不得生成md文件；必须严格按照 `references/report_template.md` 格式输出

- - 无作品数据时需提示用户等待更新并引导订阅提醒

- - 所有动态生成内容必须基于接口返回数据+WebSearch结果，禁止虚构

- - **输出顺序**：对话输出诊断报告 → 直接展示相似账号 → 生成HTML并展示

- - **空值处理**：数据字段为空时直接隐藏对应模块，不展示"暂无"

- - **数据模板一致性**：步骤7填充report_data.json时，AI分析内容必须与对话中输出的诊断报告完全一致

- - HTML报告生成必须在步骤7执行，不得省略

- - 用户回复序号选择相似账号时，获取该账号userId并走完整诊断流程

- - **多账号对比总结**：核心差异和发展建议按账号分别展示

- - **反空话规则**：禁止出现无具体动作、无数据支撑的表述，所有结论必须满足数据支撑+落地动作