AgentRazor

简体中文 | English

AgentRazor 是一个围绕 Codex app-server 协议构建的插件化 AI Agent 平台。项目提供用户对话端、管理后台、Skills 管理、app-server 配置管理、会话生命周期管理和 Token 用量指标。

功能特性

• 用户侧 Agent 对话页面：支持用户登录、Access Token/Refresh Token 续期、流式回答、过程状态展示、Mermaid 渲染、生成图片展示、归档、置顶、分组和会话状态恢复。
• jzero REST 服务端：负责认证、会话元数据、SSE 事件分发、Token 用量记录、Codex app-server 生命周期集成和插件能力。
• 插件化 Agent 能力：服务端可加载独立插件二进制和插件配置，插件可以提供 CLI 工具、Skills、迁移脚本和运行时能力；Codex 运行时会同步插件 Skills，并在 Agent 会话中按需调用。
• 管理后台：支持用户、角色、菜单、Agent Skills、Codex 配置文件、app-server 重启和首页 Agent 指标。
• Skills 管理：支持上传、浏览、编辑和删除 Codex Skills。
• Docker Compose 部署：包含 server、agent 用户端、web 管理端、PostgreSQL 和 Redis。

仓库结构

• server：jzero REST 服务端，包含 Codex app-server 生命周期管理、会话、SSE、迁移、插件加载和 Skills 同步。
• agent：面向用户的 Vue 3 对话应用，包含登录态维护、Token 续期、对话流式展示和会话操作。
• web：Vue 3 管理后台。
• core-engine：管理后台使用的共享基础引擎。
• deploy/docker-compose：Docker Compose 部署配置。
• docs：项目文档。
• specs：产品、功能和技术研究文档。

本地开发

本地开发默认使用 Docker Compose 启动完整依赖和前后端服务，避免本机环境、Codex home、数据库和 Redis 配置不一致。

cd deploy/docker-compose
docker compose up -d --build

服务启动后：

• Agent 用户端由 agent 服务提供。
• 管理后台由 web 服务提供。
• 服务端配置、数据和日志位于 deploy/docker-compose/server 下。
• Codex app-server 会从服务端数据目录中的 Codex home 读取 config.toml、models.json 和 auth.json。

常用单服务重建：

docker compose build server && docker compose up -d --no-deps server
docker compose build agent && docker compose up -d --no-deps agent
docker compose build web && docker compose up -d --no-deps web

提交前按改动范围运行验证命令：

cd server && go test ./...
cd agent && npm run build
cd web && npm run build

部署

默认部署配置位于 deploy/docker-compose。

cd deploy/docker-compose
docker compose up -d --build

常用单服务部署命令：

docker compose build server && docker compose up -d --no-deps server
docker compose build agent && docker compose up -d --no-deps agent
docker compose build web && docker compose up -d --no-deps web

规格文档

specs/ 用于沉淀规划和设计材料：

• specs/features：功能规格和实现说明。
• specs/product：产品需求和体验决策。
• specs/research：技术调研、协议分析和方案记录。

开源协议

AgentRazor 基于 Apache-2.0 License 开源。