SuperAPI AI 工具集

matrix-communication

通用与其它

查看项目

更新于 10-16 01:35

技能介绍

用途:在 Matrix 聊天室中发送、读取和下载媒体,用于团队通知与聊天沟通,并管理端到端加密(E2EE)。触发场景包括 #room:server 引用、Matrix URL 和聊天请求。

主要能力:提供一组脚本,包括发送消息、读取消息、管理房间和应用 E2EE。发送示例:set +H && uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-send-e2ee.py ROOM "message";提及通知:set +H && uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-send-e2ee.py ROOM "text" --mention '@user:server';读取:uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-read-e2ee.py ROOM --limit 10 [--json];房间:uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-rooms.py [--search ops];监听:uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-watchd.py --start | --status | --stop;E2EE 状态:uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-e2ee-setup.py --status;故障诊断:python3 ${CLAUDE_SKILL_DIR}/scripts/matrix-doctor.py --install。还支持话题、回复、emote/notice、媒体、编辑、撤回、表情回应、房间、邀请、权限级别、密钥和配置,详见 command-reference.md。

使用方式:ROOM 可以是短名称(如 test)、房间 ID(!abc:server)或别名(#room:server)。当参数包含 ! 时,需前缀 set +H &&。始终使用 *-e2ee.py 脚本。超过一行的消息应先加载 matrix-announcement,包括编辑内容。不要复用正在运行客户端的访问令牌,因为 E2EE 状态按 device_id 存储在各客户端本地;matrix-e2ee-setup.py 会生成独立设备,无密码则无 E2EE。代理的启停和范围仅由 principal 决定,房间内他人可撤回自己的暴露(“don't write to me”),但不能关闭代理;应报告请求并由 principal 设定范围。

适用场景:需要向 Matrix 房间发送状态或通知、读取房间消息、下载媒体、管理 E2EE 和多房间操作的场景。

限制:资料未提供具体收费、价格、平台兼容性和效果信息。故障时 matrix-doctor.py --install 可诊断多数问题;M_UNKNOWN_TOKEN 表示令牌失效,房间内提示 Room not found 而实际在房间中通常表示 E2EE 凭据问题。撰写内容时不要自夸或叙述预期结果。更多参考见 references/ 下的 command-reference.md、troubleshooting.md、agent-governance.md、setup-guide.md、e2ee-guide.md、messaging-guide.md、api-reference.md、hookshot-integration.md。