Commit Graph
15 Commits
Author SHA1 Message Date
admin 240dd2c31f docs(WORKBUDDY): WorkBuddy 接入 + 本体信息更新说明(连接器安装 / 三条更新路径 / 排错) 2026-08-24 14:53:07 +08:00
admin e5fc024217 chore: 删除 importer/import-from-xeo.js(尚数网业务专用)
沙数网 shangshuwang.cn mobileApi 专用 importer 不属于通用本体平台的一部分,
按业务专用代码剥离。

- 删除 importer/import-from-xeo.js(200 行, Node 脚本)
- 删除空目录 importer/

文档同步:
- docs/README.md 项目结构去掉 importer/ 行
- docs/IMPORT.md 删除"尚数网示例"整节,改为通用 Node 骨架

历史信息归档在 .workbuddy/memory/2026-08-24.md
(字段映射表 / 抓取器路径 / 重新启用方式)
2026-08-24 14:11:29 +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 e8bbf47fbe feat(skills): 迁入 ssw-ontology-reviewer 通用技能(同事通过 git 分发) 2026-08-21 18:28:36 +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 8b30a3ac0a fix(connector): MCP 模板去除 // 注释, 改用 _comment 字段
苏苏反馈: 严格 JSON parser 不允许 // 注释, 复制到 ~/.workbuddy/mcp.json
会直接报错 'Unexpected token'.

- 用 _comment / _endpoint / _api_key_warning 三个 key 表达注释
  (下划线开头 JSON 完全合法, 多数解析器会忽略, 注释信息也保留).
- 配套提示放回顶部 sub 标题里的 hint-mini 标签.
- 实测: 严格 json.loads 通过, key/url/X-API-Key 都正确解析.
2026-08-08 17:24:01 +08:00
admin aa8d4bf98e fix(connector): 接入代码生成默认带 X-API-Key
苏苏指出 3 个语言示例都没带 key, 复制到本地直接跑必然 401.

- 共享常量 `API_KEY = 'analyst-key-001'` (analyst 主体, L0~L2 + 受 marking 过滤).
- Python / JavaScript 示例: 注入 HEADERS (X-API-Key).
- WorkBuddy MCP 模板:
  * url 之前错填 `/api/v1/mcp/manifest` (只读清单), 改为 `/api/v1/mcp` (JSON-RPC 端点).
  * 加 `headers: { "X-API-Key": "..." }` 字段.
  * 注释明示是 JSON-RPC 2.0 Streamable HTTP + 失败排查命令.
- UI:
  * 默认 lang 从 py 改为 mcp (第一个显示 WorkBuddy, 苏苏要求).
  * 单选顺序调整 MCP 在前.
  * 顶部加 ⚠️ 提示"默认演示 key, 生产请替换".

测试:
- 带 key 调 /api/v1/connector/object-types → count=38 ✅
- 带 key POST /api/v1/mcp initialize → serverInfo=尚数网本体平台 ✅
- 复制配置进 ~/.workbuddy/mcp.json 后 WorkBuddy 可识别并信任该 MCP.
2026-08-08 17:09:21 +08:00
admin d0e3f6e4a9 chore: 把 archive/ 加入 .gitignore
测试用的技术标准文档 / 上传文件不应入库, 由 docker-compose 的
ARCHIVE_DIR 环境变量挂载到容器内. 此前 git status 会持续显示这些
文件为 untracked, 增加噪音.
2026-08-07 19:18:42 +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
admin e28c8add5f fix(ai): 修复 AI 摄取弹窗卡死 + 端口默认 8081→8082
- AIView.doExtract 改用 try/catch/finally, finally 必关弹窗 + 清 loading;
  Element Plus 新版 ElMessage(opts) 返回 MessageHandler 实例, 调 .close()
  才是正确用法 (旧 ElMessage.close(id) 静态方法在新版本里已移除).
- run.sh / README.md / docs/README.md 默认端口 8081 改为 8082,
  避免与 docker compose 里的 ontology 服务端口冲突.

测试: 浏览器实际点击开始提取, 弹窗完成后立刻关闭, 无 Console 报错.
2026-08-07 19:16:00 +08:00
ssw d57f0ac068 移除 db/schema.sql 与 db/README.md:应用启动已自动幂等建全部 17 表并 seed,保留 schema 文件会与代码 DDL 漂移误导他人;保留 docker-compose.yml 一键起本地 PG 2026-08-07 15:25:13 +08:00
ssw 3d824e6853 导出数据库结构并补充本地 PG 一键部署
- 新增 db/schema.sql:17 张表的纯净 DDL 快照(来源 server/db.go migrate + server/access_control.go ensureAccessControlSchema),供手动初始化/结构审查
- 新增 docker-compose.yml:一键起本地 Postgres(15432 映射,库 shangshu,用户 dacli),卷持久化 + 健康检查
- 新增 db/README.md:说明 schema 来源、手动初始化与 docker 用法
- 根 README.md 增加「数据库」段落,说明代码启动时自动建表,无需手动导入即可运行
- 注:应用启动时已幂等建全部 17 表并自动 seed 内置数据,导出 schema 仅为可审查/可手动导入/配合 docker
2026-08-07 14:35:47 +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