技能介绍

要解决什么问题

在 维表智联（Dimens） 里做二次开发时，常见卡点不是「能不能调 API」，而是 接入位置（自定义页面、Wujie 微模块、纯 Web、BFF、Node 脚本、移动端）和 上下文（baseUrl、teamId、projectId、表/视图 ID）混在一起：密钥该放哪、token 怎么刷新、更新行要不要先读版本、页面/视图/按钮三类微模块的 props 各走哪套协议。

本技能聚焦 SDK、HTTP API 与多端接入，不负责整站规划或项目内资源创建——那些应交给 dimens-system-orchestrator 与 dimens-manager。

技能如何组织答案

处理接入问题时，技能会按固定顺序收敛方案：

先定场景：若是维表 自定义页面 / dimens-web 脚手架 / Wujie 嵌入，优先走 references/dimens-web-scaffold.md，复用脚手架里的运行上下文、useDimens、SDK 聚合与 retry，而不是重写一套 dimens-auth / dimens-storage 分层。
微模块三类上下文：页面（PROJECT_MENU）、视图（SHEET_VIEW + viewState）、按钮（ROW_BUTTON_MODAL / CELL_BUTTON_MODAL + actionSnapshot）需对照 references/micro-module-wujie-context.md，区分定义级 usageScene/mountLocation 与运行时 sourceLocation。
认证与密钥边界：浏览器与移动端默认 不保存 apiSecret；API Key 换到的是现有用户 token，不是独立开放平台权限。teamId 是团队隔离，projectId 是项目内资源上下文，调用链不能混传或漏传。
默认输出契约：接入位置、认证方案、上下文来源、最小可运行调用示例、以及可用 dimens-cli 或 HTTP 断言覆盖 401 / 403 / 404 的验证路径；更新类接口统一 先读 → 改 → 写，并考虑 version/baseVersion。

自定义页面还会要求 UI/UX 前置：在编码前先确认并使用 ui-ux-pro-max 定风格与交互；新业务页用 /xxx 独立路由，不覆盖 /custom、/records、/settings 等示例与调试页。

适用边界与易错点

用户消息或当前页 URL 形如 http://host/#/{teamId}/{projectId}/{sheetId} 时，应先解析 ID 再连维表，而不是反复追问上下文。
viewState.displayRows、actionSnapshot.rowSnapshot 只是轻量快照，权威数据仍要走 SDK/API。
AI 相关能力（模型列表、生图、视频任务）需对照 references/ai-examples.md 与 references/capability-status.md，在 SDK 边界按真实响应归一化，业务层不要死读 response.data.data。
调试与资源管理优先给 dimens-cli 可验证路径；仅在端侧集成或 CLI 未覆盖时再补 SDK/HTTP 细节。