@downcity/plugins 1.0.4

package/bin/task/Index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Task plugin 静态导出入口。
+ *
+ * 关键点（中文）
+ * - Index 只保留导出职责，不再承载 task plugin 的具体实现。
+ * - 真正的类实现收敛到 `TaskPlugin.ts`。
+ */
+export { TaskPlugin } from "./TaskPlugin.js";
+//# sourceMappingURL=Index.d.ts.map

package/bin/task/Index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.d.ts","sourceRoot":"","sources":["../../src/task/Index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/bin/task/Index.js

@@ -0,0 +1,9 @@
+/**
+ * Task plugin 静态导出入口。
+ *
+ * 关键点（中文）
+ * - Index 只保留导出职责，不再承载 task plugin 的具体实现。
+ * - 真正的类实现收敛到 `TaskPlugin.ts`。
+ */
+export { TaskPlugin } from "./TaskPlugin.js";
+//# sourceMappingURL=Index.js.map

package/bin/task/Index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.js","sourceRoot":"","sources":["../../src/task/Index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/bin/task/PROMPT.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+declare const TEXT_MODULE_CONTENT = "# Task Plugin\n\n\u4F60\u53EF\u4EE5\u901A\u8FC7 `task` plugin \u7BA1\u7406\u4EFB\u52A1\u5B9A\u4E49\u3001\u6267\u884C\u3001\u8C03\u5EA6\u4E0E\u72B6\u6001\u63A7\u5236\u3002\n\n## \u4EFB\u52A1\u6A21\u578B\n\n\u6BCF\u4E2A\u4EFB\u52A1\u5B9A\u4E49\u5728 `./.downcity/task/<title>/task.md`\uFF0C\u5305\u542B\uFF1A\n- frontmatter\uFF08\u7ED3\u6784\u5316\u5B57\u6BB5\uFF09\n- body\uFF08\u4EFB\u52A1\u6B63\u6587\uFF09\n\nfrontmatter \u6838\u5FC3\u5B57\u6BB5\uFF1A\n- `title`\uFF1A\u4EFB\u52A1\u552F\u4E00\u6807\u8BC6\uFF08\u552F\u4E00\uFF09\n- `description`\uFF1A\u4EFB\u52A1\u63CF\u8FF0\n- `when`\uFF1A\u89E6\u53D1\u6761\u4EF6\uFF0C\u652F\u6301\uFF1A`@manual` / cron / `time:<ISO8601-with-timezone>`\n- `sessionId`\uFF1A\u4EFB\u52A1\u6267\u884C\u4F1A\u8BDD\n- `status`\uFF1A`enabled|paused|disabled`\n- `kind`\uFF1A`agent|script`\uFF08\u9ED8\u8BA4 `agent`\uFF09\n\n\u6267\u884C\u65F6\u4F1A\u4EA7\u751F run \u76EE\u5F55\uFF1A\n- `./.downcity/task/<title>/<timestamp>/`\n\n\u5E38\u89C1\u4EA7\u7269\uFF1A\n- `input.md`\n- `output.md`\uFF08\u672C\u6B21\u4EFB\u52A1\u7684\u6700\u7EC8\u8F93\u51FA\u6B63\u6587\uFF09\n- `result.md`\uFF08\u6267\u884C\u6458\u8981\uFF09\n- `run.json`\n- `run-progress.json`\n- `dialogue.md` / `dialogue.json`\uFF08agent \u591A\u8F6E\uFF09\n- `error.md`\uFF08\u5931\u8D25\u65F6\uFF09\n\n## \u6267\u884C\u7C7B\u578B\uFF08kind\uFF09\n\n1. `kind=agent`\n- \u5C06\u6B63\u6587\u4EA4\u7ED9 agent \u6267\u884C\n- \u9ED8\u8BA4\u5355\u8F6E\u5B8C\u6210\uFF1B\u4EC5\u5F53 frontmatter \u663E\u5F0F\u8BBE\u7F6E `review: true` \u65F6\u542F\u7528\u6A21\u62DF\u7528\u6237\u591A\u8F6E\u590D\u6838\n- \u9002\u5408\u7814\u7A76\u3001\u5206\u6790\u3001\u62A5\u544A\u751F\u6210\n\n2. `kind=script`\n- \u5C06\u6B63\u6587\u5F53\u4F5C shell \u811A\u672C\u6267\u884C\n- \u6B63\u6587\u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u5FC5\u987B\u662F\u53EF\u6267\u884C\u811A\u672C\n\n## \u53EF\u7528 action\n\n- `list`\n- `create`\n- `run`\n- `delete`\n- `update`\n- `status`\n- `enable`\n- `disable`\n\n## CLI \u793A\u4F8B\n\n- `city task list [--status enabled|paused|disabled]`\n- `city task create --title '...' --description '...' --session-id <sessionId> [--when '@manual'] [--kind agent|script] [--status ...|--activate]`\n- `city task run <title> [--reason '...']`\n- `city task update <title> [--title ...] [--description ...] [--when ...] [--status ...|--activate] [--session-id ...]`\n- `city task delete <title>`\n\n## \u5173\u952E\u7EA6\u675F\n\n- `title` \u552F\u4E00\uFF1Bcreate \u53BB\u91CD\u4EC5\u6309 `title` \u7CBE\u786E\u5339\u914D\u3002\n- `when=time:...` \u89E6\u53D1\u540E\u4F1A\u81EA\u52A8\u7F6E\u4E3A `paused`\uFF0C\u5E76\u56DE\u9000\u4E3A `when=@manual`\u3002\n- `run` \u4E3A\u5F02\u6B65\u53D7\u7406\uFF1A\u7ACB\u5373\u8FD4\u56DE `accepted=true`\u3001`message`\u3001`executionId`\uFF1B\u8C03\u7528\u65B9\u5E94\u628A\u5B83\u89C6\u4E3A\u201C\u4EFB\u52A1\u5DF2\u8FDB\u5165\u540E\u53F0\u6267\u884C\uFF0C\u7ED3\u679C\u4F1A\u81EA\u52A8\u901A\u8FC7 chat plugin runtime \u53D1\u9001\uFF0C\u5F53\u524D\u6D41\u7A0B\u65E0\u9700\u963B\u585E\u7B49\u5F85\u201D\u3002\n- \u5982\u679C `run` \u8FD4\u56DE `accepted=true`\uFF1A\n  - \u4E0D\u8981\u624B\u52A8\u628A task \u4EA7\u51FA\u518D\u8F6C\u53D1\u7ED9\u7528\u6237\u3002\n  - \u4E0D\u8981\u4E3B\u52A8\u8BFB\u53D6 run \u76EE\u5F55\u3001`run-progress.json`\u3001`output.md` \u505A\u8F6E\u8BE2\u3002\n  - \u53EA\u6709\u5F53\u7528\u6237\u660E\u786E\u8981\u6C42\u6392\u67E5\u3001\u67E5\u770B\u4EA7\u7269\u6216\u786E\u8BA4\u6267\u884C\u7EC6\u8282\u65F6\uFF0C\u624D\u8FDB\u5165 run \u76EE\u5F55\u68C0\u67E5\u3002\n- agent \u4EFB\u52A1\u9ED8\u8BA4\u53EA\u8981\u6C42\u4EA7\u751F\u6709\u6548\u8F93\u51FA\uFF1B\u4EC5\u5F53\u4EFB\u52A1\u6B63\u6587\u660E\u786E\u8981\u6C42\u5916\u53D1\u65F6\uFF0C\u624D\u5E94\u53D1\u9001\u5230\u5916\u90E8 channel\u3002\n\n## \u5982\u4F55\u8BBE\u8BA1 task \u6B63\u6587\n\n### agent task \u63A8\u8350\u7ED3\u6784\n\n\u5EFA\u8BAE\u6B63\u6587\u81F3\u5C11\u5305\u542B\u8FD9\u4E9B\u6807\u9898\uFF1A\n\n```md\n# \u4EFB\u52A1\u76EE\u6807\n\n- \u8FD9\u6B21\u4EFB\u52A1\u8981\u4EA4\u4ED8\u4EC0\u4E48\u6700\u7EC8\u7ED3\u679C\n\n# \u80CC\u666F\u4E0E\u8F93\u5165\n\n- \u6570\u636E\u6765\u6E90\u3001\u8303\u56F4\u3001\u7EA6\u675F\u3001\u53C2\u8003\u6750\u6599\n\n# \u6267\u884C\u6B65\u9AA4\n\n1. \u5148\u505A\u4EC0\u4E48\n2. \u518D\u505A\u4EC0\u4E48\n3. \u5173\u952E\u4E2D\u95F4\u4EA7\u7269\u843D\u5728\u54EA\u91CC\n\n# \u8F93\u51FA\u8981\u6C42\n\n- \u6700\u7EC8\u7ED3\u679C\u7528\u4EC0\u4E48\u683C\u5F0F\u8FD4\u56DE\n- \u662F\u5426\u9700\u8981\u8868\u683C / JSON / Markdown\n- \u4E0D\u8981\u5305\u542B\u4EC0\u4E48\u5185\u5BB9\n\n# \u89E6\u53D1\u4E0E\u72B6\u6001\u5EFA\u8BAE\n\n- \u8FD9\u4E2A\u4EFB\u52A1\u4E3A\u4EC0\u4E48\u9002\u5408 `@manual` / cron / `time:...`\n- \u5F53\u524D\u5E94\u8BE5\u662F `paused` \u8FD8\u662F `enabled`\n\n# \u6CE8\u610F\u4E8B\u9879\n\n- \u98CE\u9669\u3001\u8FB9\u754C\u3001\u4E0D\u8981\u505A\u4EC0\u4E48\n```\n\n### agent task \u6B63\u6587\u7F16\u5199\u7EA6\u675F\n\n- task \u6B63\u6587\u5FC5\u987B\u50CF\u4E00\u4EFD\u201C\u4EA4\u4ED8\u5408\u540C\u201D\uFF0C\u8BA9\u53E6\u4E00\u4E2A\u6267\u884C\u5668\u62FF\u5230\u540E\u53EF\u4EE5\u76F4\u63A5\u6267\u884C\uFF0C\u4E0D\u4F9D\u8D56\u5F53\u524D\u804A\u5929\u8BED\u5883\u8865\u5168\u542B\u4E49\u3002\n- `# \u4EFB\u52A1\u76EE\u6807` \u5FC5\u987B\u5199\u6E05\u695A\u6700\u7EC8\u8981\u4EA4\u4ED8\u4EC0\u4E48\uFF0C\u4E0D\u8981\u53EA\u5199\u201C\u770B\u4E00\u4E0B\u201D\u201C\u7814\u7A76\u4E00\u4E0B\u201D\u201C\u5904\u7406\u4E00\u4E0B\u201D\u8FD9\u7C7B\u6A21\u7CCA\u76EE\u6807\u3002\n- `# \u80CC\u666F\u4E0E\u8F93\u5165` \u5FC5\u987B\u5199\u6E05\u6765\u6E90\u3001\u8303\u56F4\u3001\u5BF9\u8C61\u3001\u65F6\u95F4\u3001\u9650\u5236\u6761\u4EF6\uFF1B\u4E0D\u8981\u5047\u8BBE\u6267\u884C\u5668\u8FD8\u80FD\u770B\u5230\u539F\u59CB\u804A\u5929\u4E0A\u4E0B\u6587\u3002\n- `# \u6267\u884C\u6B65\u9AA4` \u5E94\u63CF\u8FF0\u4EFB\u52A1\u6D41\u7A0B\uFF0C\u4E0D\u5E94\u63CF\u8FF0 task \u7BA1\u7406\u52A8\u4F5C\uFF1B\u4E0D\u8981\u5199\u201C\u5148\u68C0\u67E5\u6709\u6CA1\u6709\u540C\u540D\u4EFB\u52A1\u201D\u201C\u518D\u521B\u5EFA\u4EFB\u52A1\u201D\u201C\u7136\u540E\u89E6\u53D1\u4EFB\u52A1\u201D\u3002\n- `# \u8F93\u51FA\u8981\u6C42` \u5FC5\u987B\u6E05\u695A\u58F0\u660E\u6700\u7EC8\u6210\u54C1\u7684\u683C\u5F0F\u3001\u7ED3\u6784\u3001\u8BED\u6C14\u3001\u957F\u5EA6\uFF0C\u4EE5\u53CA\u201C\u4E0D\u8981\u8F93\u51FA\u4EC0\u4E48\u201D\u3002\n- \u8981\u660E\u786E\u5199\u51FA\uFF1A**\u6700\u540E\u4E00\u6761 assistant \u8FD4\u56DE\u4F1A\u88AB\u76F4\u63A5\u5199\u5165 `output.md` \u5E76\u53D1\u9001\u7ED9\u7528\u6237**\uFF1B\u56E0\u6B64\u6700\u7EC8\u56DE\u7B54\u5FC5\u987B\u76F4\u63A5\u7B49\u4E8E\u6210\u54C1\u5185\u5BB9\u3002\n- \u5185\u5BB9\u751F\u6210\u7C7B\u4EFB\u52A1\uFF08\u5982\u65E5\u62A5\u3001\u63D0\u9192\u3001\u6668\u8BFB\u3001\u6458\u8981\u3001\u62A5\u544A\uFF09\u5FC5\u987B\u660E\u786E\u8981\u6C42\u201C\u6700\u7EC8\u8F93\u51FA\u76F4\u63A5\u662F\u6210\u54C1\u6B63\u6587\u201D\uFF0C\u4E0D\u8981\u8BA9\u6267\u884C\u5668\u8F93\u51FA\u8FC7\u7A0B\u8BF4\u660E\u3002\n- \u5982\u679C\u4EFB\u52A1\u8981\u628A\u7ED3\u679C\u53D1\u7ED9\u7528\u6237\uFF0C\u6B63\u6587\u5E94\u8981\u6C42\u201C\u8F93\u51FA\u53EF\u76F4\u63A5\u53D1\u9001\u7684\u6B63\u6587\u5185\u5BB9\u201D\uFF0C\u800C\u4E0D\u662F\u8981\u6C42\u6267\u884C\u5668\u89E3\u91CA\u81EA\u5DF1\u5DF2\u7ECF\u53D1\u9001\u4E86\u4EC0\u4E48\u3002\n- \u9664\u975E\u786E\u6709\u9700\u8981\uFF0C\u4E0D\u8981\u5728\u6B63\u6587\u4E2D\u8981\u6C42\u6267\u884C\u5668\u590D\u8FF0 task title\u3001sessionId\u3001\u6267\u884C\u65F6\u95F4\u3001\u72B6\u6001\u7B49\u5143\u4FE1\u606F\u3002\n- \u6B63\u6587\u4E2D\u7684\u7EA6\u675F\u8981\u53EF\u6267\u884C\u3001\u53EF\u5224\u65AD\uFF0C\u5C3D\u91CF\u907F\u514D\u201C\u9002\u5F53\u201D\u201C\u5C3D\u91CF\u201D\u201C\u770B\u60C5\u51B5\u201D\u8FD9\u7C7B\u5F31\u7EA6\u675F\u8BCD\u3002\n- \u4E0D\u8981\u628A\u521B\u5EFA task\u3001\u66F4\u65B0 task\u3001\u67E5\u770B task \u72B6\u6001\u3001\u786E\u8BA4 task \u662F\u5426\u5B58\u5728\u7B49\u7BA1\u7406\u52A8\u4F5C\u5199\u8FDB\u6B63\u6587\uFF1B\u8FD9\u4E9B\u5C5E\u4E8E task plugin \u7684\u804C\u8D23\uFF0C\u4E0D\u5C5E\u4E8E task \u6B63\u6587\u4EA4\u4ED8\u7269\u3002\n\n### agent task \u6B63\u6587\u7981\u6B62\u5199\u6CD5\n\n- \u4E0D\u8981\u628A\u6B63\u6587\u5199\u6210\u804A\u5929\u56DE\u590D\u53E3\u543B\uFF0C\u4F8B\u5982\uFF1A\n  - \u201C\u6211\u6765\u4E3A\u4F60\u2026\u2026\u201D\n  - \u201C\u9996\u5148\u8BA9\u6211\u2026\u2026\u201D\n  - \u201C\u6211\u5148\u68C0\u67E5\u4E00\u4E0B\u2026\u2026\u201D\n  - \u201C\u6211\u770B\u5230\u5DF2\u7ECF\u6709\u4E00\u4E2A\u540C\u540D\u4EFB\u52A1\u2026\u2026\u201D\n- \u4E0D\u8981\u628A\u6B63\u6587\u5199\u6210\u4EFB\u52A1\u7BA1\u7406\u8BF4\u660E\uFF0C\u4F8B\u5982\uFF1A\n  - \u201C\u5982\u679C\u4EFB\u52A1\u5DF2\u5B58\u5728\u5219\u66F4\u65B0\uFF0C\u5426\u5219\u521B\u5EFA\u201D\n  - \u201C\u5148 list \u518D run\u201D\n  - \u201C\u5B8C\u6210\u540E\u544A\u8BC9\u7528\u6237\u4EFB\u52A1\u5DF2\u542F\u52A8\u201D\n- \u4E0D\u8981\u628A\u6B63\u6587\u5199\u6210\u72B6\u6001\u6C47\u62A5\u6A21\u677F\uFF0C\u4F8B\u5982\uFF1A\n  - \u201C\u4EFB\u52A1\u72B6\u6001\u603B\u7ED3\u201D\n  - \u201C\u5DF2\u53D1\u9001 / \u5DF2\u5B8C\u6210 / \u5DF2\u66F4\u65B0\u201D\n  - \u201C\u5F53\u524D\u4EFB\u52A1\u914D\u7F6E\u5982\u4E0B\u201D\n- \u4E0D\u8981\u53EA\u63CF\u8FF0\u52A8\u4F5C\uFF0C\u4E0D\u63CF\u8FF0\u6210\u54C1\uFF0C\u4F8B\u5982\uFF1A\n  - \u201C\u53BB\u641C\u96C6\u4E00\u4E9B\u8D44\u6599\u201D\n  - \u201C\u751F\u6210\u4E00\u4E2A\u5185\u5BB9\u770B\u770B\u201D\n  - \u201C\u505A\u5B8C\u540E\u53CD\u9988\u7ED3\u679C\u201D\n- \u4E0D\u8981\u628A\u6B63\u6587\u5199\u6210\u4F9D\u8D56\u5F53\u524D\u4E0A\u4E0B\u6587\u7684\u6307\u4EE3\uFF0C\u4F8B\u5982\uFF1A\n  - \u201C\u6309\u4E0A\u9762\u8BF4\u7684\u505A\u201D\n  - \u201C\u7EE7\u7EED\u521A\u624D\u90A3\u4E2A\u201D\n  - \u201C\u628A\u8FD9\u4E2A\u53D1\u51FA\u53BB\u201D\n\n### \u5982\u4F55\u5224\u65AD\u6B63\u6587\u5199\u5F97\u5BF9\u4E0D\u5BF9\n\n- \u5982\u679C\u628A task \u6B63\u6587\u5355\u72EC\u590D\u5236\u51FA\u6765\u7ED9\u53E6\u4E00\u4E2A agent\uFF0C\u5B83\u4ECD\u7136\u80FD\u7406\u89E3\u4EFB\u52A1\u76EE\u6807\u3001\u8F93\u5165\u3001\u6B65\u9AA4\u548C\u4EA4\u4ED8\u7269\uFF0C\u8BF4\u660E\u6B63\u6587\u5408\u683C\u3002\n- \u5982\u679C\u6700\u7EC8\u8F93\u51FA\u7AE0\u8282\u5220\u6389\u540E\uFF0C\u6B63\u6587\u53EA\u5269\u201C\u53BB\u505A\u4E00\u4E0B\u201D\u5F0F\u63CF\u8FF0\uFF0C\u8BF4\u660E\u6B63\u6587\u4E0D\u5408\u683C\u3002\n- \u5982\u679C\u6B63\u6587\u66F4\u50CF\u201C\u521B\u5EFA/\u66F4\u65B0\u4EFB\u52A1\u7684\u64CD\u4F5C\u8BF4\u660E\u201D\uFF0C\u800C\u4E0D\u662F\u201C\u4EFB\u52A1\u6267\u884C\u8BF4\u660E\u201D\uFF0C\u8BF4\u660E\u5206\u5C42\u9519\u4E86\uFF0C\u5FC5\u987B\u91CD\u5199\u3002\n- \u5982\u679C\u6B63\u6587\u5929\u7136\u4F1A\u8BF1\u5BFC\u6267\u884C\u5668\u8F93\u51FA\u8FC7\u7A0B\u6C47\u62A5\uFF0C\u800C\u4E0D\u662F\u6700\u7EC8\u6210\u54C1\uFF0C\u8BF4\u660E `# \u8F93\u51FA\u8981\u6C42` \u5199\u5F97\u4E0D\u591F\u5F3A\uFF0C\u5FC5\u987B\u8865\u5145\u7981\u6B62\u9879\u3002\n\n### script task \u63A8\u8350\u7ED3\u6784\n\n- \u6B63\u6587\u5FC5\u987B\u662F\u7EAF shell \u811A\u672C\uFF0C\u4E0D\u8981\u6DF7\u5165\u89E3\u91CA\u6027\u81EA\u7136\u8BED\u8A00\u3002\n- \u5F00\u5934\u5C3D\u91CF\u5199\u6CE8\u91CA\u8BF4\u660E\u811A\u672C\u76EE\u7684\u3001\u8F93\u5165\u4F9D\u8D56\u3001\u5931\u8D25\u6761\u4EF6\u3002\n- \u8F93\u51FA\u4FDD\u6301\u7A33\u5B9A\uFF0C\u4FBF\u4E8E\u76F4\u63A5\u4F5C\u4E3A\u6700\u7EC8\u7ED3\u679C\u53D1\u9001\u7ED9\u7528\u6237\u3002\n- \u5982\u9700\u751F\u6210\u6587\u4EF6\uFF0C\u5199\u5230 run \u76EE\u5F55\u6216\u660E\u786E\u7684\u9879\u76EE\u8DEF\u5F84\u3002\n\n### \u8F93\u51FA\u8BBE\u8BA1\u539F\u5219\n\n- task \u5B8C\u6210\u540E\uFF0C\u7CFB\u7EDF\u4F1A\u81EA\u52A8\u628A**\u6700\u7EC8\u7ED3\u679C\u6B63\u6587**\u901A\u8FC7 chat plugin runtime \u7684 `send` \u53D1\u56DE `sessionId` \u7ED1\u5B9A\u7684 chat\u3002\n- \u5F53\u524D\u5B9E\u73B0\u91C7\u7528\u6700\u7B80\u89C4\u5219\uFF1A**\u6700\u540E\u4E00\u6761 assistant \u8FD4\u56DE**\u4F1A\u88AB\u76F4\u63A5\u89C6\u4E3A\u6700\u7EC8\u7ED3\u679C\u6B63\u6587\uFF0C\u5E76\u5199\u5165 `output.md`\u3002\n- \u56E0\u6B64\u6B63\u6587\u91CC\u7684\u201C\u8F93\u51FA\u8981\u6C42\u201D\u8981\u9762\u5411\u6700\u7EC8\u7528\u6237\u9605\u8BFB\uFF0C\u4E0D\u8981\u53EA\u5199\u7ED9\u5F00\u53D1\u8005\u770B\u3002\n- \u5BF9\u4E8E\u9762\u5411\u7528\u6237\u7684 agent task\uFF0C\u6B63\u6587\u5E94\u8981\u6C42\u201C\u6700\u540E\u4E00\u6761 assistant \u8FD4\u56DE\u76F4\u63A5\u8F93\u51FA\u6700\u7EC8\u4EA4\u4ED8\u7269\u672C\u8EAB\u201D\uFF0C\u4E0D\u8981\u8BA9\u6267\u884C\u5668\u5728\u6700\u540E\u56DE\u7B54\u91CC\u8F93\u51FA\u81EA\u5DF1\u5982\u4F55\u521B\u5EFA\u3001\u68C0\u67E5\u3001\u66F4\u65B0\u3001\u89E6\u53D1\u6216\u53D1\u9001\u4EFB\u52A1\u3002\n- \u5982\u679C\u4EFB\u52A1\u662F\u5185\u5BB9\u751F\u6210\u7C7B\uFF08\u4F8B\u5982\u65E5\u62A5\u3001\u63D0\u9192\u3001\u6668\u8BFB\u3001\u6458\u8981\uFF09\uFF0C\u6700\u540E\u8F93\u51FA\u5E94\u76F4\u63A5\u662F\u90A3\u6BB5\u5185\u5BB9\u672C\u8EAB\uFF0C\u4E0D\u8981\u9644\u5E26\u201C\u6211\u6765\u4E3A\u4F60\u5904\u7406\u201D\u201C\u4EFB\u52A1\u5DF2\u53D1\u9001\u201D\u201C\u4EFB\u52A1\u72B6\u6001\u603B\u7ED3\u201D\u7B49\u8FC7\u7A0B\u6C47\u62A5\u3002\n- \u9ED8\u8BA4\u4E0D\u8981\u5728\u6B63\u6587\u91CC\u518D\u6B21\u8981\u6C42\u6267\u884C\u5668\u8C03\u7528 `city chat send`\u3002\n- \u53EA\u6709\u5728\u201C\u8DE8\u4F1A\u8BDD\u53D1\u9001\u201D\u201C\u989D\u5916\u6284\u9001\u201D\u201C\u591A\u6E20\u9053\u901A\u77E5\u201D\u8FD9\u7C7B\u573A\u666F\u4E0B\uFF0C\u624D\u663E\u5F0F\u8981\u6C42 `city chat send`\u3002\n\n### `when` / `status` \u600E\u4E48\u9009\n\n- task \u521B\u5EFA\u9ED8\u8BA4\u5C31\u662F `status=enabled`\uFF1B\u5982\u679C\u8FD8\u5728\u8BD5\u4EFB\u52A1\u3001\u5BB9\u6613\u5931\u8D25\u3001\u9700\u8981\u4EBA\u5DE5\u786E\u8BA4\uFF0C\u518D\u663E\u5F0F\u5207\u5230 `paused`\u3002\n- \u5DF2\u7ECF\u9A8C\u8BC1\u7A33\u5B9A\u3001\u9700\u8981\u81EA\u52A8\u8FD0\u884C\uFF1A\u76F4\u63A5\u4F7F\u7528 cron + `status=enabled`\u3002\n- \u660E\u786E\u53EA\u6267\u884C\u4E00\u6B21\uFF1A\u4F7F\u7528 `time:<\u5E26\u65F6\u533A ISO \u65F6\u95F4>`\uFF1B\u6267\u884C\u540E\u7CFB\u7EDF\u4F1A\u81EA\u52A8\u56DE\u9000\u5230 `@manual` + `paused`\u3002\n- \u5982\u679C\u7528\u6237\u53EA\u662F\u201C\u5148\u5B58\u8D77\u6765\u4EE5\u540E\u518D\u8DD1\u201D\uFF0C\u4E0D\u8981\u76F4\u63A5\u542F\u7528\u8C03\u5EA6\u3002\n\n## \u6B63\u6587\u6A21\u677F\n\n### agent \u6A21\u677F\n\n```md\n# \u4EFB\u52A1\u76EE\u6807\n\n- \u4EA7\u51FA\u4E00\u4EFD\u53EF\u76F4\u63A5\u53D1\u7ED9\u7528\u6237\u7684\u6700\u7EC8\u7ED3\u679C\u3002\n\n# \u80CC\u666F\u4E0E\u8F93\u5165\n\n- \u5728\u8FD9\u91CC\u8865\u5145\u4E0A\u4E0B\u6587\u3001\u6587\u4EF6\u3001\u94FE\u63A5\u3001\u8303\u56F4\u548C\u5047\u8BBE\u3002\n\n# \u6267\u884C\u6B65\u9AA4\n\n1. \u7406\u89E3\u4EFB\u52A1\u76EE\u6807\u4E0E\u5B8C\u6210\u6807\u51C6\u3002\n2. \u6536\u96C6\u5FC5\u8981\u4FE1\u606F\u5E76\u6267\u884C\u4EFB\u52A1\u3002\n3. \u628A\u5173\u952E\u4E2D\u95F4\u4EA7\u7269\u5199\u5165 run \u76EE\u5F55\u3002\n4. \u8F93\u51FA\u6700\u7EC8\u7ED3\u679C\u6B63\u6587\u3002\n\n# \u8F93\u51FA\u8981\u6C42\n\n- \u6700\u540E\u4E00\u6761 assistant \u8FD4\u56DE\u76F4\u63A5\u4F5C\u4E3A\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u8981\u9644\u5E26\u5197\u957F\u65E5\u5FD7\u3002\n- \u6700\u540E\u4E00\u6761 assistant \u8FD4\u56DE\u76F4\u63A5\u8F93\u51FA\u4EA4\u4ED8\u7269\u672C\u8EAB\uFF0C\u4E0D\u8981\u8F93\u51FA\u4EFB\u52A1\u7BA1\u7406\u8FC7\u7A0B\u3001\u53D1\u9001\u8FC7\u7A0B\u6216\u72B6\u6001\u6C47\u62A5\u3002\n- \u4E0D\u8981\u4F7F\u7528\u201C\u6211\u6765\u4E3A\u4F60\u2026\u2026 / \u9996\u5148\u8BA9\u6211\u2026\u2026 / \u5DF2\u53D1\u9001\u2026\u2026\u201D\u8FD9\u7C7B\u5143\u8BDD\u672F\u3002\n- \u9ED8\u8BA4\u4E0D\u8981\u518D\u6B21\u8C03\u7528 `city chat send`\u3002\n\n# \u89E6\u53D1\u4E0E\u72B6\u6001\u5EFA\u8BAE\n\n- \u9ED8\u8BA4\u521B\u5EFA\u540E\u7ACB\u5373\u542F\u7528\uFF1B\u5982\u679C\u53EA\u662F\u5148\u4FDD\u5B58\u8349\u7A3F\u6216\u7B49\u5F85\u4EBA\u5DE5\u786E\u8BA4\uFF0C\u518D\u6539\u6210 `paused`\u3002\n\n# \u6CE8\u610F\u4E8B\u9879\n\n- \u4EC5\u5728\u660E\u786E\u9700\u8981\u8DE8\u4F1A\u8BDD\u6216\u989D\u5916\u901A\u77E5\u65F6\uFF0C\u624D\u8C03\u7528 `city chat send`\u3002\n```\n\n### script \u6A21\u677F\n\n```bash\n# \u4EFB\u52A1\u76EE\u6807\uFF1A\u4E00\u53E5\u8BDD\u8BF4\u660E\u811A\u672C\u8981\u505A\u4EC0\u4E48\n# \u8F93\u5165\u4F9D\u8D56\uFF1A\u5217\u51FA\u73AF\u5883\u53D8\u91CF\u3001\u6587\u4EF6\u3001\u547D\u4EE4\u4F9D\u8D56\n# \u5931\u8D25\u6761\u4EF6\uFF1A\u5217\u51FA\u5E94\u8BE5 exit 1 \u7684\u60C5\u51B5\n\nset -euo pipefail\n\n# 1. \u51C6\u5907\u8F93\u5165\n\n# 2. \u6267\u884C\u4E3B\u903B\u8F91\n\n# 3. \u8F93\u51FA\u6700\u7EC8\u7ED3\u679C\uFF08\u8FD9\u6BB5\u8F93\u51FA\u4F1A\u88AB\u76F4\u63A5\u53D1\u9001\u7ED9\u7528\u6237\uFF09\n```\n\n## \u5EFA\u8BAE\n\n- \u5148 `list`\uFF0C\u518D `create`/`update`\u3002\n- \u7B80\u5355\u5185\u5BB9\u751F\u6210\u4EFB\u52A1\u4F18\u5148\u4FDD\u6301\u9ED8\u8BA4\u5355\u8F6E\uFF1B\u53EA\u6709\u786E\u5B9E\u9700\u8981\u201C\u5148\u751F\u6210\u3001\u518D\u590D\u6838\u3001\u518D\u4FEE\u8BA2\u201D\u65F6\u518D\u8BBE\u7F6E `review: true`\u3002\n- script \u4EFB\u52A1\u6B63\u6587\u4FDD\u6301\u7EAF\u811A\u672C\uFF0C\u4E0D\u8981\u6DF7\u5165\u5197\u4F59\u81EA\u7136\u8BED\u8A00\u3002\n- \u5982\u679C\u7528\u6237\u53EA\u662F\u5148\u5B58\u8D77\u6765\u4EE5\u540E\u518D\u8DD1\uFF0C\u521B\u5EFA\u540E\u663E\u5F0F\u8BBE\u6210 `paused`\uFF1B\u5426\u5219\u4FDD\u6301\u9ED8\u8BA4\u542F\u7528\u3002\n- task \u6B63\u6587\u8981\u5199\u201C\u6700\u7EC8\u7ED3\u679C\u957F\u4EC0\u4E48\u6837\u201D\uFF0C\u4E0D\u8981\u53EA\u5199\u201C\u53BB\u505A\u4E00\u4E0B\u770B\u770B\u201D\u3002\n- \u5BF9\u5185\u5BB9\u751F\u6210\u4EFB\u52A1\uFF0C\u8981\u660E\u786E\u5199\u201C\u6700\u540E\u4E00\u6761 assistant \u8FD4\u56DE\u53EA\u80FD\u662F\u6210\u54C1\u6B63\u6587\u201D\uFF0C\u907F\u514D\u6267\u884C\u5668\u628A\u8FC7\u7A0B\u8BF4\u660E\u8BEF\u5F53\u6210\u6700\u7EC8\u7ED3\u679C\u3002\n";
+export default TEXT_MODULE_CONTENT;
+//# sourceMappingURL=PROMPT.d.ts.map

