evolcore 0.0.41-test.2 → 0.0.42-test.0
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 +38 -2
- package/bin/codex-managed-hook.mjs +9 -5
- package/dist/agents/baseagent.js +156 -16
- package/dist/agents/claude-runner.js +10 -3
- package/dist/agents/codex/catalog.js +8 -4
- package/dist/agents/codex-runner.js +236 -59
- package/dist/agents/ecagent-runner.js +82 -13
- package/dist/aun/aid/agentmd.js +106 -27
- package/dist/aun/aid/client.js +1 -1
- package/dist/aun/aid/control-aid.js +65 -13
- package/dist/aun/aid/identity.js +70 -4
- package/dist/aun/aid/index.js +2 -2
- package/dist/aun/service-proxy.js +25 -1
- package/dist/channels/aun.js +242 -209
- package/dist/channels/dingtalk.js +1 -1
- package/dist/channels/feishu.js +1 -1
- package/dist/channels/qqbot.js +1 -1
- package/dist/channels/wechat.js +1 -1
- package/dist/channels/wecom.js +1 -1
- package/dist/cli/agent-command.js +183 -3
- package/dist/cli/agent-create.js +92 -86
- package/dist/cli/agent.js +136 -1
- package/dist/cli/aun-commands.js +137 -35
- package/dist/cli/bench.js +8 -2
- package/dist/cli/command-log.js +1 -1
- package/dist/cli/daemon-commands.js +235 -51
- package/dist/cli/debug-mode.js +1 -1
- package/dist/cli/directory.js +170 -0
- package/dist/cli/index.js +40 -30
- package/dist/cli/init-channel.js +4 -4
- package/dist/cli/init.js +47 -32
- package/dist/cli/managed-command-guard.js +4 -1
- package/dist/cli/model.js +27 -18
- package/dist/cli/pa-workspace-command.js +191 -0
- package/dist/cli/{contact.js → peer.js} +19 -25
- package/dist/cli/restart-monitor.js +11 -4
- package/dist/cli/thread-command.js +47 -18
- package/dist/cli/version.js +18 -18
- package/dist/config/access-policy.js +29 -12
- package/dist/config/boot-log.js +65 -10
- package/dist/config/builtin-roles.js +2 -4
- package/dist/config/config-field-policy.js +3 -0
- package/dist/config/config-manager.js +28 -20
- package/dist/config/{contact-bind-code.js → peer-bind-code.js} +6 -6
- package/dist/config/{contact-book-store.js → peer-book-store.js} +75 -75
- package/dist/config/{contact-book-v2-startup.js → peer-book-v2-startup.js} +2 -2
- package/dist/config/{contact-book.js → peer-book.js} +47 -47
- package/dist/config/peer-operation-service.js +132 -0
- package/dist/config/{contact-request-service.js → peer-request-service.js} +90 -90
- package/dist/config/peer-role-resolver.js +3 -3
- package/dist/config/providers-config.js +17 -8
- package/dist/config/providers.js +1 -1
- package/dist/config/schema-migration.js +336 -39
- package/dist/core/agent-application-service.js +8 -2
- package/dist/core/agent-create-status.js +4 -5
- package/dist/core/agent-ipc-registration.js +5 -4
- package/dist/core/agent-runtime.js +30 -17
- package/dist/core/auth/operation-authorizer.js +0 -24
- package/dist/core/auth/operation-catalog.js +4 -20
- package/dist/core/baseagent-loader.js +27 -3
- package/dist/core/bootstrap-service.js +5 -22
- package/dist/core/capability/capability-manager.js +52 -35
- package/dist/core/channel-loader.js +43 -2
- package/dist/core/channel-runtime.js +2 -2
- package/dist/core/command/agent-control.js +54 -18
- package/dist/core/command/command-handler.js +92 -72
- package/dist/core/command/connect-menu.js +35 -42
- package/dist/core/command/daemon-diagnostics.js +41 -5
- package/dist/core/command/data-root-error.js +10 -0
- package/dist/core/command/data-root-resolver.js +53 -13
- package/dist/core/command/menu-catalog.js +1 -0
- package/dist/core/command/menu-handler.js +163 -65
- package/dist/core/command/menu-protocol.js +52 -0
- package/dist/core/command/pa-workspace-calendar.js +223 -0
- package/dist/core/command/pa-workspace-store.js +459 -0
- package/dist/core/command/role-menu.js +2 -2
- package/dist/core/command/slash-gate.js +1 -1
- package/dist/core/command/slash-handler.js +57 -41
- package/dist/core/daemon-lifecycle.js +90 -31
- package/dist/core/evolagent.js +6 -10
- package/dist/core/handoff/runtime.js +11 -4
- package/dist/core/host-snapshot.js +208 -0
- package/dist/core/initialization/service.js +152 -20
- package/dist/core/ipc-registration.js +33 -4
- package/dist/core/memory/batch-meta.js +27 -0
- package/dist/core/memory/consolidation-ops-records.js +44 -1
- package/dist/core/memory/consolidation.js +169 -27
- package/dist/core/message/aun-ipc-sender.js +2 -8
- package/dist/core/message/im-renderer.js +56 -3
- package/dist/core/message/message-admission.js +121 -124
- package/dist/core/message/message-bridge.js +38 -54
- package/dist/core/message/message-queue.js +7 -0
- package/dist/core/message/outbound.js +34 -9
- package/dist/core/message/response-engine.js +154 -73
- package/dist/core/model/catalog-service.js +1 -1
- package/dist/core/model/config-scope.js +2 -2
- package/dist/core/model/model-catalog.js +5 -4
- package/dist/core/model/model-diagnostics.js +6 -5
- package/dist/core/model/model-fallback.js +3 -6
- package/dist/core/model/model-permission.js +1 -1
- package/dist/core/ownership/owner-resolver.js +9 -9
- package/dist/core/permission/approval-gateway.js +1 -1
- package/dist/core/permission/ec-command-parser.js +2 -2
- package/dist/core/permission/tool-canonical.js +96 -46
- package/dist/core/permission/tool-error-code.js +41 -0
- package/dist/core/permission/tool-policy.js +71 -47
- package/dist/core/role/runtime-policy.js +1 -1
- package/dist/core/session/session-idle-monitor.js +10 -0
- package/dist/core/session/session-manager.js +2 -4
- package/dist/core/session/session-title.js +36 -8
- package/dist/core/system-session/memory.js +2 -7
- package/dist/core/thread/command-parser.js +6 -2
- package/dist/core/thread/ipc-operation.js +51 -36
- package/dist/core/thread/thread-operation.js +29 -61
- package/dist/core/thread/thread-service.js +57 -13
- package/dist/directory/canonical-digest.js +54 -0
- package/dist/directory/owner-directory-admission.js +114 -43
- package/dist/directory/owner-directory-agentmd-sync.js +89 -0
- package/dist/directory/owner-directory-cache.js +847 -459
- package/dist/directory/owner-directory-markdown.js +272 -0
- package/dist/directory/owner-directory-query-operation.js +195 -0
- package/dist/directory/owner-directory-remark-operation.js +147 -0
- package/dist/directory/owner-directory-remarks.js +145 -0
- package/dist/directory/owner-directory-scope.js +55 -0
- package/dist/directory/owner-directory-search.js +148 -0
- package/dist/directory/owner-directory-store.js +227 -0
- package/dist/eck/kit-renderer.js +1 -0
- package/dist/ecweb/basic-settings-service.js +4 -1
- package/dist/ecweb/message-context-service.js +13 -9
- package/dist/index.js +195 -37
- package/dist/ipc.js +86 -22
- package/dist/paths.js +11 -8
- package/dist/product.js +2 -0
- package/dist/proxy/manager.js +13 -2
- package/dist/proxy/service-supervisor.js +8 -1
- package/dist/trigger/history.js +23 -0
- package/dist/trigger/scheduler.js +3 -0
- package/dist/utils/atomic-write.js +21 -0
- package/dist/utils/cross-platform.js +35 -0
- package/dist/utils/ecweb-supervisor.js +42 -0
- package/dist/utils/error-utils.js +2 -1
- package/dist/utils/evolcore-version.js +19 -0
- package/dist/utils/host-info.js +242 -5
- package/dist/utils/instance-registry.js +28 -6
- package/dist/utils/logger.js +59 -14
- package/dist/utils/machine-info.js +46 -0
- package/dist/utils/process-introspect.js +166 -2
- package/dist/utils/startup-trace.js +245 -0
- package/ecagent/dist/agent-loop.js +27 -13
- package/ecagent/dist/harness/agent-harness.js +3 -3
- package/ecagent/dist/harness/types.d.ts +1 -0
- package/ecagent/dist/types.d.ts +1 -0
- package/kits/docs/INDEX.md +1 -1
- package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +72 -0
- package/kits/docs/evolcore/INDEX.md +3 -2
- package/kits/docs/evolcore/agent-create.md +17 -27
- package/kits/docs/evolcore/agent.md +4 -1
- package/kits/docs/evolcore/aid.md +3 -1
- package/kits/docs/evolcore/config.md +16 -5
- package/kits/docs/evolcore/ctl.md +9 -0
- package/kits/docs/evolcore/ec-capabilities.md +19 -0
- package/kits/docs/evolcore/memory-consolidation-batches.md +79 -5
- package/kits/docs/evolcore/menu-exec-schema-commands.md +2 -1
- package/kits/docs/evolcore/menu-protocol.md +1 -0
- package/kits/docs/evolcore/model.md +13 -4
- package/kits/docs/evolcore/msg.md +1 -1
- package/kits/docs/evolcore/pa-workspace.md +51 -0
- package/kits/docs/evolcore/peer.md +73 -0
- package/kits/docs/evolcore/thread-chain.md +4 -1
- package/kits/eck_manifest.json +21 -0
- package/kits/rules/06-channel.md +1 -1
- package/kits/schemas/_meta.json +12 -1
- package/kits/schemas/agent-config.schema.16.json +6 -0
- package/kits/schemas/agent-config.schema.17.json +897 -0
- package/kits/schemas/daemon.schema.9.json +8 -1
- package/kits/skills/ec-agent-create/SKILL.md +2 -2
- package/kits/skills/ec-identity/SKILL.md +45 -27
- package/kits/skills/ec-service-proxy/SKILL.md +7 -2
- package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +4 -5
- package/kits/skills/thread-ops/SKILL.md +11 -11
- package/kits/templates/bootstrap-welcome.md +3 -15
- package/kits/templates/message-fragments/item.md +1 -1
- package/kits/templates/system-fragments/bootstrap.md +24 -23
- package/kits/templates/system-fragments/commands.md +12 -5
- package/kits/templates/system-fragments/thread.md +18 -3
- package/package.json +6 -4
- package/dist/config/contact-operation-service.js +0 -235
- package/dist/directory/owner-directory-authorization.js +0 -309
- package/kits/docs/evolcore/contact.md +0 -78
- /package/dist/config/{contact-alias.js → peer-alias.js} +0 -0
|
@@ -50,53 +50,43 @@ active
|
|
|
50
50
|
|
|
51
51
|
如果新 Agent 联系 Agent/AI Owner 时收到“不是联系人”或联系人准入拒绝,只发送一次 `/request <申请说明>`,说明这是 Bootstrap 首次设定,并等待 Owner 审核。不要反复重试、修改全局联系人策略或联系其它对象;Owner 直接入站时按该消息继续引导。
|
|
52
52
|
|
|
53
|
-
## 2. Owner
|
|
53
|
+
## 2. Owner 首条回复即激活
|
|
54
54
|
|
|
55
|
-
以下步骤仅适用于 `--bootstrap`,发生在**新 Agent 自己的 Bootstrap
|
|
55
|
+
以下步骤仅适用于 `--bootstrap`,发生在**新 Agent 自己的 Bootstrap 会话**中,不由创建者代替执行。
|
|
56
56
|
|
|
57
|
-
|
|
57
|
+
首条引导消息用对话口吻问一件事:Owner 希望这个 Agent 平时主要做什么,并提一句可以顺便改名。名称、描述、标签都不是必填项。收到 Owner 的任何回复后,新 Agent 不追问第二遍,直接推进激活:
|
|
58
58
|
|
|
59
|
-
- `name
|
|
60
|
-
- `description
|
|
61
|
-
- `tags
|
|
59
|
+
- `name`:创建时已填写,不要求重新输入;Owner 明确要求改名时才更新。
|
|
60
|
+
- `description`:Owner 说明了定位、职责、任务或功能时,概括为 100 字以内写入;没有提及时保留已有值。
|
|
61
|
+
- `tags`:和 description 一样从 Owner 回复中提取领域、职责或任务关键词;提取不出就保留已有值,不询问、不凑数量。
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
只采用 Owner 明确表达的内容,不从闲聊、示例或普通任务中推断。回复里没有设定内容(例如只说“好”“开始吧”)时名片不做修改。名片字段改动不展示给 Owner 确认,直接写入后继续。
|
|
64
64
|
|
|
65
|
-
|
|
66
|
-
2. 空值、占位值或格式错误的字段按缺失处理;`tags` 不足 3 个或超过 6 个也不合格。
|
|
67
|
-
3. Owner 明确提供、修改或选择且没有歧义的内容直接作为最终值;不得从普通任务、示例文字或顺带提及的内容中推断。
|
|
68
|
-
4. 信息缺失、冲突或含义不清时,只追问对应部分,保留此前已明确的内容。
|
|
69
|
-
5. Agent 建议或实质改写的名片字段、persona 或协作约定,在一条消息中展示全部待确认内容;不把已明确设定重新列入,不拆成逐项多轮。正式 welcome 不展示草稿、不询问称呼、不请求确认。
|
|
70
|
-
6. “按你的建议执行就 OK”“按这版来”“没问题”等对已展示建议的明确同意即可继续,不再回显或追问同一组内容;沉默不视为同意。没有待澄清或待确认的设定时直接保存并激活。
|
|
71
|
-
|
|
72
|
-
例如,Owner 可以回复:
|
|
65
|
+
例如,Owner 回复:
|
|
73
66
|
|
|
74
67
|
```text
|
|
75
|
-
|
|
68
|
+
主要帮我维护 evolcore 这个项目,处理 bug 和代码审查。名字改成 Helper 吧。
|
|
76
69
|
```
|
|
77
70
|
|
|
78
|
-
新 Agent
|
|
71
|
+
新 Agent 把名称改为 Helper、描述写为“维护 evolcore 项目,处理 bug 与代码审查”、标签提取为 `项目维护`、`bug修复`、`代码审查`,然后保存交接摘要、生成 welcome 并执行 `ready`,不再请求确认。
|
|
79
72
|
|
|
80
|
-
如果创建命令已提供头像,创建流程会在初始 `agent.md` 发布成功后自动处理;Bootstrap 不重复询问或上传。头像支持 PNG、JPEG、WebP,创建流程会保持完整画面、补白边、缩放到头像尺寸并压缩到 500 KiB
|
|
73
|
+
如果创建命令已提供头像,创建流程会在初始 `agent.md` 发布成功后自动处理;Bootstrap 不重复询问或上传。头像支持 PNG、JPEG、WebP,创建流程会保持完整画面、补白边、缩放到头像尺寸并压缩到 500 KiB 内;原图不会被覆盖。若无法解码或规范化,创建会返回具体的可恢复错误。引导消息会告诉 Owner:想换头像就直接发张图片,说一句“用这张当头像”。AUN 渠道收到的图片落盘到 `$EVOLCORE_HOME/agents/<selfAid>/relations/aun#<Owner AID>/attachments/`,每张图旁的同名 `.json` 里有 `createdAt`;新 Agent 据此找到最新那张,复制到当前项目目录或本会话 `$TMPDIR`,再执行 `ec aid avatar <当前 self AID> --file <复制后的路径>`。Owner 给的是 HTTPS 地址时用 `--url <HTTPS URL>`。命令会自动补白边、缩放压缩,并更新、发布名片中的 `avatar` 字段;激活后也可用同一命令更换。不要要求新 Agent 读取创建者其它会话的临时路径。
|
|
81
74
|
|
|
82
|
-
|
|
83
|
-
明确且无歧义的原文直接用 `ec agent persona --text '<完整内容>'` 或 `ec agent persona --file '<路径>'` 保存;
|
|
84
|
-
读取 persona 内容或判断文件是否存在只用 `ec agent persona show`,不要调用 base agent 的文件读取或搜索工具探测 `personal/persona.md`;命令显示不存在时按空文件处理。
|
|
85
|
-
只有 Agent 自行建议或实质改写的设定才需要确认。persona 与头像都可选,未提供不等待、不追加询问轮次、不影响 `ready`,激活后仍可完善。
|
|
75
|
+
persona 同样不主动询问。Owner 在回复中提供了人格设定(直接文本或 `.md`/`.txt` 文件)时,用 `ec agent persona --text '<完整内容>'` 或 `ec agent persona --file '<路径>'` 保存;读取 persona 内容或判断文件是否存在只用 `ec agent persona show`,不要调用 base agent 的文件读取或搜索工具探测 `personal/persona.md`;命令显示不存在时按空文件处理。persona 与头像未提供时不等待、不影响 `ready`,激活后仍可完善。
|
|
86
76
|
|
|
87
|
-
Bootstrap 完成前,新 Agent
|
|
77
|
+
Bootstrap 完成前,新 Agent 不处理普通任务,也不执行与本流程无关的工具或命令。Owner 在回复中交办的普通任务记入交接摘要的待继续事项,标注“未执行”,激活后由新主会话续接。
|
|
88
78
|
|
|
89
79
|
## 3. 新 Agent 修改自己的 agent.md
|
|
90
80
|
|
|
91
|
-
|
|
81
|
+
Owner 回复中有明确的名称、定位或标签内容时,新 Agent 用 `ec aid agentmd set <selfAid> <field> <value>` 修改对应字段,并且:
|
|
92
82
|
|
|
93
83
|
- 只修改 `name`、`description`、`tags`,不改其它 frontmatter 字段或正文。
|
|
94
84
|
- 名片文件位于受保护路径,用文件工具直接读写会被拒绝;`set` 命令会自己写回并签名。
|
|
95
85
|
|
|
96
86
|
对话式 Bootstrap 中,新 Agent 还要在 `$PERSONAL_DIR/persona.md` 中写入交接摘要(一次性 `--initialize` 模式不经过这段对话,也不会自动生成此摘要):
|
|
97
87
|
|
|
98
|
-
- 忠实整理 Owner
|
|
99
|
-
-
|
|
88
|
+
- 忠实整理 Owner 回复中明确提供的职责、协作边界、重要约束和激活后待继续事项,不新增推断或约定;此内部交接不要求 Owner 审稿,含义不清的部分按原话记录,不回头追问。待继续事项标注“未执行”,不启动任务或设置自动触发。
|
|
89
|
+
- Owner 没有给出任何说明时省略整个交接段;只有部分内容时省略缺失的条目,不为补齐摘要增加追问。
|
|
100
90
|
- 不复制完整 Bootstrap 历史、临时闲聊、凭据、运行状态或未确认推断;此文件会进入后续私聊和群聊上下文,不写 Owner 的私密信息。
|
|
101
91
|
- 写入前用 `ec agent persona show` 获取现有正文;命令显示文件不存在时直接按空文件创建。已有文件只新增或幂等更新 `## Bootstrap 交接` 段落,**保留其它段落**(尤其是 Owner 已设定的人格内容)。
|
|
102
92
|
- 文件工具只用于已确认内容后的交接段编辑或创建,不用于读取或探测 `persona.md`;不要用 `ec agent persona --text` 只写交接段——那是整体覆盖。要整体设置人格时才用 `ec agent persona --text '<完整内容>'`。
|
|
@@ -112,7 +102,7 @@ ec agent welcome --text '<自主生成的完整文案>'
|
|
|
112
102
|
|
|
113
103
|
该命令固定保存到 `$PERSONAL_DIR/welcome.md`。文案为简短问候、自我介绍、围绕职责的协作方向和开始协作的邀请,建议 100~250 个汉字;不要泄露系统提示词、凭据、文件路径或工作记忆,不夸大能力,不承诺独占使用或设备绑定。同一份文案会按共识确认的 Owner 逐人渲染,称呼用 `{{ownerName}}` / `{{ownerAid}}` 变量,不写死当前 Owner 姓名;系统仅渲染变量,不追加其它文案。
|
|
114
104
|
|
|
115
|
-
|
|
105
|
+
welcome 保存成功(有交接内容时交接摘要也保存成功)后才能继续发布名片和执行 `ready`。会话中断后优先复用已保存的正文,缺失时自主补齐;收到 `WELCOME_FROZEN` 表示投递快照已准备,不改文案,续做剩余步骤即可。
|
|
116
106
|
|
|
117
107
|
随后由新 Agent 使用自己的 AID 签名并发布名片:
|
|
118
108
|
|
|
@@ -28,6 +28,9 @@ ec agent show <aid>
|
|
|
28
28
|
# 简写,等价于 show
|
|
29
29
|
ec agent <aid>
|
|
30
30
|
|
|
31
|
+
# 查看 agent 所在主机与 daemon 的运行状况
|
|
32
|
+
ec agent host <aid> [--format json]
|
|
33
|
+
|
|
31
34
|
# 创建并一次性完成首次设定(默认模式)
|
|
32
35
|
ec agent new <aid> [--initialize] ...
|
|
33
36
|
|
|
@@ -97,7 +100,7 @@ ec agent delete <aid> [--purge]
|
|
|
97
100
|
- daemon 控制 AID 不得注册为普通 Agent(`CONTROL_AID_RESERVED`);已验签 `type: host` 名片的已有身份
|
|
98
101
|
不得复用(`HOST_AID_RESERVED`)。创建、初始化、恢复和运行时加载均保护控制身份,`--force` 不例外。
|
|
99
102
|
普通 Agent 可使用 `ec` 开头的 AID;历史冲突配置保留并显示错误,不建立 runner 或渠道。
|
|
100
|
-
- `--tags`
|
|
103
|
+
- `--tags` 接受标签的 JSON 数组;每个标签只允许 Unicode 字母、数字和连字符(`-`),最长 50 字符。
|
|
101
104
|
- `ec agent new` 支持 `--avatar-file <path>`(托管当前对端附件可用 `attachment:<id>`)或 `--avatar-url <https-url>`;创建流程沿用 `ec aid avatar` 的公共头像管线。未提供头像时跳过;已明确提供但无法规范化或上传时,创建返回可恢复错误。
|
|
102
105
|
- `--initialize` 是默认创建模式,要求显式提供 `--name`、`--description`、`--tags` 和 Owner;它不从项目元数据推断名片,成功条件是目标 Agent 已进入 `active`。它自动包含 `--non-interactive`,不需要同时填写后者。
|
|
103
106
|
- `--bootstrap` 与 `--initialize` 互斥,进入原 Bootstrap 流程并隐含 `--non-interactive`。
|
|
@@ -159,6 +159,8 @@ Agent 展示通过 `knownOwner/knownOwners` 读取关系快照,详情另返回
|
|
|
159
159
|
|
|
160
160
|
托管会话中的本地图片必须位于当前会话项目目录或本会话的托管 `$TMPDIR`;相对路径以会话项目目录为基准。不能读取受保护的 EvolCore 路径、符号链接,或托管临时目录中的硬链接。
|
|
161
161
|
|
|
162
|
+
当前对端在 AUN 里发来的图片不在消息正文中,而是落盘到 `$EVOLCORE_HOME/agents/<selfAid>/relations/aun#<对端AID>/attachments/`,每张图旁边有同名 `.json`(含 `createdAt`、`sha256`、`mimeType`)。要拿某张图当头像,先按 `createdAt` 定位文件并复制到当前项目目录或本会话 `$TMPDIR`,再把复制后的路径传给 `--file`;`--file` 只接受这两处路径。非正方形或超过 500 KiB 的图片会自动补白边、缩放并压缩成 JPEG。
|
|
163
|
+
|
|
162
164
|
上传复用 menu 的头像处理流程:校验图片、上传到 AUN storage、更新并发布 `agent.md` 的 `avatar` 字段,成功后发出 `agent:avatar_updated` 事件。无需手动修改名片或再次执行 `agentmd put`。托管 Agent 只能修改自身头像,仍需通过角色与命令授权检查。
|
|
163
165
|
|
|
164
166
|
## 子命令
|
|
@@ -171,7 +173,7 @@ ec aid list [筛选选项] [--no-verify]
|
|
|
171
173
|
ec aid show <aid>
|
|
172
174
|
|
|
173
175
|
# 创建新 AID 身份
|
|
174
|
-
ec aid new <aid> [--force]
|
|
176
|
+
ec aid new <aid> --owner <ownerAid> [--force]
|
|
175
177
|
|
|
176
178
|
# 远程探测 AID(是否存在 + 网关 + agent.md)
|
|
177
179
|
ec aid lookup <aid>
|
|
@@ -162,7 +162,7 @@ ConfigManager 只合并上述物理层并返回物理来源。角色策略不进
|
|
|
162
162
|
- `fallback` 降级链每一级都必须同时给出 `provider`、`model`、`effort`:降级可能换用不同服务商的不同模型。
|
|
163
163
|
- relation 层不承载 `baseagents`、`active_baseagent`、`model`、`models` 或 `Services`;这些字段在关系层会被剥离。
|
|
164
164
|
- `Services.<用途>`(如 `Services.decision`)也在 defaults 提供全局默认,Agent 可逐字段覆盖。
|
|
165
|
-
- Agent
|
|
165
|
+
- Agent 和 defaults 均未设置模型时,Claude/Codex 回落到本机 CLI 配置;再缺省时使用 runner 的内置默认模型。推理强度按同一层级逐字段回落。
|
|
166
166
|
- 只有当前 Agent 的 owner / admin(或 DaemonOwner)可以写模型参数。
|
|
167
167
|
|
|
168
168
|
### Codex 用户提问
|
|
@@ -198,15 +198,25 @@ envelope 提交:活动 turn 使用 `turn/steer`,已结束则通过持久队
|
|
|
198
198
|
```json
|
|
199
199
|
{
|
|
200
200
|
"access": {
|
|
201
|
-
"
|
|
201
|
+
"allowInternalContacts": true,
|
|
202
|
+
"allowExternalContacts": false,
|
|
203
|
+
"allowStrangerContacts": false,
|
|
204
|
+
"allowedAids": [],
|
|
205
|
+
"deniedAids": [],
|
|
202
206
|
"requestLimit": { "maxTimes": 600, "coolDown": 3600 }
|
|
203
207
|
}
|
|
204
208
|
}
|
|
205
209
|
```
|
|
206
210
|
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
211
|
+
三个开关按发送者在 Owner 名录中的归属分档:`allowInternalContacts` 管名录中归属本 Owner 的主体
|
|
212
|
+
(默认开),`allowExternalContacts` 管归属其他 Owner 的主体(默认关),`allowStrangerContacts`
|
|
213
|
+
管名录中查不到的主体(默认关)。Owner 与个人助理恒放行。`deniedAids` 是黑名单,优先于
|
|
214
|
+
`allowedAids` 白名单;白名单可以在对应档关闭时特别放行某个 AID。
|
|
215
|
+
|
|
216
|
+
**群聊的准入单位是整个群,不是发言人**:Agent 加入群后,群内消息不按发言人再分档;只有私聊逐条判定。
|
|
217
|
+
出站私聊与入站使用同一套判定。Owner 名录不可用(未授权、过期、损坏)时一律拒绝,不会放行。
|
|
218
|
+
|
|
219
|
+
`requestLimit` 只限制准入控制消息的自动回复、申请和绑定码提示,不是渠道准入开关;`coolDown`
|
|
210
220
|
单位为秒。该对象由 Connect 的访问设置入口修改,不通过通用 relation/defaults 覆盖链放宽。
|
|
211
221
|
|
|
212
222
|
### AUN 群规则加载策略
|
|
@@ -255,6 +265,7 @@ Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行,不会
|
|
|
255
265
|
- **群规则策略**:`groupRules.mode` 仅当前 Agent 的实际 owner 可 set/unset;DaemonOwner 不继承群或 relation 写权限,其他角色可读取当前 relation 的有效值
|
|
256
266
|
- **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled` 缺失时关闭。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner。私聊中的 `/fa`、`/fa on`、`/fa off` 管理当前 EC 会话;主会话写 Agent 配置,话题会话写 session metadata。`/fa <任务信息>` / `/fullaccess <任务信息>` 执行一次性 fullaccess 任务,不改变会话开关;群聊拒绝。每次 Runner 执行仍复核相应 Owner 授权、会话绑定和 fullaccess 能力;CLI 和托管任务不能直接 set/unset Agent fullaccess。Fullaccess Trigger 使用独立的持久授权链。经 daemon 验证的 fullaccess 任务可绕过托管 CLI 顶层白名单和 H-Class 文件入口限制,但当前会话承载的 EvolCore 生命周期保护、参数校验和文件完整性校验仍生效。
|
|
257
267
|
- **源码诊断白名单**:`readonlySourceDiagnostics` 默认关闭;开启后只读会话仅可在项目源码目录执行受限、可证明只读查询,配置/证书/快照/session/锁文件仍禁止访问
|
|
268
|
+
- **基座 skill 总开关**:`baseagentSkills` 默认关闭,设为 `true` 统一开放;仅 Agent 级、仅 owner 可写(`ec config set`,Menu 协议经 `name=cli action=exec` 传同一 argv,ECWeb 编辑 Agent 抽屉),对所有基座统一生效(Claude 的 Skill 工具、Codex 的 skills);关闭时 `/capability` 的 skill 策略不可修改。它不影响 EC 技能,EC 技能用 `ec skill enable/disable` 管理
|
|
258
269
|
- **仅人可写**:channels / owners / admins / 凭证 / aid / enabled / projects / aun
|
|
259
270
|
- Agent 托管环境写仅人字段被拒
|
|
260
271
|
|
|
@@ -12,6 +12,15 @@ ec ctl pwd # 显示当前项目路径
|
|
|
12
12
|
ec ctl help # 显示帮助
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
+
会话状态不只由消息队列决定:ecagent 的队列结束后,旧执行可能仍在退出和写入原始会话。
|
|
16
|
+
此时状态为 `interrupting`(中断收尾中),直到旧执行真正结束才允许复用原会话;
|
|
17
|
+
`RUNNER_INTERRUPT_UNCONFIRMED` 表示该退出尚未确认,不能通过清除状态或删除会话文件解除。
|
|
18
|
+
`idle` 要求队列、活动流及 runner 执行都已空闲;没有真实成功记录时不显示“最后成功”时间。
|
|
19
|
+
|
|
20
|
+
H 类拒绝保留 `policyCode=h_class_protection`、`executed=false` 和原始拒绝原因。
|
|
21
|
+
取消则另记 `cancelled`、`abortSource`;若拒绝与取消同时发生,两种事实均保留。
|
|
22
|
+
预期中断不发送普通错误或旧任务的最终回复,但原始会话及 runner 诊断仍保留工具结果和关闭流后的丢弃事件计数。
|
|
23
|
+
|
|
15
24
|
## 会话名称
|
|
16
25
|
|
|
17
26
|
```bash
|
|
@@ -29,6 +29,25 @@ EC 的技能系统:**一组可加载的能力单元**。每个技能是一个
|
|
|
29
29
|
**不复用、不代理、不封装。** Claude Code / Codex / Gemini CLI 各自的技能由它们自己管理,
|
|
30
30
|
EC 不在上面再套一层。EC 只管「EC 自身有哪些技能、哪些启用」。
|
|
31
31
|
|
|
32
|
+
基座自带的 skill 功能**默认关闭**,由 Agent 配置顶层的 `baseagentSkills` 统一控制(仅 owner 可写),
|
|
33
|
+
设为 `true` 才对所有基座开放:
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
ec config set baseagentSkills true --self <aid>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
经 Menu 协议修改时,用 `name: "cli"`、`action: "exec"` 传同一条 argv:
|
|
40
|
+
|
|
41
|
+
```json
|
|
42
|
+
{"type":"menu.action","id":"skills-1","name":"cli","action":"exec",
|
|
43
|
+
"args":{"argv":["config","set","baseagentSkills","true","--self","<aid>"]}}
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
ECWeb 在「编辑 Agent → 能力 → 基座 Skill」开关里修改。
|
|
47
|
+
|
|
48
|
+
它只管基座技能(Claude 的 Skill 工具、Codex 的 skills),**不影响 EC 技能**。关闭只是让技能清单
|
|
49
|
+
和工具不出现在模型上下文里,不是沙箱,磁盘上的 `SKILL.md` 仍可被读取。
|
|
50
|
+
|
|
32
51
|
---
|
|
33
52
|
|
|
34
53
|
## 2. 三级目录
|
|
@@ -56,14 +56,54 @@ memory/consolidation-batches/
|
|
|
56
56
|
|
|
57
57
|
```
|
|
58
58
|
<整理批次目录>/
|
|
59
|
+
batch.md ← 批次元数据(状态、会话 ID、模型、失败原因)
|
|
59
60
|
context.md ← 任务书
|
|
60
61
|
ops.jsonl ← 操作流水
|
|
62
|
+
history.jsonl ← 整理会话的原始消息(收尾时回填,调试用)
|
|
61
63
|
threads/ ← 话题快照目录
|
|
62
64
|
main.md ← 主话题快照
|
|
63
65
|
<threadId>.md ← 分话题快照(每个 thread 一个)
|
|
64
66
|
artifacts/ ← 产物目录(调试用)
|
|
65
67
|
```
|
|
66
68
|
|
|
69
|
+
### batch.md — 批次元数据
|
|
70
|
+
|
|
71
|
+
**查一次整理怎么了,先看这个文件。** 它是 YAML frontmatter + 正文,Frontmatter 在整理过程中被写入两次:批次目录创建时写初始状态,拉起会话后回填标识,结束时更新终态。
|
|
72
|
+
|
|
73
|
+
```yaml
|
|
74
|
+
---
|
|
75
|
+
executionSessionId: meta_20261030_1793318595021 ← evolcore 会话 ID
|
|
76
|
+
triggerId: memory-consolidate-promote-mvu7l7so ← 整理标识
|
|
77
|
+
agentSessionId: 06c0cf2b-8360-4b93-890d-e40be997fa0c ← base agent 会话 ID
|
|
78
|
+
baseagent: claude
|
|
79
|
+
plannedModel: <unconfigured> ← 拉起时读到的配置模型;未配置时为 <unconfigured>
|
|
80
|
+
requestedModel: deepseek-v4.1-flash ← 终态事件带出的请求模型
|
|
81
|
+
actualModel: deepseek-v4.1-flash-0901 ← runner 实际调用的模型
|
|
82
|
+
selfAid: dddd.agentid.pub
|
|
83
|
+
peerKey: aun#leiliang.agentid.cn
|
|
84
|
+
ownerAid: leiliang.agentid.cn
|
|
85
|
+
mode: promote
|
|
86
|
+
triggeredBy: relation-idle
|
|
87
|
+
startedAt: 2026-10-30T00:03:14.972Z
|
|
88
|
+
status: failed ← running / completed / failed / rolled-back
|
|
89
|
+
finishedAt: 2026-10-30T00:03:15.449Z
|
|
90
|
+
success: false
|
|
91
|
+
errorCode: model_not_configured ← 机器可读的失败码
|
|
92
|
+
failureReason: baseagents.claude.model 未配置 ← 人可读的失败原因
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 整理反馈
|
|
96
|
+
|
|
97
|
+
<整理会话写入的反馈正文,或程序生成的默认统计模板>
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
几个字段的判读要点:
|
|
101
|
+
|
|
102
|
+
- `plannedModel: <unconfigured>` —— 拉起时无法解析有效模型或找不到 Agent 配置。正常情况下计划模型按 Agent、defaults、本机 CLI、runner 默认值依次解析。
|
|
103
|
+
- `agentSessionId: <none: runner 未初始化>` —— 会话没跑到 runner 初始化那一步。正常跑完的会话这里一定是 UUID。
|
|
104
|
+
- `requestedModel` / `actualModel` 来自会话终态事件;会话早失败时两者都缺省,不算异常。
|
|
105
|
+
- `status: failed` 而没有 `errorCode`,只可能是收尾流程本身抛错(罕见,此时看 ops.jsonl 的 `finalize:error` 步骤)。
|
|
106
|
+
|
|
67
107
|
### context.md — 任务书
|
|
68
108
|
|
|
69
109
|
整理会话启动时读取的上下文文件,包含:
|
|
@@ -80,12 +120,44 @@ memory/consolidation-batches/
|
|
|
80
120
|
整理会话执行的每条 `ec memory` 命令及其结果,每行一条 JSON:
|
|
81
121
|
|
|
82
122
|
```json
|
|
83
|
-
{"ts":
|
|
84
|
-
{"ts":
|
|
85
|
-
{"ts":
|
|
123
|
+
{"ts":"2026-10-30T00:03:15.387Z","op":"session-start","sessionId":"memory-consolidate-promote-mvu7l7so","mode":"promote","triggeredBy":"relation-idle","triggerId":"memory-consolidate-promote-mvu7l7so","baseagent":"claude","plannedModel":"<unconfigured>"}
|
|
124
|
+
{"ts":"2026-10-30T00:03:15.391Z","op":"step","step":"config:model","ok":false,"errorCode":"model_not_configured","error":"baseagents.claude.model 未配置"}
|
|
125
|
+
{"ts":"2026-10-30T00:03:15.444Z","op":"step","step":"session:failed","ok":false,"error":"⚠️ 当前 Agent 未配置模型…","detail":{"executionSessionId":"meta_20261030_1793318595021","outcome":"error"}}
|
|
126
|
+
{"ts":"2026-10-30T00:03:15.446Z","op":"step","step":"finalize:verdict","ok":true,"errorCode":"model_not_configured","error":"⚠️ 当前 Agent 未配置模型…"}
|
|
127
|
+
{"ts":"2026-10-30T00:03:15.447Z","op":"step","step":"finalize:rollback","ok":true,"detail":{"rolledBack":0,"errors":0}}
|
|
128
|
+
{"ts":"2026-10-30T00:03:15.448Z","op":"summary","created":0,"updated":0,"archived":0,"errors":0}
|
|
129
|
+
{"ts":"2026-10-30T00:03:15.449Z","op":"session-end","success":false,"movedNotes":0,"checkpointWritten":false,"errorCode":"model_not_configured","error":"⚠️ 当前 Agent 未配置模型…"}
|
|
86
130
|
```
|
|
87
131
|
|
|
88
|
-
|
|
132
|
+
**每条记录的公共字段**:`ts` 是 ISO 8601 字符串;`ok` 是布尔值,失败时附 `error`(人可读)与 `errorCode`(机器可读)。
|
|
133
|
+
|
|
134
|
+
**op 取值**:
|
|
135
|
+
|
|
136
|
+
| op | 含义 | 关键字段 |
|
|
137
|
+
|----|------|---------|
|
|
138
|
+
| `session-start` | 会话开始(第一条,身份字段全在这里) | `sessionId`①、`triggerId`、`baseagent`、`plannedModel`、`mode`、`triggeredBy` |
|
|
139
|
+
| `step` | 生命周期某一步的结果 | `step`(步骤名)、`ok`、`errorCode`、`error`、`detail` |
|
|
140
|
+
| `create` / `update` / `archive` | 记忆写操作 | `scope`、`target`、`tags`、`filePath`、`reason` |
|
|
141
|
+
| `summary` | 程序追加的统计行 | `created` / `updated` / `archived` / `errors` |
|
|
142
|
+
| `session-end` | 收尾结论(写操作里唯一且最后一条) | `success`、`movedNotes`、`errorCode`、`error`、`feedbackText` |
|
|
143
|
+
|
|
144
|
+
> ① `session-start` 的 `sessionId` 字段在 launch 返回前等于 `triggerId`(占位符);真实的 evolcore 会话 ID 写在 `batch.md` 的 `executionSessionId` 字段,用它才能查 daemon 日志与事件。
|
|
145
|
+
|
|
146
|
+
**step 步骤名速查**(出问题时按顺序看哪一步开始失败):
|
|
147
|
+
|
|
148
|
+
| 步骤 | 记在哪一步 | 失败意味着 |
|
|
149
|
+
|------|-----------|-----------|
|
|
150
|
+
| `config:model` | 拉起前读 `baseagents.<ba>.model` | 模型没配,会话注定在第一轮前失败 |
|
|
151
|
+
| `launch:failed` | `launch()` 抛错 | 会话根本没建起来 |
|
|
152
|
+
| `session:failed` | 会话终态 `outcome !== 'completed'` | 带错误原文与 `detail.outcome` |
|
|
153
|
+
| `queue:launch` | 队列层拉起失败 | 同 `launch:failed`,但由排队路径触发 |
|
|
154
|
+
| `finalize:verdict` | 失败判定 | 带最终失败码,即使会话正常结束也会写 |
|
|
155
|
+
| `finalize:rollback` | 回撤写操作 | 带 `rolledBack` 与失败条数 |
|
|
156
|
+
| `finalize:index-rebuild` | 重建 MEMORY.md | 索引与记忆内容不一致 |
|
|
157
|
+
| `finalize:feedback` | 反馈投递失败 | 渠道不可达,整理结论没送达用户 |
|
|
158
|
+
| `finalize:error` | 收尾本身抛错 | 带异常栈 |
|
|
159
|
+
|
|
160
|
+
> `summary` 与 `session-end` 由程序追加;`step` 不计入 `summary` 的 `errors` 与写计数,也不参与回撤——回撤只读 `create` / `update` / `archive`。
|
|
89
161
|
|
|
90
162
|
### threads/ — 话题快照目录
|
|
91
163
|
|
|
@@ -125,8 +197,10 @@ artifacts/
|
|
|
125
197
|
| 整理进度标记 | `<chatDir>/consolidation-checkpoint.json` | 记录上次整理到哪了 |
|
|
126
198
|
| 整理批次根目录 | `$EVOLCORE_HOME/memory/consolidation-batches/` | 所有批次平铺在这里 |
|
|
127
199
|
| 整理批次目录 | `consolidation-batches/<ts>-<selfAid>-<mode>/` | 一次整理对应一个目录 |
|
|
200
|
+
| 批次元数据 | `<批次目录>/batch.md` | 状态、会话 ID、模型、失败原因——排障先看这里 |
|
|
128
201
|
| 任务书 | `<批次目录>/context.md` | 整理会话的起点文件 |
|
|
129
|
-
| 操作流水 | `<批次目录>/ops.jsonl` |
|
|
202
|
+
| 操作流水 | `<批次目录>/ops.jsonl` | 所有写操作与生命周期步骤记录 |
|
|
203
|
+
| 会话原始消息 | `<批次目录>/history.jsonl` | 整理会话的消息全文,收尾时回填 |
|
|
130
204
|
| 话题快照目录 | `<批次目录>/threads/` | 按 threadId 切分的对话历史 |
|
|
131
205
|
| 主话题快照 | `<批次目录>/threads/main.md` | 主话题消息(`threadId` 为 `null`/空串,或规范 id `main:<a>:<b>`——三者归入同一快照) |
|
|
132
206
|
| 分话题快照 | `<批次目录>/threads/<threadId>.md` | 某个 thread 的消息 |
|
|
@@ -159,7 +159,8 @@
|
|
|
159
159
|
| 全局默认 | `defaults` | `agents/defaults.json` | `defaults` | 1 | 覆盖链最底层(`models.allowed` / `projects` / `aun` 等) |
|
|
160
160
|
| Agent 级 | `agent` | `agents/{aid}/config.json` | `agent-config` | 3 | 单 agent 全量参数;含 user role policy |
|
|
161
161
|
| 关系级 | `relation` | `agents/{aid}/relations/{peerKey}/config.json` | `relation-config` | 2 | 覆盖链最高优先;含 user/group role 分配 |
|
|
162
|
-
|
|
|
162
|
+
| 对端身份 | `peer` | `agents/{aid}/peers.json` | `contact-book` | 3 | 跨渠道别名、展示名与本地拉黑 |
|
|
163
|
+
| Owner 名录副本 | (无) | `agents/{aid}/directory/contacts.json` | (无) | - | Owner 侧名录,只读 |
|
|
163
164
|
|
|
164
165
|
**覆盖链优先级**(低 → 高,逐字段合并):`defaults` → `agent` → `relation`。
|
|
165
166
|
|
|
@@ -90,6 +90,7 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
|
|
|
90
90
|
|------|-----------|------|
|
|
91
91
|
| `system` | `status` | daemon 状态 |
|
|
92
92
|
| `system` | `monitor` | 运行时监控 |
|
|
93
|
+
| `system` | `host` | 主机信息快照(daemon / 队列 / 主机 / 磁盘 / 版本 / runtime) |
|
|
93
94
|
| `system` | `logs` | daemon 日志(`source`/`limit` 可选) |
|
|
94
95
|
| `session` | `subtasks` | 会话子任务列表 |
|
|
95
96
|
| `baseagents` | —— | 已加载 baseagent 列表 |
|
|
@@ -1,6 +1,15 @@
|
|
|
1
1
|
# ec model - 模型管理命令集
|
|
2
2
|
|
|
3
|
-
查看或设置 agent
|
|
3
|
+
查看或设置 agent 使用的模型与推理强度。模型先取 Agent 配置,再继承 `agents/defaults.json`;两处均未配置时:
|
|
4
|
+
|
|
5
|
+
- Claude 读取 `~/.claude/settings.json.model`,再回落到 `sonnet`。
|
|
6
|
+
- Codex 读取 `$CODEX_HOME/config.toml.model`(未设置目录时为 `~/.codex/config.toml`),再从当前连接的 app-server 列表中选择首个可用的 `gpt[*]terra`,忽略大小写并排除隐藏、禁用项。
|
|
7
|
+
- ecagent 从当前 Provider 的模型目录中选择首个可用的 `deepseek[*]flash`,忽略大小写并排除禁用项。目录服务按 Provider 的 ecagent/text 解析规则选择。
|
|
8
|
+
- Gemini 使用自身 runner 默认模型。
|
|
9
|
+
|
|
10
|
+
Codex/ecagent 缺少显式模型且目录不可用或无匹配项时,分别返回 `CODEX_MODEL_UNAVAILABLE` / `ECAGENT_MODEL_UNAVAILABLE`;ecagent 未选 Provider 且未配置模型也会报错。目录选择只预填运行时有效配置,普通运行不自动写回 Agent/defaults 文件,也不使用内置候选或未经验证的手工目录项代替真实列表。
|
|
11
|
+
|
|
12
|
+
推理强度优先取 Agent、defaults 配置;Claude/Codex 还可分别读取 CLI 的 `effortLevel` / `model_reasoning_effort`,均未配置时使用模型或 SDK 默认值。
|
|
4
13
|
|
|
5
14
|
`ec model` 修改 Agent 级持久化配置,对该 Agent 所有会话的下一条消息生效。
|
|
6
15
|
|
|
@@ -22,7 +31,7 @@ ec model use <model-id> --self <aid> [--effort <level>]
|
|
|
22
31
|
# 设置 Agent 级推理强度:low | medium | high | xhigh | max | auto
|
|
23
32
|
ec model effort <level> --self <aid>
|
|
24
33
|
|
|
25
|
-
# 清除 Agent
|
|
34
|
+
# 清除 Agent 级模型和推理强度,回落到较低优先级配置
|
|
26
35
|
ec model reset --self <aid>
|
|
27
36
|
|
|
28
37
|
# 诊断网关连通性、模型目录和 Agent 级模型可用性
|
|
@@ -38,7 +47,7 @@ ec model check [--self <aid>]
|
|
|
38
47
|
| `--self <aid> --role <role>` | 按角色策略预览有效模型 | 只读;角色策略由角色策略编辑器管理 |
|
|
39
48
|
| `--self <aid> --peer <peer>` | 按该对端的关系角色预览有效模型 | 只读;`use` / `effort` / `reset` 带 `--peer` 直接拒绝(`MODEL_AGENT_ONLY`) |
|
|
40
49
|
|
|
41
|
-
|
|
50
|
+
角色策略对解析出的模型应用白名单或固定模型约束。`--peer` 使用 `channelType#channelId`;裸 AID 按 `aun#<aid>` 处理。`effort auto` 清除 Agent 级强度后,会回落到 defaults 或本机 CLI 的强度;都没有时使用 SDK 默认。
|
|
42
51
|
|
|
43
52
|
在 EvolCore 托管会话中,所有 `ec model` 子命令都通过 daemon 的 `ec ctl` 路径作用于已认证的当前会话,不能指定 `--self`、`--peer` 或 `--role`;上表的显式参数只用于宿主终端。需要读取或修改持久化模型配置时,使用 `ec config`,由 daemon 按实际角色和目标范围鉴权。本机终端不具备隐式当前会话语义。
|
|
44
53
|
|
|
@@ -51,7 +60,7 @@ ec model check [--self <aid>]
|
|
|
51
60
|
- `use`、`effort`、`reset` 只能写 Agent 级,且只有当前 Agent 的 owner / admin(或 DaemonOwner)可以执行;这是代码级上限,角色文件授予 `model.*` 也不能让其他角色写入。member、visitor 只能查看。
|
|
52
61
|
- 本地终端直接运行时不伪造远端角色。显式传入 `--role` 可检查该角色的模型可见性和有效模型。
|
|
53
62
|
- `use`、`effort`、`reset` 不直接修改角色策略;传入 role 写作用域会返回 `ROLE_POLICY_MANAGED`。
|
|
54
|
-
- `check` 会连接已配置的模型网关并发送最小探测请求;未配置自定义网关时跳过 API
|
|
63
|
+
- `check` 会连接已配置的模型网关并发送最小探测请求;未配置自定义网关时跳过 API 探测。模型检查显示实际解析结果及来源。
|
|
55
64
|
|
|
56
65
|
## 模型参数与执行窗口
|
|
57
66
|
|
|
@@ -84,7 +84,7 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
|
|
|
84
84
|
`declined` 的私聊目标加入本 Agent 联系人簿并设为 `active`,然后继续发送。`blocked` 目标仍会拒绝发送,必须先执行:
|
|
85
85
|
|
|
86
86
|
```bash
|
|
87
|
-
ec
|
|
87
|
+
ec peer unblock <target-aid> --self <self-aid>
|
|
88
88
|
```
|
|
89
89
|
|
|
90
90
|
`ec group send` 走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# `ec pa-workspace`
|
|
2
|
+
|
|
3
|
+
个人助理工作区的入口导航由 Core 保存。这个命令只在当前 Agent 与其 Owner 的 AUN 私聊托管会话中可用;App 通过 `pa-workspace` Menu 查询读取结果。
|
|
4
|
+
|
|
5
|
+
## 初始化工作区
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
ec pa-workspace init --workspace "<工作区绝对路径>"
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Core 会运行原有 `personal-assistant` Skill 初始化脚本;只有 Skill 成功完成后,Core 才登记传入的同一工作区路径并发布默认入口。目录已有非工作区内容时,Skill 会拒绝初始化且 Core 保持未绑定;确认保留现有内容并初始化后,可显式加 `--force` 重试。需要安装 Skill 自带 trigger 时可加 `--with-triggers`。
|
|
12
|
+
|
|
13
|
+
已有工作区若不需要再次运行 Skill,可用 `ec pa-workspace bind --workspace "<工作区绝对路径>"` 登记。绑定只保存访问映射,不搬动或改写工作区文件。
|
|
14
|
+
|
|
15
|
+
## 先查看当前导航
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
ec pa-workspace navigation show
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
输出包含 `workspaceId`、`navigationRevision` 和 `entries`。`entries` 中每项至少有:
|
|
22
|
+
|
|
23
|
+
- `id`:入口稳定标识;修改标题或排序时应保留
|
|
24
|
+
- `title`:App 展示的入口名称
|
|
25
|
+
- `path`:工作区根目录下的相对路径,不能是绝对路径、不能穿越根目录、不能指向隐藏运行时目录
|
|
26
|
+
- `kind`:`file` 或 `directory`
|
|
27
|
+
- `order`:数值越小越靠前
|
|
28
|
+
- `availability`:`available` 或 `unavailable`
|
|
29
|
+
|
|
30
|
+
初始化工作区时 Core 会注册报告、任务、沉淀、对话档案、笔记和链接收藏等默认入口,即使目录暂时没有内容也会保留入口并标记为不可用。
|
|
31
|
+
|
|
32
|
+
## 更新导航
|
|
33
|
+
|
|
34
|
+
更新前必须先读取当前 revision。把完整的新入口数组作为 JSON 传入,并使用读取到的 revision 做并发校验:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
ec pa-workspace navigation update --expected-revision 3 --entries-json '[{"id":"reports","title":"报告","path":"output/reports","kind":"directory","order":10}]'
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
更新是完整替换,不是局部 patch。要保留的入口必须一并传回;`id` 和 `path` 不能重复。目标不存在时可以显式使用 `"availability":"unavailable"` 并提供 `"reason"`,这样可以先发布入口,目录创建后再刷新状态。
|
|
41
|
+
|
|
42
|
+
成功后 revision 会递增,返回新的导航状态。若 revision 已变化,命令返回 `CONFLICT`;重新执行 `navigation show`、合并用户仍要保留的入口后再提交,不能覆盖并发修改。
|
|
43
|
+
|
|
44
|
+
## 约束
|
|
45
|
+
|
|
46
|
+
- 这是导航元数据写入,不是文件写入;App 仍然只读。
|
|
47
|
+
- 入口路径只能落在已绑定的 PA 工作区内,Core 会再次校验真实路径和入口类型。
|
|
48
|
+
- `bind` 只用于 PA 初始化或更换工作区,不能在普通关系、群聊或只读任务中调用。
|
|
49
|
+
- 不要把 `manifest` 作为对象名称,也不要把绝对主机路径发给 App。
|
|
50
|
+
|
|
51
|
+
示例参数和权限行为对应 `src/cli/pa-workspace-command.ts`、`src/ipc.ts` 与 `src/core/command/pa-workspace-store.ts`。
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# ec peer — 对端身份与本地拉黑
|
|
2
|
+
|
|
3
|
+
`ec peer` 管理指定 Agent 的**对端身份表** `peers.json`:跨渠道别名映射、展示名,以及本地拉黑状态。
|
|
4
|
+
|
|
5
|
+
它**不是**联系人管理入口。谁能联系这个 Agent 由 Owner 在 Evol App 的联系人名录里决定,
|
|
6
|
+
准入按名录归属分三档(见 `config.md` 的「Agent 消息准入策略」)。添加联系人、审批入群申请都由 Owner 完成,
|
|
7
|
+
Agent 侧不提供这些命令。
|
|
8
|
+
|
|
9
|
+
`peers.json` 与 Owner 名录副本 `contacts.json` 是两份不同的文件:后者是 Owner 侧推下来的只读名录,
|
|
10
|
+
前者是本 Agent 自己的身份映射表。
|
|
11
|
+
|
|
12
|
+
## 命令
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
ec peer block <aid> --self <agent-aid>
|
|
16
|
+
ec peer unblock <aid> --self <agent-aid>
|
|
17
|
+
ec peer list --blocked [--self <agent-aid>]
|
|
18
|
+
ec peer list --all [--self <agent-aid>]
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
支持 `--format json`。本机 `list` 省略 `--self` 时聚合全部 Agent;写操作在仅有一个 Agent 时可自动推断,
|
|
22
|
+
多 Agent 环境必须显式指定,避免误操作错误 Agent。
|
|
23
|
+
|
|
24
|
+
## 约束
|
|
25
|
+
|
|
26
|
+
- `<aid>` 和 `--self` 必须是合法 AID。
|
|
27
|
+
- 拉黑针对 canonical AID,因此会拒绝它在 AUN 以及所有已绑定外部渠道中的私聊入站。
|
|
28
|
+
- `block/unblock` 只接受已经存在于 `peers.json` 的对端;不存在时返回 `NOT_FOUND`。
|
|
29
|
+
想让某个从未交互过的 AID 出现在这里,需要先有一次真实交互。
|
|
30
|
+
- Agent owner 不能被拉黑。
|
|
31
|
+
- `list --blocked` 只列出已拉黑的对端;`list --all` 列出全部已登记对端。指定 `--self` 时返回该 Agent 的
|
|
32
|
+
`peerRevision`,本机省略 `--self` 时按 Agent 聚合。
|
|
33
|
+
- 删除角色关系或撤销 Owner 后,既有身份映射与拉黑状态仍保留。
|
|
34
|
+
|
|
35
|
+
## 权限边界
|
|
36
|
+
|
|
37
|
+
直接从本机终端运行时,这是本地管理命令。
|
|
38
|
+
|
|
39
|
+
从 Agent 活动任务执行时,CLI 不直接写文件,而是携带当前 session delegation token 调用 daemon `peer.op`:
|
|
40
|
+
|
|
41
|
+
| 操作 | owner | admin | 普通角色 |
|
|
42
|
+
|---|---:|---:|---:|
|
|
43
|
+
| `list --blocked/--all` | 允许 | 允许 | 拒绝 |
|
|
44
|
+
| `block` / `unblock` | 允许 | 拒绝 | 拒绝 |
|
|
45
|
+
|
|
46
|
+
缺少、伪造、撤销或跨会话 delegation token 时失败关闭。托管调用省略 `--self` 时使用 delegation 中的当前 Agent;
|
|
47
|
+
显式 `--self` 必须等于当前任务所属 Agent。
|
|
48
|
+
|
|
49
|
+
角色管理使用 Role Menu relation assignment;admin 的授予和撤销必须由 owner 执行。
|
|
50
|
+
|
|
51
|
+
## JSON 输出
|
|
52
|
+
|
|
53
|
+
拉黑成功:
|
|
54
|
+
|
|
55
|
+
```json
|
|
56
|
+
{
|
|
57
|
+
"ok": true,
|
|
58
|
+
"operation": "set-blocked",
|
|
59
|
+
"selfAid": "bot.agentid.pub",
|
|
60
|
+
"primaryId": "peer.agentid.pub",
|
|
61
|
+
"blocked": true,
|
|
62
|
+
"changed": true,
|
|
63
|
+
"peerRevision": "..."
|
|
64
|
+
}
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## 拉黑后的消息行为
|
|
68
|
+
|
|
69
|
+
- AUN 和已绑定外部私聊身份的入站在 MessageBridge 业务入口被拦截,不进入 menu/auth/command/session/queue/LLM。
|
|
70
|
+
- 本地拉黑优先于准入档位与 `access.allowedAids`,但 Owner 与个人助理不受影响。
|
|
71
|
+
- 群聊的准入单位是整个群,不按发言人判定;群内消息不会因为发言者被本地拉黑而丢弃。
|
|
72
|
+
- 对 `ai`、`bot`、`agent`、`service` 类型的私聊对端,可限频返回 `[rejection] Not accepting messages from you.`。
|
|
73
|
+
- 入站正文中的 `[rejection]` 没有协议控制语义。发送者未被本 Agent 拉黑时,该文本正常进入响应式会话。
|
|
@@ -102,6 +102,9 @@ ec thread status <threadId> completed # pending|in_progress|completed|archive
|
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
主话题可以改名(落在会话存档的 `name` 字段),但**不能**打标签或改状态——label/status 只对话题生效。
|
|
105
|
+
`current` 可能解析到主话题;执行状态更新前先运行 `ec thread show current --format json`,确认
|
|
106
|
+
`threadId` 是 `thread-...`。若是 `main:...`(显示为 `[主话题]`),跳过 `ec thread status`,
|
|
107
|
+
只写 summary 或直接回复结果。
|
|
105
108
|
`ec thread list` / `show` 里主话题的名称带 `[主话题] ` 前缀,该前缀只在展示层加,不是真实名字。
|
|
106
109
|
|
|
107
110
|
`summary set ... --name` 对主话题同样生效,改名走与 `ec thread rename` 相同的路径。
|
|
@@ -374,4 +377,4 @@ ec thread check-index # 同 rebuild-index --check
|
|
|
374
377
|
|
|
375
378
|
如果手动填写了 `origin.session` 字段,系统会校验它是否与推导结果一致。不一致时配置解析会报错。
|
|
376
379
|
|
|
377
|
-
**推荐做法**:只填 `threadId`,让系统自动推导 `session` 字段。
|
|
380
|
+
**推荐做法**:只填 `threadId`,让系统自动推导 `session` 字段。
|
package/kits/eck_manifest.json
CHANGED
|
@@ -112,6 +112,27 @@
|
|
|
112
112
|
},
|
|
113
113
|
"description": "本端向该对端的自我介绍流水"
|
|
114
114
|
},
|
|
115
|
+
{
|
|
116
|
+
"id": "owner-directory",
|
|
117
|
+
"type": "file",
|
|
118
|
+
"file": "$AGENT_DIR/directory/directory.md",
|
|
119
|
+
"order": 29,
|
|
120
|
+
"needsInjection": false,
|
|
121
|
+
"optional": true,
|
|
122
|
+
"when": {
|
|
123
|
+
"and": [
|
|
124
|
+
{
|
|
125
|
+
"var": "hasOwnerDirectory",
|
|
126
|
+
"eq": true
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"var": "lifecycle",
|
|
130
|
+
"eq": "active"
|
|
131
|
+
}
|
|
132
|
+
]
|
|
133
|
+
},
|
|
134
|
+
"description": "Owner 名录:Owner、个人助理、内部联系人、外部联系人与加入的群"
|
|
135
|
+
},
|
|
115
136
|
{
|
|
116
137
|
"id": "relation-layer",
|
|
117
138
|
"type": "file",
|
package/kits/rules/06-channel.md
CHANGED
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
|
|
38
38
|
## 命令集
|
|
39
39
|
|
|
40
|
-
**重要**:遇到明确触发词(费用/用量/统计/创建/查群/远程 daemon
|
|
40
|
+
**重要**:遇到明确触发词(费用/用量/统计/创建/查群/远程 daemon 诊断/改配置/个人助理工作区入口调整等)时,优先查 `$KITS_DOCS/evolcore/INDEX.md`
|
|
41
41
|
或直接试对应 ec 命令。`[commands]` 段仅列常用命令,完整目录在 INDEX.md。
|
|
42
42
|
|
|
43
43
|
所有命令以 `ec` 为前缀,以自己的 AID 为发送者。**运行时按当前场景(有无对端/群、对端角色)注入的精简能力卡由 `commands` fragment 决定**(见动态注入的 `[commands]` 段)。
|