evolcore 0.0.45 → 0.0.46

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.
Files changed (204) hide show
  1. package/CHANGELOG.md +75 -0
  2. package/bin/ecmsg.js +33 -23
  3. package/dist/ability/application-service.js +1 -2
  4. package/dist/ability/package.js +28 -0
  5. package/dist/agent-template/jobs.js +158 -36
  6. package/dist/agent-template/runtime.js +401 -34
  7. package/dist/agent-template/service.js +764 -369
  8. package/dist/agent-template/tool-runner.js +35 -17
  9. package/dist/agent-template/types.js +7 -4
  10. package/dist/agents/baseagent.js +10 -9
  11. package/dist/agents/claude-runner.js +13 -5
  12. package/dist/agents/codex/app-server-client.js +2 -4
  13. package/dist/agents/codex/diagnostics.js +18 -1
  14. package/dist/agents/codex-runner.js +3 -1
  15. package/dist/agents/ecagent-runner.js +3 -1
  16. package/dist/agents/gemini-runner.js +2 -1
  17. package/dist/aun/menu/client.js +142 -182
  18. package/dist/aun/rpc/client.js +33 -17
  19. package/dist/aun/service-proxy.js +6 -23
  20. package/dist/channels/aun.js +656 -112
  21. package/dist/cli/agent-create.js +37 -10
  22. package/dist/cli/agent-template.js +105 -84
  23. package/dist/cli/agent.js +31 -18
  24. package/dist/cli/daemon-commands.js +15 -17
  25. package/dist/cli/daemon-lifecycle-client.js +40 -18
  26. package/dist/cli/directory.js +12 -4
  27. package/dist/cli/ecmsg-gateway.js +5 -2
  28. package/dist/cli/events-command.js +2 -1
  29. package/dist/cli/init.js +50 -20
  30. package/dist/cli/integrity-command.js +2 -0
  31. package/dist/cli/managed-command-guard.js +20 -1
  32. package/dist/cli/menu-client.js +7 -5
  33. package/dist/cli/restart-monitor.js +33 -20
  34. package/dist/cli/services-command.js +28 -5
  35. package/dist/config/config-field-policy.js +24 -0
  36. package/dist/config/config-manager.js +20 -2
  37. package/dist/config/peer-book-store.js +152 -120
  38. package/dist/config/peer-role-resolver.js +24 -4
  39. package/dist/config/provider-identity-migration.js +1 -1
  40. package/dist/config/provider-identity.js +10 -4
  41. package/dist/config/provider-ipc-service.js +10 -2
  42. package/dist/config/provider-local-sync.js +2 -2
  43. package/dist/config/providers-config.js +95 -10
  44. package/dist/config/providers-import.js +4 -6
  45. package/dist/config/providers.js +14 -3
  46. package/dist/config/role-store.js +1 -1
  47. package/dist/config-store.js +9 -1
  48. package/dist/core/agent-application-service.js +56 -29
  49. package/dist/core/agent-create-status.js +3 -1
  50. package/dist/core/agent-creation-claim.js +1 -0
  51. package/dist/core/agent-ipc-registration.js +2 -2
  52. package/dist/core/agent-reload-coordinator.js +38 -1
  53. package/dist/core/agent-runtime.js +85 -38
  54. package/dist/core/auth/agent-delegation.js +5 -0
  55. package/dist/core/auth/operation-authorizer.js +1 -1
  56. package/dist/core/auth/operation-catalog.js +3 -3
  57. package/dist/core/bootstrap-service.js +3 -0
  58. package/dist/core/capability/capability-manager.js +3 -1
  59. package/dist/core/channel-loader.js +29 -3
  60. package/dist/core/channel-runtime.js +1 -1
  61. package/dist/core/command/agent-control.js +6 -5
  62. package/dist/core/command/agent-template-menu.js +32 -97
  63. package/dist/core/command/eventcenter-menu.js +61 -13
  64. package/dist/core/command/menu-catalog.js +11 -4
  65. package/dist/core/command/menu-handler.js +35 -8
  66. package/dist/core/command/menu-protocol.js +8 -16
  67. package/dist/core/command/skill-slash.js +6 -2
  68. package/dist/core/command/team-workspace-bootstrap.js +1 -2
  69. package/dist/core/command/team-workspace-management-store.js +83 -0
  70. package/dist/core/command/team-workspace-management.js +1 -2
  71. package/dist/core/command/team-workspace-team.js +26 -3
  72. package/dist/core/daemon-control.js +3 -4
  73. package/dist/core/daemon-lifecycle.js +146 -110
  74. package/dist/core/evolagent-registry.js +42 -0
  75. package/dist/core/evolagent.js +2 -1
  76. package/dist/core/file-integrity/read.js +9 -16
  77. package/dist/core/file-integrity/store.js +94 -34
  78. package/dist/core/handoff/dispatcher.js +33 -7
  79. package/dist/core/handoff/runtime.js +8 -0
  80. package/dist/core/inference/text-inference.js +12 -2
  81. package/dist/core/invoke/invoke-service.js +24 -3
  82. package/dist/core/ipc-registration.js +3 -0
  83. package/dist/core/message/aun-ipc-sender.js +109 -7
  84. package/dist/core/message/contact-admission.js +6 -2
  85. package/dist/core/message/message-bridge.js +13 -0
  86. package/dist/core/message/message-queue.js +131 -30
  87. package/dist/core/message/pending-hints.js +8 -0
  88. package/dist/core/message/response-engine.js +48 -2
  89. package/dist/core/message/send-routing.js +3 -12
  90. package/dist/core/model/catalog-service.js +13 -0
  91. package/dist/core/model/model-catalog.js +57 -18
  92. package/dist/core/pack-auth.js +163 -31
  93. package/dist/core/pack-install.js +42 -1
  94. package/dist/{services/ledger.js → core/pack-ledger.js} +17 -6
  95. package/dist/core/permission/ec-command-parser.js +3 -1
  96. package/dist/core/permission/shell-environment.js +23 -0
  97. package/dist/core/rate-window.js +6 -1
  98. package/dist/core/session/session-idle-monitor.js +0 -1
  99. package/dist/core/session/session-manager.js +14 -0
  100. package/dist/core/session/session-title.js +26 -6
  101. package/dist/core/skill/index-generator.js +3 -4
  102. package/dist/core/thread/thread-service.js +0 -1
  103. package/dist/core/thread/topic-id.js +8 -0
  104. package/dist/directory/owner-directory-admission.js +17 -0
  105. package/dist/directory/owner-directory-cache.js +3 -1
  106. package/dist/directory/owner-directory-markdown.js +145 -23
  107. package/dist/directory/owner-directory-policy.js +23 -0
  108. package/dist/directory/owner-directory-query-operation.js +20 -6
  109. package/dist/directory/owner-directory-search.js +47 -0
  110. package/dist/eck/message-renderer.js +171 -32
  111. package/dist/ecweb/basic-settings-service.js +7 -3
  112. package/dist/ecweb/providers-service.js +17 -10
  113. package/dist/ecweb/runtime/lifecycle.js +1 -1
  114. package/dist/ecweb/runtime/supervisor.js +77 -35
  115. package/dist/event-center/admission-materializer.js +1 -1
  116. package/dist/event-center/bus-gate.js +48 -4
  117. package/dist/event-center/bus-host.js +3 -3
  118. package/dist/event-center/center-config.js +57 -28
  119. package/dist/event-center/dispatcher.js +8 -0
  120. package/dist/event-center/event-log.js +69 -27
  121. package/dist/event-center/index-generator.js +6 -1
  122. package/dist/event-center/ipc-operation.js +66 -25
  123. package/dist/event-center/pack-loader.js +12 -55
  124. package/dist/event-center/pack-manager.js +5 -3
  125. package/dist/event-center/registry.js +48 -52
  126. package/dist/event-center/runtime.js +219 -81
  127. package/dist/event-center/script-runner.js +18 -7
  128. package/dist/event-center/types.js +9 -1
  129. package/dist/event-center/validation.js +33 -4
  130. package/dist/index.js +96 -42
  131. package/dist/ipc.js +33 -7
  132. package/dist/product.js +1 -0
  133. package/dist/proxy/manager.js +52 -11
  134. package/dist/proxy/service-supervisor.js +265 -67
  135. package/dist/services/dispatcher.js +26 -3
  136. package/dist/services/idempotency.js +128 -0
  137. package/dist/services/identity.js +3 -27
  138. package/dist/services/index-generator.js +5 -1
  139. package/dist/services/index.js +244 -45
  140. package/dist/services/ipc-operation.js +164 -20
  141. package/dist/services/pack-manager.js +37 -9
  142. package/dist/services/router.js +100 -31
  143. package/dist/services/script-runner.js +15 -4
  144. package/dist/services/service-payload.js +50 -2
  145. package/dist/services/validation.js +107 -3
  146. package/dist/trigger/scheduler.js +14 -4
  147. package/dist/trigger/script-sandbox.js +39 -2
  148. package/dist/utils/cross-platform.js +35 -11
  149. package/dist/utils/error-utils.js +13 -1
  150. package/dist/utils/instance-registry.js +33 -35
  151. package/dist/utils/process-introspect.js +35 -20
  152. package/dist/utils/project-path.js +47 -3
  153. package/dist/utils/windows-shell-trust.js +174 -68
  154. package/kits/docs/context-assembly.md +3 -3
  155. package/kits/docs/evolcore/agent.md +28 -10
  156. package/kits/docs/evolcore/config.md +22 -0
  157. package/kits/docs/evolcore/directory.md +46 -12
  158. package/kits/docs/evolcore/event-center.md +6 -6
  159. package/kits/docs/evolcore/group-collaboration.md +1 -1
  160. package/kits/docs/evolcore/menu-client.md +7 -5
  161. package/kits/docs/evolcore/menu-protocol.md +5 -3
  162. package/kits/docs/evolcore/msg.md +10 -3
  163. package/kits/docs/evolcore/provider.md +7 -3
  164. package/kits/docs/evolcore/services.md +145 -12
  165. package/kits/docs/evolcore/thread-chain.md +17 -9
  166. package/kits/docs/prompt-loading-architecture.md +4 -4
  167. package/kits/eck_message_manifest.json +46 -3
  168. package/kits/rules/04-relation.md +10 -2
  169. package/kits/rules/06-channel.md +2 -1
  170. package/kits/schemas/providers.schema.2.json +1 -0
  171. package/kits/skills/ec-group/SKILL.md +4 -0
  172. package/kits/skills/ec-skill/scripts/cli.mjs +1 -1
  173. package/kits/skills/ec-skill/scripts/skill.mjs +13 -2
  174. package/kits/skills/thread-ops/SKILL.md +8 -5
  175. package/kits/templates/message-fragments/group-batch-item.md +3 -0
  176. package/kits/templates/message-fragments/group-batch.md +1 -0
  177. package/kits/templates/message-fragments/item-group.md +4 -0
  178. package/kits/templates/message-fragments/item-private.md +4 -0
  179. package/kits/templates/message-fragments/thread-context.md +1 -1
  180. package/kits/templates/system-fragments/commands.md +5 -5
  181. package/kits/templates/system-fragments/managed-runtime.md +1 -1
  182. package/kits/templates/system-fragments/relation.md +11 -7
  183. package/package.json +3 -2
  184. package/scripts/agent-template/index.mjs +9 -4
  185. package/scripts/agent-template/inspect.mjs +16 -9
  186. package/scripts/agent-template/shared/plan.mjs +3 -33
  187. package/scripts/agent-template/shared/template-contract.mjs +186 -3
  188. package/scripts/agent-template/shared/template-package.mjs +119 -10
  189. package/scripts/agent-template/shared/template-runtime.mjs +49 -6
  190. package/scripts/agent-template/shared/template.mjs +5 -5
  191. package/scripts/agent-template/team-pack.mjs +245 -0
  192. package/scripts/agent-template/team-preview.mjs +111 -0
  193. package/scripts/aid-batch/identity-batch.mjs +143 -0
  194. package/dist/ability/versions.js +0 -32
  195. package/dist/aun/model-headers.js +0 -17
  196. package/dist/channels/builtin-plugins.js +0 -19
  197. package/dist/core/command/team-workspace-initializer.js +0 -2
  198. package/dist/core/command/team-workspace-job-store.js +0 -88
  199. package/dist/core/command/team-workspace-management-service.js +0 -2
  200. package/dist/core/contact-bind-registry.js +0 -27
  201. package/dist/event-center/ledger.js +0 -52
  202. package/dist/services/reply.js +0 -55
  203. package/kits/templates/message-fragments/item.md +0 -3
  204. package/scripts/agent-template/pack.mjs +0 -169
