feat(mcp): 参考 dacli 扩面到 49 个业务工具

- 新增 workflow×7 / form.create|update|delete / ops×4 / dict×3 / menu×2 / permission×3 / context.app.list
- 实现方式:mcp_compat 进程内直调契约面 handler(与 HTTP 同一函数),不重写 SQL
- 自动把 formData 等对象字段序列化为 TEXT,避免 value_to_text 静默丢弃
- 管理员头缓存按 SessionStore 实例缓存并设上界(防地址复用 602 与无界内存)
- 新增 tests/mcp_tools_it.rs 6 条;全量 667 passed,verify.sh --smoke 14 步全绿
This commit is contained in:
admin committed 2026-11-02 23:46:17 +08:00
1 parent 31e0e457ba
commit c55d111e88
13 files changed
+1931 -7

No files matched your search

+29 -1
View File
@@ -80,21 +80,27 @@ sspf_context # 1. 先确认环境
→ 失败则读 error.hints / next_actions 自纠
```
### 当前业务工具(26 个)
### 当前业务工具(49 个)
| 域 | 工具 | 一句话 | 写 |
|---|---|---|---|
| context | `context.get` | 取后端/应用/表数 | |
| context | `context.app.list` | 列多应用(`base_system`,默认不含主系统) | |
| schema | `schema.table.list` | 列出物理表 | |
| schema | `schema.table.describe` | 看表的列与类型 | |
| schema | `schema.index.list` | 索引与唯一约束 | |
| schema | `schema.table.create` | 按低代码设计稿建表 + 回写模型 | ✅ |
| menu | `menu.tree` | 菜单树(按应用隔离) | |
| menu | `menu.info` | 菜单详情(改之前先看) | |
| menu | `menu.create` | 建菜单(写全 enCode + systemId) | ✅ |
| menu | `menu.update` | 改菜单(名称/地址/图标/排序) | ✅ |
| menu | `menu.delete` | 软删菜单 | ✅ |
| permission | `permission.user.list` | 用户(**不含口令字段**) | |
| permission | `permission.user.create` | 建普通用户(可同时绑角色) | ✅ |
| permission | `permission.user.delete` | 软删用户(管理员不可删) | ✅ |
| permission | `permission.role.list` | 角色 | |
| permission | `permission.role.create` | 建角色(enCode 全平台唯一) | ✅ |
| permission | `permission.role.delete` | 软删角色(系统角色不可删) | ✅ |
| permission | `permission.authorize.list` | 查某对象的直授 | |
| permission | `permission.authorize.grant` | 给用户/角色/组织/岗位授菜单(幂等) | ✅ |
| permission | `permission.authorize.revoke` | 撤权(软删,撤不存在会报错) | ✅ |
@@ -102,6 +108,9 @@ sspf_context # 1. 先确认环境
| dict | `dict.type.list` | 字典分类 | |
| dict | `dict.data.list` | 字典项 | |
| dict | `dict.type.create` | 建字典分类 | ✅ |
| dict | `dict.type.update` | 改字典分类 | ✅ |
| dict | `dict.type.delete` | 软删分类(**不级联**字典项) | ✅ |
| dict | `dict.data.create` | 往分类追加字典项 | ✅ |
| data | `data.query` | 按表名查数据(结构化条件) | |
| data | `data.count` | 按表名计数 | |
| data | `data.record.insert` | 按设计稿新增记录(主表 + 子表) | ✅ |
@@ -110,6 +119,25 @@ sspf_context # 1. 先确认环境
| form | `form.list` | 列低代码功能(`base_visual_dev`) | |
| form | `form.describe` | 解析表单:主表字段/子表/控件类型 | |
| form | `form.validate` | 校验表单声明的字段在表里是否真有列 | |
| form | `form.create` | 建表单定义(草稿态;`formData` 可传对象) | ✅ |
| form | `form.update` | 改表单定义(只 SET 传了的键) | ✅ |
| form | `form.delete` | 软删功能(菜单需另行清理) | ✅ |
| workflow | `workflow.template.list` | 流程模板列表(元数据) | |
| workflow | `workflow.template.info` | 模板详情 | |
| workflow | `workflow.template.create` | 建模板(只写元数据) | ✅ |
| workflow | `workflow.template.update` | 改模板 | ✅ |
| workflow | `workflow.template.delete` | 软删模板 | ✅ |
| workflow | `workflow.template.selector` | 流程下拉(绑表单/菜单用) | |
| workflow | `workflow.task.list` | 任务元数据(无引擎 ⇒ 通常为空) | |
| ops | `ops.health` | 表数 / 会话数 / admin 就绪 | |
| ops | `ops.logs` | 按分类查系统日志 | |
| ops | `ops.online` | 按账号聚合的在线会话(不含 token) | |
| ops | `ops.schedule.list` | 定时任务定义(不跑调度) | |
**P3 这批(23 个)怎么实现的**:不重写 SQL,而是**进程内直调契约面 handler**
(`src/backend/src/mcp_compat.rs`),与 HTTP 路由注册的是同一个函数 ⇒ 校验、默认值、
软删语义只有一份。代价是 MCP 适配器必须构造管理员请求头(`SessionStore::issue` 一个
`admin` 会话),所以**它只适用于本地开发**;对外暴露要走 `BaselineHttpAdapter` 带真实 token。
**写工具为什么少而严**:读工具错了只是「看到错的数据」,写工具错了是「把库改坏」。
所以写工具都在写库**之前**做完校验(必填/格式/父节点存在/编码唯一),