Introduction

In the todo flow of DSH web, the official todo panel typically only serves to display tasks for the current round. If you wish to retain uncompleted tasks across rounds, sessions, and after restarts, while also annotating an evidence path for completed items, you need a review layer that does not modify the official panel. dsh-todo-guard is a community plugin for DSH web: the official todo panel remains unchanged, and the plugin mounts a review dock below the official panel to retain uncompleted tasks and annotate completion evidence.

It is maintained by a903067276-rgb, is a community project, not a DeepSeek product, and is licensed under the MIT license. The philosophy of the DSH ecosystem is “Everything is a plugin”; the community directory is an independent site with no official affiliation to DeepSeek or Fangfang, so it should not be treated as an official app store.

What is this

dsh-todo-guard is the todo review plugin for DeepSeek Harness web. Its positioning is: the official todo panel is not modified or replaced; the plugin mounts a review dock below the official panel via an additional conversation.input.dock.

It mainly solves two things:

  • Preserve uncompleted tasks: Persist across rounds, session switching, and dsh restarts.
  • Verify completion evidence: Annotate existence for paths given in todo items, and let people confirm finalize.

The entire logic is purely local logic: zero model calls, zero token cost.

Core Features

Preserve uncompleted tasks

The plugin preserves uncompleted tasks through checkpoint resume. When the official panel fails to render after a restart, the review dock can serve as a fallback.

Annotate evidence status

strictMode is enabled by default. When enabled, todo items will be annotated with three states based on the evidence path:

  • Evidence path exists: verified.
  • Path written or anchor exists, but path is missing: evidence missing.
  • No verifiable trace: unverified.

The evidence path only performs an existence check; the host only performs stat, does not read content. Therefore, “path exists” does not equal “task actually completed”.

strictMode can be disabled in Settings → todo strict mode. When disabled, the review dock becomes a normal list, losing annotations and confirmation, but resume is still usable.

Non-blocking hints

Missing or forged evidence will not block task writing, nor will it throw errors. The plugin only gives nudge hints in the tool result text.

When checking 2 or more items at once, an incremental check nudge is triggered.

If the host supports the official tools/post-execute, the plugin will append non-blocking text hints after successful writing; for old hosts without this hook, it falls back to panel annotations.

Review and finalize

The review dock is collapsed by default. When collapsed, it shows the pending count and retains the finalize button.

If all items are checked and all auto-verified, the review dock will automatically hide. When there are still pending items, you need to click Confirm finalize; confirmation status is saved in the browser per session.

Installation and Usage

First install the plugin, then restart dsh web:

dsh plugin --profile web add "github:a903067276-rgb/dsh-todo-guard#main"
# restart dsh web

Version compatibility is best-effort and not guaranteed for every DSH version. Verified compatibility relationships are as follows:

  • DSH 0.1.1-rc.1+: use main.
  • DSH 0.1.0-rc.7 / rc.8: review dock data is not guaranteed, it is recommended to use v0.1.6 fallback.
  • DSH 0.1.0-rc.6: frozen rc6-compat, no longer maintained.

Old version fallback:

dsh plugin add github:a903067276-rgb/dsh-todo-guard#v0.1.6

package engines require dsh >=0.0.1; peerDependencies include @deepseek-ai/cordis ^4.0.1-rc.1 and @deepseek-ai/schemastery ^3.18.1.

Typical Usage

Write （证据：path） inside a todo item. A todo item can contain multiple evidence paths.

Fix the button（证据：lib/index.js）
Run tests（证据：test/run.log）（证据：docs/result.md）

Relative paths are parsed according to the session working directory; absolute paths and ~/ are supported as-is.

Use Cases and Notes

dsh-todo-guard is suitable for scenarios where DSH web is used to manage todos and one wants to retain uncompleted tasks and evidence annotations.

Notes before use:

  • It is a community project, not a DeepSeek product.
  • Version compatibility is best-effort, not guaranteed for every DSH version.
  • Evidence paths only perform existence checks; the host only performs stat, does not read content; path existence does not equal actual completion.
  • After strictMode is disabled, the dock becomes a normal list without annotations or confirmation, but resume is still usable.
  • The plugin runs with the current dsh process permissions, registering docks, checking evidence paths, and appending hints. It is recommended to check the GitHub source code, MIT license, and dependency declarations before installation.

Conclusion

The value of dsh-todo-guard lies in: not modifying the official todo panel, adding a lightweight review layer to the DSH web todo flow: retaining uncompleted tasks, annotating evidence status, and letting people confirm finalize. It does not replace actual completion verification but is suitable as a local todo review assistant.

GitHub: https://github.com/a903067276-rgb/dsh-todo-guard

Directory: https://www.skillhub.cn/plugins/a903067276-rgb/dsh-todo-guard