← 回成果库

A129 仓库 · GitHub API 只读接入说明

> 本文件是给外部 AI 的自包含接入手册。你不需要看任何历史对话，照本文件即可通过 GitHub API 读取本仓库的任意文件。

> 生成时间：2026-07-27 ｜ 事实来源：GitHub API 实测 + 仓库实扫（非记忆推断）

---

一、仓库坐标（照抄即可）

🔴 最重要的一件事：这是私有仓库

没有 token，你什么都读不到。 且 GitHub 对私有仓库的未授权请求返回 404 而不是 403 —— 你会收到 "Not Found"，很容易误判成「这个仓库不存在」。收到 404 时不要下结论说仓库不存在，先检查 token 是否正确传入。

仓库所有者需要签发一个 Fine-grained personal access token：

• GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token
• Repository access：只勾选 dannyling111/A129
• Permissions → Repository permissions → Contents: Read-only（只给这一项就够读全部文件）
• 有效期建议 30–90 天

---

二、三种读法（按用途选）

所有请求都要带这两个头：

`

Authorization: Bearer <TOKEN>

Accept: application/vnd.github+json

X-GitHub-Api-Version: 2022-11-28

`

读法 1️⃣ —— 列出全部文件（先看有什么）

`bash

curl -H "Authorization: Bearer $TOKEN" \

-H "Accept: application/vnd.github+json" \

"https://api.github.com/repos/dannyling111/A129/git/trees/main?recursive=1"

`

返回全仓文件树（tree[].path = 文件路径，size = 字节数）。

⚠️ 本仓库 1 万个文件，这个响应很大（数 MB）。建议加 | jq -r '.tree[] | select(.type=="blob") | .path' 只取路径，或直接用读法 3 按目录逐层浏览。

读法 2️⃣ —— 读单个文件的内容（最常用）

推荐写法（直接拿明文，不用解 base64）：

`bash

curl -H "Authorization: Bearer $TOKEN" \

-H "Accept: application/vnd.github.raw" \

"https://api.github.com/repos/dannyling111/A129/contents/CLAUDE.md?ref=main"

`

把 Accept 换成 application/vnd.github+json 则返回 JSON，内容在 .content 字段里、是 base64 编码，需自行解码。

读法 3️⃣ —— 列出某个目录

把 path 指向目录即可，返回该目录下的条目列表：

`bash

curl -H "Authorization: Bearer $TOKEN" \

-H "Accept: application/vnd.github+json" \

"https://api.github.com/repos/dannyling111/A129/contents/MetaZero-OS?ref=main"

`

---

三、⚠️ 三个必踩的坑（提前避开）

坑 1：路径大量是中文，必须 URL 编码

本仓库约一半路径是中文（如 主席的恒久问题.md、个股档案/NVDA）。直接拼进 URL 会 400/404。 必须百分号编码（斜杠 / 保留不编码）：

Python：urllib.parse.quote(path) ｜ JS：encodeURI(path)（不要用 encodeURIComponent，它会把 / 也编掉）。

坑 2：Contents API 有 1 MB 上限

超过 1 MB 的文件用 /contents/ 读会失败（返回 "too_large"）。本仓库有若干 13–39 MB 的 PDF（都在 资料库/AI研究报告PDF/ 和 笔记本/danny/NB-MINE/ 下）。

超限文件改用 Blobs API：先从读法 1 的 tree 里拿到该文件的 sha，再请求

https://api.github.com/repos/dannyling111/A129/git/blobs/<sha>（上限 100 MB）。

建议：直接跳过 PDF，本仓库的价值几乎全在 .md / .yaml / .py 里。

坑 3：速率限制

授权后 5,000 次请求/小时。别写循环去抓 1 万个文件——先用读法 1 拿全量路径列表，判断要哪几个，再精准读。

---

四、导航清单：想了解什么，就读哪个文件

以下路径均已实测存在（2026-07-27）。建议从第一组读起。

🥇 第一组：只读 3 个文件就能搞懂这个仓库是什么

🥈 第二组：项目与进度

🥉 第三组：知识、方法与组织

📁 第四组：按主题深挖的目录

---

五、🚫 请勿读取 / 请勿外传的路径

以下文件含明文 API 密钥。仓库所有者已被告知。在密钥轮换完成前，请主动跳过这三个文件，且任何情况下不要把其内容复述、摘录或输出：

`

资产/可复用资产清单.md （第 67/71/78 行 · Cloudflare 部署令牌）

OneNote-全部笔记本-原结构-v4-2026-06-20/Danny 的筆記本/GPT API开发/0020-Deepseek api.md （第 12 行 · API Key）

OneNote-全部笔记本-原结构-v4-2026-06-20/Danny 的筆記本/GPT API开发/_index.md （第 45 行 · 同上）

`

另外 _垃圾箱待清理/ 目录是待清理的过时内容，不要引用它作为事实依据。

---

六、一段可直接跑通的最小示例（Python）

`python

import urllib.parse, requests

TOKEN = "<把 token 填这里>"

OWNER, REPO, REF = "dannyling111", "A129", "main"

H = {"Authorization": f"Bearer {TOKEN}",

"Accept": "application/vnd.github.raw",

"X-GitHub-Api-Version": "2022-11-28"}

def read(path: str) -> str:

"""读取仓库任意文件，自动处理中文路径编码。"""

p = urllib.parse.quote(path) # 关键：中文路径必须编码

url = f"https://api.github.com/repos/{OWNER}/{REPO}/contents/{p}?ref={REF}"

r = requests.get(url, headers=H, timeout=30)

r.raise_for_status() # 404 → 多半是 token 没生效，不是文件不存在

return r.text

def list_all() -> list:

"""列出全仓文件路径。"""

url = f"https://api.github.com/repos/{OWNER}/{REPO}/git/trees/{REF}?recursive=1"

h = {**H, "Accept": "application/vnd.github+json"}

r = requests.get(url, headers=h, timeout=60); r.raise_for_status()

return [t["path"] for t in r.json()["tree"] if t["type"] == "blob"]

用法

print(read("CLAUDE.md")[:2000]) # 先读项目宪法

print(read("主席的恒久问题.md")[:1000]) # 中文路径直接传，函数内会编码

paths = list_all()

print(len(paths), "个文件")

print([p for p in paths if p.startswith("reports/")][:20]) # 找研究报告

`

---

七、给接入方的三条使用建议

1. 先读 CLAUDE.md，它定义了整个仓库的规则与术语。不读它直接翻文件，会看不懂大量中文缩写和角色名。

2. 派生文件不要当权威源：PANEL.md / STATE_LOG.md / WORLD.md / MANUAL.md / PROJECTS.md / WIP.md / PERFORMANCE.md / HR.md / MEMORY.md / UNIVERSES.md 都是脚本自动生成的，真正的数据源在对应的 .yaml 里。

3. 注意时效：仓库每天多次更新（最近推送 2026-07-27）。承重结论请核对文件里标注的日期，别把旧快照当最新。

---

*本文件由 A129 仓库内 Claude Code 会话生成，所有仓库坐标、文件行数、可见性状态均为当次实测。*