MuseAI-Skills

muse.ai（Muse AI） 的技能文档与 Muse / Hatch 运行环境快照。

English · 中文分析报告 · 文件校验清单

快速导航：技能目录 · 文件结构与作用 · 系统架构 · 下载与校验

本仓库中的 Muse AI 指 muse.ai；这一站点对应关系也见随包的产品概览。仓库存档了该 Muse / Hatch 个人 AI Agent 环境的部分文件，包括产品说明、技能定义、连接器权限清单、Linux 运行环境脚本，以及随包程序和依赖，供结构阅读与技术分析。

它不是完整源码仓库，也不是可以一键部署的安装包。 核心程序主要以 Linux x86-64 ELF 二进制提供；构建源码、完整宿主配置、rootfs 和部分运行资源不在这份快照中。仓库附带的材料自述使用 Muse、Hatch、Jarvis 等名称；本存档不代表官方发布或认可，也未独立验证这些材料的来源与产品声明。

对研究 Agent 工作流设计而言，随包技能文本是这份快照中尤其值得阅读的部分：它们具体描述了 何时触发、如何分流任务、使用哪些工具、怎样处理授权与失败，以及如何验收交付物。阅读这些内容不需要下载体积较大的二进制。

目录里共有 72 个 SKILL.md 路径：68 个独立技能文件，加上 4 个符号链接别名。下面的分类表完整覆盖 68 个独立文件，别名单独列出。名称使用目录路径，可能与 frontmatter 中的名称不同。这里称为“随包技能”，表示它们在快照中的位置；尚未独立认证其官方来源，也不将其称为已验证的官方开源发布。

以下按工作流设计的参考价值选择，不代表运行效果排名，也不代表可以直接安装使用。

voice-calls 实际指向静态语音目录，不能根据名字推断它提供 Agent 代打电话能力。Spaces 目录 含运行时文档与模板，但没有顶层 SKILL.md，因此不额外计为一个技能。Artifacts 共享参考 包含图表、地图、实时数据、Markdown 等输出说明。全目录另有 40 个 manifest 路径和 12 份 eval YAML；这些是配套文件数，不是额外技能数，也不代表评测已经通过。

• 先看技能的触发条件、边界与输出契约，再结合它引用的参考文档及权限 manifest 阅读。
• 工作流模式可以用于改进自己的 Agent 指令，但需要按目标环境调整工具名、工作区路径、授权规则和验收步骤。
• 连接器技能依赖对应 CLI/MCP、账户连接、OAuth scopes 和运行时授权。复制 Markdown 不会自动获得这些能力。
• 部分引用的辅助程序并未包含：Artifacts 验证脚本、skill-creator 的连接器脚手架，以及 Magic Moment 的 mm 可执行程序均缺失；Spaces 也缺少 SDK/构建资源。技能文档可阅读，执行链路并不完整。
• 保留来源归属和适用许可。“存档中可见”不等于“官方来源已认证、可独立运行或可任意重新授权”。

只想研究这些技能，可以跳过全部 LFS 二进制下载：

GIT_LFS_SKIP_SMUDGE=1 git clone https://github.com/win4r/MuseAI-Skills.git
cd MuseAI-Skills

打开 opt/hatch/skills/ 或点击上方目录即可，无需执行随包程序。

• 想快速理解系统：阅读 项目分析报告，包含架构图、能力边界、交付缺项和证据索引。
• 想了解产品设计：从 产品概览、目标、后台调度 和 后台整理 开始。
• 想研究工具与权限：阅读 连接器说明、Gmail 技能 和 权限 manifest。
• 想研究运行架构：阅读 runtime-cell 启动脚本、daemon 控制脚本 和 数据库关系文档。
• 想研究生成式应用：阅读 Artifacts 说明 与 TypeScript Web Artifact Runtime，注意两者的发布能力描述存在差异。

下面展开重要路径；… 表示省略其他程序或技能，花括号用于合并展示同级路径。全部技能入口见上方分类目录。这里的路径以已发布仓库为准，不包含本地另行解压的重复目录。

