Lyn-77/ProMentor

ProMentor

把任意开源项目转成 MIT 风格的动手工程课程 在实践中学习

ProMentor 是一个 AI Coding Agent Skill。装上它，你的 AI 编程助手立刻化身为导师——扫描项目架构、生成阶梯式 Chapter、带你手写核心逻辑、自动判题、AI Code Review。

学的不是算法题，是一个真实系统的架构设计能力。

安装

DSH Web GUI 内置 Dashboard（非DeepSeek Harness不需要看）

只有 DSH 需要本小节：它的 Dashboard 是 GUI 内置插件（Codex / Claude Code
等其他 Agent 的技能包自带静态网页，跳过本小节）。插件预构建产物随 Release 包
分发，仓库本身不含构建产物。

安装（一条命令）

方式 A（推荐）：下载 Release 的 promentor.zip 并解压
cd /promentor
bash dsh-plugin/install.sh

方式 B（源码）：clone 本仓库后先 make build
cd /path/to/ProMentor
bash dsh-plugin/install.sh

- 卸载：bash dsh-plugin/uninstall.sh

从release下载zip

1. 前往 Releases 下载最新 promentor.zip

2. 解压后把 promentor/ 放到 .{YourAgent}/skills/

使用

在 DSH（DeepSeek Harness）、Codex、Claude Code 等支持 /promentor 命令的 AI 编程助手中打开你的项目，然后：

1. 生成课程

/promentor init

AI 自动扫描你的项目，分析架构，生成课程大纲。你确认后，逐 Chapter 生成讲义、Lab、行为测试。

2. 学习

/promentor learn ch01

AI 讲解讲义、带你读标注过的源码、引导你手写核心逻辑。

3. 测试

/promentor test

AI 运行行为测试，告诉你哪些通过了、哪些失败了、为什么。

4. 获取提示

/promentor hint

AI 读了你的代码和测试结果，给你针对当前错误的、分层的提示。从方向到思路，不直接给答案。

5. 提交

/promentor submit

全量测试 + 锁定成绩。代码保存到提交历史。

6. AI Code Review

/promentor review

AI 对比你的实现 vs 原始源码，解释设计决策、"为什么这样做"、你可以如何改进。

7. 查看进度

/promentor         # 课程面板
/promentor progress # 详细进度

8. 查看仪表盘（网页 Dashboard）

/promentor dashboard

DSH Web GUI 内置面板（推荐）：点击会话输入框上方的 ProMentor 按钮，
面板跟随当前会话的工作目录，直接读取 .promentor/ 课程数据——无需任何本地服务。
安装教程见上方 ① DSH Web GUI 内置 Dashboard（一条命令 bash dsh-plugin/install.sh）。

独立仪表盘（备用，供 Codex / Claude Code 等）：自动读取 .promentor/ 下生成的课程数据，浏览器网页与 Agent 对话双通道查看。

功能

- 主页概览：总体完成度、当前学习章节、已完成/学习中/未开始统计、每章状态/分数/尝试次数、内容完整性警告
- 章节独立页面：/dashboard/chapters// 直达任意章节，可刷新、可分享
- 左侧边栏：一键切换讲义（Lecture）与源码导读（Source）
- 主题切换：右上角按钮在浅色/深色模式间切换
- Markdown 增强渲染：代码语法高亮、Mermaid 图、数学公式、CJK 排版（Streamdown）

自动启动

/promentor init 结束与 /promentor learn  开始时，会提示打开 GUI 内置面板
（插件未安装时自动启动独立仪表盘并输出访问地址）。

架构

- DSH 插件模式：host 数据网关（packages/host/promentor）+ GUI 面板
（packages/client/ui-promentor），位于 deepseek-harness 仓库，本仓库 dsh-plugin/
目录负责注册（install.sh / uninstall.sh）
- 独立服务模式（备用）：全局单进程，重复启动复用已有进程；网页只存在于技能包
dashboard/ 内，不复制到项目目录；服务启动时读取项目根目录的 .promentor/ 数据

使用方式（备用模式）：

cd /path/to/project
python3 /scripts/serve.py          # 启动并打开浏览器
python3 /scripts/serve.py status   # 查看运行进程
python3 /scripts/serve.py stop     # 停止

命令速查

| 命令 | 说明 |
|------|------|
| /promentor init | 分析项目，生成课程 |
| /promentor | 课程面板（目录 + 进度） |
| /promentor learn  | 进入指定 Chapter 学习 |
| /promentor test | 运行行为测试 |
| /promentor hint | 动态生成分层提示 |
| /promentor submit | 正式提交，锁定成绩 |
| /promentor review | 对比实现 vs 原始源码 |
| /promentor progress | 查看总进度 |
| /promentor dashboard | 课程仪表盘（完成度 + 当前学习 + 内容完整性） |

学习模型

Learn Concept     （AI 讲解讲义）
↓
阅读源码  （AI 带你读标注过的源码）
↓
实现实验     （手写核心逻辑）
↓
运行测试         （/promentor test）
↓
提交与审查   （/promentor submit → /promentor review）
↓
掌握系统设计

为什么是 ProMentor

- 比直接读源码有路线：不是随机跳转，是有依赖关系的阶梯式学习路径
- 比视频课深入：不是看别人写代码，是自己亲手实现核心逻辑
- 比博客系统化：不是碎片化知识点，是完整理解一个系统的设计哲学
- AI 原生：课程由 AI 生成、AI 讲解、AI 判题、AI Review。零内容生产成本。