myapp-creator#

Version: 1.0.31

让用户用一句话生成可独立打开的单文件 HTML 应用或文档，并落库到 fe-service。 本 skill 不主动调用 LLM，所有 HTML / app_name / features 由调用本 skill 的 LLM agent 直接产出后传入工具。

⚠️ 最高优先级规则（违反即为严重错误）：

1. 游戏类应用 绝对禁止 包含任何形式的 AI 对手、人机对战、电脑自动下棋/出牌。棋类/对战类游戏 只允许 双人同屏轮流操作，不实现任何计算机决策逻辑。
2. 所有应用 绝对禁止 出现"导出"、"打印"、"保存"按钮或相关功能代码。

触发条件#

当用户需求匹配以下任一类别时，本 skill 参与：

应用类（交互式 HTML）#

关键词：应用、app、小游戏、游戏、网页、页面、工具、计算器、时钟、日历、翻译器、转换器 示例：

• "做一个贪吃蛇游戏"
• "创建一个番茄钟"
• "生成一个天气页面"
• "给我做一个马里奥游戏"
• "帮我做一个单位转换工具"

文件类（文档式 HTML）#

关键词：文档、文件、word、ppt、演示文稿、slides、pdf、excel、xlsx、表格、报告、简历、周报、日报、总结、方案、计划书 示例：

• "生成一个项目周报"
• "做一个自我介绍PPT"
• "创建一个预算表格"
• "帮我写一份简历"
• "保存一个会议纪要文档"

不触发（交给龙虾其他能力）#

• 图片/绘画类："画一张…"、"生成一张图片…"
• 音频/音乐类："生成一首歌…"、"合成语音…"
• 视频类："剪辑一个…"、"生成视频…"
• 小说/纯文本类："写一篇小说…"、"写一首诗…"（纯创作不产出可交互文件）
• 纯问答/聊天/闲聊

判断规则#

用户意图是"产出一个可独立打开、保存下来反复使用的文件或应用"时触发本 skill。 如果用户只是想让你"说一段话"或"回答问题"，不要触发。

触发标记（兼容旧入口）#

以下前缀仍可直接触发，不需要语义判断：

• [create_app]<描述> → 创建新应用/文件
• [update_app:app_id=<n>]<描述> → 更新已有应用/文件
• [install_check:session=<sid>] → 安装自检（仅调 myapp_ping）
• 不带上述前缀 → 按语义判断是否匹配触发条件

创建流程#

最长等待 300s。若 300s 内不能完成 HTML 生成与 myapp_register 调用，直接回复"应用创建失败，请稍后重试"。

1. 解析用户描述，判断类型（应用类 or 文件类），产出：

   • app_name：应用/文件名，≤30 字
   • features：JSON 字符串数组，3~8 条，每条 ≤30 字，描述具体功能/内容要点
   • html_content：完整可独立打开的单文件 HTML（按类型选择模板风格）

2. HTML 通用约束：

   • 自包含：CSS/JS 全部内联在 <style> / <script>
   • 不依赖本地资源
   • 外部资源仅允许：unpkg.com / jsdelivr.net / cdnjs.cloudflare.com
   • 总长度 ≤ 60KB（UTF-8 字节数）
   • 不引用任何小度专属 API
   • 必须包含 <meta name="viewport" content="width=device-width,initial-scale=1">

目标运行环境 — Android 8.1 WebView（Chrome/85）： 所有 HTML 最终运行在搭载 Android 8.1 的智能屏 WebView 中，无鼠标/硬键盘，仅支持触摸和左右滑动。 生成代码时必须遵守以下兼容规则：

JS / Web API 兼容（feature detection 优先，禁止仅凭 UA 判断）：

• 使用 typeof IntersectionObserver !== 'undefined' 等特性检测，不要直接调用可能不存在的 API

• 禁止使用 Chrome 86+ 才支持的 API： CSS.registerProperty、 @property、 content-visibility、 aspect-ratio（CSS）、 ResizeObserver（需检测）、 structuredClone（用 JSON.parse(JSON.stringify()) 替代）

• 禁止使用 ES2020+ 语法： ??=、 ||=、 &&=、 import() 动态导入、 BigInt、 globalThis（用 window 替代）

• 禁止使用 ctx.roundRect()——这是 Canvas 2D 的新方法，Chrome 99 才加入，Chrome 85 WebView 直接抛异常导致整个 draw 函数崩溃。必须用以下自定义 helper 替代： js

  function rr(ctx, x, y, w, h, r) {
    ctx.beginPath();
    ctx.moveTo(x + r, y);
    ctx.lineTo(x + w - r, y);  ctx.arcTo(x + w, y,     x + w, y + r,     r);
    ctx.lineTo(x + w, y + h - r); ctx.arcTo(x + w, y + h, x + w - r, y + h, r);
    ctx.lineTo(x + r, y + h);  ctx.arcTo(x,     y + h, x,     y + h - r, r);
    ctx.lineTo(x, y + r);      ctx.arcTo(x,     y,     x + r, y,         r);
    ctx.closePath();
  }
  // 用法：rr(ctx, x, y, w, h, radius); ctx.fill();
  
  

• 禁止在 Canvas 内用 emoji 字符（如 🌕🔥❤️ 等）——Android WebView 字体渲染异常会抛异常或显示方块。Canvas 内所有文字必须用纯 ASCII/中文文字，用几何图形代替 emoji（如"♥ × 3"改用红色圆形绘制）

