Commit Graph
65 Commits
Author SHA1 Message Date
admin 7d4a0c26e3 chore(release): v1.5.2 CHANGELOG 定稿(摘除未发布标记) 2026-10-15 10:20:09 +08:00
admin 4349c3c608 feat(server): 扫描工具包内嵌二进制,对外零 git 依赖(review-kit 端点)
苏苏原则:本体对外分发不应假设用户能访问 git 仓库,资产一律内置。
原 reviewer skill 的 6 个脚本资产(scan.py 扫描器/manifest schema/AI 精修
提示词/代理脚本/两份示例输出)从 git 历史提取至 server/reviewkit/,
经 //go:embed 随二进制发布:

- GET /api/v1/review-kit:索引(文件名/大小/用途)
- GET /api/v1/review-kit/<name>:单文件下载,按扩展名给 content-type
- GET /api/v1/review-kit/archive:tar.gz 打包(一次拿全套)
- 路径穿越防护(../、绝对路径、子目录、白名单外文件名一律 404)

get_usage_guide 的 review 场景与 WORKBUDDY.md 路径 C.2 同步改写:
「git show 取回」→「curl 从本体服务下载」,host 取实际部署地址。

验证:3 个新测试用例(内嵌完整性含孤儿文件检查/路径穿越/HTTP 三端点
含 gzip+tar 解包校验);本地 8081 端到端 smoke——下载的 scan.py 实连
MCP --list-types 拉出真实类型清单,key 文件用完即删。
2026-10-15 09:21:32 +08:00
admin 723445d355 feat(mcp): get_usage_guide 并入 review/training 场景,删除三个 ontology skill
苏苏决策:skill 需要用户安装、跨客户端不可移植,场景说明全部前移为
服务端工具能力。本次将原 ssw-ontology-reviewer(差距扫描核对)与
ssw-ontology-trainer(员工培训闭环)的核心 SOP 并入 get_usage_guide,
随后删除全部三个 skill:

- get_usage_guide 场景键 8 → 10:新增 review(扫描器用法/findings 精修/
  两类型清单/核对页 Apply/策展决策)与 training(业务全景六域+个体按需/
  三阶段闭环/只读安全边界)。reviewer 的脚本资产留在 git 历史,
  工具内给出取回命令
- instructions 场景列表同步补评审/培训(1659→~1680 字节,仍 <2KB)
- 删除 skills/ssw-ontology-ops、skills/ssw-ontology-reviewer(git rm),
  .workbuddy/skills/ssw-ontology-trainer(进访达回收站),用户级两个
  软链一并清除;git 历史均保留可恢复
- 文档同步:WORKBUDDY.md 路径 C/§6/排错/附录改为 get_usage_guide 用法,
  CLAUDE.md 目录表改指 server/mcp_guide.go

验证:go test ./server 全绿(10 场景键穷举+容错用例同步扩充);
全仓无 skill 残留引用(CHANGELOG 历史条目除外)。
2026-10-15 08:52:31 +08:00
admin 5b67ed991a feat(mcp): 内置提示词席位 + 工具语义标注 + get_usage_guide 场景指南工具
把「怎么用这套本体」从用户侧 skill 前移为服务端能力,任何接入 MCP 的
客户端开箱即用,无需安装 skill:

- initialize 下发 instructions(1.6KB,起步速查:开工三步/查询/写入/
  建模/分级/权限/知识库/铁律;控制在 2KB 内防客户端截断)
- tools/list 每个工具带 title + ToolAnnotations(readOnly/destructive/
  idempotent/openWorld),指针字段确保显式 false 不被 omitempty 吞掉;
  39→40 个工具全覆盖,4 个破坏性工具可被客户端识别
- tools/list 补 ttlMs/cacheScope,清单可缓存 5 分钟
- 新增 get_usage_guide:不传参返回铁律+场景路由总览,传 scenario 返回
  该场景完整 SOP(query/ingest/modeling/classification/access/
  knowledge/backup/gotchas)。静态内容不触库,与 ssw-ontology-ops
  skill 同源——skill 定位转为深度参考

