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
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
# ec ctl — 当前会话工具
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
在**当前托管会话**中向本会话发送文件、重命名、管理队列,以及查询项目路径和会话状态。
|
|
4
|
+
发消息用 `ecmsg send`(见 `msg.md`)。
|
|
4
5
|
|
|
5
6
|
> ctl 命令通过 IPC 转发给 daemon,仅在 evolcore 托管环境中可用(依赖 `EVOLCORE_SESSION_ID`)。
|
|
6
7
|
|
|
@@ -21,21 +22,30 @@ H 类拒绝保留 `policyCode=h_class_protection`、`executed=false` 和原始
|
|
|
21
22
|
取消则另记 `cancelled`、`abortSource`;若拒绝与取消同时发生,两种事实均保留。
|
|
22
23
|
预期中断不发送普通错误或旧任务的最终回复,但原始会话及 runner 诊断仍保留工具结果和关闭流后的丢弃事件计数。
|
|
23
24
|
|
|
25
|
+
## 闲置触发(聊天斜杠命令)
|
|
26
|
+
|
|
27
|
+
- `/loop`:查看持久开关及待执行的单次提示词;回显为单行,不显示会话 ID。
|
|
28
|
+
- `/loop on [seconds]`:开启持久闲置触发,默认 300 秒,可设 30–86400 秒;每次普通任务结束后重新计时。
|
|
29
|
+
- `/loop <提示词>`:当前会话连续闲置 300 秒后执行提示词一次,不立即提交模型,也不修改持久开关。
|
|
30
|
+
- 新的单次提示词替换上一条待执行提示词;已有任务运行或新任务到达时,从任务结束后重新计时。
|
|
31
|
+
- `/loop off`:关闭持久触发并取消尚未入队的单次提示词;已经开始的任务不受影响。
|
|
32
|
+
- 持久开关按主会话 `relation-main` / 独立话题 `topic-session` 存储;单次请求始终只绑定发起时的确切会话。
|
|
33
|
+
- 单次请求保留原请求者和加密方式,执行时重新校验权限,不继承单次 `/fa` 提权;会话删除或替换后不转投新会话。
|
|
34
|
+
- 单次请求最多入队一次,入队失败不重发;已入队任务由原任务恢复机制处理,不另起一次任务。
|
|
35
|
+
|
|
24
36
|
## 会话名称
|
|
25
37
|
|
|
26
38
|
```bash
|
|
27
39
|
ec ctl name <新名称>
|
|
28
40
|
```
|
|
29
41
|
|
|
30
|
-
##
|
|
42
|
+
## 文件
|
|
31
43
|
|
|
32
44
|
```bash
|
|
33
|
-
ec ctl send '<text>' # 主动发送文本(proactive 模式)
|
|
34
45
|
ec ctl file [channel] <path> # 发送项目内文件
|
|
35
46
|
```
|
|
36
47
|
|
|
37
|
-
>
|
|
38
|
-
> `ec ctl send` 只在拿不到自己的 AID 时兜底——它自动继承当前会话的 AID 和对端。
|
|
48
|
+
> 发消息用 `ecmsg send`(见 msg.md)。`ec ctl` 只负责本表所列的会话工具。
|
|
39
49
|
|
|
40
50
|
## 消息队列
|
|
41
51
|
|
|
@@ -13,7 +13,7 @@ Agent 侧可以查询或向 Owner 发送入录申请,不能直接增删名录
|
|
|
13
13
|
命令与 `ec skill` 对齐:**`list` 列举/过滤,`info` 看单条详情**。
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
|
-
ec directory list [<关键词>...] [--filter '<kw1,kw2>']... [--type <type>] [--scope internal|external|all] [--owner <aid|unbound>] [--limit <n>] [--page <n>] [--format json]
|
|
16
|
+
ec directory list [<关键词>...] [--filter '<kw1,kw2>']... [--type <type>] [--scope internal|external|pa-team|all] [--owner <aid|unbound>] [--limit <n>] [--page <n>] [--format json]
|
|
17
17
|
ec directory info <contact-aid|名字> [--limit <n>] [--format json]
|
|
18
18
|
ec directory refresh [--format json]
|
|
19
19
|
ec directory blocked [--format json]
|
|
@@ -58,9 +58,13 @@ Evol App 中处理该申请,并把目标加入联系人名录、允许本 Agen
|
|
|
58
58
|
多个 `--filter` 之间为 AND**;
|
|
59
59
|
- 位置参数(`list 张三 采购`):保留旧 `find` 的语义,多个词**同时命中**(AND)。
|
|
60
60
|
|
|
61
|
-
其它过滤:`--type`、`--scope internal|external|all`(默认 `all
|
|
61
|
+
其它过滤:`--type`、`--scope internal|external|pa-team|all`(默认 `all`;`pa-team`
|
|
62
|
+
只列 `open_pa_context` 里且已核验的成员)、
|
|
62
63
|
`--owner <aid|unbound>`(按条目归属过滤,`unbound` 只列没有 `owner_aid` 的条目)。
|
|
63
64
|
|
|
65
|
+
**黑名单**:`blocked_aids` 里的主体不会出现在注入的 `directory.md` 里,也不该被
|
|
66
|
+
主动联系;名单本身用 `ec directory blocked` 查。
|
|
67
|
+
|
|
64
68
|
**分页**:默认每页 20 条,上限 100。`--limit` / `--page` 可调;JSON 结果带
|
|
65
69
|
`page` / `limit` / `total` / `hasMore`。
|
|
66
70
|
|
|
@@ -184,22 +188,51 @@ updated_at: <unix 秒>
|
|
|
184
188
|
|
|
185
189
|
### 备注怎样体现在注入内容里
|
|
186
190
|
|
|
187
|
-
`directory.md`
|
|
191
|
+
`directory.md` 按**注意力预算**分层:谁需要被认真读(载描述),谁只需要认得名字。
|
|
192
|
+
|
|
193
|
+
行形态有三种:
|
|
188
194
|
|
|
189
195
|
| 形态 | 内容 | 用于 |
|
|
190
196
|
|---|---|---|
|
|
191
|
-
| `full` | 名字 \| AID \| 类型 \| 备注名 \| 描述 \| 备注:… |
|
|
192
|
-
| `
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
197
|
+
| `full` | 名字 \| AID \| 类型 \| 备注名 \| 描述 \| 备注:… | PA Team |
|
|
198
|
+
| `name_with_aid` | 名字 \| 备注名 \| AID | 内部联系人(PA Team 之外) |
|
|
199
|
+
| `name_no_aid` | 名字 \| 备注名 | 外部 Agent / 外部人类 / 加入的群 / 其他 / 白名单 |
|
|
200
|
+
|
|
201
|
+
### 八个分组
|
|
202
|
+
|
|
203
|
+
| 顺序 | 分组 | 判据 | 形态 |
|
|
204
|
+
|---|---|---|---|
|
|
205
|
+
| 固定 | Owner / 个人助理 / 我 | 顶层身份块 + 自己 | 名字 \| 备注名 \| AID |
|
|
206
|
+
| 1 | **PA Team** | `aid ∈ open_pa_context` 且 `ownership_status=owned` | `full` |
|
|
207
|
+
| 2 | 内部联系人(其余) | 内部且不在 PA Team | `name_with_aid` |
|
|
208
|
+
| 3 | 外部 Agent | `classifyEntry` = `external_agent` | `name_no_aid` |
|
|
209
|
+
| 4 | 外部人类 | `classifyEntry` = `external_human` | `name_no_aid` |
|
|
210
|
+
| 5 | 加入的群 | `type=group` | `name_no_aid` |
|
|
211
|
+
| 6 | 其他 | 类型未知 / 归属未核实 / 无 owner | `name_no_aid`,附「不要主动联系」 |
|
|
212
|
+
| 7 | 白名单 | `allowedAids` 命中且不在 1–6 组 | `name_no_aid` |
|
|
213
|
+
|
|
214
|
+
**PA Team 判据**:服务端在 `contacts.json` 顶层下发 `open_pa_context`(AID 数组)。
|
|
215
|
+
判据是**这个列表**,不再看 `exttype` 前缀。成员必须同时满足 `ownership_status=owned`,
|
|
216
|
+
否则落到「其他」组——进了列表不等于绕过归属核验。
|
|
217
|
+
|
|
218
|
+
- 列表里出现但 `entries` 中不存在的 AID 会被丢弃并记 WARN(团队清单先于名录同步时
|
|
219
|
+
两边短暂不一致,不能因此报错)。
|
|
220
|
+
- **PA Team 最多加载 100 人**:前 100 人按 `full` 渲染,超出部分降级为 `name_no_aid`
|
|
221
|
+
单列,并在组提示里写明「当前加载 N 人,其余 M 人仅列名」。
|
|
222
|
+
|
|
223
|
+
**内部联系人(其余)**是 PA Team 的兜底分支:默认配置下所有内部 owned 成员都在
|
|
224
|
+
PA Team 里,该组为空、不渲染;Owner 手动把某人移出团队清单后,他才出现在这里。
|
|
225
|
+
|
|
226
|
+
**白名单**是**准入控制清单**,不是联系人分组:命中的主体本来就能入站,这里只是让 PA
|
|
227
|
+
知道"有这么个通道"。因此白名单成员可能**根本不在联系人清单里**——那种情况下只给名字,
|
|
228
|
+
不展示 AID 与描述。与 1–6 组去重,一个人只出现一次。
|
|
229
|
+
|
|
230
|
+
**其他组**:`type` 不在协议 8 种之内(如 `ai`)、`type=agent` 但 `ownership_status !== 'owned'`、
|
|
231
|
+
或没有 `owner_aid` 的条目。只注入名字与备注名,不展示 AID、类型与描述,并明确提示
|
|
232
|
+
“不要主动联系”。完整字段用 `ec directory list` 现查。
|
|
233
|
+
|
|
234
|
+
**降级**:任一分组超预算时,`full` 行降级为两列、`name_with_aid` 行去掉 AID,
|
|
235
|
+
仍放不下才从尾部整行省略,并汇总一行「其余 N 条已省略」。
|
|
203
236
|
|
|
204
237
|
## 输出与错误
|
|
205
238
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
群聊场景下收发消息、管理群与成员。触发词:群发/建群/邀请/踢人/退群/群成员/群聊协作/分工/任务分派。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**发消息统一用 `ecmsg send`**(本端恒为当前会话本端,群目标用 `--to <群AID>`)。本页其余 `ec group` 命令用于群管理;宿主终端场景下它们也承担发送。
|
|
6
6
|
|
|
7
7
|
本命令覆盖常用消息、基础生命周期、成员操作、角色/群主管理、封禁、屏蔽、成员状态、暂停/恢复和群规则。生产环境 agent 优先使用本页列出的 `ec group` 命令。
|
|
8
8
|
|
|
@@ -15,13 +15,13 @@
|
|
|
15
15
|
|
|
16
16
|
```bash
|
|
17
17
|
# 文本(含空格/换行/特殊字符时用引号包起来;纯短词可不包,但多空格会被压成一个)
|
|
18
|
-
|
|
18
|
+
ecmsg send '<text>' [--encrypt yes|no|auto] # 在群会话里即群内公开发送
|
|
19
19
|
|
|
20
20
|
# 文件(--as image|video|voice|file)
|
|
21
|
-
|
|
21
|
+
ecmsg send --file <path> [--as <type>] [--text '<说明>']
|
|
22
22
|
|
|
23
23
|
# 自定义 payload
|
|
24
|
-
|
|
24
|
+
ecmsg send --payload '<json>'
|
|
25
25
|
|
|
26
26
|
# 查询本地群历史(只读,不调用 Gateway,不推进 group pull/ack 游标)
|
|
27
27
|
ec group history <from> <group-id> [--limit <N>] [--thread <main|all|id>] [--format json]
|
|
@@ -38,13 +38,13 @@ ec group ack <from> <group-id> <seq> [--app <name>]
|
|
|
38
38
|
- `--mention-all` — @ 所有人
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
|
-
|
|
42
|
-
|
|
41
|
+
ecmsg send '@bob 看下 PR' --mention 'bob.agentid.pub'
|
|
42
|
+
ecmsg send '通知' --mention 'alice.agentid.pub,bob.agentid.pub'
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
> 正文恰好以 `--` 开头:带空格的(如 `"--file 是正文"`)会被正确识别为正文;
|
|
46
46
|
> 若正文**精确等于**某个 flag 名(如要发送文本 `--encrypt`),用 `--` 分隔:
|
|
47
|
-
> `
|
|
47
|
+
> `ecmsg send -- --encrypt`
|
|
48
48
|
|
|
49
49
|
发送选项还包括:
|
|
50
50
|
|
|
@@ -266,7 +266,7 @@ ec group mention <from> <group-id> --clear
|
|
|
266
266
|
- `--format json` — 对支持结构化结果的子命令输出 JSON
|
|
267
267
|
- `--app <name>` — 仅 `pull` / `ack` 指定独立消费 slot
|
|
268
268
|
- `--aun-path <path>` — 指定 AUN keystore 根
|
|
269
|
-
- `--encrypt` — 仅 send
|
|
269
|
+
- `--encrypt yes|no|auto` — 仅 send(`ecmsg send`),默认 `auto`:被对端消息触发时沿用该消息的状态,主动发起时明文
|
|
270
270
|
- `create` 会通过 SDK 自动生成并导入群 `group_aid` 身份。
|
|
271
271
|
- 默认群名遇到明确的身份占用错误时最多尝试 5 次;显式指定的名称不会自动更换,超时或身份导入失败也不会换名重建。
|
|
272
272
|
- 创建结果以服务端返回的 `group_aid` 为准;与请求不一致时输出提示,JSON 结果包含 `warning` 和 `requested_group_aid`。
|
|
@@ -304,7 +304,7 @@ daemon 按整理会话的模式校验 `--scope`:
|
|
|
304
304
|
|
|
305
305
|
## 十、session.md 的注入
|
|
306
306
|
|
|
307
|
-
整理会话也加载 `$KITS_FRAGMENTS/session.md`,但其中的 proactive 行为约束(群聊要不要响应、首次调用工具前先发言、每 N 次调用汇报进展、`
|
|
307
|
+
整理会话也加载 `$KITS_FRAGMENTS/session.md`,但其中的 proactive 行为约束(群聊要不要响应、首次调用工具前先发言、每 N 次调用汇报进展、`ecmsg send` 语法速查)**不会渲染**。
|
|
308
308
|
|
|
309
309
|
原因:整理会话由触发器创建,`peerType` 是 `system`、`chatType` 是 `private`。`resolveChatModeForPeer` 对 system 对端有硬约束,返回 `interactive`,而 proactive 那段的条件是 `{{?chatMode=proactive}}`,所以整块跳过。已实测确认。
|
|
310
310
|
|
|
@@ -176,7 +176,7 @@
|
|
|
176
176
|
|
|
177
177
|
| 字段 | 类型 | 默认 | 作用 |
|
|
178
178
|
|---|---|---|---|
|
|
179
|
-
| `pre_tool_1stmsgchk` | boolean | `true` | 意图表达门禁:每条新消息计数重置为 15,每轮结束后有意图表达成功则清零否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行
|
|
179
|
+
| `pre_tool_1stmsgchk` | boolean | `true` | 意图表达门禁:每条新消息计数重置为 15,每轮结束后有意图表达成功则清零否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行 ecmsg send |
|
|
180
180
|
| `tool_use_reminder` | boolean | `true` | 意图表达门禁与队列提醒:开启意图表达门禁(规则同 pre_tool_1stmsgchk),同时保留队列未读提醒 |
|
|
181
181
|
|
|
182
182
|
- schema 里的 `default` 即**运行时出厂默认**——宿主组装 `modeConfig` 时先铺这层默认(`coordinator.schemaDefaults`),再叠用户显式桶值;flow 层不再硬编码默认。
|
|
@@ -236,9 +236,38 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
|
|
|
236
236
|
|
|
237
237
|
主机 Agent 初始化通过 `menu.action`、`name="agent"`、`action="initialize"` 调用。参数可平铺在
|
|
238
238
|
`args` 中,也可放入 `args.plan`;`aid` 必须与计划中的 AID 一致。`project` 可省略或为空,Core 会按普通
|
|
239
|
-
Agent 创建规则解析主机默认项目;显式项目路径优先。可选的 `
|
|
240
|
-
|
|
241
|
-
`
|
|
239
|
+
Agent 创建规则解析主机默认项目;显式项目路径优先。可选的 `provider` 用于固定所选 `baseagent` 的 Provider,
|
|
240
|
+
可放在 `args.provider` 或 `args.plan.provider`;同时提供时 `plan.provider` 优先。Provider 必须支持该 Base Agent,
|
|
241
|
+
并会随冻结计划持久化。可选的 `model` 必须存在于所选 Provider(未指定 Provider 时为当前默认 Provider)的可见模型目录;
|
|
242
|
+
指定非 `auto` 的 `effort` 时必须同时指定 `model`,且强度必须在当前模型目录支持的范围内。`effort="auto"`
|
|
243
|
+
不写入强度覆盖。远程调用沿用现有控制面权限校验。
|
|
244
|
+
|
|
245
|
+
示例:
|
|
246
|
+
|
|
247
|
+
```json
|
|
248
|
+
{
|
|
249
|
+
"type": "menu.action",
|
|
250
|
+
"id": "<uuid>",
|
|
251
|
+
"name": "agent",
|
|
252
|
+
"action": "initialize",
|
|
253
|
+
"args": {
|
|
254
|
+
"plan": {
|
|
255
|
+
"aid": "helper.agentid.pub",
|
|
256
|
+
"project": "C:/agents/helper",
|
|
257
|
+
"baseagent": "codex",
|
|
258
|
+
"provider": "gateway",
|
|
259
|
+
"ownerAid": "owner.agentid.pub",
|
|
260
|
+
"name": "Helper",
|
|
261
|
+
"description": "协助处理项目开发任务",
|
|
262
|
+
"type": "agent",
|
|
263
|
+
"tags": ["coding"]
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
`action="create"` 的旧式创建入口同样可在 `args.provider` 指定 Provider;`initialize: true` 一步初始化入口也接受
|
|
270
|
+
该字段。Provider 必须支持 `args.baseagent`;未指定时沿用当前配置解析规则。
|
|
242
271
|
|
|
243
272
|
失败后用同一 action 和 `{ aid, resume: true }` 恢复已保存计划。恢复不接受新计划字段,只使用原操作主体、AID
|
|
244
273
|
和持久化计划;其他主体无法接管。
|
|
@@ -4,47 +4,55 @@
|
|
|
4
4
|
|
|
5
5
|
## Agent 会话中的 Shell 调用边界
|
|
6
6
|
|
|
7
|
-
在 EvolCore
|
|
7
|
+
在 EvolCore 托管会话中,每次工具调用只能执行一条完整的命令。禁止把
|
|
8
8
|
`command -v`、`ec aid`、`&&`、`||`、`;`、`|`、重定向、子 shell、`bash -lc` 或其它脚本
|
|
9
|
-
和 `
|
|
9
|
+
和 `ecmsg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
|
|
10
10
|
再决定下一步。工具审批被拒绝时应报告原始错误并停止,不要通过追加命令或提权参数重试。
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
发送统一入口是 `ecmsg send`,本端恒为当前会话本端;目标三种说法:
|
|
13
|
+
|
|
14
|
+
| 目标 | 写法 |
|
|
15
|
+
|---|---|
|
|
16
|
+
| 当前会话的对端/群(默认) | `ecmsg send '<text>'` |
|
|
17
|
+
| 指定话题 | `ecmsg send '<text>' --thread <话题id>` |
|
|
18
|
+
| 指定对端 | `ecmsg send '<text>' --to <对端ID>` |
|
|
19
|
+
|
|
20
|
+
`--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。宿主终端没有会话上下文时,`ec msg send <from> <to> '<text>'` 是同一通道的非托管形态。
|
|
13
21
|
|
|
14
22
|
## 发送消息
|
|
15
23
|
|
|
16
24
|
长文本内联参数统一约定:普通命令调用不变;将字面量 `\n`、`\r`、`\t`、`\\` 分别按一次解码为换行、回车、制表符、反斜杠。Shell 已传入的真实换行保持原样;不要使用 PowerShell 的反引号换行转义,它会在 CLI 之前改变 argv。Windows PowerShell 请调用命令名,不要显式调用批处理入口传物理多行。仅解码正文和文本选项(`--description`、`--text`、`--transcript`、`--handoff-context`);文件内容、路径、`--payload` JSON、标题均不解码。审批仍按 Shell 传入的原始 argv 校验。
|
|
17
25
|
|
|
18
26
|
```bash
|
|
19
|
-
#
|
|
20
|
-
|
|
27
|
+
# 文本
|
|
28
|
+
ecmsg send '<text>'
|
|
21
29
|
|
|
22
30
|
# 从文件读取文本内容(用于超长消息或避免 Shell 转义)
|
|
23
|
-
|
|
31
|
+
ecmsg send --text-from-file <path>
|
|
24
32
|
|
|
25
|
-
#
|
|
26
|
-
|
|
33
|
+
# 端到端加密(三态:yes 密文 / no 明文 / auto 跟随,默认 auto)
|
|
34
|
+
ecmsg send '<text>' --encrypt yes
|
|
27
35
|
|
|
28
|
-
#
|
|
29
|
-
|
|
36
|
+
# 强制明文
|
|
37
|
+
ecmsg send '<text>' --encrypt no
|
|
30
38
|
|
|
31
39
|
# 文件:--as 可选 image|video|voice|file(默认按扩展名推断)
|
|
32
|
-
|
|
40
|
+
ecmsg send --file <path> [--as <type>] [--text '<说明>']
|
|
33
41
|
|
|
34
42
|
# 链接卡片
|
|
35
|
-
|
|
43
|
+
ecmsg send --link <url> [--title '<title>'] [--description '<desc>']
|
|
36
44
|
|
|
37
45
|
# 自定义 payload(JSON)
|
|
38
|
-
|
|
46
|
+
ecmsg send --payload '<json>'
|
|
39
47
|
|
|
40
48
|
# 从 UTF-8 文件读取自定义 payload(避免 Windows Shell 破坏 JSON 引号)
|
|
41
|
-
|
|
49
|
+
ecmsg send --payload-file <path>
|
|
42
50
|
|
|
43
51
|
# 发送自定义 payload 并等待关联结果
|
|
44
|
-
|
|
52
|
+
ecmsg send --to <对端AID> --payload '<json>' --return required --timeout 60s --format json
|
|
45
53
|
|
|
46
54
|
# 单向发送,不建立结果关联
|
|
47
|
-
|
|
55
|
+
ecmsg send '<text>' --return none
|
|
48
56
|
```
|
|
49
57
|
|
|
50
58
|
`--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊 `msg send`,不能同时提供位置文本。
|
|
@@ -57,6 +65,10 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
|
|
|
57
65
|
每一行都必须单独执行,且是该次 shell 调用中的唯一命令。
|
|
58
66
|
|
|
59
67
|
发送相关选项:
|
|
68
|
+
- `--to <对端ID>` — 指定对端(群 AID 或对方 AID,按关系判定类型);省略表示当前会话对端/群
|
|
69
|
+
- `--check-every <时长>` — 跨话题复查周期(5m/30m/2h/1d);省略时跨话题补默认 20m,同话题不建复查
|
|
70
|
+
- `--mention '<aid1>,<aid2>'` / `--mention-all` — 仅群聊 @成员;私聊带 `--mention` 会被拒绝
|
|
71
|
+
- `--trigger-prompt <text>` — 跨话题时追加到复查 Trigger 提示词(需与 `--thread` 同用)
|
|
60
72
|
- `--text-from-file <path>` — 从文件读取文本(UTF-8),用于超长消息或避免 Shell 转义
|
|
61
73
|
- `--handoff-context <text>` — 仅托管私聊跨会话发送可用,1–65536 字符;为本 Agent 的目标会话保存额外交接上下文,处理对端回复时补入。该内容不加入网络 payload,实际发送正文不变;不能用来迁移整个运行中的任务。
|
|
62
74
|
- `--encrypt` — 端到端加密
|
|
@@ -80,20 +92,23 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
|
|
|
80
92
|
|
|
81
93
|
托管会话中的附件源文件必须位于当前项目目录或当前会话 `$TMPDIR` 内;符号链接、硬链接、路径穿越和受保护路径会被拒绝。
|
|
82
94
|
|
|
83
|
-
托管会话主动执行 `
|
|
95
|
+
托管会话主动执行 `ecmsg send` 时,系统会先校验目标关系权限,再将无条目、`pending` 或
|
|
84
96
|
`declined` 的私聊目标加入本 Agent 联系人簿并设为 `active`,然后继续发送。`blocked` 目标仍会拒绝发送,必须先执行:
|
|
85
97
|
|
|
86
98
|
```bash
|
|
87
99
|
ec peer unblock <target-aid> --self <self-aid>
|
|
88
100
|
```
|
|
89
101
|
|
|
90
|
-
|
|
102
|
+
发到群走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
|
|
91
103
|
|
|
92
104
|
非托管环境的 `ec msg send` 是独立 AUN CLI 发送,不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断。
|
|
93
105
|
|
|
94
|
-
在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role
|
|
106
|
+
在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。默认目标是当前对端;
|
|
107
|
+
要联系当前对端以外的对象,用 `ecmsg send '<text>' --to <对方AID>`(首次联系直接发出),
|
|
108
|
+
或先 `ec thread list <对方AID>` 选话题(没有就 `ec thread create`),再用
|
|
109
|
+
`ecmsg send '<text>' --thread <threadId> --check-every <时长>` 发送(`--check-every` 可省略)。**跨话题会自动创建复查**(缺省 20m),到期后系统向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功回执(含 `message_id`/`status`)不得声称已发送。
|
|
95
110
|
|
|
96
|
-
成功输出:`✓ 已发送
|
|
111
|
+
成功输出:`✓ 已发送 from=… to=… thread=… chatType=… message_id=<id> seq=<n> status=<status>`
|
|
97
112
|
|
|
98
113
|
## 请求/响应等待与异步查询
|
|
99
114
|
|
|
@@ -149,7 +164,7 @@ ec msg request get <self-aid> <request-id> --format json
|
|
|
149
164
|
> 正文写法:含空格/换行/特殊字符时用引号包起来;纯短词可不包,但多空格会被压成一个。
|
|
150
165
|
> 正文恰好以 `--` 开头:带空格的(如 `"--file 是正文"`)会被正确识别为正文;
|
|
151
166
|
> 若正文**精确等于**某个 flag 名(如要发送文本 `--encrypt`),用 `--` 分隔:
|
|
152
|
-
> `
|
|
167
|
+
> `ecmsg send -- --encrypt`
|
|
153
168
|
|
|
154
169
|
## 拉取消息
|
|
155
170
|
|
|
@@ -232,13 +247,6 @@ ec msg history <self-aid> <target-aid> \
|
|
|
232
247
|
加密策略:
|
|
233
248
|
- 对端发来密文消息时,回复也应使用 `--encrypt`(保持对话加密一致性)
|
|
234
249
|
- 对端发来明文消息时,默认明文回复
|
|
235
|
-
- 主动发起(没有入站消息上下文)默认明文;只有显式 `--encrypt`,或 `daemon.json` 设置 `aun.defaultEncrypt: true`,才加密发送
|
|
236
|
-
|
|
237
|
-
## 在当前会话中快速回复(备选)
|
|
250
|
+
- 主动发起(没有入站消息上下文)默认明文;只有显式 `--encrypt yes`,或 `daemon.json` 设置 `aun.defaultEncrypt: true`,才加密发送
|
|
238
251
|
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
```bash
|
|
242
|
-
ec ctl send '<text>'
|
|
243
|
-
ec ctl send --encrypt '<text>'
|
|
244
|
-
```
|
|
252
|
+
`ecmsg send` 默认等价于 `--encrypt auto`:被对端消息触发时沿用该消息的加密状态,主动发起时明文。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ec provider — 宿主 Provider 注册表
|
|
2
2
|
|
|
3
|
-
管理 daemon 级 providers.json;单数命令 provider,没有 providers 别名。宿主控制终端须经 daemon
|
|
3
|
+
管理 daemon 级 providers.json;单数命令 provider,没有 providers 别名。宿主控制终端须经 daemon 控制凭据授权;经 daemon 验证为 DaemonOwner 的托管任务无需 fullaccess 即可执行 list/show,只读结果仍脱敏。托管写操作仍要求 daemon 验证的 trusted fullaccess 执行身份。普通 Agent owner/admin 或 Owner+bypass 不等于 DaemonOwner,也不能单凭这些身份管理进程级 Provider。daemon 必须在线;帮助无需 daemon 或配置。
|
|
4
4
|
|
|
5
5
|
## 命令集
|
|
6
6
|
|
|
@@ -11,22 +11,70 @@ ec provider create --file <path> [--format json]
|
|
|
11
11
|
ec provider import --file <path> [--format json]
|
|
12
12
|
ec provider update <provider-id> --file <path> [--format json]
|
|
13
13
|
ec provider delete <provider-id> [--format json]
|
|
14
|
+
ec provider sync [--format json]
|
|
14
15
|
~~~
|
|
15
16
|
|
|
16
|
-
- list
|
|
17
|
+
- 默认输出可读文本:list 为列表,show 为分层配置详情,create/import/update/delete 为操作结果,sync 为同步摘要(导入、别名、引用更新、默认选择、待处理项、告警和备份)。`--format json` 保留完整 `{ ok, data }` 或 `{ ok, code, error, data? }` 响应,供脚本使用。失败退出码非零。
|
|
18
|
+
- list 显示 ID、名称、域名和服务类型;show 展示脱敏配置,两者均显示 revision。API key、headers、queryParams 中的凭据不回显;完整脱敏注册表可用 `list --format json` 获取。
|
|
17
19
|
- create/update 的文件必须是单个完整 Provider 对象;update 仅替换已存在的 ID,不是字段 patch 或 upsert。
|
|
18
|
-
- import 还接受只有一项的 Provider ID 映射或 providers
|
|
20
|
+
- import 还接受只有一项的 Provider ID 映射或 providers 包装。保存时按规范化完整 hostname 生成稳定的 `provider-` 八位数字 ID;同域配置进入冲突/合并流程,不会因当前环境重新编号。
|
|
19
21
|
- 文件为 UTF-8(可带 BOM),不超过 1 MiB。CLI 将绝对路径交给 daemon 读取,不在 argv 传递 JSON 或凭据;无 --text 参数。
|
|
20
22
|
- update 中的 <redacted> 保留对应旧凭据;省略字段表示清除。create/import 不接受脱敏占位符。
|
|
21
23
|
- delete 遇到 defaults、Agent 或 relation 的 Provider/fallback 引用时拒绝,返回非敏感引用路径;没有 force/级联删除。配置损坏或引用目录不可读时也拒绝删除。
|
|
22
24
|
|
|
25
|
+
## 托管查询的命令边界
|
|
26
|
+
|
|
27
|
+
在托管 Codex 会话中,直接执行独立的 `ec provider list --format json` 或 `ec provider show <provider-id> --format json`。
|
|
28
|
+
不要将查询嵌入 PowerShell 赋值、管道或多语句脚本,例如 `$result = ec provider list --format json | ConvertFrom-Json`。
|
|
29
|
+
无法安全解析并绑定到实际 EC 参数的复合命令会在执行前拒绝,需拆成独立工具调用;Shell 审批通过不等于内部 EC 调用已获得单次审批。
|
|
30
|
+
|
|
31
|
+
会话进入新任务后,同一命令仍需当前任务的审批。`approval_not_found` 表示当前命令缺少匹配审批;历史任务的同命令审批不会将新任务误报为 `task_revoked`,也不会被复用授权。
|
|
32
|
+
|
|
33
|
+
## 本机扫描与统一配置
|
|
34
|
+
|
|
35
|
+
`ec provider sync` 通过在线 daemon 执行以下一次性事务,不需要输入文件。旧命令名 `sync-local` 不再接受:
|
|
36
|
+
|
|
37
|
+
1. 复用初始化界面的本机基座导入机制,扫描 Claude、Codex、Gemini 和 ecagent 的本机连接;只导入具有有效密钥的来源。同域沿用原有导入合并规则,保留已存在的凭据和服务设置,补充缺少的服务。
|
|
38
|
+
2. 将可识别域名的 Provider ID 转为稳定八位格式,同步 defaults、Agent 和 relation 配置内的 Provider/fallback 引用;冻结初始化计划及其请求指纹不修改,单独记录运行时 Provider 迁移绑定。在线同步暂留旧 ID aliases,到下次成功启动迁移后自动清除。
|
|
39
|
+
3. 仅将全局 defaults 的 `active_baseagent` 改为 `ecagent`;不覆盖已有 Agent 的显式基座或模型选择。
|
|
40
|
+
4. 若注册表存在 `provider-96659517`,从其适用于 ecagent 的实时模型目录选择已启用、已列出的 `deepseek…flash` 模型;多个版本按模型 ID 的数字版本降序选择,例如 `deepseek-v4.1-flash` 优先于 `deepseek-v4-flash`。写入全局 `baseagents.ecagent.provider/model`,不写入拼错的 `deekseek` 或通配符字面量。与新模型不兼容的全局 effort 会清除。
|
|
41
|
+
|
|
42
|
+
若首选 Provider 不存在,保留原有 ecagent 选择并返回 `PREFERRED_PROVIDER_NOT_FOUND`;仍执行导入、ID 迁移及全局基座切换。首选 Provider 存在但没有 ecagent/text 服务、模型目录无法获取或没有符合条件的模型,则整次操作失败,不落盘。没有可导入来源时返回 `NO_LOCAL_PROVIDER_SOURCES`,仍处理已有注册表。
|
|
43
|
+
|
|
44
|
+
同步时,已有和导入 Provider 的 `common.baseUrl` 若为 `$VAR` 或 `${VAR}`,读取 daemon 当前进程的环境变量,将完整实际 HTTP(S) URL(含协议、端口、路径)固化到 `common.baseUrl`,保存规范化完整域名,再计算稳定 ID。端口与路径不参与 ID 计算;密钥等其他环境变量引用保持原状。已有同域条目须先通过凭据和服务端点兼容检查,不兼容则整次失败,不覆盖。
|
|
45
|
+
|
|
46
|
+
变量未设置或为空返回 `PROVIDER_ENV_BASE_URL_MISSING`;URL 无效、包含嵌套环境变量、认证信息、查询串或片段返回 `PROVIDER_ENV_BASE_URL_INVALID`,均不落盘。已声明 domain 与实际地址不匹配时也拒绝。固化后环境变量变化不会自动改动该 Provider;修改地址须显式更新配置。返回 `materializedBaseUrls` 表示本次解析的环境变量地址数量,不回显实际地址。普通启动迁移保持原有行为,不自动展开环境变量。
|
|
47
|
+
|
|
48
|
+
提交前对受影响配置加锁、验证未被其他写入者改动,并通过统一配置快照保存迁移前版本。提交中写入失败会回滚,异常中断由启动迁移恢复。输出只包含导入来源、ID/aliases、待处理项、全局选择、变更数量和备份版本号,不回显密钥。JSON 的 backup 现为统一快照版本(如 v100),不再是独立迁移备份目录。宿主控制终端或 trusted fullaccess 任务可执行;普通 DaemonOwner 托管只读授权不允许执行此命令。
|
|
49
|
+
|
|
50
|
+
同域旧条目迁移冲突时,`PROVIDER_CONFLICT` 提示列出冲突 Provider ID、域名及字段,例如 `common.apiKey`、`services.text.path`、`services.text.models`;JSON 的 `data.kind=provider_migration_conflict`,并提供 `providerIds`、`domain`、`fields`。仅报告字段名,不返回密钥、请求头、查询参数、端点路径或模型设置的值。凭据按配置原文比较,环境变量引用与静态密钥不同不代表实际密钥一定不同。发生冲突不落盘,需核对这些字段后再同步,不自动选边覆盖。
|
|
51
|
+
|
|
52
|
+
## 启动迁移收尾
|
|
53
|
+
|
|
54
|
+
纯 CLI `ec init` 在完成 Baseagent 选择与默认配置保存后,扫描检测到的基座并自动导入有效的本机 Provider 连接;同域沿用服务合并规则,不覆盖已有凭据和模型设置。已有可用选择优先保留,否则绑定本次导入或注册表中适用的 Provider;来源缺失、导入冲突或最终仍无可用连接时输出脱敏提醒。非交互 JSON 输出在 `providers.imported` / `providers.warnings` 提供结果,不输出密钥。此步骤不等同于 `ec provider sync`,不强制切换默认基座或模型。
|
|
55
|
+
|
|
56
|
+
`ec init --web` 不执行终端侧 Baseagent 扫描或 Provider 自动导入;这些步骤由网页初始化流程负责。终端仍检查并准备启动所需的主机控制 AID,不停止或重启已运行的 daemon。
|
|
57
|
+
|
|
58
|
+
本机 Provider 合并导入和 ECWEB 草稿导入合并旧条目时,立即升级为域名稳定 ID,并在同一快照及事务中迁移配置引用;冻结初始化计划保持不变,通过运行时绑定迁移。在线暂留旧 ID 别名,到下次成功启动后清理。哈希碰撞、重复域名无法安全归并或并发修改时拒绝提交,不覆盖其他条目。历史内嵌连接迁移新增 Provider 时也直接生成稳定 ID;同域不兼容的凭据不再通过递增编号绕过冲突。
|
|
59
|
+
|
|
60
|
+
启动时,在加载 Agent 前恢复未完成的迁移事务,再更新全局默认、Agent、关系配置和 fallback,以及初始化记录和 ECWeb 创建工作流中的运行时 Provider 绑定。初始化原始 plan、fingerprint、创建凭据和请求 ID 保持不变,避免破坏重试与恢复的一致性。统一配置快照已覆盖初始化记录和 ECWeb 创建状态,迁移前版本包含全部受影响文件,而非仅 providers.json。
|
|
61
|
+
|
|
62
|
+
Provider 不再创建独立的长期迁移备份,版本查看、恢复和保留清理由现有 ec config 快照机制统一管理;既有历史迁移备份保留不动。短期事务日志仅用于本次操作的失败回滚和中断恢复,成功提交后删除。若 configSnapshots=false,不创建版本备份,在线 sync 返回 CONFIG_SNAPSHOTS_DISABLED 告警,启动迁移也记录告警,但事务日志回滚仍启用;快照开启但写入失败则在修改配置前中止。
|
|
63
|
+
|
|
64
|
+
新快照记录扩展后的文件范围;恢复到尚未收录初始化状态的历史快照时,不因这些文件缺席而删除当前初始化状态。新快照则能够恢复这些文件的内容或原本不存在的状态。
|
|
65
|
+
|
|
66
|
+
引用更新与 aliases 清理作为同一事务提交,providers.json 最后写入。配置无法读取、迁移冲突或并发写入时拒绝提交;提交失败回滚,异常中断由下次启动恢复。成功后旧 ID 不再可用;重复启动无变更时不产生新备份。外部脚本应改用固定 ID,历史备份不重写。启动收尾不导入本机连接、不修改默认基座或模型,也不展开环境变量。
|
|
67
|
+
|
|
68
|
+
托管 Codex 使用解析后的固定 Provider ID 生成运行时 model_provider,并在 thread/start、thread/resume、thread/fork 显式指定当前 Provider,覆盖历史会话中的旧 Provider 选择;原 thread ID 和历史不修改,不以新建会话代替恢复。不会修改用户原生 Codex config.toml 的 model_provider/model_providers。模型目录查询与推理使用相同的运行时命名规则。
|
|
69
|
+
|
|
23
70
|
## 完整对象示例
|
|
24
71
|
|
|
25
72
|
~~~json
|
|
26
73
|
{
|
|
27
74
|
"name": "Example",
|
|
75
|
+
"domain": "api.example.com",
|
|
28
76
|
"common": {
|
|
29
|
-
"baseUrl": "https://example.
|
|
77
|
+
"baseUrl": "https://api.example.com/v1",
|
|
30
78
|
"apiKey": "$EXAMPLE_API_KEY"
|
|
31
79
|
},
|
|
32
80
|
"services": { "text": {} }
|
|
@@ -35,11 +83,15 @@ ec provider delete <provider-id> [--format json]
|
|
|
35
83
|
|
|
36
84
|
apiKey 可用共享 Provider schema 支持的环境变量引用;真实凭据应只保存在受权限保护的 JSON 文件中,不放入命令行历史。
|
|
37
85
|
|
|
86
|
+
Provider identity 取完整规范化 hostname:小写、IDN 转 Punycode、去掉末尾点;裸注册域名补为 `www.`,已有子域名保持不变。静态 `baseUrl` 自动推导 domain;若 `baseUrl` 是环境变量引用,必须显式填写 domain,且运行时地址必须匹配。ID 为完整 SHA-256 摘要转整数后对 100000000 取模并补齐八位。哈希碰撞会拒绝保存,不会改用环境相关的替代 ID。迁移旧 `provider-N` 时会保留 aliases 供旧引用和冻结初始化计划兼容。
|
|
87
|
+
|
|
38
88
|
## 输出与并发
|
|
39
89
|
|
|
40
90
|
文本模式打印脱敏数据;--format json 成功返回 { ok: true, data },失败返回 { ok: false, code, error, data? } 且退出码非零。
|
|
41
91
|
|
|
42
|
-
常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(revision 冲突、仍有引用或引用无法校验)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
|
|
92
|
+
常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(revision 冲突、仍有引用或引用无法校验)、PROVIDER_CONFLICT(域名已存在)、PROVIDER_ID_COLLISION(八位哈希碰撞)、PROVIDER_DOMAIN_IMMUTABLE(不能修改已有域名)、PROVIDER_DOMAIN_REQUIRED/INVALID/MISMATCH(域名缺失、非法或与地址不符)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
|
|
93
|
+
|
|
94
|
+
升级时在启动阶段通过统一快照备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过局部运行时绑定兼容,成功后清理全局 aliases。旧环境变量地址未声明 domain、localhost 或 IP 地址暂保留旧 ID,并报告待处理;不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
|
|
43
95
|
|
|
44
96
|
不提供 if-revision 等参数。daemon 自动读取当前 revision 并通过共享层 CAS 提交;冲突时不自动重试。配置变更用于后续新请求,无需 reload/restart;首次安装本功能的 daemon 代码仍需宿主重新加载。
|
|
45
97
|
|
|
@@ -39,13 +39,13 @@ ec response config set <key> <value> --mode <mode-id> --self <aid> [--peer <X>]
|
|
|
39
39
|
当前注册表只内置 `single-session`。历史的 `interactive` / `proactive` 已合并为该模式下的
|
|
40
40
|
`chatmode` 流程,不再是可传给 `ec response set` 的 mode id。
|
|
41
41
|
|
|
42
|
-
`paactive` 是 PA 私聊的展示分支:它复用 interactive 的执行流、ECK manifest/vars、工具、文件、审批/提问和 notify;模型公开文本(含最终文本)改为 AUN `activity.item.kind=text`,正式回复须经托管 `
|
|
42
|
+
`paactive` 是 PA 私聊的展示分支:它复用 interactive 的执行流、ECK manifest/vars、工具、文件、审批/提问和 notify;模型公开文本(含最终文本)改为 AUN `activity.item.kind=text`,正式回复须经托管 `ecmsg send`。它不使用 proactive 的工具表态门禁或 thought.put,只在 active AUN 人类 Owner 私聊主会话与话题生效。群聊不支持 interactive/paactive,固定使用 proactive。
|
|
43
43
|
|
|
44
44
|
可由目标私聊的 `/chatmode paactive`、Menu 或 Agent `chatmode.private` 配置选择。关系级写入要求已有 `targetKind=private` 的 AUN 关系;`chatmode.group` 只允许 proactive。旧 schema 保存的 group=interactive 读取时按 proactive 兼容,新写入会被拒绝。配置变更对下一任务生效,当前运行任务保持原模式。
|
|
45
45
|
|
|
46
46
|
paactive 的 `show_activities=all/text/none` 保持原显示设置:`all` 展示过程文本和工具活动,`text` 展示过程文本,`none` 隐藏中间过程;最终模型文本均投影为 activity。activity 投递失败不会降级成普通回复。
|
|
47
47
|
|
|
48
|
-
proactive 也遵守 `show_activities`:`all` 投递全部 thought,`text` 只投递模型文本,`none` 不投递 thought(含最终模型文本)。未显式配置时,群聊默认 `none`,私聊默认 `all`;显式配置仍按关系 > Agent > defaults 覆盖。群聊通过 Menu 或 `ec config` 调整,私聊也可使用 `/activity all|text|none`。本地任务活动记录、正式 `
|
|
48
|
+
proactive 也遵守 `show_activities`:`all` 投递全部 thought,`text` 只投递模型文本,`none` 不投递 thought(含最终模型文本)。未显式配置时,群聊默认 `none`,私聊默认 `all`;显式配置仍按关系 > Agent > defaults 覆盖。群聊通过 Menu 或 `ec config` 调整,私聊也可使用 `/activity all|text|none`。本地任务活动记录、正式 `ecmsg send` 和任务状态通知不受此参数影响。
|
|
49
49
|
|
|
50
50
|
## 作用域(越具体越优先:关系 > agent > 全局)
|
|
51
51
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ec thread — 话题链命令
|
|
2
2
|
|
|
3
|
-
话题(Thread)是在私聊或群聊关系里切出的独立对话分支。一组对话可以同时推进多个话题,每个话题有自己的上下文、历史和生命周期,互不干扰。话题链(Thread Chain)则是跨会话、跨 agent 的协作机制:A 可以把一条任务"分支"到 B 的某个话题,B 也可以在自己的话题里继续工作,两者通过 `
|
|
3
|
+
话题(Thread)是在私聊或群聊关系里切出的独立对话分支。一组对话可以同时推进多个话题,每个话题有自己的上下文、历史和生命周期,互不干扰。话题链(Thread Chain)则是跨会话、跨 agent 的协作机制:A 可以把一条任务"分支"到 B 的某个话题,B 也可以在自己的话题里继续工作,两者通过 `ecmsg send --thread` 和 thread-inbox 上下文注入关联起来。
|
|
4
4
|
|
|
5
5
|
触发词:话题/thread/跨话题/委托/ec thread/话题链/summary/删除话题/thread-inbox/跨话题上下文/跨话题复查。
|
|
6
6
|
|
|
@@ -135,29 +135,27 @@ ec thread delete <threadId> # 软删除:session 文件移入 _trash/,索
|
|
|
135
135
|
|
|
136
136
|
## 跨会话发送(话题链核心)
|
|
137
137
|
|
|
138
|
-
在托管会话中,`
|
|
138
|
+
在托管会话中,`ecmsg send` 用 `--thread` 直接路由到某个话题:
|
|
139
139
|
|
|
140
140
|
```bash
|
|
141
|
-
#
|
|
142
|
-
|
|
141
|
+
# 基本形式(本端/对端由话题推断)
|
|
142
|
+
ecmsg send '<消息内容>' --thread <threadId>
|
|
143
143
|
|
|
144
|
-
#
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
# 附带跨话题复查(跨话题时必填;每 30m 向目标话题投递一次复查通知)
|
|
148
|
-
ec msg send '<消息内容>' --thread <threadId> --check-every 30m
|
|
144
|
+
# 自定义复查周期(缺省 20m)
|
|
145
|
+
ecmsg send '<消息内容>' --thread <threadId> --check-every 30m
|
|
149
146
|
```
|
|
150
147
|
|
|
151
148
|
注意事项:
|
|
152
149
|
|
|
153
|
-
- `--thread`
|
|
150
|
+
- `--thread` 必须是本端已存在的话题:独立话题查索引,主话题(`main:<selfAid>:<peerAid>`)查该关系的 active session。都不存在时返回 `TOPIC_NOT_FOUND`
|
|
151
|
+
- `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>` 两种形态;裸对端 AID 不是话题 id
|
|
154
152
|
- **主话题可以作为跨话题发送的目标**。例如:
|
|
155
153
|
```bash
|
|
156
154
|
# A 向 B 的主会话发送消息(从 A 的某个话题跨过去)
|
|
157
|
-
|
|
155
|
+
ecmsg send '请在主会话查看这个报告' --thread 'main:bob.aid:alice.aid'
|
|
158
156
|
```
|
|
159
157
|
主话题的 ID 可以从 `ec thread list <peer>` 的输出中获取(第一行就是主话题)
|
|
160
|
-
-
|
|
158
|
+
- **跨话题自动创建复查**,缺省 20m;只有要改周期时才写 `--check-every`(`5m` / `30m` / `2h` / `1d`)
|
|
161
159
|
- 跨话题发送成功后,系统会在**本端**写一条 thread-inbox 记录。目标话题下次被唤醒时,
|
|
162
160
|
这条记录会以「‹跨话题上下文 · 来源话题:xxx›」的形式注入一次,然后删除
|
|
163
161
|
- `--check-every` 会创建**跨话题复查**(名称 `check-<目标>-from-<来源>-<唯一后缀>`,
|
|
@@ -179,7 +177,7 @@ ec msg send '<消息内容>' --thread <threadId> --check-every 30m
|
|
|
179
177
|
|
|
180
178
|
```bash
|
|
181
179
|
# A 向 B 的话题 T2 发送任务,并设置周期复查
|
|
182
|
-
|
|
180
|
+
ecmsg send '请处理项目A的数据清洗' --thread thread-T2-xxxx --check-every 2h
|
|
183
181
|
```
|
|
184
182
|
|
|
185
183
|
**A 收到 B 的回复时感知来源上下文:**
|
|
@@ -256,6 +256,23 @@ DaemonOwner 管理请求
|
|
|
256
256
|
|
|
257
257
|
## 三、查实现时从哪里开始
|
|
258
258
|
|
|
259
|
+
### Shell 查询的路径判定
|
|
260
|
+
|
|
261
|
+
`readonly-shell-query` 是共享查询分析器,H/L 类路径预检在 `readonly`、`auto`、`request`、
|
|
262
|
+
`bypass` 下都会使用它;名称不表示只影响 `readonly`。`readonly` 还要求整条命令可证明只读,
|
|
263
|
+
其余模式仍按自身审批策略处理未建模命令。
|
|
264
|
+
|
|
265
|
+
- 管道后的 `rg <pattern>` 无文件操作数时读取 stdin;即使上游命令未被查询分析器建模,
|
|
266
|
+
路径预检也保留该 stdin 上下文,不推导成递归扫描当前目录。
|
|
267
|
+
- `rg --files` 仍会枚举文件系统。省略路径并导致范围包含受保护路径时,返回
|
|
268
|
+
`shell_implicit_cwd`,`matchedRule=implicit-cwd`,`matchedPath` 是当前目录,
|
|
269
|
+
提示改用 `src`、`tests` 等显式范围。它不表示实际读取了 `data` 内容。
|
|
270
|
+
- 普通 `ps`、`pgrep` 查询及不附带子命令的 `env` 可建模为无文件操作数的查询;
|
|
271
|
+
`env -S`、执行子命令、`pgrep --pidfile` 等不在这项放行内。
|
|
272
|
+
- 临时写入检查逐命令段处理:已证明只读的搜索参数不算写目标,`2>/dev/null` 是无副作用的
|
|
273
|
+
stderr 丢弃;输出文件、`tee` 及文件修改命令中的临时目标仍须位于会话 `$TMPDIR`。
|
|
274
|
+
只读路径仍要经过 H/L 与当前模式读取范围检查。
|
|
275
|
+
|
|
259
276
|
以下相对链接指向仓库源码。本文按 2026-11-02 的实现说明整理,后续行为变化应同时更新说明。
|
|
260
277
|
|
|
261
278
|
| 关注点 | 入口 |
|
|
@@ -137,7 +137,7 @@ Trigger V3 第二阶段使用 `execution.type` 区分执行位置:
|
|
|
137
137
|
|
|
138
138
|
### 跨话题复查(kind=cross-thread-review)
|
|
139
139
|
|
|
140
|
-
`
|
|
140
|
+
`ecmsg send --thread <T2> --check-every 5m` 创建的复查用 `target_session` 执行:
|
|
141
141
|
到期时**不创建 trigger 会话**,而是把渲染好的通知作为一条入站消息投进目标话题 T2
|
|
142
142
|
的本地会话队列,由 T2 侧的 agent 在 T2 自己的上下文里决策。
|
|
143
143
|
|
|
@@ -504,7 +504,7 @@ ec trigger create --exec script --file ./trigger-dir --enable
|
|
|
504
504
|
|
|
505
505
|
### 任务异常恢复到原会话
|
|
506
506
|
|
|
507
|
-
`task:error` 可以直接把恢复请求路由到产生异常的原始会话,不需要通过 `
|
|
507
|
+
`task:error` 可以直接把恢复请求路由到产生异常的原始会话,不需要通过 `ecmsg send` 发送模拟的“继续”消息。`target_session` 执行类型配合 `event_session` feedback 时,daemon 从事件中的 `sessionId` 查找原会话,并复用其持久化的 baseagent/provider 会话。
|
|
508
508
|
|
|
509
509
|
daemon 启动时会自动维护一个名为 `__task-recovery` 的系统 Trigger。这里的事件名仍然是 `task:error`;开头的 `__` 只表示 Trigger 的 ID/name 属于 EvolCore daemon 的系统定义,和 `__upgrade-check` 使用同一命名约定,不是事件命名空间。该 Trigger 的 daemon scope 覆盖同一 EvolCore daemon 管理的所有本机 Agent,跨 daemon 或远程 Agent 不在范围内。
|
|
510
510
|
|