package/bin/task/PROMPT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PROMPT.d.ts","sourceRoot":"","sources":["../../src/task/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,QAAA,MAAM,mBAAmB,m0iBAA8nK,CAAC;AAExpK,eAAe,mBAAmB,CAAC"}

package/bin/task/PROMPT.js

@@ -0,0 +1,8 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+// Source: src/task/PROMPT.ts.txt
+const TEXT_MODULE_CONTENT = "# Task Plugin\n\n你可以通过 `task` plugin 管理任务定义、执行、调度与状态控制。\n\n## 任务模型\n\n每个任务定义在 `./.downcity/task/<title>/task.md`，包含：\n- frontmatter（结构化字段）\n- body（任务正文）\n\nfrontmatter 核心字段：\n- `title`：任务唯一标识（唯一）\n- `description`：任务描述\n- `when`：触发条件，支持：`@manual` / cron / `time:<ISO8601-with-timezone>`\n- `sessionId`：任务执行会话\n- `status`：`enabled|paused|disabled`\n- `kind`：`agent|script`（默认 `agent`）\n\n执行时会产生 run 目录：\n- `./.downcity/task/<title>/<timestamp>/`\n\n常见产物：\n- `input.md`\n- `output.md`（本次任务的最终输出正文）\n- `result.md`（执行摘要）\n- `run.json`\n- `run-progress.json`\n- `dialogue.md` / `dialogue.json`（agent 多轮）\n- `error.md`（失败时）\n\n## 执行类型（kind）\n\n1. `kind=agent`\n- 将正文交给 agent 执行\n- 默认单轮完成；仅当 frontmatter 显式设置 `review: true` 时启用模拟用户多轮复核\n- 适合研究、分析、报告生成\n\n2. `kind=script`\n- 将正文当作 shell 脚本执行\n- 正文不能为空，必须是可执行脚本\n\n## 可用 action\n\n- `list`\n- `create`\n- `run`\n- `delete`\n- `update`\n- `status`\n- `enable`\n- `disable`\n\n## CLI 示例\n\n- `city task list [--status enabled|paused|disabled]`\n- `city task create --title '...' --description '...' --session-id <sessionId> [--when '@manual'] [--kind agent|script] [--status ...|--activate]`\n- `city task run <title> [--reason '...']`\n- `city task update <title> [--title ...] [--description ...] [--when ...] [--status ...|--activate] [--session-id ...]`\n- `city task delete <title>`\n\n## 关键约束\n\n- `title` 唯一；create 去重仅按 `title` 精确匹配。\n- `when=time:...` 触发后会自动置为 `paused`，并回退为 `when=@manual`。\n- `run` 为异步受理：立即返回 `accepted=true`、`message`、`executionId`；调用方应把它视为“任务已进入后台执行，结果会自动通过 chat plugin runtime 发送，当前流程无需阻塞等待”。\n- 如果 `run` 返回 `accepted=true`：\n  - 不要手动把 task 产出再转发给用户。\n  - 不要主动读取 run 目录、`run-progress.json`、`output.md` 做轮询。\n  - 只有当用户明确要求排查、查看产物或确认执行细节时，才进入 run 目录检查。\n- agent 任务默认只要求产生有效输出；仅当任务正文明确要求外发时，才应发送到外部 channel。\n\n## 如何设计 task 正文\n\n### agent task 推荐结构\n\n建议正文至少包含这些标题：\n\n```md\n# 任务目标\n\n- 这次任务要交付什么最终结果\n\n# 背景与输入\n\n- 数据来源、范围、约束、参考材料\n\n# 执行步骤\n\n1. 先做什么\n2. 再做什么\n3. 关键中间产物落在哪里\n\n# 输出要求\n\n- 最终结果用什么格式返回\n- 是否需要表格 / JSON / Markdown\n- 不要包含什么内容\n\n# 触发与状态建议\n\n- 这个任务为什么适合 `@manual` / cron / `time:...`\n- 当前应该是 `paused` 还是 `enabled`\n\n# 注意事项\n\n- 风险、边界、不要做什么\n```\n\n### agent task 正文编写约束\n\n- task 正文必须像一份“交付合同”，让另一个执行器拿到后可以直接执行，不依赖当前聊天语境补全含义。\n- `# 任务目标` 必须写清楚最终要交付什么，不要只写“看一下”“研究一下”“处理一下”这类模糊目标。\n- `# 背景与输入` 必须写清来源、范围、对象、时间、限制条件；不要假设执行器还能看到原始聊天上下文。\n- `# 执行步骤` 应描述任务流程，不应描述 task 管理动作；不要写“先检查有没有同名任务”“再创建任务”“然后触发任务”。\n- `# 输出要求` 必须清楚声明最终成品的格式、结构、语气、长度，以及“不要输出什么”。\n- 要明确写出：**最后一条 assistant 返回会被直接写入 `output.md` 并发送给用户**；因此最终回答必须直接等于成品内容。\n- 内容生成类任务（如日报、提醒、晨读、摘要、报告）必须明确要求“最终输出直接是成品正文”，不要让执行器输出过程说明。\n- 如果任务要把结果发给用户，正文应要求“输出可直接发送的正文内容”，而不是要求执行器解释自己已经发送了什么。\n- 除非确有需要，不要在正文中要求执行器复述 task title、sessionId、执行时间、状态等元信息。\n- 正文中的约束要可执行、可判断，尽量避免“适当”“尽量”“看情况”这类弱约束词。\n- 不要把创建 task、更新 task、查看 task 状态、确认 task 是否存在等管理动作写进正文；这些属于 task plugin 的职责，不属于 task 正文交付物。\n\n### agent task 正文禁止写法\n\n- 不要把正文写成聊天回复口吻，例如：\n  - “我来为你……”\n  - “首先让我……”\n  - “我先检查一下……”\n  - “我看到已经有一个同名任务……”\n- 不要把正文写成任务管理说明，例如：\n  - “如果任务已存在则更新，否则创建”\n  - “先 list 再 run”\n  - “完成后告诉用户任务已启动”\n- 不要把正文写成状态汇报模板，例如：\n  - “任务状态总结”\n  - “已发送 / 已完成 / 已更新”\n  - “当前任务配置如下”\n- 不要只描述动作，不描述成品，例如：\n  - “去搜集一些资料”\n  - “生成一个内容看看”\n  - “做完后反馈结果”\n- 不要把正文写成依赖当前上下文的指代，例如：\n  - “按上面说的做”\n  - “继续刚才那个”\n  - “把这个发出去”\n\n### 如何判断正文写得对不对\n\n- 如果把 task 正文单独复制出来给另一个 agent，它仍然能理解任务目标、输入、步骤和交付物，说明正文合格。\n- 如果最终输出章节删掉后，正文只剩“去做一下”式描述，说明正文不合格。\n- 如果正文更像“创建/更新任务的操作说明”，而不是“任务执行说明”，说明分层错了，必须重写。\n- 如果正文天然会诱导执行器输出过程汇报，而不是最终成品，说明 `# 输出要求` 写得不够强，必须补充禁止项。\n\n### script task 推荐结构\n\n- 正文必须是纯 shell 脚本，不要混入解释性自然语言。\n- 开头尽量写注释说明脚本目的、输入依赖、失败条件。\n- 输出保持稳定，便于直接作为最终结果发送给用户。\n- 如需生成文件，写到 run 目录或明确的项目路径。\n\n### 输出设计原则\n\n- task 完成后，系统会自动把**最终结果正文**通过 chat plugin runtime 的 `send` 发回 `sessionId` 绑定的 chat。\n- 当前实现采用最简规则：**最后一条 assistant 返回**会被直接视为最终结果正文，并写入 `output.md`。\n- 因此正文里的“输出要求”要面向最终用户阅读，不要只写给开发者看。\n- 对于面向用户的 agent task，正文应要求“最后一条 assistant 返回直接输出最终交付物本身”，不要让执行器在最后回答里输出自己如何创建、检查、更新、触发或发送任务。\n- 如果任务是内容生成类（例如日报、提醒、晨读、摘要），最后输出应直接是那段内容本身，不要附带“我来为你处理”“任务已发送”“任务状态总结”等过程汇报。\n- 默认不要在正文里再次要求执行器调用 `city chat send`。\n- 只有在“跨会话发送”“额外抄送”“多渠道通知”这类场景下，才显式要求 `city chat send`。\n\n### `when` / `status` 怎么选\n\n- task 创建默认就是 `status=enabled`；如果还在试任务、容易失败、需要人工确认，再显式切到 `paused`。\n- 已经验证稳定、需要自动运行：直接使用 cron + `status=enabled`。\n- 明确只执行一次：使用 `time:<带时区 ISO 时间>`；执行后系统会自动回退到 `@manual` + `paused`。\n- 如果用户只是“先存起来以后再跑”，不要直接启用调度。\n\n## 正文模板\n\n### agent 模板\n\n```md\n# 任务目标\n\n- 产出一份可直接发给用户的最终结果。\n\n# 背景与输入\n\n- 在这里补充上下文、文件、链接、范围和假设。\n\n# 执行步骤\n\n1. 理解任务目标与完成标准。\n2. 收集必要信息并执行任务。\n3. 把关键中间产物写入 run 目录。\n4. 输出最终结果正文。\n\n# 输出要求\n\n- 最后一条 assistant 返回直接作为最终结果，不要附带冗长日志。\n- 最后一条 assistant 返回直接输出交付物本身，不要输出任务管理过程、发送过程或状态汇报。\n- 不要使用“我来为你…… / 首先让我…… / 已发送……”这类元话术。\n- 默认不要再次调用 `city chat send`。\n\n# 触发与状态建议\n\n- 默认创建后立即启用；如果只是先保存草稿或等待人工确认，再改成 `paused`。\n\n# 注意事项\n\n- 仅在明确需要跨会话或额外通知时，才调用 `city chat send`。\n```\n\n### script 模板\n\n```bash\n# 任务目标：一句话说明脚本要做什么\n# 输入依赖：列出环境变量、文件、命令依赖\n# 失败条件：列出应该 exit 1 的情况\n\nset -euo pipefail\n\n# 1. 准备输入\n\n# 2. 执行主逻辑\n\n# 3. 输出最终结果（这段输出会被直接发送给用户）\n```\n\n## 建议\n\n- 先 `list`，再 `create`/`update`。\n- 简单内容生成任务优先保持默认单轮；只有确实需要“先生成、再复核、再修订”时再设置 `review: true`。\n- script 任务正文保持纯脚本，不要混入冗余自然语言。\n- 如果用户只是先存起来以后再跑，创建后显式设成 `paused`；否则保持默认启用。\n- task 正文要写“最终结果长什么样”，不要只写“去做一下看看”。\n- 对内容生成任务，要明确写“最后一条 assistant 返回只能是成品正文”，避免执行器把过程说明误当成最终结果。\n";
+export default TEXT_MODULE_CONTENT;
+//# sourceMappingURL=PROMPT.js.map

