抖音多模态入库（/dy）

将本次指定的抖音视频与图文整理为按主题组织的 Obsidian 知识笔记，结合本地语音转写、文字识别与原图核对，支持作品 ID 去重，同步维护知识索引和导入日志。

当前 Agent 负责内容理解、核心知识提炼与笔记写作；本项目脚本负责内容获取、去重、校验和事务保存。核心流程不依赖 CC Connect 或微信 Bot，现有安装器提供 Claude Code 的命令与自动路由集成，可配合 CC Connect 使用。

核心功能

• 处理单个作品、分享文本和多个链接；也可导入用户明确指定的收藏夹中的新作品。
• 视频通过本地 MLX Whisper 转写；图文通过 Apple Vision 识别文字，再由具备视觉能力的 Agent 逐页核对原图。
• 提炼核心知识，生成包含解释、证据、模型补充和自测的主题笔记。
• 按作品 ID 去重，识别已改名或移动的笔记，保留已有笔记与个人补充。
• 同一作品的笔记、图片附件、知识索引和导入日志通过事务提交；后续作品失败不回滚已完成作品。
• 原始标题、文案、转写或 OCR 含“面试”时，同步生成或合并面试题；合并前检查相似内容与目标版本。
• 跟踪批次进度、清单缺口、有限恢复次数和可复制的重试链接。
• 使用简洁标题，通常为 12–36 字、最多 60 字；每篇配置五个不重复标签。

本技能只处理当前请求明确提交的作品或收藏夹。单条作品不会触发作者全量导入；作者范围任务使用独立的 /dy-author。已有作品默认跳过，不因更新技能自动补建面试题。

宿主与运行依赖

宿主接入范围

当前 Agent 读取材料并写作，脚本不创建 CC Connect 定时任务，也不另起模型会话。仅运行 Python 不会自动生成知识正文。

现有安装器面向 Claude Code 的 .claude 目录、斜杠命令与自动路由钩子。下方给出这一集成路线；使用 CC Connect 时，按其官方说明配置模型与消息平台。

Codex 等其他宿主可按各自技能发现机制接入核心流程，但仍需配置运行依赖、脚本路径、工作目录和工具权限。当前安装器没有通用宿主安装模式，不承诺下载后在任意 Agent 中即用。自动触发取决于宿主如何加载 Skill 或路由钩子。

下载和安装

下载仓库

在 GitHub 选择“Code → Download ZIP”下载源码，或执行：

git clone https://github.com/llm-xiaoye/douyin-to-obsidian.git
cd douyin-to-obsidian

发布版本提供固定快照。main 分支的新提交不会自动更新旧版压缩包。

安装现有命令集成

确认目标工作区、Obsidian Vault，以及用于访问抖音的 Chrome 用户资料目录。在对应 Chrome 中打开 chrome://version，复制“个人资料路径（Profile Path）”，包含 Default 或 Profile 1，不要只填父目录。

将以下路径换为自己的绝对路径，保留引号。使用 CC Connect 时，工作区必须对应项目实际工作目录：

DY_PYTHON="/absolute/path/to/python3.12"
DY_WORKSPACE="/absolute/path/to/agent-workspace"
DY_VAULT="/absolute/path/to/YourVault"
DY_PROFILE="$HOME/Library/Application Support/Google/Chrome/Default"

"$DY_PYTHON" -B scripts/install.py \
  --workspace "$DY_WORKSPACE" \
  --vault "$DY_VAULT" \
  --browser-profile "$DY_PROFILE"

可在同一安装命令中追加：

--browser-cache-dir "/absolute/path/to/Chrome/Cache_Data"
--cache-dir "/absolute/path/to/dy-runtime-cache"

自定义 Chrome 用户数据目录必须匹配对应 Cache_Data。安装器不创建 Chrome 用户资料、不复制 Cookie，也不要求导出凭据。默认运行缓存为 ~/Library/Caches/douyin-to-obsidian。依赖安装与首次转写模型下载需要网络和磁盘空间。缺少 macOS 工具链时，可运行 xcode-select --install。

