# 工作日志 — 2026-05-22

---

## 一、Admin 项目架构修复

### 1. admin-ai-chat 模块部署 ✅

**问题：** Admin 前端 `TaskAssistant.tsx` 调用 `/admin-api/ai/chat`，但 NestJS 服务端没有对应模块。

**修复：**
- 提交推送 `admin-ai-chat` 模块（controller/service/module/dto），端点 `POST /admin-api/ai/chat`
- 修复 `AdminUsersModule` 缺少 `PasswordService` 依赖
- 修复 `AdminRole` import 路径 `role.enum` → `admin-role.enum`
- 修复 systemd 启动路径 `dist/main.js` → `dist/src/main.js`
- 创建 admin 账号 `admin@zhixi.app / admin123`
- 添加 `GET /admin-api/ai/dashboard` 端点

### 2. Hermes Agent 集成 🔶

**发现：** 4核4G 上运行 `hermes-agent` Docker 容器（nousresearch/hermes-agent:0.14.0），是一个带 Web Dashboard 的 AI Agent 平台。

**Hermes 架构：**
- Dashboard：端口 9119（Web UI）
- Gateway：负责连接外部平台（飞书/微信/Discord 等 30+ 平台）
- 内置 OpenAI 兼容 API Server（`api_server.py`）：端口 8642，提供 `/v1/chat/completions`

**已完成：**
- ✅ 启动 Hermes Gateway
- ✅ 启用 `api_server` 平台（环境变量 `API_SERVER_ENABLED=true`）
- ✅ 配置 DeepSeek 作为推理后端（`config.yaml`）
- ✅ 设置 API Key 认证 `zhixi-hermes-key-2026`
- ✅ Docker 端口映射 8642
- ✅ UFW 开放 8642（仅内网 172.21.0.0/16 + 10.2.0.0/16）
- ✅ NestJS `AdminAiChatService` 改为 Hermes 优先 + DeepSeek 降级

**当前架构：**
```
Admin 前端 (Vite)
  → POST /admin-api/ai/chat (Bearer token)
  → NestJS AdminAiChatService (8核32G)
    → 尝试 http://10.2.0.7:8642/v1/chat/completions (Hermes)
    → 失败则降级 DeepSeekProvider
```

**待修复：**
- ⏳ 腾讯云安全组需手动开通 8642 端口（仅对内网），当前 8核32G → 4核4G:8642 不通
- ⏳ 临时方案：NestJS 自动降级到 DeepSeek 直接调用，Admin Chat 功能可用

---

## 二、服务器状态

### 8核32G (120.53.227.155)

| 服务 | 状态 |
|------|------|
| zhixi-api | ✅ active |
| zhixi-worker | ✅ active |
| gitea-runner | ✅ active |
| MySQL/Redis/Qdrant | ✅ 运行中 |
| admin-ai-chat 端点 | ✅ `POST /admin-api/ai/chat` |
| admin dashboard 端点 | ✅ `GET /admin-api/ai/dashboard` |

### 4核4G (81.70.187.179)

| 服务 | 状态 |
|------|------|
| hermes-agent | ✅ Up，Dashboard :9119，API :8642 |
| Gitea 1.23.8 | ✅ |
| Nginx | ✅ |
| gitea-runner | ✅ |
| UFW | ✅ 22/80/443/2222/9119/8642 |

---

## 三、当前待办（更新）

### 已完成
1. ~~admin-ai-chat 模块部署~~ ✅
2. ~~AdminUsersModule PasswordService 依赖修复~~ ✅
3. ~~AdminRole import 路径修复~~ ✅
4. ~~systemd dist 路径修复~~ ✅
5. ~~Admin 账号创建~~ ✅
6. ~~Hermes Gateway 启动~~ ✅
7. ~~Hermes api_server 平台启用~~ ✅
8. ~~NestJS → Hermes 优先调用~~ ✅

### 待完成
9. ⏳ 腾讯云安全组添加 8642 端口（需手动操作控制台）
10. ⏳ 4核4G Nginx 代理 `/hermes-api/` → `127.0.0.1:8642`
11. 🟢 AI 提取 prompt 调优（待真实文档）
12. 🟢 COS 备份同步 + 生命周期清理
13. 🟢 MySQL 物理清理脚本
14. 🟢 Docker Compose 统一
15. 🟢 logrotate 确认
16. 🔴 学习引擎串联（待产品决策 → `待决策事项.md`）
17. ⬜ 阶段九：iOS API 对接 + 用户闭环测试
18. ⬜ 阶段十：后台管理 + 额度检查
