EaiLab/pj0235-eai_agentplatform
11
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b4c8ea38d19be56e3b103c7326e4c1117b3f4aae
pj0235-eai_agentplatform/eai_agentplatform/backend-go/internal/api/router.go
T
eaiadminandClaude Code c1af86c934 feat(asr): 本地语音转写接入为一级路由 + 并行工作流合并提交 
按用户指示做**一包提交**，不按工作流拆分。本提交刻意混合了多条并行线：

  · 本地 ASR 接管：audio 成为与 chat/embed/image/video 同等的路由类别
    （IsLocalRoute 单一判据、audio 健康探测、default_audio_route、
    auto 占位、GET /api/ai/routes/audio、回退云端时界面明示「音频已出网」）
  · LLM 调用层：ctx 贯穿、ToolCall/ToolSchema、EmptyCompletionError /
    TransientUpstreamError（按错误类型而非文案判重试）
  · 编排 Agent：general_assistant orchestrate/persistence/spec_driver
  · 联网搜索：internal/search（playwright）
  · 网盘：backend + 前端
  · 前端 UI：导航/路由/工作台若干页
  · 交付文档：DELIVERY.md / AR04 / 部署文档的「无 Python」表述据实改写，
    新增 eai_agentplatform-asr.service、asr.env、clonezilla-cleanup 清 ~/asr-poc

不分拆的原因：dev 早期，粒度不该打断工作节奏。且实测过——这些改动
**在编译上是同一个单元**（llm.go 的 ctx 签名变更牵动 12 个调用点，
chat_message.go 的 ctx 改动又与编排重写同处一个 hunk），拆出来的中间态编不过。
详见 TOP_CODING_RULES.md G14.5 与 bugs_and_errors.md E09。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-26 22:21:39 +08:00

