Yuzu482/YHWH

Kether-governed AI agent orchestration with Pi/MCP, isolated workers, LSP tools, and a portable Windows/WSL2 installer

About YHWH

YHWH 是面向 Windows 11 + WSL2 的便携式 Kether 治理规则与 Pi 执行环境，适合希望为 AI 编码工作流配置受控 worker、沙箱和 LSP 工具的开发者与维护者。它提供宿主接入配置、主代理规则、资源限制与结果校验；不安装主代理客户端，也不代表所有宿主或模型均已实机验证。

快速开始： 查看一键安装（需 Windows 11、WSL2 与硬件虚拟化），或先读常见客户端接入；项目结构见下方，安装细节与验证边界见安装和验证与卸载。

主代理只负责思考与调度： Astra（或宿主选择的主模型）负责方案、调度、补丁整合与验收；代码、测试和实现修复由 Pi 子代理编写，原生 worker 默认 Luna/medium，并按任务复杂度显式选择 low、high 或 max。子代理失败不自动回退为主代理编码。该策略是宿主指令约束，不能禁用所有客户端的编辑工具；详见职责与失败处理与思考档位和交付预算。

子代理监管心跳： 本地计时器提供不调用模型的心跳，并单独记录最近执行进度；静默不触发自动重试。它不证明远端模型健康，也不自动唤醒主代理；详见心跳说明与部署边界。

交付诊断（待发布）： 新增思考、正文、工具事件计数及最近活动时间，帮助解释子代理超时；不保存原始内容，不改变预算或成功判定。现有安装需升级；它不是完成等待接口。详见诊断字段与证据边界。

连续调用改进：HeadlessBatchEvents 实时显示各项阶段、等待状态和结果；会话缓存减少重复文件读取与哈希，保留每次版本检查。整批执行前校验，同会话串行调用，失败即停止；报告缓存命中及分段耗时。详见操作与验收边界。

v0.12 工作流优化： CLI 实机回显验收、连续批次与耗时证据、可选 Windows Job Object 清理、受管插件升级/回滚、Git 变更影响候选及 Windows CI 配置。Antigravity 路径留空、默认禁用；CI 尚有失败项。源码能力与已部署/已发布状态分别记录，见操作与验收指南。

新增可选特性：Codex、Claude Code、Antigravity 官方 CLI 无头主代理入口，包含版本锁定、统一结果、运行预算和发布/本地文件比对。现有 Pi 路由保持不变，默认不启用客户端。见 使用说明。

v0.13.0： 原生 Luna worker 改为按任务选择思考档位（默认 medium），加入交付和清理预算、思考／正文／工具活动诊断，以及 Windows 与无凭据测试兼容性修复。保留此前的连续调用、心跳、关系记忆和确定性探针。本地服务需单独升级，性能收益尚未做对照验证；详见双语发布说明。

开发背景、架构演进、关键决策及历史验证边界见 架构开发历史；对应的脱敏记录见 历史证据索引。

本仓库的 README 统一采用中英文双版本，并在顶部提供语言切换按钮；新增或修改时同步维护两版。维护约定见 AGENTS.md（仓库文件，不随安装包分发）。

0.7 受控 API 配置： 支持 OpenCode Go、CommandCode、OpenRouter 和自定义 HTTPS 平台。宿主显式配置后选择可选 API 路由，保留 Luna/Sonnet 5 与 max 绑定、审查者无工具、无自动降级。新增 Configure-Providers.cmd；见平台配置指南。真实账号与付费心跳尚未验证。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/Yuzu482--YHWH.html)

Related MCP servers