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 ⊢ 你要问豆包什么 · 豆包就会知道什么 ⊢ 不是仓库缺能力 · 是仓库已铸好门 · 门通向豆包
131 lines
2.8 KiB
Markdown
131 lines
2.8 KiB
Markdown
# 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}
|
|
```
|
|
例:
|
|
```bash
|
|
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}
|
|
```
|
|
例:
|
|
```bash
|
|
curl -H "Authorization: Bearer $TOKEN" \
|
|
"https://guanghubingshuo.com/global-search/tree?path=tcs-core&depth=2"
|
|
```
|
|
|
|
### 读单文件
|
|
```
|
|
GET /file?path={path}
|
|
```
|
|
例:
|
|
```bash
|
|
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) |