.
├── README.md / README.en.md
├── PROJECT_ANALYSIS.md
├── SHA256SUMS
├── .gitattributes / .gitignore
├── home/hatch/
│   ├── config/
│   │   ├── home.yaml
│   │   └── skills.yaml
│   ├── PROACTIVE_PREFERENCES.md
│   ├── assets/onboarding_tour/memory_import.md
│   ├── docs/
│   │   ├── muse.md / client-surfaces.md
│   │   ├── goals.md / feed.md / ideas.md / self_improvement.md
│   │   ├── scheduling-and-watching.md / connectors.md / browser.md
│   │   ├── artifacts.md / files-and-library.md
│   │   ├── privacy-and-credentials.md / data-handling.md
│   │   ├── payments-and-purchases.md / calls-texts-notifications.md
│   │   ├── voice.md / media.md / referrals.md / channel-availability.md
│   │   ├── channels/whatsapp.md
│   │   └── devices/
│   │       ├── mac_app.md / tailscale.md / home_link.md
│   │       └── home_link/integrations/
│   │           ├── brother_printers.md
│   │           ├── lutron_smart_bridges.md
│   │           └── shelly_plugs.md
│   └── workspace/muse-security-audit.md
└── opt/
    ├── hatch/
    │   ├── bin/
    │   │   ├── hatch / spawnd / hatch-execd / hatch-multicall
    │   │   └── …
    │   ├── runtime-cell/
    │   │   ├── pre-start.sh / launch-daemon.sh / post-start.sh
    │   │   ├── control-daemon.sh / control-execd.sh / run-daemon.sh
    │   │   ├── ensure-rootfs.sh / resolve-rootfs-path.sh
    │   │   ├── runtime-cell-entry.sh / require-modules.sh
    │   │   ├── guest.env / guest-runtime-env.sh
    │   │   ├── build-cell-trust-store.sh / hatch-preflight-opportunistic
    │   │   ├── skill-scopes.conf / bin-scopes.conf
    │   │   ├── stop.sh / post-stop.sh / is-loopback-rv.sh
    │   │   └── etc/{hosts,resolv.conf,wgetrc}
    │   └── skills/
    │       ├── gmail/{SKILL.md,manifest.yaml,eval/scenarios.yaml}
    │       ├── goals/{SKILL.md,creation/,guides/}
    │       ├── artifacts/{document,markdown,pdf,presentation,spreadsheet,testing}/
    │       ├── artifacts/references/
    │       ├── muse_db/{SKILL.md,references/schema.md}
    │       ├── magic-moment/{SKILL.md,INSTALL.md,guide/,reference/}
    │       ├── spaces/templates/{space-static,space-ts}/workspace_agents.md
    │       ├── spaces/ts-runtime/{README.md,docs/vertical-tool-schemas.md}
    │       └── …
    └── hatch-image/bin/
        ├── runtime-cell.kdl / hatch-manifest
        ├── convert-cell-intent / hatch-prewarm
        ├── bun / codex / codex-resources/bwrap
        ├── npm -> npm-package/bin/npm-cli.js
        ├── npx -> npm-package/bin/npx-cli.js
        ├── npm-package/{package.json,LICENSE,bin/,lib/,docs/,man/,node_modules/}
        ├── rtc-sidecar / rtc-sidecar-lib/
        └── disabled-user-mgmt / percona-telemetry-disabled / gws

仓库根目录是存档根目录，不是正在运行的操作系统根目录。home/hatch/ 对应原 Agent 的 home；opt/hatch/ 是其程序包；opt/hatch-image/ 是镜像侧工具。原文中的 ~ 通常指 /home/hatch，不是你当前电脑的用户目录。绝对路径 /run、/var/lib、/etc 描述的是运行时依赖，本仓库大多没有这些内容。尤其要注意：opt/hatch/runtime-cell/etc/ 只有三个配置模板，不等于完整的 /etc。

以下 26 份文档说明这份快照中的产品契约。账号特定的能力和历史可用性描述，不应当作已核实的当前产品事实。

这些是实现脚本和配置，不是可以照抄执行的启动教程。下表依据注释和可见调用说明职责；完整宿主 unit 与 nspawn 配置缺失。

按职责理解启动关系：

flowchart LR
  A[pre-start / rootfs preparation] --> B[launch-daemon / systemd-nspawn]
  B --> C[post-start / network readiness]
  C --> D[control-daemon]
  C --> E[control-execd]
  D --> F[hatch daemon]
  E --> G[hatch-execd]
  C -.-> H[opportunistic package reconcile]

这是职责关系图，不是已验证的 systemd 依赖图。runtime-cell-entry.sh 提供共享的就绪/环境处理，guest.env 提供配置。就绪后的 reconcile 可以与 daemon 并行，因此 ready 不等于所有软件包更新都已结束。

