用途:该技能用于在 Obsidian 中通过 CSS 片段改变界面外观,同时保持用户既有的视觉语言。它把用户用自然语言描述的可见对象翻译为 Obsidian 的稳定层级对象,再安全编辑当前启用的片段、截图验证并迭代,避免陷入无效的 CSS 循环。
主要能力:识别并映射常见界面对象,如工作区标签头、侧边停靠栏、文件浏览器行、Markdown 视图头、笔记表面、属性、反向链接、关系图、状态栏等;区分颜色、可读性、层次、圆角、结构、简化、工作流、重构等变更类型;在主观编辑前保存命名检查点;只编辑拥有该视觉形状的层级;格式化 CSS 后重载并截图受影响区域。
使用方式:从实时仓库开始,读取 <vault>/.obsidian/appearance.json,以 enabledCssSnippets 为当前样式来源;先读启用片段,再考虑归档或备份。将用户短语映射为可见对象、Obsidian 层级、可能的选择器、变更类型和拥有层级。编辑前保存检查点到 .obsidian/snippet-archive/,不要放入 .obsidian/snippets。重新读取当前代码块后只改一个拥有层级,格式化 CSS,重载或聚焦 Obsidian,截图受影响区域,以截图和用户反馈作为证据。若失败,检查归属或恢复,不要继续堆叠 CSS。
适用场景:重设标签页、侧边栏、笔记表面、属性、反向链接、关系图或文件浏览器等界面外观;处理“没变化”“仍然被包裹”“没有浮起”“图标看不清”等视觉问题;在不改变已接受外观的前提下重构启用片段。
限制:不是通用 CSS 工作流,也不是固定主题生成器。精确类名可能随主题、插件或应用版本变化,需在实时仓库中验证。切换主题、禁用片段或插件、隐藏或移动属性、大幅改变全局排版或编辑器密度、删除归档实验、修改 .obsidian/snippets 或 Obsidian 设置之外的文件前,需明确确认。CSS 有效不等于视觉成功,截图才是产品事实。若方向失败两次,应恢复上一个良好检查点并改变归属模型。重构应在用户接受视觉状态之后进行。