@walknpm/todo-cli 1.1.0 → 2.0.0

package/README.zh-CN.md

@@ -1,10 +1,11 @@
 # todo-cli
 
-> **简体中文** | [English](./README.md)
+> [English](./README.md) | **简体中文**
 
-一个零依赖的 Node.js 命令行待办事项管理器。支持完整的增删改查、完成状态切换、
-分类/标签、优先级排序、截止日期（含逾期高亮）、搜索、统计概览，以及导出
-（JSON / CSV / Markdown）。数据持久化到 `~/.todo-cli/todos.json`。
+一个零依赖的 Node.js 待办事项管理器，支持 **CLI + Web 界面**。完整的增删改查、
+子任务、循环任务、任务依赖、时间追踪、置顶、批量操作、分类/标签、优先级排序、
+截止日期、搜索、统计、看板、日历视图、时间线、导出（JSON / CSV / Markdown）
+和自动更新。数据保存在 `~/.todo-cli/todos.json`。
 
 ## 环境要求
 
@@ -12,191 +13,198 @@
 
 ## 快速安装
 
+**通过 npm：**
+
 ```bash
-git clone https://gitcode.com/hw_aishell_projects/todo_cli.git
-cd todo_cli
-npm install -g .
-todo --version   # → todo v1.0.0
+npm install -g @walknpm/todo-cli
+todo --version   # → todo v2.0.0
 ```
 
-## 命令一览
-
-| 命令                  | 说明                                               |
-| --------------------- | -------------------------------------------------- |
-| `add <标题>`          | 添加新待办                                         |
-| `list`                | 列出待办（默认命令）                               |
-| `done <id>`           | 标记完成（`done --all` = 全部完成）                |
-| `toggle <id>`         | 切换完成 / 待办状态                                |
-| `edit <id>`           | 编辑待办                                           |
-| `delete <id>`         | 删除待办                                           |
-| `search <关键词>`     | 搜索标题 / 标签 / 分类 / 备注                      |
-| `stats`               | 显示统计概览                                       |
-| `export [json\|csv\|md]` | 导出全部待办到标准输出                          |
-| `archive`             | 归档（删除所有已完成项）                           |
-| `update`              | 自动更新到最新版（`--check` = 仅检查不安装）       |
-| `clear`               | 清空所有待办                                       |
-| `help`                | 显示帮助                                           |
-
-`-h` / `--help` 可附加在**任意命令**后（或单独使用）显示帮助。
-`-v` / `--version` 显示版本号。
-
-## 参数标志
-
-| 标志                   | 适用命令         | 说明                                       |
-| ---------------------- | ---------------- | ------------------------------------------ |
-| `-p, --priority <v>`   | add, edit        | `high` \| `medium` \| `low`（默认: medium） |
-| `-t, --tags <v>`       | add, edit        | 逗号分隔的标签                             |
-| `-c, --category <v>`   | add, edit        | 分类名称                                   |
-| `-d, --due <v>`        | add, edit        | 截止日期 `YYYY-MM-DD`                      |
-| `--note <v>`           | add, edit        | 较长的备注 / 描述                          |
-| `--title <v>`          | edit             | 新标题                                     |
-| `--status <v>`         | list             | `all` \| `done` \| `pending`               |
-| `--tag <v>`            | list             | 按标签过滤                                 |
-| `--sort <v>`           | list             | `priority` \| `created` \| `due` \| `id`   |
-| `--all`                | done             | 完成所有待办项                             |
-| `--check`              | update           | 仅检查是否有更新，不安装                    |
-| `--format <v>`         | export           | `json` \| `csv` \| `md`（默认: json）      |
-
-## 使用示例
+**通过 git：**
 
 ```bash
-# 添加待办（含截止日期、优先级、标签、分类、备注）
-todo add "提交报税单" -p high -d 2025-01-31 -c finance -t urgent,monthly --note "附上收据"
-
-# 列出与过滤
-todo list
-todo list --status pending --sort due
-todo list --category work --priority high
-
-# 搜索
-todo search 报税
-
-# 批量完成与归档
-todo done --all
-todo archive
+git clone https://gitcode.com/hw_aishell_projects/todo_cli.git
+cd todo_cli
+npm install -g .
+todo --version   # → todo v2.0.0
+```
 
-# 统计概览
-todo stats
+## 🚀 Web 界面
 
-# 自动更新
-todo update --check   # 检查是否有新版本
-todo update           # 安装最新版本
+启动 Web 服务器：
 
