Skip to content
Back to search

dsh-openmaic

OpenMAIC for DeepSeek Harness: classrooms, slides, interactive widgets, and Socratic teaching

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/thu-maic--dsh-openmaic/badge.svg)](/listings/thu-maic--dsh-openmaic)

HTML

<a href="/listings/thu-maic--dsh-openmaic"><img src="/api/listings/thu-maic--dsh-openmaic/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 git+https://github.com/THU-MAIC/dsh-openmaic.git

Then restart `dsh web` and refresh. The plugin ships its compiled `lib/`, so a git install needs no build step.

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 · 97 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # dsh-openmaic
  2. 把 OpenMAIC 带进 DeepSeek Harness。Bring OpenMAIC into DeepSeek Harness.
  3. `dsh-openmaic` is a DeepSeek Harness plugin that registers four tools and a
  4. Socratic teaching skill:
  5. - `openmaic_generate`: tell your agent "make me a lesson about X", and the plugin submits the requirement to [open.maic.chat](https://open.maic.chat/), waits for the async generation job, and returns a playable classroom link.
  6. - `openmaic_slide`: the agent writes one OpenMAIC slide (PPTist-style Slide JSON) and the plugin renders it with OpenMAIC's official renderer (text, shapes, images, tables, charts, formulas, code).
  7. - `openmaic_widget`: the agent writes an OpenMAIC-style interactive widget (simulation, game, or code) per the bundled contract; the code streams as it writes, then renders inline as a sandboxed card.
  8. - `openmaic_render`: the agent writes an inline HTML teaching fragment (concept card, quiz, walkthrough) and the plugin renders it as a sandboxed card right in the conversation.
  9. - `openmaic-teach` skill: turns a session into a Socratic OpenMAIC lesson, teaching by guided questioning and pulling in slides, widgets, and cards as aids.
  10. ## What it looks like
  11. ```
  12. 用户: 帮我做一节量子物理入门课
  13. 模型 → openmaic_generate(requirement="量子物理入门课", language="zh-CN")
  14. ← "Classroom ID: class-abc123
  15. Classroom URL:
  16. https://open.maic.chat/classroom/class-abc123"
  17. 模型: 课堂已经生成好了,点开就能上课:
  18. https://open.maic.chat/classroom/class-abc123
  19. ```
  20. Interactive widget:
  21. ```
  22. 用户: 做一个抛体运动模拟器
  23. 模型 → 按 openmaic-widget 模板写完整 HTML(流式输出)
  24. → openmaic_widget(html="<!doctype html>…", widgetType="simulation", title="抛体运动")
  25. ← "Rendered the simulation widget …"
  26. 对话里就地出现一个可交互的 OpenMAIC 模拟器
  27. ```
  28. ## Install
  29. ```sh
  30. dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git
  31. ```
  32. Then restart `dsh web` and refresh. The plugin ships its compiled `lib/`, so a
  33. git install needs no build step.
  34. ## Config
  35. ```yaml
  36. dsh-openmaic:
  37. baseUrl: https://open.maic.chat
  38. accessCode: "" # invite code; not enforced online yet, leave empty
  39. pollIntervalMs: 5000
  40. maxWaitMs: 600000
  41. ```
  42. | Key | Default | Notes |
  43. | --- | --- | --- |
  44. | `baseUrl` | `https://open.maic.chat` | API base. Point at `http://localhost:3000` to develop against a local OpenMAIC. |
  45. | `accessCode` | `""` | Invite code for open.maic.chat. Not enforced online yet, leave empty; fill it in once enabled. |
  46. | `pollIntervalMs` | `5000` | Poll interval in ms. Generation is slow, so 60000 is friendlier than the default. |
  47. | `maxWaitMs` | `600000` | Cap for one job, 10 minutes. |
  48. ## API flow
  49. 1. If `accessCode` is set, `POST /api/access-code/verify` and replay the `openmaic_access` cookie on later requests.
  50. 2. `POST /api/generate-classroom` with the requirement, plus only the optional flags you passed. Returns a `jobId` and `pollUrl`.
  51. 3. Poll `GET {pollUrl}` until the job is `succeeded` or `failed`, or `maxWaitMs` runs out.
  52. 4. On success, return `{baseUrl}/classroom/{classroomId}` (or the server-provided `result.url`).
  53. ## Scope
  54. - `openmaic_generate`: generate a classroom and return a playable link.
  55. - `openmaic_slide`: render one OpenMAIC slide with the official renderer.
  56. - `openmaic_widget`: render a simulation / game / code widget the agent writes (a full HTML document). It streams the code while the agent writes it and renders on completion.
  57. - `openmaic_render`: render an inline HTML teaching fragment as a sandboxed card.
  58. - `openmaic-teach`: Socratic teaching session that uses the tools above as aids.
  59. The slide/widget/render tools do no server-side generation; they render content
  60. the agent authors against the OpenMAIC SDK contracts (`@openmaic/dsl`,
  61. `@openmaic/generation`, `@openmaic/renderer`).
  62. ## Roadmap
  63. - Wire the remaining widget types (diagram, visualization3d, procedural-skill).
  64. - Action loop back to the model (teaching-agent interactions: highlight/annotate/reveal widget elements).
  65. ## Development
  66. ```sh
  67. ./scripts/build.sh # links host deps, bundles src/ to lib/ with tsdown
  68. ./scripts/test.sh # links host deps, runs the vitest suite
  69. ```
  70. The scripts locate the harness checkout from `dsh` on `PATH`; set `DSH_CHECKOUT` to build against a specific checkout.
  71. ## License
  72. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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