0c1eebaf54
CI / Build, Lint, Test (push) Failing after 2m24s
Details
|
||
|---|---|---|
| .devops | ||
| .gitea/workflows | ||
| .github/workflows | ||
| cmd | ||
| doc | ||
| docs | ||
| examples/workflows/community-ops-automation | ||
| gitlink-web | ||
| internal | ||
| npm | ||
| scripts | ||
| shortcuts | ||
| skills | ||
| .gitattributes | ||
| .gitignore | ||
| .golangci.yml | ||
| Dockerfile | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| README.zh-CN.md | ||
| REPRODUCE.md | ||
| contributors.csv | ||
| gitlink_cli_contributors.json | ||
| go.mod | ||
| go.sum | ||
| main.go | ||
| main_test.go | ||
README.md
gitlink-cli（jiangtx 小组·竞赛增强版）
本仓库是 gitlink/gitlink-cli 的竞赛 Fork，由 jiangtx 小组为《软件演化与运维》进阶任务 + GitLink 大赛开发。 在官方 40+ 命令 / 11 Skill 基础上，新增 12 个命令模块 / 26 个 Skill / 端到端自动化工作流 / 科研智能服务，覆盖开发者协作与科研辅助两大场景，兼容 Claude Code / OpenClaw / Cursor 等 AI Agent。
🌐 科研服务在线演示：http://121.41.212.97/skills/（Flask + DeepSeek + gitlink-cli，14 个 Skill）
安装 · 功能矩阵 · 子任务成果 · Skills · 复现指南 · 课程报告 · 上游 PR
小组成员
| 成员 | 主责领域 |
|---|---|
| wyx / wyxfzgg | pm / wiki / export / alias·browse·status 命令、安装脚本、DevOps 流水线、编排 Skill |
| 林迪文（lindiwen23） | notification / search / ci / org 增强、gitlink-web 科研服务、research-tracker 等 Skill |
| whzy | workflow 命令、i18n 本地化、编排 Skill、show/demo 离线演示 |
| wangyue789 | pipeline 命令 |
| Mengz | webhook 命令 |
| 蒋天翔（jiangtx） | repo/pr/user 增强、capability、Skill 收录协调 |
| 何开元 | label 命令 |
个人工作量以 GitLink 提交记录为准（
git shortlog -sn）。
为什么用 gitlink-cli（竞赛增强版）
- Agent 原生 — 内置结构化 Skills，Claude Code / OpenClaw / Cursor 等 Agent 零配置即可操作 GitLink。
- 覆盖广 — 仓库、Issue、PR、Webhook、成员、分支、Release、CI、Pipeline、组织、搜索、用户、项目管理(PM)、Wiki、数据导出、通知、能力探测、对比、工作流分析 全覆盖。
- 批量操作 — 批量关闭 Issue、批量更新 Issue 状态、批量添加成员（支持 CSV +
--dry-run预览）。 - 科研赋能 — 科研智能服务覆盖热点追踪 / 项目洞悉 / 合规检查 / 协作匹配 / 进度预警全链路。
- 端到端工作流 — 社区运营、代码质量看门人、项目一键初始化、多仓库协同、贡献者成长等编排 Skill。
- 跨平台 — macOS / Linux / Windows（x64/arm64），
npm install -g @gitlink-ai/cli一键安装。 - 三层架构 — Shortcuts（人 & AI 友好）→ Raw API（全覆盖）→ Config（配置管理）。
功能矩阵
21 个命令组（~129 子命令）
| 命令组 | 说明 | 本组新增 |
|---|---|---|
| repo / issue / pr / release / branch / user / org / search / ci | 官方核心命令（含本组增强：repo 文件操作、issue 批量、pr commits/versions 等） | 部分 |
| pm | 项目管理：仪表盘/Sprint/周报/标签/流水线/运行 | ✨ |
| wiki | Wiki 页面：pages/get/create/update/delete | ✨ |
| export | 数据导出：issues/prs/contributors → CSV/JSON | ✨ |
| notification | 通知：list/read/read-all/watch | ✨ |
| capability | 后端 API 能力探测（跨实例兼容） | ✨ |
| compare | 分支/标签/commit 对比 | ✨ |
| workflow | 本地规则工作流：triage/health/repo-report/pr-summary | ✨ |
| label / member / milestone / pipeline / webhook | 标签 / 成员(含批量) / 里程碑 / 流水线 / Webhook | ✨ |
| alias / browse / status | 开发者体验：别名 / 浏览器跳转 / 状态 | ✨ |
| api / auth / config / show / demo / completion / version | 基础设施 + 离线演示 | 部分 |
37 个 AI Agent Skill（官方 11 + 新增 26） · 详见 skills/README.md 端到端自动化工作流 · 详见 examples/workflows/ 科研智能服务 · 详见 gitlink-web/
安装与快速开始
要求
- Node.js 14+（
npm/npx）用于 npm 安装；Go 1.26+ 用于源码构建；支持 macOS/Linux/Windows。
安装
# 方式 A：npm（推荐，一条命令装好 CLI + Skills）
npm install -g @gitlink-ai/cli
# 方式 B：源码构建（需 Go 1.26+）
git clone https://www.gitlink.org.cn/jiangtx/gitlink-cli.git
cd gitlink-cli && go build -o gitlink-cli . # Windows: go build -o gitlink-cli.exe .
配置与登录
gitlink-cli config init # 一次性引导配置
gitlink-cli auth login # 交互登录（账号密码，推荐）
gitlink-cli auth login --token # 或粘贴私有 token
export GITLINK_TOKEN="your-token" # 或设环境变量（CI/CD、非交互）
gitlink-cli auth status # 确认登录
3 分钟体验
gitlink-cli repo +info --owner Gitlink --repo gitlink-cli # 仓库信息
gitlink-cli issue +list --owner Gitlink --repo gitlink-cli # Issue 列表
gitlink-cli workflow +triage --owner Gitlink --repo gitlink-cli # AI 分拣
gitlink-cli export +contributors --owner Gitlink --repo gitlink-cli --format json # 导出
gitlink-cli capability +check # 后端能力探测
使用示例
新增命令（本组贡献）
# 项目管理
gitlink-cli pm +dashboards --owner jiangtx --repo gitlink-cli
gitlink-cli pm +weekly --owner jiangtx --repo gitlink-cli
# Wiki 管理
gitlink-cli wiki +pages --owner jiangtx --repo gitlink-cli
gitlink-cli wiki +create --owner jiangtx --repo gitlink-cli --title "周报" --content "..."
# 数据导出（CSV/JSON，科研/报表数据源）
gitlink-cli export +issues --owner jiangtx --repo gitlink-cli --format csv --output issues.csv
gitlink-cli export +contributors --owner jiangtx --repo gitlink-cli --format json
# 通知管理
gitlink-cli notification +list
gitlink-cli notification +watch --owner jiangtx --repo gitlink-cli
# 能力探测 + 对比 + 工作流分析
gitlink-cli capability +check
gitlink-cli compare +view --head feature --base master
gitlink-cli workflow +health --repository Gitlink/gitlink-cli --open-issues 3 --open-prs 1 --has-readme --has-license
# 批量操作
gitlink-cli issue +batch-close --owner jiangtx --repo gitlink-cli --numbers 1,2,3 --dry-run
gitlink-cli member +batch-add --owner jiangtx --repo gitlink-cli --user-ids 101,102
# 开发者体验
gitlink-cli alias +set rl "repo +list"
gitlink-cli browse issues/42
gitlink-cli status
核心命令（沿用上游）
gitlink-cli repo +list / +info / +create / +fork
gitlink-cli issue +create / +list / +view / +close / +comment
gitlink-cli pr +list / +create / +view / +merge / +review / +versions
gitlink-cli release +list / +create / +view
gitlink-cli branch +list / +create / +protect
gitlink-cli webhook +list / +create / +test
gitlink-cli ci +builds / +logs / +restart
gitlink-cli pipeline +runs / +run / +logs
gitlink-cli search +repos / +users / +code / +issues
gitlink-cli api GET /users/me # Raw API（未封装接口）
全局参数
| 参数 | 说明 |
|---|---|
--owner / --repo |
仓库所有者 / 名称（git 仓库内自动从 remote 解析） |
--format |
输出格式 json / table / yaml（workflow 另支持 markdown） |
--debug |
调试输出 |
四个子任务成果
子任务一·扩展 CLI（50%）
新增 12 个命令模块、~61 个子命令、3 条批量操作。每个新模块含源码 + 单元测试 + 命令帮助文档 + 变更说明。详见 doc/commands/、doc/changes/。
子任务二·开发 Skill（20%）
新增 26 个 Skill，覆盖智能代码审查 / Issue 分拣 / Release Notes / 项目健康度 / 许可证合规 / 新人引导 6 大场景。6 个已通过 Agent 平台验证。详见 skills/README.md。
子任务三·端到端自动化工作流（20%）
community-ops-automation：串联 repo+info → issue+list → pr+list → release+list → issue+comment 共 4–5 条命令，在 Gitlink/gitlink-cli 与 jiangtx/gitlink-cli 真实项目跑通，含 Python/PowerShell/bash 脚本、JSON 配置、单元测试、SVG 架构图、验证记录。另有 5 个编排 Skill（社区运营/代码质量看门人/项目初始化/多仓库协同/贡献者成长）。
子任务四·应用 GitLink 辅助科研（加分）
科研智能服务 gitlink-web + gitlink-research-tracker Skill：技术调研（多关键词搜索→成熟度评分→趋势→选型），覆盖热点追踪 / 项目洞悉 / 合规检查 / 协作匹配 / 进度跟踪 5 个科研场景。
DevOps 流水线（10%）
.devops/ 建木流水线：ci.yml（test/vet/fmt）· build.yml（编译+命令注册验证）· gitlink-web.yml（科研服务部署）。master 合并自动触发。
AI Agent Skills
skills/ 目录含 37 个 Skill（官方 11 + 新增 26），分类：核心基础 / 命令封装 / 智能化场景（代码审查·分拣·Release·健康度·合规·新人引导）/ 端到端编排 / 科研辅助。兼容 Claude Code / OpenClaw / Cursor。完整说明见 skills/README.md。
科研智能服务 gitlink-web
基于 Flask + DeepSeek API + gitlink-cli 的 Web 服务，14 个 Skill（核心 9 + 科研实验室 5），输入研究主题或仓库 → 自动调 gitlink-cli 拉数据 → DeepSeek 生成结构化报告。
🌐 在线：http://121.41.212.97/skills/ ｜ 代码：gitlink-web/ ｜ 验证报告：作品提交/子任务四
成果落地（竞赛核心）
向真正上游 gitlink/gitlink-cli 提交细粒度 PR（每功能一个特性分支 = 功能代码+测试+文档+变更说明），共 13 个。详见 docs/UPSTREAM_PRS.md：
- 子任务一 CLI（5）：export / pm / notification / alias·browse·status / capability
- 子任务二 Skill（2）：release-notes / compliance-check
- 子任务三 编排 Skill（5）：community-ops / pr-gate / project-bootstrap / multi-repo-ops / contributor-growth
- 子任务四 科研服务（1）：gitlink-web
项目结构
gitlink-cli/
├── cmd/ # Cobra 命令（root/auth/api/config/alias/browse/status/show/demo/...）
├── internal/ # 内部包（auth/client/config/context/output/capability/i18n/demo）
├── shortcuts/ # 21 个命令组（repo/issue/pr/...pm/wiki/export/notification/capability/compare/workflow/...）
├── skills/ # 37 个 AI Agent Skill（11 官方 + 26 新增）
├── gitlink-web/ # 子任务四 科研智能服务（Flask + DeepSeek）
├── examples/workflows/ # 子任务三 端到端工作流（community-ops-automation）
├── .devops/ # 建木 DevOps 流水线（ci/build/gitlink-web）
├── doc/ # 设计文档 + commands/ 命令文档 + changes/ 变更说明
├── docs/ # 报告 + 复现指南 + 上游 PR 清单
├── REPRODUCE.md # 评委复现手册
└── main.go / Makefile / go.mod
文档导航
- 📖 Skills 指南 · 🔧 设计文档 · 📚 命令帮助 · 📝 变更说明
- 🔄 端到端工作流 · 🔬 科研服务
- 🎓 课程报告（软件分析建模 / 新需求构思 / 变更影响分析）
- ✅ 复现指南 · 🏆 上游 PR 清单
FAQ
Q：脚本/CI 中怎么用？ 设 GITLINK_TOKEN 环境变量 + --format json：
export GITLINK_TOKEN="your-token"
gitlink-cli repo +list --format json | jq '.data.projects[] | .name'
Q：owner/repo 自动解析？ 在 git 仓库内运行，自动从 git remote origin 解析。
Q：某命令在 --help 标 ⚠？ 该模块后端暂不支持，gitlink-cli capability +check 查看详情。
Q：完整 API 参考？ 见 skills/gitlink-shared/REFERENCE.md 与 GitLink OpenAPI。