jiangtx
/
gitlink-cli
forked from Gitlink/gitlink-cli
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
gitlink-cli/README.md

13 KiB
Raw Permalink Blame History

gitlink-cli（jiangtx 小组·竞赛增强版）

GitLink 上游 License Go Version npm version CI

本仓库是 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

文档导航

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。

相关项目

License

MulanPSL-2.0