SuperAPI AI 工具集

clawhub-moderation

安全与审计

查看项目

更新于 10-16 06:39

技能介绍

ClawHub Moderation 是 ClawHub 的员工审核管理工具,属于仓库本地工具,需从已检出的 ClawHub 仓库根目录运行。它封装了现有的 ClawHub CLI 认证/配置和 HTTP API 接口,不直接调用 Convex 内部 mutation 执行员工操作。

主要能力

该工具提供多个顶级命令组:auth、users、plugins|plugin、packages|package、org、email、skills|skill。

技能管理(skills)支持:hard-delete <skill>、unhide <slug>、revoke-version <slug>、rescan <slug>、reports、triage-report <report-id>。hard-delete 需要 owner 限定的引用并默认干跑,仅在获得该干跑返回的确切确认令牌后才能应用。当多个发布者使用相同 slug 时,revoke-version 需传 --owner <handle>。工具中没有独立的 skills hide 命令,处理应隐藏技能的举报时使用 triage-report 的 --action hide。

用户管理(users)支持:ban <handleOrId>、unban <handleOrId>、lift-moderation-hold <handleOrId>、set-role <handleOrId> <role>、reclassify-ban <handleOrId>、remediate-autobans。当参数为用户 id 时使用 --id;仅在用户要求模糊匹配或精确 handle 有歧义时使用 --fuzzy。

组织发布者(org)支持:official(list/add/remove)、create <handle>、remove-member <handle> <member>、delete <handle>、repair-scoped-packages <csv>。org create 需要 --member,且不得将执行命令的版主隐式添加为 owner。org delete 仅适用于空的组织发布者,默认干跑。

插件包(packages)支持:moderate <name>、status|moderation-status <name>、queue|moderation-queue、reports、triage-report <report-id>、hard-delete <name>、transfer <name>、repair-name <name>、migrations、set-migration <bundled-plugin-id>、trusted-publisher。

员工邮件(email send)支持 --to <email>、--user <handle>、--subject <subject>、--body-file <path>、--body <text>、--send、--confirm-user-request、--confirm-user-signoff、--json。仅起草时可不带发送标志;发送需用户明确请求并确认最终收件人、主题和正文后,使用 --send --confirm-user-request --confirm-user-signoff。服务器在管理员认证成功后通过生产 noreply 提供商发送并写入审计日志。

使用方式

从 ClawHub 仓库根目录运行 bun run admin -- --help 查看帮助。认证或验证当前令牌使用 bun run admin -- login 和 bun run admin -- whoami。各命令组可通过 --help 查看子命令,例如 bun run admin -- skills --help。

安全规则

需要用户提供明确目标:技能 slug、用户 handle 或用户 id。破坏性、恢复性、所有权或审核写入需要提供原因。任何写入前展示确切命令并请求确认,除非用户已指示继续或提供 --yes。人类优先使用 handle,仅在用户提供用户 id 时使用 --id。禁止绕过 API 令牌认证、服务器角色检查或审计日志。写入后需用 CLI/API 验证状态并报告结果。

影响说明

skills unhide 是版主手动恢复:清除技能隐藏状态,对顶级审核字段应用干净的手动覆盖,保留版本级扫描器记录,更新公开统计并写入审计日志。skills revoke-version 永久移除一个确切版本,记录员工证据,在存在安全存留版本时将 latest 指针推进到该版本,无可用版本时保持技能独立隐藏。users ban 具有破坏性:撤销 API 令牌、标记用户已删除、隐藏其拥有的技能、软删除评论并写入审计日志。users unban 仅限管理员:清除封禁状态并恢复由匹配封禁流程隐藏的技能,已撤销的 API 令牌保持撤销。users lift-moderation-hold 仅限管理员:清除账户级审核保留,恢复由该保留隐藏的技能并写入审计日志。packages transfer 保留包行、统计、发布和历史,仅更改所有者发布者。packages hard-delete 仅限管理员,要求包已被软删除、提供确切 owner handle、原因和干跑令牌,永久移除所有包发布及相关历史。org delete 软删除空组织发布者并保留成员行用于历史,拒绝含有活跃技能或包的组织。

验证方式

技能:unhide 后检查页面/API 状态;hard-delete 后验证 owner 限定的页面/API 读取返回未找到。用户:优先使用用户搜索/管理员界面查找目标账户。组织和包:写入后使用公开发布者/插件页面和相关 CLI 状态命令。邮件:验证 CLI 响应和审计预期,不要为测试投递而发送第二封邮件。如果验证因认证或缺少管理员权限受阻,如实报告命令结果和验证阻碍。

适用场景

适用于 ClawHub 员工执行平台审核管理操作,包括技能隐藏恢复、版本撤销、重扫描、举报分类处理,用户封禁/解封/角色设置/审核保留解除,组织发布者官方标记、创建、删除、成员管理,插件包审核、转移、硬删除、受信发布者设置,以及经用户明确授权的员工邮件发送。

限制

需从已检出的 ClawHub 仓库根目录运行,依赖 bun 和现有 ClawHub CLI 认证/配置。部分命令仅限管理员。无独立 skills hide 命令。org delete 仅适用于空组织发布者。未提供关于公开访问、定价或平台的更多信息。