CordisPluginGuide & Directory
联系合作

THU-MAIC / dsh-openmaic

已收录

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

main其他 查看源代码

安装

npx -y @deepseek-ai/dsh plugin --profile web add github:THU-MAIC/dsh-openmaic

此安装命令根据 GitHub 仓库地址生成，是未经验证的安装起点。

README

维护者编写的文档快照。

在 GitHub 查看 ↗
提交版本 09c1693同步于 2026年8月18日

dsh-openmaic

把 OpenMAIC 带进 DeepSeek Harness。Bring OpenMAIC into DeepSeek Harness.

dsh-openmaic is a DeepSeek Harness plugin that registers four tools and a Socratic teaching skill:

  • openmaic_generate: tell your agent "make me a lesson about X", and the plugin submits the requirement to open.maic.chat, waits for the async generation job, and returns a playable classroom link.
  • 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).
  • 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.
  • 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.
  • openmaic-teach skill: turns a session into a Socratic OpenMAIC lesson, teaching by guided questioning and pulling in slides, widgets, and cards as aids.

What it looks like

用户: 帮我做一节量子物理入门课
模型 → openmaic_generate(requirement="量子物理入门课", language="zh-CN")
     ← "Classroom ID: class-abc123
        Classroom URL:
        https://open.maic.chat/classroom/class-abc123"
模型: 课堂已经生成好了，点开就能上课：
     https://open.maic.chat/classroom/class-abc123

Interactive widget:

用户: 做一个抛体运动模拟器
模型 → 按 openmaic-widget 模板写完整 HTML（流式输出）
     → openmaic_widget(html="<!doctype html>…", widgetType="simulation", title="抛体运动")
     ← "Rendered the simulation widget …"
     对话里就地出现一个可交互的 OpenMAIC 模拟器

Install

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.

Config

dsh-openmaic:
  baseUrl: https://open.maic.chat
  accessCode: ""     # invite code; not enforced online yet, leave empty
  pollIntervalMs: 5000
  maxWaitMs: 600000
KeyDefaultNotes
baseUrlhttps://open.maic.chatAPI base. Point at http://localhost:3000 to develop against a local OpenMAIC.
accessCode""Invite code for open.maic.chat. Not enforced online yet, leave empty; fill it in once enabled.
pollIntervalMs5000Poll interval in ms. Generation is slow, so 60000 is friendlier than the default.
maxWaitMs600000Cap for one job, 10 minutes.

API flow

  1. If accessCode is set, POST /api/access-code/verify and replay the openmaic_access cookie on later requests.
  2. POST /api/generate-classroom with the requirement, plus only the optional flags you passed. Returns a jobId and pollUrl.
  3. Poll GET {pollUrl} until the job is succeeded or failed, or maxWaitMs runs out.
  4. On success, return {baseUrl}/classroom/{classroomId} (or the server-provided result.url).

Scope

  • openmaic_generate: generate a classroom and return a playable link.
  • openmaic_slide: render one OpenMAIC slide with the official renderer.
  • 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.
  • openmaic_render: render an inline HTML teaching fragment as a sandboxed card.
  • openmaic-teach: Socratic teaching session that uses the tools above as aids.

The slide/widget/render tools do no server-side generation; they render content the agent authors against the OpenMAIC SDK contracts (@openmaic/dsl, @openmaic/generation, @openmaic/renderer).

Roadmap

  • Wire the remaining widget types (diagram, visualization3d, procedural-skill).
  • Action loop back to the model (teaching-agent interactions: highlight/annotate/reveal widget elements).

Development

./scripts/build.sh  # links host deps, bundles src/ to lib/ with tsdown
./scripts/test.sh   # links host deps, runs the vitest suite

The scripts locate the harness checkout from dsh on PATH; set DSH_CHECKOUT to build against a specific checkout.

License

MIT

项目文件与信号

以下项目是目录快照中检测到的公开仓库信号。

测试已检测

仓库信息

开发语言
JavaScript
许可证
MIT
最后更新
2026年8月13日 13:27

谨慎安装

请检查源代码、权限、生命周期脚本、依赖与网络访问；不受信任的插件应先在隔离环境中测试。

相关插件

更多插件

查看全部插件

deepseek-harness

其他

159240

DeepSeek Harness: Everything is a Plugin.

npx -y @deepseek-ai/dsh plugin --profile web add github:deepseek-ai/deepseek-harness
GitHub 安装查看详情

deepseek-harness-desktop

其他

13449

为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。

npx -y @deepseek-ai/dsh plugin --profile web add github:anywhere-labs/deepseek-harness-desktop
GitHub 安装查看详情

awesome-dsh-plugin

其他

8697

A curated list of plugins for DeepSeek Harness (dsh) · DeepSeek Harness 插件精选列表

npx -y @deepseek-ai/dsh plugin --profile web add github:awesome-dsh-plugin/awesome-dsh-plugin
GitHub 安装查看详情

zhuzhiliao

其他

2836

竹知了 —— 一转就哇哇叫的传统玩具，Web 模拟版。零依赖单文件，真实录音采样，移动端优先。

npx -y @deepseek-ai/dsh plugin --profile web add github:imsai-sh/zhuzhiliao
GitHub 安装查看详情

BitFun

其他

1787

BitFun combines a high-performance agent runtime written in Rust with a polished desktop application. It pairs the depth of a Code Agent with open, general-purpose capabilities for work beyond software development.

npx -y @deepseek-ai/dsh plugin --profile web add github:GCWing/BitFun
GitHub 安装查看详情

dsh-deep-whale

其他

1358

DSH Web 鲸鱼娘皮肤系列(深海女仆工坊 maid-atelier)——CC BY-NC-SA 4.0

npx -y @deepseek-ai/dsh plugin --profile web add github:Small-tailqwq/dsh-deep-whale
GitHub 安装查看详情