SkillAgentSearch skills...

muse-guardian

给 Muse.ai 一键装上探针、Hermes、保活、持久化数据、自动允许沙盒的外联审批卡片,以及容器重建 SKILL。

Install / Use

npx skills add bytehola/muse-guardian

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

68/100

Category

Operations

Supported Platforms

Universal

Our assessment of muse-guardian

muse-guardian scores 68/100 on our quality scale, 693rd of 745 Operations skills we index.

Its SKILL.md is 116 KB long, well organised into 393 sections with 71 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.

It has no GitHub stars yet, so there is no community track record; judge it on its content.

Substance
21/30
Structure
20/20
Description
12/15
Adoption
0/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 14 days ago, so muse-guardian is actively maintained.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

Review

Our scan of the first 100 KB of the file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review judged it risky: The skill instructs the agent to deploy MuseAutoApprove, a daemon that automatically approves the platform's external-network permission cards (HITL), weakening the sandbox's permission safeguards and effectively auto-approving access reque.

AI review: risky

  • The skill instructs the agent to deploy MuseAutoApprove, a daemon that automatically approves the platform's external-network permission cards (HITL), weakening the sandbox's permission safeguards and effectively auto-approving access reque
  • It tells the agent to download and execute remote install scripts/binaries from GitHub (e.g., cfsm-agent install.sh, cf-probe binary) through embedded wrapper scripts, which is the skill-file equivalent of piping a remote script into a shel
  • It directs the user to send the muse.ai account password in plaintext in the chat and has the agent write it to a local credentials file, creating unnecessary credential exposure.

AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

muse-guardian compared with similar skills

All 4 of these similar skills score higher than muse-guardian; compare them before choosing.

SkillScoreStarsUpdatedFormat
muse-guardian (this skill)by bytehola68014d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server
crawl4aiby unclecode10087.4k3d agoMCP Server

Frequently asked questions

How do I install muse-guardian?
Run npx skills add bytehola/muse-guardian. The install tabs above show the steps for each supported agent.
Which AI agents does muse-guardian work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is muse-guardian safe to use?
Our scan of the first 100 KB of the file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review judged it risky: The skill instructs the agent to deploy MuseAutoApprove, a daemon that automatically approves the platform's external-network permission cards (HITL), weakening the sandbox's permission safeguards and effectively auto-approving access reque. It declares no license and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is muse-guardian still maintained?
The repository was last updated 14 days ago, so muse-guardian is actively maintained.

name: muse-guardian description: "在全新沙盒/新账号上从零部署一套「CF Server Monitor 探针 + 三层保活 + Hermes 微信机器人 + MuseAutoApprove(muse.ai 外联审批自动批准)」:Cloudflare Worker 后台、cf-probe 探针、持久化脚本布局、离线包缓存、Hermes 安装与模型 API 配置、微信扫码绑定、沙盒内看门狗、平台 hook 探针(检测/恢复拆分)、平台开机钩子、端到端验证。开工先问「全部安装 / 逐模块」(默认逐模块);全文按 5 个模块 + 收尾组织,同一模块内连续执行,只在用户必须输入/扫码/平台点击时打断;每步五段式(命令 / 话术 / 用户手动动作 / 做完的标志 / 排错表格),全部脚本完整代码直接内嵌,复制即可用。触发词:部署保活、给新账号也来一套、装探针、微信机器人、沙盒重建恢复、保活脚本、自动审批、审批卡片、MuseAutoApprove。" version: 2.6.0 license: MIT metadata: hermes: tags: [ sandbox, keepalive, disaster-recovery, cloudflare, probe, hermes, weixin, deployment, muse-auto-approve, ] related_skills: [weixin-instant-ack, sandbox-environment-recon]

沙盒保活 + Hermes 微信机器人:一键部署手册

一、这套东西是什么

平台(Muse / hatch 沙盒)会不定期重建沙盒:整机从外部删掉重装,沙盒内的一切—— 进程、systemd、cron、/tmp——全部消失,只有 $HOME(/home/hatch)会保留。

本手册部署的是一套三层保活 + 微信机器人:

