ZeoKeel Harness

把 AI 从个人技巧
变成组织能力

员工在客户端里干活,做出来的技能与智能体可以共享给全员;用量、额度与审计留在企业自己的服务器上。 交付物是一个容器镜像:服务端、内置 PostgreSQL、反向代理与三平台客户端安装包都在里面, 员工机器不需要访问任何外网。

交付物
一个容器镜像
服务端 + 数据库 + 客户端
员工侧
零外网
只访问企业域名,安装与升级同源
组织侧
经验可复用
共享技能、智能体与应用
管理侧
水位可度量
用量、余额与审计一屏可查
ZeoKeel Harness 桌面客户端主界面
Adoption

企业 AI 水位:从个人技巧到组织能力

大多数企业卡在同一处 —— 个人用得不错,组织拿不到。这套平台要解决的正是后面三步: 让经验沉淀、让能力复用、让水位看得见。

L1

个人尝鲜

员工各自用外部工具,数据出企业,成本是一笔糊涂账。

平台提供
  • 客户端随服务端分发,员工只访问企业域名
  • 上游模型密钥只在服务端,员工机器上没有任何 Key
L2

部门试点

每个部门各接一套,成果无法横向复制。

平台提供
  • 统一模型网关与模型目录:接新模型是改配置,不是改代码
  • 能力中心按用户或部门授权,不再各自造轮子
L3

平台化复用

技能、智能体与应用变成可检索、可审批、可复用的资产。

平台提供
  • 能力中心:员工上传 → 管理员审批 → 全员复用,归属清晰
  • 五轨记忆:项目经验按目录与分支沉淀,跟着项目走
  • 应用中心:业务自己造的小工具,全员可直接打开
L4

可度量的 AI 原生

管理层看得到水位:谁在用、用在哪、花了多少、哪些能力被复用了。

平台提供
  • 用量中心按部门 / 成员 / 模型拆账,账本可逐笔对账
  • 余额闸门与审计日志:成本可控、行为可回溯

能力中心与记忆如何工作 · 管理员看到的用量与审计 · 员工自建应用

Architecture

一个平台,三层协同

客户端负责交互,本地服务负责智能体运行,服务端负责账号、模型与审计。 三层各自独立升级,接口只有一套。

Desktop

桌面客户端

原生窗口、系统托盘、自动更新。对话、能力中心、连接器、定时任务、内置浏览器与语音输入都在一个界面里完成。

  • 安装包自带 Node.js / pnpm / Python 运行时,员工机器不需要任何开发环境
  • 关闭窗口只是收进托盘;诊断包一键导出
  • 连接器凭据、浏览器会话、定时任务按账号隔离
Local host

本地智能体引擎

自动启动、停止与恢复本地 Harness 服务,会话、文件与工作区留在本机;模型请求经企业网关转发。

  • 上游 DeepSeek Harness 以固定版本原样运行,不魔改源码
  • 桌面壳与业务插件按官方 Cordis 机制组合,可替换、可演进
  • 沙箱按会话分档:只读 / 工作区内修改 / 完全权限
Server

企业服务端与管理后台

一台内网服务器承载账号、模型网关、额度计费、能力中心审批与审计,管理后台随镜像内嵌。

  • 上游模型密钥 AES-GCM 加密后只存服务端,员工拿不到任何 API Key
  • 客户端安装包与升级包由这台服务器下发
  • 员工接触不到管理后台:它在 /admin/,按 RBAC 权限点显示
