Skip to content

// 开源 · 私有部署 · Apache 2.0

一个目录定义一个 Agent,
一套底座管起一群 Agent私有可审计不锁任何云管起一群 Agent

YokeOS 是装在企业自己基础设施上的 Java 原生 Agent 底座(Agent Harness OS)——私有部署、全链路可审计、不锁任何云。不是又一个聊天机器人,而是让一群 Agent 可靠运行、被管起来的那层底座。第一阶段运行时内核正逐节交付中。

yokeos — bash
yokeos init
✓ 工作区已初始化:.yokeos/
agents/ · skills/ · output/ · memory/ · sessions/ · logs/
yokeos profile create ops-agent
✓ .yokeos/agents/ops-agent/AGENT.md
yokeos chat --profile ops-agent
you最近一小时 nginx 有报错吗
[ops-agent] 思考中...
→ Tool: shell
→ tail -n 100 /var/log/nginx/error.log
→ SandboxChecker: ✓ 白名单放行
[ops-agent]
过去 1 小时发现 3 个 502 错误,均来自 upstream backend:8080。
建议检查后端健康状态。需要我生成诊断报告并推送到团队群吗?
0云锁定私有部署在你自己的 K8s、虚拟机与物理机上
day-one审计落库llm_calls 与 tool_invocations 从第一节就写入
3触发源CLI · REST API · cron 钟推,同一条执行链路
6核心能力单机运行时内核的最小完备集

三个入口,一个引擎,一套存储。

YokeOS Architecture

放一个目录,得一个 Agent

一个目录 = 一个 Agent

AGENT.md = frontmatter(运行配置)+ 正文(任务指令)。REST 创建、一句话生成草稿,或直接把目录放进工作区——免重启即上线。

免重启一句话生成多 Agent 并存
文档 →

对接 LLM

Provider 抽象统一对接主流大模型,Agent 不感知具体厂商;多 Provider 并存靠显式 name → ChatModel 映射区分,不靠类型扫描。

显式映射运行时切换本地推理
文档 →

自实现 ReAct 循环

推理引擎自己实现,不套外部 Agent 框架。LLM 决定调哪个工具,底座执行后回填结果,循环行为完全可控。

自实现迭代上限全程审计
文档 →

两层记忆

会话记忆跨重启恢复;长期记忆是一个 MEMORY.md 文件,核心/归档两个分区,每次组装 prompt 自动注入,后端可插拔。

会话 + 长期核心/归档三档后端
文档 →

工具体系与沙箱

九个内置工具覆盖最短链路,每次调用过路径/命令/域名三重白名单并落审计;扩展三档,零代码起步。

三重白名单MCP三档扩展
文档 →

通知、定时与对外服务

Agent 干完活推 Webhook 通知;cron 到点自跑——第三触发源。REST API 18 个端点对外暴露全部能力,附 Web 管理台第一版。

Webhookcron 钟推18 端点
文档 →

六个能力,拼出企业的真实场景

01

全渠道客服

理解用户问题,循环查知识库,记住客户历史,接 CRM,业务系统经 HTTP 接入。

02

运维助手

分析告警,调日志查询与服务重启,记住历史故障,接 Prometheus/SSH,Webhook 触发。

03

研发助手

理解需求,读代码改代码,记住项目惯例,接 GitHub/CI,IDE 插件接入。

04

知识管理

理解问题,检索文档,记住团队约定,接 Confluence,内网门户嵌入。

05

销售助手

拼装客户画像,调 CRM 与企业信息工具,记住客户偏好,销售 App 直接调用。

06

数据分析

生成 SQL,执行查询并出图,记住业务表结构,接 BI 系统与看板。

慢就是快,分阶段克制。

阶段一进行中

单机运行时内核

  • 六大核心能力
  • 一个目录 = 一个 Agent、动态管理、多 Agent 并存
  • 审计落库与白名单沙箱从第一天就在
  • 以参照实现为基准逐节交付、等价验收
阶段二规划中

能力补齐与底座分布式

  • 知识库与语义记忆:导入、切分、向量检索
  • 节点无状态化、状态外置、多副本高可用
  • 平台基线升级(Spring Boot 4 + Spring AI 2.0)
阶段三愿景

跨节点 Agent 协作

  • 引入 Agent 通信底座,对接 A2A
  • 跨节点发现、委托、可靠异步协同

让一群 Agent,跑在你完全掌控的底座上。

从定位到技术方案,整套立项文档链已经公开——每一个能力都有可追溯的规格。第一阶段运行时内核正逐节交付,欢迎对照阅读。