311 lines
17 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package api
import (
"os"
"path/filepath"
"github.com/gin-gonic/gin"
"eai_agentplatform/backend/internal/config"
connectorapi "eai_agentplatform/backend/internal/connectors/api"
"eai_agentplatform/backend/internal/middleware"
skillapi "eai_agentplatform/backend/internal/skills/api"
specialistapi "eai_agentplatform/backend/internal/specialists/api"
weixinpublicaccountapi "eai_agentplatform/backend/internal/specialists/packages/weixin_public_account/api"
"eai_agentplatform/backend/internal/specialists/runtime"
xappapi "eai_agentplatform/backend/internal/xapps/api"
)
// Cfg 全局配置，RegisterRoutes 时注入
var Cfg *config.Config
// RegisterRoutes 注册所有路由
func RegisterRoutes(r *gin.Engine, cfg *config.Config) {
Cfg = cfg
specialistruntime.Cfg = cfg
connectorapi.UseConfig(cfg)
// 素材静态预览（只读）：仅公开 approved/ 子目录（已审批通过文件），
// pending/ 未审批文件不对外暴露，落实「审批前置」。
if err := os.MkdirAll(filepath.Join(cfg.KBDataDir, "approved"), 0o755); err == nil {
r.Static("/media", filepath.Join(cfg.KBDataDir, "approved"))
}
// 网盘物理文件静态预览（只读）：仅 approved 文件通过 Preview 接口取 URL，
// 未审批文件不对外暴露，落实「审批前置」。
if err := os.MkdirAll(cfg.NetdiskDataDir, 0o755); err == nil {
r.Static("/netdisk-file", cfg.NetdiskDataDir)
}
r.GET("/api/health", func(c *gin.Context) {
ver := "1.1.0"
if p, err := config.LoadPlatformConfig(); err == nil {
ver = p.Version
}
c.JSON(200, gin.H{"status": "ok", "service": "eai_agentplatform-app", "version": ver})
})
auth := r.Group("/api/auth")
{
auth.POST("/login", Login)
auth.GET("/me", middleware.Auth(cfg), Me)
}
// 员工可读
r.GET("/api/company-train", middleware.Auth(cfg), GetCompanyTrain)
r.POST("/api/company-train/suggest-material", middleware.Auth(cfg), SuggestMaterial)
r.GET("/api/specialists", middleware.Auth(cfg), specialistapi.ListSpecialists)
r.GET("/api/specialists/by-key/:key", middleware.Auth(cfg), specialistapi.GetSpecialistByKey)
r.GET("/api/specialists/summary", middleware.Auth(cfg), specialistapi.SpecialistSummary)
r.GET("/api/skills", middleware.Auth(cfg), skillapi.ListSkillDefinitions)
r.GET("/api/skills/by-key/:key", middleware.Auth(cfg), skillapi.GetSkillDefinitionByKey)
r.GET("/api/xapps", middleware.Auth(cfg), xappapi.ListXAppDefinitions)
r.GET("/api/xapps/by-key/:key", middleware.Auth(cfg), xappapi.GetXAppDefinitionByKey)
r.GET("/api/actions", middleware.Auth(cfg), ListActionDefinitions)
r.GET("/api/actions/by-key/:key", middleware.Auth(cfg), GetActionDefinitionByKey)
r.GET("/api/workbench/overview", middleware.Auth(cfg), WorkbenchOverview)
r.GET("/api/tasks", middleware.Auth(cfg), ListTasks)
r.GET("/api/tasks/:id", middleware.Auth(cfg), GetTaskDetail)
// 员工自己的工作区：「新建任务」和侧边栏的任务列表走这三个。
// 归属由服务端按登录用户定，请求里的 owner 一律不读。
r.GET("/api/my/tasks", middleware.Auth(cfg), ListMyTasks)
r.POST("/api/my/tasks", middleware.Auth(cfg), CreateMyTask)
r.PUT("/api/my/tasks/:id", middleware.Auth(cfg), UpdateMyTask)
r.DELETE("/api/my/tasks/:id", middleware.Auth(cfg), DeleteMyTask)
// 项目：任务的容器。和「我的任务」同一套归属规则，归属服务端定死。
r.GET("/api/projects", middleware.Auth(cfg), ListProjects)
r.POST("/api/projects", middleware.Auth(cfg), CreateProject)
r.PUT("/api/projects/:id", middleware.Auth(cfg), UpdateProject)
r.DELETE("/api/projects/:id", middleware.Auth(cfg), DeleteProject)
r.GET("/api/projects/:id/tasks", middleware.Auth(cfg), ListProjectTasks)
r.GET("/api/artifacts/:id", middleware.Auth(cfg), GetArtifactDetail)
r.POST("/api/weixin-public-account/tasks", middleware.Auth(cfg), weixinpublicaccountapi.CreateWeixinPublicAccountTask)
r.GET("/api/weixin-public-account/tasks/:id/workflow", middleware.Auth(cfg), weixinpublicaccountapi.GetWeixinPublicAccountWorkflow)
r.PUT("/api/weixin-public-account/tasks/:id", middleware.Auth(cfg), weixinpublicaccountapi.UpdateWeixinPublicAccountTask)
r.POST("/api/weixin-public-account/tasks/:id/steps/:stepKey", middleware.Auth(cfg), weixinpublicaccountapi.ExecuteWeixinPublicAccountWorkflowStep)
r.POST("/api/weixin-public-account/tasks/:id/images/:imageKey/regenerate", middleware.Auth(cfg), weixinpublicaccountapi.RegenerateWeixinPublicAccountImage)
r.GET("/api/weixin-public-account/tasks/:id/export", middleware.Auth(cfg), weixinpublicaccountapi.ExportWeixinPublicAccountDocument)
r.GET("/api/weixin-public-account/generated-images/:filename", middleware.Auth(cfg), weixinpublicaccountapi.ServeWeixinPublicAccountGeneratedImage)
r.GET("/api/connectors", middleware.Auth(cfg), connectorapi.ListConnectors)
r.GET("/api/connectors/:key", middleware.Auth(cfg), connectorapi.GetConnector)
r.POST("/api/connectors/:key/query", middleware.Auth(cfg), connectorapi.QueryConnector)
r.GET("/api/products", middleware.Auth(cfg), ListProducts)
r.GET("/api/products/:id", middleware.Auth(cfg), GetProduct)
r.GET("/api/courses", middleware.Auth(cfg), ListCourses)
r.GET("/api/courses/:id", middleware.Auth(cfg), GetCourse)
// 学员端考试
r.GET("/api/exam/list", middleware.Auth(cfg), ExamList)
r.GET("/api/exam/cover", middleware.Auth(cfg), ExamCover)
r.POST("/api/exam/start", middleware.Auth(cfg), ExamStart)
r.POST("/api/exam/submit", middleware.Auth(cfg), ExamSubmit)
r.GET("/api/exam/record", middleware.Auth(cfg), ExamRecordList)
r.GET("/api/exam/record/:record_id", middleware.Auth(cfg), ExamRecordDetail)
r.GET("/api/exam/mistakes", middleware.Auth(cfg), MyMistakes)
r.PUT("/api/exam/mistakes/:id/resolve", middleware.Auth(cfg), ResolveMistake)
r.POST("/api/exam/mistakes/practice", middleware.Auth(cfg), MistakePractice)
r.GET("/api/exam/certificates", middleware.Auth(cfg), MyCertificates)
r.GET("/api/exam/certificates/:id", middleware.Auth(cfg), CertificateDetail)
// 学员：我的岗位应学清单 / 学习档案 / 积分与排行榜
r.GET("/api/my/position", middleware.Auth(cfg), MyPosition)
r.GET("/api/my/profile", middleware.Auth(cfg), MyProfile)
r.GET("/api/my/xapp-center", middleware.Auth(cfg), xappapi.GetMyXAppCenter)
r.PUT("/api/my/xapp-center", middleware.Auth(cfg), xappapi.UpdateMyXAppCenter)
r.GET("/api/points/me", middleware.Auth(cfg), MyPoints)
r.GET("/api/points/leaderboard", middleware.Auth(cfg), Leaderboard)
// 素材媒体（员工/管理员均可上传、预览）
r.POST("/api/media/upload", middleware.Auth(cfg), Upload)
r.POST("/api/media/upload-init", middleware.Auth(cfg), UploadInit)
r.POST("/api/media/upload-chunk", middleware.Auth(cfg), UploadChunk)
r.POST("/api/media/upload-complete", middleware.Auth(cfg), UploadComplete)
r.GET("/api/media/preview/:media_id", middleware.Auth(cfg), Preview)
r.GET("/api/media/status/:media_id", middleware.Auth(cfg), MediaStatus)
// ── 团队共享网盘（目录 / 文件 / 预览 / 下载）──
r.GET("/api/netdisk/folders", middleware.Auth(cfg), netdiskListFolders)
r.POST("/api/netdisk/folders", middleware.Auth(cfg), netdiskCreateFolder)
r.PATCH("/api/netdisk/folders/:id", middleware.Auth(cfg), netdiskPatchFolder)
r.GET("/api/netdisk/files", middleware.Auth(cfg), netdiskListFiles)
r.POST("/api/netdisk/upload", middleware.Auth(cfg), netdiskUpload)
r.GET("/api/netdisk/files/:id/download", middleware.Auth(cfg), netdiskDownload)
r.GET("/api/netdisk/files/:id/preview", middleware.Auth(cfg), netdiskPreview)
r.PUT("/api/netdisk/files/:id/rename", middleware.Auth(cfg), netdiskRenameFile)
r.PUT("/api/netdisk/files/:id/move", middleware.Auth(cfg), netdiskMoveFile)
r.DELETE("/api/netdisk/files/:id", middleware.Auth(cfg), netdiskRecycleFile)
// 回收站
r.GET("/api/netdisk/recycle", middleware.Auth(cfg), netdiskRecycleList)
r.POST("/api/netdisk/recycle/:id/restore", middleware.Auth(cfg), netdiskRestoreFile)
r.GET("/api/knowledge/spaces", middleware.Auth(cfg), ListKnowledgeSpaces)
r.GET("/api/knowledge/search", middleware.Auth(cfg), SearchKnowledge)
r.GET("/api/knowledge/status/:source_id", middleware.Auth(cfg), KnowledgeStatus)
// ── AI 对话（普通员工可访问，管理员访问）──
r.POST("/api/ai-chat/message", middleware.Auth(cfg), ChatMessage)
r.GET("/api/ai-chat/conversations", middleware.Auth(cfg), ListConversations)
r.GET("/api/ai-chat/conversations/:id/messages", middleware.Auth(cfg), ConversationMessages)
r.GET("/api/ai-chat/quick-actions", middleware.Auth(cfg), QuickActions)
r.POST("/api/ai-chat/quick-action", middleware.Auth(cfg), QuickAction)
r.GET("/api/ai/usage", middleware.Auth(cfg), AIUsage)
r.GET("/api/ai/routes/chat", ListChatRoutes)
r.GET("/api/ai/routes/embed", ListEmbedRoutes)
r.GET("/api/ai/routes/audio", ListAudioRoutes)
r.GET("/api/assistant/opening", middleware.Auth(cfg), GetAssistantOpening)
// 学习进度（员工上报 + 本人查询）
r.POST("/api/learning/progress", middleware.Auth(cfg), RecordLearningProgress)
r.GET("/api/learning/me", middleware.Auth(cfg), MyLearningProgress)
// 学习笔记（员工个人工具）
r.GET("/api/notes", middleware.Auth(cfg), ListNotes)
r.POST("/api/notes", middleware.Auth(cfg), CreateNote)
r.PUT("/api/notes/:id", middleware.Auth(cfg), UpdateNote)
r.DELETE("/api/notes/:id", middleware.Auth(cfg), DeleteNote)
// ── 报告生成（普通员工可访问）──
r.POST("/api/report/generate", middleware.Auth(cfg), skillapi.ReportGenerate)
r.POST("/api/report/export/pdf", middleware.Auth(cfg), skillapi.ReportExportPDF)
r.POST("/api/report/export/docx", middleware.Auth(cfg), skillapi.ReportExportDOCX)
r.POST("/api/report/export/pptx", middleware.Auth(cfg), skillapi.ReportExportPPTX)
r.POST("/api/report/export/xlsx", middleware.Auth(cfg), skillapi.ReportExportXLSX)
r.POST("/api/report/preview", middleware.Auth(cfg), skillapi.ReportPreview)
r.POST("/api/contract/review", middleware.Auth(cfg), ReviewContract)
// 文档工具
r.POST("/api/document/translate", middleware.Auth(cfg), TranslateDocument)
r.POST("/api/copy/proofread", middleware.Auth(cfg), ProofreadCopy)
r.GET("/api/copy/quick", middleware.Auth(cfg), QuickProofread)
r.POST("/api/batch/extract", middleware.Auth(cfg), ExtractBatch)
r.POST("/api/batch/files", middleware.Auth(cfg), ExtractFromFiles)
r.POST("/api/skills/office/execute", middleware.Auth(cfg), skillapi.ExecuteOfficeSkill)
r.POST("/api/skills/office/ocr", middleware.Auth(cfg), skillapi.ExecuteOfficeSkillOCR)
r.POST("/api/skills/office/tts", middleware.Auth(cfg), skillapi.ExecuteOfficeSkillTTS)
// 语音转写技能的四步。**不复用 /api/skills/office/execute**：office 的运行时
// 是纯产物构造器（不发网络请求），转写必须真的调 ASR 与 LLM。
// 每步一条路由 = 每步一条 task_run，右栏「工作流 x/4」据此推进。
// 语音转写：一步一个端点、一步一条 task_run，右栏的「工作流 x/6」靠这个推进。
// speakers 与 speakers/confirm 是**两步**：前者只推断（产物落 ready、任务落待确认），
// 后者是用户拍板。中间停多久由用户决定，后端不设超时。
r.POST("/api/skills/audio/scope", middleware.Auth(cfg), skillapi.ExecuteAudioScope)
r.POST("/api/skills/audio/transcribe", middleware.Auth(cfg), skillapi.ExecuteAudioTranscribe)
r.POST("/api/skills/audio/speakers", middleware.Auth(cfg), skillapi.ExecuteAudioSpeakers)
r.POST("/api/skills/audio/speakers/confirm", middleware.Auth(cfg), skillapi.ExecuteAudioSpeakersConfirm)
r.POST("/api/skills/audio/structure", middleware.Auth(cfg), skillapi.ExecuteAudioStructure)
r.POST("/api/skills/audio/minutes", middleware.Auth(cfg), skillapi.ExecuteAudioMinutes)
r.GET("/api/tts/audio/:filename", middleware.Auth(cfg), skillapi.ServeTTSAudio)
r.POST("/api/chat/message", middleware.Auth(cfg), HandleChatMessage)
// 语音工具
r.POST("/api/audio/transcribe", middleware.Auth(cfg), TranscribeAudio)
// 管理员维护
admin := r.Group("/api")
admin.Use(middleware.Auth(cfg), middleware.RequireAdmin())
{
admin.POST("/products", CreateProduct)
admin.PUT("/products/:id", UpdateProduct)
admin.DELETE("/products/:id", DeleteProduct)
admin.POST("/products/import", ImportProducts)
admin.POST("/courses", CreateCourse)
admin.PUT("/courses/:id", UpdateCourse)
admin.GET("/exam/questions", ListQuestions)
admin.POST("/exam/questions", CreateQuestion)
admin.PUT("/exam/questions/:id", UpdateQuestion)
admin.DELETE("/exam/questions/:id", DeleteQuestion)
admin.GET("/exam/papers", ListPapers)
admin.POST("/exam/papers", CreatePaper)
admin.PUT("/exam/papers/:id", UpdatePaper)
admin.DELETE("/exam/papers/:id", DeletePaper)
admin.GET("/media/audit-list", AuditList)
admin.POST("/media/audit/:media_id", AuditMedia)
// 网盘管理：删目录、审批、回收站彻底删除
admin.DELETE("/netdisk/folders/:id", netdiskDeleteFolder)
admin.GET("/netdisk/audit-list", netdiskAuditList)
admin.POST("/netdisk/audit/:id", netdiskAuditFile)
admin.DELETE("/netdisk/recycle/:id", netdiskPurgeFile)
admin.POST("/knowledge/scan", KnowledgeScan)
admin.POST("/knowledge/index/rebuild", RebuildKnowledgeIndex)
admin.POST("/knowledge/spaces", CreateKnowledgeSpace)
admin.PUT("/knowledge/spaces/:id", UpdateKnowledgeSpace)
admin.DELETE("/knowledge/spaces/:id", DeleteKnowledgeSpace)
admin.GET("/knowledge/faqs", ListKnowledgeFAQs)
admin.POST("/knowledge/faqs", CreateKnowledgeFAQ)
admin.PUT("/knowledge/faqs/:id", UpdateKnowledgeFAQ)
admin.DELETE("/knowledge/faqs/:id", DeleteKnowledgeFAQ)
admin.GET("/knowledge/audit-list", KnowledgeAuditList)
admin.POST("/knowledge/audit/:source_id", KnowledgeAudit)
admin.GET("/knowledge/export", ExportKnowledge)
admin.GET("/positions", ListPositions)
admin.POST("/positions", CreatePosition)
admin.PUT("/positions/:id", UpdatePosition)
admin.DELETE("/positions/:id", DeletePosition)
admin.POST("/specialists", specialistapi.CreateSpecialist)
admin.PUT("/specialists/:id", specialistapi.UpdateSpecialist)
admin.GET("/specialists/:id/remove-plan", specialistapi.PreviewSpecialistRemovePlan)
admin.DELETE("/specialists/:id", specialistapi.DeleteSpecialist)
admin.POST("/skills", skillapi.CreateSkillDefinition)
admin.PUT("/skills/:id", skillapi.UpdateSkillDefinition)
admin.GET("/skills/:id/remove-plan", skillapi.PreviewSkillRemovePlan)
admin.DELETE("/skills/:id", skillapi.DeleteSkillDefinition)
admin.POST("/xapps", xappapi.CreateXAppDefinition)
admin.PUT("/xapps/:id", xappapi.UpdateXAppDefinition)
admin.GET("/xapps/:id/remove-plan", xappapi.PreviewXAppRemovePlan)
admin.DELETE("/xapps/:id", xappapi.DeleteXAppDefinition)
admin.POST("/actions", CreateActionDefinition)
admin.PUT("/actions/:id", UpdateActionDefinition)
admin.DELETE("/actions/:id", DeleteActionDefinition)
admin.POST("/tasks", CreateTask)
admin.PUT("/tasks/:id", UpdateTask)
admin.PUT("/tasks/:id/status", UpdateTaskStatus)
admin.DELETE("/tasks/:id", DeleteTask)
admin.POST("/tasks/:id/actions", ExecuteTaskAction)
admin.PUT("/artifacts/:id/status", UpdateArtifactStatus)
admin.GET("/positions/:id/knowledge", ListPositionKnowledge)
admin.PUT("/positions/:id/knowledge", SavePositionKnowledge)
admin.GET("/positions/:id/blueprint", ListPositionBlueprint)
admin.PUT("/positions/:id/blueprint", SavePositionBlueprint)
admin.PUT("/users/:id/position", SetUserPosition)
admin.GET("/departments", ListDepartments)
admin.POST("/departments", CreateDepartment)
admin.PUT("/departments/:id", UpdateDepartment)
admin.DELETE("/departments/:id", DeleteDepartment)
admin.GET("/system/users", ListUsers)
admin.POST("/system/users", CreateUser)
admin.PUT("/system/users/:id", UpdateUser)
admin.GET("/system/users/:id/overview", UserOverview)
admin.GET("/system/exam-records", ListExamRecords)
admin.GET("/system/exam-records/export", ExportExamRecords)
admin.GET("/system/exam-records/:id", GetExamRecord)
admin.DELETE("/system/exam-records/:id", DeleteExamRecord)
admin.GET("/system/dashboard", AdminDashboard)
admin.GET("/system/exam-stats", ExamStats)
admin.GET("/system/exam-stats-by-position", PositionExamStats)
admin.GET("/system/department-stats", DepartmentStats)
admin.GET("/system/certificates", AdminCertificates)
admin.GET("/system/exam-coverage", ExamCoverage)
admin.GET("/system/learning-progress", AdminLearningProgress)
admin.GET("/system/config", GetConfig)
admin.PUT("/system/config", UpdateConfig)
admin.GET("/ai/config", GetAIConfig)
admin.PUT("/ai/config", PutAIConfig)
admin.POST("/ai/reload", ReloadAIConfig)
admin.GET("/ai/secrets-status", SecretsStatusHandler)
admin.GET("/ai/usage/users", AIUsageUsers)
// AI 通路测试（不扣算力点、不写调用日志）
admin.POST("/ai/route-test/models", AIRouteTestModels)
admin.POST("/ai/route-test/run", AIRouteTestRun)
}
}
Reference in New Issue View Git Blame Copy Permalink