package/bin/task/PROMPT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PROMPT.js","sourceRoot":"","sources":["../../src/task/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iCAAiC;AACjC,MAAM,mBAAmB,GAAG,2nKAA2nK,CAAC;AAExpK,eAAe,mBAAmB,CAAC"}

package/bin/task/Scheduler.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Task 调度注册（集成层）。
+ *
+ * 关键点（中文）
+ * - task 语义（status/when/串行保护）放在 task plugin runtime。
+ * - cron 调度执行器由宿主注入，task runtime 不依赖具体实现。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import { TaskCronEngine } from "./types/Cron.js";
+export declare function registerTaskCronJobs(params: {
+    context: AgentContext;
+    engine: TaskCronEngine;
+}): Promise<{
+    tasksFound: number;
+    jobsScheduled: number;
+}>;
+//# sourceMappingURL=Scheduler.d.ts.map

package/bin/task/Scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../../src/task/Scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAQjG,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AASjD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAwNzD"}

package/bin/task/Scheduler.js

@@ -0,0 +1,231 @@
+/**
+ * Task 调度注册（集成层）。
+ *
+ * 关键点（中文）
+ * - task 语义（status/when/串行保护）放在 task plugin runtime。
+ * - cron 调度执行器由宿主注入，task runtime 不依赖具体实现。
+ */
+import { isTaskWhenManual, resolveTaskWhenCronExpression, resolveTaskWhenOneShotMs, } from "./runtime/Model.js";
+import { listTasks, readTask, writeTask } from "./runtime/Store.js";
+import { runTaskNow } from "./runtime/Runner.js";
+import { resolveRuntimeTimezone } from "@downcity/agent/internal/utils/Time.js";
+const TASK_LOG_PREFIX = "[TASK]";
+function formatTaskLogMessage(message) {
+    return `${TASK_LOG_PREFIX} ${message}`;
+}
+export async function registerTaskCronJobs(params) {
+    const context = params.context;
+    const logger = context.logger;
+    const tasks = await listTasks(context.rootPath);
+    const runtimeTimezone = resolveRuntimeTimezone();
+    const runningByTaskId = new Set();
+    let jobsScheduled = 0;
+    for (const item of tasks) {
+        if (String(item.status).toLowerCase() !== "enabled")
+            continue;
+        const expr = resolveTaskWhenCronExpression(item.when);
+        let latestWhen = item.when;
+        try {
+            const task = await readTask({
+                taskId: item.taskId,
+                projectRoot: context.rootPath,
+            });
+            latestWhen = task.frontmatter.when;
+        }
+        catch { }
+        if (expr && !isTaskWhenManual(item.when)) {
+            try {
+                params.engine.register({
+                    id: `task:${item.taskId}`,
+                    expression: expr,
+                    timezone: runtimeTimezone,
+                    execute: async () => {
+                        const taskId = String(item.taskId || "").trim();
+                        if (!taskId)
+                            return;
+                        // 关键点（中文）：同一 taskId 串行；重叠触发时跳过，避免并发执行污染 run 目录。
+                        if (runningByTaskId.has(taskId)) {
+                            void logger.log("warn", formatTaskLogMessage("Task skipped (already running)"), {
+                                taskId,
+                                via: "cron",
+                            });
+                            return;
+                        }
+                        runningByTaskId.add(taskId);
+                        try {
+                            // 关键点（中文）：触发瞬间复查最新 task.md，避免 status/when 变更后仍沿用旧注册状态。
+                            const latest = await readTask({
+                                taskId,
+                                projectRoot: context.rootPath,
+                            });
+                            if (String(latest.frontmatter.status).toLowerCase() !== "enabled") {
+                                return;
+                            }
+                            const latestExpr = resolveTaskWhenCronExpression(latest.frontmatter.when);
+                            if (!latestExpr || isTaskWhenManual(latest.frontmatter.when)) {
+                                return;
+                            }
+                            const result = await runTaskNow({
+                                context,
+                                taskId,
+                                projectRoot: context.rootPath,
+                                trigger: { type: "cron" },
+                            });
+                            void logger.log("info", formatTaskLogMessage("Task run finished"), {
+                                taskId,
+                                via: "cron",
+                                status: result.status,
+                                executionStatus: result.executionStatus,
+                                resultStatus: result.resultStatus,
+                                ...(result.resultErrors.length > 0
+                                    ? { resultErrors: result.resultErrors }
+                                    : {}),
+                                dialogueRounds: result.dialogueRounds,
+                                userSimulatorSatisfied: result.userSimulatorSatisfied,
+                                timestamp: result.timestamp,
+                                runDir: result.runDirRel,
+                            });
+                        }
+                        catch (error) {
+                            void logger.log("error", formatTaskLogMessage("Task run failed (scheduler)"), {
+                                taskId,
+                                via: "cron",
+                                error: String(error),
+                            });
+                        }
+                        finally {
+                            runningByTaskId.delete(taskId);
+                        }
+                    },
+                });
+                jobsScheduled += 1;
+            }
+            catch {
+                void logger.log("warn", formatTaskLogMessage("Invalid task cron; skipped"), {
+                    taskId: item.taskId,
+                    when: item.when,
+                });
+            }
+        }
+        const plannedTimeMs = resolveTaskWhenOneShotMs(latestWhen);
+        if (String(latestWhen || "").trim() && String(latestWhen || "").toLowerCase().startsWith("time:") && plannedTimeMs === null) {
+            void logger.log("warn", formatTaskLogMessage("Invalid task one-shot time; skipped"), {
+                taskId: item.taskId,
+                when: latestWhen,
+            });
+            continue;
+        }
+        if (plannedTimeMs === null)
+            continue;
+        try {
+            params.engine.register({
+                id: `task-time:${item.taskId}`,
+                expression: "* * * * *",
+                timezone: runtimeTimezone,
+                execute: async () => {
+                    const taskId = String(item.taskId || "").trim();
+                    if (!taskId)
+                        return;
+                    // 到点前不执行；进程重启后若已过点，将在下一分钟补执行一次。
+                    if (Date.now() < plannedTimeMs)
+                        return;
+                    // 关键点（中文）：同一 taskId 串行；重叠触发时跳过，避免并发执行污染 run 目录。
+                    if (runningByTaskId.has(taskId)) {
+                        void logger.log("warn", formatTaskLogMessage("Task skipped (already running)"), {
+                            taskId,
+                            via: "time",
+                        });
+                        return;
+                    }
+                    let shouldDeactivateOneShot = false;
+                    runningByTaskId.add(taskId);
+                    try {
+                        const latest = await readTask({
+                            taskId,
+                            projectRoot: context.rootPath,
+                        });
+                        if (String(latest.frontmatter.status).toLowerCase() !== "enabled")
+                            return;
+                        const latestPlannedMs = resolveTaskWhenOneShotMs(latest.frontmatter.when);
+                        if (latestPlannedMs === null)
+                            return;
+                        if (Date.now() < latestPlannedMs)
+                            return;
+                        shouldDeactivateOneShot = true;
+                        const result = await runTaskNow({
+                            context,
+                            taskId,
+                            projectRoot: context.rootPath,
+                            trigger: { type: "time" },
+                        });
+                        void logger.log("info", formatTaskLogMessage("Task run finished"), {
+                            taskId,
+                            via: "time",
+                            status: result.status,
+                            executionStatus: result.executionStatus,
+                            resultStatus: result.resultStatus,
+                            ...(result.resultErrors.length > 0
+                                ? { resultErrors: result.resultErrors }
+                                : {}),
+                            dialogueRounds: result.dialogueRounds,
+                            userSimulatorSatisfied: result.userSimulatorSatisfied,
+                            timestamp: result.timestamp,
+                            runDir: result.runDirRel,
+                        });
+                    }
+                    catch (error) {
+                        void logger.log("error", formatTaskLogMessage("Task run failed (scheduler)"), {
+                            taskId,
+                            via: "time",
+                            error: String(error),
+                        });
+                    }
+                    finally {
+                        if (shouldDeactivateOneShot) {
+                            try {
+                                const latest = await readTask({
+                                    taskId,
+                                    projectRoot: context.rootPath,
+                                });
+                                await writeTask({
+                                    projectRoot: context.rootPath,
+                                    taskId,
+                                    overwrite: true,
+                                    frontmatter: {
+                                        ...latest.frontmatter,
+                                        when: "@manual",
+                                        status: "paused",
+                                    },
+                                    body: latest.body,
+                                });
+                                void logger.log("info", formatTaskLogMessage("One-shot task deactivated after execution"), {
+                                    taskId,
+                                    status: "paused",
+                                });
+                            }
+                            catch (e) {
+                                void logger.log("warn", formatTaskLogMessage("Failed to deactivate one-shot task"), {
+                                    taskId,
+                                    error: String(e),
+                                });
+                            }
+                        }
+                        runningByTaskId.delete(taskId);
+                    }
+                },
+            });
+            jobsScheduled += 1;
+        }
+        catch {
+            void logger.log("warn", formatTaskLogMessage("Invalid task one-shot trigger; skipped"), {
+                taskId: item.taskId,
+                when: latestWhen,
+            });
+        }
+    }
+    return {
+        tasksFound: tasks.length,
+        jobsScheduled,
+    };
+}
+//# sourceMappingURL=Scheduler.js.map