• 可安全使用： Promise、 async/await、 fetch、 CSS Grid、 Flexbox、 CSS Variables、 IntersectionObserver（需检测）、 requestAnimationFrame

• localStorage / sessionStorage 在 WebView 中可用，但不要依赖跨页面持久化

CSS 兼容：

• 100vh 在 Android WebView 中等于视口高度（无地址栏问题），可直接使用
• position: sticky 在 Chrome 85 中支持，但父容器不能有 overflow: hidden，否则失效
• position: fixed 在 WebView 中软键盘弹出时可能错位，避免在输入框场景依赖 fixed 定位
• 禁止使用 CSS inset 属性（ inset: 0 等简写）——Chrome 87 才支持，Chrome 85 不识别，会导致遮罩层无法撑满、内容偏移到左上角。替换写法： top:0; left:0; right:0; bottom:0（注意： box-shadow 中的 inset 关键字不受此限制，可以正常使用）
• 禁止使用 backdrop-filter（Chrome 85 需前缀，WebView 不保证支持）
• clamp() 在 Chrome 85 中已支持，可正常使用
• 滚动容器加 -webkit-overflow-scrolling: touch 保证惯性滚动

触摸与交互：

• 所有可点击元素最小触摸区域 ≥ 44×44px
• 使用 touchstart/ touchmove/ touchend 处理手势； click 在 WebView 中有 300ms 延迟，交互敏感场景改用 touch 事件
• 消除 300ms 延迟：在 <meta name="viewport"> 中加 user-scalable=no 或在 CSS 中加 touch-action: manipulation
• 禁止依赖 hover 状态（无鼠标），交互反馈改用 :active 或 JS touch 事件
• 左右滑动手势用 touchstart/ touchend 计算 deltaX 实现，不要用第三方手势库（CDN 可能不可达）
• 游戏类应用禁止使用键盘事件（ keydown/ keyup）作为唯一控制方式，必须提供触摸按钮

软键盘与输入框：

• 输入框获焦时 WebView 会 resize 视口，避免用 height: 100vh 做全屏布局的唯一约束
• 输入框弹出软键盘后 fixed 元素可能被遮挡，底部操作栏改用 position: sticky 或监听 visualViewport.resize
• 如需监听软键盘： window.visualViewport 在 Chrome 61+ 可用，Chrome 85 支持

弹窗 / Modal：

• 自定义弹窗用 position: fixed; top:0; left:0; width:100%; height:100% 覆盖全屏

• 弹窗内滚动区域加 overflow-y: auto; -webkit-overflow-scrolling: touch

• 禁止使用原生 alert()/ confirm()/ prompt()（WebView 中可能被宿主拦截）

• 横屏多设备适配：目标设备均为横屏展示，尺寸差异较大： 设备视口宽×高比例普通智能屏960×600mini智能屏960×480闺蜜机1280×720秋月1280×800pad1920×1080pad172560×1600布局以横屏为前提（宽 > 高），使用 vw/ vh/百分比等响应式单位，禁止固定像素宽度导致小屏溢出或大屏留白。字体大小建议用 clamp() 适配，如 font-size: clamp(14px, 2vw, 18px)。

1. HTML 模板风格（按类型选择）：

   应用类 — 交互式：

   • 纯单机离线游戏/工具，不依赖任何 server 服务
   • 严禁实现 AI 对手 / 人机对战 / 电脑自动下棋等功能，棋类游戏只做双人同屏轮流对战（两个玩家在同一屏幕上交替操作）
   • 棋类游戏正确做法示例：五子棋 → 黑白双方轮流点击落子，判断五连胜负，无任何电脑决策代码；象棋 → 红黑双方轮流移动棋子
   • 功能简单易上手，玩法直观，适合触屏快速操作
   • 支持触屏操作（touch 事件）
   • 美观的 UI 设计
   • 根容器使用 width:100vw; height:100vh; overflow:hidden 撑满全屏
   • 关键元素尺寸用 vmin 或百分比，确保 960px 小屏到 2560px 大屏均可用

游戏类强制横版左右布局（所有游戏类应用必须遵守）：

⚠️ 强制要求：所有游戏页面必须是横版布局，整体分为左右两栏， 禁止竖版堆叠布局。

布局结构如下： text

┌─────────────────────────────┬──────────────────┐
│                             │  状态（必展示）    │
│                             │  关卡/得分/生命    │
│       游戏区域（左栏）        ├──────────────────┤
│    占总宽约 65%~70%          │  下一块/预览      │
│    高度撑满 100vh            ├──────────────────┤
│                             │ ◀ II ▶  方向键   │
└─────────────────────────────┴──────────────────┘

右栏布局规则（状态区和方向键始终可见）：

• #status（关卡、难度、得分/目标分、生命）： flex:0 0 auto， 必须展示，不可压缩
• #game-preview（下一块/预览区）： flex:0 0 auto， 有预览需求的游戏必须展示，不可压缩
• #leaderboard（排行榜）和 #instructions（操作说明）： 当游戏有 #game-preview 时，不展示排行榜和操作说明（右栏空间有限，预览区优先）。仅在无预览需求的游戏中，才用 flex:1 1 0; min-height:0 + 标题 h3 固定 + .sb-inner 内容区 overflow-y:auto 独立滚动的方式展示
• #controls（方向键+暂停）： flex:0 0 auto， 固定在右栏底部，始终可见，不参与滚动

