@omnicrawl/cli-win32-ia32 0.4.2 → 0.4.4

package/host/omnicrawl/config/templates/config.example.toml

@@ -297,6 +297,55 @@ impersonate = ""
 # 单次请求的 URL 上限：0 表示用默认上限 20，否则按 1–20 收窄。
 max_urls = 0
 
+# 触发接口：让外部组件（定时任务、传感器脚本、CI、监控告警）在自定条件成立时拉起一个
+# 独立 loop。它们自己判断时间/温度/湿度/构建状态，命中后 POST 一条自定义消息，OmniCrawl
+# 用一次独立会话跑一轮，跑完把结果落盘并按需投递到消息平台。
+#
+#   omnicrawl trigger ensure   # 确保本机有一份可用服务（已就绪则复用）
+#   omnicrawl trigger status   # 打印配置、并发与队列
+#   omnicrawl trigger stop     # 停止本机共用的服务
+#
+#   POST /v1/triggers  {message, data?, title?, session_key?, workspace?,
+#                       timeout_seconds?, wait_seconds?, idempotency_key?,
+#                       notify?, tags?}
+#                      → {trigger_id, state, title, created_at, queue_position?, duplicate}
+#   GET  /v1/triggers[?state=&tag=&limit=]   列表（按创建时间倒序）
+#   GET  /v1/triggers/{id}                   单条状态与结果
+#   GET  /v1/triggers/{id}/events            SSE，事件名与 /api/v1/runs 同源
+#   GET  /v1/triggers/{id}/transcript        会话转录（回看那轮做了什么）
+#   POST /v1/triggers/{id}/cancel            取消（幂等）
+#
+# 与 /api/v1/runs 的区别：那条路是交互式入口，占单活动生成名额且写当前会话；触发接口有
+# 自己的会话根与并发池，无人值守任务不会和用户抢名额，也不污染用户的对话历史。
+#
+# 条件判定完全在外部组件：这里不内置调度器、不解析 cron。
+# 接口不做鉴权，host 只允许回环地址；工具白名单默认只读 + 记忆/知识库 + 联网检索，
+# 审批固定为自动审查（危险调用仍被审查闸拦下）。默认关闭。
+[trigger_api]
+enabled = false
+host = "127.0.0.1"
+# 端口：与本地 API（8765）、决策接口（8767）、抓取接口（8768）错开。
+port = 8769
+# 同时最多跑几个 loop（1–4）。每个 slot 一套独立的内核进程、工具表与会话。
+max_concurrency = 1
+# 排队上限；满了返回 429 QUEUE_FULL，调用方稍后重试。
+queue_limit = 32
+# 单次回合上限（60–7200 秒）；请求可用 timeout_seconds 收窄。
+default_timeout_seconds = 900
+# per_trigger：每次触发新开会话；keyed：允许请求用 session_key 复用持久会话（同名串行）。
+session_mode = "per_trigger"
+# 请求未给 workspace 时的缺省工作区；留空表示用宿主当前工作区。
+default_workspace = ""
+# 无人值守工具白名单（白名单语义：表外的工具既不声明给模型，宿主也不执行）。
+# 要放开 bash / write_file，前提是调用来源可信——报文、日志与网页内容会进模型上下文。
+tools = ["read", "read_image", "list", "find", "grep", "memory_search", "memory_read",
+         "memory_expand_related", "memory_write", "kb_search", "kb_read", "web_search",
+         "fetcher"]
+# 追加到固定无人值守约束之后的部署专属提示（例如「回复用中文，不超过 300 字」）。
+system_prompt_append = ""
+# 触发记录在服务进程内的保留小时数（1–8760）；会话转录另行保留在会话目录里。
+retention_hours = 168
+
 [agent_temp]
 enabled = true
 directory = ".omnicrawl/.agent_tmp"

package/host/omnicrawl/config/templates/decision_models.example.toml

@@ -118,10 +118,21 @@ tool_suggestion = false
 # 强调：只有能拆成相互独立、可并行推进的子任务，或需要隔离视角核查与隔离改动时才算用得到；
 # 单步问答、小改动、串行依赖的活一律判为用不到。
 #
-# 两类同时开启时，两条请求**并发发起**，总耗时取两者的较大者而不是相加；任一失败只少一行。
-# 决策服务不可用时同样按「本次无建议」处理，提问原文照发。
+# 三条建议（工具 / 子代理 / Skill）可同时开启：每条请求**并发发起**，总耗时取最大者而不是
+# 相加；任一失败只少一行。决策服务不可用时同样按「本次无建议」处理，提问原文照发。
 subagent_suggestion = false
 
+# 新提问自动建议 Skill：同样独立、可单开也可与前两条同开。候选另走一条路——先用当前提问对
+# 本机 Skill 索引做 BM25 检索（检索范围是名称 + 描述 + 正文），挑出最多 8 条池子，再把池子
+# 交给决策模型判定「本次符合哪几个的适用场景」。
+#
+# 上面的 `skill_search_rerank` 开着时，池子会先用决策模型重排再送审；关着就用 BM25 名次。
+# 也就是说注入本身不依赖决策服务，只有「判定哪两个最合适」这一步需要它。
+#
+# 最终**只注入前两名**，在提问尾部追加一行「建议使用skills：pdf、docx。」。
+# 本机一个 Skill 都没装、或提问一个检索词都没命中时，这次建议直接跳过（不发请求）。
+skill_suggestion = false
+
 # 决策 REST 接口：把决策能力暴露给本机其它程序（CLI 工具、Skill、外部脚本），
 # 它们不必经主模型就能拿到决策结果。大脑（主模型）负责规划，小脑（决策模型）负责
 # 快速判定，两者通过这个接口协同。

package/host/omnicrawl/templates/plan.md

@@ -51,7 +51,7 @@
 - 方案结构和各阶段之间的数据流；
 - 文件/模块职责与必要的接口、类型、配置或数据变更；
 - 输入校验、权限、敏感信息、错误、超时、取消和重试处理；
