一次收口 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]>
150 lines
4.6 KiB
Go
150 lines
4.6 KiB
Go
//go:build integration
|
||
|
||
package main
|
||
|
||
import (
|
||
"bytes"
|
||
"encoding/json"
|
||
"fmt"
|
||
"io"
|
||
"net/http"
|
||
"strings"
|
||
"testing"
|
||
"time"
|
||
)
|
||
|
||
// mcpCallSSE 以 SSE 模式调一次 MCP tools/call,返回原始响应体(多帧拼接)。
|
||
//
|
||
// 与 mcpCallRaw 的区别:mcpCallRaw 只取第一帧 data(单响应场景),
|
||
// 这里要拿到「进度帧 + 最终帧」的全序列。
|
||
func mcpCallSSE(t *testing.T, e *testEnv, headers map[string]string, tool string, args map[string]any, meta map[string]any) string {
|
||
t.Helper()
|
||
if args == nil {
|
||
args = map[string]any{}
|
||
}
|
||
params := map[string]any{"name": tool, "arguments": args}
|
||
if meta != nil {
|
||
params["_meta"] = meta
|
||
}
|
||
body, _ := json.Marshal(map[string]any{
|
||
"jsonrpc": "2.0", "id": 7, "method": "tools/call", "params": params,
|
||
})
|
||
req, err := http.NewRequest("POST", e.srv.URL+"/api/v1/mcp", bytes.NewReader(body))
|
||
if err != nil {
|
||
t.Fatalf("req: %v", err)
|
||
}
|
||
req.Header.Set("Content-Type", "application/json")
|
||
req.Header.Set("Accept", "application/json, text/event-stream")
|
||
for k, v := range headers {
|
||
req.Header.Set(k, v)
|
||
}
|
||
resp, err := e.srv.Client().Do(req)
|
||
if err != nil {
|
||
t.Fatalf("do: %v", err)
|
||
}
|
||
defer resp.Body.Close()
|
||
raw, _ := io.ReadAll(resp.Body)
|
||
return string(raw)
|
||
}
|
||
|
||
// sseFrames 拆 SSE 响应体里的 data 帧内容。
|
||
func sseFrames(body string) []string {
|
||
var out []string
|
||
for _, line := range strings.Split(body, "\n") {
|
||
line = strings.TrimSpace(line)
|
||
if strings.HasPrefix(line, "data: ") {
|
||
out = append(out, strings.TrimPrefix(line, "data: "))
|
||
}
|
||
}
|
||
return out
|
||
}
|
||
|
||
// TestIntegration_MCPProgress 长任务的进度回报(benchmark §2.6)。
|
||
//
|
||
// 三个容易翻车的点,本用例逐个钉住:
|
||
// 1. 客户端带 _meta.progressToken → 服务端以 SSE 帧吐 notifications/progress,
|
||
// 且最终结果帧仍然在(进度不能顶掉结果);
|
||
// 2. 不带 progressToken → 行为与从前完全一致(单响应,无进度帧)——不回归老客户端;
|
||
// 3. 进度帧里的 progressToken 必须原样回带,客户端才知道对应哪次请求。
|
||
func TestIntegration_MCPProgress(t *testing.T) {
|
||
env, a := setupTestEnv(t)
|
||
mh := authHeaderFor(t, a, "manager")
|
||
|
||
typ := env.typeKey + "_prog"
|
||
zoneProbeType(t, env, a, typ)
|
||
|
||
items := make([]map[string]any, 0, 5)
|
||
for i := 0; i < 5; i++ {
|
||
items = append(items, map[string]any{
|
||
"type": typ,
|
||
"pk": fmt.Sprintf("prog-%d-%d", time.Now().UnixNano(), i),
|
||
"properties": map[string]any{
|
||
"name": fmt.Sprintf("进度探针%d", i),
|
||
},
|
||
})
|
||
}
|
||
|
||
// ---- 带 progressToken:应有进度帧 + 最终结果帧 ----
|
||
body := mcpCallSSE(t, env, mh, "batch_create_objects",
|
||
map[string]any{"items": items, "stop_on_error": false},
|
||
map[string]any{"progressToken": "tok-progress-1"})
|
||
if !strings.Contains(body, "event: message") {
|
||
t.Fatalf("进度模式应返回 SSE 帧:%q", body)
|
||
}
|
||
frames := sseFrames(body)
|
||
if len(frames) < 2 {
|
||
t.Fatalf("应至少有进度帧 + 结果帧,实到 %d 帧:%q", len(frames), body)
|
||
}
|
||
progressFrames := 0
|
||
sawToken := false
|
||
sawResult := false
|
||
for _, f := range frames {
|
||
var out map[string]any
|
||
if err := json.Unmarshal([]byte(f), &out); err != nil {
|
||
t.Fatalf("帧不是合法 JSON: %v (%q)", err, f)
|
||
}
|
||
if out["method"] == "notifications/progress" {
|
||
progressFrames++
|
||
params, _ := out["params"].(map[string]any)
|
||
if params["progressToken"] != "tok-progress-1" {
|
||
t.Fatalf("进度帧应原样回带 progressToken,实到 %v", params["progressToken"])
|
||
}
|
||
sawToken = true
|
||
continue
|
||
}
|
||
if res, ok := out["result"].(map[string]any); ok {
|
||
if isErr, _ := res["isError"].(bool); isErr {
|
||
t.Fatalf("批量写入不应失败:%s", f)
|
||
}
|
||
sawResult = true
|
||
}
|
||
}
|
||
if progressFrames == 0 {
|
||
t.Fatalf("应至少有一条进度帧:%q", body)
|
||
}
|
||
if !sawToken {
|
||
t.Fatalf("应回带 progressToken:%q", body)
|
||
}
|
||
if !sawResult {
|
||
t.Fatalf("进度帧不能顶掉最终结果帧:%q", body)
|
||
}
|
||
|
||
// ---- 不带 progressToken:仍是单响应,无进度帧(老客户端行为不变)----
|
||
body = mcpCallSSE(t, env, mh, "batch_create_objects",
|
||
map[string]any{"items": items[:1], "stop_on_error": false}, nil)
|
||
if strings.Contains(body, "notifications/progress") {
|
||
t.Fatalf("不带 progressToken 不应吐进度帧:%q", body)
|
||
}
|
||
frames = sseFrames(body)
|
||
if len(frames) != 1 {
|
||
t.Fatalf("不带 progressToken 应只有 1 帧(单响应),实到 %d 帧:%q", len(frames), body)
|
||
}
|
||
var out map[string]any
|
||
if err := json.Unmarshal([]byte(frames[0]), &out); err != nil {
|
||
t.Fatalf("单响应帧不是合法 JSON: %v (%q)", err, frames[0])
|
||
}
|
||
if _, ok := out["result"]; !ok {
|
||
t.Fatalf("单响应帧应含 result:%q", frames[0])
|
||
}
|
||
}
|