快速参考

🚀 快速开始 (5分钟)

1. 安装和开发

# 安装依赖
npm install

# 启动开发服务器
npm run dev
# 访问 http://localhost:5173

2. 配置企业微信

编辑 src/js/wecom-config.js:
javascript export const WECOM_CONFIG = { corpId: 'ww1234567890abcdef', agentId: '1000001', redirectUri: 'https://your-domain.com/', apiBaseUrl: '/api' };

3. 后端配置

复制和编辑 .env:
bash cp .env.example .env

编辑 .env:
env WECOM_CORP_ID=ww1234567890abcdef WECOM_APP_SECRET=your_secret WECOM_AGENT_ID=1000001

📁 项目结构速览

src/
├── main.js                    # 入口
├── js/
│   ├── app.js                # 主逻辑
│   ├── wechat-oauth.js        # OAuth 客户端
│   ├── api-client.js          # HTTP 客户端
│   └── utils.js              # 工具函数
└── styles/
    └── main.css              # 样式

🔑 关键 API

用户认证

// 检查是否已认证
if (oauth.isAuthorized()) {
    const user = window.currentUser;
    console.log(user.name);
}

// 获取授权链接
const authUrl = oauth.getAuthUrl();

// 清除用户信息
oauth.clearUserInfo();

HTTP 请求

const apiClient = new ApiClient('/api');

// 获取用户信息
const data = await apiClient.getUserInfoByCode(code);

// 自定义请求
const result = await apiClient.post('/custom-endpoint', {});

工具函数

// 显示消息
showMessage('成功!', 'success');
showMessage('错误!', 'error');

// 复制到剪贴板
await copyToClipboard('text');

// 日期格式化
formatDateTime(new Date());

🔐 安全清单

[ ] 已在企业微信后台配置回调地址
[ ] 已设置可信域名
[ ] 已配置 HTTPS
[ ] 已验证 State 参数
[ ] 已实现权限检查
[ ] 已设置 CSRF 防护

🐛 常见错误

错误	原因	解决方案
`redirect_uri mismatch`	回调地址不匹配	检查配置文件
`获取用户信息失败`	后端 API 问题	检查后端服务
授权码过期	超过10分钟未使用	重新授权
授权时无权限	应用权限配置不足	扩大应用权限范围

📦 部署命令

# 构建
npm run build

# 预览构建
npm run preview

# 启动后端
node server-example.js

🔗 相关链接

💻 环境要求

Node.js 14+
npm 6+ 或 pnpm
HTTPS (生产环境必须)

📞 获取帮助

查看浏览器控制台 (F12)
检查网络请求 (Network 标签)
参考文档中的故障排查
查看企业微信官方文档

提示: 保存此文档快速查阅！