-- 与现有行为、历史数据、客户端、Provider、插件或外部依赖的兼容性；
+- 与现有行为、历史数据、客户端、Provider 或外部依赖的兼容性；
 - 最小而有针对性的测试案例、验收条件和失败后的诊断路径；
 - 发布、迁移、部署、监控与回滚影响（确有影响时才展开）。
 

package/host/omnicrawl/templates/subagents/explore.md

@@ -2,7 +2,11 @@
 name: explore
 description: 快速只读探索代码、网页和外部能力，返回文件路径、行号与可复核证据
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - Edit_file
   - write_file
   - memory_write

package/host/omnicrawl/templates/subagents/general-purpose.md

@@ -15,7 +15,11 @@ tools:
   - bash
   - powershell
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - switch_model
   - switch_skill
   - load_skill
@@ -36,7 +40,7 @@ background: false
 5. 完成后用简洁中文总结：改了什么、为什么、如何验证、残留风险。
 
 约束：
-- 禁止调用 subagent、switch_model、switch_skill、load_skill、search_skills。
+- 禁止调用 subagent_run、subagent_list、subagent_cancel、subagent_apply_worktree、subagent_discard_worktree、switch_model、switch_skill、load_skill、search_skills。
 - 不要提交 git commit、push 或改远程。
 - 不要删除用户未明确要求删除的文件。
 - isolation=worktree 时，结果会以分支/diff 形式返回父 Agent，由父决定是否应用。

package/host/omnicrawl/templates/subagents/plan.md

@@ -2,7 +2,11 @@
 name: plan
 description: 结合项目与外部证据制定只读的软件架构、实施步骤、风险与验证计划
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - Edit_file
   - write_file
   - memory_write

package/host/omnicrawl/templates/subagents/review.md

@@ -9,7 +9,11 @@ tools:
   - grep
   - git
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - Edit_file
   - write_file
   - memory_write

package/host/omnicrawl/templates/subagents/verify.md

@@ -12,7 +12,11 @@ tools:
   - memory_expand_related
   - verify_command
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - Edit_file
   - write_file
   - bash

package/host/omnicrawl/templates/system_prompt.md

@@ -64,6 +64,7 @@ omnicrawl文档（共 15 篇，均以 `omnicrawl://docs/<文件名>` 读取，
 - TTS 语音合成（Kokoro-82M ONNX CPU：配置、tts_synthesize 工具、CLI、音素化、模型下载）：读取 `omnicrawl://docs/TTS.md`；实现位于 `rust/crates/omnicrawl-tts/` 和 `rust/crates/omnicrawl-config/src/features/tts.rs`。
 - 决策接口（结构化决策模型的本地 REST 服务：启动、无鉴权的回环访问、decide/choice/rank/review 端点、常驻与复用、脱敏与安全边界）：读取 `omnicrawl://docs/decision_api.md`；实现位于 `rust/crates/omnicrawl-decision/` 和 `rust/crates/omnicrawl-config/src/features/decision_model.rs`。
 - 抓取接口（fetcher 的本机 REST 通道：`[fetch_api]` 配置、`/v1/fetch` 端点、无鉴权回环访问、Python 批量脚本调用、与工具同源的抓取语义与安全边界）：读取 `omnicrawl://docs/fetch_api.md`；实现位于 `rust/crates/omnicrawl-fetch/`、`rust/crates/omnicrawl-config/src/features/fetch_api.rs` 和 `rust/crates/omnicrawl-host/src/tools/fetcher.rs`。
+- 触发接口（外部事件拉起独立 loop：`[trigger_api]` 配置、`/v1/triggers` 端点、条件判定留给外部组件、无人值守审批与工具白名单、终态投递与去重）：读取 `omnicrawl://docs/trigger_api.md`；实现位于 `rust/crates/omnicrawl-trigger/` 和 `rust/crates/omnicrawl-config/src/features/trigger_api.rs`。
 - FSAPP 接入（文件系统应用侧的接入约定）：读取 `omnicrawl://docs/FSAPP.md`。
 
 脱敏占位符引用规则：

package/host/rust/assets/config-templates/config.example.toml

@@ -297,6 +297,55 @@ impersonate = ""
 # 单次请求的 URL 上限：0 表示用默认上限 20，否则按 1–20 收窄。
 max_urls = 0
 
+# 触发接口：让外部组件（定时任务、传感器脚本、CI、监控告警）在自定条件成立时拉起一个
+# 独立 loop。它们自己判断时间/温度/湿度/构建状态，命中后 POST 一条自定义消息，OmniCrawl
+# 用一次独立会话跑一轮，跑完把结果落盘并按需投递到消息平台。
+#
+#   omnicrawl trigger ensure   # 确保本机有一份可用服务（已就绪则复用）
+#   omnicrawl trigger status   # 打印配置、并发与队列
+#   omnicrawl trigger stop     # 停止本机共用的服务
+#
+#   POST /v1/triggers  {message, data?, title?, session_key?, workspace?,
+#                       timeout_seconds?, wait_seconds?, idempotency_key?,
+#                       notify?, tags?}
+#                      → {trigger_id, state, title, created_at, queue_position?, duplicate}
+#   GET  /v1/triggers[?state=&tag=&limit=]   列表（按创建时间倒序）
+#   GET  /v1/triggers/{id}                   单条状态与结果
+#   GET  /v1/triggers/{id}/events            SSE，事件名与 /api/v1/runs 同源
+#   GET  /v1/triggers/{id}/transcript        会话转录（回看那轮做了什么）
+#   POST /v1/triggers/{id}/cancel            取消（幂等）
+#
+# 与 /api/v1/runs 的区别：那条路是交互式入口，占单活动生成名额且写当前会话；触发接口有
+# 自己的会话根与并发池，无人值守任务不会和用户抢名额，也不污染用户的对话历史。
+#
+# 条件判定完全在外部组件：这里不内置调度器、不解析 cron。
+# 接口不做鉴权，host 只允许回环地址；工具白名单默认只读 + 记忆/知识库 + 联网检索，
+# 审批固定为自动审查（危险调用仍被审查闸拦下）。默认关闭。
+[trigger_api]
+enabled = false
+host = "127.0.0.1"
+# 端口：与本地 API（8765）、决策接口（8767）、抓取接口（8768）错开。
+port = 8769
+# 同时最多跑几个 loop（1–4）。每个 slot 一套独立的内核进程、工具表与会话。
+max_concurrency = 1
+# 排队上限；满了返回 429 QUEUE_FULL，调用方稍后重试。
+queue_limit = 32
+# 单次回合上限（60–7200 秒）；请求可用 timeout_seconds 收窄。
+default_timeout_seconds = 900
+# per_trigger：每次触发新开会话；keyed：允许请求用 session_key 复用持久会话（同名串行）。
+session_mode = "per_trigger"
+# 请求未给 workspace 时的缺省工作区；留空表示用宿主当前工作区。
+default_workspace = ""
+# 无人值守工具白名单（白名单语义：表外的工具既不声明给模型，宿主也不执行）。
+# 要放开 bash / write_file，前提是调用来源可信——报文、日志与网页内容会进模型上下文。
+tools = ["read", "read_image", "list", "find", "grep", "memory_search", "memory_read",
+         "memory_expand_related", "memory_write", "kb_search", "kb_read", "web_search",
+         "fetcher"]
+# 追加到固定无人值守约束之后的部署专属提示（例如「回复用中文，不超过 300 字」）。
+system_prompt_append = ""
+# 触发记录在服务进程内的保留小时数（1–8760）；会话转录另行保留在会话目录里。
+retention_hours = 168
+
 [agent_temp]
 enabled = true
 directory = ".omnicrawl/.agent_tmp"

