赛博书屋

刷到一段好视频、听到一期播客、看到一篇长文，把链接发给你平时用的 ChatGPT / Codex、Claude 或 WorkBuddy。电脑读取它能合法获取的内容，整理成带 来源、摘要、逐字稿、截图和结构图的 Markdown 笔记，放进你自己的 Obsidian。

Codex 或 Claude 用户如果愿意授权，还可以同时生成一份飞书文档副本。

动图由真实公开页面和单独建立的 Obsidian 脱敏演示库录制。 观看 42 秒完整演示（VoiceBox 雷厉旁白）。

30 秒看懂

文章、视频、播客或本地文件
            ↓
Codex / Claude / WorkBuddy（电脑、手机、飞书、微信助理）
            ↓
   同步笔记 / 蒸馏笔记 / 详细拆解
            ↓
Obsidian 本地原件 → 可选的飞书文档副本

它不是新的笔记软件，也不是在线内容平台。它是一套符合 Agent Skills 开放规范、交给桌面 Agent 安装的 Skill，笔记原件仍然在你的电脑上。

最后会得到什么

笔记里会留下原始链接、采集时间、内容状态、摘要、逐字稿或翻译， 以及实际取得的页面截图。拿不到的部分会标明，不用标题和封面补出正文。

上图是真实 Obsidian 窗口，并非仿造界面。它来自一个专门建立的 demo-vault，不包含个人账号、本机路径或私人知识库内容。

能整理哪些内容

“能整理”不等于任何链接都能完整下载。公开页面和你自己提供的文件通常 可以直接处理；遇到登录、付费内容、没有字幕或平台限制时，它会明确说明 缺了什么，再让你选择授权的可见浏览器、官方导出或本地文件。

例如 YouTube 要求“确认你不是机器人”时，书屋会停止重复抓取，只询问 是否读取已登录页面上可见的字幕；不自动导出浏览器 Cookie。

处理图片或视频时，当前模型必须真的能读取图片。Codex 当前推荐 GPT-5.6 Sol、Terra 和 Luna，默认优先 Sol，但安装后仍要用一张真实 PNG/JPEG 验收。 流程不要求模型原生接收 MP4：本机先用 FFmpeg 抽取代表帧、Whisper 转写， 再由模型合并成笔记。

微信视频号只有在独立下载组件、Codex 桌面 Browser、用户批准的完整 CDP、 腾讯元宝本人扫码和一条授权真实链接全部验收后，才算可自动下载。缺任一项 就改为用户提供本地 MP4，不把“脚本存在”写成“已经可用”。

一条链接，三种笔记

收进书屋：链接 仍然可以使用，等同于“同步笔记”。

从 v0.2.4 起，三种模式各有唯一栏目顺序。写完必须运行包内校验器；栏目改名、 错序、重复、漏项或模型自创平级栏目都会被拒绝，因此更换模型不会改变笔记骨架。 从 v0.2.5 起，结构图也使用条件性门禁：命中架构、流程、决策、分层、因果或时间线 时必须完成几何检查和图片复核；没有真实结构时不添加装饰图。 从 v0.2.6 起，完整视频笔记还必须有本地原媒体、真实逐字稿、封面和 至少 3 张不同的关键画面。处理中不再播报工具流水，完成回执最多两个短段落。 从 v0.2.7 起，公开 X Article 可以匿名取得完整正文和原图，不需要 X 账号、 Cookie 或浏览器登录；只拿到预览、短链或身份不匹配时会明确失败，不冒充全文。

三种模式实际长什么样

下面用两篇公开内容做真实案例：《Open Design Team：让多个 Codex 在同一 设计画布中实时协作》和《Seeing like an Agent》。三张图均为 Obsidian 1.13.4 阅读视图实拍；公开来源链接保留，拍摄时关闭文件列表，个人账号、本机路径和 私人关联笔记均未进入画面。

同步笔记：总结、核心内容、带时间点的逐字稿和必要翻译。

蒸馏笔记：内容骨架、方法、反例与失效边界。

详细拆解：把前两种结果放在同一篇笔记里，同时保留证据路径。

