bingshuo/fifth-domain
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
fifth-domain/archives/legacy-server-routes/2026-07-07/QUICKSTART-FOR-GENERAL-AI-SG-API.md

174 lines
6.4 KiB
Markdown
Raw Normal View History

feat: make domestic repository map canonical Publish REPO-001 through REPO-008 as domestic routes, add the public AI discovery API, and demote Singapore paths to historical backup.
2026-07-17 16:05:31 +08:00
# 🚀 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
Reference in New Issue Copy Permalink