请查看发布页面以获取最新的预编译下载。
功能强大且易于扩展的 iMessage 机器人。它可以将聊天机器人功能添加到任何 iMessage 对话中。它包括一些内置的基本命令。API 集成、游戏、自定义表情等可以通过使用 webhooks、REST API 或安装插件来添加。
非常感谢任何拉取请求和新的 GitHub 问题!如果您想为 Jared 开发插件,请参阅下面的插件部分。如果您有任何想法/建议,可以随时在 Twitter 上联系我。
Jared 必须在运行 macOS 且已登录活动消息帐户的计算机上运行。它仅在 10.14 Mojave 及更高版本上进行了测试。它可能适用于旧版本的 macOS,但这不能保证,因为消息数据库的架构可能已更改。如果您不希望 Jared 以您的身份发帖,建议您在 Mac 上创建一个新的 Apple ID 和用户帐户,并在该用户下在后台运行它。这样它就不会使用您的主 Apple ID。
请参阅顶部的下载部分。
这是必需的,因为 macOS 权限限制对消息数据库的访问。
如果您运行的是 macOS Catalina 或更高版本,则需要允许 Jared 访问以自动执行消息应用程序。这允许 Jared 发送消息。
您可以选择允许 Jared 访问您的联系人,以便它可以提供和更新联系人姓名。联系人仅用于设置/检索名称。
如果您希望使用 REST API,则需要启用它。如果您的 Mac 上启用了防火墙,您将看到一个对话框,提示您允许 Jared 访问其绑定的端口。
作为参考,这里是 Jared 内置的命令列表。由于可以通过插件添加功能,因此内置功能保持轻便。
/help
:列出所有命令。 /help,[command name]
将为您提供有关特定路线的信息。/reload
: 重新加载插件/enable
:启用 Jared/disable
: 禁用 Jared/ping
: 检查聊天机器人是否可用/version
:获取 Jared 运行的版本/send
: 重复发送消息/schedule
: 安排消息/name
: 改变 Jared 对你的称呼/whoami
: 知道你的名字/barf
:返回消息的 json 表示形式,用于调试Thank you Jared
:谢谢贾里德配置文件位于~/Library/Application Support/Jared/config.json
它允许您:
有关示例,请参阅 config-sample.json。
Jared 提供各种 API,使您可以轻松添加自己的命令、自动化消息等等。有关所有 API 文档,请参阅文档中心。
可以通过用本机 Swift 代码编写的模块化插件添加其他路由。插件从~/Library/Application Support/Jared/Plugins
文件夹动态加载。要安装模块,请将其拖到那里,然后将/reload
发送给 Jared,或单击 UI 中的Reload Plugins
。
有关开发自己的插件的更多信息,请参阅插件文档。如果您开发了任何插件,请与我联系并提供链接,以便我可以在此处添加链接!我还将开发自己的一些额外模块,并在完成后将它们添加到此处。
Jared 支持 webhooks 来发送有关传入和传出消息的服务器信息。您的服务器可以响应这些请求发送消息,或者随时使用 REST API 发送消息。要配置 webhook,请将它们添加到上面提到的config.json
中。有关 webhooks API 的更多信息,请查看 webhook 文档。
Jared 包含一个带有可以启用的 REST API 的 Web 服务器。这允许您发出 HTTP 请求以将消息发送给任何收件人。有关更多信息,请查看 REST API 文档。
Jared 按照设定的时间间隔从消息数据库中读取数据并查询新消息。它提供了一个用于对消息进行操作的路由框架,并使用 AppleScript 发送传出消息。它也是多线程的,因此可以同时处理多个请求。 Jared 允许通过.bundle
插件文件、webhooks 和 REST API 进行扩展。这允许在不修改主要 Jared 代码库的情况下添加命令。
我尝试过使用 MessagesKit 等私有 API 来发送/接收消息,但到目前为止没有成功。如果您在这方面有任何线索,我很想听听。