Obsidian 学习笔记

Appearance

更新日志 ​

所有重要的网站更新都会记录在此页面。

2026-06-18 ​

市场组件架构重构 🏗️ ​

拆分 PluginMarket（110KB）和 ThemeMarket（83KB）为 7 个子组件，消除重复代码，提升可维护性：

子组件功能行数
MarketPagination.vue通用分页（页码导航/每页条数/跳页）311
MarketSearch.vue通用搜索框（搜索历史/快捷键提示）320
MarketState.vue通用状态展示（骨架屏/错误/空状态）120
PluginCard.vue插件卡片（徽章/复选框/统计/教程）179
ThemeCard.vue主题卡片（截图/元数据/收藏）163
PluginDetailModal.vue插件详情弹窗559
ThemeDetailModal.vue主题详情弹窗（含截图区域）618
  • PluginMarket.vue：3780 → 2771 行（减少 27%）
  • ThemeMarket.vue：2820 → 2211 行（减少 22%）
  • 修复 selectAll() 中 paginatedItems → pagedItems 拼写 bug

虚拟列表懒渲染 ⚡ ​

新增 useVirtualList.ts composable，解决大 pageSize（72/96）时一次性渲染过多 DOM 的性能问题：

  • 首屏仅渲染 24 张卡片，滚动接近底部时自动追加 24 张
  • 基于 IntersectionObserver + 节流（200ms）+ requestAnimationFrame
  • 加载指示器（旋转 spinner + "滚动加载更多"提示）
  • 已集成到 PluginMarket 和 ThemeMarket 的卡片/列表视图

首页数据统计增强 📊 ​

新增内容统计脚本和首页动态板块：

  • gen-content-stats.js — 扫描 docs/ 统计文档数、字数、分类分布
  • gen-latest-updates.js — 基于 git log 生成最近 10 篇更新文档
  • HomeStats.vue — 首页异步加载数据统计卡 + 分类分布网格 + 最新内容时间线
  • 新增 npm run gen:stats 一键生成数据文件

文档阅读体验优化 📖 ​

  • ReadingTime 增强 — 标题下方新增难度等级徽章（入门/进阶/高级，三色系）+ 分类标签 + 相关标签（最多 3 个）
  • CodeEnhance 长代码折叠 — 超过 40 行的代码块自动折叠，显示"展开 N 行代码"按钮，底部渐变遮罩
  • Callout 差异化配色 — question（蓝）、example（紫）、danger（红增强）、warning（橙增强）四种类型独立配色，含暗色模式

市场交互美化 🎨 ​

  • 卡片 hover 微动画 — 双层阴影（品牌色光晕 + 基础阴影）+ cubic-bezier 缓动曲线 + 4px elevation
  • 详情弹窗响应式优化 — 移动端完整抽屉式（overlay 贴底）、操作按钮全宽垂直排列、平板端宽度过渡、统一 768px 断点

工程化质量保障 🛠️ ​

  • TypeScript 类型检查 — 新增 npm run typecheck（vue-tsc --noEmit）
  • ESLint 代码规范 — 新增 eslint.config.mjs（ESLint 9 flat config），npm run lint / npm run lint:fix
  • 一键质量检查 — npm run check:all（frontmatter + links + typecheck + lint）
  • postinstall 容错 — mark.js 补丁脚本整体 try-catch 包裹，失败不阻断安装
  • lint 清理 — 576 个 warnings 全部修复至 0 errors 0 warnings

图片资源优化 🖼️ ​

增强 optimize-images.js 脚本：

  • 新增 AVIF 格式转换（比 WebP 再小 ~20%，3 个图标 92.3% 压缩率）
  • 新增响应式 srcset 生成（480/768/1024/1920px 多尺寸）
  • 新增 alt 属性检查（扫描所有 .md/.vue 文件中的 img 标签）

