AI4XE/ai4ai
AI 工程把 AI Agent 的运行状态、上下文续期和自我复制抽象成统一接口,让同一套工具调用跨多个 harness 通用。
项目介绍
AI Agent 的扩展能力往往绑死在具体 harness 上:Claude Code、Codex、OpenCode、DeepSeek Harness 各有各的调用方式,同一件任务换个环境就要重写。AI4AI 想解决的就是这层割裂,它把这些能力抽象成一个统一接口,让相同的工具调用跨 harness 生效,技能也能保持可移植。
接口按三件事组织:读取自身运行状态(上下文用量、模型、推理强度与窗口大小)、按需续期上下文、创建自身的副本用于任务调度与协调。支持 Linux 和 macOS 上的 Claude Code、Codex、OpenCode、DeepSeek Harness;Windows 上除 DeepSeek Harness 外都走 WSL,具体细节和限制见契约文档。
快速使用
需要 Node.js 22 及以上。推荐不装全局包,直接运行:
npx ai4ai init
npx ai4ai status
init 会检测并注册本机的 harness,操作可重复执行;加 --yes 跳过确认。全局安装(npm install -g ai4ai && ai4ai init)可让命令常驻,项目级安装(npm i -D ai4ai && npx ai4ai init --scope project)则绑定到当前项目。重新注册用 ai4ai upgrade,移除注册用 ai4ai uninstall。
注册后 Claude Code、OpenCode 和 DeepSeek Harness 会直接暴露工具;Codex 不走这条路,改用命令行调用:
npx ai4ai session --operation status --harness codex
使用约束
- 必须使用 Node.js 22 及以上版本。
- Windows 上 Claude Code、Codex、OpenCode 依赖 WSL,仅 DeepSeek Harness 原生可用;平台相关的限制写在契约文档而非 README。
- 接入方式分两种:多数 harness 以工具形式使用,Codex 通过 CLI 调用,设计自动化流程时要区分。
- 项目采用 MIT 许可证。
- 上下文续期和复制自身依赖各 harness 自己的上下文与进程模型,不同实现下的行为不一定完全一致。
HotRepo 点评
AI4AI 于 2026-11-21 出现在 HotRepo 新项目榜,在约一小时的窗口内新增 7 星,累计 108 星、0 Fork。样本很短,只能说明对多 harness 工作流感兴趣的人给了早期关注,不足以判断采用率或稳定性。更有价值的是项目本身的设计取向:为四个 harness 定一份契约,并且让 Codex 明确退回到 CLI。已经在同时使用多个 harness 的读者,值得先读契约文档再决定是否接入。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- deepseek-ai/deepseek-harnessDeepSeek 开源、以「一切皆插件」架构构建的 AI 智能体运行框架,适合本地运行与扩展智能体的开发者。
- wshobson/agents把同一套编程 Agent、技能和命令适配到 Claude Code、Codex、Cursor 等多个工具,省去重复维护提示词。
- csyangwen/dsh-memory-evolve为 DSH 会话提供跨会话长期记忆、待办、技能、评审、画板和多会话编排的纯插件实现。
- ruvnet/ruflo给 Claude Code 和 Codex 套上多智能体集群、持久记忆与跨机联邦的运行时外壳。
- QCYTSN/dsh-dafeiyu为 DeepSeek Harness 提供桌面宠物,在始终置顶的透明窗口里实时显示 Agent 任务状态。