@microi.net/cli 6.2.1 → 6.2.3

package/skills/microi-form-engine/references/component-config-index.md

@@ -0,0 +1,359 @@
+# 控件配置源码索引
+
+由 `microi.mcp/scripts/generate-form-component-catalog.mjs` 从全部当前控件、共用配置弹窗及其本地依赖生成。修改控件后重新生成并执行 `--check`。
+
+PC 前端静态配置目录。designerFieldType 是历史设计器默认值，不是服务器允许的建模类型。configPaths 为源码静态路径，动态键、外部 API 语义及跨端支持须查看 sourceFiles 和责任 Skill。defaultConfig 是源码字面量，不是业务推荐值，也不能整体覆盖存量字段。
+
+共 44 类控件、61 个来源文件。决策与验收见 [表单生成质量规则](form-generation-quality.md)。先通过 MCP `microi_get_form_component_catalog` 查询目标控件，避免每次加载全量正文。
+
+## Text（单行文本）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-input.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`ReadOnlyButton`、`ShowButton`、`ShowIcon`、`SlotButtonV8Code`、`TextApend`、`TextApendPosition`、`TextIcon`、`TextIconPosition`、`TextShowPassword`、`V8Code`、`V8CodeBlur`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`ReadOnlyButton`、`ShowButton`、`ShowIcon`、`TextApend`、`TextApendPosition`、`TextIcon`、`TextIconPosition`、`TextShowPassword`。
+
+## Guid（GUID）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-input.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`ReadOnlyButton`、`ShowButton`、`ShowIcon`、`SlotButtonV8Code`、`TextApend`、`TextApendPosition`、`TextIcon`、`TextIconPosition`、`TextShowPassword`、`V8Code`、`V8CodeBlur`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`ReadOnlyButton`、`ShowButton`、`ShowIcon`、`TextApend`、`TextApendPosition`、`TextIcon`、`TextIconPosition`、`TextShowPassword`。
+
+## Textarea（多行文本）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-textarea.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`TextApend`、`TextApendPosition`、`TextIcon`、`TextIconPosition`、`TextShowPassword`、`Textarea`、`Textarea.DefaultRows`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DefaultRows`。
+
+## NumberText（数字输入）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-input-number.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`NumberTextBtn`、`NumberTextBtnPosition`、`NumberTextPrecision`、`NumberTextStep`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`NumberTextBtn`、`NumberTextBtnPosition`、`NumberTextPrecision`、`NumberTextStep`。
+
+## DateTime（日期时间）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-datetime.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`DateTimeType`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DateTimeType`。
+
+## Select（下拉单选）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-select.vue`、`Microi.Client/src/views/form-engine/diy-field-component/field-data-load-fallback.js`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiyDataSourceConfig.vue`。
+
+Config 静态路径：`Api`、`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`EnableSearch`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup`、`Sql`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`EnableSearch`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup === true`、`Sql`、`configForm`。
+
+## MultipleSelect（下拉多选）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-select.vue`、`Microi.Client/src/views/form-engine/diy-field-component/field-data-load-fallback.js`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiyDataSourceConfig.vue`。
+
+Config 静态路径：`Api`、`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`EnableSearch`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup`、`Sql`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`EnableSearch`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup === true`、`Sql`、`configForm`。
+
+## Radio（单选框）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-radio.vue`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiyDataSourceConfig.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`EnableSearch`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup`、`Sql`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`EnableSearch`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup === true`、`Sql`、`configForm`。
+
+## Checkbox（复选框）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-checkbox.vue`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiyDataSourceConfig.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup`、`Sql`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`EnableSearch`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup === true`、`Sql`、`configForm`。
+
+## Switch（开关）
+
+来源：`Microi.Client/src/utils/form-switch-value.js`、`Microi.Client/src/views/form-engine/diy-field-component/diy-switch.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`Switch`、`Switch.ActiveText`、`Switch.Description`、`Switch.DisplayMode`、`Switch.Icon`、`Switch.InactiveText`、`Switch.NullValue`、`Switch.Title`、`Switch.VisualStyle`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`ActiveText`、`Description`、`DisplayMode`、`Icon`、`InactiveText`、`Title`、`VisualStyle`。
+
+## Rate（评分）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-rate.vue`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiySimpleFieldConfigDialog.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`Rate`、`Rate.AllowHalf`、`Rate.Clearable`、`Rate.Max`、`Rate.ScoreTemplate`、`Rate.ShowScore`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`AllowHalf`、`Clearable`、`Max`、`ScoreTemplate`、`ShowScore`。
+
+## Progress（进度条）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-progress.vue`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiySimpleFieldConfigDialog.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`NumberTextBtn`、`NumberTextBtnPosition`、`NumberTextPrecision`、`NumberTextStep`、`Progress`、`Progress.Color`、`Progress.ShowText`、`Progress.Status`、`Progress.StrokeWidth`、`Progress.TextInside`、`Progress.Type`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Color`、`ShowText`、`Status`、`StrokeWidth`、`TextInside`、`Type`。
+
+## Slider（滑块）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-slider.vue`。
+
+Config 静态路径：`Slider`、`Slider.Max`、`Slider.Min`、`Slider.Range`、`Slider.ShowInput`、`Slider.ShowStops`、`Slider.Step`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Max`、`Min`、`Range`、`ShowInput`、`ShowStops`、`Step`。
+
+## ColorPicker（颜色选择）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-colorpicker.vue`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiySimpleFieldConfigDialog.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`ColorPicker`、`ColorPicker.Format`、`ColorPicker.Predefine`、`ColorPicker.ShowAlpha`、`ColorPicker.Size`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Format`、`PredefineText`、`ShowAlpha`、`Size`。
+
+## AutoNumber（自动编号）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-autonumber.vue`。
+
+Config 静态路径：`AutoNumber`、`AutoNumber.CreateRule`、`AutoNumber.DataRule`、`AutoNumberFields`、`AutoNumberFixed`、`AutoNumberLength`、`Button.PreviewCanClick`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`TextApend`、`TextApendPosition`、`TextIcon`、`TextIconPosition`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`AutoNumberFields`、`AutoNumberFixed`、`AutoNumberLength`、`CreateRule`、`DataRule`。
+
+## Button（按钮）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-button.vue`、`Microi.Client/src/views/form-engine/diy-field-component/dos.fontawesome/Fontawesome.vue`。
+
+Config 静态路径：`Button`、`Button.Icon`、`Button.Loading`、`Button.PreviewCanClick`、`Button.RefreshTableAfterClick`、`Button.Size`、`Button.Type`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Button.Icon`、`Button.PreviewCanClick`、`Button.RefreshTableAfterClick`、`Button.Type`。
+
+## Divider（分割线）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-divider.vue`。
+
+Config 静态路径：`Divider`、`Divider.Icon`、`Divider.Tag`、`DividerPosition`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Divider.Icon`、`Divider.Tag`、`DividerPosition`。
+
+## CollapseGroup（折叠分组）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-collapse-group.vue`。
+
+Config 静态路径：`CollapseGroup`、`CollapseGroup.DefaultCollapsed`、`CollapseGroup.Description`、`CollapseGroup.FieldCount`、`CollapseGroup.Icon`、`CollapseGroup.ScopeMode`、`CollapseGroup.ShowFieldCount`、`CollapseGroup.Theme`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DefaultCollapsed`、`Description`、`FieldCount`、`Icon`、`ScopeMode`、`ShowFieldCount`、`Theme`。
+
+## Tabs（页签分组）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-tabs.vue`。
+
+Config 静态路径：`FieldTabs`、`FieldTabs.CaptureRest`、`FieldTabs.DefaultActiveKey`、`FieldTabs.Description`、`FieldTabs.Position`、`FieldTabs.ScopeMode`、`FieldTabs.ShowFieldCount`、`FieldTabs.Stretch`、`FieldTabs.Tabs`、`FieldTabs.Theme`、`FieldTabs.TotalFieldCount`、`FieldTabs.Type`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`CaptureRest`、`DefaultActiveKey`、`Description`、`Position`、`ScopeMode`、`ShowFieldCount`、`Stretch`、`TotalFieldCount`、`Type`。
+
+## Alert（提示说明）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-alert.vue`。
+
+Config 静态路径：`Alert`、`Alert.Content`、`Alert.Effect`、`Alert.ShowIcon`、`Alert.Title`、`Alert.Type`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Content`、`Effect`、`ShowIcon`、`Title`、`Type`。
+
+## StaticText（静态文本）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-statictext.vue`。
+
+Config 静态路径：`StaticText`、`StaticText.Align`、`StaticText.Content`、`StaticText.Theme`、`StaticText.Title`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Align`、`Content`、`Theme`、`Title`。
+
+## Html（HTML内容）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-html.vue`。
+
+Config 静态路径：`Html`、`Html.Content`、`Html.MinHeight`、`Html.Padding`、`Html.UseFieldValue`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Content`、`MinHeight`、`Padding`、`UseFieldValue`。
+
+## RichText（富文本）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-richtext.vue`、`Microi.Client/src/views/form-engine/diy-field-component/richtext-assets.js`。
+
+Config 静态路径：`RichText`、`RichText.EditorProduct`、`RichText.File`、`RichText.File.Accept`、`RichText.File.Enabled`、`RichText.File.MaxCount`、`RichText.File.MaxSize`、`RichText.Image`、`RichText.Image.CompressMaxSize`、`RichText.Image.CompressMaxWidth`、`RichText.Image.Enabled`、`RichText.Image.MaxCount`、`RichText.Image.MaxSize`、`RichText.Image.Preview`、`RichText.Limit`、`RichText.Video`、`RichText.Video.Enabled`、`RichText.Video.MaxCount`、`RichText.Video.MaxSize`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`File.Accept`、`File.Enabled`、`File.MaxCount`、`File.MaxSize`、`Image.CompressMaxSize`、`Image.CompressMaxWidth`、`Image.Enabled`、`Image.MaxCount`、`Image.MaxSize`、`Image.Preview`、`Limit`、`Video.Enabled`、`Video.MaxCount`、`Video.MaxSize`。
+
+## CodeEditor（代码编辑器）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/AiChatPanel.vue`、`Microi.Client/src/views/form-engine/diy-field-component/diy-code-editor.vue`。
+
+Config 静态路径：`CodeEditor`、`CodeEditor.ButtonText`、`CodeEditor.DisplayMode`、`CodeEditor.Height`、`CodeEditor.Language`、`CodeEditor.V8CodeType`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`ButtonText`、`DisplayMode`、`Height`、`Language`、`V8CodeType`。
+
+## JsonTable（JSON表格）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-jsontable.vue`、`Microi.Client/src/views/form-engine/diy-field-component/json-table-column-field-runtime.js`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiyDataSourceConfig.vue`。
+
+Config 静态路径：`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`JsonTable`、`JsonTable.ApiEngineKey`、`JsonTable.Columns`、`JsonTable.DataSource`、`JsonTable.DataSourceId`、`JsonTable.DataSourceSqlRemote`、`JsonTable.KeyValueList`、`JsonTable.SelectLabel`、`JsonTable.Sql`、`SelectLabel`、`Sql`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`EnableSearch`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup === true`、`Sql`。
+
+## ImgUpload（图片上传）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-image-crop-dialog.vue`、`Microi.Client/src/views/form-engine/diy-field-component/diy-imgupload.vue`、`Microi.Client/src/views/form-engine/diy-field-component/diy-upload-compact-summary.vue`、`Microi.Client/src/views/form-engine/diy-field-component/image-crop-config.js`。
+
+Config 静态路径：`ImgUpload`、`ImgUpload.Crop`、`ImgUpload.Crop.AllowFlip`、`ImgUpload.Crop.AllowRotate`、`ImgUpload.Crop.AllowZoom`、`ImgUpload.Crop.CustomHeight`、`ImgUpload.Crop.CustomWidth`、`ImgUpload.Crop.Enabled`、`ImgUpload.Crop.Mode`、`ImgUpload.Crop.Ratio`、`ImgUpload.Limit`、`ImgUpload.MaxCount`、`ImgUpload.MaxSize`、`ImgUpload.Multiple`、`ImgUpload.Preview`、`ImgUpload.SaveFullPath`、`ImgUpload.ShowFileList`、`ImgUpload.Tips`、`Upload`、`Upload.BeforeUploadV8`、`Upload.UploadSuccessV8`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Crop.AllowFlip`、`Crop.AllowRotate`、`Crop.AllowZoom`、`Crop.CustomHeight`、`Crop.CustomWidth`、`Crop.Enabled`、`Crop.Mode`、`Crop.Ratio`、`Limit`、`MaxCount`、`MaxSize`、`Multiple`、`Preview`、`SaveFullPath`、`Tips`。
+
+## FileUpload（文件上传）
+
+来源：`Microi.Client/src/utils/file-role-permission.js`、`Microi.Client/src/views/form-engine/diy-field-component/diy-file-download-dialog.vue`、`Microi.Client/src/views/form-engine/diy-field-component/diy-file-role-tags.vue`、`Microi.Client/src/views/form-engine/diy-field-component/diy-fileupload.vue`、`Microi.Client/src/views/form-engine/diy-field-component/diy-upload-compact-summary.vue`。
+
+Config 静态路径：`FileUpload`、`FileUpload.AllowOfficeEdit`、`FileUpload.ConfigurableRoleIds`、`FileUpload.DisableRoleInheritance`、`FileUpload.EnableOfficePreview`、`FileUpload.EnableOfficeVersion`、`FileUpload.EnableRolePermission`、`FileUpload.HideUnauthorizedFiles`、`FileUpload.Limit`、`FileUpload.MaxCount`、`FileUpload.MaxSize`、`FileUpload.MediaType`、`FileUpload.Multiple`、`FileUpload.SaveFullPath`、`FileUpload.ShowFileList`、`FileUpload.ShowUnauthorizedFileName`、`FileUpload.Tips`、`Upload`、`Upload.BeforeUploadV8`、`Upload.UploadSuccessV8`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`AllowOfficeEdit`、`ConfigurableRoleIds`、`DisableRoleInheritance`、`EnableOfficePreview`、`EnableOfficeVersion`、`EnableRolePermission`、`HideUnauthorizedFiles`、`Limit`、`MaxCount`、`MaxSize`、`MediaType`、`Multiple`、`SaveFullPath`、`ShowUnauthorizedFileName`、`Tips`。
+
+## Autocomplete（自动完成）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-autocomplete.vue`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiyDataSourceConfig.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`SelectLabel`、`SelectedValueLookup`、`Sql`、`TextApend`、`TextApendPosition`、`TextIcon`、`TextIconPosition`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`EnableSearch`、`SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`SelectedValueLookup === true`、`Sql`、`configForm`。
+
+## TagInput（标签输入）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-taginput.vue`。
+
+Config 静态路径：`TagInput`、`TagInput.MaxCount`、`TagInput.Options`、`TagInput.Placeholder`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`MaxCount`、`OptionsText`、`Placeholder`。
+
+## Transfer（穿梭框）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-transfer.vue`。
+
+Config 静态路径：`Transfer`、`Transfer.Filterable`、`Transfer.LeftTitle`、`Transfer.Options`、`Transfer.RightTitle`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Filterable`、`LeftTitle`、`OptionsText`、`RightTitle`。
+
+## Cascader（级联选择）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-cascader-value.js`、`Microi.Client/src/views/form-engine/diy-field-component/diy-cascader.vue`、`Microi.Client/src/views/form-engine/diy-field-component/field-data-load-fallback.js`。
+
+Config 静态路径：`Button.PreviewCanClick`、`Cascader`、`Cascader.Children`、`Cascader.Disabled`、`Cascader.EmitPath`、`Cascader.Filterable`、`Cascader.Label`、`Cascader.Lazy`、`Cascader.Leaf`、`Cascader.Multiple`、`Cascader.ParentField`、`Cascader.ParentFields`、`Cascader.Value`、`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`SelectLabel`、`SelectSaveField`、`Sql`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Cascader.Children`、`Cascader.Disabled`、`Cascader.EmitPath`、`Cascader.Filterable`、`Cascader.Lazy`、`Cascader.Leaf`、`Cascader.Multiple`、`Cascader.ParentField`、`Cascader.ParentFields`、`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`SelectLabel`、`SelectSaveField`、`Sql`。
+
+## Address（省市区地址）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-address.vue`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiySimpleFieldConfigDialog.vue`。
+
+Config 静态路径：`Address`、`Address.CheckStrictly`、`Address.Separator`、`Address.ShowAllLevels`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`CheckStrictly`、`Separator`、`ShowAllLevels`。
+
+## Department（部门选择）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-department.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`Cascader.Children`、`Cascader.Disabled`、`Cascader.Lazy`、`Cascader.Leaf`、`Cascader.Multiple`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`Department`、`Department.EmitPath`、`Department.Filterable`、`Department.Multiple`、`SelectLabel`、`SelectSaveField`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Department.EmitPath`、`Department.Filterable`、`Department.Multiple`。
+
+## SelectTree（树形选择）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-select-tree.vue`、`Microi.Client/src/views/form-engine/diy-field-component/paged-select-tree.vue`、`Microi.Client/src/views/form-engine/diy-field-component/select-tree-paging.js`。
+
+Config 静态路径：`Button.PreviewCanClick`、`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`DataSourceSqlRemoteLoading`、`Filterable`、`SelectLabel`、`SelectSaveField`、`SelectTree`、`SelectTree.Children`、`SelectTree.Disabled`、`SelectTree.Filterable`、`SelectTree.Label`、`SelectTree.Lazy`、`SelectTree.LazyLoad`、`SelectTree.Leaf`、`SelectTree.Multiple`、`SelectTree.PageSize`、`SelectTree.ParentChildLinkage`、`SelectTree.ParentField`、`SelectTree.ParentFields`、`SelectTree.Value`、`Sql`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DataSource`、`DataSourceApiEngineKey`、`DataSourceId`、`DataSourceSqlRemote`、`SelectLabel`、`SelectSaveField`、`SelectTree.Children`、`SelectTree.Disabled`、`SelectTree.Filterable`、`SelectTree.Lazy`、`SelectTree.Leaf`、`SelectTree.Multiple`、`SelectTree.PageSize`、`SelectTree.ParentChildLinkage`、`SelectTree.ParentField`、`SelectTree.ParentFields`、`Sql`。
+
+## TreeCheckbox（树形权限）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-treecheckbox.vue`。
+
+Config 静态路径：`TreeCheckbox`、`TreeCheckbox.DataSourceApi`、`TreeCheckbox.DataSourceType`、`TreeCheckbox.DefaultExpandAll`、`TreeCheckbox.NameColumnLabel`、`TreeCheckbox.NameColumnWidth`、`TreeCheckbox.PermissionColumnLabel`、`TreeCheckbox.ShowIcon`、`TreeCheckbox.ShowSearch`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DataSourceApi`、`DataSourceType`、`DefaultExpandAll`、`NameColumnLabel`、`NameColumnWidth`、`PermissionColumnLabel`、`ShowIcon`、`ShowSearch`。
+
+## OpenTable（弹出表格）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-opentable.vue`。
+
+Config 静态路径：`OpenTable`、`OpenTable.BeforeOpenV8`、`OpenTable.BtnName`、`OpenTable.MultipleSelect`、`OpenTable.PropsWhere`、`OpenTable.SearchAppend`、`OpenTable.ShowDialog`、`OpenTable.SubmitV8`、`OpenTable.SysMenuId`、`OpenTable.SysMenuName`、`OpenTable.TableId`、`OpenTable.TableName`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`BeforeOpenV8`、`BtnName`、`MultipleSelect`、`SubmitV8`。
+
+## JoinTable（关联表格）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-jointable.vue`。
+
+Config 静态路径：`JoinTable`、`JoinTable.ModuleId`、`JoinTable.ModuleName`、`JoinTable.TableId`、`JoinTable.Where`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`Where`。
+
+## JoinForm（关联表单）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-joinform.vue`。
+
+Config 静态路径：`JoinForm`、`JoinForm.FormMode`、`JoinForm.Id`、`JoinForm.JoinFieldName`、`JoinForm.TableId`、`JoinForm.TableName`、`JoinForm._SearchEqual`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`FormMode`、`JoinFieldName`、`TableId`。
+
+## TableChild（子表）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-tablechild.vue`。
+
+Config 静态路径：`TableChild`、`TableChild.Data`、`TableChild.DisablePagination`、`TableChild.FieldRelations`、`TableChild.ImportAutoFillFk`、`TableChild.LastSysMenuId`、`TableChild.LastSysMenuName`、`TableChild.LastTableId`、`TableChild.NoneDefaultHeight`、`TableChild.PrimaryTableFieldName`、`TableChild.SearchAppend`、`TableChildFkFieldName`、`TableChildSysMenuId`、`TableChildSysMenuName`、`TableChildTableId`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DisablePagination`、`FieldRelations`、`ImportAutoFillFk`、`PrimaryTableFieldName`、`TableChildFkFieldName`。
+
+## Map（地图定位）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-map.vue`、`Microi.Client/src/views/form-engine/diy-field-component/map-runtime.js`。
+
+Config 静态路径：`MapCompany`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`MapCompany`。
+
+## MapArea（地图区域）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-map.vue`、`Microi.Client/src/views/form-engine/diy-field-component/map-runtime.js`。
+
+Config 静态路径：`MapCompany`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`MapCompany`。
+
+## Qrcode（二维码）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-qrcode.vue`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiySimpleFieldConfigDialog.vue`。
+
+Config 静态路径：`Qrcode`、`Qrcode.DisplayWidth`、`Qrcode.DownloadText`、`Qrcode.ShowDownload`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DisplayWidth`、`DownloadText`、`ShowDownload`。
+
+## FontAwesome（图标选择）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-fontawesome.vue`、`Microi.Client/src/views/form-engine/diy-field-component/shared/DiySimpleFieldConfigDialog.vue`。
+
+Config 静态路径：`Button.PreviewCanClick`、`FontAwesome`、`FontAwesome.AllowClear`、`FontAwesome.DefaultIcon`、`FontAwesome.PreviewSize`、`V8Code`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`AllowClear`、`DefaultIcon`、`PreviewSize`。
+
+## DevComponent（自定义组件）
+
+来源：`Microi.Client/src/views/form-engine/diy-field-component/diy-devcomponent.vue`。
+
+Config 静态路径：`DevComponentName`、`DevComponentPath`。
+
+设计器绑定（含临时编辑键，不能直接当 Config）：`DevComponentName`、`DevComponentPath`。