原内容真的有 SOP、多条分支、方法框架或明显叙事节奏时，书屋会适当生成 本地 SVG 和 HTML 结构图；只有一两步或证据不足时，不会为了好看硬塞图。

在哪些系统上用

Codex 已有官方 Windows 应用；WorkBuddy 的官方页面提供 Windows 版和 Windows 10+ 安装指南。详细的 Windows 路径和验收见 第一次安装。

从哪里发链接

已经在用 ChatGPT，就走 Codex 这条路；已经在用 Claude，就走 Claude；已经 在用 WorkBuddy，就走 WorkBuddy。 不选择微信助理时，不用为了书屋把两边都装一遍；Codex 用户主动选择微信 助理后，Codex 会继续引导安装或打开 WorkBuddy，并让它写入同一个书屋。 手机远程入口依赖电脑保持在线。

Codex 和 Claude 默认把 Markdown 原件写入 Obsidian。完成飞书官方授权和真实读回测试后， 也可以同时生成飞书文档副本。飞书入口负责“从哪里发”，飞书文档负责 “整理后放到哪里”，是两件事。

Claude 使用同一份 Skill 和同一个 Obsidian 书屋。它不虚构一个未经核实的 Claude 手机入口：需要在手机上发链接时，接飞书，或让 WorkBuddy 微信助理 把微信消息送进同一个书屋。

飞书 Bot 怎么接

基础 Obsidian 路线验收后，赛博书屋会询问是否增加飞书入口，并把“没有 Bot”和 “已有 Bot”分开处理：

• 没有 Bot：安装 lark-channel-bridge，运行前台向导，扫码创建或选择一个 PersonalAgent 应用；先用 /status 验收连接，再发送真实的“同步笔记：链接”。
• 已有 Bot 已在线：不重复绑定同一个应用；把 Skill 安装到现有 Bot 背后的 Agent， 用 /status、“检查书屋”和真实链接完成验收。
• 已有应用但未连接：只有飞书开放平台中的 PersonalAgent 应用可以直接绑定。 向导只读取 App ID，App Secret 由用户在本机终端隐藏输入；普通 Webhook 群机器人 不能代替。
• 通过标准：Bot 有回复、同一 Obsidian 书屋出现可读笔记、来源和获取状态可回读； 前台通过后再改成后台常驻。

默认只有应用创建者可用。需要给同事或群开放时，再用 /invite user @某人 或 /invite group 做最小范围授权。完整步骤见第一次安装。

一分钟体验

安装完成后，在电脑、手机或已连接的入口里发送：

同步笔记：https://www.youtube.com/watch?v=DEMO_VIDEO_ID

把示意地址换成你自己的文章、视频或播客链接。处理结束后，你会收到 笔记路径、获取状态和未取得内容的说明；Obsidian 里会出现可搜索的结果。

第一次怎么装

1. 安装 Obsidian。
2. 安装你已经在用的桌面工具： Codex、 Claude Code 或 WorkBuddy。
3. 从 Releases 下载 cyber-bookhouse.zip。
4. 按第一次安装把同一份 Skill 交给 Codex、Claude 或 WorkBuddy。
5. 对它说：

请用 cyber-bookhouse Skill 帮我搭好赛博书屋。请识别当前是 Codex、Claude 还是 WorkBuddy，先完成软件、Obsidian 和当前路线要求的真实测试，之后再问我 要不要增加飞书入口、微信助理或飞书文档。每次只说一个操作，最后运行 包内能力检查，并用一张真实图片验证当前模型。告诉我哪些内容能直接处理， 哪些需要 Browser/CDP、腾讯元宝登录、独立组件或本地文件。

新建书屋时，macOS 的默认目录是 ~/Documents/cyber-bookhouse，Windows 是 %USERPROFILE%\Documents\cyber-bookhouse。对你仍然称为“赛博书屋”。

向导会先用 Obsidian 的“打开文件夹作为仓库”注册目录，再做当前路线要求的 真实写入测试。基础测试通过后，才会询问是否增加飞书、微信助理或飞书文档。

已经安装了，怎样更新

