前言¶
DSH 插件生態強調“一切皆插件”；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應把它理解成官方應用商店。對智能體開發者來說，學習類插件要解決的不是“再生成一批筆記”，而是把一次真實輸入變成可追溯證據，更新學習狀態，保留可回滾邊界，並讓主代理繼續負責當前回答。
gitlearnos 提供 GitLearnOS 獨佔的官方 DeepSeek Harness Developer Preview 原生 bundle，以私有本地 Git 倉庫保存學習者擁有的學習記憶，並在 Harness 中提供有界只讀觀察、隊列面板和受授權的寫回事務。
這是什麼¶
gitlearnos 由 Guojiz 維護，許可證爲 MIT。定位是 Evidence-driven learning memory and automation for Git-native AI agents。
它面向 Git 原生智能體：主代理可以識別有用的學習事件，把證據與學習目標連接起來，給出下一步動作，並留下可檢查、可回滾的記錄。學習仍可以發生在課堂、書本、練習平臺、項目或與其他 AI 的交互中；gitlearnos 不把全部學習搬進一個應用，只連接對學習者下一步決策有用的證據。
核心能力¶
下面介紹已覈實的能力。
- 提供 GitLearnOS 獨佔的官方 DeepSeek Harness Developer Preview 原生 bundle。
- 以私有本地 Git 倉庫保存學習者擁有的學習記憶。
- 提供
learning_status與learning_route的有界只讀觀察。 - 支持由
gitlearnos.yml授權的learning_apply事務，在單次可回滾 Git 提交中應用 typed event、knowledge-gap、model、review 和 dashboard 操作。 - 提供 loopback-only、只讀面板，展示代理維護的
Next up隊列，並尊重Panel: expand|collapse。 - 支持 five queue actions，將
review、practice、close-with-one-question、ask-a-teacher或read-notes請求放入會話輸入。 - 支持
safe-auto、preview、manual寫回模式。 - 支持可選本地 RAG 層，並明確支持 RAG-Anything 作爲首個選項。
寫回與權限邊界¶
learning_apply 不是普通寫入。它需要通過 learner identity、setup/config、base revision 和 write-authority 檢查；learning_record 作爲兼容包裝保留。
寫回模式可以這樣區分：
safe-auto：在目標、證據、學習目標和隱私邊界清楚時，可執行最小的安全寫回。preview：提出精確變更，但不寫入。manual：等待審批。
另外，maintenance 與 due-review 只有在真實調度器中創建並觀察到任務後，纔算完成。
典型用法¶
從 core-ready Quickstart 開始¶
使用 core-ready Quickstart 中的單一規範 setup prompt。它會要求代理：
- 識別私有目標。
- 確認學習目標和科目與當前材料。
- 推薦本地 RAG。
- 在部署前等待。
- 檢測實際能力並報告 undo boundary。
用真實學習事件推進¶
一次提問、作答、頁面照片、課堂筆記、老師評語、練習結果或重複困難，都可以作爲學習事件。
按學習目標與真實輸入執行時，流程可以寫成：
goal and real input
→ organize traceable evidence
→ ask from the current gap
→ keep the answer or external feedback
→ recheck independently later
→ update state with one reversible Git commit
對應的中文步驟是：整理可追溯證據、從當前缺口提問、保留答案或外部反饋、稍後獨立複查、用一次可回滾 Git 提交更新狀態。
需要更大材料時¶
對較大學校教材、課程包、筆記或持久個人知識，可推薦本地 RAG 層，並使用 RAG-Anything 作爲首個明確支持選項。RAG provider 訪問是可選獨立層，不內置於該 bundle。
視覺輸入與多模態¶
DeepSeek 默認 provider 僅限文本。若需要處理圖片，可配置第三方多模態模型，或安裝授權視覺/OCR 橋接插件。若兩者都沒有，代理會要求轉寫，而不是猜測未見內容。
安裝與啓用¶
已覈實資料未給出官方安裝命令。若要接入，建議以倉庫中的 bundle 與文檔說明爲準，不要憑插件名拼接安裝命令。
適用場景與注意¶
gitlearnos 適合需要以下能力的 DSH 開發者或學習代理場景：
- 默認使用私有本地 Git 倉庫保存學習狀態。
- 希望寫入是單次可回滾 Git 提交，並有明確權限檢查。
- 需要一個 loopback-only、只讀面板查看
Next up隊列。 - 需要可選本地 RAG 層處理教材、課程包、筆記或持久個人知識。
使用前注意：
- 插件以當前
dsh進程權限運行；安裝前應檢查源碼與許可證。 - 默認推薦私有倉庫；GitHub 等 remote 爲可選。
- 面板爲 loopback-only、只讀，並標註開發樣本數據。
- 已覈實資料未給出星標數和官方安裝命令；不要據此補充不確定數據。
鏈接¶
- GitHub：https://github.com/Guojiz/gitlearnos
- 插件目錄頁（插件線索）：https://www.skillhub.cn/plugins/Guojiz/gitlearnos
