情书·Roki

把一场宫廷密谋，装进 480 × 380 的眼镜视野。

项目亮点 · 快速开始 · 眼镜交互 · 项目结构 · 打包部署

「情书·Roki」是为 Rokid AI 眼镜 / 灵珠（Rizon） 打造的沉浸式《情书》卡牌游戏智能体。说一句“来玩情书”，即可进入主界面；通过触控板切换选项、单击确认，在眼镜中完成一场 2–4 人宫廷博弈。

项目包含完整的 21 张牌规则引擎、AI 对手、语音指令、头控辅助、眼镜小屏 UI，以及可直接上传至灵珠平台的 .aix 打包流程。

项目亮点

能力	实现
👓 眼镜优先交互	针对 480 × 380 视野设计；触控板前后滑、方向键与单击确认均可操作
🃏 完整卡牌规则	实现 21 张牌、10 种角色效果、出局判定、轮次结算与钟情标记
🤖 AI 宫廷对手	支持 2–4 人对局；AI 会结合合法目标、手牌信息与局面行动
🗣️ 多种输入方式	支持唤醒词、语音命令、触控板、键盘及陀螺仪头控
✨ 沉浸式表达	酒红与鎏金宫廷视觉，短句反馈适配眼镜小屏阅读
📦 一键打包	PowerShell / Bash 脚本生成可上传的 情书·Roki.aix

眼镜交互

意图	眼镜操作	键盘映射
切换选项	触控板前后滑	↑ / ↓ / ← / →
确认选择	单击触控板	Enter / GlobalHook
启动游戏	说“情书”或“来玩情书”	打开 pages/index/index

智能体不会替玩家做决定；它负责展示合法操作、解释当前局面，并把每条反馈控制在适合眼镜阅读的长度内。

快速开始

1. 获取项目

git clone https://github.com/farlyfeifei/roki-love-letter.git
cd roki-love-letter

2. 真机调试

请先完成 Rokid AIUI 开发环境与 CLI 配置，然后运行：

npm start

3. 唤醒智能体

可使用以下唤醒词：

• 情书
• 来玩情书
• 打开情书
• Love Letter

工作原理

flowchart LR
    Input["语音 · 触控板 · 头控"] --> UI["沉浸式 UI<br/>pages/index/index.ink"]
    UI --> Engine["规则引擎<br/>lib/game-engine.js"]
    Engine --> Cards["卡牌数据<br/>lib/cards.js"]
    Engine --> AI["AI 对手<br/>lib/ai.js"]
    Engine --> UI
    UI --> Package["Rizon 智能体包<br/>情书·Roki.aix"]

Loading

项目结构

.
├── pages/index/index.ink    # 480 × 380 沉浸式游戏界面与交互
├── lib/
│   ├── cards.js             # 卡牌定义、牌库与规则文案
│   ├── game-engine.js       # 回合、卡牌效果与胜负结算
│   └── ai.js                # AI 对手决策
├── assets/                  # 图标、音效与背景音乐
├── jsui/                    # AIUI 消息卡片界面
├── docs/                    # 规则、架构、部署与智能体提示词
├── scripts/                 # Windows / macOS / Linux 打包脚本
├── agent.json               # 人设、唤醒词与技能定义
├── workflow.json            # 灵珠工作流
└── manifest.json            # 应用元数据与能力声明

打包与部署

Windows：

npm run pack

macOS / Linux：

bash scripts/pack.sh

打包产物位于 dist/情书·Roki.aix。随后登录 Rokid 灵珠平台，创建智能体并上传该文件。

更完整的部署流程见 docs/DEPLOY.md，可直接粘贴的人设提示词见 docs/AGENT_PROMPT.md。

文档

• 完整游戏规则
• 技术架构
• 部署说明
• 智能体人设与回复逻辑
• 产品需求

项目说明

本项目是独立的技术与交互设计作品，与《情书》桌游的发行方不存在隶属、合作或背书关系；相关游戏名称、规则与知识产权归各自权利人所有。