新版内置自更新器。以后直接对赛博书屋说“检查最新版”或“更新赛博书屋”，它会读取 GitHub Latest Release、比较版本和 build，并告诉你是否有更新。你确认后，它会自动 下载、校验、备份旧版并原位升级，不需要再次手动下载 ZIP：

python3 <skill-dir>/scripts/update_skill.py --check
python3 <skill-dir>/scripts/update_skill.py --apply --target auto

它不会在后台静默覆盖：真正安装前仍会询问一次。更新器只接受本项目 GitHub Release， 校验 GitHub 提供的 SHA-256，并检查压缩包路径、Skill ID、版本与 build；安装器会先把 旧版移动到 ~/.cyber-bookhouse-backups/。完成后重启或新开一个 Agent 任务。

已安装旧版的 Codex / Claude 用户可以直接运行自更新器升级到 v0.2.7； 更早版本需要手动覆盖一次。WorkBuddy 暂无稳定接口让 Skill 安全覆盖自身， 仍需在“技能”界面重新上传最新版 ZIP。

下载包里有什么

cyber-bookhouse.zip 包含：

• Codex、Claude Code 和 WorkBuddy 共用的一份开放标准 Skill；
• 可恢复备份并回读验证的 Codex / Claude 用户级安装器；
• 可检查 GitHub 最新版、校验附件并原位升级的自更新器；
• 安装状态、输入通道和真实测试记录；
• macOS 与 Windows 路径、应用和依赖检查；
• 普通公开网页、X 公开帖子与 X Article、YouTube 公开字幕和本地音视频处理；
• GPT-5.6 Sol / Terra / Luna 的选择建议、真实图片验收和视频证据边界；
• 微信视频号的腾讯元宝接入检查、Browser/CDP 风险说明和本地 MP4 降级路线；
• 同步笔记、蒸馏笔记、详细拆解和结构图生成规则；
• 固定栏目模板与可执行格式校验器，阻止不同模型自由改版；
• Obsidian、飞书文档及各入口的写入和读回验收。

它不依赖维护者电脑上的私人 Skill。yt-dlp、FFmpeg、Whisper、Obsidian 和 飞书工具仍从各自官方来源安装，仓库不重新打包第三方程序。 公共 ZIP 也不重新打包来源和再分发许可不明确的视频号下载组件。

怎样才算真的装好了

• 电脑端发一个测试链接，Obsidian 里出现可读笔记。
• 选择了手机入口时，它能继续同一个工作，并收到处理结果。
• 如果另外接了飞书或微信助理，它们写入的是同一个书屋。
• 如果选了飞书文档，测试文档能创建、能读回、能由用户打开。
• 包内能力检查已运行，缺少的外部工具和受限平台被如实报告。
• 当前模型用一张真实图片通过识别；视频号没有真实授权链接时只能写“待实测”。

电脑关机、深度睡眠或断网时，本机 Agent 无法继续处理新内容。

它怎样工作

1. 检查当前系统、桌面 Agent、Obsidian 和所需依赖。
2. 按内容类型选择最少侵入的获取方式：公开页面、授权后的可见内容或用户文件。
3. 根据用户命令生成对应模式，只用真实取得的正文、逐字稿和画面做分析。
4. 写入 Obsidian 中的 Markdown 原件和本地素材，再打开验收。
5. 用户选择飞书文档时，在本地原件成功后再生成副本并读回。

有几件事先说清楚

• Windows 目前是 Beta，需要真实 Windows 用户继续回报不同机器的安装结果。
• 不绕过登录、验证码、付费墙、DRM、访问频率限制或平台权限。
• 不要求你把密码、Token、Cookie、私人文档或 Obsidian 库交给项目维护者。
• 只能拿到标题和链接时，就只保存标题和链接，不假装已经看过正文或视频。

隐私细节见 PRIVACY.md，安全问题见 SECURITY.md。

v0.2.7 是当前公开版本，统一使用 cyber-bookhouse 作为 Skill ID；macOS 稳定， Windows 10 / 11 仍为 Beta。不同内容 平台仍需要继续拿真实样本逐个测试。