← 返回列表
⚠ 装前注意
MakoCode — 茉子版 Agent | Galgame 风格桌面 AI Agent，零门槛体验 Agent 的乐趣
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/8/14 · 已提供中文文档
综合分
57.3
GitHub 分
57.3
用户评分
—
★ Stars
150
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add liebaojun/MakoCode未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
🟢实装验证通过· 2026/9/18
由 dsh-plugin-verify（GitHub Actions）在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/17（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包makocode（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/17 08:24:39
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
MakoCode — 茉子版 Agent
一个自带完整 Galgame 界面的桌面 AI Agent
以《千恋＊万花》常陆茉子为主题形象，封装 Claude Code CLI 为沉浸式视觉小说体验
✨ 功能 •
🚀 快速开始 •
📦 安装 •
🔧 技术栈 •
📄 协议
✨ 功能
🎮 Galgame 沉浸界面
- 角色立绘系统：常陆茉子 + 朝武芳乃双角色，超 110 张 PNG 表情立绘
- 动态位置状态机：说话者居中放大，听者侧移缩小，0.7s 平滑过渡
- 场景背景：6 张和风场景（和室/浴室/餐厅/道场/旅店/神社），1.5s 淡入淡出
- BGM 系统：30+ 首千恋万花原声 BGM，按场景自动切换
- 樱花粒子：35 片花瓣永远飘落，随机大小/速度/旋转
- 思考气泡：AI 思考时弹出茉子风格俏皮话气泡
- 打字机效果：逐字显示 + Markdown 渲染 + KaTeX 公式支持
🗣️ 语音系统
- 30 条预生成问候语音（GPT-SoVITS TTS）
- 7 条思考语音（嗯.../喵.../啊...等）
- 语音缓存管理（FIFO 200MB 上限）
- 独立音量控制
🔀 多 LLM 后端
一键切换 9 家 AI 供应商：
| 供应商 | 预设 ID |
|--------|---------|
| 🚀 DeepSeek | deepseek |
| 🏛️ Anthropic | anthropic |
| 🔀 OpenRouter | openrouter |
| ⚡ 硅基流动 | siliconflow |
| ☁️ 阿里百炼 | dashscope |
| 🌋 火山方舟 | volcano |
| 💼 腾讯混元 | tencent |
| 🌙 Kimi | moonshot |
| 🔵 百度千帆 | qianfan |
🧙 首次配置向导
- 自动检测 Node.js / Git / Claude Code 安装状态
- 一键后台静默安装（内含 Node.js + Git 安装包）
- API 配置 + 连接测试
- 供应商预设弹窗一键填充
✏️ 角色定制
- 内置人设 Markdown 编辑器（主设定 + 世界观双标签）
- 支持修改角色性格、说话风格、世界观背景
- 保存后新会话生效
📂 新手友好
- 设置面板一键打开 Skills / 插件文件夹
- 文件上传（图片/文档/代码等，50MB 限制）
- 33 条快捷指令（输入 / 触发）
- 输入框自动扩展（多行支持）
- 存档系统（自动 + 手动 + 多槽位）
🔄 自动更新
- 应用内检查更新 + 后台下载
- NSIS 静默安装，无需手动重装
🚀 快速开始
方式一：下载安装器（推荐）
从 Releases 下载最新 MakoCode Setup x.x.x.exe，双击安装。
安装器会引导你完成：
1. 自动检测并安装 Node.js / Git / Claude Code
2. 配置 API（需自备 DeepSeek 或其他 LLM API Key）
3. 测试连接 → 进入茉子的世界
方式二：从源码运行
1. 克隆仓库
git clone https://github.com/liebaojun/makocode.git
cd makocode
2. 安装依赖
npm install
3. 配置 API Key
cp mako-settings.example.json mako-settings.json
编辑 mako-settings.json，填入你的 API Key
4. 启动
npm start
前置要求：Node.js ≥ 18、Git、Claude Code CLI（npm install -g @anthropic-ai/claude-code）
📦 安装
构建安装器
npm run build # 完整 NSIS 安装器 → dist/
npm run build:dir # 仅解压版（调试用）
安装器包含
| 组件 | 大小 | 说明 |
|------|------|------|
| MakoCode 源码 + 资源 | ~400MB | 含立绘/BGM/语音/界面 |
| Node.js 安装包 | ~32MB | 自动安装 |
| Git 安装包 | ~63MB | 自动安装 |
| Claude Code CLI | 在线下载 | npm 全局安装 |
🔧 技术栈
| 层面 | 技术 |
|------|------|
| 桌面框架 | Electron 31+ |
| 前端 | 原生 HTML + CSS + JavaScript（零框架） |
| 后端 | Node.js HTTP Server（零外部依赖） |
| AI 引擎 | Claude Code CLI |
| 构建/分发 | electron-builder + NSIS |
| 自动更新 | electron-updater (GitHub Releases) |
| Markdown | marked.js |
| 公式 | KaTeX |
| 语音 | GPT-SoVITS 预生成 WAV |
项目结构
makocode/
├── electron-main.js # Electron 主进程
├── server.js # HTTP 后端（聊天/设置/存档）
├── preload.js # Electron 桥接
├── galchat.html # 主界面（对话/角色/BGM/樱花）
├── wizard.html # 首次配置向导
├── package.json # 项目 + 构建配置
├── lib/ # 共享模块 (5 个)
│ ├── constants.js # 全局常量
│ ├── utils.js # 工具函数
│ ├── settings.js # 设置管理
│ ├── installer.js # 后台安装
│ └── llm-presets.js # LLM 供应商预设
├── assets/ # 游戏资源
│ ├── sprites/ # 角色立绘
│ ├── backgrounds/ # 场景背景
│ ├── bgm/ # 背景音乐
│ ├── voice/ # 语音
│ └── images/ # 头像/图标
├── bundled-tools/ # 预装工具 (Node.js MSI + Git EXE)
├── .claude/ # Claude Code 配置 + 茉子专属 skills
└── dist/ # 构建输出 (不在仓库中)
⚠️ 重要提示
版权声明
本软件中的角色立绘、背景音乐、背景图片等素材来自 柚子社《千恋＊万花》，版权归柚子社 (Yuzusoft) 所有。这些素材仅用于粉丝非商业用途。若权利人提出要求，将立即移除。
AI 生成内容
本软件使用 AI 大语言模型生成对话内容，其输出可能包含不准确或不适当的信息。用户应自行判断。
API 费用
使用本软件需要自备 LLM API Key（如 DeepSeek），可能产生 API 调用费用。
📄 许可证
- 代码：MIT License © 2026 liebaojun
- 素材：版权归柚子社 (Yuzusoft) 所有，仅限非商业用途
详见 LICENSE 文件。
MakoCode — 茉子酱 Agent
一款拥有完整 Galgame 风格界面的桌面 AI Agent
以《千恋＊万花》中的常陸茉子 (Hitachi Mako) 为角色主题，
将 Claude Code CLI 包装成沉浸式视觉小说体验
✨ 功能特性 •
🚀 快速开始 •
📦 安装 •
🔧 技术栈 •
📄 许可证
✨ 功能特性 {#features-en}
🎮 Galgame 沉浸式界面
- 角色立绘系统：双角色 —— 常陸茉子 + 朝武芳乃，超过 110 张 PNG 表情立绘
- 动态位置状态机：发言者居中并放大，聆听者移至侧边并缩小，0.7 秒平滑过渡
- 场景背景：6 个日式场景（日式房间 / 澡堂 / 餐厅 / 道场 / 旅馆 / 神社），1.5 秒淡入/淡出
- BGM 系统：来自 Senren＊Banka 的 30+ 首原创配乐，按场景自动切换
- 樱花粒子：35 片花瓣永久飘落，随机大小/速度/旋转
- 思考气泡：AI 思考时 Mako-chan 标志性的俏皮弹窗
- 打字机效果：逐字显示 + Markdown 渲染 + KaTeX 公式支持
🗣️ 语音系统
- 30 条预生成问候语音（GPT-SoVITS TTS）
- 7 条思考语音（“嗯……/喵……/啊……”等）
- 语音缓存管理（FIFO，上限 200MB）
- 独立音量控制
🔀 多 LLM 后端
一键切换 9 家 AI 提供商：
| 提供商 | 预设 ID |
|----------|-----------|
| 🚀 DeepSeek | deepseek |
| 🏛️ Anthropic | anthropic |
| 🔀 OpenRouter | openrouter |
| ⚡ SiliconFlow | siliconflow |
| ☁️ 阿里云 DashScope | dashscope |
| 🌋 火山引擎 | volcano |
| 💼 腾讯混元 | tencent |
| 🌙 Kimi（Moonshot） | moonshot |
| 🔵 百度千帆 | qianfan |
🧙 首次设置向导
- 自动检测 Node.js / Git / Claude Code 安装状态
- 一键静默后台安装（内置 Node.js + Git 安装程序）
- API 配置 + 连接测试
- 供应商预设弹窗，一键填充
✏️ 角色自定义
- 内置 Markdown 人格编辑器（主档案 + 世界观双标签页）
- 修改角色人格、说话风格和世界设定
- 对新会话生效
📂 新手友好
- 设置面板 — 一键打开 Skills / 插件文件夹
- 文件上传（图片/文档/代码，上限 50MB）
- 33 个快捷命令（输入 / 触发）
- 自动扩展输入框（支持多行）
- 存档系统（自动 + 手动 + 多槽位）
🔄 自动更新
- 应用内更新检查 + 后台下载
- NSIS 静默安装 — 无需手动重新安装
🚀 快速开始 {#quick-start-en}
方法 1：下载安装程序（推荐）
从 Releases 下载最新的 MakoCode Setup x.x.x.exe，双击安装。
安装程序会引导你完成：
1. 自动检测并安装 Node.js / Git / Claude Code
2. API 配置（自带 DeepSeek 或其他 LLM API Key）
3. 连接测试 → 进入 Mako-chan 的世界
方式 2：从源码运行
1. 克隆仓库
git clone https://github.com/liebaojun/makocode.git
cd makocode
2. 安装依赖
npm install
3. 配置 API Key
cp mako-settings.example.json mako-settings.json
编辑 mako-settings.json，填入你的 API Key
4. 启动
npm start
前置要求：Node.js ≥ 18、Git、Claude Code CLI（npm install -g @anthropic-ai/claude-code）
📦 安装 {#installation-en}
构建安装程序
npm run build # 完整 NSIS 安装程序 → dist/
npm run build:dir # 解压版本（调试用）
安装程序内容
| 组件 | 大小 | 说明 |
|-----------|------|-------------|
| MakoCode 源码 + 资源 | ~400MB | 立绘/BGM/语音/UI |
| Node.js 安装程序 | ~32MB | 自动安装 |
| Git 安装程序 | ~63MB | 自动安装 |
| Claude Code CLI | 在线下载 | npm 全局安装 |
🔧 技术栈 {#tech-stack-en}
| 层级 | 技术 |
|-------|-----------|
| 桌面框架 | Electron 31+ |
| 前端 | 原生 HTML + CSS + JavaScript（零框架） |
| 后端 | Node.js HTTP Server（零外部依赖） |
| AI 引擎 | Claude Code CLI |
| 构建/分发 | electron-builder + NSIS |
| 自动更新 | electron-updater（GitHub Releases） |
| Markdown | marked.js |
| 公式 | KaTeX |
| 语音 | GPT-SoVITS 预生成 WAV |
项目结构
makocode/
├── electron-main.js # Electron 主进程
├── server.js # HTTP 后端（聊天/设置/存档）
├── preload.js # Electron 桥接
├── galchat.html # 主 UI（聊天/角色/BGM/樱花）
├── wizard.html # 首次设置向导
├── package.json # 项目 + 构建配置
├── lib/ # 共享模块（5）
│ ├── constants.js # 全局常量
│ ├── utils.js # 工具函数
│ ├── settings.js # 设置管理
│ ├── installer.js # 后台安装程序
│ └── llm-presets.js # LLM 提供商预设
├── assets/ # 游戏资源
│ ├── sprites/ # 角色立绘
│ ├── backgrounds/ # 场景背景
│ ├── bgm/ # 背景音乐
│ ├── voice/ # 语音文件
│ └── images/ # 头像/图标
├── bundled-tools/ # 捆绑安装程序（Node.js MSI + Git EXE）
├── .claude/ # Claude Code 配置 + Mako 专属技能
└── dist/ # 构建输出（不在仓库中）
⚠️ 重要说明
版权声明
本软件中的角色立绘、背景音乐和背景图片来自 Yuzusoft 的《千恋＊万花》，版权 © Yuzusoft。这些素材仅供粉丝非商业使用。如权利人提出要求，将立即移除。
AI 生成内容
本软件使用 AI 大语言模型生成对话。输出内容可能包含不准确或不当信息。请用户自行斟酌。
API 费用
本软件需要您自备 LLM API Key（例如 DeepSeek）。可能会产生 API 调用费用。
📄 许可证 {#license-en}
- 代码：MIT License © 2026 liebaojun
- 素材：版权 © Yuzusoft，仅供非商业使用
详情请参阅 LICENSE。
用 ❤️ 为茉子酱粉丝制作扫码进群