前言¶
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
該目錄頁來自插件線索，未在已抓取資料中直接確認。