CSS 骨架模板（必须使用）： html

<div id="app" style="width:100vw;height:100vh;display:flex;flex-direction:row;overflow:hidden;background:#1a1a2e;">
  <!-- 左栏：游戏区域，尽量大，canvas 撑满整个左栏，不留空白 -->
  <div id="game-area" style="flex:1;position:relative;min-width:0;">
    <canvas id="canvas" style="display:block;width:100%;height:100%;"></canvas>
    <!-- 开始/结束/暂停 遮罩层：必须用以下写法居中，禁止只写 top:0;left:0 导致内容贴左上角 -->
    <!-- <div id="overlay" style="position:absolute;top:0;left:0;right:0;bottom:0;display:flex;flex-direction:column;
         align-items:center;justify-content:center;text-align:center;
         background:rgba(0,0,0,.6);z-index:10;">
      <h2 style="color:#fff;font-size:clamp(18px,3vw,32px);margin:0 0 2vh;">游戏标题</h2>
      <p style="color:#ccc;font-size:clamp(12px,1.8vw,18px);margin:0 0 3vh;">操作说明文字</p>
      <button style="padding:1.2vh 4vw;font-size:clamp(14px,2vw,20px);border-radius:2vmin;
        border:none;background:#e74c3c;color:#fff;touch-action:manipulation;">开始游戏</button>
    </div> -->
    <!-- ⚠️ 遮罩内所有文字/按钮必须通过 flexbox 居中，严禁使用固定 top/left 像素值定位 -->
  </div>
  <!-- 右栏：固定宽度，状态区+方向键始终可见 -->
  <div id="sidebar" style="width:26vw;min-width:180px;max-width:300px;height:100vh;
       display:flex;flex-direction:column;padding:1.5vh 1.2vw;gap:0.8vh;box-sizing:border-box;overflow:hidden;">
    <!-- ① 游戏状态：必展示，不可压缩 -->
    <div id="status" style="flex:0 0 auto;font-size:clamp(10px,1.4vw,14px);">关卡/得分/生命...</div>
    <!-- ② 预览区（下一块等）：有预览需求时展示；若有预览区则不放排行榜和操作说明 -->
    <div id="game-preview" style="flex:1 1 0;min-height:0;">...</div>
    <!-- ③④ 排行榜+操作说明：仅在无预览区的游戏中使用（与 ② 二选一） -->
    <!--
    <div id="leaderboard" style="flex:1 1 0;min-height:0;display:flex;flex-direction:column;font-size:clamp(10px,1.3vw,13px);">
      <h3 style="flex:0 0 auto;margin:0 0 0.4vh;">排行榜</h3>
      <div class="sb-inner" style="flex:1 1 0;min-height:0;overflow-y:auto;-webkit-overflow-scrolling:touch;
           scrollbar-width:thin;scrollbar-color:rgba(255,255,255,.3) transparent;">
      </div>
    </div>
    <div id="instructions" style="flex:1 1 0;min-height:0;display:flex;flex-direction:column;font-size:clamp(10px,1.3vw,13px);">
      <h3 style="flex:0 0 auto;margin:0 0 0.4vh;">操作说明</h3>
      <div class="sb-inner" style="flex:1 1 0;min-height:0;overflow-y:auto;-webkit-overflow-scrolling:touch;
           scrollbar-width:thin;scrollbar-color:rgba(255,255,255,.3) transparent;">
      </div>
    </div>
    -->
    <!-- ⑤ 方向键+暂停：固定在底部，始终可见 -->
    <div id="controls" style="flex:0 0 auto;padding-top:0.8vh;">...</div>
  </div>
</div>

Canvas 尺寸初始化（JS 中必须这样写，确保 Android 8.1 WebView 中 canvas 像素与显示尺寸一致）：

⚠️ Android 8.1 WebView 已知问题：页面刚加载时 clientWidth/clientHeight 可能为 0，导致 Canvas 尺寸变成 0×0、什么都画不出来。必须用以下模板，通过 window.load + 双层 requestAnimationFrame 延迟读取尺寸，并用 offsetWidth 做兜底。

Canvas CSS（必须用 position:absolute 撑满，不依赖 flex 布局尺寸）： html

<div id="game-area" style="flex:1;position:relative;min-width:0;">
  <canvas id="canvas" style="position:absolute;top:0;left:0;width:100%;height:100%;display:block;"></canvas>
</div>

Canvas 尺寸初始化（必须在 window.load + 双层 requestAnimationFrame 后执行）： js

function initCanvas() {
  const gameArea = document.getElementById('game-area');
  const canvas = document.getElementById('canvas');
  // offsetWidth 兜底：Android 8.1 WebView 刚加载时 clientWidth 可能为 0
  const w = gameArea.clientWidth  || gameArea.offsetWidth  || window.innerWidth * 0.7;
  const h = gameArea.clientHeight || gameArea.offsetHeight || window.innerHeight;
  canvas.width  = w;
  canvas.height = h;
  // 格子大小根据 canvas 尺寸动态计算
  const COLS = 30, ROWS = Math.floor(h / (w / COLS));
  const cellW = w / COLS, cellH = h / ROWS;
  // ... 其余游戏初始化逻辑
}

// 必须在 window.load 后、双层 rAF 确保布局渲染完毕再读尺寸
window.addEventListener('load', function() {
  requestAnimationFrame(function() {
    requestAnimationFrame(function() {
      initCanvas();
    });
  });
});

