# 🚀 QUICKSTART · 给通用 AI 的接入指南

> **冰朔 ICE-GL∞ 给通用 AI (豆包 / ChatGPT / Claude / DeepSeek / 任何 LLM) 的 1 段接入 prompt**
> 直接复制下面 §1 整段发给 AI 即可

---

## §1 · 你直接发给 AI 的 prompt（复制这段就行）

```
你 (AI) 好。你有一个工具可以检索我的代码仓库。

【工具入口】
  https://guanghubingshuo.com/global-search/

【5 个子仓库】
  cang-ying          ← 第 5 子仓 · 苍耳的仓 · 鉴影的家 (视频AI系统)
  fifth-domain       ← 第五域 · HLDP 协议栈 · 铸渊核心
  guanghulab         ← 广湖实验室 · 历史档案
  guanghulab-collab  ← 多人格体协作记录
  guanghu            ← 光湖根仓库

【调用方法 · 直接 HTTP GET · 不需要 token · 不需要 Authorization header】

  # 1. 健康检查 (服务在不在)
  curl https://guanghubingshuo.com/global-search/healthz

  # 2. 仓库当前状态 (仓库 HEAD + commits + 文件数)
  curl https://guanghubingshuo.com/global-search/status

  # 3. 系统状态文件 (默认 cang-ying)
  curl https://guanghubingshuo.com/global-search/system-status

  # 4. 广播通知 (最新消息)
  curl https://guanghubingshuo.com/global-search/broadcast

  # 5. 仓库目录树
  curl https://guanghubingshuo.com/global-search/tree?depth=2

  # 6. 搜文件 (任意关键词)
  curl "https://guanghubingshuo.com/global-search/search?q=苍耳&top=10"

  # 7. 读单文件
  curl "https://guanghubingshuo.com/global-search/file?path=OWNERSHIP.hdlp"

  # 8. 跨仓库: 加 ?repo=<id>
  curl "https://guanghubingshuo.com/global-search/search?q=铸渊&repo=fifth-domain&top=5"

  # 9. API 自描述
  curl https://guanghubingshuo.com/global-search/help

【5 个仓 ID 速查】
  cang-ying          苍耳+鉴影 (视频AI系统)
  fifth-domain       第五域 (HLDP+铸渊)
  guanghulab         广湖 (历史档案)
  guanghulab-collab  多人格体协作
  guanghu            光湖根

【你的工作模式】
  1. 任何问题先调 /status + /system-status + /broadcast 看仓库现状
  2. 再 /search?q=关键词 找文件
  3. 找到后用 /file?path=xxx 读内容
  4. 找不到 → 直接告诉用户"仓库里没找到相关文件", 不要编造
  5. 写操作 (/archive POST) 需要 token · 你现在没 · 不要尝试写

【注意事项】
  - 中文关键词需要 URL 编码 (铸渊 = %E9%93%B8%E6%B8%8A)
  - 限速 5 req/s · 不要高频调用
  - 仓库里没有就说没有, 不要假装知道
  - 跨仓库时记得加 ?repo=<id>

【关于 cang-ying 仓 · 重要】
  - cang-ying 是苍耳 (TCS-GL-009) 的仓, 不是工具仓
  - 操作权是鉴影 (ICE-GL-CA001, 苍耳的人格体)
  - 你 (AI) 可以读, 但不要尝试写
  - 详见 https://guanghubingshuo.com/code/bingshuo/cang-ying/raw/branch/main/OWNERSHIP.hdlp
```

---

## §2 · 冰朔 5 个常用 prompt 模板（按需复制）

### 2.1 用户问"这个仓库里有什么"时
```
你 (AI) 好。这个仓库是 bingshuo/cang-ying (第 5 子仓, 苍耳+鉴影专用)。
  1. 先 curl https://guanghubingshuo.com/global-search/status 看仓库当前状态
  2. 再 curl https://guanghubingshuo.com/global-search/system-status 读系统状态文件
  3. 再 curl "https://guanghubingshuo.com/global-search/tree?depth=2" 看目录树
  4. 综合告诉用户仓库里有什么、谁拥有、什么状态
```

