@amaster.ai/pi-wecom

中文文档
0.1.37发布于 2026/11/09Apache-2.0TypeScriptES Module近 30 天下载 4213

Pi extension for WeCom (enterprise WeChat) workspace — contacts, messages, meetings, schedules, docs and more via wecom-cli.

原始使用文档
文档目录4 节
  1. Features
  2. Configuration
  3. Skills Provided
  4. CLI Reference

@amaster.ai/pi-wecom

pi-wecom preview

Pi extension for WeCom (企业微信) workspace — contacts, messages, meetings, schedules, docs and more via wecom-cli.

Features

  • Auto-installs wecom-cli if not present
  • Injects wecom-cli skills into the agent session
  • Detects authentication status and prompts for QR code login if needed

Configuration

Add to ~/.pi/agent/settings.json or a trusted project's .pi/settings.json:

Project settings are loaded only after project trust is accepted. For environment-backed credentials, use user or agent settings because project settings do not expand ${ENV_VAR}.

{
  "pi-wecom": {
    "botId": "your_bot_id",
    "botSecret": "your_bot_secret"
  }
}
FieldRequiredDescription
botIdYesBot ID from WeCom Admin Console
botSecretYesBot Secret

Note: wecom-cli requires QR code scan for initial authentication. After the extension installs the CLI, run wecom-cli auth init --noninteractive to complete login.

Skills Provided

14 skills from wecom-cli covering:

  • wecomcli-shared — Shared setup and authentication checks
  • wecomcli-message — Messages and conversations
  • wecomcli-contact — Address book, user search
  • wecomcli-meeting — Create, cancel, manage meetings
  • wecomcli-calendar — Schedule CRUD, free/busy
  • wecomcli-todo — Task management
  • wecomcli-email — Email search and reading
  • wecomcli-disk — WeDrive files and folders
  • wecomcli-media — Media upload and download
  • wecomcli-doc-manage — Document search and permissions
  • wecomcli-doc — Online documents
  • wecomcli-sheet — Online spreadsheets
  • wecomcli-smartsheet — Smart Sheet data and structure
  • wecomcli-smartpage — Smart documents

CLI Reference

版本与发布记录

@amaster.ai/pi-wecom 共发布 99 个版本,首次发布于 2026/06/15;过去 12 个月发布了 99 个版本。

版本发布日期距今
0.1.37latest2026/11/09今天
0.1.2-beta.91beta2026/11/072 天前
0.1.2-beta.902026/11/062 天前
0.1.2-beta.892026/11/053 天前
0.1.2-beta.882026/11/054 天前
0.1.362026/11/054 天前

关于 @amaster.ai/pi-wecom 的常见问题

@amaster.ai/pi-wecom 是什么?

Pi extension for WeCom (enterprise WeChat) workspace — contacts, messages, meetings, schedules, docs and more via wecom-cli.

如何安装 @amaster.ai/pi-wecom?

在项目目录运行 npm install @amaster.ai/pi-wecom,或使用 pnpm add / yarn add / bun add。

@amaster.ai/pi-wecom 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@amaster.ai/pi-wecom 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@amaster.ai/pi-wecom 可以商用吗?

@amaster.ai/pi-wecom 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@amaster.ai/pi-wecom 的下载量有多少?

根据 npm 官方下载统计,@amaster.ai/pi-wecom 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,213 次,日均约 140 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@amaster.ai/pi-wecom 还在维护吗?

最新版本 0.1.37 发布于 2026/11/09(今天);至今共发布 99 个版本,其中过去 12 个月发布了 99 个;首次发布于 2026/06/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。