Files
lpt-meta/docs/diagrams/recall-layout/index.html
T

127 lines
9.9 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>自由回忆工作区布局重做</title>
<script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
<style>
body { margin: 0 auto; max-width: 1600px; padding: 24px; background: #fafafa; font-family: "PingFang SC", "Microsoft YaHei", sans-serif; color: #333; }
h1 { font-size: 20px; }
h2 { font-size: 16px; border-left: 4px solid #1a56b0; padding-left: 10px; margin-top: 40px; }
.tip { color: #777; font-size: 13px; line-height: 1.8; }
.legend { font-size: 13px; color: #555; margin: 4px 0 0; }
.legend span { display: inline-block; padding: 1px 8px; border-radius: 4px; margin-right: 6px; border: 1px solid; }
.diagram { background: #fff; border: 1px solid #e0e0e0; border-radius: 8px; padding: 16px; margin: 10px 0; }
.wire { margin: 12px 0 28px; background: #fff; border: 1px solid #e0e0e0; border-radius: 8px; padding: 14px; }
.wire img { display: block; width: 100%; height: auto; }
.wire.narrow img { max-width: 460px; margin: 0 auto; }
figcaption { margin-top: 10px; font-size: 12.5px; color: #666; line-height: 1.7; }
code { font-family: "SF Mono", Menlo, Consolas, monospace; font-size: 12.5px; }
details { background: #fff; border: 1px solid #e0e0e0; border-radius: 6px; padding: 8px 12px; margin: 10px 0; }
summary { cursor: pointer; font-size: 13.5px; color: #1a56b0; }
table { border-collapse: collapse; width: 100%; font-size: 13px; margin-top: 6px; }
th, td { border: 1px solid #e0e0e0; padding: 5px 8px; text-align: left; vertical-align: top; }
th { background: #f4f6f8; }
</style>
</head>
<body>
<h1>自由回忆工作区布局重做</h1>
<p class="tip">图源为同目录 <code>.mmd</code> 纯文本(可直接编辑);改动后需递增下方 <code>?v=</code> 版本号以避开浏览器缓存。<br/>
节点首行的「」为角色(入口 / 取 / 用 / 源 / 说明 / 待拍板)。前两张是链路与投放关系,后三张是界面线框(SVG 图源,同目录)。<br/>
本地预览:在 <code>docs/diagrams</code> 目录执行 <code>python3 -m http.server 8000</code>,再访问
<code>http://localhost:8000/recall-layout/index.html</code>。<br/>
每张图默认<b>只读视图</b>、一眼看全;点「查看」进入交互后 <b>Ctrl+滚轮</b>缩放、<b>右键拖拽</b>平移,<kbd>Esc</kbd> 退出。</p>
<h2>内容与请求链路</h2>
<div class="diagram" data-src="content-flow.mmd?v=2" data-height="fit-content">加载中…</div>
<p class="legend">
<span style="background:#e8f0fe;border-color:#1a56b0">蓝 入口</span>
<span style="background:#e7f6ea;border-color:#2e8b57">绿 取值</span>
<span style="background:#f3f0fb;border-color:#6b4fa0">紫 用途 / 处理</span>
<span style="background:#fff3cd;border-color:#b8860b">橙(虚线)值来源</span>
<span style="background:#f7f7f7;border-color:#999">灰(虚线)说明</span>
</p>
<h2>原文出现时机对比</h2>
<div class="diagram" data-src="reveal-timing.mmd?v=1" data-height="fit-content">加载中…</div>
<p class="legend">
<span style="background:#e8f0fe;border-color:#1a56b0">蓝 入口</span>
<span style="background:#e7f6ea;border-color:#2e8b57">绿 取值</span>
<span style="background:#f3f0fb;border-color:#6b4fa0">紫 用途 / 处理</span>
<span style="background:#fff3cd;border-color:#b8860b">橙(虚线)值来源</span>
<span style="background:#f7f7f7;border-color:#999">灰(虚线)说明</span>
</p>
<h2>界面线框:现状(三栏同时投放)</h2>
<figure class="wire">
<img src="current-desktop.svg?v=2" alt="自由回忆工作区现状线框">
<figcaption>左栏常驻碎片正文预览与学习报告摘要,右侧只有请求表单,记录被拆到三栏之下,侧栏另带滚动条。红色 1–5 对应五条问题。</figcaption>
</figure>
<h2>界面线框:目标(整页)</h2>
<figure class="wire">
<img src="target-desktop.svg?v=6" alt="目标布局线框:导图铺满整屏,页头与辅助区、状态条都是浮层">
<figcaption>导图铺满整个视口、页面本身不滚动;页头半透明浮在导图上,提示与查漏浮在右上可收成标题条,左下状态条(范围 + 状态 + 计时 + 操作)也能收成一行摘要。这张画的是抽屉外壳与位置;抽屉内部怎么组织见下一节。</figcaption>
</figure>
<h2>「提示与查漏」抽屉:现状问题与四个备选</h2>
<p class="tip">现状抽屉把三段都会长高的内容塞进同一个 380px 滚动轴:请求次数(无上界)、每次请求的条目(提示树 / 查漏解释 / 引文 / 分析范围)、相关碎片列表与分页。
条目一多,抽屉里就变成「什么都有一点、什么都看不全」。下面四张线框是四套结构调整,桌面宽度、改造量与代价各不相同,按真实文案绘制(<code>.svg</code> 为图源,可编辑)。</p>
<details open>
<summary>现状的五个具体问题(对应 <code>RecallWorkspace.vue</code> 的 <code>.help-drawer</code>)</summary>
<ol style="font-size:13px;line-height:1.9;color:#444;margin:8px 0 0 -8px">
<li><code>&lt;details&gt;</code> 套 <code>&lt;details&gt;</code>(请求一层、分析范围再一层),展开一条就把其余全部推走,滚动位置跟着跳。</li>
<li>提示默认模糊,4 条提示要点 4 次「显示内容」;没有一次铺开的入口。</li>
<li>「相关碎片」排在结果下面,请求一多就永远要滚到底才看得到,还带自己的分页。</li>
<li>顶部常驻三行说明(提示形式、尚未完成查漏、提示默认模糊…),和条目抢高度。</li>
<li>窄屏下抽屉变成 62dvh 的贴底抽屉,同样三段内容挤在更小的高度里。</li>
</ol>
</details>
<figure class="wire">
<img src="option-a-tabs.svg?v=1" alt="方案 A 线框:顶部固定操作区 + 结果/相关碎片两个页签 + 请求 chip 条">
<figcaption><b>方案 A|页签 + 请求条</b>:操作区固定在标题下不滚动;结果与相关碎片分页签;结果里只渲染选中的那一次请求。宽度不变,改动集中在抽屉内部状态。</figcaption>
</figure>
<figure class="wire">
<img src="option-b-inbox.svg?v=1" alt="方案 B 线框:左请求索引、右选中详情的两栏收件箱">
<figcaption><b>方案 B|两栏收件箱</b>:左列是「本次请求」索引,右列只渲染选中的一条;相关碎片成为左列固定项。桌面加宽到约 560px,窄屏退化成「列表 → 详情」推入式底抽屉。</figcaption>
</figure>
<figure class="wire">
<img src="option-c-one-line.svg?v=1" alt="方案 C 线框:每层一行摘要 + 单开,相关碎片放固定底栏">
<figcaption><b>方案 C|一行摘要 + 单开</b>:宽度不变;请求与条目先给一行摘要,展开一条自动收起上一条;相关碎片移到固定底栏,点开走已有的「原文」对话框。代价是读完整内容多一次点击。</figcaption>
</figure>
<figure class="wire">
<img src="option-d-fullscreen.svg?v=2" alt="方案 D 线框:抽屉可放大成左时间线、中结果、右碎片的三栏视图">
<figcaption><b>方案 D|放大成三栏阅读(已采用)</b>:日常仍是 380px 抽屉且只渲染最近一次;需要精读时点「放大」,三栏铺满视口,各列独立滚动。标题仍叫「提示与查漏」——铺满视口与「返回导图」本身已经说明处于另一种形态,不再用文字复述。</figcaption>
</figure>
<table>
<tr><th>方案</th><th>结构</th><th>桌面宽度</th><th>改造量</th><th>失去什么</th></tr>
<tr><td>A 页签 + 请求条</td><td>固定操作区 + 结果/碎片两页签 + 请求 chip 条</td><td>380(不变)</td><td>小:加页签状态与选中请求</td><td>一次只看一条历史结果</td></tr>
<tr><td>B 两栏收件箱</td><td>左请求索引 / 右选中详情;碎片为左列固定项</td><td>约 560</td><td>中:加宽 + 两栏 + 窄屏推入式</td><td>遮住更多导图;窄屏多一层返回</td></tr>
<tr><td>C 一行摘要 + 单开</td><td>每层先一行,单开;碎片进固定底栏</td><td>380(不变)</td><td>小到中:条目改行 + 单开 + 底栏</td><td>读全文多一次点击;碎片进弹窗</td></tr>
<tr><td>D 放大成三栏阅读</td><td>抽屉只留最近一次,放大后左时间线 / 中结果 / 右碎片</td><td>380 / 全屏</td><td>大:新布局 + 焦点管理 + 窄屏页</td><td>放大时看不到导图</td></tr>
</table>
<p class="tip"><b>待拍板</b>:① 选哪一套(或组合,如 A 的页签 + C 的单开);② 抽屉能否超过 380(方案 B 的前提);③ 相关碎片留在抽屉内,还是改成固定底栏 / 弹窗入口;
④ 「全部显示」是否需要——它和「提示默认模糊、不主动铺开内容」的口径存在张力。</p>
<h2>界面线框:目标(相关碎片三态)</h2>
<figure class="wire">
<img src="target-materials.svg?v=4" alt="相关碎片三态线框:收起、展开原文开头、查看全文">
<figcaption>没有新的页面或阶段:同一块相关碎片区,默认只给标题与角色,点开才显示原文开头,点「查看全文」读全文;学习报告与应用场景不进入复习参考资料。</figcaption>
</figure>
<h2>界面线框:目标(375px 窄屏)</h2>
<figure class="wire narrow">
<img src="target-narrow.svg?v=8" alt="375px 窄屏线框:页头压成一行、导图铺满、状态条与辅助区都可收起">
<figcaption>导图铺满整屏;页头在窄屏压成一行(返回 / 标题 / 两个图标入口),左下状态条与辅助区都能收成一行摘要。计时问号跟在「有效时间」的值后面,不再单独占一列。</figcaption>
</figure>
<script src="../viewer.js?v=2"></script>
<script>MermaidViewer.init();</script>
</body>
</html>