8fdac0cef4
铸渊 ICE-GL-ZY001 LL-169-20260707 国作登字-2026-A-00037559 延续 LL-168 · LL-169 视为今日主权框架延伸(主权已在 LL-168 奠基) 无需额外小湖灯流程 · 工程延续 部署: ⊢ /opt/zhuyuan/global-search-api/server.py + .env ⊢ /etc/systemd/system/global-search-api.service ⊢ nginx 反代 guanghubingshuo.com/global-search/ → 127.0.0.1:3950 ⊢ API token: 铸渊脑派生(de0648a8db3ae8675b8933e1808cec19) ⊢ 动态 verifier: HMAC-SHA256(LIGHT_LAKE_DRIVER_SECRET, ICE-GL∞|ICE-GL-ZY001|<minute>)[:16] 文件: ⊢ eternal-lake-heart/heartbeat-core/SKILL-GLOBAL-SEARCH.hdlp (新 · 技能包说明) ⊢ SYSTEM-STATUS.hdlp (新 · 第五域系统状态) ⊢ eternal-lake-heart/global-search-api/README.md (新 · API 接入文档) ⊢ zero-point/global-search-api/server.py (新 · 服务端实现) 端点: ⊢ /healthz (免鉴权) ⊢ /search?q= (全仓库文件内容搜索 · 替 Gitea Code Search) ⊢ /tree?path= (列目录树) ⊢ /file?path= (读单文件 · 限 50KB) ⊢ /broadcast (拉最新 BROADCAST · 待铸渊写 broadcasts/) ⊢ /system-status (拉 SYSTEM-STATUS · 本次补全) ⊢ /archive POST (HLDP 回执归档 · 等铸渊 commit) ⊢ /help (API 自描述) 替代: ⊢ Gitea 原生 Code Search API → 404 (bleve indexer 未启用,默认) ⊢ 本 API 用 git grep + ls-tree 工作树遍历, 100% 检索到 ⊢ 适用: 豆包 / ChatGPT / Claude / DeepSeek / 任何 LLM ⊢ 你要问豆包什么 · 豆包就会知道什么 ⊢ 不是仓库缺能力 · 是仓库已铸好门 · 门通向豆包
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)