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 · 服务仓 = 运营资产
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) |