cc-code-status 1.1.6 → 2.0.2

package/README.md

@@ -1,89 +1,345 @@
 # CC Code Status
 
-Claude Code 状态栏插件，显示 Git 用户名、对话次数和代码统计。
+**增强版 Claude Code 启动器 + 状态栏插件**
 
-## 功能特性
+一个集成了多 API 配置管理、代码统计和数据上报的 Claude Code 增强工具。
 
+## 核心功能
+
+### 1. Claude Code 启动器
+- 多 API 配置管理（支持多个账号/环境）
+- 一键启动 Claude Code 并自动注入环境变量
+- 启动前显示今日统计
+- 自动检测 Claude Code 安装状态
+
+### 2. 状态栏插件
 在 Claude Code 状态栏实时显示：
 - **Git 用户名** - 从 `git config user.name` 获取
-- **对话次数** - 统计真实用户提问（排除系统命令如 `/clear`, `/exit` 等）
-- **代码统计** - Claude Code 修改的代码行数（新增/删除）
+- **对话统计** - 对话次数/轮数（排除系统命令）
+- **代码统计** - 新增/删除代码行数
+
+**显示格式**: `qilin ↑ | Chat: 16次/154轮 | Code: +446/-313`
+- `↑` - 数据上报已启用（可选）
+- `16次` - 对话会话数（按 sessionId 去重）
+- `154轮` - 用户消息总数
+- `+446/-313` - 新增/删除代码行数
 
-**显示格式**: `qilin | Chat: 106 | Code: 5376/103`
-- Git 用户名
-- Chat: 对话次数
-- Code: 新增行数/ 删除行数
+### 3. 数据上报
+- 定期同步对话详情到后端 API（可配置APi、间隔，可关闭）
+- 手动触发数据上报
+- 自定义数据上报（手动输入数据）
+
+### 4. 项目排除
+- 排除指定项目，不计入统计
+- 支持路径模糊匹配
+
+---
 
 ## 安装
 
+### 前置要求
+- Node.js >= 16.0.0
+- Claude Code（必须先安装）
+
+```bash
+# 安装 Claude Code（如果未安装）
+npm install -g @anthropic-ai/claude-code
+```
+
 ### 全局安装
 
 ```bash
 npm install -g cc-code-status
 ```
 
-安装后会自动配置 Claude Code。
+安装后会自动配置状态栏。
+
+---
+
+## 快速开始
+
+### 首次使用
+
+安装后首次运行会引导你配置 API：
+
+```bash
+ccs
+```
+
+交互式配置：
+1. 输入配置名称（如 `work`, `personal`）
+2. 输入 API Key
+3. 输入 Base URL
+4. 可选：配置模型名称
 
+配置完成后，Claude Code 会自动启动。
 
-## 使用
+---
 
-安装后，Claude Code 状态栏会自动显示信息。无需任何配置。
+## 命令列表
 
-## 手动配置
+所有命令都支持短别名 `ccs`，例如 `ccs config add` 等同于 `cc-code-status config add`。
 
-如果自动配置失败，可以手动运行：
+### 启动器命令
 
 ```bash
-cc-code-status setup
+ccs                         # 启动 Claude Code（自动选择配置）
+ccs --profile <配置名>      # 使用指定配置启动
+ccs -p work                 # 使用 work 配置启动
+ccs -v                      # 查看版本号
+ccs help                    # 显示帮助
 ```
 
-## 卸载
+### 配置管理命令
 
 ```bash
-cc-code-status uninstall
-npm uninstall -g cc-code-status
+ccs config                  # 查看配置帮助（无配置时引导添加）
+ccs config add              # 添加新配置
+ccs config list             # 列出所有配置
+ccs config show             # 显示当前配置
+ccs config remove <名称>    # 删除指定配置
+ccs config --reset          # 重置所有配置
 ```
 
-## 命令
+### 统计查看命令
 
-所有命令都支持短别名 `ccs`，例如 `ccs setup` 等同于 `cc-code-status setup`。
+```bash
+ccs stats today             # 显示今日统计
+ccs stats week              # 显示本周统计（周一-周日）
+ccs week                    # 同 stats week
+```
 