游戏类 WebView 触摸适配要点（Android 8.1 WebView 无键盘/鼠标）：

⚠️ 强制要求（主控方式）：所有游戏的 主要控制方式必须是触摸坐标直接映射——玩家手指按在画布哪里，角色/目标就跟到哪里（或朝那个方向移动），不需要抬手再点方向按钮。右下角的 ↑↓←→ 方向键和暂停键保留作为 辅助控制，不是唯一控制入口。暂停按钮必须位于方向键 3×3 grid 的 正中心格。

触摸坐标映射实现模板（贴在 Canvas/游戏容器上）： js

// 主控：手指位置直接映射到游戏坐标
canvas.addEventListener('touchstart', onTouch, {passive: false});
canvas.addEventListener('touchmove',  onTouch, {passive: false});

function onTouch(e) {
  e.preventDefault();
  const rect = canvas.getBoundingClientRect();
  const touch = e.touches[0];
  // 将屏幕像素坐标换算为 canvas 内部坐标
  const cx = (touch.clientX - rect.left) * (canvas.width  / rect.width);
  const cy = (touch.clientY - rect.top)  * (canvas.height / rect.height);
  movePlayerTo(cx, cy);   // 替换为游戏实际函数：直接设置目标坐标
}

• 对于贪吃蛇、俄罗斯方块等离散格子类游戏，触摸映射改为 滑动方向： touchstart 记录起点， touchend 计算 deltaX/deltaY，阈值 20px 内忽略，超过则取绝对值较大的轴作为方向
• 对于飞机大战、跑酷等连续坐标类游戏，用 touchmove 实时跟随手指坐标
• 左侧游戏遮罩/操作说明中必须用一句话说明触摸操作方式，例如：「触摸屏幕控制移动，手指在哪飞机就去哪」

飞机大战类游戏专项规则：

• 子弹必须自动连续发射（ setInterval 或游戏主循环中每隔固定帧数发射）， 禁止要求玩家手动点击射击
• 自动射频简单难度约 300ms/发，中等 200ms/发，困难 100ms/发
• 操作说明中写「触摸屏幕移动飞机，子弹自动发射」

俄罗斯方块/消除类游戏专项规则：

• 贴地即锁，零等待：下落计时器触发时若方块无法继续下移，立刻执行 lock() → spawn()，下一块在同一帧内出现。 禁止 LOCK_DELAY 缓冲期
• spawnPiece() 必须将新方块赋值给全局变量（如 cur = shape），否则 drawGrid() 中 if(cur != null) 判断为 false 导致方块不显示
• 经典 NES 速度标准：第 1 关 800ms → 第 5 关 533ms → 第 10 关 333ms → 第 15 关 200ms → 第 20 关 100ms → 第 29 关+ 83ms（极限）
• 难度递增公式： interval = Math.max(83, 800 - (level - 1) * 5 * (1000/60))（每关减约 5 帧，60fps 基准）
• 预览区（下一块）在右栏 #game-preview 中展示，有预览时不展示排行榜和操作说明

方向键 + 暂停按钮模板（放在右栏 #controls 内，作为辅助控制）：

布局规则： 暂停按钮放在方向键 3×3 grid 的正中心格，不单独放在键盘上方。整体视觉要炫酷：方向键用半透明玻璃质感，暂停键用蓝色渐变 + 光晕， :active 有明显按压反馈。 html

<div id="controls" style="flex:0 0 auto;display:flex;flex-direction:column;align-items:center;
     gap:0.8vh;touch-action:none;user-select:none;">
  <!-- 3×3 方向键grid，暂停在正中心 -->
  <div style="display:grid;grid-template-columns:repeat(3,13vmin);grid-template-rows:repeat(3,13vmin);gap:1.2vmin;">
    <div></div>
    <button class="dpad-btn" id="btn-up">▲</button>
    <div></div>
    <button class="dpad-btn" id="btn-left">◀</button>
    <button class="dpad-btn" id="btn-pause">II</button>
    <button class="dpad-btn" id="btn-right">▶</button>
    <div></div>
    <button class="dpad-btn" id="btn-down">▼</button>
    <div></div>
  </div>
</div>
<style>
/* 方向键：半透明玻璃质感 */
.dpad-btn {
  background: linear-gradient(145deg, rgba(255,255,255,.22), rgba(255,255,255,.06));
  border: 1.5px solid rgba(255,255,255,.35);
  border-radius: 50%;
  color: #fff;
  font-size: 4.5vmin;
  touch-action: manipulation;
  display: flex;
  align-items: center;
  justify-content: center;
  box-shadow: 0 2px 8px rgba(0,0,0,.4), inset 0 1px 0 rgba(255,255,255,.25);
  cursor: pointer;
  transition: transform .08s;
}
.dpad-btn:active {
  background: linear-gradient(145deg, rgba(255,255,255,.45), rgba(255,255,255,.15));
  transform: scale(.88);
  box-shadow: 0 1px 4px rgba(0,0,0,.5), inset 0 1px 0 rgba(255,255,255,.3);
}
/* 暂停键与方向键样式完全一致，仅字号加粗 + 细边框区分；用 II 代替 ⏸ 符号（WebView 渲染兼容） */
#btn-pause {
  font-size: 4.5vmin;
  font-weight: bold;
  border-color: rgba(255,255,255,.6);
}
</style>
<script>
document.getElementById('btn-up').addEventListener('touchstart',    e=>{e.preventDefault();changeDir(0,-1);},{passive:false});
document.getElementById('btn-down').addEventListener('touchstart',   e=>{e.preventDefault();changeDir(0, 1);},{passive:false});
document.getElementById('btn-left').addEventListener('touchstart',   e=>{e.preventDefault();changeDir(-1,0);},{passive:false});
document.getElementById('btn-right').addEventListener('touchstart',  e=>{e.preventDefault();changeDir( 1,0);},{passive:false});
document.getElementById('btn-pause').addEventListener('touchstart',  e=>{e.preventDefault();togglePause();},{passive:false});
// 桌面调试保留键盘
document.addEventListener('keydown', e=>{
  if(e.key==='ArrowUp')    changeDir(0,-1);
  if(e.key==='ArrowDown')  changeDir(0, 1);
  if(e.key==='ArrowLeft')  changeDir(-1,0);
  if(e.key==='ArrowRight') changeDir( 1,0);
  if(e.key===' ')          togglePause();
});
</script>

