@microi.net/cli 5.6.3 → 5.6.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -13,6 +13,14 @@ description: Microi V8 与 MCP 文件上传下载指南。用于处理流式 AI
13
13
 
14
14
  ## 表单字段的公有桶与私有桶(强制)
15
15
 
16
+ - `Config.FileUpload.EnableRolePermission=true` 的字段强制私有上传,优先级高于字段和请求 `Limit`。
17
+ 每个附件 `VisibleRoleIds` 多选真实角色,三个默认关闭的开关为 `HideUnauthorizedFiles`、
18
+ `ShowUnauthorizedFileName`、`DisableRoleInheritance`。无权限时后端仅返回脱敏占位,不含 Path、
19
+ Versions 或签名地址;普通保存必须保留无权附件,不能改角色、改名、删除或通过复制路径重新授权。
20
+ 上传响应的 `_UploadProof` 绑定当前租户、用户、字段、记录、私有路径及有效期,只用于首次保存校验,
21
+ 持久化时移除;新文件须携带当前记录/字段上下文上传。历史公有附件需重新私有上传后才能设置角色。
22
+ 完整配置、继承与 MCP 流程见 `../microi-form-engine/SKILL.md`。
23
+
16
24
  ### 旧上传返回与接口引擎扩展
17
25
 
18
26
  - 系统设置 `CompatiblePlatformOldVersion` 默认关闭,空值/缺字段也关闭;开启时旧 HTTP 上传
@@ -5,7 +5,9 @@ description: Microi V8 HTTP 集成指南。用于通过 V8.Http.Get/Post/Patch
5
5
 
6
6
  > **Codex 非阻塞自动更新:** 当前宿主为 Codex 时,吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新;需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
7
7
 
8
- # Microi V8 HTTP 外部接口集成
8
+ # Microi V8 HTTP 外部接口集成
9
+
10
+ 第三方集成一旦需要 App Secret、ClientSecret、API Key(例如畅捷通 T+),先发现现有“系统设置 → 安全与服务接入”,调用 `microi_manage_server_private_secret` 的 List/Save,将 Secret 存为当前租户 `mci_system_setting` 的加密私密项。后端通过 `V8.SysConfig.ServerPrivateSettings['Integration.Changjet.AppSecret']` 使用。不要因为 `V8.OsClientModel` 已脱敏就判断平台无法存储或读取 Secret,也不要要求新增服务器配置/C# 端点。已有用户授权即可执行保存与脱敏回读;缺少工具时先读取 `../v8-security/SKILL.md` 的现有能力与实际连接版本。
9
11
 
10
12
  你正在开发 Microi 吾码平台的 V8 引擎代码,需要调用外部 HTTP API(微信、支付宝、短信、ERP 等第三方系统)。
11
13
 
@@ -15,7 +15,9 @@ description: Microi V8 安全指南。用于审查 DiyToken 与权限、可逆
15
15
 
16
16
  <!-- microi-progressive:begin -->
17
17
  <!-- microi-progressive:chunk id=v8-security-000 sha256=d03ee34e72925db55f9022de26dfc251c0d3d69fac52ae6a910d42ddfc142ae7 -->
18
- ## 0. 租户动态系统设置与密钥边界
18
+ ## 0. 租户动态系统设置与密钥边界
19
+
20
+ **AI 默认处理路径:** 用户交付第三方 Secret 并授权配置时,优先调用 `microi_manage_server_private_secret`:List 只确认 Key/HasSecret;Save 使用 `confirmExecution=SAVE:<ConfigKey>`,固定 `IsSecret=true / IsPublic=false` 并自动脱敏回读。例如畅捷通使用 `Integration.Changjet.AppSecret`,后端从 `V8.SysConfig.ServerPrivateSettings` 使用。不要仅拒绝硬编码后停止,也不要因为 `OsClientModel` 不暴露密钥而误判服务端 V8 无法调用第三方。工具不提供原文揭示;更换已有 Key 前回读现状,超时只回读、不盲目重写。
19
21
 
20
22
  第三方密钥(微信、支付宝、OpenAI、阿里云、ERP、SMTP)**禁止**硬编码在 V8 代码或前端。公开的租户配置必须建成当前租户 `sys_config` 的实体字段;敏感或仅供后端使用的租户业务配置保存到 `mci_system_setting`。数据库、Redis、MongoDB、MinIO、MQ 等部署控制面仍由主库 `sys_osclients` 托管,子租户不能修改。
21
23