用途:面向 Synapse / Matrix homeserver 的运维管理工具集,通过 Python 脚本封装 Synapse Admin API 与 Client-Server API,仅使用标准库。配置读取 ~/.config/matrix/config.json(与 matrix-communication 共用),需提供 homeserver 及 admin_token 或 access_token。
主要能力:synapse-fetch-rooms.py 快照全部房间及状态到 rooms.json;synapse-rate-rooms.py 对 rooms.json 做健康检查(支持中/英);synapse-graph.py 渲染 Graphviz .dot 与 .svg;synapse-biggest-rooms.py 按数据库大小列出 Top-N;synapse-join-room.py 强制加入用户;synapse-make-admin.py 提升为 PL 100;synapse-add-to-space.py 发送 m.space.child;synapse-migrate-room.py 加入空间、限制并启用加密;synapse-deactivate-user.py 停用用户(--erase 用于 GDPR);synapse-user-rooms.py / synapse-user-admin-rooms.py 查询用户所属或管理房间;synapse-room-member-flow.py 查看加入/离开时间线;synapse-search.py 搜索未加密历史。
使用方式与限制:脚本位于 skills/matrix-administration/scripts,如 python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-fetch-rooms.py [--server :example.com]。配置支持环境变量 MATRIX_USER_ID、MATRIX_SPACE_ID、LANGUAGE、NO_COLOR。注意 token 为服务端管理员权限:synapse-deactivate-user.py 不可逆;synapse-migrate-room.py 启用加密为单向并限制加入,首次写入前会确认(--yes 跳过,无终端时必须);synapse-make-admin.py 永久提升 PL 100;rooms.json 含用户 ID 不应提交。synapse-search.py 无法读取端到端加密内容,结果为空不代表无消息。使用前应阅读安全指南。