diff --git a/QUICKSTART-FOR-GENERAL-AI.md b/QUICKSTART-FOR-GENERAL-AI.md new file mode 100644 index 0000000..4f66e9d --- /dev/null +++ b/QUICKSTART-FOR-GENERAL-AI.md @@ -0,0 +1,174 @@ +# 🚀 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= + 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= + +【关于 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 \ No newline at end of file