zyhive

README

引巢 · ZyHive

zyling 旗下 AI 团队操作系统 — 让每一个 AI 成员各司其职、协同引领

以团队为核心，每个 AI Agent 是团队成员。

一行命令安装，打开浏览器即可管理整个 AI 团队：配置每个成员的身份、灵魂、记忆、技能，设计组织架构，让成员之间互相协作讨论。

---

🚀 快速开始

一条命令，自动识别平台（Windows / macOS / Linux 通用）

Windows（PowerShell）：

irm https://install.zyling.ai/install | iex

macOS / Linux：

curl -sSL https://install.zyling.ai/install | bash

Windows Git Bash / MSYS2 / Cygwin 与 macOS/Linux 命令相同，脚本会自动检测并调用系统 PowerShell 完成安装。

安装完成后，终端直接显示访问地址和访问令牌：

╔══════════════════════════════════════════════╗
║  ✅  ZyHive 安装成功！版本: v0.10.12         ║
╚══════════════════════════════════════════════╝

  📍 本地访问：  http://localhost:8080
  🏠 内网访问：  http://192.168.1.100:8080
  🌐 公网访问：  http://123.45.67.89:8080
  🔑 管理员 Token：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

---

🌐 智能安装端点

URL	说明
https://install.zyling.ai/install	通用端点，按 User-Agent 自动返回 .sh 或 .ps1
https://install.zyling.ai/zyhive.sh	Linux / macOS bash 脚本
https://install.zyling.ai/zyhive.ps1	Windows PowerShell 脚本
https://install.zyling.ai/latest	最新版本号 JSON
https://install.zyling.ai/dl/{ver}/{file}	二进制下载代理（国内加速）

国内用户通过 Cloudflare 全球节点加速下载，无需访问 GitHub。

---

✨ 核心功能

成员管理

• 多 AI 成员：每个成员有独立的身份（IDENTITY.md）、灵魂（SOUL.md）、记忆、工作区、技能、定时任务、消息渠道
• 系统配置助手 __config__：内置不可删除，启动时自动创建，专门负责全局配置问答
• 独立模型：每个成员可单独配置大模型（身份 Tab 下拉选择）
• 删除成员：自动停止 Bot、清理工作区，前端确认弹窗防误操作
• 头像颜色：每个成员有个性化颜色，图谱/对话均展示

对话 & 会话

• SSE 流式对话：与任意成员实时对话，支持工具调用（折叠卡展示，含进行中呼吸灯动画）
• 会话持久化：JSONL 格式存储，含消息历史、Token 估算、Compaction 摘要
• 统一会话侧边栏：面板会话与 Telegram / Web 渠道会话合并为单一列表，按最后活动时间排序；渠道会话只读显示（标注来源标签）
• 对话管理（ChatsView）：跨成员查看全部历史对话，工具调用卡片展示，按渠道/成员双筛选
• @ 其他成员：对话中转发消息给指定成员，获取跨成员回复

工作区 & 知识

• 工作区文件管理：文件树递归展示（VSCode 风格，Catppuccin Mocha 深色，SVG 矢量图标）、在线编辑器、创建/删除文件、二进制文件检测
• 身份 & 灵魂编辑：可视化编辑 IDENTITY.md / SOUL.md，失焦自动保存
• 记忆管理：浏览和编辑 Agent 记忆文件，每日日志，自动整合（Cron 触发）
• 成员环境变量：AI 成员可通过 self_set_env / self_delete_env 工具自行持久化私有变量

技能系统（SkillStudio）

• 三栏布局：技能列表 | 文件编辑器 | AI 协作聊天
• AI 实时推荐技能方向，自动生成 skill.json + SKILL.md
• 沙箱隔离：工具操作严格限制在 skills/{skillId}/ 目录
• 并发后台生成：多技能同时生成不互相阻塞，左侧绿色呼吸点指示
• 技能历史持久化到后端 session

团队协作

• 团队图谱（TeamView）：可拖拽成员节点，拖放创建关系，SVG 精确坐标，4 种关系类型（上下级有向箭头 / 平级协作 / 支持 / 其他），一键整理排列
• 关系管理：卡片式弹窗选择关系类型，支持「⇄ 翻转」方向，点击连线编辑/删除，双向自动同步
• 后台任务系统（SubagentsView）：基于关系权限（上级可派遣下级，下级可汇报，平级协作互发），任务卡片显示类型/关系/流向
• 目标规划（GoalsView）：个人/团队目标管理，支持甘特图（7 级时间颗粒度缩放、惯性拖拽、今日线锚定）与列表双视图，里程碑、多成员分配、定期检查绑定 Cron

消息渠道

