Skip to content
Back to search

dsh-course-studio

dsh-course-studio · 课程工坊 基于 [Mathigon]交互教科书方法论的 dsh 插件:**用户提课程需求.dsh plugin: author Mathigon-style interactive STEM courseware with agent + archive panel + live preview

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/liangdabiao--dsh-course-studio/badge.svg)](/listings/liangdabiao--dsh-course-studio)

HTML

<a href="/listings/liangdabiao--dsh-course-studio"><img src="/api/listings/liangdabiao--dsh-course-studio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

dsh plugin --profile web add https://github.com/liangdabiao/dsh-course-studio

前置:本地有一个 Mathigon textbooks 仓库(含 `content/` 与 `package.json`,依赖已 `npm install`)。默认路径 `D:\textbooks-master`,可在插件 Config 改(课程仓库路径 / 预览端口)。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 94 lines
  1. # dsh-course-studio · 课程工坊
  2. 基于 [Mathigon](https://mathigon.org) 交互教科书方法论的 dsh 插件:**用户提课程需求 → agent 按 skill 在本地 Mathigon 仓库创作互动课件 → 编译校验 → 存证入档 → 面板预览真实渲染的课件**。课件档案持久化,可随时回看源码与真实效果。
  3. <img width="1737" height="951" alt="image" src="https://github.com/user-attachments/assets/066c42db-9ad8-4f69-b6ec-400e1199d4d6" />
  4. <img width="1767" height="1032" alt="image" src="https://github.com/user-attachments/assets/85178f87-83b1-4fa7-beb2-420f491a334e" />
  5. ## 它解决什么问题
  6. Mathigon 是公认最高质量的互动教科书之一(双栏排版、填空即测、x-geopad/x-slider 互动组件、虚拟导师)。本插件把「做出同等质量的课件」变成一条 agent 闭环:
  7. ```
  8. 提需求(面板一句话 → 一键开新对话发起)
  9. ↓
  10. agent 按 course-studio 技能创作(先读 references,参照仓库真实课程)
  11. ↓ 写 content/<slug>/content.md + functions.ts + styles.scss
  12. course_studio lint → build(抓 Maths parsing error / 缺 glossary key)
  13. ↓
  14. course_studio save(源文件存证入档,面板可回看)
  15. ↓
  16. course_studio serve(mgon-serve)→ 面板「课件预览」看真实渲染的课件
  17. ```
  18. ## 安装
  19. ```
  20. dsh plugin --profile web add https://github.com/liangdabiao/dsh-course-studio
  21. ```
  22. 前置:本地有一个 Mathigon textbooks 仓库(含 `content/` 与 `package.json`,依赖已 `npm install`)。默认路径 `D:\textbooks-master`,可在插件 Config 改(课程仓库路径 / 预览端口)。
  23. ## 面板(侧栏「课程工坊」)
  24. | 页签 | 内容 |
  25. |---|---|
  26. | 概览 | 统计卡片 + 环境(仓库/依赖/预览服务状态)+ 最近课件 |
  27. | 发起制作 | **一句话提需求**(学科/学段/互动方式 agent 自行判断)→ 一键在新对话发起;附 3 个示例点填 |
  28. | 课件档案 | 存证卡片(标题/学科/校验状态/版本数),源码回看,删除可恢复 |
  29. | 课件预览 | **真实课件 iframe**(本地 mgon-serve 渲染的学生视角页),可切 section、一键启动预览服务、新窗口打开 |
  30. | 档案历史 | 新建/更新/删除/恢复全留痕,删除带快照可恢复 |
  31. | 制作规范 | course-studio 技能要点速查(中文课件硬规则、交付闭环) |
  32. ## 工具:course_studio
  33. | action | 说明 |
  34. |---|---|
  35. | `list` | 盘点仓库课程(找参照、避免 slug 撞名) |
  36. | `check` | 环境自检(仓库 / node_modules / 预览服务) |
  37. | `get` | 取一门课的 section 清单(核对 section 齐全性) |
  38. | `lint` | eslint 自动修 + 校验 content/\*\*/\*.ts |
  39. | `build` | mgon-build 全仓库编译,结构化返回 Maths parsing error / Missing keys |
  40. | `save` | 课件存证(源文件复制入档案库;同 slug+locale 自动走更新多一版) |
  41. | `serve` | 启动/确认本地预览服务,返回预览 URL |
  42. | `archive` / `get-archive` / `delete` / `history` / `restore` | 档案管理 |
  43. ## 技能快照:course-studio
  44. 完整快照自 Mathigon 课件创作方法论(写 `content.md` 前读 `markdown-dialect.md`;写 `functions.ts` 读 `functions-model.md`;互动组件读 `components.md`;**中文课件必读 `chinese-localization.md`**)。
  45. 三条最常见的「静默翻车」红线(构建不报错但课件缺节):
  46. 1. **step 之间必须 `---` 分隔**——不写整份文件被当成一个 step,前面的 section 全部静默丢失(实测踩过);
  47. 2. 中文课件每个 section 必须显式 `> section: <英文slug>`;
  48. 3. backtick 公式里严禁中文(AsciiMath Unknown symbol)。
  49. ## 档案存储
  50. `$DSH_HOME/dsh-course-studio/`(默认 `~/.dsh/dsh-course-studio/`):
  51. ```
  52. archives.json 档案元数据(每保存一版多一条 revision,最多 20 版)
  53. history.json 事件流(删除带完整快照,可恢复)
  54. courses/<id>/ 源文件存证副本(content.md / functions.ts / styles.scss / hints.yaml / images…)
  55. ```
  56. 删除档案不影响仓库里的课程源文件;仓库原件丢失可从档案回看源码。
  57. ## 开发
  58. ```
  59. npm install
  60. npm run build # 打包 client.js → dist/client.js
  61. npm test # lib 层单测(沙盒,28 项)
  62. npm run check:start # 「发起制作」发出的指令是否为完整指令(前缀 / 需求原文 / 闭环要求)
  63. node scripts/smoke.mjs [--repo <仓库>] [--port <端口>]
  64. # E2E 冒烟:工具全动作 + 真实课件页可达性(沙盒 DSH_HOME)
  65. node scripts/panel-dev.mjs [--port 8899]
  66. # 面板开发预览(假 ctx 拉起 api 路由,浏览器直接验收)
  67. ```
  68. ## 许可
  69. MIT。注意:Mathigon 仓库内容本身 UNLICENSED / private——创作课件请遵守所在仓库的许可约定,勿直接搬运其内容商用。
  70. 感谢社区支持:https://linux.do

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.