dsh-calendar 0.11.1 → 0.12.0

package/CHANGELOG.md

@@ -4,6 +4,19 @@
 
 [历史英文记录](docs/CHANGELOG.en.md)
 
+## 0.12.0（2026-10-25）
+
+- 日历主工作台，日期导航、月周议程切换与日程编辑分层更清楚。
+- 提供 DSH 原生侧栏入口，保留设置页；统一中英、深浅色、窄屏、键盘焦点与真实空/失败状态。
+- 浏览器源码移至 templates/client.js、templates/panels/ 与共享组件，独立构建为 lib/client.js；移除重复的首次引导。
+- 官方 DSH 0.2.1-rc.3 Web 逐项实际操作验收，账户模拟和未验收范围见 [工作台说明](docs/WORKBENCH.md)。
+
+## 0.11.2（2026-10-20）
+
+- 修复 #3：更新时间时保留原 TZID 对应的本地钟点和夏令时规则，不再写出 TZID 与 UTC `Z` 混用的属性。
+- 含 EXDATE、RDATE 或单次覆盖的系列，拒绝整体改开始时间、全天类型或重复规则，防止取消场次复活、改期场次重复。
+- 重复系列更新 / 删除必须显式传 `scope:"series"`；面板编辑先读取系列主记录，并提示影响全部场次，删除确认包含视图外场次。
+
 ## 0.11.1（2026-10-20）
 
 - 修复 calendar_update 传入空字符串时无法清空说明、地点或重复规则的问题；省略字段仍保留原值。

package/README.en.md