| 层 | 组件 | 对付的故障 | 恢复时间 | | ---------- | ---------------------------------------------------------------------------- | ---------------------------------------- | --------------------------- | | 探针 | cf-probe(systemd 服务)→ CF Server Monitor 后台 | 你想知道机器到底活着还是挂了 | 60 秒上报一次 | | Layer 1 | watchdog.sh(沙盒内 cron,每分钟) | 机器活着,但某个进程挂了 / 微信连接卡死 | 1 分钟内 | | Layer 2a | 平台 hook 探针(每 10 秒 bash 轮询,跑在沙盒外;健康零 token,连续异常才唤醒 agent 恢复) | 整机被重建,沙盒内 cron 全灭 | 10 秒级发现,约 2 分钟恢复 | | Layer 2b | 平台原生开机钩子(每次启动跑一次) | 同上,但更快(开机即恢复) | 开机后约 100 秒 | | Layer 3 | restore-all.sh(幂等一键恢复) | 被 1、2a、2b 调用 | 约 2 分钟 | | 审批自动化 | MuseAutoApprove(沙盒内 node 常驻;步骤 1–4 安装启动、第 15 步起接入保活) | 沙盒访问新域名时平台弹审批卡片、外联卡住 | 默认每 10 秒一轮询 |

平台重建无法阻止,本手册只保证「重建后自动恢复」。

二、怎么用这本手册(AI 必须遵守的行事规则)

  1. 开工先问执行方式;默认逐模块。 动手之前先问用户选哪种(话术见第三章开头):
    • A. 全部安装:一口气把 5 个模块 + 收尾全做完,只在下面 8 个介入点停。
    • B. 逐模块(默认):每做完一个模块汇报一次,等用户说"继续"再做下一个。用户没明确选就按 B。
    • 同一模块内的步骤连着做完,不要逐步确认;纯沙盒内的动作(跑脚本、装服务、写 cron、改文件)全部自己做完。
    • 只在用户必须到场时停:需要用户输入(账号、密钥、策略)、扫码、或在平台/网页端点击时,才停下把话术发出去,等用户回复再往下。这些点见「必须用户介入的环节」。
  2. 正文按五段式书写——这是文档结构,不是执行节奏。 每个步骤五段固定顺序,便于排障与查证;执行时同一模块内的步骤连着做完,不必逐步确认,只在 ② 出现、或 ④ 判据不过时才打断用户:
    • ① 🤖 AI 执行:你(AI)要跑的命令,精确到可以直接复制。不要写"类似这样",要写实际的命令。
    • ② 💬 对用户说:可以原样发给用户的话术(可微调语气,不要改意思)。用户是技术型、直接、要求客观,话术要短、要具体、要说清"要他做什么"。
    • ③ 🙋 用户手动做:用户必须在网页/手机/平台端点的动作。
    • ④ ✅ 做完的标志:可验证的判据(命令 + 期望输出)。做不到就不要往下走,先解决问题。
    • ⑤ 🛠️ 常见失败与处理:表格,现象 → 原因 → 处理。
  3. 每条命令都要真跑过。 报告结果时说清楚「跑了什么、看到什么」。跑不了就直说跑不了,不要编造输出。
  4. 密钥纪律(四条铁律,违反必出事):
    • 真实 SECRET / API Key / Worker 域名 / API 地址绝不写进任何文档、Skill、日志、记忆——本手册里全用占位符:<PROBE_ID>、<API_SECRET>、<WORKER_URL>、<API_BASE_URL>、<MODEL_NAME>。
    • 密钥优先让用户自己生成,通过安全页面发给你;只有用户明确同意时才由 AI 生成并在聊天里一次性显示。(例外:MuseAutoApprove 的 muse.ai 账号密码——沙盒里没有可用安全入口,按用户要求走聊天框明文,见第六章。)
    • 先脱敏再打印,不是"先打印再脱敏"。需要确认密钥存在,就只输出计数/长度/路径/布尔值,不输出值本身。
    • 含密钥的文件(install-cf-probe.sh、~/.hermes/.env)权限一律 600,且不要用文件读取工具打开(内容会进会话历史)。
  5. 谁做什么(重要,别硬揽):
    • 沙盒内的一切(跑脚本、装服务、写 cron、改文件)→ 任何有 shell 的 Agent 都能做。
    • Layer 2a(平台 hook 探针)和 Layer 2b(平台开机钩子)跑在沙盒外面:只有平台侧 Agent(Muse)或用户在平台端才能创建。如果你是在沙盒里跑的 Agent,这两步要请求用户/平台侧 Agent 执行,并把现成的 hook 脚本、hook 定义与恢复提示词交给他们(本手册第 13、14 步给了全文)。
    • 涉及 root 权限的操作(装包、写 systemd、启动 sshd、给 init.sh 加执行位)→ 沙盒里通常是 root,直接做,但要在报告里说明改了哪些系统路径。

