这是"C 哥相关 Skill"的中文通俗说明书。
旨在用最简单的大白话，告诉大家这些工具是干嘛的、怎么用。

================================================================
【1】cgerike-maker（C 哥日课制作工具）
================================================================

【简单来说】
这是一个帮你自动生成"C 哥日课"的全套工具。你只需要给一个主题，它会帮你：
  1. 上网搜资料
  2. 写出一篇符合 C 哥风格的日课文章
  3. 生成配套的竖版信息图（SVG 格式）
  4. 用 MiniMax 的 AI 语音把文章朗读出来，生成 MP3 音频
  5. 把文章内容复制到剪贴板，方便直接粘贴发布

----------------------------------------------------------------
【第一次使用前的准备工作】
----------------------------------------------------------------

在第一次使用之前，你需要完成以下几件事。只需要做一次，以后就不用再做了。

------
准备一：安装 Python
------
这个工具需要 Python 才能运行。如果你不知道自己有没有装，可以这样检查：

  打开终端（Windows 按 Win+R，输入 cmd，回车），输入：
    python --version

  如果显示类似 "Python 3.10.0" 这样的版本号，说明已经安装好了。
  如果提示"不是内部命令"，说明没有安装，需要去官网下载：
    https://www.python.org/downloads/
  下载后安装时，记得勾选"Add Python to PATH"这个选项！

------
准备二：安装 Python 依赖库（requests）
------
这个工具需要一个叫 requests 的 Python 库来联网。安装方法：

  打开终端，输入：
    pip install requests

  等它安装完就好了。如果提示 pip 不存在，试试：
    python -m pip install requests

------
准备三：安装 ffmpeg（音频处理工具）
------
ffmpeg 是一个专门处理音视频文件的工具，生成音频时需要用到它来修复音频格式。

  Windows 安装方法（推荐用 winget，最简单）：
    打开终端，输入：
      winget install ffmpeg

  如果 winget 不可用，也可以手动安装：
    1. 去 https://ffmpeg.org/download.html 下载 Windows 版本
    2. 解压到一个固定的文件夹，比如 C:\ffmpeg
    3. 把 C:\ffmpeg\bin 这个路径添加到系统环境变量 PATH 中
       （具体方法：右键"此电脑"→属性→高级系统设置→环境变量→
        在"系统变量"里找到 Path→双击→新建→输入 C:\ffmpeg\bin→确定）

  安装完成后，在终端输入以下命令验证是否成功：
    ffmpeg -version
  如果显示版本信息，说明安装成功。

  注意：如果没有安装 ffmpeg，音频也能生成，只是可能在某些播放器上
  会有格式兼容问题。建议还是装一下。

------
准备四：注册 MiniMax 海外版并获取 API Key
------
**特别注意：本工具默认配置的是 MiniMax 的海外版接口（minimax.io），而非国内版（minimaxi.com）。**
请务必按照以下步骤操作，不要走错网站。

第一步：注册/登录
  1. 打开浏览器，访问海外版官网：https://platform.minimax.io/
  2. 这是一个全英文网站。点击 "Sign up" 或 "Continue With Google" 进行注册登录。

第二步：获取 API Key
  1. 登录后，进入控制台界面。
  2. 点击左侧菜单栏的 "Settings" -> "API Keys"（或者直接访问 https://platform.minimax.io/user-center/basic-information/interface-key）。
  3. 点击 "Create new secret key" 按钮。
  4. 给 Key 起个名字（比如 "skill"），点击确认。
  5. 复制生成的 Secret key。
  6. 重要：这个 Key 只会显示一次，请立刻复制保存！

第三步：充值
  1. 点击左侧菜单的 "Billing" -> "Balance"。
  2. 确保账户内有余额（海外版通常需要绑定国际信用卡或使用对应的支付方式）。

------
准备五：配置 API Key
------
虽然程序设计了"如果没有配置，运行时会弹窗询问"的功能，但为了保证在 AI 对话中能顺畅运行，**强烈建议**你手动修改配置文件。

  找到以下路径的文件，用记事本打开：
    （你的项目根目录）\.ai\skills\cgerike-maker\.config\minimax_api_key.txt
  或者：
    （你的项目根目录）\.trae\skills\cgerike-maker\.config\minimax_api_key.txt

  把文件里的原有内容全部删掉，只写入你刚才复制的 API Key，保存。
  文件内容示例（只有一行）：
    sk-api-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

  注意：文件里只能有 API Key 这一行内容，不能有其他文字！

