手机上收到一份 PDF，想提取关键信息；离开电脑后，想继续检查项目里的代码；交给 AI 的任务还没结束，又想补充一个要求——这些需求，都可以从微信发起。
Weixin Link（weixin-link）是一款开源、自托管的微信 AI 助手项目。它把运行在自己电脑上的智能体接入微信，让用户通过聊天提交任务、发送材料、查看进度，并接收生成的文件。 项目采用 MIT 许可证，目前处于 Preview 阶段。
项目地址：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 的产品重点，是围绕微信提供集中整合的安装、项目、任务控制和文件交付流程。 选择时，建议比较实际产品能否顺利完成自己的任务，而不只比较功能名称。
可以用三个问题判断是否适合自己：
- 能否按引导完成安装，接通模型与微信？
- 任务进行时，能否查看进度、补充要求和停止？
- 结果是否便于获取，失败或中断时是否能核对状态？
如何安装 Weixin Link？
项目支持 Linux（x64、arm64）、macOS（Intel、Apple Silicon）和 Windows（x64）。安装步骤以仓库最新 README 为准。
Linux / macOS，在终端运行：
curl -fsSL https://raw.githubusercontent.com/zhangjingwei/weixin-link/main/install.sh | sh
Windows x64，在 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 参与改进。
Conversation
评论