package settings import ( "context" "errors" "fmt" "strings" "time" ) type ResourceBinding struct { Kind, TenantKey, ConversationID, ConversationTitle string BaseID, SheetID, ViewID, OperatorID string CreatedByStaffID string FieldMapping map[string]string ValidationCode string Activate bool } type BootstrapCandidate struct { TenantKey, Code, StaffID, UnionID, DisplayName, Department string DetectedAt time.Time } type SettingSession struct { TenantKey, StaffID, ConversationID, ConversationType, PendingAction string ExpiresAt time.Time } type SettingInput struct{ TenantKey, Channel, StaffID, UnionID, DisplayName, Department, Text, ConversationType, ConversationID, ConversationTitle string } type ControllerRepository interface { IsAdministrator(context.Context, string, string) (bool, error) SetPreference(context.Context, string, string, string, string) error SaveBinding(context.Context, ResourceBinding) error TestAndActivateSupportGroup(context.Context, ResourceBinding) error DetectBootstrapCandidate(context.Context, BootstrapCandidate) error GetSettingSession(context.Context, string, string) (SettingSession, bool, error) SaveSettingSession(context.Context, SettingSession) error DeleteSettingSession(context.Context, string, string) error } type Controller struct { repo ControllerRepository now func() time.Time } func NewController(repo ControllerRepository) *Controller { return &Controller{repo: repo, now: time.Now} } func (c *Controller) ShouldHandle(ctx context.Context, tenant, staff, text string) bool { if _, ok := ParseCommand(text); ok { return true } if c == nil || c.repo == nil { return false } s, ok, err := c.repo.GetSettingSession(ctx, tenant, staff) return err == nil && ok && s.ExpiresAt.After(c.now()) } func (c *Controller) Handle(ctx context.Context, in SettingInput) (string, error) { if c == nil || c.repo == nil { return "", errors.New("settings repository is required") } cmd, explicit := ParseCommand(in.Text) var action string var args []string if explicit { args = cmd.Args } else { s, ok, err := c.repo.GetSettingSession(ctx, in.TenantKey, in.StaffID) if err != nil { return "", err } if !ok || !s.ExpiresAt.After(c.now()) { return "", nil } if strings.TrimSpace(in.Text) == "取消" { _ = c.repo.DeleteSettingSession(ctx, in.TenantKey, in.StaffID) return "已取消设置。", nil } action = s.PendingAction args = []string{action, strings.TrimSpace(in.Text)} } if explicit && cmd.Name == "/help" { return "设置回答语言:/setting language \n例如:/setting language en", nil } if explicit && len(args) == 1 && len(args[0]) == 6 && allDigits(args[0]) { if strings.TrimSpace(in.ConversationType) != "direct" { return "管理员绑定码只能私聊机器人使用。", nil } err := c.repo.DetectBootstrapCandidate(ctx, BootstrapCandidate{TenantKey: in.TenantKey, Code: args[0], StaffID: in.StaffID, UnionID: in.UnionID, DisplayName: in.DisplayName, Department: in.Department, DetectedAt: c.now()}) if err != nil { return "", err } return "身份已验证,请回到后台确认首位管理员。", nil } if explicit && len(args) == 0 { admin, err := c.repo.IsAdministrator(ctx, in.TenantKey, in.StaffID) if err != nil { return "", err } if admin { return "⚙️ 我的设置:/setting language \n🛠 系统管理:support、question、faq", nil } return "⚙️ 我的设置:/setting language ", nil } if action == "" { action = strings.ToLower(args[0]) } if action == "language" { if len(args) != 2 || !validLocale(args[1]) { return "可选语言:auto、zh-CN、en、ja、ko、es。", nil } if err := c.repo.SetPreference(ctx, in.TenantKey, defaultChannel(in.Channel), in.StaffID, args[1]); err != nil { return "", err } return "✅ 回答语言已设置为 " + args[1] + "。", nil } admin, err := c.repo.IsAdministrator(ctx, in.TenantKey, in.StaffID) if err != nil { return "", err } if !admin { return "你没有系统管理权限。", nil } switch action { case "support": if in.ConversationType != "group" || strings.TrimSpace(in.ConversationID) == "" { return "请在目标技术支持群中@机器人发送 /setting support。", nil } binding := ResourceBinding{Kind: "support_group", TenantKey: in.TenantKey, ConversationID: in.ConversationID, ConversationTitle: in.ConversationTitle, CreatedByStaffID: in.StaffID} if len(args) == 2 && strings.EqualFold(args[1], "test") { err = c.repo.TestAndActivateSupportGroup(ctx, binding) if err == nil { return "✅ 测试成功,当前群已激活为技术支持群。", nil } break } err = c.repo.SaveBinding(ctx, binding) if err == nil { return "✅ 当前群已保存为技术支持群(待验证)。确认发送测试消息后,请在本群@机器人发送 /setting support test。", nil } case "question", "faq": if len(args) != 2 { err = c.repo.SaveSettingSession(ctx, SettingSession{TenantKey: in.TenantKey, StaffID: in.StaffID, ConversationID: in.ConversationID, ConversationType: in.ConversationType, PendingAction: action, ExpiresAt: c.now().Add(10 * time.Minute)}) if err != nil { return "", err } return tableBindingInstructions(action), nil } link, e := ParseNotableLink(args[1]) if e != nil { return "AI表格链接无法识别。", nil } kind := action + "_table" err = c.repo.SaveBinding(ctx, ResourceBinding{Kind: kind, TenantKey: in.TenantKey, BaseID: link.BaseID, SheetID: link.SheetID, ViewID: link.ViewID, OperatorID: in.UnionID, CreatedByStaffID: in.StaffID}) if err != nil { return tableBindingFailureReply(action, err), nil } _ = c.repo.DeleteSettingSession(ctx, in.TenantKey, in.StaffID) return fmt.Sprintf("✅ %sSchema验证通过并已激活,DobotAI将短暂重启加载Dispatcher。", map[string]string{"question": "问题AI表格", "faq": "FAQ表格"}[action]), nil default: return "未知设置项。发送 /setting 查看菜单。", nil } return "", err } func tableBindingFailureReply(action string, err error) string { label := map[string]string{"question": "问题AI表格", "faq": "FAQ表格"}[action] if label == "" { label = "AI表格" } code := "table_validation_failed" guidance := "请检查链接是否来自目标表格中的任意记录,并确认字段名称和类型符合提示要求。" raw := "" if err != nil { raw = strings.ToLower(err.Error()) } switch { case strings.Contains(raw, "schema_http_401"), strings.Contains(raw, "schema_http_403"), strings.Contains(raw, "schema_token_failed"): code = "table_permission_denied" guidance = "请确认机器人应用已开通钉钉AI表格接口权限,并确认当前管理员对目标表格有访问和编辑权限。" case strings.Contains(raw, "missing_field"): code = "table_schema_missing_field" guidance = "目标表缺少必需字段,请按上一条提示补齐字段后重试。" case strings.Contains(raw, "duplicate_field"): code = "table_schema_duplicate_field" guidance = "目标表存在重名必需字段,请保留唯一字段后重试。" case strings.Contains(raw, "field_type_mismatch"): code = "table_schema_field_type_mismatch" guidance = "目标表的必需字段类型不正确,请按上一条提示调整字段类型后重试。" case strings.Contains(raw, "schema_network_failed"), strings.Contains(raw, "schema_request_failed"), strings.Contains(raw, "schema_read_failed"): code = "table_schema_network_failed" guidance = "钉钉AI表格接口暂时不可用,请稍后重试。" case strings.Contains(raw, "schema_decode_failed"), strings.Contains(raw, "schema_empty"): code = "table_schema_response_invalid" guidance = "未读取到可用字段,请确认链接指向AI表格中的具体数据表。" } return fmt.Sprintf("❌ %s验证失败,新配置未激活。\n错误码:%s\n%s\n当前设置仍在10分钟等待期内,可直接重新发送链接卡片;发送“取消”退出。", label, code, guidance) } func tableBindingInstructions(action string) string { if action == "faq" { return "请在10分钟内直接发送FAQ表中任意一条记录的链接(钉钉显示为链接卡片也可以直接发送)。\n\n" + "操作前请确认:\n" + "1. 当前机器人应用具备钉钉AI表格接口权限,当前管理员具备目标表格的访问和编辑权限。\n" + "2. FAQ表包含以下字段:标准问题(必填)、原始问题、语言、提问人。\n" + "3. Schema验证成功后会立即激活FAQ写入,并短暂重启DobotAI加载Dispatcher。\n\n" + "如果完整URL被钉钉自动转换为链接卡片,请只发送 alidocs.dingtalk.com/ 后面的部分。示例:\n" + "i/nodes/?iframeQuery=entrance%3Ddata%26sheetId%3D%26viewId%3D\n\n" + "iframeQuery必须完整保留,系统会自动解码其中的sheetId/viewId。\n\n" + "发送“取消”退出。" } return "请在10分钟内直接发送问题AI表格中任意一条记录的链接(钉钉显示为链接卡片也可以直接发送)。\n\n" + "操作前请确认:\n" + "1. 当前机器人应用具备钉钉AI表格接口权限,当前管理员具备目标表格的访问和编辑权限。\n" + "2. 问题表包含:中文问题、提问时间、提问人、原始问题、AI答案、流程触发人员信息、语言、部门、区域。\n" + "3. Schema验证成功后会立即激活问题表写入,并短暂重启DobotAI加载Dispatcher。\n\n" + "如果完整URL被钉钉自动转换为链接卡片,请只发送 alidocs.dingtalk.com/ 后面的部分。示例:\n" + "i/nodes/?iframeQuery=entrance%3Ddata%26sheetId%3D%26viewId%3D\n\n" + "iframeQuery必须完整保留,系统会自动解码其中的sheetId/viewId。\n\n" + "发送“取消”退出。" } func validLocale(s string) bool { switch s { case "auto", "zh-CN", "en", "ja", "ko", "es": return true } return false } func defaultChannel(s string) string { if strings.TrimSpace(s) == "" { return "dingtalk" } return strings.TrimSpace(s) } func allDigits(s string) bool { for _, r := range s { if r < '0' || r > '9' { return false } } return s != "" }