{"id":15014009,"url":"https://github.com/atorber/puppet-bridge","last_synced_at":"2025-07-01T03:34:55.000Z","repository":{"id":218114526,"uuid":"745583606","full_name":"atorber/puppet-bridge","owner":"atorber","description":"基于开源机器人的微信机器人桥接框架","archived":false,"fork":false,"pushed_at":"2024-11-04T11:20:29.000Z","size":13758,"stargazers_count":48,"open_issues_count":3,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-12T14:45:50.453Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atorber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-01-19T16:46:56.000Z","updated_at":"2025-03-07T17:25:12.000Z","dependencies_parsed_at":"2024-04-15T13:46:03.684Z","dependency_job_id":"5321d868-74a4-4813-8326-e0c35f920627","html_url":"https://github.com/atorber/puppet-bridge","commit_stats":null,"previous_names":["atorber/puppet-exe","atorber/puppet-bridge"],"tags_count":0,"template":false,"template_full_name":"atorber/puppet-xp","purl":"pkg:github/atorber/puppet-bridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fpuppet-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fpuppet-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fpuppet-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fpuppet-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atorber","download_url":"https://codeload.github.com/atorber/puppet-bridge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fpuppet-bridge/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262889154,"owners_count":23380174,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-24T19:45:03.421Z","updated_at":"2025-07-01T03:34:54.971Z","avatar_url":"https://github.com/atorber.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Puppet Bridge\n\n\u003cimg alt=\"GitHub stars badge\" src=\"https://img.shields.io/github/stars/atorber/puppet-bridge\"\u003e \u003cimg alt=\"GitHub forks badge\" src=\"https://img.shields.io/github/forks/atorber/puppet-bridge\"\u003e [![NPM](https://github.com/atorber/puppet-bridge/workflows/NPM/badge.svg)](https://github.com/atorber/puppet-bridge/actions?query=workflow%3ANPM)\n[![NPM Version](https://img.shields.io/npm/v/wechaty-puppet-bridge?color=brightgreen)](https://www.npmjs.com/package/wechaty-puppet-bridge)\n[![npm (tag)](https://img.shields.io/npm/v/wechaty-puppet-bridge/next.svg)](https://www.npmjs.com/package/wechaty-puppet-bridge?activeTab=versions) ![npm downloads](https://img.shields.io/npm/dm/wechaty-puppet-bridge.svg)\n\n\u003c!-- \u003cimg src=\"./docs/images/core.png\" alt=\"chatie puppet bridge\" height=\"350\" align=\"bottom\" /\u003e --\u003e\n\n## 简介\n\npuppet-bridge 是一个虚拟的第三方Wechaty Puppet，实际上它只是一个桥接服务，它将GitHub中开源的机器人桥接到Wechaty，是开源IM bot搬运工\n\n如果你想方便且高效的使用免费的机器人，那么它是一个很好的选择，它不需要token同时又能使用Wechaty进行聊天机器人开发。\n\n获取更多信息 [项目文档](https://www.yuque.com/atorber/chatflow/mean34ibdoonvox4)\n\n## 示例代码\n\n|源项目|WeChat|实例代码|安装|\n|--|--|--|--|\n|[Devo919/Gewechat](https://github.com/Devo919/Gewechat)|iPad协议|[示例代码](./examples/ripe-wechaty-Devo919-Gewechat.ts) |npm i wechaty-puppet-bridge@0.16.0|\n|[lich0821/WeChatFerry](https://github.com/lich0821/WeChatFerry)|v3.9.10.27|[示例代码](./examples/ripe-wechaty-lich0821-WeChatFerry-3091027.ts) |npm i wechaty-puppet-bridge@0.15.0|\n|[jwping/wxbot](https://github.com/jwping/wxbot)|v3.9.8.25|[示例代码](./examples/ripe-wechaty-jwping-wxbot-3090825.ts)|npm i wechaty-puppet-bridge@0.15.0|\n|[ttttupup/wxhelper](https://github.com/ttttupup/wxhelper/tree/dev-3.9.2.23)|v3.9.2.23|[示例代码](./examples/ripe-wechaty-ttttupup-wxhelper-3090223.ts)\u003cbr\u003e (【以管理员身份运行】WeChat客户端)|npm i wechaty-puppet-bridge@0.15.0|\n|[ttttupup/wxhelper](https://github.com/ttttupup/wxhelper/tree/dev-3.9.5.81)|v3.9.5.81|[示例代码](./examples/ripe-wechaty-ttttupup-wxhelper-3090581.ts)\u003cbr\u003e(【以管理员身份运行】WeChat客户端)|npm i wechaty-puppet-bridge@0.15.0|\n|[ttttupup/wxhelper](https://github.com/ttttupup/wxhelper/tree/dev-3.9.8.25)|v3.9.8.25|[示例代码](./examples/ripe-wechaty-atorber-fused-3090825.ts)\u003cbr\u003e(【以管理员身份运行】WeChat客户端)|npm i wechaty-puppet-bridge@0.15.0|\n|[ttttupup/wxhelper](https://github.com/ttttupup/wxhelper/tree/dev-3.9.10.19)|v3.9.10.19|[示例代码](./examples/ripe-bridge-ttttupup-wxhelper-3091019.ts)\u003cbr\u003e(【以管理员身份运行】WeChat客户端)|npm i wechaty-puppet-bridge@0.15.0|\n\n## 使用NPM包\n\npuppet-bridge 已经在[npmjs.com](https://www.npmjs.com/package/wechaty-puppet-bridge)上发布了安装包，Wechaty用户可以直接安装使用\n\n```shell\nnpm i wechaty-puppet-bridge@0.16.0\n```\n\n## 机器人支持\n\n1. Wechat-bot 馈人玫瑰之手，历久犹有余香 [cixingguangming55555/wechat-bot](https://github.com/cixingguangming55555/wechat-bot)\n\n2. wxbot - 聊天机器人 [jwping/wxbot](https://github.com/jwping/wxbot)\n\n3. wxhelper - PC端微信逆向学习 [ttttupup/wxhelper](https://github.com/ttttupup/wxhelper)\n\n4. WeChatFerry - 一个玩微信的工具 [lich0821/WeChatFerry](https://github.com/lich0821/WeChatFerry)\n\n5. Gewechat -  Gewechat🤖，个人微信免费开源框架 [Devo919/Gewechat](https://github.com/Devo919/Gewechat)\n\n## 功能清单\n\npuppet-bridge可以连接所有的通过ws、http、mqtt开放IM访问的聊天机器人。最新功能清单查看 [功能清单](https://www.yuque.com/atorber/chatflow/imovlh1l8ypxmd9n#eTg6)\n\n## API接口\n\nPuppet Bridge是对开源bot项目的API封装，并不会对原生的API进行修改，因此你依然可以使用底层bot的原生API进行开发 [原生API使用说明](https://www.yuque.com/atorber/chatflow/wo5wzr75qdzs1t7p)\n\n## 更新日志\n\n### v0.15.0\n\n- 支持lich0821/WeChatFerry\n\n[查看更多版本记录](https://www.yuque.com/atorber/chatflow/hyy64kf0a0iguy68)\n\n## 推荐\n\n1. [wechatferry/wechatferry](https://github.com/wechatferry/wechatferry)项目完整的实现了[lich0821/WeChatFerry](https://github.com/lich0821/WeChatFerry)，并且作者制作了一个非常精美丰富的使用文档[https://wcferry.netlify.app/](https://wcferry.netlify.app/)\n\n```javascript\nimport { WechatferryPuppet } from '@wechatferry/puppet'\nimport { WechatyBuilder } from 'wechaty'\n\nconst puppet = new WechatferryPuppet()\nconst bot = WechatyBuilder.build({ puppet })\n\nbot.on('message', (msg) =\u003e {\n  msg.text() === 'ding' \u0026\u0026 msg.say('dong')\n})\n  .start()\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatorber%2Fpuppet-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatorber%2Fpuppet-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatorber%2Fpuppet-bridge/lists"}