一款纯前端运行的本地角色扮演（Roleplay）对话和角色卡生成工具。
【免责与授权声明】
本项目基于 CC BY-NC 4.0（知识共享-署名-非商业性使用 4.0 国际许可协议） 开源。明确禁止任何形式的商业化使用（包括但不限于：作为收费服务提供、打包在付费产品中售卖、在产品内植入广告盈利等）。 任何使用者必须遵守该协议，尊重原作者的署名权。对于违反协议的商业行为，保留追究法律责任的权利。
Roleplay Hub 致力于提供流畅、私密且功能强大的本地化AI Roleplay体验。
- 角色卡、世界书、正则脚本和多用户资料管理
- 总结记忆与向量记忆，可按角色和剧情分支独立保存
- 剧情分支创建、切换、回档、重命名和完整导入导出
- UI 模板变量分析与对话状态展示
- 自动生图、单张重新生成和多套内置画师风格
- 角色卡生成、万相广场与“墨韵 · 造梦”在线工具
本项目无需复杂的 Node.js 环境或依赖安装，即开即用！
- 点击项目主页绿色的
Code按钮，选择Download ZIP。 - 将下载的 ZIP 压缩包解压到您的本地任意文件夹中。
- 双击打开
index.html文件，即可在浏览器（推荐 Chrome / Edge / Firefox）中启动 Roleplay Hub。
(注：如果您遇到跨域或本地文件读取权限问题，可以尝试使用 VS Code 的 Live Server 插件，或简单的本地服务器工具来运行该目录。但在绝大多数现代浏览器中，双击 index.html 即可正常使用所有核心功能。)
- 打开应用后，点击侧边栏（或顶部菜单）的设置 (Settings) 选项。
- 选择自定义配置，填入您自己的或第三方提供的 API 节点 (
API URL)。 - 填入对应的
API Key，并输入或选择您想使用的模型名称 (Model)。 - 在角色管理界面，导入您的角色卡文件（或点击新建角色并手动填写设定）。
- 回到对话界面，开始属于您的 Roleplay 旅程
Roleplay-Hub/
├── index.html # 主界面与脚本加载入口
├── character/ # 角色卡生成工具
│ └── index.html
├── novel/ # 墨韵 · 造梦
│ └── index.html
├── assets/
│ ├── css/
│ │ └── styles.css # 全局样式
│ └── js/
│ ├── built-in-content.js # 默认预设、模式提示词、画师串与更新公告
│ ├── core-utils.js # 通用工具、角色卡处理与基础配置
│ ├── data-services.js # 存储、记忆、上下文、分支与 UI 状态
│ ├── runtime-services.js # API 请求、消息渲染与运行状态
│ ├── ui-components.js # 选择器、侧边栏、弹窗与页面组件
│ └── app.js # 主业务入口与页面状态
└── README.md # 项目说明
页面会按照上方顺序加载 JavaScript 文件，请不要随意调整依赖顺序。
- 修改默认预设、各模式提示词、生图画师串或工具说明时，统一编辑
built-in-content.js。 - 更新公告固定放在
built-in-content.js最底部，方便查找和替换。 - 可复用界面统一放在
ui-components.js，业务数据处理放在data-services.js。 - 项目没有构建步骤，修改后刷新浏览器即可验证。
本项目严格遵守以下开源协议：
Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)
- 您可以：自由地共享（在任何媒介以任何形式复制、发行本作品）与演绎（修改、转换或以本作品为基础进行创作）。
- 您必须：
- 署名 (Attribution)：给出适当的署名，提供指向本许可协议的链接，同时标明是否对原始作品作了修改。
- 非商业性使用 (NonCommercial)：您不得将本作品或演绎作品用于任何商业目的。 禁止任何形式的售卖、付费订阅集成或利用本项目进行广告牟利。
- 若要获取本项目的商业授权，请直接联系项目原作者。
详细许可条款请参见根目录下的 LICENSE 文件。