Files
knowledge-governance/internal/readiness/weknora.go
T
姚章浩 5bf4aae30e
build / build (push) Successful in 1m42s
fix(ui): 接通取件后自动解析与一次性定位
F17:MarkArtifactFetched 与已验证内容复用都在同一事务内经过策略、来源启用、
过滤、superseded 和当前绑定的复核后,自动把 planned 转 pending 并入队唯一
test.upload;确认与作业幂等,失败整笔回滚。356 已卡记录可对同一文件再次保存
当前策略,经同一路径恢复,不做全库补扫或手工补队列。来源页提示改为自动接续。

F14:来源→监控定位清空未结束/动作/阶段/时间筛选;来源目录定位改为一次性请求
并由父消费,revision/sources 重载不再重放旧请求,手工换目录保持。

F13:抽出 readiness.Resolver 作为端点/绑定/凭据唯一来源;worker 上传/轮询/
校验/移除改用动态客户端,每次调用重读有效配置,不再固化启动 env 客户端。

验证:隔离 PG 的 F17 正负例与恢复用例、前端挂载定位回归、全量 Go/前端测试
及 make verify 17 项通过。未部署、未做 8088 UI 验收。
2026-11-05 11:46:42 +08:00

149 lines
4.5 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 readiness
import (
"context"
"errors"
"fmt"
"net/http"
"net/url"
"strings"
"time"
"knowledge-governance/internal/platform/weknora"
)
// WeKnora 的 readiness 探测必须与业务执行链看同一个目标:网页保存的端点、
// 当前生效的知识库绑定、同一份 API Key。任何一项在启动时被捕获成常量,
// 都会在管理员改绑之后继续探测旧库(F13:旧库 404 被当成整个服务不可用)。
var (
ErrNotConfigured = errors.New("WeKnora 就绪探测未配置")
ErrKnowledgeBaseMissing = errors.New("WeKnora 探测目标知识库不存在")
ErrNoPermission = errors.New("WeKnora 探测目标知识库无读取权限")
)
type Target struct {
BaseURL string
KnowledgeBaseID string
APIKey string
}
type Result struct {
// Target 是脱敏后的探测对象(实例 + 短 ID),用于界面说明“探的是谁”。
Target string
Err error
}
// Prober 每次 Check 都重新解析目标并新建客户端:端点、凭据、绑定都允许
// 在进程运行期间变化,不能缓存成启动快照。
// Resolver is the single source for the effective WeKnora target: endpoint
// saved in the console (env fallback), current persisted binding (env fallback)
// and the same key file. API probes and worker clients both use it, so a
// runtime settings/binding change cannot leave one side on the old value.
type Resolver struct {
Endpoint func(context.Context) string
LoadBinding func(context.Context) (string, error)
ReadKey func() (string, error)
DefaultKB string
}
func (resolver Resolver) Resolve(ctx context.Context) (Target, error) {
knowledgeBaseID := strings.TrimSpace(resolver.DefaultKB)
if resolver.LoadBinding != nil {
stored, err := resolver.LoadBinding(ctx)
if err != nil {
return Target{}, fmt.Errorf("读取当前知识库绑定失败")
}
if stored = strings.TrimSpace(stored); stored != "" {
knowledgeBaseID = stored
}
}
apiKey := ""
if resolver.ReadKey != nil {
value, err := resolver.ReadKey()
if err != nil {
return Target{}, fmt.Errorf("读取 WeKnora API 凭据失败")
}
apiKey = strings.TrimSpace(value)
}
baseURL := ""
if resolver.Endpoint != nil {
baseURL = strings.TrimSpace(resolver.Endpoint(ctx))
}
return Target{BaseURL: baseURL, KnowledgeBaseID: knowledgeBaseID, APIKey: apiKey}, nil
}
type Prober struct {
Resolve func(context.Context) (Target, error)
Timeout time.Duration
AllowDockerHTTP bool
}
func (prober Prober) Check(ctx context.Context) Result {
if prober.Resolve == nil {
return Result{Err: ErrNotConfigured}
}
target, err := prober.Resolve(ctx)
if err != nil {
return Result{Err: err}
}
described := describe(target)
if strings.TrimSpace(target.BaseURL) == "" || strings.TrimSpace(target.KnowledgeBaseID) == "" || strings.TrimSpace(target.APIKey) == "" {
return Result{Target: described, Err: ErrNotConfigured}
}
timeout := prober.Timeout
if timeout <= 0 || timeout > 10*time.Second {
timeout = 10 * time.Second
}
client, err := weknora.NewClient(weknora.ClientConfig{
BaseURL: target.BaseURL,
APIKey: target.APIKey,
Timeout: timeout,
AllowDockerHTTP: prober.AllowDockerHTTP,
})
if err != nil {
return Result{Target: described, Err: err}
}
if _, _, err := client.ListKnowledge(ctx, target.KnowledgeBaseID, 1, 1); err != nil {
return Result{Target: described, Err: classify(target, described, err)}
}
return Result{Target: described}
}
func classify(target Target, described string, err error) error {
var httpErr *weknora.HTTPError
if errors.As(err, &httpErr) {
switch httpErr.StatusCode {
case http.StatusNotFound:
return fmt.Errorf("%w(%s)", ErrKnowledgeBaseMissing, described)
case http.StatusUnauthorized, http.StatusForbidden:
return fmt.Errorf("%w(%s)", ErrNoPermission, described)
case http.StatusTooManyRequests:
return fmt.Errorf("目标知识库读取被限流(HTTP 429,%s)", described)
}
}
return err
}
// describe 只保留实例主机与知识库短 ID:诊断够用,不输出完整 UUID、路径或凭据。
func describe(target Target) string {
host := ""
if parsed, err := url.Parse(strings.TrimSpace(target.BaseURL)); err == nil && parsed.Host != "" {
host = parsed.Host
}
id := strings.TrimSpace(target.KnowledgeBaseID)
if len(id) > 8 {
id = id[:8]
}
switch {
case host == "" && id == "":
return ""
case host == "":
return "知识库 " + id
case id == "":
return "实例 " + host
default:
return "实例 " + host + " · 知识库 " + id
}
}