dsh-algo-trainer

算法学习训练台 — DeepSeek Harness 插件。

将 icpc-workbench 的核心训练能力（刷题同步、弱项分析、今日推荐、训练计划、间隔复习、模板库、赛事中心、打卡）封装为 dsh agent 工具，让 AI agent 能直接帮选手完成训练全流程。

设计方案

不搬 Express/SQLite——用 dsh 原生服务重建数据层与适配层：

层	原项目	本插件
数据持久化	SQLite (node:sqlite)	JSON 文件（通过 dsh `fs` 服务落盘到 workspace 目录）
网络请求	Node `fetch`	dsh `web.fetch` / 全局 `fetch`
适配范围	CF + AtCoder + 洛谷 + 牛客	CF + AtCoder（洛谷/牛客需 Cookie/反爬，首版不支持）
Agent 接口	Express REST 路由	dsh `ctx.tools.register()`（10 个 `icpc_` 前缀工具）
前端	React SPA	dsh Slot UI 面板（紧凑仪表盘）
分析引擎	依赖 DB 的函数	纯函数（输入 `SubmissionRow[]`，无 IO 依赖）

目录结构

▼
text
复制代码
dsh-algo-trainer/
├── package.json              # dsh 插件包定义（dsh.bundle + dsh.client）
├── tsconfig.json             # host 侧 tsconfig
├── tsconfig.client.json      # client 侧 tsconfig
├── cordis.patch.yml          # dsh 配置补丁行
├── README.md
├── src/                      # Host 半边
│   ├── index.ts              # 插件入口：apply(ctx, config) — store 初始化 + 工具/RPC 注册
│   ├── dsh-compat.ts         # dsh 类型兼容层（Context / ToolDefinition / FsService / RpcService / Config）
│   ├── types.ts              # 跨模块共享类型（PlatformId / Verdict / WeaknessProfile / TodayPlan / ...）
│   ├── store/
│   │   ├── schema.ts         # JSON 数据模型（ProblemRecord / SubmissionRecord / PlanRecord / ...）
│   │   └── index.ts          # IcpcStore 类：内存索引 + 防抖落盘（替代 SQLite）
│   ├── adapters/
│   │   ├── types.ts          # PlatformAdapter / ContestAdapter 接口
│   │   ├── codeforces.ts     # CF 适配器（user.status + contest.list，knownExternalIds 增量终止）
│   │   └── atcoder.ts        # AtCoder 适配器（kenkoooo API，from_second 增量，内存缓存题目资源）
│   ├── analysis/             # 纯函数分析引擎（无 DB 依赖）
│   │   ├── stats.ts          # 总体统计（attempts/AC/AC率/各平台/各难度/各标签）
│   │   ├── weakness.ts       # 弱项画像（标签/难度 gap 打分）
│   │   ├── trend.ts          # 12 周趋势（ISO 周键，空周补 0）
│   │   ├── tags.ts           # 标签净化（过滤赛事/年份/地区等噪声标签）
│   │   └── today.ts          # 今日三档选题（能力值估算 + 弱项优先 + rotate 换一批）
│   ├── reviews/
│   │   └── schedule.ts       # 间隔复习调度（1/3/7/14/30/60 天阶梯，hard/ok/easy 调档）
│   ├── plans/
│   │   └── planService.ts    # 训练计划服务（AI 生成 + 模板降级 + JSON 解析容错）
│   ├── templates/
│   │   ├── curriculum.ts     # 114 课算法模板大纲（数据文件）
│   │   └── progress.ts       # 学习进度管理（todo/learning/mastered + 下一课推荐）
│   ├── tools/                # 10 个 agent 工具
│   │   ├── helpers.ts        # textOutput / num / str 辅助
│   │   ├── sync.ts           # icpc_sync — 同步刷题记录
│   │   ├── stats.ts          # icpc_stats — 统计分析
│   │   ├── today.ts          # icpc_today — 今日三档训练
│   │   ├── plans.ts          # icpc_generate_plan + icpc_manage_plan
│   │   ├── reviews.ts        # icpc_review — 间隔复习库
│   │   ├── templates.ts      # icpc_templates — 模板库
│   │   ├── contests.ts       # icpc_contests — 赛事中心
│   │   ├── checkins.ts       # icpc_checkin — 日历打卡
│   │   ├── settings.ts       # icpc_settings — 设置
│   │   └── import.ts         # icpc_import — 手动导入
│   └── rpc/
│       └── index.ts          # Host RPC bridge（icpc.dashboard / icpc.trend / icpc.contests）
├── client/
│   └── index.ts              # Client 半边：紧凑仪表盘面板（Slot UI + 文本渲染降级）
└── tests/
    └── analysis.test.ts      # 24 个纯函数测试