package/skills/microi-form-engine/references/data-source-events.md

@@ -43,11 +43,17 @@ SQL 仍必须经过平台受控数据源；不要把用户文本拼成标识符
 
 ## 动态联动
 
+下列内容只说明候选联动。**显示名称、保存关联 Id、其它字段回填是三个不同契约**；
+选择项目/人员后还要核对当前表已有的名称、负责人、电话、岗位、组织等字段并逐项映射。
+`SelectLabel/SelectSaveField/SelectedValueLookup` 不自动完成这些业务回填。
+完整清空、改选、异步代次、快照与后端重算规则见 [表单生成质量规则](form-generation-quality.md)。
+
 字段值变化时可用前端 V8 更新另一个字段的数据源：
 
 ```javascript
 if (V8.LoadMode === 'Design') return;
 
+// 此处只展示候选供数；完整联动还需清理旧选择、保存依赖值并校验异步请求代次。
 var result = await V8.FormEngine.GetTableData('biz_contact', {
   _SelectFields: ['Id', 'Name'],
   _Where: [['CustomerId', '=', V8.ThisValue]],
@@ -79,8 +85,13 @@ if (!V8.Form.Name) return { Code: 0, Msg: '名称不能为空' };
 
 ## 字段属性
 
-常用属性包括 `Visible`、`AppVisible`、`Required`、`Readonly`、`Data`、
-`Config`、`FormWidth`、`TableWidth`、`Tab`、角色绑定和前端事件代码。
+常用持久化属性包括 `Visible`、`AppVisible`、`NotEmpty`、`Readonly`、`Data`、
+`Config`、`FormWidth`、`TableWidth`、`TableAlign`、`Tab`、角色绑定和前端事件代码。
+
+`TableAlign` 是 `diy_field` 顶层属性，值 `auto/left/center/right`，空/null 按控件类型自动；
+不能放进 `Config`。说明显示模式是 `diy_table.FieldDescriptionMode=inline/tooltip`，空/null
+保持 inline；模式作用于普通字段 Description，不覆盖布局控件自己的说明。具体默认与 MCP 参数见
+`../SKILL.md` 的“列对齐与字段说明模式”。
 
 - 除非明确隐藏，`Visible=1`、`AppVisible=1`。
 - 角色绑定只缩小界面可见性，不能代替服务器数据权限。

package/skills/microi-form-engine/references/form-generation-quality.md

@@ -0,0 +1,160 @@
+# 表单生成质量规则
+
+本页用于生成或修复业务表单。先确定字段的业务含义、保存值、显示值和依赖，再选控件；
+不能把“存在一个外键字段”当作关联交互已完成。
+
+## 每张表的字段契约
+
+建模前为适用字段记录：名称与物理类型、控件、Config、数据源、显示键、保存键、
+关联来源及回填目标、清空行为、默认值、精度/单位、权限和验收动作。
+先回读当前表全部字段和来源表字段；已有负责人、联系方式、组织等列时，主动检查它们
+是否应由选择器回填。只映射本业务确实需要且当前用户有权读取的字段，不复制整条来源记录。
+
+| 控件族 | 必须决定的配置与行为 |
+|---|---|
+| Text、Guid | 编号/电话/证件号保留文本及前导零；Guid 是标识，不能用随机默认值覆盖编辑记录；插槽动作写 `SlotButtonV8Code` |
+| Textarea | `Textarea.DefaultRows`、合理长度与整行宽度；不要拿它代替结构化明细 |
+| NumberText | 数量/金额/比率的单位、小数位 `NumberTextPrecision` 和 `NumberTextStep`；物理精度匹配；电话不是数字计算字段 |
+| DateTime | 明确日历日期、完整时间、钟点、年月、年、月日及多选；配置 `DateTimeType`，不能因不含年份或只含时间而退成 Text |
+| Select、MultipleSelect、Radio、Checkbox、Autocomplete | 完整数据源、保存键/显示键、Text/Json、多选格式、搜索/分页、已选值回显；单选清空、数值 0、旧对象值均测试 |
+| Switch | `int` 的 0/1；`Switch.NullValue=1` 仅表示空值显示开启，不回写旧值；默认值与只读/权限分开 |
+| Rate、Progress、Slider | 分值上限、半星、0–100 进度、范围/步长及展示与录入区别；Slider.Range 保存数组时不能配 int |
+| ColorPicker | 颜色格式、透明度和预设颜色；不把设计器临时 `PredefineText` 保存成运行配置 |
+| AutoNumber | 前缀、位数、关联字段、DataRule/CreateRule；由可信后端生成，不用前端拼号替代并发唯一性 |
+| Button | 行为、图标、预览可点击和 loading；提交业务调用授权接口，不能只生成外观按钮 |
+| Divider、CollapseGroup、Tabs | Divider 标签/图标；折叠组范围和字段数；字段 Tabs 存 `FieldTabs`，表级 Tabs 存 `diy_table.Tabs`；不让分组吞掉必填字段 |
+| Alert、StaticText、Html | 独立内容、主题、类型和显示来源；说明不是业务数据；HTML 需可信并净化 |
+| RichText | `RichText.Limit` 以及图片/视频/文件开关、大小、数量和压缩；私有正文不保存临时地址 |
+| CodeEditor | `CodeEditor.Language/Height/DisplayMode/ButtonText`；语言按实际内容选择，长配置可用 Dialog；保留 V8 代码 |
+| JsonTable | `JsonTable.Columns` 的 Key/Label/Component/Config、唯一列键、数据源、必填、只读和 JSON 存储；不能只生成空表控件 |
+| ImgUpload、FileUpload | `mediumtext`、公私桶、单/多文件、数量与大小；图片压缩/裁剪、文件媒体类型/Office/角色权限；角色 Id 来自当前租户 |
+| TagInput、Transfer | 候选项、键值、标题、过滤和数量；OptionsText 是设计器编辑中间值，持久化 Options |
+| Cascader、Address、Department、SelectTree、TreeCheckbox | 节点值/显示/子节点/父键、路径还是末级、多选、懒加载、父子联动和权限；Department 路径末级才是部门 Id |
+| OpenTable | 真实来源菜单/表、单/多选、固定筛选、BeforeOpenV8/SubmitV8；选择后用 `V8.TableRowSelected` 映射到当前表 |
+| JoinTable、JoinForm、TableChild | 区分集合展示、嵌入一条表单和 1:N 明细；子表真实外键、隐藏菜单、索引、父记录隔离，按主 Skill 的关系门禁执行 |
+| Map、MapArea | 供应商、点/区域结构和有效坐标；凭据只进入租户安全设置，字段不保存 Key/Secret |
+| Qrcode、FontAwesome | 二维码数据用 `DataAppend.Code`；纯展示优先虚拟字段，不能把 PNG Base64 写短列；图标选允许值及清空回退 |
+| DevComponent | 明确页面/稳定别名、输入输出、权限、只读与生命周期；先证明标准控件无法表达，复杂租户页面优先微服务 |
+
+完整配置键、设计器标签、编辑器、选项和值域通过
+`microi_get_form_component_catalog(component:"控件名")` 获取。无该工具的旧宿主查
+[源码索引](component-config-index.md) 和当前客户端，不能编造键或退成文本框。
+目录是 PC 静态证据，不代表小程序已经实现每个配置。
+
+## 关联选择与回填
+
+先区分三件事：选择器显示名称、保存稳定 Id、把其它业务列保存为关联快照。
+`SelectLabel` 只负责显示，`SelectSaveField` 只决定当前字段保存值，它们不会自动写
+负责人电话、岗位、组织等其它字段。`SelectedValueLookup` 只补显示名，也不等于业务回填。
+
+1. 用实时 Schema 和 `microi_get_field_list` 确认来源/目标字段、原 Config 和既有事件。
+2. 明确回填模式：历史单据通常保存选择时的快照；实时展示只读取，不在打开旧单据时
+   自动改历史值。人工允许修改的快照需约定再次选择时是否覆盖。
+3. 按“目标字段 → 来源字段”列出完整映射，包括已有 Id、名称、负责人、电话等适用列。
+   来源表只有 `OwnerId` 而没有电话时，需要继续按 OwnerId 查授权人员资料或使用受控
+   接口返回完整投影；不得从字段名猜手机号，也不得假设 `Project.Phone` 必然存在。
+4. `Select` 的 `V8.ThisValue` 可能是字符串、数值、对象或旧 JSON 文本。按真实保存键解析，
+   不无条件读取 `.Id`；空字符串/null 与数值 0 分开。Department 可能返回路径数组；
+   多选必须明确数组、逐行明细或聚合规则，不能取第一条悄悄填到单值列。
+5. 改选和清空时清理本选择器拥有的回填列及依赖候选/旧选择；不清无关手填列。
+   重新选择后不能保留上一位负责人的电话和岗位。
+6. 异步查询仅选所需字段，保留菜单/表/行/字段权限；失败显示原因。结果应用前核对
+   表单、记录、依赖值和本次请求代次；A→B→A 也要丢弃第一次 A 的响应。
+   自定义容器关闭、卸载和重开同记录还需取消请求或校验自己的打开代次。
+7. 既有 V8 不得被模板覆盖；先合并事件。前端只提供体验，重要项目归属、人员资格、
+   金额和组织权限必须由后端表单事件/接口引擎重新读取权威数据并校验。
+
+### MCP 的单选回填构建器
+
+`microi_build_field_config` 的既有数据源类型可附 `options.autoFill`：
+
+```json
+{
+  "sourceType": "Sql",
+  "options": {
+    "sql": "select Id,Name from Biz_Project where IsDeleted=0 limit 0,20",
+    "selectLabel": "Name",
+    "selectSaveField": "Id",
+    "autoFill": {
+      "fieldName": "Project",
+      "targetTable": "Biz_Project",
+      "valueField": "Id",
+      "mappings": {
+        "ProjectId": "Id",
+        "ProjectName": "Name",
+        "OwnerId": "OwnerId",
+        "OwnerPhone": "OwnerPhone"
+      }
+    }
+  }
+}
+```
+
+示例表/列必须替换成已回读的真实名称。当前选择字段 `Project` 保存来源 Id；目标
+`ProjectId` 是业务外键，不是当前记录主键 `Id`。工具输出 `configJson` 和 `v8Code`，
+包含清空与异步代次保护，使用正常 `V8.FormEngine.GetFormData` 读取当前用户有权资料。
+它不会自动补来源 SQL 的业务资格条件；服务端仍需验证资格，不能把回填成功当成可提交。
+
+Manifest 可在字段根部写同等 `autoFill`，省略 `fieldName`（生成器用当前字段名）：
+
+```json
+{
+  "name": "Project", "label": "项目", "component": "Select", "type": "varchar(50)",
+  "configSource": { "sourceType": "Sql", "sql": "select Id,Name from Biz_Project limit 0,20" },
+  "autoFill": {
+    "targetTable": "Biz_Project", "valueField": "Id",
+    "mappings": { "ProjectId": "Id", "ProjectName": "Name", "OwnerId": "OwnerId" }
+  }
+}
+```
+
+对应目标列必须存在于当前表。`v8Code`/`V8Code` 在生成时同时写入根列与
+`Config.V8Code`；两处不一致、已有事件与 autoFill 冲突时停止并合并。
+多跳依赖、树路径、多选汇总或接口专属资格规则自行写可维护的事件/接口，不冒用单记录模板。
+
+配套新版 PC 的 `FormSet` 会绑定启动事件的表单对象、记录与加载代次，切记录或重新加载后
+丢弃旧回写；旧 PC 没有此兜底。直接修改 `V8.Form`、自定义容器和其它异步副作用仍需自己的
+实例/打开代次检查，不能只更新 CLI 就宣称所有客户端已具备同等保护。
+
+OpenTable 使用 `Config.OpenTable.SubmitV8` 和 `V8.TableRowSelected`。单选为行对象，
+多选为数组；明确写入每个目标字段，再关闭弹层。不能把 SubmitV8 写到字段 V8Code。
+
+## 日期、钟点、月日与时长
+
+| 业务含义 | 控件 Config.DateTimeType | 前端显示/保存格式 |
+|---|---|---|
+| 日期 | `date` | `YYYY-MM-DD` |
+| 日期与秒 | `datetime` | `YYYY-MM-DD HH:mm:ss` |
+| 日期与分钟 | `datetime_HHmm` | `YYYY-MM-DD HH:mm` |
+| 日期与小时（兼容） | `datetime_HH` | `YYYY-MM-DD HH` |
+| 仅钟点 | `HH:mm` / `HH:mm:ss` | 同名格式 |
+| 仅年月/年 | `month` / `year` | `YYYY-MM` / `YYYY` |
+| 每年纪念日、生日月日 | `MM-dd` | Day.js `MM-DD`，例如 `11-04` |
+| 年周 | `week` | `YYYY 第 ww 周`，按实际业务核对周定义 |
+| 多选天/月/年 | `dates` / `months` / `years` | 对应字符串数组，物理列需容量支持序列化数组 |
+
+`MM` 是月份，`mm` 是分钟；`MM-dd` 是字段协议，前端 Day.js 日号用 `DD`。
+`MM-dd` 不是任意自由格式扩展，也不是 Element 的 picker type。旧 PC 需升级后才可使用。
+月日没有年份，普通字典序区间不能表达跨年范围；跨年生日筛选需明确 OR/业务查询。
+时长超过 24 小时、用时分钟数等使用数值和单位，不能误用日历/钟点控件。
+
+Manifest 可声明 `valueKind:date/datetime/time/monthDay/month/year`。
+若配了 Text，预检拒绝；DateTime 未给 DateTimeType 时按语义补齐。未声明语义时，
+名称只能作为提示，不能按 `Time` 子串粗暴改写已有类型。单值日期通常用 `varchar(25)`，
+多值日期用足够长的 varchar/mediumtext；不用数据库 datetime/date/time 类型。
+
+## 生成、修复与验收
+
+- 对全部字段检查上述契约，不能只检查 Select 和 DateTime。构建器通用控件接受
+  `sourceType:"Slider", options:{config:{Slider:{Min:0,Max:100,Step:1}}}`；完整 Config
+  路径不能省成 `{Min:0}`。错误 JSON、非法格式和明显错误数值在写前拒绝。
+- 缺少数据源/列定义等静态信息可能由运行事件动态提供：预检告警时须检查完整事件；
+  未证明动态实现就不能当作可用表单交付。预检不是后端权限、运行 UI 或完整业务验收。
+- 修改原字段先取完整 Config 再合并；保留 false、0、空字符串、NULL 与省略的区别，
+  不把全目录默认配置一次性写入字段。保存后回读全部事件/Config/Data、刷新缓存。
+- 至少验证：新增 A→改选 B→清空、快速 A→B→A、0 值、空/无权限/失败、
+  编辑保存重开、只读历史快照、多选格式、导入/直接 HTTP 提交与后端校验。
+  已授权开发/验收记录可用 `microi_add_form_data`、`microi_update_form_data` 验证直接提交，
+  再用 `microi_get_table_data` 按准确 Id 回读；这些动作仍服从当前租户与写入授权。
+- PC 与所承诺移动端分别验收。小程序不能执行任意前端 V8，须按当前原生白名单
+  ActionSchema 或后端表单事件实现同等规则；PC V8 测试不能冒充小程序联动通过。

package/skills/microi-form-layout/SKILL.md

@@ -18,7 +18,7 @@ Microi 吾码低代码提供 **三种** 表单分组能力，但每种都有明
 表单打开方式与分组是两个独立决策：顶层新表默认 `FormOpenType=Dialog`、
 `FormOpenWidth=80%`。完整系统开发的子表宽度按 `microi-system-delivery` 必读清单第 4 项配置：第一层 75%、第二层 70%，再逐层递减 5 个百分点。只有约 36 个以上业务字段、至少 2 个大型子表，或同等密度的重型控件
 才评估 Drawer；不能用 Drawer 代替 Tabs/CollapseGroup 的信息架构。Dialog 统一使用居中、可拖动、
-大圆角弹层；Drawer 贴边且不使用大圆角。
+现有宿主 Dialog 壳；圆角依当前主题契约，独立应用采用适度圆角并遵循 ui-design，不以大圆角作为默认；Drawer 贴边。
 
 `CollapseGroup` 的运行态视觉统一使用清爽的白色/主题表面卡片：短主题色指示条、紧凑
 标题、可选图标、单行副标题、标题旁轻量 `x 项` 文案，以及最右侧无底色的折叠箭头。

package/skills/microi-frontend-sdk/references/progressive-01-token-/345/275/223/345/211/215/347/231/273/345/275/225/347/224/250/346/210/267/344/270/216/345/275/223/345/211/215/347/273/210/347/253/257/347/231/273/345/275/225/345/215/217/350/256/256.md

@@ -171,6 +171,12 @@ if (ctx.token && ctx.token !== appliedHostToken) {
 普通 `request`、浏览器 `fetch(FormData)` 上传和 `uni.uploadFile` 都必须读取响应头的新 Token。验收时必须连续执行至少两个需要登录态的请求（前一个允许发生 Token 轮换），确认后一个仍返回 `Code=1`；不能只看页面首屏渲染成功。
 <!-- /microi-progressive:chunk -->
 
+### 嵌入长会话验收
+
+- 从宿主标准登录开始，打开原菜单中的微应用，再切到原生列表使微应用隐藏；保持同一浏览器会话，跨过该次真实 JWT 的原始 `exp` 后返回原菜单，并执行新的受保护业务调用。分别证明宿主与子应用经标准机制续签、继承同一有效会话，以及返回后的 HTTP/业务结果；只保存脱敏时间和结果，不记录 Token。独立入口通过、缓存首屏、几分钟业务 heartbeat 或 SignalR 房间租期均不能代替宿主长会话验收；浏览器意外退出应记为中断。
+- 若旧宿主从匿名登录页启动后没有开启原有维护，先核对事件作用域与宿主实际能力。在已授权租户中优先使用既有 `LoginEndV8Code` 调用现有根组件标准维护（如 `self.$root.RefreshTokenWithLock`）；先完整读取并保留原文，采用项目命名的幂等追加，复用原租户锁和定时器销毁，注销后停止，多次登录不重复安装。写入后回读前后哈希与原文前缀、刷新对应配置缓存，再标准登录并跨真实有效期验证。
+- 钩子只能启动现有标准维护，不得复制 JWT/HTTP 会话实现、另造 Token 算法、放宽鉴权或修改有效期。检查次数及未抛异常不代表续签成功，必须以真实续签响应、新会话同步和后续受保护调用为证据；本地 Skill 增补也不代表 CLI、插件、平台或既有应用已发行升级。
+
 ## 运行时 ApiBase / OsClient 切换
 
 允许用户切换平台的客户端必须把 `ApiBase + OsClient` 视为完整安全边界，而不是只替换请求 URL。候选端点应先匿名探测，成功后再原子更新配置并清除旧 Token、用户和平台派生缓存；账号、RSA 密文、菜单、表元数据和页面状态不得跨边界复用。SDK 每次修改 `apiBase` 或 `osClient` 都必须推进端点代次，请求记录发起时代次，并在处理响应头 Token、鉴权失效或响应体之前拒绝旧代次的迟到响应。验收至少覆盖“旧平台登录请求未返回 -> 切换平台 -> 旧响应携带 Token 返回”，并确认旧 Token 没有写入、新请求只发送一个新 `osclient`。