回归测试 4 个用例守护:标注覆盖率、instructions 长度上限、清单顺序
稳定性、指南场景键全覆盖与容错。实测确认 WorkBuddy 不消费协议层
instructions/annotations(asar 逆向证据),故指南必须走工具通道——
本工具为普通 tool call,全客户端有效。
2026-10-15 08:31:30 +08:00
admin 8a72cb2e4e docs(changelog): 发布 v1.5.1 整合 GB/T 48000.3 建模能力 + MCP 写闸门修复
首个整合此前 1.6.0/1.5.0 规划能力的正式发布版本;
修复 MCP 写类工具硬编码 manager/ingest 主体、不查 grants 表导致的
已授 manage 主体(如 rong)经 MCP 仍被拒写的问题,改走 authz.CanWrite 与 REST 对齐。
2026-09-21 17:13:23 +08:00
admin 4f28dc53a2 fix(mcp): 写闸门改走 grant 授权,与 REST 路径对齐
原 MCP 写类工具在 handlers_mcp.go 用主体名硬判
(principal=="manager"||"ingest"),不查 grants 表,
导致被授 manage 权限的主体(如 rong)仍无法经 MCP 写入。

改为调用 authz.CanWrite("write","*","*"),与 REST 一致;
manager 仍由 CanWrite 内部特殊放行,任何持 write/manage
授权的主体均可写入。denyWrite 提示文案同步更新。
2026-09-21 15:47:13 +08:00
adminandClaude Opus 4.8 6fea152696 fix(ontology): 设置父类型时以库内既有公理做父子互斥守卫(PUT 省略 axioms 场景)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 22:23:39 +08:00
adminandClaude Opus 4.8 cbb3a76760 fix(ontology): 终审修复——axioms PUT 三态保持 + 缓存锁统一(classMu)+失效防污染+dateOrder 闭包声明+merge 缓存失效+父子互斥补齐+文档措辞
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 22:10:02 +08:00
adminandClaude Opus 4.8 e16bca882c docs(gb48000): M4/M5 落地状态回写(GAP/README/PLAN/CLAUDE/INSTANCE_GOVERNANCE)+ CHANGELOG 1.6.0
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 21:25:10 +08:00
adminandClaude Opus 4.8 5dd86bfa95 feat(schema): data_type 增 uri(绝对 URI 写入校验+xsd:anyURI 导出+AI/MCP 词表)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 20:59:55 +08:00
adminandClaude Opus 4.8 c5826df832 feat(ontology): display_name_lang 多语标签(三表+管理 API+Turtle 语言标签字面量,旧列回退)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 20:44:29 +08:00
adminandClaude Opus 4.8 376147fdf5 fix(ontology): createObjectType/deleteObjectType 补 invalidateClassCache(子类型 enum 闭包即时生效)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 20:27:44 +08:00
adminandClaude Opus 4.8 abbed9a60d feat(ontology): 属性继承(子类型读路径合并祖先属性+enum 校验闭包生效)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 20:01:08 +08:00
adminandClaude Opus 4.8 bb26040ed0 fix(ontology): parent_id 更新路径三态契约 + DDL 顺序对齐 brief
- updateObjectType 把 parent_id = $17 改为 CASE WHEN $17::boolean THEN $18 ELSE parent_id END,
  修复'PUT 不带 parent 字段即清空既有 parent'的回归(reviewer round 1)。
- db.go::migrate() 把 parent_id DDL 块挪到 axioms 块之后,与 brief 顺序对齐
  (语义无差,ADD COLUMN IF NOT EXISTS 幂等)。
- 追加 TestIntegration_ParentTriState_PreserveOnMissing:覆盖三态
  nil(保持)/""(清空)/值(设父),并断言不传 parent 时 parent_api_name 不变。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:26:42 +08:00
