dsh-calendar 0.2.0 → 0.2.2

package/README.md

@@ -101,7 +101,10 @@ iCloud：登录 appleid.apple.com → 登录与安全 → App 专用密码，生
 
 输入输出统一 ISO 8601。定时事件输出为 UTC（如 `2025-01-15T01:00:00Z`），全天事件输出 `YYYY-MM-DD`。输入可带时区偏移（如 `2025-01-15T09:00:00+08:00`），插件内部转 UTC 存储。
 
-## 已知限制
+## 已知限制
+
+- **国内网络**：Google（apidata.googleusercontent.com）与 iCloud（caldav.icloud.com）在中国大陆不可直连；请使用可达的 CalDAV 端点（自建 Nextcloud/Radicale 或代理）。
+
 
 - 重复事件展开：calendar_list 默认用 ICAL.RecurExpansion 展开 RRULE（`expand=true`），受 `maxOccurrences` 封顶；calendar_search 仍返回原始系列（不展开）。
 - 不支持单次实例的改/删：calendar_update / calendar_delete 针对整个重复系列（按 uid 操作），无法只修改或删除某一次发生（不支持 RECURRENCE-ID 实例级操作）。

package/lib/ical.d.ts

@@ -41,6 +41,8 @@ export interface EventFields {
     description?: string;
     location?: string;
     allDay?: boolean;
+    /** 重复规则（RFC 5545 RRULE 语法），如 FREQ=WEEKLY;COUNT=4。 */
+    rrule?: string;
     /** iCal UID；创建时缺省则自动生成，更新时用于保留原 UID。 */
     icalUid?: string;
 }

package/lib/ical.js

@@ -216,6 +216,18 @@ export function buildICalString(fields) {
     if (fields.location !== undefined && fields.location !== '') {
         vevent.addPropertyWithValue('location', fields.location);
     }
+    if (fields.rrule !== undefined && fields.rrule !== '') {
+        const rule = fields.rrule.trim();
+        if (!/^FREQ=/i.test(rule)) {
+            throw new Error('rrule 格式无效：' + fields.rrule + '（应为 RFC 5545 RRULE，如 FREQ=WEEKLY;COUNT=4）');
+        }
+        try {
+            vevent.addPropertyWithValue('rrule', ICAL.Recur.fromString(rule));
+        }
+        catch (error) {
+            throw new Error('rrule 格式无效：' + fields.rrule);
+        }
+    }
     vcal.addSubcomponent(vevent);
     return vcal.toString();
 }

package/lib/index.d.ts

@@ -9,6 +9,8 @@
  */
 import { type CalendarConfig } from './config.js';
 import { type CalendarToolDefinition } from './tools.js';
+/** cordis 服务注入：apply 里要用 ctx.tools，必须显式声明注入，否则宿主会抛 cannot get property without inject。 */
+export declare const inject: string[];
 /** 插件所需的最小 ctx 面（社区插件不依赖宿主内部类型）。 */
 export interface CalendarPluginContext {
     tools: {
@@ -22,7 +24,6 @@ export interface CalendarPluginContext {
  * @param config - 插件配置（可缺省）。
  */
 export declare function apply(ctx: CalendarPluginContext, config?: CalendarConfig | null): void;
-export default apply;
 export * from './parameters.js';
 export * from './config.js';
 export * from './ical.js';

package/lib/index.js

@@ -9,6 +9,8 @@
  */
 import { resolveConfig } from './config.js';
 import { buildCalendarTools } from './tools.js';
+/** cordis 服务注入：apply 里要用 ctx.tools，必须显式声明注入，否则宿主会抛 cannot get property without inject。 */
+export const inject = ['tools'];
 /**
  * 插件入口：惰性解析配置并注册五个日历工具。
  * @param ctx - 宿主上下文（至少含 tools.register）。
@@ -33,7 +35,6 @@ export function apply(ctx, config) {
         });
     }
 }
-export default apply;
 export * from './parameters.js';
 export * from './config.js';
 export * from './ical.js';

package/lib/tools.js

@@ -115,7 +115,7 @@ export function buildCalendarTools(config) {
     };
     const create = {
         name: 'calendar_create',
-        description: '新建一个日历事件。summary 与 start、end（ISO 8601，含时区偏移）为必填；description、location、allDay 可选。全天事件 start/end 用 YYYY-MM-DD 或设置 allDay=true。成功返回新事件的稳定标识 uid。',
+        description: '新建一个日历事件。summary 与 start、end（ISO 8601，含时区偏移）为必填；description、location、allDay、rrule 可选。全天事件 start/end 用 YYYY-MM-DD 或设置 allDay=true。成功返回新事件的稳定标识 uid。',
         parameters: compileParameters({
             summary: { type: 'string', required: true, description: '事件标题（必填）。' },
             start: { type: 'string', required: true, description: '开始时间（ISO 8601，含时区偏移，必填）。' },
@@ -123,6 +123,7 @@ export function buildCalendarTools(config) {
             description: { type: 'string', description: '事件描述（可选）。' },
             location: { type: 'string', description: '地点（可选）。' },
             allDay: { type: 'boolean', description: '是否全天事件（可选，默认 false）。' },
+            rrule: { type: 'string', description: '重复规则（可选，RFC 5545 RRULE 语法），如 FREQ=WEEKLY;COUNT=4；calendar_list 会按该规则展开实例。' },
         }),
         output: {
             schema: {
@@ -150,6 +151,7 @@ export function buildCalendarTools(config) {
                 ...(optionalString(input, 'description') !== undefined ? { description: optionalString(input, 'description') } : {}),
                 ...(optionalString(input, 'location') !== undefined ? { location: optionalString(input, 'location') } : {}),
                 ...(optionalBoolean(input, 'allDay') !== undefined ? { allDay: optionalBoolean(input, 'allDay') } : {}),
+                ...(optionalString(input, 'rrule') !== undefined ? { rrule: optionalString(input, 'rrule') } : {}),
             };
             const created = await service().create(fields);
             return { created };
@@ -167,6 +169,7 @@ export function buildCalendarTools(config) {
             description: { type: 'string', description: '新描述（可选）。' },
             location: { type: 'string', description: '新地点（可选）。' },
             allDay: { type: 'boolean', description: '是否全天事件（可选）。' },
+            rrule: { type: 'string', description: '新的重复规则（可选）。' },
         }),
         output: {
             schema: {
@@ -206,6 +209,9 @@ export function buildCalendarTools(config) {
             const allDay = optionalBoolean(input, 'allDay');
             if (allDay !== undefined)
                 changes.allDay = allDay;
+            const rrule = optionalString(input, 'rrule');
+            if (rrule !== undefined)
+                changes.rrule = rrule;
             const updated = await service().update(uid, changes);
             return { updated };
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-calendar",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "DSH 日历工具插件：通过 CalDAV 读写日历事件（Google / iCloud / Nextcloud / 自定义）",
   "type": "module",
   "main": "lib/index.js",