返回目录

dsh-openmaic

精选清单收录维护状态: 维护中

thu-maic/dsh-openmaic

OpenMAIC 的 DSH 集成:课堂、幻灯片、交互组件与苏格拉底式教学。

前往 GitHub
$ dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git

132

星标

21

Fork

JavaScript

语言

MIT

许可证

2026-08-13

创建于

2026-08-13

最近推送

一个原生 DeepSeek Harness 插件,把你的智能体变成 OpenMAIC 老师:通过四个工具加一个苏格拉底式技能,生成课堂、幻灯片、交互式组件和沙箱教学卡片。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-09-03

许可证

MIT

01它能帮你完成什么?

  • 在 DeepSeek Harness 中生成 AI 课堂与苏格拉底式课程

    open.maic.chat 上的可播放课堂链接,以及在对话中渲染的幻灯片、交互式组件和行内教学卡片

    使用 DeepSeek Harness 的教育者、教师与智能体,想要互动、苏格拉底式的教学素材

  • 行内渲染智能体编写的幻灯片、组件与 HTML 教学片段

    沙箱卡片与官方渲染器幻灯片,覆盖文字、形状、图片、表格、图表、公式、代码、模拟与游戏

    希望在 DeepSeek Harness 内直接生成可视化、互动课程内容的开发者与教学智能体

02如何接入 DeepSeek Harness?

安装步骤

  1. 01

    运行 `dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git`,把插件安装到 `web` 配置档。

    $ dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git

  2. 02

    重启 `dsh web` 并刷新页面——仓库已自带编译好的 `lib/`,因此无需构建步骤。

    $ dsh web

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配原生运行时

原生 DeepSeek Harness 运行时插件:通过官方 `dsh plugin --profile web add` 命令安装,在运行时内注册四个工具与苏格拉底式教学技能。

  • openmaic_generate — 课堂生成

    一条课程需求(例如「帮我做一节 X 课」),以及可选的 `language` 等参数→open.maic.chat 上可播放的课堂链接,由异步生成任务返回

  • openmaic_slide — 幻灯片渲染

    一份以 PPTist 风格 Slide JSON 编写的 OpenMAIC 幻灯片→经 OpenMAIC 官方渲染器渲染的幻灯片(文字、形状、图片、表格、图表、公式、代码)

  • openmaic_widget — 交互式组件

    一份按内置契约编写的 OpenMAIC 风格交互式组件(模拟、游戏或代码)→以内联沙箱卡片形式渲染的完整 HTML 文档;代码在智能体编写时流式输出

  • openmaic_render — 行内 HTML 教学卡片

    一段行内 HTML 教学片段(概念卡、测验、分步讲解)→在对话中就地渲染的沙箱卡片

  • openmaic-teach — 苏格拉底式教学技能

    一次 DeepSeek Harness 会话→以引导式提问教学的苏格拉底式 OpenMAIC 课程,并调用幻灯片、组件与卡片作为辅助

04适合谁?何时不该用?

适合

  • 使用 DeepSeek Harness 的教育者、教师与智能体,想要互动、苏格拉底式的教学素材
  • 希望在 DeepSeek Harness 内直接生成可视化、互动课程内容的开发者与教学智能体

不适合

  • slide/widget/render 工具不进行服务端生成;它们渲染智能体依据 OpenMAIC SDK 契约(`@openmaic/dsl`、`@openmaic/generation`、`@openmaic/renderer`)编写的内容,并以沙箱卡片形式行内展示。

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

  • 生成类工具会把需求提交到 open.maic.chat 并远程轮询;课堂生成为异步过程,依赖外部 OpenMAIC 服务可联网访问。
  • slide/widget/render 工具不进行服务端生成;它们渲染智能体依据 OpenMAIC SDK 契约(`@openmaic/dsl`、`@openmaic/generation`、`@openmaic/renderer`)编写的内容,并以沙箱卡片形式行内展示。
  • 课堂生成较慢;默认 `pollIntervalMs` 为 5000,但 60000 更友好,单个任务上限 `maxWaitMs` = 600000(10 分钟)。
2026-08-132026-08-13作者未说明

MIT · maintained (latest release not published; tracked from default-branch commit)

06常见问题

如何在 DeepSeek Harness 中安装 dsh-openmaic?

运行 `dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git`,然后重启 `dsh web` 并刷新。插件自带编译好的 `lib/`,因此 git 安装无需构建。

这个插件注册了哪些工具?

它注册了四个工具——`openmaic_generate`、`openmaic_slide`、`openmaic_widget`、`openmaic_render`——以及一个 `openmaic-teach` 技能,该技能以苏格拉底式教学会话运行,并以上述工具作为辅助。

课堂在哪里生成?需要账号吗?

`openmaic_generate` 把需求提交到 open.maic.chat 并轮询异步任务,返回可播放的课堂链接。配置项 `accessCode`(邀请码)目前线上尚未强制校验,可暂时留空。

slide/widget/render 工具需要服务端生成吗?

不需要。这些工具不进行服务端生成;它们渲染智能体依据 OpenMAIC SDK 契约(`@openmaic/dsl`、`@openmaic/generation`、`@openmaic/renderer`)编写的内容,并以沙箱卡片形式行内展示。

如何把插件指向本地的 OpenMAIC 实例?

在插件配置(`dsh-openmaic.baseUrl`)中将 `baseUrl` 设为 `http://localhost:3000`。其它可调项包括 `pollIntervalMs` 与 `maxWaitMs`(单个生成任务的 10 分钟上限)。

08数据与来源

  • 作者声明github.com09c1693cfe83…

    `dsh-openmaic` is a DeepSeek Harness plugin that registers four tools

  • 作者声明github.com09c1693cfe83…

    dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git

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

🏆

最佳 DeepSeek Harness 插件

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

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

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