@@ -13,6 +13,8 @@ Feedback and contributions are welcome: report [issues](https://github.com/STARD
 
 See the [0.10.4 validation record](docs/validation/0.10.4.md) for DSH `0.2.1-alpha.5` browser checks and the remaining limits.
 
+Open the new native sidebar workbench after updating and restarting DSH. Settings remains available. See the [workbench guide and validation boundaries](docs/WORKBENCH.md).
+
 ## What it does
 
 - Month, week and agenda views with drag and keyboard rescheduling.

package/README.md

@@ -13,6 +13,8 @@
 
 DSH `0.2.1-alpha.5` 的本轮检查与未验收范围见 [0.10.4 验收记录](docs/validation/0.10.4.md)。
 
+更新并重启 DSH 后，可从原生侧栏打开新版工作台，原设置入口继续保留。详见[工作台说明与验收范围](docs/WORKBENCH.md)。
+
 ## 功能
 
 - 月、周与议程视图，支持拖拽和键盘改期。

package/docs/USAGE.md

@@ -4,6 +4,8 @@
 
 ## 本次改进
 
+重复系列的 `calendar_update` / `calendar_delete` 需先向用户说明影响，确认操作全部场次后传 `scope:"series"`。无法只改或删除某一次。面板编辑读取系列原始日期，删除确认覆盖整个系列。有取消、额外或单独改期场次的系列不能整体改开始时间、全天类型或重复规则，请在原日历客户端处理；描述、地点、标题仍可修改。带 TZID 的时间保留其本地钟点与夏令时语义。
+
 日期使用 YYYY-MM-DD；带时间使用带 Z 或 UTC 偏移的 ISO 格式。错误日期会在创建或更新远端日程前报错，原日程保留。
 
 ## 安装

package/docs/WORKBENCH.md

@@ -0,0 +1,29 @@
+# dsh-calendar 工作台 / Workbench
+
+日历主工作台，日期导航、月周议程切换与日程编辑分层更清楚。
+
+Calendar workbench with clearer date navigation, views and event editing.
+
+## 使用 / Use
+
+更新插件并重启 DSH，在原生左侧栏打开工作台；没有固定时可在“更多”中找到。原有“设置”入口继续可用。侧栏排序和固定由 DSH 管理。
+
+Update the plugin, restart DSH and open its native sidebar panel (or More if it is not pinned). The existing Settings entry remains available. DSH owns sidebar order and pinning.
+
+界面跟随宿主中英文和深浅色，保留用户内容原文。窄窗口中先显示列表，打开详情后可返回；编辑器按可用宽度分栏或顺序排列。危险操作需要明确确认，未保存内容不会因切页而静默丢失。
+
+The UI follows host language and theme without translating user content. Narrow master/detail views have a Back action; editors adapt their columns to available space. Destructive actions require confirmation and edits are protected.
+
+## 源码 / Source
+
+编辑 templates/client.js、templates/panels/*.js 与 templates/workbench-ui.js，运行 pnpm run build。lib/client.js 是确定性产物，请随源码提交。公共组件的规范源位于 dsh-suite/ui/workbench-ui.js，Suite 的同步脚本显式分发副本；单个仓库可独立构建和安装。
+
+Edit the template sources and run pnpm run build. Commit generated lib/client.js with source changes. The vendored UI has no Suite runtime dependency.
+
+## 验收范围 / Validation boundary
+
+2026-10-25：Windows、官方 DSH 0.2.1-rc.3 Web，后台 Chrome/Playwright 实际点击和输入；覆盖中英文、浅深色、1536px 与 390px、状态读回与控制台。Browser plugin 不可用，因此使用本地 Playwright。
+
+邮件使用受控 AgentMail HTTP 服务，日历使用受控 CalDAV 协议传输；插件处理器、存储、校验和原生宿主均实际运行。未使用真实邮箱、真实日历账号或付费模型。RSS 访问 Node.js 官方公开来源。PPT 实际生成并渲染 PPTX、下载 ZIP；两个视频插件实际运行官方引擎并播放 MP4。
+
+这些是 Web 共用界面的验收结果，不代表已验收 Electron 专属菜单、系统权限、真实账号、全部外部来源或所有可选模型/引擎。Docker、Slack、钉钉继续按用户约定搁置。

package/lib/caldav.d.ts

@@ -45,10 +45,12 @@ export declare class CalendarService {
     }>;
     /** Insert one already reviewed UID resource; tsdav uses If-None-Match:* and never overwrites existing objects. */
     importRaw(uid: string, data: string, signal?: AbortSignal): Promise<void>;
+    /** Read the resource master rather than a projected occurrence. */
+    get(uid: string, signal?: AbortSignal): Promise<CalendarEvent>;
     /** 按 uid 更新事件；未提供的字段保留原值。 */
-    update(uid: string, changes: Partial<EventFields>, signal?: AbortSignal): Promise<CalendarEvent>;
+    update(uid: string, changes: Partial<EventFields>, signal?: AbortSignal, scope?: 'series'): Promise<CalendarEvent>;
     /** 按 uid 删除事件。 */
-    delete(uid: string, signal?: AbortSignal): Promise<{
+    delete(uid: string, signal?: AbortSignal, scope?: 'series'): Promise<{
         uid: string;
         href: string;
     }>;

package/lib/caldav.js

@@ -9,7 +9,7 @@ import { createHash } from 'node:crypto';
 import ICAL from 'ical.js';
 import { createProxyFetch } from './proxy-fetch.js';
 import { createOAuthFetch, OAuthError } from './oauth.js';
-import { buildICalString, expandEventFromICal, ExpansionLimitError, generateUid, parseEventFromICal, updateICalString, } from './ical.js';
+import { buildICalString, expandEventFromICal, ExpansionLimitError, generateUid, parseEventFromICal, updateICalString, isRecurringResource, } from './ical.js';
 /** CalDAV 操作错误：带中文指引。 */
 export class CalDAVError extends Error {
     status;
@@ -279,8 +279,22 @@ export class CalendarService {
             throw translateError(error, '导入日程', this.config);
         }
     }
+    /** Read the resource master rather than a projected occurrence. */
+    async get(uid, signal) {
+        try {
+            const object = await this.findObject(uid, signal);
+            const event = object && parseEventFromICal(String(object.data ?? ''), object.url, object.etag);
+            if (!event)
+                throw new CalDAVError('找不到或无法解析日程，请刷新日历后重试。');
+            return event;
+        }
+        catch (error) {
+            signal?.throwIfAborted();
+            throw translateError(error, '读取系列事件', this.config);
+        }
+    }
     /** 按 uid 更新事件；未提供的字段保留原值。 */
-    async update(uid, changes, signal) {
+    async update(uid, changes, signal, scope) {
         signal?.throwIfAborted();
         let object;
         try {
@@ -295,6 +309,10 @@ export class CalendarService {
                 '该事件可能已被删除或 uid 已过期。');
         }
         const existing = parseEventFromICal(String(object.data ?? ''), object.url, object.etag);
+        if (!existing)
+            throw new CalDAVError('无法解析原日程，更新已取消；请在原日历客户端检查。');
+        if (isRecurringResource(String(object.data ?? '')) && scope !== 'series')
+            throw new CalDAVError('这是整个重复系列。请先向用户说明影响，确认后显式传 scope="series"；当前不支持只改某一次。');
         const start = changes.start ?? existing?.start;
         const end = changes.end ?? existing?.end;
         if (start === undefined || end === undefined) {
@@ -340,7 +358,7 @@ export class CalendarService {
         return event;
     }
     /** 按 uid 删除事件。 */
-    async delete(uid, signal) {
+    async delete(uid, signal, scope) {
         signal?.throwIfAborted();
         let object;
         try {
@@ -354,6 +372,8 @@ export class CalendarService {
             throw new CalDAVError('找不到 uid 对应的事件：请用 calendar_list 或 calendar_search 重新获取最新 uid，' +
                 '该事件可能已被删除或 uid 已过期。');
         }
+        if (isRecurringResource(String(object.data ?? '')) && scope !== 'series')
+            throw new CalDAVError('这是整个重复系列。请先向用户说明影响，确认后显式传 scope="series"；当前不支持只删某一次。');
         try {
             const client = await this.client();
             signal?.throwIfAborted();