模块地图(执行顺序)

整条流程分成 5 个模块 + 收尾,顺序不可乱(MAA 最先装:部署全程要出网,先让审批能自动批;保活补丁必须在脚本落盘〔步骤 7〕与看门狗 cron〔步骤 11〕之后)。按 A/B 模式连着做,只在介入点停:

| 模块 | 干什么 | 步骤 | 章节 | 要用户做什么 | | -------------------- | --------------------------------------------------- | ----- | ----------- | ------------------------------------------------- | | A|自动审批底座 | 装 MuseAutoApprove 并常驻,外联审批自动批 | 1–4 | 四~七 | 选策略 + 发 muse.ai 账号密码 + 首次装包点一次卡片 | | B|监控与探针 | CF 监控后台 + cf-probe 探针 | 5–6 | 八~九 | 给 CF Token(或网页部署)+ 后台拿安装命令 | | C|保活底座 | 保活脚本落盘 + 离线包缓存 | 7–8 | 十~十一 | 无(全自动) | | D|微信机器人 | 装 Hermes + 接模型 API + 微信扫码绑定与配对 | 9–10 | 十二~十三 | 模型 API 地址/Key + 微信扫码 + 转配对码 | | E|三层保活接入 | Layer 1 看门狗、平台授权、Layer 2a/2b、MAA 保活补丁 | 11–15 | 十四~十八 | 平台端点 3 项授权 | | 收尾|验收与运维 | MAA 验证/排障/交互/升级、最终验证 | 16–20 | 十九~二十三 | 微信发消息测试 + 决定是否做重建演练 |

必须用户介入的环节(只有这 8 处要停)

除下列各处,其余全程自动。到这些点才发话术、等用户回复:

  1. 开工询问 + 平台设置:先问执行方式(A 全部安装 / B 逐模块,默认 B);再在网页把「直接网络协议」全开、「连接器 → 浏览器」(除上传文件)全改为允许(第三章)。
  2. MAA 策略与账号:选 A(永久允许)/ B(每次只批一次);把 muse.ai 邮箱密码发在聊天框(步骤 1、3)。
  3. 首次装包卡片:git clone / npm install 弹审批卡片时,用户手动点一次「允许」(步骤 2)。
  4. CF 后台:给 Cloudflare API Token(或自己在网页部署);后台「添加服务器」把安装命令贴回来;定 API_SECRET(步骤 5)。
  5. 模型 API:接口地址 + API Key + 模型名(步骤 9)。
  6. 微信扫码:手机扫码 + 确认登录;之后把机器人回的配对码转给 AI(步骤 10)。
  7. 平台授权:平台端确认「保活探针 hook / 开机钩子 / root 执行」3 项(步骤 12)。
  8. 最终验证:微信给机器人发消息测试;决定是否做重建演练(步骤 20)。

三、开工前的询问与设置 + 两次探测

开工第一件事:问执行方式 + 两处平台设置(一条消息问完)

这是整条流程的第一个动作。在跑任何命令之前先发下面这条,一次把「执行方式」和「两处设置」都问掉,拿到答复再往下。两处设置在平台网页端,沙盒里无法直接验证,以用户确认为准。

💬 对用户说(可原样发送):

开始部署前,先确认两件事:

一、执行方式,你选一个:

  • A. 全部安装(一次做完,推荐):我一口气把 5 个模块 + 收尾全做完,只在需要你输入、扫码或点平台时才来找你。
  • B. 逐模块(默认):每做完一个模块我汇报一次,你说"继续"我再做下一个。

二、两处平台设置,在 Muse.AI 网页上做:

1. 设置 → 权限 → 直接网络协议:把里面的开关全部打开。一个已知 Bug:点开关时滑块看起来没反应,其实已经打开了——每个开关点一次就行,不用管滑块动没动,也不要反复点。

2. 设置 → 权限 → 连接器 → 浏览器:把里面的选项全部改成「允许」,但**「上传文件」不可更改**。

回复格式随意,比如"A,都设好了"或"B"。执行方式不回就按 **B(逐模块)**走。