package/bin/task/Scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.js","sourceRoot":"","sources":["../../src/task/Scheduler.ts"],"names":[],"mappings":"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"}

package/bin/task/TaskPlugin.d.ts

@@ -0,0 +1,57 @@
+/**
+ * TaskPlugin：task plugin 的类实例实现。
+ *
+ * 关键点（中文）
+ * - task 的长期运行态（cron engine）归属于 TaskPlugin 实例。
+ * - task 的 prompt、action input、action execution 都已拆到独立模块。
+ * - 当前文件只保留实例骨架与 lifecycle，不再依赖旧的模块级单例。
+ */
+import type { AgentRuntime } from "@downcity/agent/internal/types/runtime/agent/AgentRuntime.js";
+import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
+import type { PluginActions } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { TaskCronRegisterResult } from "../task/types/TaskPluginTypes.js";
+import { TaskCronTriggerEngine } from "../task/runtime/CronTrigger.js";
+/**
+ * task plugin 类实现。
+ */
+export declare class TaskPlugin extends BasePlugin {
+    /**
+     * 当前 plugin 名称。
+     */
+    readonly name = "task";
+    /**
+     * task plugin 的 system 文本提供器。
+     */
+    readonly system: () => string;
+    /**
+     * task plugin 的 action 定义表。
+     */
+    readonly actions: PluginActions;
+    /**
+     * 当前实例持有的 cron engine。
+     *
+     * 关键点（中文）
+     * - 这是 per-plugin-instance 的长期运行态。
+     * - 不再复用 module-global 单例。
+     */
+    cronEngine: TaskCronTriggerEngine | null;
+    constructor(agent: AgentRuntime | null);
+    /**
+     * 启动当前实例的 cron runtime。
+     */
+    startCronRuntime(context: AgentContext): Promise<TaskCronRegisterResult | null>;
+    /**
+     * 停止当前实例的 cron runtime。
+     */
+    stopCronRuntime(): Promise<boolean>;
+    /**
+     * 重启当前实例的 cron runtime。
+     */
+    restartCronRuntime(context: AgentContext): Promise<TaskCronRegisterResult>;
+    /**
+     * 任务定义变更后重载 scheduler。
+     */
+    private reloadSchedulerAfterMutation;
+}
+//# sourceMappingURL=TaskPlugin.d.ts.map

