From: wang.yu <wang.yu@advantech.com>
Date: Wed, 19 Aug 2026 02:25:24 +0000 (+0800)
Subject: docs: 修复设计文档左侧目录点击章节后消失（flex min-width:0 消除水平滚动）
X-Git-Url: http://acesimba.cloud/gitweb/?a=commitdiff_plain;h=e8c96eaed3959848137664f658a4c670e790069a;p=StationBuilder.git

docs: 修复设计文档左侧目录点击章节后消失（flex min-width:0 消除水平滚动）

- 根因：顶部版本说明段落含全角空格不换行，flex item 默认 min-width:auto 不收缩，
  将 main#doc 撑到约 2238px 宽；点击锚点时浏览器水平滚动把 sticky 目录推出左边界。
- 修复：main#doc 增加 min-width:0，内容正常折行、消除水平滚动。
- 设计文档升 v0.17 并登记 changelog。
---

diff --git a/public/design-doc.html b/public/design-doc.html
index 162820a..ea0bfca 100644
--- a/public/design-doc.html
+++ b/public/design-doc.html
@@ -53,7 +53,7 @@
   .doc-nav a:hover{ background:#f2f7fa; color:var(--blue); }
   .doc-nav a.sub{ padding-left:22px; font-size:12.5px; color:#667; }
   .doc-nav a.active{ background:#eef7fb; color:var(--blue); font-weight:bold; }
-  main#doc{ max-width:none; flex:1 1 auto; margin:0; padding:24px 22px 80px; }
+  main#doc{ max-width:none; flex:1 1 auto; margin:0; padding:24px 22px 80px; min-width:0; }
   h2,h3,h4{ scroll-margin-top:64px; }
   @media (max-width:760px){
     .doc-layout{ flex-direction:column; padding-left:0; }
@@ -96,7 +96,7 @@
   <nav class="doc-nav"><div class="doc-nav-inner" id="toc"></div></nav>
 
 <main id="doc">
-  <p class="muted">文档版本：v0.16　最后更新：2026-08-19　修改人：wang.yu　状态：开发中（演示数据已标注）</p>
+  <p class="muted">文档版本：v0.17　最后更新：2026-08-19　修改人：wang.yu　状态：开发中（演示数据已标注）</p>
   <h1>StationBuilder 产品与交互设计方案</h1>
 
   <h2>1. 文档说明</h2>
@@ -732,6 +732,7 @@
   <h3>11.1 版本变更记录（Changelog）</h3>
   <table class="changelog">
     <tr><th>版本</th><th>日期</th><th>修改人</th><th>说明</th></tr>
+    <tr><td>v0.17</td><td>2026-08-19</td><td>wang.yu</td><td>修复左侧目录（TOC）点击章节后消失：根因为顶部版本说明段落含全角空格不换行，在 flex 布局下把 <code>main#doc</code> 撑到约 2238px 宽（flex item 默认 <code>min-width:auto</code> 不收缩），点击锚点时浏览器水平滚动将 sticky 目录推出左边界。给 <code>main#doc</code> 增加 <code>min-width:0</code> 使其可收缩、内容正常折行，消除水平滚动，目录任意宽度常驻可见。</td></tr>
     <tr><td>v0.16</td><td>2026-08-19</td><td>wang.yu</td><td>设计方案文档修订：① 左侧目录改为任意宽度常驻可见（移除窄屏 <code>display:none</code>，窄屏下列表转为顶部可滚动常驻栏），点击章节后目录不再消失；② 移除「内部登录」章节（5.1）及 5.13 登录截图，可达性说明去掉登录；③ 新增 AI 智能补全子章（5.3.2 / 5.4.2 / 5.5.2），附 AI 流式输出终端截图（ai-complete-basic/assets/functions.png）；④ 修复 PDF 导出图片被分页截断（<code>@media print</code> 增加 <code>page-break-inside:avoid</code> 与图片适配）；⑤ 修复 Word 导出无图片（<code>downloadWord</code> 将图片转为 base64 data URI 内嵌）。</td></tr>
     <tr><td>v0.15</td><td>2026-08-19</td><td>wang.yu</td><td>领域方案库列表增强：列顺序调整为「所属领域 → 方案名称 → 版本 → 状态 → 创建人 → 设备/页面/文档 → 操作」，版本/状态列收窄、所属领域/方案名称列加宽；新增筛选栏（查找 方案名称/创建人 + 所属领域下拉 + 状态下拉 + 条数）与可排序列头（所属领域/方案名称/状态/创建人，升降切换带 ▲▼），卡片视图复用同结果。</td></tr>
     <tr><td>v0.14</td><td>2026-08-19</td><td>wang.yu</td><td>左侧目录（TOC）贴齐浏览器最左侧：<code>.doc-layout</code> 取消 <code>margin:0 auto</code> 自动居中（改为 <code>margin:0; padding-left:12px</code>），宽屏下不再左右留白，目录紧贴视口左缘。</td></tr>