内容完善 📝 ​

  • 新增 ai/setup/index.md 配置指南索引页（与其他 AI 子目录结构一致）
  • 已添加到侧边栏配置和 ai/index.md 导航

2026-06-09 ​

新增 9 款插件完整教程 📚 ​

新增 18 篇文档（基础 + 进阶），覆盖社区高频使用的核心插件：

插件文档内容要点
Homepage基础 / 进阶启动页定制、动态仪表盘、条件化规则
Outliner基础 / 进阶折叠列表、快捷键操作、项目管理
make.md基础 / 进阶标签面板、属性管理、目录生成
Periodic Notes基础 / 进阶日记/周记/月记、多周期协同
Commander基础 / 进阶自定义命令、代码片段、自动化工作流
Quick Switcher++基础 / 进阶书签系统、模糊搜索、标签过滤
Tracker基础 / 进阶数据可视化、习惯追踪、甘特图
Terminal基础 / 进阶内嵌终端、多标签页、Git 工作流
TaskNotes基础 / 进阶任务笔记、跨插件联动、项目管理

文档补全与修复 🔧 ​

  • moc-method.md — 补全「分层」字段缺失内容
  • second-brain.md — 补全实践练习任务列表
  • floating-nav-plan.md — 更新验收清单状态
  • PLUGIN-MARKET-REDESIGN.md — 标记为已完成
  • SCREENSHOTS.md — 更新截图状态记录

构建问题修复 ​

  • 修复 {{ / }} Vue 模板语法与 Obsidian 模板标记冲突（preConfig 层转义为 HTML 实体）
  • 解决 5 个文件构建报错，构建正常通过

项目清理 ​

  • 删除 scripts/gen-icons.js（已被 gen-icons-optimized.js 替代）
  • 删除 scripts/update-plugin-data.js（已合并到 sync-community-data.js）

同步脚本交互式菜单 🖥️ ​

  • 执行 npm run sync:data 时自动显示模式选择菜单
  • 4 种同步模式：完整同步 / 完整+详细日志 / 快速同步（跳过 GitHub）/ 快速+详细日志
  • 非交互终端（CI/CD）自动跳过菜单，命令行参数优先
  • Windows / Linux / macOS 全平台兼容（process.stdin.isTTY 检测）

主题状态追踪 📊 ​

  • 自动生成 theme-status.json，记录新增/下架主题
  • 包含版本覆盖率、星标覆盖率、归档数等统计
  • 与插件状态追踪机制完全对齐

主题市场 Hero 区域增强 ​

  • Hero 区域新增「最后主题更新」时间显示
  • Hero 区域新增「新增主题」徽章（绿色高亮）
  • 与插件市场 Hero 区域功能对齐

市场 UI 样式对齐 🎨 ​

  • 插件市场分类筛选区采用卡片容器样式（背景、圆角、边框）
  • 主题市场热门标签云样式与插件市场完全统一（按钮背景、徽章样式、加载按钮）
  • 两个市场组件视觉风格保持一致

新增通用 Composables ​

  • useImageZoom — 图片点击放大预览（遮罩层 + ESC 关闭）
  • useServiceWorker — PWA 更新检测与通知（每 30 分钟检查 + Toast 提醒）
  • useMobileNav — 移动端底部导航（响应式 + SPA 路由同步 + 搜索入口）
  • useScrollRestore — SPA 滚动位置保存/恢复（按路径追踪）
  • useSidebarState — 侧边栏折叠状态持久化（localStorage）
  • useUtils — 通用工具函数（debounce、throttle）

新增组件 ​

  • HeroEnhancements.vue — Hero 区域平台快捷键检测（Windows/macOS 自适应显示）
  • SearchTracker.vue — 搜索行为追踪（支持热力图数据收集）
  • ShareButton.vue — 页面分享功能
  • SkipLink.vue — 无障碍跳过导航链接

