Back to search
douyin-to-obsidian
SkillGitHub
抖音视频与图文知识入库:本地语音转写与文字识别,按主题生成 Obsidian 笔记,维护索引与日志;由 Agent 驱动,CC Connect 为可选接入。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked yesterday
Badge for your README
Markdown
[](/listings/llm-xiaoye--douyin-to-obsidian)HTML
<a href="/listings/llm-xiaoye--douyin-to-obsidian"><img src="/api/listings/llm-xiaoye--douyin-to-obsidian/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 177 lines
- # 抖音多模态入库(/dy)
- 将本次指定的抖音视频与图文整理为按主题组织的 Obsidian 知识笔记,结合本地语音转写、文字识别与原图核对,支持作品 ID 去重,同步维护知识索引和导入日志。
- 当前 Agent 负责内容理解、核心知识提炼与笔记写作;本项目脚本负责内容获取、去重、校验和事务保存。核心流程不依赖 CC Connect 或微信 Bot,现有安装器提供 Claude Code 的命令与自动路由集成,可配合 CC Connect 使用。
- ## 核心功能
- - 处理单个作品、分享文本和多个链接;也可导入用户明确指定的收藏夹中的新作品。
- - 视频通过本地 MLX Whisper 转写;图文通过 Apple Vision 识别文字,再由具备视觉能力的 Agent 逐页核对原图。
- - 提炼核心知识,生成包含解释、证据、模型补充和自测的主题笔记。
- - 按作品 ID 去重,识别已改名或移动的笔记,保留已有笔记与个人补充。
- - 同一作品的笔记、图片附件、知识索引和导入日志通过事务提交;后续作品失败不回滚已完成作品。
- - 原始标题、文案、转写或 OCR 含“面试”时,同步生成或合并面试题;合并前检查相似内容与目标版本。
- - 跟踪批次进度、清单缺口、有限恢复次数和可复制的重试链接。
- - 使用简洁标题,通常为 12–36 字、最多 60 字;每篇配置五个不重复标签。
- 本技能只处理当前请求明确提交的作品或收藏夹。单条作品不会触发作者全量导入;作者范围任务使用独立的 /dy-author。已有作品默认跳过,不因更新技能自动补建面试题。
- ## 宿主与运行依赖
- | 项目 | 要求 |
- | --- | --- |
- | 系统 | macOS Apple Silicon(M 系列);Intel Mac、Windows、Linux 的完整流程不承诺支持 |
- | Python | 3.12,使用真实的绝对解释器路径 |
- | Node.js | 本机可用,用于 F2 的 JavaScript 签名 |
- | Chrome | 已安装且使用自己的用户资料;私人收藏夹需要对应抖音登录态 |
- | OCR 工具链 | Xcode Command Line Tools,包含 Swift 与 xcrun |
- | Agent | 能读取 Skill、读写本地文件、执行脚本并查看图片 |
- | Obsidian | 已存在且可写的 Vault;无需额外 Obsidian 插件 |
- | CC Connect | 可选聊天接入方式,不是核心队列的必需依赖 |
- ### 宿主接入范围
- 当前 Agent 读取材料并写作,脚本不创建 CC Connect 定时任务,也不另起模型会话。仅运行 Python 不会自动生成知识正文。
- 现有安装器面向 Claude Code 的 .claude 目录、斜杠命令与自动路由钩子。下方给出这一集成路线;使用 CC Connect 时,按其[官方说明](https://github.com/chenhg5/cc-connect)配置模型与消息平台。
- Codex 等其他宿主可按各自技能发现机制接入核心流程,但仍需配置运行依赖、脚本路径、工作目录和工具权限。当前安装器没有通用宿主安装模式,不承诺下载后在任意 Agent 中即用。自动触发取决于宿主如何加载 Skill 或路由钩子。
- ## 下载和安装
- ### 下载仓库
- 在 GitHub 选择“Code → Download ZIP”下载源码,或执行:
- ~~~sh
- git clone https://github.com/llm-xiaoye/douyin-to-obsidian.git
- cd douyin-to-obsidian
- ~~~
- [发布版本](https://github.com/llm-xiaoye/douyin-to-obsidian/releases)提供固定快照。main 分支的新提交不会自动更新旧版压缩包。
- ### 安装现有命令集成
- 确认目标工作区、Obsidian Vault,以及用于访问抖音的 Chrome 用户资料目录。在对应 Chrome 中打开 chrome://version,复制“个人资料路径(Profile Path)”,包含 Default 或 Profile 1,不要只填父目录。
- 将以下路径换为自己的绝对路径,保留引号。使用 CC Connect 时,工作区必须对应项目实际工作目录:
- ~~~sh
- 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"
- ~~~
- 可在同一安装命令中追加:
- ~~~text
- --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。
- 安装器创建:
- ~~~text
- workspace/.claude/
- ├── skills/douyin-to-obsidian/ 技能、独立虚拟环境与本地配置
- ├── commands/dy.md 按本机路径生成的命令
- └── settings.json 合并自动路由钩子
- ~~~
- 已有设置会保留,并在首次修改前备份;相同安装不重复添加钩子。遇到未受管理的同名安装、符号链接或手动修改的命令时停止,先备份并检查冲突。
- 新 Vault 仅在两份总览均不存在时初始化知识总索引.md 和导入总日志.md;有效的已有总览保持不变。缺少其中一份、遇到符号链接或格式不兼容时停止,不覆盖索引,也不扫描或迁移旧笔记。
- 依赖安装中断时保留现场与错误。检查并将不完整安装移至备份位置后再安装,不把中断状态当成安装完成。
- ### 检查安装
- 运行安装器输出的 doctor_command:
- ~~~sh
- "$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 或访问本机凭据的权限;工具状态是否显示由宿主决定。
- ## 使用方式
- | 输入 | 行为 |
- | --- | --- |
- | `/dy <作品链接>` | 导入指定视频或图文 |
- | `/dy <链接一> <链接二>` | 只处理本次链接,并按作品 ID 去重 |
- | 含“复制打开抖音”与完整链接的分享文本 | 宿主正确加载路由后进入同一流程 |
- | `/dy <收藏夹名称>` | 精确匹配收藏夹并导入新作品 |
- | `/dy <收藏夹一>,<收藏夹二>` | 处理多个收藏夹并跨收藏夹去重 |
- | `/dy 收藏夹ID:<数字ID>` | 名称不明确时按 ID 选择 |
- | `/dy --list` | 只列出收藏夹名称、ID 和数量 |
- 链接请求与收藏夹请求分开发送。失败报告包含具体阶段、完整作品链接和可复制的重试命令,由用户决定是否重试。空音频、缺页图片或仅有标题,不算成功取得知识材料。
- 面试题保存于 `知识库/面试题库/<主题>/<子方向>/`。被标记为需要题库的作品,必须完成题目草稿才可提交;合并保留个人补充并记录来源 ID。格式见[题库写作说明](skills/douyin-to-obsidian/references/interview-notes.md)与[知识笔记说明](skills/douyin-to-obsidian/references/knowledge-notes.md)。
- ## 配置与输出
- 安装后的 config.json 保存本机路径,config.example.json 为模板。不要发布个人配置。
- | 配置项 | 用途或默认值 |
- | --- | --- |
- | vault | 由 --vault 指定的 Obsidian Vault |
- | python | 安装环境中的 .venv/bin/python |
- | cache_dir | 批次、媒体、转写、OCR 和恢复记录 |
- | browser、browser_profile | Chrome 及完整用户资料目录 |
- | browser_cache_dir | 对应资料目录的 Cache_Data |
- | notes_dir | 知识库,当前主题与总览格式要求的根目录 |
- | attachments_dir | 附件,按笔记分组保存图片 |
- | review_state_file | .dy-review-state.json |
- | unified_only | true,使用统一知识索引和导入日志 |
- | asr_model | mlx-community/whisper-small-mlx |
- | prepare_workers | 默认 2,支持 1–3;模型写作与提交仍逐条推进 |
- | auto_browser_recovery | true,详情获取失败后进行有限浏览器恢复 |
- | background_detail_first | true,优先后台获取 |
- | prefer_browser_media | false |
- | close_opened_tabs | true,仅尝试关闭本批次打开的匹配标签页 |
- | browser_recovery_wait_seconds | 默认 8,范围 0–20 |
- | browser_media_timeout_seconds | 默认 40,范围 0–40 |
- 配置变更作用于新批次,已有批次保留创建时的快照。修改后运行自检,不随意改名格式约定中的总览文件和根目录。
- 笔记位于 Vault 的知识库主题目录,图片位于附件目录,根目录维护知识总索引.md 与导入总日志.md。音轨、识别材料和运行状态默认保留在缓存目录。
- ## 常见问题
- - **命令没有响应:** 检查技能是否加载、工作区是否正确,开启新会话并运行自检。
- - **分享文本没有自动触发:** 在现有 .claude 集成中检查 UserPromptSubmit 钩子,也可显式使用 /dy。
- - **私人收藏夹获取失败:** 检查配置的 Chrome 登录态;公开视频可访问不代表私人收藏夹可访问。
- - **Fresh cookies 或 DETAIL_UNAVAILABLE:** 先看实际恢复阶段,不能仅凭错误名称判断登录过期。
- - **缺少题目草稿:** 按 interview_required 完成 interview.json,再提交作品。
- - **题目合并冲突:** 重读当前题目,基于当前 SHA-256 生成完整合并正文,不覆盖个人修改。
- ## 限制与隐私
- 只处理用户有权访问的内容,不绕过登录、验证码或权限限制。平台接口、网络与账号权限变化都可能影响获取。
- Cookie 仅在本机请求进程中使用,不导出。语音转写与 OCR 在本地运行;Agent 会读取正文和图片,是否发送至云端取决于模型配置。本地 ASR/OCR 不等于整套流程完全离线。原图、来源链接和已核实的作者信息保存到 Vault。
- 项目不增加遥测或独立模型服务。依赖和模型权重从配置的软件包、GitHub 与模型仓库下载。分享诊断前应移除个人路径、来源记录和私人材料。
- ## 开发与验证
- 自检通过不等于真实作品导入成功。验证范围见[验证说明](docs/validation.md),提取失败的处理见[恢复说明](skills/douyin-to-obsidian/references/recovery.md)。
- ## 许可证
- 采用 [MIT 许可证](LICENSE)。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.