📚 稼云AI · 教辅工坊 全功能使用手册

🚀1. 快速入门（5 分钟上手）

系统全景

三步上手

工作台面板导航

📖2. 教材库管理

上传教材

AI 分析结果

分析完成后可查看：

教材联动组卷

选择教材后组卷，系统自动读取 AI 分析的单元列表：

• 第 1 单元 → 填空题 + 选择题（基础）
• 第 2 单元 → 计算题（中等）
• 第 3 单元 → 应用题（中等）
• 最后单元 → 应用题（较难）

总分精确 100 分，多单元覆盖，与教学进度联动。

OCR 拍照识别

支持拍照批量识别教材页面（多图），自动提取文字并合并。需在后台配置腾讯云 OCR（ocr_provider=tencent + SecretId/SecretKey/Region）。未配置时也可手动粘贴目录文字。

图片转 PDF

教材照片一键合成可打印 PDF（每图一页、自动居中缩放、支持 JPG/PNG/GIF/WebP）。

图片格式转换

JPG/PNG/WebP/GIF/BMP 互转；透明图转 JPG/BMP 自动铺白底。支持批量转换、质量调节、缩放/拉伸/裁剪三种模式。

🧩3. 智能组卷

核心能力

方式一：模板组卷（推荐新手）

内置模板（4 套）

方式二：细目表自定义组卷

在「细目表 JSON」输入框中填写自定义结构：

[
  {"type":"填空题", "count":8, "per":4, "difficulty":"normal", "unit":"第1单元 小数乘法"},
  {"type":"选择题", "count":5, "per":5, "difficulty":"normal", "unit":"第2单元 位置"},
  {"type":"计算题", "count":4, "per":6, "difficulty":"normal", "unit":"第3单元 小数除法"},
  {"type":"应用题", "count":3, "per":9, "difficulty":"hard", "unit":"第5单元 简易方程"}
]

支持的题型：口算题 填空题 选择题 判断题 计算题 应用题

难度等级：easy(基础) / normal(中等) / hard(较难)

方式三：整卷同类生成

在「我的试卷」列表中，每份试卷旁有「♻️ 同类卷」按钮。点击后系统读取该卷的细目表结构，换一批新题生成一套同构不同题的平行卷。

试卷包含内容

难度分布分析

每次组卷完成后自动返回细目表分析：

同时返回单元覆盖率：每个单元被覆盖了多少题目。对标学科网细目表分析。

出题引擎

批量组卷

📋4. 模板库管理

内置模板 vs 自定义模板

创建自定义模板

组卷预览

调用 POST /api/apps/jiayun-ai/panel/examPreview 传入 template_key 或 sections，返回题型结构和总分。不消耗 LLM 和积分，用于前端预览确认。

📤5. 答题卡与导出

答题卡页

每份试卷 PDF 自动附带答题卡页，包含：

• 班级/姓名/得分填写栏
• 按题型分节的题号网格（每行 5 题）
• 计算题/应用题解答区（5 行横线）

导出格式

批量导出 ZIP

调用 POST examBatchExport 传入试卷 ID 数组，系统将多份 PDF 打包为 ZIP 返回下载链接。最多 20 份/次。

📤6. PPTX 课件导出

功能说明

将教案/课件类 AI 生成内容导出为可在 PowerPoint / WPS 中编辑的 .pptx 文件。不依赖任何第三方库，纯 OOXML 打包。

操作步骤

PPTX 包含

• 封面页：大标题（44pt 居中）+ 副标题（日期 · 稼云AI · 教辅工坊）+ 底部装饰条
• 内容页：按生成内容的大纲结构自动分页，每页含标题（32pt 加粗）+ 要点列表（18pt 圆点符号）

兼容性

标准 OOXML 格式，兼容 Microsoft PowerPoint 2016+ / WPS Office / Google Slides / Keynote。

📦7. 资料包生产

品类模板

生成流程

教学进度同步

如果已设置教学进度，资料包自动以「当前正在学的单元」为出题焦点，商品文案自动标注同步进度。

质量检测

可选开启 AI 质量检测：结构自检（字体引用/PDF合法性）+ 大模型内容抽检，防止 PDF 乱码。

双版本交付

练习册支持教师版（含答案解析）和学生版（无答案）分别导出 PDF，学生版生成不额外消耗积分。

🛒8. 变现小店

上架商品

商品管理

买家购买流程

分销体系

佣金在支付成功后自动结算到邀请人余额（uk_order 幂等，不会重复结算）。