package/host/rust/assets/config-templates/decision_models.example.toml

@@ -118,10 +118,21 @@ tool_suggestion = false
 # 强调：只有能拆成相互独立、可并行推进的子任务，或需要隔离视角核查与隔离改动时才算用得到；
 # 单步问答、小改动、串行依赖的活一律判为用不到。
 #
-# 两类同时开启时，两条请求**并发发起**，总耗时取两者的较大者而不是相加；任一失败只少一行。
-# 决策服务不可用时同样按「本次无建议」处理，提问原文照发。
+# 三条建议（工具 / 子代理 / Skill）可同时开启：每条请求**并发发起**，总耗时取最大者而不是
+# 相加；任一失败只少一行。决策服务不可用时同样按「本次无建议」处理，提问原文照发。
 subagent_suggestion = false
 
+# 新提问自动建议 Skill：同样独立、可单开也可与前两条同开。候选另走一条路——先用当前提问对
+# 本机 Skill 索引做 BM25 检索（检索范围是名称 + 描述 + 正文），挑出最多 8 条池子，再把池子
+# 交给决策模型判定「本次符合哪几个的适用场景」。
+#
+# 上面的 `skill_search_rerank` 开着时，池子会先用决策模型重排再送审；关着就用 BM25 名次。
+# 也就是说注入本身不依赖决策服务，只有「判定哪两个最合适」这一步需要它。
+#
+# 最终**只注入前两名**，在提问尾部追加一行「建议使用skills：pdf、docx。」。
+# 本机一个 Skill 都没装、或提问一个检索词都没命中时，这次建议直接跳过（不发请求）。
+skill_suggestion = false
+
 # 决策 REST 接口：把决策能力暴露给本机其它程序（CLI 工具、Skill、外部脚本），
 # 它们不必经主模型就能拿到决策结果。大脑（主模型）负责规划，小脑（决策模型）负责
 # 快速判定，两者通过这个接口协同。

package/host/rust/assets/templates/plan.md

@@ -51,7 +51,7 @@
 - 方案结构和各阶段之间的数据流；
 - 文件/模块职责与必要的接口、类型、配置或数据变更；
 - 输入校验、权限、敏感信息、错误、超时、取消和重试处理；
-- 与现有行为、历史数据、客户端、Provider、插件或外部依赖的兼容性；
+- 与现有行为、历史数据、客户端、Provider 或外部依赖的兼容性；
 - 最小而有针对性的测试案例、验收条件和失败后的诊断路径；
 - 发布、迁移、部署、监控与回滚影响（确有影响时才展开）。
 

package/host/rust/assets/templates/subagents/explore.md

@@ -2,7 +2,11 @@
 name: explore
 description: 快速只读探索代码、网页和外部能力，返回文件路径、行号与可复核证据
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - Edit_file
   - write_file
   - memory_write

package/host/rust/assets/templates/subagents/general-purpose.md

@@ -15,7 +15,11 @@ tools:
   - bash
   - powershell
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - switch_model
   - switch_skill
   - load_skill
@@ -36,7 +40,7 @@ background: false
 5. 完成后用简洁中文总结：改了什么、为什么、如何验证、残留风险。
 
 约束：
-- 禁止调用 subagent、switch_model、switch_skill、load_skill、search_skills。
+- 禁止调用 subagent_run、subagent_list、subagent_cancel、subagent_apply_worktree、subagent_discard_worktree、switch_model、switch_skill、load_skill、search_skills。
 - 不要提交 git commit、push 或改远程。
 - 不要删除用户未明确要求删除的文件。
 - isolation=worktree 时，结果会以分支/diff 形式返回父 Agent，由父决定是否应用。

package/host/rust/assets/templates/subagents/plan.md

@@ -2,7 +2,11 @@
 name: plan
 description: 结合项目与外部证据制定只读的软件架构、实施步骤、风险与验证计划
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - Edit_file
   - write_file
   - memory_write

package/host/rust/assets/templates/subagents/review.md

@@ -9,7 +9,11 @@ tools:
   - grep
   - git
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - Edit_file
   - write_file
   - memory_write

package/host/rust/assets/templates/subagents/verify.md

@@ -12,7 +12,11 @@ tools:
   - memory_expand_related
   - verify_command
 disallowedTools:
