返回目录

promentor

编辑精选维护状态: 活跃

lyn-77/promentor

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

前往 GitHub
$ dsh plugin add promentor

78

星标

1

Fork

TypeScript

语言

MIT

许可证

2026-07-31

创建于

2026-09-16

最近推送

DeepSeek Harness(及 Codex / Claude Code)的 AI 导师技能:通过亲手实现来学习真实系统架构——阶梯式 Chapter、动手 Lab、行为测试判题、分层提示与 AI Code Review,并附带 DSH 内置仪表盘。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-29

许可证

作者未说明

01它能帮你完成什么?

  • 把任意开源项目转成 MIT 风格的动手工程课程

    阶梯式 Chapter 课程(讲义、Lab、行为测试),并配套 /promentor test 自动判题与 AI Code Review

    想通过亲手实现来学习真实系统架构的开发者与 AI 编程助手使用者

  • 学习真实系统的架构设计能力,而不是孤立的算法题

    /promentor hint 给出的「针对当前错误、分层」的提示——只指方向不给答案,以及每章进度与成绩追踪

    比起随机翻源码,更想要一条有依赖顺序、动手实践路径的自学者

02如何接入 DeepSeek Harness?

安装步骤

  1. 01

    从 Releases 下载最新 promentor.zip 并解压,进入解压后的 promentor/ 目录运行 `bash dsh-plugin/install.sh`(推荐)

  2. 02

    或 clone 本仓库,先执行 `make build`,再 `cd /path/to/ProMentor && bash dsh-plugin/install.sh`

  3. 03

    也可解压后把 `promentor/` 放到 `.{YourAgent}/skills/`

验证接入成功

作者未说明

回滚

  • 卸载:`bash dsh-plugin/uninstall.sh`

03DSH 适配与能力边界

DSH 适配原生运行时

DSH Web GUI 内置插件:host 数据网关(packages/host/promentor)+ GUI 面板(packages/client/ui-promentor)位于 deepseek-harness 仓库,本仓库 dsh-plugin/ 目录通过 install.sh / uninstall.sh 完成注册

  • 课程生成(/promentor init)

    在受支持的 AI 编程助手中打开的项目目录→课程大纲 + 阶梯式 Chapter(讲义、Lab、行为测试)

    在项目 `.promentor/` 目录下写入课程数据
  • 学习引导(/promentor learn)

    Chapter 标识(如 ch01)→讲义讲解、标注源码导读、引导手写核心逻辑

    读取 / 写入 `.promentor/` 课程数据
  • 测试与判题(/promentor test)

    你的实现代码→行为测试报告:哪些通过、哪些失败、为什么

  • 课程仪表盘(Dashboard)

    `.promentor/` 课程数据→完成度、每章状态 / 分数 / 尝试次数、内容完整性警告

    DSH 内置面板读取当前会话工作目录;备用模式启动本地单进程读取项目根 `.promentor/`

04适合谁?何时不该用?

适合

  • 想通过亲手实现来学习真实系统架构的开发者与 AI 编程助手使用者
  • 比起随机翻源码,更想要一条有依赖顺序、动手实践路径的自学者

05兼容性、维护与安全提示

  • 仓库本身不含构建产物:DSH 仪表盘的预构建产物随 Release 包分发,因此源码模式安装需先执行 `make build`。
  • 备用独立仪表盘模式会启动全局单进程本地服务(`python3 scripts/serve.py`),读取项目根目录 `.promentor/`——该回退路径需要 Python 运行时。
  • `/promentor` 命令仅在支持它的 AI 编程助手中可用——DSH(DeepSeek Harness)、Codex、Claude Code 等;其他环境没有内置命令。
2026-07-312026-08-13v0.3.0

TypeScript · 活跃维护中(最新版本 v0.3.0,2026-08-13)

06常见问题

怎么在 DeepSeek Harness 上安装 ProMentor?

从 Releases 下载最新 promentor.zip 并解压,进入 promentor/ 目录运行 `bash dsh-plugin/install.sh`(推荐)。源码模式:clone 本仓库,先执行 `make build`,再运行 `bash dsh-plugin/install.sh`。DSH 仪表盘是内置 GUI 插件,无需额外的本地服务。

/promentor 到底能做什么?

它会扫描你的项目、生成阶梯式 Chapter 课程(讲义、Lab、行为测试),引导你手写核心逻辑,运行行为测试并告诉你哪些通过 / 失败 / 为什么,给出不剧透答案的分层提示,并通过 AI Code Review 将你的实现与原始源码对比。

仪表盘需要起本地服务吗?

在 DSH 上不需要——内置面板直接读取当前会话的 `.promentor/` 数据,无需本地服务。Codex / Claude Code 的备用模式运行 `python3 scripts/serve.py`,启动单个全局进程读取项目根 `.promentor/`。

ProMentor 和直接读源码有什么不同?

它提供有依赖顺序的阶梯式学习路径,而不是随机跳转;让你亲手实现核心逻辑,而不是看别人写代码;并系统化一个系统的设计哲学——课程由 AI 生成、讲解、判题、Review,内容生产成本为零。

08数据与来源

  • 作者声明github.com491ad35b84d9…

    它的 Dashboard 是 **GUI 内置插件**

  • 作者声明github.com491ad35b84d9…

    DSH 插件模式:host 数据网关(`packages/host/promentor`)+ GUI 面板

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-29。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。