toujianjian/dsh-do

Project Overview项目介绍

This is a native detail optimization plugin built exclusively for DeepSeek Harness (DSH), and it adds multiple quality-of-life features that are not available in the base DSH installation. It includes an autonomous loop feature identical to Claude Code, a sidebar GitHub plugin discovery panel, one-click AI-powered plugin installation, and a right-click shortcut to add new workspaces. To install the plugin, you only need to run the official DSH plugin command, then restart your target profile to activate it. No local build is required because all built artifacts are already committed to the repository, and the autonomous loop supports round limits and auto-recovery after crashes.

This plugin is designed for DSH users who want their models to automatically run multi-step tasks without manual intervention after the initial request. A typical workflow starts with the user stating their goal, then the model calls loop_start to begin the autonomous cycle. After each round completes, the plugin automatically triggers the next round, continuing until the goal is finished, the round budget is exhausted, or the user manually cancels the loop. The plugin search feature lets you quickly find DSH-related repositories, and clicking the AI install button automatically handles the entire installation process for you, speeding up plugin discovery and setup.

The plugin has no external dependencies, follows DSH's official development specifications, and includes 15 unit tests to verify the stability of core loop and checkpoint functionality. There are a few known limitations: GitHub's public API has a rate limit of 10 requests per minute when used without an authentication token, and if DSH changes the aria-label text of the sidebar add workspace button, the plugin's selector will need to be updated. The plugin does not have an explicit open source license listed, and it supports custom configuration for default round budgets and checkpoint storage paths to fit different user preferences.

这是一款专为DeepSeek Harness(DSH)开发的原生细节优化插件,提供Claude Code同款自主循环、侧边栏GitHub插件发现、一键AI安装插件、右键添加工作区等功能。自主循环支持轮次预算限制、崩溃自动恢复,适配移动端小屏显示,优化了界面配色清晰度,可直接通过DSH官方插件命令从GitHub安装,无需本地构建,安装完成后重启目标配置文件即可生效。

适用于需要让模型自动连续完成多轮任务的DSH用户,典型工作流为用户提出目标后,模型调用loop_start启动自主循环,每轮结束后自动触发下一轮,直到目标完成、轮次耗尽或用户手动取消。插件搜索功能可快速查找DSH相关插件,点击AI安装即可自动完成安装流程,右键添加工作区则让用户无需通过图形界面逐步点击即可快速注册新工作区。

本插件无额外依赖,遵循DSH官方开发规范,内置15个单元测试保证核心功能稳定性。已知限制包括GitHub公开API无token时每分钟仅支持10次搜索,官方侧边栏按钮文案修改后需要更新选择器。插件未明确标注开源许可证,所有构建产物已提交至仓库,支持自定义默认轮次预算和检查点存储路径,无需本地构建即可安装。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:toujianjian/dsh-do

把 toujianjian/dsh-do 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-DO

Detail Optimization —— DeepSeek Harness(DSH)的细节优化插件:Claude Code 同款自主循环(含 /loop 斜杠命令)+ 断连重试参数可视化配置 + 模型循环自动截停/压缩/重发 + 侧边栏 GitHub 插件发现/一键 AI 安装 + 右键添加工作区。

项目名 dsh-DO(Detail Optimization);npm 包名因 npm 规范必须小写,为 dsh-do。源码:https://github.com/toujianjian/dsh-do

功能总览

这是一个插件、一个安装包、一个配置注册行,内部包含 Host 与 Client 两端(不是多个插件):

  • Host 半(loop):Claude Code 同款自主循环。模型调用 loop_start 启动后,驱动在同一会话里一轮接一轮自动续跑,直到 loop_done(完成)、轮次预算耗尽(自动 block)、loop_cancel(取消)或用户中断。人类也可以用 /loop 斜杠命令直接驱动同一套循环。
  • Client 半(浏览器 UI):侧边栏 GitHub 按钮(Octocat 图标)→ 双标签插件发现(项目搜索 / 插件搜索 + AI 安装);右键原生"添加工作区"按钮 → 粘贴路径注册工作区;设置区新增 dsh-DO 设置面板。
  • 设置面板:可视化编辑循环预算/检查点策略、模型循环检测策略,以及当前提供方的断连重试参数(重试次数、退避时长、抖动、重试模式)。

具体优化细节

① 自主循环(Claude Code 同款 loop)

  • 四个模型工具:loop_start / loop_status / loop_done / loop_cancel。
  • 轮次预算:max_rounds(默认 20),到顶自动 block(round-limit),防失控空转。
  • 原子检查点:每个 loop 一份 JSON 检查点(临时文件 + fsync + rename 原子发布),插件启动自动恢复,会话 resume 后 armed 循环自动续跑——重启/崩溃无需手动干预。
  • 竞态围栏(复用官方 dsh-goal-round-driver 模式):agent/status idle 驱动下一轮;agent/inbox/inserted 检测竞争提示自动暂停;agent/pre-step waterfall 校验轮次预约(round 编号/内容/loop 身份),拒绝陈旧或外来轮次并归还其它已认领消息;turn/end aborted/max-tokens、agent/error、卸载时全部正确清理。
  • 权限模型:loop_start 仅直接人类轮(顶层 agent + 本轮含 source.kind === 'user' 消息),拒绝子代理;loop_done/loop_cancel 仅人类轮或当前循环轮。
  • 重放安全:轮次计数以会话日志中已 admit 的 loop 轮次(user/message + source.kind === 'loop')为准,检查点只作提示,重放同一事件序列得到同一状态。
  • 与内置 goal 系统并存:goal 是官方事件溯源续跑;dsh-do 是自包含、无事件溯源依赖的独立循环,建议一个任务只用一种机制。

①b /loop 斜杠命令(人类直接驱动)

把 Claude Code 的 /loop [interval] <prompt> 语法与 DSH /goal 的控制动词合到一条命令上,人类不必再让模型代劳:

  • 间隔语法:前导 30s/5m/2h/1d,或尾部 every 20 minutes / every 2h。前导 token 优先于尾部子句(与 Claude Code 一致);every 后面不是时间表达式时按普通正文处理,所以 /loop check every PR 仍是合法目标。无间隔时默认 10 分钟;低于 1 分钟按 Claude Code 的粒度上取整到 1 分钟。
  • 间隔语义:间隔是轮次之间的最小间隔(intervalMs 随检查点持久化),首轮立即执行——与 Claude Code"先立刻执行一次,再按 cron 重复"一致。不写间隔则空闲即续跑。
  • 控制动词:/loop(查看状态)、pause、resume、edit <objective>(替换目标、保留预算)、done [summary]、cancel [reason](clear 为别名)。
  • start 与 edit 的分工:对已 pause 的活跃循环再次 /loop <objective> 会整条替换(新目标、新预算、新节奏)并明确告知——/loop <objective> 的语义就是"跑这个目标",不该悄悄留下旧目标。/loop edit <objective> 则保留已用轮次,用于中途修正目标。armed 的循环永不被覆盖(先 edit/pause/clear)。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-freecodego 下一个 Next dsh-autoupdate →