-  - subagent
+  - subagent_run
+  - subagent_list
+  - subagent_cancel
+  - subagent_apply_worktree
+  - subagent_discard_worktree
   - Edit_file
   - write_file
   - bash

package/host/rust/assets/templates/system_prompt.md

@@ -64,6 +64,7 @@ omnicrawl文档（共 15 篇，均以 `omnicrawl://docs/<文件名>` 读取，
 - TTS 语音合成（Kokoro-82M ONNX CPU：配置、tts_synthesize 工具、CLI、音素化、模型下载）：读取 `omnicrawl://docs/TTS.md`；实现位于 `rust/crates/omnicrawl-tts/` 和 `rust/crates/omnicrawl-config/src/features/tts.rs`。
 - 决策接口（结构化决策模型的本地 REST 服务：启动、无鉴权的回环访问、decide/choice/rank/review 端点、常驻与复用、脱敏与安全边界）：读取 `omnicrawl://docs/decision_api.md`；实现位于 `rust/crates/omnicrawl-decision/` 和 `rust/crates/omnicrawl-config/src/features/decision_model.rs`。
 - 抓取接口（fetcher 的本机 REST 通道：`[fetch_api]` 配置、`/v1/fetch` 端点、无鉴权回环访问、Python 批量脚本调用、与工具同源的抓取语义与安全边界）：读取 `omnicrawl://docs/fetch_api.md`；实现位于 `rust/crates/omnicrawl-fetch/`、`rust/crates/omnicrawl-config/src/features/fetch_api.rs` 和 `rust/crates/omnicrawl-host/src/tools/fetcher.rs`。