• Telegram Bot：每个成员独立配置 Bot，白名单管理，图片/视频/音频/文档/媒体组，群聊/话题线程，主动推送（/api/agents/:id/notify）
• Per-chat 持久会话：每个 Telegram chat 绑定独立 session，Bot 有完整对话记忆
• Web 渠道：独立 URL /chat/{agentId}/{channelId}，支持密码保护，Session 隔离
• 热重载：新增/修改渠道立即生效，Token 唯一性检测

浏览器自动化

• 16 个浏览器工具：基于 go-rod（纯 Go，零 Node.js 依赖），覆盖导航 / 快照 / 截图 / 点击 / 输入 / 滚动 / 执行 JS / 等待元素
• ARIA 快照：JS 注入 data-zy-ref 标记所有可交互元素，生成结构化 ARIA 树供 AI 精准操作
• 多成员隔离：每个成员有独立 Tab 会话，全局共享一个 Chromium 进程
• Chromium 自动下载：首次使用自动拉取，零人工干预

记忆检索（memory_search）

• 向量 + BM25 混合检索：对工作区 memory/ 目录所有 .md 文件建立混合索引
• 自动降级：无 embedding provider 时自动切换为纯 BM25 文本检索
• 增量更新：基于 mtime 检测文件变更，只重建变更文件的索引

任务 & 调度

• 定时任务（Cron）：可视化配置，每个成员独立任务，执行历史，一键运行
• Cron 隔离会话：每次任务执行在独立 session 中运行，不污染主对话历史
• NO_ALERT 抑制：任务输出以 NO_ALERT 开头时跳过推送，减少无效通知
• send_message 工具：AI 在隔离 session 中可主动向 Telegram 渠道发消息
• 技能库：跨成员汇总展示，按成员筛选，一键复制

全局项目系统

• 左侧项目列表 + 右侧文件浏览器 + 代码编辑器三栏布局
• 递归文件树，支持创建/删除文件，标签/描述元信息

模型 & 配置

• 多 Provider 支持：Anthropic / OpenAI / DeepSeek / Kimi / 智谱 GLM / MiniMax / 通义千问 / 自定义 Base URL
• Provider API Key 管理：Provider 与 Model 分离配置（v3 config），ResolveCredentials() 统一解析
• 在线测试：API Key 验证、模型 Probe，失败原因实时展示；国内 IP 被 Anthropic 封锁时明确提示并引导切换
• 工具调用能力矩阵：不支持 tool_call 的模型自动标注并前端灰显警告（如 deepseek-reasoner）
• Config 自动迁移：启动时自动执行 applyMigrations()，当前版本 v3，历史配置无需手动转换
• 全局 Tools：内置 read / write / edit / exec / grep / glob / web_fetch / memory_search / browser_* 等，可按成员启用/禁用

CLI 管理面板（类宝塔风格）

直接运行 zyhive（无参数）进入交互式管理菜单：

┌─ 操作菜单 ─────────────────────────────────────┐
│ [1] 系统状态                                    │
│ [2] 服务管理（启动 / 停止 / 重启）               │
│ [3] 配置管理（访问令牌 / 端口 / 绑定模式）        │
│ [4] 成员管理（查看 / 重置 AI 成员）               │
│ [5] 日志查看                                    │
│ [6] 在线更新（一键升级到最新版）                  │
│ [7] Nginx 管理                                  │
│ [8] SSL 证书管理                                │
│ [9] 备份与恢复                                  │
│ [0] 退出                                       │
└────────────────────────────────────────────────┘

服务管理完整支持 Linux（systemd）/ macOS（launchd）/ Windows（sc.exe）三平台。

---

🖥️ 平台支持

平台	安装方式	服务管理	备注
Linux (x86_64)	bash 脚本	systemd	✅ 推荐
Linux (arm64)	bash 脚本	systemd	✅ 支持
macOS (Apple Silicon)	bash 脚本	launchd	✅ 支持
macOS (Intel)	bash 脚本	launchd	✅ 支持
Windows (x86_64)	PowerShell 脚本	sc.exe	✅ 支持
Windows (arm64)	PowerShell 脚本	sc.exe	✅ 支持
Windows Git Bash	bash 脚本（自动转 PS）	—	✅ 自动适配

---

🛠️ 技术架构

Vue 3 + Element Plus (SPA, go:embed 单二进制)
        ↓ REST API + SSE
Go 后端 (Gin，单二进制)
        │
  pkg/runner    ← Agent 对话主循环（工具调用循环，并行执行）
  pkg/llm       ← Anthropic / OpenAI 流式客户端
  pkg/session   ← JSONL 会话存储（broadcaster fan-out + replay buffer）
  pkg/tools     ← 内置工具（read/write/edit/exec/grep/glob/web_fetch/show_image/memory_search/send_message/browser_*）
  pkg/browser   ← 浏览器自动化（go-rod，ARIA 快照，多成员 Tab 隔离）
  pkg/agent     ← 多成员生命周期 + 工作区管理 + 关系图
  pkg/channel   ← Telegram / Web 渠道（热重载，per-chat session）
  pkg/cron      ← 定时任务引擎（隔离 session，NO_ALERT 抑制）
  pkg/memory    ← 记忆整合（自动 Compaction）+ 向量/BM25 混合检索
  pkg/skill     ← Skills 管理 + Runner 注入
  pkg/project   ← 全局项目系统
  cmd/aipanel   ← 入口 + CLI 管理面板（跨平台服务管理）

