Back to directory

dsh-algorithm-tools

In a curated listMaintenance: Active

springrinbowcat/dsh-algorithm-tools

Training workbench for competitive programming — syncs Codeforces and AtCoder submissions, profiles weak tags, picks a daily three-band problem set, reviews contests, and keeps a check-in calendar. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

View on GitHubHomepage
$ dsh plugin add dsh-algorithm-tools

Install

dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.

How installs work

2

stars

0

forks

TypeScript

Language

GPL-3.0

License

2026-11-04

Created

2026-11-18

Last push

README

dsh-algorithm-tools

算法训练台 — DeepSeek Harness 插件。

来源:本插件基于 ZF3373/icpc-workbench(GPL-3.0)裁剪重写,只保留了其中一部分功能;完整说明见 NOTICE.md。

许可:GPL-3.0。

把 Codeforces / AtCoder 的刷题数据接进 DSH:同步提交、弱项分析、每日三档训练、Rank 复盘、赛事列表、日历打卡。能力分两层:

  • 10 个 icpc_* agent 工具 — 在对话里直接让 AI 帮你同步、选题、复盘
  • 右侧面板 — 日历 / 数据概览 / 赛事 三个视图,外加一键功能按钮

当前版本 0.2.2。


快速上手

# 1. 安装(会转发给 pnpm,在 profile 目录里执行)
dsh plugin --profile desktop add dsh-algorithm-tools        # 从 npm 装(推荐)
# 或跟随仓库最新提交:
dsh plugin --profile desktop add github:SpringRinbowCat/dsh-algorithm-tools
  1. 重启 DeepSeek Harness(Host 侧插件不支持热重载)
  2. 打开任意会话 → 点右上角图标打开 Algorithm Practice Space 面板(必须打开一次,icpc_* 工具才会注册进当前会话)
  3. 在对话里依次执行:
icpc_settings action=set_account platform=codeforces handle=你的CF用户名
icpc_settings action=set_local_root root=/Volumes/kingston/codeforces
icpc_sync platform=codeforces bank=true     # 首次同步题库约 10–30 秒
icpc_today                                   # 生成今天的训练

面板

三个视图,用左右箭头切换:

视图 内容
日历 近 12 周训练热力图、连续打卡(跳过周日)、今日训练进度
数据概览 提交/AC 统计、难度分布、标签分布、12 周趋势、弱项
赛事 CF + AtCoder 近期比赛(进行中 / 即将开始)

右侧功能按钮(点击后把对应指令交给当前会话的 agent):

按钮 作用
今日训练 生成/读取今天的 6 道题(巩固 2 / 同段 3 / 挑战 1)
同步数据 icpc_sync_all:同步提交 + 提交并推送本地仓库
题库刷新 icpc_sync bank=true:只拉题库,不动代码
rank 复盘 icpc_review action=contests:近期比赛复盘
加训 今日完成后出现;周日休息日也可加训

打开面板时会自动增量同步(服务端 30 分钟内只拉一次);今日训练完成后会额外拉一次最新数据。


Agent 工具(10 个)

工具 主要 action / 参数 说明
icpc_sync platform(all/codeforces/atcoder)、handle、bank 增量同步提交;bank=true 顺带刷题库
icpc_sync_all contestId 同步 + 处理 rank/_pending + 提交推送仓库
icpc_stats type(overall/weakness/trend) 统计分析
icpc_today consolidation/core/challenge/rotate/windowDays/extra 今日三档训练;周日默认休息,extra=true 可加训
icpc_review contests / contest Rank 复盘
icpc_contests action(upcoming/finished) 赛事列表
icpc_checkin status/streak/month/date/checkin/uncheck 日历打卡
icpc_problems platform/difficulty/tag/q/bank 浏览题库
icpc_settings get/set_account/set_ai/set_adapter/set_cookies/set_reminder/set_local_root 设置(返回时密钥脱敏)
icpc_maintenance stats/clear_submissions/clear_all 数据维护:查看量级、清空提交、清理旧字段

工具是按会话注册的:新会话需要先打开一次右侧面板。没打开时调用会报 unknown tool "icpc_*"。


今日训练怎么算

icpc_today 的三档推荐:

  1. 能力值 = 当前 rating:直接取 Codeforces 当前 rating,四舍五入到 100 分档。 拉不到 rating 时才回退到「近 60 天刷题 AC 难度中位数 × 0.6 + 比赛 AC 难度中位数 × 0.4」。
  2. 按目录锁定:先看 <训练根>/practice/<今天>/,已经有题目文件夹就按已有的出推荐,不重新抽题—— 这样两台电脑从 GitHub 同步同一份目录时不会各抽一套。目录为空才新抽。
  3. 落盘成文档:把三档题目和选题理由写成 practice/<今天>/<今天>.md,随仓库提交,另一台机器打开就是同样的安排。

选题依据:弱项标签命中 → 近期比赛失分标签 → 本周训练方向,按距离档位中心的距离排序。


训练仓库约定

推荐结构(localRoot 指向仓库根):

codeforces/
├── practice/<YYYY-MM-DD>/<题目>/<题目>.cpp     # 日常训练 & 赛后补题
├── practice/<YYYY-MM-DD>/<YYYY-MM-DD>.md       # 当天训练安排
├── rank/<比赛号>/<比赛号><题号>/<比赛号><题号>.cpp   # 比赛代码

