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 |
|
admin
|
7369706cd4
|
refactor(feedback): 反馈配置内嵌二进制,移除 .env 依赖
- giteaAPIBase/giteaIssueRepo/giteaIssueToken 常量编译进 server/version.go(含外网地址 :82)
- config.go 移除 Gitea 三个字段;.env/.env.example 清理 GITEA_*,部署零配置
- e2e:零环境变量启动 → POST /api/v1/feedback 自动建 issue #2(外网 issue_url)→ 外网 API 关闭
|
2026-09-05 15:17:11 +08:00 |
|
admin
|
3f08c55cae
|
feat(feedback): 公开反馈代理 POST /api/v1/feedback — 自动生成 Gitea issue,调用方零凭据
- 实测 Gitea 1.26.1 原生不支持匿名建 issue(401 + Web 跳登录),改为服务端代理
- 服务端持专用 token(GITEA_ISSUE_TOKEN,仅 write:issue scope,不入库 .env)
- 标题自动补 [bug]/[建议] 前缀,正文自动附版本号/commit/时间
- 每 IP 每小时限 10 条;token 未配置时 503 引导 Web 入口
- MCP manifest feedback.api 与 CHANGELOG 同步为 /api/v1/feedback
|
2026-09-05 15:12:23 +08:00 |
|
admin
|
8f27e34088
|
feat(changelog): CHANGELOG 头部增加 Issue 反馈机制(Web/API 入口 + 提交约定),MCP manifest 同步 feedback 字段
- issue 入口: https://oadfec13300ad18dm.mayishangshu.cn:82/ssw/ssw-ontology/issues(已探活 200)
- AI 经 Gitea API POST issues 提交 bug/建议,标题 [bug]/[建议] 前缀 + 版本号 + 复现步骤
- MCP manifest 新增 feedback 段(issues/api/convention/changelog_url)
|
2026-09-05 15:04:08 +08:00 |
|
admin
|
07fd1454f1
|
feat(version): 版本自描述 — CHANGELOG 内嵌 + 页脚/MCP/API 三端可见
- server/CHANGELOG.md 随 //go:embed 打进二进制,运行时零磁盘依赖
- ldflags 注入 Version/Commit/BuildTime(build.sh 与 Dockerfile 说明同步)
- GET /api/v1/version 与 /api/v1/version/changelog(公开)
- MCP 新增 get_server_info(第 25 个工具),initialize serverInfo / manifest
version 同步注入值
- 前端页脚版本徽章,点击弹出更新说明对话框
|
2026-09-05 14:49:56 +08:00 |
|
admin
|
cf9e8a74a4
|
feat(instances): 实例治理 — 显示名物化/merge 语义/软删除/审计/批量/血统传播/source_ts
对标《本体改进需求》14 项按本库实情取舍落地 + Palantir 两机制:
- 显示名物化: title_property → name/title/real_name/display_name 回退链,
启动回填存量 1235 个空 name(修复 45% 实例检索隐身)— server/display_name.go
- 写入语义: create/update 默认 merge(只改传入字段),replace=true 才全量替换,
响应回显 added/changed/removed — server/object_upsert.go
- 软删除: objects.deleted/same_as 真实列,连接器默认排除墓碑,
connObject 别名自动跳转 canonical,restore_object 恢复
- 删除闭环: delete_object 级联删边+幂等+快照进 object_changes;
propagate=true 沿 source 血统清理该来源全部抽取产物+摄取记录
- 变更审计: object_changes 字段级 diff + get_object_history + restore
- 批量: POST /objects/batch /links/batch 单事务逐条 ok/fail
- 检索: search 多字段 + query filters ne/in/nin/contains/exists + fields 裁剪
- KM: km_list_files recursive + 文件级 excluded 标记 + 双向溯源
- source_ts 乱序丢弃: 旧于已有值直接 409 stale_write(批量 stale_skipped)
- MCP: 新增 batch_create_objects/batch_create_links/delete_object/
restore_object/get_object_history/find_duplicates 等,共 24 工具
- 前端: api 封装 + InstanceView 删除/保存对话框治理提示
- 文档: docs/INSTANCE_GOVERNANCE.md 权威语义 + 6 份关键文档同步
|
2026-09-05 14:31:00 +08:00 |
|
admin
|
12aa26baa1
|
fix(overview): 关系数瞬时显示 + GraphView tab 按需挂载
## 问题
截图发现关系数=0。根因不是前端逻辑,是 getGraph 端点:
- getGraph 要 SELECT 全部对象 + 全部 links,序列化 3576 节点 + 2117 边
- manager 身份响应 2.5s,传到前端前显示默认 0
- 这段等待期间 Overview 已渲染完成,用户看到错误数字
## 修复
1. 新增专用端点 GET /api/v1/ontology/links/count:
- 仅做 COUNT(*),30ms 返回
- SQL 与 getGraph 可见性逻辑一致(manager 不限 / 其他主体按 marking 过滤)
- 加 EXISTS 剔除悬空边(指向已被删除对象的边),与 getGraph JOIN 行为对齐
2. OverviewView 优先用 countLinks,失败才回退到 getGraph
3. App.vue: GraphView 改为 v-if=showGraph,监听 active 切换时才挂载,
避免用户没点 tab 就白白发 getGraph 请求(省 2.5s + 4.5MB 带宽)
## 验证(实测)
- GET /api/v1/ontology/links/count 30ms 返回 count=2117
- Overview T800ms 时关系数=2117(之前要 T8500ms 才出)
- GraphView 默认不发 /graph,仅切到 tab 才挂载
|
2026-09-03 15:10:18 +08:00 |
|
admin
|
8617efd25d
|
fix(data+graph): 管理面板与 MCP 数据对齐 + 图谱支持缩放/平移/全屏
## 数据对不上的四个根因
A. 服务端硬截断 500(count 返回截断后条数,不是真实总数)
B. 管理 /objects 用 id DESC、连接器 /connector/objects 用 id ASC
-> 同条数不同内容,两侧互相搜不到对方的实例
C. Overview 用 limit=1 再累加 count -> 3576 显示成 47
D. listObjectTypes.instance_count 是真实 COUNT(*),列表却最多 500 行
## 修复(对齐管理面板与连接器/MCP)
- 共享 defaultSortClause(id DESC)+ maxPageSize=1000
- listObjects / connObjects 增加 offset + 响应里返回
total (该查询条件下、已过授权过滤的真实总数)
has_more / limit / offset
- 授权过滤从「内存层 filterByMarking」改为「SQL 层 visibilityCond」
先过滤再截断,count 与 total 与内容同口径
- connQuery / connSearch 同样下推,避免 count 偏小
- MCP get_objects_by_type 工具描述改为「id 倒序与管理页一致,配合
total/has_more 用 offset 翻页取全量」,并新增 offset 参数
## Overview / InstanceView
- Overview: 直接用 listObjectTypes 的 instance_count 求和(一次请求)
- InstanceView: 标题显示「共 X 条」+ el-pagination 分页器(默认 100/页)
## 图谱视图 GraphView 重写
- 滚轮缩放(以鼠标位置为锚点),+/- 按钮、缩放百分比可点击复位
- 拖拽平移(区分 click/drag 防误触节点点击)
- Fullscreen API 进出 + 浮动工具栏(避免被 SVG 遮挡)
- 类型多选筛选 + 节点上限保护(按连接度优先截断)
- 关系上限 4000(超出的部分统计但不绘制)
- 螺旋(黄金角)布局替代单环,避免大簇互相压叠
- 单击节点查看详情弹窗(属性 / 关联关系数 / 跳转)
## 验证(已实测)
- 总条数 3576:instance_count(3576) == admin total(3576) == connector total(3576) ✓
- 同 offset 下管理接口与连接器首条 pk 完全一致 ✓
- MCP get_objects_by_type total=733 ✓
- 非 manager 主体 SQL 层过滤生效(无 clearance -> total=0)✓
- 滚轮缩放 64% -> 80%,拖拽平移生效,全屏生效 ✓
|
2026-09-03 14:52:47 +08:00 |
|
admin
|
b7b96dc52d
|
fix(materialization): listMaterializations/listMaterializationRows 返回空数组而非 null\n\nGo 的 nil slice 序列化为 JSON 是 null,不是 []. 前端逻辑通常直接\n.forEach / .map,会因 null 报错。改为 make([]T, 0) 显式空 slice。\n\nbacking_sources handler 之前已用 []BackingSource{} 字面量,无此问题。\n\n回归测试(空库):\n- GET /api/v1/ontology/materializations → {"materializations":[],"count":0}\n- GET /api/v1/ontology/materialization-rows/{name}/rows → {"rows":[],"count":0}\n- /api/v1/ontology/backing-sources → {"backing_sources":[],"count":0} ✓
|
2026-08-24 17:48:21 +08:00 |
|
admin
|
701612a253
|
fix(migrate): 交换 action_types 与 function_types 创建顺序
action_types.impl_function_id 是 BIGINT REFERENCES function_types(id),
必须先建 function_types 才能建 action_types。原顺序导致新建空库时
migrate() 在 CREATE TABLE action_types 处失败,进而整个事务回滚,
全部 18 张表都没建出来。
修复:先 CREATE TABLE function_types,再 CREATE TABLE action_types。
ALTER TABLE 那段不用动(顺序已经是 function_types → action_types)。
bug 触发条件:仅全新空库(Docker 镜像首次启动 / 新建 PG 实例)。
旧的 dump 灌库场景不触发(dump 里有所有表)。
|
2026-08-24 16:53:16 +08:00 |
|
admin
|
1e30d4c355
|
docs+code: 通用化平台叙事,去掉尚数网业务绑定
## 文档重构(5 个 md + 1 个 html)
- README.md: '尚数网本体管理平台' → '本体元数据平台 · Ontology Platform'
- docs/README.md: 通用化定位,补全 P0/P1/P2 (Palantir Ontology 对标) + Materialization/BackingSource/Suggestions 全清单
- docs/PLAN.md: 通用化设计目标,改为 'Palantir Ontology 对标' 路线图
- docs/USAGE.md: 用通用占位符(项目/空间/组织)替换尚数网具体业务举例
- docs/IMPORT.md: 把 shangshu 当成 '一个采用方示例' 展示通用模式
- docs/product-intro.html: title/brand/hero/场景/footer 全改通用,沙数只作典型场景之一
## 代码字符串同步去 shangshu
- server/main.go: '[boot] 尚数网本体管理平台监听' → '[boot] 本体平台监听'
- server/handlers_connector.go: manifest 'server' 字段 → 'ontology-platform'
- server/handlers_mcp.go: tool description + serverInfo → 通用
- server/handlers_functions.go: builtin interface description → 通用
- server/handlers_backing_source.go: 注释去 shangshuwang.cn 具体网址
- server/config.go + server/db.go: 注释/seed 数据改占位 (demo_self / demo_partner_a/b)
- server/ai/anthropic.go: fallback systemPrompt → '通用本体平台工程师'
- server/ai/heuristic.go: 未识别 summary → '本体概念'
- server/ai/prompt.go: 静态 systemPrompt 头部 + JSON 示例去 shangshu
## 前端文案同步
- web/src/App.vue: title 改 '本体元数据平台'
- web/src/views/LoginView.vue: 登录页 h1 改通用
- web/src/views/OntologyView.vue: backing source placeholder 改 example.com
- web/src/components/ReviewWorkbench.vue + useReviewWorkbench.js: '尚数网' → '本体平台'
## 验证
- go build ./server OK
- 剩余 '尚数网' / 'shangshu-ontology' 引用:
- 文档 README/README/USAGE/PLAN/IMPORT 仅在 '采用方示例' 上下文出现
- 代码注释 sswOntologySystemPrompt 等 identifier 保持不变(避免改动 API 表面)
- skill 名 'ssw-ontology-reviewer' 保持不变(已发布技能)
Refs: docs/README.md (1.1 元数据组件表)、docs/PLAN.md (4 当前已完成能力)
|
2026-08-24 14:04:59 +08:00 |
|
admin
|
86730bd52d
|
feat: 对标 Palantir Ontology + P0/P1/P2 全落地 + xeo 端到端导入
## Palantir Ontology 对标(10 项)
P0 核心契约:
- when_to_suggest JSONB + llm_tool_description TEXT 加到 function_types/action_types
- Action 完整契约: submission_criteria / side_effects / impl_function_id / return_type
- FBA (Function-backed Action) 执行链: /api/v1/objects/:type/:pk/actions/:action
- /api/v1/ontology/suggestions 提示调度端点
P1 元原语补全:
- Object Type UX: title_property / subtitle_property / color / primary_key
- Property 字段元数据: format / default_value / indexable / vector_index / backing_column
- Link Type: directional + 独立 link_properties 子表
- Interface Type: shared_properties + parent_interface_id 多态
- Property extended types: geoshape / geopoint / media / timeseries / timestamp
P2 数据管道层:
- materializations / materialization_rows 物化层 + 60s ticker scheduler
- backing_sources 同步源元数据 + 投影字段映射
AI 提示词升级:
- ai/prompt.go 抽出 250+ 行静态 systemPrompt
- 动态上下文注入: 每次 Suggest 前查 db 拉已注册类型清单
- Suggestion struct 扩展 22 字段
## ON CONFLICT 漏 source 修复(4 处)
- handlers_objects createObject/updateObject: COALESCE(NULLIF(EXCLUDED.source,''), objects.source)
- handlers_km upsertObject + ai.ApplySuggestion: SET source=EXCLUDED.source
- 表名必须限定 objects.source, 否则报 ambiguous
## xeo mobileApi 端到端导入
- /api/v1/ai/ingest raw_text 改用 json.dumps 转义, 修复 ingestion_id=56 failed
- 1179 实例 + 1672 links + 1806 物化行
- 占位: 5 TrustedDataSpace + 158 MemberOrg
- 5 类 Materialization 配好(mat_xeo_dataproduct 等)
## 文档
- docs/update/2026-08-24.md: 10 节迁移 + 增量 11 节
- .gitignore: 加 web/vite.config.js.timestamp-*.mjs
Refs: docs/update/2026-08-24.md
|
2026-08-24 13:54:49 +08:00 |
|
admin
|
901c2d55f4
|
feat(auth): 账号密码登录 + session cookie + 导入核对工作台
**账号密码登录与会话体系**
- 后端 handlers_auth.go:bcrypt 校验 + 进程内 session store (TTL 8h)
/api/v1/auth/{login,logout,me,change-password}
- access_control.go:principalFromRequest 优先识别 session cookie;
API KEY + session 双轨并存(dev 模式两个 KEY 都为空 → 跳过 loginRequired
保留旧开发体验,任一 KEY 设置后立即开启真实鉴权)
- handlers_mcp.go:所有受管接口复用 authMiddleware,过期 session 401
- handlers_connector.go:连接器读路径同样接入
- main.go:挂 /api/v1/auth/* + 新增 loginRequired() 中间件
- 启动时为 manager/connector/ingest 三个内置主体写 bcrypt('changeme')
首次登录后强制改密(前端 App.vue 弹修改密码对话框)
**前端登录 UI**
- LoginView.vue:账号+密码登录表单(默认密码 changeme)
- App.vue:登录守卫 + 顶栏用户菜单(修改密码 / 退出登录)
- api.js:所有 request 默认 credentials: include 携带 cookie
新增 authLogin/authLogout/authMe/changePassword + mcpCall (JSON-RPC over SSE)
**导入核对工作台 (manager-only)**
- ReviewView.vue + components/ReviewWorkbench.vue +
composables/useReviewWorkbench.js(多 tab:扫描 / 资料 / 核对 / 应用)
- import-review.html + entry-review.js 多入口(vite.config.js 加 rollup input)
- 对应 ssw-ontology-reviewer skill:本体差距自动扫描 + JSON 执行清单
→ 应用到 ontology
**依赖升级**
- go.mod:go 1.25.0 精确化 + golang.org/x/{crypto,net,sync,sys,text}
升级到 bcrypt 兼容版本
|
2026-08-21 17:06:17 +08:00 |
|
admin
|
993f74c2b2
|
feat: Docker 单镜像分发 + 默认端口统一 8081 + seed 极简化
新增 Dockerfile + docker/entrypoint.sh:
- 基础 crpi-.../ssw188/postgres:16-alpine + ontology 二进制,单镜像
- 默认端口 8081 / 库 ssw-ontology / 用户 ssw / 密码 ssw
- /data/pg 自动挂 PG 数据,/data/archive 挂文档根目录
- trap 收尸保证 PG + ontology 同生命周期
seed 极简化为 1 个对象类型「合作企业」+ 3 条示例
(尚数网/腾讯/阿里巴巴),便于演示也便于清理。
默认 HTTP_PORT 统一为 8081(覆盖 server/config.go、run.sh、
vite.config.js、importer/import-from-xeo.js、docs/README.md、
docs/USAGE.md、docs/IMPORT.md、.env.example 等所有文档/代码)。
docs/README.md / .env.example 默认 DATABASE_URL 改为
ssw/[email protected]:5432/ssw-ontology(与 Docker 镜像自带 PG 一致);
run.sh 删 dacli 硬编码 fallback,改从 .env 读(不存在则报错退出)。
README 重整:分「方式 A Docker 镜像 / 方式 B 本机 ./run.sh」,
新增 AI 智能导入(-e AI_*)与管理接口鉴权(-e MANAGER_API_KEY)说明。
|
2026-08-13 15:59:27 +08:00 |
|
admin
|
f6ae259574
|
feat(ontology): 对象类型梳理 - 健康度扫描 + AI 同义判定 + 合并向导
让平台自己就能诊断同义/零实例/孤立/低区分度 4 类问题, 由 manager 审核后执行合并.
后端:
- 新建 server/handlers_ontology_cleanup.go, 4 个接口 (analyze / merge-preview /
merge-execute / delete-zero-inst), 均走 managerAuth 仅 manager 可调.
- 新表 ontology_audit_log (actor / action / target_type / details / affected_rows),
analyze / merge / delete-zero-inst 都写审计.
- ai.Provider 接口加 Complete(ctx, prompt) 轻量补全 (anthropic / openai / heuristic 实现),
ExtractJSON 改为导出.
- db.go DDL 幂等 CREATE TABLE / INDEX.
前端:
- api.js 4 个新 wrapper.
- OntologyView 第 6 个 Tab「类型梳理」: 一键扫描 + 4 类问题清单 +
同义组展开 (radio 选 target) + 合并预览 dialog + 一键删除按钮.
合并事务要点:
- 先 pk 加 _m<src_id> 后缀再 UPDATE object_type_id, 避免 UNIQUE(object_type_id,pk).
- 同时 UPDATE object_type_id + type_api_name, 保持两字段一致 (否则连接器查不到).
- link.source_type / target_type / link_types.source_type / link_types.target_type 同步改写.
- action_types 没有 target_type 字段 (在 params jsonb), 跳过.
健康度判定:
- 启发式候选: 名称规范化后相同 / Levenshtein ≤2 / HasPrefix 双向 (含
TrustedCryptoCard vs TrustedCryptographyCard) / 描述 Jaccard ≥ 0.6.
- AI 用 anthropic MiniMax-M3 复核, 给 confidence + reason + 建议 target.
- AI 未明确表态的启发式候选不强行过滤, 标 conf=0.5 让 manager 自己决定.
辅助:
- 提供 docker-compose.ontology.yml 片段给 workspace compose 挂载使用
(二进制 + archive + env + healthcheck + autoheal 自愈).
测试: 54→39 个对象类型, 13 个零实例一键删 + 2 组同义合并
(FunctionNode→FunctionalNode, TrustedCryptoCard→TrustedCryptographyCard),
审计日志 12 条, AI 实际接入 anthropic:MiniMax-M3.
|
2026-08-07 19:16:13 +08:00 |
|
ssw
|
f1b687c2d2
|
目录扁平化:子目录内容提升至仓库根,文档归入 docs/
- 将 shangshu-ontology/ 子目录内容移至仓库根一级
- 修复 run.sh 的 REPO_ROOT 计算(扁平化后不再需要 cd ..),ARCHIVE_DIR 正确指向仓库根/archive
- 文档(README/PLAN/USAGE/IMPORT/product-intro)移至 docs/,同步更新结构树与导入命令中的旧路径
- 新增根 README.md 索引指向 docs/
- 新增 .gitignore:忽略 bin/、web/node_modules/、web/dist/、server/webroot/、.env、.workbuddy/ 等噪音
- main.go 的 ARCHIVE_DIR fallback 基于可执行文件相邻上级,扁平化后仍正确,无需改动
|
2026-08-07 14:21:34 +08:00 |
|