evolcore 0.0.43-test.5 → 0.0.43-test.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +95 -0
- package/bin/ecmsg.js +281 -81
- package/dist/agents/baseagent-availability.js +20 -5
- package/dist/agents/baseagent.js +2 -2
- package/dist/agents/claude-runner.js +19 -4
- package/dist/agents/codex/app-server-client.js +36 -3
- package/dist/agents/codex-runner.js +75 -8
- package/dist/aun/group/invite-service.js +3 -2
- package/dist/aun/msg/p2p.js +6 -1
- package/dist/aun/service-proxy.js +18 -6
- package/dist/channels/aun.js +306 -30
- package/dist/cli/agent-create.js +18 -8
- package/dist/cli/aun-commands.js +9 -1
- package/dist/cli/daemon-commands.js +34 -65
- package/dist/cli/daemon-lifecycle-client.js +61 -0
- package/dist/cli/ecmsg-gateway.js +38 -3
- package/dist/cli/events-command.js +73 -0
- package/dist/cli/index.js +31 -14
- package/dist/cli/init.js +75 -0
- package/dist/cli/invoke-command.js +182 -0
- package/dist/cli/managed-command-guard.js +6 -1
- package/dist/cli/provider-command.js +1 -1
- package/dist/cli/restart-monitor.js +67 -50
- package/dist/cli/services-command.js +111 -0
- package/dist/cli/task-context.js +38 -1
- package/dist/cli/team-workspace-command.js +134 -0
- package/dist/cli/thread-command.js +6 -2
- package/dist/cli/watch-logs.js +6 -4
- package/dist/cli/watch-msg.js +1 -1
- package/dist/config/boot-log.js +6 -4
- package/dist/config/builtin-roles.js +2 -2
- package/dist/config/config-field-policy.js +2 -2
- package/dist/config/config-manager.js +1 -8
- package/dist/config/invoke-ipc-service.js +118 -0
- package/dist/config/peer-role-resolver.js +1 -1
- package/dist/config/provider-identity-migration.js +92 -17
- package/dist/config/provider-local-sync.js +2 -0
- package/dist/config/providers-config.js +13 -0
- package/dist/config/providers-management.js +100 -10
- package/dist/config/role-service.js +8 -8
- package/dist/config/role-store.js +22 -22
- package/dist/config/schema-migration.js +86 -88
- package/dist/config/snapshot.js +70 -41
- package/dist/config-store.js +2 -1
- package/dist/core/agent-reload-coordinator.js +6 -4
- package/dist/core/agent-runtime.js +146 -15
- package/dist/core/auth/delegation-authorization.js +66 -0
- package/dist/core/auth/operation-catalog.js +20 -0
- package/dist/core/baseagent-loader.js +75 -42
- package/dist/core/channel-loader.js +45 -13
- package/dist/core/channel-runtime.js +116 -45
- package/dist/core/command/agent-control.js +1 -1
- package/dist/core/command/agent-storage-menu.js +1 -1
- package/dist/core/command/chatmode-config.js +2 -36
- package/dist/core/command/command-handler.js +58 -16
- package/dist/core/command/data-root-resolver.js +32 -23
- package/dist/core/command/eventcenter-menu.js +338 -0
- package/dist/core/command/menu-catalog.js +8 -0
- package/dist/core/command/menu-handler.js +206 -87
- package/dist/core/command/menu-protocol.js +142 -22
- package/dist/core/command/menu-query-batch.js +194 -0
- package/dist/core/command/role-menu.js +27 -15
- package/dist/core/command/slash-gate.js +1 -1
- package/dist/core/command/slash-handler.js +34 -42
- package/dist/core/command/team-workspace-bootstrap.js +350 -0
- package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
- package/dist/core/command/team-workspace-initializer.js +2 -0
- package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
- package/dist/core/command/team-workspace-job-store.js +88 -0
- package/dist/core/command/team-workspace-management-service.js +2 -0
- package/dist/core/command/team-workspace-management-store.js +96 -0
- package/dist/core/command/team-workspace-management.js +265 -0
- package/dist/core/command/team-workspace-members-menu.js +88 -0
- package/dist/core/command/team-workspace-store.js +612 -0
- package/dist/core/command/team-workspace-team.js +193 -0
- package/dist/core/daemon-control.js +45 -15
- package/dist/core/daemon-lifecycle.js +478 -75
- package/dist/core/handoff/dispatcher.js +9 -3
- package/dist/core/handoff/runtime.js +130 -42
- package/dist/core/handoff/store.js +190 -2
- package/dist/core/handoff/types.js +5 -0
- package/dist/core/initialization/service.js +4 -4
- package/dist/core/invoke/executors/index.js +13 -0
- package/dist/core/invoke/executors/media.js +283 -0
- package/dist/core/invoke/executors/text.js +198 -0
- package/dist/core/invoke/invoke-service.js +157 -0
- package/dist/core/invoke/style-router.js +48 -0
- package/dist/core/invoke/types.js +19 -0
- package/dist/core/ipc-registration.js +51 -11
- package/dist/core/lifecycle-notice.js +10 -4
- package/dist/core/memory/consolidation.js +7 -5
- package/dist/core/message/aun-ipc-sender.js +149 -19
- package/dist/core/message/im-renderer.js +28 -84
- package/dist/core/message/message-bridge.js +57 -4
- package/dist/core/message/message-queue.js +46 -4
- package/dist/core/message/message-utils.js +10 -2
- package/dist/core/message/peer-mode.js +7 -34
- package/dist/core/message/pending-hints.js +4 -10
- package/dist/core/message/response-engine.js +163 -52
- package/dist/core/message/send-options.js +7 -4
- package/dist/core/message/send-routing.js +55 -7
- package/dist/core/ownership/owner-resolver.js +8 -0
- package/dist/core/permission/ec-command-parser.js +14 -3
- package/dist/core/permission/protected-paths.js +12 -2
- package/dist/core/permission/shell-environment.js +9 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +24 -0
- package/dist/core/session/adapters/codex-session-file-adapter.js +80 -0
- package/dist/core/session/adapters/ecagent-session-file-adapter.js +22 -0
- package/dist/core/session/adapters/gemini-session-file-adapter.js +39 -0
- package/dist/core/session/session-file-health.js +243 -0
- package/dist/core/session/session-fs-store.js +163 -3
- package/dist/core/session/session-idle-monitor.js +9 -1
- package/dist/core/session/session-manager.js +36 -2
- package/dist/core/task/task-recovery-service.js +13 -2
- package/dist/core/thread/command-parser.js +9 -2
- package/dist/core/thread/thread-operation.js +21 -2
- package/dist/core/thread/thread-route.js +13 -2
- package/dist/directory/owner-directory-admission.js +42 -30
- package/dist/directory/owner-directory-cache.js +143 -126
- package/dist/directory/owner-directory-query-operation.js +9 -8
- package/dist/eck/kit-renderer.js +7 -5
- package/dist/ecweb/basic-settings-service.js +1 -1
- package/dist/ecweb/message-context-service.js +0 -4
- package/dist/ecweb/runtime/lifecycle.js +14 -8
- package/dist/ecweb/runtime/supervisor.js +62 -30
- package/dist/event-center/admission-materializer.js +114 -0
- package/dist/event-center/bus-gate.js +136 -0
- package/dist/event-center/bus-host.js +290 -0
- package/dist/event-center/bus-resolver.js +120 -0
- package/dist/event-center/center-config.js +100 -0
- package/dist/event-center/client-factory.js +50 -0
- package/dist/event-center/daemon.js +45 -0
- package/dist/event-center/directory-source.js +53 -0
- package/dist/event-center/dispatcher.js +157 -0
- package/dist/event-center/event-log.js +110 -0
- package/dist/event-center/index-generator.js +63 -0
- package/dist/event-center/ipc-operation.js +308 -0
- package/dist/event-center/ledger.js +52 -0
- package/dist/event-center/pack-loader.js +202 -0
- package/dist/event-center/pack-manager.js +85 -0
- package/dist/event-center/registry.js +238 -0
- package/dist/event-center/runtime.js +641 -0
- package/dist/event-center/script-runner.js +356 -0
- package/dist/event-center/types.js +35 -0
- package/dist/event-center/validation.js +413 -0
- package/dist/index.js +751 -268
- package/dist/ipc.js +66 -12
- package/dist/paths.js +20 -0
- package/dist/product.js +14 -0
- package/dist/proxy/manager.js +43 -18
- package/dist/proxy/service-supervisor.js +78 -35
- package/dist/response-system/engines/v1/index.js +0 -1
- package/dist/response-system/modes/single-session/index.js +1 -1
- package/dist/services/dispatcher.js +100 -0
- package/dist/services/idempotency.js +90 -0
- package/dist/services/identity.js +52 -0
- package/dist/services/index-generator.js +70 -0
- package/dist/services/index.js +449 -0
- package/dist/services/ipc-operation.js +458 -0
- package/dist/services/ledger.js +52 -0
- package/dist/services/message-log.js +112 -0
- package/dist/services/pack-manager.js +204 -0
- package/dist/services/reply.js +55 -0
- package/dist/services/router.js +95 -0
- package/dist/services/script-runner.js +422 -0
- package/dist/services/service-payload.js +70 -0
- package/dist/services/types.js +18 -0
- package/dist/services/validation.js +297 -0
- package/dist/trigger/application-service.js +21 -1
- package/dist/trigger/audit.js +19 -4
- package/dist/trigger/authorization.js +14 -5
- package/dist/trigger/event-source.js +1 -1
- package/dist/trigger/history.js +176 -7
- package/dist/trigger/ipc-service.js +3 -1
- package/dist/trigger/manager.js +1 -3
- package/dist/trigger/scheduler.js +78 -5
- package/dist/trigger/script-sandbox.js +118 -22
- package/dist/utils/cross-platform.js +175 -13
- package/dist/utils/evolcore-version.js +69 -27
- package/dist/utils/host-info.js +11 -8
- package/dist/utils/instance-registry.js +19 -13
- package/dist/utils/npm-ops.js +48 -0
- package/dist/utils/process-introspect.js +109 -10
- package/dist/utils/startup-trace.js +222 -44
- package/dist/utils/windows-shell-trust.js +80 -6
- package/kits/docs/INDEX.md +2 -2
- package/kits/docs/aun/ABILITY_CALLING.md +10 -17
- package/kits/docs/context-assembly.md +1 -1
- package/kits/docs/evolcore/INDEX.md +5 -2
- package/kits/docs/evolcore/ability.md +4 -0
- package/kits/docs/evolcore/aid.md +1 -1
- package/kits/docs/evolcore/ctl.md +2 -1
- package/kits/docs/evolcore/event-center.md +207 -0
- package/kits/docs/evolcore/file-navigation.md +10 -264
- package/kits/docs/evolcore/fs.md +3 -2
- package/kits/docs/evolcore/group.md +2 -2
- package/kits/docs/evolcore/memory-architecture.md +2 -0
- package/kits/docs/evolcore/menu-exec-schema-commands.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +21 -0
- package/kits/docs/evolcore/msg.md +27 -8
- package/kits/docs/evolcore/provider.md +23 -3
- package/kits/docs/evolcore/response.md +5 -5
- package/kits/docs/evolcore/services.md +277 -0
- package/kits/docs/evolcore/task.md +2 -0
- package/kits/docs/evolcore/team-workspace.md +41 -0
- package/kits/eck_manifest.json +45 -7
- package/kits/eck_message_manifest.json +3 -3
- package/kits/rules/02-navigation.md +10 -1
- package/kits/rules/06-channel.md +5 -6
- package/kits/schemas/_meta.json +17 -6
- package/kits/schemas/agent-config.schema.19.json +5 -7
- package/kits/schemas/agent-config.schema.20.json +936 -0
- package/kits/schemas/daemon.schema.1.json +5 -0
- package/kits/schemas/daemon.schema.2.json +5 -0
- package/kits/schemas/daemon.schema.3.json +2 -1
- package/kits/schemas/daemon.schema.4.json +2 -1
- package/kits/schemas/daemon.schema.5.json +2 -1
- package/kits/schemas/daemon.schema.6.json +1 -1
- package/kits/schemas/daemon.schema.7.json +1 -1
- package/kits/schemas/daemon.schema.8.json +2 -1
- package/kits/schemas/daemon.schema.9.json +2 -1
- package/kits/schemas/relation-config.schema.12.json +2 -3
- package/kits/schemas/role-config.schema.2.json +4 -4
- package/kits/schemas/role-registry.schema.1.json +2 -2
- package/kits/schemas/single-session.schema.1.json +1 -1
- package/kits/schemas/single-session.schema.2.json +1 -1
- package/kits/schemas/single-session.schema.3.json +1 -1
- package/kits/skills/.switches.json +1 -5
- package/kits/skills/ability/SKILL.md +56 -0
- package/kits/skills/ability/references/calling.md +56 -0
- package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
- package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
- package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
- package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
- package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
- package/kits/skills/ec-agent-create/SKILL.md +0 -1
- package/kits/skills/ec-group/SKILL.md +8 -5
- package/kits/skills/ec-group-collaboration/SKILL.md +7 -7
- package/kits/skills/ec-service-proxy/SKILL.md +34 -5
- package/kits/skills/ec-trigger/SKILL.md +4 -4
- package/kits/skills/personal-assistant/SKILL.md +6 -6
- package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
- package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
- package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
- package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
- package/kits/skills/thread-ops/SKILL.md +10 -10
- package/kits/templates/system-fragments/channel.md +3 -3
- package/kits/templates/system-fragments/commands.md +9 -7
- package/kits/templates/system-fragments/reply.md +2 -6
- package/kits/templates/system-fragments/session.md +1 -1
- package/kits/templates/system-fragments/thread.md +11 -9
- package/package.json +5 -6
- package/dist/cli/pa-workspace-command.js +0 -225
- package/dist/core/command/pa-workspace-store.js +0 -468
- package/dist/core/relation/pa-team.js +0 -132
- package/kits/docs/evolcore/pa-workspace.md +0 -51
- package/kits/skills/aid-ability/SKILL.md +0 -244
- package/kits/skills/ec-ability/SKILL.md +0 -67
- package/kits/skills/ec-ability/references/workflows.md +0 -15
|
@@ -1,8 +1,12 @@
|
|
|
1
1
|
import fs from 'node:fs';
|
|
2
2
|
import path from 'node:path';
|
|
3
|
-
import { spawnSync } from 'node:child_process';
|
|
3
|
+
import { execFile, spawnSync } from 'node:child_process';
|
|
4
|
+
import { promisify } from 'node:util';
|
|
5
|
+
const execFileAsync = promisify(execFile);
|
|
4
6
|
const MAX_CACHE_ENTRIES = 128;
|
|
5
7
|
const signatureCache = new Map();
|
|
8
|
+
const pendingCmdSignatures = new Map();
|
|
9
|
+
let signatureGeneration = 0;
|
|
6
10
|
/**
|
|
7
11
|
* The signer name is checked only after Authenticode reports a trusted chain.
|
|
8
12
|
* Keep this list deliberately small: an unsigned or unknown Bash distribution
|
|
@@ -108,8 +112,8 @@ function isAppExecutionAliasPath(value) {
|
|
|
108
112
|
function shellQuote(value) {
|
|
109
113
|
return `'${value.replaceAll("'", "''")}'`;
|
|
110
114
|
}
|
|
111
|
-
function
|
|
112
|
-
|
|
115
|
+
function authenticodeScript(filePath) {
|
|
116
|
+
return [
|
|
113
117
|
'$ErrorActionPreference = "Stop"',
|
|
114
118
|
`$p = ${shellQuote(filePath)}`,
|
|
115
119
|
'$item = Get-Item -LiteralPath $p -Force',
|
|
@@ -121,8 +125,10 @@ function probeAuthenticode(filePath) {
|
|
|
121
125
|
' issuer = if ($sig.SignerCertificate) { [string]$sig.SignerCertificate.Issuer } else { "" }',
|
|
122
126
|
'} | ConvertTo-Json -Compress',
|
|
123
127
|
].join('\n');
|
|
128
|
+
}
|
|
129
|
+
function probeAuthenticode(filePath) {
|
|
124
130
|
const result = spawnSync(systemPowerShellPath(), [
|
|
125
|
-
'-NoLogo', '-NoProfile', '-NonInteractive', '-Command',
|
|
131
|
+
'-NoLogo', '-NoProfile', '-NonInteractive', '-Command', authenticodeScript(filePath),
|
|
126
132
|
], {
|
|
127
133
|
encoding: 'utf8',
|
|
128
134
|
env: systemPowerShellEnvironment(),
|
|
@@ -132,8 +138,11 @@ function probeAuthenticode(filePath) {
|
|
|
132
138
|
});
|
|
133
139
|
if (result.status !== 0 || result.error || !String(result.stdout || '').trim())
|
|
134
140
|
return undefined;
|
|
141
|
+
return parseAuthenticode(String(result.stdout));
|
|
142
|
+
}
|
|
143
|
+
function parseAuthenticode(output) {
|
|
135
144
|
try {
|
|
136
|
-
const parsed = JSON.parse(
|
|
145
|
+
const parsed = JSON.parse(output);
|
|
137
146
|
return {
|
|
138
147
|
status: typeof parsed.status === 'string' ? parsed.status : undefined,
|
|
139
148
|
subject: typeof parsed.subject === 'string' ? parsed.subject : undefined,
|
|
@@ -207,6 +216,10 @@ export function isTrustedWindowsShellExecutable(executable, kind) {
|
|
|
207
216
|
export function resolveTrustedWindowsCmdPath(comSpec) {
|
|
208
217
|
if (process.platform !== 'win32')
|
|
209
218
|
return comSpec || 'cmd.exe';
|
|
219
|
+
const systemReal = resolveWindowsCmdCandidate(comSpec);
|
|
220
|
+
return systemReal && isTrustedWindowsShellExecutable(systemReal, 'cmd') ? systemReal : undefined;
|
|
221
|
+
}
|
|
222
|
+
function resolveWindowsCmdCandidate(comSpec) {
|
|
210
223
|
const systemCmd = windowsSystemCmdPath();
|
|
211
224
|
const candidate = (comSpec || process.env.ComSpec || process.env.COMSPEC || systemCmd).trim();
|
|
212
225
|
if (!candidate)
|
|
@@ -230,9 +243,70 @@ export function resolveTrustedWindowsCmdPath(comSpec) {
|
|
|
230
243
|
if (path.win32.normalize(candidateReal).toLowerCase() !== path.win32.normalize(systemReal).toLowerCase()) {
|
|
231
244
|
return undefined;
|
|
232
245
|
}
|
|
233
|
-
return
|
|
246
|
+
return systemReal;
|
|
247
|
+
}
|
|
248
|
+
/** Async probes keep the same system-path and signature policy without blocking I/O callbacks. */
|
|
249
|
+
export async function resolveTrustedWindowsCmdPathAsync(comSpec) {
|
|
250
|
+
if (process.platform !== 'win32')
|
|
251
|
+
return comSpec || 'cmd.exe';
|
|
252
|
+
const systemReal = resolveWindowsCmdCandidate(comSpec);
|
|
253
|
+
if (!systemReal || isAppExecutionAliasPath(systemReal))
|
|
254
|
+
return undefined;
|
|
255
|
+
let stat;
|
|
256
|
+
try {
|
|
257
|
+
stat = fs.statSync(systemReal);
|
|
258
|
+
if (!stat.isFile())
|
|
259
|
+
return undefined;
|
|
260
|
+
}
|
|
261
|
+
catch {
|
|
262
|
+
return undefined;
|
|
263
|
+
}
|
|
264
|
+
const key = cacheKey(systemReal);
|
|
265
|
+
const cached = signatureCache.get(key);
|
|
266
|
+
if (cached && cached.size === stat.size && cached.mtimeMs === stat.mtimeMs) {
|
|
267
|
+
return cached.trusted ? systemReal : undefined;
|
|
268
|
+
}
|
|
269
|
+
const identity = `${key}:${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}`;
|
|
270
|
+
let pending = pendingCmdSignatures.get(identity);
|
|
271
|
+
if (!pending) {
|
|
272
|
+
const generation = signatureGeneration;
|
|
273
|
+
pending = (async () => {
|
|
274
|
+
try {
|
|
275
|
+
const { stdout } = await execFileAsync(systemPowerShellPath(), [
|
|
276
|
+
'-NoLogo', '-NoProfile', '-NonInteractive', '-Command', authenticodeScript(systemReal),
|
|
277
|
+
], { encoding: 'utf8', env: systemPowerShellEnvironment(), timeout: 5000, windowsHide: true });
|
|
278
|
+
const current = fs.statSync(systemReal);
|
|
279
|
+
if (generation !== signatureGeneration || !current.isFile()
|
|
280
|
+
|| current.size !== stat.size || current.mtimeMs !== stat.mtimeMs || current.ctimeMs !== stat.ctimeMs
|
|
281
|
+
|| resolveWindowsCmdCandidate(comSpec) !== systemReal)
|
|
282
|
+
return false;
|
|
283
|
+
const trusted = isTrustedShellSignature('cmd', parseAuthenticode(stdout) ?? {});
|
|
284
|
+
signatureCache.set(key, { size: stat.size, mtimeMs: stat.mtimeMs, trusted });
|
|
285
|
+
while (signatureCache.size > MAX_CACHE_ENTRIES) {
|
|
286
|
+
const oldest = signatureCache.keys().next().value;
|
|
287
|
+
if (!oldest)
|
|
288
|
+
break;
|
|
289
|
+
signatureCache.delete(oldest);
|
|
290
|
+
}
|
|
291
|
+
return trusted;
|
|
292
|
+
}
|
|
293
|
+
catch {
|
|
294
|
+
return false;
|
|
295
|
+
}
|
|
296
|
+
})();
|
|
297
|
+
pendingCmdSignatures.set(identity, pending);
|
|
298
|
+
}
|
|
299
|
+
try {
|
|
300
|
+
return await pending ? systemReal : undefined;
|
|
301
|
+
}
|
|
302
|
+
finally {
|
|
303
|
+
if (pendingCmdSignatures.get(identity) === pending)
|
|
304
|
+
pendingCmdSignatures.delete(identity);
|
|
305
|
+
}
|
|
234
306
|
}
|
|
235
307
|
/** Test hook: clear cached signature decisions after a fixture is replaced. */
|
|
236
308
|
export function clearWindowsShellTrustCache() {
|
|
309
|
+
signatureGeneration++;
|
|
237
310
|
signatureCache.clear();
|
|
311
|
+
pendingCmdSignatures.clear();
|
|
238
312
|
}
|
package/kits/docs/INDEX.md
CHANGED
|
@@ -18,9 +18,9 @@
|
|
|
18
18
|
| 速查表 | `aun/CHEATSHEET.md` | AUN 协议命名空间与常用操作速查 |
|
|
19
19
|
| SDK 文档指引 | `aun/SDK.md` | AUN SDK 文档位置(`$AUN_SDK_DOCS`)、结构与常用入口;四语言版本共用同一份协议文档 |
|
|
20
20
|
| 同步协议 | `aun/SYNC_PROTOCOL.md` | 上游协议同步 SOP |
|
|
21
|
-
| Ability 调用 | `aun/ABILITY_CALLING.md` | AID 能力发现、
|
|
21
|
+
| Ability 调用 | `aun/ABILITY_CALLING.md` | AID 能力发现、payload、设备状态收集和请求关联的协议参考;实际流程用 `ability` 技能 |
|
|
22
22
|
|
|
23
|
-
EvolCore
|
|
23
|
+
AUN Ability 规范与按任务选择提供、发现、管理和调用流程,统一从 `ability` 技能进入(`ec skill load ability`)。EvolCore 能力插件的现行命令语法见 `evolcore/ability.md`;源码仓库 `$PACKAGE_ROOT/docs/ability/plugin-system/README.md` 提供实施设计与交付状态,不代替随包命令手册。
|
|
24
24
|
|
|
25
25
|
## EvolCore 命令
|
|
26
26
|
|
|
@@ -1,11 +1,13 @@
|
|
|
1
|
-
# AUN Ability 调用
|
|
1
|
+
# AUN Ability 调用
|
|
2
2
|
|
|
3
|
-
本文是 EvolCore 当前实现下的通用 AID Ability Caller
|
|
3
|
+
本文是 EvolCore 当前实现下的通用 AID Ability Caller 协议与 transport 参考。它描述能力发现、原始 JSON
|
|
4
4
|
传输和请求结果查询,不定义任何具体 Provider 的能力。Caller 从 Provider 发布的索引或在线发现
|
|
5
5
|
结果中选择能力设备,再通过 AUN 传输层定向;EvolCore 不替 Caller 选择设备,也不提供 runtime 或 slot 寻址。
|
|
6
6
|
|
|
7
7
|
与当前 EvolApp 互调采用 `aid-ability/2`、`aun.ability.index.v1` 和 `aun.ability.release.v1`。双方是独立 Provider/Caller;调用和 ACK/result 使用加密私聊,能力寻址为 Provider AID + path,设备只由 transport 选择。
|
|
8
8
|
|
|
9
|
+
理解 AUN Ability 规范并选择提供、管理或调用流程时统一使用 `ability` 技能(`ec skill load ability`),仅按当前任务读取相应指南。本文是当前通用 Caller 协议与 transport 的事实参考;payload 中的 `aid-ability/2` 仅为 wire 协议版本标识。CLI 参数见 `$KITS_DOCS/evolcore/msg.md`、`$KITS_DOCS/evolcore/fs.md`、`$KITS_DOCS/evolcore/storage.md`,本地插件实例命令见 `$KITS_DOCS/evolcore/ability.md`。
|
|
10
|
+
|
|
9
11
|
## 边界
|
|
10
12
|
|
|
11
13
|
EvolCore 负责:
|
|
@@ -31,7 +33,7 @@ EvolCore 不负责:
|
|
|
31
33
|
推荐按三层发现:
|
|
32
34
|
|
|
33
35
|
```text
|
|
34
|
-
L1
|
|
36
|
+
L1 <provider-aid>:/ability/index.json
|
|
35
37
|
发布者能力快照,可缓存但可能过期
|
|
36
38
|
|
|
37
39
|
L2 protocol/discover
|
|
@@ -41,22 +43,13 @@ L3 detail_ref 指向的 JSON
|
|
|
41
43
|
不可变能力契约,包含参数、结果、安全和幂等要求
|
|
42
44
|
```
|
|
43
45
|
|
|
44
|
-
Provider
|
|
46
|
+
通过 `ec fs cat` 读取该 Provider 发布的 L1 索引:
|
|
45
47
|
|
|
46
48
|
```text
|
|
47
49
|
ec fs cat <provider-aid>:/ability/index.json
|
|
48
50
|
```
|
|
49
51
|
|
|
50
|
-
|
|
51
|
-
public/ACL 鉴权。单次读取预算默认及最高为 128 KiB,超限返回 FS_CAT_TOO_LARGE,不返回截断正文。
|
|
52
|
-
文件超出预算、Provider 不是当前私聊对端、文件非文本或者当前运行时尚不支持该入口时,
|
|
53
|
-
回退到下载,并把临时文件放在当前会话的 `$TMPDIR`:
|
|
54
|
-
|
|
55
|
-
```text
|
|
56
|
-
ec storage download <self-aid> https://<provider-aid>/ability/index.json $TMPDIR/ability-index.json
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
能力发现不能依赖目录枚举;只读取明确的 `index.json` 和 `detail_ref`。
|
|
52
|
+
能力发现不能依赖目录枚举;只读取明确的 `index.json` 和契约给出的 `detail_ref`。
|
|
60
53
|
|
|
61
54
|
L1/L2/L3 中用于机器决策的字段只有结构化字段:
|
|
62
55
|
|
|
@@ -112,11 +105,11 @@ Windows 或复杂 JSON 优先使用 `--payload-file`:通过文件工具把原
|
|
|
112
105
|
`$TMPDIR`,再单独执行发送。PowerShell 路径用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 用
|
|
113
106
|
`"$TMPDIR/obs_payload.json"`;文件内容不加 Shell 转义。该选项与 `--payload` 及位置文本互斥,
|
|
114
107
|
设备选择、加密和请求等待规则相同,详见 `../evolcore/msg.md`。
|
|
115
|
-
在当前 Windows PowerShell 托管环境中,`
|
|
108
|
+
在当前 Windows PowerShell 托管环境中,`ecmsg` 的 `--payload` 使用单引号包裹,并在 JSON 内每个
|
|
116
109
|
双引号前加反斜杠,例如:
|
|
117
110
|
|
|
118
111
|
```text
|
|
119
|
-
|
|
112
|
+
ecmsg send --to <provider-aid> --payload '{\"type\":\"ability\",\"role\":\"call\",\"call_id\":\"<call-id>\",\"operation_id\":\"<operation-id>\",\"ability_path\":\"<path>\",\"definition_id\":\"<definition-id>\",\"params\":{},\"ttl\":<ttl-seconds>,\"async\":false}' --device-id <provider-device-id> --encrypt yes --return required --timeout <ttl-seconds>s --format json
|
|
120
113
|
```
|
|
121
114
|
|
|
122
115
|
`device/status` 且 `params.action=read` 是 AID 级在线设备状态查询,命令不要带 `--device-id`,
|
|
@@ -136,7 +129,7 @@ payload/params 也不指定设备。各支持并已发布该能力的在线设
|
|
|
136
129
|
payload 没有 `sent_at` 时,EvolCore 在实际发送前自动补当前 Unix 毫秒时间戳,Caller 不需要
|
|
137
130
|
自己取当前时间。时限按下方“时限估算”确定。
|
|
138
131
|
EvolApp v1 必须使用 `--encrypt`;不能沿用普通聊天的明文 `[reply]` 设置。
|
|
139
|
-
这套转义只针对当前 PowerShell 到 `
|
|
132
|
+
这套转义只针对当前 PowerShell 到 `ecmsg` 的调用链,不直接套用到其他 Shell。
|
|
140
133
|
|
|
141
134
|
Ability 调用通常由业务协议提供:
|
|
142
135
|
|
|
@@ -49,7 +49,7 @@ evolcore 收到消息 → 构造一份 **vars**(运行时变量,见下)→
|
|
|
49
49
|
渲染时按 `session.sessionType`(缺省 `'main'`)依次查:`sessionManifests` 覆盖 → 内置映射 → `eck_manifest.json`(`resolveSessionManifest`)。bootstrapping 阶段固定用 `eck_manifest.json`。
|
|
50
50
|
**每个 manifest 文件各自两级合并**(`$KITS/<file>` + `$ECK/<file>`),互不干扰。
|
|
51
51
|
|
|
52
|
-
`chatMode
|
|
52
|
+
`chatMode` 只支持 interactive/proactive,均复用按生命周期、sessionType 和 sessionManifests 选择的 system/message manifest 与基础 vars。派生变量 `activePush` 仅在 proactive 时为 true,工具门禁变量也按 proactive 注入。PA 身份不改变 Agent 可见的模式、manifest 或 vars;仅在 active AUN 人类 Owner 私聊主会话及话题中,将 PA 的 proactive activity 经 message.send 可靠投递。其他 proactive 场景使用 thought.put,群聊固定 proactive。
|
|
53
53
|
|
|
54
54
|
## section 字段
|
|
55
55
|
|
|
@@ -4,7 +4,8 @@
|
|
|
4
4
|
运行时 evolcore 会通过 `commands` fragment 按当前场景(有无 peer/group、对端角色)
|
|
5
5
|
注入一张精简能力卡,指向本目录下对应文档;需要完整用法时 Read 对应文档。
|
|
6
6
|
|
|
7
|
-
>
|
|
7
|
+
> 对外发送统一走 `ecmsg`(本端恒为当前会话本端,不写 `--from`);
|
|
8
|
+
> 当前渠道是否需要 CLI 回复,以运行时注入的
|
|
8
9
|
> `[reply]` 规则为准,active 的 `[channel]` 补充扩展能力。参数不是全局通用的:`--format json` 仅用于对应帮助中明确支持的命令,
|
|
9
10
|
> `--app <name>` 仅用于消息 pull/ack、消费类 RPC 和明确支持 app slot 的文件操作。
|
|
10
11
|
|
|
@@ -32,7 +33,7 @@ ECWeb 托管重启、端口占用与升级失败处理见 `ecweb-lifecycle.md`
|
|
|
32
33
|
|
|
33
34
|
Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSecurityInfoW ... 5`、`unelevated ... cannot enforce deny-read` 或 daemon 管道 `EPERM` 时,参见 `codex-windows-sandbox.md`。
|
|
34
35
|
|
|
35
|
-
## 对外通信 / 网络类(连 AUN
|
|
36
|
+
## 对外通信 / 网络类(连 AUN,发送统一走 `ecmsg`)
|
|
36
37
|
|
|
37
38
|
| 命令集 | 用途 | 触发词 | 适用场景 | 文档 |
|
|
38
39
|
|--------|------|--------|----------|------|
|
|
@@ -82,6 +83,8 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
|
|
|
82
83
|
| `ec stats` | Token 用量与费用统计 | 用量/费用/统计/预算/token/cost | `stats.md` |
|
|
83
84
|
| `ec trigger` | 定时与事件触发器管理(创建用 `create`,`set` 为兼容别名) | 触发器/定时任务/cron/提醒/定时检查/自动执行/巡检/禁用 trigger/删除 trigger | `trigger.md` |
|
|
84
85
|
| `ec trigger event` | EventBus 事件目录 | 事件触发/事件目录/EventBus/source.type=event/filter.match | `event.md` |
|
|
86
|
+
| `ec events` | AUN 事件中心:注册/发布/订阅事件,事件到达跑脚本 | 事件中心/注册事件/发布事件/订阅事件/事件包/pack.json/center.json/事件处理脚本/AUN 事件 | `event-center.md` |
|
|
87
|
+
| `ec services` | 服务路由:服务包状态/诊断/重载,对端 describe/schema/call | 服务路由/服务包/提供接口/被对端调用/service.json/services.call/服务节点 | `services.md` |
|
|
85
88
|
| `ec task` | 恢复暂停或异常中断的会话任务 | 任务恢复/异常中断/继续任务/resume | `task.md` |
|
|
86
89
|
| `ec skill` | EC 技能管理(新建/安装/删除/启用/禁用/校验/查路径) | 创建技能/新建 skill/安装技能/装个 skill/删除技能/禁用技能/启用技能/看看有哪些技能/技能为什么没生效 | `ec-capabilities.md` |
|
|
87
90
|
| `ec pa-workspace` | 在 Owner 的 AUN 私聊中查看和维护 PA 工作区入口导航 | 个人助理工作区/工作区入口调整/产物入口/报告入口/任务入口/隐藏入口/改名入口/排序入口 | `pa-workspace.md` |
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
本手册描述已经实现的 CLI。默认输出 JSON;每条 `ec` 命令单独执行。下列 `<...>` 为实际运行结果或用户指定值,不能原样提交。
|
|
4
4
|
|
|
5
|
+
`ability` 技能介绍 AUN Ability 规范并组织提供、发现、管理和调用任务(`ec skill load ability`);本手册只维护 EvolCore 插件开发、实例管理与本地调用命令的语法和行为。远端 AUN 发现与调用协议见 `$KITS_DOCS/aun/ABILITY_CALLING.md`。
|
|
6
|
+
|
|
7
|
+
`ec ability invoke` 调用宿主内可管理的已安装实例,不是远端 AUN 调用。当前没有 `ec ability remote` 命令;远端发现、设备选择和调用由同一技能衔接 `$KITS_DOCS/aun/ABILITY_CALLING.md` 与 `ec fs`/`ec msg`,无需另装 Caller 技能。
|
|
8
|
+
|
|
5
9
|
## 身份与命令发现
|
|
6
10
|
|
|
7
11
|
```text
|
|
@@ -139,7 +139,7 @@ Owner 目录同步在连接可用时建立单条核验和暂态故障退避链
|
|
|
139
139
|
|
|
140
140
|
Ownership 任务事件、修改本地 Owner 配置、相关名片或 Owner 关系材料变更只失效缓存,不主动发起复核。连接首次就绪、断线恢复和缓存到期均不触发提前刷新;下次实际消息、查询或授权需要 Owner 时才等待核验。相同任务事件和连接通知去重,无关对端、普通文件变更不触发失效。远端 Owner 的 Storage 事件只在本机确实收到时生效,不能假定事件完整覆盖远端变化。Owner 绑定提交前及修改 Owner 的授权仍要求显式核验成功。
|
|
141
141
|
|
|
142
|
-
|
|
142
|
+
处于 `created`、`ownerpending` 或 `bootstrapping` 生命周期的普通 Agent 在 AUN 连接就绪后,优先取根级 `config.json.owner`,缺失时兼容旧 `owners` 数组的首个非空 AID;沿用首个配置 Owner 的选择规则,不向数组内所有 AID 发送邀约。没有绑定目标、生命周期无效或已经 `active` 时静默跳过,不因遗留配置重新绑定。存在绑定目标且新鲜协议状态为 `unbound`、`released` 或 `single_sided` 时,每个 Agent 对同一 Owner 在本进程内最多自动提交一次绑定邀约。已有协议共识时不提交,也不自动转让 Owner。提交前记录 INFO 日志 `Submitting configured Owner binding invitation`,包含主体、目标 Owner 和协议状态;提交结果与失败继续记录 `EC_OWNERSHIP` 的 `bind.result` / `bind.failed`。等待确认、提交失败或回执不明均不定时重发,断线重连和渠道重建也不会再次提交;需要重发时显式执行绑定命令。自动尝试记录只保存在内存,不持久化;进程重启后重新检查并允许再自动提交一次。
|
|
143
143
|
|
|
144
144
|
普通 Agent 的创建、手动绑定、启动补绑定和转让,在提交关系修改前实时读取目标 Owner 的远端已验签名片,要求名片 AID 匹配且 `type: human`;非 human 返回 `INVALID_OWNER`,无法读取、未验签、类型缺失或名片不匹配返回 `OWNER_IDENTITY_UNAVAILABLE`。接受绑定或转让邀约也执行此限制;当前进程没有请求投影时,先从历史消息定位原请求的目标用于类型预检,原请求真实性及固定参与方仍由 SDK 在提交时核验。拒绝邀约不受目标类型限制。该限制面向普通 Agent,不把 daemon Control AID 的身份规则改成 Agent 规则,也不追溯修改已有协议关系。
|
|
145
145
|
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
# 事件中心(`ec events`)
|
|
2
|
+
|
|
3
|
+
> 状态:[done]
|
|
4
|
+
> 创建:2026-11-08
|
|
5
|
+
> 对应实现:`src/event-center/` 和 `src/cli/events-command.ts`。
|
|
6
|
+
|
|
7
|
+
Agent 怎么建事件包、写处理脚本、注册/发布/订阅事件。
|
|
8
|
+
|
|
9
|
+
> 完整设计见仓库 `docs/event-center/`;Schema 见 `docs/event-center/schema/`。
|
|
10
|
+
> 本文是运行时知识卡,与 `docs/event-center/usage.md` 保持同步。
|
|
11
|
+
|
|
12
|
+
## 一、先判断该不该用
|
|
13
|
+
|
|
14
|
+
| 要做的事 | 用什么 |
|
|
15
|
+
| --- | --- |
|
|
16
|
+
| 到点执行(每天 9 点、每隔 30 分钟) | `ec trigger`,不是事件中心 |
|
|
17
|
+
| 有事情发生时通知**别的 AID** | 事件中心 |
|
|
18
|
+
| 收到别人的通知后跑确定性逻辑 | 事件中心 |
|
|
19
|
+
| 收到通知后要模型判断、要写报告 | 事件中心 + 脚本里调 `ecmsg` |
|
|
20
|
+
| 消息绝不能丢 | 普通持久消息,**不是**事件 |
|
|
21
|
+
|
|
22
|
+
事件是 TTL 内的在线通知:TTL 到期、断线、Bus 重启都会丢。没有历史、没有重放、没有业务 ACK。
|
|
23
|
+
|
|
24
|
+
## 二、目录
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
$AGENT_DIR/events/
|
|
28
|
+
├── center.json # 只有"我要当事件中心"时才需要
|
|
29
|
+
└── <包名>/
|
|
30
|
+
├── pack.json
|
|
31
|
+
├── ledger.jsonl
|
|
32
|
+
├── scripts/
|
|
33
|
+
└── logs/
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
包名用英文短横线,如 `meeting`、`order-watch`。
|
|
37
|
+
|
|
38
|
+
## 三、三种角色
|
|
39
|
+
|
|
40
|
+
一个 `pack.json` 里三类声明互相独立:
|
|
41
|
+
|
|
42
|
+
| 角色 | 写在哪 | 含义 |
|
|
43
|
+
| --- | --- | --- |
|
|
44
|
+
| 登记 | `register[]` | 让本 AID 成为这个事件的事件中心 |
|
|
45
|
+
| 发布 | `publish[]` | 往别人的事件中心发 |
|
|
46
|
+
| 订阅 | `subscribe[]` | 收别人的事件,收到就跑脚本 |
|
|
47
|
+
|
|
48
|
+
只订阅时不需要 `center.json`。
|
|
49
|
+
|
|
50
|
+
## 四、pack.json
|
|
51
|
+
|
|
52
|
+
```json
|
|
53
|
+
{
|
|
54
|
+
"v": 1,
|
|
55
|
+
"name": "会议通知",
|
|
56
|
+
"register": [
|
|
57
|
+
{ "event": "meeting.created", "description": "新会议", "ttl": 30 }
|
|
58
|
+
],
|
|
59
|
+
"publish": [
|
|
60
|
+
{ "bus": "$owner", "event": "meeting.created" }
|
|
61
|
+
],
|
|
62
|
+
"subscribe": [
|
|
63
|
+
{
|
|
64
|
+
"bus": "$owner",
|
|
65
|
+
"event": "meeting.created",
|
|
66
|
+
"handler": { "script": "scripts/on-created.mjs", "runtime": "node", "timeoutMs": 15000 }
|
|
67
|
+
}
|
|
68
|
+
]
|
|
69
|
+
}
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### bus 写什么
|
|
73
|
+
|
|
74
|
+
`bus` **不写字面 AID**,写占位符:
|
|
75
|
+
|
|
76
|
+
| 写法 | 指向 |
|
|
77
|
+
| --- | --- |
|
|
78
|
+
| `$self` | 本 AID 自己的事件中心 |
|
|
79
|
+
| `$owner` | 本 Agent 的 Owner(Evol App 往这里发) |
|
|
80
|
+
| `$pa` | 本 Owner 的个人助理 |
|
|
81
|
+
| `$pa.<role>` | PA Team 里担任 `<role>` 的人 |
|
|
82
|
+
| `"a.b.agentid.cn"` | 字面 AID,只在对方明确给了地址时用 |
|
|
83
|
+
|
|
84
|
+
包之所以写占位符:包是拿来拷给别的 Agent 的,写死 AID 拷过去就指向错的人。
|
|
85
|
+
|
|
86
|
+
约束:
|
|
87
|
+
|
|
88
|
+
- `$pa.<role>` 匹配多个时,取 AID 字典序第一个,不报错。同一个包在不同 Agent 上解析结果稳定。
|
|
89
|
+
- `subscribe[]` 内部同一个 `(bus, event)` 只能出现一次(同理 `publish[]`);publish 与 subscribe 之间互不冲突,可以既发又订同一事件。
|
|
90
|
+
- `handler.script` 必须在 `scripts/` 下,禁止绝对路径、`..`、符号链接。
|
|
91
|
+
- `runtime` ∈ `node` / `python` / `bash` / `powershell`;省略时按扩展名推断,推断不出即校验失败。
|
|
92
|
+
- 一个包校验失败只废这个包,其余照常启动。
|
|
93
|
+
- 占位符解析失败时按顶层 `busResolve` 处理:`strict`(缺省)停该包,`keep-last` 沿用上次结果。
|
|
94
|
+
|
|
95
|
+
## 五、center.json
|
|
96
|
+
|
|
97
|
+
```json
|
|
98
|
+
{
|
|
99
|
+
"v": 1,
|
|
100
|
+
"enabled": true,
|
|
101
|
+
"authMode": "allowlist",
|
|
102
|
+
"allowlist": {
|
|
103
|
+
"meeting.created": {
|
|
104
|
+
"allow": {
|
|
105
|
+
"publish": ["bus.example.cn"],
|
|
106
|
+
"subscribe": []
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
`allow.publish` / `allow.subscribe` 为**空数组表示不额外限制**,非空则只放行列出的 AID;可再加 `deny`(命中即拒,优先于 `allow`)。不接受旧写法 `publish_aids` / `subscribe_aids`,也不接受 `"*"` 通配。白名单放行不等于能发——最终还要叠加联系人准入。
|
|
114
|
+
|
|
115
|
+
`enabled=false`(缺省)时本 AID 只作订阅方/发布方,不承接任何人的事件。同一个 AID 不能在两台机器上同时开事件中心(`DEVICE_CONFLICT`)。
|
|
116
|
+
|
|
117
|
+
白名单**不写进 pack.json**:包会被拷走,白名单不能跟着走。
|
|
118
|
+
|
|
119
|
+
## 六、脚本契约
|
|
120
|
+
|
|
121
|
+
### stdin(一个 JSON)
|
|
122
|
+
|
|
123
|
+
```json
|
|
124
|
+
{
|
|
125
|
+
"v": 1,
|
|
126
|
+
"pack": { "name": "meeting", "dir": "…/events/meeting" },
|
|
127
|
+
"bus": "bus.example.cn",
|
|
128
|
+
"event": {
|
|
129
|
+
"name": "meeting.created",
|
|
130
|
+
"id": "01J…",
|
|
131
|
+
"publisher": "bus.example.cn",
|
|
132
|
+
"receivedAt": 1794115720000,
|
|
133
|
+
"data": { "title": "周会" }
|
|
134
|
+
},
|
|
135
|
+
"agent": { "aid": "self.agentid.cn", "dir": "…" },
|
|
136
|
+
"paths": { "ledger": "…/ledger.jsonl", "logs": "…/logs" }
|
|
137
|
+
}
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
**判断"谁发的"用 `event.publisher`**。信封上的 from 永远是 Bus 自己。
|
|
141
|
+
|
|
142
|
+
### 输出
|
|
143
|
+
|
|
144
|
+
| 情况 | 写法 |
|
|
145
|
+
| --- | --- |
|
|
146
|
+
| 正常完成 | 退出码 0 |
|
|
147
|
+
| 无事发生 | 最后一行 `[[NOOP]]`(仍写 `handled` 记录,`outcome:"noop"`) |
|
|
148
|
+
| 有结果 | 最后一行 `{"outcome":"success","text":"…","files":[]}` |
|
|
149
|
+
| 失败 | 退出码非 0 |
|
|
150
|
+
|
|
151
|
+
末行不是 JSON 也不是 `[[NOOP]]` 时按纯文本结果处理(`text` = 末行)。
|
|
152
|
+
|
|
153
|
+
### 限制
|
|
154
|
+
|
|
155
|
+
| 项 | 值 |
|
|
156
|
+
| --- | --- |
|
|
157
|
+
| 超时 | 默认 30s,`timeoutMs` ∈ [1s, 300s] |
|
|
158
|
+
| 输出上限 | stdout+stderr 合计 1 MiB,超出终止 |
|
|
159
|
+
| 环境变量 | `EC_SELF_AID` / `EC_PACK_DIR` / `EC_EVENT` / `EC_EVENT_ID` / `EC_BUS` / `EC_PUBLISHER` |
|
|
160
|
+
| 密钥清理 | 所有 `*_API_KEY` / `*_TOKEN` 被移除 |
|
|
161
|
+
| 沙箱 | 非 fullaccess 模式走 trigger 同款沙箱(cwd 为 agent 工程目录,脚本被快照执行);fullaccess 下 cwd 为包目录 |
|
|
162
|
+
| Windows | 沙箱模式需预置 codex 沙箱,未预置时报 `SCRIPT_SANDBOX_UNAVAILABLE`;`node` 运行时用本机 node.exe,`.mjs` 可跑 |
|
|
163
|
+
|
|
164
|
+
事件数据一律从 stdin JSON 读,不要依赖读包目录(`events/` 属 L-class,沙箱下不可读)。
|
|
165
|
+
|
|
166
|
+
## 七、常用操作
|
|
167
|
+
|
|
168
|
+
```
|
|
169
|
+
ec events status [<包名>] # 每包状态
|
|
170
|
+
ec events doctor <包名> # 白名单/脚本/路径/租约诊断
|
|
171
|
+
ec events ledger <包名> [--tail 20] # 台账
|
|
172
|
+
ec events tail <包名> # 事件日志
|
|
173
|
+
ec events reload [<包名>] # 手动重载
|
|
174
|
+
ec events allowlist add <event> --publish <aid>
|
|
175
|
+
ec events allowlist remove <event> --publish <aid>
|
|
176
|
+
ec events allowlist show [--event <name>]
|
|
177
|
+
ec events publish <包名> <事件名> --data '<json>'
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
改 `pack.json` 后热更新会自动 diff;不确定是否生效就跑 `ec events reload`。
|
|
181
|
+
|
|
182
|
+
## 八、排查
|
|
183
|
+
|
|
184
|
+
| 症状 | 先看 |
|
|
185
|
+
| --- | --- |
|
|
186
|
+
| 订阅没生效 | `ledger.jsonl` 里 `subscribe` 的 `result` 和 `code` |
|
|
187
|
+
| 收不到事件 | 对方 Bus 的 `allowlist.<event>.allow.subscribe` 有没有放行你;也要看联系人准入 |
|
|
188
|
+
| 收到但脚本没跑 | 日志里 `filtered` 记录(filter 不匹配);或 `received` 后队列满 `dropped` |
|
|
189
|
+
| 脚本失败 | `handled` 记录的 `exit`、`outcome` 和 `cmd` |
|
|
190
|
+
| `DEVICE_CONFLICT` | 同一 AID 是否在别处已经开着事件中心 |
|
|
191
|
+
| `FORBIDDEN` | 目标 Bus 白名单没放行本 AID |
|
|
192
|
+
| 脚本全报 126 | 沙箱不可用:`SCRIPT_SANDBOX_UNAVAILABLE`(Windows 未预置沙箱,或 agent 无工程目录) |
|
|
193
|
+
|
|
194
|
+
## 九、不要做的事
|
|
195
|
+
|
|
196
|
+
1. **不要从 `message.received` 里解析事件**。事件只通过 SDK 的 `onEvent` 回调;消息层看到 `app.pubsub.v1` 直接忽略。
|
|
197
|
+
2. **不要用 `from != self` 判断是不是事件**。自己的 Bus 发给自己时 from 就是自己。
|
|
198
|
+
3. **不要指望事件重放**。没收到就是没了,要补用持久消息重新问。
|
|
199
|
+
4. **不要把白名单写进 pack.json**。
|
|
200
|
+
5. **不要在同一个包里给同一个 `(bus, event)` 写两个 handler**。
|
|
201
|
+
|
|
202
|
+
## 十、相关文档
|
|
203
|
+
|
|
204
|
+
| 文档 | 用途 |
|
|
205
|
+
| --- | --- |
|
|
206
|
+
| `$KITS_DOCS/evolcore/event.md` | Trigger 的 EventBus 事件目录(**内部事件,不是 AUN 事件**) |
|
|
207
|
+
| `$KITS_DOCS/evolcore/trigger.md` | 定时/事件触发器,到点执行用这个 |
|