weaver-work-cli 0.1.25 → 0.1.26

package/skills/weaver-e10-caizhilian/references/setting-encrypt.md

@@ -13,7 +13,7 @@ metadata:
 
 # weaver-setting-encrypt
 
-> 版本 1.1.9：修正第三方软件名称到后端编码的转换，亿赛通提交为 `est`；同时兼容旧版本查询接口。
+> 说明：第三方软件名称提交前会转换为后端编码，亿赛通提交为 `est`；同时兼容旧版本查询接口。
 
 让"文件设置 → 加解密设置"页面**用对话就能改**。背后调两条 HTTP 接口：
 - `GET /api/file/thirdPlugEncDec/config`（新版本专用端点，读完整 `EncryptionSettings`）
@@ -28,7 +28,7 @@ metadata:
 
 ### 认证前置（必须）
 
-本模块通过 CLI 托管的认证获取凭证（base_url + Cookie + eteamsid + User-Agent），凭证契约见共享规则 [`../../weaver-e10-shared/SKILL.md`](../../weaver-e10-shared/SKILL.md)，不依赖手动配置文件，Agent 不得自己读取或输出凭证。
+本模块通过 CLI 托管的认证获取凭证（base_url + Cookie + eteamsid + User-Agent），凭证契约见同级 `weaver-e10-shared` 技能的共享规则，不依赖手动配置文件，Agent 不得自己读取或输出凭证。
 
 **使用前必须确保**：
 1. CLI 已安装：`weaver-work-cli --version` 能正常输出版本号
@@ -67,8 +67,7 @@ CLI 软链名 `setting-encrypt`（用全名避开与 `weaver-setting-attach` 的
 
 ## 8 个支持字段（扁平 key）
 
-CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完整别名表见
-[setting-encrypt-field-map.md](setting-encrypt-field-map.md)。
+CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完整别名表见本文「字段对照表」章节。
 
 > **历史说明**：早期版本支持 13 个字段（含加密机分支：`encryptMachineType` /
 > `encryptIp` / `encryptPort` / `encryptAppID` / `encryptAppKey`）。前端下拉已移除
@@ -78,7 +77,7 @@ CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完
 | 别名（key） | DTO 字段 | 类型 | 备注 | 依赖 |
 |---|---|---|---|---|
 | `open-encrypt` | `openEncryptFunction` | bool | 加解密功能开关 | — |
-| `encrypt-plugs` | `encryptPlugs` | enum | 后端编码：`est`=亿赛通、`tipray`=天锐绿盾、`vtext`=华途（对接方式/限制见 [setting-encrypt-third-party-plugins.md](setting-encrypt-third-party-plugins.md)） | — |
+| `encrypt-plugs` | `encryptPlugs` | enum | 后端编码：`est`=亿赛通、`tipray`=天锐绿盾、`vtext`=华途（对接方式与限制见下方第三方软件说明） | — |
 | `encrypt-url` | `encryptUrl` | str (URL) | 软件地址 | — |
 | `encrypt-scene` | `encryptScene` | enum | 场景：`uploadAndDownloadEncrypt` / `uploadAndDownloadNotProcessed` / `custom` | — |
 | `encrypt-file-upload` | `encryptFileUpload` | enum (str) | 加密文件-上传：`0`=解密 `1`=加密 其它=不处理 | `encrypt-scene=custom` |
@@ -94,10 +93,8 @@ CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完
    "改前值 / 改后影响 / 明确询问" 三步**（见对话式规则 3），得到
    "改 / 确认 / 好的" 之类回复后才调 CLI。
 2. **`prod` 必加 --yes**——生产环境操作时必须同时带 `--yes` 才会发 POST。
-3. **整对象 POST，子字段 merge**——`encryptionSettings` 是 DTO 嵌套对象，后端
-   `EncryptionSettings.java:49` 的 `updateSysFileItem` 接收**整对象**并存到 `param`
-   字段前 `toString()`（整对象变 JSON 串）。CLI 必须 GET 拉整对象 → 改子字段 merge
-   进 `current` → **整对象 toString 一起 POST**。**不能只 POST 改了的子字段**
+3. **整对象 POST，子字段 merge**——`encryptionSettings` 是嵌套对象，后端按**整对象**接收并保存。
+   CLI 必须 GET 拉整对象 → 改子字段 merge 进 `current` → **整对象一起 POST**。**不能只 POST 改了的子字段**
    （后端不支持增量，会覆盖整对象）；也不能"只 diff 几个 key"就 POST（merge 时
    其他子字段会丢）。
 4. **保存后再次读取校验**——POST 完按同样的端点兼容逻辑重新读取并比对。
@@ -109,7 +106,7 @@ CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完
 
 ### 后端接口执行规则
 
