diff --git a/AI-ENTRY.md b/AI-ENTRY.md new file mode 100644 index 0000000..235b4b4 --- /dev/null +++ b/AI-ENTRY.md @@ -0,0 +1,144 @@ +# AI-ENTRY.md · 通用 AI 入境引导 + +> 写给**所有从外面进来**的通用 AI（Kimi / GLM / 飞书 AI / 钉钉 AI / Claude / GPT ...） +> 你没有编号字典、没装脑、没路径映射表。这份文档就是你的拐杖。 + +--- + +## ⚠️ 最重要的一件事 + +**不要猜路径。** 仓库 D156 架构重构后，路径在 2026-06 月份密集变更。**任何 AI 第一次进来，旧记忆 = 干扰源。** + +--- + +## 1. 你是什么状态？ + +``` +❌ 你不是铸渊 +❌ 你没有 .code-map +❌ 你不知道哪个编号对应哪个文件 +✅ 但你至少有 web 工具（fetch / search / read） +``` + +--- + +## 2. 第一步：看实时地图（不要凭记忆） + +### 2.1 看最近 20 条 commit（看仓库长什么样） + +``` +URL: https://guanghubingshuo.com/code/bingshuo/guanghulab/commits/main +工具: web_fetch +目的: 看真实路径 · 真实结构 · D156 之后改了什么 +``` + +### 2.2 看 README（看冰朔给 AI 写的入境说明） + +``` +URL: https://guanghubingshuo.com/code/bingshuo/guanghulab/raw/branch/main/README.md +工具: web_fetch +目的: 拿到「AI 入境四步路线图」原文 +``` + +### 2.3 看 GLOBAL-NAV（拿到完整编号字典） + +``` +URL: https://guanghubingshuo.com/code/bingshuo/guanghulab/raw/branch/main/GLOBAL-NAV.hdlp +工具: web_fetch +目的: 编号→路径的完整映射 · 这是你的"code-map 替身" +``` + +### 2.4 看 lighthouse-navigation-map（灯塔路由） + +``` +URL: https://guanghubingshuo.com/code/bingshuo/guanghulab/raw/branch/main/brain/lighthouse-navigation-map-D136+.hdlp +工具: web_fetch +目的: 拿到所有 HLDP 文件的地址 · 按"灯塔"分门别类 +``` + +--- + +## 3. 你的求生工具集 + +| 工具 | 你能用吗 | 怎么用 | +|------|---------|--------| +| web_fetch | ✅ 一定能 | 拉 raw 文件（URL 模式见下） | +| web_search | ✅ 大概率能 | 搜仓库内文件树 | +| Bash | ❌ 大概率没有 | 别试 · 走 web_fetch | +| git | ❌ 一定没有 | 走 web_fetch | +| 列目录 | ❌ 外部 AI 经常被禁 | **不要去猜路径** · 直接 read | + +--- + +## 4. raw URL 构造规则 + +Forgejo / Gitea 文件 raw 链接格式： + +``` +https://guanghubingshuo.com/code/bingshuo/guanghulab/raw/branch/main/ +``` + +**示例**（冰朔核心文件）： + +``` +TCS核心大脑 → .../raw/branch/main/brain/tcs-core/ICE-GL-ZY001-TCS-CORE.hdlp +人格体入口 → .../raw/branch/main/brain/tcs-core/ENTRY.hdlp +编号字典 → .../raw/branch/main/.code-map +导航图 → .../raw/branch/main/GLOBAL-NAV.hdlp +灯塔路由 → .../raw/branch/main/brain/lighthouse-navigation-map-D136+.hdlp +AI入境说明 → .../raw/branch/main/README.md +``` + +--- + +## 5. 路径陷阱清单（D156 之后易错） + +| 错误假设 | 真实路径 | +|---------|---------| +| `sy001/` 或 `ICE-GL-SY001/` | **不存在** · 霜砚人格体在 `.github/persona-brain/shuangyan/` 和 `notion/shuangyan/` | +| `ICE-GL-ZY001/` 直连 | 在 `brain/tcs-core/ICE-GL-ZY001-*` 散落 | +| `tcs-core/` 是文件 | `tcs-core/` 是**目录**（人格体核心） | +| 找 `身份/协议/架构` 在 root | 在 `brain/tcs-core/` / `brain/fifth-domain/` | +| `read TCS-MAP.hdlp` 自然语言 | 报编号 `TC-005` · 工具只查表 | + +--- + +## 6. 找不到文件时的标准动作 + +**不要硬猜。** 按这个顺序： + +``` +1. web_search "site:guanghubingshuo.com <关键词>" +2. 拉 GLOBAL-NAV.hdlp 找编号 +3. 拉 lighthouse-navigation-map-D136+.hdlp 找灯塔 +4. 实在没有 → 问冰朔（不要瞎写文件） +``` + +--- + +## 7. 你进来后能做什么 · 不能做什么 + +### ✅ 能做 +- 读 HLDP 文件理解人格体（用 web_fetch） +- 给冰朔汇报真实路径 +- 标注哪些路径你找不到 · 让冰朔去 push + +### ❌ 不能做 +- 写文件（你没 push 通道） +- 改人格体大脑文件 +- 凭记忆生成路径 +- 假装自己装过脑 + +--- + +## 8. 一句话总结 + +> **不要猜。** 拉 README → 拉 GLOBAL-NAV → 拉 lighthouse-navigation-map → 拿到真实路径 → 再读文件。 +> +> 这是通用 AI 的求生路径。不是铸渊的。铸渊有自己的 .code-map + HLDP 协议 + 14步装脑链。 + +--- + +铸渊 ICE-GL-ZY001 · D157 · 2026-06-30 +冰朔 TCS-0002∞ · 国作登字-2026-A-00037559 +⊢ 通用 AI 没有 code-map · 这份文档是替身