shawnxixi-cli 0.3.0 → 1.1.0

package/src/services/api.ts

@@ -4,8 +4,9 @@
  */
 
 import axios, { AxiosInstance } from 'axios';
+import { envConfig } from '../utils/env';
 
-const API_BASE = process.env.SHAWNXIXI_API_URL || 'http://server.shawnxixi.icu';
+const API_BASE = envConfig.API_URL;
 
 /** Normalize date/datetime strings to LocalDateTime format (ISO 8601 without timezone) */
 function toLocalDateTime(value?: string): string | undefined {
@@ -62,8 +63,7 @@ class ApiService {
   }
 
   private async getToken(): Promise<string | null> {
-    // TODO: 从 Keychain 读取 token
-    return process.env.SHAWNXIXI_API_TOKEN || null;
+    return envConfig.API_TOKEN || process.env.SHAWNXIXI_API_TOKEN || null;
   }
 
   private async refreshToken(): Promise<void> {
@@ -71,23 +71,30 @@ class ApiService {
   }
 
   // ============ Todo API ============
-  async createTodo(title: string, dueDate?: string, priority?: string) {
+  async createTodo(title: string, dueDate?: string, priority?: string, tags?: string, repeatRule?: string, repeatEndDate?: string, parentId?: string) {
     const { data } = await this.client.post('/api/v1/todos', {
       title,
       dueDate: toLocalDateTime(dueDate),
       priority: priority || 'medium',
       status: 'pending',
+      tags,
+      repeatRule,
+      repeatEndDate: toLocalDateTime(repeatEndDate),
+      parentId,
     });
     return data;
   }
 
-  async listTodos(status?: string) {
-    const params = status ? { status } : {};
+  async listTodos(status?: string, priority?: string, tags?: string) {
+    const params: Record<string, string> = {};
+    if (status) params.status = status;
+    if (priority) params.priority = priority;
+    if (tags) params.tags = tags;
     const { data } = await this.client.get('/api/v1/todos', { params });
     return data;
   }
 
-  async updateTodo(id: number, updates: Partial<{title: string; status: string; priority: string; dueDate: string}>) {
+  async updateTodo(id: number, updates: Partial<{title: string; status: string; priority: string; dueDate: string; tags: string}>) {
     const { data } = await this.client.patch(`/api/v1/todos/${id}`, updates);
     return data;
   }
@@ -97,6 +104,18 @@ class ApiService {
     return data;
   }
 
+  async repeatTodo(id: number) {
+    const { data } = await this.client.post(`/api/v1/todos/${id}/repeat`);
+    return data;
+  }
+
+  async listSubtasks(parentId: number) {
+    const params: Record<string, string> = {};
+    if (parentId) params.parentId = String(parentId);
+    const { data } = await this.client.get('/api/v1/todos', { params });
+    return data;
+  }
+
   // ============ Record API ============
   async createRecord(title: string, content: string, type: string = 'diary', tags?: string) {
     const { data } = await this.client.post('/api/v1/records', {
@@ -117,25 +136,58 @@ class ApiService {
   }
 
   // ============ Finance API ============
-  async createFinance(amount: number, type: string, category: string, description?: string) {
+  async createFinance(amount: number, type: string, category: string, description?: string, account?: string, transactionDate?: string, tags?: string) {
     const { data } = await this.client.post('/api/v1/finances', {
       amount,
       type,
       category,
       description,
+      account,
+      transactionDate: toLocalDateTime(transactionDate),
+      tags,
     });
     return data;
   }
 
-  async listFinances(type?: string, category?: string) {
+  async listFinances(type?: string, category?: string, month?: string) {
     const params: Record<string, string> = {};
     if (type) params.type = type;
     if (category) params.category = category;
+    if (month) params.month = month;
     const { data } = await this.client.get('/api/v1/finances', { params });
     return data;
   }
 
+  async getFinanceStats(month: string) {
+    const { data } = await this.client.get('/api/v1/finances/stats', { params: { month } });
+    return data;
+  }
+
+  async getFinanceReport(month: string) {
+    const { data } = await this.client.get('/api/v1/finances/report', { params: { month } });
+    return data;
+  }
+
   // ============ Health API ============
+  async logHealthData(dataType: string, value: string, unit?: string, date?: string) {
+    const { data } = await this.client.post('/api/v1/health-data', {
+      dataType,
+      value,
+      unit,
+      date: toLocalDateTime(date),
+    });
+    return data;
+  }
+
+  async listHealthData(dataType?: string, fromDate?: string, toDate?: string) {
+    const params: Record<string, string> = {};
+    if (dataType) params.dataType = dataType;
+    if (fromDate) params.fromDate = fromDate;
+    if (toDate) params.toDate = toDate;
+    const { data } = await this.client.get('/api/v1/health-data', { params });
+    return data;
+  }
+
   async syncHealthData() {
     const { data } = await this.client.post('/api/v1/health-data/sync');
     return data;
@@ -151,12 +203,19 @@ class ApiService {
   }
 
   // ============ Item API ============
-  async createItem(name: string, category?: string, location?: string, expireDate?: string) {
+  async createItem(name: string, category?: string, location?: string, expireDate?: string, quantity?: number, unit?: string, brand?: string, barcode?: string, price?: number, supplier?: string, purchaseDate?: string) {
     const { data } = await this.client.post('/api/v1/items', {
       name,
       category,
       location,
       expireDate: toLocalDateTime(expireDate),
+      quantity,
+      unit,
+      brand,
+      barcode,
+      price,
+      supplier,
+      purchaseDate: toLocalDateTime(purchaseDate),
     });
     return data;
   }
@@ -169,14 +228,25 @@ class ApiService {
     return data;
   }
 
+  async getExpiringItems(days: number) {
+    const { data } = await this.client.get('/api/v1/items/expiring', { params: { days } });
+    return data;
+  }
+
+  async getItemStats() {
+    const { data } = await this.client.get('/api/v1/items/stats');
+    return data;
+  }
+
   // ============ Calendar API ============
-  async createCalendarEvent(title: string, startTime: string, endTime: string, description?: string, location?: string) {
+  async createCalendarEvent(title: string, startTime: string, endTime: string, description?: string, location?: string, color?: string) {
     const { data } = await this.client.post('/api/v1/calendar-events', {
       title,
       startTime: toLocalDateTime(startTime),
       endTime: toLocalDateTime(endTime),
       description,
       location,
+      color,
     });
     return data;
   }
@@ -189,6 +259,36 @@ class ApiService {
     return data;
   }
 
+  // ============ Task API ============
+  async createTask(title: string, source?: string, openclawId?: string, priority?: string) {
+    const { data } = await this.client.post('/api/v1/tasks', {
+      title,
+      source: source || 'cli',
+      openclawId,
+      priority: priority || 'medium',
+      status: 'pending',
+    });
+    return data;
+  }
+
+  async listTasks(status?: string, source?: string) {
+    const params: Record<string, string> = {};
+    if (status) params.status = status;
+    if (source) params.source = source;
+    const { data } = await this.client.get('/api/v1/tasks', { params });
+    return data;
+  }
+
+  async updateTask(id: number, updates: Partial<{status: string; priority: string}>) {
+    const { data } = await this.client.patch(`/api/v1/tasks/${id}`, updates);
+    return data;
+  }
+
+  async deleteTask(id: number) {
+    const { data } = await this.client.delete(`/api/v1/tasks/${id}`);
+    return data;
+  }
+
   // ============ Reminder API ============
   async createReminder(title: string, triggerTime: string, type: string = 'once') {
     const { data } = await this.client.post('/api/v1/reminders', {
@@ -217,25 +317,6 @@ class ApiService {
     const { data } = await this.client.get('/api/v1/audit-logs', { params });
     return data;
   }
-
-  // ============ Task API ============
-  async createTask(title: string, description?: string, priority?: string, source?: string) {
-    const { data } = await this.client.post('/api/v1/tasks', {
-      title,
-      description,
-      priority: priority || 'medium',
-      source: source || 'cli',
-      status: 'pending',
-    });
-    return data;
-  }
-
-  async listTasks(status?: string) {
-    const params: Record<string, string> = {};
-    if (status) params.status = status;
-    const { data } = await this.client.get('/api/v1/tasks', { params });
-    return data;
-  }
 }
 
 export const apiService = new ApiService();

package/src/utils/env.ts

@@ -0,0 +1,85 @@
+/**
+ * .env 配置文件加载器
+ * 支持 SHAWNXIXI_API_URL 等环境变量
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+interface EnvConfig {
+  API_URL: string;
+  API_TOKEN?: string;
+}
+
+let cachedConfig: EnvConfig | null = null;
+
+/**
+ * 加载 .env 文件并返回配置
+ * 优先级：process.env > .env 文件 > 默认值
+ */
+export function loadEnvConfig(): EnvConfig {
+  if (cachedConfig) return cachedConfig;
+
+  const defaultConfig: EnvConfig = {
+    API_URL: process.env.SHAWNXIXI_API_URL || 'http://localhost:8080/api/v1',
+    API_TOKEN: process.env.SHAWNXIXI_API_TOKEN,
+  };
+
+  // 尝试从当前目录和项目根目录加载 .env
+  const possiblePaths = [
+    path.join(process.cwd(), '.env'),
+    path.join(__dirname, '../../.env'),
+    path.join(__dirname, '../../../.env'),
+  ];
+
+  for (const envPath of possiblePaths) {
+    try {
+      if (fs.existsSync(envPath)) {
+        const content = fs.readFileSync(envPath, 'utf-8');
+        const envVars = parseEnvFile(content);
+        
+        // 合并配置，process.env 优先级最高
+        cachedConfig = {
+          API_URL: process.env.SHAWNXIXI_API_URL || envVars.SHAWNXIXI_API_URL || defaultConfig.API_URL,
+          API_TOKEN: process.env.SHAWNXIXI_API_TOKEN || envVars.SHAWNXIXI_API_TOKEN || defaultConfig.API_TOKEN,
+        };
+        return cachedConfig;
+      }
+    } catch (e) {
+      // 忽略读取错误，继续尝试下一个路径
+    }
+  }
+
+  cachedConfig = defaultConfig;
+  return cachedConfig;
+}
+
+/**
+ * 简单 .env 文件解析器
+ */
+function parseEnvFile(content: string): Record<string, string> {
+  const result: Record<string, string> = {};
+  const lines = content.split('\n');
+  
+  for (const line of lines) {
+    const trimmed = line.trim();
+    // 跳过空行和注释
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    
+    const eqIndex = trimmed.indexOf('=');
+    if (eqIndex > 0) {
+      const key = trimmed.substring(0, eqIndex).trim();
+      let value = trimmed.substring(eqIndex + 1).trim();
+      // 去掉引号
+      if ((value.startsWith('"') && value.endsWith('"')) ||
+          (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+      }
+      result[key] = value;
+    }
+  }
+  
+  return result;
+}
+
+export const envConfig = loadEnvConfig();

package/src/utils/finance.model.ts

@@ -0,0 +1,182 @@
+/**
+ * Finance Model Utilities
+ * 包含收支分类、账户余额计算、金额格式化等功能
+ */
+
+export type FinanceType = 'income' | 'expense';
+
+export interface FinanceItem {
+  id: string;
+  amount: number;
+  type: FinanceType;
+  category: string;
+  description?: string;
+  createdAt: string;
+}
+
+export interface Account {
+  id: string;
+  name: string;
+  balance: number;
+  currency: string;
+}
+
+export interface FinanceStats {
+  totalIncome: number;
+  totalExpense: number;
+  netBalance: number;
+  byCategory: Record<string, { income: number; expense: number }>;
+}
+
+/**
+ * 收入分类
+ */
+export const INCOME_CATEGORIES = [
+  'salary',
+  'bonus',
+  'investment',
+  'gift',
+  'refund',
+  'other_income',
+] as const;
+
+/**
+ * 支出分类
+ */
+export const EXPENSE_CATEGORIES = [
+  'food',
+  'transport',
+  'shopping',
+  'entertainment',
+  'housing',
+  'healthcare',
+  'education',
+  'travel',
+  'other',
+] as const;
+
+/**
+ * 判断账单类型
+ */
+export function categorizeFinance(amount: number, type?: string): FinanceType {
+  if (type === 'income' || type === 'expense') {
+    return type;
+  }
+  // 根据金额正负判断
+  return amount >= 0 ? 'income' : 'expense';
+}
+
+/**
+ * 获取默认分类
+ */
+export function getDefaultCategory(type: FinanceType): string {
+  return type === 'income' ? 'other_income' : 'other';
+}
+
+/**
+ * 验证分类是否有效
+ */
+export function isValidCategory(type: FinanceType, category: string): boolean {
+  const categories = type === 'income' ? INCOME_CATEGORIES : EXPENSE_CATEGORIES;
+  return (categories as readonly string[]).some(c => c === category);
+}
+
+/**
+ * 计算账户余额
+ */
+export function calculateBalance(items: FinanceItem[]): number {
+  return items.reduce((balance, item) => {
+    if (item.type === 'income') {
+      return balance + item.amount;
+    } else {
+      return balance - item.amount;
+    }
+  }, 0);
+}
+
+/**
+ * 计算账单统计
+ */
+export function calculateFinanceStats(items: FinanceItem[]): FinanceStats {
+  const stats: FinanceStats = {
+    totalIncome: 0,
+    totalExpense: 0,
+    netBalance: 0,
+    byCategory: {},
+  };
+
+  for (const item of items) {
+    if (!stats.byCategory[item.category]) {
+      stats.byCategory[item.category] = { income: 0, expense: 0 };
+    }
+
+    if (item.type === 'income') {
+      stats.totalIncome += item.amount;
+      stats.byCategory[item.category].income += item.amount;
+    } else {
+      stats.totalExpense += item.amount;
+      stats.byCategory[item.category].expense += item.amount;
+    }
+  }
+
+  stats.netBalance = stats.totalIncome - stats.totalExpense;
+  return stats;
+}
+
+/**
+ * 格式化金额
+ * @param amount 金额
+ * @param currency 货币符号，默认 ¥
+ * @param showSign 是否显示正负号，默认 false
+ */
+export function formatAmount(
+  amount: number,
+  currency: string = '¥',
+  showSign: boolean = false
+): string {
+  const formatted = Math.abs(amount).toFixed(2);
+  const sign = showSign ? (amount >= 0 ? '+' : '-') : '';
+
+  // 格式化千分位
+  const parts = formatted.split('.');
+  parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+
+  return `${sign}${currency}${parts.join('.')}`;
+}
+
+/**
+ * 解析金额字符串
+ */
+export function parseAmount(amountStr: string): number {
+  // 移除货币符号和千分位逗号
+  const cleaned = amountStr
+    .replace(/[¥$,]/g, '')
+    .trim();
+  const num = parseFloat(cleaned);
+  return isNaN(num) ? 0 : num;
+}
+
+/**
+ * 判断是否为有效金额
+ */
+export function isValidAmount(amount: number): boolean {
+  return !isNaN(amount) && isFinite(amount) && amount !== 0;
+}
+
+/**
+ * 计算日均支出
+ */
+export function calculateDailyAverage(expense: number, days: number): number {
+  if (days <= 0) return 0;
+  return expense / days;
+}
+
+/**
+ * 计算月度预算剩余
+ */
+export function calculateBudgetRemaining(
+  totalBudget: number,
+  spent: number
+): number {
+  return totalBudget - spent;
+}

package/src/utils/output.ts

@@ -0,0 +1,126 @@
+/**
+ * 全局输出格式化工具
+ * 支持 --json / --quiet / --dry-run 全局参数
+ */
+
+// 全局标志（由 index.ts 在解析全局参数后设置）
+export let globalJsonFlag = false;
+export let globalQuietFlag = false;
+export let globalDryRunFlag = false;
+
+export function setGlobalFlags(args: { json?: boolean; quiet?: boolean; dryRun?: boolean }) {
+  if (args.json !== undefined) globalJsonFlag = args.json;
+  if (args.quiet !== undefined) globalQuietFlag = args.quiet;
+  if (args.dryRun !== undefined) globalDryRunFlag = args.dryRun;
+}
+
+/**
+ * 统一输出函数
+ */
+export function output(data: any, options: { quiet?: boolean } = {}): void {
+  if (globalQuietFlag || options.quiet) return;
+  
+  if (globalJsonFlag) {
+    console.log(JSON.stringify(data, null, 2));
+  } else {
+    console.log(typeof data === 'string' ? data : JSON.stringify(data, null, 2));
+  }
+}
+
+/**
+ * 错误输出
+ */
+export function outputError(message: string, ...args: any[]): void {
+  if (!globalQuietFlag) {
+    console.error(`\x1b[31m✖ ${message}\x1b[0m`, ...args);
+  }
+}
+
+/**
+ * 成功输出
+ */
+export function outputSuccess(message: string, ...args: any[]): void {
+  if (!globalQuietFlag) {
+    console.log(`\x1b[32m✔ ${message}\x1b[0m`, ...args);
+  }
+}
+
+// Simple loading indicator (ora ESM issue workaround)
+const spinners = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+let spinnerInterval: NodeJS.Timeout | null = null;
+
+export interface LoadingInstance {
+  start: () => void;
+  succeed: (text?: string) => void;
+  fail: (text?: string) => void;
+  stop: () => void;
+}
+
+/**
+ * 创建 Loading 实例（简单实现，兼容 CJS）
+ */
+export function createLoading(text: string): LoadingInstance {
+  let currentText = text;
+  let index = 0;
+  let started = false;
+  
+  const instance: LoadingInstance = {
+    start: () => {
+      if (started || globalQuietFlag) return;
+      started = true;
+      process.stdout.write('\x1b[?25l'); // hide cursor
+      spinnerInterval = setInterval(() => {
+        process.stdout.write(`\r${spinners[index % spinners.length]} ${currentText}`);
+        index++;
+      }, 80);
+    },
+    succeed: (text?: string) => {
+      if (spinnerInterval) {
+        clearInterval(spinnerInterval);
+        spinnerInterval = null;
+      }
+      process.stdout.write('\x1b[?25h'); // show cursor
+      process.stdout.write('\r' + ' '.repeat(currentText.length + 3) + '\r');
+      if (!globalQuietFlag) {
+        console.log(`\x1b[32m✔ ${text || currentText}\x1b[0m`);
+      }
+    },
+    fail: (text?: string) => {
+      if (spinnerInterval) {
+        clearInterval(spinnerInterval);
+        spinnerInterval = null;
+      }
+      process.stdout.write('\x1b[?25h'); // show cursor
+      process.stdout.write('\r' + ' '.repeat(currentText.length + 3) + '\r');
+      if (!globalQuietFlag) {
+        console.error(`\x1b[31m✖ ${text || currentText}\x1b[0m`);
+      }
+    },
+    stop: () => {
+      if (spinnerInterval) {
+        clearInterval(spinnerInterval);
+        spinnerInterval = null;
+      }
+      process.stdout.write('\x1b[?25h'); // show cursor
+      process.stdout.write('\r' + ' '.repeat(currentText.length + 3) + '\r');
+    },
+  };
+  
+  return instance;
+}
+
+/**
+ * Dry-run 检查，如果处于预览模式则输出并返回 true
+ */
+export function isDryRun(): boolean {
+  return globalDryRunFlag;
+}
+
+export function dryRunLog(action: string, details?: any): void {
+  if (globalDryRunFlag) {
+    console.log(`\x1b[33m[DRY-RUN]\x1b[0m ${action}`);
+    if (details && !globalQuietFlag) {
+      console.log(JSON.stringify(details, null, 2));
+    }
+  }
+}