CHANGELOG.html

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>act-combat-design · 更新记录</title>
<style>
  :root{
    --bg:#eef2f8;--paper:#ffffff;--ink:#1a2332;--muted:#5a6578;
    --accent:#1e40af;--line:#e2e8f0;--hl:#dbeafe;
    --add:#1f7a4d;--add-bg:#e8f3ec;--chg:#1e40af;--chg-bg:#dbeafe;--fix:#b45309;--fix-bg:#fdeecd;
    --serif:"Noto Serif SC","STSong","SimSun",serif;
    --sans:-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;
    --mono:Consolas,"Cascadia Code",monospace;
  }
  *{box-sizing:border-box;}
  body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);line-height:1.8;font-size:15px;}
  main{max-width:1100px;margin:0 auto;padding:28px 32px 80px;}
  a{color:var(--accent);}
  header.hero{background:linear-gradient(135deg,#1e3a8a,#1e40af 60%,#3a7ca5);color:#fff;border-radius:16px;padding:30px 34px;margin:18px 0 24px;}
  header.hero h1{font-family:var(--serif);margin:0 0 6px;font-size:26px;}
  header.hero p{margin:0;opacity:.94;font-size:14px;}
  .ver{background:var(--paper);border:1px solid var(--line);border-radius:14px;padding:22px 26px;margin:0 0 20px;box-shadow:0 2px 14px rgba(30,64,175,.06);}
  .ver h2{font-family:var(--serif);font-size:20px;color:var(--accent);margin:0 0 4px;display:flex;align-items:center;gap:10px;}
  .ver h2 .date{font-family:var(--mono);font-size:13px;color:var(--accent);font-weight:500;background:var(--hl);padding:2px 9px;border-radius:6px;}
  .group{margin:14px 0 0;}
  .tag{display:inline-block;font-size:12.5px;font-weight:700;padding:2px 11px;border-radius:6px;margin-bottom:2px;}
  .tag.add{background:var(--add-bg);color:var(--add);}
  .tag.chg{background:var(--chg-bg);color:var(--chg);}
  .tag.fix{background:var(--fix-bg);color:var(--fix);}
  ul{margin:8px 0 0;padding-left:22px;}
  li{margin:5px 0;}
  code{font-family:var(--mono);background:#eaf0f9;color:#16357a;padding:1px 6px;border-radius:4px;font-size:.9em;}
  strong{color:var(--accent);}
  .foot{color:var(--muted);font-size:12.5px;text-align:center;margin-top:24px;}
  .tldr{margin:4px 0 6px;color:var(--muted);font-size:14px;}
  .files{margin-top:16px;border-top:1px dashed var(--line);padding-top:12px;font-size:13px;color:var(--muted);}
  .files .ftitle{font-weight:500;color:var(--ink);margin-bottom:6px;}
  .files p{margin:5px 0;line-height:1.9;}
  .fk{display:inline-block;font-size:12px;font-weight:700;padding:1px 8px;border-radius:5px;margin-right:8px;}
  .fk.add{background:var(--add-bg);color:var(--add);}
  .fk.chg{background:var(--chg-bg);color:var(--chg);}
  .fk.del{background:#eceae3;color:#6b6b66;}
  .notice{background:var(--fix-bg);border:1px solid #f0d9a8;border-left:4px solid var(--fix);border-radius:8px;padding:10px 14px;margin:10px 0 4px;font-size:13.5px;color:#6b4d12;}
  .notice p{margin:3px 0;}
  .notice strong{color:#8a5a12;}
  .foot a{color:var(--accent);}
  .maint{margin-top:8px;line-height:1.95;}
</style>
</head>
<body>
<main>

  <header class="hero">
    <h1>更新记录 · Changelog</h1>
    <p>act-combat-design 每次功能 / 内容更新都记在这里，方便使用者一眼知道更了啥。</p>
  </header>

  <section class="ver">
    <h2>v1.3 <span class="date">2026-07-13</span></h2>
    <p class="tldr">本次主要：新增<strong>操作循环示意图规范</strong>（按键即节点 / 键帽 / ▶ 开始标记 / 冷热启动双入口 / 内外双环）+ <strong>效果养成范式升级</strong>（阅读顺序铁律 / <strong>属性堆叠审计</strong> / <strong>连点里程碑</strong> / 双峰形态口径 / 审计避坑清单）；三份样板（苍岚 ×2 / 烬羽）按新范式补图补审计。沉淀自一轮真实角色养成稿评审迭代。</p>
    <div class="notice">
      <p><strong>对使用者</strong>：pull 后<strong>无需操作</strong> —— 新增 1 个 reference + 范式细化 + 样板增图，既有流程不变。无破坏性变更。</p>
    </div>

    <div class="group">
      <span class="tag add">新增 Added</span>
      <ul>
        <li><strong>操作循环示意图规范</strong> —— <code>references/operation-loop-diagram.md</code>：<strong>按键即节点</strong>（键帽五语义色：核心技蓝 / 爆发金 / 填充灰 / 防御青 / 协作粉）+ ▶ 开始标记 + <strong>冷启 / 热启双入口</strong> + <strong>内圈维持 ＋ 外圈爆发双环</strong>（含「维持工具箱」与「卡拍」范式）+ 排版铁律（网格对齐 / 少折线 / 标签不遮挡 / <strong>美观优先</strong>）。出图规则按文档规格分：<strong>纯战斗设计分稿只出 C0</strong>；养成稿 / 完整稿出 <strong>C0 ＋ 满配对照</strong>（满配图展示「养成买到的操作变化」）。</li>
        <li><strong>属性堆叠审计范式</strong> —— <code>effect-progression-design.md</code> § 三：同属性跨来源（技能效果 ＋ 被动 ＋ 命座 ＋ 套装）<strong>极限同刻</strong>审计 —— 逐线极限构成 + 兜底类别（转化上限 / 幂衰减 / 行为限幅 / 单向阀 / 窗口时限，有几条写几条）+ 一句整体判定 + 极限单发校验；附 5 条审计避坑（同轴撞车 / 定位越界 / 入口过多 / 永续漏洞 / 演出冲突）。</li>
        <li><strong>连点里程碑视角（示例 ／ 推荐，节奏按项目定）</strong> —— 同上 § 二：按<strong>你项目玩家的实际购买节奏</strong>画累计增益（分包由项目商业化设计定，「1+2 连点 / 3+4 连点 / 直奔收官」为常见 gacha 示例），每个连点包标注主题 + 同轴检查。</li>
      </ul>
    </div>

    <div class="group">
      <span class="tag chg">变更 Changed</span>
      <ul>
        <li><strong>效果养成范式 7 章按阅读顺序重排</strong> —— <strong>属性投放章必须排在技能附带效果与命座 / 养成物之后</strong>（它汇总的正是前两处的投放）；操作循环图上移到壹章。</li>
        <li><strong>双峰形态（示例 ／ 推荐口径，按项目定）</strong> —— 业界 gacha 常见「拐点 ＋ 收官」双峰（E2 / E6 付费节奏），并非必须逐级严格递增；具体形态按项目付费哲学定，通用提示是单峰过陡（单段 >35~40%）有「X 命起玩」舆论风险。</li>
        <li><strong>数值建模硬标准 +1 项</strong> —— <code>design-doc-structure.md</code>：<strong>属性投放与堆叠审计</strong>成为必配项（gacha 另配连点里程碑）。</li>
        <li><strong>完整稿贰章操作循环图规格</strong> —— 按 <code>operation-loop-diagram.md</code> 出 <strong>C0 ＋ 满配对照两张</strong>；分稿战斗设计稿只出 C0。</li>
        <li><strong>三份样板按新范式升级</strong> —— 苍岚战斗设计稿补 C0 键帽循环图；苍岚养成稿升级为 C0 / 满配对照 ＋ 属性堆叠审计 ＋ 连点里程碑；烬羽完整稿升级为 C0 / 满配对照 ＋ 属性投放与堆叠审计章（含投放表 ＋ 极限堆叠横条图）。</li>
        <li><strong>完整稿 9 章序调整</strong> —— 配队协力前移至<strong>肆</strong>（战斗行为与招式一脉，且让「养成命座 → 数值建模」相邻），资源系统改伍、养成命座改陆；模板 <code>blank-character-design-doc.html</code> 与样板烬羽同步（section 顺序 / SECTIONS / 评审备注编号 / 交叉引用）。</li>
        <li><strong>循环图「拓扑先行」铁律</strong> —— <code>operation-loop-diagram.md</code>：拓扑必须由角色机制推导（跑道型 / 自动环型 / 计量池型 / 双环型…），禁止套用他角图形，铁律扩展到所有示意图（资源流转 / 堆叠 / 数值曲线同样不套皮换字）；样板烬羽、苍岚循环图均按各自机制重画（烬羽「自动自燃环 ＋ 按键加速器」、苍岚「势计量池 ＋ 按层出口」）。</li>
        <li><strong>样板阅读顺序修正</strong> —— 苍岚养成稿操作循环图自伍章上移到壹章（先看循环，再看往循环上挂什么）；苍岚战斗设计稿移植图表 lightbox（此前缺失，插图不可点击放大）。</li>
        <li><strong>属性投放与堆叠审计独立成章</strong> —— 完整稿由 9 章升为 <strong>10 章</strong>（新柒章，位于养成命座与数值建模之间）；模板 / 样板烬羽 / <code>design-doc-structure.md</code> 10 章表同步重编号；分稿养成稿维持在属性章内。苍岚投放表升级为「谁吃到 × 属性 × 来源与量」＋「面板词条优先级」双表。</li>
        <li><strong>样板图表评审级排版精修</strong> —— 循环图按各自机制拓扑重画并做评审级排版（箭头对中 ／ 汇入圆点 ／ 间距留足），堆叠横条图按专业规格出图（网格 ＋ 坐标轴 ＋ 图例、标签不越界）。</li>
        <li><strong>堆叠审计呈现升级「五件套」</strong> —— 投放表 → 来源构成横条图 → 📐 怎么算 / 为什么 / 结果 三问框 → 极限同刻判定表 → 兜底机制清单 ＋ 整体判定醒目条（<code>.philosophy</code>，不再淹在小字里）。苍岚补来源构成图与兜底清单，烬羽判定表补齐算式、兜底独立成块；模板 / 范式文档同步。</li>
        <li><strong>诚实精准铁律与审计口径细化</strong> —— design-doc-structure 顶部新增 🔴 <strong>诚实精准铁律</strong>（一切内容按实际设计推导：有多少写多少、不多编不少写，结构底线 ＝ 该有的都有 ＋ 阅读顺序正确）；兜底机制明确「有几条写几条，别硬凑」、极限单发校验明确<strong>同招对比</strong>口径；<strong>连点节奏表</strong>入养成 / 命座章（与数值章里程碑两处呈现，按项目商业化定）；两份样板及 md 源稿按铁律复核修正。</li>
        <li><strong>三问注解统一分行式</strong> —— 所有「📐 怎么算 / 为什么 / (过程 /) 结果」注解统一为 anno-box 分行注解框（标题行 ＋ 每问一行）；摆放规则：有卡片承载的放进卡片内（与 SVG 同卡），无卡片承载的独立成块；样板同步。</li>
        <li><strong>样板双向诚实审计复核（编造 ↔ 遗漏）</strong> —— 对两份样板做「引用处 vs 定义处逐条核对 ＋ 设计元素反查下游落点」的双向审计，修复口径矛盾与覆盖缺口 38 项（审计线补全、循环图冷 ／ 热双入口、资产清单补齐、失效交叉引用清零等），样板与 md 源稿全量对齐。</li>
      </ul>
    </div>

    <div class="group">
      <span class="tag fix">修复 Fixed</span>
      <ul>
        <li>无破坏性修复；本次以范式 / 样板补全为主。</li>
      </ul>
    </div>

    <div class="files">
      <div class="ftitle">📁 本次涉及文件</div>
      <p><span class="fk add">新增 1</span><code>references/operation-loop-diagram.md</code></p>
      <p><span class="fk chg">修改 13</span><code>SKILL.md</code> · <code>README.md</code> · <code>CHANGELOG.md</code> + 本页 · <code>references/effect-progression-design.md</code> · <code>references/design-doc-structure.md</code> · <code>templates/blank-character-design-doc.html</code> · <code>cang-lan/</code> 两份 html + 两份 md · <code>jin-yu/</code> html + md</p>
      <p><span class="fk del">删除 0</span>无</p>
    </div>
  </section>

  <section class="ver">
    <h2>v1.2 <span class="date">2026-06-23</span></h2>
    <p class="tldr">本次主要：新增<strong>完整角色稿模板</strong> + <strong>完整稿满配样板「烬羽」</strong>，并把「角色设计稿」明确成<strong>分稿 / 完整稿两种规格</strong> + <strong>文件命名规范</strong> + <strong>数值建模硬标准</strong>；元规则 42 → 46 条、角色原型库去项目脱敏、只保留业界 F–Q 12 种。</p>
    <div class="notice">
      <p><strong>对使用者</strong>：pull 后<strong>无需操作</strong> —— 新增模板 / 样板 / 范式细化，既有「分稿」流程不变；想出一份到底的完整稿时多一套模板可用。无破坏性变更。</p>
    </div>

    <div class="group">
      <span class="tag add">新增 Added</span>
      <ul>
        <li><strong>完整角色稿模板</strong> —— <code>templates/blank-character-design-doc.html</code>：通用 9 章（设计定位哲学 / 核心机制 / 招式详解 / 🟡 资源系统（深入，按角色）/ 养成命座 / 🟡 配队协力（按项目）/ 数值建模 / 资源清单 / 自检）+ <strong>三类图骨架</strong>（贰 操作循环示意图、肆 资源流转示意图、柒 数值建模 5 图）+ 完整协作交互层 + 图表 lightbox。</li>
        <li><strong>完整稿满配样板「烬羽」</strong> —— <code>output/characters/jin-yu/</code>（延迟引爆型火术者，挂《星澜纪》gacha）：9 章全 + 10 图（操作循环 / 资源流转 / 数值建模 5 图）。作「完整稿」满配样板，区别于苍岚的「分稿」样板。</li>
        <li><strong>角色原型库 project-agnostic 化</strong> —— <code>character-archetypes.md</code>：移除项目脱敏的基础 5 种（A–E）+ R 延迟引爆，<strong>只保留业界调研 F–Q 12 种</strong>；各项目自家原型放本地知识区。延迟引爆机制仍由完整稿样板「烬羽」演示。</li>
        <li><strong>4 条新元规则（K 组）</strong> —— <code>meta-rules.md</code>：操作核心方向先对齐 / 消极动作不触发爆发 / 资源返现易空转（走限时窗）/ 异格不换皮三轴分流（元规则 42 → 46 条）。</li>
      </ul>
    </div>

    <div class="group">
      <span class="tag chg">变更 Changed</span>
      <ul>
        <li><strong>角色完整稿范式细化</strong> —— <code>design-doc-structure.md</code> 明确<strong>两种规格</strong>：分稿（战斗设计稿 + 养成稿分开）/ 完整稿（一份 9 章），并给<strong>判断逻辑</strong>（用户明示按明示、没明示就问）。</li>
        <li><strong>文件命名规范</strong> —— 同上：<code>角色名-战斗设计</code> / <code>角色名-养成与效果</code> / <code>角色名-战斗设计及养成效果</code> / <code>角色名-资源需求</code>；「审阅稿」是协作形态、不进文件名。</li>
        <li><strong>数值建模硬标准</strong> —— 同上：无论完整稿还是分稿养成稿，数值建模必配 <strong>5 图 + 三段注解 + 平衡自检表</strong>，只写表不配图 = 不合格。</li>
        <li><strong>图表 lightbox 按界面 fit 完整显示</strong> —— <code>review-html-components.md</code>：<code>width:94vw</code> + <code>max-height:88vh</code> + <code>height:auto</code>，宽图撑满、高图触顶自动等比缩到完整居中，都不被裁（废弃旧的固定 <code>width:min(1180px,…)</code>）。</li>
        <li><strong>苍岚分稿按命名规范重命名</strong> —— <code>苍岚-战斗设计.html</code> + <code>苍岚-养成与效果.html</code>（原「审阅稿 / 效果与养成-gacha 演示」）。</li>
      </ul>
    </div>

    <div class="group">
      <span class="tag fix">修复 Fixed</span>
      <ul>
        <li>无破坏性修复；本次以内容 / 范式补全为主。</li>
      </ul>
    </div>

    <div class="files">
      <div class="ftitle">📁 本次涉及文件</div>
      <p><span class="fk add">新增 3</span><code>templates/blank-character-design-doc.html</code> · <code>jin-yu/烬羽-战斗设计及养成效果.html</code> + <code>md/.md</code></p>
      <p><span class="fk chg">修改 7</span><code>SKILL.md</code> · <code>README.md</code> · <code>上手指南.html</code> · <code>CHANGELOG.md</code> + 本页 · <code>references/design-doc-structure.md</code> · <code>references/review-html-components.md</code></p>
      <p><span class="fk chg">重命名 2</span><code>cang-lan/</code> 下 <code>苍岚-战斗设计</code> + <code>苍岚-养成与效果</code>（html + md/）</p>
      <p><span class="fk del">删除 0</span>无</p>
    </div>
  </section>

  <section class="ver">
    <h2>v1.1 <span class="date">2026-06-18</span></h2>
    <p class="tldr">本次主要：新增<strong>自我更新机制</strong>（🧪 试验性）+ <strong>数值建模验证</strong>方法论 + <strong>gacha 示例项目</strong>，并让设计稿默认产出审阅 HTML。</p>
    <div class="notice">
      <p><strong>⚠️ 行为变更</strong>：设计稿产出 —— md 草稿确认后<strong>默认随之产出审阅级 HTML</strong>（原先需单独要）。</p>
      <p><strong>对使用者</strong>：pull 后<strong>无需操作</strong> —— 自我更新默认关闭；设计稿产出默认多出 HTML 孪生；无破坏性变更。</p>
    </div>

    <div class="group">
      <span class="tag add">新增 Added</span>
      <ul>
        <li><strong>自我更新机制（🧪 试验性）</strong> —— 新增 <code>knowledge-local/</code>：下游 agent 用中<strong>自动捕获</strong>洞察（<code>self-update/</code>）+ 用户<strong>指定</strong>的项目知识（<code>project-knowledge/</code>）。全留本地、<strong>不进 git</strong>、<strong>默认关闭</strong>（首次会问，因为耗 token）。带「写入前归属判定」triage。</li>
        <li><strong>数值建模验证方法论</strong> —— <code>numbers-and-progression.md</code> § 十：脚本化建模 → 独立 agent 对抗性交叉验证 → 设计稿内嵌可视化（每图「怎么算 / 为什么 / 结果」三问注解）。</li>
        <li><strong>命座 / 养成梯度健康自检阈值</strong> —— § 五：满命总梯度 +80~120% 等 8 项经验基线，含养成物 / 套装阈值。</li>
        <li><strong>效果与养成设计范式</strong> —— 新增 reference <code>effect-progression-design.md</code>：7 章结构 + 3 类图 + 数值注解四要素；以苍岚 gacha 演示稿为范例（references 22 → 23 份）。</li>
        <li><strong>gacha 示例项目《星澜纪》</strong> —— <code>example-conventions-gacha.md</code>（3D 三人队 + 命座 + 养成物 + PVP）+ 配套苍岚 gacha 移植效果稿（含审阅 HTML + 内嵌命座曲线）。</li>
        <li><strong>上手指南 conventions 概览图</strong> —— 第 ⑤ 节加「10 维度一图看全 + 买断 / gacha 双范例对比」。</li>
        <li><strong>本更新记录</strong> —— <code>CHANGELOG.md</code> + 本页。</li>
      </ul>
    </div>

    <div class="group">
      <span class="tag chg">变更 Changed</span>
      <ul>
        <li><strong>设计稿产出默认配审阅 HTML</strong> —— Phase 6：md 草稿确认 OK 后，<strong>默认自动产出审阅级 HTML 孪生</strong>（不用再单独要）。</li>
        <li><strong>加法增伤区稀释</strong> —— § 四增补「自拐被面板增伤稀释」边际算法 <code>S ÷ (1+P)</code>。</li>
        <li><strong>§ 五阈值取用说明</strong> —— 明确「场景梯度 / PVP / 养成物」按定位 / 品类取用，单体 / 单机 / 无 PVP 角色对应项判 N/A。</li>
      </ul>
    </div>

    <div class="group">
      <span class="tag fix">修复 Fixed</span>
      <ul>
        <li>上手指南「目录结构」树补上 <code>knowledge-local/</code>。</li>
        <li>references 份数纠正：文档原称「21 份」实为 22（漏数 <code>dual-arena-boss.md</code>），现按实际标注（初始 22 → 现 23）。</li>
        <li>审阅 HTML 里 B 站嵌入由协议相对 <code>//player.bilibili.com</code> 改为 <code>https://</code>，file:// 本地打开也能放（与 YouTube 对齐）。</li>
      </ul>
    </div>

    <div class="files">
      <div class="ftitle">📁 本次涉及文件</div>
      <p><span class="fk add">新增 9</span><code>knowledge-local/</code>（README + 2 占位）· <code>conventions/example-conventions-gacha.md</code> · <code>references/effect-progression-design.md</code> · <code>cang-lan/苍岚-养成与效果.md</code> + <code>.html</code> · <code>CHANGELOG.md</code> + <code>CHANGELOG.html</code></p>
      <p><span class="fk chg">修改 7</span><code>SKILL.md</code> · <code>README.md</code> · <code>USAGE.md</code> · <code>conventions/TEMPLATE.md</code> · <code>references/numbers-and-progression.md</code> · <code>上手指南.html</code> · <code>.gitignore</code></p>
      <p><span class="fk del">删除 0</span>无</p>
    </div>
  </section>

  <section class="ver">
    <h2>v1.0 <span class="date">初始版本 · Initial</span></h2>
    <ul>
      <li><strong>项目无关的 ACT 战斗设计方法论 + 行业知识库</strong>：6 Phase 流程（角色 / Boss）、<code>conventions/TEMPLATE.md</code> 项目约定模板、22 份 references 知识库（角色原型 / Boss 范式 / 42 元规则 / 70+ 跨游戏借鉴 / 打击感 · 数值 · Boss AI 工程基线 / 审阅 HTML + 资源 xlsx 产出工具链）。</li>
      <li><strong>示例</strong>：买断制示例项目《孤刃行》+ 示例角色「苍岚」+ 示例 Boss「孤鸦」（含审阅 HTML + 资源 xlsx）。</li>
      <li><strong>多 agent 可用</strong>：纯 markdown，Claude Code / GPT / Claude.ai / Cursor 均可加载（见 <code>USAGE.md</code>）。</li>
    </ul>
  </section>

  <div class="foot">
    act-combat-design · 二次元 / ACT 战斗设计方法论 + 行业知识库 · <a href="LICENSE">MIT</a>
    <div class="maint">
      <div>github：<a href="https://github.com/koisama0411">koisama0411</a></div>
      <div>邮箱：<a href="mailto:koisama0411@gmail.com">koisama0411@gmail.com</a></div>
      <div>wechat：HeyKoi0411</div>
    </div>
  </div>

</main>
</body>
</html>