@microi.net/cli 6.2.1 → 6.2.2

package/skills/microi-form-engine/references/component-catalog.md

@@ -4,6 +4,10 @@
 `Microi.Client/src/views/form-engine/diy-field-component/diy-component-list.json`
 为当前事实源；物理类型以服务器/MCP 允许类型为准。
 
+控件名覆盖不等于配置覆盖。完整生成先读 [表单生成质量规则](form-generation-quality.md)，
+按控件查询 MCP `microi_get_form_component_catalog` 的配置路径、标签、枚举及来源哈希；
+离线查 [控件配置源码索引](component-config-index.md)。
+
 ## 基础输入
 
 | Component | 用途 | 推荐物理类型 |

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,7 +85,7 @@ if (!V8.Form.Name) return { Code: 0, Msg: '名称不能为空' };
 
 ## 字段属性
 
-常用属性包括 `Visible`、`AppVisible`、`Required`、`Readonly`、`Data`、
+常用持久化属性包括 `Visible`、`AppVisible`、`NotEmpty`、`Readonly`、`Data`、
 `Config`、`FormWidth`、`TableWidth`、`Tab`、角色绑定和前端事件代码。
 
 - 除非明确隐藏，`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-system-delivery/SKILL.md

@@ -55,6 +55,13 @@ Manifest 使用 `tables[].formBanner`；未显式配置时仍按字段类型选
 语义字段。跨表统计由接口引擎批量返回，禁止随机数、固定演示值和 N+1；Banner 不属于
 模块引擎或 `sys_menu`。逐步建模在字段完成后调用 `microi_configure_form_banner` 回读验收。
 
+表单建模与局部修复还必须读取 `microi-form-engine/references/form-generation-quality.md`：
+审查全部字段的控件配置、关联来源/逐字段回填与清空、日期/钟点/月日精度及跨端边界。
+不能以控件类型正确或结构验收通过，代替选择项目/人员后的业务数据完整性验收。
+
+涉及业务编号或追溯时，再读取 `microi-form-engine/references/business-numbering.md`：
+蓝图明确编号用途、分配及唯一范围；验收覆盖名称/编号展示、历史编码保留和真实关联跳转。
+
 <!-- microi-progressive:begin -->
 <!-- microi-progressive:chunk id=microi-system-delivery-000 sha256=83a624f454346eac4a63fe64e0e6902b5fd1d0d74c8de578208e06ea11e180cf -->
 ## 交付总原则

package/skills/microi-system-delivery/references/delivery-pitfalls.md

@@ -4,6 +4,11 @@
 每项在项目验收表记录 `适用 / 检查方法 / 证据位置 / 结果 / 未完成原因`，失败不得记通过。
 规则不能保证模型一定服从；使用确定性检查、真实身份和原菜单结果约束交付结论。
 
+编号与追溯复测同时执行
+[业务编号与追溯契约](../../microi-form-engine/references/business-numbering.md)：
+区分内部 Id、业务编号、历史外部编码，确认持久保存和实际搜索/复制/导出；来源、去向必须
+有真实关联与权限，缺失明确标注，不把改号计划、蓝色文本或进行中的任务当作最终证据。
+
 ## 执行顺序
 
 1. 固定租户、源码/运行版本、用户要求编号、目标菜单和已授权写入范围；完整读取基础规范及实际专项正文。输出截断须补读，不能称“已加载”。

package/skills/microi-uniapp-frontend/SKILL.md

@@ -38,7 +38,7 @@ UniApp/H5/小程序必须通过项目统一 `microi.v8.js` 的 `V8.uploadFile` /
 创建、重构或修复任何 Microi 移动端项目前，必须同时应用 `microi.skills/microi-mobile-app-quality/SKILL.md`，并读取其[首版交付与外部服务验收](../microi-mobile-app-quality/references/mobile-first-delivery.md)。手机号快捷登录、会话续签、导航几何、真实地图、页面动效和公开发布回读从首版纳入需求与测试，不能先交静态占位版，再等待用户逐页指出问题。涉及后台与第三方服务时按实际业务范围执行，既有授权和租户策略优先。
 
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=microi-uniapp-frontend-001 sha256=8b6124cf7267beae98f0321780bc1aece9494c669e0337a96a61f50f5cbf62e6 -->
+<!-- microi-progressive:chunk id=microi-uniapp-frontend-001 sha256=de245aa65643e8bbb5d9cfd5256066295b4857bfa2fc8ef2689161eee9b2bc25 -->
 ## 标准产品、视图协议与租户扩展
 
 地图提供行政区与附近距离两类筛选时，应复用省市区字典，并允许省、市、区逐级选“全部”；省级“全部”须显式启用，不能改变普通地址录入的默认值。行政区域查询不依赖手机定位、不叠加附近半径，空地区仍可保留既有附近模式。范围筛选必须在原有菜单/租户/行权限内执行，分批读取并丢弃迟到响应；来源列表存在同表不同菜单时，地图入口与查询应保留准确的来源菜单和固定业务条件。验收覆盖全国、全省、全市、区县、直辖市、定位拒绝、旧接口兼容和快速切换。
@@ -49,6 +49,8 @@ UniApp/H5/小程序必须通过项目统一 `microi.v8.js` 的 `V8.uploadFile` /
 
 Microi 标准小程序必须采用“平台内核 + 版本化元数据 + Profile + 租户插件”架构，不能把某个交付项目直接写死成平台产品：
 
+JSON 历史字段的只读展示使用 `Config.ReadonlyView.Type=Timeline`，通过 `TitleField/TimeField/Fields[{Name,Label}]/ToneMap/EmptyText` 声明；复用 `mci-record-timeline` 与 `record-timeline.mjs`。只展示映射的标量字段，不泄露内部 ID，不执行 HTML 或 V8；模块详情整行布局，最近三条和逐批展开，空值及损坏数据均有可读提示。通用组件不得按客户表名或字段名硬编码。更新后验证旧记录、排序、长说明及两套小程序构建。
+
 - `src/platform/`、通用 `mci-*` 组件、动态模块页和动态表单页只实现平台能力，不得出现租户表名、字段名、品牌文案、素材或客户路由。
 - `src/tenants/<tenant>/` 存放客户专属业务组合、首页统计、表单联动、子表规则、扫码/定位/相机和复杂原生流程；`profiles/<id>/` 管理 OsClient、API、品牌、功能开关、路由和真实编译范围。
 - `src/generated/`、`pages.json`、`manifest.json` 等 Profile 产物由脚本生成，不能作为人工定制入口。多人合并冲突时以 Profile 与租户源码为准重新生成。