xinyu-pro 0.22.6 → 0.23.0

package/app/extensions/tutorial/code-examples.ts

@@ -0,0 +1,833 @@
+// app/extensions/tutorial/code-examples.ts - 教程页面代码块常量
+
+// ==================== 代码块常量 ====================
+
+export const CODE_OVERVIEW_MINIMAL = [
+  'function setup(xinyu) {',
+  "  // 插件加载时执行",
+  "  xinyu.ui.toast('插件已启用！', 'success');",
+  '}',
+].join('\n');
+
+export const CODE_ARCHITECTURE_EXEC = [
+  '// 运行时内部执行方式（简化）',
+  'const wrappedCode = `',
+  "  'use strict';",
+  '  ${pluginCode};',
+  "  if (typeof setup === 'function') {",
+  '    return { setup };',
+  '  }',
+  '  return {};',
+  '`;',
+  "const factory = new Function('xinyu', wrappedCode);",
+  'const exports = factory(xinyuBridge);',
+  'exports.setup(xinyuBridge);  // 调用插件入口',
+].join('\n');
+
+export const CODE_LIFECYCLE_EXAMPLE = [
+  'function setup(xinyu) {',
+  "  xinyu.plugin.on('onLoad', function() {",
+  "    xinyu.ui.toast('插件已加载', 'success');",
+  '  });',
+  '',
+  "  xinyu.plugin.on('onGameInit', function() {",
+  '    xinyu.game.registerAttribute({',
+  "      key: 'hp', label: '生命值', type: 'number',",
+  "      value: 100, icon: '❤️'",
+    '    });',
+  '  });',
+  '',
+  "  xinyu.plugin.on('onUnload', function() {",
+  '    // 资源会自动清理，通常不需要手动处理',
+  '  });',
+  '}',
+].join('\n');
+
+export const CODE_UI_SLOT = [
+  '// 在状态栏显示自定义信息',
+  "xinyu.ui.registerSlot('status-bar',",
+  '  \'<div style="font-size:11px;color:var(--color-text-muted)">自定义状态</div>\',',
+  '  { priority: 1 }',
+  ');',
+  '',
+  '// 在顶部导航栏右侧注入元素',
+  "xinyu.ui.registerSlot('header-right',",
+  '  \'<span style="font-size:12px">🔔 3</span>\',',
+  '  { priority: 10 }',
+  ');',
+  '',
+  '// 移除注册的内容',
+  'xinyu.ui.unregisterSlot(registrationId);',
+].join('\n');
+
+export const CODE_UI_MODAL = [
+  '// 确认对话框（返回 Promise<boolean>）',
+  'const ok = await xinyu.ui.confirm(',
+  "  '确认操作',",
+  "  '确定要重置属性吗？',",
+  "  { confirmText: '重置', cancelText: '取消', danger: true }",
+  ');',
+  '',
+  '// 自定义模态框',
+  'const modalId = xinyu.ui.showModal({',
+  "  title: '角色属性编辑',",
+  "  content: '<div style=\"padding:12px\">自定义内容</div>',",
+  "  width: '400px',",
+  '  closable: true,',
+  '  backdrop: true,',
+  "  style: 'border-radius: 12px; box-shadow: 0 8px 32px rgba(0,0,0,0.2);',  // 自定义模态框容器样式",
+  '  actions: [',
+  "     {" ,
+  "       text: '保存'," ,
+  "       primary: true," ,
+  "       onClick: function(ctx) { /* 保存逻辑 */ ctx.close(); }," ,
+  "       closeModal: true // 若 onClick 中调用了 ctx.close()，那么需要设置 closeModal 为 true 来启用模态框的关闭动画" ,
+  "     },",
+  "     { text: '取消', onClick: function(ctx) { ctx.close(); }, closeModal: true }",
+  '  ],',
+  '  onClose: function() { /* 关闭回调 */ }',
+  '});',
+  '',
+  '// 更新模态框（无需关闭重开，可动态修改 title、content、width、style）',
+  'xinyu.ui.updateModal(modalId, {',
+  "  title: '角色属性编辑（已修改）',",
+  "  content: '<div style=\"padding:12px\">更新后的内容</div>',",
+  "  width: '500px',",
+  "  style: 'border-radius: 16px; background: #1a1a2e;',",
+  '});',
+  '',
+  '// 关闭模态框',
+  'xinyu.ui.closeModal(modalId);',
+].join('\n');
+
+// 确认对话框详细示例
+export const CODE_CONFIRM_DETAIL = [
+  '// 基础用法：弹出确认对话框，等待用户选择',
+  'const confirmed = await xinyu.ui.confirm(',
+  "  '删除存档',",
+  "  '此操作不可撤销，确定要删除当前游戏存档吗？',",
+  ');',
+  'if (confirmed) {',
+  "  xinyu.ui.toast('存档已删除', 'success');",
+  '} else {',
+  "  xinyu.ui.toast('已取消', 'info');",
+  '}',
+  '',
+  '// 自定义按钮文字和危险样式（红色确认按钮）',
+  'const ok = await xinyu.ui.confirm(',
+  "  '重置全部属性',",
+  "  '将所有角色属性恢复为初始值，是否继续？',",
+  "  { confirmText: '确定重置', cancelText: '再想想', danger: true }",
+  ');',
+  '',
+  '// 在事件处理器中使用 confirm',
+  "xinyu.chat.registerCommand({",
+  "  name: '/reset',",
+  "  description: '重置游戏进度',",
+  "  handler: async function() {",
+  "    const ok = await xinyu.ui.confirm(",
+  "      '⚠️ 危险操作',",
+  "      '重置后所有进度将丢失！',",
+  "      { danger: true }",
+  "    );",
+  "    if (ok) {",
+  "      xinyu.game.setState({ gold: 0, level: 1 });",
+  "      xinyu.ui.toast('进度已重置', 'warning');",
+  "      return '【系统】游戏进度已被重置';",
+  "    }",
+  "    return '【系统】取消重置操作';",
+  "  }",
+  '});',
+].join('\n');
+
+export const CODE_UI_STYLE = [
+  '// 注入自定义 CSS（使用 CSS 变量保持主题一致）',
+  'const styleId = xinyu.ui.injectStyle(`',
+  '  .my-plugin-panel {',
+  '    background: var(--color-bg-tertiary);',
+  '    border: 1px solid var(--color-border);',
+  '    border-radius: 8px;',
+  '    padding: 12px;',
+  '  }',
+  '  .my-plugin-highlight {',
+  '    color: var(--color-accent);',
+  '    font-weight: bold;',
+  '  }',
+  '`);',
+  '',
+  '// 需要时移除',
+  'xinyu.ui.removeStyle(styleId);',
+].join('\n');
+
+export const CODE_UI_HOST_EVENT = [
+  '// 监听消息接收事件',
+  "xinyu.ui.onHostEvent('message:received', function(data) {",
+  "  console.log('新消息:', data.message);",
+  '});',
+  '',
+  '// 监听游戏状态变更',
+  "xinyu.ui.onHostEvent('game:stateChange', function(data) {",
+  "  console.log('变更的键:', data.changedKeys);",
+  '});',
+  '',
+  '// 可用事件：',
+  '// message:received / message:sent / game:stateChange',
+  '// sidebar:open / sidebar:close / input:focus / input:blur',
+  '// theme:change / plugin:enabled / plugin:disabled',
+].join('\n');
+
+export const CODE_DOM_API = [
+  '// 创建元素',
+  "const el = xinyu.ui.dom.create('div', {",
+  "  className: 'my-panel',",
+  "  style: 'position:absolute;top:10px;right:10px;',",
+  "}, 'Hello World');",
+  '',
+  '// 追加到容器（支持插槽 ID）',
+  "xinyu.ui.dom.append('floating', el);",
+  '',
+  '// 也可以直接追加 HTML 字符串',
+  "xinyu.ui.dom.append('floating', '<div class=\"my-panel\">Hello</div>');",
+  '',
+  '// 更新元素',
+  'xinyu.ui.dom.update(el.id, {',
+  "  style: 'position:absolute;top:20px;',",
+  "  textContent: 'Updated!'",
+  '});',
+  '',
+  '// 查询元素（仅限插件自己的元素）',
+  "const results = xinyu.ui.dom.query('floating', '.my-panel');",
+  '',
+  '// 绑定事件',
+  "xinyu.ui.dom.on(el.id, 'click', function() {",
+  "  xinyu.ui.toast('被点击了！', 'info');",
+  '});',
+  '',
+  '// 移除元素',
+  'xinyu.ui.dom.remove(el.id);',
+].join('\n');
+
+export const CODE_PERMS_DEFAULT = "['slot:input-toolbar', 'style:inject', 'modal:confirm']";
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export const CODE_PERMS_MANIFEST = [
+  '// 在插件代码中查看自身权限',
+  'const manifest = xinyu.plugin.getManifest();',
+  'console.log(manifest.commonPermissions);',
+  'console.log(manifest.exclusivePermissions);',
+  'console.log(manifest.requiredPermissions);',
+].join('\n');
+
+export const CODE_SLOTS_DIAGRAM = [
+  '┌──────────────────────────────────────────────────┐',
+  '│  [header-left]  [header-center]  [header-right]  │  ← 顶部导航栏(header)',
+  '├──────────────┬───────────────────┬───────────────┤',
+  '│              │   [message-top]   │               │  ← 消息上方(message-top)',
+  '│              │                   │               │',
+  '│              │ Message List Area │               │',
+  '│[sidebar-left]│                   │[sidebar-right]│',
+  '│              │  [message-bottom] │               │  ← 消息下方(message-bottom)',
+  '│  Left Side   │   [input-above]   │  Right Side   │  ← 输入框正上方(input-above)',
+  '│   Bar Area   │  [input-toolbar]  │   Bar  Area   │  ← 工具栏(input-toolbar)',
+  '│              ├───────────────────┤               │',
+  '│              │     Input Area    │               │',
+  '│              ├───────────────────┤               │',
+  '│              │    [status-bar]   │               │  ← 底部状态栏(status-bar)',
+  '└──────────────┴───────────────────┴───────────────┘',
+  '[model]     ← 模态框（由平台系统控制）',
+  '[floating]  ← 浮动层（fixed 定位，自由放置）',
+  '[overlay]   ← 全屏遮罩层（最高 z-index）',
+].join('\n');
+
+export const CODE_SLOTS_PRIORITY = [
+  "xinyu.ui.registerSlot('status-bar', '插件A', { priority: 1 });  // 最前",
+  "xinyu.ui.registerSlot('status-bar', '插件B', { priority: 10 }); // 中间",
+  "xinyu.ui.registerSlot('status-bar', '插件C');                  // 最后（默认100）",
+].join('\n');
+
+export const CODE_EXAMPLE_1 = [
+  'function setup(xinyu) {',
+  '  // 在状态栏显示游戏时间',
+  '  const startTime = Date.now();',
+  '',
+  "  xinyu.ui.registerSlot('status-bar',",
+  '    \'<div id="game-timer" style="font-size:11px;color:var(--color-text-muted)">\' +',
+  "    '⏱️ 游戏时间: 0分0秒</div>',",
+  '    { priority: 1 }',
+  '  );',
+  '',
+  '  // 每秒更新',
+  '  setInterval(function() {',
+  '    const elapsed = Math.floor((Date.now() - startTime) / 1000);',
+  '    const min = Math.floor(elapsed / 60);',
+  '    const sec = elapsed % 60;',
+  "    const el = document.querySelector('#game-timer');",
+  "    if (el) el.textContent = '⏱️ 游戏时间: ' + min + '分' + sec + '秒';",
+  '  }, 1000);',
+  '}',
+].join('\n');
+
+export const CODE_EXAMPLE_2 = [
+  'function setup(xinyu) {',
+  '  const msgCount = 0;',
+  '',
+  "  xinyu.ui.onHostEvent('message:received', function() {",
+  '    msgCount++;',
+  '    // 更新状态栏',
+  "    xinyu.ui.registerSlot('status-bar',",
+  '      \'<div style="font-size:11px;color:var(--color-text-muted)">\' +',
+  "      '💬 已收到 ' + msgCount + ' 条消息</div>',",
+  '      { priority: 2 }',
+  '    );',
+  '  });',
+  '',
+  '  // 注册一个查看统计的按钮',
+  '  xinyu.ui.registerInputToolbarButton({',
+  "    id: 'msg-stats',",
+  "    label: '统计',",
+  "    icon: '📊',",
+  '    order: 20,',
+  '    onClick: function() {',
+  '      xinyu.ui.showModal({',
+  "        title: '📊 消息统计',",
+  '        content: \'<div style="padding:16px;text-align:center">\' +',
+  '          \'<div style="font-size:32px;font-weight:bold;color:var(--color-accent)">\' + msgCount + \'</div>\' +',
+  "          '<div style=\"color:var(--color-text-muted);margin-top:4px\">已接收消息总数</div></div>',",
+  "        width: '300px'",
+  '      });',
+  '    }',
+  '  });',
+  '}',
+].join('\n');
+
+export const CODE_EXAMPLE_3 = [
+  'function setup(xinyu) {',
+  '  // 注入样式',
+  '  xinyu.ui.injectStyle(`',
+  '    .quick-menu {',
+  '      position: fixed; bottom: 80px; right: 20px;',
+  '      display: flex; flex-direction: column; gap: 8px;',
+  '      z-index: 50;',
+  '    }',
+  '    .quick-menu-btn {',
+  '      width: 44px; height: 44px; border-radius: 50%;',
+  '      background: var(--color-bg-secondary);',
+  '      border: 1px solid var(--color-border);',
+  '      color: var(--color-text-secondary);',
+  '      font-size: 18px; cursor: pointer;',
+  '      display: flex; align-items: center; justify-content: center;',
+  '      transition: all 0.2s;',
+  '    }',
+  '    .quick-menu-btn:hover {',
+  '      background: var(--color-accent); color: #fff;',
+  '      transform: scale(1.1);',
+  '    }',
+  '  `);',
+  '',
+  '  // 在浮动层注入按钮',
+  "  xinyu.ui.registerSlot('floating',",
+  "    '<div class=\"quick-menu\">' +",
+  "    '<button class=\"quick-menu-btn\" onclick=\"document.dispatchEvent(new CustomEvent(\\'plugin-action\\', {detail:\\'look\\'}))\">👁️</button>' +",
+  "    '<button class=\"quick-menu-btn\" onclick=\"document.dispatchEvent(new CustomEvent(\\'plugin-action\\', {detail:\\'talk\\'}))\">💬</button>' +",
+  "    '<button class=\"quick-menu-btn\" onclick=\"document.dispatchEvent(new CustomEvent(\\'plugin-action\\', {detail:\\'rest\\'}))\">🏕️</button>' +",
+  "    '</div>',",
+  '    { priority: 1 }',
+  '  );',
+  '}',
+].join('\n');
+
+export const CODE_DEBUG_EXAMPLE = [
+  'function setup(xinyu) {',
+  "  console.log('插件 manifest:', xinyu.plugin.getManifest());",
+  "  console.log('插件配置:', xinyu.plugin.config.get());",
+  '',
+  '  // 查看游戏状态',
+  "  console.log('游戏状态:', xinyu.game.getState());",
+  "  console.log('游戏属性:', xinyu.game.getAttributes());",
+  '}',
+].join('\n');
+
+// ==================== 新增代码块常量 ====================
+
+// --- CSS 变量章节 ---
+export const CODE_CSS_VAR_INLINE = [
+  '// 在内联 style 中使用 CSS 变量',
+  "xinyu.ui.registerSlot('status-bar',",
+  "  '<div style=\"color:var(--color-text-primary);background:var(--color-bg-secondary);",
+  "    padding:4px 8px;border-radius:var(--border-radius);",
+  "    border:1px solid var(--color-border)\">自定义状态栏</div>',",
+  '  { priority: 1 }',
+  ');',
+  '',
+  '// DOM 沙箱创建元素时使用',
+  "const el = xinyu.ui.dom.create('div', {",
+  "  style: 'background:var(--color-bg-tertiary);color:var(--color-accent);",
+  "    padding:8px;border-radius:var(--border-radius)'",
+  "}, '使用 CSS 变量的元素');",
+].join('\n');
+
+export const CODE_CSS_VAR_INJECT = [
+  '// 在 injectStyle 注入的 CSS 中使用 CSS 变量',
+  'xinyu.ui.injectStyle(`',
+  '  .my-plugin-card {',
+  '    background: var(--color-bg-secondary);',
+  '    border: 1px solid var(--color-border);',
+  '    border-radius: var(--border-radius);',
+  '    padding: 16px;',
+  '    box-shadow: 0 2px 8px var(--color-shadow);',
+  '  }',
+  '  .my-plugin-title {',
+  '    color: var(--color-text-primary);',
+  '    font-family: var(--font-heading);',
+  '    font-size: 16px;',
+  '    margin-bottom: 8px;',
+  '  }',
+  '  .my-plugin-desc {',
+  '    color: var(--color-text-secondary);',
+  '    font-family: var(--font-body);',
+  '    font-size: 13px;',
+  '    line-height: 1.6;',
+  '  }',
+  '  .my-plugin-btn {',
+  '    background: var(--color-accent);',
+  '    color: var(--color-text-primary);',
+  '    border: none;',
+  '    border-radius: var(--border-radius);',
+  '    padding: 8px 16px;',
+  '    cursor: pointer;',
+  '    transition: background 0.2s;',
+  '  }',
+  '  .my-plugin-btn:hover {',
+  '    background: var(--color-accent-hover);',
+  '  }',
+  '`);',
+].join('\n');
+
+export const CODE_CSS_VAR_CUSTOM = [
+  '// 创建自定义 CSS 变量（建议使用插件前缀避免冲突）',
+  'xinyu.ui.injectStyle(`',
+  '  :root {',
+  '    --my-dice-primary: #e74c3c;',
+  '    --my-dice-secondary: #c0392b;',
+  '    --my-dice-bg: rgba(231, 76, 60, 0.1);',
+  '    --my-dice-radius: 8px;',
+  '  }',
+  '  .dice-result {',
+  '    background: var(--my-dice-bg);',
+  '    color: var(--my-dice-primary);',
+  '    border: 2px solid var(--my-dice-secondary);',
+  '    border-radius: var(--my-dice-radius);',
+  '    padding: 12px;',
+  '    font-size: 24px;',
+  '    font-weight: bold;',
+  '    text-align: center;',
+  '  }',
+  '`);',
+  '',
+  '// 使用自定义变量',
+  "xinyu.ui.registerSlot('status-bar',",
+  "  '<div class=\"dice-result\">🎲 6</div>',",
+  '  { priority: 5 }',
+  ');',
+].join('\n');
+
+// --- 插件存储章节 ---
+export const CODE_STORAGE_PLUGIN = [
+  '// 使用 xinyu.plugin.storage（推荐方式）',
+  'function setup(xinyu) {',
+  "  // 读取用户偏好",
+  '  const theme = xinyu.plugin.storage.get("theme") || "auto";',
+  '  const fontSize = xinyu.plugin.storage.get("fontSize") || 14;',
+  '',
+  '  // 保存用户偏好',
+  '  xinyu.plugin.storage.set("theme", "dark");',
+  '  xinyu.plugin.storage.set("fontSize", 16);',
+  '',
+  '  // 也可以存储 JSON 对象（自动序列化）',
+  '  xinyu.plugin.storage.set("userSettings", {',
+  '    theme: "dark",',
+  '    fontSize: 16,',
+  '    language: "zh-CN",',
+  '    notifications: true',
+  '  });',
+  '',
+  '  // 读取 JSON 对象',
+  '  const settings = xinyu.plugin.storage.get("userSettings");',
+  '  console.log(settings.theme);  // "dark"',
+  '',
+  '  // 删除某个键',
+  '  xinyu.plugin.storage.remove("theme");',
+  '',
+  '  // 获取所有键名',
+  '  const allKeys = xinyu.plugin.storage.keys();',
+  "  console.log('存储的键:', allKeys);",
+  '}',
+].join('\n');
+
+export const CODE_STORAGE_GAME = [
+  '// 使用 xinyu.game.setState / getState 管理游戏状态',
+  'function setup(xinyu) {',
+  "  xinyu.plugin.on('onGameInit', function() {",
+  '    // 初始化游戏状态',
+  '    xinyu.game.setState({',
+  '      gold: 100,',
+  '      level: 1,',
+  '      exp: 0,',
+  '      currentScene: "village"',
+  '    });',
+  '  });',
+  '',
+  '  // 读取游戏状态',
+  '  const state = xinyu.game.getState();',
+  "  console.log('金币:', state.gold);",
+  '',
+  '  // 更新游戏状态（会触发 game:stateChange 事件）',
+  '  xinyu.game.setState({ gold: state.gold + 50 });',
+  '',
+  '  // 监听游戏状态变更（所有插件都能收到）',
+  "  xinyu.ui.onHostEvent('game:stateChange', function(data) {",
+  "    console.log('变更的键:', data.changedKeys);",
+  '    // data.changedKeys = ["gold"]',
+  '  });',
+  '}',
+].join('\n');
+
+export const CODE_STORAGE_ATTR = [
+  '// 使用 registerAttribute / setAttribute 管理游戏属性',
+  'function setup(xinyu) {',
+  "  xinyu.plugin.on('onGameInit', function() {",
+  '    // 注册属性（会显示在游戏属性面板中）',
+  '    xinyu.game.registerAttribute({',
+  "      key: 'hp',",
+  "      label: '生命值',",
+  "      type: 'number',",
+  "      value: 100,",
+  "      icon: '❤️',",
+  "      color: '#e74c3c'",
+  '    });',
+  '',
+  '    xinyu.game.registerAttribute({',
+  "      key: 'mp',",
+  "      label: '魔法值',",
+  "      type: 'number',",
+  "      value: 50,",
+  "      icon: '💎',",
+  "      color: '#3498db'",
+  '    });',
+  '',
+  '    xinyu.game.registerAttribute({',
+  "      key: 'status',",
+  "      label: '状态',",
+  "      type: 'string',",
+  "      value: '正常',",
+  "      icon: '⭐'",
+  '    });',
+  '  });',
+  '',
+  '  // 更新属性值',
+  '  xinyu.game.setAttribute("hp", 80);',
+  '',
+  '  // 读取所有属性',
+  '  const attrs = xinyu.game.getAttributes();',
+  "  console.log('HP:', attrs.hp.value);  // 80",
+  '}',
+].join('\n');
+
+// --- AI 拦截章节 ---
+export const CODE_AI_PROMPT = [
+  '// 四种 AI 拦截器示例',
+  'function setup(xinyu) {',
+  '',
+  '  // 1. Prompt 构建拦截 - 注入 NPC 人格',
+  '  xinyu.ai.onPromptBuild(function(prompt, worldSetting) {',
+  '    return prompt + "\\n\\n[系统指令] 你现在扮演酒馆老板老王，说话粗犷豪爽。";',
+  '  });',
+  '',
+  '  // 2. 发送前拦截 - 修改消息内容',
+  '  xinyu.ai.onBeforeSend(function(messages) {',
+  '    // messages: [{ role: "user", content: "..." }, ...]',
+  '    return messages; // 返回修改后的消息数组',
+  '  });',
+  '',
+  '  // 3. 接收后拦截 - 内容格式化',
+  '  xinyu.ai.onAfterReceive(function(content) {',
+  '    // 移除多余的空行',
+  '    return content.replace(/\\n{3,}/g, "\\n\\n");',
+  '  });',
+  '',
+  '  // 4. 请求配置拦截 - 动态调整模型参数',
+  '  xinyu.ai.onRequestConfig(function(config) {',
+  '    config.model = "gpt-4";',
+  '    return config;',
+  '  });',
+  '}',
+].join('\n');
+
+export const CODE_AI_PIPELINE = [
+  '// 管道模式：多个插件的拦截器按注册顺序依次执行',
+  '//',
+  '// 假设有三个插件都注册了 onPromptBuild：',
+  '//',
+  '// 原始 Prompt:',
+  '//   "你是一个奇幻世界的 AI 导游..."',
+  '//',
+  '// Plugin A (NPC 人格插件) onPromptBuild:',
+  '//   输入: "你是一个奇幻世界的 AI 导游..."',
+  '//   输出: "你是一个奇幻世界的 AI 导游...\\n[你现在是酒馆老板老王]"',
+  '//',
+  '// Plugin B (规则注入插件) onPromptBuild:',
+  '//   输入: "你是一个奇幻世界的 AI 导游...\\n[你现在是酒馆老板老王]"',
+  '//   输出: "你是一个奇幻世界的 AI 导游...\\n[你现在是酒馆老板老王]\\n[规则: 战斗判定使用 d20]"',
+  '//',
+  '// Plugin C (状态注入插件) onPromptBuild:',
+  '//   输入: "...\\n[规则: 战斗判定使用 d20]"',
+  '//   输出: "...\\n[规则: 战斗判定使用 d20]\\n[当前玩家HP: 80/100]"',
+  '//',
+  '// 最终发送给 AI 的 Prompt = Plugin C 的输出',
+  '//',
+  '// 注意：每个 handler 应该返回修改后的值，不要返回 undefined',
+].join('\n');
+
+export const CODE_AI_NPC = [
+  '// 完整示例：NPC 人格注入插件',
+  'function setup(xinyu) {',
+  '  const npcData = {',
+  '    name: "酒馆老板·老王",',
+  '    personality: "粗犷豪爽，喜欢讲冒险故事，偶尔会推销自己的特酿麦酒",',
+  '    speech: "说话带点江湖气，用词朴实，偶尔夹杂方言"',
+  '  };',
+  '',
+  '  // 在 Prompt 中注入 NPC 人格',
+  '  xinyu.ai.onPromptBuild(function(prompt) {',
+  '    const npcPrompt = "\\n\\n[角色扮演指令]\\n"',
+  '      + "你现在是 " + npcData.name + "\\n"',
+  '      + "性格: " + npcData.personality + "\\n"',
+  '      + "说话风格: " + npcData.speech + "\\n"',
+  '      + "请始终保持角色，不要脱离人设。";',
+  '    return prompt + npcPrompt;',
+  '  });',
+  '',
+  '  // 在状态栏显示当前 NPC',
+  "  xinyu.ui.registerSlot('status-bar',",
+  '    \'<div style="font-size:11px;color:var(--color-text-muted)">\' +',
+  "    '🎭 当前 NPC: ' + npcData.name + '</div>',",
+  '    { priority: 1 }',
+  '  );',
+  '',
+  '  // 注册切换 NPC 的按钮',
+  '  xinyu.ui.registerInputToolbarButton({',
+  "    id: 'switch-npc',",
+  "    label: '切换NPC',",
+  "    icon: '🎭',",
+  '    order: 15,',
+  '    onClick: function() {',
+  '      xinyu.ui.showModal({',
+  "        title: '🎭 切换 NPC',",
+  "        content: '<div style=\"padding:12px\">选择要扮演的 NPC</div>',",
+  "        width: '350px'",
+  '      });',
+  '    }',
+  '  });',
+  '}',
+].join('\n');
+
+// --- 插件配置章节 ---
+export const CODE_CONFIG_SCHEMA = [
+  '// configSchema 定义示例（骰子插件）',
+  'const configSchema = [',
+  '  {',
+  "    key: 'defaultDice',",
+  "    label: '默认骰子面数',",
+  "    type: 'select',",
+  "    defaultValue: '20',",
+  "    description: '掷骰时使用的默认面数',",
+  "    options: [",
+  "      { value: '4', label: 'D4 (四面骰)' },",
+  "      { value: '6', label: 'D6 (六面骰)' },",
+  "      { value: '8', label: 'D8 (八面骰)' },",
+  "      { value: '10', label: 'D10 (十面骰)' },",
+  "      { value: '12', label: 'D12 (十二面骰)' },",
+  "      { value: '20', label: 'D20 (二十面骰)' },",
+  "      { value: '100', label: 'D100 (百面骰)' }",
+  '    ]',
+  '  },',
+  '  {',
+  "    key: 'showAnimation',",
+  "    label: '显示掷骰动画',",
+  "    type: 'boolean',",
+  "    defaultValue: true,",
+  "    description: '掷骰时是否显示动画效果'",
+  '  },',
+  '  {',
+  "    key: 'customModifier',",
+  "    label: '固定修正值',",
+  "    type: 'number',",
+  "    defaultValue: 0,",
+  "    description: '每次掷骰后自动加减的固定值'",
+  '  },',
+  '  {',
+  "    key: 'rollCommand',",
+  "    label: '掷骰指令前缀',",
+  "    type: 'text',",
+  "    defaultValue: '/roll',",
+  "    description: '触发掷骰的聊天指令'",
+  '  },',
+  '  {',
+  "    key: 'diceNote',",
+  "    label: '骰子备注',",
+  "    type: 'textarea',",
+  "    defaultValue: '',",
+  "    description: '自定义的骰子规则说明'",
+  '  }',
+  '];',
+].join('\n');
+
+export const CODE_CONFIG_READ = [
+  '// 在插件代码中读取配置',
+  'function setup(xinyu) {',
+  '',
+  '  // 获取全部配置',
+  '  const config = xinyu.plugin.config.get();',
+  "  console.log('默认骰子:', config.defaultDice);",
+  "  console.log('显示动画:', config.showAnimation);",
+  '',
+  '  // 获取单个配置值',
+  '  const dice = xinyu.plugin.config.get("defaultDice");',
+  '  const modifier = xinyu.plugin.config.get("customModifier");',
+  '',
+  '  // 配置值来自用户在插件管理页面中的设置',
+  '  // 如果用户未修改，则使用 defaultValue',
+  '  const total = xinyu.utils.rollDice("1d" + dice).total + modifier;',
+  "  xinyu.ui.toast('掷骰结果: ' + total, 'info');",
+  '}',
+].join('\n');
+
+export const CODE_CONFIG_FULL = [
+  '// 完整示例：带配置的骰子插件',
+  'function setup(xinyu) {',
+  '  // 读取配置',
+  '  const config = xinyu.plugin.config.get();',
+  '  const dice = config.defaultDice || "20";',
+  '  const modifier = config.customModifier || 0;',
+  '  const showAnim = config.showAnimation !== false;',
+  '',
+  '  // 注册掷骰指令',
+  '  xinyu.chat.registerCommand({',
+  "    name: config.rollCommand || '/roll',",
+  "    description: '掷骰子',",
+  '    handler: function(args) {',
+  '      const notation = args[0] || ("1d" + dice);',
+  '      const result = xinyu.utils.rollDice(notation);',
+  '      const total = result.total + modifier;',
+  '',
+  '      const msg = "🎲 " + notation;',
+  '      if (modifier !== 0) msg += (modifier > 0 ? "+" : "") + modifier;',
+  '      msg += " = " + total;',
+  '',
+  '      xinyu.chat.insertSystemMessage(msg);',
+  '      return msg;',
+  '    }',
+  '  });',
+  '',
+  '  // 在状态栏显示当前骰子设置',
+  "  xinyu.ui.registerSlot('status-bar',",
+  '    \'<div style="font-size:11px;color:var(--color-text-muted)">\' +',
+  "    '🎲 D' + dice + (modifier ? (modifier > 0 ? '+' : '') + modifier : '') + '</div>',",
+  '    { priority: 5 }',
+  '  );',
+  '}',
+].join('\n');
+
+// --- 导入导出章节 ---
+export const CODE_EXPORT_FORMAT = [
+  '// 导出格式示例',
+  '//',
+  '// 单个插件导出（直接返回插件 JSON）：',
+  '{',
+  '  "id": "my-dice-plugin",',
+  '  "name": "我的骰子插件",',
+  '  "version": "1.0.0",',
+  '  "type": "game-mechanics",',
+  '  "description": "一个简单的骰子插件",',
+  '  "author": "作者名",',
+  '  "code": "function setup(xinyu) { ... }",',
+  '  "configSchema": [...],',
+  '  "commonPermissions": ["slot:status-bar", "style:inject"],',
+  '  "exclusivePermissions": [],',
+  '  "requiredPermissions": []',
+  '}',
+  '',
+  '// 批量导出（xinyu-extension-v1 格式）：',
+  '{',
+  '  "format": "xinyu-extension-v1",',
+  '  "exportedAt": "2026-04-26T12:00:00.000Z",',
+  '  "plugins": [',
+  '    { "id": "plugin-a", ... },',
+  '    { "id": "plugin-b", ... }',
+  '  ]',
+  '}',
+].join('\n');
+
+export const CODE_IMPORT_FORMAT = [
+  '// 导入格式（支持 3 种）',
+  '//',
+  '// 格式 1：完整导出格式',
+  '{',
+  '  "format": "xinyu-extension-v1",',
+  '  "exportedAt": "2026-04-26T12:00:00.000Z",',
+  '  "plugins": [',
+  '    {',
+  '      "id": "my-plugin",',
+  '      "name": "我的插件",',
+  '      "version": "1.0.0",',
+  '      "type": "game-mechanics",',
+  '      "description": "插件描述",',
+  '      "author": "作者名",',
+  '      "code": "function setup(xinyu) { ... }",',
+  '      "configSchema": [...],',
+  '      "commonPermissions": [...],',
+  '      "exclusivePermissions": [...],',
+  '      "requiredPermissions": [...]',
+  '    }',
+  '  ]',
+  '}',
+  '',
+  '// 格式 2：直接数组',
+  '[',
+  '  { "id": "plugin-a", "name": "插件A", "code": "..." },',
+  '  { "id": "plugin-b", "name": "插件B", "code": "..." }',
+  ']',
+  '',
+  '// 格式 3：单个插件',
+  '{',
+  '  "id": "my-plugin",',
+  '  "name": "我的插件",',
+  '  "code": "function setup(xinyu) { ... }"',
+  '}',
+].join('\n');
+
+// --- 安全章节 ---
+export const CODE_SECURITY_TAGS = [
+  '// 允许的 HTML 标签完整列表（46 个）',
+  '//',
+  '// 文本结构：div, span, p, h1, h2, h3, h4, h5, h6,',
+  '//           br, hr, pre, code, blockquote',
+  '//',
+  '// 列表：ul, ol, li, dl, dt, dd',
+  '//',
+  '// 表格：table, thead, tbody, tfoot, tr, th, td, caption, colgroup, col',
+  '//',
+  '// 表单（仅展示，无功能）：label, fieldset, legend',
+  '//',
+  '// 媒体：img, figure, figcaption, video, audio, source, canvas',
+  '//',
+  '// 语义化：article, section, aside, header, footer, nav, main,',
+  '//        details, summary, time, mark, abbr, small, strong, em, b, i,',
+  '//        u, s, sub, sup, del, ins',
+  '//',
+  '// 禁止的标签：script, style, link, meta, iframe,',
+  '//            object, embed, applet, form, input, select, textarea, button',
+  '//',
+  '// 禁止的属性前缀：on*, srcdoc, formaction, xlink:href',
+  '// 禁止的协议：javascript:',
+].join('\n');