优惠券

• 满减券：设置满减金额和使用门槛
• 复购专享：仅已购买账号可用
• 配合老带新促进转化

评价体系

买家评价自动邀请（短信/站内提醒）+ 评价送积分 + 评价晒图额外奖励 + 卖家回复。

在线客服

可配置微信二维码/电话/客服须知，前台小店右下角显示在线客服悬浮按钮。

经营看板

📕9. 红书发布

发布流程

赛道矩阵

版权预检

发布前强制执行：AI 评分原创度 + 违禁词检测（红线级直接拦截）+ 配图水印风险 + 赛道专属词库检查。

合规门槛

自动发货

三种发货方式：① 自有小店下载（推荐，零手续费）② 小红书服务市场「极速自动发货」③ 第三方工具（如阿奇索 138 元/年）。

📦10. 批量管理

批量组卷

批量删除试卷

调用 POST examBatchDelete 传入 ID 数组，最多 50 份/次。

批量商品上下架

调用 POST productBatchStatus 传入 ID 数组和 status（1=上架 0=下架），最多 50 件/次。

批量导出 ZIP

调用 POST examBatchExport 传入试卷 ID 数组，系统打包多份 PDF 返回下载链接。最多 20 份/次。

批量导出收入 CSV

在「📈 经营看板」中点击导出按钮，按订单导出收入 CSV（含买家脱敏手机号）。

📊11. 教学进度

班级管理

进度记录

进度CSV导出

在进度看板中点击导出，按班级导出学生进度 CSV。

教学日历

系统按当前日期自动识别教学时效节点（开学/期中/期末/寒暑假），推荐爆款品类与关键词。即将到来的节点会提前提醒。

🎓12. 学习乐园

功能列表

错题本

速算闯关自动记录错题（题面+正确答案），在成长曲线页面查看错题列表。掌握度分析基于错题数据计算薄弱知识点。

合觧提示

🎨13. 电商宝

五大子模块

生成七要素

选择 Skill → 平台（多选）→ 语言（多选）→ 风格 → 比例 → 分辨率 → 张数。系统自动计算积分消耗（实时预览）。

积分计费

会员体系

积分卡：100 积分¥9.9 / 1000 积分¥79.9 / 10000 积分¥699。支持卡密兑换。

📊14. 掌握度分析

计算公式

等级划分

精准练推荐

掌握度 < 70% 的科目自动生成推荐：每日一练 + 错题重练。最多推荐 3 科。

API

GET /api/apps/jiayun-ai/study/masteryOverview?grade=五年级
Authorization: Bearer <user_token>

响应：{
  subjects: [{subject, quiz_count, accuracy, accuracy_7d, wrong_count, mastery, level, trend}],
  weak: [{subject, mastery, wrong_count}],
  recommend: [{subject, action, advice}],
  total_wrong: N
}

❓15. 帮助与支持

常见问题

Q: 组卷时 LLM 不可用怎么办？

A: 系统自动回退到本地题库兜底，确保 100% 有题。本地题库按年级×题型×难度随机生成真实完整题目，含答案。

Q: 教材分析失败怎么办？

A: 检查文件格式是否支持（PDF/DOCX/TXT），文件是否损坏。如 AI 分析超时，可重试或直接手动粘贴目录文字。

Q: PPTX 打开乱码怎么办？

A: 确认使用 PowerPoint 2016+ 或 WPS Office 最新版。生成内容如含特殊字符可能影响排版，建议先在生成结果中预览确认。

Q: 支付后下载不了？

A: 支付成功后系统自动解锁下载链接。如未解锁，请在「已购订单」中刷新页面或联系客服。

Q: 如何提高组卷质量？

A: ①确保教材已完成 AI 分析（有单元和知识点）②选择合适的模板 ③在细目表中指定具体的单元和难度 ④配置 LLM API Key 以启用 AI 出题。

Q: 如何批量生成试卷？

A: 在「🧩 智能组卷」中点击「📦 批量组卷（多教材）」按钮，系统自动为所有教材逐本生成。限流 3 次/5 分钟。

Q: 试卷上的水印能去掉吗？

A: 防伪水印是版权保护措施，不可去掉。水印内容为「租户名 版权所有 请勿传播 日期」。

联系方式

如遇问题请联系在线客服（小店右下角悬浮按钮）或查看平台帮助文档。

🗓️16. 迭代计划

Phase 1（1-2 周）：运营启动

Phase 2（2-4 周）：功能深化

Phase 3（1-2 月）：生态扩展