weaver-work-cli 0.1.24 → 0.1.26

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

@@ -1,14 +1,14 @@
 ---
 name: weaver-setting-attach
-description: "对话式修改\"文件设置 → 附件设置\"页面的 15 个配置项（上传最大、上传格式控制 方式、附件打开方式、批量下载、禁止移动端下载、附加提示、图片压缩、版本清理、 打印转 PDF 等）。通过自然语言 / `setting set --item key=value` 即可完成 GET 全量 → modify（保留原值） → diff 让用户确认 → POST 落库，无需打开 浏览器逐项点击。覆盖 weapp 端 `POST /api/file/tenant/setting` 与 `POST /api/file/tenant/setting/save` 两条接口。Use for 改附件设置、改上传 最大、改附件打开方式、改白名单黑名单、附件批量下载、禁止移动端下载、附加 提示、文件设置、文件上传、格式限制、图片压缩、版本清理、清理文件版本、 打印转 PDF、eteams-file 后台、<your-e10-domain>/info/fileSet/attach."
+description: "对话式修改\"文件设置 → 附件设置\"页面的 15 个配置项（上传最大、上传格式控制 方式、附件打开方式、批量下载、禁止移动端下载、附加提示、图片压缩、版本清理、 打印转 PDF 等）。通过自然语言 / `setting set --item key=value` 即可完成 GET 全量 → modify（保留原值） → diff 让用户确认 → POST 落库，无需打开 浏览器逐项点击。覆盖 weapp 端 `POST /api/file/tenant/setting` 与 `POST /api/file/tenant/setting/save` 两条接口。另提供只读查询：按审批流程 ID 查附件上传目录（caizhilian.setting-attach.list-upload-folders）。Use for 改附件设置、改上传 最大、改附件打开方式、改白名单黑名单、附件批量下载、禁止移动端下载、附加 提示、文件设置、文件上传、格式限制、图片压缩、版本清理、清理文件版本、 打印转 PDF、按流程查上传目录、流程附件目录、流程上传文件夹、eteams-file 后台、<your-e10-domain>/info/fileSet/attach."
 license: Proprietary
 compatibility: 泛微E10采知连配套使用，内部可自由使用与修改，禁止对外分发
 metadata:
   maintainer: unknown
   type: capability
   version: 1.0.0
-  updated: 2026-08-19
-  tags: [附件设置, 上传最大, 格式控制, 批量下载, 图片压缩, 版本清理, 打印转PDF]
+  updated: 2026-10-13
+  tags: [附件设置, 上传最大, 格式控制, 批量下载, 图片压缩, 版本清理, 打印转PDF, 流程上传目录]
 ---
 
 # weaver-setting-attach
