其他组件与集成边界

描述列表与树

ProDescriptions 支持列配置、内容 render/renderHTML 与标签 renderLabel，内容插槽按 prop、标签按 ${prop}-label。同一字段只采用实际渲染分支，不应同时依赖多个回调的副作用。TSX 用 lang="tsx"；HTML 仅用于可信或已净化内容。

直接传入 data 时，编辑结果通过 formChange 同步回业务数据；使用组件请求路径时按公开事件及数据模型协调。函数式入口为 useProDescriptions/createDescriptionsComponent/createDescriptions，实例和销毁责任属于调用方。

TreeFilter 通过 defaultValue 设置初始选择，change 通知选中项；请求数据、字段映射和组件树属性以生成契约为准。默认选择不意味着当前用户具有该节点权限。

图片、上传与文件

ImageViewer 基于 Element Plus 图片查看器，支持组件和函数式打开；调用方提供可信图片 URL 和退出清理。

图片/文件上传按 uid 维护并发任务，同名文件独立保留。外部重置、删除和卸载使旧任务失效；转换响应可以异步，必须完成后再更新模型。文档站图片演示返回本地资源，不能据此判定业务上传接口成功。

MultipleUpload 区分文件、校验与确认提交阶段；本地示例不会产生真实业务写入。UploadExcel 在浏览器解析文件，通过 onSuccess 返回 header/results；大文件性能需另行测量。

内容、权限与主题

SafeHtml 使用 DOMPurify，保留 content/source 契约。文档站 SSR 初始内容为空，客户端挂载后净化输出，绝不在服务端直接回显未净化 HTML。表单标签等其他 HTML 回调仍需单独遵守可信输入边界。

权限组件 的角色和按钮在文档站来自本地演示 Store，不连接真实认证。示例允许展示不代表用户获授生产权限。

主题状态应随文档站亮暗切换同步；图表通过公共主题变量和 ResizeObserver/lifecycle 更新并释放。文档站保留 SSR-only 适配，浏览器端的下载、裁剪、拖拽、编辑器使用实际实现。