Metadata-Version: 2.4
Name: pysupercc
Version: 0.1.23
Summary: SuperCC — 超级 Claude Code，支持多平台（飞书、钉钉、微信等），具备记忆自优化和技能自进化能力
Author-email: Hu1J <2948696442@qq.com>
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: claude-agent-sdk>=0.1.59
Requires-Dist: lark-oapi>=1.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: python-dateutil>=2.8.0
Requires-Dist: qrcode>=7.4.0
Requires-Dist: Pillow>=10.0.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: packaging>=23.0
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: filelock>=3.13.0
Requires-Dist: jieba>=0.42.1
Requires-Dist: scikit-learn>=1.0
Requires-Dist: croniter>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: questionary>=2.0

# SuperCC 🐲

```
███████╗██╗  ██╗███████╗███████╗██████╗ ███████╗███████╗
██╔════╝██║  ██║██║  ██║██╔════╝██╔══██╗██╔════╝██╔════╝
███████╗██║  ██║███████║█████╗  ██████╔╝██║     ██║
╚════██║██║  ██║██╔════╝██╔══╝  ██╔══██╗██║     ██║
███████║███████║██║     ███████╗██║  ██║███████╗███████╗
╚══════╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝╚══════╝╚══════╝
```

**超级 Claude Code** — 多平台 AI 工作搭档，让 Claude Code 在飞书、钉钉等 IM 平台中无缝运行。

> 自进化超级 AI · 越用越懂你

---

## 核心亮点

### 多平台接入
支持飞书（已上线），框架设计支持钉钉/微信/QQ 等扩展。一个后台，多个平台同时在线。

### 记忆自优化
每日凌晨自动精炼记忆库 — 合并冗余、精简重复、删除过时信息。记忆越用越精准。

### 技能自进化
每次对话后自动检查 skills 目录变化，有更新自动 git commit。技能可像代码一样版本管理。

### 记忆注入
每次对话自动检索相关记忆，注入上下文。无需重复描述背景，AI 始终知道你是谁、你在做什么。

### Cron 定时任务
标准 cron 表达式，精准定时触发 AI 执行任务，结果自动推送到飞书。

### 多模型支持
内置 MiniMax、火山引擎 ARK、阿里云通义千问、智谱 GLM、DeepSeek、Kimi 等国内主流供应商，API Key 即插即用。

---

## 快速开始

### 安装

```bash
pip install -U pysupercc
```

### 启动

```bash
supercc
```

首次运行会自动进入安装引导（飞书扫码授权 → 配置模型 API → 启动服务）。

### 升级

```bash
supercc update
```

---

## 指令集

### 基础对话

| 指令 | 说明 |
|------|------|
| `/new` | 创建新会话 |
| `/status` | 查看当前运行状态 |
| `/stop` | 打断 Claude 当前正在执行的查询 |
| `/restart` | 重启 SuperCC 服务 |
| `/update` | 检查更新并自动升级 |
| `/help` | 查看所有可用指令 |

### 记忆系统

| 指令 | 说明 |
|------|------|
| `/memory` | 管理本地记忆库（查看/搜索/增删） |
| `/remember <内容>` | 主动添加记忆 |
| `/forget` | 清除当前会话上下文（记忆不受影响） |

### 定时任务

| 指令 | 说明 |
|------|------|
| `/cron` | 管理定时任务（创建/查看/删除/暂停） |
| `/cron list` | 查看所有定时任务 |
| `/cron logs <id>` | 查看任务执行日志 |

### 模型配置

| 指令 | 说明 |
|------|------|
| `/model` | 查看当前模型配置状态 |
| `/model switch <provider>` | 切换到已配置的供应商（如 `/model switch volcano`） |

### Codex 子代理

| 指令 | 说明 |
|------|------|
| `/codex` | 查看 Codex MCP 状态 |
| `/codex available` | 快速判断 Codex 当前是否可用 |
| `/codex models` | 查看 Codex 可选模型 |
| `/codex setup` | 立即写入/刷新 Claude Code 的 Codex MCP 配置 |

