前言¶

DSH 的理念之一是“一切皆插件”，很多长流程可以拆成可安装、可回退、可抽查的工作流。对老师或课程整理者来说，一个常见问题是：手里已经有一批教材 PDF，想把它变成可继续加工、可审校、可下载的教学蓝本，但中间要处理材料解析、知识梳理、章节设计、初稿审校等多个环节。

dsh-craft-your-textbook 是 DeepSeek Harness（dsh）的一个插件包，目标是把教材 PDF 加工成「AI 教学蓝本」的 6 阶段流水线。下面介绍它是什么、能做什么、怎么安装，以及典型使用步骤。

这是什么¶

• 插件名称：xx-hub/dsh-craft-your-textbook。
• 维护者线索：xx-hub。
• 定位：把教材 PDF 加工成「AI 教学蓝本」的 6 阶段流水线，是 dsh 的一个插件包。
• 许可证：MIT。
• 使用入口：安装后，在 dsh 的网页界面（web profile）中启用“造书模式”。

核心功能¶

这个插件把教材处理流程拆成几个可暂停、可拍板、可回退的节点。资料称，它全程中文，且不需要任何技术知识。

1. 上传教材 PDF
   支持学生用书、教师用书、考纲、讲义、真题等材料，一次可多选。

2. AI 探查材料
   AI 探查上传材料，并生成源材料索引、知识地图、重点难点和章节安排。

3. 关键方案拍板
   学习目标与方法、章节架构等关键方案会做成拍板关卡。资料称，拍板前流程不会继续往下走。

4. 生成最佳范例章
   先生成一章作为全书样板，支持逐行写意见、与旧稿对比，并支持按章节列出字数清单。

5. 铺章
   其余章节由小助手执笔、小助手审计、主 AI 终审，并支持逐章预览和写意见。

6. 全章过目
   全部章节写完后，会停在「全章过目」卡上，让用户逐章查看；全部满意后，才进入最后检查。

7. 定点修改、催办和回退
   - 支持定点修改已经拍板的历史决定，并提示下游影响；资料称 10 分钟内可一键撤销。
   - 支持催办或戳一下 AI，用于提醒未落账或停下的任务。
   - 支持回退到上一个拍板点；资料称旧版本只读保留。

8. 演示流程
   提供「先建一本演示书试试」的演示流程；资料称该演示流程不花模型额度。

9. 交付结果
   最后检查通过后，交付《书名》.md，并附「这本书怎么用」说明和风格意见落实清单。

安装与启用¶

先确认环境：需要先装好 DeepSeek Harness（dsh），并能打开网页界面（web profile）。

然后运行 README 推荐安装命令：

npx dsh-craft-your-textbook

首次使用前，还需要配置两件事：

1. 配置大模型接口
   资料称，任何兼容 OpenAI 的接口均可，例如 DeepSeek 官方 key。

2. 配置 MinerU Token
   MinerU Token 用于 PDF 转换。

配置完成后，点「我配好了，继续」。

随后打开插件入口：

1. 重启 dsh。
2. 在浏览器打开 http://127.0.0.1:3080。
3. 新建会话。
4. 在模式里选择「造书模式」。
5. 进入工作台，开始新建书。

典型用法¶

下面是一条可按步骤复现的使用路径。

1、安装插件

npx dsh-craft-your-textbook

2、打开工作台

重启 dsh 后，浏览器打开：

http://127.0.0.1:3080

然后新建会话，并在模式里选择「造书模式」。

3、新建书并上传材料

在工作台点「＋ 新建书」，填写书名和目标。

接着上传教材 PDF，并为每份材料标记角色，例如学生用书、教师用书、考纲、讲义、真题。

完成后点「开始转换」。

4、查看探查结果

工作台会出现「探查结果」卡。

如果满意，点「满意，继续设计」。

如果不满意，点「让 AI 重做」。

5、处理范例章

对生成的最佳范例章，可以逐行写意见，也可以点「和第 N 稿对比」查看修改内容。

如果满意，点「满意，继续写全书」。

6、铺章阶段抽查

铺章时，可以点「看看这章」预览某一章。

如果认为需要调整，点「写意见」，要求 AI 修改并重新自查。

7、全章过目

全书写完后，会进入「全章过目」卡。

逐章查看后，如果全部满意，点「都过了，交工」，进入最后检查。

8、下载成品

最后检查通过后，点「下载《书名》.md」。

同时查看「你的风格线条条有着落」清单，确认风格意见在成品中的落实情况。

9、先配置再使用

如果是首次使用，先配置大模型接口和 MinerU Token，然后点「我配好了，继续」。

适用场景与注意¶

适合谁：

• 需要把已有教材 PDF 整理成可加工、可审校、可下载 Markdown 的教学蓝本的人。
• 希望在关键方案上保留拍板权，而不是让 AI 一次性跑完全程的人。
• 希望全程使用中文界面，并在资料称不需要技术知识的前提下尝试 dsh 插件流程的人。

需要注意：

• 造出来的内容属于教学参考，AI 可能讲错，需老师或家长复核后再使用。
• 书项目数据保存在当前会话工作区目录；工作区不可用或老书可能位于 ~/.dsh/textbook/projects/。
• 卸载会移除插件并删除 ~/.dsh/.agent-presets/textbook，但书项目数据保留在 ~/.dsh/textbook/projects。
• README 提到，可以在对话里告诉向导一个预算上限；超过时会先暂停询问。
• 插件以当前 dsh 进程权限运行。安装前建议检查源码与许可证；本包许可证为 MIT。
• 这里的目录页只是插件线索，不应理解成官方应用商店；DSH 社区目录是独立站点。

链接¶

• GitHub：https://github.com/xx-hub/dsh-craft-your-textbook
• 目录页线索：https://www.skillhub.cn/plugins/xx-hub/dsh-craft-your-textbook
  该链接来自插件线索，未能从本次已抓取资料中独立核实。