weaver-work-cli 0.1.23 → 0.1.25

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
@@ -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 字段名）三选一即可：