shawnxixi-cli 0.1.0

package/.env.example

@@ -0,0 +1,2 @@
+SHAWNXIXI_API_URL=http://localhost:8080
+SHAWNXIXI_API_TOKEN=

package/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build-test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20.x]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - name: Install dependencies
+        run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Test
+        run: npm test
+
+  publish:
+    needs: build-test
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+      - name: Install dependencies
+        run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+

package/AUTH-RESEARCH.md

@@ -0,0 +1,230 @@
+# CLI 鉴权方案调研
+
+## 1. CLI 工具常用鉴权方案
+
+### 1.1 API Key 方案
+**原理**: 使用静态字符串作为密钥
+```
+Authorization: Bearer <api_key>
+```
+
+**优点**:
+- 实现简单
+- 易于理解和使用
+- 适合机器对机器通信
+
+**缺点**:
+- 密钥泄露后无法撤销（需重新生成）
+- 无期限控制（除非服务端实现）
+
+**适用场景**: 
+- 服务级 API 访问
+- CI/CD 环境
+
+### 1.2 OAuth2 方案
+**原理**: 标准 OAuth2 流程，支持刷新令牌
+
+**优点**:
+- 支持令牌过期和刷新
+- 用户可撤销授权
+- 支持细粒度权限控制
+
+**缺点**:
+- 实现复杂
+- 需要 Web 回调或终端授权
+
+**适用场景**:
+- 需要用户授权的 API
+- 用户数据访问
+
+### 1.3 Token（JWT）方案
+**原理**: 使用自包含的 JSON Web Token
+
+**优点**:
+- 自带过期时间
+- 可包含用户信息
+- 验证简单
+
+**缺点**:
+- 令牌一旦颁发无法撤销（直到过期）
+- 令牌较长
+
+**适用场景**:
+- 有状态 API 访问
+- 需要追踪用户身份的 API
+
+## 2. CLI 安全存储 Token
+
+### 2.1 Keychain 存储（推荐 macOS/Linux）
+```typescript
+// 使用 keytar 库
+import keytar from 'keytar';
+
+const SERVICE = 'shawnxixi-cli';
+const ACCOUNT = 'api-token';
+
+// 存储
+await keytar.setPassword(SERVICE, ACCOUNT, token);
+
+// 读取
+const token = await keytar.getPassword(SERVICE, ACCOUNT);
+
+// 删除
+await keytar.deletePassword(SERVICE, ACCOUNT);
+```
+
+**优点**:
+- 系统级安全存储
+- 不易被普通用户发现
+- 跨平台支持
+
+**缺点**:
+- 需要 native 依赖
+- 某些系统可能不支持
+
+### 2.2 Config File 存储
+```bash
+# ~/.config/shawnxixi-cli/config.json
+{
+  "token": "encrypted_or_plain_token",
+  "endpoint": "https://api.shawnxixi.com"
+}
+```
+
+**优点**:
+- 简单实现
+- 用户可控
+
+**缺点**:
+- 容易被发现和泄露
+- 需要自行加密或依赖文件系统权限
+
+### 2.3 环境变量
+```bash
+export SHAWNXIXI_TOKEN="your_token_here"
+```
+
+**优点**:
+- 简单
+- 便于 CI/CD 集成
+
+**缺点**:
+- 容易被 history 或日志泄露
+- 不够安全
+
+### 2.4 加密存储
+```typescript
+import { createCipheriv, randomBytes } from 'crypto';
+
+const encrypt = (text: string, key: Buffer): string => {
+  const iv = randomBytes(16);
+  const cipher = createCipheriv('aes-256-cbc', key, iv);
+  return iv.toString('hex') + ':' + cipher.update(text, 'utf8', 'hex') + ':' + cipher.final('hex');
+};
+```
+
+## 3. 推荐方案及理由
+
+### 推荐: API Key + Keychain 存储
+
+**理由**:
+
+1. **CLI 工具特性**: 大多数 CLI 工具（如 kubectl, terraform, aws cli）都采用 API Key 方案
+2. **实现简单**: 比 OAuth2 简单很多，适合自动化调用
+3. **keychain 安全**: macOS Keychain / Linux libsecret 提供系统级保护
+4. **SpringBoot 兼容**: 与现有 JWT 方案可共存，CLI 使用 API Key 即可
+
+**实现架构**:
+```
+shawnxixi-cli
+    │
+    ├── 首次使用: shawnxixi login  # 输入 API Key，存 Keychain
+    │
+    ├── 后续使用: 自动从 Keychain 读取
+    │
+    └── API 调用: Authorization: Bearer <token>
+                      │
+                      ▼
+              shawnxixi-server
+                      │
+                      ├── 验证 JWT token
+                      │
+                      └── 返回业务数据
+```
+
+## 4. 与 SpringBoot 后端的鉴权对接
+
+### 4.1 后端实现
+```java
+// Spring Security 配置
+@Configuration
+public class SecurityConfig {
+    @Bean
+    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
+        http
+            .csrf(AbstractHttpConfigurer::disable)
+            .authorizeHttpRequests(auth -> auth
+                .requestMatchers("/api/**").authenticated()
+                // 或支持 API Key 白名单
+                .requestMatchers("/api/cli/**").permitAll()  // CLI 专用入口
+            )
+            .addFilterBefore(new ApiKeyAuthFilter(), 
+                UsernamePasswordAuthenticationFilter.class);
+        return http.build();
+    }
+}
+
+// API Key 验证过滤器
+public class ApiKeyAuthFilter extends OncePerRequestFilter {
+    @Override
+    protected void doFilterInternal(HttpServletRequest request, 
+                                    HttpServletResponse response,
+                                    FilterChain chain) {
+        String apiKey = request.getHeader("X-API-Key");
+        // 或 Authorization: Bearer <api_key>
+        
+        if (apiKey != null && validateApiKey(apiKey)) {
+            // 设置认证信息
+            SecurityContextHolder.getContext()
+                .setAuthentication(new ApiKeyAuthentication(apiKey));
+        }
+        chain.doFilter(request, response);
+    }
+}
+```
+
+### 4.2 CLI 实现
+```typescript
+// src/services/auth.ts
+import keytar from 'keytar';
+
+const SERVICE = 'shawnxixi-cli';
+const ACCOUNT = 'api-token';
+
+export async function getStoredToken(): Promise<string | null> {
+  return keytar.getPassword(SERVICE, ACCOUNT);
+}
+
+export async function saveToken(token: string): Promise<void> {
+  await keytar.setPassword(SERVICE, ACCOUNT, token);
+}
+
+export async function login(apiKey: string): Promise<void> {
+  // 验证 API Key 有效性
+  await saveToken(apiKey);
+}
+```
+
+### 4.3 安全建议
+1. **API Key 生成**: 使用 UUID v4 或 crypto random
+2. **传输安全**: 必须使用 HTTPS
+3. **存储加密**: Keychain 本身已加密，可选额外加密
+4. **令牌轮换**: 支持用户撤销和重新生成
+5. **日志保护**: 不要在日志中打印 token
+
+## 结论
+
+对于 shawnxixi-cli 作为 OpenClaw 执行肢：
+- **鉴权方案**: API Key（简单、适合机器调用）
+- **存储方案**: Keychain（系统级安全）
+- **后端对接**: API Key Header + Spring Security Filter

