{"id":14994558,"url":"https://github.com/wechaty/puppet-oicq","last_synced_at":"2026-06-14T17:01:34.162Z","repository":{"id":46090489,"uuid":"394493387","full_name":"wechaty/puppet-oicq","owner":"wechaty","description":"Wechaty Puppet for QQ based on project takayama-lily/oicq-template","archived":false,"fork":false,"pushed_at":"2021-11-21T17:12:20.000Z","size":193,"stargazers_count":15,"open_issues_count":17,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-28T20:58:03.896Z","etag":null,"topics":["chatbot","oicq","puppet","qq","sdk","wechaty"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/wechaty-puppet-oicq","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/wechaty.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}},"created_at":"2021-08-10T01:45:15.000Z","updated_at":"2024-05-24T14:48:59.000Z","dependencies_parsed_at":"2022-09-03T06:51:25.652Z","dependency_job_id":null,"html_url":"https://github.com/wechaty/puppet-oicq","commit_stats":null,"previous_names":["anaivebird/wechaty-puppet-oicq"],"tags_count":0,"template":false,"template_full_name":"wechaty/puppet-mock","purl":"pkg:github/wechaty/puppet-oicq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wechaty%2Fpuppet-oicq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wechaty%2Fpuppet-oicq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wechaty%2Fpuppet-oicq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wechaty%2Fpuppet-oicq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wechaty","download_url":"https://codeload.github.com/wechaty/puppet-oicq/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wechaty%2Fpuppet-oicq/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34329738,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["chatbot","oicq","puppet","qq","sdk","wechaty"],"created_at":"2024-09-24T16:03:52.231Z","updated_at":"2026-06-14T17:01:34.105Z","avatar_url":"https://github.com/wechaty.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WECHATY PUPPET OICQ (基于[OICQ](https://github.com/takayama-lily/oicq)项目的QQ机器人)\n\n[![Powered by Wechaty](https://img.shields.io/badge/Powered%20By-Wechaty-brightgreen.svg)](https://wechaty.js.org)\n\n[![NPM Version](https://badge.fury.io/js/wechaty-puppet-oicq.svg)](https://www.npmjs.com/package/wechaty-puppet-oicq)\n[![npm (tag)](https://img.shields.io/npm/v/wechaty-puppet-oicq/next.svg)](https://www.npmjs.com/package/wechaty-puppet-oicq?activeTab=versions)\n\n## 运行方法\n\n### 配置系统环境变量\n\n1. `WECHATY_PUPPET_OICQ_QQ`：要登录的QQ号\n\n### 安装依赖\n\n将代码clone到本地，执行`npm install`\n\n### 运行示例代码\n\n`npm run start`\n\n按照提示完成扫码完成后按下回车，即可运行示例机器人\n\n## Getting Started with Wechaty\n\n```sh\nexport WECHATY_PUPPET=wechaty-puppet-oicq\nnpm start\n```\n\nLearn more for building your first Wechaty bot at \u003chttps://github.com/wechaty/wechaty-getting-started\u003e\n\n## 项目介绍\n\n“开源软件供应链点亮计划-暑期2021”（以下简称 暑期2021）是由中科院软件所与 openEuler 社区共同举办的一项面向高校学生的暑期活动，旨在鼓励在校学生积极参与开源软件的开发维护，促进国内优秀开源软件社区的蓬勃发展。\n\n根据项目的难易程度和完成情况，参与者还可获取“开源软件供应链点亮计划-暑期2021”活动奖金和奖杯。\n\n官网：\u003chttps://summer.iscas.ac.cn\u003e\n\n## Wechaty\n\n[Wechaty](https://wechaty.js.org) 是一个开源聊天机器人框架SDK，具有高度封装、高可用的特性，支持NodeJs, Python, Go 和Java 等多语言版本。在过去的5年中，服务了数万名开发者，收获了 Github 的 9600 Star。同时配置了完整的DevOps体系并持续按照Apache 的方式管理技术社区。\n\n## 项目名称\n\n开发支持 QQ 聊天软件的 [Wechaty Puppet Provider](https://wechaty.js.org/docs/puppet-providers/) 模块\n\n## 背景介绍\n\nWechaty 社区目前已经支持微信、Whatsapp、企业微信、飞书等常见流行即时通讯工具，并且能够通过多语言 SDK （比如 Python Wechaty） 进行调用。\n\nQQ 是国内和微信并列的两大聊天软件。我们在本次 Summer 2021 的项目中，Wechaty 希望可以实现对 QQ Chatbot 的支持。通过 Wechaty Puppet 的接口，可以将 QQ 进行 RPA 封装，使其成为 `wechaty-puppet-qq`  供 Wechaty 开发者方便接入 QQ 平台，使其成为 Wechaty 可以使用的社区生态模块。\n\n## 需求介绍\n\n使用 \u003chttps://github.com/wechaty/wechaty-puppet-mock\u003e 项目作为模版，参考社区其他的 [Wechaty Puppet Provider](https://wechaty.js.org/docs/puppet-providers/) 代码模块，对 QQ 进行规划、RPA选型、原型测试，和最终的代码封装。\n\n这里有一个专门讲解如何开发 Wechaty Puppet Provider 的 workshop 视频，它以 `wechaty-puppet-official-account` 作为例子，做了从0到1的入门讲解：[Wechaty Workshop for Puppet Makers: How to make a Puppet for Wechaty](https://wechaty.js.org/2020/08/05/wechaty-puppet-maker/)。通过观看这一个小时的视频，应该可以系统性的了解如何完成构建一个 Wechaty Puppet Provider 模块。\n\n在初期开发中，能够实现文本消息的接收和发送，即可完成原型验证 POC 。\n\n还可以参考以下链接：\n\n1. TypeScript Puppet Official Documentation: \u003chttps://wechaty.github.io/wechaty-puppet/typedoc/classes/puppet.html\u003e\n1. Wechaty Puppet Specification: \u003chttps://wechaty.js.org/docs/specs/puppet\u003e\n1. \u003chttps://github.com/wechaty/wechaty-puppet-mock\u003e\n\n## 导师联系方式\n\n1. [李佳芮](https://wechaty.js.org/contributors/lijiarui/): Wechaty co-creator, Founder \u0026 CEO of Juzi.BOT (rui@chatie.io)\n1. [李卓桓](https://wechaty.js.org/contributors/huan)：Wechaty creator, Tencent TVP of Chatbot (huan@chatie.io)\n\n## 项目产出目标\n\n1. 每日代码 commit\n1. 每周提交一份 report （回复本 issue）\n1. 每两周一次在线会议\n1. 发布 Git Repo `wechaty-puppet-qq`\n1. 可以通过 Wechaty 加载 wechaty-puppet-qq 模块，并通过 QQ RPA 底层，实现文本消息的收发功能\n1. 提供一个 `examples/ding-dong-bot.ts` ，完成“接收到文字消息`ding`时，自动回复消息`dong`\\\"的功能\n1. 配置 GitHub Actions 实现自动化测试* （可选）\n\n## 项目技术栈\n\n1. TypeScript programming language\n2. Git\n3. [RPA](https://wechaty.js.org/docs/explainations//rpa)\n\n## Links\n\n- \u003chttps://github.com/wechaty/wishlist/issues/9\u003e\",\n\n## 相关链接\n\n- [Wechaty](https://wechaty.js.org/v/zh/)\n- [Express](https://www.runoob.com/nodejs/nodejs-express-framework.html)\n- [TypeScripts中文手册](https://www.tslang.cn/docs/handbook/basic-types.html)\n\n## History\n\n### main v1.0 (Oct 29, 2021)\n\nRelease v1.0 of Wechaty Puppet Provider for QQ.\n\n- v0.1 (Sep 22, 2021): ES Modules support\n\n### v0.0.1 (Jun 22, 2021)\n\n- [OSPP 2021 Project started](https://github.com/wechaty/summer/issues/81)\n\n## Author\n\n[@naivebird](https://wechaty.js.org/contributors/anaivebird/)\n\n## Copyright \u0026 License\n\n- Code \u0026 Docs © 2021-2021 @naivebird and Wechaty Contributors\n- Code released under the Apache-2.0 License\n- Docs released under Creative Commons\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwechaty%2Fpuppet-oicq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwechaty%2Fpuppet-oicq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwechaty%2Fpuppet-oicq/lists"}