liebaojun/MakoCode
一个自带完整 Galgame 界面的桌面 AI Agent 以《千恋＊万花》常陆茉子为主题形象，封装 Claude Code CLI 为沉浸式视觉小说体验 ✨ 功能 • 🚀 快速开始 • 📦 安装 • 🔧 技术栈 • 📄 协议 ---
catalog 简介 / catalog descriptioncatalog description：MakoCode — 茉子版 Agent | Galgame 风格桌面 AI Agent，零门槛体验 Agent 的乐趣
安装Install
dsh plugin --profile web add github:liebaojun/MakoCode把 liebaojun/MakoCode 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
MakoCode — 茉子版 Agent
一个自带完整 Galgame 界面的桌面 AI Agent
以《千恋＊万花》常陆茉子为主题形象，封装 Claude Code CLI 为沉浸式视觉小说体验
✨ 功能 • 🚀 快速开始 • 📦 安装 • 🔧 技术栈 • 📄 协议
✨ Features
🎮 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 静默安装，无需手动重装
🚀 Quick Start
方式一：下载安装器（推荐）
从 Releases 下载最新 MakoCode Setup x.x.x.exe，双击安装。
安装器会引导你完成：
- 自动检测并安装 Node.js / Git / Claude Code
- 配置 API（需自备 DeepSeek 或其他 LLM API Key）
- 测试连接 → 进入茉子的世界
方式二：从源码运行
# 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
构建安装器
npm run build # 完整 NSIS 安装器 → dist/
npm run build:dir # 仅解压版（调试用）
安装器包含
| 组件 | 大小 | 说明 |
|---|---|---|
| MakoCode 源码 + 资源 | ~400MB | 含立绘/BGM/语音/界面 |
| Node.js 安装包 | ~32MB | 自动安装 |
| Git 安装包 | ~63MB | 自动安装 |
| Claude Code CLI | 在线下载 | npm 全局安装 |
🔧 Tech Stack
| 层面 | 技术 |
|---|---|
| 桌面框架 | 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 调用费用。
📄 License
- 代码：MIT License © 2026 liebaojun
- 素材：版权归柚子社 (Yuzusoft) 所有，仅限非商业用途
详见 LICENSE 文件。
MakoCode — Mako-chan Agent
A desktop AI Agent with a full Galgame-style interface
Featuring 常陸茉子 (Hitachi Mako) from *Senren＊Banka* as the character theme,
wrapping Claude Code CLI into an immersive visual novel experience
✨ Features • 🚀 Quick Start • 📦 Installation • 🔧 Tech Stack • 📄 License
✨ Features {#features-en}
🎮 Galgame Immersive Interface
- Character Sprite System: Dual characters — 常陸茉子 + 朝武芳乃, over 110 PNG expression sprites
- Dynamic Position State Machine: Speaker centers & enlarges, listener shifts side & shrinks, 0.7s smooth transition
- Scene Backgrounds: 6 Japanese-style scenes (Japanese Room / Bathhouse / Dining Hall / Dojo / Inn / Shrine), 1.5s fade-in/out
- BGM System: 30+ original soundtracks from Senren＊Banka, auto-switching by scene
- Sakura Particles: 35 petals falling eternally, random size/speed/rotation
- Thinking Speech Bubble: Mako-chan's signature playful popup while AI is thinking
- Typewriter Effect: Character-by-character display + Markdown rendering + KaTeX formula support
🗣️ Voice System
- 30 pre-generated greeting voices (GPT-SoVITS TTS)
- 7 thinking voices ("Hmm.../Nya.../Ah..." etc.)
- Voice cache management (FIFO, 200MB cap)
- Independent volume control
🔀 Multi-LLM Backend
One-click switching across 9 AI providers:
| Provider | Preset ID |
|---|---|
| 🚀 DeepSeek | deepseek |
| 🏛️ Anthropic | anthropic |
| 🔀 OpenRouter | openrouter |
| ⚡ SiliconFlow | siliconflow |
| ☁️ Alibaba DashScope | dashscope |
| 🌋 Volcano Engine | volcano |
| 💼 Tencent Hunyuan | tencent |
| 🌙 Kimi (Moonshot) | moonshot |
| 🔵 Baidu Qianfan | qianfan |
🧙 First-Setup Wizard
- Auto-detects Node.js / Git / Claude Code installation status
- One-click silent background installation (bundled Node.js + Git installers)
- API configuration + connection test
- Vendor preset modal for one-click filling
✏️ Character Customization
- Built-in Markdown personality editor (main profile + world view dual tabs)
- Modify character personality, speech style, and world setting
- Takes effect on new sessions
📂 Beginner Friendly
- Settings panel — one-click open Skills / plugin folders
- File upload (images/documents/code, 50MB limit)
- 33 quick commands (triggered by typing
/) - Auto-expanding input box (multi-line support)
- Save system (auto + manual + multi-slot)
🔄 Auto-Update
- In-app update check + background download
- NSIS silent installation — no manual reinstall needed
🚀 Quick Start {#quick-start-en}
Method 1: Download Installer (Recommended)
Download the latest MakoCode Setup x.x.x.exe from Releases and double-click to install.
The installer guides you through:
- Auto-detection and installation of Node.js / Git / Claude Code
- API configuration (bring your own DeepSeek or other LLM API Key)
- Connection test → enter Mako-chan's world
Method 2: Run from Source
# 1. Clone the repository
git clone https://github.com/liebaojun/makocode.git
cd makocode
# 2. Install dependencies
npm install
# 3. Configure API Key
cp mako-settings.example.json mako-settings.json
# Edit mako-settings.json, fill in your API Key
# 4. Launch
npm start
Prerequisites: Node.js ≥ 18, Git, Claude Code CLI (npm install -g @anthropic-ai/claude-code)
📦 Installation {#installation-en}
Build Installer
npm run build # Full NSIS installer → dist/
npm run build:dir # Extracted version (debugging)
Installer Contents
| Component | Size | Description |
|---|---|---|
| MakoCode source + assets | ~400MB | Sprites/BGM/Voice/UI |
| Node.js installer | ~32MB | Auto-installed |
| Git installer | ~63MB | Auto-installed |
| Claude Code CLI | Online download | npm global install |
🔧 Tech Stack {#tech-stack-en}
| Layer | Technology |
|---|---|
| Desktop Framework | Electron 31+ |
| Frontend | Vanilla HTML + CSS + JavaScript (zero framework) |
| Backend | Node.js HTTP Server (zero external dependencies) |
| AI Engine | Claude Code CLI |
| Build/Distribution | electron-builder + NSIS |
| Auto-Update | electron-updater (GitHub Releases) |
| Markdown | marked.js |
| Formulas | KaTeX |
| Voice | GPT-SoVITS pre-generated WAV |
Project Structure
makocode/
├── electron-main.js # Electron main process
├── server.js # HTTP backend (chat/settings/save)
├── preload.js # Electron bridge
├── galchat.html # Main UI (chat/character/BGM/sakura)
├── wizard.html # First-setup wizard
├── package.json # Project + build config
├── lib/ # Shared modules (5)
│ ├── constants.js # Global constants
│ ├── utils.js # Utility functions
│ ├── settings.js # Settings management
│ ├── installer.js # Background installer
│ └── llm-presets.js # LLM provider presets
├── assets/ # Game resources
│ ├── sprites/ # Character sprites
│ ├── backgrounds/ # Scene backgrounds
│ ├── bgm/ # Background music
│ ├── voice/ # Voice files
│ └── images/ # Avatars/icons
├── bundled-tools/ # Bundled installers (Node.js MSI + Git EXE)
├── .claude/ # Claude Code config + Mako-exclusive skills
└── dist/ # Build output (not in repo)
⚠️ Important Notes
Copyright Notice
Character sprites, background music, and background images in this software are from Yuzusoft's Senren＊Banka, copyright © Yuzusoft. These assets are for fan non-commercial use only. They will be removed immediately upon request from the rights holder.
AI-Generated Content
This software uses AI large language models to generate dialogue. The output may contain inaccurate or inappropriate information. User discretion is advised.
API Fees
This software requires you to bring your own LLM API Key (e.g., DeepSeek). API call fees may apply.
📄 License {#license-en}
- Code: MIT License © 2026 liebaojun
- Assets: Copyright © Yuzusoft, non-commercial use only
See LICENSE for details.
Made with ❤️ for Mako-chan fans
相关推荐Related
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
anywhere-labs/deepseek-harness-desktop
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。
-
tt-a1i/archify
Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained…
-
freestylefly/awesome-gpt-image-2
Prompt as Code | GPT-Image2 工业级提示词引擎与模板库，470+ 个案例逆向工程，20+ 套工业级模板，并提炼出Skills，持续更新中
-
YaoApp/yao
✨ All your agents and workspaces in one place, on every device you own. Track tasks on a board, accessible from desktop,…
-
ZSeven-W/openpencil
The world's first open-source AI-native vector design tool and the first to feature concurrent Agent Teams. Design-as-Co…