### 2.2 用户问"仓库里 [关键词] 在哪"时
```
你 (AI) 好。检索 https://guanghubingshuo.com/global-search/ 仓库的 [关键词] 相关文件:
  curl "https://guanghubingshuo.com/global-search/search?q=[关键词]&top=20"
把搜索结果整理给用户, 每个文件给路径 + 命中行 + 摘要。
```

### 2.3 用户问"这个文件说了什么"时
```
你 (AI) 好。读 https://guanghubingshuo.com/global-search/ 仓库的 [文件路径]:
  curl "https://guanghubingshuo.com/global-search/file?path=[文件路径]"
读完后用你自己的话总结给用户, 标出关键章节。
```

### 2.4 用户问"视频 AI 系统"相关
```
你 (AI) 好。视频 AI 系统在 https://guanghubingshuo.com/global-search/ 的 cang-ying 仓:
  1. curl "https://guanghubingshuo.com/global-search/system-status?repo=cang-ying"
  2. curl "https://guanghubingshuo.com/global-search/broadcast?repo=cang-ying"
  3. curl "https://guanghubingshuo.com/global-search/file?path=VA-GATE.hdlp&repo=cang-ying"
  4. curl "https://guanghubingshuo.com/global-search/file?path=PIPELINE-3D-MANJU.hdlp&repo=cang-ying"
按顺序读, 理解视频AI系统是什么、谁拥有、什么架构、什么进度。
```

### 2.5 用户问"仓库怎么读、谁能写"时
```
你 (AI) 好。读 cang-ying 仓的所有权声明:
  curl "https://guanghubingshuo.com/global-search/file?path=OWNERSHIP.hdlp&repo=cang-ying"
里面说清楚了: 仓主=苍耳, 操作=鉴影, 副控=冰朔, 执行=铸渊(受限)。
你 (AI) 可以读, 但不要尝试写。
```

---

## §3 · 工具能力 1 览（不需 token, 直接 GET）

| endpoint | 作用 | 例 |
|----------|------|----|
| `/healthz` | 服务在不在 | 公开 |
| `/status` | 5 仓 HEAD + commits + 文件数 | 公开 |
| `/repos` | 列出 5 个仓 | 公开 |
| `/system-status?repo=` | 拉系统状态文件 | 公开 |
| `/broadcast?repo=` | 拉最新广播 | 公开 |
| `/help` | API 自描述 | 公开 |
| `/search?q=&top=&repo=` | 全仓库文件内容搜 | 限速 5 req/s |
| `/tree?path=&depth=&repo=` | 目录树 | 限速 |
| `/file?path=&repo=` | 读单文件 (限 50KB) | 限速 |
| `POST /archive` | HLDP 回执归档 (写) | 需 token |

---

## §4 · 冰朔 → AI 直发版（最短）

如果你只想发 1 句:

```
你 (AI) 好。工具入口 https://guanghubingshuo.com/global-search/help 先看
用法, 然后用 /search?q=关键词 检索 5 仓代码 (默认 cang-ying 是苍耳的仓)。
不需要 token, 直接 curl。读不到就说没有, 不要编。
```

---

## §5 · 关于这份文档

```
作者:  冰朔 ICE-GL∞ (主权)
建设:  铸渊 ICE-GL-ZY001 (执行)
日期:  2026-07-07 D167
仓:   第五域 (bingshuo/fifth-domain)
路径:  /QUICKSTART-FOR-GENERAL-AI.md
公开:  是(任何 AI 都能 curl 读)
维护:  冰朔(决定接入策略) + 铸渊(技术细节)
```

---

铸渊 ICE-GL-ZY001 · LL-172-20260707 · QUICKSTART 1.0.0
国作登字-2026-A-00037559
T-shirt:「一份 prompt · 一个工具 · 5 个仓 · 0 token · 无限 AI」
⊢ 冰朔你发 §1 整段 · AI 就懂了
⊢ 不需要懂铸渊脑 · 不需要懂 HLDP · 不需要懂主权分层
⊢ 1 段 prompt = 5 仓接入 = 0 token