-- `cc-code-status` / `ccs` - 运行状态栏插件（由 Claude Code 调用）
-- `cc-code-status setup` / `ccs setup` - 配置 Claude Code
-- `cc-code-status uninstall` / `ccs uninstall` - 移除配置
-- `cc-code-status sync-enable` / `ccs sync-enable` - 启用数据上报功能
-- `cc-code-status sync-disable` / `ccs sync-disable` - 禁用数据上报功能
-- `cc-code-status sync-status` / `ccs sync-status` - 查看数据上报状态
-- `cc-code-status sync-now` / `ccs sync-now` / `ccs sync` - 主动触发一次数据上报（真实数据）
-- `cc-code-status week` / `ccs week` - 显示本周统计数据
-- `cc-code-status exclude add <项目路径>` / `ccs exclude add <路径>` - 添加排除项目（不统计该项目）
-- `cc-code-status exclude remove <项目路径>` / `ccs exclude remove <路径>` - 移除排除项目
-- `cc-code-status exclude list` / `ccs exclude list` - 列出所有排除项目
-- `cc-code-status help` / `ccs help` - 显示帮助
+### 数据上报命令
 
-### 排除项目功能
+```bash
+ccs sync-enable             # 启用数据上报
+ccs sync-disable            # 禁用数据上报
+ccs sync-status             # 查看上报状态
+ccs sync-now                # 手动触发一次上报（真实数据）
+ccs sync                    # 同 sync-now
+ccs custom-sync             # 自定义数据上报（交互式输入）
+```
 
-如果你不想统计某些项目的对话和代码数据，可以使用排除功能：
+### 项目排除命令
 
 ```bash
-# 添加当前目录到排除列表
-ccs exclude add .
+ccs exclude add <路径>      # 添加排除项目
+ccs exclude remove <路径>   # 移除排除项目
+ccs exclude list            # 列出所有排除项目
+```
+
+### 旧版兼容命令
 
-# 添加指定路径到排除列表
+```bash
+ccs setup                   # 配置状态栏（向后兼容）
+ccs uninstall               # 移除状态栏配置
+```
+
+---
+
+## 使用场景
+
+### 场景 1：多账号管理
+
+```bash
+# 添加公司账号
+ccs config add
+# 配置名称: work
+# API Key: sk-ant-...
+# Base URL: https://api.company.com
+
+# 添加个人账号
+ccs config add
+# 配置名称: personal
+# API Key: sk-ant-...
+# Base URL: https://api.anthropic.com
+
+# 查看所有配置
+ccs config list
+
+# 使用指定配置启动
+ccs --profile work
+ccs -p personal
+```
+
+### 场景 2：排除测试项目
+
+```bash
+# 添加测试项目到排除列表
 ccs exclude add /Users/qilin/test-project
+ccs exclude add /Users/qilin/demo-app
 
 # 查看排除列表
 ccs exclude list
 
+# 删除缓存以立即生效
+rm ~/.cc-code-status/current.json
+
 # 从排除列表中移除
 ccs exclude remove /Users/qilin/test-project
 ```
 