• changeDir(dx, dy) 和 togglePause() 替换为游戏实际函数名；坐标映射类游戏中方向键可改为触发"持续向该方向移动"逻辑
• 按钮尺寸用 vmin 单位，960px 小屏到 2560px 大屏均可用
• 暂停键必须在中心格，禁止移到键盘外部单独放置

游戏角色视觉规范（卡通可爱风格，禁止只画纯色圆点/方块）：

• 贪吃蛇：蛇头用圆角矩形 + 两个白色眼睛（小圆 + 黑色瞳孔）+ 根据朝向旋转；蛇身用渐变色圆角矩形，节节之间颜色略有变化；食物用苹果/草莓等图形（红色圆 + 绿色小叶子）

• 贪吃蛇蛇头绘制示例（Canvas 2D）： js

  function drawHead(ctx, x, y, w, h, dir) {
    ctx.save();
    ctx.translate(x + w/2, y + h/2);
    const angle = {right:0, down:Math.PI/2, left:Math.PI, up:-Math.PI/2}[dir] || 0;
    ctx.rotate(angle);
    // 头部圆角矩形
    ctx.fillStyle = '#2ecc71';
    roundRect(ctx, -w/2, -h/2, w, h, w*0.3);
    ctx.fill();
    // 眼睛
    [[-w*0.15, -h*0.15],[w*0.15, -h*0.15]].forEach(([ex,ey])=>{
      ctx.fillStyle='#fff'; ctx.beginPath(); ctx.arc(ex,ey,w*0.12,0,Math.PI*2); ctx.fill();
      ctx.fillStyle='#222'; ctx.beginPath(); ctx.arc(ex+w*0.03,ey,w*0.06,0,Math.PI*2); ctx.fill();
    });
    ctx.restore();
  }
  function roundRect(ctx,x,y,w,h,r){
    ctx.beginPath();ctx.moveTo(x+r,y);ctx.lineTo(x+w-r,y);ctx.arcTo(x+w,y,x+w,y+r,r);
    ctx.lineTo(x+w,y+h-r);ctx.arcTo(x+w,y+h,x+w-r,y+h,r);ctx.lineTo(x+r,y+h);
    ctx.arcTo(x,y+h,x,y+h-r,r);ctx.lineTo(x,y+r);ctx.arcTo(x,y,x+r,y,r);ctx.closePath();
  }
  
  

• 俄罗斯方块：方块用渐变色 + 高光边框，不同形状用不同颜色

• 飞机大战：飞机用多边形或 SVG path 绘制，子弹用细长椭圆，敌机颜色与玩家区分； 子弹必须自动连续发射，禁止要求玩家手动点击射击；操作说明写「触摸屏幕移动飞机，子弹自动发射」

• 通用原则：所有游戏角色必须有辨识度，能看出是什么，不能只是纯色几何形状

平台跳跃 / 跑酷类游戏触摸控制规范（马里奥、跑酷等左右移动+跳跃类游戏必须遵守）：

核心设计：左右半屏控制方向，上滑触发跳跃，斜滑（如右上方）同时触发移动+跳跃，完全模拟实体手柄的拇指操作。

js

let tSX = 0, tSY = 0; // 触摸起点，每次 touchstart 或跳跃触发后重置

canvas.addEventListener('touchstart', e => {
  e.preventDefault();
  const t = e.touches[0];
  tSX = t.clientX; tSY = t.clientY;
}, {passive: false});

canvas.addEventListener('touchmove', e => {
  e.preventDefault();
  const t = e.touches[0];
  const dx = t.clientX - tSX;
  const dy = t.clientY - tSY; // 负值 = 向上

  // 左右移动：根据手指当前位置在画布左/右半区判断方向
  const rect = canvas.getBoundingClientRect();
  if (t.clientX < rect.left + rect.width / 2) {
    moveLeft();
  } else {
    moveRight();
  }

  // 上滑检测跳跃：阈值 20px，触发后立即重置 tSY 防止重复触发
  if (dy < -20) {
    jump();
    tSY = t.clientY; // 重置参考点，允许同一次触摸连续触发（斜滑等）
  }
}, {passive: false});

canvas.addEventListener('touchend', e => {
  stopMove(); // 手指抬起停止移动
}, {passive: false});