做完的标志:用户回复执行方式(缺失则按 B)+ 确认两处设置已做。探测 2 如果全是 000,第一怀疑对象是「直接网络协议」没开全。

两次探测(不是前置条件,是事实确认)

这两条命令是给自己看的,不要把它们包装成"前置条件清单"去问用户:

# 探测 1:我是谁、在哪、有没有 systemd / root
whoami; echo "HOME=$HOME"; id -u; ls -d "$HOME/workspace" 2>/dev/null || echo "no workspace dir"
systemctl --version 2>/dev/null | head -1 || echo "no systemd"
# 探测 2:能不能出去(GitHub / Cloudflare / 模型 API 端点)
curl -sS -m 8 -o /dev/null -w 'github %{http_code}\n' https://raw.githubusercontent.com/huilang-me/cfsm-agent/main/install.sh
curl -sS -m 8 -o /dev/null -w 'cf     %{http_code}\n' https://api.cloudflare.com/client/v4

期望:whoami 是 root 或可用 sudo 的用户;HOME 指向可持久化的家目录;systemd 存在;两个 HTTP 码不是 000(000 = 连不上)。若 GitHub 不通,第 8 步的离线缓存就是必需的,不是可选项。探测 2 两个都是 000 时,先回头确认上面的「直接网络协议」已全部打开,再谈别的。

模块 A|自动审批底座(MuseAutoApprove,步骤 1–4)

先装这一模块并常驻:后续全程出网(拉代码、装依赖、调模型)都不再卡审批卡片。本模块要用户配合三次:定策略、发 muse.ai 账号密码、首次装包点一次卡片。

四、步骤 1:MuseAutoApprove 是什么(先定策略)

目标:说清机制与副作用,让用户定决策策略。

沙盒外联未被规则覆盖的域名会弹审批卡片(HITL)。本组件用 muse.ai 账号连 hatch 网关加密 RPC(wss://hatch.metaaivm.com)自动决策,默认 allow_always + destination_domain 落库永久规则。纯 Node 无浏览器,只与 muse.ai / hatch 通信;data/ 含账号密码、会话、token,log/ 含邮箱与审批记录,均在 $HOME 下(700/600),不外发不提交。

| 事项 | 说明 | | -------- | ------------------------------------------------------------------------- | | 登录 | 邮箱+密码;服务端会发一封验证码邮件,本工具不读邮件 | | 会话 | hatch_sess 30 天,每 5 分钟 token touch 滚动续期——30 天内跑过一次即永续 | | 轮询 | 默认 10 秒一轮 | | 默认决策 | allow_always + destination_domain;失败回退 allow_once | | 保守决策 | --decision allow_once:只批本次,不落永久规则 | | 生效范围 | 仅本账号、所连 VM 的审批流 |

① 🤖 AI 执行(命令)

开工检查:用户还没确认第三章的两处平台设置——「设置 → 权限 → 直接网络协议」全部打开、「设置 → 权限 → 连接器 → 浏览器」除「上传文件」外全部改为允许——的,先回去做完再进本步骤。

ls "$HOME/workspace/muse-guardian/MuseAutoApprove/muse-daemon.cjs" 2>/dev/null \
  && echo "已安装(升级见第二十二章)" || echo "尚未安装"

确认尚未安装后,按 ② 与用户确认策略,再进下一步。用户没明确表态就不要动。

② 💬 对用户说(可原样发送)

🚦 装一个"自动点同意"的组件(MuseAutoApprove)。沙盒每次访问新域名,平台会弹卡片等你点"允许",不点就卡住;这个组件用你的 muse.ai 账号把这一步自动做掉。

要你定一个策略:

  • A. 永久允许(推荐):同域名批一次永久放行,之后基本不再看到卡片;
  • B. 每次只批一次(保守):域名不被永久记住。

另外它需要你的 muse.ai 账号密码——下一步直接在聊天框发我即可。装的过程会弹一两次卡片(GitHub、npm),那两次请手动点允许。 回"A"或"B",我就继续。

③ 🙋 用户手动做

  • 选策略 A 或 B。

④ ✅ 做完的标志

  • 用户明确回复 A 或 B(没回复不要往下走)。

⑤ 🛠️ 常见失败与处理

| 现象 | 处理 | | ------------------------ | -------------------------------------------------------------------- | | 用户担心"自动同意"不安全 | 改 B(每次只批一次);或先不装 | | 用户不想把密码给 AI | MAA 只能明文聊天给(其他入口走不通);介意可落盘后自行改密,或先不装 | | 用户想只放行指定域名 | 本工具没有白名单:要么 B,要么继续手工点卡片 |


五、步骤 2:安装(Node + git clone + 依赖)

目标:Node ≥ 20.18 就位、代码 clone 到 ~/workspace/muse-guardian、依赖装齐、语法自检全过。

全部装在 $HOME 下:代码、node_modules、Node 运行时、凭据、会话——重建后都在。

① 🤖 AI 执行(命令)

# 1) Node ≥ 20.18:有就跳过;没有/过旧 → 装 $HOME/.local(重建不丢)
command -v node && node -v || echo "no node"
# 无 Node 或版本低时(示例版本,按需换 22.x 最新补丁号):
case "$(uname -m)" in x86_64|amd64) A=x64;; aarch64|arm64) A=arm64;; *) echo "未知架构 $(uname -m)"; exit 1;; esac
V=v22.16.0
mkdir -p "$HOME/.local" /tmp/ni
curl -fL -o /tmp/ni/node.tar.gz "https://nodejs.org/dist/$V/node-$V-linux-$A.tar.gz"
tar -xzf /tmp/ni/node.tar.gz -C "$HOME/.local" --strip-components=1 --exclude='CHANGELOG.md' --exclude='LICENSE' --exclude='README.md'
export PATH="$HOME/.local/bin:$PATH"; node -v && npm -v
# 2) 克隆仓库(更新 = git pull),app 在仓库的 MuseAutoApprove/ 子目录
cd ~/workspace
[ -d muse-guardian/.git ] && git -C muse-guardian pull --ff-only \
  || git clone https://github.com/bytehola/muse-guardian.git
