一起把隐界做得更好
隐界以 MIT 协议完整开源。它由一个很小的团队和一群用户慢慢养大——不管你是想分享一个角色设定、报一个 Bug,还是提交一个 PR,这里都有你能落手的地方。
四种参与方式
捏角色、聊世界观
你在应用里创造的角色、琢磨出的世界观设定、好玩的用法,都值得分享。来 GitHub Discussions 发出来,和其他玩家与开发者一起讨论——很多功能的灵感正是从这里来的。
报告问题
遇到 Bug 或别扭的体验?到 GitHub Issues 开一帖,附上复现步骤和环境信息(系统、浏览器、自部署还是云端)。一条清晰的 Issue 和一个修复同样有价值。
修 Bug、写功能
Fork 仓库、创建分支、确保 pnpm build 通过,然后提交 PR 并描述改动。提交信息用语义化前缀(feat: / fix: / docs: 等)。从一个小修复开始就很好。
翻译与文档
隐界支持中英日韩四语,全部文案都在 packages/i18n 的 catalogs 里维护;README 与开发文档也有四语版本。修正一处译文、补一段文档,都是实打实的贡献。
开发者:三步跑起本地环境
准备环境
Node.js ≥ 18,pnpm 8.15.4(推荐 corepack enable 锁定版本)。数据库是内置 SQLite,无需额外安装。
安装依赖
克隆仓库后执行 pnpm install 装 workspace 包;api 自带 npm 锁、不在 pnpm workspace 里,需要单独 cd api && npm install。
配置并启动
复制 api/.env.example 为 api/.env,至少填入一个模型 API Key;然后 pnpm dev:api 启动后端(:3000)、pnpm dev:app 启动前端(:5180)。注意:不要直接跑 pnpm dev——那是多租户云模式的命令,自部署/本地开发用 dev:api + dev:app。
完整的端口表、日志位置与 Android 联调说明,见仓库的 DEVELOPMENT.md。
仓库结构一瞥
单仓 monorepo:apps/app 是主应用(按功能模块组织——聊天、朋友圈、游戏、宠物、知识库、日程……),api 是 NestJS 后端,apps/site 是这个官网,packages 放共享契约与多语言资源。改前端大多只动 apps/app 的一个 feature 目录。
模型层可插拔(BYOK)
AI 模型接入是可插拔的:OpenAI、Claude、Gemini、DeepSeek 等云端模型用你自己的 API Key,或指向本地 Ollama / vLLM 完全离线跑。想了解每家的接法,见「模型接入」页。
从这里开始
不确定从哪入手?先去 Discussions 打个招呼,说说你想做什么;或者翻翻 Issues 找一个看得懂的小问题。贡献规范的完整版在 CONTRIBUTING.md。