shawnxixi-cli 0.3.0 → 1.1.0

package/README.md

@@ -1,136 +1,416 @@
 # shawnxixi-cli
 
-> 肖嘻 CLI 工具 — OpenClaw 的执行肢
+肖嘻 CLI 工具 - 日常业务与系统管理的命令行接口。
 
 ## 安装
 
 ```bash
-# 从源码编译
+# 从源码安装
 git clone https://github.com/LyuShawn/shawnxixi-cli.git
 cd shawnxixi-cli
 npm install
 npm run build
-
-# 链接到全局
 npm link
+
+# 或全局安装
+npm install -g shawnxixi-cli
 ```
 
-## 配置
+## 初始化配置
 
 ```bash
-# 设置后端地址（可选，默认 http://localhost:8080）
-export SHAWNXIXI_API_URL=http://localhost:8080
+# 复制配置文件
+cp .env.example .env
 
-# 设置 API Token（可选）
-export SHAWNXIXI_API_TOKEN=your-token
+# 编辑配置（可选）
+vim .env
 ```
 
-## 命令
+### 环境变量
+
+| 变量 | 默认值 | 说明 |
+|-----|-------|------|
+| `SHAWNXIXI_API_URL` | `http://localhost:8080/api/v1` | API 服务器地址 |
+| `SHAWNXIXI_API_TOKEN` | - | API 认证 Token（可选） |
+
+## 全局参数
+
+| 参数 | 说明 |
+|-----|------|
+| `--json` | 输出 JSON 格式 |
+| `--quiet` | 静默模式（只输出关键信息） |
+| `--dry-run` | 预览模式（不实际调用 API） |
+
+## 命令总览
+
+```
+shawnxixi <command>
+
+日常业务命令：
+  biz todo      待办管理（对标滴答清单）
+  biz task      任务管理（对标系统任务）
+  biz record    记录管理
+  biz finance   财务管理（对标记账类 App）
+  biz item      物品管理
+  biz calendar  日程管理（对标日历 App）
+  biz health    健康数据管理（对标 Apple Health）
+
+系统命令：
+  sys health    健康检查
+```
+
+---
+
+## biz todo（待办管理）
+
+对标滴答清单的待办管理功能。
+
+### 子命令
+
+| 命令 | 说明 |
+|-----|------|
+| `add <title>` | 创建待办 |
+| `list` | 列出待办 |
+| `edit <id>` | 编辑待办 |
+| `done <id>` | 标记待办完成 |
+| `delete <id>` | 删除待办 |
 
-### 待办 (biz todo)
+### 选项
+
+| 选项 | 说明 |
+|-----|------|
+| `--due <date>` | 截止日期（YYYY-MM-DD） |
+| `--priority <level>` | 优先级（low/medium/high） |
+| `--status <status>` | 状态过滤（pending/done） |
+| `--tags <tags>` | 标签（逗号分隔） |
+
+### 示例
 
 ```bash
 # 创建待办
-shawnxixi biz todo create "开会" --due 2026-04-12 --priority high
+shawnxixi biz todo add "完成项目报告" --due 2026-04-15 --priority high --tags work,important
 
 # 列出所有待办
 shawnxixi biz todo list
 
+# 按状态筛选
+shawnxixi biz todo list --status pending --priority high
+
+# 编辑待办
+shawnxixi biz todo edit 123 --title "新标题" --priority low
+
 # 标记完成
-shawnxixi biz todo done 1
+shawnxixi biz todo done 123
 
 # 删除待办
-shawnxixi biz todo delete 1
+shawnxixi biz todo delete 123
 ```
 
-### 记录 (biz record)
+---
+
+## biz task（任务管理）
+
+对标系统任务的功能，支持 OpenClaw 等来源。
+
+### 子命令
+
+| 命令 | 说明 |
+|-----|------|
+| `list` | 列出任务 |
+| `create <title>` | 创建任务 |
+| `update <id>` | 更新任务 |
+| `delete <id>` | 删除任务 |
+
+### 选项
+
+| 选项 | 说明 |
+|-----|------|
+| `--status <status>` | 状态过滤（pending/running/done） |
+| `--source <source>` | 来源过滤（openclaw/cli） |
+| `--openclaw-id <id>` | OpenClaw ID |
+| `--priority <level>` | 优先级（low/medium/high） |
+
+### 示例
 
 ```bash
-# 创建记录
-shawnxixi biz record create "灵感" --content "想到一个新的app idea" --type idea
+# 列出运行中的任务
+shawnxixi biz task list --status running --source openclaw
 
-# 列出所有记录
-shawnxixi biz record list
+# 创建任务
+shawnxixi biz task create "修复登录 bug" --source openclaw --openclaw-id 456
 
-# 宠物记录
-shawnxixi biz record create "西西体重" --content "3.2kg" --type pet --tags "体重,西西"
+# 更新任务状态
+shawnxixi biz task update 123 --status done
+
+# 删除任务
+shawnxixi biz task delete 123
 ```
 
