@wangjs-jacky/ticktick-cli 0.1.0

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,26 @@
+name: 发布到 npm
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - run: npm ci
+
+      - run: npm test
+
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CLAUDE.md

@@ -0,0 +1,34 @@
+# tt-cli
+
+滴答清单（TickTick）命令行工具。
+
+## 开发约定
+
+- TypeScript strict 模式
+- 注释和输出文案使用中文
+- npm 包名：`@wangjs-jacky/ticktick-cli`
+- ESM only，target node18
+
+## 架构要点
+
+- **OAuth2 流程**：本地 HTTP 服务器监听回调 → 浏览器打开授权页 → code 换 token
+- **Token 自动刷新**：`apiRequest` 发请求前检查有效性，过期自动刷新
+- **CSRF 防护**：授权请求携带随机 state 参数，回调时校验
+
+## 调试经验
+
+- **"无输出"≠"无报错"**：命令静默退出时，优先排查命令注册/匹配问题
+- **401 先验端点再验 token**：用 `fetch` 直接测试不同 API 端点，比猜测 token 过期更快定位
+- **验证轮次要克制**：确认 bug 后立即转向修复，不要反复验证同一结论
+- **日期格式**：TickTick API 要求 `"2026-04-04T19:00:00.000+0800"`（有毫秒，时区无冒号）。`utils/format.ts` 的 `normalizeTickTickDate()` 已自动转换
+
+## cac 子命令约束
+
+`cac` v7 不支持空格分隔的子命令名，必须用连字符（`task-list`）。`index.ts` 中 `SUBCOMMAND_GROUPS` 做了预处理，用户可输入 `tt task list`。**新增子命令时必须同时更新命令注册和 `SUBCOMMAND_GROUPS`**。
+
+## 参考文档
+
+- [项目开发指南](docs/reference/project-guide.md)：技术栈、常用命令、项目结构、配置存储、区域系统
+- [CLI 操作手册](docs/reference/cli-usage-guide.md)：所有已实现命令的完整用法
+- [OAuth 2.0 认证架构设计](docs/oauth-credential-pre-validation.md)：授权码模式完整流程
+- [滴答清单 Open API（中文）](docs/reference/dida365-open-api-zh.md) / [英文](docs/reference/dida365-open-api.md)

package/README.md

@@ -0,0 +1,62 @@
+# tt-cli
+
+[![npm version](https://img.shields.io/npm/v/@wangjs-jacky/ticktick-cli.svg)](https://www.npmjs.com/package/@wangjs-jacky/ticktick-cli) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+English | [中文](./README_CN.md)
+
+A command-line tool for TickTick (滴答清单), supporting both China region (dida365.com) and Global region (ticktick.com).
+
+## Install
+
+```bash
+npm install -g @wangjs-jacky/ticktick-cli
+```
+
+## Usage
+
+### First-time Login
+
+```bash
+tt login
+```
+
+You'll be prompted for Client ID and Client Secret. Register your app at [TickTick Developer Platform](https://developer.ticktick.com/app) first.
+
+Set Redirect URI to: `http://localhost:3000/callback`
+
+### Switch Region
+
+```bash
+tt config --region cn      # China region (dida365.com)
+tt config --region global   # Global region (ticktick.com)
+```
+
+### Daily Use
+
+```bash
+tt whoami    # Check login status
+tt logout    # Log out
+tt config    # View configuration
+```
+
+## Development
+
+```bash
+npm install        # Install dependencies
+npm run build      # Build
+npm test           # Run tests
+npm run dev        # Watch mode
+```
+
+## Tech Stack
+
+| Category | Choice |
+|----------|--------|
+| CLI Framework | `cac` |
+| Terminal UI | `@clack/prompts` + `picocolors` |
+| Build | `tsup` (ESM only) |
+| Test | `vitest` |
+
+## License
+
+MIT

package/README_CN.md

@@ -0,0 +1,62 @@
+# tt-cli
+
+[![npm version](https://img.shields.io/npm/v/@wangjs-jacky/ticktick-cli.svg)](https://www.npmjs.com/package/@wangjs-jacky/ticktick-cli) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[English](./README.md) | 中文
+
+滴答清单（TickTick）命令行工具，支持国内版（dida365.com）和国际版（ticktick.com）双区域。
+
+## 安装
+
+```bash
+npm install -g @wangjs-jacky/ticktick-cli
+```
+
+## 使用
+
+### 首次登录
+
+```bash
+tt login
+```
+
+首次使用会提示输入 Client ID 和 Client Secret，需要先到 [TickTick 开发者平台](https://developer.ticktick.com/app) 注册应用。
+
+注册时 Redirect URI 设置为：`http://localhost:3000/callback`
+
+### 区域切换
+
+```bash
+tt config --region cn      # 切换到国内版（dida365.com）
+tt config --region global   # 切换到国际版（ticktick.com）
+```
+
+### 日常使用
+
+```bash
+tt whoami    # 查看登录状态
+tt logout    # 登出
+tt config    # 查看配置
+```
+
+## 开发
+
+```bash
+npm install        # 安装依赖
+npm run build      # 构建
+npm test           # 运行测试
+npm run dev        # 监听模式开发
+```
+
+## 技术栈
+
+| 类别 | 方案 |
+|------|------|
+| CLI 框架 | `cac` |
+| 终端 UI | `@clack/prompts` + `picocolors` |
+| 构建 | `tsup`（ESM only） |
+| 测试 | `vitest` |
+
+## License
+
+MIT

package/bin/cli.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }