前言¶
在 DeepSeek Harness（DSH）里做日常事务，常见做法是把待办写在会话里、依赖外部日历或单独开一个笔记应用。会话上下文会滚动，外部工具又和智能体割裂。若你希望在 DSH 桌面 Web GUI 里直接看到整月格子、就地编辑每日记录，并把 DSH 内已配置的定时提醒叠在同一视图里，社区客户端插件 dsh-calendar-board（维护者 jy007）针对的正是这一点：月视图看板、格内编辑、完成反馈，以及可选的本机日历与 iCal 订阅。
下面按定位、功能、安装、用法与注意事项说明，事实以 GitHub 仓库 README 为准；社区目录页见 skillhub.cn。
这是什么¶
dsh-calendar-board 是面向 DSH Desktop NEXT（desktop-next profile，Web GUI）的纯前端客户端插件（当前资料中 package.json 版本为 1.5.2，MIT 许可证）。它在侧栏注册日历图标，在主区域展示以周一为起点的整月网格：ISO 周号、通过 Intl 显示的农历、今日高亮、相邻月份补格。自述条目落在页面 localStorage 并与 Host 侧存储同步；DSH schedule 服务的提醒以只读方式展开到日历上。
插件不内置构建步骤、不声明第三方依赖；页面自述不做额外网络请求（订阅 iCal 由 Host 拉取并缓存）。DSH 生态里插件由社区目录收录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
月视图与格内编辑¶
每个日期格最多展示前三条记录及剩余条数，颜色、下划线、删除线会保留。点击某天即可在格内输入：Enter 追加一行并保持光标，逐字保存；Esc 或点击其他区域退出，未提交的草稿仍会持久化。清空一行即删除该条。
单条操作与进度¶
勾选表示完成（删除线并变暗，可取消）。悬停行尾可用 U 切换下划线、● 循环文字颜色（默认 / 红 / 琥珀 / 绿 / 蓝）、× 删除。日展开面板为条目编号并显示完成进度条。
本机日历（macOS）¶
在 macOS 上可通过 AppleScript 读取系统「日历」应用里已同步的账户（含 Google、飞书/Lark 等），无需单独注册密钥。侧栏点 + 连接日历，在 本机日历（macOS） 中选择要展示的日历；首次读取会触发系统「自动化」对 Calendar 的授权。读取在后台进行并缓存，避免大日历阻塞月视图。
iCal 订阅与图例¶
可订阅任意 iCalendar 地址（Google、飞书/Lark、Outlook、Apple 等提供的私密 iCal URL），事件与自有任务并排显示；各源有独立颜色，页眉下图例可开关各源。资料说明支持常见重复规则展开、全天事件及时区处理；Host 拉取 feed 后缓存约 10 分钟，页面内不执行第三方脚本。
DSH 定时提醒¶
读取 DSH schedule 服务，将 daily / weekly / one-shot / every / cron 等提醒展开到日历；页眉有同步状态徽标。Host 另提供只读备用路由 /calendar-board/schedules。若无 schedule 服务，页眉会提示「Scheduled reminders unavailable」，其余功能仍可用。
完成庆祝与每日提醒¶
完成一条时可用 WebAudio 三音琶音、canvas 烟火、CSS 彩屑与 toast；页眉 ✦ 可预览，扬声器切换静音（偏好写入 localStorage）。尊重系统「减少动态效果」设置。另支持在设定时刻通过系统通知做每日 nudge。界面支持中英文，样式基于 DSH 主题 token，适配明暗模式。
智能体与 Host 工具¶
Host 侧为规范数据源，各 DSH 会话可通过统一工具读写看板，无需浏览器抓取。示例载荷如下：
{ "action": "list", "from": "2026-11-02", "to": "2026-11-08" }
{ "action": "add", "date": "2026-11-06", "title": "给 adon 发邮件", "time": "10:00" }
{ "action": "complete", "id": "itmw3c6bd3c83xd" }
{ "action": "remove", "id": "itmw3c6bd3c83xd" }
README 还列出 update、sources、events、subscribe / unsubscribe、toggleSource、calendars 等 action。可对智能体用自然语言，例如：「今天还剩哪些事没做？」「帮我加一条：明天 10 点给 adon 发邮件」「把『吃小龙虾』标记完成」。其他插件也可通过 calendarBoard Host 服务调用同一实现。
安装与启用¶
官方推荐在 DSH 新会话中让智能体执行安装（由插件管理器调用 install_bundle）：
Install the plugin github:jy007/dsh-calendar-board
安装后侧栏应出现日历图标；若无，可重载窗口或重启 DSH。资料中 engines.dsh 要求 >=0.2.1-rc.2。
更新时需在仓库目录 git pull 后，再次在 DSH 中安装 github:jy007/dsh-calendar-board（插件以快照拷贝安装，不自动跟踪 git）。面板页脚 vX.Y.Z 表示当前运行版本。卸载在插件管理器中移除 dsh-calendar-board；自述条目保留在浏览器 localStorage。
手动路径安装（克隆本地目录再装 bundle）见 README「Manual」一节；本文不展开 git clone 步骤。
典型用法¶
- 点击侧栏 calendar 图标 打开看板。
- 点击某日，在格内直接输入（Enter 继续，Esc 退出）。
- 勾选完成 → 提示音与烟火；悬停调整颜色、下划线或删除。
- 页眉：
‹ ›换月、Today、+ Add for today、Daily nudge、✦预览烟火、扬声器静音、⟳重新同步定时提醒。
macOS 用户通过 + 连接日历 绑定本机日历；需要外部日程时添加 iCal 订阅 URL，并在图例中开关各源。
适用场景与注意¶
适合谁： 已在用 DSH Desktop NEXT、希望月视图统筹每日笔记、待办与 DSH 内 schedule 提醒的开发者或重度桌面用户；macOS 上还想零配置叠加系统日历的人；希望通过智能体或 Host API 编程增删改查日历条目的工作流。
数据与隐私（README 摘要）： 自述条目 Host 路径为 <DSH_HOME>/storages/calendar-board/items.json，页面另有 localStorage 缓存；订阅地址在 sources.json；定时提醒只读、不落库。订阅 iCal 时 Provider 会看到来自本机的请求，私密 iCal 地址应视为密码。页脚显示「已同步 Host」/「仅本机保存」以区分是否与 Host 通信。
权限与安全： 插件在当前 DSH 进程权限下运行；安装前请自行查看 源码与 MIT 许可证。本机日历与 iCal 拉取会触及系统自动化与网络，仅在你显式连接或订阅后发生。
兼容性： 注册 Client 槽位 sidebar.panellist 与 main；可选依赖 Host 的 schedule 与 webServer（无 webServer 时仅走 remote channel）。
结尾¶
dsh-calendar-board 把月视图、格内编辑、DSH 提醒与本机/订阅日历收进 DSH 侧栏，并用 Host 工具把同一数据开放给智能体与其他插件。目录页：skillhub.cn/plugins/jy007/dsh-calendar-board；源码与完整 API 表：github.com/jy007/dsh-calendar-board。