安装器创建：

workspace/.claude/
├── skills/douyin-to-obsidian/    技能、独立虚拟环境与本地配置
├── commands/dy.md               按本机路径生成的命令
└── settings.json                合并自动路由钩子

已有设置会保留，并在首次修改前备份；相同安装不重复添加钩子。遇到未受管理的同名安装、符号链接或手动修改的命令时停止，先备份并检查冲突。

新 Vault 仅在两份总览均不存在时初始化知识总索引.md 和导入总日志.md；有效的已有总览保持不变。缺少其中一份、遇到符号链接或格式不兼容时停止，不覆盖索引，也不扫描或迁移旧笔记。

依赖安装中断时保留现场与错误。检查并将不完整安装移至备份位置后再安装，不把中断状态当成安装完成。

检查安装

运行安装器输出的 doctor_command：

"$DY_WORKSPACE/.claude/skills/douyin-to-obsidian/.venv/bin/python" -B \
  "$DY_WORKSPACE/.claude/skills/douyin-to-obsidian/scripts/doctor.py"

ok: true 仅说明本地依赖、路径和集成检查通过。自检不读取 Cookie、不下载作品、不写笔记，也不证明抖音登录态和网络可用。

开启新的 Agent 会话加载技能；使用 CC Connect 时开启对应工作区的新会话。允许必要的读写和执行工具，仅规划模式无法完成导入。macOS 可能请求控制 Chrome 或访问本机凭据的权限；工具状态是否显示由宿主决定。

使用方式

链接请求与收藏夹请求分开发送。失败报告包含具体阶段、完整作品链接和可复制的重试命令，由用户决定是否重试。空音频、缺页图片或仅有标题，不算成功取得知识材料。

面试题保存于 知识库/面试题库/<主题>/<子方向>/。被标记为需要题库的作品，必须完成题目草稿才可提交；合并保留个人补充并记录来源 ID。格式见题库写作说明与知识笔记说明。

配置与输出

安装后的 config.json 保存本机路径，config.example.json 为模板。不要发布个人配置。

配置变更作用于新批次，已有批次保留创建时的快照。修改后运行自检，不随意改名格式约定中的总览文件和根目录。

笔记位于 Vault 的知识库主题目录，图片位于附件目录，根目录维护知识总索引.md 与导入总日志.md。音轨、识别材料和运行状态默认保留在缓存目录。

常见问题

• 命令没有响应： 检查技能是否加载、工作区是否正确，开启新会话并运行自检。
• 分享文本没有自动触发： 在现有 .claude 集成中检查 UserPromptSubmit 钩子，也可显式使用 /dy。
• 私人收藏夹获取失败： 检查配置的 Chrome 登录态；公开视频可访问不代表私人收藏夹可访问。
• Fresh cookies 或 DETAIL_UNAVAILABLE： 先看实际恢复阶段，不能仅凭错误名称判断登录过期。
• 缺少题目草稿： 按 interview_required 完成 interview.json，再提交作品。
• 题目合并冲突： 重读当前题目，基于当前 SHA-256 生成完整合并正文，不覆盖个人修改。

限制与隐私

只处理用户有权访问的内容，不绕过登录、验证码或权限限制。平台接口、网络与账号权限变化都可能影响获取。

Cookie 仅在本机请求进程中使用，不导出。语音转写与 OCR 在本地运行；Agent 会读取正文和图片，是否发送至云端取决于模型配置。本地 ASR/OCR 不等于整套流程完全离线。原图、来源链接和已核实的作者信息保存到 Vault。

项目不增加遥测或独立模型服务。依赖和模型权重从配置的软件包、GitHub 与模型仓库下载。分享诊断前应移除个人路径、来源记录和私人材料。

开发与验证

自检通过不等于真实作品导入成功。验证范围见验证说明，提取失败的处理见恢复说明。

许可证

采用 MIT 许可证。