dsh-calendar-board

Calendar Board for DeepSeek Harness

English · [中文](README.zh.md)

A month-view calendar board for [DeepSeek Harness](https://deepseek.com) desktop: your daily notes, the reminders you scheduled inside DSH, inline editing right in the grid — and a little celebration every time you finish something.

> Pure front-end plugin. No build step, no third-party dependencies, no network calls. Your entries live in the page's localStorage; scheduled reminders are read-only.

Features

Month view

• Whole-month grid starting on Monday, with ISO week numbers, lunar dates (via Intl's Chinese calendar), a highlighted today, and trailing days from the adjacent months
• Each cell shows the first 3 entries plus a remaining count; colors, underlines and strikethroughs are preserved

Inline editing

• Click any day cell to edit it in place: an input appears inside the cell, Enter adds another entry and keeps the caret there
• Every line is directly editable and saves as you type; Esc or clicking elsewhere exits, and an uncommitted draft is still persisted
• Clear a line and leave it to delete the entry

Per-entry controls

• Check an entry to complete it — it gets a strikethrough and dims; uncheck to revert
• Hover the end of a row: U toggles underline, ● cycles the text color (default / red / amber / green / blue), × deletes
• The day panel numbers entries 1. 2. 3. and shows a completion progress bar

This Mac's calendars (zero setup)

• On macOS the board reads Calendar.app through AppleScript — every calendar already synced there, Google and Feishu/Lark accounts included — so nothing has to be registered or pasted
• Open + 连接日历, pick the calendars to show, done. The first read raises the system Automation prompt for Calendar
• Reads run in the background and are cached, so a big calendar never blocks the month view

Calendar subscriptions

• Subscribe to any iCalendar feed — the secret iCal address Google Calendar, Feishu/Lark, Outlook or Apple Calendar hands out — and its events appear beside your own tasks
• Every source has its own color; the legend under the header toggles each source on or off
• Recurring events (daily / weekly with BYDAY / monthly / yearly, COUNT, UNTIL, EXDATE), all-day events, TZID wall times and UTC times are expanded into the visible month
• Feeds are fetched by the Host and cached for ten minutes; no third-party script runs in the page

Scheduled reminders

• Reads DSH's schedule service and expands daily / weekly / one-shot / every / cron reminders into the calendar
• A header badge shows the sync state; the Host half also exposes a read-only /calendar-board/schedules route as a fallback source

Completion celebration

• Finishing an entry plays a three-note arpeggio (synthesized with WebAudio), draws canvas fireworks, adds CSS confetti and shows a toast
• ✦ in the header previews the effect at any time; the speaker toggles sound (remembered locally)
• Respects the system "reduce motion" preference

Extras

• Daily nudges through system notifications, fired at the time you set
• Chinese and English UI, built entirely on DSH theme tokens so light and dark both work

Install

One-liner (recommended)

Open a new session in DSH and tell your agent:

Install the plugin github:jy007/dsh-calendar-board

The agent calls the plugin manager's install_bundle. A calendar icon appears in the sidebar afterwards; if it does not, reload the window or restart DSH.

Manual

git clone https://github.com/jy007/dsh-calendar-board.git ~/plugins/dsh-calendar-board

Then ask your DSH agent to install ~/plugins/dsh-calendar-board as a bundle, or pick that directory in the plugin manager.

Use the calendars already on this Mac

Click + 连接日历 and pick from the 本机日历（macOS） list. The first read asks macOS to let DSH control Calendar (System Settings → Privacy & Security → Automation); allow it once.

Update

cd dsh-calendar-board && git pull

Then install github:jy007/dsh-calendar-board again in DSH. The plugin installs a snapshot copy, so it does not follow the repository by itself; the vX.Y.Z in the panel footer is the version currently running.

Uninstall

Remove dsh-calendar-board in the plugin manager. Your entries stay in the browser's local storage.

Usage

1. Click the calendar icon in the sidebar to open the board

2. Click a day and start typing right in the cell (Enter keeps going, Esc exits)

3. Check an entry to complete it → chime + fireworks; hover for color, underline, delete

4. Header: ‹ › month, Today, + Add for today, Daily nudge, ✦ preview the fireworks, speaker to mute, ⟳ resync scheduled reminders

Agent access

The Host half is the canonical store, so every DSH session can read and edit the board through one tool — no browser scraping, no screenshots:

{ "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" }

| action | arguments | meaning |

| --- | --- | --- |

| list | date or from/to, includeDone | entries with id, date, time, title, done, repeat, color |

Every action answers with the same envelope: { "ok": true, ... } — list adds today, count and items; the others return the touched item or removed.

| add | title, optional date (defaults to today), time, repeat:"daily" | create an entry |