npm - kcode-pi - Versions diffs - 0.1.0 - Mend

kcode-pi 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (219) hide show

package/vendor/kingdee-skills/ok-cosmic/ok-cosmic-intro.html ADDED Viewed

@@ -0,0 +1,903 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>ok-cosmic v1.3.0 — 金蝶云苍穹 AI 开发技能</title>
+<style>
+  :root {
+    --primary: #2563eb;
+    --primary-dark: #1d4ed8;
+    --accent: #f59e0b;
+    --bg: #0f172a;
+    --bg-card: #1e293b;
+    --bg-light: #334155;
+    --text: #e2e8f0;
+    --text-muted: #94a3b8;
+    --success: #22c55e;
+    --error: #ef4444;
+    --warning: #f59e0b;
+    --info: #3b82f6;
+    --gradient: linear-gradient(135deg, #2563eb 0%, #7c3aed 100%);
+  }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Microsoft YaHei', sans-serif; background: var(--bg); color: var(--text); overflow: hidden; height: 100vh; }
+  /* Slide container */
+  .deck { position: relative; width: 100vw; height: 100vh; }
+  .slide { position: absolute; inset: 0; display: flex; flex-direction: column; justify-content: center; align-items: center; padding: 60px 80px; opacity: 0; transform: translateX(60px); transition: all 0.5s cubic-bezier(.4,0,.2,1); pointer-events: none; overflow-y: auto; }
+  .slide.active { opacity: 1; transform: translateX(0); pointer-events: auto; }
+  .slide.prev { opacity: 0; transform: translateX(-60px); }
+  /* Navigation */
+  .nav { position: fixed; bottom: 30px; left: 50%; transform: translateX(-50%); display: flex; gap: 12px; z-index: 100; }
+  .nav button { background: var(--bg-light); border: none; color: var(--text); width: 44px; height: 44px; border-radius: 50%; cursor: pointer; font-size: 18px; transition: all .2s; display: flex; align-items: center; justify-content: center; }
+  .nav button:hover { background: var(--primary); }
+  .progress { position: fixed; top: 0; left: 0; height: 3px; background: var(--gradient); transition: width .4s; z-index: 100; }
+  .page-num { position: fixed; bottom: 36px; right: 40px; color: var(--text-muted); font-size: 14px; z-index: 100; font-variant-numeric: tabular-nums; }
+  /* Typography */
+  h1 { font-size: 3em; font-weight: 800; line-height: 1.2; margin-bottom: 16px; }
+  h2 { font-size: 2.2em; font-weight: 700; margin-bottom: 24px; color: #fff; }
+  h3 { font-size: 1.3em; font-weight: 600; margin-bottom: 12px; color: var(--accent); }
+  p, li { font-size: 1.1em; line-height: 1.7; color: var(--text); }
+  .subtitle { font-size: 1.35em; color: var(--text-muted); margin-bottom: 32px; }
+  .tag { display: inline-block; padding: 4px 14px; border-radius: 20px; font-size: .85em; font-weight: 600; margin: 3px; }
+  .tag-blue { background: rgba(37,99,235,.2); color: #60a5fa; border: 1px solid rgba(37,99,235,.3); }
+  .tag-purple { background: rgba(124,58,237,.2); color: #a78bfa; border: 1px solid rgba(124,58,237,.3); }
+  .tag-green { background: rgba(34,197,94,.2); color: #4ade80; border: 1px solid rgba(34,197,94,.3); }
+  .tag-amber { background: rgba(245,158,11,.2); color: #fbbf24; border: 1px solid rgba(245,158,11,.3); }
+  .tag-red { background: rgba(239,68,68,.2); color: #f87171; border: 1px solid rgba(239,68,68,.3); }
+  /* Layout helpers */
+  .grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 28px; width: 100%; max-width: 1200px; }
+  .grid-3 { display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 20px; width: 100%; max-width: 1200px; }
+  .grid-4 { display: grid; grid-template-columns: repeat(4, 1fr); gap: 16px; width: 100%; max-width: 1200px; }
+  .card { background: var(--bg-card); border-radius: 16px; padding: 28px; border: 1px solid rgba(255,255,255,.06); transition: transform .2s; }
+  .card:hover { transform: translateY(-2px); }
+  .card-sm { background: var(--bg-card); border-radius: 12px; padding: 18px; border: 1px solid rgba(255,255,255,.06); }
+  .center { text-align: center; }
+  .left { text-align: left; align-items: flex-start; }
+  .w-full { width: 100%; max-width: 1200px; }
+  .stat { font-size: 3em; font-weight: 800; background: var(--gradient); -webkit-background-clip: text; -webkit-text-fill-color: transparent; line-height: 1.1; }
+  .stat-label { font-size: .95em; color: var(--text-muted); margin-top: 6px; }
+  .code-block { background: #0d1117; border-radius: 10px; padding: 20px 24px; font-family: 'JetBrains Mono', 'Fira Code', 'SF Mono', monospace; font-size: .9em; line-height: 1.7; color: #c9d1d9; overflow-x: auto; text-align: left; border: 1px solid rgba(255,255,255,.06); }
+  .code-block .kw { color: #ff7b72; }
+  .code-block .str { color: #a5d6ff; }
+  .code-block .cm { color: #8b949e; }
+  .code-block .fn { color: #d2a8ff; }
+  .flow-line { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; justify-content: center; margin: 20px 0; }
+  .flow-box { background: var(--bg-card); border: 1px solid rgba(37,99,235,.4); border-radius: 10px; padding: 12px 20px; font-weight: 600; font-size: .95em; white-space: nowrap; }
+  .flow-arrow { color: var(--primary); font-size: 1.4em; }
+  table { width: 100%; border-collapse: collapse; font-size: .95em; }
+  th { background: var(--bg-light); padding: 12px 16px; text-align: left; font-weight: 600; color: #fff; }
+  td { padding: 10px 16px; border-bottom: 1px solid rgba(255,255,255,.06); }
+  tr:hover td { background: rgba(37,99,235,.05); }
+  .layer-a { border-left: 4px solid var(--error); }
+  .layer-b { border-left: 4px solid var(--warning); }
+  .layer-c { border-left: 4px solid var(--info); }
+  .emoji { font-size: 2em; margin-bottom: 12px; display: block; }
+  .badge { display: inline-block; padding: 2px 10px; border-radius: 6px; font-size: .8em; font-weight: 700; }
+  .badge-err { background: rgba(239,68,68,.2); color: #f87171; }
+  .badge-warn { background: rgba(245,158,11,.2); color: #fbbf24; }
+  .badge-info { background: rgba(59,130,246,.2); color: #60a5fa; }
+  .hero-logo { font-size: 5em; margin-bottom: 20px; }
+  .version { display: inline-block; background: var(--gradient); padding: 6px 18px; border-radius: 20px; font-size: .95em; font-weight: 700; color: #fff; margin-bottom: 20px; }
+  ul { list-style: none; padding: 0; }
+  ul li { padding: 6px 0; padding-left: 24px; position: relative; }
+  ul li::before { content: "▸"; position: absolute; left: 0; color: var(--primary); font-weight: bold; }
+  /* Retrieval chain (Extension Repos slide) */
+  .retrieval-chain { display: flex; align-items: stretch; justify-content: center; gap: 8px; width: 100%; max-width: 1200px; margin: 0 auto; }
+  .chain-node { flex: 1; background: var(--bg-card); border-radius: 14px; padding: 18px 14px 16px; text-align: center; position: relative; border: 1px solid rgba(255,255,255,.08); transition: transform .2s; }
+  .chain-node:hover { transform: translateY(-4px); }
+  .chain-node .node-num { position: absolute; top: -10px; left: 50%; transform: translateX(-50%); width: 26px; height: 26px; border-radius: 50%; font-size: .78em; font-weight: 800; display: flex; align-items: center; justify-content: center; color: #fff; box-shadow: 0 2px 8px rgba(0,0,0,.3); }
+  .chain-node .node-icon { font-size: 1.8em; margin: 6px 0 4px; line-height: 1; }
+  .chain-node .node-title { font-size: .95em; font-weight: 700; color: #fff; font-family: 'JetBrains Mono', 'Fira Code', monospace; letter-spacing: -.02em; }
+  .chain-node .node-desc { font-size: .75em; color: var(--text-muted); margin-top: 4px; }
+  .chain-node.n-blue { border-top: 3px solid #60a5fa; } .chain-node.n-blue .node-num { background: #2563eb; }
+  .chain-node.n-purple { border-top: 3px solid #a78bfa; } .chain-node.n-purple .node-num { background: #7c3aed; }
+  .chain-node.n-green { border-top: 3px solid #4ade80; } .chain-node.n-green .node-num { background: #16a34a; }
+  .chain-node.n-amber { border-top: 3px solid #fbbf24; box-shadow: 0 0 0 1px rgba(245,158,11,.4), 0 8px 32px -8px rgba(245,158,11,.4); background: linear-gradient(180deg, rgba(245,158,11,.08) 0%, var(--bg-card) 100%); }
+  .chain-node.n-amber .node-num { background: var(--accent); }
+  .chain-node.n-amber .node-title { color: #fbbf24; }
+  .chain-arrow-wrap { display: flex; flex-direction: column; align-items: center; justify-content: center; min-width: 52px; padding-top: 28px; }
+  .chain-arrow-wrap .arrow-label { font-size: .7em; color: var(--error); font-weight: 700; letter-spacing: .05em; text-transform: uppercase; margin-bottom: 2px; }
+  .chain-arrow-wrap .arrow-icon { color: var(--text-muted); font-size: 1.6em; line-height: 1; }
+  /* Venn diagram (trigger conditions) */
+  .venn-wrap { display: flex; align-items: center; justify-content: center; position: relative; height: 160px; }
+  .venn-circle { position: absolute; width: 140px; height: 140px; border-radius: 50%; display: flex; align-items: center; justify-content: center; text-align: center; font-size: .82em; font-weight: 600; line-height: 1.35; padding: 0 12px; }
+  .venn-left { left: 40px; background: rgba(96,165,250,.22); border: 2px solid rgba(96,165,250,.6); color: #bfdbfe; padding-right: 50px; }
+  .venn-right { right: 40px; background: rgba(167,139,250,.22); border: 2px solid rgba(167,139,250,.6); color: #ddd6fe; padding-left: 50px; }
+  .venn-center { position: absolute; left: 50%; top: 50%; transform: translate(-50%, -50%); z-index: 3; width: 72px; height: 72px; border-radius: 50%; background: var(--accent); display: flex; align-items: center; justify-content: center; color: #1a1a1a; font-weight: 800; font-size: .85em; box-shadow: 0 0 24px rgba(245,158,11,.6); border: 3px solid #0f172a; text-align: center; line-height: 1.1; }
+  /* Principle badge pills */
+  .principle-row { display: grid; grid-template-columns: repeat(3, 1fr); gap: 14px; width: 100%; }
+  .principle-badge { background: var(--bg-card); border-radius: 14px; padding: 16px 18px; display: flex; align-items: center; gap: 14px; border: 1px solid rgba(255,255,255,.06); }
+  .principle-badge .pb-icon { flex: 0 0 42px; width: 42px; height: 42px; border-radius: 10px; display: flex; align-items: center; justify-content: center; font-size: 1.3em; font-weight: 800; }
+  .principle-badge .pb-text strong { display: block; font-size: .95em; color: #fff; margin-bottom: 2px; }
+  .principle-badge .pb-text span { font-size: .8em; color: var(--text-muted); line-height: 1.4; }
+  .principle-badge.p-amber .pb-icon { background: rgba(245,158,11,.2); color: #fbbf24; }
+  .principle-badge.p-red .pb-icon { background: rgba(239,68,68,.2); color: #f87171; }
+  .principle-badge.p-blue .pb-icon { background: rgba(37,99,235,.2); color: #60a5fa; }
+  @media (max-width: 900px) {
+    .slide { padding: 30px 24px; }
+    h1 { font-size: 2em; }
+    h2 { font-size: 1.6em; }
+    .grid-2, .grid-3, .grid-4 { grid-template-columns: 1fr; }
+    .stat { font-size: 2em; }
+  }
+</style>
+</head>
+<body>
+<div class="progress" id="progress"></div>
+<div class="page-num" id="pageNum"></div>
+<div class="deck" id="deck">
+<!-- ============ SLIDE 1: Title ============ -->
+<div class="slide active center">
+  <div class="hero-logo">🚀</div>
+  <div class="version">v1.3.0</div>
+  <h1 style="background:var(--gradient);-webkit-background-clip:text;-webkit-text-fill-color:transparent;">ok-cosmic</h1>
+  <p class="subtitle">金蝶云苍穹 AI 开发技能 — 完整介绍</p>
+  <div style="margin-top:24px; display:flex; gap:10px; flex-wrap:wrap; justify-content:center;">
+    <span class="tag tag-blue">封装优先</span>
+    <span class="tag tag-purple">幻觉防护</span>
+    <span class="tag tag-green">自动校验</span>
+    <span class="tag tag-amber">离线知识库</span>
+  </div>
+  <p style="margin-top:48px; color:var(--text-muted); font-size:.9em;">作者：陈泽贤、钱芮名 &nbsp;|&nbsp; 仅限内部使用</p>
+</div>
+<!-- ============ SLIDE 2: What is ok-cosmic ============ -->
+<div class="slide center">
+  <h2>什么是 ok-cosmic？</h2>
+  <p class="subtitle" style="max-width:800px;">面向金蝶云苍穹二开场景的 AI Agent Skill，让 AI 真正理解苍穹 SDK</p>
+  <div class="grid-4" style="margin-top:20px;">
+    <div class="card center">
+      <div class="stat">15</div>
+      <div class="stat-label">插件模板</div>
+    </div>
+    <div class="card center">
+      <div class="stat">7</div>
+      <div class="stat-label">内置工具</div>
+    </div>
+    <div class="card center">
+      <div class="stat">24</div>
+      <div class="stat-label">代码片段</div>
+    </div>
+    <div class="card center">
+      <div class="stat">19</div>
+      <div class="stat-label">A层硬规则</div>
+    </div>
+  </div>
+  <div class="grid-4" style="margin-top:16px;">
+    <div class="card center">
+      <div class="stat">12</div>
+      <div class="stat-label">规则文档</div>
+    </div>
+    <div class="card center">
+      <div class="stat">12</div>
+      <div class="stat-label">封装参考文档</div>
+    </div>
+    <div class="card center">
+      <div class="stat">6</div>
+      <div class="stat-label">Lint 检查器</div>
+    </div>
+    <div class="card center">
+      <div class="stat">40+</div>
+      <div class="stat-label">STYLE/SCENE 规则</div>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 3: Design Goals ============ -->
+<div class="slide center">
+  <h2>四大设计目标</h2>
+  <div class="grid-2" style="margin-top:12px;">
+    <div class="card">
+      <span class="emoji">🧠</span>
+      <h3>AI 理解无障碍</h3>
+      <p>所有文档、模板、规则均面向 AI 消费设计，结构化标签 + 锚点引用，让 Agent 精准定位信息</p>
+    </div>
+    <div class="card">
+      <span class="emoji">🎯</span>
+      <h3>生产级代码</h3>
+      <p>通过模板骨架 + A/B/C 三层规则 + 自动 post-check，确保 AI 生成的代码可直接进入 Code Review</p>
+    </div>
+    <div class="card">
+      <span class="emoji">⚡</span>
+      <h3>Token 效率</h3>
+      <p>决策矩阵索引 + 最小加载原则 + TL;DR 摘要机制，减少无效上下文消耗</p>
+    </div>
+    <div class="card">
+      <span class="emoji">📦</span>
+      <h3>开箱即用</h3>
+      <p>Step 0 自动预检 + 依赖自动安装 + 离线知识库，一条命令完成环境验证</p>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 4: Core Capabilities ============ -->
+<div class="slide center">
+  <h2>五大核心能力</h2>
+  <div class="w-full" style="margin-top:12px;">
+    <div class="card" style="margin-bottom:16px; display:flex; gap:20px; align-items:flex-start;">
+      <div style="font-size:2em; min-width:44px;">🧩</div>
+      <div><h3 style="margin-bottom:4px;">插件选型与模板骨架</h3><p>14 种插件类型 + 11 种能力类型全覆盖，决策矩阵 + 意图路由自动匹配最佳方案</p></div>
+    </div>
+    <div class="card" style="margin-bottom:16px; display:flex; gap:20px; align-items:flex-start;">
+      <div style="font-size:2em; min-width:44px;">🔎</div>
+      <div><h3 style="margin-bottom:4px;">离线 API 知识查询</h3><p>基于 SQLite 知识图谱，支持类名搜索、方法搜索、继承链校验、签名验证，完全离线可用</p></div>
+    </div>
+    <div class="card" style="margin-bottom:16px; display:flex; gap:20px; align-items:flex-start;">
+      <div style="font-size:2em; min-width:44px;">🗂️</div>
+      <div><h3 style="margin-bottom:4px;">元数据 / 基础资料在线查询</h3><p>通过 OpenAPI 实时查询字段标识、枚举映射、refType、基础资料编码名称，支持本地缓存</p></div>
+    </div>
+    <div class="card" style="margin-bottom:16px; display:flex; gap:20px; align-items:flex-start;">
+      <div style="font-size:2em; min-width:44px;">🛡️</div>
+      <div><h3 style="margin-bottom:4px;">幻觉防护与规则约束</h3><p>11 个幻觉方法名 + 6 个幻觉类名黑名单 + 12 个场景错配规则 + 24 个编码风格规则，自动 lint 检测</p></div>
+    </div>
+    <div class="card" style="display:flex; gap:20px; align-items:flex-start;">
+      <div style="font-size:2em; min-width:44px;">✅</div>
+      <div><h3 style="margin-bottom:4px;">代码生成后自动校验</h3><p>Gradle 编译 + post-lint 串联，6 大检查器并行扫描，ERROR 阻断 → 自动修复 → 复检闭环</p></div>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 5: Architecture ============ -->
+<div class="slide left">
+  <h2 style="text-align:center;">技能架构总览</h2>
+  <div class="grid-2 w-full" style="margin-top:12px;">
+    <div>
+      <div class="code-block" style="font-size:.82em; line-height:1.6;">
+<span class="cm">ok-cosmic/</span>
+├── <span class="fn">SKILL.md</span>          <span class="cm"># AI 主入口（线性执行流）</span>
+├── <span class="fn">manifest.json</span>     <span class="cm"># 工具注册（7 tools）</span>
+├── <span class="str">assets/</span>           <span class="cm"># 15 个插件模板</span>
+│   └── <span class="str">snippets/</span>     <span class="cm"># 24 个场景代码片段</span>
+├── <span class="str">rules/</span>            <span class="cm"># 12 个规则文档</span>
+│   ├── constraints.md      <span class="cm"># A层硬约束</span>
+│   ├── anti-patterns.md    <span class="cm"># 禁忌清单</span>
+│   ├── coding-preferences.md <span class="cm"># B/C层偏好</span>
+│   ├── decision-matrix.md  <span class="cm"># 决策矩阵</span>
+│   ├── intent-routing.md   <span class="cm"># 意图路由</span>
+│   ├── cheat-sheet.md      <span class="cm"># 高频API速查</span>
+│   ├── post-check.md       <span class="cm"># 校验规则</span>
+│   └── a-layer-rules.json  <span class="cm"># 规则ID配置</span>
+├── <span class="str">scripts/</span>          <span class="cm"># 7 个 Python 工具脚本</span>
+│   └── <span class="str">lint/</span>         <span class="cm"># 6 个静态检查器</span>
+└── <span class="str">references/</span>       <span class="cm"># SDK 参考文档</span>
+    ├── <span class="str">adv/</span>          <span class="cm"># 12 篇封装层文档</span>
+    └── <span class="str">base/</span>         <span class="cm"># 原生SDK文档</span>
+      </div>
+    </div>
+    <div>
+      <div class="card layer-a" style="margin-bottom:12px;">
+        <h3>SKILL.md — AI 大脑</h3>
+        <p>线性执行流设计：Step 0 预检 → 意图路由 → 决策矩阵 → 确认卡 → 代码生成 → Post-Check</p>
+      </div>
+      <div class="card layer-b" style="margin-bottom:12px;">
+        <h3>rules/ — 规则引擎</h3>
+        <p>A/B/C 三层分治，文档与 lint 脚本 1:1 映射，a-layer-rules.json 作为单一可信源</p>
+      </div>
+      <div class="card" style="margin-bottom:12px; border-left: 4px solid var(--success);">
+        <h3>scripts/ — 工具链</h3>
+        <p>7 个 Python 脚本 + 6 个 lint 检查器，支持离线/在线混合查询与自动校验</p>
+      </div>
+      <div class="card" style="border-left: 4px solid var(--primary);">
+        <h3>assets/ — 模板库</h3>
+        <p>15 个骨架模板 + 24 个场景片段，覆盖苍穹全部主流二开场景</p>
+      </div>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 6: Plugin Coverage ============ -->
+<div class="slide center">
+  <h2>14 种插件类型全覆盖</h2>
+  <p class="subtitle">每种类型配套：模板骨架 + 参考文档 + 代码片段 + 决策矩阵卡片</p>
+  <div class="grid-4 w-full" style="margin-top:12px;">
+    <div class="card-sm center"><div style="font-size:1.5em;">📋</div><strong>表单插件</strong><br><small style="color:var(--text-muted)">字段联动 / 控件交互</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">📄</div><strong>单据插件</strong><br><small style="color:var(--text-muted)">审核提交 / 单据头体</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">📑</div><strong>列表插件</strong><br><small style="color:var(--text-muted)">多选操作 / 批量处理</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">🌳</div><strong>树列表插件</strong><br><small style="color:var(--text-muted)">左树右表</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">⚙️</div><strong>操作插件</strong><br><small style="color:var(--text-muted)">保存 / 审核 / 校验</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">🔄</div><strong>转换插件</strong><br><small style="color:var(--text-muted)">下推 / BOTP 转换</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">↩️</div><strong>反写插件</strong><br><small style="color:var(--text-muted)">BOTP 回写阶段</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">📊</div><strong>报表插件</strong><br><small style="color:var(--text-muted)">过滤容器 / 界面</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">📈</div><strong>报表取数</strong><br><small style="color:var(--text-muted)">动态列 / DataSet</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">🖨️</div><strong>打印插件</strong><br><small style="color:var(--text-muted)">套打模板</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">🌐</div><strong>OpenAPI</strong><br><small style="color:var(--text-muted)">外部集成接口</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">⏰</div><strong>后台任务</strong><br><small style="color:var(--text-muted)">定时调度作业</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">🔀</div><strong>工作流插件</strong><br><small style="color:var(--text-muted)">审批流节点</small></div>
+    <div class="card-sm center"><div style="font-size:1.5em;">📥</div><strong>导入插件</strong><br><small style="color:var(--text-muted)">批量导入</small></div>
+  </div>
+</div>
+<!-- ============ SLIDE 7: Tool Chain ============ -->
+<div class="slide center">
+  <h2>7 个内置工具脚本</h2>
+  <div class="w-full" style="margin-top:12px;">
+    <table>
+      <tr><th style="width:30%">工具名</th><th style="width:35%">功能</th><th>关键特性</th></tr>
+      <tr>
+        <td><strong style="color:#60a5fa">cosmic_search_classes</strong></td>
+        <td>模糊/正则搜索苍穹类名</td>
+        <td><span class="tag tag-blue" style="font-size:.75em">离线</span> 支持包前缀、kind 过滤</td>
+      </tr>
+      <tr>
+        <td><strong style="color:#60a5fa">cosmic_search_methods</strong></td>
+        <td>跨类全局搜索方法名</td>
+        <td><span class="tag tag-blue" style="font-size:.75em">离线</span> 排名 + 分类筛选</td>
+      </tr>
+      <tr>
+        <td><strong style="color:#60a5fa">cosmic_get_class_detail</strong></td>
+        <td>查看类详情 / 校验签名</td>
+        <td><span class="tag tag-blue" style="font-size:.75em">离线</span> 继承链 + compact 模式</td>
+      </tr>
+      <tr>
+        <td><strong style="color:#a78bfa">cosmic_get_meta_fields</strong></td>
+        <td>查询表单元数据字段</td>
+        <td><span class="tag tag-purple" style="font-size:.75em">在线+缓存</span> fuzzy/detail/tree 视图</td>
+      </tr>
+      <tr>
+        <td><strong style="color:#a78bfa">cosmic_query_basedata</strong></td>
+        <td>查询基础资料数据</td>
+        <td><span class="tag tag-purple" style="font-size:.75em">在线+缓存</span> 编码/名称/完整数据包</td>
+      </tr>
+      <tr>
+        <td><strong style="color:#4ade80">cosmic_post_check</strong></td>
+        <td>代码生成后统一校验</td>
+        <td><span class="tag tag-green" style="font-size:.75em">Gradle+Lint</span> 6 大检查器并行</td>
+      </tr>
+      <tr>
+        <td><strong style="color:#4ade80">cosmic_config_check</strong></td>
+        <td>Step 0 环境预检</td>
+        <td><span class="tag tag-green" style="font-size:.75em">自动安装</span> Python 依赖自动补全</td>
+      </tr>
+    </table>
+  </div>
+</div>
+<!-- ============ SLIDE 8: Decision Flow ============ -->
+<div class="slide center">
+  <h2>AI 开发决策流程</h2>
+  <p class="subtitle">从用户需求到代码交付的完整链路</p>
+  <div class="flow-line" style="margin:28px 0;">
+    <div class="flow-box" style="border-color:var(--accent);">Step 0<br>配置预检</div>
+    <div class="flow-arrow">→</div>
+    <div class="flow-box">意图路由<br><small>时机+载体+能力</small></div>
+    <div class="flow-arrow">→</div>
+    <div class="flow-box">决策矩阵<br><small>命中1主+0-1能力</small></div>
+    <div class="flow-arrow">→</div>
+    <div class="flow-box" style="border-color:var(--accent);">最小确认卡<br><small>6项全部就绪</small></div>
+  </div>
+  <div class="flow-line">
+    <div class="flow-box">读模板骨架<br><small>assets/*.java</small></div>
+    <div class="flow-arrow">→</div>
+    <div class="flow-box">验证签名<br><small>cheat-sheet/脚本</small></div>
+    <div class="flow-arrow">→</div>
+    <div class="flow-box" style="border-color:var(--success);">生成代码</div>
+    <div class="flow-arrow">→</div>
+    <div class="flow-box" style="border-color:var(--success);">Post-Check<br><small>≤3轮修复闭环</small></div>
+  </div>
+  <div class="card w-full" style="margin-top:28px; text-align:left;">
+    <h3>最小确认卡（6 项必须就绪）</h3>
+    <div class="grid-3" style="margin-top:12px;">
+      <div>① 插件类型 <small style="color:var(--text-muted)">← 决策矩阵</small></div>
+      <div>② 目标事件方法 <small style="color:var(--text-muted)">← 模板/references</small></div>
+      <div>③ 使用模板 <small style="color:var(--text-muted)">← assets/*.java</small></div>
+      <div>④ 已验证字段/refType <small style="color:var(--text-muted)">← 元数据脚本</small></div>
+      <div>⑤ 已确认枚举值 <small style="color:var(--text-muted)">← metadata Ext</small></div>
+      <div>⑥ 已验证类/方法签名 <small style="color:var(--text-muted)">← cheat-sheet/API</small></div>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 9: Rule Layers ============ -->
+<div class="slide center">
+  <h2>A / B / C 三层规则体系</h2>
+  <p class="subtitle">区分"硬红线"与"建议写法"，避免一刀切</p>
+  <div class="grid-3 w-full" style="margin-top:16px;">
+    <div class="card layer-a">
+      <h3 style="color:var(--error);">A 层 · 硬约束</h3>
+      <p style="font-size:.9em;"><span class="badge badge-err">ERROR</span> 阻断交付</p>
+      <ul style="margin-top:12px; font-size:.9em;">
+        <li>拒绝 API 幻觉</li>
+        <li>模板签名强制校验</li>
+        <li>操作插件禁调 getView()</li>
+        <li>绑定阶段禁改数据</li>
+        <li>循环禁访数据库/Redis</li>
+        <li>DataSet 必须 close</li>
+        <li>禁止 printStackTrace()</li>
+        <li>SQL 必须参数化</li>
+      </ul>
+      <p style="margin-top:12px; font-size:.85em; color:var(--text-muted);">来源：constraints.md · anti-patterns.md<br>19 个规则 ID 定义在 a-layer-rules.json</p>
+    </div>
+    <div class="card layer-b">
+      <h3 style="color:var(--warning);">B 层 · 推荐项</h3>
+      <p style="font-size:.9em;"><span class="badge badge-warn">WARNING</span> 新代码优先</p>
+      <ul style="margin-top:12px; font-size:.9em;">
+        <li>优先使用 Ext 扩展基类</li>
+        <li>优先使用 OpUtils / BotpUtils</li>
+        <li>CharSequenceUtils 判空</li>
+        <li>CollectionUtils 判空</li>
+        <li>query+load 替代直接 set</li>
+        <li>ThreadPools 替代 new Thread</li>
+        <li>KDBizException 替代 RE</li>
+      </ul>
+      <p style="margin-top:12px; font-size:.85em; color:var(--text-muted);">来源：coding-preferences.md<br>历史代码不因 B 层判错</p>
+    </div>
+    <div class="card layer-c">
+      <h3 style="color:var(--info);">C 层 · 治理项</h3>
+      <p style="font-size:.9em;"><span class="badge badge-info">INFO</span> 渐进优化</p>
+      <ul style="margin-top:12px; font-size:.9em;">
+        <li>补 @Override 验证来源注释</li>
+        <li>统一异常体系</li>
+        <li>减少原生样板代码</li>
+        <li>进一步封装收敛</li>
+      </ul>
+      <p style="margin-top:12px; font-size:.85em; color:var(--text-muted);">来源：coding-preferences.md · post-check.md<br>仅 --strict 模式检查 VERIFY-*</p>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 10: Anti-Hallucination ============ -->
+<div class="slide center">
+  <h2>幻觉防护机制</h2>
+  <p class="subtitle">AI 代码生成中最常见的苍穹 SDK 幻觉，ok-cosmic 全部拦截</p>
+  <div class="grid-2 w-full" style="margin-top:16px;">
+    <div class="card" style="text-align:left;">
+      <h3 style="color:var(--error);">幻觉方法名黑名单（11 项）</h3>
+      <div style="margin-top:8px; font-size:.85em;">
+        <table>
+          <tr><td style="color:#f87171"><code>setReadOnly()</code></td><td>→ <code>getView().setEnable()</code></td></tr>
+          <tr><td style="color:#f87171"><code>model.getRowCount()</code></td><td>→ <code>model.getEntryRowCount()</code></td></tr>
+          <tr><td style="color:#f87171"><code>model.addRow()</code></td><td>→ <code>model.createNewEntryRow()</code></td></tr>
+          <tr><td style="color:#f87171"><code>model.deleteRow()</code></td><td>→ <code>model.deleteEntryRow()</code></td></tr>
+          <tr><td style="color:#f87171"><code>getView().refresh()</code></td><td>→ <code>getView().updateView()</code></td></tr>
+          <tr><td style="color:#f87171"><code>queryAll()</code></td><td>→ <code>query()</code></td></tr>
+        </table>
+      </div>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3 style="color:var(--error);">幻觉类名黑名单（6 项）</h3>
+      <ul style="font-size:.9em;">
+        <li>不存在 <code>Cosmic*</code> 工具类</li>
+        <li>不存在 <code>Cloud*</code> Utils/Helper</li>
+        <li>不存在 <code>BillHelper</code></li>
+        <li>不存在 <code>FormHelper</code></li>
+        <li>不存在 <code>ListHelper</code></li>
+        <li>不存在 <code>PluginHelper</code></li>
+      </ul>
+      <div style="margin-top:16px;">
+        <h3 style="color:var(--warning);">枚举值禁猜 [A1.8]</h3>
+        <p style="font-size:.9em;">下拉字段选项值必须通过元数据脚本确认，禁止凭经验猜测</p>
+      </div>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 11: Post-Check ============ -->
+<div class="slide center">
+  <h2>Post-Check 自动校验</h2>
+  <p class="subtitle">每次代码生成后自动触发，形成闭环</p>
+  <div class="flow-line" style="margin:24px 0;">
+    <div class="flow-box">生成 .java</div>
+    <div class="flow-arrow">→</div>
+    <div class="flow-box">cosmic-post-check.py</div>
+    <div class="flow-arrow">→</div>
+    <div class="flow-box" style="border-color:var(--accent);">Gradle？</div>
+  </div>
+  <div class="grid-2 w-full">
+    <div class="card" style="text-align:left;">
+      <h3 style="color:var(--success);">Gradle 项目</h3>
+      <div class="flow-line" style="justify-content:flex-start; margin:8px 0;">
+        <div class="flow-box" style="font-size:.85em;">gradlew compileJava</div>
+        <div class="flow-arrow">→</div>
+        <div class="flow-box" style="font-size:.85em;">post-lint 场景/风格</div>
+        <div class="flow-arrow">→</div>
+        <div class="flow-box" style="font-size:.85em; border-color:var(--success);">综合结果</div>
+      </div>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3 style="color:var(--info);">非 Gradle 项目</h3>
+      <div class="flow-line" style="justify-content:flex-start; margin:8px 0;">
+        <div class="flow-box" style="font-size:.85em;">post-lint 静态校验</div>
+        <div class="flow-arrow">→</div>
+        <div class="flow-box" style="font-size:.85em; border-color:var(--success);">输出结果</div>
+      </div>
+    </div>
+  </div>
+  <div class="card w-full" style="margin-top:20px; text-align:left;">
+    <h3>4 大并行检查器</h3>
+    <div class="grid-3" style="margin-top:12px; gap:12px;">
+      <div class="card-sm"><strong>scene_check</strong><br><small style="color:var(--text-muted)">场景错配检测</small></div>
+      <div class="card-sm"><strong>style_check</strong><br><small style="color:var(--text-muted)">编码风格 24 规则</small></div>
+      <div class="card-sm"><strong>resource_check</strong><br><small style="color:var(--text-muted)">资源管理 4 规则</small></div>
+      <div class="card-sm"><strong>verify_check</strong><br><small style="color:var(--text-muted)">验证来源留痕</small></div>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 12: Snippets & Templates ============ -->
+<div class="slide center">
+  <h2>代码片段矩阵</h2>
+  <p class="subtitle">24 个场景化代码片段，按领域分类，可直接引用</p>
+  <div class="grid-3 w-full" style="margin-top:12px;">
+    <div class="card" style="text-align:left;">
+      <h3>📋 form/ <small style="color:var(--text-muted)">(10 篇)</small></h3>
+      <ul style="font-size:.85em;">
+        <li>ViewControlOpsSample</li>
+        <li>F7FilterSample</li>
+        <li>ConfirmDialogSample</li>
+        <li>OpenBillModalSample</li>
+        <li>TreeControlSample</li>
+        <li>...</li>
+      </ul>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3>🔍 query/ <small style="color:var(--text-muted)">(3 篇)</small></h3>
+      <ul style="font-size:.85em;">
+        <li>BatchQuerySample</li>
+        <li>DataSetQueryStatSample</li>
+        <li>BaseDataQuerySample</li>
+      </ul>
+      <h3 style="margin-top:16px;">📦 data/ <small style="color:var(--text-muted)">(2 篇)</small></h3>
+      <ul style="font-size:.85em;">
+        <li>DynamicObjectOpsSample</li>
+        <li>DynamicObjectCrudSample</li>
+      </ul>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3>⚙️ operation/ <small style="color:var(--text-muted)">(2 篇)</small></h3>
+      <ul style="font-size:.85em;">
+        <li>OpAddValidatorsSample</li>
+        <li>OperationOptionBridgeSample</li>
+      </ul>
+      <h3 style="margin-top:12px;">🔄 botp/</h3>
+      <ul style="font-size:.85em;"><li>BotpTracePushSample</li></ul>
+      <h3 style="margin-top:12px;">📎 attachment/</h3>
+      <ul style="font-size:.85em;"><li>AttachmentUploadBindSample</li></ul>
+      <h3 style="margin-top:12px;">💬 message/ · ⏰ task/ · 🔗 concurrent/</h3>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 13: Intent Routing ============ -->
+<div class="slide center">
+  <h2>自然语言意图路由</h2>
+  <p class="subtitle">三步翻译：时机 → 载体 → 能力，从业务话术到技术场景</p>
+  <div class="grid-3 w-full" style="margin-top:16px;">
+    <div class="card" style="text-align:left;">
+      <h3>① 看"时机词"</h3>
+      <table style="font-size:.82em;">
+        <tr><td>"保存前""审核时"</td><td>→ 操作插件</td></tr>
+        <tr><td>"下推时""选单时"</td><td>→ 转换插件</td></tr>
+        <tr><td>"字段变化""F7 过滤"</td><td>→ 前端交互</td></tr>
+        <tr><td>"定时执行""后台跑"</td><td>→ 后台任务</td></tr>
+        <tr><td>"外部调用""接口"</td><td>→ OpenAPI</td></tr>
+      </table>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3>② 看"载体词"</h3>
+      <table style="font-size:.82em;">
+        <tr><td>"表单上""控件"</td><td>→ 表单插件</td></tr>
+        <tr><td>"单据界面""头体"</td><td>→ 单据插件</td></tr>
+        <tr><td>"列表上""批量"</td><td>→ 列表插件</td></tr>
+        <tr><td>"左树右表"</td><td>→ 树列表插件</td></tr>
+        <tr><td>"报表过滤"</td><td>→ 报表插件</td></tr>
+      </table>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3>③ 补"能力词"</h3>
+      <table style="font-size:.82em;">
+        <tr><td>"打开页面""弹窗"</td><td>→ 视图跳转</td></tr>
+        <tr><td>"查数据""ORM"</td><td>→ 查询存取</td></tr>
+        <tr><td>"基础资料""物料"</td><td>→ 基础资料</td></tr>
+        <tr><td>"附件""上传"</td><td>→ 附件文件</td></tr>
+        <tr><td>"跨线程""并发"</td><td>→ 上下文恢复</td></tr>
+      </table>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 14: Extension Repos Fallback ============ -->
+<div class="slide center">
+  <h2 style="margin-bottom:6px;">扩展代码库兜底 <span style="font-size:.6em; color:var(--text-muted); font-weight:500;">Extension Repos Fallback</span></h2>
+  <p style="color:var(--text-muted); font-size:.95em; margin-bottom:24px;">信息检索的最后一道防线：内置资产与当前项目都 miss 时，再走拓展仓库</p>
+  <!-- Retrieval chain: 4 个阶梯式卡片→壮extensionRepos高亮 -->
+  <div class="retrieval-chain">
+    <div class="chain-node n-blue">
+      <div class="node-num">1</div>
+      <div class="node-icon">📖</div>
+      <div class="node-title">cheat-sheet</div>
+      <div class="node-desc">高频 API 速查</div>
+    </div>
+    <div class="chain-arrow-wrap">
+      <div class="arrow-label">miss</div>
+      <div class="arrow-icon">→</div>
+    </div>
+    <div class="chain-node n-purple">
+      <div class="node-num">2</div>
+      <div class="node-icon">🗄️</div>
+      <div class="node-title">知识库脚本</div>
+      <div class="node-desc">API 事实 / 字段校验</div>
+    </div>
+    <div class="chain-arrow-wrap">
+      <div class="arrow-label">miss</div>
+      <div class="arrow-icon">→</div>
+    </div>
+    <div class="chain-node n-green">
+      <div class="node-num">3</div>
+      <div class="node-icon">🧩</div>
+      <div class="node-title">assets/snippets</div>
+      <div class="node-desc">场景实现模板</div>
+    </div>
+    <div class="chain-arrow-wrap">
+      <div class="arrow-label">miss</div>
+      <div class="arrow-icon">→</div>
+    </div>
+    <div class="chain-node n-amber">
+      <div class="node-num">4</div>
+      <div class="node-icon">📦</div>
+      <div class="node-title">extensionRepos</div>
+      <div class="node-desc">拓展仓库兜底 ⭐</div>
+    </div>
+  </div>
+  <!-- 中间区：左 Venn 图 触发条件 / 右 配置示例 -->
+  <div class="grid-2 w-full" style="margin-top:26px; gap:20px;">
+    <div class="card" style="text-align:left; padding:20px 24px;">
+      <h3 style="margin-bottom:6px;">触发条件 <span style="font-size:.65em; color:var(--text-muted); font-weight:500;">需同时满足</span></h3>
+      <div class="venn-wrap">
+        <div class="venn-circle venn-left">内置资产<br>全部 miss</div>
+        <div class="venn-circle venn-right">当前项目<br>无可用实现</div>
+        <div class="venn-center">触发<br>Fallback</div>
+      </div>
+      <p style="text-align:center; font-size:.8em; color:var(--text-muted); margin-top:4px;">两个条件的<strong style="color:var(--accent);"> 交集 </strong>才会触发，避免乱跳拓展仓</p>
+    </div>
+    <div class="card" style="text-align:left; padding:20px 24px;">
+      <h3 style="margin-bottom:8px;">一行配置即启用 <span style="font-size:.65em; color:var(--text-muted); font-weight:500;">ok-cosmic.json</span></h3>
+      <div class="code-block" style="font-size:.82em;">
+{
+  <span class="cm">// 其他字段省略…</span>
+  <span style="color:#fbbf24; font-weight:700;">"extensionRepos"</span>: [
+    <span class="str">"/path/to/ext-repo-1"</span>,
+    <span class="str">"~/code/ext-repo-2"</span>
+  ]
+}
+      </div>
+      <p style="margin-top:10px; font-size:.78em; color:var(--text-muted);">支持 <code>~</code> 展开、多路径。Step 0 预检自动校验，路径不存在只给 WARNING。</p>
+    </div>
+  </div>
+  <!-- 使用原则 3 大徽章 -->
+  <div class="principle-row w-full" style="margin-top:22px;">
+    <div class="principle-badge p-amber">
+      <div class="pb-icon">📌</div>
+      <div class="pb-text"><strong>仅参考</strong><span>不等同于 ok-cosmic 推荐写法</span></div>
+    </div>
+    <div class="principle-badge p-red">
+      <div class="pb-icon">🛡️</div>
+      <div class="pb-text"><strong>规范优先</strong><span>与 A/B 层冲突时以 ok-cosmic 为准</span></div>
+    </div>
+    <div class="principle-badge p-blue">
+      <div class="pb-icon">🔘</div>
+      <div class="pb-text"><strong>可选开关</strong><span>未配置或空数组时自动跳过</span></div>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 15: Quick Start ============ -->
+<div class="slide center">
+  <h2>快速开始</h2>
+  <div class="w-full" style="margin-top:16px;">
+    <table>
+      <tr><th>你的情况</th><th>从哪步开始</th><th>预计耗时</th></tr>
+      <tr><td>首次完整安装（含服务端）</td><td>步骤 1</td><td>30 分钟</td></tr>
+      <tr><td>服务端已就绪，新项目接入</td><td>步骤 6</td><td>2 分钟</td></tr>
+      <tr><td>已有项目，换 Agent</td><td>步骤 7</td><td>1 分钟</td></tr>
+    </table>
+  </div>
+  <div class="grid-2 w-full" style="margin-top:20px;">
+    <div class="card" style="text-align:left;">
+      <h3>安装步骤概览</h3>
+      <ol style="list-style:decimal; padding-left:20px; font-size:.95em;">
+        <li style="padding:4px 0;">环境检查（Java 8+ / Python 3.8+）</li>
+        <li style="padding:4px 0;">部署自定义封装库 JAR</li>
+        <li style="padding:4px 0;">注册元数据 + 基础资料 OpenAPI</li>
+        <li style="padding:4px 0;">构建离线知识库</li>
+        <li style="padding:4px 0;">知识验证</li>
+        <li style="padding:4px 0;">创建 <code>ok-cosmic.json</code> 配置</li>
+        <li style="padding:4px 0;">软链接安装 Skill</li>
+        <li style="padding:4px 0;">加载 Skill 开始编程</li>
+      </ol>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3>多 Agent 共享（推荐）</h3>
+      <div class="code-block" style="font-size:.8em; margin-top:8px;">
+<span class="cm"># 唯一维护一份 skill 源</span>
+~/skills/ok-cosmic
+<span class="cm"># 各 Agent 软链接指向</span>
+~/.claude/skills/ok-cosmic    → ~/skills/ok-cosmic
+~/.opencode/skills/ok-cosmic  → ~/skills/ok-cosmic
+~/.codex/skills/ok-cosmic     → ~/skills/ok-cosmic
+~/.gemini/.../ok-cosmic       → ~/skills/ok-cosmic
+      </div>
+      <p style="margin-top:12px; font-size:.85em; color:var(--text-muted);">更新一处，多个 Agent 同步生效</p>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 16: Demo Scenarios ============ -->
+<div class="slide center">
+  <h2>典型使用场景</h2>
+  <div class="grid-2 w-full" style="margin-top:16px;">
+    <div class="card" style="text-align:left;">
+      <h3>场景一：表单字段联动</h3>
+      <div class="code-block" style="font-size:.82em; margin-top:8px;">
+<span class="cm">// 用户说：</span>
+<span class="str">"帮我写一个表单插件，数量变化时自动计算金额"</span>
+<span class="cm">// AI 执行路径：</span>
+1. 意图路由 → "字段值改变" → 表单插件
+2. 决策矩阵 → #form-plugin
+3. 确认卡 → propertyChanged 事件
+4. 查元数据 → 确认 qty / price / amount 字段
+5. 读 FormPluginTemplate.java
+6. 生成代码 → Post-Check ✅
+      </div>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3>场景二：审核前校验</h3>
+      <div class="code-block" style="font-size:.82em; margin-top:8px;">
+<span class="cm">// 用户说：</span>
+<span class="str">"审核时校验分录不能为空"</span>
+<span class="cm">// AI 执行路径：</span>
+1. 意图路由 → "审核时" → 操作插件
+2. 决策矩阵 → #op-plugin
+3. 确认卡 → onAddValidators 事件
+4. 读 OpPluginTemplate.java
+5. 查 cheat-sheet → getEntryRowCount API
+6. 生成代码 → Post-Check ✅
+      </div>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3>场景三：BOTP 下推</h3>
+      <div class="code-block" style="font-size:.82em; margin-top:8px;">
+<span class="cm">// 用户说：</span>
+<span class="str">"实现销售订单到出库单的下推转换"</span>
+<span class="cm">// AI 执行路径：</span>
+1. 意图路由 → "下推" → 转换插件
+2. 决策矩阵 → #convert-plugin
+3. 读 BotpTracePushSample 片段
+4. 读 ConvertPlugInTemplate.java
+5. 生成代码 → Post-Check ✅
+      </div>
+    </div>
+    <div class="card" style="text-align:left;">
+      <h3>场景四：API 签名校验</h3>
+      <div class="code-block" style="font-size:.82em; margin-top:8px;">
+<span class="cm">// 用户说：</span>
+<span class="str">"查询 QueryServiceHelper 的 loadSingle 用法"</span>
+<span class="cm">// AI 执行路径：</span>
+1. 调用 cosmic_get_class_detail
+2. detail kd.bos.servicehelper
+        .QueryServiceHelper
+        --method loadSingle --compact
+3. 返回精确签名 + 参数说明
+4. 写入代码 → 签名保证准确
+      </div>
+    </div>
+  </div>
+</div>
+<!-- ============ SLIDE 17: Summary ============ -->
+<div class="slide center">
+  <h2>总结</h2>
+  <div class="grid-2 w-full" style="margin-top:20px;">
+    <div>
+      <div class="card" style="text-align:left; margin-bottom:16px;">
+        <h3 style="color:#fff;">核心价值</h3>
+        <ul style="font-size:.95em;">
+          <li><strong>消除 API 幻觉</strong> — 黑名单 + 知识库校验双保险</li>
+          <li><strong>事件时机正确</strong> — 场景错配自动检测</li>
+          <li><strong>封装优先落地</strong> — 模板 + 规则引导使用封装</li>
+          <li><strong>交付质量保证</strong> — Post-Check 自动闭环校验</li>
+          <li><strong>拓展库兜底</strong> — extensionRepos 补足内置资产的长尾空白</li>
+          <li><strong>Token 高效</strong> — 索引 + 按需加载最小化上下文</li>
+        </ul>
+      </div>
+      <div class="card" style="text-align:left;">
+        <h3 style="color:#fff;">兼容性</h3>
+        <ul style="font-size:.95em;">
+          <li>Claude Code / Qoder</li>
+          <li>OpenCode / Codex</li>
+          <li>Gemini CLI</li>
+          <li>任何支持 Skill 的 AI Agent</li>
+        </ul>
+      </div>
+    </div>
+    <div>
+      <div class="card" style="text-align:center; padding:40px;">
+        <div class="hero-logo" style="font-size:4em;">🚀</div>
+        <div class="version" style="margin:12px 0;">v1.3.0</div>
+        <h2 style="font-size:1.8em; margin-bottom:8px;">ok-cosmic</h2>
+        <p style="color:var(--text-muted);">让 AI 真正理解苍穹 SDK<br>写出生产级代码</p>
+        <div style="margin-top:24px; display:flex; gap:8px; flex-wrap:wrap; justify-content:center;">
+          <span class="tag tag-blue">15 模板</span>
+          <span class="tag tag-purple">7 工具</span>
+          <span class="tag tag-green">6 检查器</span>
+          <span class="tag tag-amber">24 片段</span>
+          <span class="tag tag-red">19 硬规则</span>
+        </div>
+      </div>
+    </div>
+  </div>
+  <p style="margin-top:32px; color:var(--text-muted); font-size:.9em;">作者：陈泽贤、钱芮名 &nbsp;|&nbsp; 金蝶云苍穹 AI 开发技能</p>
+</div>
+</div><!-- /deck -->
+<!-- Navigation -->
+<div class="nav">
+  <button onclick="go(-1)" title="上一页">‹</button>
+  <button onclick="go(1)" title="下一页">›</button>
+</div>
+<script>
+  const slides = document.querySelectorAll('.slide');
+  let cur = 0;
+  function show(n) {
+    slides.forEach((s, i) => {
+      s.classList.remove('active', 'prev');
+      if (i === n) s.classList.add('active');
+      else if (i < n) s.classList.add('prev');
+    });
+    document.getElementById('progress').style.width = ((n + 1) / slides.length * 100) + '%';
+    document.getElementById('pageNum').textContent = (n + 1) + ' / ' + slides.length;
+  }
+  function go(d) {
+    cur = Math.max(0, Math.min(slides.length - 1, cur + d));
+    show(cur);
+  }
+  document.addEventListener('keydown', e => {
+    if (e.key === 'ArrowRight' || e.key === ' ' || e.key === 'PageDown') { e.preventDefault(); go(1); }
+    if (e.key === 'ArrowLeft' || e.key === 'PageUp') { e.preventDefault(); go(-1); }
+    if (e.key === 'Home') { e.preventDefault(); cur = 0; show(cur); }
+    if (e.key === 'End') { e.preventDefault(); cur = slides.length - 1; show(cur); }
+  });
+  // Touch support
+  let touchX = 0;
+  document.addEventListener('touchstart', e => touchX = e.touches[0].clientX);
+  document.addEventListener('touchend', e => {
+    const dx = e.changedTouches[0].clientX - touchX;
+    if (Math.abs(dx) > 50) go(dx < 0 ? 1 : -1);
+  });
+  show(0);
+</script>
+</body>
+</html>