-**注意**：
-- 排除项目后需要删除缓存才能立即生效：`rm ~/.cc-code-status/current.json`
-- 排除列表保存在 `~/.cc-code-status/config.json` 中
+### 场景 3：查看统计数据
+
+```bash
+# 查看今日统计
+ccs stats today
+# 输出: 对话: 16次/154轮
+#       代码: +446/-313 行
+
+# 查看本周统计
+ccs stats week
+# 输出:
+# ========================================
+#    本周统计 (2025-11-04 至 2025-11-10)
+# ========================================
+# 总计: 42次/186轮 | +1234/-567 行
+# 每日明细:
+#   周一 (2025-11-04)     5次/25轮 | +123/-45 行
+#   周二 (2025-11-05)     8次/32轮 | +234/-56 行
+#   ...
+```
+
+### 场景 4：数据上报
+
+```bash
+# 启用数据上报
+ccs sync-enable
+
+# 查看上报状态
+ccs sync-status
+
+# 手动触发一次上报
+ccs sync-now
+
+# 自定义数据上报（手动输入数据）
+ccs custom-sync
+# 交互式输入:
+#   - 对话轮次
+#   - 新增代码行数
+#   - 删除代码行数
+```
+
+---
+
+## 配置文件
+
+### API 配置
+
+保存在 `~/.config/cc-code-status/config.json`：
+
+```json
+{
+  "profiles": {
+    "work": {
+      "apiKey": "sk-ant-...",
+      "baseUrl": "https://api.company.com",
+      "model": "claude-sonnet-4-5-20250929",
+      "smallFastModel": "claude-3-5-haiku-20250219",
+      "configuredAt": "2025-11-18T08:00:00.000Z",
+      "version": "2.0.0"
+    },
+    "personal": {
+      "apiKey": "sk-ant-...",
+      "baseUrl": "https://api.anthropic.com",
+      "configuredAt": "2025-11-18T09:00:00.000Z",
+      "version": "2.0.0"
+    }
+  }
+}
+```
+
+### 状态栏和同步配置
+
+保存在 `~/.cc-code-status/config.json`：
+
+```json
+{
+  "apiUrl": "http://10.40.0.70:8087/api/cloudcode-ai/batch-receive",
+  "syncInterval": 1800000,
+  "enabled": true,
+  "excludedProjects": [
+    "/Users/qilin/test-project",
+    "/Users/qilin/demo-app"
+  ]
+}
+```
+
+### 缓存文件
+
+- `~/.cc-code-status/current.json` - 状态栏缓存（5分钟 TTL）
+- `~/.cc-code-status/conversations.json` - 对话详情（用于数据上报）
+
+---
+
+## 常见问题
+
+### 1. 状态栏不显示
+
+检查 `~/.claude/settings.json` 中的配置：
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "cc-code-status"
+  }
+}
+```
+
+或运行：
+```bash
+ccs setup
+```
+
+### 2. 多个配置如何选择？
+
+- **单配置**：自动使用唯一配置
+- **多配置**：启动时交互选择，或使用 `--profile` 参数指定
+- **命令行参数**：`ccs --profile work` 或 `ccs -p work`
+
+### 3. 统计数据不准确
+
+```bash
+# 删除缓存，强制重新计算
+rm ~/.cc-code-status/current.json
+
+# 检查是否有项目被排除
+ccs exclude list
+```
+
+### 4. 数据上报失败
+
+```bash
+# 查看上报状态和配置
+ccs sync-status
+
+# 检查 API 地址是否正确
+cat ~/.cc-code-status/config.json
+
+# 手动触发并查看错误信息
+ccs sync-now
+```
+
+### 5. 卸载插件
+
+```bash
+# 移除状态栏配置
+ccs uninstall
+
+# 卸载插件
+npm uninstall -g cc-code-status
+
+# 删除配置文件（可选）
+rm -rf ~/.cc-code-status
+rm -rf ~/.config/cc-code-status
+```
+
+---
 
 
 ## 许可证
 
 MIT
+
+---

package/dist/cli-legacy.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 旧版 CLI 函数（向后兼容）
+ * 包含 v1.x 版本的所有辅助函数
+ */
+export declare function setup(): void;
+export declare function uninstall(): void;
+export declare function setSyncEnabled(enabled: boolean): void;
+export declare function showSyncStatus(): void;
+export declare function manualSync(): Promise<void>;
+export declare function customSync(): Promise<void>;
+export declare function handleExclude(subArgs: string[]): void;
+export declare function showWeekStats(): void;
+//# sourceMappingURL=cli-legacy.d.ts.map

package/dist/cli-legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-legacy.d.ts","sourceRoot":"","sources":["../src/cli-legacy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,wBAAgB,KAAK,IAAI,IAAI,CA0C5B;AAED,wBAAgB,SAAS,IAAI,IAAI,CAwBhC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0CrD;AAED,wBAAgB,cAAc,IAAI,IAAI,CA+BrC;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAGhD;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CA+IhD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAkBrD;AAED,wBAAgB,aAAa,IAAI,IAAI,CA2FpC"}