⚙️ 系统设置
系统设置非常重要，开好数据库后第一件事就是配置系统设置
📸 系统设置预览
系统授权版本标签
【界面风格 → 主题与导航】中的“不显示系统授权版本”（HideSystemLicenseVersion）默认关闭。 右上角显示开源版、个人版或企业版，点击进入 /#/license；开启此设置只隐藏授权版本标签， Api/Web 版本和开发工具连接入口继续显示。授权类型来自后端实时启动配置 PlatformEdition，不由可编辑配置决定。 需更新前后端镜像及“系统设置”应用；旧库缺少开关时仍默认显示。
侧栏 Logo 的比例与高度
SysLogoType=图形 表示只显示图片，展开侧栏时图片使用可用宽度，不再限制为方形图标。SysLogoHeight 支持数值或像素字符串，例如 80、80px；侧栏顶部会随高度调整，菜单滚动区域使用剩余高度。收起侧栏时保留最大 40px 的紧凑图标。
图片始终等比例完整显示。超宽横版 Logo 即使配置高度 80px，也会受侧栏宽度约束，实际图形高度小于 80px；这是正常的等比例适配，不应拉伸图片。建议裁掉原图中多余的透明留白。无效高度回退 40px，图片失败时继续使用当前租户标题首字，不回退成其它租户的品牌。
启动加载页 Logo
启动时尚未读取到有效的 SysLogo，默认显示红色魔方、金属代码括号与品牌面板。 设置了系统 Logo 后，缓存配置和本次新读取的系统设置均可更新启动图标；图片成功加载后才切换， 空值、无效格式或图片加载失败时保留默认图标，避免出现破图。
例如在系统设置上传公司 Logo，后续启动会优先显示该图片，无需另配 Loading 图标。 默认图标随新版 PC 前端静态资源交付，部署时需一起更新 index.html 与 static 目录； 无需新增数据库字段或安装新的系统设置应用包。此规则仅用于启动页，侧栏 Logo 继续按上节处理。
公开配置与服务端私密配置
系统设置采用明确的双表边界：
sys_config保存需要向浏览器公开的租户配置。新增公开项必须创建真实物理字段和diy_field元数据；前端V8.SysConfig读取它的安全投影。mci_system_setting只保存敏感配置或仅供后端使用的普通值。历史IsPublic字段已停用，任何记录都不会进入匿名GetSysConfig或浏览器。- 后端接口引擎和后端 V8 事件仍可读取
sys_config全部字段；私密值统一从V8.SysConfig.ServerPrivateSettings[ConfigKey]读取。禁止返回、记录或复制整个ServerPrivateSettings。 mci_system_setting的 Secret 使用租户绑定认证加密，列表默认掩码；临时显示原文要求 Passkey、Authenticator 或严格人脸的一次性步进验证，并使用no-store。
“是否启用、是否显示、采用哪种公开交互方式”这类浏览器和管理员都需要判断的能力开关，必须建成 sys_config 实体字段，不能因为它与登录、OAuth 或安全功能有关就塞进“安全与服务接入”。“安全与服务接入”只维护 API Key、ClientSecret、RP ID、Origin、Issuer、供应商地址、Scope 等不能公开或仅供后端执行的参数。两边禁止维护同一个新配置；存量 mci_system_setting 开关只作升级兼容回退，保存入口和列表均不再展示。
系统设置官方应用与 Secret 边界
AI 接入畅捷通等第三方服务时，应先使用 microi_manage_server_private_secret 列出已配置的 Key，再把 App Secret 保存到“安全与服务接入”，并按 Key 回读 HasSecret/IsSecret/IsEnabled 确认。工具复用平台已有私密配置，不返回明文或密文；写入确认格式为 SAVE:<Key>。服务端接口引擎按受限私密配置能力读取，浏览器、表单代码和公开配置不得取得 Secret。不要因凭据尚未配置就让用户新增生产环境变量、硬编码到源码或另建凭据库。
独立官方应用 app.microi.sys-config 唯一交付以下接口引擎：
platform-tenant-system-settings是 Managed 核心，只编排管理员列表、删除和非 Secret 保存；platform-system-settings-custom-hook是 CreateIfMissing 租户扩展，默认直接返回{ Code: 1 }，官方升级不覆盖；- Hook 只接收阶段、设置 Id、ConfigKey 和结果数量，不接收
ConfigValue、SecretCipher或 Secret 原文。
安装、更新或重新安装“系统设置”会恢复 Managed 核心源码，因此租户逻辑必须写入 Hook。旧 /api/TenantSystemSettings/List、Delete 与非 Secret Save 只保留兼容转发。Secret/Sensitive Key 保存仍由可信 C# 立即转换为租户绑定认证密文；GetRevealChallenge + Reveal 仍要求超级管理员的普通 DiyToken 会话和一次性 Passkey/TOTP/严格人脸票据。访问密钥、匿名 V8、普通 FormEngine HTTP 和租户 Hook 都不能获得通用加解密或 Reveal 能力。
基础 SaaS 空库包仍可携带新租户初始化所需的表、字段和默认模板，但上述两个接口引擎只允许“系统设置”包拥有；SaaS 与应用商城包不得复制同 Key Managed 资源，避免多个官方包相互覆盖。
系统全局函数
更新后端及“系统设置”应用 v6.4.0 后，可在系统设置的“全局函数”子表维护 mci_global_function：每行一个函数，选择前端 Client 或后端 Server，配置函数名、源码、启用状态和顺序。仅平台管理员可维护；源码必须是一个与函数名一致的 function 声明，不允许顶层执行语句。
系统默认提供两个运行端各一套 DateNow、DateFormat、DateAdd。安装按当前唯一启用的系统设置绑定父记录，只补不存在的种子，不覆盖用户修改过的函数，也不替换 GlobalV8Code、GlobalServerV8Code。
执行顺序为基础日期函数、当前设置且匹配运行端的启用函数、原有全局 V8。原有同名自定义函数优先，建议同一名称只在一个位置维护。后端引擎还会在加载租户设置前提供日期基础函数，因此缺表、首次升级、安装器自举不再依赖用户手工补写 DateNow。
函数列表和合并代码使用租户隔离的 L1/Redis 缓存；新增、修改、删除和系统设置变更在真实事务提交后更新缓存版本，回滚不发布新版本。其它节点通过现有缓存失效通知读取新版本；旧快照有有限 TTL。前端已打开页面需刷新，获取新的全局代码。不要直接用 SQL 修改函数表而绕过表单引擎缓存失效流程。
登录与身份能力开关
登录与身份能力的公开正向开关如下：
sys_config 字段 | 默认值 | 说明 |
|---|---|---|
IdentityVerificationEnabled | 1 | 统一强身份验证与多登录方式总开关 |
PasskeyEnabled | 1 | Passkey / Windows Hello / Face ID / Touch ID 能力 |
AuthenticatorTotpEnabled | 1 | 标准 TOTP Authenticator 能力 |
RequirePasswordChangeStepUp | 1 | 已登记强因子的用户修改密码时要求二次验证 |
ExternalLoginEnabled | 1 | 内置第三方登录总开关 |
FaceVerificationEnabled | 0 | 独立 Face Gateway 严格人脸与活体能力 |
GiteeLoginEnabled / WeChatLoginEnabled / GitHubLoginEnabled | 0 | 对应内置外部登录能力 |
新字段显式值优先；字段尚未安装或值为空时，运行时才读取旧 mci_system_setting Key，再回退到存量 sys_osclients / 安全默认值。这样旧租户升级后不会被突然改值，但升级完成后的唯一配置入口始终是公开系统设置。
旧数据库启用 Passkey / Authenticator 时，需要同时更新平台前端、后端与官方“系统设置”“SaaS引擎”应用包；仅安装应用包不会替换正在运行的后端 DLL 或已部署的前端静态资源。完成更新后在 sys_config 打开公开能力与登录入口开关，存量用户仍须在个人中心分别登记自己的 Passkey 或 TOTP，系统不会替用户自动生成认证因子。Passkey 还要求可信 HTTPS 前端 Origin（localhost 仅限开发），HTTP 站点即使开关已打开也不能完成 WebAuthn 登记或登录。
开发配置与服务接入
停用任务调度
【开发配置 → 接口、文件与运行环境】的【停用任务调度】对应 sys_config.DisableTaskScheduling，默认关闭。更新后端与“系统设置”应用 v6.4.2 后，开启可让新版后端停止领取本租户的 Quartz 定时任务，保留仍连接同一数据库的旧版调度，不修改共享任务启停状态。
保存成功后下一次调度检查读取更新后的系统设置缓存，无需重启；已开始的业务不会被强行中断。新版将跳过原因写入任务日志，并按任务及计划时间跨节点去重。普通接口与应用安装等持久后台任务不受影响。交接步骤及日志边界见任务调度与后台任务。
开发配置的表单布局
“开发配置”Tab 默认使用四个展开的 CollapseGroup：访问与运行地址、V8 执行治理、全局脚本、模板与页面代码。分组作用域使用“直到下一个分组”，避免后续新增字段被错误吞入末尾分组。
该 Tab 的 CodeEditor 字段统一设置 Config.CodeEditor.DisplayMode = "Dialog"。表单默认只显示 编辑代码（N字） 按钮，点击后使用平台统一大圆角弹层编辑；确实需要在表单内常驻编辑器的字段可以在【表单设计 → 控件配置 → 默认显示方式】改回 Inline。字符数按 Unicode 字符计算，空值也显示 0字。
表单地图服务接入
表单 Map / MapArea 的高德、百度、腾讯凭据统一放在 mci_system_setting，并归类到“系统设置 → 安全与服务接入”：
| Key | 类型 | 默认状态 | 用途 |
|---|---|---|---|
Map.Provider | 普通私有 | 停用 | 默认地图供应商：AMap、Baidu 或 Tencent |
Map.AMap.JsApiKey | Secret | 停用 | 高德 Web JS API Key |
Map.AMap.SecurityJsCode | Secret | 停用 | 高德 JS API 2.0 安全密钥 |
Map.AMap.ServiceHost | 普通私有 | 停用 | 高德安全代理地址；优先于直接下发安全密钥 |
Map.Baidu.JsApiKey | Secret | 停用 | 百度 JavaScript API AK |
Map.Tencent.JsApiKey | Secret | 停用 | 腾讯 JavaScript API GL Key |
官方模板全部默认停用，升级不会覆盖现有租户选择；旧 sys_config.AMapKey / AMapSecret / BaiduAK 在新设置未启用时继续兼容。地图运行时端点只接受当前登录用户，从 DiyToken 确定租户，只返回字段实际选择的一家供应商，并设置 Cache-Control: no-store；访问密钥会话被拒绝，响应中不存在其它 Secret。
浏览器地图 SDK 必须拿到客户端 Key，所以 Key 在浏览器开发者工具中仍可见。必须在高德、百度、腾讯控制台配置当前生产域名白名单和所需 JavaScript API 产品；Secret 的作用是防止明文落库、列表泄露和一次性返回全部供应商凭据。高德配置 Map.AMap.ServiceHost 后，后端不会再返回 Map.AMap.SecurityJsCode。
// 前端或后端均可读取公开实体字段
var title = V8.SysConfig.SysTitle;
// 仅后端接口引擎、SubmitBeforeServerV8、SubmitAfterServerV8 等可信后端事件可用
var privateSettings = V8.SysConfig.ServerPrivateSettings || {};
var clientSecret = privateSettings['Login.Gitee.ClientSecret'];
// clientSecret 只能参与当前后端调用，禁止 return 或 console.log。FormMaskBlur 是全局正向开关：缺失、空值或 0/false 默认关闭遮罩毛玻璃，只有显式 1/true 才开启。平台统一 Dialog、图片裁剪、字段配置、业务弹窗和 Element Plus MessageBox 都必须从同一运行时读取该值，页面不得再用静态 CSS 默认开启毛玻璃。表级 diy_table.DisableFormMaskBlur 仍是负向开关；全局开启后，某张表显式配置 1/true 可单独关闭。旧 sys_config.DisableFormMaskBlur 只用于未升级租户的前端兼容回退，字段元数据必须在 PC 与移动端隐藏。
登录页入口统一使用 DisableLoginPasskey、DisableLoginAuthenticator、DisableLoginGitee、DisableLoginWeChat、DisableLoginGitHub 五个负向开关，字段标签分别为“关闭生物登录入口”“关闭Authenticator登录入口”“关闭Gitee登录入口”“关闭微信登录入口”“关闭GitHub登录入口”。它们缺失、空值或 0/false 时默认显示入口，只有显式 1/true 才关闭；旧 Login*Display 字段仅作兼容回退并隐藏。DisableAiAssistant 同样保持负向开关语义。
AI 助手只保留“关闭AI助手图标”一个设置项：DisableAiAssistant=1/true 表示隐藏图标，0/false 表示显示。旧版“显示AI助手图标”（IsShowAiAssistant）已从官方母版字段元数据和新版系统设置安装包移除，不再作为新项目配置入口。已有数据库的旧物理列可保留供尚未升级的定制客户端兼容；字段 Id 可能曾被新开关复用，维护旧租户时须先按表名与字段名定位，不能直接套用旧 Id 删除。
界面风格：框架来源标识与水印
微服务和定制组件的来源标识由吾码宿主统一渲染，子应用不需要自行实现，也不存在租户级显示开关。RenderSourceBadgeMode 已停用并从系统设置移除：来源标识始终可发现，避免用户在不知道内容来源的情况下误改宿主或子应用。
菜单微服务显示在框架内容区右上角并提供独立关闭按钮，用户认为它遮挡子应用控件时可仅关闭当前页面实例的标识；切换到另一个微服务页面后会重新显示，不会记住为全局关闭。V8.OpenAppDialog 打开的微服务或定制弹层把标识放在标准标题栏，因为它不会覆盖弹层正文和右上角操作区，所以始终显示且不提供关闭按钮。表单 DevComponent 显示在字段宿主，表格中的 DevComponent 只在列头显示一次，避免每行重复。
来源标识本身是可点击按钮。点击后由框架打开统一的大圆角详情弹层，展示应用标识、页面标识、应用内路由、框架路由、版本、源码定位、运行入口、发布/挂载状态和租户坐标，并生成一段可复制的 Microi MCP 修改指令。详情中的运行信息只显示公开定位数据，不展示 Token、访问密钥或私有配置值。
框架水印使用以下公开 sys_config 字段，覆盖整个 100vw × 100vh，包括路由内容和 Element Plus 弹层；水印层固定 pointer-events:none，不会阻止点击、滚动、拖拽、触摸或键盘操作，并自动适配亮色/深色主题。
| 字段 | 默认值 | 说明 |
|---|---|---|
FrameworkWatermarkEnabled | 0 | 显式设为 1/true 才开启，保证旧租户升级后视觉不变 |
FrameworkWatermarkContent | $SysTitle$ - $UserName$ | 留空时显示“系统标题 - 用户名”；用户名为空自动回退 $Account$，两者均为空时只显示系统标题，不会输出 undefined/null。支持 $SysTitle$、$SysShortTitle$、$UserName$、$Account$、$Date$、$DateTime$，也支持 |
FrameworkWatermarkDirection | DiagonalUp | DiagonalUp（斜向上）、DiagonalDown（斜向下）、Horizontal（水平） |
FrameworkWatermarkOpacity | 30 | 百分比；未设置、非法或为 0 时按 30 处理，运行时限制在 1–100 |
FrameworkWatermarkDensity | Comfortable | Compact、Comfortable、Sparse 三档重复间距 |
FrameworkWatermarkFontSize | 14 | 像素；未设置、非法或为 0 时按 14 处理，运行时限制在 8–72 |
水印内容只应使用系统标题、用户显示名、账号、日期等公开展示信息，不要填写 Token、密码、Secret、手机号等敏感值。保存系统设置后会沿用现有 sys_config 缓存失效机制；刷新页面即可按最新配置重建框架水印。
“界面风格”是一级 Tab，内部继续使用“主题与导航 / 登录界面与入口 / AI 与框架水印”等 CollapseGroup 归类设置。新增界面配置时应放入相应折叠组，不能继续把大量开关直接平铺在 Tab 中。
🔐 验证码
获取验证码图片
展开查看 JavaScript 代码（24 行）
//通过浏览器测试：
https://api.microios.com/api/Captcha/getCaptcha?OsClient=micrios
//通过查看元素，可在Response Headers中看到返回了captchaid，在提交验证码时，此值必须传入到后端。
//在PC前端或Uni-App移动端的处理方式大致为：
<img id="CaptchaImg" src="" @click="GetCaptcha()" />
GetCaptcha(){
$axios.get(self.DiyCommon.GetApiBase() + '/api/Captcha/getCaptcha', {
params: {
OsClient : self.OsClient//一定要传入OsClient值
},
responseType: 'arraybuffer'
})
.then(response => {
if(response && response.headers && response.headers.captchaid){
self.CaptchaId = response.headers.captchaid;//一定要将返回的captchaid存储起来
}
return 'data:image/png;base64,' + btoa(
new Uint8Array(response.data)
.reduce((data, byte) => data + String.fromCharCode(byte), '')
);
}).then(data => {
$('#CaptchaImg').attr('src', data);//显示验证码图片
});
}提交验证码
//参数传入_CaptchaId、_CaptchaValue验证码配置
展开查看 JSON 配置（24 行）
{
"CaptchaType": 11, // 验证码类型，值为0-11，具体效果见平台文档
"CodeLength": 1, // 验证码长度, 要放在CaptchaType设置后。当类型为算术表达式时（CaptchaType=10-11），长度代表操作的个数, 建议1。当CaptchaType=0-9时建议填4。
"ExpirySeconds": 300, // 验证码过期秒数
"IgnoreCase": true, // 比较时是否忽略大小写
//"StoreageKeyPrefix": "", // 存储键前缀
"ImageOption": {
"Animation": true, // 是否启用动画
"FontSize": 32, // 字体大小
"Width": 150, // 验证码宽度
"Height": 50, // 验证码高度
"BubbleMinRadius": 5, // 气泡最小半径
"BubbleMaxRadius": 10, // 气泡最大半径
"BubbleCount": 3, // 气泡数量
"BubbleThickness": 1.0, // 气泡边沿厚度
"InterferenceLineCount": 2, // 干扰线数量
//"FontFamily": "kaiti", //【暂不支持】 包含actionj,epilog,fresnel,headache,lexo,prefix,progbot,ransom,robot,scandal,kaiti
"FrameDelay": 300, // 每帧延迟,Animation=true时有效, 默认30，建议300左右
//"BackgroundColor": "#ffffff", //【暂不支持】 格式: rgb, rgba, rrggbb, or rrggbbaa format to match web syntax, 默认#fff
"ForegroundColors": "", // 颜色格式同BackgroundColor,多个颜色逗号分割，随机选取。不填，空值，则使用默认颜色集
"Quality": 100, // 图片质量（质量越高图片越大，gif调整无效可能会更大）
"TextBold": false // 粗体
}
}| CaptchaType | 字体 | 静态图 | 动图 |
|---|---|---|---|
| DEFAULT (0) |  |  | |
| CHINESE (1) |  |  | |
| NUMBER (2) |  |  | |
| NUMBER_ZH_CN (3) |  |  | |
| NUMBER_ZH_HK (4) |  |  | |
| WORD (5) |  |  | |
| WORD_LOWER (6) |  |  | |
| WORD_UPPER (7) |  |  | |
| WORD_NUMBER_LOWER (8) |  |  | |
| WORD_NUMBER_UPPER (9) |  |  | |
| ARITHMETIC (10) |  |  | |
| ARITHMETIC_ZH (11) |  |  |