鸿蒙 ArkTS 实战：Invoice Tax Calc 从发票税额计算到票据税额应用完整解析
2026/7/22 16:00:32
一个教育产品想增加几何能力，表面需求可能只是“在题目旁边放一张图”。但产品真正运行起来后，需求往往会继续增长：图能不能拖动？老师能不能修改？学生能不能作答？内容能不能保存？能不能导出到讲义？AI 能不能根据一句话改图？
如果每出现一个需求就补一个局部功能，最终很容易造出一套难以维护的半成品几何编辑器。
**几何画板 SDK 的作用，是把一套可交互的几何能力作为产品组件接入现有 Web 应用。**宿主产品继续负责用户、课程、题目、权限和数据；SDK 负责几何内容的展示与创作。
一、几何画板 SDK 到底提供什么？
以大角几何 SDK 为例，能力可以分为四层。
1. 交互式展示
演示模式可以加载分享内容或结构化文件，切换多页画板，并让用户在网页中直接观察和操作图形。
它适合：
- 题库的题目页和解析页；
- 数字教材中的动态插图；
- 课件播放和课堂演示；
- 几何作品展示页。
与 PNG 不同，点、线、圆和变量仍然保持几何关系。拖动一个点时，相关对象会按照构造关系一起变化。
2. 完整几何创作
编辑模式内置动态几何引擎和工具栏，并支持多画板管理、撤销重做、结构化内容读写和 UI 定制。
它适合：
- 教案或课件编辑器；
- 题库内容生产后台；
- 学生几何作图题；
- 教研资源共建平台。
宿主可以选择隐藏导航栏、工具栏或代数面板，使画板适应自己的页面布局和用户角色。
3. 数据和业务系统集成
几何内容不是只能留在第三方网站里的截图。SDK 可以把完整内容作为结构化 JSON 交给宿主系统保存。
这意味着几何图可以和题目、课程、用户及版本记录建立关系：
题目 ID ├─ 题干 ├─ 标准答案 ├─ 几何文件 JSON ├─ 创建者与审核状态 └─ 历史版本编辑器还会产生内容变化、画板切换、保存、AI 请求等事件，使宿主能把几何操作接入现有业务流程。
4. 自动化和 AI
SDK 提供 REPL 指令接口，可以用程序定义对象、设置样式、管理画板和创建交互动画。
编辑模式还可以显示 AI 对话面板。用户用自然语言提出作图或改图要求，宿主后端负责业务鉴权和额度校验，再把流式结果交给内嵌编辑器处理。
于是“AI 生成”和“人工编辑”不再是两套割裂工具：AI 先完成基础图，用户在同一个画板里检查、调整、保存和导出。
二、为什么不是直接放一张图片？
静态图片适合最终分发，却无法承担完整教学交互。
例如讲解圆周角时，老师需要拖动圆上的点，让学生观察角度变化；讲解函数参数时，需要调整滑块并查看曲线变化；学生做作图题时，还需要提交自己的构造过程。
图片只能记录某一瞬间，交互式几何内容则记录对象之间的关系。因此二者不是替代关系：SDK 用于互动和编辑，PNG、SVG 或 TikZ 用于最终输出。
三、SDK、iframe、HTTP API 和 MCP 有什么区别？
| 方式 | 主要使用者 | 解决的问题 |
|---|---|---|
| 手写 iframe | 前端开发者 | 嵌入一个现成网页，但通信、状态和版本兼容通常要自己处理 |
| 几何 SDK | Web 产品团队 | 在自己的产品中加入可控、可编辑、可保存的几何界面 |
| HTTP API | 后端与批处理系统 | 服务端生成或渲染几何内容，不要求用户看到画板 |
| MCP | AI Agent 与支持 MCP 的客户端 | 让 Agent 把几何工具作为外部能力调用 |
如果核心诉求是“用户留在我的产品页面里操作几何”，SDK 通常是最匹配的入口。
四、哪些产品最需要几何画板 SDK？
在线题库
把静态题图升级为可拖动的动态图；或者在作图题中给学生提供编辑器，并保存学生提交的结构化内容。
教案与课件系统
老师可以直接在编辑流程中创建多页几何内容，不必在外部工具画好再截图上传。演示时又可以切换到轻量模式。
AI 助教
语言模型负责理解题目和用户意图，内嵌几何画板承载真正的构造、展示和修改，用户能检查 AI 结果而不是只接收一张不可编辑图片。
数学内容生产后台
AI 批量生成基础图，编辑人员校对，审核人员查看结构，最终导出多种格式。几何内容从一次性配图变成可复用资产。
五、选型时应该问哪些问题？
不要只问“能不能嵌进去”，还应确认：
- 是否同时支持展示与编辑？
- 内容能否由宿主系统读取和保存？
- 是否支持多画板、撤销重做和 UI 定制？
- 能否用程序控制几何对象和样式？
- 能否导出 PNG、SVG 或 LaTeX/TikZ？
- AI 能力是否允许宿主做用户鉴权和额度控制？
- 组件卸载、事件取消订阅和错误处理是否明确？
- 数据协议和版本升级是否有文档？
这些问题决定 SDK 能不能进入真实生产系统，而不只是完成一次 Demo。
六、一个典型的接入架构
用户 ↓ 你的 Web 应用（题库 / 教案 / AI 助教） ↓ 创建与控制 大角几何 SDK（演示或编辑模式） ↕ 内容、保存、事件 你的业务后端与数据库 ↕ 可选：AI 请求转发 大角几何后端前端可以公开appId；服务端 token 必须留在后端。业务后端继续掌握账号权限、套餐额度、内容审核和数据归属。
常见问题
接入 SDK 后，内容是不是只能存在大角几何？
不是。编辑模式支持读取完整结构化内容，接入方可以将它存入自己的数据库。
SDK 能不能只展示，不让用户编辑？
可以。演示模式正是面向内容分发和展示的轻量入口。
SDK 能不能让 AI 直接改图？
可以通过 REPL 或编辑器 AI 对话能力实现。AI 对话需要宿主后端转发，不能把服务端密钥暴露在浏览器里。
结语
几何画板 SDK 不是一个孤立的绘图控件，而是一层可嵌入的数学交互基础设施。它的价值不止在于少写一些前端代码，更在于把几何展示、创作、数据、自动化和 AI 接入统一在同一套内容模型里。
如果你的产品已经出现“动态展示、用户改图、保存复用或 AI 作图”中的两项以上需求，就值得用一个最小 Demo 验证 SDK，而不是继续堆叠截图和临时页面。
下一步：访问 大角几何 SDK 文档中心，根据场景选择演示模式或编辑模式。