# zhipin-agent-runtime

**Repository Path**: nomenofear/zhipin-agent-runtime

## Basic Information

- **Project Name**: zhipin-agent-runtime
- **Description**: 智聘云图 Agent 运行时 Docker 镜像，集成开发环境与项目管理工具链。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-10
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zhipin-agent-runtime

智聘云图 Agent 运行时 Docker 镜像，集成开发环境与项目管理工具链。

## 包含工具

| 工具 | 版本 | 说明 |
|------|------|------|
| Debian | 12.15-slim | 基础镜像 |
| Git | 12.15 默认 | 版本控制 |
| OpenJDK | 17 | Java 运行环境 |
| Maven | 3.9.16 | Java 构建工具（阿里云私服） |
| Node.js | 24.21.0 | JavaScript 运行时 |
| Python | 3.13.13 | Python 运行环境 |
| uv | 0.12.11 | Python 包管理器 |
| OpenCode | 2.0.6 | AI 编程助手 |
| HiFox CLI | latest | 项目管理工具（官方不支持版本锁定） |
| Apifox CLI | 2.2.9 | API 管理与自动化测试 |

## 快速开始

### 1. 配置环境变量

复制并编辑 `.env` 文件：

```bash
cp .env.example .env
```

填写以下变量：

```env
# Git 账号
GIT_AUTHOR_NAME=your-name
GIT_AUTHOR_EMAIL=your@email.com

# HiFox 个人访问令牌（hfx_ 开头）
HIFOX_TOKEN=hfx_xxxxxxxxxxxxxxxx

# Apifox 个人访问令牌（APS- 开头）
APIFOX_ACCESS_TOKEN=APS-xxxxxxxxxxxxxx
```

### 2. 构建镜像

```bash
docker-compose build
```

### 3. 启动容器

```bash
# 前台交互
docker-compose up

# 后台守护
docker-compose up -d

# 进入容器
docker-compose exec agent-runtime bash
```

## 工具验证

进入容器后执行：

```bash
git --version
java --version
mvn --version
node --version
python --version
uv --version
opencode --version
hifox version
apifox --version
```

## 挂载说明

| 宿主机路径 | 容器路径 | 用途 |
|-----------|---------|------|
| `./workspace` | `/workspace` | 项目代码 |
| `~/.m2/repository` | `/root/.m2/repository` | Maven 本地仓库 |
| `~/.npm` | `/root/.npm` | npm 缓存 |
| `~/.cache/uv` | `/root/.cache/uv` | uv 缓存 |
| `~/.config/opencode` | `/root/.config/opencode` | OpenCode 配置 |
| `~/.local/share/opencode` | `/root/.local/share/opencode` | OpenCode 数据 |
| `~/.hifox` | `/root/.hifox` | HiFox 数据 |
| `~/.apifox` | `/root/.apifox` | Apifox 数据 |
| `~/.gitconfig` | `/root/.gitconfig` | Git 配置 |
| `~/.ssh` | `/root/.ssh` | SSH key |

## 入口脚本

容器启动时 `entrypoint.sh` 自动执行：

1. 检测 `HIFOX_TOKEN` → 自动登录 HiFox 并启动 daemon
2. 检测 `APIFOX_ACCESS_TOKEN` → 自动登录 Apifox
3. 执行用户命令

## 注意事项

- 密钥通过 `.env` 文件传入，不要写入镜像或提交到 Git
- 首次挂载宿主机目录时，确保目录已存在
- Python 3.13.13 为源码编译安装，构建时间较长
- Maven 默认使用阿里云私服，无需额外配置

## 常用命令

```bash
# 后台启动 + exec 进入
docker run -d --name zhipin-agent-runtime --env-file .env \
  -v ./workspace:/workspace \
  -v ~/.m2/repository:/root/.m2/repository \
  -v ~/.config/opencode:/root/.config/opencode \
  -v ~/.hifox:/root/.hifox \
  -v ~/.apifox:/root/.apifox \
  -v ~/.gitconfig:/root/.gitconfig \
  -v ~/.ssh:/root/.ssh \
  -w /workspace \
  zhipin-agent-runtime:latest sleep infinity

docker exec -it zhipin-agent-runtime bash
```