+- 触发接口（外部事件拉起独立 loop：`[trigger_api]` 配置、`/v1/triggers` 端点、条件判定留给外部组件、无人值守审批与工具白名单、终态投递与去重）：读取 `omnicrawl://docs/trigger_api.md`；实现位于 `rust/crates/omnicrawl-trigger/` 和 `rust/crates/omnicrawl-config/src/features/trigger_api.rs`。
 - FSAPP 接入（文件系统应用侧的接入约定）：读取 `omnicrawl://docs/FSAPP.md`。
 
 脱敏占位符引用规则：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnicrawl/cli-win32-ia32",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "OmniCrawl 平台包（Windows 32 位：内核 + 完整宿主）",
   "repository": {
     "type": "git",
@@ -21,6 +21,7 @@
     "omnicrawl-api": "host/omnicrawl-api.exe",
     "omnicrawl-decision": "host/omnicrawl-decision.exe",
     "omnicrawl-fetch": "host/omnicrawl-fetch.exe",
+    "omnicrawl-trigger": "host/omnicrawl-trigger.exe",
     "omnicrawl-mcp-server": "host/omnicrawl-mcp-server.exe"
   },
   "files": [

package/version.json

@@ -1,10 +1,10 @@
 {
   "name": "@omnicrawl/cli-win32-ia32",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "os": "win32",
   "cpu": "ia32",
-  "kernelVersion": "0.4.2",
-  "hostVersion": "0.4.2",
+  "kernelVersion": "0.4.4",
+  "hostVersion": "0.4.4",
   "hostPlatform": "win32-ia32",
-  "builtAt": "2026-10-29T17:12:12.814Z"
+  "builtAt": "2026-11-02T05:31:21.240Z"
 }

package/host/omnicrawl/extensions/node_runner.mjs

@@ -1,402 +0,0 @@
-#!/usr/bin/env node
-/**
- * OmniCrawl 单插件 Node runner。
- *
- * Host 固定调用：
- *   node node_runner.mjs --plugin-root <canonical-path>
- *
- * 协议：stdin/stdout NDJSON JSON-RPC 2.0。
- * 插件日志经 SDK logger 走 stderr 结构化行；普通 console 也被重定向到 stderr。
- */
-
-import { createRequire } from "node:module";
-import path from "node:path";
-import process from "node:process";
-import { pathToFileURL } from "node:url";
-import readline from "node:readline";
-import fs from "node:fs";
-
-const require = createRequire(import.meta.url);
-
-function parseArgs(argv) {
-  const args = { pluginRoot: "" };
-  for (let i = 0; i < argv.length; i += 1) {
-    const item = argv[i];
-    if (item === "--plugin-root") {
-      args.pluginRoot = argv[i + 1] || "";
-      i += 1;
-    }
-  }
-  return args;
-}
-
-function writeStdout(message) {
-  process.stdout.write(`${JSON.stringify(message)}\n`);
-}
-
-function writeStderrLine(level, message, fields = {}) {
-  const payload = {
-    level,
-    message: String(message),
-    fields,
-    ts: new Date().toISOString(),
-  };
-  process.stderr.write(`${JSON.stringify(payload)}\n`);
-}
-
-// 强制把 console 导向 stderr，避免污染协议 stdout。
-const originalConsole = { ...console };
-for (const level of ["log", "info", "warn", "error", "debug"]) {
-  console[level] = (...parts) => {
-    writeStderrLine(level === "log" ? "info" : level, parts.map(String).join(" "));
-  };
-}
-
-function createLogger() {
-  return {
-    debug(message, fields) {
-      writeStderrLine("debug", message, fields || {});
-    },
-    info(message, fields) {
-      writeStderrLine("info", message, fields || {});
-    },
-    warn(message, fields) {
-      writeStderrLine("warn", message, fields || {});
-    },
-    error(message, fields) {
-      writeStderrLine("error", message, fields || {});
-    },
-  };
-}
-
-function definePlugin(plugin) {
-  return plugin;
-}
-
-function loadPackageJson(pluginRoot) {
-  const packagePath = path.join(pluginRoot, "package.json");
-  const raw = fs.readFileSync(packagePath, "utf8");
-  return JSON.parse(raw);
-}
-
-async function importPlugin(entryPath) {
-  const url = pathToFileURL(entryPath).href;
-  const mod = await import(url);
-  return mod.default || mod.plugin || mod;
-}
-
-class PluginRuntime {
-  constructor(pluginRoot) {
-    this.pluginRoot = path.resolve(pluginRoot);
-    this.packageJson = loadPackageJson(this.pluginRoot);
-    this.manifest = this.packageJson.omnicrawl || {};
-    this.handlers = new Map();
-    this.plugin = null;
-    this.initialized = false;
-    this.activeCancellations = new Set();
-    this.logger = createLogger();
-    this._hostRequestId = 1;
-    this._pendingHostRequests = new Map();
-  }
-
-  /** Host 对 Worker 请求的响应入口（custom.emit 等）。 */
-  resolveHostResponse(message) {
-    if (!message || message.id == null) return false;
-    const pending = this._pendingHostRequests.get(message.id);
-    if (!pending) return false;
-    this._pendingHostRequests.delete(message.id);
-    if (message.error) {
-      pending.reject(new Error(message.error.message || String(message.error)));
-    } else {
-      pending.resolve(message.result || { ok: true });
-    }
-    return true;
-  }
-
-  _requestHost(method, params = {}) {
-    const id = this._hostRequestId;
-    this._hostRequestId += 1;
-    return new Promise((resolve, reject) => {
-      this._pendingHostRequests.set(id, { resolve, reject });
-      writeStdout({
-        jsonrpc: "2.0",
-        id,
-        method,
-        params,
-      });
-      // Host 超时由 Python 侧控制；Worker 侧给一个安全兜底。
-      setTimeout(() => {
-        if (this._pendingHostRequests.has(id)) {
-          this._pendingHostRequests.delete(id);
-          reject(new Error(`Host 请求超时：${method}`));
-        }
-      }, 10000);
-    });
-  }
-
-  async initialize(params = {}) {
-    if (this.initialized) {
-      return this._registrationSnapshot();
-    }
-    const entryRel = this.manifest.entry || this.packageJson.main;
-    if (!entryRel) {
-      throw new Error("package.json 缺少 omnicrawl.entry / main");
-    }
-    const entryPath = path.resolve(this.pluginRoot, entryRel);
-    const rootResolved = path.resolve(this.pluginRoot);
-    if (!entryPath.startsWith(rootResolved + path.sep) && entryPath !== rootResolved) {
-      throw new Error(`entry 逃逸包根目录：${entryRel}`);
-    }
-
-    const imported = await importPlugin(entryPath);
-    const definition = typeof imported === "function" ? imported({ definePlugin }) : imported;
-    if (!definition || typeof definition.activate !== "function") {
-      throw new Error("插件必须导出 activate(context) 的 PluginDefinition");
-    }
-    this.plugin = definition;
-
-    const declared = Array.isArray(this.manifest.hooks) ? this.manifest.hooks : [];
-    const declaredIds = new Set(declared.map((item) => item.id));
-
-    const context = {
-      plugin: {
-        name: this.packageJson.name,
-        version: this.packageJson.version,
-        apiVersion: String(this.manifest.apiVersion || "1"),
-      },
-      runtime: {
-        omnicrawlVersion: params.omnicrawlVersion || process.env.OMNICRAWL_VERSION || "0.1.5",
-        nodeVersion: process.version,
-      },
-      hooks: {
-        on: (registration) => {
-          if (!registration || typeof registration !== "object") {
-            throw new Error("hooks.on(registration) 需要对象");
-          }
-          const id = String(registration.id || "");
-          const hook = String(registration.hook || "");
-          const mode = String(registration.mode || "observe");
-          const handler = registration.handler;
-          if (!declaredIds.has(id)) {
-            throw new Error(`运行期不能注册 manifest 未声明的 Handler：${id}`);
-          }
-          if (typeof handler !== "function") {
-            throw new Error(`Handler ${id} 缺少 handler 函数`);
-          }
-          this.handlers.set(id, { id, hook, mode, handler });
-          return () => {
-            this.handlers.delete(id);
-          };
-        },
-        emitCustom: async (event, payload = {}, options = {}) => {
-          if (!this.initialized) {
-            throw new Error("initialize 完成前不能 emitCustom");
-          }
-          const permissions = Array.isArray(this.manifest.permissions)
-            ? this.manifest.permissions
-            : [];
-          if (!permissions.includes("hook:custom-emit")) {
-            throw new Error("缺少 hook:custom-emit 权限");
-          }
-          const version =
-            options.version != null
-              ? Number(options.version)
-              : Number(
-                  (Array.isArray(this.manifest.customEvents)
-                    ? this.manifest.customEvents.find((item) => item.name === event)
-                    : null)?.version || 1
-                );
-
-          // 同插件订阅必须本地投递：Host 若在 hook.invoke 中再回调本 Worker
-          // 会与“等待 custom.emit 响应”形成死锁。
-          let localDelivered = 0;
-          const localEvent = {
-            apiVersion: String(this.manifest.apiVersion || "1"),
-            hook: event,
-            payload: payload || {},
-            timestamp: new Date().toISOString(),
-          };
-          for (const binding of this.handlers.values()) {
-            if (binding.hook !== event) continue;
-            await binding.handler(localEvent);
-            localDelivered += 1;
-          }
-
-          const result = await this._requestHost("custom.emit", {
-            event,
-            version,
-            payload: payload || {},
-            localDelivered,
-          });
-          return {
-            ...(result || { ok: true }),
-            localDelivered,
-            delivered: Number(result?.delivered || 0) + localDelivered,
-          };
-        },
-      },
-      logger: this.logger,
-    };
-
-    await definition.activate(context);
-
-    // 若插件未在 activate 中显式 on()，但 manifest 声明了 hooks，则保持空绑定；
-    // Host 会在二次校验时发现实际注册子集。
-    this.initialized = true;
-    return this._registrationSnapshot();
-  }
-
-  _registrationSnapshot() {
-    const registrations = [];
-    for (const item of this.handlers.values()) {
-      registrations.push({
-        id: item.id,
-        hook: item.hook,
-        mode: item.mode,
-      });
-    }
-    // 若 activate 没手动 on，回落为 manifest 声明（开发期便利）；
-    // Host 仍要求它们是 manifest 子集。
-    if (registrations.length === 0 && Array.isArray(this.manifest.hooks)) {
-      for (const item of this.manifest.hooks) {
-        registrations.push({
-          id: item.id,
-          hook: item.hook,
-          mode: item.mode,
-        });
-      }
-    }
-    return {
-      plugin: {
-        name: this.packageJson.name,
-        version: this.packageJson.version,
-        apiVersion: String(this.manifest.apiVersion || "1"),
-      },
-      handlers: registrations,
-      capabilities: {
-        customEmit: Boolean(
-          Array.isArray(this.manifest.permissions) &&
-            this.manifest.permissions.includes("hook:custom-emit")
-        ),
-      },
-    };
-  }
-
-  async invoke(handlerId, event) {
-    const binding = this.handlers.get(handlerId);
-    if (!binding) {
-      // 允许仅声明未绑定：默认 continue，便于 observe 空实现。
-      return { action: "continue" };
-    }
-    const result = await binding.handler(event);
-    if (result == null) {
-      return { action: "continue" };
-    }
-    if (typeof result !== "object") {
-      throw new Error(`Handler ${handlerId} 必须返回对象`);
-    }
-    return result;
-  }
-
-  async shutdown() {
-    if (this.plugin && typeof this.plugin.deactivate === "function") {
-      await this.plugin.deactivate();
-    }
-    this.handlers.clear();
-    this.initialized = false;
-  }
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  if (!args.pluginRoot) {
-    writeStderrLine("error", "missing --plugin-root");
-    process.exit(2);
-  }
-  const runtime = new PluginRuntime(args.pluginRoot);
-  const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
-
-  const sendResult = (id, result) => {
-    writeStdout({ jsonrpc: "2.0", id, result });
-  };
-  const sendError = (id, code, message) => {
-    writeStdout({ jsonrpc: "2.0", id, error: { code, message } });
-  };
-
-  // 必须用事件驱动读取 stdin：handler 内 await custom.emit 时 Host 响应
-  // 也要从同一 stdin 进来。若 for-await 串行阻塞，会形成死锁超时。
-  let shuttingDown = false;
-  const inflight = new Set();
-
-  const handleMessage = async (message) => {
-    // Host 对 Worker 请求的响应：无 method，带 id+result/error。
-    if (
-      message.id != null &&
-      (Object.prototype.hasOwnProperty.call(message, "result") ||
-        Object.prototype.hasOwnProperty.call(message, "error")) &&
-      !message.method
-    ) {
-      runtime.resolveHostResponse(message);
-      return;
-    }
-
-    const { id, method, params } = message;
-    try {
-      if (method === "initialize") {
-        const result = await runtime.initialize(params || {});
-        if (id !== undefined) sendResult(id, result);
-      } else if (method === "hook.invoke") {
-        const handlerId = params?.handlerId;
-        const event = params?.event || {};
-        const result = await runtime.invoke(handlerId, event);
-        if (id !== undefined) sendResult(id, result);
-      } else if (method === "hook.cancel") {
-        const requestId = params?.requestId;
-        if (requestId != null) runtime.activeCancellations.add(requestId);
-        if (id !== undefined) sendResult(id, { ok: true });
-      } else if (method === "ping") {
-        if (id !== undefined) sendResult(id, { ok: true, ts: Date.now() });
-      } else if (method === "shutdown") {
-        shuttingDown = true;
-        await runtime.shutdown();
-        if (id !== undefined) sendResult(id, { ok: true });
-        process.exit(0);
-      } else if (method) {
-        if (id !== undefined) sendError(id, -32601, `Method not found: ${method}`);
-      }
-    } catch (error) {
-      const text = error instanceof Error ? error.message : String(error);
-      writeStderrLine("error", text);
-      if (id !== undefined) sendError(id, -32000, text);
-    }
-  };
-
-  rl.on("line", (line) => {
-    if (shuttingDown) return;
-    const trimmed = String(line || "").trim();
-    if (!trimmed) return;
-    let message;
-    try {
-      message = JSON.parse(trimmed);
-    } catch (error) {
-      writeStderrLine("error", "invalid json from host", { error: String(error) });
-      return;
-    }
-    if (!message || typeof message !== "object") return;
-    const task = handleMessage(message);
-    inflight.add(task);
-    task.finally(() => inflight.delete(task));
-  });
-
-  await new Promise((resolve) => {
-    rl.on("close", resolve);
-  });
-  await Promise.allSettled([...inflight]);
-}
-
-main().catch((error) => {
-  writeStderrLine("error", error instanceof Error ? error.message : String(error));
-  process.exit(1);
-});
-
-export { definePlugin };

package/host/rust/assets/extensions/node_runner.mjs

@@ -1,402 +0,0 @@
-#!/usr/bin/env node
-/**
- * OmniCrawl 单插件 Node runner。
- *
- * Host 固定调用：
- *   node node_runner.mjs --plugin-root <canonical-path>
- *
- * 协议：stdin/stdout NDJSON JSON-RPC 2.0。
- * 插件日志经 SDK logger 走 stderr 结构化行；普通 console 也被重定向到 stderr。
- */
-
-import { createRequire } from "node:module";
-import path from "node:path";
-import process from "node:process";
-import { pathToFileURL } from "node:url";
-import readline from "node:readline";
-import fs from "node:fs";
-
-const require = createRequire(import.meta.url);
-
-function parseArgs(argv) {
-  const args = { pluginRoot: "" };
-  for (let i = 0; i < argv.length; i += 1) {
-    const item = argv[i];
-    if (item === "--plugin-root") {
-      args.pluginRoot = argv[i + 1] || "";
-      i += 1;
-    }
-  }
-  return args;
-}
-
-function writeStdout(message) {
-  process.stdout.write(`${JSON.stringify(message)}\n`);
-}
-
-function writeStderrLine(level, message, fields = {}) {
-  const payload = {
-    level,
-    message: String(message),
-    fields,
-    ts: new Date().toISOString(),
-  };
-  process.stderr.write(`${JSON.stringify(payload)}\n`);
-}
-
-// 强制把 console 导向 stderr，避免污染协议 stdout。
-const originalConsole = { ...console };
-for (const level of ["log", "info", "warn", "error", "debug"]) {
-  console[level] = (...parts) => {
-    writeStderrLine(level === "log" ? "info" : level, parts.map(String).join(" "));
-  };
-}
-
-function createLogger() {
-  return {
-    debug(message, fields) {
-      writeStderrLine("debug", message, fields || {});
-    },
-    info(message, fields) {
-      writeStderrLine("info", message, fields || {});
-    },
-    warn(message, fields) {
-      writeStderrLine("warn", message, fields || {});
-    },
-    error(message, fields) {
-      writeStderrLine("error", message, fields || {});
-    },
-  };
-}
-
-function definePlugin(plugin) {
-  return plugin;
-}
-
-function loadPackageJson(pluginRoot) {
-  const packagePath = path.join(pluginRoot, "package.json");
-  const raw = fs.readFileSync(packagePath, "utf8");
-  return JSON.parse(raw);
-}
-
-async function importPlugin(entryPath) {
-  const url = pathToFileURL(entryPath).href;
-  const mod = await import(url);
-  return mod.default || mod.plugin || mod;
-}
-
-class PluginRuntime {
-  constructor(pluginRoot) {
-    this.pluginRoot = path.resolve(pluginRoot);
-    this.packageJson = loadPackageJson(this.pluginRoot);
-    this.manifest = this.packageJson.omnicrawl || {};
-    this.handlers = new Map();
-    this.plugin = null;
-    this.initialized = false;
-    this.activeCancellations = new Set();
-    this.logger = createLogger();
-    this._hostRequestId = 1;
-    this._pendingHostRequests = new Map();
-  }
-
-  /** Host 对 Worker 请求的响应入口（custom.emit 等）。 */
-  resolveHostResponse(message) {
-    if (!message || message.id == null) return false;
-    const pending = this._pendingHostRequests.get(message.id);
-    if (!pending) return false;
-    this._pendingHostRequests.delete(message.id);
-    if (message.error) {
-      pending.reject(new Error(message.error.message || String(message.error)));
-    } else {
-      pending.resolve(message.result || { ok: true });
-    }
-    return true;
-  }
-
-  _requestHost(method, params = {}) {
-    const id = this._hostRequestId;
-    this._hostRequestId += 1;
-    return new Promise((resolve, reject) => {
-      this._pendingHostRequests.set(id, { resolve, reject });
-      writeStdout({
-        jsonrpc: "2.0",
-        id,
-        method,
-        params,
-      });
-      // Host 超时由 Python 侧控制；Worker 侧给一个安全兜底。
-      setTimeout(() => {
-        if (this._pendingHostRequests.has(id)) {
-          this._pendingHostRequests.delete(id);
-          reject(new Error(`Host 请求超时：${method}`));
-        }
-      }, 10000);
-    });
-  }
-
-  async initialize(params = {}) {
-    if (this.initialized) {
-      return this._registrationSnapshot();
-    }
-    const entryRel = this.manifest.entry || this.packageJson.main;
-    if (!entryRel) {
-      throw new Error("package.json 缺少 omnicrawl.entry / main");
-    }
-    const entryPath = path.resolve(this.pluginRoot, entryRel);
-    const rootResolved = path.resolve(this.pluginRoot);
-    if (!entryPath.startsWith(rootResolved + path.sep) && entryPath !== rootResolved) {
-      throw new Error(`entry 逃逸包根目录：${entryRel}`);
-    }
-
-    const imported = await importPlugin(entryPath);
-    const definition = typeof imported === "function" ? imported({ definePlugin }) : imported;
-    if (!definition || typeof definition.activate !== "function") {
-      throw new Error("插件必须导出 activate(context) 的 PluginDefinition");
-    }
-    this.plugin = definition;
-
-    const declared = Array.isArray(this.manifest.hooks) ? this.manifest.hooks : [];
-    const declaredIds = new Set(declared.map((item) => item.id));
-
-    const context = {
-      plugin: {
-        name: this.packageJson.name,
-        version: this.packageJson.version,
-        apiVersion: String(this.manifest.apiVersion || "1"),
-      },
-      runtime: {
-        omnicrawlVersion: params.omnicrawlVersion || process.env.OMNICRAWL_VERSION || "0.1.5",
-        nodeVersion: process.version,
-      },
-      hooks: {
-        on: (registration) => {
-          if (!registration || typeof registration !== "object") {
-            throw new Error("hooks.on(registration) 需要对象");
-          }
-          const id = String(registration.id || "");
-          const hook = String(registration.hook || "");
-          const mode = String(registration.mode || "observe");
-          const handler = registration.handler;
-          if (!declaredIds.has(id)) {
-            throw new Error(`运行期不能注册 manifest 未声明的 Handler：${id}`);
-          }
-          if (typeof handler !== "function") {
-            throw new Error(`Handler ${id} 缺少 handler 函数`);
-          }
-          this.handlers.set(id, { id, hook, mode, handler });
-          return () => {
-            this.handlers.delete(id);
-          };
-        },
-        emitCustom: async (event, payload = {}, options = {}) => {
-          if (!this.initialized) {
-            throw new Error("initialize 完成前不能 emitCustom");
-          }
-          const permissions = Array.isArray(this.manifest.permissions)
-            ? this.manifest.permissions
-            : [];
-          if (!permissions.includes("hook:custom-emit")) {
-            throw new Error("缺少 hook:custom-emit 权限");
-          }
-          const version =
-            options.version != null
-              ? Number(options.version)
-              : Number(
-                  (Array.isArray(this.manifest.customEvents)
-                    ? this.manifest.customEvents.find((item) => item.name === event)
-                    : null)?.version || 1
-                );
-
-          // 同插件订阅必须本地投递：Host 若在 hook.invoke 中再回调本 Worker
-          // 会与“等待 custom.emit 响应”形成死锁。
-          let localDelivered = 0;
-          const localEvent = {
-            apiVersion: String(this.manifest.apiVersion || "1"),
-            hook: event,
-            payload: payload || {},
-            timestamp: new Date().toISOString(),
-          };
-          for (const binding of this.handlers.values()) {
-            if (binding.hook !== event) continue;
-            await binding.handler(localEvent);
-            localDelivered += 1;
-          }
-
-          const result = await this._requestHost("custom.emit", {
-            event,
-            version,
-            payload: payload || {},
-            localDelivered,
-          });
-          return {
-            ...(result || { ok: true }),
-            localDelivered,
-            delivered: Number(result?.delivered || 0) + localDelivered,
-          };
-        },
-      },
-      logger: this.logger,
-    };
-
-    await definition.activate(context);
-
-    // 若插件未在 activate 中显式 on()，但 manifest 声明了 hooks，则保持空绑定；
-    // Host 会在二次校验时发现实际注册子集。
-    this.initialized = true;
-    return this._registrationSnapshot();
-  }
-
-  _registrationSnapshot() {
-    const registrations = [];
-    for (const item of this.handlers.values()) {
-      registrations.push({
-        id: item.id,
-        hook: item.hook,
-        mode: item.mode,
-      });
-    }
-    // 若 activate 没手动 on，回落为 manifest 声明（开发期便利）；
-    // Host 仍要求它们是 manifest 子集。
-    if (registrations.length === 0 && Array.isArray(this.manifest.hooks)) {
-      for (const item of this.manifest.hooks) {
-        registrations.push({
-          id: item.id,
-          hook: item.hook,
-          mode: item.mode,
-        });
-      }
-    }
-    return {
-      plugin: {
-        name: this.packageJson.name,
-        version: this.packageJson.version,
-        apiVersion: String(this.manifest.apiVersion || "1"),
-      },
-      handlers: registrations,
-      capabilities: {
-        customEmit: Boolean(
-          Array.isArray(this.manifest.permissions) &&
-            this.manifest.permissions.includes("hook:custom-emit")
-        ),
-      },
-    };
-  }
-
-  async invoke(handlerId, event) {
-    const binding = this.handlers.get(handlerId);
-    if (!binding) {
-      // 允许仅声明未绑定：默认 continue，便于 observe 空实现。
-      return { action: "continue" };
-    }
-    const result = await binding.handler(event);
-    if (result == null) {
-      return { action: "continue" };
-    }
-    if (typeof result !== "object") {
-      throw new Error(`Handler ${handlerId} 必须返回对象`);
-    }
-    return result;
-  }
-
-  async shutdown() {
-    if (this.plugin && typeof this.plugin.deactivate === "function") {
-      await this.plugin.deactivate();
-    }
-    this.handlers.clear();
-    this.initialized = false;
-  }
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  if (!args.pluginRoot) {
-    writeStderrLine("error", "missing --plugin-root");
-    process.exit(2);
-  }
-  const runtime = new PluginRuntime(args.pluginRoot);
-  const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
-
-  const sendResult = (id, result) => {
-    writeStdout({ jsonrpc: "2.0", id, result });
-  };
-  const sendError = (id, code, message) => {
-    writeStdout({ jsonrpc: "2.0", id, error: { code, message } });
-  };
-
-  // 必须用事件驱动读取 stdin：handler 内 await custom.emit 时 Host 响应
-  // 也要从同一 stdin 进来。若 for-await 串行阻塞，会形成死锁超时。
-  let shuttingDown = false;
-  const inflight = new Set();
-
-  const handleMessage = async (message) => {
-    // Host 对 Worker 请求的响应：无 method，带 id+result/error。
-    if (
-      message.id != null &&
-      (Object.prototype.hasOwnProperty.call(message, "result") ||
-        Object.prototype.hasOwnProperty.call(message, "error")) &&
-      !message.method
-    ) {
-      runtime.resolveHostResponse(message);
-      return;
-    }
-
-    const { id, method, params } = message;
-    try {
-      if (method === "initialize") {
-        const result = await runtime.initialize(params || {});
-        if (id !== undefined) sendResult(id, result);
-      } else if (method === "hook.invoke") {
-        const handlerId = params?.handlerId;
-        const event = params?.event || {};
-        const result = await runtime.invoke(handlerId, event);
-        if (id !== undefined) sendResult(id, result);
-      } else if (method === "hook.cancel") {
-        const requestId = params?.requestId;
-        if (requestId != null) runtime.activeCancellations.add(requestId);
-        if (id !== undefined) sendResult(id, { ok: true });
-      } else if (method === "ping") {
-        if (id !== undefined) sendResult(id, { ok: true, ts: Date.now() });
-      } else if (method === "shutdown") {
-        shuttingDown = true;
-        await runtime.shutdown();
-        if (id !== undefined) sendResult(id, { ok: true });
-        process.exit(0);
-      } else if (method) {
-        if (id !== undefined) sendError(id, -32601, `Method not found: ${method}`);
-      }
-    } catch (error) {
-      const text = error instanceof Error ? error.message : String(error);
-      writeStderrLine("error", text);
-      if (id !== undefined) sendError(id, -32000, text);
-    }
-  };
-
-  rl.on("line", (line) => {
-    if (shuttingDown) return;
-    const trimmed = String(line || "").trim();
-    if (!trimmed) return;
-    let message;
-    try {
-      message = JSON.parse(trimmed);
-    } catch (error) {
-      writeStderrLine("error", "invalid json from host", { error: String(error) });
-      return;
-    }
-    if (!message || typeof message !== "object") return;
-    const task = handleMessage(message);
-    inflight.add(task);
-    task.finally(() => inflight.delete(task));
-  });
-
-  await new Promise((resolve) => {
-    rl.on("close", resolve);
-  });
-  await Promise.allSettled([...inflight]);
-}
-
-main().catch((error) => {
-  writeStderrLine("error", error instanceof Error ? error.message : String(error));
-  process.exit(1);
-});
-
-export { definePlugin };