MakiMath

编者工作台指南 ​

本页尚未完成新模型复核

本页保留旧版操作资料，不作为当前接口或产品能力的依据。课程/小节接口已移除，旧动画执行方式不再适用。新契约以前端接入流程为准；部署不得据旧文直接初始化已有数据库。

讲义工作台（/workbench）是 MakiMath 专门为内容创作者打造的核心生产力工具。它将树状目录编排、源码编辑、前置知识图谱与实时 WASM 预览深度整合在单一界面中。

工作台三大功能区 ​

工作台三大功能区

1. 目录树导航区 ​

  • 层级浏览：展示当前用户拥有编辑权限的所有课程、章节和小节。
  • 拖拽重排：支持鼠标拖拽章节或小节上下移动，释放后自动同步并更新后端的 pos 排序字段。
  • 上下文菜单：右键点击节点可执行“新建小节”、“编辑属性”、“复制小节”、“删除节点”等操作。

2. 源码编辑区 ​

  • 快捷工具栏：支持一键插入定理块、例题模板、矩阵骨架及常用微积分算子。
  • 历史记录：支持编辑回退（Ctrl + Z）与重做（Ctrl + Y）。
  • 脏数据提示：当内容有未保存的修改时，工作台会显示显目的状态提醒，防止意外刷新丢失心血。

3. WASM 实时预览区 ​

  • 基于 Typlet 引擎直接在本地浏览器线程中进行高保真矢量渲染。
  • 无论公式复杂度多高，键入与渲染延迟均保持在毫秒级，实现真正意义上的所见即所得。

小节高级批量操作 ​

在进行整书或大体量讲义的编纂重构时，工作台提供了多项高效的批量处理能力：

1. 批量移动 (Batch Move) ​

  • 勾选多个小节后，选择目标章节即可一键批量迁移。
  • 防冲突机制：如果目标章节中已存在同名 slug，系统会自动追加 -1、-2 后缀，避免数据库唯一键冲突。

2. 批量复制 (Batch Copy) ​

  • 支持将选中的小节批量复制为副本（默认标题追加 (副本) 标识，并自动分配最新排序权重）。
  • 可跨章节复制，便于复用经典习题或公共推导模块。

3. 批量删除 (Batch Delete) ​

  • 批量勾选小节并确认后一次性安全移除，同时关联的拓扑依赖边会被级联更新。

前置依赖拾取器 (PrereqPicker) ​

在小节的属性编辑面板中，点击 设置前置小节 即可唤起前置依赖拾取器：

  1. 可视化检索：支持按章节展开筛选，或者输入关键词快速过滤候选小节。
  2. 防自选与合规校验：
    • 当前编辑的小节自身会被禁用，不可选择为前置依赖。
    • 依赖关系必须构成有向无环图，如存在潜在死循环回路，系统会拦截并给出友好提示。
  3. 即时联动：保存前置关系后，知识图谱页面将立即重绘前置流向箭头。

内容冲突协商与保存机制 ​

为了避免多人协作编辑同一门课程时产生内容相互覆盖，MakiMath 采用了基于哈希的内容协商机制：

  1. SHA-256 校验：每个小节在加载到工作台时，均携带后端的 source_hash。
  2. 并发冲突保护：若另外一名编者在此期间抢先提交了新版本，你的提交请求会被拦截并提示最新变更，保障内容版本安全。