# agework-dev

**Repository Path**: dazzle_tech/agework-dev

## Basic Information

- **Project Name**: agework-dev
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-03
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AgeWork

本地化部署的多 Agent 工作台，支持 Claude、Codex 等 AI Agent，数据完全自控。

## 环境要求

- Node.js `>=20`
- pnpm `10.33.4`

## 快速开始

```bash
pnpm boot
```

交互式向导，选择模式、配置选项，完成后可直接启动服务。

也可以直接用命令：

```bash
pnpm init:dev && pnpm dev    # 开发
pnpm init:prod && pnpm app:deploy  # 生产
```

启动后访问 http://localhost:5173，进入「设置 → Agent 配置」添加 API Key，然后在首页创建项目开始使用。

## 初始化参数

`pnpm init:dev` / `pnpm init:prod` 支持以下参数：

- `--no-install` — 跳过 `pnpm install`
- `--no-auth` — 禁用登录验证（`init:dev` 默认启用，`init:prod` 默认关闭）
- `--reset` — 重写环境默认值并清空重建数据库，有数据时询问是否备份
- `--ctx <path>` — 设置部署子路径，同步写入前后端配置
- `--name <name>` — 修改应用名
- `--port <port>` — 修改后端端口

## 环境变量

init 会自动从 `.env.example` 创建 `.env`，通常不需要手动配置。

`apps/api/.env` 必配项：

| 变量 | 说明 | 默认值 |
| --- | --- | --- |
| `DATABASE_URL` | 数据库连接 | `file:./dev.db` |
| `ADMIN_INIT_PASSWORD` | admin 账号初始密码 | `admin123` |

其余配置（`PORT`、`APP_NAME`、`JWT_SECRET`、`APP_CONTEXT` 等）均有代码默认值，按需修改即可。

## 生产部署

```bash
pnpm init:prod     # 安装依赖、初始化环境
pnpm app:deploy    # 构建并启动
```

部署到子路径时：

```bash
pnpm init:prod --ctx /agent
pnpm app:deploy
```

Nginx 转发：

```nginx
location /agent/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_buffering off;
    proxy_read_timeout 3600s;
}
```

更新部署：

```bash
git pull && pnpm init:prod && pnpm app:deploy
```

## 常用命令

| 命令 | 说明 |
| --- | --- |
| `pnpm boot` | 交互式初始化向导 |
| `pnpm init:dev` | 开发环境初始化 |
| `pnpm init:prod` | 生产环境初始化 |
| `pnpm dev` | 启动开发服务 |
| `pnpm dev:reset` | 重置数据库并启动开发服务 |
| `pnpm build` | 构建生产产物 |
| `pnpm start` | 启动已有构建 |
| `pnpm app:deploy` | 构建并启动生产服务 |
| `pnpm db:studio` | 打开 Prisma Studio |
| `pnpm kill-port <port>` | 清理指定端口 |
| `pnpm typecheck` | 类型检查 |
| `pnpm test:api` | 后端单测 |
| `pnpm test:web` | 前端单测 |