cscs-dsh-plugin · 《NSCA-CSCS认证指南（第4版）》学习插件（DeepSeek Harness 版）

本包是 OpenCode 版插件 的 DeepSeek Harness（dsh）适配版： 一条命令安装后，AI 助手掌握全书章节结构，并能按书页码现场 OCR 调取原文 （答题标注出处、备考出题、关键数字核对）。

✅ 实测版本：dsh 0.2.0-rc.2 与 0.2.1-rc.2（桌面版与 CLI 同内核）。rc 版本间可能存在破坏性变更， 升级 dsh 后如遇异常请核对最新对照说明。

📦 v1.0.3 适配说明：自 1.0.3 起插件不再携带 @deepseek-ai/dsh-tools 副本， 仅保留 schemastery 一个纯库依赖。宿主桥接的最终形状由插件直接提供， 避免多模块实例下调度器 Symbol 对不上号（工具调用报 Cannot read properties of undefined (reading 'prepare') 的根因）。 1.0.2 及更早版本在 dsh 0.2.1-rc.2 桌面端会触发该问题，请升级。

⚠️ 版权说明：本插件不包含、不分发教材本身（版权归 NSCA 及中文版出版方）。 插件只分发：章节索引、要点笔记、OCR 调取工具。每位使用者需自行准备 自己合法获得的书 PDF/扫描件，并在首次使用时配置路径。 请勿上传或分享书籍扫描件与批量 OCR 文本。

关联声明：本项目是社区学习工具，非 NSCA 官方产品，与 NSCA 及人民邮电出版社 无任何隶属、合作或授权关系；"NSCA-CSCS" 名称仅用于描述学习对象与兼容性。

注册的内容

| 组件 | 名称 | 作用 | |---|---|---| | 工具 | nsca_ocr_page | 按书页码 OCR 原文（缓存，约8秒/页；未配置路径时返回引导） | | 工具 | nsca_use_book | 配置并持久保存用户的书 PDF 路径 | | 技能资料 | skill/references/ | 章节索引（chapter-index.md）与要点笔记（key-concepts.md），工具会返回绝对路径供 AI 读取 |

环境要求

• dsh ≥ 0.2.0-rc.2（桌面版 App 或 CLI 均可，同一内核）
• Python 3 与 OCR 依赖：pip install -r skill/scripts/requirements.txt （pymupdf + rapidocr-onnxruntime + numpy）
• 自备教材 PDF（自己纸质书的扫描件，或购买电子书渠道所得的本地副本）

安装

方式一 · 桌面版 App（推荐）

npm 发布后，在桌面 App 的「插件」页搜索 cscs-dsh-plugin 安装，重启 App 生效。

方式二 · CLI 命令（web / tui / 自定义 profile）

dsh plugin --profile <profile名> add cscs-dsh-plugin

正常情况下安装器会读取包内的 dsh.bundle 声明自动挂载层； 若之后启动日志未出现 [cscs] 工具注册完成，请把 cscs-dsh-plugin 手动加入 <DSH_HOME>/profiles/<profile名>/package.json 的 dsh.profile.bundles 数组末尾，再启动一次。

注意：桌面 App 自用的 desktop profile 由 App 专属管理，请优先在 App 内操作。

方式三 · 手动挂载（不动 App 的 profile）

把本包文件夹放到任意位置，参照 cordis.yml 写一个覆盖层并通过 --patch 挂载（launcher 参数在 profile 名之前）：

dsh --profile web --patch "D:/某路径/cscs-plugin-dsh/cordis.yml" --no-open

cordis.yml 模板（路径改成自己的，必须绝对路径）：

- insert:
    - id: cscs
      name: 'D:/某路径/cscs-plugin-dsh/src/index.ts'
      config:
        pdf: 'D:/你的书/NSCA-CSCS---.pdf'

配置书 PDF（三位一体）

| 优先级 | 方式 | 说明 | |---|---|---| | 1 | 插件 config.pdf | bundle 层 / cordis.yml 里的 config | | 2 | 环境变量 NSCA_CSCS_PDF | 全局一次配置 | | 3 | nsca_use_book 工具 | 对话里把路径告诉 AI，它调用工具持久保存（存于 ~/.cscs-dsh-plugin/state.json） |

不配置也能聊：工具会返回引导，AI 改用包内章节索引与要点笔记继续辅导（见下文"关于教材"）。

验证

1. 启动后看日志两行：[cscs] 技能包就位 与 [cscs] 工具注册完成
2. 开个对话问：「调取教材第 473 页内容，给我讲讲」 —— 约 8 秒后回吐该页 OCR 文本；同一页重复问秒回（缓存）。

关于教材：没有书也能用吗？

• 有书（自己合法获得的纸质书扫描件或电子书本地副本）：配好路径后可逐页 OCR 调取原文、标页码答题、备考出题。
• 没书：插件照常安装。未配置路径时工具会说明情况，AI 会改用包内的章节索引 + 要点笔记继续辅导（不逐页调原文）。想要完整功能，请通过出版社、京东、当当等正版渠道购买纸质或电子书，用你自己拥有的副本配置路径。
• 本插件始终不提供书文件，不引导盗版渠道；也请勿分享扫描件与批量 OCR 文本。

与 OpenCode 版的关系

同一套技能内容（SKILL.md + references + OCR 脚本），两个宿主各自薄适配：

• OpenCode：opencode-cscs-plugin（npm / GitHub）
• DeepSeek Harness：本包 cscs-dsh-plugin 内容更新时两边同步推进。

许可

MIT；不改变原书版权归属。详见 LICENSE（含对原书版权的特别说明）。