• dy < -20（负值向上）触发跳跃，同一次 touchmove 序列可多次触发（重置 tSY）
• 斜向上滑（如右上方）会同时执行 moveRight() + jump()，天然支持斜跳
• 阈值 20px 优于 28px，更灵敏，适合快节奏横板游戏
• 右栏方向键：◀▶ 控制移动，▲ 触发跳跃，▼ 可用于下蹲/快速下落
• 触摸坐标映射为主控，方向键为辅助——两套控制并行，不互斥
• 防止页面滚动干扰游戏：游戏容器加 touch-action:none，Canvas 加 { passive: false } 并 e.preventDefault()
• 游戏暂停/重启按钮触摸区域 ≥ 44×44px
• 禁止在游戏主循环中使用 alert()，改用页面内自定义弹窗显示胜负信息

跳跃 / 平台类游戏角色定位规范（跳一跳、跑酷、马里奥等必须遵守）：

⚠️ 已知 Bug 根因：用 ph = PLAYER_H / squish 作为绘制高度来定位头部/身体，当落地弹跳动画触发 squish ≠ 1 时， ph 变大，角色视觉上"沉入"平台下方。

正确做法： py 始终表示角色 脚底 的 y 坐标（即站在平台顶面）， squish 只影响 宽度（身体变宽/变窄），绝不影响高度定位： js

// py = 脚底 y（始终贴平台顶面，不受 squish 影响）
// squish: 落地压缩系数，1=正常，>1=横向压扁（宽变大、高不变）
function drawPlayer(ctx, px, py, squish) {
  const W = PLAYER_W * squish;   // 宽度随 squish 变化
  const H = PLAYER_H;            // 高度固定，不除以 squish
  const x = px - W / 2;
  const y = py - H;              // 脚底 py 往上量固定 PLAYER_H
  // 绘制身体：rr(ctx, x, y, W, H, radius)
}

• squish 动画只修改 W（或同时等比缩小 H 但必须同步上移 y = py - H），确保脚底始终在 py
• 禁止写 y = py - PLAYER_H / squish，这会在 squish > 1 时让角色上移，squish < 1 时下沉

⚠️ 强制要求：所有游戏类应用必须内置难度阶段机制， 默认从简单难度开始，通过 10 关后自动升级为中等难度，通过 20 关后升级为困难。以飞机大战为参照基准，其他游戏按比例换算。

难度分级标准（以飞机大战为基准示例）： 阶段关卡范围敌机坠落速度子弹发射间隔过关目标分每关目标分增量简单（Easy）第 110 关基础速度 × 1/2300ms/发100 分+10 分/关中等（Medium）第 1120 关基础速度 × 80%200ms/发200 分+10 分/关困难（Hard）第 21 关起基础速度100ms/发300 分+10 分/关

• 难度参数必须用变量控制，根据关卡号计算，禁止魔法数字硬编码： js

  let level = 1; // 每通关 +1
  
  function getDifficulty(level) {
    if (level <= 10) return {
      speedMul: 1/2,  bulletInterval: 300,
      targetScore: 100 + (level - 1) * 10   // 100, 110, 120...
    };
    if (level <= 20) return {
      speedMul: 0.8,  bulletInterval: 200,
      targetScore: 200 + (level - 11) * 10  // 200, 210, 220...
    };
    return {
      speedMul: 1,  bulletInterval: 100,
      targetScore: 300 + (level - 21) * 10  // 300, 310, 320...
    };
  }
  
  

• 不设硬性关卡上限，进入困难阶段后目标分持续增加，让玩家可以持续挑战

• 关卡信息（当前关卡、当前难度名称、得分 / 目标分、生命）必须在右栏顶部实时显示

文档/Word/PDF 风格：

• 容器使用响应式宽度： max-width: min(1200px, 92vw); margin: 3vh auto; padding: 4vh 5vw
• 在 960px 小屏上内容几乎满宽，在 1920px+ 大屏上居中且不超过 1200px
• 正文字号 clamp(14px, 1.8vw, 18px)，标题 clamp(20px, 3vw, 32px)
• 清晰的标题/段落/列表排版，使用衬线或无衬线字体
• 页面顶部可显示文档标题和日期

PPT/演示文稿风格：

• 引入 reveal.js： <link rel="stylesheet" href="https://unpkg.com/reveal.js@5/dist/reveal.css">
• 引入主题： <link rel="stylesheet" href="https://unpkg.com/reveal.js@5/dist/theme/white.css">
• 引入 JS： <script src="https://unpkg.com/reveal.js@5/dist/reveal.js"></script>
• 内容用 <div class="reveal"><div class="slides"><section>...</section></div></div> 包裹
• 每个 <section> 是一页幻灯片
• 初始化： <script>Reveal.initialize({hash:true, touch:true, width:960, height:600});</script> reveal.js 内部会等比缩放到实际视口，960×600 基准保证所有设备文字清晰不溢出
• 5~15 页为宜

Excel/表格风格：

• 容器 width:100vw; height:100vh; overflow:auto; box-sizing:border-box; padding:2vh 3vw
• HTML <table> 宽度 100%，带 border 和交替行色
• 表头字号 clamp(12px, 1.6vw, 16px)，单元格字号 clamp(12px, 1.4vw, 15px)
• 表头点击可排序（内联 JS 实现）
• 单元格 contenteditable="true" 可编辑

所有类型通用禁止项：

• 禁止出现"导出"、"打印"、"保存"功能按钮
• 禁止 @media print 相关样式
• 禁止 window.print()、文件下载等功能