@@ -21,7 +21,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` 能正常输出版本号
@@ -60,6 +60,51 @@ weaver-work-cli auth set --eteamsid "PCACCOUNT_xxx"
 | `setting set --item <key=value> [--item ...] [--dry-run] [--yes]` | GET → 合并 → diff → 询问 → POST |
 | `setting diff --item ...` | 只打印 diff，不调任何接口 |
 
+## 按流程查附件上传目录（caizhilian.setting-attach.list-upload-folders）
+
+**只读操作**。用户给出审批流程（含 e-builder 建模流程）的 ID，查该流程的附件会
+上传到哪些知识库文件夹。CLI 会自动合并「通用附件设置」与各「附件字段」的目录
+配置，去重后一次返回。
+
+```text
+weaver-work-cli --json caizhilian run caizhilian.setting-attach.list-upload-folders --input-json '{"workflow_id":"12345"}'
+```
+
+- **入参**：`workflow_id`（审批流程 ID，字符串，必填，不要用 JSON 数字传）。
+- **返回**：`folders` 数组，每项含
+  - `id` / `name` / `path`：文件夹 ID、名称、完整路径；
+  - `sources`：该文件夹的来源列表——`{type:"common_setting"}` 表示来自流程的
+    通用附件设置；`{type:"field", field_id, field_name}` 表示来自某个附件字段的
+    目录配置。同一文件夹出现在多个来源时会合并成多条 `sources`。
+- **行为细节**：只有目录型（folderType=1）的附件字段才查字段级目录，其余字段跳过；
+  个别字段查询失败时跳过该字段，不影响其余来源。
+
+**反向查询**：从文件夹反查哪些审批流程把它设为上传目录，用
+`caizhilian.setting-attach.list-workflows-by-folders`（入参 `folder_ids`）。
+
+**排查提示**：返回空 `folders` 只表示该流程没有配置任何上传目录（或环境不支持），
+先和用户核对流程 ID 是否正确，不要据此断定「流程不存在」或「功能不支持」。
+
+## 按名称搜索审批流程（caizhilian.setting-attach.search-workflows）
+
+**只读操作**。按流程名称模糊搜索审批流程（含 e-builder 建模流程），返回流程 ID、
+名称和类型。典型用途：用户只说了流程名称时，先用本操作搜到流程 ID，再查该流程的
+附件上传目录（`caizhilian.setting-attach.list-upload-folders`）。
+
+```text
+weaver-work-cli --json caizhilian run caizhilian.setting-attach.search-workflows --input-json '{"keyword":"附件文档普通流程"}'
+```
+
+- **入参**：`keyword`（流程名称搜索词，模糊匹配，自动去除首尾空格；可选，不传或
+  空白返回全部流程）、`page_no`（默认 1）、`page_size`（默认 100）。旧字段名 `name`
+  仍可作为 `keyword` 的别名使用，但两者同时出现且取值不一致会报错。
+- **返回**：`{ page_no, page_size, has_next, workflows: [{ id, workflowName, typeName }] }`。
+  `id` 就是 `list-upload-folders` 需要的流程 ID（字符串，后续入参直接引用）。
+- **分页**：默认只查第一页；返回 `has_next=true` 时先告诉用户还有更多结果，由用户
+  决定是否继续翻页，不要自动翻页拉全量。
+- **匹配语义**：按流程名称模糊匹配；同名流程可能有多条（不同分部/类型），用
+  `typeName` 和上下文区分，拿不准时让用户选，不要自行挑一条。
+
 ## 15 个支持字段
 
 字段别名（中文 / 英文 / DTO 字段名）三选一即可：
@@ -70,7 +115,7 @@ weaver-work-cli auth set --eteamsid "PCACCOUNT_xxx"
 | `shard-size` | `uploadShardSize` | 整数 MB | 1 ≤ n ≤ 50 |
 | `format-mode` | `sysFormatWhitesEnable` | `whitelist` / `blacklist` | 切换模式后会自动迁移 `format-list` |
 | `format-list` | `sysFormatWhites` 或 `sysFormatBlacks` | 逗号/分号分隔扩展名 | 自动按当前 mode 写到正确字段 |
-| `non-image-open` | `sysNonImageMediaOpenType` | `newTab` / `popupWindow` | 后端实际只有这两个值（v0.1.0 表格写的 dialog/directDownload 是错的，已纠正） |
+| `non-image-open` | `sysNonImageMediaOpenType` | `newTab` / `popupWindow` | 后端实际只有这两个值 |
 | `image-open` | `sysImageMediaOpenType` | `newTab` / `previewComponent` | |
 | `show-attach-list` | `sysPreviewShowAttachmentList` | bool | |
 | `attach-expand` | `sysAttachmentListDefaultExpand` | bool | |
@@ -84,9 +129,9 @@ weaver-work-cli auth set --eteamsid "PCACCOUNT_xxx"
 | `version-size` | `sysFileVersionSize` | 整数(1-500) / `-1`(不限) | 每个文件最多保留多少个历史版本。**与 `version-time` 互斥**，由 `version-clean-type` 决定生效哪个 |
 | `version-time` | `sysFileVersionTime` | 整数(1-1095) / `-1`(永久) | 每个文件的历史版本保留多少天。**与 `version-size` 互斥**，由 `version-clean-type` 决定生效哪个 |
 | `print-pdf-types` | `sysPrintToPdfFileTypes` | 逗号分隔扩展名 | 打印时需要转 PDF 的扩展名（空 = 未启用，独立项） |
-| `version-clean-type` | `sysAutoClearFileVersionType` | `versionSize` / `versionTime` | 版本清理方式（按份数 / 按时间）—— v0.2.0 补。**决定 `version-size` 和 `version-time` 哪个生效** |
-| `version-size-type` | `sysFileVersionSizeType` | `selected` / `custom` | 份数那一行 UI 状态（selected = 选下拉 / custom = 自定义）—— v0.2.0 补 |
-| `version-time-type` | `sysFileVersionTimeType` | `selected` / `custom` | 时间那一行 UI 状态（selected = 选下拉 / custom = 自定义）—— v0.2.0 补 |
+| `version-clean-type` | `sysAutoClearFileVersionType` | `versionSize` / `versionTime` | 版本清理方式（按份数 / 按时间）。**决定 `version-size` 和 `version-time` 哪个生效** |
+| `version-size-type` | `sysFileVersionSizeType` | `selected` / `custom` | 份数那一行 UI 状态（selected = 选下拉 / custom = 自定义） |
+| `version-time-type` | `sysFileVersionTimeType` | `selected` / `custom` | 时间那一行 UI 状态（selected = 选下拉 / custom = 自定义） |
 
 ### 版本清理设置规则（强制）
 
@@ -105,7 +150,7 @@ weaver-work-cli auth set --eteamsid "PCACCOUNT_xxx"
 
 **单独设置 `version-size` 或 `version-time` 不会生效**，必须同时设置 `version-size-type` 和 `version-time-type` 为 `custom`。
 
-完整别名表见 [setting-attach-field-map.md](setting-attach-field-map.md)。
+完整别名表见本文「字段对照表」章节。
 
 ## 硬性门禁
 
@@ -197,27 +242,13 @@ weaver-work-cli auth set --eteamsid "PCACCOUNT_xxx"
 
 ## 宿主
 
-CLI 入口：
-
-```text
-python3 scripts/attach_setting.py <cmd> [args]
-```
-
-装好后 `setting show / set ...` 即可直接调用。
+CLI 入口：`weaver-work-cli caizhilian run caizhilian.setting-attach.<operation>`（操作清单见 SKILL.md 路由表）。
 
 
 ## 与 weaver-im 的关系
 
 两者**不共享凭证**（`auth_opt2` 决策）。现在统一通过 CLI 托管的认证获取凭证。
 
-## 版本
-
-- 0.1.0（2026-08-06）首次创建。覆盖 eteams-file 截图"附件设置" Tab 的 11 字段。
-- 0.2.0（2026-08-09）补 6 字段：图片压缩(`img-compress` / `img-compress-quality`)、
-  版本清理(`auto-clear-version` / `version-size` / `version-time`)、
-  打印转 PDF(`print-pdf-types`)。这 3 类功能实际也在附件设置同一页
-  (`AttachSet/index.tsx`),0.1.0 时只覆盖 11 项漏了。同时修 `mobile-block`
-  alias 的 `invert=True` 方向写反 bug(CLI true 现在直接对应 DTO true)。
 # 接口协议
 
 ## 端点
@@ -237,7 +268,7 @@ CLI 自动从 `.env.local` / ENV 读取并塞进 Cookie。
 
 ## FileSettingDto 节选（11 字段 + 只读）
 
-完整 DTO 见 eteams-file 仓库 `BaseSetDto.java`。下面只列本 skill 关心的字段：
+完整字段以服务端 DTO 为准。下面只列本 skill 关心的字段：
 
 ```json
 {
@@ -270,25 +301,13 @@ CLI 自动从 `.env.local` / ENV 读取并塞进 Cookie。
 | 401/403 | — | ETEAMSID 失效/没权限，重跑 `setting login --config <name>` |
 | 5xx | — | 后端挂了，看日志 |
 
-## 后端实现位置（参考）
-
-- Controller：`eteams-file/src/main/java/com/weaver/teams/file/e10/mvc/web/FileSettingController.java`
-- DTO：`com.weaver.teams.file.e10.dto.FileSettingDto` / `BaseSetDto`
-- 设置项注册：`com.weaver.teams.file.e10.manager.set.FileSetFactory`
-- 前端调用：`weapp-file/src/api/fileSetApi.ts` 中 `fileSetDatas` / `fileSetSave`
-
 ## POST 注意事项
 
-1. **保存是逐字段 update，不是覆盖式全量**。后端 `fileSettingSave` 遍历 DTO，对**非 null**
-   字段调 `FileSetItemServiceProxy.updateSysFileItem(...)`；null 字段跳过不处理。
-   意味着：未指定字段**不会被清空**（因为后端根本不动它们）。
-2. **但绝对不能透传只读/虚拟字段**——后端用每个字段名 `FileobjTenantPermissionEnum.valueOf(key)`，
-   `sysMaxSingleUploadLimitSize` 等虚拟字段不在 enum 里，会抛
-   `IllegalArgumentException: No enum constant ...` 让整笔事务回滚。
-3. **只 POST 改了的字段**。CLI 用 `field_map.diff` 算出 changed 字段后只发这一份。
-4. **服务端会校验范围**：传超范围值会返回业务异常（status=false / code=500），
-   CLI 会原样打印 `detailErrorMessage`。
-5. **操作日志**：`FileOpLogManager` 会记一条 `fileSetting` 日志（管理员可在"操作日志"里看到）。
+1. **保存是逐字段更新，不是覆盖式全量**。只提交的字段会被修改；未指定字段**不会被清空**。
+2. **绝对不能提交只读/虚拟字段**（如 `sysMaxSingleUploadLimitSize`），会直接报错并让整笔事务回滚。
+3. **只提交改了的字段**，CLI 会自动只发变更字段。
+4. **服务端会校验范围**：传超范围值会返回业务异常，CLI 会原样打印错误信息。
+5. **操作日志**：会记一条附件设置日志（管理员可在"操作日志"里看到）。
 # 字段对照表（11 项）
 
 > 对应 eteams-file 后端 `BaseSetDto` / `FileSettingDto`。

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

@@ -23,7 +23,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` 能正常输出版本号
@@ -96,7 +96,7 @@ backup delete --id 2 --yes
 2. **`prod` 必须 --yes**——防手滑。
 3. **不开开关不能调规则**——`backup update/enable/disable/delete` 在
    `sysLocalFileBackup=false` 时拒绝（关着的备份调规则没意义）。
-4. **period 范围 60-1440 分钟**（后端 `FileBackupManagerImpl.java:57` 校验）；
+4. **period 范围 60-1440 分钟**（后端校验）；
    CLI 也做同样校验。
 5. **新建规则不能走 CLI**——后端没 `/api/file/create/backup/rule` 端点（前端 bug）；
    唯一新建路径是 `backup on` 在无规则时自动建默认。
@@ -174,10 +174,8 @@ backup delete --id 2 --yes
      和备份目录都必须是 E10 应用服务器能访问的目录（不能是客户本机的
      `/Users/xxx`、不能是某个应用节点临时目录、不能是其他服务器的远程
      路径），否则后端写不进去。改路径时 agent **必须**在话术里复述这个约束
-   - **改"备份目录"前必做本地预校验，不发注定失败的请求** — 后端
-     `FileSettingManagerImpl.checkBackupPath`
-     （`src/main/java/com/weaver/teams/file/e10/manager/file/FileSettingManagerImpl.java:276-302`）
-     会拒 5 类路径，agent 改路径前**必须**在 CLI 端先把目标路径跑一遍
+   - **改"备份目录"前必做本地预校验，不发注定失败的请求** — 后端会拒 5 类路径，
+     agent 改路径前**必须**在 CLI 端先把目标路径跑一遍
      等价校验，任一不过**直接告诉客户"后端会拒：<原因>"，让客户重新给路径**，
      **不要**静默发请求让后端报错。5 项校验：
 
@@ -187,9 +185,7 @@ backup delete --id 2 --yes
      4. 不能等于源目录（源目录按 `;` 切分后逐个比较）
      5. 不能是源目录的子目录（源目录末尾补 `/` 后取备份路径前 N 位对比）
 
-     CLI 已有 `_validate_backup_path()` 函数封装这 5 项（`scripts/backup_setting.py`），
-     `cmd_update` 在 `--backup-path` 显式传值时自动跑，错误打到 stderr 并
-     `return 4`，不发请求。常见客户语言：
+     CLI 会在 `--backup-path` 显式传值时自动跑这 5 项校验，不通过直接报错返回，不发请求。常见客户语言：
      - "路径要以 / 开头"（CODE_20080）
      - "路径不能含特殊字符 \* ? \" < > |"（CODE_20078）
      - "路径不能含空白 / 分号 / 单引号 / 全角问号"（FILE_PATH 正则）
@@ -224,11 +220,7 @@ backup delete --id 2 --yes
 
 ## 宿主
 
-CLI 入口：
-
-```text
-python3 scripts/backup_setting.py <cmd> [args]
-```
+CLI 入口：`weaver-work-cli caizhilian run caizhilian.setting-backup.<operation>`（操作清单见 SKILL.md 路由表）。
 
 
 ## 与 weaver-setting-attach / weaver-setting-encrypt 的关系
@@ -244,28 +236,6 @@ python3 scripts/backup_setting.py <cmd> [args]
 
 ## 版本
 
-- 0.1.0（2026-08-06）首次创建。
-- 0.2.0（2026-08-06）优化：对话式规则完整内联 6 条（去除外部仓库依赖），加上 backup
-  特有"业务前置 + 路径约束 + 典型部署模板"作为规则 6/7 整合；重写"与 attach/encrypt
-  关系"段（删开发内部决策）；门禁 1 补对话确认说明；加版本号规则。
-- 0.2.1（2026-08-09）优化：规则 3 `show` / `list` 规则详情输出格式改为按列表
-  逐项展示，规则名前不再显示 `规则 #<id>`，直接用规则名。
-- 0.2.2（2026-08-09）澄清：业务上后端只支持 1 条"默认备份规则"，不能
-  新建第二条。规则 6 改写为"只支持 1 条默认规则，不能新增"，去掉
-  "新建规则没 CLI 入口"的旧表述（之前会让用户去找 weapp 后台手动加，
-  实际是后端根本不支持）。
-- 0.2.3（2026-08-09）修 bug + 加预校验：
-  - `scripts/backup_api.py 的 `get_rule`` 参数从 `id` 改为 `backupId`（后端
-    `FileBackupServiceImpl.getBackupRule:88` 校验的是 `backupId`，传 `id`
-    被拒）
-  - `scripts/backup_setting.py 的 `cmd_update`` 拉详情时多下沉一层到 `weaForm.data`，
-    否则 `backupName` 等字段读到空串
-  - 规则 6 加"改备份目录前必做本地预校验"：把后端
-    `FileSettingManagerImpl.checkBackupPath:276-302` 的 5 项校验
-    （`/` 开头 / 硬禁字符 / FILE_PATH 正则 / 不等于源路径 / 非源路径子目录）
-    搬到 CLI 端 `_validate_backup_path()`，update 前自动跑，错误直接
-    拦在客户端不发请求
-
 版本号规则 `x.y.z`：
 - **x 升** — 大重构（接口变化、DTO 结构变化、命令大幅增删）
 - **y 升** — 新增命令、新增子模块、新增业务场景
@@ -292,7 +262,7 @@ python3 scripts/backup_setting.py <cmd> [args]
 
 1. **开关是逐字段 update**：只传 `sysLocalFileBackup` 一个字段，后端不会清空
    其它字段（参考 agent memory 中 weaver-setting-attach 的同款经验）。
-2. **开开关 + 无规则 = 自动建默认规则**——`SysLocalFileBackup.java:138-159`：
+2. **开开关 + 无规则 = 自动建默认规则**：
    ```java
    getInitFileBackup(tenantKey, newValue)
    → 取第一个 LOCAL_STORE 实例 → 构造 BackupRuleCreateParam
@@ -302,19 +272,12 @@ python3 scripts/backup_setting.py <cmd> [args]
 3. **新建规则的端点不存在**——前端 `createBackupRule` 调的是
    `/api/file/create/backup/rule`，后端 `FileBackupController` 里**没有**这个
    端点。前端 bug，CLI 不暴露 `create`。
-4. **period 范围 60-1440 分钟**——后端 `FileBackupManagerImpl.java:57` 校验。
+4. **period 范围 60-1440 分钟**——后端校验。
 5. **delete 是批量**——body 是 `{ids: [N1, N2, ...]}`；CLI 一次只支持一个
    id，多个需要循环。
 6. **enable 接口的字段是 `enableStatus`（Boolean），不是 `enabled`**——后端
    `BackupRuleEnableParam` 用 `enableStatus` 字段。
 
-## 后端实现位置
-
-- Controller：`eteams-file/src/main/java/com/weaver/teams/file/e10/mvc/web/FileBackupController.java`
-- 开关注册：`eteams-file/src/main/java/com/weaver/teams/file/e10/manager/set/impl/SysLocalFileBackup.java`
-- 规则 CRUD：`eteams-file/src/main/java/com/weaver/teams/file/e10/service/web/impl/FileBackupServiceImpl.java`
-- Param/DTO：`eteams-file/src/main/java/com/weaver/teams/file/e10/param/BackupRule*.java`
-- 前端 UI：`weapp-file/src/components/pc/FileSet/components/BackupSet/`
 # 字段说明
 
 ## 顶层：本地备份开关
@@ -322,7 +285,7 @@ python3 scripts/backup_setting.py <cmd> [args]
 - **DTO 字段**：`sysLocalFileBackup`（Boolean）
 - **GET 端点**：`POST /api/file/tenant/setting`
 - **SAVE 端点**：`POST /api/file/tenant/setting/save`（只传这一个字段）
-- **特殊行为**：开时如果当前无规则，**自动建默认规则**（用第一个本地存储实例的 path，详见 `SysLocalFileBackup.java:138-159`）
+- **特殊行为**：开时如果当前无规则，**自动建默认规则**（用第一个本地存储实例的 path）
 
 ## 备份规则字段
 
@@ -360,13 +323,12 @@ python3 scripts/backup_setting.py <cmd> [args]
 
 ## ⚠️ 已知坑
 
-1. **没有"新建规则"接口**——后端 `FileBackupController` 没有
-   `/api/file/create/backup/rule` 端点；前端代码 `RuleDialog.tsx:120` 调了但
-   后端没实现，是个**前端 bug**。CLI 不暴露 `create` 子命令。
+1. **没有"新建规则"接口**——后端没有新建规则端点（前端页面调了但后端没实现，是个**前端 bug**）。
+   CLI 不暴露 `create` 子命令。
 2. **唯一新建路径**：`backup on` 开启本地备份时如果无规则会自动建默认
    （用第一个本地存储实例的 path）。如果租户没有本地存储实例，
-   `SysLocalFileBackup.java:142` 会抛 `BusinessException("no useful local storage")`。
+   后端会报"没有可用的本地存储"错误。
 3. **规则操作需要本地备份开启**——CLI 在 `update/enable/disable/delete` 前
    会 GET 一次 settings 检查 `sysLocalFileBackup`，没开会拒绝并提示先 `on`。
-4. **period 范围 60-1440**（后端 `FileBackupManagerImpl.java:57` 校验），
+4. **period 范围 60-1440**（后端校验），
    CLI 也做同样校验；非整数倍数的"1440"会被四舍五入（按分钟）。

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 | 中文 | 含义 |
 |---|---|---|