v0.7.0

本版本以工作区引用索引为主线：双链与文件引用统一为根内相对路径解析，新增反链面板与出链面板、索引持续维护（增量更新、排除模式、清理与完整重建）、更名/移动（单文件与文件夹/批量）引用自动更新，以及文件图片定期刷新与删除态提示；同时 Markdown 图片获得弹窗放大查看与防误触交互，编辑器顶栏新增「刷新嵌入资源」按钮，表格数据行背景透明到编辑器背景。

新增

• 图片弹窗查看与防误触：Markdown 图片接入与图表代码块同款的查看交互——鼠标悬停图片（加载成功后）右上角浮现按钮组：实时预览侧为「编辑源码」与「放大查看」两枚（编辑把光标落到图片源码起点并显示源文，放大打开全屏弹窗），阅读模式仅「放大查看」一枚；点击图片本体不再跳转源码（防误触），错误占位仍保持点击重试。弹窗内可滚轮/键盘缩放、拖拽平移、快捷键 0 重置、Esc/点击空白/背板关闭；工具条「刷新」按当前文档重新定位该图并重载（图片被移动后仍能追到，被删除则维持当前画面），「导出」把原图以原格式另存副本（保存对话框自选位置；http(s) 外链图禁用导出）；顶部工具栏的「刷新嵌入资源」联动弹窗内同图重载。链接内嵌图片（[![a](i)](url)）不接按钮组，点击仍跳链接；表格网格内图片暂不接。全程零写回。（#212）
• 出链面板：右侧栏新增「当前笔记中的链接」面板（与大纲/反链三面板互斥切换，双模式可用）——平铺列出当前笔记的全部出链（目标名 + 路径两行；双链、普通链接、图片与引用式定义四类），按命中优先与目标名稳定排序；点击条目打开目标文档并按该链接的实际锚点定位（[[笔记#标题]] 落到该标题，无锚点落文档顶），图片附件经系统预览器打开；断链条目整体弱化且不可点；https 等外部链接不进面板。未保存编辑约半秒即时反映；「显示或隐藏出链面板」已登记为可绑定操作（默认未绑定）。
• 反链面板与工作区引用索引：右侧栏新增「反向链接」面板（与大纲面板互斥切换，实时预览与阅读模式均可用）——显示当前笔记被哪些文档引用（来源文件与行号、引用片段），按来源路径与位置稳定排序，点击条目打开来源文档并定位到引用处。背后是持久化的工作区引用索引：启动时扫描各工作区根的 Markdown（双链、普通链接、图片、引用式定义四类引用；代码块与行内代码内的字面量不计），索引缓存在扩展私有工作区存储中按根分区（重启即恢复，不写笔记目录、Remote SSH 存宿主侧）；未保存的编辑约半秒后即时反映到反链（仅内存，不写盘）；文件保存与外部修改自动重扫；被引用的图片等任意类型附件仅登记目标与被引用关系。多工作区根各自独立（跨根引用不解析、嵌套根按最具体根归属）；断链与未命中引用保留显示；面板区分加载中/无引用/更新中/读取失败四态。「显示或隐藏反链面板」已登记为可绑定操作（默认未绑定，可在设置页快捷键分页绑定）；索引条目同时采集文件创建时间（Windows 可得，Linux/远程常不可得——按创建时间排序时未知沉底）。（#197）
• 索引维护：增量更新、排除模式与完整重建：引用索引在编辑与文件事件中持续自愈——未保存编辑停止约半秒更新反链、连续输入至多约两秒强制合并一次；保存与外部文件事件进入有界队列逐批处理（批量 Git 切换等大量变更自动降级为一次清单核验，不堆积任务）；启动、窗口焦点回归与活跃期每约十分钟按 mtime+size 清单比对补漏（远程断连或权限错误只标记待核、绝不误判为删除）；工作区根增删（含嵌套根）自动重算覆盖范围。设置页新增「索引维护」分页：排除模式列表编辑/保存/恢复默认（默认 **/.git/** 与 **/node_modules/**，按工作区独立持久化；不继承 VSCode 搜索排除与 .gitignore；被笔记显式引用的排除位置目标仍可解析），清理当前工作区缓存（安全回收过期代际，不动活跃数据）与完整重建（重新解析全部正文并核验资源，带进度显示、可取消、失败有反馈）两项操作；两条命令同时注册到命令面板（默认未绑定键位）。嵌套工作区根的归属边界随本批加固：父根不再解析或登记属于子根的文件。（#198）
• 更名或移动文件时自动更新引用：在 VSCode 内（资源管理器、命令面板或「移到新位置」）重命名或移动 Markdown 文件与图片等附件时，指向它的双链、普通链接、图片与引用式定义按新位置自动重算相对路径——别名、标题/块锚点、URL 编码与无关正文原样保留；省略扩展名的双链维持省略、显式扩展名（.pdf/.png 等）保持完整；移动 Markdown 自身时它的相对出链也按新目录重算。改写随更名一并应用（一步撤销可整体恢复），已打开面板实时同步；未保存内容受保护：区间与索引对不上时跳过该文档并明确告知，绝不覆盖未保存文本。跨工作区根的移动不生成跨根相对引用（跳过并在通知中说明）；索引未就绪时明确提示本次未更新（可稍后从设置页重建索引再手动修正），不静默部分成功。区分「已更新 N 处」「部分跳过」「未更新」三类合并通知；外部工具（非 VSCode）改名只刷新索引、不改写链接。（#199）
• 文件夹与多文件移动的引用更新：重命名或移动整个文件夹（含嵌套子目录与内部附件）、以及一次选中多个文件移动时，同样自动更新引用——整批按「旧→新路径映射」一次规划：外部引用者批量改写（一步撤销整体恢复），文件夹内文档之间的互链因相对关系不变而保持原样（不产生无谓改动），移动到不同深度后指向外部的出链按新位置重算；被引用的图片随文件夹移动时引用同步改写。批量操作合并为一条通知；部分引用因越界等原因未更新时，通知附「未更新项」清单（文件名与原因），不伪报全部成功。（#200）
• 图片定期刷新与删除后找不到状态：工作区图片修改后自动刷新、删除后明确提示——磁盘上的图片文件被覆盖保存或删除时，已打开文档中的图片在约半秒内自动失效重载（新内容直接替换呈现，无需关闭重开面板），删除的图片撤下旧图并显示「找不到」错误态（点击可重试）；远程 SSH 断连或权限错误显示「暂不可访问」（黄色提示，不冒充删除），连接恢复后自动恢复显示。机制：失效刷新由宿主自己的图片文件监视器与周期核验驱动——监视器监听工作区图片文件变化即时失效，已挂载图片每约 30 秒合并核验一次兜底（无活跃图片不计时、面板恢复可见立即核验）；引用索引的文件事件目前只覆盖 Markdown 文档，不驱动图片刷新（未来索引扩展到非 Markdown 目标后自动接通）。图片地址附带版本代次（?v=）击穿 webview 资源缓存，未变化的图片不重复读取。公开样式契约新增失败态细分类 vsidian-image-notfound / vsidian-image-unreachable（叠加在既有错误态上，可被 CSS 片段命中）。HTTP(S) 直连外链图片不纳入自动刷新（保持现状）；整个链路零写回（不改动 Markdown 与保存状态）。（#201）
• 工具栏刷新按钮（嵌入资源手动刷新）：编辑器顶栏右端组（双态切换左侧）新增「刷新嵌入资源」按钮——外部程序替换磁盘上的同名图片后，编辑器常继续显示旧图（图片缓存不感知磁盘变化），点一下刷新立即重新装载显示新图（视口内图片短暂重载闪动属预期）；Mermaid 图表懒加载失败后的「本会话不再重试」终态一并重置，再点刷新恢复重新注入。刷新是纯视图操作：光标/选区、滚动位置、三态视图模式与查找会话全部保持，不改文档内容、不产生撤销记录、文件不 dirty；仅作用于当前文档面板。配套命令面板「Vsidian: 刷新嵌入资源」，可绑定快捷键（实时预览与阅读双模式生效，默认未绑定，可在设置页绑定）。（#208）

改进

• 表格数据行背景透明：实时预览的表格数据行与分隔线行不再铺灰色底色，背景透明到编辑器背景（与阅读模式一致），表格结构感由单元格边框与表头行保留（表头底色不变）；frontmatter 标题栏底色不受影响。CSS 片段可通过新公开变量 --vsidian-table-row-background 恢复数据行底色，--table-background / --vsidian-table-background 继续控制表头格、阅读表头与 frontmatter 标题栏。（#213）
• 反链面板形态改版：反链面板重做为分组卡片形态——按来源文件分组（组头显示来源名与计数，可折叠），组内每条引用是一张上下文卡片，卡片内命中链接的原始 Markdown 语法整体黄底高亮（明暗主题各一档可读黄）；面板顶部新增工具栏：排序（文件名 A-Z/Z-A、编辑时间从新到旧/从旧到新、创建时间从新到旧/从旧到新六项三组下拉，当前项勾选）、搜索（匹配来源文件名与片段文本、不区分大小写，无匹配有占位提示）、折叠全部/全部展开与更多上下文（引用行 ±2 行的长片段切换）；排序与折叠状态不持久化（面板重载回到默认）。侧栏反链图标换为链环 + 左折返箭头造型；设置页「索引维护」分页图标同步换为链环。
• 双链与文件引用统一为根内相对路径解析：双链目标只按来源文档所在目录解析——[[笔记]] 即同目录的 笔记.md、[[目录/笔记]] 为明确子路径、[[../笔记]] 允许在工作区根内上行，越出所属根直接拦截并提示；此前的工作区内按文件名全局搜索（子目录或其他工作区根的同名文件也会命中）、根目录路径兜底与「找到多个目标」的选择弹窗均已移除，多个工作区根互不补查（嵌套工作区按文档实际所属的最具体根划界）。普通链接与图片的解析口径不变（同样基于来源目录；显式 .pdf/.png 等扩展名不会被补成 .md）；别名、标题/块锚点、本文件锚点、URL 编码与宿主大小写语义保持。兼容性变化：旧笔记中依赖跨目录短名命中的双链（如子目录文档里的 [[根目录笔记]]）跳转时将提示目标不存在，正文不会被自动改写——请改用明确相对路径（[[../根目录笔记]]）；QuickPick 同名候选选择随短名搜索一并废除，不再出现「找到多个目标」弹窗。（#196）

修复

• 图片悬停按钮组底色不再透出图片颜色：悬停图片/按钮时，按钮底色此前取 VSCode 主题变量（部分主题为半透明色），按钮又直接浮在图片上，半透明底色把斑驳的图片颜色透了进来；现按钮面改为「主题色 + 编辑器底实色」双层合成，任何主题下都不透底（主题值为实色时观感不变）。图表代码块的按钮组同款受益。（#212）
• 图片禁用浏览器原生拖拽（弹窗与正文）：图片弹窗内与正文（实时预览/阅读）中的图片，按住拖动此前会触发浏览器原生拖拽——半透明缩略图跟随鼠标、Windows 侧右下角带「复制」加号徽标，还会吞掉弹窗内的拖拽平移手势；现全部禁用，按住拖动只走既有交互（弹窗平移视图），不再出现拖拽缩略图。（#212）
• 独立成行图片的悬停按钮组贴齐图片右上角：实时预览与阅读中整行单独一张图片时，若图片比正文列窄（如小尺寸截图），悬停浮现的按钮组此前贴在整行右缘、远离图片；现此类图片的容器收缩到图片实际宽度，按钮组贴图片右上角。无固有尺寸的 SVG（mermaid 导出形态）与被列宽钳制的大图不受影响（本就铺满整行，按钮位置不变，且前者的铺满基准是其防塌缩语义，已守恒验证）。（#212）
• 阅读视图限宽档下标题与正文左缘对齐：可读行宽为非 0 档时，阅读视图的标题块此前不随正文列居中——H1–H6 贴容器左缘，段落、引用等其余块在限宽列内水平居中，标题与正文左缘错开（偏移量为内容区与限宽差值的一半，如限宽 920px 的窗口下约 78px）；铺满档（0 = 默认）不受影响。根因是标题规则的水平 margin 简写覆盖了 #175 的块级居中声明；现标题垂直间距改走 margin-block，限宽档下标题与正文同列居中，垂直间距不变。（#206）
• 实时预览独立成行图片空白（mermaid 导出 SVG）：实时预览中整行仅含一张图片时，若图源是无固有尺寸的 SVG（mermaid 导出的典型形态：width="100%"、无 height、仅 viewBox），此前渲染为静默空白行——图片实际加载成功，只是行内收缩布局（inline-block shrink-to-fit）把它解析成 0×0，因此无任何报错；阅读模式则正常显示。现此类独立成行图片改用块级布局（新增公开样式类 vsidian-image-block，叠加于 vsidian-image），铺满正文列宽度（受「可读行宽」设置与 CSS 片段约束，与阅读模式同口径）；有固有尺寸的图片（PNG/JPG 等）不受影响，仍按自然宽度呈现。已知边界：与文字混排在同一行内的此类 SVG 仍为行内形态（可能仍不可见，如需支持另行开票）。

v0.6.0

本版本以交互入口与跳转链路为主线：实时预览正文右键全域接管统一自绘菜单，双链锚点跳转、复制块链接与图片粘贴补齐「链接与插入」闭环，新增可读行宽与代码块折行等阅读体验设置，表格选区交互多处对齐预期。

新增

• 统一右键菜单（实时预览正文全域接管）：实时预览正文的右键菜单从「仅块链接两项」升级为统一自绘菜单，并在全正文域接管——空行、普通文本、选区、表格行、围栏代码内、图形块上右键均弹出自家菜单（此前这些位置弹的是浏览器原生菜单，反而丢失剪切/复制等基础功能）。菜单按 Obsidian 蓝本分三簇：链接（新增 [[双链]]、新增外部链接、复制标题链接、复制块链接）、块与格式（文本格式/段落设置/插入三个级联子菜单，覆盖粗体斜体到标题六级、列表、表格、数学块等全部格式操作）、剪贴板（剪切/复制/粘贴/全选——剪切/复制/粘贴经宿主剪贴板桥真实读写，全选为纯选区事务；提示列显示当前快捷键）。结构敏感区安全降级：表格单元格、围栏代码、图形块上的写操作整簇置灰（保留可发现性），块链接与剪贴板仍可用；frontmatter 头区与阅读模式不接管（原生菜单照常）。菜单项右侧显示快捷键提示（小字弱化，未绑定不占位）；菜单图标已接线 26 枚明暗主题资产（段落设置 H1–H6 档用文字徽标不经生图，备用 key 资产在场暂不接线）。菜单支持键盘操作（方向键移动与进出子菜单、Enter/Space 执行、Esc 关闭）；段落设置子菜单按光标所在行的当前结构勾选，条目按「列表／标题／引用」分子组呈现。顺带修复：带 frontmatter 文档上「全选」/Ctrl+A 被头区光标引导误弹回正文起点的既存缺陷（引导口径收窄为「选区完全落入头区」）。（#183）
• 双链锚点跳转（块引用定位与本文件锚点）：[[笔记#^块id]] 单击不再只打开目标文件——跳转落到目标块首行（块 id 双形态：块后空一行的独立行 ^id 或块内末行行尾的 ^id 标记，独立行归属其上方块；围栏代码块内的字面标记不算，闭围栏行行尾标记算围栏块自身的 id）；[[#标题]]、[[#^块id]] 本文件锚点省略笔记名即可页内跳转（可带别名，显示文字默认锚点原文、别名优先）。跳转落位与标题跳转同款（本扩展面板内定位 / 文本编辑器 selection reveal）；标题或块 id 在目标文档中不存在时打开文档后给出提示。非法形态（[[#]] 空锚点、空或越集块 ID 等）维持原文降级。（#159；#163 验收反馈增补独立行形态）
• 复制块链接（右键菜单与快捷键）：实时预览正文右键任意块即可取得链接——标题行提供「复制标题链接」（[[笔记名#标题]]）与「复制块链接」（[[笔记名#^块id]]）两项，普通块（段落、列表、引用、表格、代码块）提供「复制块链接」；目标块还没有块 id 时自动在块尾行后空一行写入独立行 ^id（6 位随机 id，Obsidian 默认形态；与全文已有 id 查重，一笔可撤销编辑）后再复制。手写的块 id 两形态都识别与复用：块后独立行 ^id（归属上方块）或块内末行行尾的 ^id。块 id 标记在实时预览淡化呈现（正文前景 45% 混入——适配自定义字体颜色与明暗主题）、阅读模式隐藏。快捷键 Ctrl+Shift+C 对光标所在块执行同款复制（光标在标题行等价复制标题链接），可在设置页改绑或清空（仅实时预览正文生效）。边界：表格右键按表格整块；frontmatter 头区与阅读模式不接管右键与快捷键。（#162；写入形态对齐 Obsidian 与标记淡化/隐藏为 #163 验收反馈修正）
• 跳转目标高亮：双链/普通链接锚点跳转（[[笔记#^块id]]、[[#标题]]、[文字](文件.md#锚点) 单击）后，目标标题或段落整体覆盖半透黄提示，用户任意操作（点击、滚动、按键、切换页面）后消失。高亮颜色经 CSS 变量 --vsidian-anchor-flash-background 暴露，可在 CSS 片段中覆盖；实时预览与阅读模式同款。（#163 验收反馈）
• 图片粘贴插入与资产文件夹设置：实时预览中 Ctrl+V 粘贴剪贴板图片自动落盘并在光标处插入标准图片引用——截图生成 Pasted image 时间戳.png（Obsidian 默认风格）、复制文件沿用原名（Windows 非法字符清洗、重名 -1 递增、全非法字符回退时间戳）；新增三项设置：粘贴图片插入总开关（默认开）、图片存放位置（同目录 / 相对工作区根 / 相对当前文件，默认同目录）与图片存放子路径（默认 assets，后两种模式生效；绝对路径与 .. 越界被拒并通知，无工作区时回退同目录并提示）；子目录不存在自动递归创建；插入一步可撤销（落盘文件保留）；失败以通知反馈、不插文本；阅读模式与设置页输入不接管，IME 组合期间放行默认粘贴。（#161）
• 可读行宽设置（滑块，双模式）：设置页新增「可读行宽」滑块（0–1600px 步进 20，0 = 铺满为默认档），同时约束实时预览与阅读模式的正文列宽——可用宽度不足时自动收缩避让右侧大纲栏，正文列在主编辑区水平居中、随侧栏开合实时跟随；Live 行号列随正文列一起居中，表格、代码块卡片等宽内容同列限宽。CSS 片段可分别单独覆盖两模式（Obsidian 别名 --file-line-width 同接两变量；按视图作用域声明的片段常规规则即可生效，根级覆盖需 !important）。（#175）
• 代码块折行开关（阅读视图）：阅读视图卡片 head 的复制钮左侧新增折行开关，点击联动全文代码块（含大围栏分片）同时切换；关闭折行后卡片代码区出横向滚动条、行号列与头部钉住不随滚动，再点恢复折行；视图态默认折行、重开文档恢复默认；实时预览恒折行、不放此开关（编辑器级折行约束）。按钮提示显示将触发的动作（开启/关闭自动折行）。（#191）
• 设置页分组重组与图片粘贴防呆：设置页保持常规 / 编辑器两个侧栏分组，分类改为在编辑器页内以组内标题小节呈现——「显示 / 符号输入 / 代码块 / 图片」四小节按设置键前缀归节（键名不变，已存设置值零迁移）；图片存放子路径在「与当前文件同目录」模式下灰化不可编辑（仅后两种模式生效，值不清除），总开关关闭时整组级联灰化；图片粘贴的剪贴板文件名为 URL 编码形态（如从浏览器复制的中文文件名）时先解码再清洗，不再把编码串原样落盘。（#163 验收反馈）

改进

• 代码块卡片观感与 head 按钮交互：Live 编辑态的围栏符号（```）与代码文本列严格同 x 对齐（缩进按块的行号列宽计算，卡内行号关闭时归零；代码正文与行号列位置不动）；卡内行号左缘留 8px 离卡片边、数字与代码间距 16px（列总占不变，代码列与围栏对齐零位移）；卡片 head 按钮区调整为 [折行（阅读）] [复制] [折叠]——折叠钮固定最右，收起/展开按钮位置恒定，鼠标不挪可连续开合；复制/折行按钮的显现触发区从头部横带扩大为整个卡片（进入卡片即显、离开即隐，折叠钮保持常驻）；整条头部横带可点击折叠（按钮本身除外），实时预览与阅读视图一致。（#189/#190）
• 代码语法配色对齐 VSCode 明暗主题：卡片语法高亮的 tok-* 共享色板按用户 VSCode 主题导出逐词取色（明 / 暗 / 暗高对比三档自动跟随），函数与属性形式调用改用暖黄（浅色 #806000、深色 #DCDCAA）与紫色关键词相配；全部已注册语言复用同一类别配色，用户 CSS 片段仍可按 tok-* 类覆写。（2026-09-28 主题批次）
• 工具栏双态切换按钮移至右端组：阅读/Live 双态切换按钮从左侧按钮组移至工具栏右端、侧栏开关左侧——与侧栏开关紧挨组成右端组，与左侧（设置、快速操作）之间以弹性空隙分隔；按钮功能与 Ctrl+Q 快捷键不变（DOM 顺序未动，仅样式推右）。（#158）
• 跨文件跳转统一面板并记住标签视口：双链与普通链接的跨文件跳转统一在本扩展面板打开目标（不再与同文档的源码标签并存），定位等待面板就绪后落位；标签的滚动位置、阅读/Live 模式与光标位置分别被记住，切回或重开文档时恢复离开时的位置——图表渲染完成重排后按源码行落位，视口不再漂移；此前页内跳转/查找跳转后再做跨文件跳转、切回源文档时视口被拉回旧的程序性定位点的缺陷一并修复（定位改为送达确认制，重载不再重播历史定位）。（PR #163 批次）
• 样式参考条目英文文案：设置页「样式参考」的全部条目（正文域与界面域）补齐英文平行文案——界面语言为 English 时条目卡片显示英文，未覆盖字段回退中文基准；契约 JSON 导出与离线 HTML 指南维持中文单语。（#178–#181）

修复

• 大纲右键菜单子菜单溢出：大纲面板停靠在窗口右侧时，右键菜单的级联子菜单此前只会向右展开、溢出屏幕；现右缘放不下自动翻到左侧展开。菜单同时迁移到统一菜单内核装配（外观与行为不变），父项点击也可展开子菜单（悬停展开为主通道）。（#183）
• 长代码行折行续行窜入卡内行号区：折行态下超长代码行的续行此前退到卡片左缘（x=0）、与卡内行号列重叠；现以悬挂缩进对齐——首行完全原位（行号与文本列位置不变），续行对齐代码文本列，实时预览与阅读视图同修；卡内行号关闭的块无变化。（#191）
• 阅读模式正文隐形限宽：阅读正文此前被固定 760px 钳制且贴左（宽窗口右侧留大片空白），产品内无任何设置可调、只有 CSS 片段能覆盖，且与 Live 铺满行为不一致；现默认铺满可用宽度并在主编辑区居中，限宽能力由「可读行宽」设置提供。（#174）
• 表格拖选蒙版与进行中选区叠显：跨格拖选进行中，格内文字不再叠显原生蓝色线性选区（此前与格区高亮叠加、脱手才消失）；从首格竖向拉满一列再横向拉到整表时，该列拖选蒙版不再中途消失直到松手。（PR #167、PR #173）
• 表格空行与空内容格的编辑语义：点击空行的首格（光标落在透明填充空白上）按退格恢复「删除该行」（此前无反应）；空内容格的填充空格对用户彻底透明——退格不再逐个删除、方向键一步切到相邻格、纯空白键入/粘贴被拒（此前方向键可逐位经过、暴露隐藏空格）。（PR #167）
• 格区复制产物粘回表格格区：跨格复制的表格产物（自动补表头的独立表格）粘贴到另一表格的格区内时，不再被当纯文本整段塞进左上格——现剥去自动补的表头包装、按选区矩形扩表容纳，粘贴不删除行列。（PR #173）

v0.5.0

本版本以样式体系与编辑手感为主线：公开样式契约与 CSS 片段体系落地，frontmatter 属性表格、HTML 注释与阅读/Live 双态切换等编辑能力补齐，链接目标、撤销分段与撤销竞态对齐预期，设置页全面视觉刷新。

改进

• 块引用双链渲染为链接：[[笔记#^块ID]]（Obsidian #^ 标准形态，含 [[目录/笔记#^id|别名]] 组合）不再按原文降级——live 与阅读双视图均渲染为双链，无别名时显示 路径#^块ID、别名优先；单击打开目标文件（块级定位滚动属后续版本）。降级边界同步明确：路径裸含 ^、标题文本含 ^、空或含非拉丁字符的块 ID 仍按原文显示。（#154 验收反馈）
• 撤销分段改为时间停顿驱动：一次 Ctrl+Z 撤掉的单位从此可预期——连续输入（含中文 IME）停顿约半秒、或主动移动光标（点击、方向键）后，后续输入自动开新撤销段，每段一次撤销；连续快速输入仍合并为一次撤销（与 VSCode 原生手感对齐）。此前撤销粒度跟随网络往返节奏攒批，中文输入常一次撤掉远超预期的长段。IME 组合期间不拆段（一次候选提交始终是一个整体），传输合并不变（不增加保存流量）。（#153）
• 设置页视觉刷新：独立滚动与分组容器：设置页左右两列改为各自独立的滚动容器（滚动正文不再把侧栏导航带出视野，两侧滚动条互不带动），全部设置分页统一「分组容器」观感——条目按组聚合为圆角容器、以随主题自适应的色差底强调（替代分割线平铺），布尔设置项由复选框换为纯 CSS 拨动开关（键盘可达与存储语义不变）。快捷键分页对齐 Obsidian：顶部改为单搜索框＋键盘图标切换「按按键筛选」，新增筛选签（冲突带实时计数/全部/已分配/由我分配/未分配），每个操作单行呈现（键位牌居右），点「＋」后原位变「✓」并就地录制键位（支持单段或两段，Enter/✓ 提交、Esc/失焦取消），「清空绑定/恢复默认」收进行内 ⋯ 菜单；全局搜索定位行为与键位数据、存储、冲突判定语义不变。设置项支持依赖灰化（注册表驱动）：依赖关闭时子设置项自动禁用并灰化、重新开启自动解灰且子项值保留（如「卡内行号」「复制按钮」依附「代码块卡片」开关），新增依赖项只需在设置定义上登记。样式参考分页顶部新增「样式参考 / 详细查询」总分页签（总表与查询分栏两态切换，全局搜索定位条目时自动落入详细查询），详细查询内类目栏与条目列表各自独立滚动、过滤搜索工具行固定不随内容滚走（切回总表页签恢复整块滚动）；CSS 片段分页的远程缓存说明与样式参考的别名兼容要点统一为左侧强调条加色底的说明框形态。（#155）
• Live 表格列宽按内容比例分配：表格网格列宽不再强制等分——逐列按内容宽度比例分配（设最小列宽下限），小列小宽、大列大宽，观感与阅读模式一致；GFM 对齐标记（:-:）在实时预览侧逐列生效（此前仅阅读侧呈现）。（#142）
• 引用块紫色提示竖条：两侧引用块左缘竖条由 VSCode 灰调主题色升级为明显的 accent 紫（亮暗主题各一档），新增公开 CSS 变量 --vsidian-quote-bar-color 供 CSS 片段覆写。（#143）
• 样式契约门禁接入 CI 与发布链路（维护者面）：CI 新增独立 style-contract 检查——先从 git 历史锚定复验历史基线未被候选分支篡改（排在契约检查之前），再运行历史契约兼容全量检查（基线比较、指南一致性、弃用期限与发布记录交叉验证），检查器与基线文件的变更同时暴露在 PR 摘要中供独立审查，检查报告无论成败均作为构建产物保留；发布工作流在打包发布前对同一候选产物执行同一复验链，失败即中止发布。附带可重复的负向演示脚本（node scripts/demoStyleContractGate.mjs）证明删除公开入口或篡改历史基线都会被拦截、恢复后通过。远端分支保护的必需检查名单尚待维护者授权更新（操作步骤见 docs/specs/style-contract-gate.md）。（#135）
• 公开样式契约的兼容保护工具（维护者面）：新增历史契约检查器 npm run check:stylecontract——以独立历史基线（v0.4.0 已发布契约的固化快照）对照当前清单，拦截公开入口被删除、降级或收回 Obsidian 原名承诺，自动校验弃用/移除期限（实际发布版本 + 替代写法、两个后续次版本且满 30 天；改日期、跳版本号不能绕过），并核对指南产物与别名桥实现的一致性；npm run check:stylecontract:baseline 可从 git 历史复验基线未被篡改。集成测试新增「历史基线旧片段渲染验证」：用 v0.4.0 时代承诺的写法生成真实 CSS 片段，在当前实现的编辑器里逐项验证可见效果。本工具为本地检查与 CI 门禁准备，自动拦截合并待后续版本接入。（#134）
• 语法高亮与大纲层级色可被用户片段覆写：内置 tok-* 色板与大纲层级色规则改经 :where() 零特异性书写——用户片段以裸 .tok-keyword、.vsidian-outline-level-2 等单类选择器即可覆盖内置配色（此前 #app 前缀的特异性会压过片段规则，属公开入口核实中发现的偏差）；大纲层级色与正文标题的 --vsidian-heading-color-{1..6} 三侧同源关系不变。（#133）

新增

• 普通链接与图片的目标可含空格：[文本](我的 文件.md)、![图](某 目录/图.png) 这类目标含空格的普通链接与图片此前在实时预览与阅读视图均显示裸源码；现正常渲染并可点击跳转、装载图片。标准写法（<> 尖括号包裹、%20 编码）与无空格目标的既有行为不变；双链 [[…]]（含空格形态）不受影响。（#152）
• YAML frontmatter 属性表格（只读卡片 + Popover 编辑）：文档头的 YAML frontmatter 在实时预览成型为只读键值两列表格卡片——顶部标题栏（图标 + Properties + 右上角「修改」按钮），点击「修改」弹出贴按钮的编辑浮层，浮层内完成键值对的增删改与字符串数组（tags 一类）的增删项，底部「添加属性」按钮新增键值对；文本输入即时写回、按钮操作单笔写回，撤销与保存行为不变（每笔操作 = 一次撤销）。成型态不再暴露源码：光标进入头区自动落到卡片之后，源码仅在头区非法（含嵌套等复杂类型）时降级出现、可编辑，修复后自动回表格；阅读模式渲染同款只读表格（含标题栏、无按钮）。样式对齐 Obsidian 属性面板方向（完整边框圆角卡片、键列常规字重灰、无格线；浮层白底圆角投影 + 主题主色按钮）。（#140）
• HTML 注释快捷键与双视图呈现：实时预览中 Ctrl+/ 一键包裹或取消 <!-- --> 注释——有选区包裹选区、无选区插入空对（光标落开围栏内侧），两态切换；注释在实时预览淡化呈现、阅读模式完全隐藏；代码块与行内代码内的字面 <!-- 不受影响；快捷键可在设置页改绑（仅实时预览正文生效）。（#139）
• 编辑器顶栏双态切换按钮与 Ctrl+Q 快捷键：编辑器顶栏右侧（侧栏按钮左侧）新增「阅读/Live」单按钮切换，图标随当前模式变化、不涉及源码模式；配套可绑定快捷键 Ctrl+Q（双模式生效，可改绑），与右上角三态按钮及模式记忆语义一致。（#141）
• 样式参考小类分栏分页与契约 JSON 导出：设置页「样式参考」分页改为按小类分栏浏览——左侧类目栏按正文域/界面域分组（每类目带条目计数、当前类目高亮），右侧条目每页 15 条分页呈现（页码导航，类目切换重置到第一页）；支持等级过滤与文本搜索保留，搜索命中跨类目时聚合呈现并标注来源类目。离线指南（HTML）同步按类目分组。新增机器可读的契约 JSON（media/style-reference/style-reference.json，随扩展分发：含 schema 版本、类目定义表、全部条目全字段与 Obsidian 变量别名表的自描述清单），可经设置页「导出 JSON」按钮或命令面板「Vsidian: 导出样式参考 JSON」另存到用户路径（默认文件名带扩展版本，记忆上次导出目录；默认未绑定快捷键）——供 AI 助手与外部工具直接消费样式契约。（#145）
• 界面域公开样式契约：样式契约扩展到编辑器界面域（115 条）——代码块卡片与语法高亮、公式、图表（含按钮组与图表弹窗）、大纲面板、编辑器顶栏逐项登记实际支持入口；每个静态入口（.vsidian-math、.vsidian-code-card-header、.tok-*、.vsidian-outline-level-{1..6}、.vsidian-graphic-chrome、.vsidian-diagram-* 等）经真实渲染探针验证用户片段可实际改变可见属性（覆盖弹窗打开与刷新、明暗主题切换、阅读视图虚拟化重挂载；设置页不受片段影响）；第三方渲染器（KaTeX/Mermaid）内部 DOM 不承诺为稳定接口，以限制条目如实登记。样式参考分页与离线指南同步收录界面域条目（含示例与不兼容边界说明）。（#133）
• 公开样式契约与 Obsidian 兼容参考：公开样式入口迁移为结构化清单单一事实源（110 条，含支持等级与生命周期字段；手写映射表退位为迁移说明）；标记「直接兼容」的 Obsidian 原名选择器与 CSS 变量（如 .cm-strong、.HyperMD-header-1、.markdown-preview-view p、.task-list-item、a.internal-link、--h1-color、--text-highlight-bg 等）经内置别名桥在实时预览与阅读视图实际生效——元素同时挂载两个类名、变量经回退链取值，vsidian 原名保持既有语义且优先；设置页新增「样式参考」分页离线查阅随版本生成的指南（含域名/等级过滤与搜索），命令面板新增「Vsidian: 打开样式参考」（默认未绑定快捷键）。既有 vsidian 类名与变量全部保留，双轨并存。（#132）
• CSS 片段管理：在设置页选择用户级片段目录后，其第一层 .css 文件作为跨项目共享的独立片段管理——新片段默认关闭，按确定的文件名顺序加载（同层叠优先级后加载者覆盖）；逐项启停、手动重新加载、在文件管理器中打开目录，保存片段文件后自动生效；目录暂时读取失败时保留最近成功样式并提示。片段经外部样式表作用于实时预览与阅读视图，不影响输入、撤销与文档内容；独立设置页与原生源码编辑器不注入用户 CSS。命令面板新增「CSS 片段：重新加载」（默认未绑定快捷键）。（#128）
• CSS 片段本地依赖导入：入口片段经 @import 加载子目录 CSS（支持嵌套导入与 media/supports/layer 标准条件语义），被引用文件不自动成为独立片段；片段内的相对图片/字体按各自 CSS 文件所在目录解析（路径含空格与中文可用）。修改被导入文件自动刷新（只重载依赖它的入口，无关文件变更不产生刷新）；关闭入口撤下其整套样式，共享同一依赖的其他入口不受影响。循环导入有界不挂死；引用越出片段目录的路径（../ 逃逸、根相对、file: 等）与经符号链接逃逸的条目被拒绝加载并在设置页与通知中提示，修复后自动恢复；局部无效 CSS 遵循浏览器逐规则容错，缺失导入不整份回滚。（#129）
• CSS 片段暂停/恢复：命令面板新增「CSS 片段：暂停全部」与「CSS 片段：恢复」（默认未绑定快捷键，宿主侧命令——正文工具栏隐藏或面板异常时仍可用）；暂停全局冻结全部片段（编辑器立即撤下、新面板不装）但保留逐片段开关，重启后保持暂停状态并可在设置页 CSS 片段分页看到暂停提示、就地恢复；恢复按原配置立即生效，与逐项停用语义分开。（#131）
• CSS 片段环境隔离：本地与 Remote SSH 环境分别记录片段目录与启用状态（扩展状态按扩展宿主机器持久，远程配置不会覆盖本地目录，不做跨环境同步）；同一远程机器的多个窗口共用同一份配置。存储值内含环境标记作防御层，防止配置被意外搬运到另一环境后互相覆盖。（#131）
• HTTPS 样式导入与联网字体：片段内 @import url(https://…) 与 @font-face 远程字体（如 Google Fonts）可直接经网络加载，远程样式表内的相对字体 URL 按该表地址解析；扩展不做宿主代理、不绕过 CORS（字体服务须按标准返回跨域许可）。断网、跨域拒绝、HTTP 错误或无效 CSS 时其余片段不受影响，正文以备用字体保持可读；字体晚到自动触发高度重测与滚动锚定，不丢输入。安全边界：仅放行 HTTPS 源的样式与字体（明文 http 不放行），脚本权限不因此扩大。远程内容不监听远端变化，手动重新加载只重新拉取本地片段入口，远程样式与字体的缓存遵循其服务器的 HTTP 缓存设置（设置页 CSS 片段分页附有说明）。（#130）

修复

• 撤销与输入同步的竞态：按下 Ctrl+Z 瞬间若还有键入尚未同步完成，此前撤销请求会先于这些输入到达——一次 Ctrl+Z 撤掉的是更早的操作，而刚键入的新输入被静默保留；现此类撤销请求暂存至输入全部落地后按原顺序执行，撤销的必然是最近一次已完成的输入。（#148）
• 嵌套标记围栏外侧贴文字时不再显示裸围栏：高亮围栏 ==…== 的定界符外侧紧贴文字（汉字或字母）、内侧紧贴另一标记符号时（如 跨格==**建立**==选区后），此前外层高亮判定不配对、正文显示裸 == 围栏；现放宽配对判定至与 Obsidian 一致的宽松基准，嵌套高亮/粗体/删除线等组合正常渲染，实时预览与阅读视图改用同一判定内核、结果一致。空白边界、残缺形态与代码上下文的既有拒绝行为不变。（#149）
• 表格格内双链/图片/公式不再破坏网格布局：单元格内的 [[双链]]、![图片](…) 与 $公式$ 渲染元素连同其测量缓冲嵌套进所属单元格，不再裸露为网格行的额外格位——此前含渲染元素的行会把后续单元格顶到多出的一行（如 三[[a b]] | 四 行中「四」错位换行、双链自成一格）。渲染保留不降级；格内编辑（单击进格显源码、Tab 切格、格区拖选）与表格外正文中的渲染均不受影响。（#150）
• 符号补全在词前越界补出闭合符：光标右侧是正文文字时键入开括号/引号仍自动补全闭合符号（word 前键 [ 得 [|]word，闭合符越过后续文字落位）——括号与引号此前未登记右邻抑制。现对齐 VSCode/CodeMirror 生态惯例：右邻为词字符或普通标点（非空白且非闭合类字符）时不补全，右邻空白、行尾或闭合类字符（) ] }、引号、Markdown 标记符等）时照常补全，全部括号对与引号（含全角、弯引号）与 IME 提交路径行为一致；[|] 内再键 [ 得 [[|]] 的双链骨架两键成型保留（右邻 ] 属闭合类照补）。Markdown 触发符（* _ ~ 等）的既有右邻抑制行为不变。（#151）
• 样式契约陈旧数据纠错：清单中 .vsidian-mode-toggle（顶栏模式切换按钮组）为旧映射表陈旧行——该类自 #38 起已从 webview 移除且从未随任何发布版存在，已转为移除记录条目；公式容器与代码卡片行/行号类在阅读视图的同名发射此前漏记，已按源码补全适用视图；顶栏条目描述同步更正（#38 起模式切换在宿主标题栏）。（#133）

v0.4.0

本版本围绕 Markdown 语法扩展与结构化编辑：新增高亮与分割线语法、图形化代码块的弹窗浏览与导出，列表与引用获得 Enter 延续、退格清层与 Tab 缩进，侧栏支持拖拽调宽。

新增

• 高亮语法：==text== 高亮在实时预览与阅读模式渲染为荧光底色（Obsidian 风格）；命令面板、快捷键与快速操作条均可对选区或当前词切换，「清除行内格式」一并覆盖；光标进入显形源码直接编辑，配对判定与语法树语义一致，大纲面板标题条目同步透传高亮标记。（PR #108）
• 分割线：--- 等主题分割线在双模式渲染为居中渐变横线（行高与正文一致），光标触及显形源码可编辑；「插入分割线」操作规整前后空行（已有空行不叠加）、光标所在行左右文字各自成段，插入后光标落在分割线行尾，有选区时内容保留在分割线之后，表格选区内禁用；命令面板、快捷键（默认未绑定）与快速操作条均有入口。（PR #108）
• 图形化代码块交互：渲染图形（Mermaid 等）右上角悬停显示按钮组——「编辑源码」（仅实时预览，光标落入围栏显形源码）与「弹窗预览」（双视图全屏浮层：滚轮/键盘缩放、拖拽平移、一键回到整图、按当前源码刷新，缩放按矢量重排文字不糊）；点击图形本体不进入编辑，编辑入口收敛到按钮。图表可导出 SVG 与 PNG 文件（宿主另存为对话框落盘，环境不支持 PNG 光栅化时自动降级为仅 SVG）。（PR #114）
• 侧栏拖宽：右侧栏左缘拖拽调整宽度（200–720px，双击恢复默认），句柄聚焦时方向键微调；宽度跨面板记忆，重载后保持。（PR #115）
• 列表与引用的 Enter 延续与退格清层：实时预览中列表/引用行按 Enter 自动延续结构前缀——有序编号 +1 且保留宽度（9.→10.、01.→02.），任务新项重置为未勾选，引用内列表延续完整前缀（> - ）；空列表项/空引用行（无正文无子项）再按 Enter 退出结构还原普通段落。折叠光标紧邻列表标记右侧（如 - |item）时按 Backspace 分层剥除——嵌套项先升一级缩进，顶级一次清除整段标记（任务标记与列表标记为一个单元），嵌套引用逐层剥除。块级公式与表格、代码块内不接管（源码字面编辑）。（PR #121）
• Tab/Shift+Tab 通用行缩进：实时预览正文内 Tab 将光标行（或选区覆盖的各行）整行缩进一级，Shift+Tab 反向；列表行一级宽度对齐上方最近项的内容列（CommonMark 口径：无序与任务父项下均 2 格、宽编号有序父项下 4 格，跨族取上方项内容列），普通行（含代码围栏、缩进代码块与块级公式内）固定 2 空格，多光标取覆盖行并集；表格内保持单元格导航优先。缩进后的列表行圆点紧邻正文（无序标记隐藏区并入行首缩进空白，嵌套行整体视觉缩进较此前收紧），正文内 Tab 不再被转发为工作台焦点导航，焦点移出编辑器改经 Esc/鼠标。（PR #121）

修复

• 无选区行内格式切换不幂等：无选区对当前词施加行内格式（粗体/斜体/删除线/行内代码）后，光标此前停在开围栏外侧——再按同一快捷键不触发取消，反而在围栏符号处落入空对插入，产生 ****** 类叠加标记；现包裹后光标落在开围栏内侧，重复按键正确取消，两态往返。（PR #109）
• 表格段行号错位：实时预览中表格段的行号与正文错行——分隔行的 0 高记账格被补偿撑开、表头行锚定缺失格内下移量；行号与正文的字形基线对齐同步修正。（PR #117）
• 任务复选框：实时预览中任务复选框对物理鼠标点击无响应（widget 误拦截按下事件）；阅读模式松散列表（项间有空行）中的任务项不渲染复选框——两处修复。（PR #117）
• Mermaid 暗色可读性：暗色主题下打开文档时图表按浅色主题渲染，连线与文字叠暗底对比度不足、近乎不可见，仅运行中切换主题才恢复；现打开文档即按当前明暗态出图，暗色下图内配色对齐正文，文字与连线对比度满足无障碍下限。（PR #114）

v0.3.0

本版本围绕编辑效率与本地化体验：新增格式快速操作条与全项目快捷键管理，设置页支持分类导航与全局搜索，界面全面支持中英双语，并优化大纲视效。

新增

• 快速操作条：编辑器顶栏笔形按钮展开流内格式工具条，按组呈现常用格式、标题层级菜单、插入公式与建表入口，直接作用于原选区，展开状态会记住；写回保留局部格式操作外的原始标记，跨行围栏内的列表与引用容器保持原样；展开时不破坏表格格区，支持 Tab 键盘进出。阅读模式下写操作不可用。（PR #92）
• 快捷键管理：设置页新增「快捷键」分页，集中管理全部可绑定操作（格式、表格、查找、视图切换、大纲、设置入口等）；按键录制添加绑定（支持两段键），逐条删除、一键清空、单项或全部恢复默认；清空选择持久保留，不因重启或升级回退。插件内部冲突按「键位相同且生效范围重叠」判定，冲突时可一键替换既有绑定。（PR #92）
• 设置页分类导航与全局搜索：设置页左侧新增分类导航，顶部全局搜索按名称或说明定位设置项。（PR #92）
• 中英双语界面：编辑器、设置页、宿主通知与命令标题全部经语言包取词；设置页「常规 → 界面语言」提供「自动／简体中文／English」三档，默认跟随 VSCode 显示语言，切换即时生效。（PR #98）

改进

• 大纲视效：条目悬停指针与高亮、折叠滑块能量条、层级引导线。（PR #100）

已知限制

• 快捷键管理仅检测 Vsidian 内部冲突，不检测工作台与其他扩展的按键规则；排查外部冲突可使用 VSCode 的「记录键盘快捷方式故障排查」。

v0.2.0

本版本围绕信息组织与内容呈现扩展：新增右侧栏大纲面板、公式渲染、Mermaid 图表与代码块卡片，并增强表格选区交互。

新增

• 右侧栏与大纲面板：编辑器顶栏新增右侧栏切换按钮（细线／粗线两态图标，状态跨面板记忆）。「大纲」面板实时同步标题层级（ATX/Setext 语义，代码围栏与 frontmatter 伪标题不计入）；点击条目跳转正文对应标题（双模式），常驻高亮指示当前所在章节；六档「结绳」滑块统一展开深度，条目箭头手动折叠，滚动自动展开当前路径；工具条提供跳转末尾、重置与标题搜索（片段级高亮）；标题行内样式（粗体、斜体、行内代码、删除线）与主题层级配色同源透传；右键菜单提供结构命令、五项复制、调整层级、重命名（保留行内标记）与整段删除；拖拽标题按「控制域」整段重排，控制域外内容零误伤，一次撤销完整回滚。（PR #64、#71）
• 公式渲染：行内 $…$ 与块级 $$…$$ 的 LaTeX 公式在实时预览与阅读模式渲染（KaTeX 本地打包，无 CDN）；光标进入公式显形源码直接编辑，解析失败稳定降级为可读原文；普通美元、转义与代码区不误判。（PR #76）
• Mermaid 图表：语言标记为 mermaid 的围栏代码块在实时预览与阅读模式渲染为图（流程图、时序图等；本地打包按需加载，无 CDN）；光标进入围栏显形源码直接编辑，语法错误降级为错误提示与可读源码，不影响后续内容；明暗主题自动联动，图内链接不执行跳转。（PR #76）
• 代码块卡片：围栏代码块在光标离开时收起为卡片——语言头部横带（彩色徽标 + 显示名）、卡内行号（每块从 1 起）、悬停复制按钮（点击复制整块代码，经宿主剪贴板按文档换行风格写入——CRLF 文档得 CRLF；编辑态同样常驻）、折叠 chevron（点击收起，光标进入临时展开）；内置 Lezer +legacy-modes 高亮引擎（17 语言 + 纯文本，支持别名，明暗两套 VSCode Dark+/Light+ 风格色板，未识别语言回退纯文本），实时预览与阅读视图观感一致。mermaid 等渲染型围栏在光标进入（含点击渲染图）时同样显示卡片外壳与行号——呈现态保持图表渲染，折叠收起同样支持。设置页提供「代码块卡片 / 卡内行号 / 复制按钮 / 语法高亮」四个开关（高亮独立于卡片）。（PR #87）

改进

• 表格选区：跨格拖选形成矩形高亮，Ctrl+C / Cmd+C 复制为独立 Markdown 表格（选区首行为表头）；Delete / Backspace 清空局部区域，满行／满列选区删除对应行／列，整表选区删除整表，空行首格起点退格删除该行；边沿点阵把手支持单击选中行列（原有拖动重排保留）。（PR #76）

已知限制

• 代码块卡片：超过 4096 行的围栏跳过语法着色（逐键全块解析不可接受，回退纯文本卡片）；语言徽标为字形徽标（非矢量 logo）。

v0.1.0

首个公开版本。

新增

• 双视图编辑器：基于源文本的「实时预览 + 阅读」双视图；实时预览由 CodeMirror 6 全文承载（视口外不建 DOM），阅读模式由 markdown-it 分块渲染并按需挂载，10 万行 / 10 万块级文档性能与体量基本无关。
• 三态切换：编辑器标题栏按钮在「实时预览 → 阅读 → 源码编辑器」间循环，命令面板亦可直达任一模式；最近停留模式跨窗口全局记住，源码位置锚点保持。.md / .markdown 默认由本扩展打开，可随时右键改回原生编辑器。
• 表格编辑：规范表格以网格呈现，点击单元格直接格内编辑且网格保持；悬停入口增添行列、点阵抓手拖排行；Tab / Shift+Tab 单元格导航；命令面板六个行列命令与「创建表格」命令（中英双语界面）；格内键入 | 自动转义。
• 链接、图片与双链：普通链接、图片与 [[双链]] 在光标进入时显形源码，单击跳转（源码态 Ctrl/Cmd + 单击）；双链支持 [[笔记]]、[[路径/笔记]]、[[笔记|别名]]、[[笔记#标题]] 四形态，重名弹候选、缺失目标提示；本地图片经宿主通道装载，file://、javascript: 等危险 scheme 拦截。
• 任务勾选：两种视图内点击 checkbox 直接写回源文本，支持撤销。
• 查找：编辑器内 Ctrl+F / Cmd+F（限本编辑器激活时）。
• 独立设置页：「Vsidian: 打开设置」进入扩展自带设置页，不占用 VSCode 统一设置中心；设置用户级保存、重开回显、变更即时生效。当前提供实时预览行号开关（源文件行号，表格段显示段首行号）。
• 输入与同步防护：中文等 IME 组合期间缓冲上报，避免半截候选写回；外部修改无法安全同步时弹出冲突横幅，本地输入不丢（可复制或放弃）。

已知限制

• 未支持 Obsidian 的 Canvas、白板、插件生态与 .md 之外的笔记格式。
• CSP 允许 img-src https:——任意 https 图源可达（远程图床支持的设计代价）。
• 阅读模式始终无行号；表格列数不一致时显示可编辑源码而非网格。