键盘快捷键系统 ⌨️ ​

  • 右侧悬浮菜单新增键盘快捷键按钮（键盘图标），仅在有快捷键的页面显示
  • 点击弹出面板，列出当前页面所有快捷键（<kbd> 样式展示）
  • 插件市场：/ 聚焦搜索、← → 翻页、Esc 清除筛选、Enter 搜索/跳转/打开详情
  • 主题市场：与插件市场快捷键完全对齐（/、← →、Esc、Enter）
  • 文档页：Esc 关闭图片放大预览
  • 非文档页面不显示键盘按钮

翻页体验优化 📖 ​

  • 键盘 ← → 翻页不再跳转到页面顶部，原地切换保持阅读位置
  • useMarketPagination 新增 skipScroll 参数，支持静默翻页
  • 主题市场键盘导航从局部 DOM 监听改为全局 document 监听，页面任意位置均可使用
  • 移除主题市场翻页按钮的键盘提示文字（(←) (→)）
  • 移除主题市场分页区域下方的 ←→翻页 提示条

2026-06-06 ​

市场组件代码重构 ♻️ ​

通用 Composables 提取

从 PluginMarket 和 ThemeMarket 中提取 6 个通用 composable，消除重复代码：

Composable功能复用范围
useMarketSearch多关键词搜索、搜索历史持久化（localStorage）插件市场 + 主题市场
useMarketFavorites收藏管理（添加/移除/批量/持久化）插件市场 + 主题市场
useMarketPagination分页逻辑（页码导航/跳转/页大小）插件市场 + 主题市场
useMarketBatchSelect批量选择（全选/反选/清除）插件市场
useMarketUtils工具函数（日期/数字格式化、搜索高亮、头像）全部市场组件
useMarketUrlParamsURL 查询参数持久化（状态同步/分享链接）插件市场 + 主题市场

组件清理

  • 移除废弃的 MarketGrid.vue 组件及 index.ts 引用
  • 移除 config.mts 中 MarketGrid 的分包配置

主题市场收藏与搜索历史 ⭐ ​

收藏功能

  • 卡片视图新增收藏按钮（红心图标）
  • 列表视图新增收藏列
  • Hero 统计栏显示收藏总数
  • 收藏数据 localStorage 持久化

搜索历史

  • Hero 搜索框新增搜索历史下拉面板
  • 点击历史记录快速回填搜索词
  • 支持单条删除和清空全部历史
  • 最多保留 10 条历史记录

插件市场标签云 🏷️ ​

  • Hero 区新增热门话题标签云组件
  • 自动从插件 topics 字段提取高频标签（出现 ≥3 次，Top 20）
  • 异步懒加载（500ms 延迟），不阻塞首屏渲染
  • 标签显示出现次数徽章
  • 点击标签快速筛选，再次点击取消筛选
  • 筛选条件变更自动重置分页

插件市场详情弹窗 📋 ​

交互优化

  • 卡片/列表项点击改为打开详情弹窗（原跳转 GitHub）
  • 详情数据按需异步加载，结果浏览器缓存
  • 加载中骨架屏 / 加载失败错误提示
  • 弹窗打开时禁止背景滚动
  • ESC 键 / 点击遮罩层关闭弹窗
  • 入场/退场动画（缩放 + 淡入淡出）

详情面板内容

  • 插件名称、版本号、下载量徽章
  • 描述、作者信息（头像 + GitHub 主页链接）
  • 统计信息网格：下载量 / 星标 / Fork / 更新时间
  • 元信息网格：分类 / 许可证 / 语言 / 创建时间 / 最近发布
  • 话题标签列表
  • 操作按钮：GitHub 仓库 / 项目主页 / 关闭

URL 状态持久化 🔗 ​

  • 搜索词、分类、排序、分页等筛选条件同步到 URL query params
  • 页面刷新后自动从 URL 恢复状态
  • 支持复制/分享带筛选条件的链接
  • 默认值时自动从 URL 移除，保持 URL 简洁
  • 使用 restoring 标志防止恢复过程中的 watch 回写

