核心用法
weixin-connect 是专为个人微信（非企业微信）设计的标准化连接技能。用户触发关键词如"连接个人微信""微信扫码登录"后，系统将严格执行四步流程：检查/安装插件 → 调用 ilink API 获取二维码 → PNG 生成并双保险上传（CDN 优先+workspace 备份）→ 用户扫码确认后轮询状态、写入凭证、重启 Gateway。
关键特性包括：二维码 CDN 加速展示确保加载稳定；workspace 本地备份兜底防止上传失败；严格的步骤锁定机制防止跳步或自由发挥；凭证文件自动生成并设置 0600 权限保障安全。
显著优点
1. 官方背书：基于腾讯微信 ilink 官方接口，token 与 bot_id 体系与微信生态原生兼容
2. 双保险机制：CDN 展示 + workspace 备份，兼顾用户体验与可靠性
3. 流程刚性：写死步骤禁止跳步，避免人工干预导致的配置错误
4. 安全设计：凭证文件权限 0600，索引与账户分离存储，最小化攻击面
5. 状态透明：轮询状态实时反馈（wait/scaned/confirmed/expired），用户感知清晰
潜在缺点与局限
1. 时效约束：二维码有效期仅约 1 分钟，网络延迟可能导致过期需重试
2. 单点依赖：完全依赖 ilink 官方服务可用性，无降级方案
3. 人工卡点：必须等用户主动回复"ok"才启动轮询，无法全自动完成
4. 平台局限：明确排除企业微信（WeCom），需用户准确区分两者
5. 重试边界：CDN 上传 3 次失败后强制 workspace 兜底，无更多弹性
适合人群
- 需要将 AI 助手接入个人微信进行私域运营的个人开发者
- 追求标准化、可复现部署流程的技术团队
- 对凭证安全与操作审计有合规要求的组织
常规风险
1. 凭证泄露：虽然文件权限 0600，但若主机本身被入侵仍存在风险
2. 接口变更：ilink 官方 API 调整可能导致流程中断
3. 社交封号：高频或异常行为可能触发微信风控
4. CDN 可用性：CDN 服务异常时用户体验下降（虽有兜底）