# Apex Dashboard

> Obsidian 一页纸工作台。一个页面，搞定一切。随手记灵感、管理待办、追踪项目 — 而且好看得不像实力派。

## 截图预览

![Apex Dashboard](screenshot1.png)

## 功能特色

### 🗒️ Memo（备忘）
内置便签式 Memo 卡片，每张卡片都有可编辑文本区域，随时记录灵感、会议笔记或每日反思，无需离开仪表盘。支持 `[[双链]]` 渲染为可点击链接，轻松关联笔记。

### ✅ Todo（待办）
交互式任务清单，支持添加、拖拽排序、勾选完成。底部进度条以百分比实时显示完成进度。待办项同样支持 `[[双链]]`，方便交叉引用。

### 📁 Projects（项目）
将 Vault 文档组织为项目卡片。每张卡片可关联多篇笔记，支持封面图片（支持本地 Vault 图片和网络图片链接）和内联文档搜索，快速添加文件。支持管理多种文件类型，包括 Markdown 笔记、PDF、图片、音频和视频。

### 📝 Notes（笔记）
紧凑的列表式分区，用于整理参考文档和快捷访问文件。每行最多显示 5 张卡片，无封面图片，最大化信息密度。

### ⚡ 快捷操作
将常用快捷方式固定到侧边栏，支持两种操作类型：**文件**链接可打开任意文档，**命令**快捷方式可触发任意 Obsidian 命令。内置新建日记和新建笔记预设。

### 🎨 Banner（横幅）
可自定义的横幅区域，支持编辑引言和背景图片（支持本地 Vault 图片和网络图片链接）。双击即可修改。

### 🔄 拖拽排列
在分区之间拖拽卡片来重新组织工作空间，也可以在 Todo 卡片内拖拽任务项进行排序，还支持在 Projects/Notes 卡片之间拖拽文档链接。

### 🧩 自定义分区
创建分区时可选择 4 种内置类型 — **Memo**、**Todo**、**Projects**、**Notes** — 每种类型都有独立的布局和行为。自由组合，打造专属工作流。

### 🕐 最近文档
侧边栏展示最近编辑的文件及相对时间，快速回到最近的工作。

## 主题

![主题预览](screenshot2.png)
![主题预览](screenshot3.png)
![主题预览](screenshot4.png)

5 款精心设计的主题，各具风格：

| 主题 | 风格 |
|------|------|
| **Earth（大地）** | 温暖有机的质感，羊皮纸色调 |
| **Nordic（北欧）** | 简约清爽，蓝色点缀 |
| **Cyan（青绿）** | 赛博朋克风，青色暗底 |
| **Aurora（极光）** | 冰霜玻璃质感，极光渐变动画 |
| **Spring（春日）** | 玫瑰色调，温暖柔光 |

所有主题均支持 Obsidian 亮色和暗色模式。青柠和传奇主题无论系统偏好如何，始终呈现暗色风格。

## 设置选项

- **Dashboard 文件路径** — 自定义仪表盘数据文件的存放路径
- **样式** — 从 5 款视觉主题中选择
- **语言** — 支持英文和中文界面
- **最近文档数量** — 控制侧边栏显示的最近文件数量

## 安装

### 从 Obsidian 社区插件市场安装（即将上架）
1. 打开 设置 > 第三方插件
2. 搜索 "Apex Dashboard"
3. 点击安装，然后启用

### 手动安装
1. 从 [GitHub Releases](https://github.com/pandorareads/apex-dashboard/releases) 下载最新版本
2. 解压到 Vault 的 `.obsidian/plugins/apex-dashboard/` 目录
3. 打开 设置 > 第三方插件，启用 "Apex Dashboard"

## 使用方法

1. 通过左侧功能区图标（主页图标）或命令面板打开：`Apex Dashboard: Open dashboard`
2. 首次使用会在 Vault 根目录自动创建 `dashboard.md` 文件
3. 所有更改直接保存到文件 — 纯文本格式，你的数据完全属于你

> **注意：** 删除、重命名或对分区进行排序，需要在 `dashboard.md` 笔记中进行操作。在笔记中的任何修改，会在工作台界面中直接生效。

## 更新日志

### v1.0.6
- **多名言轮播** — Banner 支持存储多条名人名言，可在编辑弹窗中添加、编辑和删除
- **背景图轮播** — 支持添加多张背景图片，每 2 小时自动切换，带淡入淡出过渡效果
- **名言自动轮播** — 名言每 2 小时自动切换（与背景图错开 1 小时，不会同时切换）
- **双击重命名分区** — 双击任意分区标题即可内联编辑名称（Enter 保存，Escape 取消）
- **分区类型保护** — 修复 Memo 和 Todo 分区重命名后类型丢失的问题，兼容新旧仪表盘
- **智能类型检测** — 仅含 generic 卡片的分区在标题变更后正确保持 Memo 类型
- **分区折叠** — 点击分区标题左侧的倒三角可折叠/展开分区，折叠状态跨会话保留
- **跨卡片拖拽** — 支持在 Projects/Notes 卡片之间拖拽文档链接，在 Todo 卡片之间拖拽任务项
- **卡片排序修复** — 修复所有分区（待办、项目、笔记）的卡片拖放定位问题，卡片现在会精确放置到拖放位置，而不是总是移到第一个位置
- **分区类型修复** — 修复在 Markdown 文件中重命名分区后类型被重置为 Projects 的 Bug
- **空卡片交互** — 清空所有项目后的卡片仍可通过拖拽或输入框添加新内容
- **移动端优化** — 隐藏备忘录调色板按钮、抽屉使用实色背景适配所有主题、快捷操作列表加高显示
- **分区类型颜色** — 四种分区类型（备忘、待办、笔记、笔记无封面）各有独立的倒三角颜色

### v1.0.4
- **快捷操作** — 快捷链接升级为快捷操作，支持文件链接和 Obsidian 命令快捷方式
- **添加操作弹窗** — 双标签页（文件/命令）添加自定义操作，内置新建日记和新建笔记预设
- **4 种分区类型** — Memo、Todo、Projects、Notes，每种类型拥有独立布局和行为
- **多格式文档支持** — 在项目卡片中管理 Markdown、PDF、图片（PNG、JPG、GIF、SVG、WebP）、音频（MP3、M4A）和视频（MP4、MOV）
- **双向链接** — Memo 和 Todo 卡片将 `[[双链]]` 渲染为可点击链接，支持 basename 回退
- **日记路径设置** — 配置新建日记的保存路径
- **UI 优化** — 桌面端隐藏垂直滚动条、主题色水平滚动条、Notes 分区布局优化
- **Bug 修复** — 修复备忘录卡片双链点击、快捷链接重命名竞态条件、插件卸载时重命名监听器清理

### v1.0.3
- **双链支持** — Memo 和 Todo 卡片现在会将 `[[双链]]` 渲染为可点击链接
- **分区类型选择** — 创建新分区时可选择分区类型
- **移动端侧边栏抽屉** — 移动端导航采用滑入动画
- **分区创建体验优化** — 移动端分区创建增加确认按钮，新增"添加新分区"命令快捷方式
- **Bug 修复** — 卡片拖拽限制在标题/封面区域，修复移动端横幅编辑按钮和抽屉对齐问题

### v1.0.2
- **分区管理** — 支持手动删除分区、分区类型选择器
- **移动端优化** — 改善卡片滚动和移动端布局
- **Bug 修复** — 遵循正文分区顺序，防止表单意外重置

## 兼容性

- Obsidian v0.15.0+
- 桌面端和移动端
- 所有主题均适配亮色和暗色模式

## 许可证

0BSD