主题市场功能增强 ​

搜索与筛选

  • 多关键词 AND 搜索：输入多个关键词时，同时匹配所有关键词
  • 搜索结果高亮：匹配的文本自动 <mark> 高亮显示
  • 新增许可证筛选下拉框，按开源协议过滤主题
  • 新增归档状态筛选（全部 / 正常 / 已归档）
  • 新增话题云组件：异步加载热门话题标签，点击快速筛选

视图与排序

  • 卡片新增 Fork 数量展示
  • 列表视图新增许可证列和归档标记行
  • 排序选项从 5 项扩展到 7 项（新增"创建时间"和"Fork 数"）

分页与导航

  • 合并卡片/列表视图的重复分页为单一实例
  • 新增键盘导航：← → 方向键切换页码
  • 筛选条件变更自动重置到第 1 页
  • 新增空状态提示面板，含重置按钮

性能优化

  • 列表页默认加载精简数据（287KB），较完整版减少 49%
  • 新增主题详情弹窗，按需加载完整数据并浏览器缓存
  • 移除 HTTP 缓存禁用策略，启用强缓存
  • 精简数据新增 updatedAt、version、repo、isArchived、licenseInfo 字段

同步脚本升级 v3.1 ​

性能与稳定性

  • 合并主题 + 插件为单次 GraphQL 查询，节省 API 额度
  • 在 GraphQL 查询中嵌入 manifest.json，批量获取版本号（4175 个插件从逐个请求优化为批量）
  • 并发控制改为 for 循环批次创建 Promise，修复批次控制失效问题
  • HTTP 502/503/429 自动重试退避
  • 新增 gzip 压缩输出（.json.gz）
  • 支持 plugin-overrides.json 合并覆盖
  • 批量操作增加进度条显示

数据字段扩展

  • 新增字段：createdAt、minAppVersion、forkCount、isArchived、isFork、homepageUrl、licenseInfo、primaryLanguage、latestRelease、topics
  • 精简版数据新增 isArchived、licenseInfo、createdAt、forkCount

错误处理

  • GraphQL 部分错误不再导致整批降级（仓库不存在仅跳过该条目）
  • 非 JSON 响应（HTML 错误页）自动重试
  • 修复 failedRepos 解构字段名不匹配导致脚本崩溃

项目配置与规范 ​

  • commit-msg hook 新增中文提交格式支持（18 种类型）
  • pre-commit hook 修复 Linux stat 兼容性
  • 补充移动端/无障碍/SEO 样式与结构化数据规范
  • sharp 升级至 0.34.5 最新稳定版
  • 修复 docs:clean 脚本 Linux 兼容性（Windows 批处理 → Unix Shell）
  • 更新 README 徽章数据与项目说明，同步脚本文档升级至 v3.1

同步数据统计 ​

数据类型数值
插件总数4564 个
主题总数552 个
插件版本覆盖率100%
主题版本覆盖率88.8%
插件下载量覆盖4169 个

2026-05-17 ​

插件市场更新日期修复 ​

Bug 修复

  • 修复插件更新日期显示错误问题（GraphQL 字段 updatedAt → pushedAt）
  • 修复前端日期时区处理错误（改用 UTC 时间格式化，避免日期偏差一天）

同步脚本全面升级 v3.0

优化项说明
GraphQL 批量查询每批 100 个仓库，减少 API 调用次数
REST API 并行请求并发数控制为 10，避免被限流
智能缓存机制优先使用本地缓存，失败时自动回退
自动重试机制网络波动时自动重试（最多 2 次）
模块化代码结构按功能划分为独立模块，易于维护
详细 JSDoc 注释每个函数都有完整注释说明

新增功能

  • --verbose 参数：显示详细日志，便于调试
  • 版本号批量获取：分批并行处理，提升获取速度
  • 增强进度条：实时显示速度和预估剩余时间
  • 详细统计信息：显示各类数据的覆盖率