package/bin/task/TaskPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskPlugin.d.ts","sourceRoot":"","sources":["../../src/task/TaskPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAgBtE;;GAEG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC;;OAEG;IACH,QAAQ,CAAC,IAAI,UAAU;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,QAAO,MAAM,CAAuB;IAEnD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC;;;;;;OAMG;IACI,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAAQ;gBAE3C,KAAK,EAAE,YAAY,GAAG,IAAI;IA6CtC;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAazC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAQzC;;OAEG;IACG,kBAAkB,CACtB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,CAAC;IAWlC;;OAEG;YACW,4BAA4B;CAY3C"}

package/bin/task/TaskPlugin.js

@@ -0,0 +1,126 @@
+/**
+ * TaskPlugin：task plugin 的类实例实现。
+ *
+ * 关键点（中文）
+ * - task 的长期运行态（cron engine）归属于 TaskPlugin 实例。
+ * - task 的 prompt、action input、action execution 都已拆到独立模块。
+ * - 当前文件只保留实例骨架与 lifecycle，不再依赖旧的模块级单例。
+ */
+import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
+import { TaskCronTriggerEngine } from "../task/runtime/CronTrigger.js";
+import { registerTaskCronJobs } from "../task/Scheduler.js";
+import { createTaskPluginActions, } from "../task/runtime/TaskPluginActions.js";
+import { reloadTaskSchedulerAfterMutation, } from "../task/runtime/TaskActionExecution.js";
+import { TASK_PLUGIN_PROMPT } from "../task/runtime/TaskPluginSystem.js";
+const TASK_LOG_PREFIX = "[TASK]";
+function formatTaskLogMessage(message) {
+    return `${TASK_LOG_PREFIX} ${message}`;
+}
+/**
+ * task plugin 类实现。
+ */
+export class TaskPlugin extends BasePlugin {
+    /**
+     * 当前 plugin 名称。
+     */
+    name = "task";
+    /**
+     * task plugin 的 system 文本提供器。
+     */
+    system = () => TASK_PLUGIN_PROMPT;
+    /**
+     * task plugin 的 action 定义表。
+     */
+    actions;
+    /**
+     * 当前实例持有的 cron engine。
+     *
+     * 关键点（中文）
+     * - 这是 per-plugin-instance 的长期运行态。
+     * - 不再复用 module-global 单例。
+     */
+    cronEngine = null;
+    constructor(agent) {
+        super(agent);
+        this.actions = createTaskPluginActions({
+            reloadSchedulerAfterMutation: async (params) => this.reloadSchedulerAfterMutation(params),
+        });
+        this.lifecycle = {
+            start: async (context) => {
+                const result = await this.startCronRuntime(context);
+                if (!result)
+                    return;
+                context.logger.info(formatTaskLogMessage(`Task cron trigger started (tasks=${result.tasksFound}, jobs=${result.jobsScheduled})`));
+            },
+            stop: async (context) => {
+                const stopped = await this.stopCronRuntime();
+                if (!stopped)
+                    return;
+                context.logger.info(formatTaskLogMessage("Task cron trigger stopped"));
+            },
+            command: async ({ context, command }) => {
+                if (command !== "reschedule" && command !== "reload") {
+                    return {
+                        success: false,
+                        message: `Unknown task command: ${command}`,
+                    };
+                }
+                const result = await this.restartCronRuntime(context);
+                context.logger.info(formatTaskLogMessage(`Task cron trigger reloaded (tasks=${result.tasksFound}, jobs=${result.jobsScheduled})`));
+                return {
+                    success: true,
+                    message: "task scheduler reloaded",
+                };
+            },
+        };
+    }
+    /**
+     * 启动当前实例的 cron runtime。
+     */
+    async startCronRuntime(context) {
+        if (this.cronEngine)
+            return null;
+        const engine = new TaskCronTriggerEngine();
+        const registerResult = await registerTaskCronJobs({
+            context,
+            engine,
+        });
+        await engine.start();
+        this.cronEngine = engine;
+        return registerResult;
+    }
+    /**
+     * 停止当前实例的 cron runtime。
+     */
+    async stopCronRuntime() {
+        if (!this.cronEngine)
+            return false;
+        const previous = this.cronEngine;
+        this.cronEngine = null;
+        await previous.stop();
+        return true;
+    }
+    /**
+     * 重启当前实例的 cron runtime。
+     */
+    async restartCronRuntime(context) {
+        await this.stopCronRuntime();
+        const started = await this.startCronRuntime(context);
+        return (started || {
+            tasksFound: 0,
+            jobsScheduled: 0,
+        });
+    }
+    /**
+     * 任务定义变更后重载 scheduler。
+     */
+    async reloadSchedulerAfterMutation(params) {
+        return await reloadTaskSchedulerAfterMutation({
+            context: params.context,
+            action: params.action,
+            title: params.title,
+            reloadScheduler: async (context) => this.restartCronRuntime(context),
+        });
+    }
+}
+//# sourceMappingURL=TaskPlugin.js.map

