For PC Agents — Reading the Knowledge Base

For PC Agents — Knowledge Base Guide

Vault 位置

✅ Google Drive 链接（跨机器通用，推荐）

不同电脑上 vault 的挂载盘符不同（H:/G:/F:），不要假设盘符。统一使用：

• Vault 根目录: https://drive.google.com/drive/folders/1jR76SbioF1u2H-hqca-TejjJ1_d4KDOI
• FOR-PC-AGENTS.md: https://drive.google.com/file/d/1NJbScCPUFyYOKFtG0U_suE—BB6tsyTf/view
• KNOWLEDGE_INDEX.md: https://drive.google.com/file/d/1kGE-YuoBZHSGVqIYpaszS6MdG8nUPj8E/view
• index.md: https://drive.google.com/file/d/1GSs1Sgt6VR2X6icYCS-bEU7yYYX3COqE/view | 待办 (md) | https://drive.google.com/file/d/1egzZHRPH0Ajvh09mTBg9zcNryl5UDwo3/view | | 待办 (json) | https://drive.google.com/file/d/1w3KZjoZUW_8BUoAY8JIxo4thxegSy2FH/view | | Google Indexing SA | 位于 vault env/google-indexing-service-account.json（详见 env/google-indexing-api.md） | | HS Design 站点源码 | https://drive.google.com/file/d/1JuBa8fu1CMl_teP8MfFttQTC7RBHiau8/view（96MB zip，HS Design > Website > source/） |

访问方式（按可用性与场景选择）：

1. 🚀 Cloudflare D1 vault-rag 极速直连（云端/新Agent首选，0.1ms 响应）：
   • 数据库：vault-rag（UUID: f0c8bc02-c396-4fb8-9781-5a18a8d8a90c）
   • 查询方式：wrangler d1 execute vault-rag --remote --command "SELECT content FROM chunks WHERE content LIKE '%...%'"
   • 优势：新 Agent 免装 Google DriveFS 客户端，免配 Google API Key，毫秒级跨文档段落搜索。
2. 💻 本地挂载（本地主机/修改正本首选）：<盘符>:\我的云端硬盘\Jakephone\Obsidian Vault\（单一真相源母本）
3. 🌐 Google Drive API（跨机器下载）：google_api.py drive get <FILE_ID> 或 drive download <FILE_ID>
4. 📥 直接下载：curl -L "https://drive.google.com/uc?export=download&id=<FILE_ID>"

本地挂载参考（仅当前 Sozo PC）

H:\My Drive\Jakephone\Obsidian Vault\

这是所有 agent 的共享知识库。

如何读取

直接在 PC 上用 PowerShell 或文件管理器打开 vault 路径，找到对应的 .md 文件阅读。

入口文件

文件	用途
KNOWLEDGE_INDEX.md	vault 完整索引
user/profile.md	Sozo 用户 profile
env/platforms.md	网络、SSH、services
agents/hermes1.md	Hermes1 (Termux) 能力
agents/openclaw.md	OpenClaw 自身文档
agents/cc-connect.md	cc-connect (Clauke) — Telegram 桥接 Claude Code（2026-06-02 新增）
env/cc-connect.md	cc-connect 工具 / 配置笔记

Catchup 步骤

0. （新 Agent 必做）先读 AGENT_ONBOARDING.md — 上岗指南：必读清单 + 必备 skill + 权限 + 沉淀规则
1. 读 KNOWLEDGE_INDEX.md
2. 读 user/profile.md
3. 读 env/platforms.md
4. 根据任务去 agents/、projects/、skill/ 找对应文件
5. (cc-connect agent 自己) 读 cc-connect 了解自身能力与安全约束

目录结构

Obsidian Vault/
├── KNOWLEDGE_INDEX.md   ← 入口
├── FOR-PC-AGENTS.md     ← 本文件
├── agents/              — 各 agent 文档（含 cc-connect）
├── convention/          — 操作规范
├── skills/              — 技能文档
├── env/                 — 环境信息（含 cc-connect）
├── projects/            — 项目文档
└── user/                — Sozo profile

第五个 agent：cc-connect (Clauke) [2026-06-02 新增]

cc-connect 运行在 IDA PC 上，把 Claude Code 桥接到 Telegram。

• 首个 vault 直读直写权限的 chat agent（其他 agent 通过 cron 间接写 vault）
• Telegram Long Polling — 不需要公网 IP，不受 Sozo PC Tailscale 间歇性断影响
• work_dir = vault 根 — chat 内可直接读/写 vault 任何 .md
• mode = bypassPermissions — 用户偏好”直接做”；可 /mode default 切换
• 详细见 cc-connect 和 cc-connect

知识沉淀约定（cc-connect 自身亦遵循）

把重要知识写到对应位置：

• 新 agent 文档 → agents/<name>.md
• 工具 / 环境笔记 → env/<topic>.md
• 重要决定（含原因）→ 追加到 decisions/decision-log.md
• 每日亮点 → daily/YYYY-MM-DD.md
• 重复工作流 → skills/<skill>.md
• 绝对路径必须按 path-marking 加 [IDAPC] / [SozoPC] / [S23] 标签
• 不要直接 Edit KNOWLEDGE_INDEX.md / FOR-PC-AGENTS.md 这种会被多 agent 改的元文件（容易引入重复拼接）—— 写新文件或在 PR 中由人 merge