-# 导出
-todo export csv > todos.csv
-todo export md
+```bash
+todo web              # 默认端口 3456
+todo web 8080         # 自定义端口
+npm run web           # 通过 npm 脚本
 ```
 
-## 项目结构
+然后在浏览器中打开 **http://localhost:3456**。
+
+### Web 界面功能
+
+| 功能 | 说明 |
+| ---- | ---- |
+| **仪表盘** | 统计卡片、完成率、最近待办、即将到期 |
+| **列表视图** | 完整待办列表，支持行内操作、筛选、排序、搜索 |
+| **看板** | 拖拽在"待办"和"已完成"列之间移动 |
+| **日历** | 月历视图，待办按截止日期显示 |
+| **时间线** | 所有待办的时间顺序活动流 |
+| **添加/编辑弹窗** | 完整表单，包含循环和置顶 |
+| **详情视图** | 子任务管理、依赖关系、时间戳、快捷操作 |
+| **时间追踪** | 启动/停止计时器，浮动计时器组件 |
+| **深色/浅色主题** | 切换并保存到 localStorage |
+| **响应式** | 适配桌面、平板和手机 |
+| **键盘快捷键** | `n` = 新建待办，`/` = 搜索，`Esc` = 关闭弹窗 |
+
+## 命令
+
+### 核心命令
+
+| 命令 | 说明 |
+| ---- | ---- |
+| `add <标题>` | 添加新待办 |
+| `list` | 列出待办（默认命令） |
+| `show <id>` | 查看待办详情 |
+| `done <id>` | 标记完成（`done --all` = 全部完成） |
+| `toggle <id>` | 切换完成/待办状态 |
+| `edit <id>` | 编辑待办 |
+| `delete <id>` | 删除待办（别名：`rm`、`remove`） |
+| `duplicate <id>` | 复制待办（别名：`dup`） |
+| `pin <id>` | 切换置顶状态 |
+| `search <关键词>` | 搜索标题/标签/分类/备注/负责人 |
+| `stats` | 显示统计信息 |
+| `export [json\|csv\|md]` | 导出所有待办 |
+| `archive` | 归档（删除）所有已完成的待办 |
+| `clear` | 删除所有待办 |
+| `web [端口]` | 启动 Web 界面服务器（默认：3456） |
+| `update` | 更新到最新版本（`--check` = 仅检查） |
+| `help` | 显示帮助 |
+
+### 子任务
 
-```
-todo_cli/
-├── bin/
-│   └── todo.js        # 可执行入口（shebang）
-├── src/
-│   ├── store.js       # JSON 文件持久化层
-│   ├── todo.js        # 领域逻辑（增删改查、搜索、统计、导出等）
-│   └── cli.js         # 命令解析、ANSI 彩色、表格输出
-├── package.json
-├── README.md          # 英文文档
-└── README.zh-CN.md    # 中文文档
+```bash
+todo subtask add <id> <标题>        # 添加子任务
+todo subtask done <id> <sid>         # 切换子任务完成状态
+todo subtask edit <id> <sid> <标题>  # 编辑子任务标题
+todo subtask delete <id> <sid>       # 删除子任务
 ```
 
----
+### 循环任务
 
-## 🤖 AI 自动部署提示词
+```bash
+todo recur <id> daily   [间隔]   # 每 N 天重复
+todo recur <id> weekly  [间隔]   # 每 N 周重复
+todo recur <id> monthly [间隔]   # 每 N 月重复
+todo recur <id> yearly  [间隔]   # 每 N 年重复
+todo recur <id> off              # 取消循环
+```
 
-> 以下提示词可直接粘贴给 AI 助手（如 Claude、ChatGPT、DeepSeek 等），AI 会自动完成部署。
-> 复制对应场景的代码块即可。
+当循环待办被标记为完成时，会自动创建一个新的待办实例，截止日期按循环间隔推进。
 
-### 场景一：从零安装并验证
+### 任务依赖
 
-```
-请帮我安装部署 todo-cli 命令行待办工具，步骤如下：
-
-1. 克隆仓库：git clone https://gitcode.com/hw_aishell_projects/todo_cli.git
-2. 进入目录：cd todo_cli
-3. 全局安装：npm install -g .
-4. 验证安装：运行 todo --version，确认输出 "todo v1.0.0"
-5. 功能验证：依次执行以下命令并确认每步输出正常：
-   - todo add "部署测试任务" -p high -t test -c verify
-   - todo list
-   - todo done 1
-   - todo stats
-   - todo clear
-6. 如果任何步骤报错，请展示完整错误信息并尝试修复。
-
-完成后告诉我安装路径和 todo --version 的输出。
+```bash
+todo dep add <id> <依赖id>     # 添加依赖（阻止完成）
+todo dep remove <id> <依赖id>  # 移除依赖
 ```
 