package/CLAUDE.md

@@ -0,0 +1,102 @@
+# shawnxixi-cli
+
+## 项目说明
+
+肖嘻 CLI 工具，OpenClaw 的执行肢。通过 HTTP 调用 shawnxixi-server REST API。
+
+## 技术栈
+
+- **Runtime**: Node.js 20+
+- **语言**: TypeScript 5.3
+- **HTTP Client**: axios
+- **测试**: Jest + ts-jest
+- **构建**: tsc
+
+## CLI 命令格式
+
+```
+shawnxixi <命名空间> <操作> [参数]
+```
+
+### biz 命名空间（日常业务）
+
+| 操作 | 命令格式 | 说明 |
+|------|---------|------|
+| todo create | `shawnxixi biz todo create "{title}" --due {date} --priority {priority}` | 创建待办 |
+| todo list | `shawnxixi biz todo list --status {status}` | 列出待办 |
+| todo update | `shawnxixi biz todo update {id} --status {status}` | 更新待办 |
+| todo delete | `shawnxixi biz todo delete {id}` | 删除待办 |
+| record create | `shawnxixi biz record create "{title}" --type {type} --content "{content}" --tags {tags}` | 创建记录 |
+| record list | `shawnxixi biz record list --type {type}` | 列出记录 |
+| finance create | `shawnxixi biz finance create --amount {amount} --type {type} --category {category}` | 记账 |
+| finance list | `shawnxixi biz finance list --type {type}` | 列出账单 |
+| item create | `shawnxixi biz item create "{name}" --category {category}` | 添加物品 |
+| item list | `shawnxixi biz item list --category {category}` | 列出物品 |
+| calendar create | `shawnxixi biz calendar create "{title}" --start {startTime} --end {endTime}` | 创建日程 |
+| calendar list | `shawnxixi biz calendar list --start {startTime} --end {endTime}` | 列出日程 |
+| reminder create | `shawnxixi biz reminder create "{title}" --trigger "{triggerTime}" --type {type}` | 创建提醒 |
+| reminder list | `shawnxixi biz reminder list --status {status}` | 列出提醒 |
+| audit list | `shawnxixi biz audit list --entityType {entityType} --operation {operation}` | 查看审计日志 |
+| task create | `shawnxixi biz task create "{title}" --priority {priority}` | 创建任务 |
+| task list | `shawnxixi biz task list --status {status}` | 列出任务 |
+
+### sys 命名空间（系统操作）
+
+| 操作 | 命令格式 | 说明 |
+|------|---------|------|
+| health query | `shawnxixi sys health query --dataType {dataType} --startDate {startDate} --endDate {endDate}` | 查询健康数据 |
+| health sync | `shawnxixi sys health sync` | 同步健康数据 |
+
+## API 端点（Server v1）
+
+所有 API 基础路径：`http://localhost:8080/api/v1`
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/api/v1/todos` | GET/POST | 待办列表/创建 |
+| `/api/v1/todos/{id}` | GET/PUT/PATCH/DELETE | 待办详情/更新/删除 |
+| `/api/v1/records` | GET/POST | 记录列表/创建 |
+| `/api/v1/records/{id}` | GET/PUT/PATCH/DELETE | 记录详情/更新/删除 |
+| `/api/v1/finances` | GET/POST | 账单列表/创建 |
+| `/api/v1/items` | GET/POST | 物品列表/创建 |
+| `/api/v1/calendar-events` | GET/POST | 日程列表/创建 |
+| `/api/v1/reminders` | GET/POST | 提醒列表/创建 |
+| `/api/v1/audit-logs` | GET | 审计日志（只读） |
+| `/api/v1/tasks` | GET/POST | 任务列表/创建 |
+| `/api/v1/health-data` | GET/POST | 健康数据 |
+| `/api/v1/health-data/sync` | POST | 同步健康数据 |
+
+## 环境变量
+
+| 变量 | 说明 | 默认值 |
+|------|------|-------|
+| `SHAWNXIXI_API_URL` | API 基础地址 | `http://localhost:8080` |
+| `SHAWNXIXI_API_TOKEN` | 认证 Token | 无（匿名） |
+
+**安全注意**：Token 只写入本地 `.env` 或环境变量，禁止写入代码或 git。
+
+## npm 发包
+
+- 包名：`shawnxixi-cli`（npmjs.com）
+- 发布命令：`npm publish --access public`
+- CI 自动发包：main 分支合并时通过 GitHub Actions 触发，需配置 `NPM_TOKEN` secret
+
+## 启动开发
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## 目录结构
+
+```
+src/
+├── index.ts           # CLI 入口
+├── commands/          # 命令实现
+│   ├── biz/          # 业务命令
+│   └── sys/          # 系统命令
+└── services/
+    └── api.ts        # HTTP API 调用层
+```

