{"id":13648345,"url":"https://github.com/wzpan/dingdang-robot","last_synced_at":"2025-10-01T09:30:36.863Z","repository":{"id":142780367,"uuid":"91250793","full_name":"wzpan/dingdang-robot","owner":"wzpan","description":"🤖 叮当是一款可以工作在 Raspberry Pi 上的中文语音对话机器人/智能音箱项目。","archived":true,"fork":false,"pushed_at":"2018-04-13T07:53:08.000Z","size":1640,"stargazers_count":1858,"open_issues_count":2,"forks_count":535,"subscribers_count":181,"default_branch":"master","last_synced_at":"2024-09-24T02:31:36.272Z","etag":null,"topics":["amazon-echo","cortana","dingdang-robot","google-home","raspberry-pi","robot","speaker"],"latest_commit_sha":null,"homepage":"http://dingdang.hahack.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wzpan.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}},"created_at":"2017-05-14T14:58:36.000Z","updated_at":"2024-09-23T10:20:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"b74963a9-b0c2-42e0-bf46-ea45f503d809","html_url":"https://github.com/wzpan/dingdang-robot","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wzpan%2Fdingdang-robot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wzpan%2Fdingdang-robot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wzpan%2Fdingdang-robot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wzpan%2Fdingdang-robot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wzpan","download_url":"https://codeload.github.com/wzpan/dingdang-robot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219871421,"owners_count":16554409,"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":["amazon-echo","cortana","dingdang-robot","google-home","raspberry-pi","robot","speaker"],"created_at":"2024-08-02T01:04:09.800Z","updated_at":"2025-10-01T09:30:36.441Z","avatar_url":"https://github.com/wzpan.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"叮当——中文语音对话机器人\n=============\n\n注意：本项目已迁移到 [dingdang-robot/dingdang-robot](https://github.com/dingdang-robot/dingdang-robot) ，当前仓库将归档，不再更新维护。\n\n已经使用了 dingdang 的用户，如需正常获得更新支持，可以切换 dingdang 的仓库地址：\n\n``` sh\ncd $HOME/dingdang\ngit remote remove origin\ngit remote add origin https://github.com/dingdang-robot/dingdang-robot.git\n```\n\n叮当是一款可以工作在 Raspberry Pi 上的开源中文语音对话机器人/智能音箱项目，目的是让中国的Hacker们也能快速打造个性化的智能音箱。\n\n\u003ch1 align=\"center\"\u003e\n\u003cimg width=\"250\" src=\"http://onmw7y6f4.bkt.clouddn.com/dingdang-logo.png\" alt=\"dingdang\"\u003e\n\u003c/h1\u003e\n\n\u003cdiv class=\"video\"\u003e\n   \u003cdiv class=\"MIAOPAI_player\" style='width:600px;-moz-user-select:none;-webkit-user-select:none;-ms-user-select:none;-khtml-user-select:none;user-select:none;' \u003e\n   \u003c/div\u003e\n\u003c/div\u003e  \n\n\u003cdiv id=\"demo_placeholder\"\u003e\n\u003c/div\u003e\n\n## Table of Contents\n\n* [特性](#特性)\n* [Demo](#demo)\n* [硬件要求](#硬件要求)\n* [安装](#安装)\n* [升级](#升级)\n* [配置](#配置)\n* [运行](#运行)\n* [退出](#退出)\n* [插件](#插件)\n* [贡献](#贡献)\n* [联系](#联系)\n* [感谢](#感谢)\n* [FAQ](#faq)\n* [免责声明](#免责声明)\n\n## 特性\n\n![叮当的特性](http://onmw7y6f4.bkt.clouddn.com/dingdang-robot2.png)\n\n叮当包括以下诸多特性：\n\n* 模块化。功能插件、语音识别、语音合成、对话机器人都做到了高度模块化，第三方插件单独维护，方便继承和开发自己的插件。\n* 微信接入。支持接入微信，并通过微信远程操控自己家中的设备。\n* 中文支持。集成百度、科大讯飞、阿里、谷歌等多家中文语音识别和语音合成技术，且可以继续扩展。\n* 对话机器人支持。支持接入图灵机器人、Emotibot，未来还将支持接入更多机器人。\n* 全局监听，离线唤醒。支持无接触地离线语音指令唤醒。\n* 灵活可配置。支持定制机器人名字，支持选择语音识别和合成的插件。\n* 智能家居。集成 HomeAssistant 插件，支持语音控制智能家电。\n\n叮当的工作模式：\n\n![叮当的工作模式](http://onmw7y6f4.bkt.clouddn.com/dingdang-workflow.png)\n\n叮当被唤醒后，用户的语音指令先经过在线 STT 引擎进行 ASR 识别成文本，然后对识别到的文本进行技能匹配，交给适合处理该指令的技能插件去处理。插件处理完成后，得到的结果再交给 TTS 引擎合成成语音，播放给用户。\n\n虽然一次交互可能包含多次网络请求，不过带来的好处是：每一个环节都可以被修改和定制。\n\n## Demo\n\n详见 [Demo](https://github.com/dingdang-robot/dingdang-robot/wiki/demo) \n\n## 硬件要求\n\n* Raspberry Pi 全系列，或其他 Linux 主机；\n* USB 麦克风（建议选购麦克风阵列）；\n* 音箱（不建议蓝牙音箱）；\n* 至少 8G 的 Micro-SD 内存卡（刷镜像要求内存卡的实际容量至少 7.9 GB，否则可能刷不成功）；\n* 摄像头（可选，用于拍照）。\n* 读卡器（可选，用于刷镜像进内存卡）。\n\n如果不知道怎么选择，可以参考 [硬件选购建议](https://github.com/dingdang-robot/dingdang-robot/wiki/hardware-choices) 。\n\n## 安装\n\n### 镜像安装\n\n推荐使用镜像安装的方式，像安装 Raspbian 系统一样，安装完后，只需要少量的配置即可立即使用叮当机器人。\n\n* [下载地址](https://github.com/dingdang-robot/dingdang-robot/wiki/changelog)\n\n镜像安装方法详见 [镜像安装](https://github.com/dingdang-robot/dingdang-robot/wiki/install#%E9%95%9C%E5%83%8F%E5%AE%89%E8%A3%85) 。\n\n刷完后记得在启动系统后进入 `raspi-config` 的高级选项中开启 Extend FileSystem，以让内存卡中的剩余空间合并到主分区中。\n\n### 手动安装\n\n见 [手动安装](https://github.com/dingdang-robot/dingdang-robot/wiki/install)。\n\n## 升级\n\n``` sh\ncd /home/pi/dingdang\ngit pull\n```\n\n## 配置\n\n请参考 [配置](https://github.com/dingdang-robot/dingdang-robot/wiki/configuration) 。\n\n## 运行\n\n``` sh\ncd /home/pi/dingdang\npython dingdang.py\n```\n\n建议在 [tmux](http://blog.jobbole.com/87278/) 或 supervisor 中执行。\n\n运行过程中的 log 可以在启动后使用如下命令查阅：\n\n``` sh\ntail -f temp/dingdang.log\n```\n\n如果希望运行过程中直接在屏幕中打印 log ，可以使用如下命令：\n\n``` sh\npython dingdang.py --verbose\n```\n\n## 退出\n\n先使用 `Ctrl-Z` 退出当前会话，然后执行如下命令：\n\n``` sh\nps auwx | grep dingdang  # 查看dingdang的PID号\nkill -9 PID号\n```\n\n## 插件\n\n* [官方插件列表](https://github.com/dingdang-robot/dingdang-robot/wiki/plugins)\n* [第三方插件](https://github.com/dingdang-robot/dingdang-contrib)\n\n\n## 贡献\n\n* 喜欢本项目请先打一颗星；\n* 提 bug 请到 [issue 页面](https://github.com/dingdang-robot/dingdang-robot/issues)；\n* 要贡献代码，欢迎 fork 之后再提 pull request；\n* 插件请提交到 [dingdang-contrib](https://github.com/dingdang-robot/dingdang-contrib) ；\n* 您的捐赠将鼓励我继续完善叮当，支持支付宝、微信等捐赠形式。捐赠的时候，请备注下您的昵称或姓名，我将会把您备注的信息添加到 [捐赠者名单](https://github.com/dingdang-robot/dingdang-robot/wiki/donate-list) 中：\n\n| 支付宝 | 微信支付 |\n| ------ | --------- |\n| \u003cimg src=\"http://7xj89i.com1.z0.glb.clouddn.com/ali_pay_01.jpg\" height=\"248px\" width=\"164px\" title=\"支付宝\" style=\"display:inherit;\"/\u003e | \u003cimg src=\"http://7xj89i.com1.z0.glb.clouddn.com/wechat_pay_02.png\" height=\"248px\" width=\"164px\" title=\"微信支付\" style=\"display:inherit;\"/\u003e |\n\n\n## 联系\n\n* 叮当的主要开发者是 [潘伟洲](http://hahack.com) 。\n* QQ 群：580447290（人数将满，为控制人数，需付费20元入群）\n* 论坛：[bbs.hahack.com](http://bbs.hahack.com)\n\n## 感谢\n\n* 叮当的前身是 [jasper-client](https://github.com/jasperproject/jasper-client)。感谢 [Shubhro Saha](http://www.shubhro.com/), [Charles Marsh](http://www.crmarsh.com/) and [Jan Holthuis](http://homepage.ruhr-uni-bochum.de/Jan.Holthuis/) 在 Jasper 项目上做出的优秀贡献；\n* 微信机器人使用的是 [liuwons](http://lwons.com/) 的 [wxBot](https://github.com/liuwons/wxBot)。\n* 感谢果果 [@qwedc001](http://github.com/qwedc001) 帮忙搭建维护 [论坛](http://bbs.hahack.com) 。\n* 感谢 [@GoldJohnKing](https://github.com/GoldJohnKing) 设计了叮当的 [logo](https://github.com/dingdang-robot/dingdang-robot/issues/39) 。\n\n## FAQ\n\n- 我能否更换成其他唤醒词，而不是叫“叮当”？\n\n  - 能。参见 [修改唤醒词](https://github.com/dingdang-robot/dingdang-robot/wiki/configuration#%E9%85%8D%E7%BD%AE%E9%BA%A6%E5%85%8B%E9%A3%8E) 。[项目站点](http://dingdang.hahack.com) 置顶的视频就演示了与一个名为“小梅”的机器人聊天。\n\n- 百度不太能够准确识别我的指令，怎么办？\n\n  - 参见 [优化百度语音识别准确度](https://github.com/dingdang-robot/dingdang-robot/wiki/configuration#%E4%BC%98%E5%8C%96%E7%99%BE%E5%BA%A6%E8%AF%AD%E9%9F%B3%E8%AF%86%E5%88%AB%E5%87%86%E7%A1%AE%E5%BA%A6) 。\n\n- 为什么取名为“叮当”？\n\n  - 我一开始有多个候选唤醒词，但我发现”叮当“在离线唤醒词中准确率最高。所以取名为“叮当”。\n\n- 我想了解你的系统镜像都做了哪些定制？\n\n  - 请参见 [dingdang 镜像与 Raspbian 系统的区别](https://github.com/dingdang-robot/dingdang-robot/wiki/different-with-raspbian) 。\n  \n- pi 账户默认登录密码是啥？\n\n  - 与 Raspbian 系统默认密码相同，都是 raspberry 。\n\n## 免责声明\n\n* 叮当只用作个人学习研究，如因使用叮当导致任何损失，本人概不负责。\n* 本开源项目与腾讯叮当助手没有任何关系。\n\n![](http://onmw7y6f4.bkt.clouddn.com/post.jpg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwzpan%2Fdingdang-robot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwzpan%2Fdingdang-robot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwzpan%2Fdingdang-robot/lists"}