dsh-kaogong

DeepSeek Harness 插件：用自然语言记录公务员考试备考的学习时长和错题。数据存在本机 SQLite，路径是绝对路径，不跟当前工作区走。

安装

需要 Node 24+（使用内置 node:sqlite）。

dsh plugin --profile web add ./kaogong

若从本仓库根目录安装，路径改成插件目录的绝对或相对路径。

默认库路径

~/.dsh/kaogong/kaogong.sqlite

可以在设置页里把 dbPath 改成任意绝对路径(支持 ~)。

「今天」按本机本地日历日计算,没有时区设置。更换 dbPath 不会把旧库数据迁到新路径。

设置

Host 注册 settings namespace kaogong，Client 在「设置 → 插件配置」挂同名卡片。可改：

• 数据库绝对路径（可用 ~）
• 七个内置模块的中文名和别名（id 不可改、不可删）
• 自定义模块（id 需匹配 ^[a-z][a-z0-9_]*$）

部分 DSH 版本可能用白名单挡住第三方设置卡片。卡片不出现时，直接改 ~/.dsh/settings.yaml 仍然有效：

kaogong:
  dbPath: /Users/you/.dsh/kaogong/kaogong.sqlite
  modules:
    - id: politics
      name: 政治理论
      aliases: [政治, 马原, 毛中特]
    - id: gongan
      name: 公安专业科目
      aliases: [公安, 执法资格]

modules 必须包含内置七个 id：politics common verbal reasoning quant data essay。小题型俗称（例如「图形推理」）是某个大模块的别名，不会单独存进数据库。

工具

模型应先调用 kaogong_list_modules 再映射用户说法。其余工具：kaogong_start、kaogong_end、kaogong_log、kaogong_add_wrong、kaogong_today、kaogong_wrongs。

客户端打包

Web 设置卡片必须是 DSH 的 lazy-CJS 工厂（window.__ModuleLoader__.load），不是 ESM 源码。改 src/client/ 后重新打包并重启 DSH：

cd kaogong && npm run build:client

产物是 lib/client.js。

测试

node --experimental-strip-types --test test/*.test.ts

本地默认 Node 若低于 24，请用 Node 24 运行。

发布

先递增版本号，再发布：

npm version patch   # 0.1.0 -> 0.1.1，自动改 package.json 并打 git tag
npm run release     # npm publish --access public

版本递增对应关系：

命令	变化	场景
npm version patch	0.1.0 → 0.1.1	修 bug
npm version minor	0.1.0 → 0.2.0	加功能
npm version major	0.1.0 → 1.0.0	破坏性改动
npm version 1.2.3	→ 1.2.3	指定具体版本

注意：

• npm version 会自动 git commit 并打 tag，要求工作区干净，先提交或 stash 未提交的改动。
• 不想动 git 时加 --no-git-tag-version。
• 打完 tag 用 git push --follow-tags 把 tag 一起推上去。