1. 项目定位与用途
丞相是一个开源的飞书 AI 助手框架，定位为团队中的"全能同事"而非聊天机器人。它基于 Claude Code 或 OpenAI Codex 引擎，通过 MCP 协议将飞书 API 暴露给 AI，使其能直接执行操作。主要用途是在飞书群聊或私聊中通过自然语言指令，让 AI 自动完成发消息、创建任务、更新文档、安排日程、操作多维表格等办公任务，真正实现"说完就办"，减少人工操作。
项目档案命令行工具
zhu1090093659/minister CLI 工具：安装、命令与使用场景
zhu1090093659/minister：丞相是一个基于 Claude Code 或 OpenAI Codex 的飞书 AI 助手框架，通过 MCP 协议让 AI 直接操作飞书 API 本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
丞相是一个基于 Claude Code 或 OpenAI Codex 的飞书 AI 助手框架，通过 MCP 协议让 AI 直接操作飞书 API 执行任务，为企业团队提供自动化办公能力。
中文项目介绍
丞相（Minister）是一个开源的飞书 AI 助手框架，核心定位是让 AI 从文本生成者转变为实际执行者。它基于 Claude Code 或 OpenAI Codex 双引擎，通过 MCP 协议将飞书 API 封装为工具暴露给 AI，使其能直接完成发消息、建任务、写文档、排日程等操作，无需人工干预。项目解决了传统 AI 助手只能提供建议而无法执行、团队个性化需求冲突以及 AI 记忆不持久三大问题。适用于企业团队自动化日常办公、个人全能助理、团队知识管理以及通过 MCP 接入第三方系统的场景。技术层面采用 TypeScript Monorepo 架构，Bun 驱动运行，支持 Docker 一键部署，并提供基于 React + Vite 的 Web 管理后台。每位用户拥有独立的文件系统工作区，实现记忆（CLAUDE.md）和配置的持久化与隔离。
详细信息与使用说明
2. 解决的问题
丞相解决了三个核心问题：一是传统 AI 助手只能生成文本建议而无法实际执行，本框架通过直接调用飞书 API 让 AI 拥有执行力；二是团队中不同成员的个性化需求冲突，通过为每位用户维护独立工作区（CLAUDE.md 记忆与 .claude/settings.json 配置）实现偏好隔离；三是 AI 对话记忆不持久，通过文件系统持久化存储，确保会话中断或服务重启后记忆依然保留。
3. 适用场景
主要适用场景包括：企业团队自动化日常办公，如自动发送通知、创建跟踪任务、更新项目文档、协调会议日程；个人作为全能助理管理飞书工作空间，操作多维表格和通讯录；团队知识管理，持久化记录成员工作习惯和偏好；以及通过 MCP 协议接入 GitHub、Jira 等第三方系统扩展能力。十人团队可用其分担杂活，一人公司可当作全能搭档，均能提升工作效率。
4. 安装方式
安装需以下步骤：首先克隆仓库并安装依赖：git clone <repo-url> minister && cd minister && bun install；其次配置环境变量，复制 config/.env.example 为 .env 并填写飞书应用凭证（FEISHU_APP_ID、FEISHU_APP_SECRET）、管理后台地址（ADMIN_BASE_URL）及引擎类型（ENGINE_TYPE）；若使用 Claude 需复制 config/claude.env.example 并设置 ANTHROPIC_API_KEY，使用 Codex 则需配置 config/config.toml.example 和 OPENAI_API_KEY；最后通过 docker-compose up 或直接运行 bun run packages/bot-server/src/index.ts 启动服务。需提前在飞书开放平台创建自建应用并配置权限。
5. 使用方式
使用方式为：在飞书群聊或私聊中 @机器人并发送自然语言指令，如"帮我创建下周例会日程"；AI 引擎理解意图后，通过 MCP 工具直接调用飞书 API 执行操作，无需用户手动处理；处理过程中通过流式卡片实时展示进度和结果；访问配置了 ADMIN_BASE_URL 的管理后台（飞书 OAuth 登录）进行个人系统提示词、MCP 服务器、Skill 及群组行为策略的配置；每次对话中用户表达的偏好会自动写入个人工作区的 CLAUDE.md，实现跨会话记忆。
6. 实现特点
实现上具有以下特点：双引擎支持，通过 ENGINE_TYPE 环境变量在 Claude Code CLI 与 OpenAI Codex CLI 间切换；MCP 协议集成，feishu-mcp 服务将飞书 API 封装为 6 类 20 个工具（消息、任务、通讯录、多维表格、文档、日历）；用户隔离与持久化，每位用户在 data/worktrees/{open_id}/ 下拥有独立工作区，文件系统权限确保安全；实时交互，bot-server 通过 WebSocket 长连接接收消息，流式卡片反馈进度；管理后台提供三层配置继承（系统默认 < 个人 < 群组）；整体采用 Monorepo 组织，TypeScript 编写，Bun 驱动，Docker 一键部署。
思维导图
zhu1090093659/minister
常见问题
zhu1090093659/minister 是做什么的？
丞相是一个基于 Claude Code 或 OpenAI Codex 的飞书 AI 助手框架，通过 MCP 协议让 AI 直接操作飞书 API 执行任务，为企业团队提供自动化办公能力。
zhu1090093659/minister 适合用在什么场景？
丞相是一个开源的飞书 AI 助手框架，定位为团队中的"全能同事"而非聊天机器人。它基于 Claude Code 或 OpenAI Codex 引擎，通过 MCP 协议将飞书 API 暴露给 AI，使其能直接执行操作。主要用途是在飞书群聊或私聊中通过自然语言指令，让 AI 自动完成发消息、创建任务、更新文档、安排日程、操作多维表格等办公任务，真正实现"说完就办"，减少人工操作。
zhu1090093659/minister 如何安装？
安装需以下步骤：首先克隆仓库并安装依赖：git clone <repo-url> minister && cd minister && bun install；其次配置环境变量，复制 config/.env.example 为 .env 并填写飞书应用凭证（FEISHU_APP_ID、FEISHU_APP_SECRET）、管理后台地址（ADMIN_BASE_URL）及引擎类型（ENGINE_TYPE）；若使用 Claude 需复制 config/claude.env.example 并设置 ANTHROPIC_API_KEY，使用 Codex 则需配置 config/config.toml.example 和 OPENAI_API_KEY；最后通过 docker-compose up 或直接运行 bun run packages/bot-server/src/index.ts 启动服务。需提前在飞书开放平台创建自建应用并配置权限。
zhu1090093659/minister 如何开始使用？
使用方式为：在飞书群聊或私聊中 @机器人并发送自然语言指令，如"帮我创建下周例会日程"；AI 引擎理解意图后，通过 MCP 工具直接调用飞书 API 执行操作，无需用户手动处理；处理过程中通过流式卡片实时展示进度和结果；访问配置了 ADMIN_BASE_URL 的管理后台（飞书 OAuth 登录）进行个人系统提示词、MCP 服务器、Skill 及群组行为策略的配置；每次对话中用户表达的偏好会自动写入个人工作区的 CLAUDE.md，实现跨会话记忆。