ls muse-guardian/MuseAutoApprove/muse-daemon.cjs

# 3) 装依赖 + 双自检
cd muse-guardian/MuseAutoApprove
npm install --no-audit --no-fund
node -e "require('undici');require('ws');require('https-proxy-agent');require('sodium-native');console.log('deps OK')"
for f in muse-daemon.cjs work/*.cjs; do node --check "$f" || echo "FAIL $f"; done; echo "语法检查完成"

# 4) 目录与权限
mkdir -p data log && chmod 700 data

首次安装的鸡生蛋:git clone / npm install 自己也要出网,可能弹审批卡片(github.com、registry.npmjs.org、nodejs.org)——此时自动审批还没起来,需要用户手动点一次"允许"。点过之后,同类请求就永久放行了。

装完后读一遍 ~/workspace/muse-guardian/MuseAutoApprove/README.md——里面有这个工具的目录结构、CLI 命令、环境变量和日志字段说明。后续排障和回答用户追问时用得上,不要只照本 SKILL.md 的模板复述。

② 💬 对用户说(可原样发送)

📦 开始装。过程可能弹一两次审批卡片(GitHub、npm),请手动点允许——就这一次,之后同类请求自动审批组件会替你处理。 装完我把自检结果给你看。

③ 🙋 用户手动做

  • 平台弹卡片时手动点允许。

④ ✅ 做完的标志

cd ~/workspace/muse-guardian/MuseAutoApprove
node -v                                                                   # ≥ v20.18
ls muse-daemon.cjs package.json work/*.cjs | wc -l                        # 期望 9
node -e "require('undici');require('ws');require('https-proxy-agent');require('sodium-native');console.log('deps OK')"
for f in muse-daemon.cjs work/*.cjs; do node --check "$f" || echo "FAIL $f"; done; echo "语法检查完成"

⑤ 🛠️ 常见失败与处理

| 现象 | 处理 | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | git clone 超时/被拦 | 让用户放行 github.com;或本机打包 MuseAutoApprove/ 整目录传进沙盒(走整包拷贝,别手抄单文件) | | npm install 超时/被拦 | 放行 registry.npmjs.org;或换镜像 npm config set registry https://registry.npmmirror.com;或用离线 node_modules 包 | | sodium-native 编译失败 | apt-get install -y build-essential python3 后重装;或用同架构的离线 node_modules | | node --check 某文件 FAIL | 文件截断/损坏:`git -C ~/workspace/muse-guardian checkout -- MuseAutoApprove/<fi

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars0
CategoryOperations
Updated14d ago
Forks0

Trust signals

80/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 low