wecomcli-doc-manage

SKILL.md 节选

> 执行任何 `wecom-cli` 命令前，必须先读取并完成 `wecomcli-shared` 技能的公共前置检查。

## 核心概念

- **四种文档类型**：在线文档 `doc`、在线表格 `sheet`、智能表格 `smartsheet`、智能文档 `smartpage`。`doc_type` 枚举在多接口中复用。
- **搜索接口额外支持的类型**：收集表 `collect`、PPT `ppt`、脑图 `mind`、流程图 `flow`、汇报 `journal`、PDF `pdf`。这些类型仅在「搜索文档」接口的 `doc_types` 过滤中可用，其他接口（改名、权限、加入规则等）不适用。

## 适用范围

**适用**：
- 仅支持搜索 doc文档 / 在线表格 / 智能表格 / 智能文档 / PPT / 收集表 / 脑图 / 流程图 / 汇报 / PDF 文档类型
- 仅支持修改 doc文档 / 在线表格 / 智能表格 / 智能文档 的名称
- 仅支持添加 doc文档 / 在线表格 / 智能表格 / 智能文档 的成员权限
- 仅支持设置 doc文档 / 在线表格 / 智能表格 / 智能文档 的加入规则

## 接口路由表

路由表第二列若是 `references/xxx.md` 链接 → 必须先用 `read` 工具读完该文件，再构造命令。

| 用户意图                                                    | 参考位置 |
|---------------------------------------------------------|---|
| 搜索文档（包含最近浏览/创建）                                         | 见下方「搜索文档」 |
| 修改文档名                                                   | [+names-update](references/doc-names-update.md) |
| 添加文档成员 / 改权限                                            | [+members-update](references/doc-members-update.md) |
| 设置链接加入规则                                                | [+rules-update](references/doc-rules-update.md) |

## 接口详述

### 搜索文档

按关键词与过滤条件（类型 / 创建者 / 浏览者-成员 / 时间窗 / 排序）搜索文档

> 关于"浏览者"与"成员"：在本接口的搜索语义下二者等价——`visitor_userids` 命中的是"该 userid 作为浏览者/成员/相关者"的文档，用来表达"包含 X"、"X 参与的"、"与 X 相关的"、"X 作为成员的"均可。**注意权限约束**：无论传谁的 userid，最终结果只会返回**当前调用者本人有权限访问**的文档；他人有权限但你没权限的文档不会出现在结果中，因此本接口不能用于"窥探他人独占的文档列表"。

#### 命令

```bash
wecom-cli doc search --json '<JSON 参数>'
```

#### 参数

| 字段 | 类型 | 必填 | 默认值 | 语义                                                                                                                |
|---|---|---|---|-------------------------------------------------------------------------------------------------------------------|
| `keywords` | string[] | 是 | — | 关键词数组，OR 关系。仅按其他条件过滤时传空数组 `[]`                                                                               |
| `search_scope` | string | 否 | `title_content` | 搜索范围枚举：`title`（仅标题） / `title_content`（标题和内容，默认） / `content`（仅内容）                                                  |
| `doc_types` | string[] | 否 | — | 限定类型，取值为 `doc` / `sheet` / `smartsheet` / `smartpage` / `collect` / `ppt` / `mind` / `flow` / `journal` / `pdf` 的子集 |
| `creator_userids` | string[] | 否 | — | 限定创建者 userid 列表（典型：传当前用户 userid 查"我最近创建"）                                                                         |
| `visitor_userids` | string[] | 否 | — | 限定"浏览者 / 成员" userid 列表                                                                           |
| `created_after` / `created_before` | string | 否 | — | 创建时间窗，`YYYY-MM-DD HH:mm:ss`                                                                                       |

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 4 个文件，合计 13.1 KiB