go-deploy

Go Deploy — 打开部署链接

触发条件

• 「去部署」（go deploy）
• 「部署平台」（deploy platform）
• 「准备部署」（prepare to deploy）

触发后，执行一个操作：打开部署平台链接。不执行部署、不查询状态、不执行构建操作。

---

阶段 1：读取 docs/deploy.md

1. 在项目根目录查找 docs/deploy.md
2. 存在 → 继续阶段 3（解析链接）
3. 不存在 → 继续阶段 2（扫描项目）

---

阶段 2：扫描项目

docs/deploy.md 不存在 — 项目尚未配置部署信息。扫描现有文档以自动提取并生成配置，减少手动输入。

按优先级顺序扫描以下来源（高优先级来源通常由项目负责人维护，因此更可靠）：

优先级	来源	扫描逻辑
1	AGENTS.md	查找包含「部署」「deploy」「发布」关键词的章节，提取 URL
2	README.md	同上
3	scripts/ 目录	查找文件名中包含 deploy/open/publish 的脚本，读取 URL 变量
4	CI/CD 配置	.github/workflows/*.yml、.gitlab-ci.yml、Jenkinsfile
5	package.json	scripts 字段中包含 deploy/publish/release 的命令

链接筛选：项目文档通常包含许多无关 URL（依赖网站、参考文档等）。仅提取看起来像部署控制台的 URL（包含 deploy/console/cluster/release 关键词，或已知平台域名）。去重，并标注每个链接的来源。

扫描结果处理

• 找到候选链接 → 列出所有候选链接（含来源文件），询问用户确认哪些是真正的部署链接（关键词匹配可能产生误报 — 由用户确认可避免写入错误信息）→ 确认后生成 docs/deploy.md（见下方格式）→ 继续阶段 3
• 未找到候选链接 → 输出以下提示：

No deployment-related information found in the project.

Please provide the following and I'll create docs/deploy.md:
1. Deployment link URL (required)
2. Deployment platform name (optional, e.g. "Vercel", "Internal Deploy Platform")
3. Brief description (optional)

If the project has multiple deployment links, list them separately.

用户提供信息后，生成 docs/deploy.md 并继续阶段 3。

---

阶段 3：解析链接

从 docs/deploy.md 中提取部署链接：

1. 查找所有 ## 二级标题（每个标题 = 一个部署目标）
2. 在每个标题下，查找以 **Link**:、**链接**: 或 **URL**: 开头的行，并提取 URL
3. 可选读取 **Platform**: / **平台**: 和 **Description**: / **说明**: 行
4. 汇总为链接列表

错误处理：docs/deploy.md 存在但未找到链接行 → 提示格式不符合约定，继续阶段 2（扫描）。URL 未以 http:// 或 https:// 开头 → 跳过并发出警告。

---

阶段 4：选择链接

• 仅有 1 个链接 → 直接继续阶段 5
• 有多个链接 → 列出所有链接，并询问用户选择（每次都询问，不记住之前的选择）：

Detected the following deployment links:

1. <first ## heading>
2. <second ## heading>

Enter the number of the link to open:

---

阶段 5：打开链接

执行适用于操作系统的命令：

# macOS
open "<URL>"
# Linux
xdg-open "<URL>"
# Windows (Git Bash / MSYS2 / Cygwin)
cmd.exe /c start "" "<URL>"

备用处理：如果浏览器无法打开或命令失败 → 直接输出 URL，提示用户手动复制。打开后，说明：“已打开：<链接名称>”。

---

docs/deploy.md 格式约定

每个部署目标使用一个 ## 二级标题。标题下方列出 **Link**: 行并填写 URL（必填）；**Platform**: 和 **Description**: 为选填项。生成文件时，如果 docs/ 目录不存在，则创建该目录。

示例：

# Deployment

## Production

- **Platform**: Internal Deploy Platform
- **Link**: https://deploy.example.com/console/my-project
- **Description**: Main deployment entry — view cluster status, release new versions

## Staging

- **Link**: https://pre-deploy.example.com/my-project