跨平台兼容性增强

  • Windows SSL 证书自动处理
  • Windows UTF-8 编码自动处理
  • 路径分隔符自动适配

代码清理

  • 删除 run-sync.js、run-sync.bat、同步数据.bat
  • 统一使用 npm run sync:data 命令

同步数据统计 ​

数据类型覆盖率
插件总数3836 个
有星标数据3236/3836 (84%)
有分类2443/3836 (64%)
有下载量3797/3836 (99%)
有版本信息3386/3836 (88%)
主题总数515 个
手动分类覆盖124 个插件

2026-05-16 ​

代码质量与无障碍改进 ​

项目配置优化

  • 新增 tsconfig.json，配置严格类型检查
  • 修复 tsconfig.json 继承错误、Vue 组件标签匹配问题

废弃文件清理

  • 删除 composables/useBackToTop.ts（功能已由 FloatingNav.vue 统一提供）
  • 移除 theme/index.ts 中废弃的 BackToTop 引用

文档校验脚本增强

check-frontmatter.js 新增：

功能说明
--fix 模式自动修复 frontmatter 问题
相似度检测检测重复的 title/description
无障碍检查图片 alt 属性检查

check-links.js 新增：

功能说明
Wiki 链接统计统计 [[链接]] 语法使用情况
图片链接检查检测缺失的图片资源
外部链接统计汇总外部链接数量

无障碍功能改进

  • FloatingNav.vue：添加 role、aria-label、aria-expanded 属性
  • ReadingProgress.vue：添加 role="progressbar" 和 ARIA 属性
  • FeedbackSection.vue：添加 role="group"、aria-live="polite"

主题市场全面升级 ​

新增功能

  • 主题截图展示（16:10 比例，懒加载）
  • 作者头像（GitHub API 获取）
  • 版本号显示（从 manifest.json 获取）
  • 更新日期（格式化为 YYYY-MM-DD）
  • 分类筛选（全部/暗色/亮色/双模式）
  • 排序功能（名称/作者/星标/更新时间/版本）
  • 视图切换（卡片/列表）

Hero 区域优化

  • 主题数量徽章（512+ 社区主题）
  • 渐变背景光效（脉冲动画）
  • 统计信息展示

问题修复

  • 修复标题乱码问题
  • 修复统计信息重复显示
  • 修复更新日期不显示问题
  • 优化版本号角标位置

数据同步脚本优化 ​

核心修复

  • GraphQL 认证：bearer → Bearer
  • Windows 环境变量丢失：添加 env: env 参数

终端输出优化

  • 颜色标注（成功/错误/警告/信息）
  • 实时进度条（百分比、速度、预计完成时间）
  • 失败明细记录
  • 统计摘要

错误处理增强

  • 单个请求失败不影响整体流程
  • 批次查询失败自动降级为 REST API
  • 使用缓存数据作为 fallback

2026-05-15 ​

插件市场功能完善 ​

布局优化

  • 最大宽度限制为 1152px
  • 分类筛选移至左侧侧边栏（固定定位）
  • 移动端自动切换为底部横向标签

功能增强

  • 插件状态管理（新插件绿色徽章）
  • 数据显示优化（星标、更新日期、版本号）
  • 新增 scripts/update-plugin-data.js（已合并到 sync-community-data.js，v1.5 移除）

问题修复

  • 页面刷新后数据加载失败（Service Worker 拦截 /data/ 路径）
  • Response body 被锁定错误（使用 response.clone()）
  • 移除已删除插件功能

2026-05-14 ​

内容架构补全与图标系统修复 ​

新增文档（3 篇）

  • advanced/properties-dataview.md — Properties 与 Dataview 联动
  • advanced/plugin-recommendations-by-scenario.md — 场景化插件推荐
  • basics/pdf-export.md — PDF 导出最佳实践

