docs: 2026-05-22 工作日志 — admin-ai-chat 部署 + Hermes Agent 集成

工作日志/2026-05-22.md

@@ -0,0 +1,99 @@
+# 工作日志 — 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. ⬜ 阶段十：后台管理 + 额度检查