-### 财务 (biz finance)
+---
+
+## biz finance（财务管理）
+
+对标记账类 App 的财务管理功能。
+
+### 子命令
+
+| 命令 | 说明 |
+|-----|------|
+| `add <amount>` | 新增账单 |
+| `list` | 列出账单 |
+| `stats` | 账单统计 |
+
+### 选项
+
+| 选项 | 说明 |
+|-----|------|
+| `--type <type>` | 类型（income/expense） |
+| `--category <cat>` | 分类 |
+| `--note <text>` | 备注 |
+| `--month <month>` | 月份过滤（YYYY-MM） |
+
+### 示例
 
 ```bash
-# 记账（支出）
-shawnxixi biz finance create 50 --category food --desc "午饭"
+# 记一笔支出
+shawnxixi biz finance add 100 --type expense --category 餐饮 --note 午饭
 
-# 记账（收入）
-shawnxixi biz finance create 15000 --type income --category salary
+# 记一笔收入
+shawnxixi biz finance add 5000 --type income --category 工资 --note 月薪
 
-# 列出财务流水
-shawnxixi biz finance list
+# 按月份查看支出
+shawnxixi biz finance list --type expense --month 2026-04
 
-# 按分类查看
-shawnxixi biz finance list --category food
+# 查看月度统计
+shawnxixi biz finance stats --month 2026-04
 ```
 
-### 物品 (biz item)
+---
+
+## biz health（健康数据）
+
+对标 Apple Health 的健康数据管理。
+
+### 子命令
+
+| 命令 | 说明 |
+|-----|------|
+| `log` | 记录健康数据 |
+| `list` | 查询健康数据 |
+| `sync` | 同步健康数据 |
+
+### 选项
+
+| 选项 | 说明 |
+|-----|------|
+| `--type <type>` | 数据类型（heart_rate/steps/weight/...） |
+| `--value <value>` | 数值 |
+| `--unit <unit>` | 单位（bpm/kg/steps/...） |
+| `--date <date>` | 日期（YYYY-MM-DD） |
+| `--from <date>` | 开始日期 |
+| `--to <date>` | 结束日期 |
+
+### 示例
 
 ```bash
-# 添加物品
-shawnxixi biz item create "阿莫西林" --location "药箱" --expire 2026-12-01 --category "药品"
+# 记录心率
+shawnxixi biz health log --type heart_rate --value 72 --unit bpm --date 2026-04-12
 
-# 列出物品
-shawnxixi biz item list
+# 记录步数
+shawnxixi biz health log --type steps --value 8000 --unit steps --date 2026-04-12
+
+# 查询心率历史
+shawnxixi biz health list --type heart_rate --from 2026-04-01 --to 2026-04-12
+
+# 查询体重
+shawnxixi biz health list --type weight --from 2026-04-01 --to 2026-04-12
 ```
 
-### 日历 (biz calendar)
+---
+
+## biz calendar（日程管理）
+
+对标日历 App 的日程管理功能。
+
+### 子命令
+
+| 命令 | 说明 |
+|-----|------|
+| `add <title>` | 创建日程 |
+| `list` | 列出日程 |
+
+### 选项
+
+| 选项 | 说明 |
+|-----|------|
+| `--from <datetime>` | 开始时间（必需） |
+| `--to <datetime>` | 结束时间（必需） |
+| `--location <loc>` | 地点 |
+| `--color <color>` | 颜色（HEX 如 #ff0000） |
+| `--desc <text>` | 描述 |
+
+### 示例
 
 ```bash
 # 创建日程
-shawnxixi biz calendar create "面试" --start "2026-04-15 14:00" --end "2026-04-15 15:30" --desc "技术面试"
+shawnxixi biz calendar add "团队周会" --from "2026-04-15 10:00" --to "2026-04-15 11:00" --location 会议室A --color #4285f4
+
+# 查看本月日程
+shawnxixi biz calendar list --from 2026-04-01 --to 2026-04-30
+```
+
+---
+
+## biz record（记录管理）
+
+通用记录管理（日记/宠物/笔记/灵感）。
 
