技术手册
技术手册
外部 AI 提示词
想在别的 AI 工具里讨论美化方案时,把这段提示词发过去,再把结果手动粘回角色卡。
先试试平台里的 AI 助手
平台的 AI 创作助手能直接把正则、CSS、JS 写进草稿,还会先做基础校验,比外部 AI 省事(见第 4 关、第 10 关)。下面的提示词适合想在别处反复讨论方案的时候用。
复制给外部 AI
先把方括号里的内容改成自己的需求,再把整段发给外部 AI。
text
你是AI玩家角色卡美化助手。请根据我的需求生成可以直接检查和粘贴的方案。
我的角色主题:
[例如:雨夜温室中的悬疑调查]
我要实现的效果:
[例如:把地点、天气、情绪显示成可折叠信息面板]
角色当前会输出的文本示例:
[粘贴一段真实示例,必须包含准备匹配的固定标记]
是否需要点击或自动切换:
[不需要 / 说明具体交互]
请严格按以下七部分返回:
1. 建议角色输出格式
2. 正则规则名称、查找表达式、flags 和应用位置
3. 完整替换 HTML,并说明 $1、$2 等捕获组分别对应什么
4. 完整全局 CSS
5. 仅在确实需要交互时返回完整全局 JavaScript,否则写“不需要”
6. 至少两个测试输入和对应的预期输出
7. 保存前检查清单
平台约束:
- 正则必须同时兼容 Go regexp / RE2 与浏览器 RegExp。
- 优先使用替换 HTML 自己的 class、.charx-*、[data-charx-slot] 和 --charx-* 变量。
- 不要依赖 Tailwind 组合类、临时 class、DOM 层级或 nth-child 顺序。
- CSS 禁止 @import、javascript:、vbscript:、expression()、behavior: 和 -moz-binding。
- JavaScript 禁止 eval、Function 构造器、动态 import、Worker、网络请求、localStorage、sessionStorage 和 Cookie。
- 新脚本使用 $charx.hooks.on 注册,使用 $charx.hooks.once('onDestroy', cleanup) 清理副作用。
- 不要覆盖整个 window.CharxHooks。
- 不要使用 fixed 遮挡输入区,窄屏不能出现横向滚动。
- 动画必须支持 prefers-reduced-motion: reduce。
- 只输出原创代码,不复制其他平台的选择器或模板。
请先给最小可运行版本,再给可选增强项。不要省略任何完整代码,也不要假设未经说明的平台能力。这是一段写给 AI 的创作辅助指令,不是平台的接口。外部工具改不了你的角色卡,返回的结果要自己检查、自己粘贴。
检查 AI 返回的结果
正则
- 示例输入能匹配,不相干的输入不会被误匹配。
$1、$2和替换 HTML 里的位置对得上。- flags 只包含真正需要的字母。
- 保存时没有报语法错误。
详见正则匹配与替换。
CSS
- 自己的类名和替换 HTML 里的一模一样。
- 改平台区域时只用稳定选择器。
- 浅色、深色模式下文字都看得清。
- 390px 宽的屏幕上不挡输入栏、不横向溢出。
- 全局 CSS 不超过 500 KiB。
JavaScript
- 不用脚本也能做到的效果,就把脚本删掉。
- 用
$charx.hooks.on注册,退出时调用取消函数。 - 没有联网、浏览器存储、动态导入或执行代码字符串。
- 全局 JS 不超过 100 KiB。
在三个环境里验收
- 在正则测试面板里检查固定输入和替换结果。
- 在创作页预览里检查完整回复、切换会话和退出页面。
- 到角色实际要用的网页和 App 里分别检查。
创作页预览通过,只能说明预览里没问题,代替不了网页和 App 的验收。
从实例改起
最省事的办法:挑一个最接近的美化实例,连同你的角色主题一起发给 AI,让它保留原有类名和安全限制,只改颜色、文案和字段。