chore: 初始化仓库

docs/guide/commands/install.md

@@ -0,0 +1,79 @@
+# install — 安装 Extension
+
+安装外部 Extension 到当前项目或全局环境。
+
+## 基本用法
+
+```bash
+# 安装指定 Extension（npm 包）
+spaceflow install @spaceflow/review
+
+# 安装本地路径
+spaceflow install ./commands/my-plugin
+
+# 安装 git 仓库
+spaceflow install git@github.com:org/plugin.git
+
+# 安装所有 spaceflow.json 中的 dependencies
+spaceflow install
+
+# 全局安装
+spaceflow install @spaceflow/review -g
+```
+
+## 支持的 source 类型
+
+| 类型 | 示例 | 说明 |
+|------|------|------|
+| npm 包 | `@spaceflow/review` | 执行 `pnpm add <package>` |
+| 本地路径 | `./commands/my-plugin` | 注册 `link:` 引用到 `spaceflow.json` |
+| git 仓库 | `git@github.com:org/plugin.git` | 克隆到 `.spaceflow/deps/` |
+
+## 安装流程
+
+1. **解析 source** — 判断是 npm 包、本地路径还是 git 仓库
+2. **安装依赖** — 根据类型执行对应的安装操作
+3. **更新配置** — 将 Extension 注册到 `spaceflow.json` 的 `dependencies` 字段
+4. **关联编辑器** — 将 Extension 的 skills 关联到 `support` 中配置的编辑器目录
+
+## 无参数模式
+
+不传 source 时，会读取 `spaceflow.json` 中的 `dependencies` 字段，安装所有已注册的 Extension：
+
+```bash
+spaceflow install
+```
+
+等价于遍历 `dependencies` 中的每一项并逐个安装。
+
+## 全局安装
+
+使用 `-g` 标志安装到全局目录 `~/.spaceflow/`：
+
+```bash
+spaceflow install @spaceflow/review -g
+```
+
+全局安装的 Extension 在所有项目中可用。
+
+## 命令行选项
+
+| 选项 | 简写 | 说明 |
+|------|------|------|
+| `--name <name>` | `-n` | 自定义 Extension 名称 |
+| `--global` | `-g` | 全局安装 |
+| `--verbose` | `-v` | 详细日志 |
+| `--ignore-errors` | | 忽略错误，不退出进程 |
+
+## 示例
+
+```bash
+# 安装并指定名称
+spaceflow install @spaceflow/review --name review
+
+# 安装本地开发中的 Extension
+spaceflow install ./commands/review
+
+# CI 中安装所有依赖（忽略错误）
+spaceflow install --ignore-errors
+```