feique

v1.3.3

Published

16 days ago

飞鹊 (Feique) — Team AI Collaboration Hub. From individual productivity to team synergy, weave AI into every stage of work through Feishu.

0High
0Medium
0Low

colorcross

codex claude claude-code feishu lark bridge cli agent

飞鹊 (Feique) v1.3.3

团队 AI 协作中枢 — 从个人提效到团队协作，让 AI 融入工作的每个环节。

English | 官网 | 快速开始 | 架构设计 | FAQ

飞鹊 (Feique) 是团队 AI 协作中枢。它通过飞书连接 Codex CLI、Claude Code 等 AI 能力，让团队成员协作配合、相互促进——帮助发现问题和瓶颈、提升效率，推动从个人能力的提升，到团队协作的顺畅，再到整体能力的持续迭代。

当前已支持 AI 编程场景的完整链路：项目绑定按 chat_id 持久化，本地会话可接管，同仓库自动串行，排队和运行态在飞书里直接可见；最终回复支持富文本和卡片，并默认收口成更干净的单条结果消息。

🌟 核心特性

🚀 快速开始

1. 安装

npm install -g feique
feique init --mode global

# 创建一个新项目目录并接入配置
feique create-project repo-new /srv/codex/repo-new

# 绑定已有目录为项目
feique bind repo-a /path/to/repo-a

2. 配置环境变量

只需设置飞书应用的凭证即可快速启动（默认使用 long-connection 模式，无需公网 IP）：

export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=***

3. 检查与启动

# 检查环境与连通性
feique doctor --remote

# 启动服务
feique start

# 查看日志
feique logs --follow

💬 飞书内交互示例

在飞书里，你可以直接使用自然语言或斜杠命令与 Codex 交互：

# 项目管理
/projects
/project repo-a
/admin project create repo-new /srv/codex/repo-new

# 会话管理
/session adopt latest
/session list

# 知识库操作
/wiki search 部署文档
/kb search 架构设计
/doc read doxcn123
/task create 跟进发布检查
/base records app_token tbl_id 5

# 团队协作
/team                    # 查看谁在用 AI 做什么
/learn 部署前必须跑完 e2e  # 沉淀团队知识
/recall 部署流程           # 语义检索已有知识
/handoff @张三 继续修复    # 将当前会话交接给队友
/pickup                  # 接手交接给你的会话
/review                  # 发起评审
/approve                 # 批准评审
/reject 需要补测试用例     # 打回评审并注明原因
/insights                # 查看团队瓶颈诊断
/trust suggest           # 设置当前项目信任级别
/timeline                # 查看项目时间线
/digest                  # 手动触发团队日报

# 自然语言命令
切换到项目 repo-a
接管最新会话
查看详细状态
团队现在谁在忙？
帮我把会话交给小王
这个项目最近都发生了什么？

🏗️ 架构概览

[ Feishu App ] <---> [ Transport (WS/Webhook) ]
                            |
                            v
[ Project Router ] ---> [ Session Manager ] ---> [ Concurrency Queue ]
       |                    |                            |
       v                    v                            v
[ Team Awareness ]  [ Memory / Wiki ]             [ Backend (Codex / Claude) ]
[ Trust Boundaries] [ Knowledge Loop ]                   |
[ Cost Tracking ]   [ Context Continuity ]               v
       |                    |                     [ Local Workspace ]
       v                    v
[ Dashboard ]       [ Handoff & Review ]
[ Team Digest ]     [ Team Insights ]

详细的架构设计请参考架构文档。

⚙️ 最小配置示例

配置文件默认位于 ~/.feique/config.toml：

version = 1

[service]
default_project = "default"
reply_mode = "card"  # text | post | card

[codex]
bin = "codex"
default_sandbox = "workspace-write"
run_timeout_ms = 1800000  # 30 minutes

# (可选) 如果要使用 Claude Code 后端
# [backend]
# default = "claude"  # codex | claude
#
# [claude]
# bin = "claude"
# default_permission_mode = "auto"
# default_model = "sonnet"