------
准备六：打造你自己的"分身"（修改人设和声音）
------
"C 哥"只是一个示例，你可以把这个工具改成你自己（比如"王老师日课"、"小李观察"）。
你需要修改两个地方：

1. 修改人设（SKILL.md）
   打开 `cgerike-maker\SKILL.md` 文件，找到底部的 `## 5. 人设 (Persona)` 章节。
   把里面的"C 哥"、"连续创业者"等描述，改成你自己的名字和履历。
   AI 写文章时会完全模仿这里的人设。

2. 修改声音（generate_audio.py）
   打开 `cgerike-maker\generate_audio.py` 文件，找到第 69 行附近：
     "voice_id": "", # 在此输入你的声音 ID

   你需要填入一个 Voice ID。获取方法：
   a. 在 MiniMax 海外版控制台 (platform.minimax.io)，找到 "Audio" -> "Voice Cloning" (声音克隆)。
   b. 你可以上传一段自己的录音来克隆声音，或者从 "T2A" (Text to Audio) 页面选择一个预置的声音。
   c. 复制对应的 Voice ID（通常是一串数字或字母）。
   d. 填入代码中，例如：
      "voice_id": "male-qn-qingse", # 这是一个示例 ID

----------------------------------------------------------------
【特别提醒：关于剪贴板功能】
----------------------------------------------------------------
这个工具不仅能生成文章和音频，还能自动把排版好的文章复制到你的电脑剪贴板。
要实现这个功能，你必须安装配套的 `markdown-to-clipboard` Skill。

请检查 `shared_skills` 目录下是否有 `markdown-to-clipboard` 文件夹。
如果没有，请直接复制一份过来。如果缺失这个 Skill，自动复制功能将失效，但不影响文章和音频生成。

----------------------------------------------------------------
【怎么用】
----------------------------------------------------------------

配置好以上所有准备工作后，就可以开始使用了。

使用方法非常简单，直接告诉 AI（Claude/Trae 等）：
  "帮我写一篇关于 [主题] 的日课"

比如：
  "帮我写一篇关于 DeepSeek 最新进展的日课"
  "帮我写一篇关于如何用 AI 做副业的日课"

AI 会自动按照以下流程工作：

  第一步：搜索资料
    AI 会去网上搜索相关内容，确保信息准确、有来源。

  第二步：写初稿
    AI 会按照你设定的人设（SKILL.md 里写的）写出日课文章。

  第三步：给你看初稿，等你确认
    AI 会把初稿展示给你，然后停下来问你：
    "初稿已生成，请确认内容是否需要修改？确认无误后我将生成音频和配图。"
    你可以提出修改意见，或者直接回复"确认"/"OK"。

  第四步：生成产物（你确认后才会执行）
    - 生成 SVG 信息图（竖版 1080×1920，适合手机查看）
    - 生成 MP3 音频（用 MiniMax AI 语音朗读）
    - 把文章内容复制到剪贴板（Windows 下自动执行）

----------------------------------------------------------------
【生成的文件在哪里】
----------------------------------------------------------------

日课文章（Markdown 格式）：
  保存在项目根目录下的：
    daily-lessions/年份/月份/YYYY-MM-DD.md
  例如：daily-lessions/2026/03/2026-03-04.md

音频文件（MP3 格式）：
  通常保存在当前工作目录，文件名类似：
    2026-03-04.mp3

SVG 信息图：
  通常在对话中直接展示，你可以复制 SVG 代码保存为 .svg 文件，
  用浏览器打开即可查看。

----------------------------------------------------------------
【常见问题】
----------------------------------------------------------------

问：运行时提示"MINIMAX_API_KEY 未设置"？
答：说明 API Key 没有配置好。请检查 `minimax_api_key.txt` 文件内容是否正确。

问：生成的音频声音不对？
答：请检查 `generate_audio.py` 里的 `voice_id` 是否是你想要的那个。
   默认是空的或者是示例 ID，必须改成你自己的。

问：提示"401 Unauthorized"或鉴权失败？
答：可能是你用了国内版（minimaxi.com）的 Key 去请求海外版接口，或者反之。
   请确保在 platform.minimax.io 注册并获取 Key。

问：为什么没有自动复制到剪贴板？
答：请检查是否安装了 `markdown-to-clipboard` Skill，并且你的系统是 Windows。

----------------------------------------------------------------
【背后的逻辑】（给好奇宝宝）
----------------------------------------------------------------

这个工具的核心是把"写日课"这件事拆成了几个自动化步骤：