安装

▼
bash
复制代码
# 在 dsh profile 中添加
dsh plugin --profile web add dsh-algo-trainer

# 或从源码
cd dsh-algo-trainer
npm install

配置

▼
yaml
复制代码
# cordis.patch.yml
- insert:
    - id: algo-trainer
      name: 'dsh-algo-trainer'
      config:
        dataDir: ''           # 数据目录，留空则用 workspace/.icpc-data/
        ai:
          enabled: false
          baseURL: 'https://api.deepseek.com/v1'
          apiKey: ''
          model: 'deepseek-chat'

AI 配置也可运行时通过 icpc_settings 工具修改（持久化到 JSON）。

Agent 工具

工具	功能
`icpc_sync`	同步 CF/AtCoder 提交记录（增量，支持 all 批量）
`icpc_stats`	统计分析：overall / weakness / trend
`icpc_today`	今日三档训练推荐（巩固/同段/挑战，弱项优先）
`icpc_generate_plan`	AI 生成训练计划（无 key 降级模板）
`icpc_manage_plan`	计划管理：list/detail/checkin/uncheck/delete/import
`icpc_review`	间隔复习库：list/add/feedback/remove
`icpc_templates`	114 课模板库：browse/next/set_status
`icpc_contests`	多平台赛事（CF+AtCoder 聚合）
`icpc_checkin`	日历打卡：streak/month/date/checkin/uncheck
`icpc_settings`	设置：get/set_account/set_ai
`icpc_import`	手动导入刷题记录（JSON）

Client 面板

紧凑仪表盘面板通过 rpc.call('icpc.dashboard') 拉取一次聚合数据，展示：

总体统计（提交/AC/AC率/解题数）
能力值 + 连续打卡 + 到期复习
今日三档训练推荐题单
弱项 Top5
今日任务清单与打卡状态

测试

▼
bash
复制代码
npx tsx --test tests/**/*.test.ts

24 个测试覆盖全部纯函数：难度分桶、AC 率计算、总体统计、弱项画像、趋势周键、标签净化、能力值估算、三档选题、间隔复习调度、计划 JSON 解析容错。

dsh 插件契约

name: 'dsh-algo-trainer'
inject: ['tools', 'fs', 'rpc'] — 等待三个 dsh 服务就绪后挂载
apply(ctx, config): 加载 JSON 存储 → 初始化 CF/AtCoder 适配器 → 注册 10 个工具 + 3 个 RPC 方法 → ctx.effect() 注册 dispose 落盘
Config: Schemastery 兼容 schema（dataDir / ai）

设计方案

不搬 Express/SQLite——用 dsh 原生服务重建数据层与适配层：

层

原项目

本插件

数据持久化

SQLite (node:sqlite)

JSON 文件（通过 dsh fs 服务落盘到 workspace 目录）

网络请求

Node fetch

dsh web.fetch / 全局 fetch

适配范围

CF + AtCoder + 洛谷 + 牛客

CF + AtCoder（洛谷/牛客需 Cookie/反爬，首版不支持）

Agent 接口

Express REST 路由

dsh ctx.tools.register()（10 个 icpc_ 前缀工具）

前端

React SPA

dsh Slot UI 面板（紧凑仪表盘）

分析引擎

依赖 DB 的函数

纯函数（输入 SubmissionRow[]，无 IO 依赖）

目录结构

▼
text
复制代码

