Files
adminandClaude Code d14440a3ed feat(server): v1.8.0 本体导入 + 分区 + 行级归属 + 认证位 + 结构 diff + 分页 + 进度回报
一次收口 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]>
2026-11-06 13:51:48 +08:00

146 lines
4.6 KiB
Go
Raw Permalink 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 main
import (
"strings"
"testing"
)
// TestZoneDeniedTypesSemantics 钉死分区的判定口径(纯函数):
//
// - 类型不属于任何分区 → 公共区,任何主体可见;
// - 类型属于分区 Z → 主体持有 Z 中**至少一个**即可见(目录分区的直觉);
// - 主体一个分区都没有 → 所有被分区的类型都不可见(fail-closed)。
func TestZoneDeniedTypesSemantics(t *testing.T) {
typeZones := map[string][]string{
"PublicType": {}, // 公共区
"Finance": {"fin"}, // 单分区
"Shared": {"fin", "corp"}, // 双分区:命中任一即可见
"Secret": {"sec"}, // 主体没有的分区
}
// 主体持有 fin(没有 corp / sec)
held := map[string]bool{"fin": true}
denied := zoneDeniedTypes(held, typeZones)
if denied["PublicType"] {
t.Error("公共区类型不应被分区挡住")
}
if denied["Finance"] {
t.Error("持有 fin 的主体应能看到 Finance 类型的实例")
}
if denied["Shared"] {
t.Error("持有 fin 的主体应能看到 Shared 类型(命中任一分区即可)")
}
if !denied["Secret"] {
t.Error("主体不持有 sec,Secret 类型必须不可见(fail-closed)")
}
// 一个分区都没有的主体:所有被分区的类型都不可见,公共区照旧可见
none := zoneDeniedTypes(map[string]bool{}, typeZones)
if none["PublicType"] {
t.Error("公共区类型对任何主体都可见")
}
for _, typ := range []string{"Finance", "Shared", "Secret"} {
if !none[typ] {
t.Errorf("无分区的主体不应看到 %s 类型的实例", typ)
}
}
// 持有 corp 的主体:Shared 可见,Finance 不可见(不持有 fin)
corp := zoneDeniedTypes(map[string]bool{"corp": true}, typeZones)
if corp["Shared"] {
t.Error("持有 corp 的主体应能看到 Shared 类型")
}
if !corp["Finance"] {
t.Error("未持有 fin 的主体不应看到 Finance 类型的实例")
}
}
// TestZoneCondSQL 生成的 SQL 条件:
// - 无权访问的类型为空 → "TRUE"(不配置分区 = 零影响);
// - 否则用「类型不在黑名单里」表达,且占位符编号与 args 一致。
func TestZoneCondSQL(t *testing.T) {
args := []interface{}{"x"}
cond, args := zoneCondSQL("o", "type_api_name", nil, args)
if cond != "TRUE" {
t.Errorf("无分区配置时应返回 TRUE,实到 %q", cond)
}
if len(args) != 1 {
t.Errorf("args 不应变化,实到 %v", args)
}
cond, args = zoneCondSQL("o", "type_api_name", []string{"SecretType"}, args)
if !strings.Contains(cond, "o.type_api_name") {
t.Errorf("条件应引用别名.类型列,实到 %q", cond)
}
if !strings.Contains(cond, "$2") {
t.Errorf("条件应引用第 2 个占位符,实到 %q", cond)
}
if len(args) != 2 {
t.Fatalf("args 应追加 1 个,实到 %v", args)
}
denied, ok := args[1].([]string)
if !ok || len(denied) != 1 || denied[0] != "SecretType" {
t.Errorf("追加的参数应是被屏蔽的类型清单,实到 %v", args[1])
}
}
// TestZoneFilterAllows 过滤器本身的语义:manager 豁免、fail-closed 时全拒。
func TestZoneFilterAllows(t *testing.T) {
var nilFilter *zoneFilter
if !nilFilter.allows("AnyType") {
t.Error("nil 过滤器应放行(等价于未启用分区)")
}
empty := &zoneFilter{}
if !empty.allows("AnyType") {
t.Error("空过滤器应放行")
}
fc := &zoneFilter{failClosed: true}
if fc.allows("AnyType") {
t.Error("fail-closed 时不应放行任何类型")
}
f := &zoneFilter{denied: map[string]bool{"Secret": true}}
if f.allows("Secret") {
t.Error("被屏蔽的类型不应放行")
}
if !f.allows("Public") {
t.Error("未列入屏蔽的类型应放行")
}
dl := f.deniedTypes()
if len(dl) != 1 || dl[0] != "Secret" {
t.Errorf("deniedTypes 应返回有序清单,实到 %v", dl)
}
}
// TestNormalizeZoneName 分区名校验。
func TestNormalizeZoneName(t *testing.T) {
if _, err := normalizeZoneName(" "); err == nil {
t.Error("空分区名应报错")
}
long := strings.Repeat("x", 65)
if _, err := normalizeZoneName(long); err == nil {
t.Error("超长分区名应报错")
}
name, err := normalizeZoneName(" 财务 ")
if err != nil {
t.Fatalf("合法分区名不应报错: %v", err)
}
if name != "财务" {
t.Errorf("分区名应去空白,实到 %q", name)
}
}
// TestNormalizeNameList 清单归一:去空白、去重、保序。
func TestNormalizeNameList(t *testing.T) {
got := normalizeNameList([]string{" a ", "b", "a", "", " ", "c"})
want := []string{"a", "b", "c"}
if len(got) != len(want) {
t.Fatalf("长度不符:实到 %v", got)
}
for i := range want {
if got[i] != want[i] {
t.Fatalf("实到 %v,期望 %v", got, want)
}
}
}