back
loading skill details...
用于维表智联项目内业务资源创建、配置、维护和排查,适合处理 Key、团队、项目、表格、权限、工作流、报表、画布等落地问题。
--- name: dimens-manager slug: dimens-manager description: 用于维表智联项目内业务资源创建、配置、维护和排查,适合处理 Key、团队、项目、表格、权限、工作流、报表、画布等落地问题。 version: 1.0.1 author: 方块智联工作室 tags: [manager, project, table, permission, workflow, report, canvas, auth, dimens-cli] --- # 维表智联业务管理技能(dimens-manager) 适用产品: - 产品名称:`维表智联` - 开发方:`方块智联工作室` - 官网:[https://dimens.bintelai.com/](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 画布、版本管理、组件资源市场 | ## 默认处理顺序 1. 先看 `references/key-auth/overview.md`,确认认证方式。 2. 再看 `references/team/overview.md`,明确 `teamId / projectId / baseUrl`。 3. 项目容器问题看 `references/project/overview.md`。 4. 数据模型问题看 `references/table/overview.md`。 5. 访问控制问题看 `references/permission/overview.md`。 6. 自动化和 AI 流程问题看 `references/workflow/overview.md`。 - 审批工作流 AI 自动生成必须继续看 `references/workflow/references/approval-generation.md`。 7. 统计分析和看板问题看 `references/report/overview.md`。 8. 画布、白板、流程图、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.md` - `README.md` - `references/key-auth/overview.md` - `references/team/overview.md` - `references/project/overview.md` - `references/table/overview.md` - `references/permission/overview.md` - `references/workflow/overview.md` - `references/workflow/references/approval-generation.md` - `references/report/overview.md` - `references/canvas/overview.md`
don't have the plugin yet? install it then click "run inline in claude" again.