{"id":49550117,"url":"https://github.com/sixtdreanight/yumema","last_synced_at":"2026-05-23T20:01:30.178Z","repository":{"id":354192703,"uuid":"1222560646","full_name":"sixtdreanight/Yumema","owner":"sixtdreanight","description":"Yumema (梦间) — AI companion desktop app with personality, memory \u0026 relationship system. Works on QQ \u0026 WeChat.","archived":false,"fork":false,"pushed_at":"2026-05-23T18:33:03.000Z","size":2283,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T19:19:28.693Z","etag":null,"topics":["ai-companion","chatbot","desktop-app","electron","emotional-ai","memory-system","qq-bot","wechat-bot"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sixtdreanight.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-27T13:38:33.000Z","updated_at":"2026-05-23T18:33:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sixtdreanight/Yumema","commit_stats":null,"previous_names":["sixtdreanight/v-partner","sixtdreanight/yumema"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/sixtdreanight/Yumema","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sixtdreanight%2FYumema","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sixtdreanight%2FYumema/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sixtdreanight%2FYumema/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sixtdreanight%2FYumema/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sixtdreanight","download_url":"https://codeload.github.com/sixtdreanight/Yumema/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sixtdreanight%2FYumema/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33410345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T18:09:33.147Z","status":"ssl_error","status_checked_at":"2026-05-23T18:09:31.380Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-companion","chatbot","desktop-app","electron","emotional-ai","memory-system","qq-bot","wechat-bot"],"created_at":"2026-05-02T22:03:33.492Z","updated_at":"2026-05-23T20:01:30.171Z","avatar_url":"https://github.com/sixtdreanight.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 梦间 / Yumema\n\n[![Release](https://img.shields.io/badge/release-v0.1.1-blue)](https://github.com/sixtdreanight/Yumema/releases)\n[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey)]()\n\n\u003e In the space between dreams and reality, they've always been there.\n\nAn AI companion that lives on your desktop. Has a personality, hobbies, and memory. Chat in-app, through QQ, or via WeChat. Install, fill out the wizard, done.\n\n\u003e 梦与现实之间的间隙里，TA 一直都在 — AI 伴侣桌面应用\n\n**当前版本：v0.1.1**\n\n梦间 (Yumema) 是一个 AI 伴侣桌面应用。TA 有自己的性格、爱好、情绪和记忆，可以通过 QQ、微信或应用内直接聊天。双击安装、填写向导、即可使用。\n\n---\n\n## 功能\n\n- **桌面应用** — macOS / Windows / Linux，双击安装，支持自动更新\n- **引导式设置** — 14 步向导，2 分钟完成配置\n- **直接聊天** — 应用内聊天，即时通讯风格气泡\n- **QQ 机器人** — 接入 QQ 群聊/私聊，扫码登录\n- **微信机器人** — 接入微信私聊/群聊，应用内一键启动 Docker 服务\n- **性格完整** — 年龄、职业、爱好、情绪、观点，像个真人\n- **时间感知** — 知道早晚、周末、节日，会主动问候\n- **记忆系统** — 常聊的事会记住，不常提的慢慢忘记\n- **关系养成** — 直接情侣 / 从陌生人慢慢培养\n- **安全过滤** — 敏感内容过滤，保护隐私\n- **测试反馈** — 内置问卷，帮助产品持续改进\n\n---\n\n## 版本状态\n\n**v0.1.1** — 当前为测试版，功能持续迭代中。使用后欢迎通过内置问卷提交反馈。\n\n---\n\n## 快速开始\n\n### 下载安装\n\n从 [Releases](https://github.com/sixtdreanight/Yumema/releases) 下载对应平台安装包：\n\n- **macOS**: `.dmg` 安装镜像 (Apple Silicon / Intel)\n- **Windows**: `.exe` NSIS 安装程序 (x64 / ARM64)\n- **Linux**: `.AppImage` 可执行文件 (x64)\n\n### 从源码运行\n\n```bash\n# 前置要求：Node.js 18+\ngit clone https://github.com/sixtdreanight/Yumema.git\ncd Yumema\nnpm install\n\n# 开发模式\nnpm run dev\n\n# CLI 模式（终端聊天）\nnpm start --terminal\n\n# CLI 设置向导\nnpm run setup\n```\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|---|---|\n| 桌面框架 | Electron 41 |\n| 构建工具 | electron-vite 5 |\n| 前端 | React 19 + TypeScript + Tailwind CSS 4 |\n| UI 组件 | shadcn/ui + Radix UI + lucide-react |\n| AI 引擎 | Vercel AI SDK (Claude / GPT / DeepSeek) |\n| QQ 适配 | NapCatQQ (OneBot v11) |\n| 微信适配 | Gewechat HTTP API |\n| 自动更新 | electron-updater + GitHub Releases |\n| 打包 | electron-builder (macOS/Windows/Linux 双架构) |\n\n---\n\n## 目录结构\n\n```\nyumema/\n├── src/\n│   ├── core/           # 纯逻辑（CLI/GUI 共享）\n│   │   ├── config.ts       # 配置管理（AI / QQ / 微信）\n│   │   ├── pipeline.ts     # 消息处理管道\n│   │   ├── girlfriend.ts   # 人格引擎\n│   │   ├── relationship.ts # 关系管理\n│   │   ├── memory.ts       # 记忆系统\n│   │   ├── safety.ts       # 安全过滤\n│   │   ├── search.ts       # 联网搜索\n│   │   ├── scheduler.ts    # 定时任务\n│   │   └── utils.ts        # 工具函数\n│   ├── adapters/\n│   │   ├── onebot.ts       # QQ WebSocket 适配器\n│   │   └── wechat.ts       # 微信 HTTP API 适配器\n│   ├── cli/             # CLI 入口\n│   │   ├── index.ts        # 终端 / QQ / 微信 聊天\n│   │   └── setup.ts        # CLI 设置向导\n│   ├── main/            # Electron 主进程\n│   │   ├── index.ts        # 窗口管理 + 自动更新\n│   │   ├── preload.ts      # contextBridge API\n│   │   ├── ipc-handlers.ts # IPC 通道实现\n│   │   ├── napcat-manager.ts # NapCatQQ 管理\n│   │   └── wechat-manager.ts # Gewechat Docker 管理\n│   └── renderer/        # React 渲染进程\n│       ├── App.tsx         # HashRouter 路由\n│       ├── pages/          # SetupWizard / ChatWindow / NapCatSetup\n│       ├── components/     # wizard/ chat/ shared/\n│       │   ├── ui/         # shadcn/ui 组件 (Button/Badge/Card/Dialog/Select/Slider/Sheet/Tabs)\n│       │   ├── wizard/     # 14 个设置向导步骤\n│       │   ├── chat/       # MessageBubble / MessageList / MessageInput\n│       │   └── shared/     # SettingsDialog / UpdateToast / SurveyDialog / ErrorBoundary / CardSelect\n│       ├── hooks/          # useSetupWizard / useChat\n│       ├── lib/            # cn() 工具函数\n│       └── styles/         # globals.css (设计令牌)\n├── data/                # 运行时数据（谈话记录、配置）\n├── dist/                # 构建输出\n├── docs/                # 项目文档\n└── resources/           # 应用图标\n```\n\n---\n\n## 微信接入（可选）\n\n梦间支持通过微信与 AI 伴侣聊天，基于 [Gewechat](https://github.com/Devo919/Gewechat) 服务：\n\n- **应用内一键启动**：在设置向导或设置页面点击「启动 Gewechat」，应用会自动检查 Docker 环境并启动容器\n- **需预先安装 [Docker](https://www.docker.com/)**\n\n如需手动部署：\n\n```bash\ndocker run -itd -p 2531:2531 -p 2532:2532 --name=gewe gewe\n```\n\n微信与 QQ 可同时配置，也可随时在设置中启用/停用。\n\n---\n\n## 文档\n\n- [常见问题](docs/faq.md) — QQ 扫码、API Key、NapCatQQ\n- [更新日志](docs/CHANGELOG.md) — 版本变更记录\n- [路线图](docs/ROADMAP.md) — 版本规划与排期\n\n---\n\n## 重要提醒\n\n- **AI 内容不代表作者立场**，本软件仅供学习娱乐\n- **QQ 使用第三方协议**，存在封号风险，建议使用小号\n- **AI API 按量计费**，频繁聊天会产生费用\n- **TA 不能替代真实人际关系**，请保持现实生活中的社交\n- **保护隐私**，勿透露身份证、银行卡等敏感信息\n\n## Related / 相关项目\n\n- [companion-engine](https://github.com/sixtdreanight/companion-engine) — The core engine that powers this app\n\n## License\n\n[GPL-3.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsixtdreanight%2Fyumema","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsixtdreanight%2Fyumema","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsixtdreanight%2Fyumema/lists"}