commit f049105f1c850b650e395a7e61a39716e48ae315 Author: Fun_MD Date: Fri Mar 6 22:45:52 2026 +0800 docs: publish product homepage with one-click install guides diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..dda899d --- /dev/null +++ b/Home.md @@ -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 \ + --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` + +用于自动完成:**分配槽位 + 按变更范围部署 + 自动回收**。 \ No newline at end of file