opt/hatch/bin/ 有 77 个程序路径。下表列出关键入口与分组，明确区分有脚本调用依据的职责和仅按名称进行的归类；没有为撰写说明执行这些二进制。

以 Gmail 为例：先读 SKILL.md 理解操作流程，再读 manifest 理解方法权限和 scopes，随后看 eval 场景 理解期望行为，最后对照通用的连接器契约。单看编译后的 CLI 无法解释这套策略。同样，config/skills.yaml 声明 available 不等于账户已连接，skill-scopes.conf 控制可见性也不等于授予操作权限。

初始材料盘点（排除 .DS_Store，不含新增仓库文档与校验清单）：

精确的发布文件集合以 Git 树和 SHA256SUMS 为准。数据库数字是文档统计，不是实际数据库查询结果。

材料呈现的工作流是：用户提出任务，Agent 读取个人上下文，结合目标与记忆调用工具，将结果交付为消息、文档或应用，再由后台流程维护记忆、关系和建议。

这些文件可以说明设计意图和部分实现形态，不能证明相应功能在线可用、账户已连接、权限已授予或测试已经通过。

先安装 Git LFS，然后执行：

git lfs install
git clone https://github.com/win4r/MuseAI-Skills.git
cd MuseAI-Skills
git lfs pull
git lfs fsck

二进制与共享库由 Git LFS 管理。未安装 LFS 或跳过下载时，相关路径可能只有小型指针文件。普通 ZIP 下载不能作为完整 LFS 内容已获取的证明；优先使用以上方式。

原始文件逐路径累计约 2.02 GB；按本地 inode 去重约 1.55 GB。Git 不保留硬链接关系，因此 checkout 后共享镜像的多个名字通常成为独立文件，需要按约 2 GB 工作区加 Git/LFS 缓存预留空间。

GIT_LFS_SKIP_SMUDGE=1 git clone https://github.com/win4r/MuseAI-Skills.git
cd MuseAI-Skills

需要二进制时再运行 git lfs pull。

完成 LFS 下载后，在仓库根目录运行：

# Linux
sha256sum --check SHA256SUMS

# macOS
shasum -a 256 --check SHA256SUMS

清单覆盖发布时的普通文件，不包含清单自身、.git 和被忽略的本机元数据。符号链接由 Git 跟踪，不列入该普通文件清单。哈希用于检查内容一致性，不验证原始来源或程序安全性。

当前快照无法独立启动。不要将 README 中的下载步骤理解为安装或部署步骤。

• 核心程序面向 Linux x86-64，不能在 macOS 原生运行。
• 缺少核心源码与完整构建定义，无法重建 daemon 和连接器。
• 缺少完整宿主服务、rootfs、数据库迁移和控制面依赖。
• Web Artifact README 引用的 build.mjs、sdk/ 和 dist/space-sdk.tgz 不在快照中。
• 评测 YAML 引用的 spawn-eval-instructions.md 不在快照中。
• runtime-cell.kdl 引用的 run-execd.sh 不在快照中；不排除完整镜像另行生成该文件。
• opt/hatch-image/bin/gws 是零字节文件；这不代表其他 Google CLI 入口也失效。
• 产品文档限制为静态产物发布，技术文档则描述带数据库的 Cloudflare 导出；适用版本与开放渠道未确认。

随包脚本中含绝对路径、挂载、权限和系统服务操作，它们为原始 Linux 环境编写，不是面向任意电脑的通用安装脚本。

本地分析已完成文件与硬链接盘点、关键程序格式检查、文档交叉阅读，并对 15 个 runtime-cell .sh 文件执行 sh -n，全部通过语法检查。

未进行服务启动、核心源码编译、数据库连通、真实连接器调用、设备接入、完整应用构建或动态安全验证。历史 安全审查材料 保留了其原文与原始范围，不构成对整个系统的安全背书。

这是一份公开存档，公开可见不等于所有内容获得统一的开源授权。未为整份快照添加 MIT、Apache 等总许可；原始组件的版权、商标及各自已有的许可保持不变。随包 npm 及依赖的许可证保留在对应目录，例如 npm LICENSE。

这份快照未提供可确认覆盖全部 Muse/Hatch 内容的统一再分发许可证。本仓库不替原权利人授予额外使用、修改或再分发权利；使用者应按具体文件及组件确认适用条款。