前置条件
- 1macOS 12+ 或 Linux(Ubuntu 22.04+/Debian 12+ 验证通过,Windows 需 WSL2)
- 2已安装 Node.js 20+ 与 npm/pnpm(用于 skills 插件市场)
- 3持有 Meta 账号或 API Key(Contributor 档需同意数据用于训练)
- 4终端基础:会用 cd/ls/编辑器,了解 PATH 概念
腾讯智能体开发平台 ADP
新客首月专属价,最高直降 880 元,构建/分发/治理企业级 Agent
常见问题
QContributor 档 $0.10/MTok 这么便宜,会有什么坑?
Contributor 档的代价是 Meta 会用你的 Prompt 和补全数据做训练。所以敏感代码(含密钥、客户数据、未公开业务逻辑)一律走 Standard 档或本地 Spark 自托管。配置时在 ~/.muse/config.toml 把 tier = 'standard' 设为默认,仅在非敏感项目用 muse --tier contributor 临时切换。
Qappend-only 事件日志占满了磁盘怎么办?
Muse Code 把事件日志存在 ~/.muse/events/,每个 session 一个 .jsonl 文件。用 muse events prune --keep 7d 保留近 7 天,或直接编辑 config.toml 加 events.max_age_days = 7 自动清理。切勿手动删整个 events 目录,会让正在跑的长任务无法 resume。
Q长任务跑到一半 OOM 被杀,重跑会不会从头来?
不会。Muse Code 的 append-only 日志保证重启安全:muse resume <session-id> 会从最后一个 checkpoint 接着跑。前提是任务用了 /plan 审批门控(plan 文件即 checkpoint),裸跑的 /goal 任务只能从最近的工具调用边界恢复。
Qsubagent 之间会互相覆盖文件吗?
默认会,因为 subagent 共享同一工作目录。要隔离就开 worktree 模式:config.toml 里 subagent.worktree = true,每个 subagent 跑在独立 git worktree,最后由主 agent 合并。和 Orca 多 Agent 的 worktree 隔离思路一致。