package/NPM-PUBLISH-RESEARCH.md

@@ -0,0 +1,163 @@
+# NPM 发布调研
+
+## 1. 如何发布到 npm（详细步骤）
+
+### 步骤 1: 创建 npm 账号
+```bash
+npm adduser
+# 或前往 https://www.npmjs.com/signup 注册
+```
+
+### 步骤 2: 验证包配置
+```bash
+# 确认 package.json 配置正确
+npm view .  # 查看包信息预览
+
+# 登录状态确认
+npm whoami  # 显示当前登录用户名
+```
+
+### 步骤 3: 发布包
+```bash
+# 发布前先 build
+npm run build
+
+# 发布（标签默认为 latest）
+npm publish
+
+# 发布到指定标签
+npm publish --tag beta
+npm publish --tag next
+```
+
+### 步骤 4: 验证发布
+```bash
+npm view shawnxixi-cli   # 查看已发布的包信息
+npm install shawnxixi-cli  # 验证安装
+```
+
+## 2. npm Scope 设置
+
+### 使用 @shawnxixi scope
+```bash
+# 创建 scope
+npm init --scope=@shawnxixi
+
+# 或在 package.json 中设置
+{
+  "name": "@shawnxixi/cli"
+}
+```
+
+### 注意事项
+- 需要先在 npm 创建 organization 或使用付费组织的 scope
+- 免费账号可以使用 public scope 的 @username/packageName
+- `@shawnxixi` 需要创建 shawnxixi organization
+
+## 3. Version 管理策略
+
+### 语义化版本 (SemVer)
+```
+major.minor.patch
+1.0.0
+│   │   │
+│   │   └── patch: 修复 bug，兼容更新
+│   └── minor: 新功能，兼容更新
+└── major: 破坏性变更，不兼容更新
+```
+
+### 预发布版本
+```
+1.0.0-alpha.1    # alpha 测试版
+1.0.0-beta.1     # beta 测试版
+1.0.0-rc.1       # release candidate
+```
+
+### 发布策略
+- 开发阶段: `0.1.0` 起，patch 频繁更新
+- MVP 后: `1.0.0` 作为首个正式版本
+- 使用 `npm version` 管理版本:
+  ```bash
+  npm version patch  # 0.1.0 -> 0.1.1
+  npm version minor  # 0.1.0 -> 0.2.0
+  npm version major  # 0.1.0 -> 1.0.0
+  ```
+
+## 4. 发布可见性（private 包）
+
+### Public 包（默认）
+```json
+{
+  "name": "@shawnxixi/cli",
+  "publishConfig": {
+    "access": "public"
+  }
+}
+```
+
+### Private 包
+```json
+{
+  "name": "@shawnxixi/internal-cli",
+  "private": true
+  // private 包不能发布到公共 registry
+}
+```
+
+### Restricted 可见性
+- 需要付费组织
+- 只能组织内成员安装
+
+## 5. CI/CD 自动发布配置
+
+### GitHub Actions 示例
+```yaml
+# .github/workflows/npm-publish.yml
+name: npm-publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+          
+      - name: Install dependencies
+        run: npm ci
+        
+      - name: Build
+        run: npm run build
+        
+      - name: Publish
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+### NPM Token 配置
+1. npm 官网 -> Access Tokens
+2. 创建 Automation Token（推荐用于 CI）
+3. GitHub -> Settings -> Secrets -> NPM_TOKEN
+
+### 发布流程
+```
+代码合并 -> 打 tag (v1.0.0) -> push tag -> GitHub Actions 触发 -> 自动发布
+```
+
+## 推荐方案
+
+对于 shawnxixi-cli：
+- **Scope**: `@shawnxixi` (需要创建 organization) 或 `shawnxixi-cli` (直接发布)
+- **Version**: 从 `0.1.0` 开始，使用 SemVer
+- **可见性**: public
+- **CI/CD**: GitHub Actions + npm automation token

package/README.md

@@ -0,0 +1,136 @@
+# shawnxixi-cli
+
+> 肖嘻 CLI 工具 — OpenClaw 的执行肢
+
+## 安装
+
+```bash
+# 从源码编译
+git clone https://github.com/LyuShawn/shawnxixi-cli.git
+cd shawnxixi-cli
+npm install
+npm run build
+
+# 链接到全局
+npm link
+```
+
+## 配置
+
+```bash
+# 设置后端地址（可选，默认 http://localhost:8080）
+export SHAWNXIXI_API_URL=http://localhost:8080
+
+# 设置 API Token（可选）
+export SHAWNXIXI_API_TOKEN=your-token
+```
+
+## 命令
+
+### 待办 (biz todo)
+
+```bash
+# 创建待办
+shawnxixi biz todo create "开会" --due 2026-04-12 --priority high
+
+# 列出所有待办
+shawnxixi biz todo list
+
+# 标记完成
+shawnxixi biz todo done 1
+
+# 删除待办
+shawnxixi biz todo delete 1
+```
+
+### 记录 (biz record)
+
+```bash
+# 创建记录
+shawnxixi biz record create "灵感" --content "想到一个新的app idea" --type idea
+
+# 列出所有记录
+shawnxixi biz record list
+
+# 宠物记录
+shawnxixi biz record create "西西体重" --content "3.2kg" --type pet --tags "体重,西西"
+```
+
+### 财务 (biz finance)
+
+```bash
+# 记账（支出）
+shawnxixi biz finance create 50 --category food --desc "午饭"
+
+# 记账（收入）
+shawnxixi biz finance create 15000 --type income --category salary
+
+# 列出财务流水
+shawnxixi biz finance list
+
+# 按分类查看
+shawnxixi biz finance list --category food
+```
+
+### 物品 (biz item)
+
+```bash
+# 添加物品
+shawnxixi biz item create "阿莫西林" --location "药箱" --expire 2026-12-01 --category "药品"
+
+# 列出物品
+shawnxixi biz item list
+```
+
+### 日历 (biz calendar)
+
+```bash
+# 创建日程
+shawnxixi biz calendar create "面试" --start "2026-04-15 14:00" --end "2026-04-15 15:30" --desc "技术面试"
+
+# 列出日程
+shawnxixi biz calendar list
+```
+
+### 健康 (sys health)
+
+```bash
+# 同步健康数据
+shawnxixi sys health sync
+
+# 查询健康数据
+shawnxixi sys health query steps --from 2026-04-01 --to 2026-04-11
+shawnxixi sys health query heartRate
+```
+
+## 开发
+
+```bash
+# 编译
+npm run build
+
+# 测试
+npm test
+
+# 发布到 npm（需权限）
+npm publish --access public
+```
+
+## 架构
+
+```
+src/
+├── commands/          # 命令实现
+│   ├── biz/          # 业务命令
+│   └── sys/          # 系统命令
+├── services/
+│   └── api.ts        # HTTP 调用层
+└── index.ts          # 入口
+```
+
+## 相关项目
+
+- [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 应用

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

@@ -0,0 +1,12 @@
+export declare const calendarCommands: {
+    create: (title: string, options?: {
+        start?: string;
+        end?: string;
+        desc?: string;
+    }) => Promise<void>;
+    list: (options?: {
+        from?: string;
+        to?: string;
+    }) => Promise<void>;
+};
+//# sourceMappingURL=calendar.d.ts.map

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

@@ -0,0 +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;qBAgBhE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE;CAWrD,CAAC"}