1 line
134 KiB
JSON
1 line
134 KiB
JSON
{"repo": "1437649480/miku-hermes-chat", "files": {"README.md": {"0121f64a8b990a88ed22a3dc9cd18f5ff4e3de98": {"t": 1785747355.3997302, "n": 10334, "h": "2b951b98876030f7", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n| ----------- | ----- | ----------------------------------- |\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包注入 | ✅ 完成 | 情感检测 + 关键词匹配，自动插入初音表情包 |\n| Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n| 🎤 TTS 语音合成 | 🔌 可选 | Edge TTS 免费 / 网站反代 / RVC 本地 / AI 模型 |\n\n## 🏗️ 架构概览\n\n```mermaid\ngraph TB\n subgraph Client[\"📱 微信客户端\"]\n Bot[\"iLink Bot\"]\n end\n\n subgraph Gateway[\"🔀 Hermes Gateway (WSL2)\"]\n Miku[\"🎭 miku.skill<br/>角色引擎\"]\n Sticker[\"🎨 sticker<br/>表情包注入\"]\n Session[\"🧠 Session Manager<br/>永久记忆 + 压缩\"]\n end\n\n subgraph Backend[\"🤖 模型服务层\"]\n DeepSeek[\"deepseek-free-api<br/>💬 主对话<br/>Port :8000\"]\n Kimi[\"kimi-free-api<br/>🤖 Vision/提取<br/>Port :8002\"]\n end\n\n Client --> Gateway\n Gateway --> DeepSeek\n Gateway --> Kimi\n```\n\n***\n\n## 🚀 快速开始\n\n### 前置条件\n\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n\n详细步骤见 [docs/部署指南.md](docs/部署指南.md)，核心配置如下：\n\n```bash\n# 1. 复制配置模板\ncp config-example/config.yaml.example ~/.hermes/config.yaml\n\n# 2. 设置环境变量\ncat >> ~/.hermes/.env << 'EOF'\nDEEPSEEK_API_KEY=sk-your-deepseek-key\nHERMES_MAX_ITERATIONS=90\nDEEPSEEK_MODEL=deepseek-chat\nWEIXIN_DM_POLICY=open\nEOF\n\n# 3. 安装 Miku 角色技能\nmkdir -p ~/.hermes/skills/miku\ncp -r miku.skill/SKILL.md ~/.hermes/skills/miku/\ncp -r miku.skill/pictures/ ~/.hermes/skills/miku/pictures/\n\n# 4. 启用技能\nhermes skills enable miku\n```\n\n> 📚 **完整配置参考：** 更多详细配置（语音模式、TTS、辅助功能等）见：\n>\n> - [docs/PROJECT\\_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) — 完整配置结构\n> - [docs/部署指南.md](docs/部署指南.md) — 手把手部署教程\n> - [docs/操作指令参考.md](docs/操作指令参考.md) — 聊天指令大全\n\n### 4. 安装表情包功能\n\n将初音未来表情包注入引擎放入 Hermes 网关扩展目录：\n\n```bash\n# 复制表情包注入引擎\ncp gateway/sticker_injector.py $HERMES_HOME/gateway/sticker_injector.py\ncp gateway/sticker_cache.py $HERMES_HOME/gateway/sticker_cache.py\n\n# 表情包图片已在步骤 3 的 miku.skill/pictures/ 中安装\n# 重启网关后，miku 会自动根据情绪发送匹配的表情包\n```\n\n> `sticker_injector.py` 读取 `miku.skill/pictures/sticker_catalog.json`（表情包目录），支持 6 种情绪检测（开心/撒娇/安慰/傲娇/难过/惊讶/日常）+ 关键词匹配 + 时段感知，从 209 张初音表情包中自动选择最合适的。\n\n#### 🖼️ 可视化表情包管理系统\n\n提供 Web 可视化界面管理表情包，支持**上传、删除、分类**操作。界面采用**深色实体面板**（无玻璃模糊效果），使用您自己放入 `background/` 目录的壁纸作为背景，每 5 分钟自动轮播切换。\n\n**一键启动：** 双击 `miku.skill/pictures/启动表情包管理.bat`（自动安装 Flask 并打开浏览器）\n\n```bash\n# 或手动启动\ncd miku.skill/pictures\npip install flask\npython sticker_manager.py\n# 浏览器打开 http://localhost:5100\n```\n\n| 功能 | 操作 |\n|------|------|\n| 查看 | 按分类浏览所有表情包，搜索过滤 |\n| 上传 | 拖放/点击上传 PNG/JPG/WebP，自动归档到对应来源目录 |\n| 删除 | 悬停卡片点击 X 按钮，同时从 catalog 和磁盘删除 |\n| 分类 | 新建/编辑/删除情绪分类，配置触发词和场景（右键编辑） |\n| 壁纸 | 每 5 分钟自动循环 `background/` 目录中的多张壁纸 |\n\n> 💡 **添加/修改壁纸**：将 .jpg/.png 图片放入 `miku.skill/pictures/background/` 目录即可，系统自动识别并在 5 分钟循环中切换。推荐从 [分享鲨壁纸网 - 初音未来](https://www.fenxiangsha.com/search/255-0.html) 下载高清壁纸。\n\n### 5. 启动 Hermes → 连接微信\n\n```bash\n# 进入 WSL\nwsl.exe -d Ubuntu-24.04\n\n# 首次需配置微信（扫码登录）\nhermes gateway setup\n# 选择 Weixin → 等待二维码 → 手机微信扫码 → 确认登录\n\n# 启动微信网关\nhermes gateway start\n\n# 检查状态\nhermes gateway status\n```\n\n测试：用手机微信给 Bot 发 `miku`，初音未来就会回复你！♡\n\n> **默认已开启 TTS**：所有回复自动附带语音（`/voice tts` 模式）。如需关闭，发送 `/voice off`。\n\n### 6. 配置 TTS 语音（可选）\n\n编辑 `~/.hermes/config.yaml`，选择一种 TTS 方案：\n\n```yaml\ntts:\n provider: edge # 免费 Edge TTS\n edge:\n voice: zh-CN-XiaoxiaoNeural\n # 或使用 aivoicelab 初音未来角色语音（网站反代，需自行部署）\n # provider: aivoicelab\n # aivoicelab:\n # model: miku\n # model_name: us-female-hatsune-miku\n\nvoice:\n auto_tts: true # 自动语音合成\n default_mode: all # 默认模式: all=所有回复带语音 (/voice tts)\n```\n\n重启网关后语音生效。详见 [gateway/tts\\_interface.py](gateway/tts_interface.py) 和 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n### 7. 配置辅助功能\n\n标题自动生成和网页内容提取走 kimi-free-api (Port 8002)，在 `~/.hermes/config.yaml` 中配置：\n\n```yaml\nauxiliary:\n title_generation:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token # 与 kimi-free-api 共用 token\n web_extract:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token\n timeout: 360 # 网页提取耗时较长，给足够超时\n```\n\n> **标题自动生成**：新会话的第一轮对话后，自动用 Kimi 摘要生成中文标题。\\\n> **网页内容提取**：在微信中发送 URL（如 B站视频、知乎文章），miku 会自动抓取内容并分析。\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── LICENSE # Apache 2.0\n├── miku.skill/ # 初音未来角色定义\n│ ├── SKILL.md # 人格、对话规则、示例\n│ └── pictures/ # 表情包管理\n│ ├── sticker_catalog.json # 表情包目录（6种情绪×209张贴纸，触发词+场景匹配）\n│ ├── sticker_manager.py # 可视化管理系统后端 (Flask)\n│ ├── sticker_manager.html # 可视化管理系统前端\n│ ├── background/ # 管理界面壁纸（5分钟循环）\n│ ├── 01_miratsu/ # みらつ Q版可爱风 (14张)\n│ └── 06_bilibili_200/ # B站官方V家表情包 (150张，7个主题)\n├── gateway/ # Hermes 网关扩展\n│ ├── sticker_injector.py # 情感表情包注入引擎\n│ ├── sticker_cache.py # 表情包描述缓存\n│ └── tts_interface.py # TTS 语音合成接口定义\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example # 含 TTS 可选方案注释\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── PROJECT_OVERVIEW.md # 项目总览（架构、配置、命令）\n ├── free-api-guide.md # 免费 API 部署详解\n ├── architecture.md # 系统架构说明\n ├── 部署指南.md # 从零部署教程\n └── 操作指令参考.md # 全部聊天指令 + 排查命令\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n| ----------------- | ------------ | ---- | ------------------- |\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群（Vision/压缩/提取） |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎤 语音指令\n\n在聊天中发送以下指令控制 TTS 语音行为：\n\n| 指令 | 效果 |\n| -------------------- | ------------ |\n| `/voice tts` | 所有回复都带语音（默认） |\n| `/voice on` | 仅回复语音消息时发语音 |\n| `/voice off` | 纯文字，不发语音 |\n| `/voice status` | 查看当前语音模式 |\n| `/voiceorder after` | 语音在文字+表情包之后发 |\n| `/voiceorder before` | 语音在文字+表情包之前发 |\n\n语音支持三种模式：**全量 TTS** → 所有回复带语音 / **语音回复** → 仅在收到语音时回复语音 / **关闭** → 纯文字静音。详细文档见 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## ⚖️ 角色版权与使用协议\n\n本项目使用的**初音未来 (Hatsune Miku)** 虚拟角色受以下协议保护：\n\n| 协议 | 适用对象 | 许可范围 |\n| ----------------------------------------------------------------------- | ---------------- | --------------- |\n| [PCL](https://piapro.jp/license/pcl/summary) (Piapro Character License) | 初音未来等 Crypton 角色 | 非营利二次创作、公开展示、分发 |\n| [CC BY-NC 3.0](https://creativecommons.org/licenses/by-nc/3.0/) | 角色原始插画 | 复制、改编、分发（非商业用途） |\n\n**使用要求：**\n\n- **非商业** — 禁止营利目的、禁止广告宣传、禁止收费\n- **署名** — 必须标注 `Hatsune Miku, © Crypton Future Media, Inc. 2007`\n- **CC 链接** — 在线发布时添加 `licensed under a CC BY-NC: https://creativecommons.org/licenses/by-nc/3.0/`\n- **商业用途** — 需联系 <intlbiz@crypton.co.jp> 获取单独授权\n\n**本项目遵守：** 本项目为个人非营利研究交流，角色 Skill 基于官方设定与同人文化创作，所有角色版权归 [Crypton Future Media, Inc.](https://www.crypton.co.jp/) 所有。\n\n详细使用条款: <https://piapro.jp/license/character_guideline>\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n\\####免责声明\n逆向API是不稳定的，建议前往MoonshotAI官方 <https://platform.moonshot.cn/> 付费使用API，避免封禁的风险。\n\n本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- [Crypton Future Media](https://www.crypton.co.jp/) - 初音未来角色版权方\n- [KEI](https://x.com/kei_garou) - 初音未来角色原画设计\n- [藤田咲](https://x.com/fujitasaki_pu) - 初音未来音源提供\n\n### 🎨 表情包来源\n\n| 来源 | 说明 | 数量 |\n|------|------|------|\n| [luotianyi-dev/vocaloid-bilibili-stickers](https://github.com/luotianyi-dev/vocaloid-bilibili-stickers) | B站官方V家全套表情包 (CC BY-NC 3.0) | 150张 |\n| [みらつ (miratsu)](https://www.pixiv.net/users/102593990) | Q版可爱风原创同人表情包 | 14张 |\n| [分享鲨壁纸网](https://www.fenxiangsha.com/search/255-0.html) | 管理界面背景壁纸来源 | — |\n\n"}, "2344723cbfe5e39cc08797551d6d3aaf7d5e8b1a": {"t": 1785772744.7604928, "n": 10758, "h": "21c0605cdc3ecd10", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n| ----------- | ----- | ----------------------------------- |\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包注入 | ✅ 完成 | 情感检测 + 关键词匹配，自动插入初音表情包 |\n| Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n| 🎤 TTS 语音合成 | 🔌 可选 | Edge TTS 免费 / 网站反代 / RVC 本地 / AI 模型 |\n\n## 🏗️ 架构概览\n\n```mermaid\ngraph TB\n subgraph Client[\"📱 微信客户端\"]\n Bot[\"iLink Bot\"]\n end\n\n subgraph Gateway[\"🔀 Hermes Gateway (WSL2)\"]\n Miku[\"🎭 miku.skill<br/>角色引擎\"]\n Sticker[\"🎨 sticker<br/>表情包注入\"]\n Session[\"🧠 Session Manager<br/>永久记忆 + 压缩\"]\n end\n\n subgraph Backend[\"🤖 模型服务层\"]\n DeepSeek[\"deepseek-free-api<br/>💬 主对话<br/>Port :8000\"]\n Kimi[\"kimi-free-api<br/>🤖 Vision/提取<br/>Port :8002\"]\n end\n\n Client --> Gateway\n Gateway --> DeepSeek\n Gateway --> Kimi\n```\n\n***\n\n## 🚀 快速开始\n\n### 前置条件\n\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n\n详细步骤见 [docs/部署指南.md](docs/部署指南.md)，核心配置如下：\n\n```bash\n# 1. 复制配置模板\ncp config-example/config.yaml.example ~/.hermes/config.yaml\n\n# 2. 设置环境变量\ncat >> ~/.hermes/.env << 'EOF'\nDEEPSEEK_API_KEY=sk-your-deepseek-key\nHERMES_MAX_ITERATIONS=90\nDEEPSEEK_MODEL=deepseek-chat\nWEIXIN_DM_POLICY=open\nEOF\n\n# 3. 安装 Miku 角色技能\nmkdir -p ~/.hermes/skills/miku\ncp -r miku.skill/SKILL.md ~/.hermes/skills/miku/\ncp -r miku.skill/pictures/ ~/.hermes/skills/miku/pictures/\n\n# 4. 启用技能\nhermes skills enable miku\n```\n\n> 📚 **完整配置参考：** 更多详细配置（语音模式、TTS、辅助功能等）见：\n>\n> - [docs/PROJECT\\_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) — 完整配置结构\n> - [docs/部署指南.md](docs/部署指南.md) — 手把手部署教程\n> - [docs/操作指令参考.md](docs/操作指令参考.md) — 聊天指令大全\n\n### 4. 安装表情包功能\n\n将初音未来表情包注入引擎放入 Hermes 网关扩展目录：\n\n```bash\n# 复制表情包注入引擎\ncp gateway/sticker_injector.py $HERMES_HOME/gateway/sticker_injector.py\ncp gateway/sticker_cache.py $HERMES_HOME/gateway/sticker_cache.py\n\n# 表情包图片已在步骤 3 的 miku.skill/pictures/ 中安装\n# 重启网关后，miku 会自动根据情绪发送匹配的表情包\n```\n\n> `sticker_injector.py` 读取 `miku.skill/pictures/sticker_catalog.json`（表情包目录），支持 6 种情绪检测（开心/撒娇/安慰/傲娇/难过/惊讶/日常）+ 关键词匹配 + 时段感知，从 209 张初音表情包中自动选择最合适的。\n\n#### 🖼️ 可视化表情包管理系统\n\n提供 Web 可视化界面管理表情包，支持**上传、删除、分类**操作。界面采用**深色实体面板**（无玻璃模糊效果），使用您自己放入 `background/` 目录的壁纸作为背景，每 5 分钟自动轮播切换。\n\n**一键启动：** 双击 `miku.skill/pictures/启动表情包管理.bat`（自动安装 Flask 并打开浏览器）\n\n```bash\n# 或手动启动\ncd miku.skill/pictures\npip install flask\npython sticker_manager.py\n# 浏览器打开 http://localhost:5100\n```\n\n| 功能 | 操作 |\n|------|------|\n| 查看 | 按分类浏览所有表情包，搜索过滤 |\n| 上传 | 拖放/点击上传 PNG/JPG/WebP，自动归档到对应来源目录 |\n| 删除 | 悬停卡片点击 X 按钮，同时从 catalog 和磁盘删除 |\n| 分类 | 新建/编辑/删除情绪分类，配置触发词和场景（右键编辑） |\n| 壁纸 | 每 5 分钟自动循环 `background/` 目录中的多张壁纸 |\n\n> 💡 **添加/修改壁纸**：将 .jpg/.png 图片放入 `miku.skill/pictures/background/` 目录即可，系统自动识别并在 5 分钟循环中切换。推荐从 [分享鲨壁纸网 - 初音未来](https://www.fenxiangsha.com/search/255-0.html) 下载高清壁纸。\n\n### 5. 启动 Hermes → 连接微信\n\n```bash\n# 进入 WSL\nwsl.exe -d Ubuntu-24.04\n\n# 首次需配置微信（扫码登录）\nhermes gateway setup\n# 选择 Weixin → 等待二维码 → 手机微信扫码 → 确认登录\n\n# 启动微信网关\nhermes gateway start\n\n# 检查状态\nhermes gateway status\n```\n\n测试：用手机微信给 Bot 发 `miku`，初音未来就会回复你！♡\n\n> **默认已开启 TTS**：所有回复自动附带语音（`/voice tts` 模式）。如需关闭，发送 `/voice off`。\n\n### 6. 配置 TTS 语音（可选）\n\n编辑 `~/.hermes/config.yaml`，选择一种 TTS 方案：\n\n```yaml\ntts:\n provider: edge # 免费 Edge TTS\n edge:\n voice: zh-CN-XiaoxiaoNeural\n # 或使用 aivoicelab 初音未来角色语音（网站反代，需自行部署）\n # provider: aivoicelab\n # aivoicelab:\n # model: miku\n # model_name: us-female-hatsune-miku\n\nvoice:\n auto_tts: true # 自动语音合成\n default_mode: all # 默认模式: all=所有回复带语音 (/voice tts)\n```\n\n重启网关后语音生效。详见 [gateway/tts\\_interface.py](gateway/tts_interface.py) 和 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n### 7. 配置辅助功能\n\n标题自动生成和网页内容提取走 kimi-free-api (Port 8002)，在 `~/.hermes/config.yaml` 中配置：\n\n```yaml\nauxiliary:\n title_generation:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token # 与 kimi-free-api 共用 token\n web_extract:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token\n timeout: 360 # 网页提取耗时较长，给足够超时\n```\n\n> **标题自动生成**：新会话的第一轮对话后，自动用 Kimi 摘要生成中文标题。\\\n> **网页内容提取**：在微信中发送 URL（如 B站视频、知乎文章），miku 会自动抓取内容并分析。\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── LICENSE # Apache 2.0\n├── miku.skill/ # 初音未来角色定义\n│ ├── SKILL.md # 人格、对话规则、示例\n│ └── pictures/ # 表情包管理\n│ ├── sticker_catalog.json # 表情包目录（6种情绪×209张贴纸，触发词+场景匹配）\n│ ├── sticker_manager.py # 可视化管理系统后端 (Flask)\n│ ├── sticker_manager.html # 可视化管理系统前端\n│ ├── background/ # 管理界面壁纸（5分钟循环）\n│ ├── 01_miratsu/ # みらつ Q版可爱风 (14张)\n│ └── 06_bilibili_200/ # B站官方V家表情包 (150张，7个主题)\n├── gateway/ # Hermes 网关扩展\n│ ├── sticker_injector.py # 情感表情包注入引擎\n│ ├── sticker_cache.py # 表情包描述缓存\n│ └── tts_interface.py # TTS 语音合成接口定义\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example # 含 TTS 可选方案注释\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── PROJECT_OVERVIEW.md # 项目总览（架构、配置、命令）\n ├── free-api-guide.md # 免费 API 部署详解\n ├── architecture.md # 系统架构说明\n ├── 部署指南.md # 从零部署教程\n └── 操作指令参考.md # 全部聊天指令 + 排查命令\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n| ----------------- | ------------ | ---- | ------------------- |\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群（Vision/压缩/提取） |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎤 语音指令\n\n在聊天中发送以下指令控制 TTS 语音行为：\n\n| 指令 | 效果 |\n| -------------------- | ------------ |\n| `/voice tts` | 所有回复都带语音（默认） |\n| `/voice on` | 仅回复语音消息时发语音 |\n| `/voice off` | 纯文字，不发语音 |\n| `/voice status` | 查看当前语音模式 |\n| `/voiceorder after` | 语音在文字+表情包之后发 |\n| `/voiceorder before` | 语音在文字+表情包之前发 |\n\n语音支持三种模式：**全量 TTS** → 所有回复带语音 / **语音回复** → 仅在收到语音时回复语音 / **关闭** → 纯文字静音。详细文档见 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## ⚖️ 角色版权与使用协议\n\n本项目使用的**初音未来 (Hatsune Miku)** 虚拟角色受以下协议保护：\n\n| 协议 | 适用对象 | 许可范围 |\n| ----------------------------------------------------------------------- | ---------------- | --------------- |\n| [PCL](https://piapro.jp/license/pcl/summary) (Piapro Character License) | 初音未来等 Crypton 角色 | 非营利二次创作、公开展示、分发 |\n| [CC BY-NC 3.0](https://creativecommons.org/licenses/by-nc/3.0/) | 角色原始插画 | 复制、改编、分发（非商业用途） |\n\n**使用要求：**\n\n- **非商业** — 禁止营利目的、禁止广告宣传、禁止收费\n- **署名** — 必须标注 `Hatsune Miku, © Crypton Future Media, Inc. 2007`\n- **CC 链接** — 在线发布时添加 `licensed under a CC BY-NC: https://creativecommons.org/licenses/by-nc/3.0/`\n- **商业用途** — 需联系 <intlbiz@crypton.co.jp> 获取单独授权\n\n**本项目遵守：** 本项目为个人非营利研究交流，角色 Skill 基于官方设定与同人文化创作，所有角色版权归 [Crypton Future Media, Inc.](https://www.crypton.co.jp/) 所有。\n\n详细使用条款: <https://piapro.jp/license/character_guideline>\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n\\####免责声明\n逆向API是不稳定的，建议前往MoonshotAI官方 <https://platform.moonshot.cn/> 付费使用API，避免封禁的风险。\n\n本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- [Crypton Future Media](https://www.crypton.co.jp/) - 初音未来角色版权方\n- [KEI](https://x.com/kei_garou) - 初音未来角色原画设计\n- [藤田咲](https://x.com/fujitasaki_pu) - 初音未来音源提供\n\n### 🎨 表情包来源\n\n| 来源 | 说明 | 数量 |\n|------|------|------|\n| [luotianyi-dev/vocaloid-bilibili-stickers](https://github.com/luotianyi-dev/vocaloid-bilibili-stickers) | B站官方V家全套表情包 (CC BY-NC 3.0) | 150张 |\n| [みらつ (miratsu)](https://www.pixiv.net/users/102593990) | Q版可爱风原创同人表情包 | 14张 |\n| [分享鲨壁纸网](https://www.fenxiangsha.com/search/255-0.html) | 管理界面背景壁纸来源 | — |\n\n### 🎵 推荐扩展表情包（需手动下载）\n\n| 套系 | 下载方式 | 数量 |\n|------|---------|------|\n| rsktter LINE表情包 | [萌绘网](https://www.moehui.com/255000.html) 提取码 `4pir` | 40张 |\n| 雪未来 LINE表情包 | [萌绘网](https://www.moehui.com/270702.html) 提取码 `j8bg` | 40张 |\n| 兔子洞 LINE表情包 | [萌绘网](https://www.moehui.com/253519.html) 提取码 `8icg` | 24张 |\n| Bib 画师表情包 | [Pixiv](https://www.pixiv.net/users/10899738) / [B站](https://m.bilibili.com/opus/617750888565244450) | — |\n\n"}, "0d8d44ba57a51a0a022c034e1f2b8b11c89eacda": {"t": 1785772746.1271544, "n": 10163, "h": "848f6da0d52ab5d6", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n| ----------- | ----- | ----------------------------------- |\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包注入 | ✅ 完成 | 情感检测 + 关键词匹配，自动插入初音表情包 |\n| Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n| 🎤 TTS 语音合成 | 🔌 可选 | Edge TTS 免费 / 网站反代 / RVC 本地 / AI 模型 |\n\n## 🏗️ 架构概览\n\n```mermaid\ngraph TB\n subgraph Client[\"📱 微信客户端\"]\n Bot[\"iLink Bot\"]\n end\n\n subgraph Gateway[\"🔀 Hermes Gateway (WSL2)\"]\n Miku[\"🎭 miku.skill<br/>角色引擎\"]\n Sticker[\"🎨 sticker<br/>表情包注入\"]\n Session[\"🧠 Session Manager<br/>永久记忆 + 压缩\"]\n end\n\n subgraph Backend[\"🤖 模型服务层\"]\n DeepSeek[\"deepseek-free-api<br/>💬 主对话<br/>Port :8000\"]\n Kimi[\"kimi-free-api<br/>🤖 Vision/提取<br/>Port :8002\"]\n end\n\n Client --> Gateway\n Gateway --> DeepSeek\n Gateway --> Kimi\n```\n\n***\n\n## 🚀 快速开始\n\n### 前置条件\n\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n\n详细步骤见 [docs/部署指南.md](docs/部署指南.md)，核心配置如下：\n\n```bash\n# 1. 复制配置模板\ncp config-example/config.yaml.example ~/.hermes/config.yaml\n\n# 2. 设置环境变量\ncat >> ~/.hermes/.env << 'EOF'\nDEEPSEEK_API_KEY=sk-your-deepseek-key\nHERMES_MAX_ITERATIONS=90\nDEEPSEEK_MODEL=deepseek-chat\nWEIXIN_DM_POLICY=open\nEOF\n\n# 3. 安装 Miku 角色技能\nmkdir -p ~/.hermes/skills/miku\ncp -r miku.skill/SKILL.md ~/.hermes/skills/miku/\ncp -r miku.skill/pictures/ ~/.hermes/skills/miku/pictures/\n\n# 4. 启用技能\nhermes skills enable miku\n```\n\n> 📚 **完整配置参考：** 更多详细配置（语音模式、TTS、辅助功能等）见：\n>\n> - [docs/PROJECT\\_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) — 完整配置结构\n> - [docs/部署指南.md](docs/部署指南.md) — 手把手部署教程\n> - [docs/操作指令参考.md](docs/操作指令参考.md) — 聊天指令大全\n\n### 4. 安装表情包功能\n\n将初音未来表情包注入引擎放入 Hermes 网关扩展目录：\n\n```bash\n# 复制表情包注入引擎\ncp gateway/sticker_injector.py $HERMES_HOME/gateway/sticker_injector.py\ncp gateway/sticker_cache.py $HERMES_HOME/gateway/sticker_cache.py\n\n# 表情包图片已在步骤 3 的 miku.skill/pictures/ 中安装\n# 重启网关后，miku 会自动根据情绪发送匹配的表情包\n```\n\n> `sticker_injector.py` 读取 `miku.skill/pictures/sticker_catalog.json`（表情包目录），支持 6 种情绪检测（开心/撒娇/安慰/傲娇/难过/惊讶/日常）+ 关键词匹配 + 时段感知，从 209 张初音表情包中自动选择最合适的。\n\n#### 🖼️ 可视化表情包管理系统\n\n提供 Web 可视化界面管理表情包，支持**上传、删除、分类**操作。界面采用**深色实体面板**（无玻璃模糊效果），使用您自己放入 `background/` 目录的壁纸作为背景，每 5 分钟自动轮播切换。\n\n**一键启动：** 双击 `miku.skill/pictures/启动表情包管理.bat`（自动安装 Flask 并打开浏览器）\n\n```bash\n# 或手动启动\ncd miku.skill/pictures\npip install flask\npython sticker_manager.py\n# 浏览器打开 http://localhost:5100\n```\n\n| 功能 | 操作 |\n|------|------|\n| 查看 | 按分类浏览所有表情包，搜索过滤 |\n| 上传 | 拖放/点击上传 PNG/JPG/WebP，自动归档到对应来源目录 |\n| 删除 | 悬停卡片点击 X 按钮，同时从 catalog 和磁盘删除 |\n| 分类 | 新建/编辑/删除情绪分类，配置触发词和场景（右键编辑） |\n| 壁纸 | 每 5 分钟自动循环 `background/` 目录中的多张壁纸 |\n\n> 💡 **添加/修改壁纸**：将 .jpg/.png 图片放入 `miku.skill/pictures/background/` 目录即可，系统自动识别并在 5 分钟循环中切换。推荐从 [分享鲨壁纸网 - 初音未来](https://www.fenxiangsha.com/search/255-0.html) 下载高清壁纸。\n\n### 5. 启动 Hermes → 连接微信\n\n```bash\n# 进入 WSL\nwsl.exe -d Ubuntu-24.04\n\n# 首次需配置微信（扫码登录）\nhermes gateway setup\n# 选择 Weixin → 等待二维码 → 手机微信扫码 → 确认登录\n\n# 启动微信网关\nhermes gateway start\n\n# 检查状态\nhermes gateway status\n```\n\n测试：用手机微信给 Bot 发 `miku`，初音未来就会回复你！♡\n\n### 6. 配置 TTS 语音（可选）\n\n编辑 `~/.hermes/config.yaml`，选择一种 TTS 方案：\n\n```yaml\ntts:\n provider: edge # 免费 Edge TTS\n edge:\n voice: zh-CN-XiaoxiaoNeural\n # 或使用 aivoicelab 初音未来角色语音（网站反代，需自行部署）\n # provider: aivoicelab\n # aivoicelab:\n # model: miku\n # model_name: us-female-hatsune-miku\n```\n\n重启网关后语音生效。详见 [gateway/tts\\_interface.py](gateway/tts_interface.py) 和 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n### 7. 配置辅助功能\n\n标题自动生成和网页内容提取走 kimi-free-api (Port 8002)，在 `~/.hermes/config.yaml` 中配置：\n\n```yaml\nauxiliary:\n title_generation:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token # 与 kimi-free-api 共用 token\n web_extract:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token\n timeout: 360 # 网页提取耗时较长，给足够超时\n```\n\n> **标题自动生成**：新会话的第一轮对话后，自动用 Kimi 摘要生成中文标题。\\\n> **网页内容提取**：在微信中发送 URL（如 B站视频、知乎文章），miku 会自动抓取内容并分析。\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── LICENSE # Apache 2.0\n├── miku.skill/ # 初音未来角色定义\n│ ├── SKILL.md # 人格、对话规则、示例\n│ └── pictures/ # 表情包管理\n│ ├── sticker_catalog.json # 表情包目录（6种情绪×209张贴纸，触发词+场景匹配）\n│ ├── sticker_manager.py # 可视化管理系统后端 (Flask)\n│ ├── sticker_manager.html # 可视化管理系统前端\n│ ├── background/ # 管理界面壁纸（5分钟循环）\n│ ├── 01_miratsu/ # みらつ Q版可爱风 (14张)\n│ └── 06_bilibili_200/ # B站官方V家表情包 (150张，7个主题)\n├── gateway/ # Hermes 网关扩展\n│ ├── sticker_injector.py # 情感表情包注入引擎\n│ ├── sticker_cache.py # 表情包描述缓存\n│ └── tts_interface.py # TTS 语音合成接口定义\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example # 含 TTS 可选方案注释\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── PROJECT_OVERVIEW.md # 项目总览（架构、配置、命令）\n ├── free-api-guide.md # 免费 API 部署详解\n ├── architecture.md # 系统架构说明\n ├── 部署指南.md # 从零部署教程\n └── 操作指令参考.md # 全部聊天指令 + 排查命令\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n| ----------------- | ------------ | ---- | ------------------- |\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群（Vision/压缩/提取） |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎤 语音指令\n\n在聊天中发送以下指令控制 TTS 语音行为：\n\n| 指令 | 效果 |\n| -------------------- | ------------ |\n| `/voice tts` | 所有回复都带语音（默认） |\n| `/voice on` | 仅回复语音消息时发语音 |\n| `/voice off` | 纯文字，不发语音 |\n| `/voice status` | 查看当前语音模式 |\n| `/voiceorder after` | 语音在文字+表情包之后发 |\n| `/voiceorder before` | 语音在文字+表情包之前发 |\n\n语音支持三种模式：**全量 TTS** → 所有回复带语音 / **语音回复** → 仅在收到语音时回复语音 / **关闭** → 纯文字静音。详细文档见 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## ⚖️ 角色版权与使用协议\n\n本项目使用的**初音未来 (Hatsune Miku)** 虚拟角色受以下协议保护：\n\n| 协议 | 适用对象 | 许可范围 |\n| ----------------------------------------------------------------------- | ---------------- | --------------- |\n| [PCL](https://piapro.jp/license/pcl/summary) (Piapro Character License) | 初音未来等 Crypton 角色 | 非营利二次创作、公开展示、分发 |\n| [CC BY-NC 3.0](https://creativecommons.org/licenses/by-nc/3.0/) | 角色原始插画 | 复制、改编、分发（非商业用途） |\n\n**使用要求：**\n\n- **非商业** — 禁止营利目的、禁止广告宣传、禁止收费\n- **署名** — 必须标注 `Hatsune Miku, © Crypton Future Media, Inc. 2007`\n- **CC 链接** — 在线发布时添加 `licensed under a CC BY-NC: https://creativecommons.org/licenses/by-nc/3.0/`\n- **商业用途** — 需联系 <intlbiz@crypton.co.jp> 获取单独授权\n\n**本项目遵守：** 本项目为个人非营利研究交流，角色 Skill 基于官方设定与同人文化创作，所有角色版权归 [Crypton Future Media, Inc.](https://www.crypton.co.jp/) 所有。\n\n详细使用条款: <https://piapro.jp/license/character_guideline>\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n\\####免责声明\n逆向API是不稳定的，建议前往MoonshotAI官方 <https://platform.moonshot.cn/> 付费使用API，避免封禁的风险。\n\n本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- [Crypton Future Media](https://www.crypton.co.jp/) - 初音未来角色版权方\n- [KEI](https://x.com/kei_garou) - 初音未来角色原画设计\n- [藤田咲](https://x.com/fujitasaki_pu) - 初音未来音源提供\n\n### 🎨 表情包来源\n\n| 来源 | 说明 | 数量 |\n|------|------|------|\n| [luotianyi-dev/vocaloid-bilibili-stickers](https://github.com/luotianyi-dev/vocaloid-bilibili-stickers) | B站官方V家全套表情包 (CC BY-NC 3.0) | 150张 |\n| [みらつ (miratsu)](https://www.pixiv.net/users/102593990) | Q版可爱风原创同人表情包 | 14张 |\n| [分享鲨壁纸网](https://www.fenxiangsha.com/search/255-0.html) | 管理界面背景壁纸来源 | — |\n\n"}, "fd1d079377bdff4291655f3421100b6f59c68e92": {"t": 1785772749.3918507, "n": 10587, "h": "64ae6597d7bf2c57", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n| ----------- | ----- | ----------------------------------- |\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包注入 | ✅ 完成 | 情感检测 + 关键词匹配，自动插入初音表情包 |\n| Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n| 🎤 TTS 语音合成 | 🔌 可选 | Edge TTS 免费 / 网站反代 / RVC 本地 / AI 模型 |\n\n## 🏗️ 架构概览\n\n```mermaid\ngraph TB\n subgraph Client[\"📱 微信客户端\"]\n Bot[\"iLink Bot\"]\n end\n\n subgraph Gateway[\"🔀 Hermes Gateway (WSL2)\"]\n Miku[\"🎭 miku.skill<br/>角色引擎\"]\n Sticker[\"🎨 sticker<br/>表情包注入\"]\n Session[\"🧠 Session Manager<br/>永久记忆 + 压缩\"]\n end\n\n subgraph Backend[\"🤖 模型服务层\"]\n DeepSeek[\"deepseek-free-api<br/>💬 主对话<br/>Port :8000\"]\n Kimi[\"kimi-free-api<br/>🤖 Vision/提取<br/>Port :8002\"]\n end\n\n Client --> Gateway\n Gateway --> DeepSeek\n Gateway --> Kimi\n```\n\n***\n\n## 🚀 快速开始\n\n### 前置条件\n\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n\n详细步骤见 [docs/部署指南.md](docs/部署指南.md)，核心配置如下：\n\n```bash\n# 1. 复制配置模板\ncp config-example/config.yaml.example ~/.hermes/config.yaml\n\n# 2. 设置环境变量\ncat >> ~/.hermes/.env << 'EOF'\nDEEPSEEK_API_KEY=sk-your-deepseek-key\nHERMES_MAX_ITERATIONS=90\nDEEPSEEK_MODEL=deepseek-chat\nWEIXIN_DM_POLICY=open\nEOF\n\n# 3. 安装 Miku 角色技能\nmkdir -p ~/.hermes/skills/miku\ncp -r miku.skill/SKILL.md ~/.hermes/skills/miku/\ncp -r miku.skill/pictures/ ~/.hermes/skills/miku/pictures/\n\n# 4. 启用技能\nhermes skills enable miku\n```\n\n> 📚 **完整配置参考：** 更多详细配置（语音模式、TTS、辅助功能等）见：\n>\n> - [docs/PROJECT\\_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) — 完整配置结构\n> - [docs/部署指南.md](docs/部署指南.md) — 手把手部署教程\n> - [docs/操作指令参考.md](docs/操作指令参考.md) — 聊天指令大全\n\n### 4. 安装表情包功能\n\n将初音未来表情包注入引擎放入 Hermes 网关扩展目录：\n\n```bash\n# 复制表情包注入引擎\ncp gateway/sticker_injector.py $HERMES_HOME/gateway/sticker_injector.py\ncp gateway/sticker_cache.py $HERMES_HOME/gateway/sticker_cache.py\n\n# 表情包图片已在步骤 3 的 miku.skill/pictures/ 中安装\n# 重启网关后，miku 会自动根据情绪发送匹配的表情包\n```\n\n> `sticker_injector.py` 读取 `miku.skill/pictures/sticker_catalog.json`（表情包目录），支持 6 种情绪检测（开心/撒娇/安慰/傲娇/难过/惊讶/日常）+ 关键词匹配 + 时段感知，从 209 张初音表情包中自动选择最合适的。\n\n#### 🖼️ 可视化表情包管理系统\n\n提供 Web 可视化界面管理表情包，支持**上传、删除、分类**操作。界面采用**深色实体面板**（无玻璃模糊效果），使用您自己放入 `background/` 目录的壁纸作为背景，每 5 分钟自动轮播切换。\n\n**一键启动：** 双击 `miku.skill/pictures/启动表情包管理.bat`（自动安装 Flask 并打开浏览器）\n\n```bash\n# 或手动启动\ncd miku.skill/pictures\npip install flask\npython sticker_manager.py\n# 浏览器打开 http://localhost:5100\n```\n\n| 功能 | 操作 |\n|------|------|\n| 查看 | 按分类浏览所有表情包，搜索过滤 |\n| 上传 | 拖放/点击上传 PNG/JPG/WebP，自动归档到对应来源目录 |\n| 删除 | 悬停卡片点击 X 按钮，同时从 catalog 和磁盘删除 |\n| 分类 | 新建/编辑/删除情绪分类，配置触发词和场景（右键编辑） |\n| 壁纸 | 每 5 分钟自动循环 `background/` 目录中的多张壁纸 |\n\n> 💡 **添加/修改壁纸**：将 .jpg/.png 图片放入 `miku.skill/pictures/background/` 目录即可，系统自动识别并在 5 分钟循环中切换。推荐从 [分享鲨壁纸网 - 初音未来](https://www.fenxiangsha.com/search/255-0.html) 下载高清壁纸。\n\n### 5. 启动 Hermes → 连接微信\n\n```bash\n# 进入 WSL\nwsl.exe -d Ubuntu-24.04\n\n# 首次需配置微信（扫码登录）\nhermes gateway setup\n# 选择 Weixin → 等待二维码 → 手机微信扫码 → 确认登录\n\n# 启动微信网关\nhermes gateway start\n\n# 检查状态\nhermes gateway status\n```\n\n测试：用手机微信给 Bot 发 `miku`，初音未来就会回复你！♡\n\n### 6. 配置 TTS 语音（可选）\n\n编辑 `~/.hermes/config.yaml`，选择一种 TTS 方案：\n\n```yaml\ntts:\n provider: edge # 免费 Edge TTS\n edge:\n voice: zh-CN-XiaoxiaoNeural\n # 或使用 aivoicelab 初音未来角色语音（网站反代，需自行部署）\n # provider: aivoicelab\n # aivoicelab:\n # model: miku\n # model_name: us-female-hatsune-miku\n```\n\n重启网关后语音生效。详见 [gateway/tts\\_interface.py](gateway/tts_interface.py) 和 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n### 7. 配置辅助功能\n\n标题自动生成和网页内容提取走 kimi-free-api (Port 8002)，在 `~/.hermes/config.yaml` 中配置：\n\n```yaml\nauxiliary:\n title_generation:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token # 与 kimi-free-api 共用 token\n web_extract:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token\n timeout: 360 # 网页提取耗时较长，给足够超时\n```\n\n> **标题自动生成**：新会话的第一轮对话后，自动用 Kimi 摘要生成中文标题。\\\n> **网页内容提取**：在微信中发送 URL（如 B站视频、知乎文章），miku 会自动抓取内容并分析。\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── LICENSE # Apache 2.0\n├── miku.skill/ # 初音未来角色定义\n│ ├── SKILL.md # 人格、对话规则、示例\n│ └── pictures/ # 表情包管理\n│ ├── sticker_catalog.json # 表情包目录（6种情绪×209张贴纸，触发词+场景匹配）\n│ ├── sticker_manager.py # 可视化管理系统后端 (Flask)\n│ ├── sticker_manager.html # 可视化管理系统前端\n│ ├── background/ # 管理界面壁纸（5分钟循环）\n│ ├── 01_miratsu/ # みらつ Q版可爱风 (14张)\n│ └── 06_bilibili_200/ # B站官方V家表情包 (150张，7个主题)\n├── gateway/ # Hermes 网关扩展\n│ ├── sticker_injector.py # 情感表情包注入引擎\n│ ├── sticker_cache.py # 表情包描述缓存\n│ └── tts_interface.py # TTS 语音合成接口定义\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example # 含 TTS 可选方案注释\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── PROJECT_OVERVIEW.md # 项目总览（架构、配置、命令）\n ├── free-api-guide.md # 免费 API 部署详解\n ├── architecture.md # 系统架构说明\n ├── 部署指南.md # 从零部署教程\n └── 操作指令参考.md # 全部聊天指令 + 排查命令\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n| ----------------- | ------------ | ---- | ------------------- |\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群（Vision/压缩/提取） |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎤 语音指令\n\n在聊天中发送以下指令控制 TTS 语音行为：\n\n| 指令 | 效果 |\n| -------------------- | ------------ |\n| `/voice tts` | 所有回复都带语音（默认） |\n| `/voice on` | 仅回复语音消息时发语音 |\n| `/voice off` | 纯文字，不发语音 |\n| `/voice status` | 查看当前语音模式 |\n| `/voiceorder after` | 语音在文字+表情包之后发 |\n| `/voiceorder before` | 语音在文字+表情包之前发 |\n\n语音支持三种模式：**全量 TTS** → 所有回复带语音 / **语音回复** → 仅在收到语音时回复语音 / **关闭** → 纯文字静音。详细文档见 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## ⚖️ 角色版权与使用协议\n\n本项目使用的**初音未来 (Hatsune Miku)** 虚拟角色受以下协议保护：\n\n| 协议 | 适用对象 | 许可范围 |\n| ----------------------------------------------------------------------- | ---------------- | --------------- |\n| [PCL](https://piapro.jp/license/pcl/summary) (Piapro Character License) | 初音未来等 Crypton 角色 | 非营利二次创作、公开展示、分发 |\n| [CC BY-NC 3.0](https://creativecommons.org/licenses/by-nc/3.0/) | 角色原始插画 | 复制、改编、分发（非商业用途） |\n\n**使用要求：**\n\n- **非商业** — 禁止营利目的、禁止广告宣传、禁止收费\n- **署名** — 必须标注 `Hatsune Miku, © Crypton Future Media, Inc. 2007`\n- **CC 链接** — 在线发布时添加 `licensed under a CC BY-NC: https://creativecommons.org/licenses/by-nc/3.0/`\n- **商业用途** — 需联系 <intlbiz@crypton.co.jp> 获取单独授权\n\n**本项目遵守：** 本项目为个人非营利研究交流，角色 Skill 基于官方设定与同人文化创作，所有角色版权归 [Crypton Future Media, Inc.](https://www.crypton.co.jp/) 所有。\n\n详细使用条款: <https://piapro.jp/license/character_guideline>\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n\\####免责声明\n逆向API是不稳定的，建议前往MoonshotAI官方 <https://platform.moonshot.cn/> 付费使用API，避免封禁的风险。\n\n本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- [Crypton Future Media](https://www.crypton.co.jp/) - 初音未来角色版权方\n- [KEI](https://x.com/kei_garou) - 初音未来角色原画设计\n- [藤田咲](https://x.com/fujitasaki_pu) - 初音未来音源提供\n\n### 🎨 表情包来源\n\n| 来源 | 说明 | 数量 |\n|------|------|------|\n| [luotianyi-dev/vocaloid-bilibili-stickers](https://github.com/luotianyi-dev/vocaloid-bilibili-stickers) | B站官方V家全套表情包 (CC BY-NC 3.0) | 150张 |\n| [みらつ (miratsu)](https://www.pixiv.net/users/102593990) | Q版可爱风原创同人表情包 | 14张 |\n| [分享鲨壁纸网](https://www.fenxiangsha.com/search/255-0.html) | 管理界面背景壁纸来源 | — |\n\n### 🎵 推荐扩展表情包（需手动下载）\n\n| 套系 | 下载方式 | 数量 |\n|------|---------|------|\n| rsktter LINE表情包 | [萌绘网](https://www.moehui.com/255000.html) 提取码 `4pir` | 40张 |\n| 雪未来 LINE表情包 | [萌绘网](https://www.moehui.com/270702.html) 提取码 `j8bg` | 40张 |\n| 兔子洞 LINE表情包 | [萌绘网](https://www.moehui.com/253519.html) 提取码 `8icg` | 24张 |\n| Bib 画师表情包 | [Pixiv](https://www.pixiv.net/users/10899738) / [B站](https://m.bilibili.com/opus/617750888565244450) | — |\n\n"}, "18db507bb1c1229066bcd5f3801b5dfdc25d6f0f": {"t": 1785772750.6489725, "n": 10597, "h": "1bd27c092e3503d2", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n| ----------- | ----- | ----------------------------------- |\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包注入 | ✅ 完成 | 情感检测 + 关键词匹配，自动插入初音表情包 |\n| Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n| 🎤 TTS 语音合成 | 🔌 可选 | Edge TTS 免费 / 网站反代 / RVC 本地 / AI 模型 |\n\n## 🏗️ 架构概览\n\n```mermaid\ngraph TB\n subgraph Client[\"📱 微信客户端\"]\n Bot[\"iLink Bot\"]\n end\n\n subgraph Gateway[\"🔀 Hermes Gateway (WSL2)\"]\n Miku[\"🎭 miku.skill<br/>角色引擎\"]\n Sticker[\"🎨 sticker<br/>表情包注入\"]\n Session[\"🧠 Session Manager<br/>永久记忆 + 压缩\"]\n end\n\n subgraph Backend[\"🤖 模型服务层\"]\n DeepSeek[\"deepseek-free-api<br/>💬 主对话<br/>Port :8000\"]\n Kimi[\"kimi-free-api<br/>🤖 Vision/提取<br/>Port :8002\"]\n end\n\n Client --> Gateway\n Gateway --> DeepSeek\n Gateway --> Kimi\n```\n\n***\n\n## 🚀 快速开始\n\n### 前置条件\n\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n\n详细步骤见 [docs/部署指南.md](docs/部署指南.md)，核心配置如下：\n\n```bash\n# 1. 复制配置模板\ncp config-example/config.yaml.example ~/.hermes/config.yaml\n\n# 2. 设置环境变量\ncat >> ~/.hermes/.env << 'EOF'\nDEEPSEEK_API_KEY=sk-your-deepseek-key\nHERMES_MAX_ITERATIONS=90\nDEEPSEEK_MODEL=deepseek-chat\nWEIXIN_DM_POLICY=open\nEOF\n\n# 3. 安装 Miku 角色技能\nmkdir -p ~/.hermes/skills/miku\ncp -r miku.skill/SKILL.md ~/.hermes/skills/miku/\ncp -r miku.skill/pictures/ ~/.hermes/skills/miku/pictures/\n\n# 4. 启用技能\nhermes skills enable miku\n```\n\n> 📚 **完整配置参考：** 更多详细配置（语音模式、TTS、辅助功能等）见：\n>\n> - [docs/PROJECT\\_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) — 完整配置结构\n> - [docs/部署指南.md](docs/部署指南.md) — 手把手部署教程\n> - [docs/操作指令参考.md](docs/操作指令参考.md) — 聊天指令大全\n\n### 4. 安装表情包功能\n\n将初音未来表情包注入引擎放入 Hermes 网关扩展目录：\n\n```bash\n# 复制表情包注入引擎\ncp gateway/sticker_injector.py $HERMES_HOME/gateway/sticker_injector.py\ncp gateway/sticker_cache.py $HERMES_HOME/gateway/sticker_cache.py\n\n# 表情包图片已在步骤 3 的 miku.skill/pictures/ 中安装\n# 重启网关后，miku 会自动根据情绪发送匹配的表情包\n```\n\n> `sticker_injector.py` 读取 `miku.skill/pictures/sticker_catalog.json`（表情包目录），支持 6 种情绪检测（开心/撒娇/安慰/傲娇/难过/惊讶/日常）+ 关键词匹配 + 时段感知，从 209 张初音表情包中自动选择最合适的。\n\n#### 🖼️ 可视化表情包管理系统\n\n提供 Web 可视化界面管理表情包，支持**上传、删除、分类**操作。界面采用**玻璃拟态设计**（`backdrop-filter: blur` + 半透明深色面板），确保在缤纷多彩的 Miku 壁纸上文字和按钮依然清晰可读。\n\n**一键启动：** 双击 `miku.skill/pictures/启动表情包管理.bat`（自动安装 Flask 并打开浏览器）\n\n```bash\n# 或手动启动\ncd miku.skill/pictures\npip install flask\npython sticker_manager.py\n# 浏览器打开 http://localhost:5100\n```\n\n| 功能 | 操作 |\n|------|------|\n| 查看 | 按分类浏览所有表情包，搜索过滤 |\n| 上传 | 拖放/点击上传 PNG/JPG/WebP，自动归档到对应来源目录 |\n| 删除 | 悬停卡片点击 X 按钮，同时从 catalog 和磁盘删除 |\n| 分类 | 新建/编辑/删除情绪分类，配置触发词和场景（右键编辑） |\n| 壁纸 | 每 5 分钟自动循环 `background/` 目录中的多张壁纸 |\n\n> 💡 **添加/修改壁纸**：将 .jpg/.png 图片放入 `miku.skill/pictures/background/` 目录即可，系统自动识别并在 5 分钟循环中切换。推荐从 [分享鲨壁纸网 - 初音未来](https://www.fenxiangsha.com/search/255-0.html) 下载高清壁纸。\n\n### 5. 启动 Hermes → 连接微信\n\n```bash\n# 进入 WSL\nwsl.exe -d Ubuntu-24.04\n\n# 首次需配置微信（扫码登录）\nhermes gateway setup\n# 选择 Weixin → 等待二维码 → 手机微信扫码 → 确认登录\n\n# 启动微信网关\nhermes gateway start\n\n# 检查状态\nhermes gateway status\n```\n\n测试：用手机微信给 Bot 发 `miku`，初音未来就会回复你！♡\n\n### 6. 配置 TTS 语音（可选）\n\n编辑 `~/.hermes/config.yaml`，选择一种 TTS 方案：\n\n```yaml\ntts:\n provider: edge # 免费 Edge TTS\n edge:\n voice: zh-CN-XiaoxiaoNeural\n # 或使用 aivoicelab 初音未来角色语音（网站反代，需自行部署）\n # provider: aivoicelab\n # aivoicelab:\n # model: miku\n # model_name: us-female-hatsune-miku\n```\n\n重启网关后语音生效。详见 [gateway/tts\\_interface.py](gateway/tts_interface.py) 和 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n### 7. 配置辅助功能\n\n标题自动生成和网页内容提取走 kimi-free-api (Port 8002)，在 `~/.hermes/config.yaml` 中配置：\n\n```yaml\nauxiliary:\n title_generation:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token # 与 kimi-free-api 共用 token\n web_extract:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token\n timeout: 360 # 网页提取耗时较长，给足够超时\n```\n\n> **标题自动生成**：新会话的第一轮对话后，自动用 Kimi 摘要生成中文标题。\\\n> **网页内容提取**：在微信中发送 URL（如 B站视频、知乎文章），miku 会自动抓取内容并分析。\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── LICENSE # Apache 2.0\n├── miku.skill/ # 初音未来角色定义\n│ ├── SKILL.md # 人格、对话规则、示例\n│ └── pictures/ # 表情包管理\n│ ├── sticker_catalog.json # 表情包目录（6种情绪×209张贴纸，触发词+场景匹配）\n│ ├── sticker_manager.py # 可视化管理系统后端 (Flask)\n│ ├── sticker_manager.html # 可视化管理系统前端\n│ ├── background/ # 管理界面壁纸（5分钟循环）\n│ ├── 01_miratsu/ # みらつ Q版可爱风 (14张)\n│ └── 06_bilibili_200/ # B站官方V家表情包 (150张，7个主题)\n├── gateway/ # Hermes 网关扩展\n│ ├── sticker_injector.py # 情感表情包注入引擎\n│ ├── sticker_cache.py # 表情包描述缓存\n│ └── tts_interface.py # TTS 语音合成接口定义\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example # 含 TTS 可选方案注释\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── PROJECT_OVERVIEW.md # 项目总览（架构、配置、命令）\n ├── free-api-guide.md # 免费 API 部署详解\n ├── architecture.md # 系统架构说明\n ├── 部署指南.md # 从零部署教程\n └── 操作指令参考.md # 全部聊天指令 + 排查命令\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n| ----------------- | ------------ | ---- | ------------------- |\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群（Vision/压缩/提取） |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎤 语音指令\n\n在聊天中发送以下指令控制 TTS 语音行为：\n\n| 指令 | 效果 |\n| -------------------- | ------------ |\n| `/voice tts` | 所有回复都带语音（默认） |\n| `/voice on` | 仅回复语音消息时发语音 |\n| `/voice off` | 纯文字，不发语音 |\n| `/voice status` | 查看当前语音模式 |\n| `/voiceorder after` | 语音在文字+表情包之后发 |\n| `/voiceorder before` | 语音在文字+表情包之前发 |\n\n语音支持三种模式：**全量 TTS** → 所有回复带语音 / **语音回复** → 仅在收到语音时回复语音 / **关闭** → 纯文字静音。详细文档见 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## ⚖️ 角色版权与使用协议\n\n本项目使用的**初音未来 (Hatsune Miku)** 虚拟角色受以下协议保护：\n\n| 协议 | 适用对象 | 许可范围 |\n| ----------------------------------------------------------------------- | ---------------- | --------------- |\n| [PCL](https://piapro.jp/license/pcl/summary) (Piapro Character License) | 初音未来等 Crypton 角色 | 非营利二次创作、公开展示、分发 |\n| [CC BY-NC 3.0](https://creativecommons.org/licenses/by-nc/3.0/) | 角色原始插画 | 复制、改编、分发（非商业用途） |\n\n**使用要求：**\n\n- **非商业** — 禁止营利目的、禁止广告宣传、禁止收费\n- **署名** — 必须标注 `Hatsune Miku, © Crypton Future Media, Inc. 2007`\n- **CC 链接** — 在线发布时添加 `licensed under a CC BY-NC: https://creativecommons.org/licenses/by-nc/3.0/`\n- **商业用途** — 需联系 <intlbiz@crypton.co.jp> 获取单独授权\n\n**本项目遵守：** 本项目为个人非营利研究交流，角色 Skill 基于官方设定与同人文化创作，所有角色版权归 [Crypton Future Media, Inc.](https://www.crypton.co.jp/) 所有。\n\n详细使用条款: <https://piapro.jp/license/character_guideline>\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n\\####免责声明\n逆向API是不稳定的，建议前往MoonshotAI官方 <https://platform.moonshot.cn/> 付费使用API，避免封禁的风险。\n\n本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- [Crypton Future Media](https://www.crypton.co.jp/) - 初音未来角色版权方\n- [KEI](https://x.com/kei_garou) - 初音未来角色原画设计\n- [藤田咲](https://x.com/fujitasaki_pu) - 初音未来音源提供\n\n### 🎨 表情包来源\n\n| 来源 | 说明 | 数量 |\n|------|------|------|\n| [luotianyi-dev/vocaloid-bilibili-stickers](https://github.com/luotianyi-dev/vocaloid-bilibili-stickers) | B站官方V家全套表情包 (CC BY-NC 3.0) | 150张 |\n| [みらつ (miratsu)](https://www.pixiv.net/users/102593990) | Q版可爱风原创同人表情包 | 14张 |\n| [分享鲨壁纸网](https://www.fenxiangsha.com/search/255-0.html) | 管理界面背景壁纸来源 | — |\n\n### 🎵 推荐扩展表情包（需手动下载）\n\n| 套系 | 下载方式 | 数量 |\n|------|---------|------|\n| rsktter LINE表情包 | [萌绘网](https://www.moehui.com/255000.html) 提取码 `4pir` | 40张 |\n| 雪未来 LINE表情包 | [萌绘网](https://www.moehui.com/270702.html) 提取码 `j8bg` | 40张 |\n| 兔子洞 LINE表情包 | [萌绘网](https://www.moehui.com/253519.html) 提取码 `8icg` | 24张 |\n| Bib 画师表情包 | [Pixiv](https://www.pixiv.net/users/10899738) / [B站](https://m.bilibili.com/opus/617750888565244450) | — |\n\n"}, "42a37949b442028ad685f2c02f2af13a2e5b8546": {"t": 1785772751.845402, "n": 10441, "h": "3fe319bc557dedbb", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n| ----------- | ----- | ----------------------------------- |\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包注入 | ✅ 完成 | 情感检测 + 关键词匹配，自动插入初音表情包 |\n| Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n| 🎤 TTS 语音合成 | 🔌 可选 | Edge TTS 免费 / 网站反代 / RVC 本地 / AI 模型 |\n\n## 🏗️ 架构概览\n\n```mermaid\ngraph TB\n subgraph Client[\"📱 微信客户端\"]\n Bot[\"iLink Bot\"]\n end\n\n subgraph Gateway[\"🔀 Hermes Gateway (WSL2)\"]\n Miku[\"🎭 miku.skill<br/>角色引擎\"]\n Sticker[\"🎨 sticker<br/>表情包注入\"]\n Session[\"🧠 Session Manager<br/>永久记忆 + 压缩\"]\n end\n\n subgraph Backend[\"🤖 模型服务层\"]\n DeepSeek[\"deepseek-free-api<br/>💬 主对话<br/>Port :8000\"]\n Kimi[\"kimi-free-api<br/>🤖 Vision/提取<br/>Port :8002\"]\n end\n\n Client --> Gateway\n Gateway --> DeepSeek\n Gateway --> Kimi\n```\n\n***\n\n## 🚀 快速开始\n\n### 前置条件\n\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n\n详细步骤见 [docs/部署指南.md](docs/部署指南.md)，核心配置如下：\n\n```bash\n# 1. 复制配置模板\ncp config-example/config.yaml.example ~/.hermes/config.yaml\n\n# 2. 设置环境变量\ncat >> ~/.hermes/.env << 'EOF'\nDEEPSEEK_API_KEY=sk-your-deepseek-key\nHERMES_MAX_ITERATIONS=90\nDEEPSEEK_MODEL=deepseek-chat\nWEIXIN_DM_POLICY=open\nEOF\n\n# 3. 安装 Miku 角色技能\nmkdir -p ~/.hermes/skills/miku\ncp -r miku.skill/SKILL.md ~/.hermes/skills/miku/\ncp -r miku.skill/pictures/ ~/.hermes/skills/miku/pictures/\n\n# 4. 启用技能\nhermes skills enable miku\n```\n\n> 📚 **完整配置参考：** 更多详细配置（语音模式、TTS、辅助功能等）见：\n>\n> - [docs/PROJECT\\_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) — 完整配置结构\n> - [docs/部署指南.md](docs/部署指南.md) — 手把手部署教程\n> - [docs/操作指令参考.md](docs/操作指令参考.md) — 聊天指令大全\n\n### 4. 安装表情包功能\n\n将初音未来表情包注入引擎放入 Hermes 网关扩展目录：\n\n```bash\n# 复制表情包注入引擎\ncp gateway/sticker_injector.py $HERMES_HOME/gateway/sticker_injector.py\ncp gateway/sticker_cache.py $HERMES_HOME/gateway/sticker_cache.py\n\n# 表情包图片已在步骤 3 的 miku.skill/pictures/ 中安装\n# 重启网关后，miku 会自动根据情绪发送匹配的表情包\n```\n\n> `sticker_injector.py` 读取 `miku.skill/pictures/sticker_catalog.json`（表情包目录），支持 6 种情绪检测（开心/撒娇/安慰/傲娇/难过/惊讶/日常）+ 关键词匹配 + 时段感知，从 209 张初音表情包中自动选择最合适的。\n\n#### 🖼️ 可视化表情包管理系统\n\n提供 Web 可视化界面管理表情包，支持**上传、删除、分类**操作：\n\n```bash\ncd miku.skill/pictures\npip install flask\npython sticker_manager.py\n# 浏览器打开 http://localhost:5100\n```\n\n| 功能 | 操作 |\n|------|------|\n| 查看 | 按分类浏览所有表情包，搜索过滤 |\n| 上传 | 拖放/点击上传 PNG/JPG/WebP，自动归档到对应来源目录 |\n| 删除 | 悬停卡片点击 X 按钮，同时从 catalog 和磁盘删除 |\n| 分类 | 新建/编辑/删除情绪分类，配置触发词和场景 |\n| 壁纸 | 每 5 分钟自动循环 background/ 目录中的壁纸（右键编辑分类） |\n\n> 💡 **添加/修改壁纸**：将 .jpg/.png 图片放入 `miku.skill/pictures/background/` 目录即可，系统自动识别并在 5 分钟循环中切换。推荐从 [分享鲨壁纸网 - 初音未来](https://www.fenxiangsha.com/search/255-0.html) 下载高清壁纸。\n\n### 5. 启动 Hermes → 连接微信\n\n```bash\n# 进入 WSL\nwsl.exe -d Ubuntu-24.04\n\n# 首次需配置微信（扫码登录）\nhermes gateway setup\n# 选择 Weixin → 等待二维码 → 手机微信扫码 → 确认登录\n\n# 启动微信网关\nhermes gateway start\n\n# 检查状态\nhermes gateway status\n```\n\n测试：用手机微信给 Bot 发 `miku`，初音未来就会回复你！♡\n\n### 6. 配置 TTS 语音（可选）\n\n编辑 `~/.hermes/config.yaml`，选择一种 TTS 方案：\n\n```yaml\ntts:\n provider: edge # 免费 Edge TTS\n edge:\n voice: zh-CN-XiaoxiaoNeural\n # 或使用 aivoicelab 初音未来角色语音（网站反代，需自行部署）\n # provider: aivoicelab\n # aivoicelab:\n # model: miku\n # model_name: us-female-hatsune-miku\n```\n\n重启网关后语音生效。详见 [gateway/tts\\_interface.py](gateway/tts_interface.py) 和 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n### 7. 配置辅助功能\n\n标题自动生成和网页内容提取走 kimi-free-api (Port 8002)，在 `~/.hermes/config.yaml` 中配置：\n\n```yaml\nauxiliary:\n title_generation:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token # 与 kimi-free-api 共用 token\n web_extract:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token\n timeout: 360 # 网页提取耗时较长，给足够超时\n```\n\n> **标题自动生成**：新会话的第一轮对话后，自动用 Kimi 摘要生成中文标题。\\\n> **网页内容提取**：在微信中发送 URL（如 B站视频、知乎文章），miku 会自动抓取内容并分析。\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── LICENSE # Apache 2.0\n├── miku.skill/ # 初音未来角色定义\n│ ├── SKILL.md # 人格、对话规则、示例\n│ └── pictures/ # 表情包管理\n│ ├── sticker_catalog.json # 表情包目录（6种情绪×209张贴纸，触发词+场景匹配）\n│ ├── sticker_manager.py # 可视化管理系统后端 (Flask)\n│ ├── sticker_manager.html # 可视化管理系统前端\n│ ├── background/ # 管理界面壁纸（5分钟循环）\n│ ├── 01_miratsu/ # みらつ Q版可爱风 (14张)\n│ └── 06_bilibili_200/ # B站官方V家表情包 (150张，7个主题)\n├── gateway/ # Hermes 网关扩展\n│ ├── sticker_injector.py # 情感表情包注入引擎\n│ ├── sticker_cache.py # 表情包描述缓存\n│ └── tts_interface.py # TTS 语音合成接口定义\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example # 含 TTS 可选方案注释\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── PROJECT_OVERVIEW.md # 项目总览（架构、配置、命令）\n ├── free-api-guide.md # 免费 API 部署详解\n ├── architecture.md # 系统架构说明\n ├── 部署指南.md # 从零部署教程\n └── 操作指令参考.md # 全部聊天指令 + 排查命令\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n| ----------------- | ------------ | ---- | ------------------- |\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群（Vision/压缩/提取） |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎤 语音指令\n\n在聊天中发送以下指令控制 TTS 语音行为：\n\n| 指令 | 效果 |\n| -------------------- | ------------ |\n| `/voice tts` | 所有回复都带语音（默认） |\n| `/voice on` | 仅回复语音消息时发语音 |\n| `/voice off` | 纯文字，不发语音 |\n| `/voice status` | 查看当前语音模式 |\n| `/voiceorder after` | 语音在文字+表情包之后发 |\n| `/voiceorder before` | 语音在文字+表情包之前发 |\n\n语音支持三种模式：**全量 TTS** → 所有回复带语音 / **语音回复** → 仅在收到语音时回复语音 / **关闭** → 纯文字静音。详细文档见 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## ⚖️ 角色版权与使用协议\n\n本项目使用的**初音未来 (Hatsune Miku)** 虚拟角色受以下协议保护：\n\n| 协议 | 适用对象 | 许可范围 |\n| ----------------------------------------------------------------------- | ---------------- | --------------- |\n| [PCL](https://piapro.jp/license/pcl/summary) (Piapro Character License) | 初音未来等 Crypton 角色 | 非营利二次创作、公开展示、分发 |\n| [CC BY-NC 3.0](https://creativecommons.org/licenses/by-nc/3.0/) | 角色原始插画 | 复制、改编、分发（非商业用途） |\n\n**使用要求：**\n\n- **非商业** — 禁止营利目的、禁止广告宣传、禁止收费\n- **署名** — 必须标注 `Hatsune Miku, © Crypton Future Media, Inc. 2007`\n- **CC 链接** — 在线发布时添加 `licensed under a CC BY-NC: https://creativecommons.org/licenses/by-nc/3.0/`\n- **商业用途** — 需联系 <intlbiz@crypton.co.jp> 获取单独授权\n\n**本项目遵守：** 本项目为个人非营利研究交流，角色 Skill 基于官方设定与同人文化创作，所有角色版权归 [Crypton Future Media, Inc.](https://www.crypton.co.jp/) 所有。\n\n详细使用条款: <https://piapro.jp/license/character_guideline>\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n\\####免责声明\n逆向API是不稳定的，建议前往MoonshotAI官方 <https://platform.moonshot.cn/> 付费使用API，避免封禁的风险。\n\n本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- [Crypton Future Media](https://www.crypton.co.jp/) - 初音未来角色版权方\n- [KEI](https://x.com/kei_garou) - 初音未来角色原画设计\n- [藤田咲](https://x.com/fujitasaki_pu) - 初音未来音源提供\n\n### 🎨 表情包来源\n\n| 来源 | 说明 | 数量 |\n|------|------|------|\n| [luotianyi-dev/vocaloid-bilibili-stickers](https://github.com/luotianyi-dev/vocaloid-bilibili-stickers) | B站官方V家全套表情包 (CC BY-NC 3.0) | 150张 |\n| [みらつ (miratsu)](https://www.pixiv.net/users/102593990) | Q版可爱风原创同人表情包 | 14张 |\n| [分享鲨壁纸网](https://www.fenxiangsha.com/search/255-0.html) | 管理界面背景壁纸来源 | — |\n\n### 🎵 推荐扩展表情包（需手动下载）\n\n| 套系 | 下载方式 | 数量 |\n|------|---------|------|\n| rsktter LINE表情包 | [萌绘网](https://www.moehui.com/255000.html) 提取码 `4pir` | 40张 |\n| 雪未来 LINE表情包 | [萌绘网](https://www.moehui.com/270702.html) 提取码 `j8bg` | 40张 |\n| 兔子洞 LINE表情包 | [萌绘网](https://www.moehui.com/253519.html) 提取码 `8icg` | 24张 |\n| Bib 画师表情包 | [Pixiv](https://www.pixiv.net/users/10899738) / [B站](https://m.bilibili.com/opus/617750888565244450) | — |\n\n"}, "45bc66b37328fc6c1db4a46738e38c9c6fc55dc9": {"t": 1785772753.1420693, "n": 9472, "h": "4b91171ab9ae5311", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n| ----------- | ----- | ----------------------------------- |\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包注入 | ✅ 完成 | 情感检测 + 关键词匹配，自动插入初音表情包 |\n| Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n| 🎤 TTS 语音合成 | 🔌 可选 | Edge TTS 免费 / 网站反代 / RVC 本地 / AI 模型 |\n\n## 🏗️ 架构概览\n\n```mermaid\ngraph TB\n subgraph Client[\"📱 微信客户端\"]\n Bot[\"iLink Bot\"]\n end\n\n subgraph Gateway[\"🔀 Hermes Gateway (WSL2)\"]\n Miku[\"🎭 miku.skill<br/>角色引擎\"]\n Sticker[\"🎨 sticker<br/>表情包注入\"]\n Session[\"🧠 Session Manager<br/>永久记忆 + 压缩\"]\n end\n\n subgraph Backend[\"🤖 模型服务层\"]\n DeepSeek[\"deepseek-free-api<br/>💬 主对话<br/>Port :8000\"]\n Kimi[\"kimi-free-api<br/>🤖 Vision/提取<br/>Port :8002\"]\n end\n\n Client --> Gateway\n Gateway --> DeepSeek\n Gateway --> Kimi\n```\n\n***\n\n## 🚀 快速开始\n\n### 前置条件\n\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n\n详细步骤见 [docs/部署指南.md](docs/部署指南.md)，核心配置如下：\n\n```bash\n# 1. 复制配置模板\ncp config-example/config.yaml.example ~/.hermes/config.yaml\n\n# 2. 设置环境变量\ncat >> ~/.hermes/.env << 'EOF'\nDEEPSEEK_API_KEY=sk-your-deepseek-key\nHERMES_MAX_ITERATIONS=90\nDEEPSEEK_MODEL=deepseek-chat\nWEIXIN_DM_POLICY=open\nEOF\n\n# 3. 安装 Miku 角色技能\nmkdir -p ~/.hermes/skills/miku\ncp -r miku.skill/SKILL.md ~/.hermes/skills/miku/\ncp -r miku.skill/pictures/ ~/.hermes/skills/miku/pictures/\n\n# 4. 启用技能\nhermes skills enable miku\n```\n\n> 📚 **完整配置参考：** 更多详细配置（语音模式、TTS、辅助功能等）见：\n>\n> - [docs/PROJECT\\_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) — 完整配置结构\n> - [docs/部署指南.md](docs/部署指南.md) — 手把手部署教程\n> - [docs/操作指令参考.md](docs/操作指令参考.md) — 聊天指令大全\n\n### 4. 安装表情包功能\n\n将初音未来表情包注入引擎放入 Hermes 网关扩展目录：\n\n```bash\n# 复制表情包注入引擎\ncp gateway/sticker_injector.py $HERMES_HOME/gateway/sticker_injector.py\ncp gateway/sticker_cache.py $HERMES_HOME/gateway/sticker_cache.py\n\n# 表情包图片已在步骤 3 的 miku.skill/pictures/ 中安装\n# 重启网关后，miku 会自动根据情绪发送匹配的表情包\n```\n\n> `sticker_injector.py` 读取 `miku.skill/pictures/sticker_catalog.json`（表情包目录），支持 6 种情绪检测（开心/撒娇/安慰/傲娇/难过/惊讶/日常）+ 关键词匹配 + 时段感知，从 209 张初音表情包中自动选择最合适的。\n\n#### 🖼️ 可视化表情包管理系统\n\n提供 Web 可视化界面管理表情包，支持**上传、删除、分类**操作：\n\n```bash\ncd miku.skill/pictures\npip install flask\npython sticker_manager.py\n# 浏览器打开 http://localhost:5100\n```\n\n| 功能 | 操作 |\n|------|------|\n| 查看 | 按分类浏览所有表情包，搜索过滤 |\n| 上传 | 拖放/点击上传 PNG/JPG/WebP，自动归档到对应来源目录 |\n| 删除 | 悬停卡片点击 X 按钮，同时从 catalog 和磁盘删除 |\n| 分类 | 新建/编辑/删除情绪分类，配置触发词和场景 |\n| 壁纸 | 每 5 分钟自动循环 background/ 目录中的壁纸（右键编辑分类） |\n\n> 💡 **添加/修改壁纸**：将 .jpg/.png 图片放入 `miku.skill/pictures/background/` 目录即可，系统自动识别并在 5 分钟循环中切换。推荐从 [分享鲨壁纸网 - 初音未来](https://www.fenxiangsha.com/search/255-0.html) 下载高清壁纸。\n\n### 5. 启动 Hermes → 连接微信\n\n```bash\n# 进入 WSL\nwsl.exe -d Ubuntu-24.04\n\n# 首次需配置微信（扫码登录）\nhermes gateway setup\n# 选择 Weixin → 等待二维码 → 手机微信扫码 → 确认登录\n\n# 启动微信网关\nhermes gateway start\n\n# 检查状态\nhermes gateway status\n```\n\n测试：用手机微信给 Bot 发 `miku`，初音未来就会回复你！♡\n\n### 6. 配置 TTS 语音（可选）\n\n编辑 `~/.hermes/config.yaml`，选择一种 TTS 方案：\n\n```yaml\ntts:\n provider: edge # 免费 Edge TTS\n edge:\n voice: zh-CN-XiaoxiaoNeural\n # 或使用 aivoicelab 初音未来角色语音（网站反代，需自行部署）\n # provider: aivoicelab\n # aivoicelab:\n # model: miku\n # model_name: us-female-hatsune-miku\n```\n\n重启网关后语音生效。详见 [gateway/tts\\_interface.py](gateway/tts_interface.py) 和 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n### 7. 配置辅助功能\n\n标题自动生成和网页内容提取走 kimi-free-api (Port 8002)，在 `~/.hermes/config.yaml` 中配置：\n\n```yaml\nauxiliary:\n title_generation:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token # 与 kimi-free-api 共用 token\n web_extract:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token\n timeout: 360 # 网页提取耗时较长，给足够超时\n```\n\n> **标题自动生成**：新会话的第一轮对话后，自动用 Kimi 摘要生成中文标题。\\\n> **网页内容提取**：在微信中发送 URL（如 B站视频、知乎文章），miku 会自动抓取内容并分析。\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── LICENSE # Apache 2.0\n├── miku.skill/ # 初音未来角色定义\n│ ├── SKILL.md # 人格、对话规则、示例\n│ └── pictures/ # 表情包图片 + sticker_catalog.json\n│ ├── sticker_catalog.json # 表情包目录（6种情绪×209张贴纸，触发词+场景匹配）\n│ ├── 01_miratsu/ # みらつ Q版可爱风 (13张)\n│ └── 06_bilibili_200/ # B站官方V家表情包 (196张，7个主题)\n├── gateway/ # Hermes 网关扩展\n│ ├── sticker_injector.py # 情感表情包注入引擎\n│ ├── sticker_cache.py # 表情包描述缓存\n│ └── tts_interface.py # TTS 语音合成接口定义\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example # 含 TTS 可选方案注释\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── PROJECT_OVERVIEW.md # 项目总览（架构、配置、命令）\n ├── free-api-guide.md # 免费 API 部署详解\n ├── architecture.md # 系统架构说明\n ├── 部署指南.md # 从零部署教程\n └── 操作指令参考.md # 全部聊天指令 + 排查命令\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n| ----------------- | ------------ | ---- | ------------------- |\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群（Vision/压缩/提取） |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎤 语音指令\n\n在聊天中发送以下指令控制 TTS 语音行为：\n\n| 指令 | 效果 |\n| -------------------- | ------------ |\n| `/voice tts` | 所有回复都带语音（默认） |\n| `/voice on` | 仅回复语音消息时发语音 |\n| `/voice off` | 纯文字，不发语音 |\n| `/voice status` | 查看当前语音模式 |\n| `/voiceorder after` | 语音在文字+表情包之后发 |\n| `/voiceorder before` | 语音在文字+表情包之前发 |\n\n语音支持三种模式：**全量 TTS** → 所有回复带语音 / **语音回复** → 仅在收到语音时回复语音 / **关闭** → 纯文字静音。详细文档见 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## ⚖️ 角色版权与使用协议\n\n本项目使用的**初音未来 (Hatsune Miku)** 虚拟角色受以下协议保护：\n\n| 协议 | 适用对象 | 许可范围 |\n| ----------------------------------------------------------------------- | ---------------- | --------------- |\n| [PCL](https://piapro.jp/license/pcl/summary) (Piapro Character License) | 初音未来等 Crypton 角色 | 非营利二次创作、公开展示、分发 |\n| [CC BY-NC 3.0](https://creativecommons.org/licenses/by-nc/3.0/) | 角色原始插画 | 复制、改编、分发（非商业用途） |\n\n**使用要求：**\n\n- **非商业** — 禁止营利目的、禁止广告宣传、禁止收费\n- **署名** — 必须标注 `Hatsune Miku, © Crypton Future Media, Inc. 2007`\n- **CC 链接** — 在线发布时添加 `licensed under a CC BY-NC: https://creativecommons.org/licenses/by-nc/3.0/`\n- **商业用途** — 需联系 <intlbiz@crypton.co.jp> 获取单独授权\n\n**本项目遵守：** 本项目为个人非营利研究交流，角色 Skill 基于官方设定与同人文化创作，所有角色版权归 [Crypton Future Media, Inc.](https://www.crypton.co.jp/) 所有。\n\n详细使用条款: <https://piapro.jp/license/character_guideline>\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n\\####免责声明\n逆向API是不稳定的，建议前往MoonshotAI官方 <https://platform.moonshot.cn/> 付费使用API，避免封禁的风险。\n\n本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- [Crypton Future Media](https://www.crypton.co.jp/) - 初音未来角色版权方\n- [KEI](https://x.com/kei_garou) - 初音未来角色原画设计\n\n"}, "b9ebc29cb29e9def6911dae9fe00ab6eee5c1dad": {"t": 1785772754.3214247, "n": 8460, "h": "a3939293a726389b", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n| ------------- | ------ | ----------------------------------- |\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包注入 | ✅ 完成 | 情感检测 + 关键词匹配，自动插入初音表情包 |\n| Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n| 🎤 TTS 语音合成 | 🔌 可选 | Edge TTS 免费 / 网站反代 / RVC 本地 / AI 模型 |\n\n## 🏗️ 架构概览\n\n```mermaid\ngraph TB\n subgraph Client[\"📱 微信客户端\"]\n Bot[\"iLink Bot\"]\n end\n\n subgraph Gateway[\"🔀 Hermes Gateway (WSL2)\"]\n Miku[\"🎭 miku.skill<br/>角色引擎\"]\n Sticker[\"🎨 sticker<br/>表情包注入\"]\n Session[\"🧠 Session Manager<br/>永久记忆 + 压缩\"]\n end\n\n subgraph Backend[\"🤖 模型服务层\"]\n DeepSeek[\"deepseek-free-api<br/>💬 主对话<br/>Port :8000\"]\n Kimi[\"kimi-free-api<br/>🤖 Vision/提取<br/>Port :8002\"]\n end\n\n Client --> Gateway\n Gateway --> DeepSeek\n Gateway --> Kimi\n```\n\n---\n\n## 🚀 快速开始\n\n### 前置条件\n\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n\n详细步骤见 [docs/部署指南.md](docs/部署指南.md)，核心配置如下：\n\n```bash\n# 1. 复制配置模板\ncp config-example/config.yaml.example ~/.hermes/config.yaml\n\n# 2. 设置环境变量\ncat >> ~/.hermes/.env << 'EOF'\nDEEPSEEK_API_KEY=sk-your-deepseek-key\nHERMES_MAX_ITERATIONS=90\nDEEPSEEK_MODEL=deepseek-chat\nWEIXIN_DM_POLICY=open\nEOF\n\n# 3. 安装 Miku 角色技能\nmkdir -p ~/.hermes/skills/miku\ncp -r miku.skill/SKILL.md ~/.hermes/skills/miku/\ncp -r miku.skill/pictures/ ~/.hermes/skills/miku/pictures/\n\n# 4. 启用技能\nhermes skills enable miku\n```\n\n> 📚 **完整配置参考：** 更多详细配置（语音模式、TTS、辅助功能等）见：\n> - [docs/PROJECT_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) — 完整配置结构\n> - [docs/部署指南.md](docs/部署指南.md) — 手把手部署教程\n> - [docs/操作指令参考.md](docs/操作指令参考.md) — 聊天指令大全\n\n### 4. 安装表情包功能\n\n将初音未来表情包注入引擎放入 Hermes 网关扩展目录：\n\n```bash\n# 复制表情包注入引擎\ncp gateway/sticker_injector.py $HERMES_HOME/gateway/sticker_injector.py\ncp gateway/sticker_cache.py $HERMES_HOME/gateway/sticker_cache.py\n\n# 表情包图片已在步骤 3 的 miku.skill/pictures/ 中安装\n# 重启网关后，miku 会自动根据情绪发送匹配的表情包\n```\n\n> `sticker_injector.py` 支持 6 种情绪检测（开心/难过/害羞/生气/惊讶/日常）+ 关键词匹配 + 时段感知，从 209 张初音表情包中自动选择最合适的。\n\n### 5. 启动 Hermes → 连接微信\n\n```bash\n# 进入 WSL\nwsl.exe -d Ubuntu-24.04\n\n# 首次需配置微信（扫码登录）\nhermes gateway setup\n# 选择 Weixin → 等待二维码 → 手机微信扫码 → 确认登录\n\n# 启动微信网关\nhermes gateway start\n\n# 检查状态\nhermes gateway status\n```\n\n测试：用手机微信给 Bot 发 `miku`，初音未来就会回复你！♡\n\n### 6. 配置 TTS 语音（可选）\n\n编辑 `~/.hermes/config.yaml`，选择一种 TTS 方案：\n\n```yaml\ntts:\n provider: edge # 免费 Edge TTS\n edge:\n voice: zh-CN-XiaoxiaoNeural\n # 或使用 aivoicelab 初音未来角色语音（网站反代，需自行部署）\n # provider: aivoicelab\n # aivoicelab:\n # model: miku\n # model_name: us-female-hatsune-miku\n```\n\n重启网关后语音生效。详见 [gateway/tts_interface.py](gateway/tts_interface.py) 和 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n### 7. 配置辅助功能\n\n标题自动生成和网页内容提取走 kimi-free-api (Port 8002)，在 `~/.hermes/config.yaml` 中配置：\n\n```yaml\nauxiliary:\n title_generation:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token # 与 kimi-free-api 共用 token\n web_extract:\n model: kimi-latest\n base_url: http://127.0.0.1:8002/v1\n api_key: your-kimi-token\n timeout: 360 # 网页提取耗时较长，给足够超时\n```\n\n> **标题自动生成**：新会话的第一轮对话后，自动用 Kimi 摘要生成中文标题。 \n> **网页内容提取**：在微信中发送 URL（如 B站视频、知乎文章），miku 会自动抓取内容并分析。\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── LICENSE # Apache 2.0\n├── miku.skill/ # 初音未来角色定义\n│ ├── SKILL.md # 人格、对话规则、示例\n│ └── pictures/ # 表情包图片 + sticker_catalog.json\n├── gateway/ # Hermes 网关扩展\n│ ├── sticker_injector.py # 情感表情包注入引擎\n│ ├── sticker_cache.py # 表情包描述缓存\n│ └── tts_interface.py # TTS 语音合成接口定义\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example # 含 TTS 可选方案注释\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── PROJECT_OVERVIEW.md # 项目总览（架构、配置、命令）\n ├── free-api-guide.md # 免费 API 部署详解\n ├── architecture.md # 系统架构说明\n ├── 部署指南.md # 从零部署教程\n └── 操作指令参考.md # 全部聊天指令 + 排查命令\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n| ----------------- | ------------ | ---- | ----------------- |\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群（Vision/压缩/提取） |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎤 语音指令\n\n在聊天中发送以下指令控制 TTS 语音行为：\n\n| 指令 | 效果 |\n|------|------|\n| `/voice tts` | 所有回复都带语音（默认） |\n| `/voice on` | 仅回复语音消息时发语音 |\n| `/voice off` | 纯文字，不发语音 |\n| `/voice status` | 查看当前语音模式 |\n| `/voiceorder after` | 语音在文字+表情包之后发 |\n| `/voiceorder before` | 语音在文字+表情包之前发 |\n\n语音支持三种模式：**全量 TTS** → 所有回复带语音 / **语音回复** → 仅在收到语音时回复语音 / **关闭** → 纯文字静音。详细文档见 [docs/操作指令参考.md](docs/操作指令参考.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## ⚖️ 角色版权与使用协议\n\n本项目使用的**初音未来 (Hatsune Miku)** 虚拟角色受以下协议保护：\n\n| 协议 | 适用对象 | 许可范围 |\n|------|----------|----------|\n| [PCL](https://piapro.jp/license/pcl/summary) (Piapro Character License) | 初音未来等 Crypton 角色 | 非营利二次创作、公开展示、分发 |\n| [CC BY-NC 3.0](https://creativecommons.org/licenses/by-nc/3.0/) | 角色原始插画 | 复制、改编、分发（非商业用途） |\n\n**使用要求：**\n- **非商业** — 禁止营利目的、禁止广告宣传、禁止收费\n- **署名** — 必须标注 `Hatsune Miku, © Crypton Future Media, Inc. 2007`\n- **CC 链接** — 在线发布时添加 `licensed under a CC BY-NC: https://creativecommons.org/licenses/by-nc/3.0/`\n- **商业用途** — 需联系 intlbiz@crypton.co.jp 获取单独授权\n\n**本项目遵守：** 本项目为个人非营利研究交流，角色 Skill 基于官方设定与同人文化创作，所有角色版权归 [Crypton Future Media, Inc.](https://www.crypton.co.jp/) 所有。\n\n详细使用条款: https://piapro.jp/license/character_guideline\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n\\####免责声明\n逆向API是不稳定的，建议前往MoonshotAI官方 <https://platform.moonshot.cn/> 付费使用API，避免封禁的风险。\n\n本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- [Crypton Future Media](https://www.crypton.co.jp/) - 初音未来角色版权方\n- [KEI](https://x.com/kei_garou) - 初音未来角色原画设计\n- [藤田咲](https://x.com/fujitasaki_pu) - 初音未来音源提供 \n\n"}, "28d4f626493341ca3923f0036bd8e95e9ae80a22": {"t": 1785772757.732856, "n": 5106, "h": "9d4ad2801a7c8518", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n|------|------|------|\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包/图片生成 | 🔧 测试中 | CF Workers AI + Pollinations.ai 双后端 |\n| 🔄 Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n\n## 🏗️ 架构概览\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│ 微信客户端 (iLink Bot) │\n└──────────────────────────┬───────────────────────────────────┘\n │\n┌──────────────────────────▼───────────────────────────────────┐\n│ Hermes Gateway (WSL2, 8765) │\n│ ┌─────────────┐ ┌──────────────┐ ┌───────────────────┐ │\n│ │ miku.skill │ │ Image Gen │ │ Session Manager │ │\n│ │ (角色引擎) │ │ (CF Plugin) │ │ (永久记忆) │ │\n│ └─────────────┘ └──────────────┘ └───────────────────┘ │\n└──────────────────────────┬───────────────────────────────────┘\n │\n ┌────────────────┼────────────────┐\n ▼ ▼ ▼\n┌─────────────────┐ ┌──────────────┐ ┌──────────────┐\n│ deepseek-free-api│ │ kimi-free-api │ │CF/Pollinations│\n│ (Port 8000) │ │ (Port 8002) │ │ (Image Gen) │\n│ 主对话模型 │ │ 辅助模型群 │ │ 图片生成 │\n└─────────────────┘ └──────────────┘ └──────────────┘\n```\n\n## 🚀 快速开始\n\n### 前置条件\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n```bash\ncp config-example/config.yaml.example $HERMES_HOME/config.yaml\n# 编辑 config.yaml: 填入 Kimi token 和 DeepSeek API key\n```\n\n### 4. 安装生图插件\n```bash\ncp -r plugins/image_gen/cf/ $HERMES_HOME/../plugins/image_gen/cf/\n```\n\n### 5. 启动服务\n```bash\nbash scripts/start-all-services.sh\n```\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── miku.skill/ # 初音未来角色定义\n│ └── SKILL.md # 人格、对话规则、示例\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example\n├── plugins/ # 自定义 Hermes 插件\n│ └── image_gen/cf/ # 免费生图插件\n│ ├── plugin.yaml\n│ └── __init__.py\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── free-api-guide.md # 免费 API 部署详解\n └── architecture.md # 系统架构说明\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n|------|------|------|------|\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群 |\n| CF Workers AI | Cloudflare | (云端) | Flux 生图，免费 15 张/天 |\n| Pollinations.ai | Pollinations | (云端) | Flux 生图，匿名有限速 |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n####免责声明\n逆向API是不稳定的，建议前往MoonshotAI官方 https://platform.moonshot.cn/ 付费使用API，避免封禁的风险。\n\n本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- Crypton Future Media - 初音未来角色版权\n"}, "426208e86ef9037754f2e18ee2c3753d8c913995": {"t": 1785772760.0656304, "n": 4871, "h": "d7c02525dfb89cdf", "c": "# Miku Hermes Chat - 初音未来虚拟角色情感聊天系统\n\n[](https://github.com/NousResearch/hermes-agent)\n[](LICENSE)\n[]()\n[]()\n\n基于 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 框架构建的**初音未来（Hatsune Miku）虚拟角色情感聊天系统**。通过开源 Free API 反代技术实现零 API 费用的多模态 AI 女友体验，支持微信端实时对话、图片理解、长期记忆、上下文压缩及表情包生成。\n\n## ✨ 核心特性\n\n| 功能 | 状态 | 说明 |\n|------|------|------|\n| 💬 角色扮演聊天 | ✅ 完成 | 基于 miku.skill 的初音未来女友人格 |\n| 🖼️ 图片识别 | ✅ 完成 | 发送图片自动描述，支持多模态理解 |\n| 🧠 长期记忆 | ✅ 完成 | 会话永不自动重置，跨天记忆 |\n| 📦 上下文压缩 | ✅ 完成 | 自动压缩超长对话历史 |\n| 📝 标题自动生成 | ✅ 完成 | 会话自动命名 |\n| 🌐 网页内容提取 | ✅ 完成 | URL 发送即解析 |\n| 🎨 表情包/图片生成 | 🔧 测试中 | CF Workers AI + Pollinations.ai 双后端 |\n| 🔄 Token 自动刷新 | ✅ 完成 | Windows 任务计划程序定时刷新 |\n| ⚡ 24×7 保活 | ✅ 完成 | 关屏不关机，持续在线 |\n\n## 🏗️ 架构概览\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│ 微信客户端 (iLink Bot) │\n└──────────────────────────┬───────────────────────────────────┘\n │\n┌──────────────────────────▼───────────────────────────────────┐\n│ Hermes Gateway (WSL2, 8765) │\n│ ┌─────────────┐ ┌──────────────┐ ┌───────────────────┐ │\n│ │ miku.skill │ │ Image Gen │ │ Session Manager │ │\n│ │ (角色引擎) │ │ (CF Plugin) │ │ (永久记忆) │ │\n│ └─────────────┘ └──────────────┘ └───────────────────┘ │\n└──────────────────────────┬───────────────────────────────────┘\n │\n ┌────────────────┼────────────────┐\n ▼ ▼ ▼\n┌─────────────────┐ ┌──────────────┐ ┌──────────────┐\n│ deepseek-free-api│ │ kimi-free-api │ │CF/Pollinations│\n│ (Port 8000) │ │ (Port 8002) │ │ (Image Gen) │\n│ 主对话模型 │ │ 辅助模型群 │ │ 图片生成 │\n└─────────────────┘ └──────────────┘ └──────────────┘\n```\n\n## 🚀 快速开始\n\n### 前置条件\n- Windows 10/11 + WSL2 (Ubuntu 24.04)\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) 已安装\n- Python 3.12+, Node.js 18+\n\n### 1. 部署免费 API 反代\n```bash\n# deepseek-free-api (主对话)\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api.git\ncd deepseek-free-api && pip install -r requirements.txt\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# kimi-free-api (辅助模型 - 需 token)\ngit clone https://github.com/HuangJHong/kimi-free-api.git\ncd kimi-free-api && npm install && npm start # Port 8002\n```\n\n### 2. 安装 Miku Skill\n```bash\ncp -r miku.skill/ $HERMES_HOME/skills/miku/\n```\n\n### 3. 配置 Hermes\n```bash\ncp config-example/config.yaml.example $HERMES_HOME/config.yaml\n# 编辑 config.yaml: 填入 Kimi token 和 DeepSeek API key\n```\n\n### 4. 安装生图插件\n```bash\ncp -r plugins/image_gen/cf/ $HERMES_HOME/../plugins/image_gen/cf/\n```\n\n### 5. 启动服务\n```bash\nbash scripts/start-all-services.sh\n```\n\n## 📁 项目结构\n\n```\nmiku-hermes-chat/\n├── README.md # 本文件\n├── miku.skill/ # 初音未来角色定义\n│ └── SKILL.md # 人格、对话规则、示例\n├── config-example/ # 配置模板（已脱敏）\n│ └── config.yaml.example\n├── plugins/ # 自定义 Hermes 插件\n│ └── image_gen/cf/ # 免费生图插件\n│ ├── plugin.yaml\n│ └── __init__.py\n├── scripts/ # 运维脚本\n│ ├── start-all-services.sh # 全服务启动 (WSL2)\n│ ├── restart-gateway.sh # 网关重启\n│ ├── 启动Miku网关.bat # 一键重启 (Windows)\n│ ├── keep-awake.py # 系统保活\n│ ├── 睡眠保活模式.bat # 保活启动\n│ ├── refresh-kimi-token.py # Kimi Token 自动刷新\n│ ├── refresh-kimi-token.ps1 # Windows 任务计划\n│ └── refresh-kimi-token.bat # 刷新批处理\n└── docs/ # 文档\n ├── free-api-guide.md # 免费 API 部署详解\n └── architecture.md # 系统架构说明\n```\n\n## 🔑 免费 API 说明\n\n本项目完全基于**免费 API 反代**技术，实现零 API 费用：\n\n| 服务 | 上游 | 端口 | 说明 |\n|------|------|------|------|\n| deepseek-free-api | DeepSeek 网页版 | 8000 | 主对话，OpenAI 兼容 |\n| kimi-free-api | Kimi 网页版 | 8002 | 辅助模型群 |\n| CF Workers AI | Cloudflare | (云端) | Flux 生图，免费 15 张/天 |\n| Pollinations.ai | Pollinations | (云端) | Flux 生图，匿名有限速 |\n\n详细部署指南见 [docs/free-api-guide.md](docs/free-api-guide.md)。\n\n## 🎭 Role Character\n\n本项目使用了初音未来（Hatsune Miku）作为虚拟角色原型：\n- **官方设定**: Crypton Future Media\n- **形象设计**: KEI\n- **音源提供**: 藤田咲\n- **代表作品**: 甩葱歌、Tell Your World、世界第一的公主殿下\n\n角色 Skill 文件基于官方设定与同人文化创作，用于虚拟女友角色扮演体验。\n\n## 📄 License\n\nApache 2.0 - 详见 [LICENSE](LICENSE)\n\n## 🙏 致谢\n\n- [Nous Research](https://github.com/NousResearch) - Hermes Agent 框架\n- [LLM-Red-Team](https://github.com/LLM-Red-Team) - deepseek-free-api\n- [HuangJHong](https://github.com/HuangJHong) - kimi-free-api (Vision 修复)\n- [lzA6](https://github.com/lzA6) - arting-2api 参考\n- Crypton Future Media - 初音未来角色版权\n"}, "df0773af7bbe3f70aabfbe6b00ba190d1a952107": {"t": 1785772762.4358733, "n": 367, "h": "5e5e466b7f9e2aee", "c": "# miku-hermes-chat\n基于Hermes Agent的零 API 费用虚拟女友系统：通过开源 deepseek-free-api 和 kimi-free-api 实现完全免费多模态对话，支持微信端实时聊天、图片识别、长期记忆（永不丢会话）、上下文压缩、表情包生成及 24×7 保活。 核心亮点：角色扮演：基于 miku.skill 的初音未来女友人格 - 多模态理解：发图即识别描述 - 永久记忆：会话永不自动重置 - 表情包生成：CF Workers AI + Pollinations 双后端 - Token 自动刷新：Windows 任务计划定时续期 - 零 API 费用：完全基于网页版 API 反代 项目包含完整角色 Skill、配置模板、运维脚本及免费生图插件，适合学习 AI 架构或低成本体验虚拟角色对话\n"}}}} |