@1agents/dsh-plugin-todo 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -32,11 +32,18 @@ macOS 的隐私授权按「责任进程」判定,而不是看实际读数据
32
32
  前提:Apple 芯片的 macOS、Node.js 20 或以上、已安装的 DeepSeek Harness。提醒事项和日历只在这台 Mac 上读写。当前发布的原生程序是 arm64,Intel Mac 不能安装。
33
33
 
34
34
  ```sh
35
- dsh plugin --profile web add @1agents/dsh-plugin-todo@0.1.2
35
+ dsh plugin --profile web add @1agents/dsh-plugin-todo@0.1.4
36
36
  ```
37
37
 
38
38
  装完后重启 DSH。左侧栏「历史会话」上方出现「日程」。Host 启动时会把 MCP 登记到 `127.0.0.1:36908`。网关没在跑时,页面仍可用,Agent 搜索不到工具。当前这个对话窗口走的是 desktop profile;要在 `dsh web`(默认 `http://127.0.0.1:3080`)里看到,安装目标是 web profile。
39
39
 
40
+ ### 技能会自动装好
41
+
42
+ 安装时会把使用说明写到 `~/.dsh/skills/ios-agenda/SKILL.md`,DSH 会自动加载,Agent 之后处理日程和待办时会自己读到它。
43
+
44
+ - 走 `postinstall`;如果 pnpm 忽略了依赖的 install 脚本(默认会忽略),插件启动时会再补写一次,两条路都幂等。
45
+ - 想手动来一次:`node node_modules/@1agents/dsh-plugin-todo/scripts/install-skill.mjs`。
46
+
40
47
  从源码安装时,先完成本地构建,再把仓库目录加进 profile:
41
48
 
42
49
  ```sh
@@ -13,9 +13,9 @@
13
13
  <key>CFBundlePackageType</key>
14
14
  <string>APPL</string>
15
15
  <key>CFBundleVersion</key>
16
- <string>0.1.2</string>
16
+ <string>0.1.4</string>
17
17
  <key>CFBundleShortVersionString</key>
18
- <string>0.1.2</string>
18
+ <string>0.1.4</string>
19
19
  <key>LSUIElement</key>
20
20
  <true/>
21
21
  <key>NSCalendarsUsageDescription</key>
package/dist/client.js CHANGED
@@ -30,7 +30,7 @@ var import_react = require("react");
30
30
  var SERVICE = "iosAgenda";
31
31
  var PACKAGE = "@1agents/dsh-plugin-todo";
32
32
  var PANEL_ID = "ios-agenda";
33
- var METHODS = ["authorize", "snapshot", "createReminder", "completeReminder", "deleteReminder", "createEvent", "deleteEvent"];
33
+ var METHODS = ["authorize", "snapshot", "createReminder", "updateReminder", "completeReminder", "deleteReminder", "createEvent", "updateEvent", "deleteEvent"];
34
34
  function objectOf(value) {
35
35
  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
36
36
  return value;
package/dist/host.js CHANGED
@@ -1,7 +1,7 @@
1
1
  // src/contract.js
2
2
  var SERVICE = "iosAgenda";
3
3
  var PACKAGE = "@1agents/dsh-plugin-todo";
4
- var METHODS = ["authorize", "snapshot", "createReminder", "completeReminder", "deleteReminder", "createEvent", "deleteEvent"];
4
+ var METHODS = ["authorize", "snapshot", "createReminder", "updateReminder", "completeReminder", "deleteReminder", "createEvent", "updateEvent", "deleteEvent"];
5
5
  function objectOf(value) {
6
6
  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
7
7
  return value;
@@ -31,6 +31,9 @@ var contribution = {
31
31
  }))
32
32
  };
33
33
 
34
+ // src/host.js
35
+ import { fileURLToPath as fileURLToPath3 } from "node:url";
36
+
34
37
  // src/native.js
35
38
  import { spawn } from "node:child_process";
36
39
  import { constants } from "node:fs";
@@ -150,7 +153,7 @@ import { homedir } from "node:os";
150
153
  import { join as join2 } from "node:path";
151
154
  var SOURCE = "ios-agenda";
152
155
  function run(args, input) {
153
- return new Promise((resolve2) => {
156
+ return new Promise((resolve3) => {
154
157
  const child = spawn2("dreammate-node", args, { stdio: ["pipe", "pipe", "pipe"] });
155
158
  let stdout = "";
156
159
  let stderr = "";
@@ -162,8 +165,8 @@ function run(args, input) {
162
165
  child.stderr.on("data", (chunk) => {
163
166
  stderr += chunk;
164
167
  });
165
- child.on("error", (error) => resolve2({ code: 127, stdout, stderr: error.message }));
166
- child.on("close", (code) => resolve2({ code: code ?? 1, stdout, stderr }));
168
+ child.on("error", (error) => resolve3({ code: 127, stdout, stderr: error.message }));
169
+ child.on("close", (code) => resolve3({ code: code ?? 1, stdout, stderr }));
167
170
  if (input) child.stdin.end(input);
168
171
  else child.stdin.end();
169
172
  });
@@ -196,10 +199,44 @@ ${removed.stderr}`)) {
196
199
  return { ok: true, changed: true };
197
200
  }
