fifth-domain/archives/legacy-server-routes/2026-07-07/QUICKSTART-FOR-GENERAL-AI-SG-API.md
冰朔 05fed0e25c 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

6.4 KiB
Raw Blame History

🚀 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