日历清单 · DeepSeek Harness 插件

在 DeepSeek Harness 左侧栏加一个日历清单入口， 主区是一个完整的个人任务管理器：月 / 周 / 列表 / 看板四种视图，右侧还带一条独立 AI 对话。

界面参考 macOS 日历与滴答清单。

更多截图

月视图 — 农历、节气、传统节日

列表视图 — 左侧清单导航、中间任务、右侧详情

任务详情 — 标题、日期、时间段、备注

功能

四种视图

视图	特点
周	0:00–24:00 时间轴，每小时 56px，视口约 13 小时，其余滚动；拖选空白创建任务；拖动事件改时间/日期
月	农历、节气、传统节日；周数栏；每天显示任务条
列表	三列结构（清单导航 / 任务列表 / 详情），按状态分组
看板	自定义分组列，拖动卡片切换分组

任务

• 点任务打开右侧详情编辑：标题、完成、日期、开始/结束时间、备注（任意长文本）、清单、删除
• 输入即保存（防抖），失焦后才重绘，打字不闪
• 优先级（普通 / 高）
• 深链 ?task=<id> 直接打开某条任务

清单

• 默认四个：工作 / 生活 / 学习 / 收集箱
• 可增删改：+ 新建、双击改名、右键删除（删除时任务自动转移到第一个清单）
• 每个清单有独立颜色

AI 对话

右侧是一条独立的 DSH 会话，用 sessions 服务创建并持久化。 中间的拖动分隔条可调整宽度，双击恢复默认。

安装

需要先装好 DeepSeek Harness（DSH）。

git clone https://github.com/yzsuki-afk/ticklist-calendar.git

然后在 DSH 里对 Agent 说：

帮我安装 /你克隆到的路径/ticklist-calendar 这个插件

Agent 会调用 install_bundle 完成安装，左侧栏随即出现「日历清单」。

插件通过绝对路径安装，不需要发布到 npm。

安装前自检

仓库带了一个自检脚本，装之前跑一遍能拦住会让 DSH 起不来的错误：

node scripts/check.js

它检查两类问题：

• client.js 里 __ModuleLoader__.load({ id }) 的 id 与 package.json 的 name 是否一致
• index.js / client.js 的语法、cordis.patch.yml 是否引用了正确的包名

这两项任一不对，装上后 DSH 会直接无法启动。

⚠️ 启动失败怎么办

先说清楚风险：DSH 的 web boot 要求每个插件 entry 都激活成功，任何插件出错都会让整个应用起不来，而弹窗里只有一个「禁用第三方插件」按钮。

那个按钮的代价比文案说的大得多——它会清空整个 dsh.profile.bundles（实测从 15 个变成 2 个），并把 patch 里的配置项一起丢掉，等于所有第三方插件陪葬。

所以如果 DSH 起不来，先别点它，改用仓库自带的急救脚本（在终端里跑，不需要打开 DSH）：

# 1) 看当前挂了哪些插件，并打印最新崩溃日志
python3 scripts/recover.py status

# 2) 从日志里找到出问题的插件名，只停用它
python3 scripts/recover.py disable ticklist-calendar

# 3) 重启 DSH —— 其他插件全部保留

# 4) 问题修好后恢复
python3 scripts/recover.py enable ticklist-calendar

日志里的线索长这样：

ticklist-calendar: import failed (see console for the import error)
client-modules: duplicate factory registration for "@local/ticklist-calendar"

冒号前面那个名字就是 disable 的参数。

脚本做的事就是往 profile 的 cordis.patch.yml 追加两行：

- id: ticklist-calendar
  disabled: true

每次改动前都会自动备份成 cordis.patch.yml.bak-recover-<时间戳>。

数据存哪

~/.dsh/storages/ticklist-calendar/tasks.json

一份 JSON，包含 lists（清单）、groups（看板分组）、tasks（任务）三段。 写入用「临时文件 + 原子重命名」，避免写一半断电损坏。 文件损坏时会自动备份成 tasks.json.corrupt-<时间戳> 再重置，不会静默吞掉数据。

想备份或迁移，直接复制这个文件即可。

技术实现

ticklist-calendar/
├── package.json          # bundle 清单 + dsh.client 声明
├── cordis.patch.yml      # 插入一行插件
├── index.js              # Host：页面路由 + GET/PUT /api/state + JSON 文件存储
├── client.js             # Client：左侧栏入口 + 主区（iframe + AI 对话 + 分隔条）
├── app/index.html        # 全部 UI（单文件 HTML/CSS/JS，无构建步骤）
├── locale/{zh,en}.json
├── icon.svg
├── scripts/check.js      # 安装前自检（防 id/包名不一致）
├── scripts/recover.py    # 启动失败急救：精确停用单个插件
└── docs/                 # 截图

几个值得记的点：

• UI 是单个 HTML 文件，没有打包步骤，改完刷新即生效；Host 只负责静态托管和数据接口。
• 右侧 AI 对话借助会话作用域的子槽位拿到 SessionProvider，再用 renderFactorySlot('conversation.content', …) 渲染原生对话界面。
• 时间轴用固定小时高度而不是百分比铺满：窗口拉伸时事件块尺寸稳定， 且不需要监听 resize 重排。
• 窗口拖拽的坑：-webkit-app-region: drag 只在顶层文档生效， iframe 内部的元素拖不动窗口。所以顶栏由宿主侧 client.js 用 React 渲染， iframe 只承载内容区。
• 改包名要同步改客户端模块 id：client.js 顶部的 window.__ModuleLoader__.load({ id }) 里的 id 必须与 package.json 的 name 完全一致。只改其一会导致启动时报 duplicate factory registration / import failed，整个 DSH 起不来。

已知限制

• 只做了个人使用的核心功能：没有提醒通知、重复任务、标签、子任务、附件
• 清单/分组没有排序拖拽
• 数据是单机 JSON 文件，没有多端同步

许可

MIT