维表智联业务管理技能(dimens-manager)
适用产品:
- 产品名称:
维表智联 - 开发方:
方块智联工作室 - 官网:https://dimens.bintelai.com/
执行前必读
- ✅ 当前技能负责项目内业务资源落地,不负责完整系统方案拆解;系统级需求先用
dimens-system-orchestrator。 - ✅ SDK、HTTP、Web、BFF、Node.js 接入问题先用
dimens-sdk。 - ✅ Windows 下生成或修改中文文件时,必须遵守
../windows-utf8.md:用 UTF-8 写入,禁止cmd echo/ 默认重定向写中文正文,写完读回确认没有??。 - ✅ 项目内查询、创建、更新、上传、验证等操作优先推荐并执行
dimens-cli命令;自定义 URL 只作为上下文解析或 CLI 未覆盖时的补充路径,不作为首选解决方案。 - ✅ 执行任何写操作前先确认认证、
teamId、projectId与资源归属。 - ✅ 更新类操作统一遵循“先读取当前数据 -> 修改目标字段 -> 再提交更新”。
- ✅ 项目资源默认按“三驾马车”理解:表格、文档、报表。
- ✅ 报表创建当前走项目菜单
sheet/create type=report;返回的reportId等于sheetId。
职责边界
| 问题类型 | 应使用技能 |
|---|---|
| 完整系统、平台、管理应用的规划和拆解 | dimens-system-orchestrator |
| 项目内资源创建、配置、更新、排查 | dimens-manager |
| SDK、HTTP API、Web/BFF/Node.js/移动端接入 | dimens-sdk |
快速路由表
| 业务域 | 入口文档 | 适用场景 |
|---|---|---|
| Key 鉴权 | references/key-auth/overview.md | API Key / Secret 换 token、第三方接入、密钥边界排查 |
| 团队上下文 | references/team/overview.md | 确认 teamId/projectId、成员、租户隔离、资源归属 |
| 项目初始化 | references/project/overview.md | 创建项目、项目菜单、文档资源、初始化主链 |
| 多维表格 | references/table/overview.md | 表、字段、视图、行数据、relation、筛选查询 |
| 权限管理 | references/permission/overview.md | 角色、项目权限、表/列/行权限、ACL、公开访问 |
| 工作流 | references/workflow/overview.md | 工作流定义、项目挂载、运行调用、模型配置 |
| 报表 | references/report/overview.md | 报表、图表组件、参数联动、数据源查询 |
| 画布 | references/canvas/overview.md | 画布资源、AI 生成画布、PPT 画布、版本管理、组件资源市场 |
默认处理顺序
- 先看
references/key-auth/overview.md,确认认证方式。 - 再看
references/team/overview.md,明确teamId / projectId / baseUrl。 - 项目容器问题看
references/project/overview.md。 - 数据模型问题看
references/table/overview.md。 - 访问控制问题看
references/permission/overview.md。 - 自动化和 AI 流程问题看
references/workflow/overview.md。- 审批工作流 AI 自动生成必须继续看
references/workflow/references/approval-generation.md。
- 审批工作流 AI 自动生成必须继续看
- 统计分析和看板问题看
references/report/overview.md。 - 画布、白板、流程图、PPT 画布和 AI 一键生成画布看
references/canvas/overview.md。
高风险跑偏点
- 不要把
dimens-manager当成系统级需求分析器。 - 不要在 Windows 下用
echo 中文 > file、未指定编码的Out-File或默认重定向写中文文件;这会导致中文变成??。 - 不要把 API Key 当成独立权限体系;Key 登录后仍继承绑定用户权限。
- 不要脱离团队和项目上下文处理表格、权限、工作流、报表。
- 不要把人员/部门字段粗暴退化成普通下拉字段。
- 不要跳过报表预检链直接创建复杂图表。
- 不要把业务工作流画布直接等同于可执行工作流;可执行链路仍要回到工作流章节。
- 不要把 AI 生成的审批流程文字等同于已发布审批工作流;必须补齐图草案、项目挂载、
workflow字段入口和审批运行验证。 - 不要只看 CLI 命令执行成功就判断权限生效;还要关注缓存失效、权限快照和前端刷新。
常见错误与修正
| 错误 | 修正 |
|---|---|
只给 projectId 就开始改资源 | 先确认 teamId 和资源归属 |
| 直接局部 update | 先读取当前数据,再合并目标字段 |
报表创建后读取不到 reportId | 使用返回的 sheetId 作为 reportId,或使用已归一化的 CLI 输出 |
| 权限创建成功就认为前端已生效 | 继续检查权限快照、缓存失效和前端刷新 |
| AI 只输出审批说明,没有图草案 | 按 approval-generation.md 补齐 pluginType=approval 的 nodes/edges/globalVariables/meta |
参考文档
../windows-utf8.mdREADME.mdreferences/key-auth/overview.mdreferences/team/overview.mdreferences/project/overview.mdreferences/table/overview.mdreferences/permission/overview.mdreferences/workflow/overview.mdreferences/workflow/references/approval-generation.mdreferences/report/overview.mdreferences/canvas/overview.md