# wecom-cli

**Repository Path**: yeuimu/wecom-cli

## Basic Information

- **Project Name**: wecom-cli
- **Description**: 企业微信 api cli 封装
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-27
- **Last Updated**: 2026-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wecom-cli

企业微信命令行工具，支持智能表格的增删改查操作。

## 安装

```bash
pnpm install
pnpm build
npm link
```

## 快速开始

### 1. 初始化配置

```bash
wecom config init
```

### 2. 创建文档

```bash
wecom doc add --name "项目进度表" --type smart
```

### 3. 查看文档列表

```bash
wecom doc list
```

### 4. 操作智能表格

```bash
# 查询子表
wecom doc smart sheet query --name "项目进度表"

# 添加字段
wecom doc smart field add --name "项目进度表" --sheet-id SHEET_ID --title "姓名" --type 1

# 添加记录
wecom doc smart record add --name "项目进度表" --sheet-id SHEET_ID --record '{"values":{"姓名":"张三"}}'

# 查询记录
wecom doc smart record query --name "项目进度表" --sheet-id SHEET_ID
```

## 配置管理

```bash
# 设置代理
wecom config proxy --https http://proxy:8080

# 查看 token 状态
wecom config token

# 查看配置
wecom config show
```

## 开发

```bash
pnpm dev           # 开发模式运行
pnpm build         # 构建
pnpm test          # 运行测试
pnpm lint          # 代码检查
pnpm format        # 代码格式化
pnpm typecheck     # 类型检查
```

## 双模式使用

### CLI 模式

```bash
wecom doc list -j
```

### 库模式

```typescript
import 'reflect-metadata';
import { AppContext, container } from 'wecom-cli';

const ctx = container.resolve(AppContext);
const client = await ctx.getClient();
const { createDoc } = await import('wecom-cli');

// 方式一：通过容器自动管理 token 和 client
const result = await createDoc(client, 10, '测试文档', undefined, undefined, undefined);

// 方式二：自行创建 WeComClient（不依赖容器）
import { WeComClient, getAccessToken } from 'wecom-cli';
const token = await getAccessToken();
const myClient = new WeComClient({ accessToken: token });
const result2 = await createDoc(myClient, 10, '测试文档', undefined, undefined, undefined);
```