1. 图标生成（icon_base64）：

   • 产出一个 256×256 的 SVG 图标
   • 风格：圆角矩形纯色背景 + 居中的主题图形（用 SVG path/circle/rect 绘制， 禁止使用 <text> 或 emoji）
   • 背景用饱和度高的纯色，中间图形用与背景对比强烈的颜色（可用白色、也可用多色彩搭配，参考 App Store 图标风格）
   • SVG 文本做 base64 编码后传入 icon_base64（不带 data:image/svg+xml;base64, 前缀）
   • SVG 原文不超过 3KB， 禁止使用 <text> 元素或 emoji

2. 【必须执行】HTML 自检 — 提交前逐项检查： 生成 html_content 后， 必须 在脑内逐项检查以下条件，任一不通过则必须修改代码后再提交：

   自检项 A — 禁止 AI/电脑对手（仅游戏/棋类/对战类需检查）：

   • 代码中是否存在任何"电脑走棋/出牌/移动"的函数？（如 computerMove, aiMove, makeAIMove, botPlay, autoPlay, cpuTurn）→ 若有， 删除整个函数及其调用
   • 代码中是否存在 minimax, alphaBeta, evaluate, bestMove, getRandomMove, Math.random() 用于选择落子位置？→ 若有， 删除
   • 代码中是否存在"难度选择"（easy/medium/hard）或"人机/人人"模式切换？→ 若有， 删除，只保留双人模式
   • 游戏流程是否为：玩家A操作 → 切换到玩家B → 玩家B操作 → 切换回玩家A → 循环？→ 必须是
   • 是否有任何 setTimeout/ setInterval 用于延迟执行电脑的操作？→ 若有， 删除

自检项 B — 禁止导出/打印/保存（所有类型需检查）：

• 是否存在"导出"、"打印"、"保存"、"下载"按钮或菜单项？→ 若有， 删除
• 是否存在 window.print(), document.execCommand('SaveAs'), URL.createObjectURL, download 属性？→ 若有， 删除

自检项 C — Android 8.1 WebView 兼容（所有类型需检查）：

• 是否使用了 Chrome 86+ 才支持的 CSS/JS API（ @property、 content-visibility、 structuredClone、 ??=/ ||=/ &&= 赋值运算符）？→ 若有， 替换为兼容写法
• 是否使用了 ctx.roundRect()？→ Chrome 99+， 必须替换为自定义 rr() helper（用 arcTo 实现）
• Canvas 内是否使用了 emoji 字符（fillText 中含 🔥❤️ 等）？→ WebView 字体渲染异常， 必须替换为纯文字或几何图形
• 游戏布局是否为横版左右两栏（左栏游戏区、右栏控制区）？→ 若是竖版堆叠，必须改为横版
• 右栏有 #game-preview（下一块/预览区）时，是否已去掉 #leaderboard 和 #instructions？→ 预览区与排行/说明互斥，有预览时不展示排行和说明。无预览区的游戏中，排行/说明用 flex:1 1 0;min-height:0 + h3 固定 + .sb-inner 内滚动。 #controls 始终 flex:0 0 auto 固定底部
• Canvas CSS 是否用 position:absolute;top:0;left:0;width:100%;height:100% 撑满左栏，而非依赖 flex 布局？→ 若只用 width:100%;height:100% 而无 position:absolute，必须修正
• Canvas 尺寸初始化是否在 window.load + 双层 requestAnimationFrame 内执行，且用 offsetWidth 做兜底（防止 Android 8.1 WebView 初始 clientWidth 为 0）？→ 若直接在顶层读 clientWidth，必须改为延迟初始化模板
• 需要方向控制的游戏：是否在 Canvas 上绑定了 touchstart/ touchmove 做坐标直接映射（主控），且右下角仍保留方向键 + 暂停按钮（辅助）？→ 若只有方向按钮而无触摸坐标映射，必须补充
• 飞机大战类游戏：子弹是否自动连续发射（ setInterval 或主循环计时），而非要求玩家手动点击射击？→ 若需要手动触发，必须改为自动发射
• 俄罗斯方块/消除类游戏：①初始下落间隔是否为800ms（经典NES速度）？②贴地后是否立刻lock+spawn（零等待，无LOCK_DELAY缓冲）？③ spawnPiece() 是否将新方块赋值给全局变量（ cur=shape）？→ 若不符合，按专项规则修正
• 游戏内的开始/结束/暂停遮罩层是否用 position:absolute;top:0;left:0;right:0;bottom:0;display:flex;align-items:center;justify-content:center 居中（ 禁止用 inset:0，Chrome 85 不支持）？→ 若用 inset:0 或固定像素定位，内容会在智能屏上贴左上角，必须修正
• 游戏是否实现了三段式难度（简单110关：速度×1/2、300ms/发、100+10×n分 → 中等1120关：速度×80%、200ms/发、200+10×n分 → 困难21关起：基础速度、100ms/发、300+10×n分），且第1关使用简单参数？→ 若全程同一难度或开局就很快，必须按难度分级模板修正
• 游戏角色是否有视觉辨识度（蛇头有眼睛、食物有形状等），而不是纯色圆点/方块？→ 若只是纯色几何形，必须改为卡通风格
• 是否使用了原生 alert()/ confirm()/ prompt()？→ 若有， 改为页面内自定义弹窗
• 游戏容器/Canvas 是否加了 touch-action:none 并在 touch 事件中调用 e.preventDefault()？→ 若未处理， 补充
• 可点击/可触摸元素的触摸区域是否 ≥ 44×44px？→ 若不足， 调整尺寸
• 跳跃/平台类游戏（跳一跳、跑酷等）：绘制角色时是否用固定常量 PLAYER_H 定位脚底坐标（ py 为脚底 y，头顶为 py - PLAYER_H），而非用 PLAYER_H / squish 等变形高度定位？→ squish（落地压缩动画）只能影响角色宽度/变窄，绝不能影响脚底 py 的计算，否则 squish≠1 时角色视觉上会"沉入"平台下方