1. 搜索：AI 联网搜索，保证内容有来源、不瞎编。

2. 写作：AI 按照 SKILL.md 里设定的人设（语气、结构、禁忌词）来写。

3. 配图：SVG 是一种矢量图格式，可以直接用代码描述图形，不需要图片文件，
   AI 直接生成代码，浏览器就能渲染出漂亮的信息图。

4. 音频：通过 MiniMax 的 API（接口），把文字发送给 MiniMax 的服务器，
   服务器用 AI 语音合成技术生成 MP3，再下载回来。
   ffmpeg 负责修复音频文件的格式信息，让它在各种播放器上都能正常播放。

5. 剪贴板：调用另一个专门的 Skill，把 Markdown 格式的文章转换成富文本，
   直接写入系统剪贴板。

================================================================
【2】media-copywriter（全自动自媒体文案创作）
================================================================

【简单来说】
这是一个专门写自媒体文案的"超级助理"。不管你想写"AI 技巧分享"、"新闻时事讲解"还是"全程高能的事件解说"，它都能搞定。
它最厉害的地方在于：它会先去网上搜集最新、最全的资料（Deep Research），然后模仿爆款文案的结构和语气来写，最后还能帮你找配图素材。

【怎么用】
1. **告诉它你想写什么**：
   "帮我写一篇关于[主题]的口播文案"
   或者更具体一点："帮我写一篇介绍 Claude 3.5 新功能的文案，要模仿那个讲 AI 很厉害的博主的风格"。

2. **选择分类（它会自动判断，你也可以指定）**：
   它内置了几种常见的爆款模板：
   - `tech`: 纯技术干货分享
   - `AI 具体小技巧类`: 手把手教操作
   - `AI 访谈和时事新闻讲解类`: 深度解析
   - `全程高能事件型`: 讲故事、抓眼球

3. **等待它工作**：
   - 它会先去 Google/Bing 搜索一圈资料（保证信息准确）。
   - 然后根据模板写出初稿。
   - 它会自己检查一遍（QA Loop），看看有没有违背人设，够不够吸引人。如果不合格，它会自己修改。

4. **确认与保存**：
   它会把写好的文案给你看。如果你满意，它会保存成一个 `.md` 文件，放在 `口播文案/` 目录下。

5. **找素材（可选）**：
   文案定稿后，它还可以帮你去网上搜相关的图片或视频素材，下载下来方便你剪辑。

================================================================
【3】svg-ppt-maker（SVG 课件生成器）
================================================================

【简单来说】
这是一个"用代码画 PPT"的神器。它生成的不是普通的 PPT 文件，而是一套高清的、可以在浏览器里播放的 SVG 幻灯片。
风格非常现代、商务、科技感（蓝色系），特别适合用来做技术课程或知识分享。

【怎么用】
1. **告诉它你的课程大纲**：
   "帮我做一个关于[主题]的课件，大概 10 页"。

2. **确认大纲**：
   它会先列出每一页的标题和内容大纲，问你行不行。你确认后它才开始做。

3. **生成课件**：
   它会一页页生成 SVG 图片，并自动配好解说词（Script）。

4. **查看课件**：
   生成完成后，它会给你一个 `index.html` 文件。
   **双击打开这个 HTML 文件**，你就可以像播放 PPT 一样在浏览器里演示了（支持键盘左右键翻页，还有画笔功能！）。

【背后的逻辑】（给好奇宝宝）
它其实是用 SVG（矢量图）技术来画每一页 PPT。这意味着不管你把画面放多大，文字和图形永远都是清晰的，不会有锯齿。
而且它生成的 HTML 播放器非常轻量，不需要安装 PowerPoint 就能在任何电脑、手机上播放。

================================================================
【4】markdown-to-clipboard（Markdown 转富文本粘贴板）
================================================================

【简单来说】
这是一个辅助小工具。你在 Trae/Claude 里写的 Markdown 文章（带 # 标题、**加粗** 的那种），如果直接复制到微信公众号或飞书里，格式往往会乱。
用这个工具，它可以把 Markdown 变成"带排版的富文本"，直接塞进你的剪贴板。

【怎么用】
通常你不需要直接调用它。它主要是配合其他 Skill（如 `cgerike-maker`）在后台默默工作的。
如果你想单独用，可以运行脚本：
`python .ai/skills/markdown-to-clipboard/md_to_clipboard.py 你的文件.md`
运行后，直接去微信公众号编辑器里按 `Ctrl+V`，排版好的文章就出来了。
