# nobt-todo

**Repository Path**: nobt/nobt-todo

## Basic Information

- **Project Name**: nobt-todo
- **Description**: 待办管理
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nobtodo

轻量本地待办工具。本机单人使用，数据保存在项目目录：

## 示例预览

### 1. 画布工作台与提醒面板

![Nobtodo 画布工作台与提醒面板](docs/images/1.png)

自由网格画布展示多个待办卡片，支持不规则尺寸和位置布局；右下角提醒面板常驻显示到期提醒，并支持单条确认、关闭和全部确认。

### 2. 左侧列表导航

![Nobtodo 左侧列表导航](docs/images/2.png)

侧边栏展示全部卡片列表、未完成数量、颜色标识和删除入口；点击列表可定位到对应画布卡片，侧边栏也可收起以释放工作区宽度。

### 3. 搜索与拼音检索

![Nobtodo 搜索与拼音检索](docs/images/3.png)

顶部悬浮搜索框支持任务和列表搜索，同时支持中文、拼音全拼和拼音首字母检索；`Ctrl+F` 可快速唤起搜索。

### 4. 暗黑主题

![Nobtodo 暗黑主题](docs/images/4.png)

提供明亮和暗黑主题，覆盖画布、卡片、侧边栏、提醒面板、滚动条和工具栏等主要界面元素。

### 5. 设置面板

![Nobtodo 设置面板](docs/images/5.png)

设置面板支持主题切换、新增任务顺序设置、默认最大化画布、背景网格显示、数据目录查看、备份导出和备份导入。

## 功能列表

- 本地网页待办工具，默认运行在 `http://127.0.0.1:8189`。
- 数据存储在项目 `data` 目录，包含任务数据、图片附件、缩略图和备份文件。
- 单窗口工作台，左侧列表导航可展开/收起。
- 中间区域为可缩放、可拖拽平移的网格画布。
- 卡片支持自由拖拽、调整大小、折叠/展开、颜色修改和删除。
- 顶部工具栏支持一键折叠/展开全部卡片；`Alt+<` / `Alt+>` 快捷键会按当前多选卡片、激活卡片或全局范围折叠/展开。
- 支持 `Ctrl` + 鼠标单击多选多个卡片，拖拽任一已选卡片时可将多张卡片作为一组同步移动。
- 卡片底部或底角调整大小区域支持双击自适应高度，自动扩展到完整展示当前卡片内容。
- 卡片可一键自动整理，执行前会二次确认。
- 卡片可不规则摆放，也可通过辅助线进行中线和底部对齐。
- 卡片激活后置顶，激活边框动画使用当前卡片颜色。
- 画布支持最大化展示，最大化后隐藏顶部栏和抽屉，仅保留画布区域；右上角提供固定悬浮的退出最大化按钮。
- 设置中可控制启动后是否默认最大化画布。
- 最大化状态下仍可通过 `Alt+S` 展开侧边栏，侧边栏以左侧悬浮抽屉形式覆盖在画布上。
- 设置中可控制画布是否显示背景网格，关闭后保留卡片、滚动、拖拽和对齐线能力。
- 待办可在卡片内直接新增、编辑、完成、删除和调整顺序。
- 新增待办默认顺序追加，也可在设置中改为倒序添加。
- 删除图片、删除卡片、删除待办支持 `Ctrl+Z` 撤销。
- 待办支持补充说明，补充说明支持列表语法：`- `、`1. `、`a. `。
- 待办补充说明可按单条折叠/展开，也可按卡片整体展开/折叠。
- 待办支持图片附件，图片显示为紧凑缩略图，双击可按顺序预览。
- 图片预览支持上一张/下一张切换，首尾图片会禁用对应方向。
- 待办支持提醒时间，到期后在右下角提醒面板显示。
- 提醒面板展示任务标题、所属卡片列表和提醒时间。
- 同一待办修改提醒时间时会更新已有提醒，不会重复新增。
- 提醒可单条确认、关闭，也可全部确认；确认后刷新不再重复显示。
- 支持明亮/暗黑主题切换，默认明亮。
- 支持搜索任务和列表，支持中文、拼音全拼、拼音首字母。
- 主界面搜索默认隐藏，可通过搜索图标或 `Ctrl+F` 唤起。
- 支持 `Alt+N` 快捷新增；Chrome 保留 `Ctrl+N`，不作为推荐快捷键。
- 支持导出和导入单个 zip 备份包，包内包含 `todo.json`、图片和缩略图文件，可恢复文字、图片、布局和设置；旧版 JSON 备份仍可导入。

## 快捷键

- `Ctrl+F`：打开顶部搜索框。
- `Alt+N`：新增。存在激活卡片时新增待办；没有激活卡片时在当前视口新增卡片列表。
- `Alt+S`：展开或收起侧边栏；最大化画布时也可使用。
- `Alt+<` / `Alt+,`：折叠卡片。已多选卡片时作用于多选卡片；否则有激活卡片时作用于激活卡片；没有激活卡片时作用于全部卡片。
- `Alt+>` / `Alt+.`：展开卡片。已多选卡片时作用于多选卡片；否则有激活卡片时作用于激活卡片；没有激活卡片时作用于全部卡片。
- `Alt+=` / `Alt++`：以当前激活卡片为中心放大画布。
- `Alt+-`：以当前激活卡片为中心缩小画布。
- `Alt+0`：恢复 100% 缩放，并把画布滚动到左上角。
- `F11`：最大化或退出最大化画布。
- `Enter`：在激活待办上打开并聚焦补充说明。
- `Ctrl+Z`：撤销最近一次删除图片、删除待办或删除卡片。
- `Ctrl` + 鼠标单击卡片空白区域：切换卡片多选状态。
- 鼠标滚轮：在画布空白区域滚动时缩放画布；在卡片内滚动时滚动卡片内容。
- 鼠标双击卡片底部或底角调整大小区域：自适应卡片高度。

## 设置项

- 主题：明亮 / 暗黑。
- 新增任务：顺序添加 / 倒序添加。
- 画布：是否默认最大化，是否显示背景网格，背景网格默认显示。
- 数据：查看本地数据目录，导出 zip 备份包，导入 zip 备份包或旧版 JSON 备份。

```text
data/
```

## 使用

```bash
npm install
npm run build
npm run web
```

打开：

```text
http://127.0.0.1:8189
```

## 开发

```bash
npm run web
npm run dev
```

开发页面地址为 `http://127.0.0.1:1420`，API 由 `8189` 端口的本地服务写入 `data` 目录。