From 1d96a9e99cdb14c5f1f59cb49da9e3a265778519 Mon Sep 17 00:00:00 2001 From: WangDL Date: Fri, 22 May 2026 00:37:52 +0800 Subject: [PATCH] =?UTF-8?q?docs:=202026-05-22=20=E5=B7=A5=E4=BD=9C?= =?UTF-8?q?=E6=97=A5=E5=BF=97=20=E2=80=94=20admin-ai-chat=20=E9=83=A8?= =?UTF-8?q?=E7=BD=B2=20+=20Hermes=20Agent=20=E9=9B=86=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 工作日志/2026-05-22.md | 99 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 工作日志/2026-05-22.md diff --git a/工作日志/2026-05-22.md b/工作日志/2026-05-22.md new file mode 100644 index 0000000..b3f33e9 --- /dev/null +++ b/工作日志/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. ⬜ 阶段十：后台管理 + 额度检查