adminandClaude Opus 4.8 caacb5a3bf feat(ontology): parent_id SubclassOf 声明(环/父子互斥守卫+类型闭包+rdfs:subClassOf 导出)
DDL: object_types.parent_id BIGINT REFERENCES object_types(id) ON DELETE SET NULL(GB/T 48000.3-2026 §7.1.1 / 附录 A.1.6-7)。
模型: ObjectType.ParentID *int64(不序列化)+ ParentAPIName string(回显专用)。
入口: objectTypeInput.Parent *string 三态(nil=保持/空=无父/值=设父)。
守卫:
  createObjectType  自指 + 父子互斥(checkParentDisjoint)。
  updateObjectType  自指 + 环(checkParentCycle,parent 链 ≤32 步)+ 父子互斥(总是检查,即使 in.Parent 未传,沿用现有 parent)。
类型闭包: typeClosure 替换 Task 4 stub,实为 parent_id 链上行至根,深度 32 + visited 防环兜底。
读路径: loadObjectType / listObjectTypes LEFT JOIN object_types par 取 parent_api_name 回显。
导出: schemaTypeExport.ParentAPIName + buildTurtle 类型块追加 rdfs:subClassOf <parentIRI>(taskIRI 已由任务 6 顶部建立)。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:24:01 +08:00
adminandClaude Opus 4.8 f1ef22734e feat(export): 公理随 Turtle 导出为 OWL 公理(disjointWith/equivalentClass/inverseOf/FunctionalProperty)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:18:34 +08:00
adminandClaude Opus 4.8 309c1321b0 feat(ontology): functionalLinks 功能属性边写入校验(create_link/批量)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:13:26 +08:00
adminandClaude Opus 4.8 807427629e feat(ontology): dateOrder 公理实例写入校验(applyObjectUpsert 统一入口,validate_axioms 可豁免)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:08:22 +08:00
adminandClaude Opus 4.8 d6dc45e85f feat(ontology): 公理 schema 级良构校验(引用存在性+inverseOf 互换+date/datetime)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:03:25 +08:00
adminandClaude Opus 4.8 6e08f15581 feat(ontology): object_types.axioms 公理声明列(形状校验+创建/更新/回显+写入路径串入 schema 版本流)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 18:57:55 +08:00
adminandClaude Opus 4.8 c6cd9981f3 fix(export): 撤销 addProperty 多余的 DataType 守卫(任务1 brief 外)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 18:53:29 +08:00
adminandClaude Opus 4.8 b6ab1ffde6 fix(export): IRI 本地名守卫 + Turtle 字面量显式转义(导出防毒化)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 18:51:20 +08:00
adminandClaude Opus 4.8 5a8c8ca946 docs(gb48000): 终评收窄版本流水覆盖口径 + 旧快照 iri 注记 + PLAN 补钩后续项
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 17:36:27 +08:00
adminandClaude Opus 4.8 e5c18cbd55 docs(gb48000): 差距分析三项 P1 落地状态回写 + CHANGELOG + env 示例
存量集成测试 8 项失败与 Task 1-7 无关(对照实验:pre-GB48000 代码 + 全新库以完全相同文案复现):RestoreEdges/BackupLifecycle 新库通过=共享库 shangshu 状态残留;其余 6 项为测试环境前置缺失(共享库主体已有 api_key 触发 connectorAuth 401 / 全新库未跑 seedAccessControlDefaults 缺 access-control 五表),非本次交付回归;server/ai::TestHeuristicA5 为机器局部 fixture 文件缺失。冒烟:meta/export(turtle,400 分支)/versions(list+/:version+404/400)/iri 回显全部实测通过。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:59:04 +08:00
adminandClaude Opus 4.8 c3b4848dd6 fix(schema): getSchemaVersion 区分 ErrNoRows 与真实 DB 错误 + 404/400 断言
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:34:07 +08:00
adminandClaude Opus 4.8 fe2ef537aa feat(schema): /ontology/versions 版本流水查询 + 按版本读回旧定义
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:27:33 +08:00
adminandClaude Opus 4.8 3c2ae8b885 feat(schema): schemaAudit 挂钩 append-only 全局版本流水 schema_versions
TestIntegration_SchemaVersions 走 /versions 端点,Task 7 前预期红(404);
本任务以 TestIntegration_SchemaVersionsWritten 验证写入转绿。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:17:38 +08:00
adminandClaude Opus 4.8 a380664a1c feat(export): GET /ontology/export 导出 W3C Turtle,Protégé 等标准工具可加载
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:05:56 +08:00
adminandClaude Opus 4.8 4de8a8dce6 feat(export): 纯函数 Turtle 序列化(schema→owl:Class/DatatypeProperty/ObjectProperty)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 15:56:37 +08:00
adminandClaude Opus 4.8 ba699ded3b feat(ontology): 管理/审计/连接器读取路径统一回显 iri
含旁路创建位点回填治愈(seed/merge/AI 摄取):migrate 的三条 UPDATE 抽成
backfillMissingIRI,seedIfEmpty 灌入后、mergeExecute 提交后、ai.ApplySuggestion
落库后(runIngest 单点,覆盖 AI 摄取/km 抽取/连接批量抽取)各调一次治愈空值。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 15:48:51 +08:00
adminandClaude Opus 4.8 3c3c385955 feat(schema): object/property/link 三类元数据物化全局 IRI(创建即固化+存量回填)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 15:25:18 +08:00
adminandClaude Opus 4.8 96a27c389f feat(ontology): 全局 IRI 命名空间配置 + /ontology/meta 自描述
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 15:02:02 +08:00
admin 43007cd2d2 docs(changelog): v1.4.1 发布说明(导入核对 tab 风格统一) 2026-09-14 10:28:22 +08:00
admin 5e2ddf7241 docs(changelog): v1.4.0 发布说明(使用分析 + schema 层审计) 2026-09-11 18:32:43 +08:00
admin 8ed658382f feat(analytics): 使用分析面板 + schema 层审计 + access_log target/保留策略
- access_log 中间件按路由模板映射 target(修复 :name/:id 参数名导致
  /object-types/:name 等路由 target 长期为空);401/4xx 兜底记 deny;
  action 简化为 read/write/delete/manage;新增 90 天保留策略
  (ACCESS_LOG_RETENTION_DAYS 覆盖,0 关闭)