索引页条目补全

  • basics/index.md：移除重复条目，新增"无障碍功能""PDF 导出"
  • advanced/index.md：新增联动教程和场景推荐
  • reference/index.md：新增 4 个速查表链接
  • best-practices/index.md：新增 4 个职业工作流

图标系统修复

  • 补充 3 个新页面的图标映射
  • 修复 icon-39 被优化脚本移除问题
  • 修复导航栏"扩展生态"图标缺失
  • 修复下拉菜单 active 状态图标不变色

链接与格式清理

  • 40+ 文件 176 处链接去除 .md 后缀
  • 33 个文件移除 Callout emoji 标题
  • 243 个文件批量添加 category 和 tags

变更统计：新增 3 篇 | 修改 60+ 个 | 修复 176 处链接

2026-05-09 ​

导航扩展与代码块修复 ​

新增文档（20 篇）

  • 数据安全：data-portability.md、version-migration.md、commercial-use.md
  • 开发：svelte-plugin-dev.md、codemirror-extensions.md、plugin-testing.md、mobile-plugin.md、plugin-i18n.md
  • 职业工作流：设计师/律师/医生/金融从业者
  • 集成：Apple 生态、自动化、项目管理
  • AI：rag-workflow.md、cost-optimization.md

Bug 修复

  • 代码块行号与内容错位
  • quickadd-cheatsheet.md Vue 模板解析冲突
  • useNavIcons.ts 重复键警告
  • 构建警告 Some chunks are larger than 500 kB

变更统计：新增 20 篇 | 修改 68 个 | 新增 25 项图标映射

2026-05-05 ​

内容质量全面修复与格式规范化 ​

新增文档

  • ai/setup/built-in-ai.md — Obsidian 内置 AI 功能
  • basics/accessibility.md — 无障碍与辅助功能

死链修复

  • 修复 4 处死链（attachments、math、kindle、integrations）

语法高亮优化

  • 新增 16 个代码块语言别名（dataview、dvjs、tasks、chart 等）

变更统计：新增 2 篇 | 死链修复 4 处 | 语法别名 16 个

早期更新 ​

2026-04 ~ 2026-02 ​

日期主要更新
2026-04-22UI 精简与页脚优化
2026-04-17Markdown 表格格式修复与侧边栏图标补全
2026-04-11核心语法教程补全（Callout、数学公式、嵌入语法、Front Matter）
2026-04-10设置指南、AI 隐私安全、学生知识库、开发者笔记本
2026-04-08AI 插件专题与移动端内容（~35,000 字）
2026-04-07导航优化、移动端插件与性能监控
2026-04-06视频教程页面上线
2026-04-04FAQ 整合、效率工具重组、术语表、搜索热力图
2026-04-03AI 专题深度补充（20 篇，内容增长 330%）
2026-03-31AI 案例体系扩充、Obsidian v1.12.7 新功能同步
2026-03-28第三方集成和案例展示目录上线（19 篇）
2026-03-27图标系统全面重构（CSS 模块化拆分）
2026-03-26网站全面优化（首页 CSS 提取、移动端响应式）
2026-03-14快速参考卡片系统上线（103 篇）
2026-03-13文档体系全面升级（94 篇）
2026-02-28页脚重构与移动端目录组件
2026-02-27侧边栏重构与内容扩充
2026-02-24场景化工作流上线（学生、程序员、写作、科研、教师）
2026-02-23CLI 命令行界面文档上线
2026-02-22工作流模块上线
2026-02-20网站正式上线（68 篇文档）

文档增长统计 ​

日期新增扩充总计
2026-06-09186276
2026-06-0604258
2026-05-1703258
2026-05-1602258
2026-05-14360+258
2026-05-092068251
2026-05-05218+231
2026-04-111181229
2026-04-1048213
2026-04-08125201
2026-04-07620+189
2026-04-04515+182
2026-04-03020172
2026-03-31185172
2026-03-28195154
2026-03-1492103
2026-03-1315194
2026-02-272079
2026-02-245177
2026-02-2068068