运行时依赖
安装命令
点击复制技能文档
维表智联业务管理技能(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。 统计分析和看板问题看 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.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