lcch-cli 1.0.1 → 1.0.2

package/README.md

@@ -2,6 +2,47 @@
 
 管理 Claude Code 配置 (`~/.claude.json`) 的 CLI 工具。
 
+## 简介
+
+LCCH（L Claude Code Helper）是一款专为 Claude Code 重度用户打造的配置管理 CLI 工具，帮助你高效管理、清理、备份和导出 Claude Code 的配置与数据。
+
+### 核心痛点
+
+长期使用 Claude Code 后，你是否遇到过这些问题？
+
+- **配置膨胀**：`~/.claude.json` 中积累了大量已删除或移动的项目路径，导致启动变慢、配置臃肿
+- **磁盘空间告急**：项目 resume 会话数据（`~/.claude/projects/`）日积月累，占用大量磁盘空间
+- **安全隐患**：会话历史、resume 文件和缓存中残留了 API 密钥、Bearer Token 等敏感信息
+- **配置风险**：手动修改配置前担心出错，却缺乏便捷的备份恢复手段
+- **数据孤岛**：需要将会话记录导出存档或分享，但 Claude Code 没有内置导出功能
+
+### 主要功能
+
+| 功能模块 | 说明 |
+|---------|------|
+| **项目浏览** | 查看所有项目的状态（有效/无效/孤立），支持树形结构和详细统计 |
+| **数据清理** | 交互式清理无效项目、删除历史会话和 resume 文件，释放磁盘空间 |
+| **配置备份** | 一键备份 `.claude.json` 和 `settings.json`，支持恢复和自动回滚 |
+| **会话导出** | 按项目、会话、角色、内容类型筛选，导出为 JSON / Markdown / HTML / Text 四种格式 |
+| **安全扫描** | 扫描缓存中的 API 密钥、Token、私钥等敏感信息，支持一键掩码替换 |
+| **统计概览** | 查看全局使用统计（项目数、费用、Token、工具调用等）和缓存信息 |
+| **MCP / Hooks 管理** | 查看全局和项目级的 MCP 服务器配置与 Hooks 脚本 |
+
+### 特点
+
+- **交互式体验**：基于 inquirer 的向导式操作，支持搜索过滤和多选，无需记忆复杂命令
+- **安全优先**：敏感信息默认模糊化展示，掩码替换前自动创建文件级备份
+- **自动备份**：恢复配置前自动创建覆盖式备份，避免操作失误导致配置丢失
+- **多格式导出**：会话记录可导出为 JSON（程序处理）、Markdown（阅读）、HTML（分享）、Text（纯文本）
+- **彩色终端**：使用 chalk 提供清晰的视觉层次，项目状态一目了然
+
+### 适用人群
+
+- **长期使用 Claude Code 的开发者** — 项目数量多、会话数据庞大的用户
+- **注重隐私安全的用户** — 需要定期清理和扫描敏感信息的团队或个人
+- **多项目切换的工程师** — 需要快速浏览、清理、导出不同项目会话记录
+- **配置管理爱好者** — 希望在修改配置前有可靠备份机制的用户
+
 ## 安装
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lcch-cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Claude Code Helper - 管理 Claude Code 配置的 CLI 工具",
   "main": "dist/index.js",
   "bin": {