Vibe coded by Claude, conceived by Lelia. ฅ^•ﻌ•^ฅ 为海豹骰设计的 AI角色扮演回复插件，方便oc人随时和自己的骰子对话
SealDiceAIroleplay 是一个海豹骰 JS 插件，通过接入 AI API，让你的骰子可以扮演自定义的角色人设。通过指令，玩家可以直接和骰子对话，骰子会以该角色的身份回应。
按照格式填写角色设定后，AI 会以该角色的身份回应玩家，支持上下文记忆。
功能：
- 自定义角色人设（名字、身份、性格、说话风格、人物关系）
- 短期上下文记忆（同一会话内）
- 支持 DeepSeek / Claude 等 AI API
- 海豹骰插件，可以直接在QQ内部用指令使用
玩家：.hekate 你是谁？
骰子：十字路口的火炬为你点燃。我是赫卡特，你寻我何事？
玩家：.hekate 我在寻找一条通往冥界的路。
骰子：（沉默片刻）每一条路都通往冥界，只是时间早晚。你真正想问的，是能否活着回来。
你需要准备：
- 海豹骰 SealDice 1.5.1 或以上版本
- Python 3.8+
- 一个 AI API Key，推荐以下两个：
- DeepSeek — 价格便宜，中文效果好，推荐新手使用
- Anthropic Claude — 质量更高，笔者认为的效果最好，适合对效果有更高要求的用户，但价格昂贵且大陆地区连接不稳定
- 一台能运行 Python 的设备（本地电脑或云服务器均可）
下载本仓库中的 app.py 和 requirements.txt，放在同一个文件夹里，例如 ~/aibot/。
pip install -r requirements.txt✅ 成功：所有依赖安装完成，无报错
❌ 失败：出现 ERROR 或 Could not find a version，请检查 Python 版本是否为 3.8+
用文本编辑器打开 app.py，找到顶部角色设定区域，按注释说明填写。详见下方「角色设定填写指南」。
同时填入你的 API Key：
AI_API_KEY = "你的API Key"本地运行：
cd ~/aibot
python app.py✅ 成功：终端出现 Running on http://0.0.0.0:5000
❌ 失败：出现 Address already in use，说明5000端口被占用，换一个端口或关闭占用进程
服务器后台运行（推荐）：
cd ~/aibot
gunicorn -w 2 -b 0.0.0.0:5000 app:app --daemon✅ 成功：命令执行后无报错，回到命令行
❌ 失败：出现 command not found: gunicorn，请先运行 pip install gunicorn
启动后可用以下命令测试服务是否正常：
curl -X POST http://localhost:5000/chat \
-H "Content-Type: application/json" \
-d '{"message": "你好", "playerName": "测试"}'✅ 成功：返回包含 reply 字段的 JSON
❌ 失败：返回 Connection refused，说明服务未启动
Q: 云服务器上启动了但外部访问不了？ A: 检查服务器防火墙是否放行了5000端口。
Q: API Key 填写后报错 401？
A: API Key 填写有误，请检查是否复制完整。
Q: 返回 500 错误？
A: 查看终端日志，通常是 API Key 无效或余额不足。
下载本仓库中的 sealdiceAIroleplay.js，用文本编辑器打开，找到顶部配置区填写：
// ===== 配置区 =====
const FLASK_URL = 'http://你的IP:5000/chat'; // Flask 服务地址，必填
const COMMAND_NAME = 'hekate'; // 指令名，玩家用 .指令名 触发，必填
const CHAR_NAME = '赫卡特'; // 角色名，仅用于提示语显示，必填Flask 服务地址如何填写：
- 本地运行：填
http://127.0.0.1:5000/chat - 云服务器运行：填
http://你的服务器公网IP:5000/chat，例如http://106.55.29.59:5000/chat- Linux 服务器查询公网IP：
curl ifconfig.me - Windows 本地查询IP：
ipconfig，找到「IPv4 地址」
- Linux 服务器查询公网IP：
指令名如何设置：
- 指令名即玩家触发对话的命令，例如填
hekate，玩家发.hekate 你好即可触发 - 建议用角色名的英文或拼音，3个字母以上
⚠️ 避免使用和海豹骰内置指令相近的开头，例如r、ra、sc、a开头的短命令，容易被误解析⚠️ 指令名需要在 JS 插件配置区和后续使用中保持一致，改了这里记得同步更新
进入海豹骰后台 → 扩展功能 → JS扩展 → 上传插件，选择 sealdiceAIroleplay.js。
点击右上角「重载 JS」按钮。
✅ 成功：插件列表出现你的角色名，且「禁用指令」栏有你设置的指令名 ❌ 失败：插件列表显示「佚名」且无指令，点击「重载 JS」再试一次
在 QQ 或其他平台发送：
.hekate 你好
✅ 成功：骰子会先发送一条等待提示，例如「赫卡特听见了你，请等待她的回音。」，随后返回角色回复 ❌ 失败：无任何回应，请检查 Flask 服务是否正常运行
💡 等待提示语来自 JS 插件中的设置，你可以在
sealdiceAIroleplay.js里找到并修改成你喜欢的文字。 💡 等待提示语可以删去，但强烈推荐保留——当角色迟迟没有回复时，它能帮助你快速判断是指令没有触发，还是 Flask 服务出现了问题。
Q: 上传后指令没有反应？ A: 确认 Flask 服务正在运行，用 curl 测试服务是否正常（见上方部署章节）。
Q: 提示「未设置快捷指令」？
A: 指令名设置有问题，避免使用单个字母或以 .a 开头的名字。
Q: 重载后插件失效？ A: 这是海豹骰的已知缓存问题，重载 JS 不会清空已注册的扩展。删除插件后重新上传即可。
打开 app.py，找到角色设定区域，按以下说明填写：
| 变量 | 说明 | 示例 |
|---|---|---|
CHAR_NAME |
角色主名 | 赫卡特 |
CHAR_ALIASES |
别名，没有可留空 | 黑暗女神、十字路口的守护者 |
CHAR_ROLE |
角色身份 | 魔法与月亮的掌管者，冥界的引路人 |
CHAR_WORLD |
世界观背景 | 古希腊神话世界 |
CHAR_DESCRIPTION |
对角色的简短描述 | 古老而强大的存在、普通的高中生、江湖游历的侠客 |
CHAR_PERSONALITY |
性格 | 神秘而深邃，冷静但不冷漠 |
CHAR_SPEECH_STYLE |
语言风格 | 简短有力，带有预言般的韵味 |
CHAR_SPEECH_FORMAT |
语言格式，已预设可删改 | 动作描写用括号表示… |
CHAR_RESTRICTIONS |
角色专属限制，填写角色能与不能 | 不称呼对方为「孩子」 |
CHAR_RELATIONSHIPS |
人物关系，每行一个 | 宙斯：诸神之王，我与他井水不犯河水 |
💡 填写越详细，AI 的角色扮演效果越好。人物关系部分尤其推荐填写，当玩家提及相关人物时，角色会有对应的情绪反应。
- 只有通过指令触发的消息才会发送给 AI，普通聊天内容不会被读取
- 对话记录仅存于内存，服务重启后自动清空，不写入任何文件
- 本项目调用方式不会主动上传数据，但最终取决于你所使用的 AI API 服务商的隐私条款。例如 Anthropic Claude 和 DeepSeek 均在其条款中说明不将 API 调用数据用于模型训练，使用其他服务商请自行查阅对应条款。
- 重启 Flask 服务后，所有对话记忆清空
- 当前不支持跨会话持久记忆
- 对话历史过长时可能超出 API token 限制，建议定期重启服务清空记忆
- 当前版本默认使用 DeepSeek API 格式，使用 Claude 等其他格式需自行修改
app.py中的请求部分
- 持久化记忆（跨会话记忆、人物关系记忆）
- 更丰富的应用场景，例如在沙盒模组中扮演随机路人 NPC，丰富玩家探索体验
- 卫星：AI角色补位，顶替扮演、骰点等
- Anthropic Claude — 本项目的开发伙伴，笔者认为目前效果最佳的 AI，超级昂贵但超级好用 ฅ^•ﻌ•^ฅ
- DeepSeek — 默认 AI 后端，便宜好用
- SealDice — 骰子平台支持
SealDiceAIroleplay 的初衷绝对不是认为AI创作可以替代人类创作！我只是试图在原本的固定自定义回复中，多探索一些机动的可能性，从而丰富体验。
人类的赞歌是勇气的赞歌、是智慧的赞歌，在任何模组里任何伟大的冒险旅途，都离不开每一位作者、玩家、主持人的共同创作。
向伟大的创作者致敬！祝诸位骰运昌隆，所历皆传奇。
感恩赫卡特女神及祂的尊名、仁慈和智慧🔥
Vibe coded by Claude, conceived by Lelia. ฅ^•ﻌ•^ฅ