Files
eightbf-analysis-go/docs/对齐说明.md
T
gozerosandCursor bd427b57a1 feat: 换到 Gin 主流栈并补齐运维能力
HTTP 用 Gin,配置用 Viper,日志用 zap,数据用 sqlx;保留原有接口与会商行为。
顺带补上就绪探活、请求号、滚动日志、systemd 与 Dockerfile。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-04 09:51:41 +08:00

1.3 KiB
Raw Blame History

Go 版与 Java 版对齐说明

设计权威:服务端开发设计要求.md(与 Java 仓同步)。

已对齐

  • API 路径、状态码、ApiResponse、身份头
  • 作业状态机、一开一场、cancel_flag、plan 检查点
  • 人工干预 / resume / inject / patch plan(关干预自动放行)
  • 岗位投影(position_owner 裁气泡)
  • Live:模型校验 → init → 总控派活 → 席位 → 可选卡点 → 收口;失败不当成功
  • Demo 假进度 Worker
  • 环境变量 EBA_*;Go 额外 EBA_DB_DSN、ANALYSIS_MODE、ANALYSIS_AUTH_ENABLED

已知差异 / 注意

  1. 进程互斥:勿与 Java 实例同时抢同一 MySQL 的 queued(尚未做多实例领取锁)。
  2. schema 启动:Go 启动读工作目录 schema.sql;部署时保证 cwd 或改绝对路径。
  3. SSE 细节:DeerFlow 帧格式若有变,优先对照 Java DeerFlowClient 再改本仓 internal/deerflow。
  4. 日志 / 就绪 / 停机:zap + 可选 LOG_FILE 滚动、/ready、SIGTERM 优雅停机;HTTP 为 Gin。详见 运维.md。

切换建议

  1. 停 Java 进程
  2. 确认同一 EBA_DB_* / DeerFlow
  3. 起 Go:go run ./cmd/server 或 systemd
  4. Nginx /analysis-api 仍指 :18097
  5. 健康检查 + 开一场研讨验收