-# 列出日程
-shawnxixi biz calendar list
+### 子命令
+
+| 命令 | 说明 |
+|-----|------|
+| `create <title>` | 创建记录 |
+| `list` | 列出记录 |
+
+### 选项
+
+| 选项 | 说明 |
+|-----|------|
+| `--content <text>` | 内容 |
+| `--type <type>` | 类型（diary/pet/note/idea） |
+| `--tags <tags>` | 标签（逗号分隔） |
+
+### 示例
+
+```bash
+# 写日记
+shawnxixi biz record create "今日感想" --content "完成了一个重要功能" --type diary --tags work,daily
+
+# 创建灵感
+shawnxixi biz record create "新功能创意" --content "做一个 AI 助手" --type idea --tags ai,innovation
+
+# 列出所有笔记
+shawnxixi biz record list --type note
 ```
 
-### 健康 (sys health)
+---
+
+## biz item（物品管理）
+
+物品收纳管理功能。
+
+### 子命令
+
+| 命令 | 说明 |
+|-----|------|
+| `create <name>` | 添加物品 |
+| `list` | 列出物品 |
+
+### 选项
+
+| 选项 | 说明 |
+|-----|------|
+| `--location <loc>` | 存放位置 |
+| `--expire <date>` | 过期日期（YYYY-MM-DD） |
+| `--category <cat>` | 分类 |
+
+### 示例
 
 ```bash
-# 同步健康数据
-shawnxixi sys health sync
+# 添加物品
+shawnxixi biz item create "牛奶" --location 冰箱 --expire 2026-04-20 --category 食品
 
-# 查询健康数据
-shawnxixi sys health query steps --from 2026-04-01 --to 2026-04-11
-shawnxixi sys health query heartRate
+# 列出物品
+shawnxixi biz item list --category 食品
 ```
 
-## 开发
+---
+
+## sys（系统命令）
+
+### sys health
+
+健康检查。
 
 ```bash
-# 编译
-npm run build
+shawnxixi sys health
+# 输出: { status: 'ok', timestamp: '2026-04-12T00:00:00.000Z' }
+```
 
-# 测试
-npm test
+---
+
+## 使用示例
+
+### 完整工作流
+
+```bash
+# 1. 创建待办
+shawnxixi biz todo add "准备周五会议" --due 2026-04-18 --priority high --tags work
+
+# 2. 记录一笔支出
+shawnxixi biz finance add 50 --type expense --category 交通 --note打车费
 
-# 发布到 npm（需权限）
-npm publish --access public
+# 3. 记录今日心率
+shawnxixi biz health log --type heart_rate --value 75 --unit bpm
+
+# 4. 创建会议日程
+shawnxixi biz calendar add "产品评审会" --from "2026-04-15 14:00" --to "2026-04-15 16:00" --location 线上
+
+# 5. 查看所有待办
+shawnxixi biz todo list --status pending
+```
+
+### 全局参数使用
+
+```bash
+# JSON 输出
+shawnxixi biz todo list --json
+
+# 静默模式
+shawnxixi biz todo add "测试" --quiet
+
+# 预览模式（不实际调用 API）
+shawnxixi biz todo add "测试待办" --due 2026-04-20 --dry-run
 ```
 
-## 架构
+---
+
+## 故障排查
+
+### API 连接失败
+
+1. 检查 `.env` 中的 `SHAWNXIXI_API_URL` 是否正确
+2. 确认服务器已启动
+3. 检查网络连接
+
+### 命令不存在
+
+```bash
+# 重新链接
+npm link
 
+# 或使用 npx
+npx shawnxixi biz todo list
 ```
