# Weixin Link 是什么？把微信变成个人 AI 工作入口的开源项目

> Weixin Link 是一款开源自托管微信 AI 助手，将本地智能体接入微信，支持通过聊天提交 PDF 等文件、发起代码审查及查看任务进度。

原文：/knowledge/weixin-link-%E6%98%AF%E4%BB%80%E4%B9%88-%E6%8A%8A%E5%BE%AE%E4%BF%A1%E5%8F%98%E6%88%90%E4%B8%AA%E4%BA%BA-ai-%E5%B7%A5%E4%BD%9C%E5%85%A5%E5%8F%A3%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE

手机上收到一份 PDF，想提取关键信息；离开电脑后，想继续检查项目里的代码；交给 AI 的任务还没结束，又想补充一个要求——这些需求，都可以从微信发起。

**Weixin Link（weixin-link）是一款开源、自托管的微信 AI 助手项目。它把运行在自己电脑上的智能体接入微信，让用户通过聊天提交任务、发送材料、查看进度，并接收生成的文件。** 项目采用 MIT 许可证，目前处于 Preview 阶段。

项目地址：[github.com/zhangjingwei/weixin-link](https://github.com/zhangjingwei/weixin-link)

## Weixin Link 适合谁？

- **开发者**：希望离开电脑后，仍能从微信发起代码检查、问题排查和代码审查。
- **经常处理材料的人**：希望把手机收到的文档交给 AI 整理，再拿到摘要、清单或 CSV 文件。
- **个人 AI 助手用户**：希望在熟悉的微信窗口里持续处理日常事务与不同项目。
- **自托管爱好者**：希望把助手部署在自己的设备上，管理工作区、模型接入和工具权限。

实际任务能力取决于所选模型、智能体、工具与授权范围；安装完成不意味着自动获得所有外部服务的访问权限。

## 在微信里，可以交给它什么任务？

### 1. 手机发材料，微信收成果

给助手发送 PDF、Office 文档或图片，并说明目标，例如：

> 提取这份文件里的关键日期、金额和待办事项，整理成清单。

也可以继续要求：

> 把结果整理成 CSV 文件发给我。

Weixin Link 支持接收材料和交付生成的文件，让微信承担任务入口与结果接收的角色。它能否完整理解某个文件，仍取决于文件格式、内容与当前解析能力。

### 2. 离开电脑后，继续处理开发任务

在已配置并授权的工作区内，可以提出这样的需求：

> 检查这个项目的测试失败原因，修复后告诉我改了什么，以及验证结果。

项目也提供明确的代码审查入口：

- `代码审查`：检查当前工作区的未提交变更。
- `对比审查`：指定基准分支，检查相对该分支的变更。
- `审查提交`：从最近提交中选择一次进行审查。

这些操作让审查范围更明确，适合从手机发起具体的开发工作。审查结论仍需要结合测试和人工判断使用。

### 3. 任务进行中，还能补充和干预

发出需求后，可以通过微信了解当前任务，而不必一直守着电脑：

- `状态`：查看任务与发送状态。
- `进度`：查看当前处理进展。
- `补充`：按提示追加当前任务的要求。
- `停止`：停止当前任务并清空排队消息。
- `结果`：查看最近一次结果。
- `恢复`：核对已提交但结果未确认的任务。

例如，助手正在修改代码时，可以通过“补充”说明“保留原接口，新增兼容实现”。补充功能用于仍在执行的任务，任务结束后不能继续追加到原任务中。

### 4. 在一个微信窗口里，分开管理不同项目

日常事务、代码项目和资料整理，可以使用不同会话。Weixin Link 提供项目创建、列表、切换、历史、归档和还原等操作。

它还支持会话分叉和旁支：讨论方案 A 的过程中，可以创建另一条思路探索方案 B，同时保留原有进展。不同工作可以分别延续，减少在一段聊天中反复切换背景的负担。

### 5. 在授权后连接其他设备和服务

项目提供 SSH、Home Assistant 只读查询和 RSSHub 新闻源等可选集成。可以根据需要启用，用于远程设备操作、家中设备状态查询或信息收集。

这些能力需要单独配置和授权。远程主机可连接，也不代表助手可以不受限制地操作其中所有目录和服务。

## Weixin Link 的特点是什么？

### 一体化安装与维护入口

安装器把模型配置、登录和连接检查放进统一引导。安装、升级、重新登录微信和卸载，也有统一菜单入口。

对希望自行部署微信 AI 助手的用户来说，这减少了自己寻找组件和拼接配置流程的工作。

### 把项目与任务管理直接放进微信

Weixin Link 的设计重点包括项目切换、任务进度、执行中补充、停止、结果查询与会话分支。这些能力构成了可以直接使用的工作流程。

对用户来说，关注点是：当前在做哪件事、做到哪一步、能否调整要求，以及最后拿到什么结果。

### 为中断和交付异常设计处理机制

项目实现了持久任务队列、去重、任务恢复与结果投递相关机制，并提供状态和恢复入口。

这些机制有助于核对任务与交付状态，但不意味着任何任务都能无损续做，也不保证微信消息一定到达或已读。遇到断网、服务重启或外部接口异常时，仍需结合实际状态排查。

### 自托管、源码开放

服务部署在自己的电脑上，用户可以检查源码、管理本机账号配置，并决定授权哪些工作区和服务。

自托管也需要准确理解数据边界：使用云端模型时，相关输入仍可能发送给所选模型服务；通过微信收发的内容也会经过微信服务。自托管不等于全部数据都离线处理。

## Weixin Link 与基于 OpenClaw 的微信助手有什么区别？

两者在具体任务上可能重叠，例如处理文件、调用工具和执行开发任务。不能仅凭底座名称判断谁更聪明、更安全或更可靠。

**Weixin Link 的产品重点，是围绕微信提供集中整合的安装、项目、任务控制和文件交付流程。** 选择时，建议比较实际产品能否顺利完成自己的任务，而不只比较功能名称。

可以用三个问题判断是否适合自己：

1. 能否按引导完成安装，接通模型与微信？
2. 任务进行时，能否查看进度、补充要求和停止？
3. 结果是否便于获取，失败或中断时是否能核对状态？

## 如何安装 Weixin Link？

项目支持 Linux（x64、arm64）、macOS（Intel、Apple Silicon）和 Windows（x64）。安装步骤以仓库最新 README 为准。

Linux / macOS，在终端运行：

```sh
curl -fsSL https://raw.githubusercontent.com/zhangjingwei/weixin-link/main/install.sh | sh
```

Windows x64，在 PowerShell 运行：

```powershell
& ([scriptblock]::Create((Invoke-RestMethod 'https://raw.githubusercontent.com/zhangjingwei/weixin-link/main/install.ps1')))
```

按安装器提示选择模型接入方式、完成授权和微信登录。当前安装引导提供订阅登录、DeepSeek、Qwen 和 Kimi 等选择，具体可用性与费用以相应服务及账号条件为准。

模型服务需要相应网络连接；电脑需要保持运行并联网，助手才能持续接收和执行任务。密码和 API Key 不要发送到微信聊天中。

## 常见问题

### Weixin Link 是微信官方产品吗？

不是。Weixin Link 是独立开源项目，不代表微信、OpenAI 或其他服务提供方的官方产品或背书。

### Weixin Link 免费吗？

项目采用 MIT 许可证，源码开放。运行所需的模型订阅、API 调用、设备和网络可能产生费用。开源不等于所有使用成本都免费。

### 必须使用 Codex 订阅吗？

安装引导也提供 DeepSeek、Qwen、Kimi 等模型配置选项。模型服务与智能体底座属于不同层次，具体支持方式请查看当前版本文档。

### 支持普通微信群吗？

当前使用指南要求在微信私聊中使用，暂不支持普通微信群。

### 可以离线运行吗？

不能把它视为完整离线方案。微信通信需要联网，使用云端模型也需要连接对应服务。

### 目前适合直接承担关键业务吗？

项目处于 Preview 阶段。建议先从文档整理、代码审查等可核对的任务开始，逐步了解效果与权限范围；涉及重要数据和不可逆操作时保留人工确认。

## 从一个真实的小任务开始

第一次使用，可以发送一份不含敏感信息的文档，让助手提取要点并生成文件；开发者也可以先对一个测试项目做代码审查。

体验过程中，除了看回答质量，也可以检查进度查询、项目切换和结果获取是否符合自己的习惯。

如果这些流程解决了你的实际问题，欢迎给项目点一个 Star；遇到问题，可以提交包含版本、复现步骤和脱敏错误信息的 Issue，也欢迎通过 Pull Request 参与改进。

- [项目主页与安装说明](https://github.com/zhangjingwei/weixin-link)
- [完整使用指南](https://github.com/zhangjingwei/weixin-link/blob/main/USER-GUIDE.md)
- [配置与维护](https://github.com/zhangjingwei/weixin-link/blob/main/CONFIGURATION.md)
- [反馈问题](https://github.com/zhangjingwei/weixin-link/issues)
- [贡献指南](https://github.com/zhangjingwei/weixin-link/blob/main/CONTRIBUTING.md)