wecomcli-doc-manage

用途

wecomcli-doc-manage 是企业微信文档公共管理技能，专注于企业微信文档的搜索与公共信息管理。它不负责新建或导入文档，也不负责读取正文，而是处理文档的检索、命名、权限与加入规则等管理操作。

支持按关键词与多种过滤条件搜索文档，包括类型、创建者、浏览者/成员、创建时间窗、最近打开时间窗和排序方式。搜索范围可选标题、标题和内容（默认）或仅内容。

可搜索的文档类型包括：doc 文档、在线表格、智能表格、智能文档、收集表、PPT、脑图、流程图、汇报、PDF。

关于“浏览者”与“成员”：在该接口语义下二者等价，visitor_userids 命中的是“该 userid 作为浏览者/成员/相关者”的文档。需注意权限约束：无论传谁的 userid，结果只会返回当前调用者本人有权限访问的文档，因此不能用于查看他人独占的文档列表。

搜索返回字段包含：has_more、next_cursor、docs 列表。单条文档包含 docid、doc_name、doc_type、url、creator_userid、create_time、modify_time、title_highlight、text_highlight。

仅支持修改 doc 文档、在线表格、智能表格、智能文档的名称。

仅支持为 doc 文档、在线表格、智能表格、智能文档添加成员权限。

仅支持为 doc 文档、在线表格、智能表格、智能文档设置加入规则。

wecom-cli 是插件提供的 tool，不是终端命令。所有操作都通过调用该 tool 完成，参数应使用 args 传入，禁止通过 exec、shell、终端等命令行方式使用。

首次调用 wecom-cli 前，必须按 wecomcli-preflight 技能执行前置条件检查，确保工具已加入白名单。

调用格式示例：

wecom-cli doc search --json '{"keywords":["待办 tool","待办","tool","产品"],"search_scope":"title_content","limit":10}'

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

参数组合按意图分派：

(a) 按内容找 → keywords（必填） + search_scope=title_content + sort_by=best_match
(b) 我最近浏览 / 与我相关 / 我作为成员 → visitor_userids=[当前 userid] + sort_by=best_match + opened_after（默认近 7 天）
(c) 包含某人为成员 / 某人参与 → visitor_userids=[他人 userid] + sort_by=best_match，并提醒用户仅返回当前调用者有权限访问的部分
(d) 我最近创建 → creator_userids=[当前 userid] + created_* 时间窗 + sort_by=create_time + created_after（默认近 7 天）

userid 前缀为 wo。用户提供姓名时，需通过 wecomcli-contact 技能解析为 userid，禁止把姓名当 userid 拼接或编造。

keywords 必须先分词再组装：对自然语言 query 做中英文分词，剔除口语化、通用、停用词，挑选强区分度的必传 token，第 1 个元素为必传 token 用空格拼接的串，后续元素依次为各单独 token。若必传 token 只有 1 个，第 1 个元素即该 token 本身。

展示搜索结果时须用 markdown 无序列表逐条展示，禁止使用表格，最多展示 10 条。文档名须为可点击链接，格式为 - doc_name，url 原样取自接口返回字段。默认不展示创建者，creator_userid 禁止输出给用户。

结果多于 1 条时需展示候选列表，等用户选定后再继续；结果为 0 条时告知未搜到并追问更多关键词线索。

仅支持搜索 doc 文档、在线表格、智能表格、智能文档、PPT、收集表、脑图、流程图、汇报、PDF
仅支持修改 doc 文档、在线表格、智能表格、智能文档的名称
仅支持添加 doc 文档、在线表格、智能表格、智能文档的成员权限
仅支持设置 doc 文档、在线表格、智能表格、智能文档的加入规则
搜索接口受调用者自身权限限制，无法查看他人独占且本人无权访问的文档
ppt / journal / collect / mind / flow 类型目前无下游技能或 CLI 能读取正文，命中这些类型且需查看内容时，需告知暂不支持读取，引导用户用 doc_url 在企业微信客户端内打开
读取或打开搜索到的 docid 需按 doc_types 使用对应内容技能：doc 用 wecomcli-doc、smartpage 用 wecomcli-smartpage、sheet 用 wecomcli-sheet、smartsheet 用 wecomcli-smartsheet；首次读取正文前必须 read 对应内容技能的 SKILL.md，命令以其为准，严禁直接拼“读正文”命令
新建或导入 doc 文档请使用 wecomcli-doc；新建或导入在线表格请使用 wecomcli-sheet；智能表格内容 CRUD 请使用对应技能
搜索多候选需确认、搜索意图确认、必填参数（docid、权限角色等）缺失时，需用简洁自然语言追问缺失或有歧义的信息，有候选项时列出供用户选择，不得自行猜测