Luker 中文文档 下载 App

CardApp 与 Studio 工作台:角色卡里的内嵌应用

先说 CardApp 是什么

CardApp 是角色卡内嵌的应用系统:卡可以在自己的数据里定义一个小型应用(HTML、脚本、样式),聊天时它在界面上渲染——状态面板、情绪指示器、任务清单、互动按钮,都是它的舞台。对玩家来说,一张带 CardApp 的卡不只是"一个角色",还是"一个带界面的玩法"。

应用有完整的生命周期:角色切换时挂载并初始化,对话事件驱动更新,离开时卸载。CardApp 的数据读写走平台的状态系统(按命名空间隔离,聊天结构变化时自动对账),见逐楼层变量同源的状态机制。

官方 CardApp Studio 演示
Studio 演示

Studio 是它的开发环境

带 CardApp 的卡在编辑助手里会自动进入 CardApp Studio(也可以从扩展面板主动打开)。这是一个覆盖在主界面上的三栏工作台:

Studio 三栏布局总览
Studio 总览
区域内容
左栏AI 助手对话与会话管理,所有修改从这里发起
中栏实时预览——就是聊天界面本身,CardApp 在里面真实渲染
右栏CodeMirror 6 代码编辑器 + 文件树 + Git 历史
右栏代码编辑器
代码编辑器
左栏 AI 对话
AI 对话

开发体验的几个亮点

会话管理面板
会话列表
预览自动刷新
实时预览

AI 的工具面更宽

Studio 里的 AI 比普通弹窗能干更多事:完整的文件读写、运行诊断,还集成了搜索插件——开发 CardApp 时让 AI 现查 API 文档再写代码,不用切窗口。

给玩家的建议

你不需要会写代码才能用带 CardApp 的卡——正常导入、正常聊,界面自己会出来。想魔改界面时再开 Studio,让 AI 帮你改,你只管审批。