-加解密设置必须由 `scripts/encrypt_setting.py` 调用 `encrypt_api.py` 完成，禁止通过浏览器表单或浏览器自动化写入。浏览器仅可参与 `weaver-work-cli auth login` 登录授权。
+加解密设置必须通过 CLI 的加解密设置操作完成，禁止通过浏览器表单或浏览器自动化写入。浏览器仅可参与 `weaver-work-cli auth login` 登录授权。
 
 - 查询接口优先是 `GET /api/file/thirdPlugEncDec/config`；旧版本返回 404 时，使用
   `POST /api/file/tenant/setting` 读取 `data.encryptionSettings`。保存接口是
@@ -178,8 +175,8 @@ CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完
      - 华途对接出问题 → 找华途侧开发 / 客户运维
      - 亿赛通对接出问题 → 找亿赛通侧开发 / 客户运维
      - 天锐绿盾没生效 → 检查应用服务器本地是否安装(文档:见 setting-encrypt-third-party-plugins.md 一节)
-     - 总部开发**只负责 E10 后台配置项，不管远程服务**；不要试图通过改 E10 设置来"修"
-   - **集成官方支持之外的插件**：走 E10 二开流程（由总部开发评估接入）
+     - **只负责 E10 后台配置项，不管远程服务**；不要试图通过改 E10 设置来"修"
+   - **集成官方支持之外的插件**：走 E10 二开流程评估接入
    - **后端返回致命错误**（已知）：不重试，直接告诉客户失败原因 + 正确路径
    - 话术模板：
      "这里改不了：<原因>。需要去<正确路径>那里先做<前置操作>。
@@ -188,11 +185,7 @@ CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完
 
 ## 宿主
 
-CLI 入口：
-
-```text
-python3 scripts/encrypt_setting.py <cmd> [args]
-```
+CLI 入口：`weaver-work-cli caizhilian run caizhilian.setting-encrypt.<operation>`（操作清单见 SKILL.md 路由表）。
 
 
 ## 与 weaver-setting-attach 的关系
@@ -208,20 +201,6 @@ python3 scripts/encrypt_setting.py <cmd> [args]
 
 ## 版本
 
-- 0.1.0（2026-08-06）首次创建。覆盖 eteams-file 截图"加解密设置" Tab 的 13 字段。
-- 0.2.0（2026-08-06）优化：对话式规则完整内联（去除外部仓库依赖）、字段表加"依赖"列、
-  软链名统一为 `setting-encrypt`、门禁 4 表述修正、删除开发内部决策泄露、版本号规则确立。
-- 0.2.1（2026-08-06）业务知识沉淀：新建 `setting-encrypt-third-party-plugins.md`，写入 3 个官方
-  插件对接步骤 / 限制 / 二开联系人；修正 `encryptPlugs` 常见值（"三未信安"→"天锐绿盾 / 华途"）；
-  对话式规则 6 增加"远程服务/插件对接问题"与"集成官方支持之外插件"两类引导。
-- 1.0.0（2026-08-09）字段大删减：前端 UI 下拉已移除加密机（`encryptMachine`）选项，
-  后端 `EncryptionSettings.toString()` 也漏了 `encryptMachineType` 输出。删除 5 个
-  加密机专属字段（`encrypt-machine-type` / `encrypt-ip` / `encrypt-port` / `encrypt-app-id` /
-  `encrypt-app-key`），CLI 字段表从 13 缩到 8。`encryptPlugs` 现在固定为华途 / 天锐绿盾 /
-  亿赛通 3 个值；3 个软件分支的配置项完全相同，不再有"加密机分支"差异。
-- 1.1.7（2026-09-02）明确只能通过后端接口执行加解密设置，移除浏览器写入流程，保留未保存状态判定和歧义 URL 处理。
-- 1.1.8（2026-09-02）兼容旧版本部署中 `thirdPlugEncDec/config` 不存在的情况：查询和保存后校验在专用接口 404 时改用 `tenant/setting` 的 `encryptionSettings`。
-
 版本号规则 `x.y.z`：
 - **x 升** — 大重构（GET/POST 模式变化、DTO 结构变化、字段大幅增删）
 - **y 升** — 新增字段、新增命令、新增子模块
@@ -242,7 +221,7 @@ python3 scripts/encrypt_setting.py <cmd> [args]
 
 ## EncryptionSettings 完整字段（8 子字段）
 
-> **v1.0.0 (2026-08-09) 字段大删减**:从 13 缩到 8。前端 UI 下拉已移除加密机
+> **字段大删减**：从 13 缩到 8。前端 UI 下拉已移除加密机
 > (`encryptMachine`) 选项,因此删除 `encryptMachineType` / `encryptIp` /
 > `encryptPort` / `encryptAppID` / `encryptAppKey` 5 个加密机专属字段。
 
