简体中文 | English
电子爱是一个由 DSH Agent 驱动的 AI 角色卡创作与演绎客户端，首先提供免费开源的 Android 版本，随后开发 PC 客户端。
像 vibe coding 一样创作角色。 你只需要说出想法，剩下那些曾经最繁琐的写卡工作，可以交给 Agent 和工具一步步完成。
- 会自己查设定的角色 Agent：DSH 让角色拥有真正的 Agent 能力。它会像查资料一样主动搜索设定库，只读取当前剧情需要的内容，再调用变量、联网和其他工具继续演绎。
- 从手工写卡到 Agent 创作：创作 Agent 可以搭建和修改角色、设定库、变量、正则与形象素材；所有修改先预览、校验，再由创作者决定是否保存。
- 用工具调用稳定更新变量：Agent 不在回复里输出特定的变量更新格式，而是调用专用工具读取、校验并更新关系、物品、事件和世界状态。每类工具都有明确的数据格式和操作规范，减少模型输出漂移，让状态演进更稳定、可追踪；角色还可以带有自己的 HTML、CSS、JavaScript 和素材，把状态呈现为可交互的演绎界面。
电子爱想建立一个持续进化的创作飞轮：把社区积累的角色设计知识、模板和方法变成 Agent 可以检索和复用的能力。知识越丰富，Agent 越会创作；创作出的作品与经验，又能继续推动整个社区向前发展。
角色扮演对话 |
Agent 执行详情 |
这里只展示未来要完成的任务，不代表当前已经实现的功能。
- 兼容提示词模板和前端角色卡的启动流程，让角色卡点击开始后能够按模板向 AI 发起首轮对话。
- 完善前端 API 文档与示例，支持 Agent 自动设计前端样式并自动载入角色卡。
- 完善 DSH 插件管理与 MCP 接入，提供统一的配置、权限和运行状态管理。
- 适配更多模型厂商的官方 API。
- 开发 PC 端电子爱客户端，逐步实现跨平台的角色创作与演绎体验。
- 完善生图能力，扩展模型接入、参数控制、编辑和连续创作流程。
项目当前需要着重思考的公开课题，将持续整理在 AI 角色扮演开发难题。
- GitHub：通过 Issue、Discussion 或 Pull Request 参与项目。
- QQ 群：
1041463229，可在 QQ 中搜索群号加入。
电子爱不只是一个 AI 聊天软件。
我希望“AI 角色扮演设计师”能够成为一种真正被看见、被尊重，也能够获得合法收入的新兴职业。优秀的角色作品也应该像小说、游戏和影视作品一样被认真创作、被人记住，让创作者有机会依靠自己的热爱与能力一直走下去。
电子爱的最终目标，就是加速这一职业的诞生与普及。我们会从免费开源的客户端、Agent 创作工具、角色作品的表现能力和创作者生态开始，一步一步把这条路铺出来。无论这个未来还要多久才会到来，电子爱都会先迈出这一步，并始终朝着这个目标走下去。
我们想给所有喜欢 AI 角色扮演的人带来的，不只是一款更好用的软件，而是一条过去并不存在的路。在就业环境充满挑战的今天，让热爱角色、擅长创作的人，多一种值得认真选择的人生可能。
电子爱探索的不只是 AI 角色对话，也包括由 AI 驱动的游戏、互动叙事以及更多尚未被定义的创作形式。如今一些重前端的角色卡已经显现出这种可能：角色不再只是简单的对话，也可以成为界面精美的模拟器游戏，让人亲自经历各种有趣的故事，甚至把曾经只能存在于幻想中的世界，变成可以自由探索的开放世界。电子爱希望和创作者一起，把这些雏形继续发展成更丰富的作品。
电子爱想为这件事提供一套长期开放的工具，也希望聚集同样相信这件事的人。一个人能够做到的事情很有限；如果未来项目拥有收入，我希望能够邀请真正有能力的开发者、设计师和创作者加入，给予他们应得的报酬，一起把这个项目做得更好、更久。
我承诺：电子爱官方发布的 Android 客户端和未来的 PC 客户端将一直保持免费开源，不会转为闭源产品。官方客户端不内置任何付费功能，不内置推荐任何API中转站；用户自主选择并配置自己信任的模型服务。
如果项目未来获得持续收入，目前设想的主要方向是建立面向 AI 角色创作生态的资源与服务平台，帮助创作者展示、发布和交易角色作品、OC 定制、美术素材、界面设计、插件与扩展及其他创作内容与服务，并持续维护自己的作品。平台未来可能通过公开透明的平台服务、赞助或捐赠获得收入，用于基础设施、支付协作者报酬、组建专业团队以及项目长期维护。具体规则将在相关服务上线前公开说明。
我不认为开源必须以开发者和创作者无法获得回报为代价。我希望电子爱最终形成的是一个良性循环：核心工具自由开放，创作者自主决定作品的授权和价格，项目也能获得足以持续开发的资源。
电子爱是一个开源、本地运行的客户端。项目方不提供模型服务，也没有接收用户本地角色卡、设定或聊天记录的数据后台，无法也不会获取这些隐私数据；用户连接的模型服务由用户自己选择。
未来如果上线设计资源与服务平台，平台将只面向合法合规的设计资源与创作服务，并对平台上公开发布或交易的内容依法管理。
感谢下列开源项目与创作者对 AI Agent 和角色扮演生态所做的探索：
- 特别感谢 DeepSeek Harness（DSH） 提供 Agent 执行框架。电子爱基于 DSH 构建 Agent 运行时，并在其上连接角色会话、创作工具、权限审批、子 Agent 与 Android 运行环境。DSH 及其上游代码继续遵守 MIT 许可证和各自的第三方许可。
- 感谢 SillyTavern 推动角色卡、预设、世界书、正则和富内容创作生态的发展。电子爱对其中部分内容格式和创作习惯提供选择性兼容，但不以复刻其前端、扩展运行环境或全部体系行为为目标。
- 感谢 Tavern-Helper 及 MVU 内容生态推动变量驱动角色扮演的实践。电子爱延续了“状态能够参与叙事”的创作方向，并以自己的层级数据模型、Agent 工具、补丁协议、Zod 校验、消息快照和事务提交机制实现。
- 感谢 TauriTavern 对移动端长聊天与富内容运行问题的公开探索，为电子爱调研这类工程问题提供了可供比较的实践。
- 感谢 EJS 建立的模板语法与创作生态。电子爱独立实现了对部分 EJS 模板语法的兼容，未内置 EJS 上游运行库。
- 感谢 Grok Build 提供无界面的流式 Markdown 解析组件。电子爱直接使用固定版本的
xai-grok-markdown与xai-grok-markdown-core，并将解析结果接入 Android 与 Compose 显示层。相关上游代码继续遵守 Apache-2.0 许可证，Mermaid 组件继续遵守其 MIT 许可证。
实际随包分发的第三方代码、二进制文件和素材及其许可证，以 NOTICE 和各级许可文件中的记录为准。
我欢迎认同下列方向的开发者、AI 角色扮演设计师、视觉与交互设计师、文档作者和社区建设者与我合作：
- 认同核心工具应当保持免费开源；
- 尊重原作者、兼容对象与事实上的技术脉络；
- 认同角色设计师有权决定自己原创作品的授权方式，并可以从中获得合法回报；
- 认同AI角色扮演应合法合规，并愿意共同守住法律底线、不侵犯他人权益；
- 愿意在开源、创作者权益和可持续维护之间建立长期的良性循环。
如果你也想让 AI 角色卡设计成为一种更完整、更合规、也更能持续发展的创作工作，欢迎通过 Issue、Discussion 或 Pull Request 参与电子爱。
- CoreForgeLab — 架构与数据库设计：参与 ElecKoi 数据库与持久化架构的审计、长期演进设计和重构规划；重点参与 Character Card、Character Instance、Agent 与 Group Chat 的数据边界、权限隔离、生命周期、资源索引及备份恢复模型设计，并协助整理相关架构文档与公开讨论。详见贡献者记录。
电子爱官方 Android 客户端和未来的 PC 客户端将持续免费开源。项目未来可能与独立的 AI 角色创作资源与服务平台有联系，平台将通过服务、赞助或捐赠支持长期开发和支付协作者报酬，这是必须履行的义务与职责。
参与 ElecKoi 的长期协作，意味着我们认可 README 中已经公开说明的基本发展方向：核心客户端持续保持免费开源，尊重开源项目、原作者与创作者的权利，在合法合规的前提下发展 AI 角色创作生态，并努力在开放协作、创作者收益和项目长期维护之间建立可持续的良性循环。
参与贡献不代表贡献者放弃自己代码或作品的版权，也不意味着必须无条件接受未来所有方向变化。若项目在开源模式、商业模式、用户数据边界、创作者权益或其他重大原则上发生实质性调整，应当尽可能提前公开说明并与贡献者沟通，使现有和未来的参与者都能够在充分知情的情况下决定是否继续协作。
贡献者保留自己贡献的版权，代码继续按照 AGPL-3.0-or-later 提供。普通的 Issue 或 Pull Request 不构成版权转让，也不会赋予项目方将贡献改为闭源代码的权利。未来的资源网站或平台服务也不会因此取得贡献者代码、作品或其他内容的额外权利。
如果你对这一方向有疑问，请先通过 Issue 或 Discussion 沟通。我不希望任何人在付出劳动后，才发现项目的发展方向与自己的价值判断不同。
.\gradlew.bat :app:assembleDebug仓库已包含 Gradle Wrapper、Android 模块、原生代码、WebView 运行资源，以及构建本地 Runtime 所需的文件。体积较大的 runtime/bundles/*.egruntime 不纳入版本控制，构建时会按照固定清单自动准备。
除另有标注的第三方组件外，ElecKoi 源码采用 GNU Affero General Public License v3.0 or later（AGPL-3.0-or-later）。第三方组件继续遵守各自许可证，详见 NOTICE 和各级许可文件。