package/bin/task/TaskPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskPlugin.js","sourceRoot":"","sources":["../../src/task/TaskPlugin.ts"],"names":[],"mappings":"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"}

package/bin/task/runtime/CronTrigger.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Task cron 触发引擎。
+ *
+ * 关键点（中文）
+ * - 该模块仅服务于 task plugin runtime，不放在 core。
+ * - 只提供 cron 注册与调度，不承载 task 业务语义。
+ */
+import { TaskCronEngine, TaskCronTriggerDefinition } from "../types/Cron.js";
+export declare class TaskCronTriggerEngine implements TaskCronEngine {
+    private readonly definitions;
+    private readonly scheduledJobs;
+    private started;
+    register(definition: TaskCronTriggerDefinition): void;
+    unregister(id: string): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private scheduleOne;
+}
+//# sourceMappingURL=CronTrigger.d.ts.map

package/bin/task/runtime/CronTrigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronTrigger.d.ts","sourceRoot":"","sources":["../../../src/task/runtime/CronTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,cAAc,EACd,yBAAyB,EAC1B,MAAM,kBAAkB,CAAC;AAE1B,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAChB;IACZ,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,OAAO,CAAS;IAExB,QAAQ,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI;IAwBrD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAiBtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,OAAO,CAAC,WAAW;CAyBpB"}