前言¶

用智能體輔助學習時，常見做法是臨時讓模型出題或總結，對話結束進度就散在聊天記錄裏，難以追蹤掌握度和複習節奏。DeepSeek Harness（DSH）支持以插件擴展 Host 能力；伴學（Study Companion） 把一次對話組織成可持續的學習迴路：規劃 → 練習 → 測試 → 反饋 → 複習，並在側欄面板裏查看進度、作答和漏洞回顧。

下面介紹插件定位、能力與在 DSH 中的安裝、首次使用方式；可選的 Safari 課程同步與數據存放位置一併說明。

這是什麼¶

伴學是社區維護的 DSH 工作流類插件，倉庫爲 zgdllt/study-companion，包名 @local/study-companion，當前發佈版本 1.0.0，採用 MIT 許可證。維護者 zgdllt。項目在 DSH 0.2.1-rc.5 下開發與驗證；其他 DSH 版本以宿主插件 API 兼容性爲準。

插件在對話中讓 agent 制訂學習階梯、出題與評分；在側欄查看進度、考場作答和回顧；還可跟隨網頁課程記錄筆記，把練習難點追溯到課件頁與原課時間。

核心功能¶

README 以表格歸納能力，安裝後可對照側欄「概覽 / 階梯 / 考場 / 課堂 / 方法」使用。

Host 側提供檔案讀寫等工具（如 study_read、study_write、ask_exam、bind_session、lesson_open 等）；面板負責展示與提交，考試評分由對話中的 agent 完成，面板不自行評分。

安裝與啓用¶

準備 DSH¶

伴學依賴 DSH 的 Host 與 Web 界面。桌面版直接打開應用；命令行可按官方說明啓動 Web：

npx @deepseek-ai/dsh web

默認界面爲 http://127.0.0.1:3080。先在「設置 → 模型」配置可用模型，再選擇或添加工作區。模型細節見 DSH 使用指南。

安裝插件（推薦 Git 地址）¶

1. 在 DSH 側欄打開「插件」，點擊「添加插件」。
2. 在安裝輸入框粘貼完整地址，固定安裝 v1.0.0：

git+https://github.com/zgdllt/study-companion.git#v1.0.0

3. 點擊「安裝」，完成後點擊「立即啓用」；若提示重啓則重啓 DSH。
4. 刷新界面。側欄應出現「伴學」，插件列表包名爲 @local/study-companion。

安裝機器需能訪問 GitHub；無需單獨構建，也無需把源碼複製進 DSH 安裝目錄。

Release 包：從 Releases 下載 local-study-companion-1.0.0.tgz，在「添加插件」中填寫該文件在 運行 DSH 的機器上 的絕對路徑後安裝啓用。

也可在對話中讓 agent 調用 plugin_manager，參數示例（在 DSH 內使用，不要在終端執行）：

{
  "action": "install_bundle",
  "target": "git+https://github.com/zgdllt/study-companion.git#v1.0.0"
}

若 agent 預設沒有 plugin_manager，請用插件頁面安裝。

檢查安裝¶

• 「插件」頁中伴學已啓用，Host 行無加載錯誤。
• 側欄能打開伴學，看到「概覽 / 階梯 / 考場 / 課堂 / 方法」。
• 在「概覽」新建學科後，回對話讓 agent 讀取學習檔案，應能調用 study_read。

典型用法¶

1. 在「概覽」新建學科，填寫主題、目標、截止時間和可用小時數。
2. 回到 DSH 對話，發送（可按需微調錶述）：

請用伴學工具讀取我剛創建的學科，先通過 study_write 的 bind_session 操作將它綁定到當前對話，再建立學習階梯和學習計劃並寫入檔案。先帶我完成第一個單元，不要一次講完整套課程。

3. 學完一個單元后說「開始考試」。agent 用 ask_exam 一次出一道題。
4. 打開「考場」作答，點擊「提交併繼續考試」；答案保存後可由綁定對話繼續，或自行回到該對話說「繼續考試」。
5. agent 讀取答案、評分並指出漏洞，再講解或出下一題。
6. 學完後讓 agent 保存一頁速查表並安排複測。

每個學科可綁定一個主伴學對話；換對話繼續時，先讓 agent 用 bind_session 重新綁定。「方法」頁提供六張方法卡與可複製提示詞。

跟隨網頁課程（Safari，可選）¶

普通學習流程不依賴 Safari。在 macOS 上要同步課程播放狀態需：用 Safari 打開回放；在 Safari 設置中啓用開發者相關選項並允許從 Apple 事件執行 JavaScript；授權 DSH 相關應用控制 Safari；在對話中用 lesson_open 建立課次，在「課堂」檢查適配器並同步狀態。

README 寫明此前僅在雨課堂回放上實測媒體狀態、播放控制、課件錨點與時間對齊；B 站、學堂在線等未驗證。無播放器接口時媒體位置保持 null，頁面授課時刻不會冒充爲視頻時間。

數據、隱私與適用注意¶

學習檔案保存在運行 DSH 的機器上，DSH_HOME 未設置時爲 ~/.dsh：

$DSH_HOME/storages/study-companion/
├── active.json
├── subjects/<id>.json
├── courses/<id>.json
├── lessons/<id>.json
└── prefs.json

可通過 bundle 的 cordis.patch.yml 爲 Host 設置 config.dataDir 更換目錄。卸載插件不會刪除檔案；插件本身無額外雲端服務或遙測，模型調用仍按 DSH 中配置的權限處理。

適合誰：已在用 DSH、希望用 agent + 面板固化學習計劃、單題考試與間隔複習的開發者或自學者。

邊界：評分是模型對本次回答的判斷，不等於真實能力驗收；自動前測、全瀏覽器端到端驗收等待實現項以 docs/CONTRACT.md 爲準。安裝前建議瀏覽倉庫源碼與 MIT 許可證；插件以當前 dsh 進程權限運行。

鏈接¶

• 社區目錄頁：https://www.skillhub.cn/plugins/zgdllt/study-companion
• GitHub：https://github.com/zgdllt/study-companion
• 項目主頁：https://zgdllt.github.io/study-companion/