DeepSeek Harness plugin

dsh-todolist

An independent todo board for DeepSeek Harness: list/board/calendar/week/project views, AI tools (todolist / todolist_suggest), and a self-contained storage backend. Registers a top-level Todos tab

Jump to install

Source facts

Repository
HZ-JasonLin/dsh-todolist
Latest update
Aug 19, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/HZ-JasonLin/dsh-todolist
Plugin: dsh-todolist
Author: HZ-JasonLin

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

@hz-jasonlin/dsh-todolist

An independent todo board plugin for DeepSeek Harness.

独立待办看板插件,为 DeepSeek Harness(DSH)提供完整的待办管理能力。

Features / 功能

  • 对话页顶部「待办」Tab,提供列表、今日、日历、周视图和项目视图
  • 全视图点击即编辑:列表行、今日卡片、日历/周任务条、项目看板卡片点击直接打开编辑弹窗;勾选框单独承担完成/恢复;编辑弹窗内提供「删除」(二次确认弹窗,避免误触)
  • 日历 / 周视图拖动

- 拖动任务条到其他日期 → 修改日期(单日任务改期、跨度任务整体平移;落点格高亮提示) - 拖动任务条到其他任务条上方/下方 → 调整排序(持久化) - 长按空白日期后跨格拖动 → 快速创建跨度任务 - 每天最多展示 5 条泳道,超出折叠为「+N」,点击就地展开 / 收起

  • 今日视图拖动排序:顶部「今日」与侧边栏「今日」卡片可拖动排序并持久保存;未手动排序前保持智能顺序(逾期 → 今日到期 → 周期 → 进行中)
  • 统一的指针与拖拽视觉:悬停一律点击指针,拖动中才是拖动指针;任务拖动使用紧凑拖影,并屏蔽宿主(better-sidebar)的分栏落区遮罩
  • 横向项目看板,支持项目列拖动排序;可以直接在项目列中添加任务,并自动预填所属项目
  • 项目筛选和项目看板完全由任务的 proj 数据驱动:新建任务时出现的项目会自动成为筛选选项
  • 任务完成状态记录 doneAt,日历和周视图按实际完成日期显示
  • 未完成的逾期任务自动显示到今天,并标注延期天数
  • 当天日期以蓝色圆圈 + 白字高亮
  • AI 工具:todolist 用于直接管理已确认待办,todolist_suggest 用于提交待确认建议
  • 可选接入 dsh-better-sidebar,在其原生右侧栏提供「今日」Tab
  • 未安装 dsh-better-sidebar 时,提供独立的 Today 侧栏:按钮挂载到 DSH 原生 session header utilities,与 Session log 共用同一控制行;侧栏支持展开、收起、拖拽调宽和宽度持久化
  • 使用独立的本地存储,不依赖其他插件

Installation / 安装

插件已发布到 npm,推荐直接用 DSH 插件 CLI 安装:

dsh plugin --profile web add @hz-jasonlin/dsh-todolist

也可以从 GitHub 安装:

dsh plugin --profile web add github:HZ-JasonLin/dsh-todolist

从源码构建(仅开发环境):

git clone https://github.com/HZ-JasonLin/dsh-todolist.git
cd dsh-todolist
npm install

# 构建客户端 bundle
$env:DSH_SOURCE="<your-dsh-esbuild-environment>"   # 仅当本地构建环境需要时
node scripts/build.mjs

插件可以独立使用,不要求安装 dsh-better-sidebar。只安装 @hz-jasonlin/dsh-todolist 时,顶部「待办」Tab 和完整待办功能仍然可用,同时会启用独立的 Today 侧栏。

如果同时安装了 dsh-better-sidebar,fallback 会自动停用,插件改为向 better-sidebar 注册原生「今日」Tab。这是自动让渡机制,不会出现两个侧栏入口。

待确认待办管理 / Pending Suggestions

todolist_suggest 用于 AI 自己提出、需要用户确认的待办建议。建议会进入「待确认待办管理」Tab,用户可以选择「采纳」或「拒绝」。

当用户明确说“记住……”或“我要做……”时,应使用普通 todolist 工具直接写入待办,因为用户本人就是确认者。这种情况下不会进入待确认队列。

因此,如果没有使用过 todolist_suggest,「待确认待办管理」显示为空是正常的,并不代表功能失效。

数据存储 / Storage

服务端会将数据存储在 DSH 配置的数据目录中:

  • todo-data/todos.json
  • todo-data/suggestions.json

运行时数据位于本仓库之外,不会被提交到 Git。

开发构建 / Development Build

# 仅当本地构建环境需要时设置 DSH_SOURCE
$env:DSH_SOURCE="<your-dsh-esbuild-environment>"
node scripts/build.mjs

构建产物写入 lib/client.js

License / 许可证

MIT