兼容旧格式:practise/<日期>/...;只要目录名或 .cpp 文件名能匹配 2283C / 1858E1 这类题号即可。

0.1.7 起移除了独立的「训练计划」体系(计划视图、计划按钮、taskList/*.md、icpc_generate_plan/icpc_manage_plan)。每日训练本身已经覆盖了它的作用。

比赛当场不输比赛号:rank/_pending

比赛时不知道 contest id 也能建题:

  1. Sublime 里按 Ctrl+Alt+R → 输 A/B/C1 → 文件落在 rank/_pending/A/A.cpp
  2. 赛后点「同步数据」→ 插件发现 _pending,先返回 needContestId 和题号列表,不提交
  3. 你回一个比赛号 → 自动重命名成 rank/<比赛号>/<比赛号>A/<比赛号>A.cpp、改写题链,再提交推送

对应工具调用:icpc_sync_all,有 _pending 时先不带 contestId,拿到清单后再带 contestId=2280。

冲突策略:远端为准

icpc_today / icpc_sync / icpc_generate_plan 动手前都会 git pull。pull 冲突时:

  1. git rebase --abort / merge --abort,不让仓库卡在冲突状态
  2. 只把「安排类」路径强制对齐远端(practice/<日期>/<日期>.md)
  3. 同一批差异里的 *.cpp 也按远端覆盖,其他文件不动
  4. 对齐后立即同步进面板,不再追问

换 Codeforces 账号

icpc_settings action=set_account platform=codeforces handle=新用户名
icpc_sync platform=codeforces

不需要手动清数据:提交记录从 0.1.3 起带 handle 字段,统计、日历、弱项都按当前绑定账号过滤:

  • 换号时,没有 handle 的旧记录会自动归到旧账号名下,不会算成新号的账
  • 想彻底清空历史(比如重建):icpc_maintenance action=clear_all

注意:icpc_maintenance 必须在插件进程内部执行。直接改磁盘上的 state 文件会被运行中的进程用内存副本覆盖——退出时还会再刷一次盘。


数据与目录

内容 位置
插件状态(题库缓存 / 提交 / 训练索引 / 设置) $DSH_HOME/.icpc-data/icpc-state.json,未设 DSH_HOME 时是 ~/.icpc-data/icpc-state.json
启动探针 同目录 icpc-boot.log(排查数据目录用)
训练仓库 icpc_settings action=set_local_root 设置;未设置时依次尝试 D:\codeforces、~/codeforces

state 文件不跟 git 同步:每台机器路径和账号绑定不同。能算出来的数据(提交、AC、弱项、打卡)都可以从 CF 重新拉;题库缓存重建约 10–30 秒。

读写模型:启动时读一次进内存 → 运行中改内存 → 500 ms 防抖落盘 → 退出时再写一次。所以:

  • 运行中直接编辑 state 文件无效
  • 清库必须走 icpc_maintenance
  • 文件损坏时插件会把坏文件改名成 .corrupt-<时间戳> 留档,然后从空状态启动

配置

cordis.patch.yml 里的挂载行(profile 层):

- insert:
    - id: algo-trainer
      name: 'dsh-algorithm-tools'
      config:
        dataDir: ''          # 留空 = $DSH_HOME/.icpc-data
        localRoot: ''        # 留空 = D:\codeforces → ~/codeforces
        ai:
          enabled: false
          baseURL: 'https://api.deepseek.com/v1'
          apiKey: ''
          model: 'deepseek-chat'

dataDir / localRoot / ai 也可以运行时用 icpc_settings 改(持久化进 JSON),get 返回的 apiKey / cookie 是脱敏的。


目录结构

Read the full README on GitHub →

More in Web & Browser

anysearch-dsh

by anysearch-team

AnySearch web search provider and advanced search tools for DeepSeek Harness (DSH)

CuratedEvaluatedWeb & BrowserTypeScript
70517

dsh-find-plugin

by awesome-dsh-plugin

In-agent plugin discovery: live GitHub repository search scoped to the official `dsh-plugin` topic, star-ranked; every result comes with a ready-to-run `dsh plugin add` command.

CuratedEvaluatedWeb & BrowserJavaScript
23814

fnos-dsh

by fnosp

Multi-source web search and fetch failover for DeepSeek Harness sessions: takes over the session searchProvider and fetchProvider seams and tries configured sources in a chosen order — TinyFish, Tavily and the official search as a fallback that always participates and can be repositioned but not removed. Multiple API keys per platform are spread round-robin, usage snapshots drive pre-flight exclusion of exhausted accounts, and per-request timeouts plus same-platform retry control failover granularity. Web fetching runs local HTTP first, then falls back to TinyFish Fetch server-side rendering and Tavily Extract, so pages still load when local egress is blocked by proxy or DNS policies. A per-platform panel shows key usage and plan limits. Install from npm with `dsh plugin --profile web add @tnnevol/dsh-failover-search`.

CuratedEvaluatedWeb & BrowserTypeScript
12012

modsearch

by liustack

Web/X 搜索与抓取桥:为纯文本 coding agent 提供结构化 JSON 证据(search/fetch/citations),引擎可选 Antigravity CLI(免 key)/带 key 引擎/X(Grok Build 登录态)。

CuratedEvaluatedWeb & BrowserTypeScript
1,02643

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.