-src/
-├── commands/          # 命令实现
-│   ├── biz/          # 业务命令
-│   └── sys/          # 系统命令
-├── services/
-│   └── api.ts        # HTTP 调用层
-└── index.ts          # 入口
+
+---
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式（监听文件变化）
+npm run build
+
+# 运行测试
+npm test
+
+# 链接到全局
+npm link
 ```
 
-## 相关项目
+## License
 
-- [shawnxixi-design](https://github.com/LyuShawn/shawnxixi-design) - 设计/需求文档
-- [shawnxixi-server](https://github.com/LyuShawn/shawnxixi-server) - 后端服务
-- [shawnxixi-skills](https://github.com/LyuShawn/shawnxixi-skills) - Skill 知识库
-- [shawnxixi-app](https://github.com/LyuShawn/shawnxixi-app) - iOS 应用
+ISC

package/commitlint.config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      ['feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'build', 'ci', 'chore', 'revert'],
+    ],
+  },
+};

package/dist/commands/biz/calendar.d.ts

@@ -1,9 +1,24 @@
+/**
+ * biz calendar 命令
+ * 日程管理（对标日历 App）
+ * 子命令：add / list
+ */
 export declare const calendarCommands: {
+    /**
+     * 创建日程
+     * biz calendar add <title> --from <datetime> --to <datetime> --location <loc> --color #ff0000
+     */
     create: (title: string, options?: {
-        start?: string;
-        end?: string;
+        from?: string;
+        to?: string;
+        location?: string;
+        color?: string;
         desc?: string;
     }) => Promise<void>;
+    /**
+     * 列出日程
+     * biz calendar list --from 2026-04-01 --to 2026-04-30
+     */
     list: (options?: {
         from?: string;
         to?: string;

package/dist/commands/biz/calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/commands/biz/calendar.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB;oBACL,MAAM,YAAW;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;qBAchE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE;CASrD,CAAC"}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/commands/biz/calendar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,gBAAgB;IAC3B;;;OAGG;oBACmB,MAAM,YAAW;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAkCvH;;;OAGG;qBACmB;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE;CAyBrD,CAAC"}

package/dist/commands/biz/calendar.js

@@ -1,29 +1,67 @@
 "use strict";
+/**
+ * biz calendar 命令
+ * 日程管理（对标日历 App）
+ * 子命令：add / list
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.calendarCommands = void 0;
 const api_1 = require("../../services/api");
+const output_1 = require("../../utils/output");
 exports.calendarCommands = {
+    /**
+     * 创建日程
+     * biz calendar add <title> --from <datetime> --to <datetime> --location <loc> --color #ff0000
+     */
     create: async (title, options = {}) => {
-        if (!options.start || !options.end) {
-            console.error('必须指定 --start 和 --end 时间');
-            process.exit(1);
-        }
+        const loading = (0, output_1.createLoading)('创建日程...');
         try {
-            const result = await api_1.apiService.createCalendarEvent(title, options.start, options.end, options.desc);
-            console.log(JSON.stringify(result, null, 2));
+            if (!options.from || !options.to) {
+                loading.fail('缺少必需参数 --from 和 --to');
+                (0, output_1.outputError)('Usage: biz calendar add <title> --from <datetime> --to <datetime> [--location <loc>] [--color <color>] [--desc <desc>]');
+                process.exit(1);
+            }
+            if ((0, output_1.isDryRun)()) {
+                loading.stop();
+                (0, output_1.dryRunLog)('创建日程', { title, ...options });
+                return;
+            }
+            loading.start();
+            const result = await api_1.apiService.createCalendarEvent(title, options.from, options.to, options.desc, options.location, options.color);
+            loading.succeed('日程创建成功');
+            (0, output_1.output)(result);
         }
         catch (error) {
-            console.error('创建日程失败:', error.message);
+            loading.fail('创建日程失败');
+            (0, output_1.outputError)(error.message);
             process.exit(1);
         }
     },
+    /**
+     * 列出日程
+     * biz calendar list --from 2026-04-01 --to 2026-04-30
+     */
     list: async (options = {}) => {
+        const loading = (0, output_1.createLoading)('加载日程列表...');
         try {
+            if ((0, output_1.isDryRun)()) {
+                loading.stop();
+                (0, output_1.dryRunLog)('列出日程', options);
+                return;
+            }
+            loading.start();
             const result = await api_1.apiService.listCalendarEvents(options.from, options.to);
-            console.log(JSON.stringify(result, null, 2));
+            loading.succeed('日程列表加载成功');
+            if (result.data && result.data.length > 0) {
+                (0, output_1.output)(result.data);
+            }
+            else {
+                (0, output_1.output)({ message: '暂无日程' });
+            }
         }
         catch (error) {
-            console.error('查询日程失败:', error.message);
+            loading.fail('加载日程列表失败');
+            (0, output_1.outputError)(error.message);
             process.exit(1);
         }
     },

package/dist/commands/biz/calendar.js.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../../src/commands/biz/calendar.ts"],"names":[],"mappings":";;;AAAA,4CAAgD;AAEnC,QAAA,gBAAgB,GAAG;IAC9B,MAAM,EAAE,KAAK,EAAE,KAAa,EAAE,UAA2D,EAAE,EAAE,EAAE;QAC7F,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAU,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,KAAM,EAAE,OAAO,CAAC,GAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACvG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,EAAE,KAAK,EAAE,UAA0C,EAAE,EAAE,EAAE;QAC3D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAU,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../../src/commands/biz/calendar.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,4CAAgD;AAChD,+CAA6F;AAEhF,QAAA,gBAAgB,GAAG;IAC9B;;;OAGG;IACH,MAAM,EAAE,KAAK,EAAE,KAAa,EAAE,UAA4F,EAAE,EAAE,EAAE;QAC9H,MAAM,OAAO,GAAG,IAAA,sBAAa,EAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;gBACrC,IAAA,oBAAW,EAAC,wHAAwH,CAAC,CAAC;gBACtI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,IAAI,IAAA,iBAAQ,GAAE,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,IAAA,kBAAS,EAAC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;gBACzC,OAAO;YACT,CAAC;YAED,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,MAAM,gBAAU,CAAC,mBAAmB,CACjD,KAAK,EACL,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,EAAE,EACV,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,KAAK,CACd,CAAC;YACF,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC1B,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,IAAA,oBAAW,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,EAAE,KAAK,EAAE,UAA0C,EAAE,EAAE,EAAE;QAC3D,MAAM,OAAO,GAAG,IAAA,sBAAa,EAAC,WAAW,CAAC,CAAC;QAE3C,IAAI,CAAC;YACH,IAAI,IAAA,iBAAQ,GAAE,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,IAAA,kBAAS,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC3B,OAAO;YACT,CAAC;YAED,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,MAAM,gBAAU,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7E,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAE5B,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,IAAA,eAAM,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,IAAA,eAAM,EAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,IAAA,oBAAW,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/commands/biz/finance.d.ts

@@ -1,12 +1,43 @@
+/**
+ * biz finance 命令
+ * 财务管理（对标记账类 App）
+ * 子命令：add / list / stats / report
+ */
 export declare const financeCommands: {
+    /**
+     * 新增账单
+     * biz finance add --type expense --amount 100 --category 餐饮 --note 午饭 --account cash --date 2026-04-12 --tags food,lunch
+     */
     create: (amount: string, options?: {
         type?: string;
         category?: string;
-        desc?: string;
+        note?: string;
+        account?: string;
+        date?: string;
+        tags?: string;
     }) => Promise<void>;
+    /**
+     * 列出账单
+     * biz finance list --type expense --month 2026-04
+     */
     list: (options?: {
         type?: string;
         category?: string;
+        month?: string;
+    }) => Promise<void>;
+    /**
+     * 统计账单
+     * biz finance stats --month 2026-04
+     */
+    stats: (options?: {
+        month?: string;
+    }) => Promise<void>;
+    /**
+     * 月度报表
+     * biz finance report --month 2026-04
+     */
+    report: (options?: {
+        month?: string;
     }) => Promise<void>;
 };
 //# sourceMappingURL=finance.d.ts.map

package/dist/commands/biz/finance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finance.d.ts","sourceRoot":"","sources":["../../../src/commands/biz/finance.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe;qBACH,MAAM,YAAW;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;qBAiBrE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CAS3D,CAAC"}
+{"version":3,"file":"finance.d.ts","sourceRoot":"","sources":["../../../src/commands/biz/finance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,eAAe;IAC1B;;;OAGG;qBACoB,MAAM,YAAW;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IA+B3I;;;OAGG;qBACmB;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IA0B1E;;;OAGG;sBACoB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAuBzC;;;OAGG;uBACqB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAsB3C,CAAC"}