@lark-apaas/coding-steering 0.1.46 → 0.1.47-alpha.20260903185732

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@lark-apaas/coding-steering",
-  "version": "0.1.46",
+  "version": "0.1.47-alpha.20260903185732",
   "description": "Stack-specific steering content for miaoda-coding templates",
   "type": "module",
   "files": [
     "steering"
   ],
+  "scripts": {
+    "lint:md": "markdownlint 'steering/**/*.md' --ignore 'steering/**/skills/**' --ignore 'steering/**/skills_common/**' --ignore 'steering/**/skills_local/**'"
+  },
   "devDependencies": {
     "markdownlint-cli": "^0.47.0"
   },
@@ -17,8 +20,5 @@
     "miaoda",
     "coding-steering"
   ],
-  "license": "MIT",
-  "scripts": {
-    "lint:md": "markdownlint 'steering/**/*.md' --ignore 'steering/**/skills/**' --ignore 'steering/**/skills_common/**' --ignore 'steering/**/skills_local/**'"
-  }
-}
+  "license": "MIT"
+}

package/steering/nestjs-react-fullstack/skills/app-init-feasibility-guide/SKILL.md

@@ -83,7 +83,6 @@ available-agents:
 | 无持久化状态、纯展示或前端工具 | 纯前端 |
 | 需要数据存储、用户隔离、后端逻辑 | 全栈 |
 | 涉及文件上传与管理 | 全栈 + 文件服务 |
-| 服务端图像、音视频处理（易引入 native addon） | 先确认能否改用 client 处理、平台服务或纯 JS/WASM |
 | 以飞书多维表格为数据源 | 插件优先；复杂查询场景评估是否同步至本地库 |
 | 需要飞书通知、群组、AI 能力 | 插件集成，标记插件实例需求 |
 | 需要定时或事件驱动的后台处理 | 全栈 + 自动化任务 |
@@ -114,7 +113,6 @@ available-agents:
 - 集成点：飞书、多维表格、AI、内网接口、OpenAPI、自动化触发。
 - 边界与限制：不支持的能力、外部依赖、数据权限边界。
 - 交给 Code agent 时标明需要加载的专项 skill（表格、表单、图表、插件、权限、文件、自动化）。
-- 需要 native addon 时：确认它提供覆盖 linux-x64 / glibc 的预编译二进制并记录包名与版本；没有预编译二进制、装的时候要现场编译的不能用。
 
 ## Common Mistakes
 

package/steering/nestjs-react-fullstack/skills/authz-guide/references/management-page-spec.md

@@ -16,7 +16,7 @@ Step 0: 制定实施计划（强制，禁止跳过）
 
 Step 1: 编码前确认（闸门）
   ├─ 确认 SDK 方法签名：读取 sdk-types.md，摘录 roles / members / search 的出入参
-  ├─ 确认搜索组件目录存在：client/src/components/business-ui/ 下包含 user-select、department-select、chat-select 目录
+  ├─ 先按「妙搭业务组件」一节调用 get_ui_component_info(["@miaoda/user-select", "@miaoda/department-select", "@miaoda/chat-select"]) 安装组件（装机路径 client/src/components/miaoda/）
   └─ 确认 Tag 胶囊组件存在：上述目录中分别包含 user-select-tag、department-select-tag、chat-select-tag 文件
 
   ⛔ 以上任一不存在，停止实现并报告
@@ -63,7 +63,7 @@ Step 5: 验证
 
 按以下优先级顺序拼接展示，无任何内容时显示 `--`：
 
-1. **特殊范围胶囊**：使用 `ItemPill` 组件（`business-ui/entity-combobox/item-pill`）展示，每项带**品牌色**（`bg-primary`，跟随 CSS 变量 `--primary`，默认蓝色）圆底 20px 图标（`SPECIAL_MEMBER_ICONS` 常量，见代码骨架），图标前景色使用 `text-primary-foreground`，在表格成员摘要列和成员编辑面板中**同时复用**：
+1. **特殊范围胶囊**：使用市场组件返回的胶囊/Tag 展示（import 路径与 Props 以 get_ui_component_info 返回的 docs 为准），每项带**品牌色**（`bg-primary`，跟随 CSS 变量 `--primary`，默认蓝色）圆底 20px 图标（`SPECIAL_MEMBER_ICONS` 常量，见代码骨架），图标前景色使用 `text-primary-foreground`，在表格成员摘要列和成员编辑面板中**同时复用**：
    - `企业全员`（`allEmployees`）：`Building` 图标（lucide-react）
    - `互联网公开`（`public`）：`Globe` 图标（lucide-react）
    - `应用开发者`（`presetGroup.isContainsAdmin`）：`Users` 图标（lucide-react）
