pysupercc 0.1.24

SuperCC — 超级 Claude Code，支持多平台（飞书、钉钉、微信等），具备记忆自优化和技能自进化能力

SuperCC 🐲

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

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

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

---

核心亮点

多平台接入

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

记忆自优化

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

技能自进化

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

记忆注入

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

Cron 定时任务

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

多模型支持

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

---

快速开始

安装

pip install -U pysupercc

启动

supercc

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

升级

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：

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
• 查看文档: GitHub README

---

更新日志

详见 CHANGELOG.md。