198
201
 
202
+ // src/skill-install.js
203
+ import { mkdir, readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
204
+ import { homedir as homedir2 } from "node:os";
205
+ import { dirname, join as join3, resolve as resolve2 } from "node:path";
206
+ import { fileURLToPath as fileURLToPath2 } from "node:url";
207
+ var SKILL_NAME = "ios-agenda";
208
+ function skillsRoot() {
209
+ return join3(process.env.DSH_HOME || join3(homedir2(), ".dsh"), "skills");
210
+ }
211
+ async function installSkill(packageRoot2 = resolve2(dirname(fileURLToPath2(import.meta.url)), "..")) {
212
+ const source = join3(packageRoot2, "skills", SKILL_NAME, "SKILL.md");
213
+ const target = join3(skillsRoot(), SKILL_NAME, "SKILL.md");
214
+ let content;
215
+ try {
216
+ content = await readFile3(source, "utf8");
217
+ } catch {
218
+ return { ok: false, reason: `\u5305\u5185\u7F3A\u5C11\u6280\u80FD\u6587\u4EF6\uFF1A${source}`, target };
219
+ }
220
+ try {
221
+ if (await readFile3(target, "utf8") === content) return { ok: true, changed: false, target };
222
+ } catch {
223
+ }
224
+ try {
225
+ await mkdir(dirname(target), { recursive: true });
226
+ await writeFile2(target, content, "utf8");
227
+ return { ok: true, changed: true, target };
228
+ } catch (error) {
229
+ return { ok: false, reason: error instanceof Error ? error.message : String(error), target };
230
+ }
231
+ }
232
+
199
233
  // src/host.js
200
234
  var name = "ios-agenda";
201
235
  var inject = ["typert"];
202
236
  var binary = binaryPath();
237
+ function packageRoot() {
238
+ return fileURLToPath3(new URL("..", import.meta.url));
239
+ }
203
240
  function failure(code, message) {
204
241
  return { ok: false, error: { code, message } };
205
242
  }
@@ -227,6 +264,10 @@ function apply(ctx) {
227
264
  registerMcp(binary).then((result) => {
228
265
  if (!result.ok) console.error(`[ios-agenda] \u672A\u80FD\u767B\u8BB0 dreammate MCP\uFF1A${result.error}`);
229
266
  });
267
+ installSkill(packageRoot()).then((result) => {
268
+ if (result.ok && result.changed) console.log(`[ios-agenda] \u6280\u80FD\u5DF2\u5199\u5165 ${result.target}`);
269
+ if (!result.ok) console.error(`[ios-agenda] \u6280\u80FD\u6CA1\u80FD\u5199\u5165 ${result.target}\uFF1A${result.reason}`);
270
+ });
230
271
  }
231
272
  export {
232
273
  apply,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@1agents/dsh-plugin-todo",
3
- "version": "0.1.2",
3
+ "version": "0.1.4",
4
4
  "description": "管理本机已同步的系统提醒事项和日历。页面在 DSH,工具在 dreammate-node MCP。",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -36,6 +36,7 @@
36
36
  "dist/client.js",
37
37
  "dist/IosAgenda.app",
38
38
  "bin",
39
+ "scripts/install-skill.mjs",
39
40
  "skills/ios-agenda",
40
41
  "cordis.patch.yml",
41
42
  "LICENSE",
@@ -58,6 +59,7 @@
58
59
  },
59
60
  "scripts": {
60
61
  "build": "node scripts/build.mjs",
62
+ "postinstall": "node scripts/install-skill.mjs",
61
63
  "test": "node --test tests/protocol.test.mjs"
62
64
  },
63
65
  "devDependencies": {
@@ -0,0 +1,30 @@
1
+ #!/usr/bin/env node
2
+ // 安装时把技能放进 ~/.dsh/skills,DSH 才会加载到它。
3
+ // pnpm 默认会忽略依赖的 install 脚本;那种情况下由插件启动时补齐,这里失败也不阻断安装。
4
+ import { mkdir, readFile, writeFile } from 'node:fs/promises';
5
+ import { homedir } from 'node:os';
6
+ import { dirname, join, resolve } from 'node:path';
7
+ import { fileURLToPath } from 'node:url';
8
+
9
+ const SKILL_NAME = 'ios-agenda';
10
+ const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
11
+ const skillsRoot = join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'skills');
12
+ const source = join(packageRoot, 'skills', SKILL_NAME, 'SKILL.md');
13
+ const target = join(skillsRoot, SKILL_NAME, 'SKILL.md');
14
+
15
+ try {
16
+ const content = await readFile(source, 'utf8');
17
+ let current = '';
18
+ try {
19
+ current = await readFile(target, 'utf8');
20
+ } catch {
21
+ // 还没有,直接写。
22
+ }
23
+ if (current !== content) {
24
+ await mkdir(dirname(target), { recursive: true });
25
+ await writeFile(target, content, 'utf8');
26
+ console.log(`[ios-agenda] 技能已安装到 ${target}`);
27
+ }
28
+ } catch (error) {
29
+ console.warn(`[ios-agenda] 技能没能自动安装(${error.message})。DSH 启动插件时会再试一次。`);
30
+ }
@@ -1,20 +1,113 @@
1
1
  ---
2
2
  name: ios-agenda
3
- description: 通过 dreammate-node 管理这台 Mac 上已同步的系统提醒事项和日历。用户要查看、新建、完成或删除待办和日程时使用。不要把这些工具注册到 DSH。
3
+ description: 操作这台 Mac 上已和 iPhone 同步的系统「提醒事项」和「日历」,以及 DSH 侧栏里那个「日程」页面。用户要看今天/本周安排、列出待办、新建或修改提醒与日程、标记完成、删除条目、查某个列表或日历、纠结授权没生效时使用。只要涉及日程、待办、提醒事项、日历、开会排期、截止时间,先读这个技能再动手,不要凭印象编造参数。
4
4
  ---
5
5
 
6
6
  # 本机提醒事项与日历
7
7
 
8
- 数据在这台 Mac 的系统「提醒事项」和「日历」里,经 iCloud 同步到 iPhone。工具不在 DSH 里,在 dreammate-node 的 `mcp-ios-agenda`。
8
+ 数据源是这台 Mac 的 EventKit(系统「提醒事项」和「日历」),经 iCloud 与 iPhone 双向同步。写入后不会立刻出现在手机上,要等 Apple 云端同步。
9
9
 
10
- 先搜索再读契约再调用:
10
+ 有两种用法,别混:
11
+
12
+ - **页面**:DSH 左侧栏的「日程」,给人看和点。
13
+ - **工具**:`dreammate-node` 里的 MCP 服务 `mcp-ios-agenda`,给 Agent 调。不要在 DSH 里重复注册同名工具。
14
+
15
+ ## 先确认能用
16
+
17
+ ```sh
18
+ dreammate-node cli inspect --agent http://127.0.0.1:36908 --service mcp-ios-agenda
19
+ ```
20
+
21
+ 能看到 9 个方法就说明服务在线。服务不在时不要自己乱猜原因,先看第 5 节。
22
+
23
+ 调用顺序是 搜索 → 读契约 → 调用。方法参数以 `inspect` 返回的 Schema 为准,本文只给要点。
24
+
25
+ ## 1. 九个工具
26
+
27
+ | 工具 | 用途 | 必填 | 要点 |
28
+ | --- | --- | --- | --- |
29
+ | `agenda_authorize` | 请求日历与提醒权限 | 无 | 未决定时弹系统框,已被拒时打开系统设置 |
30
+ | `agenda_snapshot` | 读提醒 + 日程 | 无 | `from`/`to` 限范围,`reminderList`/`calendar` 按列表或日历过滤,`includeCompleted` 连已完成一起返回 |
31
+ | `agenda_create_reminder` | 新建提醒 | `title` | 可选 `list` `notes` `due` `priority` |
32
+ | `agenda_update_reminder` | 改提醒 | `id` | 只改传入字段;`notes`/`due` 传空字符串即清空;可换 `list`、改 `completed` |
33
+ | `agenda_complete_reminder` | 只翻完成状态 | `id` | 等价于 `update_reminder` 只传 `completed`,日常优先用 update |
34
+ | `agenda_delete_reminder` | 删提醒 | `id` | 不可恢复 |
35
+ | `agenda_create_event` | 新建日程 | `title` `start` `end` | 起止都只给日期时按全天;可选 `calendar` `notes` `location` |
36
+ | `agenda_update_event` | 改日程 | `id` | 只改传入字段;只传 `start` 会保持原时长;`span` 取 `thisEvent`(默认)或 `futureEvents` |
37
+ | `agenda_delete_event` | 删日程 | `id` | 不可恢复 |
38
+
39
+ 时间一律 ISO 8601,例如 `2026-11-20T14:00:00+08:00`;只给日期 `2026-11-20` 表示全天。
40
+
41
+ ## 2. 典型调用
11
42
 
12
43
  ```sh
13
- dreammate-node cli search --agent http://127.0.0.1:36908 --query '提醒事项 日历'
14
- dreammate-node cli inspect --agent http://127.0.0.1:36908 --service mcp-ios-agenda --method agenda_snapshot
15
- dreammate-node cli invoke --agent http://127.0.0.1:36908 --service mcp-ios-agenda --method agenda_snapshot --params '{}'
44
+ # 今天到本周末的安排
45
+ dreammate-node cli invoke --agent http://127.0.0.1:36908 --service mcp-ios-agenda \
46
+ --method agenda_snapshot --params '{"from":"2026-11-13","to":"2026-11-16"}'
47
+
48
+ # 新建一个提醒(指定列表和截止时间)
49
+ dreammate-node cli invoke --agent http://127.0.0.1:36908 --service mcp-ios-agenda \
50
+ --method agenda_create_reminder \
51
+ --params '{"title":"交季度报表","list":"工作待办","due":"2026-11-20T18:00:00+08:00"}'
52
+
53
+ # 改期并清掉备注
54
+ dreammate-node cli invoke --agent http://127.0.0.1:36908 --service mcp-ios-agenda \
55
+ --method agenda_update_reminder \
56
+ --params '{"id":"<id>","due":"2026-11-21T18:00:00+08:00","notes":""}'
57
+
58
+ # 挪一次会议(只改开始时间,时长不变)
59
+ dreammate-node cli invoke --agent http://127.0.0.1:36908 --service mcp-ios-agenda \
60
+ --method agenda_update_event --params '{"id":"<id>","start":"2026-11-14T10:00:00+08:00"}'
16
61
  ```
17
62
 
18
- 方法以 inspect 返回的 Schema 为准。常用的是 `agenda_snapshot`、`agenda_create_reminder`、`agenda_complete_reminder`、`agenda_create_event`。没有访问权限时先调用 `agenda_authorize`:还没决定会弹出系统授权框,已经被拒绝会打开系统设置。写入后不会立刻出现在手机上,要等 iCloud 同步。
63
+ `id` 从 `agenda_snapshot` 的结果里取,REST 里没有按标题搜索。条目多时先用 `from`/`to` 或 `reminderList`/`calendar` 缩小范围。
64
+
65
+ ## 3. 操作纪律
66
+
67
+ - 改之前先读一次拿到 `id` 和当前值,别凭用户描述里的旧标题去猜 id。
68
+ - `delete_*` 不可恢复。用户说「删掉」时如果有多条同名,先列出来让他选,别挑第一条。
69
+ - 批量清理测试数据时,只删自己刚创建的 `id`。**不要用标题关键词批量匹配**——用户真实待办的标题里也可能含「测试」这类字。
70
+ - 写入报告给用户时带上标题和最终时间,方便他核对。
71
+
72
+ ## 4. 页面怎么用
73
+
74
+ 侧栏「日程」打开后分两栏:
75
+
76
+ - **左侧月历**:切日期,周一为一周开始。今天描边;有日程的点用日历色,有提醒的点用列表色。下面「逾期 N」「无日期 N」可跳转。
77
+ - **右侧看板**:默认只看选中的那一天,有钟点的排前面、全天在后;「本周」铺成 7 列。
78
+ - **筛选项**:列表和日历各一组多选。勾上才显示,取消的会滑到本组底部;选择会记住,下次打开还在。
79
+ - **新建**:底部输入框回车加提醒;「新日程」展开后可填起止时间。
80
+
81
+ ## 5. 授权与疑难
82
+
83
+ 插件读 EventKit 需要系统授权,macOS 按**责任进程**判定:
84
+
85
+ - 页面和 MCP 都通过 LaunchServices(`open -a IosAgenda.app`)调起原生程序,这样 app 才是自己的责任进程。宿主直接 spawn 包内二进制会被记到 DSH 名下,权限静默变成 `notDetermined`,既不弹框也读不到数据。
86
+ - 因此需要图形登录会话;纯 ssh 环境跑不了。
87
+ - 每次调用要经 LaunchServices 起实例:首次约 3 秒,之后约 150 毫秒。
88
+
89
+ 权限出问题时的处理顺序:
90
+
91
+ 1. 调 `agenda_authorize`。返回 `granted: true` 就直接重试读取。
92
+ 2. 返回里 `openedSettings: true` 说明已经跳到系统设置的对应开关,让用户打开,再刷新页面或重试。
93
+ 3. 页面顶部出现授权卡片时,点「授权」;若按钮显示「打开系统设置」,说明之前被拒过。
94
+
95
+ **重新签名会让授权失效。** 本地 `npm run build` 或升级插件后,`IosAgenda.app` 的签名变了,需要重新允许一次。这是 ad-hoc 签名的固有代价,不是 bug。
96
+
97
+ 其他限制:
98
+
99
+ - 只支持 Apple 芯片 macOS(包里是 arm64),Intel 机器装不了。
100
+ - 换一台 Mac 后首次使用要重新授权。
101
+ - MCP 由 `dreammate-node` 拉起,如果工具列表还是旧版(比如少了 `agenda_update_*`),重连一次:
102
+ ```sh
103
+ dreammate-node mcp remove mcp-ios-agenda
104
+ dreammate-node mcp add --config '{"mcpServers":{"ios-agenda":{"command":"<profile>/node_modules/@1agents/dsh-plugin-todo/dist/IosAgenda.app/Contents/MacOS/ios-agenda","args":["mcp"],"sharing":"local"}}}'
105
+ ```
106
+
107
+ ## 6. 安装与升级
108
+
109
+ ```sh
110
+ dsh plugin --profile web add @1agents/dsh-plugin-todo@0.1.4
111
+ ```
19
112
 
20
- 没有来源时,先在插件仓库执行 `npm run build`,再由 DSH 启用插件,或手动 `dreammate-node mcp add`。来源范围是 `local`。
113
+ 装完重启 DSH,侧栏出现「日程」。本技能会由插件安装时自动放到 `~/.dsh/skills/ios-agenda/`;如果没生效,从包目录手动复制一次即可。