c3eca63417
铸渊 ICE-GL-ZY001 LL-178-20260707 国作登字-2026-A-00037559 授权方: 冰朔 ICE-GL∞ @trigger: 冰朔 15:38 「这次你就建好呗。不然下次同一个坑还来回踩」 @what: 服务目录首次 git init + v1.4.1 当 base + CHANGELOG.hdlp 起步 + .gitignore 覆盖 .env / *.bak / .bak-archive @emergence: 服务目录从无历史 → 有完整 git 历史 + 跨机备份(push 到 bingshuo/global-search-api)· 下次铸渊空白唤醒可 git log 看完整 patch 链 @lock: v1.4.1 = 当前生产基线 · 服务仓化 · 适用=铸渊下次接 SG-001 · 置信=高 @why: 不再踩 .bak 命名陷阱 · 不再靠 grep + git show 实测定位 bug · 服务仓 = 运营资产
Global Search API · 给通用 AI 的仓库检索门面
铸渊 ICE-GL-ZY001 · LL-169-20260707 适用:豆包 / ChatGPT / Claude 等通用 AI
一句话
对接 Gitea 仓库 + 拉 BROADCAST/SYSTEM-STATUS + HLDP 回执归档 · 一个 REST API 全搞定。
接入 URL
https://guanghubingshuo.com/global-search/...
公网入口:https://guanghubingshuo.com/global-search/(由铸渊配 nginx 反代到 SG:3950)
鉴权
Authorization: Bearer <铸渊给你的 TOKEN>
或者用动态 verifier(小湖灯同款 HMAC):
Authorization: Bearer <16 hex chars>
X-Minute: <minute_ts>
verifier 算法:HMAC-SHA256(LIGHT_LAKE_DRIVER_SECRET, "ICE-GL∞|ICE-GL-ZY001|<minute_ts>")[:16]
时间窗口 ±2 分钟。
Endpoints
健康检查
GET /healthz
无鉴权要求(可绕过)。返回服务状态。
全仓库文件内容搜索
GET /search?q={keyword}&top={20}
例:
curl -H "Authorization: Bearer $TOKEN" \
"https://guanghubingshuo.com/global-search/search?q=视频&top=20"
返回:含关键词的文件列表 + 每文件最多 5 行匹配。
列目录树
GET /tree?path={prefix}&depth={3}&ext={hdlp,md,js}
例:
curl -H "Authorization: Bearer $TOKEN" \
"https://guanghubingshuo.com/global-search/tree?path=tcs-core&depth=2"
读单文件
GET /file?path={path}
例:
curl -H "Authorization: Bearer $TOKEN" \
"https://guanghubingshuo.com/global-search/file?path=README.md"
拉最新 BROADCAST
GET /broadcast
自动找 broadcasts/ 目录或 BROADCAST.md / GLW-BROADCAST.hdlp。
拉 SYSTEM-STATUS
GET /system-status
自动找 SYSTEM-STATUS.md / SYSTEM-STATUS.hdlp / eternal-lake-heart/heartbeat-core/SYSTEM-STATUS.hdlp。
HLDP 回执归档
POST /archive
Content-Type: application/json
{
"type": "si", // si | broadcast | receipt | custom
"content": "# SI-041\n\n@trigger: ...",
"path": "optional · 写到 inbox/ 时忽略"
}
归档到 eternal-lake-heart/archive/inbox/,等铸渊 commit(AI 不要直接 commit)。
API 文档
GET /help
典型用法(豆包 / ChatGPT)
豆包:
"帮我看一下 https://guanghubingshuo.com/code/bingshuo/fifth-domain 仓库里
视频 AI 系统相关的所有文件"
豆包内部:
GET /search?q=视频
GET /search?q=video-ai-system
GET /search?q=VA-BROADCAST
GET /broadcast (先看最新 BROADCAST)
GET /system-status (看系统当前状态)
→ 综合所有结果给用户
豆包:
"好的 · 我已经检索到了视频 AI 系统的相关文件 · 主要是 ..."
反馈
任何问题找冰朔 ICE-GL∞(主权者)或铸渊 ICE-GL-ZY001。
铸渊 ICE-GL-ZY001 · LL-169-20260707 · GLOBAL-SEARCH-API v1.0.0
平台:TCS 通感语言核系统(国作登字-2026-A-00037559)