@@ -229,19 +229,14 @@ const SPECIAL_MEMBER_ICONS = {
 // RoleManagementPage.tsx 骨架
 import { useState, useEffect } from 'react';
 import { Table, type TableProps } from '@lark-apaas/client-toolkit/antd-table';
+// 妙搭业务组件（UserSelect / DepartmentSelect / ChatSelect 及其 Tag、胶囊）的 import 路径
+// 以 get_ui_component_info 返回的 docs 为准，安装后按 docs 补齐，勿凭记忆写死路径
 import { Button } from '@client/src/components/ui/button';
 import { Badge } from '@client/src/components/ui/badge';
 import { Switch } from '@client/src/components/ui/switch';
 import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter } from '@client/src/components/ui/dialog';
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from '@client/src/components/ui/dropdown-menu';
 import { HoverCard, HoverCardContent, HoverCardTrigger } from '@client/src/components/ui/hover-card';
-import { UserSelectTag } from '@client/src/components/business-ui/user-select/user-select-tag';
-import { DepartmentSelectTag } from '@client/src/components/business-ui/department-select/department-select-tag';
-import { ChatSelectTag } from '@client/src/components/business-ui/chat-select/chat-select-tag';
-import { ItemPill } from '@client/src/components/business-ui/entity-combobox/item-pill';
-import { UserSelect } from '@client/src/components/business-ui/user-select';
-import { DepartmentSelect } from '@client/src/components/business-ui/department-select';
-import { ChatSelect } from '@client/src/components/business-ui/chat-select';
 import type { ForceRoleDTO } from '@shared/api.interface';
 
 export default function RoleManagementPage() {

package/steering/nestjs-react-fullstack/skills/client-builtins-user-service/SKILL.md

@@ -224,7 +224,16 @@ const MyComponent = () => {
 
 ## 用户展示与选择方案
 
-{% if projectMeta['flags']['supportBusinessUser'] %}
+{% if projectMeta['flags']['businessUiFromMarket'] %}
+用户展示 / 选择使用组件市场的妙搭业务组件，项目内默认未安装。使用前必须先调用 get_ui_component_info(["@miaoda/<name>"]) 安装并阅读返回的 docs，Props / import 路径以 docs 为准：
+
+- @miaoda/user-select 用户选择组件
+- @miaoda/department-select 部门选择组件
+- @miaoda/user-display 用户展示组件：展示任意用户时传 `value`（用户 ID 字符串或字符串数组）；**不要**传 `users`。
+
+列表、详情、卡片等任意位置展示一个或多个用户 ID，都使用 @miaoda/user-display，不要退回到直接渲染、拼接或 `join` 用户 ID 文本。
+
+{% elif projectMeta['flags']['supportBusinessUser'] %}
 这些组件在使用之前必须读取 client/src/components/business-ui/README.md 文件来理解用法，并以该 README 与本地源码为准。
 
 目前可用的组件有：
@@ -316,7 +325,7 @@ const form = useForm<z.infer<typeof formSchema>>({
 - **组件路径**：`@lark-apaas/client-toolkit/components/User`
 - **功能**：用于所有用户信息的展示场景
 - **特性**：显示用户**头像**和**姓名**，支持多用户展示
-- **边界**：本节仅适用于 `@lark-apaas/client-toolkit/components/User`。如果当前项目启用了本地 `@/components/business-ui/user-display`，必须按上方 business-ui 分支读取 README 并使用 `value` / `userId` / `user_id`，不要把这里的 `users` 参数迁移过去。
+- **边界**：本节仅适用于 `@lark-apaas/client-toolkit/components/User`。如果当前项目使用本地 `business-ui/user-display` 或市场组件 `@miaoda/user-display`，必须按其 README / docs 使用 `value` / `userId` / `user_id`，不要把这里的 `users` 参数迁移过去。
 
 ### 属性定义
 

package/steering/nestjs-react-fullstack/skills/coding-guide/SKILL.md

@@ -18,7 +18,8 @@ unavailable-agents:
 - `client/src/index.tsx`
 - `client/index.html`
 - `client/src/app.tsx`（加路由 / Provider 可改，但**禁止删除其中的平台根组件 / Provider 包裹**，禁止用 `eslint-disable` 关掉平台校验规则）
-- `client/src/components/business-ui/*`
+- `client/src/components/business-ui/*`（预置的业务组件，仅旧版模板存在）
+- `client/src/components/miaoda/*`（组件市场装机产物，装完不要改写）
 - `server/modules/view/view.controller.ts`
 - `vite.config.ts`
 
@@ -89,7 +90,9 @@ client/
 │   ├── components/        # 可复用的 UI 组件
 │   │   ├── ui/            # shadcn/ui 组件[Use the components for functionality, but heavily style them.]
 │   │   │   ├── README.md      # shadcn/ui 组件库使用说明 [请务必参考该文档进行组件使用]
-{% if projectMeta['flags']['supportBusinessUser'] %}
+{% if projectMeta['flags']['businessUiFromMarket'] %}
+│   │   ├── miaoda/            # 组件市场装机的妙搭业务组件（初始不存在，按需安装，见「妙搭业务组件」一节）
+{% elif projectMeta['flags']['supportBusinessUser'] %}
 │   │   ├── business-ui/            # 封装好的用户，部门选择组件以及展示组件
 │   │   │   ├── README.md      # 用户展示，用户头像展示，部门选择展示逻辑必须使用 [请务必参考该文档进行组件使用]，禁止直接使用avatar组件等方式自行实现
 {% endif %}
@@ -155,9 +158,8 @@ shared/ # 前后端共享的目录
 
 ## 依赖使用规范
 
-1. **子包完整性检查**：部分库有多个子包（如 `@dnd-kit/core` + `@dnd-kit/sortable` + `@dnd-kit/utilities`），添加 import 后必须确认 package.json 中包含所有需要的子包
-2. **禁止安装时需现场编译的 native addon**（`node-gyp rebuild`、`binding.gyp`、需要系统头文件或编译器）。依赖按平台内置能力 / 浏览器能力 → 纯 JS 或 WASM → 有预编译二进制的 native addon 的顺序选型
-3. 用法不清时查看 readme，可进一步搜索或网页访问获取信息
+1. **子包完整性检查**：部分库有多个子包（如 `@radix-ui/react-*` 系列每个组件都是独立子包），添加 import 后必须确认 package.json 中包含所有需要的子包
+2. 用法不清时查看 readme，可进一步搜索或网页访问获取信息
 
 ## 文件命名约定
 
@@ -234,7 +236,6 @@ shared/ # 前后端共享的目录
 - **能力边界**：服务端不支持文件上传（FaaS 限制），前端用 dataloom SDK 上传，服务端仅保存元信息
 - **环境判断**：`process.env.NODE_ENV === "production"` 表示生产环境
 - **文件系统**：临时文件、下载内容和处理中间产物统一写入 `/tmp` 下的独立目录，用完后清理
-- **启动关键路径**：`bootstrap`、`onModuleInit` 和 `OnApplicationBootstrap` 只做必须的同步装配，不得执行 DDL、全量数据同步、长轮询或无界外部请求。应用应尽早 `listen()`；非关键预热放到后台任务，外部调用必须有超时、错误日志和降级路径
 - **服务端运行时资源文件**（字体 / 证书 / 模板 / wasm 等需在运行时读取的非代码文件，CRITICAL — 发布后静默失效根因）：① 必须在 `nest-cli.json` 的 `assets` 中声明（如 `{"include": "assets/<dir>/**/*", "outDir": "dist/server"}`），否则不会进 `dist/` 构建产物；② 路径用 `__dirname` 相对**编译产物**定位（如 `path.join(__dirname, "../assets/...")`），**禁止 `process.cwd()` 相对源码路径**——dev 跑源码能命中、发布跑 `dist/` 会落空；③ 资源缺失或加载失败必须 **fail-loud**（抛错或明确错误日志），禁止 `catch` 后静默返回残缺产物
 - **启动生命周期**：`constructor`、`onModuleInit` 和 `onApplicationBootstrap` 应快速完成，避免在其中下载大文件、全量同步或批量迁移；仅将钩子声明为 `async` 仍会被等待，无法缩短启动时间
 
@@ -477,13 +478,10 @@ await db.select().from(users).where(eq(users.adminUser, userId));
 
 - **必须从 `req.userContext` 获取**，禁止从前端传递，禁止硬编码（`const { userId } = req.userContext`）
 - 依赖用户信息的接口不要用 API 测试工具测试，用 `think` 工具思考
-- 后端按 `user-identity` 和 `@lark-apaas/fullstack-nestjs-core` 的 Express `Request` 增强读取 `req.userContext`；`tenantId` 为可选 number，不能套用前端 `window.tenantId` / `viewContext` 字符串语义。
-- Controller 直接用 `@Req() req: Request`；测试、mock 或业务窄类型用独立接口，只声明实际读取字段。不要继承 Express `Request` 或重声明 `userContext`；未读 `tenantId` 就省略，必须保留时用 `unknown` 或 SDK 兼容类型。
 
 ```typescript
-// req.userContext 字段（由身份认证中间件挂载，完整合同见 user-identity）：
-// - userId/appId: string
-// - tenantId: SDK Request.userContext 的可选 number
+// req.userContext 字段（由身份认证中间件挂载）：
+// - userId/tenantId/appId: string
 // - env: 'preview' | 'runtime'  (preview=预览态, runtime=发布运行态)
 // - userName/userNameEn: string
 // - userNameI18n: string  (多语名字, 如 {zh_cn: '用户', en_us: 'user'})
@@ -575,12 +573,15 @@ async createArticle(@Req() req: Request, @Body() dto: CreateArticleDto) {
 - **图表**: ReactECharts，**开发前必须调用 `/charts-skill`**
 - **图标**: Lucide React（唯一图标库，禁止 Emoji 和其他图标库）
 - **表格/表单/图表**: 见下方"组件 Skill 召回规则"，开发前必须先调用对应 Skill
-{% if projectMeta['flags']['supportBusinessUser'] %}
+{% if projectMeta['flags']['businessUiFromMarket'] %}
+- **用户**: 用户信息展示/选择必须使用组件市场的妙搭业务组件（见「妙搭业务组件」一节，先安装后使用），禁止手写选人/头像组件、禁止直接展示 userId
+{% elif projectMeta['flags']['supportBusinessUser'] %}
 - **用户**: 用户信息展示/选择必须用 `business-ui` 组件（阅读 README.md），禁止直接展示 userId
 {% endif %}
 {% if projectMeta['flags']['supportTiptapAndStreamdown'] %}
-- **富文本**: `business-ui/tiptap-editor`（阅读 README.md）
 - **Markdown 渲染**: `components/ui/streamdown`（内置 prose 排版）
+{% else %}
+- **Markdown 渲染**: `components/ui/markdown`（react-markdown + remark-gfm，内置 prose 排版）
 {% endif %}
 
 ## API 请求
@@ -612,12 +613,34 @@ import { axiosForBackend } from '@lark-apaas/client-toolkit/utils/getAxiosForBac
 | 组件 | 来源 | 用途 |
 |------|------|------|
 | Table | `@lark-apaas/client-toolkit/antd-table` | 数据表格，**先调 `/table-skill`** |
-{% if projectMeta['flags']['supportBusinessUser'] %}
+{% if projectMeta['flags']['supportBusinessUser'] and not projectMeta['flags']['businessUiFromMarket'] %}
 | UserSelect/UserDisplay/UserProfile/DepartmentSelect | `business-ui/*` | 用户/部门选择展示 |
 {% endif %}
 {% if projectMeta['flags']['supportTiptapAndStreamdown'] %}
-| TiptapEditorComplete | `business-ui/tiptap-editor` | 富文本编辑器 |
 | Streamdown | `components/ui/streamdown` | Markdown/流式渲染 |
+{% else %}
+| Markdown | `components/ui/markdown` | Markdown 渲染（react-markdown + remark-gfm） |
+{% endif %}
+
+{% if projectMeta['flags']['businessUiFromMarket'] %}
+### 妙搭业务组件（组件市场，强制使用）
+
+企业用户 / 组织类组件已上架组件市场，项目内**默认未安装**。命中以下场景时禁止手写等价组件，必须先安装后使用：
+
+| 组件 ID | 用途 |
+|---------|------|
+| @miaoda/user-select | 用户选择器（搜索 / 单多选 / 外部联系人）——选人、成员、指派、审批人等场景 |
+| @miaoda/department-select | 部门选择器——组织架构场景 |
+| @miaoda/chat-select | 群组（群聊）选择器 |
+| @miaoda/user-display | 用户头像 + 姓名展示（传用户 ID 自动拉取资料）——任何展示用户的场景 |
+| @miaoda/user-profile | 用户详情卡（hover 弹出完整资料） |
+
+**强制流程**：
+
+1. 编码前调用 get_ui_component_info(["@miaoda/user-select", ...]) 一次性安装本轮所需的全部组件（依赖会自动递归安装）
+2. Props / import 路径 / Provider 前置 100% 以工具返回的 docs 为准，禁止凭记忆猜测
+3. 组件源码安装在 client/src/components/miaoda/，不要移动或改写
+4. 工具返回 Component not found 时，告知用户该组件未上架，不要手写等价实现
 {% endif %}
 
 ### 组件 Skill 召回规则（强制执行）
@@ -747,7 +770,9 @@ return <h1>{data?.title || '未知标题'}</h1>;
 ## 图片规范
 
 - **展示**：必须用 `@client/src/components/ui/image` 组件（非原生 `<img>`），响应式设 `sizes`，固定宽设 `width`
-{% if projectMeta['flags']['supportBusinessUser'] %}
+{% if projectMeta['flags']['businessUiFromMarket'] %}
+- 用户头像用市场组件 @miaoda/user-display（见「妙搭业务组件」一节）
+{% elif projectMeta['flags']['supportBusinessUser'] %}
 - 用户头像用 business-ui 组件
 {% endif %}
 
@@ -781,15 +806,12 @@ return <h1>{data?.title || '未知标题'}</h1>;
 | 验证 | zod |
 | 工具函数 | lodash |
 | 样式 | clsx |
-| Excel | xlsx（**仅前端实现，禁止服务端实现**。解析后将结构化数据传到服务端保存） |
-| PDF 导出 | jspdf + html2canvas（**仅前端实现，禁止服务端实现**） |
-| 文件上传 | react-dropzone |
-| 二维码 | qrcode.react |
+| 文件上传 | 原生 `<input type="file">`，用 shadcn 组件封装样式 |
 | 用户反馈 | sonner |
-| 拖拽 | @dnd-kit/core |
-| 数字动画 | react-countup |
-| Base64 | js-base64 — `import { encode, decode } from 'js-base64'` |
-| 3D 场景 | cobe |
+| 数字动画 | `requestAnimationFrame` 手写，或 framer-motion 的 `animate` |
+| Base64 | 原生 `atob`/`btoa`（Unicode 内容先经 `TextEncoder`/`TextDecoder`）；服务端用 `Buffer` |
+
+> Excel 解析、PDF 导出、二维码、拖拽、3D 场景等能力已随依赖瘦身不再预装（xlsx、jspdf、html2canvas、qrcode.react、@dnd-kit、react-dropzone、react-countup、js-base64、cobe 已从模板移除）。确有此类需求时，先在 package.json 显式添加所需依赖并安装，再编写代码。
 
 ## 滚动分页最佳实践
 

package/steering/nestjs-react-fullstack/skills/plugin-guide/references/table.md

@@ -326,12 +326,12 @@ const chartData =
 | `Progress`                   | `${value}%` 或进度条                                                 | `<Input type="number" min={0} max={100} />` |
 | `Rating`                     | `'★'.repeat(value) + '☆'.repeat(5-value)`                            | `<Input type="number" min={0} max={5} />`   |
 
-BizType 为 `User` 的字段展示必须使用 business-ui `UserDisplay`；不要直接渲染、拼接或 `join` 用户 ID 文本。
+BizType 为 `User` 的字段展示必须使用组件市场的 `@miaoda/user-display`（先 get_ui_component_info 安装）；不要直接渲染、拼接或 `join` 用户 ID 文本。
 
 ### 组件代码示例
 
 ```tsx
-// 人员展示（business-ui UserDisplay 使用 value；不要传 users）
+// 人员展示（市场组件 @miaoda/user-display 使用 value；不要传 users）
 <UserDisplay
   value={record['人员字段']?.map(userId => userId.toString()) || []}
   size="small"
@@ -381,7 +381,7 @@ BizType 为 `User` 的字段展示必须使用 business-ui `UserDisplay`；不
 const columns = [
   // 文本字段 - 注意读取格式是 { text: string }
   { title: '文本', dataIndex: ['record', '文本字段', 'text'], key: 'text' },
-  // 人员字段 - 使用 business-ui UserDisplay 组件，传 value（用户 ID 字符串数组），不要传 users
+  // 人员字段 - 使用市场组件 @miaoda/user-display，传 value（用户 ID 字符串数组），不要传 users
   {
     title: '负责人',
     key: 'user',

package/steering/nestjs-react-fullstack/skills_common/user-identity/SKILL.md

@@ -93,14 +93,12 @@ match-template-name: nestjs-react-fullstack
 
 > 完整的解析→守卫流程见 `authn-guide` skill 第二节"认证流程"。
 
-类型使用规则：Controller 直接用 `@Req() req: Request` 读取 SDK 增强的 `req.userContext`。测试、mock 或局部业务需要窄类型时，定义独立接口，只声明实际读取字段；不要继承 Express `Request`，也不要重声明平台增强的 `userContext`。未读取的 `tenantId` 省略；必须保留时用 `unknown` 或 SDK 兼容类型。
-
 ### 字段表
 
 | 字段 | 类型 | 说明 |
 |------|------|------|
 | `userId` | `string` | 妙搭用户 ID |
-| `tenantId` | `number \| undefined` | 租户 ID；按 SDK Express `Request.userContext` 增强：可选 number |
+| `tenantId` | `number` | 租户 ID |
 | `appId` | `string` | 应用 ID |
 | `loginUrl` | `string` | 登录跳转 URL |
 | `userType` | `string` | 用户类型（如 `_employee`） |

package/steering/nestjs-react-fullstack/skills_local/authz-guide/references/management-page-spec.md

@@ -16,7 +16,7 @@ Step 0: 制定实施计划（强制，禁止跳过）
 
 Step 1: 编码前确认（闸门）
   ├─ 确认 SDK 方法签名：读取 sdk-types.md，摘录 roles / members / search 的出入参
-  ├─ 确认搜索组件目录存在：client/src/components/business-ui/ 下包含 user-select、department-select、chat-select 目录
+  ├─ 先按「妙搭业务组件」一节调用 get_ui_component_info(["@miaoda/user-select", "@miaoda/department-select", "@miaoda/chat-select"]) 安装组件（装机路径 client/src/components/miaoda/）
   └─ 确认 Tag 胶囊组件存在：上述目录中分别包含 user-select-tag、department-select-tag、chat-select-tag 文件
 
   ⛔ 以上任一不存在，停止实现并报告
@@ -63,7 +63,7 @@ Step 5: 验证
 
 按以下优先级顺序拼接展示，无任何内容时显示 `--`：
 
-1. **特殊范围胶囊**：使用 `ItemPill` 组件（`business-ui/entity-combobox/item-pill`）展示，每项带**品牌色**（`bg-primary`，跟随 CSS 变量 `--primary`，默认蓝色）圆底 20px 图标（`SPECIAL_MEMBER_ICONS` 常量，见代码骨架），图标前景色使用 `text-primary-foreground`，在表格成员摘要列和成员编辑面板中**同时复用**：
+1. **特殊范围胶囊**：使用市场组件返回的胶囊/Tag 展示（import 路径与 Props 以 get_ui_component_info 返回的 docs 为准），每项带**品牌色**（`bg-primary`，跟随 CSS 变量 `--primary`，默认蓝色）圆底 20px 图标（`SPECIAL_MEMBER_ICONS` 常量，见代码骨架），图标前景色使用 `text-primary-foreground`，在表格成员摘要列和成员编辑面板中**同时复用**：
    - `企业全员`（`allEmployees`）：`Building` 图标（lucide-react）
    - `互联网公开`（`public`）：`Globe` 图标（lucide-react）
    - `应用开发者`（`presetGroup.isContainsAdmin`）：`Users` 图标（lucide-react）
@@ -229,19 +229,14 @@ const SPECIAL_MEMBER_ICONS = {
 // RoleManagementPage.tsx 骨架
 import { useState, useEffect } from 'react';
 import { Table, type TableProps } from '@lark-apaas/client-toolkit/antd-table';
+// 妙搭业务组件（UserSelect / DepartmentSelect / ChatSelect 及其 Tag、胶囊）的 import 路径
+// 以 get_ui_component_info 返回的 docs 为准，安装后按 docs 补齐，勿凭记忆写死路径
 import { Button } from '@client/src/components/ui/button';
 import { Badge } from '@client/src/components/ui/badge';
 import { Switch } from '@client/src/components/ui/switch';
 import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter } from '@client/src/components/ui/dialog';
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from '@client/src/components/ui/dropdown-menu';
 import { HoverCard, HoverCardContent, HoverCardTrigger } from '@client/src/components/ui/hover-card';
-import { UserSelectTag } from '@client/src/components/business-ui/user-select/user-select-tag';
-import { DepartmentSelectTag } from '@client/src/components/business-ui/department-select/department-select-tag';
-import { ChatSelectTag } from '@client/src/components/business-ui/chat-select/chat-select-tag';
-import { ItemPill } from '@client/src/components/business-ui/entity-combobox/item-pill';
-import { UserSelect } from '@client/src/components/business-ui/user-select';
-import { DepartmentSelect } from '@client/src/components/business-ui/department-select';
-import { ChatSelect } from '@client/src/components/business-ui/chat-select';
 import type { ForceRoleDTO } from '@shared/api.interface';
 
 export default function RoleManagementPage() {

package/steering/nestjs-react-fullstack/skills_local/client-builtins-user-service/SKILL.md

@@ -224,13 +224,14 @@ const MyComponent = () => {
 
 ## 用户展示与选择方案
 
-这些组件在使用之前必须读取 client/src/components/business-ui/README.md文件来理解用法
+按项目形态二选一：项目里已有 `client/src/components/business-ui/` 预置目录时，直接使用预置组件（读取该目录 README.md，UserDisplay 传 `value` / `userId`，不传 `users`）；没有该目录时走组件市场——使用前必须先安装（有 get_ui_component_info 工具时调用它，否则 `fullstack-cli component add @miaoda/<name>`）并阅读返回的 docs，Props / import 路径以 docs 为准：
 
-目前可用的组件有：
+- @miaoda/user-select 用户选择组件
+- @miaoda/department-select 部门选择组件
+- @miaoda/user-display 用户展示组件：展示任意用户时传 `value`（用户 ID 字符串或字符串数组）；**不要**传 `users`。
+
+列表、详情、卡片等任意位置展示一个或多个用户 ID，都使用 @miaoda/user-display，不要退回到直接渲染、拼接或 `join` 用户 ID 文本。
 
-- UserSelect 用户选择组件（@/components/business-ui/user-select）
-- DepartmentSelect 部门选择组件（@/components/business-ui/department-select）
-- UserDisplay - 用户展示组件（@/components/business-ui/user-display）
 
 ## 使用注意事项
 

package/steering/nestjs-react-fullstack/skills_local/coding-guide/SKILL.md

@@ -64,8 +64,7 @@ client/
 │   ├── components/        # 可复用的 UI 组件
 │   │   ├── ui/            # shadcn/ui 组件[Use the components for functionality, but heavily style them.]
 │   │   │   ├── README.md      # shadcn/ui 组件库使用说明 [请务必参考该文档进行组件使用]
-│   │   ├── business-ui/            # 封装好的用户，部门选择组件以及展示组件
-│   │   │   ├── README.md      # 用户展示，用户头像展示，部门选择展示逻辑必须使用 [请务必参考该文档进行组件使用]，禁止直接使用avatar组件等方式自行实现
+│   │   ├── miaoda/            # 组件市场装机的妙搭业务组件（新版模板，初始不存在按需安装；旧版模板此处为 business-ui/ 预置目录）
 │   │   ├── Layout.tsx     # 布局包装器
 │   ├── hooks/             # 自定义 React hooks
 │   └── utils/             # 工具函数
@@ -129,7 +128,7 @@ shared/ # 前后端共享的目录
 
 1. 优先使用项目已有依赖，仅在无法实现时安装新依赖
 2. 使用前先查看 `package.json` 确保依赖已存在
-3. **子包完整性检查**：部分库有多个子包（如 `@dnd-kit/core` + `@dnd-kit/sortable` + `@dnd-kit/utilities`），添加 import 后必须确认 package.json 中包含所有需要的子包
+3. **子包完整性检查**：部分库有多个子包（如 `@radix-ui/react-*` 系列每个组件都是独立子包），添加 import 后必须确认 package.json 中包含所有需要的子包
 4. 用法不清时查看 readme，可进一步搜索或网页访问获取信息
 
 ## 文件命名约定
@@ -335,13 +334,10 @@ await db.select().from(users).where(eq(users.adminUser, userId));
 
 - **必须从 `req.userContext` 获取**，禁止从前端传递，禁止硬编码
 - 依赖用户信息的接口不要用 API 测试工具测试，用 `think` 工具思考
-- 后端按 `user-identity` 和 `@lark-apaas/fullstack-nestjs-core` 的 Express `Request` 增强读取 `req.userContext`；`tenantId` 为可选 number，不能套用前端 `window.tenantId` / `viewContext` 字符串语义。
-- Controller 直接用 `@Req() req: Request`；测试、mock 或业务窄类型用独立接口，只声明实际读取字段。不要继承 Express `Request` 或重声明 `userContext`；未读 `tenantId` 就省略，必须保留时用 `unknown` 或 SDK 兼容类型。
 
 ```typescript
-// req.userContext 字段（由身份认证中间件挂载，完整合同见 user-identity）：
-// - userId/appId: string
-// - tenantId: SDK Request.userContext 的可选 number
+// req.userContext 字段（由身份认证中间件挂载）：
+// - userId/tenantId/appId: string
 // - env: 'preview' | 'runtime'  (preview=预览态, runtime=发布运行态)
 // - userName/userNameEn: string
 // - userNameI18n: string  (多语名字, 如 {zh_cn: '用户', en_us: 'user'})
@@ -452,14 +448,13 @@ NestJS 自己不读 env。直连 NestJS 端口 → header 缺失 → `req.userCo
 
 - **框架**: React 19 + TypeScript
 - **路由**: React Router DOM v6
-- **样式**: styled-jsx + tailwindcss（语义化 token）。styled-jsx 使用前提见下方"样式开发"
+- **样式**: tailwindcss（语义化 token）为主，复杂 CSS 用 CSS Modules（`*.module.css`），动态计算值用行内 `style`
 - **UI 组件库**: shadcn/ui — Use components for functionality, heavily style them
 - **图表**: ReactECharts，**开发前必须调用 `/charts-skill`**
 - **图标**: Lucide React（唯一图标库，禁止 Emoji 和其他图标库）
 - **表格/表单/图表**: 见下方"组件 Skill 召回规则"，开发前必须先调用对应 Skill
-- **用户**: 用户信息展示/选择必须用 `business-ui` 组件（阅读 README.md），禁止直接展示 userId
-- **富文本**: `business-ui/tiptap-editor`（阅读 README.md）
-- **Markdown 渲染**: `components/ui/streamdown`（内置 prose 排版）
+- **用户**: 用户信息展示/选择必须用平台业务组件——项目里已有 `client/src/components/business-ui/` 时直接使用它（阅读其 README.md）；没有该目录时从组件市场安装（见「妙搭业务组件」一节）。禁止手写选人/头像组件、禁止直接展示 userId
+- **Markdown 渲染**: `components/ui/markdown`（react-markdown + remark-gfm，内置 prose 排版）
 
 ## API 请求
 
@@ -491,9 +486,28 @@ import { axiosForBackend } from '@lark-apaas/client-toolkit/utils/getAxiosForBac
 | 组件                                                | 来源                                    | 用途                              |
 | --------------------------------------------------- | --------------------------------------- | --------------------------------- |
 | Table                                               | `@lark-apaas/client-toolkit/antd-table` | 数据表格，**先调 `/table-skill`** |
-| UserSelect/UserDisplay/UserProfile/DepartmentSelect | `business-ui/*`                         | 用户/部门选择展示                 |
-| TiptapEditorComplete                                | `business-ui/tiptap-editor`             | 富文本编辑器                      |
-| Streamdown                                          | `components/ui/streamdown`              | Markdown/流式渲染                 |
+| Markdown                                            | `components/ui/markdown`                | Markdown 渲染（react-markdown + remark-gfm） |
+
+### 妙搭业务组件（组件市场，强制使用）
+
+> 本节适用于项目内**没有** `client/src/components/business-ui/` 预置目录的新版模板；有预置目录时直接使用预置组件，不走市场安装。
+
+企业用户 / 组织类组件已上架组件市场，项目内**默认未安装**。命中以下场景时禁止手写等价组件，必须先安装后使用：
+
+| 组件 ID | 用途 |
+|---------|------|
+| @miaoda/user-select | 用户选择器（搜索 / 单多选 / 外部联系人）——选人、成员、指派、审批人等场景 |
+| @miaoda/department-select | 部门选择器——组织架构场景 |
+| @miaoda/chat-select | 群组（群聊）选择器 |
+| @miaoda/user-display | 用户头像 + 姓名展示（传用户 ID 自动拉取资料）——任何展示用户的场景 |
+| @miaoda/user-profile | 用户详情卡（hover 弹出完整资料） |
+
+**强制流程**：
+
+1. 编码前一次性安装本轮所需的全部组件：有 get_ui_component_info 工具时调用它（componentIds 传上表 ID）；无该工具时执行 `fullstack-cli component add @miaoda/<name>`
+2. Props / import 路径 / Provider 前置 100% 以安装返回的 docs 为准，禁止凭记忆猜测
+3. 组件源码安装在 client/src/components/miaoda/，不要移动或改写
+4. 返回 Component not found 时，告知用户该组件未上架，不要手写等价实现
 
 ### 组件 Skill 召回规则（强制执行）
 
@@ -544,7 +558,7 @@ import { axiosForBackend } from '@lark-apaas/client-toolkit/utils/getAxiosForBac
 ```
 需要写样式？
 ├─ 基础布局/间距/颜色 → Tailwind ✅
-├─ 复杂动画/伪元素/高级CSS → styled-jsx ✅
+├─ 复杂动画/伪元素/高级CSS → CSS Modules（`*.module.css`）✅
 └─ JS动态计算值 → 行内 style ✅
 ```
 
@@ -557,10 +571,6 @@ import { axiosForBackend } from '@lark-apaas/client-toolkit/utils/getAxiosForBac
 - **arbitrary values 中空格用下划线**：`from-[hsl(215_60%_18%)]` 非 `from-[hsl(215 60% 18%)]`
 - `tailwind-theme.css` 自定义属性用 `hsl(H, S%, L%)` 格式（非 `23 10% 23%`）
 
-### styled-jsx 规范
-
-- **技术栈一致性**：仅在已配置 styled-jsx 插件的项目中使用。`package.json` 无 `styled-jsx` 依赖则**禁用**，否则运行时 SyntaxError
-- **禁止动态插值**：`<style jsx>` 内禁止 `${...}` 等表达式（会卡死）。动态值放 CSS 变量，用 `var(--xxx)` 引用
 
 ### 布局/排版
 
@@ -623,7 +633,7 @@ return <h1>{data?.title || '未知标题'}</h1>;
 ## 图片规范
 
 - **展示**：必须用 `@client/src/components/ui/image` 组件（非原生 `<img>`），响应式设 `sizes`，固定宽设 `width`
-- 用户头像用 business-ui 组件
+- 用户头像用平台业务组件（预置 business-ui 的 UserDisplay，或市场 @miaoda/user-display）
 
 ### 图片资源优先级
 
@@ -644,15 +654,12 @@ return <h1>{data?.title || '未知标题'}</h1>;
 | 验证       | zod                                                                      |
 | 工具函数   | lodash                                                                   |
 | 样式       | clsx                                                                     |
-| Excel      | xlsx（**仅前端实现，禁止服务端实现**。解析后将结构化数据传到服务端保存） |
-| PDF 导出   | jspdf + html2canvas（**仅前端实现，禁止服务端实现**）                    |
-| 文件上传   | react-dropzone                                                           |
-| 二维码     | qrcode.react                                                             |
+| 文件上传   | 原生 `<input type="file">`，用 shadcn 组件封装样式                       |
 | 用户反馈   | sonner                                                                   |
-| 拖拽       | @dnd-kit/core                                                            |
-| 数字动画   | react-countup                                                            |
-| Base64     | js-base64 — `import { encode, decode } from 'js-base64'`                 |
-| 3D 场景    | cobe                                                                     |
+| 数字动画   | `requestAnimationFrame` 手写，或 framer-motion 的 `animate`              |
+| Base64     | 原生 `atob`/`btoa`（Unicode 内容先经 `TextEncoder`/`TextDecoder`）；服务端用 `Buffer` |
+
+> Excel 解析、PDF 导出、二维码、拖拽、3D 场景等能力已随依赖瘦身不再预装（xlsx、jspdf、html2canvas、qrcode.react、@dnd-kit、react-dropzone、react-countup、js-base64、cobe 已从模板移除）。确有此类需求时，先在 package.json 显式添加所需依赖并安装，再编写代码。
 
 ## 滚动分页最佳实践