@magma27/dsh-calendar

Calendar

适用于 dsh Web GUI 的日历待办插件：提供侧边栏入口和周/月视图日历，可拖选时间范围来创建任务，并支持艾森豪威尔紧急性/重要性象限、子任务、固定执行会话与 LLM 提供商，以及主机权威模式

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add @magma27/dsh-calendar@0.1.6

兼容性与来源证明

Calendar 以 @magma27/dsh-calendar 发布，当前版本为 0.1.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: npm
Registry 更新时间: 2026/9/20

版本

0.1.6stable

2026/9/17

0.1.5stable

2026/9/4

0.1.4stable

2026/8/22

查看其余 4 个版本收起版本

0.1.3stable

2026/8/21

0.1.2stable

2026/8/21

0.1.1stable

2026/8/21

0.1.0stable

2026/8/21

README

📅 dsh-calendar

Host-authoritative calendar and scheduled Agent runs for DSH Web

简体中文

[!NOTE] dsh-calendar is a DSH Web plugin, not a standalone calendar app. Install it into a DSH profile so the Host can own the task ledger, schedule Agents, and settle execution records.

[!NOTE] The current source targets DSH 0.1.2-rc.1. This release no longer provides the legacy apiProxy; the plugin adapts the current Host services (sessionController, workspaceRegistry, agentPresets, commands) at its Host boundary.

dsh-calendar is a DSH Web calendar and Agent task plugin. Use it to plan todos, arrange time, schedule one-off or recurring Agent runs, and let Agents create and manage tasks through calendar_task. Agents can also review your calendar tasks and execution history to help reflect on your plans and progress.

Preview

Week view _{Week view}	Month view _{Month view}
Matrix view _{Matrix view}	Agenda view _{Agenda view}

Features

Create and arrange timed tasks with drag-and-drop calendar views.
Week, month, agenda, and Eisenhower matrix views.
Set urgency and importance levels, manage subtasks, and complete tasks directly with a checkbox.
Schedule one-off or daily/weekly Agent runs, with optional weekend and holiday skipping.
Configure each Agent run with a workspace, session, provider/model, Agent preset, and permission preset.
The calendar_task tool lets Agents create, query, update, delete, and schedule tasks through the same Host ledger.
Host-authoritative task ledger and execution records that stay consistent across browser refreshes.

Agent tool: `calendar_task`

calendar_task is the model-facing interface for managing calendar tasks. Pass one action per call; all mutations use the same Host ledger as the calendar UI.

Time fields are intentionally separate: startAt/endAt define the calendar block, dueAt is a one-off absolute Agent trigger, and repeat with triggerAgent and optional triggerAt defines recurring triggers. There is no scheduleAt parameter.

Action	Purpose
`options`	List available workspaces, sessions, providers, models, and modes.
`create`	Create a task, optionally with execution settings and a schedule.
`get`	Read one task and its execution summary.
`list`	Query and filter tasks or execution records.
`update`	Edit a task's title, time, content, or execution settings.
`setQuadrant`	Set the task's urgency and importance.
`setDone`	Mark a task complete or incomplete.
`addSubtask`	Add a checklist subtask.
`setSubtaskDone`	Mark a subtask complete or incomplete.
`removeSubtask`	Remove a subtask.
`setSchedule`	Add, change, or clear a one-off or daily/weekly schedule.
`run`	Start an Agent run immediately.
`delete`	Delete a task.

Install from npm

This is a DSH plugin, not a standalone calendar app. Install it into the DSH Web profile so DSH can load its Host and client bundle:

# DSH delegates profile plugin management to pnpm; install it once if needed
npm install --global pnpm

# Install the published package into the DSH Web profile
dsh plugin --profile web add '@magma27/dsh-calendar'

# Restart the Web profile after installation or upgrade
dsh web

Check the composed profile:

dsh --profile web --dump-config

Upgrade or remove it with:

dsh plugin --profile web update '@magma27/dsh-calendar'
dsh plugin --profile web remove '@magma27/dsh-calendar'

Install from source

pnpm install
pnpm typecheck
pnpm test
pnpm build

# Mount the local checkout into the DSH Web profile
dsh plugin --profile web add link:<path-to-dsh-calendar>

# Restart DSH Web; a browser refresh does not replace the Host bundle
dsh web

Runtime model and safety

The calendar UI submits actions and renders Host snapshots; it does not own or mutate the task ledger directly.
calendar_task is available to Agents for creating, querying, updating, and deleting calendar tasks. sessionId: "current" pins a task to the calling Agent session.
A blank triggerAt follows the task block start; an explicit absolute trigger time remains decoupled from later block moves.
On Host recovery, missed one-off due times are marked failed and not replayed. Missed repeat dates are not materialized for catch-up execution.
Scheduled execution consumes real LLM API quota. The Host rejects incomplete provider/model pins and child auto-run schedules beyond the configured recursion depth.
The Host ledger lock records its owner; after an abnormal shutdown, a lock whose PID is no longer alive is reclaimed on the next startup, while live or unverifiable locks remain fail-closed.
The default ledger path is $DSH_HOME/calendar/ledger-v1.json. Keep local ledgers, logs, and profile directories out of Git.

Development

pnpm typecheck
pnpm test
pnpm build

The repository is organized as follows:

