GitLink CI/CD Demo Project（danshen/CI）

一个用于演示 GitLink / GitHub Actions 风格 CI/CD 的示例项目。

项目结构

.
├── .github/workflows/       # GitLink 流水线（轻量引擎：version / type / trigger）
│   ├── ci.yml
│   └── deploy-staging.yml
├── .GitLink/workflows/      # 与 .github/workflows 内容一致（任选其一目录保留即可，避免重复）
│   ├── ci.yml
│   └── deploy-staging.yml
├── Dockerfile
├── src/
├── tests/
├── package.json
├── package-lock.json        # 提交到 Git，CI 里 npm ci 需要
├── .gitlab-ci.yml           # 若平台支持 GitLab CI，推送后可能自动跑（视 GitLink 而定）
├── gitlink-ci-import.yml    # 轻量引擎 version:2 格式（部分导入入口用）
├── gitlink-pm-editor-ci.yml # GitLink「流水线流程编排」编辑器（pm.gitlink.org.cn）里粘贴用
└── README.md

功能特性

• greet(name): 生成问候语
• add(a, b): 加法运算
• isValidEmail(email): 邮箱验证

流水线页是「暂无数据」时（重要）

你在 https://gitlink.org.cn/danshen/CI/actions 看到的是 「暂无数据」 和蓝色 「新建流水线」 按钮。这说明：

当前 GitLink 不会在「流水线」列表里自动出现你在代码里放的 .github/workflows/*.yml。
列表里的每一条流水线，通常要在网页上 点「新建流水线」 创建一次（配置保存在平台里），或按向导 从仓库导入 某个 YAML（若界面提供该选项）。

请按下面顺序操作（名称以你页面上为准）：

1. 点 「新建流水线」。
2. 若向导里让填 流水线名称，例如填：CI。
3. 若有 关联仓库 / 分支，选本仓库 danshen/CI、分支 master。
4. 若有 「从仓库导入 YAML」/「选择配置文件」：选仓库里的 gitlink-ci-import.yml（与 .github/workflows/ci.yml 内容相同）。
5. 若没有导入选项、而是 「图形化添加步骤」：依次添加等价步骤：检出代码 → Node 20 → 执行 npm ci → npm run lint → npm run type-check → npm test -- --coverage。
6. 保存后回到 流水线(devops)，应能看到刚建的流水线；再 推送一次 master 或点 「运行」 试跑。

仓库根目录已增加 .gitlab-ci.yml。若 GitLink 底层兼容 GitLab Runner，有可能在 其它菜单（如「构建」「CI 配置」）里出现自动流水线；以平台说明为准。

仓库里 YAML 说明（与网页「新建流水线」的关系）

文件	用途
.github/workflows/ci.yml	GitLink 轻量引擎写法（version: 2 + trigger），供导入或文档对照
gitlink-ci-import.yml	同上，根路径便于在「从仓库选择文件」里选中
.gitlab-ci.yml	标准 GitLab CI，若平台支持则可能在推送后自动执行

针对仓库 https://gitlink.org.cn/danshen/CI.git 的操作示例

你的 GitLink 项目页：danshen/CI（默认分支一般是 master）。流水线入口在顶部 「流水线(devops)」。

1. 在本机绑定远程并推送（PowerShell）

在项目根目录执行（若已添加过 origin，先 git remote remove origin）：

cd d:\Litter\111
git remote add origin https://gitlink.org.cn/danshen/CI.git
git checkout -B master
git add -A
git status
git commit -m "chore: add CI/CD workflows and demo app"

若远程已有一次提交（例如只有 README.md），第一次推送前需要合并历史：

git pull origin master --allow-unrelated-histories
# 若有冲突，按提示解决后：git add -A && git commit -m "merge remote"
git push -u origin master

若你确认可以覆盖远程、只保留本地这一套代码：

git push -u origin master --force

2. 在网页上点哪里

1. 打开：https://gitlink.org.cn/danshen/CI
2. 代码库：确认 master 上已有最新提交。
3. 流水线(devops)：若仍为「暂无数据」，按上文 「流水线页是暂无数据时」 用 「新建流水线」 创建。
4. 仓库设置：若有「CI / Runner / 构建」相关开关，按 GitLink 帮助 说明打开。

3. 分支说明

工作流里的 ref: refs/heads/master 只对 master 生效。改用 main 时，请把 ci.yml、deploy-staging.yml、gitlink-ci-import.yml 里的 ref 以及 .gitlab-ci.yml 里的 CI_COMMIT_BRANCH 规则一并改掉。

---

你在 GitLink 上还需要做的事（小结）

1. 推送代码到 master（见上文 PowerShell）。
2. 在流水线页用「新建流水线」建至少一条流水线（或导入 gitlink-ci-import.yml），否则列表会一直为空。
3. 需要第二条「预发布构建」时，再建一条流水线或导入 deploy-staging 对应 YAML（见 .github/workflows/deploy-staging.yml）。

开发命令

npm ci
npm run lint
npm run type-check
npm test
npm run build

许可证

MIT License