开发指南
IDE 与工具链
Node 22、pnpm、Biome 和通用 Agent 入口。
推荐 Node.js 22.x 与根 packageManager 指定的 pnpm 10.26.2。engines.node 是 >=22,但 muse:doctor 对非 22.x 给警告;警告不是兼容性保证。
node --version
pnpm --version
pnpm install
pnpm muse:doctor编辑器
可用 Cursor、VS Code、Claude Code 或 Codex 等支持仓库上下文的工具;以实际安装工具的功能为准。读取 AGENTS.md 和任务对应 .agents/skills/*/SKILL.md,不要将某 IDE 的私有配置当作仓库架构真值。
建议扩展:Biome(按仓库 biome.jsonc 检查/格式化)、Tailwind CSS IntelliSense、TypeScript 支持。模板使用 Biome,不要求 ESLint/Prettier 同时重格式化文件;官网自己的工具链与模板不同。
检查命令
pnpm type-check
pnpm check:error
pnpm lint:ws
pnpm test:unit缺少 collections/* 或 .source 类型时先启动 pnpm dev:cf 或运行 pnpm build:cf 生成 Fumadocs 产物,不手工补生成文件。Workers binding 类型用 pnpm cf:typegen 更新。