[storage]
dir = "~/.feique/state"

[embedding]
provider = "ollama"
ollama_model = "auto"  # 自动探测本地最优嵌入模型

[security]
allowed_project_roots = ["/srv/repos"]
viewer_chat_ids = ["oc_viewer_chat_1"]
operator_chat_ids = ["oc_operator_chat_2"]
admin_chat_ids = ["oc_admin_chat_1"]
service_observer_chat_ids = ["oc_service_observer_1"]
service_restart_chat_ids = ["oc_service_restart_1"]
config_admin_chat_ids = ["oc_config_admin_1"]

[mcp]
transport = "http"   # stdio | http
host = "127.0.0.1"
port = 8765
path = "/mcp"
sse_path = "/mcp/sse"
message_path = "/mcp/message"
active_auth_token_id = "primary"
[[mcp.auth_tokens]]
id = "primary"
token = "env:MCP_AUTH_TOKEN_PRIMARY"
enabled = true
[[mcp.auth_tokens]]
id = "rollover"
token = "env:MCP_AUTH_TOKEN_ROLLOVER"
enabled = true

[feishu]
app_id = "env:FEISHU_APP_ID"
app_secret = "env:FEISHU_APP_SECRET"
transport = "long-connection"

[projects.default]
root = "/srv/repos/repo-a"
session_scope = "chat"
run_priority = 200
operator_chat_ids = ["oc_repo_operator_1"]
session_operator_chat_ids = ["oc_repo_session_operator_1"]
run_operator_chat_ids = ["oc_repo_run_operator_1"]
config_admin_chat_ids = ["oc_repo_config_admin_1"]
download_dir = "/srv/feique/projects/repo-a/downloads"
temp_dir = "/srv/feique/projects/repo-a/tmp"
cache_dir = "/srv/feique/projects/repo-a/cache"
log_dir = "/srv/feique/projects/repo-a/logs"
# backend = "claude"  # 项目级后端覆盖

权限说明：

viewer：可见项目、查看 /projects、/status、/session list
operator：额外可切项目、接管会话、取消运行、查看 /admin runs
admin：额外可改配置、增删项目、重启服务
session_operator_chat_ids：只放宽会话接管和会话切换
run_operator_chat_ids：只放宽运行和取消运行
service_observer_chat_ids / service_restart_chat_ids / config_admin_chat_ids：把运行观察、服务重启、配置治理拆开授权

MCP 说明：

feique mcp 默认仍可跑 stdio
加 --transport http 或配置 [mcp] transport = "http" 后，会暴露 JSON-RPC + SSE 端点
如启用 HTTP，建议使用 mcp.auth_tokens 做多 token 轮换，并通过 active_auth_token_id 标记当前主 token
老配置里的 mcp.auth_token 仍兼容，但更适合单机本地接入

飞书对象与状态卡片：

/doc read <url|token>、/doc create <title>：直接读写飞书文档
/task list|get|create|complete：在飞书任务里查看、创建和完成任务
/base tables|records|create|update：查看或写入多维表格
对文档、任务、多维表格这类飞书对象写操作，会直接执行并回写同一条状态消息
文本执行请求会先立即回复一条运行态消息，再更新为 已接收 / 排队中 / 处理中 / 已完成 / 失败
运行态卡片会区分 排队中 / 准备上下文 / 生成中 / 执行中 / 已完成 / 失败 / 已取消

📚 文档导航

快速开始 - 从零到一的完整指南
架构设计 - 深入了解内部机制
FAQ - 常见问题解答
部署指南 - 生产环境部署建议
贡献指南 - 如何参与项目开发

🤝 参与贡献

我们欢迎各种形式的贡献！无论是提交 Bug、提出新功能建议，还是直接提交 Pull Request。请在贡献前阅读我们的贡献指南。

📄 开源协议

本项目采用 MIT License 开源协议。