magicOF2/dsh-schedule

Project Overview项目介绍

This is a native long-term local schedule plugin built exclusively for DeepSeek Harness. It also provides a set of agent tools that let you add, edit, list, and manage schedules directly via natural language commands in any conversation. It adds a dedicated Schedule tab to the dsh-better-sidebar component, supports bidirectional linking between schedules and conversations, inline editing, detail views, completion checkmarks, recurring schedules, and optional auto carry-over of unfinished tasks. To install, you first clone the repository from GitHub to your local machine, run the build command with pnpm, then install it to your DSH web profile using the dsh plugin command, and finally restart DSH to activate it.

After installation and restarting DSH, you can open the Schedule tab from the plus menu at the top of the better-sidebar. To add a new schedule, expand the add form, enter the title, date, recurrence, time and notes, then save it. You can tick the circle next to a schedule to mark it complete, edit details directly via the edit icon, and link your current conversation to any schedule with one click. You can also view historical schedules and completion statistics on the History tab for weekly, monthly or yearly reviews. This plugin is ideal for users who want to manage their daily tasks and long-term plans locally within DSH.

This plugin requires dsh-better-sidebar to work properly for the UI; if you do not have that dependency installed, only the agent tools will be available. All schedule data is stored locally in the ~/.dsh/dsh-schedule-data.json file, and the plugin automatically migrates old data to the new format when updating. If the data file becomes corrupted, the plugin will back up the original file before starting with an empty dataset, so you never lose your original data. You can back up your data manually by copying this JSON file to another location. The project is released under the MIT license, works across Windows, macOS and Linux, and all core logic has unit test coverage for stability.

这是一个专为DeepSeek Harness开发的原生日程管理插件,为dsh-better-sidebar侧边栏新增独立的「日程」标签页,支持日程与会话双向关联、行内编辑、详情视图、完成标记、重复日程、可选自动顺延等功能,还提供多组Agent工具调用接口,所有数据长期保存在本地文件,支持周、月、季度、年度的历史回顾统计。

安装时需要先克隆源码到本地,执行构建命令完成编译后,通过dsh插件命令安装到DSH的web配置文件,重启DSH即可正常使用。使用前需要先安装dsh-better-sidebar依赖,未安装该依赖时仅Agent工具可用,适合需要在DSH内本地管理长期日程、关联工作会话、做定期回顾的用户。

所有日程数据默认保存在用户目录下的~/.dsh/dsh-schedule-data.json文件中,支持旧数据自动迁移,文件损坏时会先备份原文件再启动,不会覆盖原始数据,拷贝该文件即可完成手动备份。项目采用MIT许可证开源,可免费使用修改,支持全平台运行,核心逻辑有单元测试覆盖,稳定性有保障。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
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:magicOF2/dsh-schedule

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

READMEREADME

dsh-schedule

DeepSeek Harness 本地日程插件 —— better-sidebar 侧边卡片「日程」、日程-会话链接、行内编辑与详情视图、完成打勾、重复日程与 agent 工具。数据长期保存在本地文件,支持周/月/季度/年度回顾。

A local long-term schedule plugin for DeepSeek Harness: a "Schedule" tab in the better-sidebar side card (today / week / history calendar), schedule↔conversation links, inline editing with a detail view, completion checkmarks, recurring tasks, optional auto carry-over, and agent tools. Data persists in a local file for lifetime history review.

功能 Features

  • 📅 单入口(侧边卡片) — 日程作为 better-sidebar 侧边栏的一个 tab;通过侧边栏顶部「+」菜单添加/打开,也可固定到侧边卡片。不占会话标题栏,也没有独立浮窗/抽屉(保证只有一种形态,不再有加载时序导致的"有时弹窗、有时侧边栏"问题)
  • 🗓️ 侧边卡片面板 — 今天(未完成/已完成)/ 本周(按天分组)/ 历史(月历 + 本周/本月/本年/连续完成统计)
  • ✏️ 行内编辑 — 日程条右侧 ✎ 直接编辑名称、日期、重复、时间、备注、顺延开关;详情页内也可编辑
  • 🔍 详情视图 — 点日程标题查看完整备注(自动换行不再截断)、完成统计、顺延历史日期与关联会话,支持在详情里打勾/关联/删除
  • ➕ 添加表单折叠 — 面板内默认收起为「+ 添加」按钮,点开才展开表单(含备注输入),把更多空间留给日程列表
  • ✅ 完成打勾 — 按天记录,重复日程每天独立;勾掉的进"已完成"区,次日自动清空当日记录但历史永久保留
  • 🔁 自动顺延(可选) — 一次性日程可勾选"未完成自动顺延":到期未完成时,下次打开自动顺延到当天,顺延经过的历史日期保留在月历中,完成的当天会显示最终状态
  • 🔗 日程↔会话链接 — 日程条右侧 ⊕ 一键关联当前会话;输入框右侧 🔗 弹出日程列表;点击日程标题或会话标签跳转到关联会话;一个日程可关联多个会话
  • 🔁 重复日程 — 一次性 / 每天 / 每周(周一~周日多选)
  • 🔄 自动刷新 — 面板打开期间每 30 秒同步一次,其他会话里 agent 改的日程也会出现
  • 🤖 Agent 工具 — dailytask_add/list/set_done/update/delete/link_session,在任意对话里说"帮我记一条日程"即可
  • 💾 长期本地存储 — ~/.dsh/dsh-schedule-data.json,完成历史永不删除,自动迁移旧版数据文件;文件损坏时先备份为 .corrupt-时间戳 再以空数据启动,绝不覆盖原文

安装 Install

# 从源码
git clone https://github.com/magicOF2/dsh-schedule.git
cd dsh-schedule
pnpm build
pnpm test

# 安装到 web profile
dsh plugin --profile web add /path/to/dsh-schedule

# 重启 DSH
dsh web

使用 Usage

  1. 打开 DSH Web,点侧边栏顶部「+」→ 选择「📅 日程」(或在已打开的侧边卡片标签栏中点日程);之后可直接点侧边卡片上的 📅 tab 使用
  2. 点面板内「+ 添加」展开表单:标题 + 日期/重复/时间 + 备注,再点"添加";一次性日程可勾选"未完成自动顺延"
  3. 完成一项,点左侧圆圈打勾
  4. 日程条 ✎ 直接编辑;点日程标题进入详情(完整备注、完成统计、顺延历史、关联会话管理)
  5. 日程条 ⊕ 或详情页按钮把当前会话关联到该日程;输入框右侧 🔗 也可以;点会话标签跳转回关联会话
  6. "历史"页签查看月历和统计;顺延过的日程会在历史日期上显示"顺"标记

前提:日程 UI 需要 dsh-better-sidebar 已安装(日程作为它的侧边卡片 tab 注册,并在其顶部「+」菜单里出现)。未安装时只有 Host 侧 agent 工具可用。

数据 Data

  • 数据文件:~/.dsh/dsh-schedule-data.json
  • 结构:items(日程定义)+ done(按 日程ID → 日期 累积的完成记录)
  • 备份:拷贝该文件即可

开发 Develop

pnpm build   # 产出 lib/(Host ESM + Client C6 bundle)
pnpm test    # node --test:存储核心 + 客户端纯视图逻辑(src/client/logic.cjs)

测试跨平台可用(Windows/macOS/Linux);日期校验、顺延展开、排序与统计均有单元覆盖。

License

MIT

← 上一个 Prev deepseek-harness-prompt-optimizer 下一个 Next dsh-context-rollover →