dsh-schedule
开发工具 活跃维护

dsh-schedule

magicOF2/dsh-schedule

提供顶栏常驻日程管理面板,支持日程与对话关联、完成打勾、自定义重复规则,数据全量本地存储,可开展周/月/季度/年度多维度日程回顾,配套专属日程管理Agent工具。

1
Stars 标星
0
Forks 分支
1
Watchers 关注
0
Open Issues
JavaScript
主要语言
MIT
开源协议
52 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:magicOF2/dsh-schedule
git clone https://github.com/magicOF2/dsh-schedule.git
git clone git@github.com:magicOF2/dsh-schedule.git
README.md master

dsh-schedule

DeepSeek Harness 本地日程插件 —— 顶栏日程面板、日程-会话链接、完成打勾、重复日程与 agent 工具。数据长期保存在本地文件,支持周/月/季度/年度回顾。

A local long-term schedule plugin for DeepSeek Harness: top-bar schedule panel (today / week / history calendar), schedule↔conversation links, completion checkmarks, recurring tasks, and agent tools. Data persists in a local file for lifetime history review.

功能 Features

  • 📋 顶栏"日程"文字按钮 — 会话标题栏右侧,纯文字简洁风
  • 🗓️ 三个视图 — 今天(未完成/已完成)/ 本周(按周一到周日分组)/ 历史(月历 + 本周/本月/本年/连续完成统计)
  • ✅ 完成打勾 — 按天记录,重复日程每天独立;勾掉的进"已完成"区,次日自动清空当日记录但历史永久保留
  • 🔁 自动顺延(可选) — 一次性日程可勾选"未完成自动顺延":到期未完成时,下次打开自动顺延到当天,顺延经过的历史日期保留在月历中,完成的当天会显示最终状态
  • 🔗 日程↔会话链接 — 日程条右侧 ⊕ 一键关联当前会话;输入框右侧 🔗 弹出日程列表;点击日程标题或会话标签跳转到关联会话;一个日程可关联多个会话
  • 🔁 重复日程 — 一次性 / 每天 / 每周(周一~周日多选)
  • 🔄 自动刷新 — 面板打开期间每 30 秒同步一次,其他会话里 agent 改的日程也会出现;Esc 或点击面板外空白处关闭
  • 🤖 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,顶部标题栏右侧出现"日程"按钮
  2. 点击打开面板:输入标题 + 选择日期/重复/时间,点"添加"
  3. 一次性日程可勾选"未完成自动顺延":当天没完成,下次打开自动跳到当天继续待办
  4. 完成一项,点左侧圆圈打勾
  5. 日程条右侧 ⊕ 把当前会话关联到该日程;输入框右侧 🔗 也可以;点日程标题(蓝色)或会话标签跳转回关联会话
  6. "历史"页签查看月历和统计;顺延过的日程会在历史日期上显示"顺"标记

数据 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