前言¶
DeepSeek Harness（DSH）以插件方式扩展能力。智能体工作流中，链接和本地音视频常被处理成一次性摘要，但后续还需要清洗短链、提取字幕或转写、保存证据，并导入笔记库。下面介绍 learn-skill。
这是什么¶
learn-skill 是 gtbwpkwjnb-alt/learn-skill 仓库提供的 DSH 技能包插件。它是一条 Agent 原生学习管道：输入分享文案或本地音视频，经过短链/推广参数清洗、字幕优先与可恢复转写、关键帧 OCR、全文 Map-Reduce-Verify，输出层级化知识卡片，并可导入 Obsidian、思源或保存为本地 Markdown。许可证为 MIT。
核心功能¶
输入与提取¶
- 网络自适应：自动检测 GFW，筛选可用平台。
- 8 平台支持：抖音 · TikTok · B站 · YouTube · 播客 · 微信 · 小红书 · 本地文件。
- 抖音主页批量学习：自动枚举
/aweme/post分页、按作品 ID 去重并报告页面计数差异。 - 中文界面 OCR：PP-OCRv6（隔离环境）→ 旧 PaddleOCR → Tesseract。
分析与输出¶
- 当前 Agent 证据分析：全文分段 Map → Reduce 汇总 → 本地证据 Verify；技能激活后使用当前 agent 的会话模型，不依赖外部模型 API。
- 层级化输出：章节分解 + Mermaid 思维导图 + 3段式总结；知识卡片可包含章节、思维导图、亮点、术语、闪卡。
任务与导入¶
- 可恢复任务：SQLite 任务账本 + 工件清单 + 断点续传；成功导入后默认清理本地工件。
- 双知识库导入：Obsidian（默认）+ 思源回退 + 本地 Markdown。
- 安全边界：主脚本只做本地提取与证据保存，不读取或调用外部模型 API。
安装与启用¶
先在 DSH 中安装插件：
dsh plugin --profile web add github:gtbwpkwjnb-alt/learn-skill
安装后重启 web：
dsh web
安装完成后，技能出现在 Settings → Plugins，按需懒加载。插件外壳由仓库根目录的 SKILL.md 提供技能，cordis.patch.yml + index.js 为插件外壳；无 npm 依赖，可从 GitHub 直装。技能格式为 kebab-case 名称 + name/description frontmatter，与 dsh 技能契约一致。
系统依赖：
- ffmpeg
- Python 3.10+
如需启用对应导入或提取能力，可配置以下变量：
| 变量 | 用途 |
|---|---|
SIYUAN_TOKEN |
导入思源时必需 |
BILI_COOKIE |
获取高质量字幕 |
OBSIDIAN_VAULT |
Obsidian 库路径 |
典型用法¶
作为 AI 技能¶
可以把链接交给技能，例如：
知析 https://www.bilibili.com/video/BV1GJ411x7h7
zhixi https://v.douyin.com/xxxxx/
学习一下这个视频 https://b23.tv/xxx
命令行¶
单条处理：
python zhixi-learn.py "https://www.bilibili.com/video/BV1GJ411x7h7"
批量处理：
python zhixi-learn.py "url1" "url2" "url3"
抖音博主主页：
python zhixi-learn.py "https://www.douyin.com/user/..."
仅提取内容：
python zhixi-learn.py "url" --extract-only
预览：
python zhixi-learn.py "url1" "url2" --dry-run
不访问网络解析短链：
python zhixi-learn.py "https://b23.tv/xxxxx?spm_id_from=333" --dry-run --no-resolve-links
文件与保留策略¶
- 处理中工件位于
learn-output/_tasks/<task_id>/。 - 导入 Obsidian 后笔记为
<Vault>/learn/<主题>-<YYYY-MM-DD>.md。 - 成功导入后默认清理本地工件，需要保留时加
--keep-local。
适用场景与注意¶
适合以下场景：
- 经常从抖音、TikTok、B站、YouTube、播客、微信、小红书或本地文件提取内容。
- 希望把处理结果导入 Obsidian 或思源。
- 需要批量处理抖音主页链接。
- 希望在 DSH 技能流程中使用当前 agent 的会话模型做证据分析。
使用前注意：
- 插件以当前 dsh 进程权限运行，安装前应检查仓库源码与许可证。
- 许可证为 MIT。
- 主脚本只做本地提取与证据保存，不读取或调用外部模型 API；当前 Agent 证据分析使用当前 agent 的会话模型。
- 测试兼容版本为 dsh v0.1.1-rc.2（2026-08-22）；预览期版本迭代快，若 API 变更以官方文档为准。
- 网络自适应会自动检测 GFW，筛选可用平台。
链接¶
仓库：
https://github.com/gtbwpkwjnb-alt/learn-skill
插件线索给出目录页：
https://www.skillhub.cn/plugins/gtbwpkwjnb-alt/learn-skill
该目录页来自插件线索，未在已抓取资料中直接确认。