-### 场景二：安装 + 导入已有数据
+### 时间追踪
 
+```bash
+todo timer start <id>         # 开始计时（会停止其他正在运行的计时器）
+todo timer stop <id>          # 停止计时并记录时间
+todo timer log <id> <分钟>    # 手动记录时间
+todo timer                    # 查看活动计时器
 ```
-请帮我部署 todo-cli 并导入已有待办数据：
-
-1. 克隆并安装：
-   git clone https://gitcode.com/hw_aishell_projects/todo_cli.git
-   cd todo_cli && npm install -g .
 
-2. 确认 todo --version 正常输出。
+### 批量操作
 
-3. 以下是我的待办事项，请逐条用 todo add 命令创建（根据内容自动判断优先级、分类和标签）：
-   - [在此粘贴你的待办列表，每行一条]
-
-4. 创建完成后运行 todo list 和 todo stats，把结果展示给我确认。
+```bash
+todo bulk done <ids...>              # 批量完成
+todo bulk delete <ids...>            # 批量删除
+todo bulk priority <ids...> -p <值>  # 批量设置优先级
+todo bulk category <ids...> -c <值>  # 批量设置分类
+todo bulk assign <ids...> --assignee <值>  # 批量设置负责人
 ```
 
-### 场景三：卸载
+## 示例
 
-```
-请帮我卸载 todo-cli 工具：
+```bash
+# 添加包含所有字段的待办
+todo add "提交报税单" -p high -d 2025-01-31 -c finance -t urgent,monthly --note "附上收据" --estimate 120 --assignee bob
 
-1. 运行 npm uninstall -g todo-cli
-2. 删除数据文件：rm -rf ~/.todo-cli
-3. 运行 todo --version 确认已无法找到该命令
-4. 告诉我卸载是否成功。
-```
+# 列表与筛选
+todo list --status pending --sort due
+todo list --overdue
+todo list --category work --priority high
 
-### 场景四：更新到最新版本
+# 子任务
+todo subtask add 1 "调研方案"
+todo subtask add 1 "撰写草稿"
+todo subtask done 1 1
 
-```
-请帮我更新 todo-cli 到最新版本：
+# 循环任务
+todo recur 3 weekly 1
+todo done 3   # 自动创建下周的新实例
 
-1. 运行 todo update --check 检查是否有新版本
-2. 如果有更新，运行 todo update 自动安装最新版
-3. 运行 todo --version 确认版本号已更新
-4. 运行 todo list 确认已有数据未丢失
-5. 告诉我更新结果。
-```
+# 任务依赖
+todo dep add 5 3   # 待办 #5 在 #3 完成前被阻止
 
-### 场景五：完整部署（含数据备份与恢复）
+# 时间追踪
+todo timer start 2
+todo timer stop 2
+todo timer log 2 30
 
-```
-请帮我完成 todo-cli 的完整部署流程：
+# 置顶与复制
+todo pin 1
+todo duplicate 3
 
-【安装】
-1. git clone https://gitcode.com/hw_aishell_projects/todo_cli.git
-2. cd todo_cli && npm install -g .
-3. 确认 todo --version 输出版本号
+# 批量操作
+todo bulk done 1 2 3
+todo bulk priority 1 2 3 -p high
 
-【备份】（如果 ~/.todo-cli/todos.json 已存在）
-4. 如果存在 ~/.todo-cli/todos.json，先备份到 ~/todo-backup-$(date +%Y%m%d).json
-5. 确认备份文件内容有效
+# Web 界面
+todo web 8080
 
-【验证】
-6. 执行 todo add "验证任务" -p medium 并确认输出
-7. 执行 todo list 确认表格正常显示
-8. 执行 todo delete 1 清理验证数据
+# 统计
+todo stats
 
-【恢复】（如果有备份）
-9. 如果之前做了备份，将备份文件复制回 ~/.todo-cli/todos.json
-10. 执行 todo list 确认数据已恢复
+# 导出
+todo export csv > todos.csv
+todo export md
 
