# task-manager

**Repository Path**: zijian666/task-manager

## Basic Information

- **Project Name**: task-manager
- **Description**: 适用于 AI 的 CLI 驱动个人本地任务管理工具。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-03
- **Last Updated**: 2026-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# task-manager

适用于 AI 的 CLI 驱动个人本地任务管理工具。


## 目标

- 面向个人使用，不包含权限、登录、用户管理等多人协作能力。
- 使用 Node.js 命令行在本地维护任务数据。
- 提供全静态网页模板，用于展示任务数据。
- 不使用 webpack，不依赖数据库服务，不暴露数据操作 API。

## 核心功能

- 支持待办、工作记录、显式关联、工作日例外和值班日期。
- 待办承载计划，工作记录承载事实，避免计划与执行混在同一类数据里。
- 任务属性尽可能完整，但保持可选，避免强制填写带来的使用负担。
- 数据量按个人日常使用设计，通常每天十几条任务以内。

## 初始技术方向

- 命令行：Node.js。
- 数据存储：`data/tasks.json`。
- 页面：静态 HTML、CSS、JavaScript。

## 使用方式

查看帮助：

```bash
node cli.js help
```

首次使用时设置项目：

```bash
node cli.js config --export-dir publish --site-title "个人任务看板" --init
```

新增待办：

```bash
node cli.js todo-add "整理任务管理项目" --status planned --tags personal
```

新增工作记录：

```bash
node cli.js work-add "完成数据结构设计" --tags dev
```

新增值班日期：

```bash
node cli.js duty-add 2026-05-03
```

列出待办：

```bash
node cli.js todo-list
```

关联待办和工作：

```bash
node cli.js relate TODO_ID WORK_ID
```

新增工作日例外（法定节假日 / 补班日）：

```bash
node cli.js workday-add 2026-10-01 --type rest --desc "国庆节"
node cli.js workday-add 2026-05-09 --type work --desc "劳动节调休上班"
```

列出工作日例外：

```bash
node cli.js workday-list --year 2026
```

导出工作日志为 Markdown：

```bash
node cli.js export --from 2026-05-01 --to 2026-05-15
```

命令行操作后，静态页面直接读取同一数据文件，无需额外导出步骤。
打开 `<exportDir>/index.html` 即可查看只读任务看板。

## 界面预览

首页日历概览（点击日期查看当日待办与工作记录）：

![首页概览](assets/screenshot-home-2026-04-28.png)

本月待办列表：

![本月待办](assets/screenshot-home-month-todos.png)

工作详情页（双击日历日期进入）：

![工作详情](assets/screenshot-day-2026-04-28.png)

全部工作归档（支持按时间范围筛选）：

![全部工作](assets/screenshot-works-2026-05-01-to-05-04.png)

## 目录说明

- `src/`：命令行与任务操作代码。
- `src/config.json`：项目设置。
- `<exportDir>/data/tasks.json`：本地任务数据（命令行和静态页面共用）。
- `src/public/`：静态展示页面模板。
- `docs/prd/task-manager.md`：需求说明。
- `docs/spec/data-structure-v3.md`：当前数据结构说明。