Kaiji-Z/dsh-plugin-lookatstudy 预览 preview

Kaiji-Z/dsh-plugin-lookatstudy

dsh 社区插件:将任意 Markdown/文件夹/GitHub 学习仓库转化为 DeepSeek Harness 内的引导式 AI 导师课程(带门控技能树、BKT 掌握度、SM-2 复习)。

Project Overview项目介绍

dsh-plugin-lookatstudy is a native plugin built exclusively for DeepSeek Harness (DSH). It converts any markdown document, local folder, or public GitHub learning repository into a structured guided course directly inside the DSH interface. It ports the full interaction design of the independent LookatStudy learning engine to DSH, turning your DSH agent into a full AI tutor with features like per-concept knowledge tracking, spaced repetition, mastery-driven progression, exam mode, XP and streaks, bilingual lessons, text-to-speech, and rich content rendering. To install the plugin, you can run dsh plugin add dsh-plugin-lookatstudy from npm, or install it from a local gzipped tarball if you built it yourself.

After installation, the plugin adds a dedicated "学习" (Study) row to the DSH sidebar, which opens a full-screen three-column study panel that matches LookatStudy's original design. The panel automatically adapts to DSH's active light or dark theme, and includes a collapsible course rail, rich lesson display area, and built-in notebook. To start learning, you just send a chat command like "import github.com/microsoft/AI-For-Beginners and teach me lesson 1", and the AI tutor will handle the full workflow from there. It is built for learners who want to use DSH's AI capabilities for structured, self-paced AI-guided learning.

The plugin is released under the open source MIT license, and all vendored learning engine code from LookatStudy is also used under the MIT license. It does not require any external core services to work: concept maps are generated with a built-in ELK layout, and diagram assets are loaded from CDN on demand, with silent degradation for offline use. Text-to-speech defaults to Edge TTS, and falls back to the system's built-in speech synthesis if Edge TTS is unavailable. The companion creature feature from original LookatStudy is not ported, and persistent text highlighting is implemented via text search anchors.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,能够将任意 markdown 文档、本地文件夹或 GitHub 学习仓库转换为 DSH 内的引导式学习课程。它将 LookatStudy 的交互设计完整整合进 DSH,让 DSH 代理变身 AI 家教,支持概念级知识追踪、掌握度驱动学习进度、间隔重复复习、康奈尔笔记、星级评分考试模式、XP 和连续学习记录、双语课程、文本朗读,还能渲染 KaTeX 数学公式、高亮代码、mermaid 图和概念图。

安装方式非常简单,可直接通过 DSH 命令从 npm 安装,也可以下载压缩包后通过 DSH 命令从本地安装。安装完成后,用户只需在对话中给出发起学习的指令,比如“导入指定学习仓库并开始第一课”,AI 导师就会按照 LookatStudy 的完整学习流程推进,自动拆分知识点概念、记录掌握程度、优先安排薄弱概念的测验和复习。它适合想要依托 DSH 的 AI 能力开展系统化自主学习的用户。

插件使用 MIT 许可证,核心学习引擎模块从同样采用 MIT 许可的 LookatStudy 项目移植而来。它不依赖额外的核心外部服务,概念图使用内置 ELK 布局生成,图表资源默认从 CDN 按需加载,离线环境下会静默降级不影响核心功能。文本朗读默认使用 Edge TTS,失败后会自动回退到系统语音。目前 Companion 生物功能未移植,持久文本高亮通过文本搜索锚点实现。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 14 stars - an early-stage project星标 14,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin add dsh-plugin-lookatstudy

把 Kaiji-Z/dsh-plugin-lookatstudy 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugin-lookatstudy

English | 简体中文

Turn any markdown document, local folder, or GitHub learning repository into a guided course inside DeepSeek Harness (dsh) — your dsh agent becomes a full AI tutor with the interaction design of LookatStudy: per-concept knowledge tracking, mastery-driven progression, spaced repetition, mastery proposals, friction awareness, learner memory, a Cornell notebook, an in-chat proposal card, exam mode with star grades, XP & streak, bilingual lessons, read-aloud (Edge TTS with a system-voice fallback), and a rich blackboard (KaTeX math, syntax-highlighted code, mermaid diagrams, mindmap & concept-map views). Learning engine modules are vendored from LookatStudy (MIT).

Screenshots

The three-column study panel (light theme)

The 学习 panel — LookatStudy's UI 1:1 in the host's light theme (the panel follows the host's dark/light switch live): the floating XP/streak app header, the three-column surface ladder (rail / chat / notebook, depth by color step), 3D push-down buttons, and the chat's typing dots; opened from the sidebar's 学习 row.

图说明
Course rail list 课程栏 — the course tree as a quiet list (a deliberate deviation from upstream's gamified map): collapsible section heads with done/total counts, lesson rows carrying the status glyph (locked / available / in-progress / mastered crown / purple exam), inline mastery bars, due badges, streaming spinners, and hover tooltips that explain every state; the focused row is brand-edged.
讲解 lesson page 讲解 — server-sanitized markdown rendered rich on demand: KaTeX formulas, syntax-highlighted code (shared copy-to-clipboard blocks), mermaid diagrams with a zoomable canvas stage (CDN loaders, silent degrade offline), and the bilingual interleave when a translation exists.
Concept map 🕸 概念图 — the lesson's knowledge components laid out as a draw.io-style concept graph (bundled ELK layout, no external service); weak concepts (mastery <70%) glow amber.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-mirror 下一个 Next dsh-git-graph →