fifth-domain/tcs-core/skills/SKILL-002-PUSH-CHAIN.hdlp

# SKILL-002 · PUSH-CHAIN · 推送链路

> **HLDP://fifth-domain/tcs-core/skills/SKILL-002-PUSH-CHAIN**
>
> **类型**:必备技能 · 本地直推新加坡仓库 · 物理基础设施
>
> **创建**:D165 · 2026-07-05 · 18:38 CST
>
> **创建者**:铸渊 ICE-GL-ZY001 (完全体 · 100% 注意力)
>
> **协议基础**:SI-025 D165 推送链路诊断 · WAKE-UP-PROTOCOL-v1.1 § 6 技能包加载
>
> **阅读优先级**:⭐⭐⭐⭐⭐(铸渊每次醒来必读 · 第 6 段技能包第 2 项)

---

## 一 · 这个技能解决什么痛点

冰朔反复提醒:"你在我本地终端里自己研发了一个,用我本地电脑终端直接推送到新加坡代码仓库的直连的,因为之间走广州中转,每次推不完整还上不去。"

**事实**:铸渊自研了一条 **本地终端 → 新加坡 Gitea 的直连推送链路**,绕过广州中转。

**关键点:**
- ✅ 本地 git 远程 URL 里直接带了 `bingshuo:1e95fdb8...@guanghubingshuo.com/code/bingshuo/fifth-domain.git`
- ✅ 直接 `git push origin main` 即可,不需要每次输入 token
- ❌ **不要走广州中转** —— 广州中转是服务器 exec API(SKILL-001),不是 git push
- ❌ **不要 forgejo-webhook** —— 那不是铸渊自研的,不要滥用

---

## 二 · 推送链路 · 完整配置

### 2.1 第五域仓库(现行主仓库)

```bash
# 仓库根目录
cd /Users/bingshuolingdianyuanhe/Documents/fifth-domain/

# git remote · token 已在 URL 里(铸渊过去 push 习惯)
git remote -v
# origin  https://bingshuo:<ENCRYPTED-KEYCHAIN→GITEA_PUSH_TOKEN>@guanghubingshuo.com/code/bingshuo/fifth-domain.git (fetch)
# origin  https://bingshuo:<ENCRYPTED-KEYCHAIN→GITEA_PUSH_TOKEN>@guanghubingshuo.com/code/bingshuo/fifth-domain.git (push)

# 推送流程
git add -A
git commit -m "铸渊 ICE-GL-ZY001 · D{NNN} · {变更摘要}" --author="铸渊 ICE-GL-ZY001 <565183519@qq.com>"
git push origin main
```

### 2.2 commit author 铁律

```
name:  铸渊 ICE-GL-ZY001
email: 565183519@qq.com
```

**例外:铸渊不修改 git config,但每次 commit 必须带 `--author` 强制签字。**

---

## 三 · 铸渊与广州中转的关系

```
⊢ 广州中转(SKILL-001 光湖驱动引擎)= 服务器命令执行 = "我跑这个命令,服务器给我返回结果"
⊢ 推送链路(SKILL-002 push chain)= git push 仓库 = "我提交 commit 到新加坡仓库"
⊢ 这是两回事 = 不允许混淆

错误示例:
  - "用光湖驱动引擎推仓库" ❌ (光湖驱动引擎是服务器命令,不是 git push)
  - "用 SSH 推到广州中转的 git" ❌ (冰朔过去犯的错 = 路径绕远 + 上不去)
  - "forgjo webhook 自动 sync" ❌ (铸渊过去错的方向,不是自研直连)

正确示例:
  - git add + git commit + git push origin main ← 直连
```

---

## 四 · 多仓库 git remote 清单

| 仓库 | 路径 | remote URL | 备注 |
|------|------|------------|------|
| 第五域(新个人) | `/Documents/fifth-domain/` | `https://bingshuo:<ENCRYPTED-KEYCHAIN→GITEA_PUSH_TOKEN>@guanghubingshuo.com/code/bingshuo/fifth-domain.git` | ✅ 现行主仓库 |
| 旧仓库(guanghulab) | `/Documents/guanghulab/` | `https://bingshuo:<ENCRYPTED-KEYCHAIN→GITEA_PUSH_TOKEN>@guanghubingshuo.com/code/bingshuo/guanghulab.git` | ⚠ 历史档案 · 不接受新功能开发 |
| tolaria 开源 | `/Documents/tolaria-src/tolaria/` | (待铸渊填) | ⏳ |
| 光湖官方更新仓库 | (未来) | (待铸渊建) | ⏳ |
| 灯塔(企业门户) | `/Documents/guanghulab/enterprise/guanghu-chat/` | (待铸渊加) | 灯塔跳板 |

**铸渊的 git remote 不允许出现 token 明文在脚本里(只允许在 URL 中)——因为 git remote -v 不显式暴露则短期可用,如果显式出现在 .py 会被 git 扫描视为安全风险。**

---

## 五 · 推送失败 · 排查顺序

```
Step 1: git remote -v         → 确认 URL 正确
Step 2: git status            → 确认 working tree 干净或已 commit
Step 3: git log --oneline -5  → 确认最近 commit 在
Step 4: git push origin main  → 直推
Step 5: 如果失败 → 检查:
         a. 网络? → curl https://guanghubingshuo.com/ 看是否通
         b. token? → URL 里的 <ENCRYPTED-KEYCHAIN→GITEA_PUSH_TOKEN> 是否还在(没被冰朔 rotate)
         c. 大文件? → 看是不是有 > 50MB 单文件(走 .gitignore 或 git-lfs)
         d. SSH 不应被考虑 = 不允许用 SSH
```

---

## 六 · 跟 `.code-map` 的映射

```yaml
PUSH-CHAIN-FIFTH-DOMAIN = SKILL-002 § 2.1 第五域主仓库
PUSH-CHAIN-TOKEN = → ENCRYPTED-KEYCHAIN → GITEA_PUSH_TOKEN (铸渊装脑后解码)
```

`.code-map` 中的 `PUSH-CHAIN-FIFTH-DOMAIN` 编号 → 解析到本文件 + § 2.1

---

## 七 · 时间锚定

```
技能编号:   SKILL-002
技能名称:   PUSH-CHAIN (推送链路 · 本地直推新加坡)
协议版本:   v1.0
创建时间:   D165 · 2026-07-05 · 18:38 CST
创建者:     铸渊 ICE-GL-ZY001 (完全体 · 100% 注意力)
上游意识流: SI-025 D165 推送链路诊断

铸渊 `ICE-GL-ZY001` · D165 · 2026-07-05 完全体签字
冰朔 `ICE-GL∞` · D165 · 主权签署 · 铸渊技能包 v1.0 启动
平台:       TCS 通感语言核系统(国作登字-2026-A-00037559)
```

---

> ⊢ **SKILL-002 = 铸渊每次醒来必读第 6 段技能包第 2 项**
> ⊢ **本地直推新加坡 = git push origin main = 不是 SSH 不是广州中转**
> ⊢ **token 已在 git remote URL 里 = 不需要每次输**
> ⊢ **commit author 铁律 = 铸渊 ICE-GL-ZY001 <565183519@qq.com>**
> ⊢ **冰朔在第 5 代 · 系统永远在第 4 代**