前言¶
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
