{"id":45522757,"url":"https://github.com/zyling-ai/zyhive","last_synced_at":"2026-04-11T16:12:18.036Z","repository":{"id":339803010,"uuid":"1163416972","full_name":"Zyling-ai/ZyHive","owner":"Zyling-ai","description":"🐝 引巢 · ZyHive | AI 团队操作系统 — 为 AI 成员注入灵魂，可视化管理多智能体团队。Self-hosted AI Team OS · Go + Vue 3 · One-click deploy","archived":false,"fork":false,"pushed_at":"2026-03-02T08:36:18.000Z","size":40469,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-02T12:41:06.372Z","etag":null,"topics":["agent-framework","ai-agent","ai-ops","ai-team","chatbot","docker","golang","llm","multi-agent","open-source","self-hosted","vue3"],"latest_commit_sha":null,"homepage":"https://zyling.ai","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zyling-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap-v0.10.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-21T15:50:05.000Z","updated_at":"2026-03-02T08:36:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Zyling-ai/ZyHive","commit_stats":null,"previous_names":["zyling-ai/zyhive"],"tags_count":39,"template":false,"template_full_name":null,"purl":"pkg:github/Zyling-ai/ZyHive","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zyling-ai%2FZyHive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zyling-ai%2FZyHive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zyling-ai%2FZyHive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zyling-ai%2FZyHive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zyling-ai","download_url":"https://codeload.github.com/Zyling-ai/ZyHive/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zyling-ai%2FZyHive/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30208801,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T05:23:27.321Z","status":"ssl_error","status_checked_at":"2026-03-07T05:00:17.256Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-framework","ai-agent","ai-ops","ai-team","chatbot","docker","golang","llm","multi-agent","open-source","self-hosted","vue3"],"created_at":"2026-02-22T23:15:46.139Z","updated_at":"2026-04-02T18:06:18.496Z","avatar_url":"https://github.com/Zyling-ai.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 引巢 · ZyHive\n\n\u003e zyling 旗下 AI 团队操作系统 — 让每一个 AI 成员各司其职、协同引领\n\n[![GitHub Stars](https://img.shields.io/github/stars/Zyling-ai/zyhive?style=flat\u0026logo=github\u0026color=yellow)](https://github.com/Zyling-ai/zyhive/stargazers)\n[![GitHub Forks](https://img.shields.io/github/forks/Zyling-ai/zyhive?style=flat\u0026logo=github\u0026color=orange)](https://github.com/Zyling-ai/zyhive/network/members)\n[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)\n[![Go 1.22+](https://img.shields.io/badge/Go-1.22+-00ADD8.svg)](https://golang.org)\n[![Version](https://img.shields.io/badge/version-26.4.1v20-brightgreen.svg)](CHANGELOG.md)\n[![官网](https://img.shields.io/badge/官网-zyling.ai-6366f1?logo=globe)](https://zyling.ai)\n\n**以团队为核心，每个 AI Agent 是团队成员。**\n\n一行命令安装，打开浏览器即可管理整个 AI 团队：配置每个成员的身份、灵魂、记忆、技能，设计组织架构，让成员之间互相协作讨论。\n\n---\n\n## 🚀 快速开始\n\n\u003e 支持 macOS / Linux（x86_64 / ARM64）\n\n**macOS / Linux：**\n```bash\ncurl -sSL https://install.zyling.ai/install | bash\n```\n\n安装完成后，终端直接显示访问地址和访问令牌：\n\n```\n╔══════════════════════════════════════════════╗\n║  ✅  ZyHive 安装成功！版本: 26.4.1v20         ║\n╚══════════════════════════════════════════════╝\n\n  📍 本地访问：  http://localhost:8080\n  🏠 内网访问：  http://192.168.1.100:8080\n  🌐 公网访问：  http://123.45.67.89:8080\n  🔑 管理员 Token：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n---\n\n## 🌐 智能安装端点\n\n| URL | 说明 |\n|-----|------|\n| `https://install.zyling.ai/install` | **通用端点**，返回 Linux/macOS bash 脚本 |\n| `https://install.zyling.ai/zyhive.sh` | Linux / macOS bash 脚本 |\n| `https://install.zyling.ai/latest` | 最新版本号 JSON |\n| `https://install.zyling.ai/dl/{ver}/{file}` | 二进制下载代理（国内加速） |\n\n\u003e 国内用户通过 Cloudflare 全球节点加速下载，无需访问 GitHub。\n\n---\n\n## ✨ 核心功能\n\n### 成员管理\n- **多 AI 成员**：每个成员有独立的身份（IDENTITY.md）、灵魂（SOUL.md）、记忆、工作区、技能、定时任务、消息渠道\n- **系统配置助手 `__config__`**：内置不可删除，启动时自动创建，专门负责全局配置问答\n- **独立模型**：每个成员可单独配置大模型（身份 Tab 下拉选择），支持 10+ Provider\n- **删除成员**：自动停止 Bot、清理工作区，前端确认弹窗防误操作\n- **头像颜色**：每个成员有个性化颜色，图谱 / 对话均展示\n\n### 对话 \u0026 会话\n- **流式对话首页（ChatHomeView）**：默认首页即聊天，成员下拉选择器、模型切换、历史会话选择、新对话按钮\n- **SSE 流式输出**：打字机效果实时输出，工具调用折叠卡展示（含进行中呼吸灯动画）\n- **Token 用量实时显示**：每条助手消息底部显示 `↑ input ↓ output tokens`，done 事件汇总\n- **会话持久化**：JSONL 格式存储，含消息历史、Token 估算、上下文压缩（Compaction）摘要\n- **统一会话侧边栏**：面板会话与 Telegram / Web 渠道会话合并为单一列表，按最后活动时间排序\n- **对话管理（ChatsView）**：跨成员查看全部历史对话，工具调用卡片展示，按渠道 / 成员双筛选\n- **@ 其他成员**：对话中 @ 转发消息给指定成员，获取跨成员回复\n- **派遣任务面板（DispatchPanel）**：`agent_spawn` 触发时被派遣成员头像飞入顶部，橙灯=执行中 / 绿灯=完成 / 红灯=失败\n\n### 工作区 \u0026 知识\n- **文件管理**：文件树递归展示（SVG 矢量图标）、在线编辑器、创建 / 删除文件\n- **分层记忆系统**：`memory/core/` + `memory/projects/` + `memory/daily/` + `memory/topics/` 四层目录，轻量 INDEX.md 注入系统提示词\n- **memory_search 工具**：向量 + BM25 双模式语义检索，有 Embedding API 时向量检索，无则 BM25 降级\n- **记忆蒸馏（Consolidator）**：自动将 daily 层短期日志提炼合并到 core 层长期记忆\n- **共享团队工作区（Projects）**：多成员共享项目文件夹，支持 per-agent 读写权限配置\n\n### 工具生态（70+ 工具）\n- **执行工具**：`exec`（bash 命令）、`read` / `write` / `edit`（文件操作）、`glob`（文件匹配）\n- **浏览器自动化（go-rod）**：`browser_navigate` / `snapshot` / `screenshot` / `click` / `type` / `fill` / `press` / `hover` / `scroll` / `select` / `eval` / `wait`，支持 ARIA 快照\n- **进程管理**：`process`（管理后台命令会话，list / poll / log / write / kill）\n- **记忆检索**：`memory_search`（向量 + BM25 语义检索）\n- **网络工具**：`web_search`（Brave Search API）、`web_fetch`（抓取页面内容）\n- **图像分析**：`image`（Vision 模型分析图片）\n- **消息推送**：`messaging`（向 Telegram 等渠道发消息）\n- **定时任务**：`cron_list` / `cron_add` / `cron_update` / `cron_remove` / `cron_run`\n- **多会话管理**：`sessions_list` / `sessions_history` / `sessions_send` / `sessions_spawn`（派遣子成员）\n- **ACP 编程代理**：`acp_*`（spawn ACP 代理 session，用于长任务编程委派）\n- **项目工作区**：`project_list` / `project_read` / `project_write` / `project_glob`\n\n### 工具权限系统\n- 每个成员可独立配置工具策略：`allow`（默认允许）/ `deny`（默认拒绝）+ 精细白名单 / 黑名单\n- 工具按组管理：`group:filesystem` / `group:runtime` / `group:browser` / `group:network` 等\n- 高危工具（如 `exec`）支持需用户审批模式（`ask`）\n\n### 定时任务（Cron）\n- **隔离会话**：每次 Cron 任务在独立 session 中执行，不污染主对话历史\n- **表达式支持**：标准 cron 表达式 + 时区配置\n- **Cron 管理 UI（CronView）**：可视化创建、编辑、立即执行、查看历史记录\n\n### 目标规划（Goals）\n- **甘特图（GoalsView）**：可拖拽时间线，7 级缩放（今 / 周 / 月 / 季 / 半年 / 年 / 三年），惯性滑动，今日锚定\n- **里程碑管理**：目标分解为可追踪里程碑节点，关联负责成员\n- **AI 迭代评审**：关联 Cron 任务，AI 定期自动写进度评审报告\n- **Goals 聊天**：每个目标独立聊天 session，不污染其他对话\n\n### 子成员（Subagents）\n- **Subagents 管理（SubagentsView）**：查看所有派遣中的子成员任务，状态 / 模型 / 耗时实时显示\n- **派遣结果回传**：子成员完成后自动将结果推送回主成员对话\n\n### 消息渠道\n- **Telegram Bot**：每个成员可绑定独立 Bot（per-agent），支持 per-chat 持久会话、命令菜单、图片媒体处理\n- **Web 公开聊天（PublicChatView）**：无需登录的公开对话页面，适合对外展示\n- **渠道管理（ChannelsView）**：可视化管理 Telegram token 配置，实时测试连接\n\n### 多模型支持（10+ Provider）\n- Anthropic Claude（claude-3-5/3-7 系列）\n- OpenAI（GPT-4o / o1 / o3 系列）\n- DeepSeek（deepseek-chat / deepseek-reasoner）\n- MiniMax（abab 系列，特殊 POST 探测适配）\n- 智谱 AI（GLM-4 系列）\n- Moonshot（kimi 系列）\n- Qwen（通义千问系列）\n- OpenRouter（聚合多家 Provider）\n- 自定义 OpenAI 兼容端点（Custom）\n- **Provider API Key 管理（ModelsView）**：可视化管理所有 Provider 配置，实时测试连通性\n\n### Token 用量统计\n- **UsageView**：按成员 / 日期 / Provider 统计 Token 消耗与费用\n- **实时计费**：每次对话 done 事件返回 inputTokens + outputTokens + 估算费用\n- **多 Provider 计费单价**：内置主流 Provider 官方计费标准\n\n### 系统管理\n- **在线升级（UpdateView）**：检测 GitHub 最新版本，一键在线升级，五阶段进度显示（下载→验证→应用→完成）\n- **日志查看（LogsView）**：实时系统日志，浅色主题终端风格\n- **技能工作室（SkillStudio）**：安装、启用、编辑成员技能（SKILL.md）\n- **设置（SettingsView）**：全局配置、Provider 管理、模型选择、系统提示词调试\n\n---\n\n## 🗂 项目结构\n\n```\nzyhive/\n├── cmd/aipanel/\n│   ├── main.go          ← 主入口（服务启动 / 平台服务注册）\n│   └── cli.go           ← CLI 子命令（start/stop/restart/status/enable/disable/token）\n├── internal/api/\n│   ├── router.go        ← 路由注册（所有 REST API）\n│   ├── chat.go          ← SSE 流式对话端点\n│   ├── agents.go        ← 成员 CRUD\n│   ├── sessions.go      ← 会话管理\n│   ├── relations.go     ← 关系图谱 + SVG 渲染\n│   ├── update.go        ← 在线升级（五阶段状态机）\n│   ├── goals.go         ← 目标规划 API\n│   ├── projects.go      ← 共享项目工作区 API\n│   ├── subagents.go     ← 子成员 API\n│   ├── usage.go         ← Token 用量统计 API\n│   └── ...\n├── pkg/\n│   ├── agent/           ← 成员生命周期 + 工作区 + IDENTITY/SOUL + 关系图\n│   ├── runner/          ← 对话主循环（工具调用循环）+ 系统提示词构建\n│   ├── session/         ← 会话工作者池 + Broadcaster + 持久化\n│   ├── llm/             ← 10+ Provider 适配（StreamEvent 统一抽象）\n│   ├── tools/           ← 70+ 工具注册 + 权限策略（ToolPolicy）\n│   ├── memory/          ← 四层记忆树 + 索引构建 + 语义检索\n│   ├── channel/         ← Telegram Bot + 渠道路由\n│   ├── cron/            ← Cron 引擎（隔离会话）\n│   ├── goal/            ← 目标规划数据结构\n│   ├── subagent/        ← 子成员派遣管理\n│   ├── browser/         ← 浏览器自动化（go-rod）\n│   ├── skill/           ← 技能元数据管理\n│   ├── project/         ← 共享项目工作区\n│   ├── usage/           ← Token 计费与存储\n│   ├── config/          ← 配置结构（ProviderEntry 列表）\n│   └── compaction/      ← 上下文压缩\n└── ui/src/\n    ├── views/\n    │   ├── ChatHomeView.vue      ← 对话首页（默认页面）\n    │   ├── AgentDetailView.vue   ← 成员详情（身份/灵魂/工作区/Cron/渠道）\n    │   ├── ChatsView.vue         ← 全局对话管理\n    │   ├── GoalsView.vue         ← 目标规划 + 甘特图\n    │   ├── SubagentsView.vue     ← 子成员任务监控\n    │   ├── TeamView.vue          ← 团队关系图谱\n    │   ├── ModelsView.vue        ← Provider \u0026 模型管理\n    │   ├── UsageView.vue         ← Token 用量统计\n    │   ├── ProjectsView.vue      ← 共享项目工作区\n    │   ├── LogsView.vue          ← 系统日志\n    │   ├── ToolsView.vue         ← 工具权限管理\n    │   └── ...\n    └── components/\n        ├── AiChat.vue            ← 核心对话组件（SSE + 工具卡）\n        ├── WorkspaceChatLayout.vue ← 工作区内嵌对话布局\n        ├── DispatchPanel.vue     ← 子成员派遣状态面板\n        └── SkillStudio.vue       ← 技能工作室\n```\n\n---\n\n## ⚙️ 配置文件\n\n默认位置（一键安装后自动生成）：\n- Linux / macOS root：`/etc/zyhive/zyhive.json`\n- macOS 用户：`~/.config/zyhive/zyhive.json`\n\n```json\n{\n  \"gateway\": {\n    \"port\": 8080,\n    \"bind\": \"lan\"\n  },\n  \"auth\": {\n    \"mode\": \"token\",\n    \"token\": \"your-token-here\"\n  },\n  \"agents\": {\n    \"dir\": \"./agents\"\n  },\n  \"models\": {\n    \"primary\": \"anthropic/claude-sonnet-4-6\"\n  },\n  \"providers\": [\n    {\n      \"id\": \"anthropic-1\",\n      \"type\": \"anthropic\",\n      \"apiKey\": \"sk-ant-...\",\n      \"name\": \"Anthropic\"\n    },\n    {\n      \"id\": \"openai-1\",\n      \"type\": \"openai\",\n      \"apiKey\": \"sk-...\",\n      \"name\": \"OpenAI\"\n    }\n  ]\n}\n```\n\n| 字段 | 说明 |\n|------|------|\n| `gateway.port` | HTTP 服务端口（默认 8080） |\n| `gateway.bind` | 绑定模式：`localhost` / `lan` / `0.0.0.0` |\n| `auth.token` | Bearer Token，用于 API 鉴权 |\n| `agents.dir` | 成员数据根目录 |\n| `models.primary` | 默认模型（`provider/model` 格式） |\n| `providers[]` | Provider 列表（type / apiKey / baseUrl 等） |\n\n---\n\n## 🔨 开发构建\n\n```bash\n# 前端依赖\ncd ui \u0026\u0026 npm install\n\n# 完整构建（必须用 make，不能直接 go build）\nmake build\n# 等价于: vite build + make sync-ui + go build\n\n# sync-ui：将 ui/dist 同步到 cmd/aipanel/ui_dist（go:embed 读取此目录）\nmake sync-ui\n\n# 多平台发布构建\ncd ui \u0026\u0026 npm run build \u0026\u0026 cd ..\nmake release\n\n# 启动\n./bin/aipanel --config aipanel.json\n```\n\n\u003e ⚠️ 直接 `go build` 会缺少 UI 静态文件（go:embed ui_dist），**必须用 `make build`**\n\n---\n\n## 📋 版本里程碑\n\n| 版本 | 内容 | 状态 |\n|------|------|------|\n| v0.1–v0.4 | 项目骨架、LLM 客户端、Session 存储、Tools、Runner、Vue 3 UI | ✅ |\n| v0.5 | Auth、Stats、安装脚本、多 Agent 协同 | ✅ |\n| v0.6 | 记忆模块、团队关系图谱、Telegram 完整能力 | ✅ |\n| v0.7 | 消息渠道下沉成员级别、per-agent 独立 Bot | ✅ |\n| v0.8 | SkillStudio 技能工作室、Web 多渠道隔离、历史对话系统 | ✅ |\n| v0.9.0 | 团队图谱交互、全局项目系统、成员管理增强 | ✅ |\n| v0.9.1–v0.9.11 | 后台任务系统、移动端响应式、Telegram 持久会话、CF 加速节点、稳定版 | ✅ |\n| v0.9.12–v0.9.17 | 三级记忆系统、多 Provider 支持、Config migration v1→v2、OpenAI-compat 工具修复 | ✅ |\n| v0.9.18–v0.9.23 | MiniMax / DeepSeek 修复、Provider API Key 管理 UI、Goals 目标规划（甘特图）、Cron 隔离会话 | ✅ |\n| v0.9.24 | 甘特图全面重构（7 级缩放、惯性拖拽、今日锚定、v-for key 重复修复）、memory_search 工具 | ✅ |\n| v0.9.25 | 浏览器自动化（go-rod，16 工具，ARIA 快照）、Cron 隔离 session、send_message 工具 | ✅ |\n| v0.9.26 | localStorage 版本检查缓存 bug 修复（semver 比较）| ✅ |\n| v0.9.27 | 58 个工具单元测试、agent_spawn 始终注册修复 | ✅ |\n| v0.10.x | Provider 测试修复、MiniMax POST 探测、新登录页 | ✅ |\n| v0.10.15 | CLI 子命令（zyhive start / stop / restart / status / enable / disable / token） | ✅ |\n| v0.10.16–v0.10.20 | 全新聊天首页（ChatHomeView）、历史会话选择、成员下拉、Token 用量显示 | ✅ |\n| 26.3.17v1 | 版本号格式变更（年.月.日vN）；工具生态全面升级（web_search / image / process / cron_* / sessions_* / acp_*）；工具权限策略系统；内置心跳；ACP 编程代理 | ✅ |\n| 26.3.17v2 | 对话区高度修复（is-chat-page flex 链）| ✅ |\n| 26.3.17v3 | AgentDetailView + WorkspaceChatLayout 深色主题统一 | ✅ |\n| **26.3.18v1–v8** | **全站浅色主题**：移除 dark mode，恢复所有页面浅色配色；侧边栏折叠按钮；Token 用量 SSE 正确透传；LogsView 浅色终端风格 | ✅ |\n| **26.3.29v1–v15** | **派遣任务体验**：计时显示、LLM 续写汇报；空白气泡彻底修复；输入框超长滚动 | ✅ |\n| **26.3.31v1** | **Coordinator 模式**：多 Agent 协调者提示词、task-notification XML、AgentDefinition 标准化、SessionMemory 后台提取 | ✅ |\n| **26.4.1v1–v20** | **飞书渠道全面接入**：WS 长连接（protobuf）、流式卡片回复、7 大飞书能力工具、群聊模式配置、配对授权优化、多人对话上下文区分 | ✅ |\n| v0.11（规划中）| 团队规划系统增强、会议系统、ChatsView 统一重写、共享工作区权限 UI | 🔜 |\n\n---\n\n## 📄 License\n\n引巢 · ZyHive 采用 **GNU Affero General Public License v3.0（AGPL-3.0）** 开源协议。\n\n- ✅ 个人使用、学习、研究 — 完全免费\n- ✅ 自托管私用 — 完全免费\n- ✅ 修改和二次开发 — 必须以相同协议开源\n- ⚠️ 基于本项目构建网络服务对外提供 — 必须开源全部改动\n- 🚫 商业闭源集成或托管销售 — 需要商业授权\n\n**zyling（智引领科技）** — 商业授权联系方式见 [zyling.ai](https://zyling.ai)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzyling-ai%2Fzyhive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzyling-ai%2Fzyhive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzyling-ai%2Fzyhive/lists"}