**Codex MCP 集成**（v0.1.7+）：
- SuperCC 自研 MCP Server（`supercc-codex-mcp-server`），直接执行 `codex exec`，结果通过 JSONL 文件 tailing 实时推送
- 支持多个 Codex 模型：`gpt-5.5`（推荐）、`gpt-5.4`、`gpt-5.4-mini`、`gpt-5.2`
- Legacy 模型名自动迁移：`gpt-5.5-codex` → `gpt-5.5`
- Claude Code 对话中自动识别 Codex/GPT-5.5 相关需求，调用 MCP 工具执行

### 项目管理

| 指令 | 说明 |
|------|------|
| `/project` | 切换到其他已初始化项目 |
| `/projects` | 列出所有已初始化项目 |

### 技能管理

| 指令 | 说明 |
|------|------|
| `/skill <关键词>` | 搜索并安装 Skills |
| `/skills` | 查看已安装的 Skills 列表 |

### Git 操作

| 指令 | 说明 |
|------|------|
| `/git` | 查看当前项目 git 状态 |

---

## 工作原理

```
┌─────────────────────────────────────────────────────────┐
│                      飞书 / 钉钉                          │
│                   （用户通过 IM 对话）                      │
└────────────────────────┬────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│                    SuperCC Bridge                        │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  │
│  │ 记忆系统  │  │ 技能进化  │  │ 对话引擎  │  │ 定时调度  │  │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘  │
└────────────────────────┬────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│                   Claude Code CLI                        │
│              （本地执行，真正的 AI 能力）                   │
└─────────────────────────────────────────────────────────┘
                         │
          ┌──────────────┴──────────────┐
          │         Codex MCP           │
          │   SuperCC 自研 MCP Server    │
          │   直接执行 codex exec        │
          │   JSONL tailing 实时推送     │
          └─────────────────────────────┘
```

SuperCC 充当 IM 平台和本地 Claude Code 之间的桥梁：
- 接收飞书消息 → 转发给本地 Claude Code
- Claude Code 回复 → 转发回飞书
- 全程对话自动注入记忆，上下文中始终包含相关信息
- SuperCC 自研 Codex MCP Server，Claude 在需要时通过 MCP 工具调用 Codex/GPT-5.5

启用 Codex MCP 前，请先安装并登录 Codex CLI：

```bash
codex --version
codex login
```

---

## 配置文件

- `~/.supercc/config.yaml` — 飞书应用配置
- `~/.supercc/models.yaml` — 多模型 API 配置
- `~/.supercc/memories.db` — 记忆数据库（SQLite + FTS5）
- `~/.supercc/cron_jobs.json` — 定时任务配置
- `~/.claude/skills/` — 全局 Skills 目录

---

## 目录结构

```
SuperCC/
├── supercc/
│   ├── main.py              # 入口点
│   ├── banner.py            # ASCII logo + 版本信息
│   ├── onboard.py           # 首次安装引导
│   ├── config.py            # 配置读写
│   ├── adapter/             # 平台适配层
│   │   └── feishu/          # 飞书适配器
│   ├── claude/              # Claude Code 接口
│   │   ├── model_config.py  # 多模型管理
│   │   └── model_providers.py # 预设供应商
│   ├── bridge/              # 消息桥接层
│   ├── skills/              # 内置 Skills
│   └── storage/             # 持久化存储
├── .supercc/                # 用户数据（~/.supercc/）
│   ├── config.yaml
│   ├── models.yaml
│   └── memories.db
└── README.md
```

---

## 常见问题

**Q: 飞书机器人收不到消息？**
检查 `~/.supercc/config.yaml` 中的 `app_id`/`app_secret` 是否正确，机器人是否已启用。

**Q: 群聊 @CC 时上下文消息注入不生效？**
确认飞书应用已开通 `im:message.group_msg` 权限，否则 `get_chat_history()` 无法拉取群聊历史。

**Q: 如何切换模型？**
发送 `/model` 查看当前配置，`/model switch <provider>` 切换供应商。

**Q: 记忆不生效？**
发送 `/memory` 查看记忆库，确认相关记忆已录入。新会话会自动注入相关记忆。

**Q: 定时任务没执行？**
确认 SuperCC 正在运行，发送 `/cron list` 查看任务状态。

---

## 获取帮助

- 提交 Issue: [GitHub Issues](https://github.com/Hu1J/supercc/issues)
- 查看文档: [GitHub README](https://github.com/Hu1J/supercc)

---

## 更新日志

详见 [CHANGELOG.md](./CHANGELOG.md)。
