安装 PlanRun

任何人都可以使用 PlanRun：MIT 许可、公开 @planrun/* npm 包，无需作者账号。你仍需要正确的宿主与工具链（见下）。

English → en/install.md · 逐步命令 → quickstart.md

适用对象

你是	路径
DSH 用户 — 在 DeepSeek Harness 跑 Agent	路径 A — `@planrun/bundle`（推荐）
PlanRun 贡献者 — 改本仓	路径 B — clone + `file:` bundle
Super Cursor 用户 — 只用 Cursor、不用 DSH	路径 C — 装 Super Cursor `.cursor/`

npm 里的 PlanRun skills 面向 DSH。本仓 .cursor/ 是 Super Cursor 母版，不以 @planrun/bundle 发布。

前置条件

要求	说明
DeepSeek Harness + `dsh` CLI	路径 A/B 必需
Node.js `^22.19` 或 `>=24`	构建与 guard
pnpm	本仓 monorepo
Git	目标项目 `.dsh/growth/`
bash	`install-planrun.sh` · `dsh-guard.sh`

路径 A — npm 用户（推荐）

dsh plugin --profile web add @planrun/bundle

重启 profile 后，在 Git 项目根：

git clone https://github.com/wangqiqi/planrun.git planrun
export PLANRUN_HOME="$PWD/planrun"
"$PLANRUN_HOME/scripts/install-planrun.sh" --here --copy-plan

验证：

dsh --profile web --dump-config | grep planrun-skills

不要在 cordis.patch.yml 里再手动插入同一插件。

路径 B — 本仓开发

git clone https://github.com/wangqiqi/planrun.git planrun && cd planrun
pnpm install && pnpm run build && pnpm run verify
export PLANRUN_HOME=/path/to/planrun
dsh plugin --profile web add "file:$PLANRUN_HOME/packages/bundle-planrun"

结构 dogfood：pnpm run verify:dogfood（需 DEEPSEEK_HARNESS_HOME）— 见 dogfood.md。

路径 C — 仅 Super Cursor

用上游 install-super-cursor 装到业务仓；不必装 PlanRun npm bundle。

映射 → mapping-from-super-cursor.md

Workflow guard

pnpm run gate-check
pnpm run plan-check
pnpm run task-verify
pnpm run next-task

详见 workflow-guard.md。

常见错误

现象	处理
`WORKSPACE_PKG_NOT_FOUND`	先 `pnpm run build`；消费者 profile 用 npm 而非 `workspace:^`
bundle 不可见	`dsh plugin add` 后重启 profile
`gate-check` BLOCK	`.dsh/growth/plan.md` 设 `PLAN_APPROVED`

安装 PlanRun ​

适用对象 ​

前置条件 ​

路径 A — npm 用户（推荐） ​

路径 B — 本仓开发 ​

路径 C — 仅 Super Cursor ​

Workflow guard ​

常见错误 ​

相关 ​