dsh-kaogong

dsh-kaogong — 考公备考整合插件（DSH 宿主原生面板）· v1.13.1

> 一句话：把 16 个优秀开源考公仓库整合为 [DeepSeek Harness](https://github.com/deepseek-ai)（DSH）宿主内的原生学习平台 ——

> 刷题 / SRS 错题本 / 真题卷 / 整卷模考 / 申论评改 / 花生十三体系方法论 / 可交互知识图谱 / 白盒可观测，完全离线可用。

> ⚠️ 安装前必读（一句话版）：本插件是整合与可视化层，npm 包不含任何题库与方法论语料。

> 装好插件后，打开「📦 题库管理」→ 一键安装必选包（huasheng13 + xingcezhenti + gk-tuxing），核心功能即刻可用。

> 题库管理依赖 git（浅克隆/更新），请先确认宿主机可执行 git --version。

---

📑 目录

• [🚀 快速开始（3 步）](#-快速开始3-步)
• [✅ 前置条件](#-前置条件)
• [📦 安装](#-安装)
• [方式一：npm（推荐）](#方式一npm推荐)
• [方式二：GitHub 源码](#方式二github-源码)
• [方式三：插件市场](#方式三插件市场)
• [🗂 首次使用：安装题库数据](#-首次使用安装题库数据)
• [🔧 升级 / 卸载 / 自检](#-升级--卸载--自检)
• [✨ 核心特性](#-核心特性)
• [📖 花生十三体系方法论](#-花生十三体系方法论)
• [🗂 数据根与题库管理](#-数据根与题库管理)
• [🏗 架构](#-架构)
• [❓ 故障排查（FAQ）](#-故障排查faq)
• [🙏 致敬上游](#-致敬上游全部数据与成果归原作者)
• [🧪 开发与验证](#-开发与验证)
• [⚖️ 许可与免责](#-许可与免责)

---

🚀 快速开始（3 步）

# 1) 装插件（在 DSH 会话/控制台）
#    npm 用户：文档见下方「安装」；源码用户：
#    plugin_manager install_bundle <克隆目录>/dsh-kaogong

# 2) 刷新 GUI → 点左栏「📚 考公学习」→ 进入「📦 题库管理」

# 3) 点「🚀 一键安装必选包」→ 完成后即可刷题 / 查方法论

国内网络建议先在「题库管理 → 镜像代理」填 https://gh-proxy.com/ 再安装，克隆速度显著提升。

✅ 前置条件

| 项 | 要求 | 说明 |

|---|---|---|

| Node.js | ≥ 22.19 | 与 DSH 宿主一致；深度题库用到内置 node:sqlite |

| DSH 宿主 | >=0.2.0-rc.2 <0.2.1-0 \|\| >=0.2.1-rc.0 <0.3.0-0 \|\| >=0.3.0-rc.0 <0.4.0-0 | package.json 的 peerDependencies / engines.dsh 已声明（兼容闸门可校验） |

| git | 任意近期版本 | 题库管理靠 git 浅克隆下载数据（repoManager.ts 的 spawn('git', …, { windowsHide: true })）；无 git 时安装会受控报错而不会崩宿主 |

| 磁盘 | 必选约 360MB，全量约 2.2GB | 按需分层安装，可选包不必一次拉全 |

| 网络 | 首次装数据需可访问 GitHub | 国内建议配镜像代理 |

📦 安装

方式一：npm（推荐）

# 在 DSH profile 中作为 bundle 引入（版本以 npm 最新为准：1.13.1）
npm install dsh-kaogong

# 或用 DSH 自带插件命令（把 npm 包装进当前 profile）
npx @deepseek-ai/dsh plugin add dsh-kaogong

npm 包内已包含 cordis.patch.yml（bundle 声明 dsh.bundle.patch 指向它）与 data/study-plan.md（学习计划模板），

装完即注册双入口，无需额外构建。

> 📌 自 v1.13.1 起修复：1.11.0 / 1.12.0 / 1.13.0 的 npm tarball 缺失 cordis.patch.yml（files 白名单漏列），

> 导致按 npm 安装的 bundle 缺 patch。现已在白名单补入，并由 smoke 的 R28 断言实测守卫（npm pack --dry-run 校验）。

方式二：GitHub 源码

git clone https://github.com/xuanyuanchumo/dsh-kaogong.git

然后在 DSH 内：

plugin_manager install_bundle <克隆目录>/dsh-kaogong

源码安装会由 prepare 脚本自动构建（tsc → scripts/bundle-client.mjs 合并为宿主单文件 combo），

因此需要能安装 devDependencies（TypeScript）。若构建失败，先在该目录执行 npm install && npm run build。

方式三：插件市场

本插件已收录于 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)（category: tools），

可在支持该索引的插件市场/面板中搜索 dsh-kaogong 安装。

🗂 首次使用：安装题库数据

1. 打开左栏「📚 考公学习」→ 📦 题库管理

2. （国内网络）在「镜像代理」填 https://gh-proxy.com/ 并保存

3. 点「🚀 一键安装必选包」，或逐项安装：

| 级 | 仓库 | 体积 | 装完可用的功能 |