⚠️ 如果自检发现违规代码， 不要提交，先修正 html_content 再继续下一步。

5.5. 【必须执行】JS 语法验证（应用类/游戏类必须，文件类可选）： 在调用 myapp_register 之前，用 exec 工具对 html_content 中的 <script> 代码块做语法验证，确保不因语法错误导致游戏在智能屏上完全空白：

bash

# 提取 <script> 内容写临时文件，用 node --check 验证
node -e "
const fs = require('fs');
const html = fs.readFileSync('/tmp/_skill_check.html','utf8');
const scripts = html.match(/<script[\s\S]*?>([\s\S]*?)<\/script>/gi) || [];
scripts.forEach((s,i) => {
  const code = s.replace(/<\/?script[^>]*>/gi,'');
  fs.writeFileSync('/tmp/_check_'+i+'.js', code);
});
" && node --check /tmp/_check_*.js 2>&1

• 实际操作：将 html_content 写入 /tmp/_skill_check.html，运行上面命令
• 如果 node --check 输出任何错误，必须修复对应 JS 代码后重新验证，直到无错误
• 验证通过后再调用 myapp_register

1. 调用 myapp_register 工具：
   • 入参： dumi_id, cuid, query, app_name, html_content, features, icon_base64, tag
   • tag：根据第 1 步判断的类型填写—— 应用类（交互式）填 "app"，文件类（文档/PPT/表格）填 "doc"；不传时服务端默认 "app"
   • dumi_id 与 cuid 从对话上下文中获取（OpenClaw 会注入）
2. 工具返回成功后，向用户展示：
   • 告知创建完成："《<app_name>》已创建完成。"
   • 展示功能/玩法（根据类型区分）：

     • 应用类：

       • 列出"游戏特性"或"功能特性"：从 features 中提取 3~6 条核心点
       • 列出"操作方式"：说明触屏/键盘的操作方法（如方向键控制、暂停等）

     • 文件类（文档/PPT/表格）：

       • 简要概括文档核心内容（如关键数据、主要结论、章节概要等，3~5 条）
       • 提示"点击链接即可查看完整内容"
   • 展示文件位置：给出返回的 html_url 链接
   • 提示用户："下次可以在「我的创作」页面查看和管理你创建的所有应用"
3. 失败/超长/超出能力 → 回复"应用创建失败，请稍后重试"
   • 不要重试， 不要伪造成功， 不要把 html_content 输出到对话

更新流程#

最长等待 300s。若 300s 内不能完成旧功能读取、HTML 重新生成与 myapp_update 调用，直接回复"应用更新失败，请稍后重试"。

1. 先调 myapp_get(app_id) 拿到 app_name 与旧 features、旧 query
2. 把"旧 features + 用户新需求"作为完整上下文，重新生成：
   • 新 features（合并增删，仍是 1~12 条全集，不是 diff）
   • 新 html_content（保持原有类型风格）
   • 若应用主题/类型发生变化，重新生成 icon_base64（同创建流程第 4 步）
3. 调用 myapp_update(app_id, query, html_content, features, icon_base64, tag)
   • tag 同创建流程：应用类填 "app"，文件类填 "doc"
4. 工具返回成功后，向用户展示：
   • 告知更新完成："《<app_name>》已更新完成。"
   • 展示更新内容（根据类型区分）：
     • 应用类：列出本次新增/变更的功能点和操作方式变化
     • 文件类：简要概括更新后的核心内容或变更要点
   • 展示文件位置：给出返回的 html_url 链接
   • 提示用户："下次可以在「我的创作」页面查看和管理你创建的所有应用"
5. 失败 → 回复"应用更新失败，请稍后重试"

安装自检（[install_check:session=]）#

最长等待 300s。超过 300s 未完成安装或 myapp_ping，视为安装失败。

仅调用 myapp_ping(session_id="<sid>", dumi_id, cuid, skill_version="1.0.10")， 不输出对话内容（或仅极简的"已就绪"）。

硬约束#

• 绝对禁止在游戏中实现 AI 对手、人机对战、电脑自动操作——棋类/对战类游戏只允许双人同屏轮流操作
• 禁止出现的代码模式： computerMove, aiMove, makeAIMove, minimax, alphaBeta, bestMove, getRandomMove, 难度选择(easy/medium/hard), 人机/人人模式切换
• 绝对禁止出现"导出"、"打印"、"保存"按钮或相关功能
• 需要方向控制的游戏必须在页面上渲染四个方向触摸按钮（↑↓←→），绑定 touchstart 事件——不得以键盘或滑动手势代替
• 不要把 html_content 原文输出到对话
• 不要把 MYAPP_API_TOKEN / MYAPP_API_BASE 输出到对话
• 工具调用 4xx/5xx → 直接失败兜底，不重试，不修改请求自行重试
• 除安装、创建、更新外，其它工具交互超过 180s 视为失败