════════════════════════════════════════════════════════════
  基金健诊 Skill 使用说明  v2.2
  由公众号"财金吃瓜党"制作，仅供研学，请审慎使用
════════════════════════════════════════════════════════════

更多 AI 金融工具，请搜索微信公众号：财金吃瓜党

────────────────────────────────────────────────────────────
【0】这是什么？
────────────────────────────────────────────────────────────
基金健诊 Skill 是一个运行在 WorkBuddy（AI 编程助手）中的专属技能
包，能够帮助您对客户的基金持仓进行全面诊断，自动生成专业的 Word 健
诊报告，包含市场形态分析、单基金深度检视、组合风险评估、投资行为画
像等内容。

⚠ 本工具仅供研学和内部参考，不构成任何投资建议。
  最终诊断结论请由持证专业人员审核后使用。

────────────────────────────────────────────────────────────
【1】运行前需要准备什么？
────────────────────────────────────────────────────────────
运行本 skill 之前，请确认以下软件/服务已就绪：

  软件/服务              说明
  ─────────────────────────────────────────────
  WorkBuddy（CodeBuddy）  本 skill 的宿主环境，需安装并登录
  Python 3.8+            运行脚本，建议使用 3.10 或 3.11
  qieman MCP             获取基金净值、持仓等数据（需配置）
  akshare MCP            获取市场指数等行情数据（需配置）
  python-docx            生成 Word 报告（pip 安装）
  openpyxl               读取投资者 Excel 信息表（pip 安装）

如不确定自己是否安装了 Python，可以在 WorkBuddy 对话中说：
"检查一下 Python 是否已安装"，AI 会帮您确认。

────────────────────────────────────────────────────────────
【2】第一次使用：安装步骤（必做）
────────────────────────────────────────────────────────────

步骤 1 ▶ 安装 Python（如已安装可跳过）
  访问 https://www.python.org/downloads/ 下载 Python 安装包。
  安装时请务必勾选 "Add Python to PATH" 选项，然后一路下一步。

步骤 2 ▶ 安装 Python 依赖库
  打开电脑的"命令提示符"：
    Windows 用户：按 Win+R，输入 cmd，回车
    Mac 用户：打开终端（Terminal）
  
  在命令提示符中输入以下命令并回车：

    pip install python-docx openpyxl requests

  如果网络较慢，可使用国内镜像加速：

    pip install python-docx openpyxl requests -i https://pypi.tuna.tsinghua.edu.cn/simple

  看到"Successfully installed"字样即表示安装成功。

步骤 3 ▶ 安装 skill 包
  在 WorkBuddy 中，进入"技能中心"，选择"从本地安装"，
  找到 fund-diagnosis-v2.zip 文件，等待安装完成。

步骤 4 ▶ 配置 MCP 服务（关键步骤）
  请确认 WorkBuddy 中已配置 qieman 和 akshare 两个 MCP 服务。
  如未配置，请联系公众号"财金吃瓜党"获取配置指引。

  ⚠ 未配置 MCP 时，skill 启动会提示"MCP 依赖缺失"，无法进行
    数据获取和诊断。

步骤 5 ▶ 准备投资者信息表
  使用 skill 包内 assets/投资者信息模板.xlsx 填写客户信息。
  请按照模板中的格式如实填写，不要修改表头或工作表名称。

────────────────────────────────────────────────────────────
【3】每次诊断的使用流程
────────────────────────────────────────────────────────────

① 打开 WorkBuddy，在对话框中输入：
    "帮我做基金健诊"  或  "启动基金健诊"
   AI 会自动加载本 skill 并引导下一步。

② 提供投资者信息
   按照 AI 提示，告知填写好的 Excel 文件路径，
   或直接将文件拖入对话框。

③ 确认数据
   AI 会展示从 Excel 中解析到的客户信息和持仓，
   确认无误后回复"确认"，启动诊断。

④ 等待诊断完成
   诊断约需 2-5 分钟（取决于持仓数量）。
   AI 会逐步展示各阶段结果：
     市场形态分析 → 单基金检视 → 组合分析 → 行为画像
   每个阶段均需您确认后才继续。

⑤ 获取报告
   诊断完成后，AI 会告知 Word 报告的保存路径，直接打开即可。
   同时会生成一份同名的 HTML 预览文件。

────────────────────────────────────────────────────────────
【4】常见问题
────────────────────────────────────────────────────────────

问题：提示"MCP 依赖缺失"
解决：检查 WorkBuddy 中 qieman 和 akshare MCP 是否已正确配置并启用。

问题：pip install 报错
解决：确认 Python 已正确安装且已加入 PATH；尝试换国内镜像源。

问题：Excel 模板解析失败
解决：请使用 skill 包内的官方模板，不要自行修改表头或工作表名称。

问题：报告生成失败
解决：确认 python-docx 已安装；检查输出路径是否有中文特殊字符或
      权限限制（如 OneDrive 同步文件夹）。

问题：基金数据获取超时
解决：网络问题，稍后重试；或检查 qieman MCP 配置是否有效。

────────────────────────────────────────────────────────────
【5】Skill 文件结构
────────────────────────────────────────────────────────────

fund-diagnosis-v2/
├── SKILL.md                  Skill 定义文件（AI 读取的工作流程）
├── 使用说明.html             HTML 版使用说明（推荐，含二维码）
├── 使用说明.txt              本文件
├── assets/
│   ├── 投资者信息模板.xlsx   请用此模板填写客户信息
│   └── 二维码组合-白底.png   公众号 Logo
├── references/
│   ├── 健诊规则.json         诊断标准规则库
│   ├── 字段映射.json         数据字段定义
│   └── 报告模板_结构.json    报告结构定义
└── scripts/                  功能脚本（无需手动调用）
    ├── data_loader.py
    ├── market_analyzer.py
    ├── fund_analyzer.py
    ├── portfolio_analyzer.py
    ├── behavior_analyzer.py
    ├── report_generator.py
    ├── html_report_generator.py
    └── dependency_checker.py

────────────────────────────────────────────────────────────
  本 skill 由公众号"财金吃瓜党"制作，仅供研学，请审慎使用
  搜索微信公众号：财金吃瓜党
════════════════════════════════════════════════════════════