@@ -10,15 +10,31 @@ export const IDEMPOTENCY_WINDOW_MS = 24 * 60 * 60 * 1000;
10
10
  function key(from, requestId) {
11
11
  return `${from}\u0000${requestId}`;
12
12
  }
13
+ /** `YYYY-MM`(本地时区,与 `logs/messages-YYYYMMDD.jsonl` 的日期口径一致)。 */
14
+ function monthKey(ts) {
15
+ const date = new Date(ts);
16
+ return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}`;
17
+ }
13
18
  export class IdempotencyStore {
14
19
  filePath;
15
20
  records = new Map();
21
+ /**
22
+ * 正在执行中的 (from, requestId) → 完成信号。
23
+ *
24
+ * 只靠 records 挡不住并发:同一 request_id 的两条消息各带不同 message_id,
25
+ * `claimInboundMessage` 拦不住,两个请求都会 lookup miss 然后各跑一遍脚本。
26
+ * 这个表在 lookup 之后、执行之前占位,执行完再释放。
27
+ */
28
+ inFlight = new Map();
29
+ /** 同上,键 → 完成信号触发器。与 `inFlight` 同生命周期。 */
30
+ releasers = new Map();
16
31
  loadedMtimeMs = -1;
17
32
  constructor(filePath) {
18
33
  this.filePath = filePath;
19
34
  }
20
35
  /** 按文件 mtime 懒加载;文件被外部改动时重读。 */
21
36
  ensureLoaded(now = Date.now()) {
37
+ this.rotateIfMonthChanged(now);
22
38
  let mtimeMs = 0;
23
39
  try {
24
40
  mtimeMs = fs.statSync(this.filePath).mtimeMs;
@@ -61,6 +77,90 @@ export class IdempotencyStore {
61
77
  this.records.delete(entryKey);
62
78
  }
63
79
  }
80
+ /**
81
+ * 跨月就把当前文件滚进 `logs/idempotency-<YYYY-MM>.jsonl`。
82
+ *
83
+ * 为什么按自然月而不是按大小:去重窗口只有 24 小时,上个月的记录在本月启动时
84
+ * 已经完全没用,留着只是让文件无限长。按月切既保住了"能翻回去查"的审计价值,
85
+ * 又给文件大小设了自然上界。归档目标与 `removePack` 的日志归档同在 `logs/` 下。
86
+ *
87
+ * 懒触发(每次 `ensureLoaded` 顺手看一眼 mtime),不引定时器:进程可能长期空闲,
88
+ * 定时器只会空转。
89
+ */
90
+ rotateIfMonthChanged(now = Date.now()) {
91
+ if (!fs.existsSync(this.filePath))
92
+ return; // 没什么可滚的。
93
+ // 判据是**最新一条记录的时间**,不是文件 mtime:mtime 表示"最后一次写入",
94
+ // 一次补写或外部拷贝都会把它拉到别的月份,那时按它切会把还在窗口内的记录误归档。
95
+ this.ensureLoadedFresh(now);
96
+ if (this.records.size === 0)
97
+ return;
98
+ const newest = Math.max(...[...this.records.values()].map(record => record.ts));
99
+ if (monthKey(newest) === monthKey(now))
100
+ return;
101
+ const archiveDir = path.join(path.dirname(this.filePath), 'logs');
102
+ const archivePath = path.join(archiveDir, `idempotency-${monthKey(newest)}.jsonl`);
103
+ let carried = [];
104
+ try {
105
+ // 先把"仍在 24h 窗口内"的记录挑出来。跨月那一刻它们可能只有几分钟岁数,
106
+ // 直接搬走会让这些请求重放时找不到缓存、再跑一遍脚本。
107
+ this.ensureLoadedFresh(now);
108
+ carried = [...this.records.values()].filter(record => record.ts >= now - IDEMPOTENCY_WINDOW_MS);
109
+ fs.mkdirSync(archiveDir, { recursive: true });
110
+ // 目标已存在(外部拷贝可能造成)就跟在后面追加,不覆盖——覆盖等于丢掉已归档的历史。
111
+ if (fs.existsSync(archivePath)) {
112
+ fs.appendFileSync(archivePath, fs.readFileSync(this.filePath, 'utf8'), 'utf8');
113
+ fs.rmSync(this.filePath, { force: true });
114
+ }
115
+ else {
116
+ fs.renameSync(this.filePath, archivePath);
117
+ }
118
+ // 仍有效的记录写回新文件:归档要归档,但去重语义不能因为跨月断掉。
119
+ fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
120
+ const text = carried.map(record => `${JSON.stringify(record)}\n`).join('');
121
+ if (text)
122
+ fs.writeFileSync(this.filePath, text, 'utf8');
123
+ this.records.clear();
124
+ for (const record of carried)
125
+ this.records.set(key(record.from, record.requestId), record);
126
+ this.loadedMtimeMs = text ? fs.statSync(this.filePath).mtimeMs : 0;
127
+ }
128
+ catch {
129
+ // 滚动失败不影响去重:继续用当前文件,下次再试。
130
+ }
131
+ }
132
+ /**
133
+ * 直接重读文件、不触发滚动(滚动过程中要用,否则递归)。
134
+ *
135
+ * 只在跨月那一刻调用一次,不必在意"mtime 没变就跳过"的优化。
136
+ */
137
+ ensureLoadedFresh(now) {
138
+ this.records.clear();
139
+ try {
140
+ for (const line of fs.readFileSync(this.filePath, 'utf8').split('\n')) {
141
+ if (!line)
142
+ continue;
143
+ try {
144
+ const record = JSON.parse(line);
145
+ if (typeof record.from === 'string' && typeof record.requestId === 'string'
146
+ && Number.isFinite(record.ts) && record.result && typeof record.result === 'object') {
147
+ this.records.set(key(record.from, record.requestId), record);
148
+ }
149
+ }
150
+ catch {
151
+ // 跳过坏行
152
+ }
153
+ }
154
+ }
155
+ catch {
156
+ // 读失败按空表处理。
157
+ }
158
+ this.loadedMtimeMs = now;
159
+ }
160
+ /** 幂等文件的月度归档路径(CLI / 排查用)。 */
161
+ static archivePathFor(filePath, month) {
162
+ return path.join(path.dirname(filePath), 'logs', `idempotency-${month}.jsonl`);
163
+ }
64
164
  /** 命中的上次结果;未命中返回 undefined。 */
65
165
  lookup(from, requestId, now = Date.now()) {
66
166
  this.ensureLoaded(now);
@@ -73,6 +173,34 @@ export class IdempotencyStore {
73
173
  }
74
174
  return record;
75
175
  }
176
+ /**
177
+ * 占住一个 (from, requestId)。返回 `null` 表示占位成功;否则返回「同键那次执行
178
+ * 结束」的 Promise,调用方应等它完成后重新 lookup。
179
+ *
180
+ * 不直接回错误:正常重试与并发重投是一回事,第一次跑完后缓存里就有结果了,
181
+ * 让后来者等一会儿拿到同样的应答,比给它一个错误码更接近调用方的预期。
182
+ *
183
+ * 占位成功后必须调 `release`(放在 finally 里)——否则一次脚本异常会让这个
184
+ * request_id 在进程生命周期内永久不可再执行。
185
+ */
186
+ reserve(from, requestId) {
187
+ const entryKey = key(from, requestId);
188
+ const existing = this.inFlight.get(entryKey);
189
+ if (existing)
190
+ return existing;
191
+ let resolve = () => { };
192
+ const done = new Promise(result => { resolve = result; });
193
+ this.inFlight.set(entryKey, done);
194
+ this.releasers.set(entryKey, resolve);
195
+ return null;
196
+ }
197
+ release(from, requestId) {
198
+ const entryKey = key(from, requestId);
199
+ this.inFlight.delete(entryKey);
200
+ const resolve = this.releasers.get(entryKey);
201
+ this.releasers.delete(entryKey);
202
+ resolve?.();
203
+ }
76
204
  /** 记录一次成功执行的结果。IO 失败吞掉:去重是优化,不是正确性前提。 */
77
205
  record(from, requestId, result, now = Date.now()) {
78
206
  this.ensureLoaded(now);
@@ -4,8 +4,9 @@
4
4
  * `requires` 判定与 ECK 的 hasServicePacks 都读它。名片变更频率极低,
5
5
  * 由调用方在加载时算一次并缓存,热重载(ec aid agentmd set)时失效。
6
6
  *
7
- * 优先读本地 `AIDs/<aid>/agent.md`(daemon 启动即可用,不依赖 AUN 连接);
8
- * 本地缺失时再走 AIDStore.resolve(网络路径)。
7
+ * 只读本地 `AIDs/<aid>/agent.md`:daemon 启动即可用,不依赖 AUN 连接。
8
+ * 不提供走网络的兜底——本机名片读不到时按 `agent` / 空 exttype 处理
9
+ * (fail-closed:只有 `requires` 含 `agent` 或 `*` 的包才会激活)。
9
10
  */
10
11
  import fs from 'node:fs';
11
12
  import { agentMdPath } from '../paths.js';
@@ -25,28 +26,3 @@ export function readLocalSelfIdentity(aid) {
25
26
  return undefined;
26
27
  }
27
28
  }
28
- /**
29
- * 读本机名片的 type / exttype。
30
- * `AIDStore.resolve` → `ResolveResult.agent_md.frontmatter`;`client.getType()` 只读 type。
31
- * 本地读不到时才走网络。两处都读不到时按 `agent` / 空 exttype 处理(fail-closed:
32
- * 只有 `requires` 含 `agent` 或 `*` 的包才会激活)。
33
- */
34
- export async function resolveSelfIdentity(store, aid) {
35
- const local = readLocalSelfIdentity(aid);
36
- if (local)
37
- return local;
38
- if (!store)
39
- return { aid, type: 'agent', exttype: '' };
40
- try {
41
- const result = await store.resolve(aid);
42
- const frontmatter = result.ok ? result.data.agent_md?.frontmatter : undefined;
43
- return identityFromFrontmatter(aid, frontmatter);
44
- }
45
- catch {
46
- return { aid, type: 'agent', exttype: '' };
47
- }
48
- }
49
- /** services 模式:本机名片 type 精确等于 services。 */
50
- export function isServicesIdentity(identity) {
51
- return identity.type === 'services';
52
- }
@@ -36,8 +36,12 @@ export function writeServicesIndex(servicesDir, selfAid, activePacks) {
36
36
  lines.push(` ec services describe <本AID> 查看完整参数与示例`);
37
37
  lines.push(` ec services call <本AID> <type> --data '<json>'`);
38
38
  lines.push('');
39
+ // 分档写出:各档权限不同,混成一行会让模型以为 enable 和 status 一样随手可调,
40
+ // 试一次被拒才发现(详见 $KITS_DOCS/evolcore/services.md §十)。
39
41
  lines.push('本机管理:');
40
- lines.push(' ec services status / doctor / ledger / tail / reload');
42
+ lines.push(' 只读(member 及以上): status / types / ledger / tail / doctor / reload / pack list / rules show');
43
+ lines.push(' owner|admin: pack add|remove|enable|disable, rules add|remove');
44
+ lines.push(' 总闸 daemonOwner+fullaccess: enable / disable');
41
45
  lines.push('');
42
46
  lines.push('可用服务(type 即对端应发送的 payload.type):');
43
47
  for (const pack of activePacks) {
@@ -4,7 +4,6 @@
4
4
  * 本模块不碰 AUN 传输:它只返回 ServiceReply,由 channels/aun.ts 负责发出。
5
5
  * 应答(*.result)完全不经过这里——那是 AunRequestRegistry 的事,在消息层更早分支。
6
6
  */
7
- import fs from 'node:fs';
8
7
  import path from 'node:path';
9
8
  import { logger } from '../utils/logger.js';
10
9
  import { matchFilter } from '../trigger/event-source.js';
@@ -12,19 +11,38 @@ import { ServiceDispatcher } from './dispatcher.js';
12
11
  import { IdempotencyStore } from './idempotency.js';
13
12
  import { readLocalSelfIdentity } from './identity.js';
14
13
  import { writeServicesIndex } from './index-generator.js';
15
- import { packLedger, routerLedger, ServiceLedger } from './ledger.js';
14
+ import { servicePackLedger as packLedger, routerLedger, ServiceLedger } from '../core/pack-ledger.js';
16
15
  import { ServiceMessageLog } from './message-log.js';
17
16
  import { buildPackState, loadPackDir, loadPacks } from './pack-manager.js';
18
- import { buildErrorReply, buildSilentReply, buildSuccessReply, replyFromOutcome } from './reply.js';
19
17
  import { DEFAULT_ROUTER_CONFIG, loadRouterConfig, RateLimiter } from './router.js';
18
+ import { RateWindow } from '../core/rate-window.js';
20
19
  import { ServiceScriptRunner } from './script-runner.js';
21
- import { isReservedServiceType, matchesListen, RESERVED_TYPES } from './service-payload.js';
20
+ import { buildErrorReply, buildSilentReply, buildSuccessReply, replyFromOutcome, isReservedServiceType, matchesListen, RESERVED_TYPES, } from './service-payload.js';
22
21
  import { errorMessage } from './types.js';
23
22
  export { classifyServicePayloadType, parseServiceType, isReservedServiceType, RESERVED_TYPES } from './service-payload.js';
24
- export { resolveSelfIdentity, readLocalSelfIdentity, isServicesIdentity } from './identity.js';
23
+ export { readLocalSelfIdentity } from './identity.js';
24
+ /**
25
+ * 未准入调用的回复预算。
26
+ *
27
+ * 不开放成 services-config.json 的配置项:按来源 AID 计数换个 AID 就清零,
28
+ * 必须有一个全局上限兜底,否则"来一条回一条"就是天然的放大面。
29
+ */
30
+ const UNAUTHORIZED_GLOBAL_QUOTA = { perMinute: 30, perHour: 200 };
31
+ /** 同一个来源只提醒一次「未准入」的窗口;窗口内再调一律静默。 */
32
+ const UNAUTHORIZED_NOTICE_TTL_MS = 24 * 60 * 60 * 1000;
33
+ /** 提醒记录上限;超出按插入顺序淘汰最早的,避免被大量陌生 AID 撑爆内存。 */
34
+ const UNAUTHORIZED_NOTICE_MAX = 10_000;
35
+ /**
36
+ * 未准入时 services.list / describe(不带 service)能看到的清单。
37
+ *
38
+ * 只留 `services.ping`:对方能确认"这是一台 EvolCore 服务节点、且可达",
39
+ * 但拿不到包名、服务 type、reply 策略这些内部结构。
40
+ */
41
+ const UNAUTHORIZED_MINIMAL_BUILTIN = ['services.ping'];
25
42
  export class ServiceRouter {
26
43
  servicesDir;
27
44
  deps;
45
+ readonlySnapshot;
28
46
  config = DEFAULT_ROUTER_CONFIG;
29
47
  packs;
30
48
  identity;
@@ -33,10 +51,23 @@ export class ServiceRouter {
33
51
  dispatcher;
34
52
  scriptRunner;
35
53
  idempotency = new Map();
54
+ /** 未准入回复的全局桶:所有来源共用,绕不过按 AID 的独立计数。 */
55
+ unauthorizedWindow = new RateWindow();
56
+ /** fromAid → 上次告知未准入的时间;窗口内重复调用静默。 */
57
+ unauthorizedNotified = new Map();
36
58
  started = false;
37
- constructor(servicesDir, deps, limits) {
59
+ constructor(servicesDir, deps, limits,
60
+ /**
61
+ * 只读快照模式:不写索引、不写台账。
62
+ *
63
+ * `ec services status` 这类纯查询在 daemon 没实例时会现场建一个 offline router,
64
+ * 走完整 `ensureStarted()` ——那会把 `.index.md` 重写一遍、给每个包追加一条
65
+ * `pack.load`。查一次刷一次,台账很快就没法看了。
66
+ */
67
+ readonlySnapshot = false) {
38
68
  this.servicesDir = servicesDir;
39
69
  this.deps = deps;
70
+ this.readonlySnapshot = readonlySnapshot;
40
71
  this.identity = { aid: deps.aid, type: 'agent', exttype: '' };
41
72
  this.packs = buildPackState([], [], this.identity);
42
73
  this.scriptRunner = new ServiceScriptRunner(deps);
@@ -56,10 +87,18 @@ export class ServiceRouter {
56
87
  this.config = router.config;
57
88
  this.routerErrors = router.errors;
58
89
  this.limiter.setConfig(router.config);
90
+ // 顺带清理过期窗口:reload 是低频动作,够用了,不值得为此单开一个定时器。
91
+ this.limiter.prune();
92
+ this.unauthorizedWindow.prune();
59
93
  const loaded = loadPacks(this.servicesDir);
60
- this.packs = buildPackState(loaded.valid, loaded.invalid.map(item => ({ id: item.packId, errors: item.errors })), this.identity, this.packs.revision);
94
+ this.packs = buildPackState(loaded.valid, loaded.invalid.map(item => ({ id: item.packId, errors: item.errors })), this.identity);
61
95
  // 索引与包集合同步重建;空集删除,交给 manifest 的 optional 判缺失。
62
- writeServicesIndex(this.servicesDir, this.identity.aid, this.packs.activePacks);
96
+ // 只读快照不写:查询命令不该改变磁盘状态。
97
+ if (!this.readonlySnapshot) {
98
+ writeServicesIndex(this.servicesDir, this.identity.aid, this.packs.activePacks);
99
+ }
100
+ if (this.readonlySnapshot)
101
+ return this.snapshot();
63
102
  if (router.exists) {
64
103
  const ledger = routerLedger(this.servicesDir);
65
104
  ledger.append({ action: 'router.load', result: router.errors.length ? 'failed' : 'ok', ...(router.errors.length ? { reason: router.errors.join('; ') } : {}) });
@@ -71,15 +110,27 @@ export class ServiceRouter {
71
110
  const packDir = path.join(this.servicesDir, item.id);
72
111
  new ServiceLedger(path.join(packDir, 'ledger.jsonl')).append({ action: 'pack.skipped', packId: item.id, reason: item.reason });
73
112
  }
113
+ // `enabled: false` 是合法状态:包不加载、目录与日志保留。写一条台账,
114
+ // 否则"这个包为什么没生效"只能靠猜——`pack.disabled` 这个 action 一直没人写。
115
+ for (const pack of this.packs.disabledPacks) {
116
+ const ledger = new ServiceLedger(path.join(this.servicesDir, pack, 'ledger.jsonl'));
117
+ ledger.append({ action: 'pack.disabled', result: 'ok', packId: pack });
118
+ }
74
119
  for (const item of this.packs.invalidPacks) {
75
120
  const ledger = new ServiceLedger(path.join(this.servicesDir, item.id, 'ledger.jsonl'));
76
121
  ledger.append({ action: 'pack.invalid', result: 'failed', packId: item.id, reason: item.errors.join('; ') });
77
122
  }
78
123
  return this.snapshot();
79
124
  }
80
- /** ECK 的 hasServicePacks:是否有已激活(requires 通过)的包。读内存状态,不扫目录。 */
125
+ /**
126
+ * ECK 的 hasServicePacks:是否有已激活(requires 通过)的包。读内存状态,不扫目录。
127
+ *
128
+ * 必须同时看总闸:`services-config.json` 的 `enabled=false` 时所有 `services.*`
129
+ * 入站请求被丢弃,包文件还在但一个都接不到。只看 activePacks 会让 prompt 里留着
130
+ * `[services]` 段,模型照着自己列出的能力回答,实际无法服务。
131
+ */
81
132
  hasActivePacks() {
82
- return this.packs.activePacks.length > 0;
133
+ return this.config.enabled && this.packs.activePacks.length > 0;
83
134
  }
84
135
  snapshot() {
85
136
  return { enabled: this.config.enabled, config: this.config, packs: this.packs, identity: this.identity, routerErrors: this.routerErrors };
@@ -91,14 +142,18 @@ export class ServiceRouter {
91
142
  consumeBuiltinQuota(fromAid) {
92
143
  return this.limiter.consume('builtin', fromAid);
93
144
  }
94
- /** 单包热加载(ec services reload <name>)。 */
145
+ /**
146
+ * 先校验单个包、再全量重载。
147
+ *
148
+ * **不是单包热加载**:跨包 type 冲突必须整集合重算,所以最终还是 `reload()`。
149
+ * 这个方法的唯一价值是"包本身坏了就先报错,不用等全量重扫"。
150
+ */
95
151
  reloadPack(packId) {
96
152
  const packDir = path.join(this.servicesDir, packId);
97
153
  const errors = [];
98
154
  const pack = loadPackDir(packDir, errors);
99
155
  if (!pack)
100
156
  return { ok: false, errors };
101
- // 全量重建:跨包冲突必须重算。
102
157
  this.reload();
103
158
  return { ok: true, errors: [] };
104
159
  }
@@ -109,6 +164,23 @@ export class ServiceRouter {
109
164
  return undefined;
110
165
  return { dir: pack.dir, logs: pack.paths.logsDir, ledger: pack.paths.ledger };
111
166
  }
167
+ /**
168
+ * 查该 type 的调用准入规则。
169
+ *
170
+ * 精确 type 优先;否则取第一条通配(与 `resolvePack` 同口径,避免"路由到 A 包
171
+ * 却按 B 包的规则判")。通配只吃一整段,`services.order.*` 不匹配 `services.order`.
172
+ */
173
+ callRuleFor(type) {
174
+ const rules = this.config.rules ?? {};
175
+ const exact = rules[type];
176
+ if (exact)
177
+ return exact;
178
+ for (const [pattern, rule] of Object.entries(rules)) {
179
+ if (pattern.endsWith('.*') && matchesListen(pattern, type))
180
+ return rule;
181
+ }
182
+ return undefined;
183
+ }
112
184
  idempotencyFor(pack) {
113
185
  let store = this.idempotency.get(pack.id);
114
186
  if (!store) {
@@ -127,10 +199,35 @@ export class ServiceRouter {
127
199
  logger.debug(`[Services] router disabled; dropped ${type} mid=${message.messageId}`);
128
200
  return buildSilentReply(type, message.requestId);
129
201
  }
130
- // 保留字:整条 type 精确相等才算,两段形式。
202
+ // 拉黑对任何 type 都静默:连「这台节点活着」都不回。
203
+ if (options.admission === 'blocked') {
204
+ this.rejectLedger('BLOCKED', type, message);
205
+ return buildSilentReply(type, message.requestId);
206
+ }
207
+ // 保留字:整条 type 精确相等才算,两段形式。内置查询已在内部按准入分级。
131
208
  if (isReservedServiceType(type)) {
132
209
  return this.handleBuiltin(type, message, options);
133
210
  }
211
+ // rules:按服务 type 的调用准入。基础集合是联系人快照(由消息层算好传进来),
212
+ // `allow` 在其上额外放行,`deny` 命中即拒且优先于 allow。
213
+ //
214
+ // 只覆盖"能不能调",不放开别的:deny 走的是与 not_authorized 完全相同的
215
+ // 回复路径,避免"被 deny"与"未曝光"两种结果可区分——那会变成探测信道。
216
+ const rule = this.callRuleFor(type);
217
+ const denied = rule?.deny.includes(message.fromAid) === true;
218
+ const ruleAllowed = !denied && rule?.allow.includes(message.fromAid) === true;
219
+ // 准入必须先于包匹配。
220
+ //
221
+ // 先匹配再判准入会造出一条枚举信道:命中包回 NOT_AUTHORIZED、没命中回静默,
222
+ // 陌生人只要看有没有回包,就能把本机的服务 type 一个个试出来。所以未准入时
223
+ // 不管 type 存不存在,走的都是同一个分支、同一个回包。
224
+ //
225
+ // 顺序也决定了开销:准入在 resolvePack 之前,未准入的调用不会触达包、更不会
226
+ // 进 dispatcher 起沙箱。
227
+ // allow 白名单可以放行联系人之外的人;blocked 已在上面回掉,拉黑优先。
228
+ if (!ruleAllowed && (denied || options.admission === 'not_authorized')) {
229
+ return this.unauthorizedReply(type, message, 'business');
230
+ }
134
231
  const match = this.resolvePack(type);
135
232
  if (!match)
136
233
  return this.handleUnmatched(type, message);
@@ -142,18 +239,72 @@ export class ServiceRouter {
142
239
  packLedger(pack).append({ action: 'service.duplicate', packId: pack.id, type, from: message.fromAid, requestId: message.requestId });
143
240
  return { type: String(cached.result.type ?? `${type}.result`), requestId: message.requestId, shouldSend: true, payload: cached.result };
144
241
  }
145
- if (options.admission === 'blocked') {
146
- ServiceMessageLog.forPack(pack).writeDropped(message, 'blocked');
147
- packLedger(pack).append({ action: 'service.rejected', packId: pack.id, type, from: message.fromAid, requestId: message.requestId, code: 'BLOCKED' });
242
+ // 并发到达的同 request_id:等前一次跑完,再按正常路径重新 lookup 拿它的结果。
243
+ // 不直接拒:正常重试与并发重投是同一回事,第一次跑完后缓存里就有应答了。
244
+ // 最多让出两次(前一次结束、可能被第三个请求抢先),之后才明确报在途。
245
+ let slot = store.reserve(message.fromAid, message.requestId);
246
+ for (let attempt = 0; slot && attempt < 2; attempt++) {
247
+ await slot;
248
+ const afterWait = store.lookup(message.fromAid, message.requestId);
249
+ if (afterWait) {
250
+ packLedger(pack).append({ action: 'service.duplicate', packId: pack.id, type, from: message.fromAid, requestId: message.requestId, reason: 'in_flight' });
251
+ return { type: String(afterWait.result.type ?? `${type}.result`), requestId: message.requestId, shouldSend: true, payload: afterWait.result };
252
+ }
253
+ slot = store.reserve(message.fromAid, message.requestId);
254
+ }
255
+ if (slot) {
256
+ packLedger(pack).append({ action: 'service.duplicate', packId: pack.id, type, from: message.fromAid, requestId: message.requestId, reason: 'in_flight' });
257
+ return buildErrorReply(type, message.requestId, 'REQUEST_IN_FLIGHT', 'the same request_id is still being processed');
258
+ }
259
+ try {
260
+ return await this.executeMatched(pack, handler, type, message, store);
261
+ }
262
+ finally {
263
+ store.release(message.fromAid, message.requestId);
264
+ }
265
+ }
266
+ /** 拒绝留痕走 router 台账:未准入时还不知道(也不该去查)是哪个包。 */
267
+ rejectLedger(code, type, message) {
268
+ routerLedger(this.servicesDir).append({
269
+ action: 'service.rejected', code, type, from: message.fromAid, requestId: message.requestId,
270
+ });
271
+ }
272
+ /**
273
+ * 未准入的统一回包:24 小时内只提醒一次,之后静默。
274
+ *
275
+ * 为什么还要回这一次:对端第一次调用时需要知道「不是超时、也不是格式错,是被拒了」,
276
+ * 否则只能干等 30 秒。回包必须与请求内容无关——不带 owner AID、不带 request_contact、
277
+ * 不带包名/type/路径,也不区分自己是否存在,否则这次"善意提醒"就成了探测手段。
278
+ */
279
+ unauthorizedReply(type, message, bucket) {
280
+ const now = Date.now();
281
+ const last = this.unauthorizedNotified.get(message.fromAid);
282
+ if (last !== undefined && now - last < UNAUTHORIZED_NOTICE_TTL_MS) {
148
283
  return buildSilentReply(type, message.requestId);
149
284
  }
150
- if (options.admission === 'not_authorized') {
151
- ServiceMessageLog.forPack(pack).writeDropped(message, 'not_authorized');
152
- packLedger(pack).append({ action: 'service.rejected', packId: pack.id, type, from: message.fromAid, requestId: message.requestId, code: 'NOT_AUTHORIZED' });
153
- return buildErrorReply(type, message.requestId, 'NOT_AUTHORIZED', 'service call is not authorized', {
154
- ...(options.requestContact ? { request_contact: options.requestContact } : {}),
155
- });
285
+ // 全局桶兜底:换 AID 也放不大回复量;超了就直接静默,连"被拒"都不说。
286
+ if (!this.unauthorizedWindow.consume('unauthorized\u0000global', UNAUTHORIZED_GLOBAL_QUOTA, now).allow) {
287
+ return buildSilentReply(type, message.requestId);
288
+ }
289
+ this.rememberUnauthorized(message.fromAid, now);
290
+ this.rejectLedger('NOT_AUTHORIZED', type, message);
291
+ logger.debug(`[Services] unauthorized ${bucket} call from ${message.fromAid} type=${type} mid=${message.messageId}`);
292
+ return buildErrorReply(type, message.requestId, 'NOT_AUTHORIZED', 'service call is not authorized');
293
+ }
294
+ rememberUnauthorized(fromAid, now) {
295
+ if (this.unauthorizedNotified.size >= UNAUTHORIZED_NOTICE_MAX) {
296
+ const oldest = this.unauthorizedNotified.keys().next().value;
297
+ if (oldest !== undefined)
298
+ this.unauthorizedNotified.delete(oldest);
156
299
  }
300
+ this.unauthorizedNotified.set(fromAid, now);
301
+ }
302
+ /** 未准入可见的最小清单:能判断这是服务节点,拿不到内部结构。 */
303
+ minimalListing() {
304
+ return { services: [], builtin: [...UNAUTHORIZED_MINIMAL_BUILTIN] };
305
+ }
306
+ /** 已通过准入与幂等检查之后的主路径。拆出来只是为了给 reserve/release 留一个 finally。 */
307
+ async executeMatched(pack, handler, type, message, store) {
157
308
  const limit = this.limiter.consume('service', message.fromAid);
158
309
  if (!limit.allow) {
159
310
  packLedger(pack).append({ action: 'service.rejected', packId: pack.id, type, from: message.fromAid, requestId: message.requestId, code: 'RATE_LIMITED' });
@@ -170,15 +321,34 @@ export class ServiceRouter {
170
321
  }
171
322
  packLedger(pack).append({ action: 'service.invoked', packId: pack.id, type, from: message.fromAid, requestId: message.requestId });
172
323
  const outcome = await this.dispatcher.run(pack, handler.handler, message);
173
- log.writeHandled(message, {
174
- cmd: handler.handler.script,
175
- exit: outcome.exitCode,
176
- ms: outcome.durationMs,
177
- outcome: outcome.outcome,
178
- ...(outcome.error ? { reason: `${outcome.error.code}: ${outcome.error.message}`.slice(0, 240) } : {}),
179
- // 无沙箱执行必须留痕:事后排查「这个脚本为什么能读到不该读的东西」靠它。
180
- ...(outcome.sandboxAbsent ? { sandboxAbsent: outcome.sandboxAbsent } : {}),
181
- });
324
+ // 没跑起来 ≠ 脚本失败:`QUEUE_FULL` / `DISPATCHER_CLOSED` 是调度层拒收,脚本一秒都没执行。
325
+ // 混进 `handled` 会让"这个服务为什么老是 error"指向错误的方向。
326
+ const notRun = outcome.error?.code === 'QUEUE_FULL' || outcome.error?.code === 'DISPATCHER_CLOSED';
327
+ if (notRun) {
328
+ log.writeDropped(message, outcome.error.code.toLowerCase());
329
+ packLedger(pack).append({
330
+ action: 'service.rejected', packId: pack.id, type, from: message.fromAid,
331
+ requestId: message.requestId, code: outcome.error.code,
332
+ });
333
+ }
334
+ else {
335
+ log.writeHandled(message, {
336
+ cmd: outcome.cmd ?? handler.handler.script,
337
+ exit: outcome.exitCode,
338
+ ms: outcome.durationMs,
339
+ outcome: outcome.outcome,
340
+ ...(outcome.error ? { reason: `${outcome.error.code}: ${outcome.error.message}`.slice(0, 240) } : {}),
341
+ // 无沙箱执行必须留痕:事后排查「这个脚本为什么能读到不该读的东西」靠它。
342
+ ...(outcome.sandboxAbsent ? { sandboxAbsent: outcome.sandboxAbsent } : {}),
343
+ });
344
+ }
345
+ if (outcome.sandboxAbsent) {
346
+ // 日志按天轮转、只留近期;台账才是长期答案。
347
+ packLedger(pack).append({
348
+ action: 'script.unsandboxed', packId: pack.id, type, from: message.fromAid,
349
+ requestId: message.requestId, reason: outcome.sandboxAbsent,
350
+ });
351
+ }
182
352
  if (outcome.outcome === 'error' || outcome.outcome === 'timeout') {
183
353
  logger.warn(`[Services] ${pack.id} handler for ${type} ${outcome.outcome}: ${outcome.error?.code ?? ''} ${outcome.error?.message ?? ''}`);
184
354
  }
@@ -195,19 +365,44 @@ export class ServiceRouter {
195
365
  return buildSilentReply(type, message.requestId);
196
366
  return reply;
197
367
  }
198
- /** 内置查询服务:豁免准入(blocked 仍拒),受限流。 */
368
+ /**
369
+ * 内置查询服务:按准入分级,不搞"一律豁免"。
370
+ *
371
+ * 分级标准是**返回体里有没有我方内部结构**:
372
+ * - `ping` 只有 ok/ts/version,零信息,任何来源都答(否则对端连可达性都判断不了);
373
+ * - `list` / `describe`(不带 service)是"这是不是服务节点"的探针,未准入降级成
374
+ * 只含 `services.ping` 的空壳,不暴露包名、type、reply 策略;
375
+ * - `describe` / `schema` / `skill`(带 service)会带出 pack、脚本路径、timeout,
376
+ * 未准入一律走统一拒绝,与业务调用的回包完全一致,不构成"这个 type 存不存在"的信道。
377
+ */
199
378
  handleBuiltin(type, message, options) {
379
+ // handleRequest 已在更外层挡掉 blocked;这里再挡一次是给直调本方法的测试兜底。
200
380
  if (options.admission === 'blocked')
201
381
  return buildSilentReply(type, message.requestId);
382
+ const allowed = options.admission !== 'not_authorized';
202
383
  const limit = this.limiter.consume('builtin', message.fromAid);
203
384
  if (!limit.allow) {
385
+ // 未准入时不能回 RATE_LIMITED:那也是一条信息,而且是回复放大器。
386
+ if (!allowed)
387
+ return buildSilentReply(type, message.requestId);
204
388
  return buildErrorReply(type, message.requestId, 'RATE_LIMITED', '请求过于频繁,请稍后重试', {
205
389
  ...(limit.retryAfter !== undefined ? { retry_after: limit.retryAfter } : {}),
206
390
  });
207
391
  }
392
+ if (type === 'services.ping') {
393
+ return buildSuccessReply(type, message.requestId, { ok: true, ts: Date.now(), version: '1' });
394
+ }
395
+ if (!allowed) {
396
+ if (type === 'services.list') {
397
+ return buildSuccessReply(type, message.requestId, this.minimalListing());
398
+ }
399
+ if (type === 'services.describe' && !readStringField(message.payload, 'service')) {
400
+ // 不带 service 时退化为清单:与 `ec services describe <aid>` 的语义一致。
401
+ return buildSuccessReply(type, message.requestId, this.minimalListing());
402
+ }
403
+ return this.unauthorizedReply(type, message, 'builtin');
404
+ }
208
405
  switch (type) {
209
- case 'services.ping':
210
- return buildSuccessReply(type, message.requestId, { ok: true, ts: Date.now(), version: '1' });
211
406
  case 'services.list':
212
407
  return buildSuccessReply(type, message.requestId, {
213
408
  services: this.describeAll(),
@@ -336,7 +531,12 @@ export class ServiceRouter {
336
531
  }
337
532
  return undefined;
338
533
  }
339
- /** 关闭:停止接收新任务。 */
534
+ /**
535
+ * 释放运行时资源。**只关调度器**:本类不持有 watcher、定时器或账本句柄
536
+ * (包目录没有 watcher,账本是每次 append 时现开现关),所以没有别的要拆的东西。
537
+ * 在途子进程不在这里杀——`dispatcher.close()` 只拒收新任务,已经在跑的那个
538
+ * 跑完为止,由调用方决定要不要等。
539
+ */
340
540
  close() {
341
541
  this.dispatcher.close();
342
542
  }
@@ -413,6 +613,12 @@ export function getServiceRouter(aid, servicesDir, deps) {
413
613
  }
414
614
  return router;
415
615
  }
616
+ /**
617
+ * 从单例表摘除并关闭实例(channel 拆卸时调用,见 `AunChannel.disconnect()`)。
618
+ * 未建过实例或已摘除时直接 return——调用方不必先判存在。
619
+ * 摘除后旧对象的 `started` 不会复位,所以**不要复用被释放的实例**;
620
+ * 需要时重新 `getServiceRouter()` 会拿到全新对象、`started=false`、重扫全部包。
621
+ */
416
622
  export function releaseServiceRouter(aid) {
417
623
  const router = routers.get(aid);
418
624
  if (!router)
@@ -433,17 +639,10 @@ export function listServiceRouterAids() {
433
639
  * 用于 daemon 未运行时的 `ec services status/doctor`,以及 daemon 侧 `--aid` 不在活跃表时的兜底。
434
640
  */
435
641
  export function createOfflineServiceRouter(aid, servicesDir, deps) {
436
- const router = new ServiceRouter(servicesDir, deps);
642
+ // 只读快照:`ec services status` / `doctor` 在 daemon 无实例时走这里。查询不该
643
+ // 写索引、也不该给每个包追加 `pack.load`。
644
+ const router = new ServiceRouter(servicesDir, deps, undefined, true);
437
645
  router.ensureStarted(readLocalSelfIdentity(aid) ?? { aid, type: 'agent', exttype: '' });
438
646
  return router;
439
647
  }
440
- /** services/ 目录是否存在(总闸之外的第二层:目录都没有就没必要扫)。 */
441
- export function servicesDirExists(servicesDir) {
442
- try {
443
- return fs.statSync(servicesDir).isDirectory();
444
- }
445
- catch {
446
- return false;
447
- }
448
- }
449
648
  export { errorMessage };