Apex Dashboard 详细部署（安装）教程

Apex Dashboard 是一个为 Obsidian 打造的一体化个人工作台插件。它能将你的备忘、待办、项目和笔记整合到一个美观的玻璃质感仪表盘中，所有数据都保存在你本地的 Markdown 文件中。本教程将指导你通过两种方式完成安装。

一、 安装前准备

开始安装前，请确认：

  1. 你已经安装了 Obsidian 且版本不低于 v0.15.0。
  2. 你有一个用于存放笔记的 仓库（Vault）。

二、 安装方式

Apex Dashboard 的安装非常简单，最推荐通过 Obsidian 官方社区插件市场进行。

方式一：从 Obsidian 社区插件市场安装（推荐）

这是最便捷、安全的安装方式，能自动获取更新。

操作步骤：

  1. 打开你的 Obsidian。
  2. 进入 设置 > 社区插件 > 浏览。
  3. 在搜索框中输入 “Apex Dashboard”。
  4. 在搜索结果中找到它，点击 安装，安装完成后，再点击 启用。

方式二：手动安装（离线或市场无法访问时）

如果无法访问社区插件市场，或希望安装特定版本，可以采用此方式。

操作步骤：

  1. 下载插件包：访问项目在 GitHub 的 Releases 页面，下载最新版本的 ApexDashboard-x.y.z.zip 文件。
  2. 解压文件：将下载的 .zip 文件解压，得到一个名为 apex-dashboard 的文件夹。请确认该文件夹内直接包含 main.js、manifest.json 和 styles.css 这三个核心文件。
  3. 放置到仓库：找到你的 Obsidian 仓库（Vault）根目录下的隐藏文件夹 .obsidian，再进入其内的 plugins 文件夹。如果 plugins 文件夹不存在，请手动创建。将上一步解压出的 apex-dashboard 文件夹完整地复制到 plugins 文件夹内。
  4. 启用插件：重启或加载 Obsidian，进入 设置 > 社区插件，在已安装插件列表中找到 “Apex Dashboard” 并启用它。

三、 初次使用与配置

安装并启用插件后，就可以开始使用了。

  1. 打开仪表盘：你可以通过两种方式打开：
    • 点击 Obsidian 左侧边栏的主页图标（ribbon icon）。
    • 使用命令面板（Ctrl/Cmd + P），输入并执行 Apex Dashboard: Open dashboard。
  2. 自动初始化：首次打开时，插件会在你的仓库根目录自动创建一个 dashboard.md 文件。这就是你的仪表盘数据文件，所有在仪表盘上的修改都会实时写入这个文件，数据完全归你控制。
  3. 定制你的仪表盘：
    • 更换主题：进入 Obsidian 设置 > Apex Dashboard 设置，在 Style（样式）选项中，你可以从 13 种精心设计的主题（如 Earth, Nordic, Aurora）中选择。
    • 配置侧边栏小工具：在插件设置中，你可以独立开关和配置天气（由 Open-Meteo 提供，无需 API 密钥）、番茄钟、阅读追踪器等小工具。
    • 管理布局：仪表盘上的每个卡片（Memo, Todo, Projects）都支持拖拽进行重新排序。你也可以通过直接编辑 dashboard.md 文件来删除、重命名或调整分区。

四、 常见问题

  1. 问：如何删除或重命名一个分区（Section）？
    答：无法直接在界面上操作。你需要用文本编辑器打开仓库根目录的 dashboard.md 文件，找到对应的分区标题或内容块进行编辑。任何对 dashboard.md 的修改，保存后都会立刻在仪表盘视图上生效。
  2. 问：安装后设置界面显示不正常怎么办？
    答：在 Obsidian 1.13+ 版本上，旧版插件的设置页布局可能存在问题。请确保你安装了 v1.8.4 或更高版本，此问题在该版本中已被修复。
  3. 问：我可以为任务设置提醒吗？
    答：可以。在 Todo 任务上，点击铃铛图标可以设置提醒日期和时间。提醒会以 ⏰ YYYY-MM-DD HH:MM 的格式直接写在任务文本里，并在到期时通过 Obsidian 的通知系统提醒你。