Pinvou/pinvou-agent is an open-source desktop workspace where an AI agent helps with work, visual design, and software development. People use it to work with files and knowledge, create editable visual artifacts, connect coding agents to projects, and extend the workspace with tools, MCP servers, skills, and workflows; the catalogue skills add capabilities to that environment.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add Pinvou/pinvou-agent --skill wecomcli-doc-managegit clone --depth 1 https://github.com/Pinvou/pinvou-agentWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/pinvou/pinvou-agent/wecomcli-doc-manage)<a href="https://agentmods.dev/skills/pinvou/pinvou-agent/wecomcli-doc-manage"><img src="https://agentmods.dev/badge/skills/pinvou/pinvou-agent/wecomcli-doc-manage/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/pinvou/pinvou-agent/wecomcli-doc-manage"><img src="https://agentmods.dev/badge/skills/pinvou/pinvou-agent/wecomcli-doc-manage.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00116 | $0.02975 |
| Opus 5 | $0.00058 | $0.01488 |
| Sonnet 5 | $0.00023 | $0.00595 |
| Haiku 4.5 | $0.00012 | $0.00298 |
Grade A, and why
wecomcli-doc-manage scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
This is a copy
89% identical to wecomcli-doc-manage — 8 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 133 lines — stays where its author put it; the contents beside it link to each section on GitHub.
执行任何
wecom-cli命令前,必须先读取并完成wecomcli-shared技能的公共前置检查。
核心概念
- 四种文档类型:在线文档
doc、在线表格sheet、智能表格smartsheet、智能文档smartpage。doc_type枚举在多接口中复用。 - 搜索接口额外支持的类型:收集表
collect、PPTppt、脑图mind、流程图flow、汇报journal、PDFpdf。这些类型仅在「搜索文档」接口的doc_types过滤中可用,其他接口(改名、权限、加入规则等)不适用。
适用范围
适用:
- 仅支持搜索 doc文档 / 在线表格 / 智能表格 / 智能文档 / PPT / 收集表 / 脑图 / 流程图 / 汇报 / PDF 文档类型
- 仅支持修改 doc文档 / 在线表格 / 智能表格 / 智能文档 的名称
- 仅支持添加 doc文档 / 在线表格 / 智能表格 / 智能文档 的成员权限
- 仅支持设置 doc文档 / 在线表格 / 智能表格 / 智能文档 的加入规则
接口路由表
路由表第二列若是 references/xxx.md 链接 → 必须先用 read 读完该文件,再构造命令。
| 用户意图 | 参考位置 |
|---|---|
| 搜索文档(包含最近浏览/创建) | 见下方「搜索文档」 |
| 修改文档名 | +names-update |
| 添加文档成员 / 改权限 | +members-update |
| 设置链接加入规则 | +rules-update |
接口详述
搜索文档
按关键词与过滤条件(类型 / 创建者 / 浏览者-成员 / 时间窗 / 排序)搜索文档
关于"浏览者"与"成员":在本接口的搜索语义下二者等价——
visitor_userids命中的是"该 userid 作为浏览者/成员/相关者"的文档,用来表达"包含 X"、"X 参与的"、"与 X 相关的"、"X 作为成员的"均可。注意权限约束:无论传谁的 userid,最终结果只会返回当前调用者本人有权限访问的文档;他人有权限但你没权限的文档不会出现在结果中,因此本接口不能用于"窥探他人独占的文档列表"。
命令
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 |
opened_after / opened_before |
string | 否 | — | 最近打开时间窗,YYYY-MM-DD HH:mm:ss |
sort_by |
string | 否 | best_match |
排序枚举:best_match(默认) / create_time(创建时间) / modify_time(修改时间) |
limit |
int | 否 | 10 |
返回上限,不超过 100 |
cursor |
string | 否 | — | 分页游标;首次传空,后续取上页 next_cursor |
What ships with it
3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- today Changed de0eda48e413
- 10d ago First seen · 133 lines · 116 tokens per session scan A 336654ffd5c4
wecomcli-doc-manage is a skill published in the GitHub repository Pinvou/pinvou-agent (1,779 stars, last pushed today), licensed MIT. It adds 116 tokens to every session and 2,975 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. It is 89% identical to wecomcli-doc-manage, differing in 8 lines, and is treated as a copy.
Other skills, from other repositories
docx
Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when…
doc-coauthoring
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers.…
xlsx
Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or…
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and…
pptx
Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying…
skill-creator
A skill for creating, editing, improving, and testing skills for coding agents.