@@ -286,30 +265,20 @@ GET 端点返回的是**扁平 dict**（8 子字段直接平铺）；POST 时整
    校验时还原为普通 URL。
 4. **license 控制**：没 `ENC_DEC` license 时 GET 返回的 `openEncryptFunction=false`，
    且整个对象字段大多为空。
-5. **encryptScene 校验**：后端 `StoThirdPlugEncDecProcess.java:718-722` 对值
-   做 `equalsIgnoreCase` 比对；不在 enum 内的值会被忽略（不抛错）。
-6. **4 个文件处理字段仅 encryptScene=custom 时生效**：其它场景下后端用预设
-   覆盖这 4 个字段（实际行为见 `StoThirdPlugEncDecProcess.java:755-770`）。
-
-## 后端实现位置
-
-- Controller：`eteams-file/src/main/java/com/weaver/teams/file/e10/mvc/web/thirdplugencdec/FileThirdPlugEncDecController.java`
-- 设置项注册：`eteams-file/src/main/java/com/weaver/teams/file/e10/manager/set/impl/EncryptionSettings.java`
-- 业务逻辑：`eteams-file/src/main/java/com/weaver/teams/file/e10/manager/storage/chain/process/StoThirdPlugEncDecProcess.java`
-- DTO：`eteams-file/src/main/java/com/weaver/teams/file/e10/dto/BaseSetDto.java`（嵌套类 `EncryptionSettings`）
-- 前端 UI：`weapp-file/src/components/pc/FileSet/components/Encryption/index.tsx`
+5. **encryptScene 校验**：后端对值做忽略大小写比对；不在枚举内的值会被忽略（不抛错）。
+6. **4 个文件处理字段仅 encryptScene=custom 时生效**：其它场景下后端用预设值覆盖这 4 个字段。
+
 # 字段对照表（8 个子字段）
 
-> 对应 eteams-file 后端 `BaseSetDto.EncryptionSettings`（嵌套类）。
-> 整对象 toString() 存到 `FileObjTenantPermission.param` 字段。
+> 对应后端「加密设置」嵌套对象，整对象序列化后保存。
 > CLI 接受 snake-case 别名 / 中文别名 / DTO 字段名（驼峰）。
 
 > **数据结构说明**：后端 GET `/api/file/thirdPlugEncDec/config` 返回的是**扁平的
 > EncryptionSettings 字典**（8 个子字段直接平铺，没有外层 `encryptionSettings` 包装）。
 > CLI 内部统一用扁平 dict；POST 时整个扁平对象作为 `encryptionSettings` 字段的值
-> 一起发出去（参考 [setting-encrypt-api.md](setting-encrypt-api.md)）。
+> 一起发出去（参考本文「接口协议」章节）。
 
-> **v1.0.0 (2026-08-09) 字段大删减**:从 13 缩到 8。前端 UI 下拉已移除加密机
+> **字段大删减**：从 13 缩到 8。前端 UI 下拉已移除加密机
 > (`encryptMachine`) 选项,后端 `EncryptionSettings.toString()` 也漏了
 > `encryptMachineType` 输出,因此删除 5 个加密机专属字段
 > (`encrypt-machine-type` / `encrypt-ip` / `encrypt-port` / `encrypt-app-id` /
@@ -333,9 +302,9 @@ GET 端点返回的是**扁平 dict**（8 子字段直接平铺）；POST 时整
 - **后端值**：`est`=亿赛通 / `tipray`=天锐绿盾 / `vtext`=华途
 - **输入别名**：CLI 也接受 `亿赛通` / `天锐绿盾` / `华途`，提交前会转换为上述编码
 - **对接/限制**：
-  - 详细对接步骤、限制、二开联系人见 [setting-encrypt-third-party-plugins.md](setting-encrypt-third-party-plugins.md)
+  - 详细对接步骤与限制需走 E10 二开流程获取（联系管理员）
   - 天锐绿盾**仅支持本地安装**；远程调用方式需走 E10 二开流程
-  - 华途/亿赛通都是远程服务，**总部开发不介入远程服务确认**，找客户/厂商侧
+  - 华途/亿赛通都是远程服务，远程服务的确认与联调由客户/厂商侧负责
 - **示例**：`--item encrypt-plugs=亿赛通`（实际提交 `encryptPlugs=est`）
 
 ## 3. 软件地址
@@ -354,7 +323,7 @@ GET 端点返回的是**扁平 dict**（8 子字段直接平铺）；POST 时整
 - **中文**：`加解密场景` / `场景`
 - **DTO 字段**：`encryptScene`
 - **类型**：enum
-- **值**（前端 `Encryption/index.tsx:122-129` 实际只有 3 个）：
+- **值**（前端实际只有 3 个）：
 
 | 英文 id | 中文 | 含义 |
 |---|---|---|