员工机器 不需要访问任何外网 桌面客户端 智能对话 能力中心 连接器 定时任务 内置浏览器 语音输入 loopback · 127.0.0.1 本地 Harness 服务 上游固定版本 + 插件组合 · 会话、文件与工作区留在本机 HTTPS + Bearer token 客户端安装包与升级清单 (SHA-256 校验) 企业内网服务器 · 一个容器镜像 Caddy 反代 / TLS Go 服务端 PostgreSQL 认证 模型网关 用量计费 能力中心审批 审计日志 客户端分发 上游模型服务 OpenAI 兼容 Anthropic 兼容 上游密钥只存服务端 /v1/*
数据流与信任边界:员工机器只需要与企业内网服务器通信,上游密钥不出服务端。 (窄屏可左右滑动查看完整示意图)
Capabilities

员工每天会用到的能力

开箱即用,不需要装插件市场里的第三方扩展;每一项都由服务端统一配置与审计。

智能对话与工作区

每条会话绑定一个项目目录;模型读写文件、执行命令、操作浏览器时按权限门控逐次确认。

能力中心

技能与智能体两类内容,我的 / 市场两个来源;安装、更新、卸载与上传审核状态一站可见。

连接器中心

用一条标准 MCP 配置接入企业内部系统,OAuth 授权与令牌续期自动完成,凭据加密留在本机。

自动化任务

官方 Schedule 的单次/间隔/每日/每周/cron 提醒,到点投递回原会话;按账号隔离,投递记录可查。

内置浏览器

Agent 可接管浏览器完成操作:多标签、地址栏、下载管控与操作日志;控制权只在「我来操作」按钮上交接。

语音输入

说话转成输入框草稿;识别在本机子进程里跑,音频不出机器、离线可用,模型随客户端分发。

五轨记忆

用户档案 / 全局事实 / 项目关键记忆 / 项目日志 / 每日日志,按目录与 git 分支隔离,确认制写入。

应用中心

员工用 AI 自建 WASM 应用,只在客户端独立窗口打开;服务端不需要为应用准备任何公网入口与证书。

桌面客户端文档 · 插件开发 · 插件生态

Admin console

账号、模型、额度与审计,都在一台内网服务器上

管理后台随服务端镜像内嵌(/admin/),侧栏按当前账号的 RBAC 权限点显示: 超级管理员看到全部,审计员只有只读视图,员工接触不到它。 水位不靠问卷估 —— 用量中心按部门、成员与模型给出真实的调用与费用。

  • 账号与认证:本地账号、LDAP、OIDC 三种登录方式;管理员 MFA。改密、降权、禁用即时吊销该账号全部令牌。
  • 模型网关:上游供应商与模型目录由管理员统一配置,可标注输入模态;密钥加密存储,客户端只看到一个模型清单。
  • 用量与计费:按用户按模型计量输入/输出与缓存命中,支持高峰时段分级定价;余额闸门与可逐笔对账的账本。
  • 审批与授权:共享技能与智能体走统一审批队列,官方与精选内容带徽章;授权对象可以是用户或部门。
  • 审计日志:用户、部门、网关、能力中心与共享审批的关键操作全程留痕,哈希链防篡改,保留策略可配。
  • 服务器信息:版本、更新提示、数据库与迁移状态、模型并发一屏可查;升级前先备份,回滚只需切回旧镜像。
管理后台用量统计
用量中心:按部门、成员、模型拆开的费用与 Token 明细
Deployment

私有化部署:一个镜像,一份说明

没有安装脚本,不依赖镜像仓库,也不需要部署机能访问 Git 仓库。 镜像自带首次部署、升级与回滚所需的一切。

1

取镜像

从本渠道的更新服务器下载镜像包与 SHA256SUMS,校验后 docker load。不经任何镜像仓库,内网可完全离线旁路取包。

2

导出部署文件

一条命令把 compose、三种证书模式的 Caddyfile 与三平台客户端安装包 导出到部署目录,再按说明写 .env。

3

启动与自检

docker compose up -d 拉起 Caddy + 服务端 + 内置 PostgreSQL; 健康探针与客户端分发清单都有明确判据,通过才算部署成功。

4

交付全员

员工从企业服务器门户下载客户端并登录;客户端版本跟随服务端, 升级服务端即升级全员客户端。

部署机上执行 · 详细步骤见 容器化部署
# 1) 校验并导入镜像(<版本> 从本渠道 latest.json 的 server.version 取,不带 v)
curl -fL -O https://release.zeokeel.com/official/releases/<版本>/zeokeel-server-<版本>-amd64.zip
unzip -p zeokeel-server-<版本>-amd64.zip image.tar | docker load

# 2) 把部署文件导出到部署目录(镜像自带 compose / Caddyfile / 客户端安装包)
docker run --rm -v /opt/zeokeel:/out -e ZEOKEEL_UNPACK_STACK=/out \
  zeokeel-harness-server:<版本>

# 3) 写 .env 后启动,并确认健康检查通过
cd /opt/zeokeel && docker compose up -d
curl -k https://<你的域名>/healthz

数据只在 bind mount 目录里

zeokeel-data/(含 master.key)与 pg-data/ 挂在部署目录下,升级只换镜像、不动数据,回滚只需切回旧镜像。

三种证书模式

纯内网自签(Caddy 本地 CA)、公网域名自动签发、企业正式证书三选一, 只切换 .env 的 TLS_MODE。

四条数据安全铁律

不执行带 -v 的清理、不用 latest 标签、升级前必须备份且校验非空、 不覆盖已有部署目录的 .env。

部署总览 · 升级、备份与回滚 · 客户端分发与升级 · 离线部署 · 运维与排障

Delivery

客户端是服务端的一部分,品牌也是

一次构建,一个渠道;品牌不会被版本升级「洗掉」。

客户端随服务端发布

Windows / macOS / Linux 安装包打进服务端镜像,由企业服务器自己下发 (/api/client/v2/updates/manifest 与 /updates/client/*)。 版本错配在结构上不可能发生。

员工零外网

员工只访问企业域名:安装、登录、升级都由这台服务器完成。 断点续传与 SHA-256 校验内建,内网也能稳定分发上百 MB 的安装包。

渠道白标交付

名称、标语、欢迎语、标识与主题色来自随镜像交付的渠道内容, 登录页、客户端界面、管理后台与门户页一处配置、全产品一致;渠道之间互不升级。

1 服务端升级 改一个镜像标签 重启即完成 2 发布升级清单 版本、绝对 HTTPS 地址 与每个资产的 SHA-256 3 客户端校验 断点续传下载 校验通过才安装 4 全员版本一致 登录态、会话与设置 原样延续 每个客户端只认它登录的那台服务器:不访问公网更新源,也没有按渠道划分的下载站。
一次升级服务端,全员客户端在同一轮里跟上;渠道身份由服务端在结构上决定。 (窄屏可左右滑动查看完整示意图)
Security

安全与数据主权

每一条都对应一个具体实现与一条自动化判据,而不是一句形容词。

凭据加密存储

上游密钥以 AES-GCM 加密(密文前缀 enc:v1:,主密钥独立成文件);凭据按 0600/0700 权限原子写入,防符号链接与路径逃逸。

令牌只存哈希

员工 API 令牌 90 天过期且只存哈希;改密、降权、禁用与用户更新同事务吊销。管理端会话 12 小时硬上限 + 空闲滑动过期 + CSRF。

沙箱与权限分档

会话可选只读 / 工作区内修改 / 完全权限;写操作受工作区与临时目录约束(Linux Landlock、Windows ACL),越界即拒绝。

出站边界

客户端默认不读取系统代理,升级源只有它登录的那台服务器;未连接服务端时不做任何外发检查,内网可完全离线。

严格默认拒绝

未授权的市场与共享内容一律 404(不泄露存在性);授权变更留痕;管理员操作经 RBAC 与审计双重约束。

数据主权

数据、密钥与账本都在企业自己的机器上(bind mount 目录),随镜像交付,没有按人头授权费,也不需要把数据交给第三方。

系统架构与安全设计 · 管理后台说明 · 常见问题

Screenshots

界面预览

以下为产品真实界面截图,未做视觉修饰。

Changelog

更新说明

每个版本都带策展的发布说明:谁必须升级、不升级会怎样。

查看全部更新 · 历史版本与镜像归档 GitHub Releases

Wiki

按角色进入文档

Wiki 有中文与英文两套,每页右上角可切换语言。

FAQ

常见问题

ZeoKeel Harness 与 DeepSeek Harness 的关系?

上游 DeepSeek Harness 提供核心智能体、插件系统与 Web UI;本项目提供桌面封装、本地服务启动与企业服务端,基于固定版本构建,不魔改上游源码。桌面壳自身就是一个合法的 DSH 插件。

支持私有化部署吗?

支持,且是主要形态。交付物是一个容器镜像(含服务端、内置 PostgreSQL、Caddy 与三平台客户端安装包),可选三种证书模式,数据全部落在部署目录的 bind mount 里;也支持并入已有反代或单二进制 + 外部 PostgreSQL。

员工电脑需要访问外网吗?

不需要。客户端从企业自己的服务器下载与升级,员工机器只与企业域名通信;完全隔离的环境可以离线旁路取包部署。

客户端怎么升级?

升级服务端即可。客户端安装包随服务端镜像发布,客户端定期向它登录的服务器检查新版本,并按清单里的 SHA-256 校验后安装——不存在「客户端升了、服务端没升」的错配。

模型和密钥放在哪?

模型目录与上游 API Key 由管理员在管理后台配置,密钥在服务端加密存储,客户端只拿到一个模型清单与会话令牌,员工机器上没有任何上游 Key。

连接器与技能如何分发?

遵循「技能 + MCP」两种标准形态:企业能力以 SKILL.md 经能力中心分发(审批 + 授权),MCP 能力走连接器框架,一条标准配置即可接入;两者都可审计、可审批、可收回。

是否开源?

本项目遵循 MIT License,完全开源免费。上游以固定版本原样运行,升级只跟随上游版本号。

支持哪些平台?

Windows x64(NSIS 安装程序)、macOS(Apple 芯片,DMG,正式版已签名与公证)与 Linux x64(AppImage);企业交付面不含 Linux deb。

用一台内网服务器,把 AI 交给整个团队

取一个镜像,按同一份说明完成部署、升级与回滚;员工机器不需要访问任何外网。