dsh-algo-trainer/ ├── package.json # dsh 插件包定义（dsh.bundle + dsh.client） ├── tsconfig.json # host 侧 tsconfig ├── tsconfig.client.json # client 侧 tsconfig ├── cordis.patch.yml # dsh 配置补丁行 ├── README.md ├── src/ # Host 半边 │ ├── index.ts # 插件入口：apply(ctx, config) — store 初始化 + 工具/RPC 注册 │ ├── dsh-compat.ts # dsh 类型兼容层（Context / ToolDefinition / FsService / RpcService / Config） │ ├── types.ts # 跨模块共享类型（PlatformId / Verdict / WeaknessProfile / TodayPlan / ...） │ ├── store/ │ │ ├── schema.ts # JSON 数据模型（ProblemRecord / SubmissionRecord / PlanRecord / ...） │ │ └── index.ts # IcpcStore 类：内存索引 + 防抖落盘（替代 SQLite） │ ├── adapters/ │ │ ├── types.ts # PlatformAdapter / ContestAdapter 接口 │ │ ├── codeforces.ts # CF 适配器（user.status + contest.list，knownExternalIds 增量终止） │ │ └── atcoder.ts # AtCoder 适配器（kenkoooo API，from_second 增量，内存缓存题目资源） │ ├── analysis/ # 纯函数分析引擎（无 DB 依赖） │ │ ├── stats.ts # 总体统计（attempts/AC/AC率/各平台/各难度/各标签） │ │ ├── weakness.ts # 弱项画像（标签/难度 gap 打分） │ │ ├── trend.ts # 12 周趋势（ISO 周键，空周补 0） │ │ ├── tags.ts # 标签净化（过滤赛事/年份/地区等噪声标签） │ │ └── today.ts # 今日三档选题（能力值估算 + 弱项优先 + rotate 换一批） │ ├── reviews/ │ │ └── schedule.ts # 间隔复习调度（1/3/7/14/30/60 天阶梯，hard/ok/easy 调档） │ ├── plans/ │ │ └── planService.ts # 训练计划服务（AI 生成 + 模板降级 + JSON 解析容错） │ ├── templates/ │ │ ├── curriculum.ts # 114 课算法模板大纲（数据文件） │ │ └── progress.ts # 学习进度管理（todo/learning/mastered + 下一课推荐） │ ├── tools/ # 10 个 agent 工具 │ │ ├── helpers.ts # textOutput / num / str 辅助 │ │ ├── sync.ts # icpc_sync — 同步刷题记录 │ │ ├── stats.ts # icpc_stats — 统计分析 │ │ ├── today.ts # icpc_today — 今日三档训练 │ │ ├── plans.ts # icpc_generate_plan + icpc_manage_plan │ │ ├── reviews.ts # icpc_review — 间隔复习库 │ │ ├── templates.ts # icpc_templates — 模板库 │ │ ├── contests.ts # icpc_contests — 赛事中心 │ │ ├── checkins.ts # icpc_checkin — 日历打卡 │ │ ├── settings.ts # icpc_settings — 设置 │ │ └── import.ts # icpc_import — 手动导入 │ └── rpc/ │ └── index.ts # Host RPC bridge（icpc.dashboard / icpc.trend / icpc.contests） ├── client/ │ └── index.ts # Client 半边：紧凑仪表盘面板（Slot UI + 文本渲染降级） └── tests/ └── analysis.test.ts # 24 个纯函数测试

配置

▼
yaml
复制代码

# cordis.patch.yml - insert: - id: algo-trainer name: 'dsh-algo-trainer' config: dataDir: '' # 数据目录，留空则用 workspace/.icpc-data/ ai: enabled: false baseURL: 'https://api.deepseek.com/v1' apiKey: '' model: 'deepseek-chat'

AI 配置也可运行时通过 icpc_settings 工具修改（持久化到 JSON）。

Agent 工具

工具

功能

icpc_sync

同步 CF/AtCoder 提交记录（增量，支持 all 批量）

icpc_stats

统计分析：overall / weakness / trend

icpc_today

今日三档训练推荐（巩固/同段/挑战，弱项优先）

icpc_generate_plan

AI 生成训练计划（无 key 降级模板）

icpc_manage_plan

计划管理：list/detail/checkin/uncheck/delete/import

icpc_review

间隔复习库：list/add/feedback/remove

icpc_templates

114 课模板库：browse/next/set_status

icpc_contests

多平台赛事（CF+AtCoder 聚合）

icpc_checkin

日历打卡：streak/month/date/checkin/uncheck

icpc_settings

设置：get/set_account/set_ai

icpc_import

手动导入刷题记录（JSON）

dsh 插件契约

name: 'dsh-algo-trainer'

inject: ['tools', 'fs', 'rpc'] — 等待三个 dsh 服务就绪后挂载

apply(ctx, config): 加载 JSON 存储 → 初始化 CF/AtCoder 适配器 → 注册 10 个工具 + 3 个 RPC 方法 → ctx.effect() 注册 dispose 落盘

Config: Schemastery 兼容 schema（dataDir / ai）