一次收口 2026-11-06 的九项能力(CHANGELOG 1.5.4 → 1.8.0): - 自检探针(readiness.go):check_readiness / check_answerable 两个只读探针,把 「本体里没有」「我没权限看」「模型没抽全」三种空结果原因拆开 - 读路径语义钉死(scope.go):标记与分级的可见范围统一由 Scope 产出,实例分级 为空时继承类型默认级(fail-closed),列表与详情口径一致 - 行级可改性轴(object_owner.go):归属只收窄不宽于 grants,所有对象写路径统一 走 canWriteObject,归属查询失败即拒绝 - 公理第 6 类 certification:认证位保护人工策展内容,AI 重摄取不再覆盖已认证条目 - 跨版本结构 diff(schema_diff.go):schema_snapshots 全量快照 + diff 端点,机器 事实与人工策展分组呈现 - 分区维度 zone:分区绑类型、命中任一即可见,读路径一律带 zone 条件 - 统一分页信封(pagination.go):列表回包统一 count/total/limit/offset/has_more/ truncated,total 与 items 同源 - MCP 长任务进度(mcp_progress.go):客户端带 progressToken 才走 SSE 进度帧 - 本体 schema 导入(ontology_import.go):Turtle 导入 + 四道 fail-fast 闸门 + 整事务 + (source, external_id) 幂等 + IRI 往返不变式 MCP 工具清单并入单一注册表(mcp_registry.go),对外声明与实际可调不再各说各话; 工具数 42 → 54(只读 27 / 写入 27),注册表与分发 case 的双向漂移由 AST 单测拦截。 CHANGELOG 编号整理:新「认证位 + 行级归属」条目由 1.6.0 改为 1.5.6(1.6.x 留给 分区与结构 diff),2026-09-20 的 GB/T 规划稿改标「规划稿·未发布」——该能力已并入 v1.5.1,避免与正式发布的版本号重复。 Co-Authored-By: Claude Code <[email protected]>
543 lines
21 KiB
Go
543 lines
21 KiB
Go
package main
|
||
|
||
import (
|
||
"context"
|
||
"embed"
|
||
"io/fs"
|
||
"log"
|
||
"net/http"
|
||
"os"
|
||
"path/filepath"
|
||
"strconv"
|
||
"strings"
|
||
|
||
"github.com/gin-gonic/gin"
|
||
"github.com/joho/godotenv"
|
||
|
||
"shangshu-ontology/server/ai"
|
||
)
|
||
|
||
func pathExists(p string) bool {
|
||
st, err := os.Stat(p)
|
||
return err == nil && st.IsDir()
|
||
}
|
||
func pathExistsAbs(p string) bool {
|
||
abs, err := filepath.Abs(p)
|
||
if err != nil {
|
||
return false
|
||
}
|
||
return pathExists(abs)
|
||
}
|
||
|
||
//go:embed all:webroot
|
||
var webFS embed.FS
|
||
|
||
type app struct {
|
||
cfg *Config
|
||
pool dbRunner // dbRunner 是 *pgxpool.Pool / *txPool 的接口,snapshot_router.go 定义
|
||
ai ai.Provider
|
||
archiveRoot string
|
||
engine *gin.Engine // 供 MCP 端点做进程内子请求,复用连接器逻辑
|
||
}
|
||
|
||
func main() {
|
||
if err := run(); err != nil {
|
||
log.Fatalf("启动失败: %v", err)
|
||
}
|
||
}
|
||
|
||
func run() error {
|
||
_ = godotenv.Load()
|
||
cfg := loadConfig()
|
||
log.Printf("[boot] 配置: %s", cfg.String())
|
||
|
||
ctx := context.Background()
|
||
p, err := initDB(ctx, cfg.dsn())
|
||
if err != nil {
|
||
return err
|
||
}
|
||
pool = p
|
||
defer pool.Close()
|
||
|
||
if cfg.SeedOnStart {
|
||
if err := seedIfEmpty(ctx, pool); err != nil {
|
||
log.Printf("[boot] 种子数据警告: %v", err)
|
||
}
|
||
// 访问控制元原语:principal/marking/grant/field_policy schema 幂等升级 + 默认 seed
|
||
if err := ensureAccessControlSchema(ctx, pool); err != nil {
|
||
log.Printf("[boot] 访问控制 schema 警告: %v", err)
|
||
}
|
||
if err := seedAccessControlDefaults(ctx, pool); err != nil {
|
||
log.Printf("[boot] 访问控制种子警告: %v", err)
|
||
}
|
||
// Kinetic 层 ⑤Function builtin 函数同步
|
||
if err := ensureBuiltinFunctions(ctx, pool); err != nil {
|
||
log.Printf("[boot] builtin 函数同步警告: %v", err)
|
||
}
|
||
// Semantic 层 ⑦Interface 同步(注册 6 个 connector REST 端点)
|
||
if err := ensureBuiltinInterfaces(ctx, &app{cfg: cfg, pool: pool}); err != nil {
|
||
log.Printf("[boot] builtin interface 同步警告: %v", err)
|
||
}
|
||
}
|
||
|
||
provider := ai.NewProvider(ai.Config{
|
||
BaseURL: cfg.AIBaseURL,
|
||
Key: cfg.AIKey,
|
||
Model: cfg.AIModel,
|
||
})
|
||
log.Printf("[boot] AI 提供者: %s", provider.Name())
|
||
|
||
// ARCHIVE_DIR 在进程 cwd 不同时会指向不一致目录,自动 fallback 到可执行文件相邻路径
|
||
if cfg.ArchiveDir != "" && !filepath.IsAbs(cfg.ArchiveDir) {
|
||
if abs, _ := filepath.Abs(cfg.ArchiveDir); !pathExists(abs) {
|
||
if exe, err := os.Executable(); err == nil {
|
||
if try := filepath.Join(filepath.Dir(exe), "..", cfg.ArchiveDir); pathExistsAbs(try) {
|
||
cfg.ArchiveDir = try
|
||
}
|
||
}
|
||
}
|
||
}
|
||
a := &app{cfg: cfg, pool: pool, ai: provider, archiveRoot: cfg.ArchiveDir}
|
||
log.Printf("[boot] 知识文件根目录: %s", a.archiveRoot)
|
||
|
||
// 结构快照基线(2026-11-06):首次启用时落一份「当前结构」作为 version=0,
|
||
// 跨版本 diff 以此为起点。基线不是历史某刻的真值,来源写在 label 里。
|
||
a.ensureSchemaBaseline(ctx)
|
||
|
||
gin.SetMode(gin.ReleaseMode)
|
||
r := gin.New()
|
||
r.Use(gin.Recovery())
|
||
if cfg.AllowCORS {
|
||
r.Use(corsMiddleware())
|
||
}
|
||
// Dynamic Security 审计日志中间件(自动记录每次请求的访问决策)
|
||
r.Use(a.accessLogMiddleware())
|
||
startAccessLogFlusher(pool)
|
||
// access_log 保留策略(2026-09-11):默认 90 天,ACCESS_LOG_RETENTION_DAYS 覆盖
|
||
startAccessLogRetention(pool, cfg.AccessLogRetentionDays)
|
||
|
||
// 物化层调度器(P2-1):后台 ticker 定期刷新 interval 物化
|
||
startMaterializationScheduler(context.Background(), a)
|
||
|
||
registerRoutes(r, a)
|
||
|
||
// 静态资源(内嵌 Vue 构建产物),SPA 回退
|
||
webroot, err := fs.Sub(webFS, "webroot")
|
||
if err != nil {
|
||
return err
|
||
}
|
||
fileServer := http.FileServer(http.FS(webroot))
|
||
r.NoRoute(func(c *gin.Context) {
|
||
if strings.HasPrefix(c.Request.URL.Path, "/api/") {
|
||
log.Printf("[warn] NoRoute 404 (API): %s %s", c.Request.Method, c.Request.URL.Path)
|
||
c.JSON(http.StatusNotFound, gin.H{"error": "not found"})
|
||
return
|
||
}
|
||
// 真实静态文件(assets 等)直接返回;其余路径回退到 index.html(SPA 路由)
|
||
rel := strings.TrimPrefix(c.Request.URL.Path, "/")
|
||
if rel == "" {
|
||
rel = "index.html"
|
||
}
|
||
if f, openErr := webroot.Open(rel); openErr == nil {
|
||
f.Close()
|
||
fileServer.ServeHTTP(c.Writer, c.Request)
|
||
return
|
||
}
|
||
data, readErr := fs.ReadFile(webroot, "index.html")
|
||
if readErr != nil {
|
||
c.Status(http.StatusNotFound)
|
||
return
|
||
}
|
||
c.Data(http.StatusOK, "text/html; charset=utf-8", data)
|
||
})
|
||
|
||
addr := ":" + strconv.Itoa(cfg.HTTPPort)
|
||
log.Printf("[boot] 本体平台监听 %s", addr)
|
||
return r.Run(addr)
|
||
}
|
||
|
||
func registerRoutes(r *gin.Engine, a *app) {
|
||
a.engine = r // 供 MCP 端点在进程内复用连接器 handler
|
||
r.GET("/health", func(c *gin.Context) { c.JSON(200, gin.H{"status": "ok"}) })
|
||
// 版本自描述(公开):部署核对用,前端页脚 / MCP get_server_info 同源
|
||
r.GET("/api/v1/version", a.versionHandler)
|
||
r.GET("/api/v1/version/changelog", a.changelogHandler)
|
||
// 反馈代理(公开):bug/建议自动转 Gitea issue,调用方零凭据
|
||
r.POST("/api/v1/feedback", a.feedbackHandler)
|
||
|
||
api := r.Group("/api/v1")
|
||
// 快照路由中间件:读 X-Snapshot-Id / X-Snapshot-Ts 头 → 把 a.pool 临时换为事务视图
|
||
// (SET LOCAL search_path TO backups_<id>,> public)。写方法带快照头 → 403。
|
||
// 必须在 loginRequired / managerAuth 之前,这样 GET 走快照不被鉴权误拦。
|
||
api.Use(a.snapshotMiddleware())
|
||
|
||
// 账号密码登录(公开端点,登录前访问)
|
||
api.POST("/auth/login", a.authLogin)
|
||
api.POST("/auth/logout", a.authLogout)
|
||
api.GET("/auth/me", a.authMe)
|
||
api.POST("/auth/change-password", a.changePassword)
|
||
|
||
// 管理类接口(本体/实例/AI摄取):需 manager 主体(密码登录或 manager 的 api_key)
|
||
mgmt := api.Group("")
|
||
mgmt.Use(a.loginRequired(), a.managerAuth())
|
||
{
|
||
ot := mgmt.Group("/ontology")
|
||
ot.GET("/object-types", a.listObjectTypes)
|
||
ot.POST("/object-types", a.createObjectType)
|
||
ot.GET("/object-types/:name", a.getObjectType)
|
||
ot.PUT("/object-types/:name", a.updateObjectType)
|
||
ot.DELETE("/object-types/:name", a.deleteObjectType)
|
||
ot.POST("/object-types/:name/properties", a.addProperty)
|
||
ot.PUT("/properties/:id", a.updateProperty)
|
||
ot.DELETE("/properties/:id", a.deleteProperty)
|
||
|
||
// 数据分级(issue #5):类型级分级配置总览 + 实例生效分级批量重算(默认 dry_run)。
|
||
// 挂在本组而非 /objects 下,避免与 /objects/:type/:pk 参数路由冲突被抢占匹配。
|
||
ot.GET("/classification/config", a.classificationConfig)
|
||
// 管理员设置对象类型的分级配置(v1.3.0):之前只有 GET 没有 PUT,导致前端保存失败
|
||
// 「对象类型分级」路由按对象名(/object-types/:name/classification)放,方便前端「按类型编辑」
|
||
ot.PUT("/object-types/:name/classification", a.setObjectTypeClassification)
|
||
ot.POST("/classification/recompute", a.recomputeClassification)
|
||
|
||
ot.GET("/link-types", a.listLinkTypes)
|
||
ot.POST("/link-types", a.createLinkType)
|
||
// 链接属性(链接本身带字段,P1-3)
|
||
ot.GET("/link-types/:name/properties", a.listLinkProperties)
|
||
ot.POST("/link-types/:name/properties", a.addLinkProperty)
|
||
ot.DELETE("/link-properties/:id", a.deleteLinkProperty)
|
||
ot.DELETE("/link-types/:name", a.deleteLinkType)
|
||
|
||
// 类型梳理 (analyze / merge-preview / merge-execute / delete-zero-inst)
|
||
ot.POST("/types/analyze", a.analyzeTypes)
|
||
ot.POST("/types/merge-preview", a.mergePreview)
|
||
ot.POST("/types/merge-execute", a.mergeExecute)
|
||
ot.POST("/types/delete-zero-inst", a.deleteZeroInstTypes)
|
||
|
||
ot.GET("/action-types", a.listActionTypes)
|
||
ot.POST("/action-types", a.createActionType)
|
||
|
||
ot.GET("/function-types", a.listFunctionTypes)
|
||
ot.GET("/function-types/:name", a.getFunctionType)
|
||
ot.POST("/function-types", a.createFunctionType)
|
||
ot.DELETE("/function-types/:name", a.deleteFunctionType)
|
||
ot.POST("/function-types/:name/invoke", a.invokeFunctionType)
|
||
|
||
ot.GET("/interface-types", a.listInterfaceTypes)
|
||
ot.GET("/interface-types/:name", a.getInterfaceType)
|
||
ot.POST("/interface-types", a.createInterfaceType)
|
||
ot.DELETE("/interface-types/:name", a.deleteInterfaceType)
|
||
|
||
// 物化层(P2-1 2026-08-24)
|
||
ot.GET("/materializations", a.listMaterializations)
|
||
ot.POST("/materializations", a.createMaterialization)
|
||
ot.DELETE("/materializations/:name", a.deleteMaterialization)
|
||
ot.POST("/materializations/:name/refresh", a.refreshMaterializationHandler)
|
||
ot.GET("/materializations/:name/rows", a.listMaterializationRows)
|
||
|
||
// Backing Sources(P2-2 2026-08-24):物化层的源配置(精简版仅 metadata)
|
||
ot.GET("/backing-sources", a.listBackingSources)
|
||
ot.POST("/backing-sources", a.createBackingSource)
|
||
ot.DELETE("/backing-sources/:name", a.deleteBackingSource)
|
||
|
||
// 提示调度(Suggestive Dispatch):按当前上下文返回 Function/Action 建议列表(2026-08-24)
|
||
ot.GET("/suggestions", a.listSuggestions)
|
||
|
||
ot.GET("/graph", a.getGraph)
|
||
ot.GET("/links/count", a.countLinks)
|
||
|
||
// 本体自描述:全局 IRI 命名空间 + 建模依据标准 + 服务版本
|
||
ot.GET("/meta", a.ontologyMeta)
|
||
|
||
// schema 标准序列化导出(GB/T 48000.3-2026 §5.3):当前仅 format=turtle
|
||
ot.GET("/export", a.ontologyExport)
|
||
|
||
// schema 版本流水查询(GB/T 48000.3-2026 通用建模方法·schema 版本):只读
|
||
ot.GET("/versions", a.listSchemaVersions)
|
||
ot.GET("/versions/:version", a.getSchemaVersion)
|
||
|
||
// 跨版本结构 diff(2026-11-06):任意两版本的结构比对,字段分机器事实 / 人工策展
|
||
ot.GET("/schema/snapshots", a.listSchemaSnapshots)
|
||
ot.GET("/schema/diff", a.diffSchemaVersions)
|
||
ot.POST("/schema/snapshot", a.captureSchemaSnapshot)
|
||
|
||
obj := mgmt.Group("/objects")
|
||
obj.GET("", a.listObjects)
|
||
obj.POST("", a.createObject)
|
||
obj.GET("/:type/:pk", a.getObject)
|
||
obj.PUT("/:type/:pk", a.updateObject)
|
||
obj.DELETE("/:type/:pk", a.deleteObject)
|
||
// 提交 Action(P0-1 + P0-3:完整契约 + FBA 执行链路,2026-08-24)
|
||
obj.POST("/:type/:pk/actions/:action", a.applyAction)
|
||
|
||
// 实例治理(2026-09-05):批量写入 + 变更历史 + 软删除回滚 + 重复实体扫描
|
||
obj.POST("/batch", a.batchCreateObjects)
|
||
obj.GET("/changes", a.listRecentChanges)
|
||
obj.GET("/duplicates", a.findDuplicates)
|
||
obj.POST("/:type/:pk/restore", a.restoreObject)
|
||
obj.GET("/:type/:pk/history", a.getObjectHistory)
|
||
|
||
lk := mgmt.Group("/links")
|
||
lk.POST("", a.createLink)
|
||
lk.POST("/batch", a.batchCreateLinks)
|
||
lk.DELETE("/:id", a.deleteLink)
|
||
|
||
ing := mgmt.Group("/ai")
|
||
ing.POST("/ingest", a.aiIngest)
|
||
ing.GET("/ingest", a.listIngestions)
|
||
ing.GET("/ingest/:id", a.getIngestion)
|
||
}
|
||
|
||
// 知识管理:文件管理 + 数据连接资源(manager 或 ingest 主体可写,供 MCP/agent 导入)
|
||
km := api.Group("/km")
|
||
km.Use(a.ingestOrManagerAuth())
|
||
{
|
||
km.GET("/tree", a.kmTree)
|
||
km.GET("/files", a.kmListFiles)
|
||
km.POST("/folders", a.kmCreateFolder)
|
||
km.POST("/upload", a.kmUpload)
|
||
km.GET("/file", a.kmFileMeta)
|
||
km.POST("/put-text", a.kmPutText)
|
||
km.POST("/extract", a.kmExtract)
|
||
km.DELETE("/files", a.kmDeleteFiles)
|
||
// 文件级排除标记(2026-09-05):标记后默认不参与批量抽取
|
||
km.POST("/exclude", a.kmSetExcluded)
|
||
// 文件级分级(issue #5-⑤):整份文档打级,传导给已抽取实例(文件越敏→产物越敏)
|
||
km.POST("/classification", a.kmSetClassification)
|
||
|
||
km.GET("/connections", a.kmListConnections)
|
||
km.POST("/connections", a.kmCreateConnection)
|
||
km.GET("/connections/:id", a.kmConnectionDetail)
|
||
km.DELETE("/connections/:id", a.kmDeleteConnection)
|
||
km.POST("/connections/:id/import", a.kmImportConnection)
|
||
km.POST("/connections/extract", a.kmExtractConnections)
|
||
}
|
||
|
||
// 连接器接口(只读查询):connector 主体已配置 api_key 时须在 X-API-Key 携带,供 WorkBuddy 等接入
|
||
conn := api.Group("/connector")
|
||
conn.Use(a.connectorAuth())
|
||
{
|
||
conn.GET("/object-types", a.connObjectTypes)
|
||
conn.GET("/objects/:type", a.connObjects)
|
||
conn.GET("/object/:type/:pk", a.connObject)
|
||
conn.GET("/search", a.connSearch)
|
||
conn.GET("/facets", a.connFacets)
|
||
conn.POST("/query", a.connQuery)
|
||
conn.GET("/graph", a.connGraph)
|
||
// 跨版本结构 diff(2026-11-06):连接器只读——结构本身已由 /object-types 全量公开,
|
||
// diff 只是同一份结构的时间维度,不额外暴露实例数据。
|
||
conn.GET("/schema/diff", a.diffSchemaVersions)
|
||
conn.GET("/schema/snapshots", a.listSchemaSnapshots)
|
||
// 自检探针(2026-11-06):问数前先探本体可用性 / 问题可答性
|
||
conn.GET("/readiness", a.connReadiness)
|
||
conn.POST("/answerable", a.connAnswerable)
|
||
// 实例治理(2026-09-05):MCP 写入端点
|
||
conn.POST("/objects/batch", a.batchCreateObjects)
|
||
conn.POST("/links/batch", a.batchCreateLinks)
|
||
}
|
||
|
||
// 访问控制元原语管理接口(manager 主体可见)
|
||
// whoami 任何 principal 都可调(诊断当前身份)——挂在 mgmt 外,登录即可查
|
||
api.GET("/access/whoami", a.whoami)
|
||
acc := mgmt.Group("/access")
|
||
{
|
||
acc.GET("/principals", a.listPrincipals)
|
||
acc.GET("/principals/:name", a.getPrincipal)
|
||
acc.POST("/principals", a.createPrincipal)
|
||
acc.PUT("/principals/:name", a.updatePrincipal)
|
||
acc.DELETE("/principals/:name", a.deletePrincipal)
|
||
acc.GET("/principals/:name/clearances", a.getClearances)
|
||
acc.PUT("/principals/:name/clearances", a.putClearances)
|
||
|
||
acc.GET("/grants", a.listGrants)
|
||
acc.POST("/grants", a.createGrant)
|
||
acc.DELETE("/grants/:id", a.deleteGrant)
|
||
|
||
acc.GET("/markings", a.listMarkings)
|
||
acc.GET("/objects/:type/:pk/markings", a.getObjectMarkings)
|
||
acc.PUT("/objects/:type/:pk/markings", a.putObjectMarkings)
|
||
|
||
acc.GET("/field-policies", a.listFieldPolicies)
|
||
acc.POST("/field-policies", a.createFieldPolicy)
|
||
acc.DELETE("/field-policies/:id", a.deleteFieldPolicy)
|
||
|
||
// 主体分组(行级归属的组形态):组内成员的权限只对该行生效,不扩大全局权限
|
||
acc.GET("/groups", a.listGroups)
|
||
acc.PUT("/groups/:name", a.putGroup)
|
||
acc.DELETE("/groups/:name", a.deleteGroup)
|
||
|
||
// 分区维度(zone):目录分区 + 授权边界(类型级)。
|
||
// 类型入区后,其实例只对持有该分区的主体可见;未入区 = 公共区(行为与从前一致)。
|
||
acc.GET("/zones", a.listZones)
|
||
acc.POST("/zones", a.setZone)
|
||
acc.DELETE("/zones/:name", a.deleteZone)
|
||
|
||
acc.GET("/preview", a.previewAsPrincipal)
|
||
// 三态存在性探针:exists / invisible / not_exists。
|
||
// 读路径对越权实例一律 404(不泄漏存在性),三态只能走这条管理面探针。
|
||
acc.GET("/existence", a.probeExistence)
|
||
acc.GET("/log", a.listAccessLog)
|
||
acc.GET("/log/stats", a.accessLogStats)
|
||
}
|
||
|
||
// 本体 schema 导入(2026-11-06):与导出对称的写端点。
|
||
// 写闸门走 grants 表的 manage 级授权(handler 内判定,不通过 managerAuth)——
|
||
// 与 MCP 写闸门口径一致、不写死主体名(docs/ONTOLOGY_IMPORT.md §9)。
|
||
// 之所以不挂 mgmt 组:managerAuth 只放行 principal=="manager",
|
||
// 那会把「持有 manage 授权的受托管理员」也挡在门外,与 grants 语义冲突。
|
||
imp := api.Group("/ontology")
|
||
imp.Use(a.loginRequired())
|
||
{
|
||
imp.POST("/import", a.ontologyImport)
|
||
}
|
||
|
||
// 行级可改性轴(2026-11-06):归属的查看与设置对归属方开放(行可转交),
|
||
// 但解除归属、清改分组属管理动作,仍只在 /access 组(manager 专属)。
|
||
// 归属只收窄写权限:对象设有归属时,非归属方即便持有该类型的写授权也不能改这一行;
|
||
// 对象未设归属 → 不限制,历史行为不变。
|
||
own := api.Group("/ownership")
|
||
own.Use(a.loginRequired())
|
||
{
|
||
own.GET("/objects/:type/:pk/owners", a.getObjectOwners)
|
||
own.PUT("/objects/:type/:pk/owners", a.putObjectOwners)
|
||
own.DELETE("/objects/:type/:pk/owners", a.deleteObjectOwners)
|
||
}
|
||
|
||
// 使用分析(2026-09-11):本体总体/分项使用、用户活跃、共享情况(仅 manager)
|
||
ana := mgmt.Group("/analytics")
|
||
{
|
||
ana.GET("/overview", a.analyticsOverview)
|
||
ana.GET("/types", a.analyticsTypes)
|
||
ana.GET("/users", a.analyticsUsers)
|
||
ana.GET("/sharing", a.analyticsSharing)
|
||
}
|
||
|
||
// 数据备份(v1.3.0):仅 manager 主体可访问,含 create/inspect/list/download/diff/delete
|
||
// 不提供 restore 到线上——MCP 客户端拿到 dump 后在另一实例验证恢复路径
|
||
bkp := mgmt.Group("/backups")
|
||
{
|
||
bkp.POST("", a.createBackupHandler)
|
||
bkp.GET("", a.listBackupsHandler)
|
||
bkp.GET("/:id", a.inspectBackupHandler)
|
||
bkp.GET("/:id/switch", a.switchBackupHandler)
|
||
bkp.DELETE("/:id", a.deleteBackupHandler)
|
||
}
|
||
|
||
// MCP 协议端点(Streamable HTTP):WorkBuddy 以 url 方式一键注册
|
||
api.Any("/mcp", a.mcpAuth(), a.mcpHandle)
|
||
// MCP 工具清单(人类可读的自描述,供参考/调试)
|
||
api.GET("/mcp/manifest", a.mcpManifest)
|
||
// 本体差距扫描工具包(内嵌二进制,对外零 git 依赖)
|
||
api.GET("/review-kit", a.reviewKitIndex)
|
||
api.GET("/review-kit/archive", a.reviewKitArchive)
|
||
api.GET("/review-kit/:name", a.reviewKitFile)
|
||
}
|
||
|
||
func (a *app) managerAuth() gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
// 仅放行 manager 主体(含 dev 模式默认 manager)
|
||
p := a.principalFromRequest(c)
|
||
if p != "manager" {
|
||
c.Set("authz_decision", "deny")
|
||
c.AbortWithStatusJSON(401, gin.H{"error": "需要 manager 主体", "principal": p})
|
||
return
|
||
}
|
||
c.Next()
|
||
}
|
||
}
|
||
|
||
// loginRequired 强制要求已登录(cookie session 或 X-API-Key)。
|
||
// manager 主体尚未配置 api_key(全新库、seed 未运行)→ 跳过,便于首次引导。
|
||
// 真实鉴权模式(manager 已有 key)下,到达此中间件的请求必须带 session 或 API Key,否则 401。
|
||
// 注意:本中间件不区分角色(manager/ingest/connector 都可过);
|
||
// 角色门由 managerAuth / ingestOrManagerAuth 等下游中间件把控。
|
||
func (a *app) loginRequired() gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
// manager 尚未配置密钥时保留开放体验:无人也能进(默认 manager)
|
||
if !a.managerKeySet() {
|
||
c.Next()
|
||
return
|
||
}
|
||
p := a.principalFromRequest(c)
|
||
if p == "" || p == "public" {
|
||
c.AbortWithStatusJSON(401, gin.H{"error": "需要登录或有效 API Key", "principal": p})
|
||
return
|
||
}
|
||
c.Next()
|
||
}
|
||
}
|
||
|
||
// connectorAuth 连接器入口鉴权:key 是「任意主体的有效 api_key」即可放行(修复 issue #8 v2)。
|
||
//
|
||
// 历史:早期只接受 name='connector' 的 key(连接器入口 = 单一 connector 身份)。
|
||
// v2:放宽到任一主体的 key——既然 manager / connector / analyst 等各有 api_key,
|
||
// 连接器入口就应当接受调用方的真实身份,让 principalFromRequest 按真实主体解析,
|
||
// 读路径的 visibility / classification filter 即按真实身份工作(manager 豁免、
|
||
// connector/analyst 按各自 clearance 子集)。
|
||
//
|
||
// 未提供 key 时:若全库任意主体已配置 key 则要求带(401),全库无 key 则放行(无密钥只读场景)。
|
||
func (a *app) connectorAuth() gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
key := c.GetHeader("X-API-Key")
|
||
if key == "" {
|
||
key = c.Query("key")
|
||
}
|
||
if key == "" {
|
||
// 无 key:若任意主体已有 key,则视为必须带 key;否则放行(无密钥只读兼容)
|
||
if a.anyPrincipalKeySet() {
|
||
c.AbortWithStatusJSON(401, gin.H{"error": "连接器接口需要 X-API-Key"})
|
||
return
|
||
}
|
||
c.Next()
|
||
return
|
||
}
|
||
var name string
|
||
if err := a.pool.QueryRow(c,
|
||
"SELECT name FROM principals WHERE api_key=$1", key).Scan(&name); err == nil && name != "" {
|
||
c.Next()
|
||
return
|
||
}
|
||
c.AbortWithStatusJSON(401, gin.H{"error": "连接器密钥无效"})
|
||
}
|
||
}
|
||
|
||
// ingestOrManagerAuth 知识管理写接口鉴权:仅放行 manager 或 ingest 主体。
|
||
// ingest 主体由 MCP/agent 使用(持有 seed 随机 key 或 UI 设置的 api_key),可按需限定 clearance 与 grant。
|
||
func (a *app) ingestOrManagerAuth() gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
p := a.principalFromRequest(c)
|
||
if p != "manager" && p != "ingest" {
|
||
c.Set("authz_decision", "deny")
|
||
c.AbortWithStatusJSON(403, gin.H{"error": "需要 manager 或 ingest 主体", "principal": p})
|
||
return
|
||
}
|
||
c.Next()
|
||
}
|
||
}
|
||
|
||
// mcpAuth MCP 端点鉴权:允许 manager/ingest/connector 调用;生产环境拒绝匿名 public。
|
||
// manager 尚未配置 key(全新库)时 principalFromRequest 返回 manager,自然放行,便于首次引导。
|
||
func (a *app) mcpAuth() gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
p := a.principalFromRequest(c)
|
||
if p == "public" {
|
||
c.Set("authz_decision", "deny")
|
||
c.AbortWithStatusJSON(401, gin.H{"error": "MCP 需要鉴权(manager/ingest/connector 主体)", "principal": p})
|
||
return
|
||
}
|
||
c.Next()
|
||
}
|
||
}
|
||
|
||
func corsMiddleware() gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
c.Header("Access-Control-Allow-Origin", "*")
|
||
c.Header("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS")
|
||
c.Header("Access-Control-Allow-Headers", "Content-Type,X-API-Key,Authorization")
|
||
if c.Request.Method == http.MethodOptions {
|
||
c.AbortWithStatus(204)
|
||
return
|
||
}
|
||
c.Next()
|
||
}
|
||
}
|