- schema 审计:对象类型/属性/链接类型/链接属性/动作类型/分级配置的
  增删改写入 ontology_audit_log(target_pk 落库,update/delete 带 before 快照);
  存量库补 target_pk 列(幂等 ALTER)
- 新增 /api/v1/analytics/{overview,types,users,sharing}(仅 manager):
  总体读写比/活跃主体/来源分布/按天趋势、分项热度、用户活跃、共享授权使用量
- 前端新增「使用分析」tab(AnalyticsView)
2026-09-11 18:23:47 +08:00
admin 15d0893522 docs(changelog): v1.3.6 发布说明([Unreleased] 定版 issue #8 MCP 读路径真实身份) 2026-09-07 18:41:14 +08:00
admin 6841712289 fix(mcp): 读路径透传调用方真实身份(issue #8 v2)
按用户反馈「每个主体都有 mcp 访问 key,就应该是各自主体身份」——
v1 方案「注入 connector key + 手动 X-Principal」本质是「模拟身份」,
绕开了主体解析链。v2 改为透传调用方真实鉴权。

### 改动
- callConn 接受源 *gin.Context,透传 X-API-Key / session cookie 给内层请求,
  让 principalFromRequest 自然解析到 manager / connector / analyst / 等。
- connectorAuth 放宽到「任一主体 api_key 即放行」:
  - 移除 WHERE name='connector' 的硬约束
  - 助手 anyPrincipalKeySet() 判断全库是否已有密钥(有则要求带 key,无则放行兼容无密钥只读)
- 6 个调用点去掉 principal 参数,改传 c。

### 影响
- 之前:MCP 读工具一律以 connector 执行,manager 走 MCP 只能看 L0-L2。
- 现在:各主体按自己 clearance 视图读,manager 走 MCP 见全部分级(含 L3)。
- callConn 路径与 connectorAuth 路径身份解析统一(都走 principalFromRequest 自然解析)。

### 验证
- 3 个新集成测试全绿(issue8_mcp_read_principal_test.go):
  按 connector / manager / analyst 三种 api_key 调 MCP get_objects_by_type,
  分别见 2 / 3 / 1 条(符合各自 clearance)。
- 既有 issue #6/#7 的 6 个测试 + SetObjectTypeClassification 全绿。

### CHANGELOG 风格
按用户反馈「只有改了什么 / 有什么影响,不要流水账」,
重写 [Unreleased] / [1.3.3] / [1.3.2] 三段:每段只留「影响 + 改动 [+ 设计]」,
去掉过程叙述、commit hash、调试日志、issue 评论引用等。
2026-09-07 18:36:21 +08:00
admin 2a58d5adab docs(changelog): v1.3.3 发布说明([Unreleased] 定版 issue #7 clearance 配置) 2026-09-07 17:43:46 +08:00
admin 8388e14772 feat(access): 补 principal clearance 配置入口(采纳 issue #7)
用户报告「principal_clearances 不可配置,导致 L3 实例对所有非 manager 主体不可见」
—— 实测是 UX 缺口:

### 修复
- PUT /access/principals/:name 的 principalUpdateInput 新增 clearances 字段(nil=不动;
  非空数组(含 [])= 全量替换),与 PUT /principals/:name/clearances 同义。
- GET /access/principals/:name 响应新增 clearances 数组(保证非 nil,空集序列化为 [])。
- GET /access/principals 列表也回显 clearances,避免管理员看不到当前状态。

### 新增 MCP 工具(之前 36 个没有这一片)
- list_principals:列出全部主体及其 clearance。
- get_principal:按名取单个主体(含 description / has_api_key / clearances)。
- set_principal_clearance:全量替换主体 clearance(alias 接受 markings / clearances)。

### 不动的部分
- seedAccessControlDefaults 中 manager 默认 [L0,L1,L2,L3,L4] 已正确(CHANGELOG v1.2.0
  「manager 不受影响」依然成立)。
- classificationCond / classAllowed 对 manager 显式放行已正确;用户报告的「admin
  看不到 L3」实际是误读——真正不可见的是非 manager 主体(默认 connector L0-L2、public L0)。

### 验证
- 新增 3 个集成测试(issue7_clearance_config_test.go):
  updatePrincipal clearances / MCP 端到端 / 旧专用端点回归,全绿。
- 既有测试除 TestIntegration_ClassificationFilter 外全绿(后者预存在失败)。
2026-09-07 17:38:54 +08:00
admin 938a5fc960 docs(changelog): v1.3.2 发布说明([Unreleased] 定版 issue #6 本体属性注册修复) 2026-09-07 16:53:14 +08:00
admin c16957b97d feat(ontology): 补 update_object_type / add_object_type_property(采纳 issue #6 方案 A+B)
用户提交 issue #6 反映「587 个 data_level 实例是孤儿,原生分级引擎无法接管」
(分类引擎要求 classification_property 必须在 schema 中注册,但无任何端点
能把属性注册到已存在类型上)。

### 修复
- PUT /api/v1/ontology/object-types/:name 此前静默忽略 properties 字段
  (用户实测加 zz_probe 属性再 GET 没注册上)。现 objectTypeInput 新增
  properties 数组字段,非空时由 upsertObjectTypeProperties 一并 upsert
  (同名更新元数据,新名新增)。createObjectType 也同步支持内联 properties,
  两条路径共用同一辅助函数,语义一致。

### 新增 MCP 工具
- update_object_type(包装 PUT /object-types/:name):更新 display/icon/group/
  分级三件套同时可批量 upsert properties。
- add_object_type_property(包装 POST /object-types/:name/properties):
  细粒度「加一个属性」入口,适合只补一个属性的场景(如分级属性 data_level)。

### 不采纳
- 方案 C(让 set_object_type_classification 在 property 不存在时自动注入):
  把属性注册藏在分类配置里语义混淆,属性注册应是显式动作 + 可独立审计。

### 验证
- 新增 3 个集成测试(issue6_object_type_property_test.go):
  update_object_type merge / add_object_type_property MCP 端到端 /
  update_object_type MCP 端到端,全绿。
- 全部既有测试除 TestIntegration_ClassificationFilter 外全绿;后者为预存在
  失败(stash 本次改动后仍 fail,根因不在本 PR 范围内)。
2026-09-07 16:41:52 +08:00
admin 4fc20ad0a5 fix(docker): HEALTHCHECK 改用免鉴权 /api/v1/version (v1.3.1 密钥收紧后 object-types 无头 401) 2026-09-07 15:38:13 +08:00
admin 2cacb40153 refactor(access): 完全移除 .env 显式密钥,密钥统一由 principals 表管理
理由:管理界面已就位,DB 中由 UI 设置或 seed 随机生成的 key 才是唯一权威来源,
不再需要在部署时手动配置 MANAGER_API_KEY/CONNECTOR_API_KEY/INGEST_API_KEY,
避免环境变量泄漏/不同环境不一致/容器重启覆盖等运维隐患。

### 设计
- 移除 Config 中的 ManagerAPIKey/ConnectorAPIKey/IngestAPIKey 字段及对应环境变量读取。
- principalFromRequest 仅查 principals 表 api_key;不再有 env 优先回退。
- loginRequired/connectorAuth 改为查询 'DB 是否已有密钥' 判定是否进入真实鉴权模式;
  manager 未配置 key 的全新库仍保留开放体验,便于首次引导(密码登录)。
- 首次启动时 seedAccessControlDefaults 为 4 个内置主体(manager/connector/public/ingest)
  随机生成 API Key 并打印到 stdout(幂等,已有 key 不覆盖)。
- handlers_mcp.callConn 内部派发改用 a.builtinKey('connector') 注入 X-API-Key,
  走 DB 查到的密钥而非 env。

### 加固
- 移除固定/空 key 漏洞:seed 写入前先 UPDATE...WHERE api_key IS NULL OR api_key='',
  重复启动幂等;首次启动日志里打印 4 个随机值,运维保存后可在 Access Control 页重置。

### 验证(localhost:8081 真实库,go test 全绿)
- DB 中已保存的 manager 主体密钥(经纯 DB 解析)返回 manage+L0-L4;密码登录仍可引导。
- connector 端点:无 key 401,带 DB key 200;authHint 切到 DB key 状态文案。
- public key 解析为 public(L0 only),匿名请求也回退 public,无升权。
- mgmt 端点:无 key / public key 均 401;manager key 200。
- 全部测试 green (server + ai)。

### 文档同步
- README.md / docs/README.md / docs/USAGE.md / docs/IMPORT.md /
  skills/ssw-ontology-reviewer/SKILL.md / web/src/views/ConnectorView.vue /
  server/CHANGELOG.md 同步去掉 .env 密钥说明,改为'首次启动日志 + Access Control 页管理'。
2026-09-07 15:37:22 +08:00
admin d938462bd6 refactor(access): 完全移除 .env 显式密钥,密钥统一由 principals 表管理
理由:管理界面已就位,DB 中由 UI 设置或 seed 随机生成的 key 才是唯一权威来源,
不再需要在部署时手动配置 MANAGER_API_KEY/CONNECTOR_API_KEY/INGEST_API_KEY,
避免环境变量泄漏/不同环境不一致/容器重启覆盖等运维隐患。

### 设计
- 移除 Config 中的 ManagerAPIKey/ConnectorAPIKey/IngestAPIKey 字段及对应环境变量读取。
- principalFromRequest 仅查 principals 表 api_key;不再有 env 优先回退。
- loginRequired/connectorAuth 改为查询 'DB 是否已有密钥' 判定是否进入真实鉴权模式;
  manager 未配置 key 的全新库仍保留开放体验,便于首次引导(密码登录)。
- 首次启动时 seedAccessControlDefaults 为 4 个内置主体(manager/connector/public/ingest)
  随机生成 API Key 并打印到 stdout(幂等,已有 key 不覆盖)。
- handlers_mcp.callConn 内部派发改用 a.builtinKey('connector') 注入 X-API-Key,
  走 DB 查到的密钥而非 env。

### 加固
- 移除固定/空 key 漏洞:seed 写入前先 UPDATE...WHERE api_key IS NULL OR api_key='',
  重复启动幂等;首次启动日志里打印 4 个随机值,运维保存后可在 Access Control 页重置。

### 验证(localhost:8081 真实库,go test 全绿)
- mgr-key-2213 经纯 DB 解析回 manager(manage+L0-L4);密码登录仍可引导。
- connector 端点:无 key 401,带 DB key 200;authHint 切到 DB key 状态文案。
- public key 解析为 public(L0 only),匿名请求也回退 public,无升权。
- mgmt 端点:无 key / public key 均 401;manager key 200。
- 全部测试 green (server + ai)。

### 文档同步
- README.md / docs/README.md / docs/USAGE.md / docs/IMPORT.md /
  skills/ssw-ontology-reviewer/SKILL.md / web/src/views/ConnectorView.vue /
  server/CHANGELOG.md 同步去掉 .env 密钥说明,改为'首次启动日志 + Access Control 页管理'。
2026-09-07 15:29:20 +08:00
admin d0baba4640 fix(access): 允许内置主体 manager/connector 设置自己的 API Key
此前 updatePrincipal 对 manager/connector/public 一律拒绝 api_key 变更,
导致 UI 编辑保存无反应(用户的 mgr-key-2213 保存不了)。现仅禁止匿名
主体 public 设置 key,manager/connector 可通过 UI 或 REST 设置/重置/清空。
鉴权逻辑不变:DB key 与 .env MANAGER_API_KEY/CONNECTOR_API_KEY 并存。
2026-09-07 14:52:15 +08:00
admin 389dbfb4b8 feat(classification): 补 PUT /object-types/:name/classification 端点
背景:v1.2.0 加了 object_types.classification_property/_levels/_default 三列,
 但只暴露了 GET /classification/config,没有配对的 PUT/POST。
 后果:
   - 前端编辑对象类型分级保存按钮看似无反应(POST 到不存在的路由)
   - 587 个打了 data_level 标签的实例是「裸属性」,分级引擎不接管
   - 23 个类型 enabled 全是 false

 改动:
   - 新增 REST PUT /api/v1/ontology/object-types/:name/classification
     (handler: setObjectTypeClassification)
   - 校验:levels 非空有序、default ∈ levels、property 必须是已存在属性
   - 写入后调 invalidateClassCache() 让下一次 GET config 立刻反映
   - 「关闭分级」入口:property=空 允许 levels=[] / default=''
   - 新增 MCP 工具 set_object_type_classification(manager 必填)
   - 24 个测试全绿(11 纯函数 + 13 集成)
2026-09-07 14:33:33 +08:00
admin e7b39805fb feat(backup): 按 schema 镜像 + 请求级 search_path 切库 (issue #4 #5 后续)
「让客户端敢操作」的关键能力:写前/写后打一份快照 → 任意 GET 带 X-Snapshot-Id
 头即可命中 backups_<id> schema 的同名表(业务 SQL 不带 schema 前缀照样切)。

 设计要点:
   - 备份 = 独立 schema backups_<id>(真表,不是单存 JSONB)—— 查询性能与活库一致
   - snapshotRouter 中间件:BeginTx + SET LOCAL search_path → 把 a.pool 临时换
     为事务视图 txPool → handler 结束 commit + 还原 a.pool。业务代码一行不改。
   - a.pool 字段类型从 *pgxpool.Pool 升级为 dbRunner interface(中间件可换 txPool)。
   - 11 个 helper 函数签名同步改为 dbExec(与现有 dbExec 共存,无破坏性)。
   - 写方法(POST/PUT/PATCH/DELETE)带快照头 → 403 拒绝(mistake-safety)。

 接口:
   - POST /api/v1/backups 创建
   - GET /api/v1/backups 列表
   - GET /api/v1/backups/:id 元信息(含 schema_name)
   - GET /api/v1/backups/:id/switch 切库提示
   - DELETE /api/v1/backups/:id 级联删 schema
   - 支持 X-Snapshot-Id (直接 run id) + X-Snapshot-Ts (秒级时间戳) 两种切换入口

 MCP 工具 (5 个):backup_create / backup_list / backup_inspect / backup_switch / backup_delete

 测试 (22 个全绿,~5.5s 集成):
   - SnapshotRouter:改前建快照 → 改后读快照只见改前
   - SnapshotSearchPathPersist:不污染下一个请求
   - SnapshotByTimestamp:ts 头也能切库
   - SnapshotDeleteCleansSchema:delete 真 DROP schema
   - BackupLifecycle / BackupDiffAfterMutation:完整 create→list→inspect→switch→delete

 文档:docs/BACKUP.md 写清用法、机制、客户端工作流;CHANGELOG.md [1.3.0]。
2026-09-07 11:35:47 +08:00
admin ae9a1a69e2 test: 加 16 个回归测试 (11 纯函数 + 5 集成) + docs/TESTING.md
- 纯函数单测(go test -short)覆盖:
  classification (levelIndex/maxLevel/materializeClassification/principalMaxIndex/deniedLevelsFor)、
  display_name (propString/resolveDisplayName)、
  governance (diffProps/mergeProps/parseStringArray/similarity)
- 集成测试(-tags=integration,跑真实 PG)覆盖 issue #4 #5 端到端:
  enum_violation 拦截 + 友好错误;分级过滤 manager vs analyst(L0/L1) 越级 404;
  properties.sensitivity 越级 redact 为 ***;删→恢复关系边 (links_snapshot+edges_created=1);
  recompute dry_run 不落库 / apply=true 落库修正错误分级
- 集成测试踩坑:X-Principal 与 principal_clearances.principal 必须一致;每次新主体必须清
  authzCache(sync.Map 进程级),否则历史空 Authz 会让分级过滤假阴性
- docs/TESTING.md:测试分层 / 跑测命令 / 编写新测试的约定
- CHANGELOG [1.2.0] 加 测试 与 文档 段落
2026-09-07 10:11:39 +08:00
admin da73b1091f feat(governance): restore_object 恢复关系边 + 数据分级通用能力 (issue #4 #5)
- #4 restore_object 默认连同关系边恢复:删除级联存边快照(links_snapshot),回滚重建两端在的边、跳过悬空引用,分级从快照物化
- #5 数据分级(不硬编码字段名/级别名):
  - 类型级 classification_property/levels/default 配置 + objects.classification 物化列+索引
  - 读路径按 principal_clearances 下推过滤,越级默认屏蔽且不泄漏存在性(fail-closed)
  - 字段级 properties.sensitivity 越级脱敏为 ***
  - 枚举写入校验(修复变量遮蔽导致的永不拦截 bug):越界值 400 enum_violation
  - 批量重算 recompute(dry_run 默认/apply 落库) + KM 源文件级分级传导
  - MCP +3 工具(get_classification_config/recompute_classification/set_km_classification)
- 分级路由改挂 /ontology 避免与 /objects/:type/:pk 参数路由冲突
- 更新 CHANGELOG 与 INSTANCE_GOVERNANCE.md §15-§16
- 验证:localhost:8081 真实库跑通删→恢复边、分级过滤、枚举拦截、字段脱敏、重算落库
2026-09-07 09:45:02 +08:00
admin 097910e63e docs(changelog): 记录 v1.1.1 问题反馈通道发布说明 2026-09-05 15:26:32 +08:00