前言¶

在 DSH（DeepSeek Harness）里做学习或辅导类智能体时，常见做法是：把试卷 PDF 丢进会话，让模型逐题讲解。卷面上其实已经标好的错题、划改和页边演算，往往散落在对话里，难以按知识点回头复习，也不方便导出成可打印的合集。

下面介绍社区插件 AI 错题本（suanmingxing/dsh-ai-mistake-book）。它的定位不是「AI 帮你解题」，而是把扫描卷面上已经存在的内容，整理成以知识点为索引、可手改、可进版本库的错题卡片，并在你确认后再归档到本地目录。

这是什么¶

• 名称：AI 错题本（npm 包名 ai-mistake-book，当前版本 0.2.1）
• 维护者：suanmingxing
• 分类：记忆（DSH 社区目录）
• 仓库：github.com/suanmingxing/dsh-ai-mistake-book
• 目录页：skillhub.cn 插件页

插件把「投喂 PDF/图片 → 光栅化读卷 → 按题号提取错题 → 生成卡片草稿 → 人工确认归档」串成一条本地流水线；归档结果在 archiveRoot 下，索引自动重建，不依赖第三方错题云服务。

核心功能¶

从扫描件到结构化卡片¶

1. 扫描件直读：PDF 自动光栅化（默认 400 dpi），生成整页概览与高清横带；看不清时可按需索取原生分辨率重切。
2. 按题号提取：你只报错题题号，模型提取题干、作答、划改、页边演算、卷面标注、知识点、错因、难度等字段。
3. 绝不编造：读不准的内容写入「待人工确认」，由人核对，而不是猜测补全。
4. 卡片即 Markdown：归档路径为 library/<学科>/<卷子>/cards/*.md，带 front-matter，可手改、可 diff、可纳入 Git。

索引、导出与回收¶

• 知识点索引：自动重建 index.md / index.json，按学科 → 一级 → 二级知识点归类。
• 导出打印版 PDF：板块（含自定义板块）可勾选、可排序；公式以 Word 原生公式（OMML）排版，而非 Unicode 拼凑。
• 回收站：删除先进 _trash/，可逐项还原，清空才真正销毁。
• 会话可追溯：待归档页可跳回分析会话继续修改。

界面与 Prompt¶

插件提供「已归档 · 浏览」（左栏知识点树 + 右栏卡片，可对照原卷裁剪图）、「已归档 · 管理」（导出 PDF、删除、回收站）、「设置」（Prompt 与 PDF 模板）、「待归档」（核对候选后确认归档）。

设置页按模型实际接收顺序展示：分析任务书、难度与学段背景、错因分类、系统自动追加说明，以及统一的 PDF 导出模板列表（预设 + 自定义板块，可拖动顺序、勾选、编辑说明）。改完后需点「保存全部修改」；分析新试卷时生效。

分析期间可将当前会话工具临时收窄到读页面、提交候选、提交决定、问用户确认（默认 restrictAnalysisTools: true），结束后自动恢复。

环境要求¶

• DSH 桌面版，Web / 桌面 profile 均可；要求 DSH >= 0.2.1-rc.2。
• 分析模型须支持图片输入；插件启动前会校验，不支持会直接报错。
• Node.js ≥ 22（DSH 自带运行时已满足）。

安装与启用¶

目前仅通过 GitHub 分发（npm 包尚未发布）。安装命令以 README 为准：

dsh plugin --profile desktop add github:suanmingxing/dsh-ai-mistake-book

把 desktop 换成你实际使用的 profile（桌面版通常为 desktop，dsh web 用 web）。装完后重启 DeepSeek Harness 生效。

开发调试可用 link: 指向本地克隆目录；该方式下 pnpm 不会自动安装插件 dependencies，仓库已将必要依赖放在提交的 node_modules/ 中（见 VENDOR.md）。

DSH 社区目录（如 skillhub.cn）是独立站点，与 DeepSeek / 幻方无官方从属关系；安装插件前建议自行查看仓库源码与 MIT 许可证。插件以当前 DSH 进程权限运行，可读写你配置的 archiveRoot。

典型用法¶

首次配置¶

1. 在 DSH「设置 → 插件 → AI 错题本」中设置 archiveRoot（默认 ~/.dsh/ai-mistake-book），填写存放错题本的绝对路径；修改后需重启插件。
2. 在 DSH 里将归档根目录作为工作区打开（首次执行 /mistake 会自动创建）。

投喂试卷并归档¶

在会话中指定错题题号与扫描文件路径，例如：

/mistake 错题为 3、5、6、8、9、11 题  @"C:\path\to\扫描卷.pdf"

也可在插件页通过模型工具 mistake_ingest 指定文件路径。分析在当前会话中进行；完成后到插件页「待归档」核对候选并确认归档。正式归档必须在插件页确认，之后可在「已归档 → 管理」导出 PDF 或删除卡片。

可选：在「设置 → AI 错题本」的 Prompt 配置中调整分析任务书、背景、错因分类，以及在 PDF 导出模板中调整板块顺序、勾选或新增自定义板块。

归档目录结构¶

<archiveRoot>/
├─ inbox/<batchId>/     进行中的批次（原始扫描、光栅图）
├─ library/<学科>/<卷子>/cards/*.md   归档后的错题卡片
├─ templates/           可编辑的提示词
├─ exports/             导出的 PDF
├─ export-settings.json PDF 导出模板配置
├─ _trash/              回收站
└─ index.md / index.json  自动生成的索引

主要设置项（节选）¶

完整说明见仓库 README。

数据与隐私¶

试卷、转录、卡片、导出件均保存在本机 archiveRoot 下；插件不向第三方服务上传内容。模型调用走你在 DSH 中配置的 provider，与日常会话同一链路。

适用场景与注意¶

适合：已有扫描卷/PDF，希望按知识点建本地错题库、需要 Markdown 可编辑与 PDF 打印导出、愿意在「待归档」环节人工核对字段的学习者或辅导场景。

注意：

• 公式排版覆盖常见写法；矩阵、分段函数等结构暂不支持，会退化为可读文本。
• 分析依赖模型视觉能力；界面文案有中/英字典，提示词模板默认中文。
• 已知限制与更新见仓库 CHANGELOG.md。

结尾¶

AI 错题本把 DSH 的会话能力与本地文件归档结合起来：扫描卷 → 按题提取 → 确认后写入 library/ 并重建索引，适合需要「可复习结构」而非「自动解题」的场景。

• 社区目录：https://www.skillhub.cn/plugins/suanmingxing/dsh-ai-mistake-book
• 源码与文档：https://github.com/suanmingxing/dsh-ai-mistake-book