src/core/       pure domain models and repeat-rule logic
src/host-*.ts   Host ledger, routes, scheduler, and runner
src/client/     calendar views, forms, and Host transport
tests/          core, Host, and client tests

Update log

Date	Summary
2026-09-17	Added stale ledger-lock recovery after abnormal shutdown, with live-owner checks and legacy lock compatibility.
2026-09-04	Documented the DSH `0.1.2-rc.1` Host-service adapter migration and refreshed the related install, build, and runtime notes.

License

README

📅 dsh-calendar

Host-authoritative calendar and scheduled Agent runs for DSH Web

简体中文

[!NOTE] dsh-calendar is a DSH Web plugin, not a standalone calendar app. Install it into a DSH profile so the Host can own the task ledger, schedule Agents, and settle execution records.

[!NOTE] The current source targets DSH 0.1.2-rc.1. This release no longer provides the legacy apiProxy; the plugin adapts the current Host services (sessionController, workspaceRegistry, agentPresets, commands) at its Host boundary.

Preview

Week view _{Week view}	Month view _{Month view}
Matrix view _{Matrix view}	Agenda view _{Agenda view}

Features

Create and arrange timed tasks with drag-and-drop calendar views.
Week, month, agenda, and Eisenhower matrix views.
Set urgency and importance levels, manage subtasks, and complete tasks directly with a checkbox.
Schedule one-off or daily/weekly Agent runs, with optional weekend and holiday skipping.
Configure each Agent run with a workspace, session, provider/model, Agent preset, and permission preset.
The calendar_task tool lets Agents create, query, update, delete, and schedule tasks through the same Host ledger.
Host-authoritative task ledger and execution records that stay consistent across browser refreshes.

Agent tool: `calendar_task`

calendar_task is the model-facing interface for managing calendar tasks. Pass one action per call; all mutations use the same Host ledger as the calendar UI.

Action	Purpose
`options`	List available workspaces, sessions, providers, models, and modes.
`create`	Create a task, optionally with execution settings and a schedule.
`get`	Read one task and its execution summary.
`list`	Query and filter tasks or execution records.
`update`	Edit a task's title, time, content, or execution settings.
`setQuadrant`	Set the task's urgency and importance.
`setDone`	Mark a task complete or incomplete.
`addSubtask`	Add a checklist subtask.
`setSubtaskDone`	Mark a subtask complete or incomplete.
`removeSubtask`	Remove a subtask.
`setSchedule`	Add, change, or clear a one-off or daily/weekly schedule.
`run`	Start an Agent run immediately.
`delete`	Delete a task.

Install from npm

This is a DSH plugin, not a standalone calendar app. Install it into the DSH Web profile so DSH can load its Host and client bundle:

# DSH delegates profile plugin management to pnpm; install it once if needed
npm install --global pnpm

# Install the published package into the DSH Web profile
dsh plugin --profile web add '@magma27/dsh-calendar'

# Restart the Web profile after installation or upgrade
dsh web

Check the composed profile:

dsh --profile web --dump-config

Upgrade or remove it with:

dsh plugin --profile web update '@magma27/dsh-calendar'
dsh plugin --profile web remove '@magma27/dsh-calendar'

Install from source

pnpm install
pnpm typecheck
pnpm test
pnpm build

# Mount the local checkout into the DSH Web profile
dsh plugin --profile web add link:<path-to-dsh-calendar>

# Restart DSH Web; a browser refresh does not replace the Host bundle
dsh web

Runtime model and safety

The calendar UI submits actions and renders Host snapshots; it does not own or mutate the task ledger directly.
calendar_task is available to Agents for creating, querying, updating, and deleting calendar tasks. sessionId: "current" pins a task to the calling Agent session.
A blank triggerAt follows the task block start; an explicit absolute trigger time remains decoupled from later block moves.
On Host recovery, missed one-off due times are marked failed and not replayed. Missed repeat dates are not materialized for catch-up execution.
Scheduled execution consumes real LLM API quota. The Host rejects incomplete provider/model pins and child auto-run schedules beyond the configured recursion depth.
The Host ledger lock records its owner; after an abnormal shutdown, a lock whose PID is no longer alive is reclaimed on the next startup, while live or unverifiable locks remain fail-closed.
The default ledger path is $DSH_HOME/calendar/ledger-v1.json. Keep local ledgers, logs, and profile directories out of Git.

Development

pnpm typecheck
pnpm test
pnpm build

The repository is organized as follows:

src/core/       pure domain models and repeat-rule logic
src/host-*.ts   Host ledger, routes, scheduler, and runner
src/client/     calendar views, forms, and Host transport
tests/          core, Host, and client tests

Update log

Date	Summary
2026-09-17	Added stale ledger-lock recovery after abnormal shutdown, with live-owner checks and legacy lock compatibility.
2026-09-04	Documented the DSH `0.1.2-rc.1` Host-service adapter migration and refreshed the related install, build, and runtime notes.

Calendar

兼容性与来源证明

版本

相关插件

Calendar

README

📅 dsh-calendar

Preview

Features

Agent tool: calendar_task

Install from npm

Install from source

Runtime model and safety

Development

Update log

License

兼容性与来源证明

版本

相关插件

相关插件

README

📅 dsh-calendar

Preview

Features

Agent tool: calendar_task

Install from npm

Install from source

Runtime model and safety

Development

Update log

License

相关插件

Agent tool: `calendar_task`

Agent tool: `calendar_task`