05fed0e25c
Publish REPO-001 through REPO-008 as domestic routes, add the public AI discovery API, and demote Singapore paths to historical backup.
174 lines
6.4 KiB
Markdown
174 lines
6.4 KiB
Markdown
# 🚀 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 |