📖 使用者层

1. 你能得到什么

• 8 个学习 Tab：⚡ 动态总览 · 概念树 · 主流程时序 · 调用关系 · 流程图 · 交互 · 依赖 · ER · 目录。
• 每图带出处徽章：doc 仓库文档原文（权威）/ code 真实调用关系（权威）/ flow AI 归纳 / curated 规则回退——哪句是抄的、哪句是猜的，一眼分清。
• 文档优先，不白花 token：仓库自带架构文档时，概念/流程/时序直接逐字提取原文，冷启动 0 次 LLM。
• 讲解不换窗口：点「🗣 AI 讲解」，Arch Lens 把带事实依据（职责、核心文件、真实调用边、图源） 的问题发进你当前会话；回答就留在会话历史里——会话记录就是笔记，问答与生成的图全都记得住 （原 ARCH-NOTES.md 笔记面板、📊 学习进度已下线，见 usage）。
• 一键出文档：📄 按钮按 7 章（目录/概念/依赖/时序/流程/ER/交互，认知主干顺序）逐章串行生成，每章只依据 代码事实写正文，先过"幻觉门禁"再落地 docs/architecture-.generated.md；已生成的章节 缓存复用，重复点击只补缺、重试失败章。
• 随问随画：hover 任意调用边/子图可下钻细节图；🎨 动态出图按你的问题现画一张（含讲解概要）， 可保存锁定——保存的图是你的资产，重扫不丢。
• 不多花一分钱：结果全部缓存；重新扫描只更新受影响的部分，没变的图秒回、不重复计费。
• 用量透明：⚡ LLM 面板显示本工作区累计与最近明细（字符/估算/模型实际 token），重启不丢。
• 代码不出机器：扫描与解析全程本地离线，除你已配置的模型调用外无任何网络请求。

2. 安装启用（三步）

1. 克隆本仓库并按 开发者层 › 构建 打出全部包产物；
2. 在仓库根执行 scripts\link-arch-lens.ps1（Windows）或 pwsh scripts/link-arch-lens.ps1（macOS / Linux），把 arch-lens-backend、 client-arch-lens、code-index-tree-sitter 以 link: 依赖挂载进 DSH web profile 的 node_modules（幂等，可重复执行；详见 scripts/scripts.md link-arch-lens 一节）；
3. 执行 scripts\toggle-arch-lens.ps1 -Mode on 写入启用行，再重启 DSH 主服务 + 浏览器硬刷新（Ctrl+F5），在 Web GUI 侧边栏唤出悬浮机器人 → 学习台。

随时停用 / 恢复

脚本只对 DSH profile 的 cordis.patch.yml 做追加 / 变更：缺 arch-lens 行才补、 已有则只翻转 disabled，文件里其它任何配置（mcp-browser 等）原样保留。

脚本命令与参数说明见 scripts/scripts.md（toggle-arch-lens 一节），

3. 界面速查

全局按钮（面板顶部）

按钮	含义	LLM 消耗
提示词	编辑讲解/生成用的提示词套装（保存在工作区，跟随仓库）	0
↻ 重新扫描	只重建事实：重扫代码图与索引，按变动包精确失效受影响的图缓存；不生成任何图	0
⚡ 变动更新	一条链 = 重新扫描 + 智能增量重绘：只补画失效/缺失的图；改完代码后的一键维护	仅失效的图
🔁 全量重建	不重扫，对全部图逐一校验缓存：失效/缺失的重绘、有效的跳过（"全量"指清点范围，不是无条件重绘）	仅失效/缺失的图
⏹ 停止	立即中断所有进行中的 AI 生成	—
📄 一键生成文档	7 章串行生成（见上）；每章独立失败、独立重试，重复点击只补缺	缺失/失效的章

三颗扫描/重建按钮的完整用法（费用语义、中断、常见坑）见 usage.md「三个扫描 / 重建按钮」一节。

📊 学习进度按钮已下线（2026-09）：其数据源是已退役的笔记文件；会话记录本身就是 更完整的笔记。详见 usage.md。

图内交互

操作	含义
🤖 AI 生成（各 Tab）	对当前图不满意？把重画请求发进会话，AI 读码后重画这张图，画完自动回填
🗣 AI 讲解	概念树节点、追问对话框、动态出图行都有——把"讲明白这个"发进会话，答案进笔记；讲解过的组件计入进度
🔬 方法级	时序/交互/流程图切到方法粒度：按真实方法与调用边重新归纳（独立生成，不影响实体级图）
hover 调用边 / 子图标题	浮出 🤖 动态画图——只对这一条边/这一块画细节图
右键节点/边/子图	把该元素的标签送进 🎨 出图输入框，改一改再问
💾 保存当前图	动态出的图连标题、讲解概要一起保存，图号锁定，重扫不失效
✏️ 追问重画	在对话框里对已生成的图追加要求（"把 XX 展开""换成时序"），原图位置更新

每个 Tab 与交互的完整走读见 docs/usage.md。

---