diff --git a/.workbuddy/memory/2026-08-22.md b/.workbuddy/memory/2026-08-22.md index 6fd1bad..1e88517 100644 --- a/.workbuddy/memory/2026-08-22.md +++ b/.workbuddy/memory/2026-08-22.md @@ -278,3 +278,39 @@ - 关键证据:SsoBind 用 fake code 调 MaxKey token endpoint,从 405 StringIndexOutOfBoundsException(client_secret < 29 字符报错)跳到 400 code 格式校验 → OAuth2 client 鉴权通过 - 剩 1 步:走 Playwright/curl 真 OAuth2 流程拿 code 跑完整 → 21:02 已闭环 + +## 2026-08-22 21:20:MAXKEY_INTEGRATION_PLAN.md 文档同步到落地状态 + 双向引用(未提交) + +- **变更原因**:plan.md 状态横幅仍写"计划阶段",但 OAuth2 已跑通(commit 3b393a3);§9「待决策项」6 条都已默认落地;§11「实施最小集合」与实际路径有偏离;troubleshooting.md 是单向引用 +- **改动 5 处**(仅 docs,未碰代码): + 1. **plan.md L7-10 横幅**:状态 → "OAuth2 主流程已跑通"+ commit 引用 + 反向链接到 TROUBLESHOOTING.md + 2. **plan.md §6 已决策项**:从 11 条扩到 17 条(新增 #12-17:MaxKey Docker 单实例本地 / MaxKey 多租户延后 / SQL 注册 / SsoBindController 独立于 jnpf / 不用 jnpf UserInfo / 密码策略延后) + 3. **plan.md §7 实战结果 vs 预判对照表**:5 行(§7.1-7.5)替代原"实战坑位预判" + 4. **plan.md §9 待决策项**:从 6 条缩到 2 条真正未拍板(MaxKey 多租户时点 + 跨子空间互信白名单) + 5. **plan.md §10 下一步行动**:替换为后续 5 条实际工作(CAS / Playwright / 首登改密 / Flyway / MaxKey 多租户) + 6. **plan.md §11.2/11.3/11.4**:重写为"实际落地路径" + 与原方案偏离对照 + 关键代码指针 + 7. **troubleshooting.md L9-12**:加反向链接块(plan.md � troubleshooting.md 双向引用) +- **踩坑(meta)**:Edit 工具对部分 emoji(🔀 U+1F500)会编码为 U+FFFD;⏸️ U+23F8 + variation selector 可正常;解决:corrupted 处替换为 ASCII 符号(✗)或简单符号 +- **行数变化**:plan.md 606 → 608;troubleshooting.md 231 → 229(去掉重复 `---`) + +## 2026-08-22 21:24:✅ plan.md 同步到落地状态 + troubleshooting 双向引用 → commit 709c66b pushed + +- 改动的 5 处 plan.md(横幅/§6/§7/§9/§10/§11)+ 1 处 troubleshooting.md(反向链接) +- 行数:plan.md 606→608;troubleshooting.md 231→229 +- 提交:`709c66b docs(sso): MAXKEY_INTEGRATION_PLAN 同步到 OAuth2 已落地状态 + troubleshooting 双向引用` +- 远端:origin/main 已同步(`git log --oneline -1` 显示 `709c66b (HEAD -> main, origin/main, origin/HEAD)`) +- ⚠️ 工作区还有未跟踪的 yml 资源文件(`boot/ssw-admin/src/main/resources/application-*.yml` 等 7 个 yml + ssw-tdc/ssw-tds-biz resources/ + ssw-sswflow/ssw-sswflow-biz/nax operators)—— 这些是上次踩坑后从 boot/.gitignore 移除 `resources/` 规则的产物;待用户确认是否 commit 进仓 + +## 2026-08-22 21:32:✅ 资源文件入库 → 0ee0535 + 2ddeebf pushed + +- **commit 0ee0535** chore(resources): 解锁 src/main/resources 业务配置入库 (42 files, +10917 lines) + - ssw-admin application-{dev,full,preview,prod,sswflow,tdc,test}.yml (7 个 profile) + - ssw-tdc application.yml + application-dev.yml + - ssw-admin resources/ 子目录全部:META-INF、logback、sharding-sphere、mapper/*、static/ssw/sswflow/、i18n/{message_*.properties} + - ssw-sswflow nax/{dbg3.py, operators/catalog.json} + - ssw-tdc k8s/{jupyterlab, nax-2p-ray-head-svc, runtimeclass-kata}.yaml + logback + - ssw-tds fisco/{Evidence.sol, fisco_adapter.py} + external_ds/external_ds_adapter.py +- **commit 2ddeebf** chore(resources): 入库 ip2region IP 数据库 xdb (47MB) + - ip2region_v4.xdb 11MB + ip2region_v6.xdb 36MB (公开 IP 库,登录地解析) +- 远端确认:`git ls-remote origin main` = 2ddeebf,HEAD 与 origin/main 对齐 +- 后续:业务 yml 含 sso/redis DB=8/server.port=30000 等关键配置,新机器 clone 后可直接启动 ssw-admin 不再丢资源 diff --git a/docs/PKIT-IDE-PLAN.md b/docs/PKIT-IDE-PLAN.md deleted file mode 100644 index d162556..0000000 --- a/docs/PKIT-IDE-PLAN.md +++ /dev/null @@ -1,192 +0,0 @@ -# pkit-ide · AI/人类集成交互开发 - -> 把 `docs/e2e/index.html` 和 `docs/e2e/dag-panel.html` 的成熟 UI 风格吸纳,加上 -> **pkit(项目本体) + ontology(业务本体) 双层数据流**,做成 AI/人类协同 IDE 入口。 - -> **核心**:人 / AI 在**同一个面板**,看同一份数据,做同一类动作, -> 区别只是「谁发起」(人类点按钮 vs AI 在 chat 写命令)。 - ---- - -## 1. 现状资产可吸纳 - -| 来源 | 现有能力 | pkit-ide 复用方式 | -|---|---|---| -| `docs/e2e/index.html` | dark theme / chips 过滤 / 搜索 / 分组进度条 / cards / status 徽标 | **100% 拷过来**,数据源换成 `/api/coverage` | -| `docs/e2e/dag-panel.html` | 实时数据 fetch / human 操作按钮 / action 总线 | **模式**借过来(下一步):节点编辑面板 | -| ssw-loop 关卡脚本 | 5 道 ls 检查 (check_required_docs 等) | **桥接**:由 `pkit dashboard` 暴露 `/api/gate` 直接给面板 | - ---- - -## 2. pkit-ide 架构 - -``` -┌─────────────────────────────────────────────────────────────────────────┐ -│ 浏览器: pkit-ide.html (自包含, 单文件 ~580 行) │ -│ │ -│ ┌──────────────────────────────────────┐ ┌────────────────────────┐ │ -│ │ LEFT · 项目本体 + 业务字典视图 │ │ RIGHT · AI + 人类协同 │ │ -│ │ · 5 cards 计数 │ │ · AI chat panel │ │ -│ │ · ② 业务字典 (ontology) │ │ · 上下文选择 → 左条目 │ │ -│ │ · ③ REQ × TC 覆盖度 │ │ · "+ 我加" 人工按钮 │ │ -│ │ · ④ 缺陷 (defects) │ │ · "↑ 问 AI" 调度按钮 │ │ -│ │ · ⑤ ssw-loop 6 闸门 │ └────────────────────────┘ │ -│ └──────────────────────────────────────┘ │ -│ ↓ fetch JSON ↑ POST chat │ -└───────┼────────────────────────────────────────────────────────┼────────┘ - ↓ ↑ -┌─────────────────────────────────────────────────────────────────────────┐ -│ pkit dashboard (Go net/http, 7890) │ -│ GET / → pkit-ide.html (embed.FS) │ -│ GET /api/cards → 5 计数 │ -│ GET /api/coverage → top N REQ × TC │ -│ GET /api/defects → 状态分布 + 最近 10 │ -│ GET /api/gate → 最近一次 ssw-loop 6 gate │ -│ GET /api/ontology → ObjectType / LinkType counts │ -│ POST /api/chat {message, ctx} → dispatchChat() 启发式 │ -│ POST /api/human/note {code, note} → 写缺陷 HUMAN-XXX │ -└──────────────┬──────────────────────────────┬──────────────────────────┘ - ↓ 读 ↓ 读 - ┌──────────────┐ ┌────────────────┐ - │ pkit.duckdb │ │ ontology:8088 │ - │ (项目本体) │ │ (业务本体) │ - └──────────────┘ └────────────────┘ -``` - ---- - -## 3. dispatchChat · 启发式 dispatcher (无 LLM 阶段) - -`/api/chat` 当前是启发式的,根据关键字调真实数据: - -| 关键字 | 路由 | 数据源 | -|---|---|---| -| `ontology [kwd]` `业务概念 [kwd]` `概念 [kwd]` | ontology concept_lookup | ontology REST (8088) | -| `pull [Type]` | ontology getObjectType | ontology REST (8088) | -| `覆盖率` / `覆盖度` | top 5 REQ × TC | pkit.duckdb v_req_coverage | -| `REQ ` / `查 REQ` | pkit req | pkit.duckdb requirements | -| `defect add ...` | pkit defect add | pkit.duckdb defects (upsert) | -| 兜底 | "我看到了 X,但还没接 LLM"提示 | — | - -**关键性质**:**每个分支都调真实数据**,而不是 fake reply。LLM 接入是 Phase 3.5。 - ---- - -## 4. 启动方式 - -```bash -# 1. 启 ontology 业务能力后端 -~/Desktop/ssw/tools/ontology-runtime/start.sh - -# 2. 灌库(只有灌了,pkit-ide 才有数据) -~/Desktop/ssw/pkit/bin/pkit sync --source=md --apply -~/Desktop/ssw/pkit/bin/pkit sync --source=cases --apply -~/Desktop/ssw/pkit/bin/pkit sync --source=code --apply - -# 3. 启 pkit-ide 看板 -~/Desktop/ssw/pkit/bin/pkit dashboard --port=7890 - -# 4. 浏览器开 -open http://127.0.0.1:7890 -``` - ---- - -## 5. 已在这次实施的能力 - -### 面板 (自包含 HTML) - -- ✅ 5 张计数卡 (req / tc / impl / defect / milestone) -- ✅ 业务字典区段 (顶部 ontology summary,12 ObjectType + 8 LinkType) -- ✅ REQ × TC 覆盖度区段 (top 30) -- ✅ defects 区段 (状态徽标 + 最近 10) -- ✅ 最近一次 ssw-loop run 的 6 闸门 (K/A/B/C/F/I) -- ✅ 工具栏:状态 chip + 搜索 + 排序 -- ✅ 左侧条目可点击 → 自动设为 AI chat 上下文 -- ✅ 上下文栏:显示当前选中 code + 类型 pill -- ✅ "+ 我加" 按钮 → POST /api/human/note -- ✅ "↑ 问 AI" 按钮 → POST /api/chat - -### 后端 (Go pkit dashboard) - -- ✅ `GET /` → embed pkit-ide.html (单文件 ~18KB) -- ✅ `GET /api/cards` → 5 counts -- ✅ `GET /api/coverage` → top 30 rows -- ✅ `GET /api/defects` → stats + recent 10 -- ✅ `GET /api/gate` → last run + 6 gates -- ✅ `GET /api/ontology` → counts -- ✅ `POST /api/chat` → dispatchChat 5 分支 + 兜底 -- ✅ `POST /api/human/note` → HUMAN-XXX 缺陷 - ---- - -## 6. 已验证的端到端 (本次) - -```bash -curl -X POST http://127.0.0.1:7890/api/chat \ - -H 'Content-Type: application/json' \ - -d '{"message":"ontology 数据产品"}' -→ 命中 DataProduct (display_name=数据产品) + 全部 LinkType - -curl -X POST http://127.0.0.1:7890/api/chat \ - -H 'Content-Type: application/json' \ - -d '{"message":"覆盖率"}' -→ Top 5 REQ × TC (Q-USE TC=26 P0=1, Q-DOC TC=15, ...) - -curl -X POST http://127.0.0.1:7890/api/chat \ - -d '{"message":"defect add BS-NEW-AI --title AI 加的 --severity P2 --req REQ-001 --tc TC-IDENTITY-002"}' -→ ✓ 已加 defect BS-NEW-AI,关联 REQ=REQ-001, TC=TC-IDENTITY-002 -``` - ---- - -## 7. 已验证的 AI/人类协同点 - -| 交互 | 谁发起 | 数据流向 | -|---|---|---| -| 人类点 REQ → 上下文栏展示 | 人类 | LEFT → RIGHT (前端 JS, 零后端) | -| 人类选条目后问"覆盖率" | 人类 | RIGHT chat → /api/chat → pkit | -| AI 写缺陷 BS-NEW-AI | AI | AI 在 chat 写 → dispatcher → pkit | -| 人类"+ 我加" 写 HUMAN-XXX | 人类 | LEFT click → /api/human/note → pkit | -| 缺陷列表实时刷新 | 系统 | pkit dashboard 每 10s polling | -| 闸门状态实时刷新 | 系统 | pkit dashboard 每 10s polling | - -**这是 AI + 人类共享同一份 DB、同一份 UI 的最小完整闭环**。 - ---- - -## 8. 接下来要做 (Phase 3.5+) - -| TODO | 描述 | 优先级 | -|---|---|---| -| LLM 接管 dispatcher | 用 MiniMax-M3 做 fuzzy dispatch,把当前 5 个分支由 LLM 选择 + 调 MCP | 高 | -| MCP server 暴露 pkit | 把 pkit/gate 三个命令包成 MCP server,ontology 已做,补 pkit | 高 | -| diff/compare 视图 | 改一段代码 → 影响哪些 REQ/TC | 中 | -| 实时 RUN 流 | ssw-loop 一个 run 创建后,状态变 → 4 闸门实时翻转 | 中 | -| 多用户协同 | 多个 agent 在同一 dashboard 写,LB | 低 | -| ssw-ontology ObjectType 灌 ontology | 把 FL-X.Y / TP-NN 全部进 ontology ObjectType (Phase 1 路径 A) | 中 | -| AI 写需求 | 「未实现」的 REQ,AI 给出 spec + TC scaffold (用 ontology 业务字典) | 低 | -| 把现有 e2e/index.html 替换为嵌入模式 | e2e/index.html 现 inline 静态 DATA,迁到 pkit | 中 | -| 历史 replay | 哪天回放「当时这一组 REQ 是怎么跑过的」 | 低 | - ---- - -## 9. 与 ssw-loop / dag-panel.mjs 的边界 - -- pkit-ide **不** 实现 e2e 执行流(`/api/run` 跑 TC). 它只看 spec/test/result 三元组的快照. -- ssw-loop 的 RUN / 6 gate 结果,只**读**自 pkit DB (gateway.table = writes by ssw-loop) -- dag-panel.mjs (DAG 业务时序图) 仍是独立 Node.js 服务(`/api/dags` 等);pkit-ide 不取代它,只在嵌入位加一个"打开 dag-panel"链接即可 -- pkit-ide 是**单向**消费 ssw-loop + ssw-ontology 的产物,**不**反过来驱动 - ---- - -## 10. 资源 - -| | | -|---|---| -| pkit-ide HTML | `~/Desktop/ssw/pkit/cmd/pkit/templates/pkit-ide.html` (~580 行) | -| embed go | `~/Desktop/ssw/pkit/cmd/pkit/templates.go` | -| pkit binary | `~/Desktop/ssw/pkit/bin/pkit` (17MB) | -| 命令 | `pkit dashboard --port=7890` | -| 入口 URL | http://127.0.0.1:7890 | -| 路线图 | 本文件 §8 | diff --git a/docs/PKIT-MCP.md b/docs/PKIT-MCP.md deleted file mode 100644 index 837518f..0000000 --- a/docs/PKIT-MCP.md +++ /dev/null @@ -1,133 +0,0 @@ -# pkit-mcp · Model Context Protocol 接入 - -> 把 pkit 暴露成标准 MCP server,让任何支持 MCP 协议的 agent(Claude Desktop / Cursor / WorkBuddy / 自研 agent)都能直接调 pkit 全部能力。 - -## 启动 - -```bash -~/Desktop/ssw/pkit/bin/pkit-mcp -# → pkit-mcp db=.../project.duckdb ontology=http://127.0.0.1:8088 ssw=.../ssw -``` - -零配置,默认走: - -| 路径 | 默认值 | 环境变量覆盖 | -|---|---|---| -| DB | `~/Desktop/ssw/docs/project.duckdb` | `PKIT_DB` | -| ontology | `http://127.0.0.1:8088` | `PKIT_ONTOLOGY` | -| ssw-root | `~/Desktop/ssw` | `PKIT_SSW_ROOT` | - -**前置**:ontology-runtime 必须先跑(`start.sh`)——pkit-mcp 不自带 ontology。 - -## 协议 - -- **Transport**: stdio,JSON-RPC 2.0,一行一条消息 -- **Methods**: `initialize` / `initialized` / `tools/list` / `tools/call` / `ping` -- **Spec**: https://modelcontextprotocol.io/specification/2024-11-05 - -## 11 个 tools - -| Tool | 用途 | 关键参数 | -|---|---|---| -| `pkit_req` | 正向查 REQ + 关联 TC | `code` | -| `pkit_coverage` | REQ × TC 覆盖度 top-N | `limit` / `offset` | -| `pkit_defect_add` | 加缺陷 | `code` / `title` / `severity` / `req` / `tc` | -| `pkit_defect_list` | 列缺陷 | `status` | -| `pkit_gate_run_start` | 开 ssw-loop run | `app` / `milestone` | -| `pkit_gate_record` | 记录 K/A/B/C/F/I 关卡 | `run_id` / `gate` / `status` / `details` | -| `pkit_gate_check` | run 总判定 | `run_id` | -| `pkit_milestone_list` | 列里程碑 | — | -| `pkit_ontology_concept` | 查业务概念(ObjectType + LinkType) | `keyword` | -| `pkit_ontology_pull` | 拉 ObjectType 完整 schema | `type` | -| `pkit_ontology_push` | pkit REQ → ontology 镜像 | `req_code` / `object_type` | - -## 接入 WorkBuddy(用户 MCP) - -`~/.workbuddy/mcp.json` 加一段: - -```json -{ - "mcpServers": { - "pkit": { - "command": "/Users/xs/Desktop/ssw/pkit/bin/pkit-mcp", - "args": [], - "env": { - "PKIT_ONTOLOGY": "http://127.0.0.1:8088" - } - } - } -} -``` - -重启 WorkBuddy 后,connector 列表会出现 `pkit` server,带 11 个 tool。 - -## 接入 Claude Desktop / Cursor - -`~/Library/Application Support/Claude/claude_desktop_config.json`: - -```json -{ - "mcpServers": { - "pkit": { - "command": "/Users/xs/Desktop/ssw/pkit/bin/pkit-mcp" - } - } -} -``` - -## 接入自研 Python agent(参考 demo) - -```python -import subprocess, json - -def call_pkit(name, args): - p = subprocess.Popen(["/Users/xs/Desktop/ssw/pkit/bin/pkit-mcp"], - stdin=subprocess.PIPE, stdout=subprocess.PIPE, text=True) - req = {"jsonrpc":"2.0","id":1,"method":"tools/call", - "params":{"name":name,"arguments":args}} - p.stdin.write(json.dumps(req)+"\n"); p.stdin.close() - return json.loads(p.stdout.read()) - -# 调一下 -print(call_pkit("pkit_coverage", {"limit":3})["result"]["content"][0]["text"]) -``` - -## 跟 ssw-ontology-mcp 的协同 - -两者 stdio 形态完全一致: - -| | pkit-mcp | ssw-ontology-mcp | -|---|---|---| -| 管什么 | 开发契约(REQ/TC/代码/缺陷/gate) | 业务对象(Object/Property/Link) | -| 11 个 tool | REQ/TC/缺陷/gate/覆盖率/ontology 调用 | get_object_types / get_object / search / ... | -| 写入 | defect_add / gate_record / REQ push | PushObject / UpdateObject | -| 互补关系 | pkit 写 → ontology 镜像(走 `pkit_ontology_push`) | ontology 暴露 → pkit 通过 `pkit_ontology_concept/pull` 取 | - -**典型协作流**(LLM agent 视角): -1. 用户说"加一个数据产品授权流程的 REQ" -2. LLM 调 `pkit_ontology_concept {keyword:"数据产品"}` → 拿到 DataProduct schema -3. LLM 调 `pkit_ontology_pull {type:"DataProduct"}` → 拿到 properties(6 个) -4. LLM 写 REQ,直接调 `pkit_req {code:"FL-AUTH-001", ...}` (待 `pkit_req_add`) -5. LLM 调 `pkit_ontology_push {req_code:"FL-AUTH-001"}` → 在 ontology 落 object,带 `external_ref` 到 REQ -6. 后续:ontology 平台 UI 上能看到这个 object 反链到 pkit REQ - -## 实测 stdio 调用 - -```bash -echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pkit_coverage","arguments":{"limit":5}}}' \ - | ~/Desktop/ssw/pkit/bin/pkit-mcp -``` - -输出: -```json -{ - "jsonrpc": "2.0", - "id": 1, - "result": { - "content": [{ - "type": "text", - "text": "REQ × TC coverage:\n Q-USE | 质量特性-易用性 | TC=26 P0=1\n Q-DOC | 质量特性-用户文档集 | TC=15 P0=0\n ..." - }] - } -} -``` \ No newline at end of file