工作日志 — 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

三、当前待办（更新）

已完成

~~admin-ai-chat 模块部署~~ ✅
~~AdminUsersModule PasswordService 依赖修复~~ ✅
~~AdminRole import 路径修复~~ ✅
~~systemd dist 路径修复~~ ✅
~~Admin 账号创建~~ ✅
~~Hermes Gateway 启动~~ ✅
~~Hermes api_server 平台启用~~ ✅
~~NestJS → Hermes 优先调用~~ ✅

待完成

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

3.3 KiB Raw Blame History Unescape Escape