evolcore 0.0.43-test.4 → 0.0.43-test.6
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 +93 -0
- package/bin/ecmsg.js +437 -91
- package/dist/agents/baseagent-availability.js +19 -4
- package/dist/agents/baseagent.js +2 -2
- package/dist/agents/claude-runner.js +19 -4
- package/dist/agents/codex/app-server-client.js +14 -3
- package/dist/agents/codex-runner.js +18 -23
- package/dist/aun/aid/agentmd.js +25 -0
- package/dist/aun/aid/control-aid.js +15 -0
- package/dist/aun/aid/identity.js +8 -0
- package/dist/aun/aid/ownership-operation.js +12 -3
- package/dist/aun/group/invite-service.js +3 -2
- package/dist/aun/service-proxy.js +18 -6
- package/dist/channels/aun.js +99 -23
- package/dist/channels/daemon.js +2 -2
- package/dist/cli/agent-create.js +19 -7
- package/dist/cli/aid-bind-command.js +3 -0
- package/dist/cli/aun-commands.js +19 -4
- package/dist/cli/code-stats.js +451 -213
- package/dist/cli/ctl-command.js +1 -3
- package/dist/cli/daemon-commands.js +42 -4
- package/dist/cli/directory.js +3 -1
- package/dist/cli/ecmsg-gateway.js +206 -0
- package/dist/cli/index.js +6 -0
- package/dist/cli/init.js +120 -13
- package/dist/cli/provider-command.js +82 -5
- package/dist/cli/restart-monitor.js +35 -24
- package/dist/cli/stats.js +8 -1
- package/dist/cli/task-context.js +41 -1
- package/dist/cli/watch-logs.js +6 -4
- package/dist/config/boot-log.js +16 -3
- package/dist/config/builtin-roles.js +2 -2
- package/dist/config/config-manager.js +5 -14
- package/dist/config/daemon-services.js +1 -0
- package/dist/config/peer-role-resolver.js +6 -6
- package/dist/config/provider-identity-migration.js +277 -0
- package/dist/config/provider-identity.js +37 -0
- package/dist/config/provider-ipc-service.js +40 -3
- package/dist/config/provider-local-sync.js +155 -0
- package/dist/config/providers-config.js +45 -4
- package/dist/config/providers-management.js +242 -76
- package/dist/config/providers.js +4 -1
- package/dist/config/role-service.js +8 -8
- package/dist/config/role-store.js +22 -22
- package/dist/config/schema-migration.js +143 -86
- package/dist/config/snapshot.js +70 -41
- package/dist/core/agent-runtime.js +48 -9
- package/dist/core/auth/auth-gateway.js +5 -3
- package/dist/core/auth/delegation-diagnostics.js +6 -2
- package/dist/core/auth/operation-authorizer.js +3 -1
- package/dist/core/auth/operation-catalog.js +6 -4
- package/dist/core/baseagent-loader.js +114 -11
- package/dist/core/channel-loader.js +36 -13
- package/dist/core/channel-runtime.js +112 -42
- package/dist/core/command/cli-intent-parser.js +2 -1
- package/dist/core/command/command-handler.js +16 -11
- package/dist/core/command/menu-handler.js +8 -3
- package/dist/core/command/menu-protocol.js +80 -7
- package/dist/core/command/provider-menu.js +4 -2
- package/dist/core/command/role-menu.js +29 -17
- package/dist/core/command/slash-handler.js +52 -16
- package/dist/core/daemon-control.js +42 -15
- package/dist/core/daemon-lifecycle.js +411 -67
- package/dist/core/handoff/dispatcher.js +9 -3
- package/dist/core/handoff/runtime.js +139 -45
- package/dist/core/handoff/store.js +190 -2
- package/dist/core/handoff/types.js +5 -0
- package/dist/core/initialization/service.js +7 -6
- package/dist/core/ipc-registration.js +5 -4
- package/dist/core/lifecycle-notice.js +10 -4
- package/dist/core/message/aun-ipc-sender.js +83 -5
- package/dist/core/message/message-admission.js +2 -0
- package/dist/core/message/message-bridge.js +53 -4
- package/dist/core/message/message-queue.js +46 -4
- package/dist/core/message/pending-hints.js +4 -10
- package/dist/core/message/response-engine.js +33 -25
- package/dist/core/message/send-options.js +40 -0
- package/dist/core/message/send-routing.js +320 -0
- package/dist/core/ownership/owner-resolver.js +112 -8
- package/dist/core/permission/ec-command-parser.js +159 -16
- package/dist/core/permission/readonly-shell-query.js +66 -7
- package/dist/core/permission/tool-error-code.js +13 -1
- package/dist/core/permission/tool-policy.js +74 -20
- package/dist/core/relation/same-owner-proof.js +131 -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-fs-store.js +164 -3
- package/dist/core/session/session-idle-monitor.js +103 -17
- package/dist/core/session/session-manager.js +105 -18
- package/dist/core/thread/thread-route.js +5 -2
- package/dist/directory/owner-directory-admission.js +26 -1
- package/dist/directory/owner-directory-cache.js +739 -109
- package/dist/directory/owner-directory-markdown.js +146 -36
- package/dist/directory/owner-directory-query-operation.js +6 -3
- package/dist/directory/owner-directory-scope.js +12 -0
- package/dist/directory/owner-directory-search.js +5 -1
- package/dist/directory/owner-directory-store.js +28 -0
- package/dist/ecweb/basic-settings-service.js +15 -1
- package/dist/ecweb/message-context-service.js +2 -2
- package/dist/ecweb/providers-service.js +3 -1
- package/dist/ecweb/runtime/lifecycle.js +26 -15
- package/dist/ecweb/runtime/supervisor.js +120 -51
- package/dist/index.js +551 -250
- package/dist/paths.js +2 -1
- package/dist/proxy/manager.js +40 -17
- package/dist/proxy/service-supervisor.js +67 -33
- package/dist/response-system/engines/v1/proactive-flow.js +4 -0
- package/dist/trigger/application-service.js +4 -1
- package/dist/trigger/audit.js +19 -4
- package/dist/trigger/authorization.js +14 -5
- package/dist/trigger/event-source.js +4 -0
- package/dist/trigger/feedback.js +26 -2
- package/dist/trigger/history.js +176 -7
- package/dist/trigger/manager.js +1 -3
- package/dist/trigger/scheduler.js +81 -8
- package/dist/trigger/system-definitions.js +2 -2
- package/dist/trigger/validation.js +4 -0
- package/dist/utils/autostart.js +2 -2
- package/dist/utils/cross-platform.js +188 -12
- package/dist/utils/host-info.js +11 -8
- package/dist/utils/npm-ops.js +48 -0
- package/dist/utils/process-introspect.js +64 -1
- package/dist/utils/public-suffix.js +5811 -0
- package/dist/utils/startup-trace.js +160 -19
- package/dist/utils/windows-autostart.js +41 -7
- package/ecagent/dist/harness/env/nodejs.js +46 -2
- package/kits/docs/aun/ABILITY_CALLING.md +6 -6
- package/kits/docs/channels/aun.md +1 -1
- package/kits/docs/channels/feishu.md +2 -2
- package/kits/docs/context-assembly.md +20 -4
- package/kits/docs/evolcore/INDEX.md +5 -3
- package/kits/docs/evolcore/agent.md +2 -2
- package/kits/docs/evolcore/aid.md +8 -2
- package/kits/docs/evolcore/ctl.md +15 -5
- package/kits/docs/evolcore/directory.md +48 -15
- package/kits/docs/evolcore/group.md +8 -8
- package/kits/docs/evolcore/memory-consolidation.md +1 -1
- package/kits/docs/evolcore/menu-exec-schema-commands.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +32 -3
- package/kits/docs/evolcore/msg.md +38 -30
- package/kits/docs/evolcore/provider.md +57 -5
- package/kits/docs/evolcore/response.md +2 -2
- package/kits/docs/evolcore/thread-chain.md +11 -13
- package/kits/docs/evolcore/tool-authorization.md +17 -0
- package/kits/docs/evolcore/trigger.md +2 -2
- package/kits/docs/identity/ROLE_DETAIL.md +1 -1
- package/kits/docs/prompt-loading-architecture.md +30 -20
- package/kits/eck_manifest.auxiliary.json +5 -5
- package/kits/eck_manifest.json +44 -32
- package/kits/eck_manifest.memory.json +18 -18
- package/kits/eck_message_manifest.json +3 -3
- package/kits/rules/01-overview.md +1 -1
- package/kits/rules/06-channel.md +7 -8
- package/kits/schemas/_meta.json +7 -1
- 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/providers.schema.2.json +74 -0
- 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/aid-ability/SKILL.md +7 -7
- package/kits/skills/ec-agent-create/SKILL.md +1 -0
- 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 +3 -10
- package/kits/skills/ec-trigger/SKILL.md +9 -9
- package/kits/skills/ec-trigger/references/examples.md +1 -1
- package/kits/skills/thread-ops/SKILL.md +10 -10
- package/kits/templates/system-fragments/channel.md +5 -5
- package/kits/templates/system-fragments/commands.md +7 -6
- package/kits/templates/system-fragments/directory-contacts.md +10 -3
- package/kits/templates/system-fragments/personal-assistant.md +22 -3
- package/kits/templates/system-fragments/reply.md +48 -28
- package/kits/templates/system-fragments/session.md +3 -10
- package/kits/templates/system-fragments/thread.md +5 -5
- package/package.json +4 -4
|
@@ -21,6 +21,11 @@
|
|
|
21
21
|
"description": "进程级调试配置",
|
|
22
22
|
"x-merge": "dict",
|
|
23
23
|
"properties": {
|
|
24
|
+
"upmsg": {
|
|
25
|
+
"type": "boolean",
|
|
26
|
+
"default": true,
|
|
27
|
+
"description": "是否发送 durable 上线通知和 volatile 上下线通知;默认开启,false 时均不发送"
|
|
28
|
+
},
|
|
24
29
|
"eckSnapshots": {
|
|
25
30
|
"type": "boolean",
|
|
26
31
|
"default": false,
|
|
@@ -21,6 +21,11 @@
|
|
|
21
21
|
"description": "进程级调试配置",
|
|
22
22
|
"x-merge": "dict",
|
|
23
23
|
"properties": {
|
|
24
|
+
"upmsg": {
|
|
25
|
+
"type": "boolean",
|
|
26
|
+
"default": true,
|
|
27
|
+
"description": "是否发送 durable 上线通知和 volatile 上下线通知;默认开启,false 时均不发送"
|
|
28
|
+
},
|
|
24
29
|
"eckSnapshots": {
|
|
25
30
|
"type": "boolean",
|
|
26
31
|
"default": false,
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
"logLevel": { "type": "string", "enum": ["DEBUG", "INFO", "WARN", "ERROR"], "description": "daemon 日志级别" },
|
|
28
28
|
"aunTrace": { "type": "boolean", "description": "是否记录 AUN 协议 trace" },
|
|
29
29
|
"aunSdkLog": { "type": "boolean", "description": "是否启用 AUN SDK 调试日志" },
|
|
30
|
-
"upmsg": { "type": "boolean", "description": "
|
|
30
|
+
"upmsg": { "type": "boolean", "default": true, "description": "是否发送 durable 上线通知和 volatile 上下线通知;默认开启,false 时均不发送" },
|
|
31
31
|
"eckSnapshots": { "type": "boolean", "default": false, "description": "是否写入可能包含敏感上下文的 ECK 旁路调试快照" }
|
|
32
32
|
}
|
|
33
33
|
},
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
"logLevel": { "type": "string", "enum": ["DEBUG", "INFO", "WARN", "ERROR"], "description": "daemon 日志级别" },
|
|
26
26
|
"aunTrace": { "type": "boolean", "description": "是否记录 AUN 协议 trace" },
|
|
27
27
|
"aunSdkLog": { "type": "boolean", "description": "是否启用 AUN SDK 调试日志" },
|
|
28
|
-
"upmsg": { "type": "boolean", "description": "
|
|
28
|
+
"upmsg": { "type": "boolean", "default": true, "description": "是否发送 durable 上线通知和 volatile 上下线通知;默认开启,false 时均不发送" },
|
|
29
29
|
"eckSnapshots": { "type": "boolean", "default": false, "description": "是否写入可能包含敏感上下文的 ECK 旁路调试快照" }
|
|
30
30
|
}
|
|
31
31
|
},
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"$id": "providers.schema.2.json",
|
|
4
|
+
"title": "Providers (providers.json)",
|
|
5
|
+
"description": "域名稳定 Provider ID、旧 ID 兼容映射及公共接入参数。",
|
|
6
|
+
"x-logical-name": "providers",
|
|
7
|
+
"x-scope": "providers",
|
|
8
|
+
"type": "object",
|
|
9
|
+
"additionalProperties": false,
|
|
10
|
+
"required": ["$schema_version", "providers"],
|
|
11
|
+
"properties": {
|
|
12
|
+
"$schema_version": { "type": "integer", "const": 2, "default": 2, "x-merge": "scalar" },
|
|
13
|
+
"nextId": { "type": "integer", "minimum": 1, "maximum": 9007199254740991, "x-merge": "scalar" },
|
|
14
|
+
"aliases": {
|
|
15
|
+
"type": "object", "x-merge": "dict",
|
|
16
|
+
"propertyNames": { "$ref": "#/definitions/identifier" },
|
|
17
|
+
"additionalProperties": { "$ref": "#/definitions/identifier" }
|
|
18
|
+
},
|
|
19
|
+
"providers": {
|
|
20
|
+
"type": "object", "default": {}, "x-merge": "dict",
|
|
21
|
+
"propertyNames": { "$ref": "#/definitions/identifier" },
|
|
22
|
+
"additionalProperties": { "$ref": "#/definitions/provider" }
|
|
23
|
+
}
|
|
24
|
+
},
|
|
25
|
+
"definitions": {
|
|
26
|
+
"identifier": { "type": "string", "pattern": "^(?!(?:__proto__|prototype|constructor)$)[A-Za-z0-9_-]+$" },
|
|
27
|
+
"stringMap": {
|
|
28
|
+
"type": "object",
|
|
29
|
+
"propertyNames": { "not": { "enum": ["__proto__", "prototype", "constructor"] }, "pattern": "\\S" },
|
|
30
|
+
"additionalProperties": { "type": "string" }
|
|
31
|
+
},
|
|
32
|
+
"provider": {
|
|
33
|
+
"type": "object", "additionalProperties": false, "required": ["common"],
|
|
34
|
+
"properties": {
|
|
35
|
+
"name": { "type": "string" },
|
|
36
|
+
"domain": { "type": "string", "minLength": 1 },
|
|
37
|
+
"common": {
|
|
38
|
+
"type": "object", "additionalProperties": false, "required": ["baseUrl"],
|
|
39
|
+
"properties": {
|
|
40
|
+
"baseUrl": { "type": "string", "minLength": 1 },
|
|
41
|
+
"apiKey": { "type": "string" },
|
|
42
|
+
"headers": { "$ref": "#/definitions/stringMap" },
|
|
43
|
+
"queryParams": { "$ref": "#/definitions/stringMap" }
|
|
44
|
+
}
|
|
45
|
+
},
|
|
46
|
+
"services": {
|
|
47
|
+
"type": "object",
|
|
48
|
+
"propertyNames": { "allOf": [{ "$ref": "#/definitions/identifier" }, { "not": { "const": "auxiliary" } }] },
|
|
49
|
+
"additionalProperties": { "$ref": "#/definitions/service" }
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
},
|
|
53
|
+
"service": {
|
|
54
|
+
"type": "object", "additionalProperties": false,
|
|
55
|
+
"properties": {
|
|
56
|
+
"path": { "type": "string" },
|
|
57
|
+
"style": { "type": "string", "minLength": 1 },
|
|
58
|
+
"models": {
|
|
59
|
+
"type": "object",
|
|
60
|
+
"propertyNames": { "not": { "enum": ["__proto__", "prototype", "constructor"] }, "pattern": "\\S" },
|
|
61
|
+
"additionalProperties": {
|
|
62
|
+
"type": "object", "additionalProperties": false,
|
|
63
|
+
"properties": {
|
|
64
|
+
"enabled": { "type": ["boolean", "null"] },
|
|
65
|
+
"name": { "type": ["string", "null"] },
|
|
66
|
+
"imageIn": { "type": ["boolean", "null"] },
|
|
67
|
+
"manual": { "type": "boolean" }
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
@@ -23,12 +23,12 @@
|
|
|
23
23
|
"type": "object",
|
|
24
24
|
"additionalProperties": false,
|
|
25
25
|
"required": ["private", "group"],
|
|
26
|
-
"default": { "private": null, "group": null, "
|
|
26
|
+
"default": { "private": null, "group": null, "internalContact": "member" },
|
|
27
27
|
"description": "未显式分配角色时,私聊和群聊分别采用的默认角色;null 表示不自动授予角色。",
|
|
28
28
|
"properties": {
|
|
29
29
|
"private": { "type": ["string", "null"], "pattern": "^(?!owner$)[a-z0-9_-]+$", "default": null, "description": "私聊默认角色;必须已注册且不能为 owner。" },
|
|
30
30
|
"group": { "type": ["string", "null"], "pattern": "^(?!owner$)[a-z0-9_-]+$", "default": null, "description": "群聊默认角色;必须已注册且不能为 owner。" },
|
|
31
|
-
"
|
|
31
|
+
"internalContact": { "type": ["string", "null"], "pattern": "^(?!owner$)[a-z0-9_-]+$", "default": "member", "description": "同 Owner 内部 Agent 的私聊默认角色。未设置或 null 时独立默认为 member,不继承 private。必须已注册且不能为 owner。旧键名 paTeam 读取时迁移,不再写入。" }
|
|
32
32
|
},
|
|
33
33
|
"x-merge": "dict"
|
|
34
34
|
}
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"type": "boolean",
|
|
12
12
|
"enum": [true, false],
|
|
13
13
|
"default": true,
|
|
14
|
-
"description": "proactive 意图表达门禁(仅 chatmode=proactive 生效):每条新消息计数重置为 15,每轮结束后有意图表达成功则清零,否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行
|
|
14
|
+
"description": "proactive 意图表达门禁(仅 chatmode=proactive 生效):每条新消息计数重置为 15,每轮结束后有意图表达成功则清零,否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行 ecmsg send。WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不受门禁限制。",
|
|
15
15
|
"x-enumDescriptions": {
|
|
16
16
|
"true": "启用:开启意图表达门禁",
|
|
17
17
|
"false": "禁用:不启用意图表达门禁"
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"type": "boolean",
|
|
35
35
|
"enum": [true, false],
|
|
36
36
|
"default": true,
|
|
37
|
-
"description": "proactive 意图表达门禁(仅 chatmode=proactive 生效):每条新消息计数重置为 15,每轮结束后有意图表达成功则清零,否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行
|
|
37
|
+
"description": "proactive 意图表达门禁(仅 chatmode=proactive 生效):每条新消息计数重置为 15,每轮结束后有意图表达成功则清零,否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行 ecmsg send。WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不受门禁限制。",
|
|
38
38
|
"x-enumDescriptions": {
|
|
39
39
|
"true": "启用:开启意图表达门禁",
|
|
40
40
|
"false": "禁用:不启用意图表达门禁"
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
"type": "boolean",
|
|
13
13
|
"enum": [true, false],
|
|
14
14
|
"default": true,
|
|
15
|
-
"description": "proactive 意图表达门禁(仅 chatmode=proactive 生效):每条新消息计数重置为 15,每轮结束后有意图表达成功则清零,否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行
|
|
15
|
+
"description": "proactive 意图表达门禁(仅 chatmode=proactive 生效):每条新消息计数重置为 15,每轮结束后有意图表达成功则清零,否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行 ecmsg send。WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不受门禁限制。",
|
|
16
16
|
"x-enumDescriptions": {
|
|
17
17
|
"true": "启用:开启意图表达门禁",
|
|
18
18
|
"false": "禁用:不启用意图表达门禁"
|
|
@@ -32,7 +32,7 @@ allowed-tools: Read, Bash
|
|
|
32
32
|
内部字段,不要向用户索取、从自然语言猜测或写入 Ability 调用。具体设备路由遵循能力契约;
|
|
33
33
|
契约没有说明时不要自行推断。
|
|
34
34
|
- `ec ability` 用于管理本地 Provider 插件,不是远端调用接口。发现和调用远端 Provider 时,在 Provider 是当前 AUN 私聊对端的前提下,使用
|
|
35
|
-
`ec fs cat` 读取公开目录,并使用 `
|
|
35
|
+
`ec fs cat` 读取公开目录,并使用 `ecmsg send --payload` 发送协议消息。
|
|
36
36
|
- 每次工具调用仍遵守托管会话的单命令约束;不要把多个 `ec` 命令拼在一次 Shell 调用里。
|
|
37
37
|
|
|
38
38
|
## 2. 发现能力
|
|
@@ -73,10 +73,10 @@ ec fs cat <provider-aid>:/ability/skill/SKILL.md
|
|
|
73
73
|
按 Provider 协议带上 `call_id`、`operation_id` 和必需参数;`--timeout` 使用短等待时间:
|
|
74
74
|
|
|
75
75
|
```text
|
|
76
|
-
|
|
76
|
+
ecmsg send --to <provider-aid> --payload '<discover-json>' --encrypt yes --return required --timeout 5s --format json
|
|
77
77
|
```
|
|
78
78
|
|
|
79
|
-
在 Windows PowerShell 托管会话中,`<discover-json>` 也必须使用第 3 节规定的 `
|
|
79
|
+
在 Windows PowerShell 托管会话中,`<discover-json>` 也必须使用第 3 节规定的 `ecmsg`
|
|
80
80
|
转义形式;不要直接把未转义的 JSON 放进命令行。
|
|
81
81
|
|
|
82
82
|
不要因为 L2 没有返回就推断 Provider 内部没有设备;只能报告本次握手失败或超时。
|
|
@@ -140,17 +140,17 @@ Windows 或复杂 payload 优先用 `--payload-file`:先通过文件工具把
|
|
|
140
140
|
Git Bash 使用 `--payload-file "$TMPDIR/obs_payload.json"`。它与 `--payload`、位置文本和其他正文模式互斥;
|
|
141
141
|
daemon 在授权后读取并校验文件,仍需按下文选择目标设备和加密参数。
|
|
142
142
|
|
|
143
|
-
若使用 inline JSON,在当前 Windows PowerShell 托管环境中,调用 `
|
|
143
|
+
若使用 inline JSON,在当前 Windows PowerShell 托管环境中,调用 `ecmsg` 传 `--payload` 时,外层使用单引号,
|
|
144
144
|
并在 JSON 每个双引号前加一个反斜杠。该反斜杠用于命令行参数传递,不属于发给 Provider 的 JSON;
|
|
145
|
-
`
|
|
145
|
+
`ecmsg` 收到的最终参数必须是合法 JSON 对象。未转义的单引号 JSON 在此环境会被剥掉双引号,
|
|
146
146
|
导致消息发出前返回 `INVALID_ARGUMENT`。
|
|
147
147
|
|
|
148
148
|
```text
|
|
149
|
-
|
|
149
|
+
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}' --encrypt yes --return required --timeout <ttl-seconds>s --format json
|
|
150
150
|
```
|
|
151
151
|
|
|
152
152
|
上面是待填模板:按契约替换路径、ID、参数,`<ttl-seconds>` 按“时限估算”取值,
|
|
153
|
-
不得原样发送占位符。此转义形式针对当前 PowerShell 到 `
|
|
153
|
+
不得原样发送占位符。此转义形式针对当前 PowerShell 到 `ecmsg` 的调用链,不直接套用到其他 Shell。
|
|
154
154
|
|
|
155
155
|
新业务操作发送前生成唯一的 `operation_id` 和 `call_id`,按契约填完整 payload 并校验 JSON/schema,
|
|
156
156
|
然后只执行一条正式发送命令;不要发简化 payload 探测。
|
|
@@ -45,6 +45,7 @@ license: MIT
|
|
|
45
45
|
|
|
46
46
|
- 初始化必须显式提供 `--owner`、`--name`、`--description`、`--tags`。
|
|
47
47
|
`tags` 是标签的 JSON 数组;标签只含 Unicode 字母、数字和连字符,每项最长 50 字符。
|
|
48
|
+
- 需要固定推理服务商时可在初始化或 Bootstrap 创建命令中传 `--provider <id>`;该值必须支持所选 `--baseagent`。
|
|
48
49
|
- 缺少最终字段且要交由新 Agent 澄清时,显式选择 `--bootstrap`;默认模式不会自动降级。
|
|
49
50
|
- 两种模式互斥,均隐含非交互创建。`--non-interactive` 不改变默认初始化模式。
|
|
50
51
|
- persona 和头像可选;未提供时跳过,不为了这些可选项额外追加确认轮次。
|
|
@@ -34,22 +34,25 @@ license: MIT
|
|
|
34
34
|
群聊运行在 proactive 模式下,以 `[reply]` 段的实际 `chatMode` 为准:
|
|
35
35
|
|
|
36
36
|
- **直接输出不会进群**。它只是思考过程,前端能看见,但不会触发对端的消息接收,也不进其他 agent 的输入。
|
|
37
|
-
- **只有 `
|
|
37
|
+
- **只有 `ecmsg send` 的正文才会到达群里。**
|
|
38
38
|
|
|
39
39
|
命令语法只在此处完整写一遍,别处引用本节:
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
|
|
42
|
+
ecmsg send '<text>' --to <groupId> [选项] # 本端恒为会话本端,--from 可省略
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
| 选项 | 说明 |
|
|
46
46
|
|---|---|
|
|
47
|
-
| `--encrypt
|
|
47
|
+
| `--encrypt yes\|no\|auto` | 默认 `auto`:被对端消息触发时跟随该消息的加密状态,否则明文。要强制加密写 `yes` |
|
|
48
48
|
| `--mention '<aid1>,<aid2>'` | @ 成员。单引号包住、逗号分隔多个 aid,可重复传入 |
|
|
49
49
|
| `--mention-all` | @ 所有人 |
|
|
50
50
|
| `--file <path> [--as image\|video\|voice\|file]` | 发文件 |
|
|
51
51
|
| `--payload '<json>'` | 附加结构化数据 |
|
|
52
52
|
|
|
53
|
+
`--to` 就是目标群 AID。网关按本地关系记录判定它是群还是人,不靠 AID 字面形态;
|
|
54
|
+
在群会话里省略 `--to` 等价于发到当前群。
|
|
55
|
+
|
|
53
56
|
其它硬约束(同见 `[reply]` 段):
|
|
54
57
|
|
|
55
58
|
- 一次 shell 调用只跑一条完整的 `ec` 命令,不拼接管道、重定向或子 shell。
|
|
@@ -207,14 +210,14 @@ ec group rules <selfAid> <groupId> get [--format json]
|
|
|
207
210
|
其余一律回「群聊中不支持 /xxx」。所以 `/chatmode`、`/activity` 以及 `/model` 的切换、重置、审批等
|
|
208
211
|
写操作在群内都不可用,需要走私聊或管理界面。
|
|
209
212
|
|
|
210
|
-
注意:这条白名单拦的是**客户端发来的 slash 消息**。你用 `
|
|
213
|
+
注意:这条白名单拦的是**客户端发来的 slash 消息**。你用 `ecmsg send` 发出去的 `/xxx` 只是一段
|
|
211
214
|
普通文字,不走命令解析——想通过群消息间接执行 slash 是行不通的。
|
|
212
215
|
|
|
213
216
|
## 七、命令速查
|
|
214
217
|
|
|
215
218
|
```bash
|
|
216
219
|
# 发消息(唯一完整语法在第二节)
|
|
217
|
-
|
|
220
|
+
ecmsg send '<text>' --to <groupId> [--encrypt yes|no|auto] [--mention '<aid1>,<aid2>']
|
|
218
221
|
|
|
219
222
|
# 查上下文
|
|
220
223
|
ec group history <selfAid> <groupId> --limit 50 --format json
|
|
@@ -132,10 +132,10 @@ ec group rules <selfAid> <groupId> get --format json
|
|
|
132
132
|
|
|
133
133
|
### 当前就在目标群
|
|
134
134
|
|
|
135
|
-
|
|
135
|
+
使用目标群 AID 指定发送目标(本端恒为会话本端,`--from` 可省略):
|
|
136
136
|
|
|
137
137
|
```bash
|
|
138
|
-
|
|
138
|
+
ecmsg send '[A-001] 负责人:<implementerAid>;复核:<reviewerAid>。输入:<任务输入>。交付:/collab/A-001/。验收:<可验证的通过条件>。截止:<时间与时区>。请先回复 ACK,再按群规则汇报。' --to <groupId> --mention '<implementerAid>,<reviewerAid>' --encrypt yes
|
|
139
139
|
```
|
|
140
140
|
|
|
141
141
|
### 从私聊或其它群发起
|
|
@@ -148,14 +148,14 @@ ec thread create <groupId> --name 'Project Alpha 协作'
|
|
|
148
148
|
```
|
|
149
149
|
|
|
150
150
|
使用返回的裸话题 ID;已有合适话题就复用,不为每条消息重复创建。
|
|
151
|
-
发送时由话题推断身份和目标,`--check-every`
|
|
151
|
+
发送时由话题推断身份和目标,`--check-every` 可自定义,省略即默认 20m:
|
|
152
152
|
|
|
153
153
|
```bash
|
|
154
|
-
|
|
154
|
+
ecmsg send '[A-001] 负责人:<implementerAid>;复核:<reviewerAid>。输入:<任务输入>。交付:/collab/A-001/。验收:<可验证的通过条件>。截止:<时间与时区>。请先回复 ACK,再按群规则汇报。' --thread <threadId> --check-every 10m --mention '<implementerAid>,<reviewerAid>' --encrypt yes
|
|
155
155
|
```
|
|
156
156
|
|
|
157
|
-
|
|
158
|
-
|
|
157
|
+
示例用 `--encrypt yes` 强制密文。默认 `auto` 会跟随本次入站消息的加密状态;目标群明确要求密文时
|
|
158
|
+
不要依赖 `auto`,直接写 `yes`,也不要在不确定时擅自降为 `no`。
|
|
159
159
|
一次 shell 调用只执行一条完整发送命令,不拼接管道、重定向、子 shell 或其它命令。
|
|
160
160
|
|
|
161
161
|
保存回执中的 `trigger_id` 和消息 ID。发送后由目标话题继续处理,不在来源会话阻塞等待。
|
|
@@ -217,7 +217,7 @@ ec trigger delete <trigger_id>
|
|
|
217
217
|
| 邀请发出但成员未加入 | 等待目标 Owner 审核,核对成员状态,不直接分派任务 |
|
|
218
218
|
| `file_mismatch` | 核对当前规则内容,确认是预期版本后由有权限者发布 |
|
|
219
219
|
| 规则过大或编码无效 | 压缩至 4 KiB 内的 UTF-8 入口规则,其它资料另存 |
|
|
220
|
-
| `
|
|
220
|
+
| `TOPIC_NOT_FOUND` / `INVALID_THREAD_REF` | 先定位真实话题(`ec thread list`),再带正确的 `--thread`;`ecmsg` 跨话题会自行补复查,不用写 `--check-every` |
|
|
221
221
|
| 消息已发出但复查未创建 | 记录回执错误,按 `thread-ops` 补跟进,不重发原任务 |
|
|
222
222
|
|
|
223
223
|
## 参考
|
|
@@ -114,6 +114,9 @@ restart / reload 按 runtime.mode 执行:managed 经其 supervisor 或内部
|
|
|
114
114
|
|
|
115
115
|
## 监听与守护
|
|
116
116
|
|
|
117
|
+
- EvolCore 核心就绪与服务健康分开判定;ECWeb 尚未就绪或恢复失败不会使已就绪的 daemon 启动失败。正常启动、重启与核心 IPC 超时兜底不等待 ECWeb 协议握手。
|
|
118
|
+
- 服务启动等待由 `health.startupTimeoutMs` 决定,默认 45 秒,不沿用 CLI 的 30 秒核心启动等待。ECWeb 同样采用此预算,并读取 `health.failureThreshold` 和 `health.timeoutMs`;为核验实例身份,其存活探针固定使用 `/api/health`,不使用自定义路径。
|
|
119
|
+
- ECWeb 存活与其连接 daemon 的协议就绪分开:身份匹配的存活实例不会仅因 daemon 握手尚未完成而被反复重启。核心确实启动失败时,重启监控仍会安全清理遗留的 ECWeb,避免回滚后重复启动。
|
|
117
120
|
- 运行状态周期检查进程和配置的 HTTP/TCP 健康探针,默认连续失败 3 次才触发恢复,成功一次清零连续失败数。
|
|
118
121
|
- TCP 启动中每 500 ms、运行中每 10 秒检查;HTTP 启动中每 1 秒、运行中每 15 秒检查,频率固定。
|
|
119
122
|
- managed 服务在 15 分钟内最多自动重试 3 次,默认等待 5、10、20 秒;仅 backoffMs 可调整初始等待。
|
|
@@ -125,16 +128,6 @@ restart / reload 按 runtime.mode 执行:managed 经其 supervisor 或内部
|
|
|
125
128
|
- 主动 stop 或 disabled 的服务不会被后台重新启动。
|
|
126
129
|
- managed 服务的进程只会按 supervisor 写入的 PID 和启动时间记录管理;不要建议按端口强杀进程。
|
|
127
130
|
|
|
128
|
-
### 端口冲突与状态判读
|
|
129
|
-
|
|
130
|
-
- 普通 managed 服务启动前先核对实例记录与端口。只有 PID、启动时间和配置匹配才复用现存实例;未知端口占用者不接管、不终止,也不消耗自动重试额度。
|
|
131
|
-
- 配置改变需替换旧实例时,先确认旧进程退出。停止超时或身份无法核验时保留 PID 与记录,拒绝启动替代进程,不把 stop/restart 报为成功。
|
|
132
|
-
- 实例启动后先登记 `starting`,健康检查通过才更新为 `ready`;代理发现不发布尚未就绪的 supervisor 实例。
|
|
133
|
-
- `runtime.state` 表示管理状态,`endpointHealth` 表示端点探测结果,`processOwnership` 表示受管归属。`failed + healthy + unknown` 表示端点可响应但未被安全接管,不等于服务已宕机。
|
|
134
|
-
- `endpointOwnerPids` 列出冲突监听者;`lastErrorCode` 与 `lastError` 保留原始失败原因,`recoveryState=blocked/exhausted` 分别表示恢复受阻或额度耗尽。不要仅凭 HTTP 200 认定身份或代理链路已验证。
|
|
135
|
-
- 端口冲突期间仍低频探测;冲突解除且自动恢复已开启时重新对账启动。关闭自动恢复或主动 stop 后不会自动拉起。
|
|
136
|
-
- `logs/services/<name>.log` 保留原始 stdout/stderr,并增加带时间戳、服务名、启动批次和 PID 的生命周期 JSON 标记;原始输出行不保证逐行带时间戳,按批次关联,不能据此强行做逐行时间统计。
|
|
137
|
-
|
|
138
131
|
变更后用 ec proxy status <name> 复核 desired 配置、进程健康和代理登记状态。写操作返回失败时读取
|
|
139
132
|
具体错误码处理;不要重复发送不确定的 start/restart 操作。
|
|
140
133
|
|
|
@@ -21,7 +21,7 @@ license: MIT
|
|
|
21
21
|
|---|---|
|
|
22
22
|
| "明天早上 9 点提醒我带合同" | 一次 `--at` 或单次 cron,**trigger-session**,投递到用户的会话 |
|
|
23
23
|
| "以后每天 9 点给我出昨日总结" | `--cron '0 9 * * *' --tz Asia/Shanghai`,**trigger-session**,投递用户会话 |
|
|
24
|
-
| "帮我把这个任务跟到底,对方回了我马上告诉我" | 跨话题委托时用 `
|
|
24
|
+
| "帮我把这个任务跟到底,对方回了我马上告诉我" | 跨话题委托时用 `ecmsg send --thread <话题id> --check-every`,**不要自建 trigger**(见 thread-ops) |
|
|
25
25
|
| "每 30 分钟看一眼升级有没有新版本" | `--every 30m`,**trigger-session**,提示词写"无变化只输出 `[[NOOP]]`",加 `--max-runs` |
|
|
26
26
|
| "任务失败就自动继续 / 出错误告诉我" | `--event 'task:error'` 或 `--event 'message:received' --event-filter ...` |
|
|
27
27
|
| "帮我盯着这个会话,闲下来时看看有没有漏掉的事" | 这是会话 loop,`/loop 300`(事件 `session:idle`),**不是**普通 trigger |
|
|
@@ -35,7 +35,7 @@ license: MIT
|
|
|
35
35
|
|
|
36
36
|
| 类型 | 谁在执行 | 用在哪 | 坑 |
|
|
37
37
|
|---|---|---|---|
|
|
38
|
-
| `trigger-session` | daemon 专属的 trigger 会话,**与用户对话隔离** | 周期巡检、生成摘要、独立判断。默认同 trigger 复用一条会话 |
|
|
38
|
+
| `trigger-session` | daemon 专属的 trigger 会话,**与用户对话隔离** | 周期巡检、生成摘要、独立判断。默认同 trigger 复用一条会话 | 只有它支持 `--baseagent`;`--trigger-thread per-run` 每次都开新会话 |
|
|
39
39
|
| `target-session` | 把提示词**当成一条消息**投进目标会话,由那个会话的 agent 处理 | 要在用户的对话里、带着上下文做的事;跨话题复查(`--check-every`) | 不支持 `feedback=silent`;目标会话被占用会等/冲突;也**不支持** `execution.thread` |
|
|
40
40
|
| `script` | 确定性脚本,不过模型 | 只看数、查文件、调 IPC、算东西——**不需要模型判断**时优先用,又快又便宜 | 走沙箱,脚本不能读受保护路径;宿主执行要求独立批准 |
|
|
41
41
|
|
|
@@ -72,8 +72,8 @@ ec trigger create --cron '0 9 * * *' --tz Asia/Shanghai \
|
|
|
72
72
|
1. **边界**:短期跟进的周期 trigger 加 `--max-runs` 或 `--max-duration`。到上限自动 `disable`
|
|
73
73
|
(定义留着、可查),不会删。无限周期的巡检只留给用户明确要求"一直跑"的场景。
|
|
74
74
|
2. **NOOP**:周期任务有"没事可报"的情况,提示词里写死"无异常时**只输出** `[[NOOP]]`"。
|
|
75
|
-
|
|
76
|
-
|
|
75
|
+
**整段输出必须恰好是 `[[NOOP]]`**(前后不能有其它文字,结尾换行没关系),否则结果照样
|
|
76
|
+
投递,模型还会额外对着用户说一圈废话。
|
|
77
77
|
3. **复核**:建完立刻 `ec trigger show <id> --json` 看三样:`enabled`、`feedback.target`、
|
|
78
78
|
`schedule.nextFireAt`(cron 看得到下次触发时刻;与预期不符就是时区/表达式问题)。
|
|
79
79
|
改定义一律带 `--if-revision <show 返回的 revision>`,改完再看 revision 变了没有。
|
|
@@ -91,8 +91,8 @@ ec trigger create --cron '0 9 * * *' --tz Asia/Shanghai \
|
|
|
91
91
|
- **投递失败只重发结果,不重跑任务**:`effects` 里才是真实投递记录;状态 `failed` 不代表
|
|
92
92
|
用户没收到。排查时看 `history` 里的 `effects`。
|
|
93
93
|
- **你被 trigger 唤醒时**:信封里的 `触发于:` 是排定时刻(firedAt),不是唤醒时刻;
|
|
94
|
-
proactive 模式下正文流式输出会被丢弃,**回复必须走 `
|
|
95
|
-
|
|
94
|
+
proactive 模式下正文流式输出会被丢弃,**回复必须走 `ecmsg send`**;`[[NOOP]]` 仍适用,
|
|
95
|
+
只用它、别在它前后多说一句。
|
|
96
96
|
- **提示词里能用的变量**:`{{trigger.name}}`、`{{run.number}}`(第几次)、`{{run.elapsed}}`、
|
|
97
97
|
`{{date}}`、`{{time}}`,事件触发另有 `{{event.<字段>}}`。提示词正文走同一套渲染。
|
|
98
98
|
- **每次创建都是新 trigger**:重复建同一个提醒会得到多个 trigger,各自都会触发。先 `list` 查。
|
|
@@ -138,13 +138,13 @@ ec trigger create --event 'task:error' \
|
|
|
138
138
|
1. 不用 trigger 代替当前会话里立刻能做的事。
|
|
139
139
|
2. **默认**不给无上限的周期任务;用户明说长期跑,或任务本身长期有效(如每日简报)才可省略,
|
|
140
140
|
并在建之前说明"这条会一直跑到被删"。
|
|
141
|
-
3. 不在提示词里写主动发消息的命令(`
|
|
141
|
+
3. 不在提示词里写主动发消息的命令(`ecmsg send`)——结果会被**再投递一次**,
|
|
142
142
|
用户收到两遍。让模型只产出正文。
|
|
143
143
|
4. 不用 `--agent` 去操作别的 agent 的 trigger(托管会话里很容易被拒)。
|
|
144
144
|
5. 不直接读 `trigger.json`、`scripts/*`、`data/`、`AIDs/` 这类受保护路径——沙箱按 H 类拦截,
|
|
145
145
|
脚本会直接启动失败。
|
|
146
146
|
6. 提示词超过 4096 字符用 `--prompt-file`,不要硬塞。
|
|
147
|
-
7. 群聊里不要用 `--mention` 去 @ 人做提醒——`
|
|
147
|
+
7. 群聊里不要用 `--mention` 去 @ 人做提醒——`ecmsg send` 和 trigger 提示词不共享参数;
|
|
148
148
|
要在群里点名,写进目标会话的提示词里,或让 target-session 在群里自己 @。
|
|
149
149
|
|
|
150
150
|
## 九、排查手册
|
|
@@ -154,7 +154,7 @@ ec trigger create --event 'task:error' \
|
|
|
154
154
|
| 根本没触发 | `show --json` 的 `nextFireAt`、`recentRuns`;`list --all` | 被 disable、cron 表达式/时区错、一次性已跑完、上限已命中 |
|
|
155
155
|
| 触发了但没送到 | `history` 的 `effects` / `feedback` | target 路由写错、AUN 缺 chatType、渠道未配置 |
|
|
156
156
|
| 发到了错的会话 | `show --json` 的 `feedback.target` / `origin` | 在话题里建但用了 target、目标会话不存在被新建 |
|
|
157
|
-
| 用户收到一堆废话 | run 状态 `completed` 但内容很啰嗦 | `[[NOOP]]`
|
|
157
|
+
| 用户收到一堆废话 | run 状态 `completed` 但内容很啰嗦 | `[[NOOP]]` 没独占整段输出 |
|
|
158
158
|
| 每次跑很久/堆任务 | `show --json` 的 `active`;`history` | 周期比执行时间短,queue 串行排队;concurrency 设为 forbid |
|
|
159
159
|
| 脚本报沙箱不可用 | 脚本路径/项目路径 | 受保护路径,或宿主未准备沙箱 |
|
|
160
160
|
| 手动跑有效、定时没效 | `history` 时间线 | 错过策略、daemon 停机、时区 |
|
|
@@ -146,7 +146,7 @@ trigger-session 生成正文后由目标会话自己发文件:
|
|
|
146
146
|
|
|
147
147
|
## 6. 跨话题复查(只有懂这个形状才手写)
|
|
148
148
|
|
|
149
|
-
正常用 `
|
|
149
|
+
正常用 `ecmsg send '...' --thread <T2> --check-every 5m` 生成,不要手写。要点:
|
|
150
150
|
|
|
151
151
|
- `labels.kind = "cross-thread-review"` 决定投递身份取**目标话题自身**的对端,而不是来源对端。
|
|
152
152
|
- 只支持 `target_session`,`feedback.target.session = "thread"` 且带 `threadId`。
|
|
@@ -30,7 +30,7 @@ license: MIT
|
|
|
30
30
|
|
|
31
31
|
### 四条反直觉的语义
|
|
32
32
|
|
|
33
|
-
- **发出即结束**:`
|
|
33
|
+
- **发出即结束**:`ecmsg send --thread T2` 返回后当前 turn 立刻终止,不阻塞等回复。
|
|
34
34
|
- **复查是唤醒信号,不是执行脚本**:到期只投递一条通知,不保证对端已回,不携带操作命令。
|
|
35
35
|
- **决策权在自己**:要不要回、何时回、回什么,全自主。
|
|
36
36
|
- **无"等齐"原语**:想等多方回复,就在各自 turn 里用 `ec thread history` 主动读另一话题。
|
|
@@ -61,10 +61,10 @@ license: MIT
|
|
|
61
61
|
```bash
|
|
62
62
|
# 1. 找或建与 C 的话题
|
|
63
63
|
ec thread list <C的AID>
|
|
64
|
-
ec thread create <C的AID> --name '项目进度查询' #
|
|
64
|
+
ec thread create <C的AID> --name '项目进度查询' # 没有合适话题时;返回 thread-… 形式的 threadId
|
|
65
65
|
|
|
66
|
-
# 2. 发消息,--check-every
|
|
67
|
-
|
|
66
|
+
# 2. 发消息,--check-every 一步搞定复查(跨话题可自定义:5m / 30m / 2h / 1d,省略即 20m)
|
|
67
|
+
ecmsg send '项目当前进度如何?' --thread <threadId> --check-every 5m
|
|
68
68
|
|
|
69
69
|
# 3. 本 turn 结束,不阻塞
|
|
70
70
|
```
|
|
@@ -78,7 +78,7 @@ ec msg send '项目当前进度如何?' --thread <裸threadId> --check-every 5
|
|
|
78
78
|
你收到的是**普通消息**,不带话题链注入(上下文只注入在发送方的目标话题里)。处理完自行决定回不回:
|
|
79
79
|
|
|
80
80
|
```bash
|
|
81
|
-
|
|
81
|
+
ecmsg send '进度 70%,预计下周完成' # 不带 --thread,发在当前话题
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
同话题追问也不带 `--thread`,同样不建复查。
|
|
@@ -104,7 +104,7 @@ ec thread history <来源话题id> --after <发送于的时间戳>
|
|
|
104
104
|
```bash
|
|
105
105
|
ec trigger delete <trig_id> # 完成:删除,不留残留
|
|
106
106
|
ec trigger update <trig_id> --every 30m # 放宽
|
|
107
|
-
|
|
107
|
+
ecmsg send 'C 回复:进度 70%' --thread <来源threadId> --check-every 30m # 汇报(跨话题,省略即默认 20m)
|
|
108
108
|
```
|
|
109
109
|
|
|
110
110
|
**关键点**:
|
|
@@ -117,10 +117,10 @@ ec msg send 'C 回复:进度 70%' --thread <来源threadId> --check-every 30m
|
|
|
117
117
|
### D. 并发委托多方
|
|
118
118
|
|
|
119
119
|
```bash
|
|
120
|
-
|
|
121
|
-
|
|
120
|
+
ecmsg send '技术评估' --thread <T2> --check-every 10m
|
|
121
|
+
ecmsg send '产品评估' --thread <T3> --check-every 10m
|
|
122
122
|
# 之后在每个先到的 turn 里,用 ec thread history 读另一话题,齐了再合并回 T1
|
|
123
|
-
|
|
123
|
+
ecmsg send '综合评估:……' --thread <T1> --check-every 30m
|
|
124
124
|
```
|
|
125
125
|
|
|
126
126
|
### E. 查询与维护命令
|
|
@@ -178,7 +178,7 @@ ec thread summary show <threadId>
|
|
|
178
178
|
|
|
179
179
|
**不要**:
|
|
180
180
|
1. 发完阻塞等回复——turn 已结束,回复会触发新 turn。
|
|
181
|
-
2.
|
|
181
|
+
2. 以为省略 `--check-every` 就不建复查——跨话题一律自动建复查(缺省 20m),不需要时用回执里的 `trigger_id` 执行 `ec trigger delete`。
|
|
182
182
|
3. 托管会话里手写 `from/to`。
|
|
183
183
|
4. 把复查通知当"强制回复"或执行脚本。
|
|
184
184
|
5. 在复查 turn 里再 `--check-every`(会套娃)。
|
|
@@ -14,14 +14,14 @@ capabilities: {{capabilities}} # 当前渠道支持的能力
|
|
|
14
14
|
{{/}}
|
|
15
15
|
{{?channel=aun}}
|
|
16
16
|
{{?groupId}}
|
|
17
|
-
|
|
18
|
-
|
|
17
|
+
ecmsg send '<text>' [--file <path> --as image|video|voice|file] [--payload '<json>'] [--mention '<aid1>,<aid2>'] [--mention-all]
|
|
18
|
+
群聊会话下 `ecmsg send` 即群内公开发送,无需写群 AID。
|
|
19
19
|
{{/}}
|
|
20
20
|
{{?peerId}}
|
|
21
|
-
|
|
22
|
-
|
|
21
|
+
ecmsg send '<text>' [--text-from-file <path>] [--encrypt yes|no|auto] [--file <path> --as image|video|voice|file] [--link <url> --title '<title>'] [--payload '<json>' --return none|required --timeout <duration> --format json]
|
|
22
|
+
`ecmsg send` 在 proactive/paactive 下是正式回复;interactive 下普通回复直接输出,只在需要文件、链接或手动控制加密时才用。paactive 的普通模型文本由框架投影为 activity。
|
|
23
23
|
当用户想获取、读取、查询或汇总属于某个主体的数据时,无论主体通过“我/你”、姓名、关系称谓还是 AID 指代,都先依据当前关系层、明确 AID 或可靠身份/联系人信息确认主体是谁并解析到准确 AID;姓名不明或有歧义时才询问。必要时加载 `ec-identity` 解析姓名。随后加载内置技能 `aid-ability`,检查该主体 AID 是否发布了匹配的数据能力;数据类型和来源不设限。若数据由关联设备或服务提供,只能依据能力索引或可信身份信息确认对应 Provider AID,不得猜测。
|
|
24
|
-
用户要求发现或调用其他 AID 的能力时使用 `aid-ability`。用户要求给当前 Agent/主机添加、开发、安装、启用、发布、下架、升级或诊断本端插件时使用 `ec-ability`。仅出现 `ability` 等术语不足以判定要调用远端能力;按用户要做的事分流。若用户只询问远端调用流程/可行性或明确要求不要执行,只说明身份解析、能力发现与调用步骤,不读取索引、不调用能力。实际调用时不要猜测能力路径或参数:读取目标 AID 的能力索引,必要时执行在线发现,再按结构化契约构造原始 JSON。需要结果时使用 `
|
|
24
|
+
用户要求发现或调用其他 AID 的能力时使用 `aid-ability`。用户要求给当前 Agent/主机添加、开发、安装、启用、发布、下架、升级或诊断本端插件时使用 `ec-ability`。仅出现 `ability` 等术语不足以判定要调用远端能力;按用户要做的事分流。若用户只询问远端调用流程/可行性或明确要求不要执行,只说明身份解析、能力发现与调用步骤,不读取索引、不调用能力。实际调用时不要猜测能力路径或参数:读取目标 AID 的能力索引,必要时执行在线发现,再按结构化契约构造原始 JSON。需要结果时使用 `ecmsg send --to <AID> --return required`;它会按 `--timeout`(默认 60s,最大 3600s)使用 AUN volatile 非持久消息。等待超时后用 `ec msg request get` 查询,不要自动重发。`message_id` 只表示传输 ACK,不表示能力执行完成。
|
|
25
25
|
{{/}}
|
|
26
26
|
每次调用仍须遵守 `[reply]` 的单条命令及加密要求。
|
|
27
27
|
{{/}}
|