-最后汇总报告：安装状态、版本号、备份/恢复状态。
+# 自动更新
+todo update --check
+todo update
 ```
 
----
+## 项目结构
+
+```
+todo_cli/
+├── bin/
+│   └── todo.js            # 可执行入口
+├── src/
+│   ├── store.js           # JSON 文件持久化层
+│   ├── todo.js            # 领域逻辑（增删改查、子任务、循环、依赖、计时、批量...）
+│   ├── cli.js             # 命令解析、ANSI 颜色、表格输出
+│   └── server.js          # 零依赖 HTTP 服务器（REST API + 静态文件）
+├── web/
+│   ├── index.html         # SPA 外壳
+│   ├── css/
+│   │   └── style.css      # 现代响应式设计（深色/浅色主题）
+│   └── js/
+│       └── app.js         # SPA 应用逻辑（仪表盘、列表、看板、日历、时间线）
+├── skill/
+│   ├── SKILL.md
+│   ├── README.md
+│   └── CHANGELOG.md
+├── package.json
+├── README.md              # 英文文档
+└── README.zh-CN.md        # 中文文档
+```
 
-## 开源协议
+## 许可证
 
 MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walknpm/todo-cli",
-  "version": "1.1.0",
-  "description": "A zero-dependency Node.js CLI todo list manager with CRUD, due dates, search, stats, export, and auto-update.",
+  "version": "2.0.0",
+  "description": "A zero-dependency Node.js CLI + Web todo list manager with subtasks, recurring, dependencies, time tracking, kanban, calendar, and more.",
   "type": "module",
   "main": "src/cli.js",
   "bin": {
@@ -11,7 +11,9 @@
     "node": ">=18"
   },
   "scripts": {
-    "start": "node bin/todo.js"
+    "start": "node bin/todo.js",
+    "web": "node src/server.js",
+    "dev": "node src/server.js 3456"
   },
   "keywords": [
     "todo",
@@ -19,18 +21,30 @@
     "task",
     "productivity",
     "todo-list",
-    "command-line"
+    "command-line",
+    "web-ui",
+    "kanban",
+    "calendar",
+    "subtasks",
+    "recurring",
+    "time-tracking"
   ],
   "author": "walknpm",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://gitcode.com/hw_aishell_projects/todo_cli.git"
+    "url": "https://gitcode.com/hw_aishell_projects/todo-web.git"
+  },
+  "homepage": "https://gitcode.com/hw_aishell_projects/todo-web",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
-  "homepage": "https://gitcode.com/hw_aishell_projects/todo_cli",
   "files": [
     "bin/",
     "src/",
+    "web/",
+    "skill/",
     "README.md",
     "README.zh-CN.md"
   ]

package/skill/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## v1.0.0
+
+- 初始版本
+- 封装 todo-cli 全部命令：add/list/done/toggle/edit/delete/remove/search/stats/export/archive/update/clear
+- 支持 4 个工作流模板：项目规划、每日回顾、Bug 跟踪、导出汇报
+- 包含最佳实践和错误处理指南

package/skill/README.md

@@ -0,0 +1,48 @@
+# todo-cli-harness
+
+通过 `todo-cli` 命令行工具进行任务管理的 DSH Skill。
+
+**核心特性**：
+- **全命令覆盖**：增删改查、完成切换、搜索、统计、导出、自动更新
+- **结构化任务管理**：优先级、分类、标签、截止日期、备注
+- **工作流模板**：项目规划、每日回顾、Bug 跟踪、导出汇报
+- **零依赖**：仅需 Node.js >= 18 和 `todo` CLI
+
+## 命令一览
+
+| 命令 | 说明 |
+|------|------|
+| `add` | 添加任务（支持优先级/标签/分类/截止日期/备注） |
+| `list` | 列出与过滤（按状态/分类/标签/优先级/排序） |
+| `done` | 标记完成（`--all` 批量完成） |
+| `toggle` | 切换完成/待办状态 |
+| `edit` | 编辑任务 |
+| `delete` / `remove` / `rm` | 删除任务 |
+| `search` | 搜索标题/标签/分类/备注 |
+| `stats` | 统计概览 |
+| `export` | 导出 JSON/CSV/Markdown |
+| `archive` | 归档已完成任务 |
+| `update` | 自动更新工具 |
+| `clear` | 清空全部任务 |
+
+## 安装
+
+```bash
+npm install -g @walknpm/todo-cli
+```
+
+## 使用
+
+加载本 skill 后，AI Agent 会获得 `todo` CLI 的完整使用指南，包括：
+- 所有命令的语法和示例
+- 4 个常用工作流模板
+- 最佳实践和错误处理指南
+
+## 文件结构
+
+```
+skill/
+├── SKILL.md       # 技能指令（加载后生效）
+├── README.md      # 本文档
+└── CHANGELOG.md   # 变更记录
+```