evolcore 0.0.43-test.4 → 0.0.43-test.5
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 +46 -0
- package/bin/ecmsg.js +354 -91
- package/dist/agents/codex-runner.js +12 -17
- 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/channels/aun.js +30 -17
- package/dist/channels/daemon.js +2 -2
- package/dist/cli/agent-create.js +4 -2
- package/dist/cli/aid-bind-command.js +3 -0
- package/dist/cli/aun-commands.js +10 -3
- package/dist/cli/code-stats.js +451 -213
- package/dist/cli/ctl-command.js +1 -3
- package/dist/cli/daemon-commands.js +12 -3
- package/dist/cli/directory.js +3 -1
- package/dist/cli/ecmsg-gateway.js +204 -0
- package/dist/cli/index.js +6 -0
- package/dist/cli/init.js +45 -13
- package/dist/cli/provider-command.js +82 -5
- package/dist/cli/restart-monitor.js +11 -19
- package/dist/cli/stats.js +8 -1
- package/dist/cli/task-context.js +3 -0
- package/dist/config/boot-log.js +12 -1
- package/dist/config/config-manager.js +4 -13
- package/dist/config/daemon-services.js +1 -0
- package/dist/config/peer-role-resolver.js +5 -5
- package/dist/config/provider-identity-migration.js +202 -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 +153 -0
- package/dist/config/providers-config.js +32 -4
- package/dist/config/providers-management.js +144 -68
- package/dist/config/providers.js +4 -1
- package/dist/config/schema-migration.js +67 -3
- package/dist/core/agent-runtime.js +4 -2
- 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/command/cli-intent-parser.js +2 -1
- package/dist/core/command/command-handler.js +11 -6
- package/dist/core/command/menu-protocol.js +4 -2
- package/dist/core/command/provider-menu.js +4 -2
- package/dist/core/command/role-menu.js +2 -2
- package/dist/core/command/slash-handler.js +52 -16
- package/dist/core/handoff/runtime.js +9 -3
- package/dist/core/initialization/service.js +4 -3
- package/dist/core/message/aun-ipc-sender.js +81 -3
- package/dist/core/message/message-admission.js +2 -0
- package/dist/core/message/response-engine.js +23 -23
- package/dist/core/message/send-options.js +40 -0
- package/dist/core/message/send-routing.js +310 -0
- package/dist/core/ownership/owner-resolver.js +111 -8
- package/dist/core/permission/ec-command-parser.js +148 -15
- 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/session-idle-monitor.js +94 -16
- package/dist/core/session/session-manager.js +69 -16
- package/dist/core/thread/thread-route.js +5 -2
- package/dist/directory/owner-directory-cache.js +686 -97
- package/dist/directory/owner-directory-markdown.js +146 -36
- package/dist/directory/owner-directory-query-operation.js +2 -2
- 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 +18 -9
- package/dist/ecweb/runtime/supervisor.js +76 -24
- package/dist/index.js +4 -0
- package/dist/paths.js +2 -1
- package/dist/proxy/manager.js +2 -0
- package/dist/proxy/service-supervisor.js +2 -2
- package/dist/response-system/engines/v1/proactive-flow.js +4 -0
- package/dist/trigger/application-service.js +1 -0
- package/dist/trigger/event-source.js +4 -0
- package/dist/trigger/feedback.js +26 -2
- package/dist/trigger/scheduler.js +3 -3
- 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 +36 -8
- package/dist/utils/public-suffix.js +5811 -0
- package/dist/utils/windows-autostart.js +41 -7
- package/ecagent/dist/harness/env/nodejs.js +46 -2
- package/kits/docs/aun/ABILITY_CALLING.md +3 -3
- 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 +2 -1
- package/kits/docs/evolcore/agent.md +2 -2
- package/kits/docs/evolcore/aid.md +8 -2
- package/kits/docs/evolcore/ctl.md +13 -4
- package/kits/docs/evolcore/directory.md +48 -15
- package/kits/docs/evolcore/group.md +6 -6
- package/kits/docs/evolcore/memory-consolidation.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +32 -3
- package/kits/docs/evolcore/msg.md +28 -27
- package/kits/docs/evolcore/provider.md +39 -5
- package/kits/docs/evolcore/response.md +1 -1
- 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 +28 -28
- package/kits/eck_manifest.memory.json +18 -18
- package/kits/rules/01-overview.md +1 -1
- package/kits/rules/06-channel.md +3 -3
- package/kits/schemas/_meta.json +7 -1
- package/kits/schemas/providers.schema.2.json +74 -0
- package/kits/schemas/role-registry.schema.1.json +1 -1
- package/kits/skills/ec-agent-create/SKILL.md +1 -0
- package/kits/skills/ec-service-proxy/SKILL.md +3 -10
- package/kits/skills/ec-trigger/SKILL.md +5 -5
- package/kits/skills/ec-trigger/references/examples.md +1 -1
- package/kits/templates/system-fragments/channel.md +5 -5
- package/kits/templates/system-fragments/commands.md +3 -2
- 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 +47 -28
- package/kits/templates/system-fragments/session.md +2 -9
- package/kits/templates/system-fragments/thread.md +5 -5
- package/package.json +2 -3
|
@@ -9,42 +9,50 @@
|
|
|
9
9
|
和 `ec msg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
|
|
10
10
|
再决定下一步。工具审批被拒绝时应报告原始错误并停止,不要通过追加命令或提权参数重试。
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
发送统一入口是 `ecmsg send`。本端恒为当前会话本端,不写 `<from>`;目标三种说法:
|
|
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`,不能同时提供位置文本。
|
|
@@ -80,20 +88,20 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
|
|
|
80
88
|
|
|
81
89
|
托管会话中的附件源文件必须位于当前项目目录或当前会话 `$TMPDIR` 内;符号链接、硬链接、路径穿越和受保护路径会被拒绝。
|
|
82
90
|
|
|
83
|
-
托管会话主动执行 `
|
|
91
|
+
托管会话主动执行 `ecmsg send` 时,系统会先校验目标关系权限,再将无条目、`pending` 或
|
|
84
92
|
`declined` 的私聊目标加入本 Agent 联系人簿并设为 `active`,然后继续发送。`blocked` 目标仍会拒绝发送,必须先执行:
|
|
85
93
|
|
|
86
94
|
```bash
|
|
87
95
|
ec peer unblock <target-aid> --self <self-aid>
|
|
88
96
|
```
|
|
89
97
|
|
|
90
|
-
|
|
98
|
+
发到群走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
|
|
91
99
|
|
|
92
100
|
非托管环境的 `ec msg send` 是独立 AUN CLI 发送,不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断。
|
|
93
101
|
|
|
94
|
-
在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role
|
|
102
|
+
在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。默认只允许回复当前对端;要联系当前对端以外的对象,必须通过话题路由:先 `ec thread list <对方AID>` 选话题(没有就 `ec thread create`),再用 `ecmsg send '<text>' --thread <threadId> --check-every <时长>` 发送。**跨话题会自动创建复查**(缺省 20m),到期后系统向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功回执(含 `message_id`/`status`)不得声称已发送。
|
|
95
103
|
|
|
96
|
-
成功输出:`✓ 已发送
|
|
104
|
+
成功输出:`✓ 已发送 from=… to=… thread=… chatType=… message_id=<id> seq=<n> status=<status>`
|
|
97
105
|
|
|
98
106
|
## 请求/响应等待与异步查询
|
|
99
107
|
|
|
@@ -232,13 +240,6 @@ ec msg history <self-aid> <target-aid> \
|
|
|
232
240
|
加密策略:
|
|
233
241
|
- 对端发来密文消息时,回复也应使用 `--encrypt`(保持对话加密一致性)
|
|
234
242
|
- 对端发来明文消息时,默认明文回复
|
|
235
|
-
- 主动发起(没有入站消息上下文)默认明文;只有显式 `--encrypt`,或 `daemon.json` 设置 `aun.defaultEncrypt: true`,才加密发送
|
|
236
|
-
|
|
237
|
-
## 在当前会话中快速回复(备选)
|
|
243
|
+
- 主动发起(没有入站消息上下文)默认明文;只有显式 `--encrypt yes`,或 `daemon.json` 设置 `aun.defaultEncrypt: true`,才加密发送
|
|
238
244
|
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
```bash
|
|
242
|
-
ec ctl send '<text>'
|
|
243
|
-
ec ctl send --encrypt '<text>'
|
|
244
|
-
```
|
|
245
|
+
`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,52 @@ 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 引用;冻结初始化计划不修改,通过旧 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、待处理项、全局选择、变更数量和备份位置,不回显密钥。宿主控制终端或 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
|
+
|
|
23
52
|
## 完整对象示例
|
|
24
53
|
|
|
25
54
|
~~~json
|
|
26
55
|
{
|
|
27
56
|
"name": "Example",
|
|
57
|
+
"domain": "api.example.com",
|
|
28
58
|
"common": {
|
|
29
|
-
"baseUrl": "https://example.
|
|
59
|
+
"baseUrl": "https://api.example.com/v1",
|
|
30
60
|
"apiKey": "$EXAMPLE_API_KEY"
|
|
31
61
|
},
|
|
32
62
|
"services": { "text": {} }
|
|
@@ -35,11 +65,15 @@ ec provider delete <provider-id> [--format json]
|
|
|
35
65
|
|
|
36
66
|
apiKey 可用共享 Provider schema 支持的环境变量引用;真实凭据应只保存在受权限保护的 JSON 文件中,不放入命令行历史。
|
|
37
67
|
|
|
68
|
+
Provider identity 取完整规范化 hostname:小写、IDN 转 Punycode、去掉末尾点;裸注册域名补为 `www.`,已有子域名保持不变。静态 `baseUrl` 自动推导 domain;若 `baseUrl` 是环境变量引用,必须显式填写 domain,且运行时地址必须匹配。ID 为完整 SHA-256 摘要转整数后对 100000000 取模并补齐八位。哈希碰撞会拒绝保存,不会改用环境相关的替代 ID。迁移旧 `provider-N` 时会保留 aliases 供旧引用和冻结初始化计划兼容。
|
|
69
|
+
|
|
38
70
|
## 输出与并发
|
|
39
71
|
|
|
40
72
|
文本模式打印脱敏数据;--format json 成功返回 { ok: true, data },失败返回 { ok: false, code, error, data? } 且退出码非零。
|
|
41
73
|
|
|
42
|
-
常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(revision 冲突、仍有引用或引用无法校验)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
|
|
74
|
+
常见错误: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 不在线)。
|
|
75
|
+
|
|
76
|
+
升级时在启动阶段备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过 aliases 兼容。旧环境变量地址未声明 domain、localhost 或 IP 地址暂保留旧 ID,并报告待处理;不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
|
|
43
77
|
|
|
44
78
|
不提供 if-revision 等参数。daemon 自动读取当前 revision 并通过共享层 CAS 提交;冲突时不自动重试。配置变更用于后续新请求,无需 reload/restart;首次安装本功能的 daemon 代码仍需宿主重新加载。
|
|
45
79
|
|
|
@@ -39,7 +39,7 @@ 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
|
|
|
@@ -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
|
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
|
|
19
19
|
## 场景矩阵
|
|
20
20
|
|
|
21
|
-
默认角色分为 `private`、`group`、`paTeam
|
|
21
|
+
默认角色分为 `private`、`group`、`paTeam`。其中 `paTeam` 是兼容保留的配置键,实际表示“同 Owner 内部 Agent”默认:AUN 私聊中双方 agent.md 验签通过、类型为 `agent`,且新鲜 Ownership 共识确认同 Owner 时使用该独立默认;不再要求 `exttype=pa.*`。缺失/null 默认 member,不复用 private。真实 Owner 优先,显式关系角色优先于内部默认。资格失效会触发后续鉴权及工具执行重验,不批量改写关系配置;群聊和非 AUN 不适用。
|
|
22
22
|
|
|
23
23
|
| 场景 | 响应策略 | 工具可用性 |
|
|
24
24
|
|------|----------|-----------|
|
|
@@ -98,26 +98,36 @@
|
|
|
98
98
|
|
|
99
99
|
### manifest 默认段(按 order)
|
|
100
100
|
|
|
101
|
-
| order | id | 加载条件 |
|
|
101
|
+
| order | id | 加载条件 | 模板渲染 | section 名 / 内容 |
|
|
102
102
|
|-------|----|----|--------|------|
|
|
103
|
-
| 10 | rules | always | ✗ | `$KITS_RULES/`
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
|
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
103
|
+
| 10 | rules | always | ✗ | 核心规则 / 目录 `$KITS_RULES/` |
|
|
104
|
+
| 15 | bootstrap-guide | lifecycle=bootstrapping | ✓ | Bootstrap 引导 |
|
|
105
|
+
| 20 | identity-layer | chatType≠null | ✓ | 身份层 |
|
|
106
|
+
| 20.5 | skills-builtin | 缺文件则跳过 | ✗ | 内置技能 / `$AGENT_DIR/skills/.index-builtin.md` |
|
|
107
|
+
| 20.6 | skills-local | 缺文件则跳过 | ✗ | 本机技能 / `$AGENT_DIR/skills/.index-local.md` |
|
|
108
|
+
| 21 | soul | chatType≠null | ✗ | 常驻自我 / 目录 `$PERSONAL_DIR/soul`(`*.md`;骨架分册与空文件不注入,`00-GUIDE.md` 常驻) |
|
|
109
|
+
| 28 | owner-directory | hasOwnerDirectory=true | ✗ | Owner 名录 / `$AGENT_DIR/directory/directory.md`(渲染产物) |
|
|
110
|
+
| 29.4 | contacts-profile | hasOwnerDirectory=true 且 isPersonalAssistant≠true | ✓ | 联系人名录 |
|
|
111
|
+
| 29.5 | pa-profile | hasOwnerDirectory=true 且 isPersonalAssistant=true | ✓ | 个人助理 |
|
|
112
|
+
| 30 | relation-layer | chatType∈{private,group} | ✓ | 关系层 |
|
|
113
|
+
| 35 | memory | memoryEnableRelation≠false | ✓ | 记忆系统(按 sessionType 分支) |
|
|
114
|
+
| 36 | agent-memory | memoryEnableAgent≠false | ✗ | agent 记忆 / `$PERSONAL_DIR/memory/MEMORY.md` |
|
|
115
|
+
| 37 | owner-memory | ownerAid≠null | ✗ | Owner 记忆 / `$EVOLCORE_HOME/memory/owner/{{ownerAid}}/MEMORY.md` |
|
|
116
|
+
| 38 | relation-memory | peerKey≠null | ✗ | 对端记忆 / `$RELATIONS_DIR/{{peerKey}}/memory/MEMORY.md` |
|
|
117
|
+
| 40 | venue-fragment | chatType≠null | ✓ | 环境层 |
|
|
118
|
+
| 41 | venue-chattype | chatType≠null | ✗ | 场景环境 / `venues/{{chatType}}.md` |
|
|
119
|
+
| 42 | venue-channel-chattype | chatType≠null | ✗ | 渠道场景环境 / `venues/{{channel}}-{{chatType}}.md` |
|
|
120
|
+
| 42.5 | group-history | channel=aun 且 chatType=group 且 groupHistoryAvailable=true | ✓ | 群历史 |
|
|
121
|
+
| 43.2 | relation-group-rules | groupRulesPath≠null | ✗ | 群规则 / `$RELATIONS_DIR/{{peerKey}}/rules.md` |
|
|
122
|
+
| 44 | venue-client | clientType≠null | ✗ | 客户端环境 / `venues/client-{{clientType}}.md` |
|
|
123
|
+
| 46 | thread | chatType∈{private,group} | ✗ | 话题系统 |
|
|
124
|
+
| 49 | reply-contract | channel≠null 且 lifecycle∈{active,bootstrapping} | ✓ | 回复规则 |
|
|
125
|
+
| 50 | channel-layer | channel≠null | ✓ | 渠道层 |
|
|
126
|
+
| 55 | commands | channel≠null | ✓ | 命令集 |
|
|
127
|
+
| 60 | session | always | ✓ | 会话(含 localDate/weekday) |
|
|
128
|
+
| 70 | baseagent | baseAgent≠null | ✓ | base agent |
|
|
129
|
+
| 75 | bash-description | baseAgent∈{claude,ecagent} 且 lifecycle∈{active,bootstrapping} | ✓ | Bash 格式 |
|
|
130
|
+
| 80 | managed-runtime-notice | lifecycle=active | ✓ | 托管运行时(勿重复读 $KITS_RULES/ 与 CLAUDE.md 指令) |
|
|
121
131
|
|
|
122
132
|
### 输出结构
|
|
123
133
|
|
|
@@ -125,7 +135,7 @@
|
|
|
125
135
|
<system-reminder>
|
|
126
136
|
EvolCore Context Kit documents are shown below.
|
|
127
137
|
|
|
128
|
-
Contenu de $KITS_RULES/01-overview.md (rules —
|
|
138
|
+
Contenu de $KITS_RULES/01-overview.md (rules — 核心规则):
|
|
129
139
|
...(各 section 内容,按 order)
|
|
130
140
|
|
|
131
141
|
IMPORTANT: Use this context when it affects the current interaction.
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"needsInjection": false,
|
|
12
12
|
"maxFileBytes": 16384,
|
|
13
13
|
"when": "always",
|
|
14
|
-
"description": "
|
|
14
|
+
"description": "核心规则"
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
"id": "auxiliary-role",
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
"order": 20,
|
|
21
21
|
"needsInjection": true,
|
|
22
22
|
"when": "always",
|
|
23
|
-
"description": "
|
|
23
|
+
"description": "辅助会话"
|
|
24
24
|
},
|
|
25
25
|
{
|
|
26
26
|
"id": "session",
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"order": 60,
|
|
30
30
|
"needsInjection": true,
|
|
31
31
|
"when": "always",
|
|
32
|
-
"description": "
|
|
32
|
+
"description": "会话"
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"id": "baseagent",
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
"order": 70,
|
|
39
39
|
"needsInjection": true,
|
|
40
40
|
"when": { "var": "baseAgent", "neq": null },
|
|
41
|
-
"description": "
|
|
41
|
+
"description": "base agent"
|
|
42
42
|
},
|
|
43
43
|
{
|
|
44
44
|
"id": "bash-description",
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
"order": 75,
|
|
48
48
|
"needsInjection": true,
|
|
49
49
|
"when": { "var": "baseAgent", "in": ["claude", "ecagent"] },
|
|
50
|
-
"description": "Bash
|
|
50
|
+
"description": "Bash 格式"
|
|
51
51
|
}
|
|
52
52
|
]
|
|
53
53
|
}
|