chore: 初始化 eightbf-analysis-go(对齐 Java 会商作业服务)

Go 实现 /api/v1/analysis 契约、Demo/Live Worker、DeerFlow SSE;含设计文档与冒烟脚本。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
gozerosandCursor committed 2026-11-03 00:13:46 +08:00
commit 0c45b86d67
29 files changed
+3789

No files matched your search

+28
View File
@@ -0,0 +1,28 @@
# Go 版与 Java 版对齐说明
设计权威:[服务端开发设计要求.md](./服务端开发设计要求.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. **日志**:先 stdout;滚动文件按设计要求 §11 后续加 lumberjack 即可。
## 切换建议
1. 停 Java 进程
2. 确认同一 `EBA_DB_*` / DeerFlow
3. 起 Go:`go run ./cmd/server` 或 systemd
4. Nginx `/analysis-api` 仍指 `:18097`
5. 健康检查 + 开一场研讨验收