docs: publish product homepage with one-click install guides

2026-03-06 22:45:52 +08:00
commit f049105f1c

67
Home.md Normal file

@@ -0,0 +1,67 @@
# Issue-Driven DevOps Agent
> **为研发团队打造的 Issue 驱动交付平台**
> 把 `Issue -> Branch -> Preview Slot -> Test Loop -> Human-Confirmed Merge` 固化为标准流程。
## 核心价值
### 1. 分支隔离提测
每个 issue 绑定独立分支与预览槽位,避免测试互相覆盖,`main` 保持稳定回归。
### 2. 智能节省资源
按改动范围自动识别部署策略:`skip / client_only / server_only / full_stack / infra_only`
**服务端没变更就不重启服务端**
### 3. 可审计闭环
每次提测沉淀 commit、测试链接、环境 URL、验证步骤。
所有模式下最终合并都要求工程师人工确认。
## 一键安装
### Linux
```bash
curl -fsSL https://fun-md.com/Fun_MD/devops-skills/raw/branch/main/install/install.sh | bash
```
### macOS
```bash
curl -fsSL https://fun-md.com/Fun_MD/devops-skills/raw/branch/main/install/install.sh | bash
```
### Windows (PowerShell)
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://fun-md.com/Fun_MD/devops-skills/raw/branch/main/install/install.ps1 | iex"
```
## 工具使用说明
### issue_audit.py
抓取 issue/评论/图片附件并评分去重:
```bash
python skills/gitea-issue-devops-agent/scripts/issue_audit.py \
--base-url https://fun-md.com \
--repo FunMD/document-collab \
--token <TOKEN> \
--state all \
--download-attachments \
--output-dir .tmp/issue-audit
```
### change_scope.py
识别部署范围,控制资源投放:
```bash
python skills/gitea-issue-devops-agent/scripts/change_scope.py --repo-path . --base-ref origin/main --head-ref HEAD
```
### preview_slot_allocator.py
分配/复用/回收预览槽位:
```bash
python skills/gitea-issue-devops-agent/scripts/preview_slot_allocator.py --state-file .tmp/preview-slots.json --slots preview-a,preview-b --repo FunMD/document-collab --issue 48 --branch dev --ttl-hours 24 --url-template https://{slot}.qa.example.com --evict-oldest
```
## 工作流模板
- `.gitea/workflows/issue-branch-preview.yml`
- `.gitea/workflows/preview-slot-reclaim.yml`
用于自动完成:**分配槽位 + 按变更范围部署 + 自动回收**。