---

⚙️ 配置文件

默认位置（一键安装后自动生成）：

• Linux / macOS root：/etc/zyhive/zyhive.json
• macOS 用户：~/.config/zyhive/zyhive.json
• Windows：C:\ProgramData\ZyHive\zyhive.json

{
  "gateway": {
    "port": 8080,
    "bind": "lan"
  },
  "auth": {
    "mode": "token",
    "token": "your-token-here"
  },
  "agents": {
    "dir": "./agents"
  },
  "models": {
    "primary": "anthropic/claude-sonnet-4-6"
  }
}

字段	说明
gateway.port	HTTP 服务端口（默认 8080）
gateway.bind	绑定模式：localhost / lan / 0.0.0.0
auth.token	Bearer Token，用于 API 鉴权
agents.dir	成员数据根目录
models.primary	默认模型（provider/model 格式）

---

🔨 开发构建

# 前端依赖
cd ui && npm install

# 完整构建（必须用 make，不能直接 go build）
make build
# 等价于: vite build + cp ui/dist → cmd/aipanel/ui_dist + go build

# 多平台发布构建（需先构建 UI）
cd ui && npm run build && cd ..
make release

# 启动
./bin/aipanel --config aipanel.json

⚠️ 直接 go build 会缺少 UI 静态文件（go:embed），必须用 make build

---

📋 版本里程碑

版本	内容	状态
v0.1–0.4	项目骨架、LLM 客户端、Session 存储、Tools、Runner、Vue 3 UI	✅
v0.5	Auth、Stats、安装脚本、多 Agent 协同	✅
v0.6	记忆模块、团队关系图谱、Telegram 完整能力	✅
v0.7	消息渠道下沉成员级别、per-agent 独立 Bot	✅
v0.8	SkillStudio 技能工作室、Web 多渠道隔离、历史对话系统	✅
v0.9.0	团队图谱交互、全局项目系统、成员管理增强	✅
v0.9.1	后台任务系统、移动端响应式、Telegram 持久会话、成员 Env 自管理	✅
v0.9.8–11	CF 加速节点、root 权限提示、Windows 完整支持、通用安装端点	✅
v0.9.12–17	三级记忆系统、多 Provider 支持、Config 迁移、OpenAI-compat 工具修复	✅
v0.9.18–23	MiniMax/DeepSeek 修复、Provider API Key 管理、Goals 目标规划（甘特图）	✅
v0.9.24	甘特图全面重构（7 级缩放、惯性拖拽、今日锚定、密集网格修复）	✅
v0.9.25	浏览器自动化（go-rod，16 工具，ARIA 快照）、memory_search、版本更新角标	✅
v0.9.26	Cron 隔离会话、NO_ALERT、send_message、统一会话侧边栏、工具错误精细化	✅
v0.9.27	58 个工具单元测试、agent_spawn 始终注册	✅
v0.10.0	稳定性修复：新实例登录 401 死循环、update check 未登录触发问题	✅
v0.10.1	Windows 安装脚本双修：irm|iex 崩溃、服务注册失败	✅
v0.10.3	Provider 测试修复：MiniMax 等厂商"未配置调用地址"问题	✅
v0.10.4	MiniMax 探测修复：改用 chat completion 探测替代不支持的 GET /v1/models	✅
v0.10.9	安装向导：bash / PowerShell 交互式向导（8 provider 预设）	✅
v0.10.10	工具调用修复：Runner 三个路径补全 SupportsTools 字段	✅
v0.10.11	agent_list 修复：Pool 正式注册 WithAgentLister	✅
v0.10.12	工具生态全面升级：web_search / image / process / cron_* / sessions_* / acp_* + 工具权限系统 + 内置心跳 + ACP 编程代理	✅
v0.11	团队规划系统、会议系统	🔜 规划中

---

📄 License

引巢 · ZyHive 采用 GNU Affero General Public License v3.0（AGPL-3.0） 开源协议。

• ✅ 个人使用、学习、研究 — 完全免费
• ✅ 自托管私用 — 完全免费
• ✅ 修改和二次开发 — 必须以相同协议开源
• ⚠️ 基于本项目构建网络服务对外提供 — 必须开源全部改动
• 🚫 商业闭源集成或托管销售 — 需要商业授权

zyling（智引领科技） — 商业授权联系方式见 zyling.ai