CoreMan — AI skill for Claude Code

CoreMan

**融入团队的 AI 员工。Your AI teammate at work.**

中文 · [English](README.en.md)

CoreMan 是一个可自托管的 AI 员工平台，把企业微信、飞书与运行在自有环境中的 AI CLI 连接起来。团队成员在聊天中协作，管理员在统一后台管理 AI 员工、运行时、技能、权限与任务。

项目处于早期迭代阶段（0.1.0）。平台本身不提供模型额度；使用 Claude Code / Codex 等后端需要自行安装、登录并获得对应服务的使用权限。

主要能力

• 企业微信与飞书接入：长连接收发、流式回复、图片与文件、引用消息、交互问答卡片。
• AI 员工管理：提示词、模型、运行时、协作者、使用白名单及团队归属。
• 运行时管理：独立 Runtime Daemon 主动连接管理端，提供 Claude Code / Codex 后端、健康状态与额度信息。
• 团队与权限：团队、用户、角色、平台登录、通讯录同步、加密凭证与操作审计。
• 任务与协作：定时执行、通知、人工求助、会话管理、对话记录及运行状态。
• 技能与记忆：技能目录、安装审批、环境配置、记忆同步、使用统计与体检。
• 自托管运维：Docker Compose、数据库迁移、多进程协调、排空升级、可选 S3 存储与 Prometheus 监控。

快速开始

准备 Git、Python 3、Docker 与 Docker Compose v2。首次构建需要能下载容器镜像及 Python、Node.js、Go 依赖；容器内完成前端与 Runtime 安装包构建。

git clone https://github.com/wxkingstar/CoreMan.git
cd CoreMan
cp .env.example .env
# 编辑 .env：为 BOOTSTRAP_ADMIN_PASSWORD 设置独立强密码
./deploy/coreman build
./deploy/coreman up
./deploy/coreman status

浏览器打开 ，使用 `.env` 中的 `BOOTSTRAP_ADMIN_USERNAME` 和 `BOOTSTRAP_ADMIN_PASSWORD` 登录。启动工具会补齐空的加密/会话密钥，并随机替换占位的数据库及管理员密码；请妥善备份 `.env` 与数据库。

端口冲突时，在 `.env` 中设置 `CADDY_HTTP_PORT=8080`、`CADDY_HTTPS_PORT=8443`，并把 `PUBLIC_BASE_URL` 改为 `http://localhost:8080`。生产部署应设置 HTTPS 域名、对应的 `PUBLIC_BASE_URL` 与 `CADDY_SITE_ADDRESS`，并确保 Runtime 可以访问该地址。

首次配置流程：

1. 在「团队与用户」中建立团队，按需在「平台应用」配置通讯录同步及登录。
2. 在「运行时管理」生成安装命令，在已经安装并登录 AI CLI 的目标用户环境中执行；详见 Runtime 安装。
3. 创建 AI 员工，填写企业微信或飞书机器人凭证，绑定可用运行时和模型，再启用；平台侧准备见 企业微信接入 与 飞书接入。
4. 从对应聊天平台发送消息，在「对话记录」和「运行状态」验证完整链路。

平台登录验证成功后，可在设置中关闭引导管理员登录。AI CLI 会以 Runtime 所属系统用户的权限执行操作；请使用独立、最小权限的用户环境，并按需隔离文件和网络。提示词约束不能替代操作系统隔离。

本地开发

后端需要 Python 3.12+、uv 与 PostgreSQL 16；前端需要 Node.js 22.12+。以下命令使用专用开发数据库：

uv sync --all-groups
cp .env.example .env
# 编辑 .env：配置本地 DATABASE_URL、强管理员密码、MASTER_KEY、SESSION_SECRET
# 生成 MASTER_KEY：
python3 -c 'import