安装

前提条件

• Node.js 20.19.0 或更高版本 —— 检查你的版本：node --version

包管理器

npm

npm install -g @atelierai/rasen@latest

pnpm

pnpm add -g @atelierai/rasen@latest

yarn

yarn global add @atelierai/rasen@latest

bun

Bun 可以把 Rasen 全局安装，但 Rasen 目前运行在 Node.js 之上。 你仍然需要在 PATH 中可用、版本为 20.19.0 或更高的 Node.js。

bun add -g @atelierai/rasen@latest

Nix

无需安装，直接运行 Rasen：

nix run github:DumoeDss/rasen -- init

或安装到你的 profile：

nix profile install github:DumoeDss/rasen

或在 flake.nix 里把它加进你的开发环境：

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    rasen.url = "github:DumoeDss/rasen";
  };

  outputs = { nixpkgs, rasen, ... }: {
    devShells.x86_64-linux.default = nixpkgs.legacyPackages.x86_64-linux.mkShell {
      buildInputs = [ rasen.packages.x86_64-linux.default ];
    };
  };
}

验证安装

rasen --version

更新

先升级包，再刷新每个项目的生成文件：

npm install -g @atelierai/rasen@latest   # 或 pnpm/yarn/bun 的等价命令
rasen update                              # 在每个项目内运行

rasen update 会为你已配置的工具重新生成技能和命令文件，让你的斜杠命令与所安装的版本保持一致。

卸载

没有 rasen uninstall 命令，因为 Rasen 不过是一个全局包，外加你项目里的若干文件。移除它只需几个手动步骤，并且这些步骤都不会触碰你的源代码。

1. 移除全局包：

npm uninstall -g @atelierai/rasen   # 或：pnpm rm -g / yarn global remove / bun rm -g

2. 从某个项目中移除 Rasen（可选）。 如果你不再需要它的规格和变更，删除 rasen/ 目录：

rm -rf rasen/

动手前先想一想：rasen/specs/ 和 rasen/changes/archive/ 是你关于"系统如何运作"以及"它为什么改变"的记录。如果你可能还想要这份历史，那就在卸载之后也保留这个文件夹（或把它保留在 git 里）。

3. 移除生成的 AI 工具文件（可选）。 Rasen 会把技能和命令文件写入各工具各自的目录，例如 .claude/skills/rasen-*/、.claude/commands/rasen/ 和 .cursor/commands/rasen-* 等等。为你配置过的那些工具，删除 rasen-* 的技能和 rasen 的命令即可。每个工具对应的确切路径见支持的工具。

如果你在 CLAUDE.md 或 AGENTS.md 这类文件里还有 Rasen 的标记块，请手动移除那些块；那些文件中属于你自己的内容，仍然归你保留。

后续步骤

安装完成后，在你的项目里初始化 Rasen：

cd your-project
rasen init

完整演练请参阅快速入门。