前言¶
在 DeepSeek Harness（DSH）裏做「教一門課」或「生成成套學習筆記」，常見做法是臨時寫 prompt，讓 agent 輸出零散 Markdown。產物往往缺少統一結構、節與節之間的動手主線、以及可離線瀏覽和判分的配套界面。維護者 GamecialX 的插件 dsh-study-notes（GitHub：GamecialX/dsh-study-notes，社區目錄：skillhub 插件頁）向當前 profile 註冊 study-notes 技能：按內置《學習筆記生成準則》交付標準 Markdown 筆記庫、讀者自建的 project/ 動手線、以及單文件本地網頁門戶（含練習與章末測試判分）。插件分類爲工作流；index.js 僅使用 node: 內置模塊，零依賴、零構建，可離線安裝。
這是什麼¶
dsh-study-notes 是一個 DSH bundle：加載後在會話技能目錄中出現 study-notes。當用戶想從零學一門科目、需要學習筆記 / 教學文檔 / 講義式材料時，技能指導 agent 生成能從頭跟到尾的課（而非概念百科）：每節在讀者自己的 project/（非代碼科目則爲推導本、句子本、時間線等）裏產出可檢查的結果，下一節承接上一節；概念在第一次用到它的步驟裏出現。新課程會先寫一節樣章，用戶確認風格後再批量生成。當前 package 版本爲 2.1.2，許可證 MIT，要求 Node.js >= 20。
核心功能¶
技能交付的產物¶
生成內容位於用戶指定的筆記根目錄，主要包括：
| 產物 | 說明 |
|---|---|
00 大綱.md |
科目簡介、跟課方式、逐章逐節「本節產物 / 動手入口」、概念檢索表 |
Cha_X 章名/ |
節筆記（接上一節 → 若干「第 N 步」→ 小結 → 練習）、CX 速查.md、CX 測試.md、src/ 圖源；章末通跑與項目地圖 |
project/ |
讀者動手目錄，從空開始；agent 不在此寫入 |
code/（代碼類科目） |
答案快照 code/answer/chNN/、運行輸出 code/out/、演示 notebook 等 |
checklist.md |
規劃、進度指針、樣章風格約定、變更與恢復上下文 |
web/ |
單文件門戶 index.html、數據 notes_data.js、離線 KaTeX、serve.mjs |
| 啓動腳本 | 啓動學習服務器.bat、start_server.sh 一鍵起服務並打開門戶 |
門戶能力（據 README）：進度與均分儀表盤、側欄目錄樹、五種標註塊渲染（答案默認摺疊）、錨點與 Markdown 鏈接、速查頁、離線公式（KaTeX 0.16.22，本地缺失時可回退 CDN）、節內練習即時判分、章末測試與成績單、知識圖譜、全文搜索、localStorage 持久化。
規範與校驗¶
技能資產在 assets/study-notes/：SKILL.md 爲入口；references/ 含筆記格式、教學設計、流程恢復、質量門禁、門戶契約、Typora 兼容、分科目 playbook 等；templates/ 提供大綱、節筆記、速查、測試等骨架及門戶模板。
用戶或維護者可用插件內腳本校驗生成庫，例如：
node assets/study-notes/scripts/check-library.mjs "<筆記根目錄>"
node assets/study-notes/scripts/check-library.mjs "<筆記根目錄>" --strict
node assets/study-notes/scripts/run-course.mjs "<筆記根目錄>"
check-library.mjs 檢查結構、鏈接、可移植性、教學篇幅與練習數量、代碼綁定、課程線規則 R1–R12 等；--strict 將課程線 warning 升爲 error，適合新庫驗收。
安裝與啓用¶
插件包即倉庫根目錄（含 package.json 的一層）。DSH 從本地絕對路徑安裝，需先把倉庫放到本機（官方 README 示例）：
git clone https://github.com/GamecialX/dsh-study-notes.git
記克隆後的絕對路徑爲 <插件目錄>，任選一種方式安裝。
方式 A：Web 界面（推薦）
- 打開 DSH Web 界面，左側 Plugins → Add plugin。
- 填寫
<插件目錄>的絕對路徑（須指向含package.json的目錄）。 - 點 Install；bundle 與 id 爲
study-notes的項默認啓用。
方式 B：會話內 plugin_manager
在啓用 plugin_manager 的 Creator 模式會話中，要求 agent 使用 install_bundle 將 <插件目錄> 裝到當前 profile（非完全權限下需批准）。
方式 C：CLI
dsh plugin --profile <profile 名> add "<插件目錄>"
安裝後確認：Plugins 頁出現 Study notes (學習筆記) 卡片；新會話技能列表含 study-notes。若通過符號鏈接指向本地目錄安裝，不要移動或刪除該目錄，否則 skill 或資源路徑會失效。
典型用法¶
- 在新會話中說：「我想從零學 \<某科目>，給我生成學習筆記。」
- agent 應加載
study-notes，先確認科目與目的；按流程 P0–P5 規劃，P2.5 樣章確認後再批量寫章。 - 筆記就緒後，在筆記根目錄執行啓動腳本或
web/serve.mjs/ Python 靜態服務，瀏覽器打開本地門戶閱讀、做題與章末測試。 - 交付前對筆記根目錄運行
check-library.mjs --strict（及代碼類科目的run-course.mjs）做驗收。
插件開發自測可在插件目錄執行：
npm test
適用場景與注意¶
適合：希望在 DSH 裏把「學一門新課」固化爲可複用工作流的產品/教學場景；需要 Typora 優先的標準 Markdown、節節累積的動手線、以及離線可用的本地門戶與判分，而不是一次性 chat 輸出。
注意：
- 插件以當前 DSH 進程權限運行；安裝前請閱讀倉庫源碼與 MIT 許可證，確認路徑與 profile 策略符合你的環境。
- 社區目錄站點與 DeepSeek / 幻方無官方從屬關係，插件來自社區維護者 GamecialX，星標等元數據以目錄頁與 GitHub 爲準。
- 瀏覽器內的門戶視覺效果（毛玻璃、動效等）README 說明需人工查看；自動化測試覆蓋渲染與判分邏輯，不覆蓋全部 UI 細節。
結尾¶
dsh-study-notes 把「從零學一門課」收斂爲 DSH 技能 study-notes：標準 Markdown 庫、讀者 project/ 主線、校驗腳本與本地學習門戶一體，零 npm 運行時依賴。進一步瞭解請查看 GitHub 倉庫 與 skillhub 目錄頁。
