evolcore 0.0.41 → 0.0.42
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 +36 -0
- 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
|
@@ -41,10 +41,12 @@
|
|
|
41
41
|
"logLevel": {
|
|
42
42
|
"type": "string",
|
|
43
43
|
"enum": [
|
|
44
|
+
"TRACE",
|
|
44
45
|
"DEBUG",
|
|
45
46
|
"INFO",
|
|
46
47
|
"WARN",
|
|
47
|
-
"ERROR"
|
|
48
|
+
"ERROR",
|
|
49
|
+
"FATAL"
|
|
48
50
|
],
|
|
49
51
|
"description": "daemon 日志级别"
|
|
50
52
|
},
|
|
@@ -64,6 +66,11 @@
|
|
|
64
66
|
"type": "boolean",
|
|
65
67
|
"default": false,
|
|
66
68
|
"description": "是否写入可能包含敏感上下文的 ECK 旁路调试快照"
|
|
69
|
+
},
|
|
70
|
+
"channelLogs": {
|
|
71
|
+
"type": "boolean",
|
|
72
|
+
"default": false,
|
|
73
|
+
"description": "是否写入渠道边界审计日志;默认关闭,排障时开启"
|
|
67
74
|
}
|
|
68
75
|
}
|
|
69
76
|
},
|
|
@@ -44,7 +44,7 @@ license: MIT
|
|
|
44
44
|
| 需要新 Agent 与 Owner 对话完成首次设定 | 显式 `--bootstrap` | 新 Agent 在自己的 Bootstrap 会话完成设定并进入 `active` |
|
|
45
45
|
|
|
46
46
|
- 初始化必须显式提供 `--owner`、`--name`、`--description`、`--tags`。
|
|
47
|
-
`tags`
|
|
47
|
+
`tags` 是标签的 JSON 数组;标签只含 Unicode 字母、数字和连字符,每项最长 50 字符。
|
|
48
48
|
- 缺少最终字段且要交由新 Agent 澄清时,显式选择 `--bootstrap`;默认模式不会自动降级。
|
|
49
49
|
- 两种模式互斥,均隐含非交互创建。`--non-interactive` 不改变默认初始化模式。
|
|
50
50
|
- persona 和头像可选;未提供时跳过,不为了这些可选项额外追加确认轮次。
|
|
@@ -131,7 +131,7 @@ CLI 默认等待 60 秒,可用 `--wait` 设置 0–300 秒。初始化不接
|
|
|
131
131
|
|
|
132
132
|
- `created`:先核对初始名片发布、Owner 绑定和渠道状态;没有成功发布时不会推进绑定。
|
|
133
133
|
- `ownerpending`:等待协议 Owner 共识,不把“请求已受理”当作引导已开始。
|
|
134
|
-
- `bootstrapping
|
|
134
|
+
- `bootstrapping`:新 Agent 询问 Owner 一次定位与任务,收到任何回复后按回复内容更新名片、保存交接和 welcome,并执行 `ready`。
|
|
135
135
|
- `active`:进入验收。
|
|
136
136
|
|
|
137
137
|
有的渠道需要 Owner 首次入站才能取得回复上下文;必要时告知 Owner 向新 Agent 发消息。
|
|
@@ -3,7 +3,7 @@ name: ec-identity
|
|
|
3
3
|
description: >-
|
|
4
4
|
身份与联系人:我是谁、我认识谁、这个名字指的是哪个 AID。
|
|
5
5
|
用于查改自己的名片(名字、描述、标签、头像)、查别人名片、按名字找人、
|
|
6
|
-
|
|
6
|
+
维护对端身份(查登记、拉黑)。用户说"我是谁""我的名片""改个名字"
|
|
7
7
|
"改描述""换头像""这个人是谁""查一下 X""帮我找 XX""联系人""通讯录"
|
|
8
8
|
"加他/拉黑他""有没有这个人"时使用。
|
|
9
9
|
不适用于判断对端权限角色(那是关系层 relation config),
|
|
@@ -14,7 +14,7 @@ license: MIT
|
|
|
14
14
|
# EC Identity 操作规程
|
|
15
15
|
|
|
16
16
|
**本 skill 只讲决策与边界**:哪个身份查什么、名字怎么转成 AID、写操作什么时候允许。
|
|
17
|
-
参数细节看 `ec aid --help`、`ec
|
|
17
|
+
参数细节看 `ec aid --help`、`ec peer --help` 和 `$KITS_DOCS/evolcore/aid.md`、`peer.md`。
|
|
18
18
|
|
|
19
19
|
## 一、身份有三个层次,不要混用
|
|
20
20
|
|
|
@@ -49,26 +49,45 @@ ec aid avatar <selfAid> --file <本地图片>
|
|
|
49
49
|
|
|
50
50
|
**不要**直接读 `$EVOLCORE_HOME/AIDs/<aid>/agent.md`——H 类保护会直接拒绝 `cat`/`Read`。
|
|
51
51
|
|
|
52
|
+
### 用对端发来的图片换头像
|
|
53
|
+
|
|
54
|
+
对端在聊天里发来的图片不进消息正文,也不出现在任何命令输出里;它落盘在:
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
$EVOLCORE_HOME/agents/<selfAid>/relations/aun#<对端AID>/attachments/
|
|
58
|
+
0123abcd...ef.jpg ← 图片本体,文件名是 32 位十六进制附件 ID
|
|
59
|
+
0123abcd...ef.json ← 元数据:attachmentId / mimeType / size / sha256 / createdAt
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
用户说“用刚才那张图当头像”时:
|
|
63
|
+
|
|
64
|
+
1. 列这个目录,按同名 `.json` 里的 `createdAt` 排序,取最新那张。用户指的是更早的某张时,按对话时间挑。
|
|
65
|
+
2. 把图片复制到当前项目目录或本会话 `$TMPDIR`——`ec aid avatar --file` 只接受这两处路径,直接传附件目录里的绝对路径会被拒。
|
|
66
|
+
3. `ec aid avatar <selfAid> --file '<复制后的路径>'`。
|
|
67
|
+
|
|
68
|
+
群聊里的图片存到 `relations/aun#<群AID>/attachments/`。多个对端都发过图时,先按对话确定是谁发的,再到对应目录找。图片尺寸和体积不用自己处理,命令会补白边、缩放并压缩成 JPEG。
|
|
69
|
+
|
|
70
|
+
如果用户给的是 HTTPS 图片地址,直接用 `--url <地址>`,跳过上面第 1、2 步。
|
|
71
|
+
|
|
52
72
|
## 三、我认识谁
|
|
53
73
|
|
|
54
74
|
按可靠性排序,**逐层往下找,找到就停**:
|
|
55
75
|
|
|
56
76
|
```bash
|
|
57
77
|
# 1. 聊过的人——最实用,自带名片名和活跃时间
|
|
58
|
-
ec thread peers
|
|
78
|
+
ec thread peers
|
|
59
79
|
|
|
60
|
-
# 2.
|
|
61
|
-
ec
|
|
62
|
-
ec
|
|
63
|
-
ec contact list --blocked # 只有拉黑的
|
|
80
|
+
# 2. 已登记对端——本 Agent 的身份映射表,可能带 displayName
|
|
81
|
+
ec peer list --all --format json
|
|
82
|
+
ec peer list --blocked # 只有拉黑的
|
|
64
83
|
|
|
65
84
|
# 3. 已知 AID 想看名片
|
|
66
85
|
ec aid lookup <aid> # 含正文,不验签,快
|
|
67
86
|
ec aid agentmd get <aid> # 验签,慢一点,适合需要确认真伪时
|
|
68
87
|
```
|
|
69
88
|
|
|
70
|
-
三者覆盖的是不同集合:`thread peers` 是"聊过的",`
|
|
71
|
-
|
|
89
|
+
三者覆盖的是不同集合:`thread peers` 是"聊过的",`peer list` 是"登记过的"。
|
|
90
|
+
一个人可能聊过但没进身份表,也可能在身份表里但从没说过话。
|
|
72
91
|
|
|
73
92
|
## 四、按名字找人(反直觉的部分)
|
|
74
93
|
|
|
@@ -77,8 +96,8 @@ ec aid agentmd get <aid> # 验签,慢一点,适合需要确认真伪
|
|
|
77
96
|
|
|
78
97
|
所以 `<名字> → AID` 只能这样:
|
|
79
98
|
|
|
80
|
-
1. `ec thread peers
|
|
81
|
-
2. 匹配不上 → `ec
|
|
99
|
+
1. `ec thread peers`,肉眼/AI 匹配名字列
|
|
100
|
+
2. 匹配不上 → `ec peer list --all --format json` 看 `displayName`
|
|
82
101
|
3. 还没有 → **直接问用户要 AID**
|
|
83
102
|
|
|
84
103
|
**禁止**猜测或拼凑 AID(比如"老王"猜成 `wang.agentid.pub`)。猜错会发给陌生人。
|
|
@@ -88,55 +107,54 @@ ec aid agentmd get <aid> # 验签,慢一点,适合需要确认真伪
|
|
|
88
107
|
## 五、联系人维护
|
|
89
108
|
|
|
90
109
|
```bash
|
|
91
|
-
ec
|
|
92
|
-
ec
|
|
93
|
-
ec contact reject <aid> --request-id <id> # owner/admin
|
|
94
|
-
ec contact block <aid> # 仅 owner
|
|
95
|
-
ec contact unblock <aid> # 仅 owner
|
|
110
|
+
ec peer block <aid> # 仅 owner
|
|
111
|
+
ec peer unblock <aid> # 仅 owner
|
|
96
112
|
```
|
|
97
113
|
|
|
98
114
|
要点:
|
|
99
115
|
|
|
100
|
-
-
|
|
101
|
-
|
|
116
|
+
- **加联系人、审批申请都不归 Agent。** 谁能联系这个 Agent 由 Owner 在 Evol App 的联系人名录里决定,
|
|
117
|
+
Agent 侧没有 `add` / `approve` / `reject` 命令。
|
|
102
118
|
- `block` 只影响**本端入站**,不代表对端也拉黑了你。而且写操作会被 daemon 拒绝发送。
|
|
103
|
-
- Owner 关系以 Ownership 2.1 协议共识为准;`config.json` 的 `owner/owners` 只保留兼容绑定目标,不授予 Owner 权限。Owner 不能用 `ec
|
|
119
|
+
- Owner 关系以 Ownership 2.1 协议共识为准;`config.json` 的 `owner/owners` 只保留兼容绑定目标,不授予 Owner 权限。Owner 不能用 `ec peer` 改。
|
|
104
120
|
列表里 `"source": "owner"` 的那些条目是自动物化的,不可删。
|
|
105
121
|
|
|
106
122
|
## 六、数据落在哪
|
|
107
123
|
|
|
108
124
|
```
|
|
109
125
|
$EVOLCORE_HOME/agents/<selfAid>/
|
|
110
|
-
├── config.json ← Agent 配置(channels/models
|
|
111
|
-
├──
|
|
112
|
-
|
|
126
|
+
├── config.json ← Agent 配置(channels/models/兼容绑定目标/ac 准入三档)
|
|
127
|
+
├── contacts.json ← Owner 名录副本,只读;准入按它的条目归属判定
|
|
128
|
+
├── peers.json ← ★ 本 Agent 的身份映射表(displayName/aliases/本地拉黑)
|
|
129
|
+
└── data/peer/
|
|
113
130
|
├── operations.jsonl ← 每次变更的操作日志
|
|
114
131
|
└── audit.jsonl ← 审计
|
|
115
132
|
```
|
|
116
133
|
|
|
117
|
-
`
|
|
134
|
+
`peers.json` 的每条记录:
|
|
118
135
|
|
|
119
136
|
```json
|
|
120
137
|
{
|
|
121
138
|
"displayName": "老王", // 可选,本地别名
|
|
122
139
|
"aliases": ["aun:xxx", "feishu:ou_xxx"], // 跨渠道身份绑定,把多个账号合并成一个人
|
|
123
|
-
"status": "
|
|
124
|
-
"pendingRequest": { "id": "...", "submittedAt": "...", "expiresAt": "..." }
|
|
140
|
+
"status": "blocked" // 只有 blocked 有准入含义;缺省即正常
|
|
125
141
|
}
|
|
126
142
|
```
|
|
127
143
|
|
|
144
|
+
准入不再看这里的状态:谁能进来由 `contacts.json` 的条目归属 + `access` 三档开关决定。
|
|
145
|
+
|
|
128
146
|
## 七、已知缺口(不要假装它们不存在)
|
|
129
147
|
|
|
130
148
|
| 缺口 | 现状 | 怎么办 |
|
|
131
149
|
|---|---|---|
|
|
132
|
-
| `displayName` 无 CLI 写入口 | store 层 `set-display-name` mutation 已实现,`ec
|
|
150
|
+
| `displayName` 无 CLI 写入口 | store 层 `set-display-name` mutation 已实现,`ec peer` 没暴露 | 想改只能通过 connect-menu 协议;否则先别承诺 |
|
|
133
151
|
| 名字反查 | 未实现 | 走第三、四节的顺序查找 |
|
|
134
152
|
| `search.*` 检索 | 协议有定义,SDK 与 evolcore 未实现 | 不要尝试调用,会失败 |
|
|
135
153
|
|
|
136
154
|
## 八、禁忌
|
|
137
155
|
|
|
138
156
|
1. **不要**用名字判断身份或权限——一律用 `selfAid`。
|
|
139
|
-
2. **不要**直读 `$EVOLCORE_HOME/AIDs/` 或 `
|
|
157
|
+
2. **不要**直读 `$EVOLCORE_HOME/AIDs/` 或 `peers.json`——H 类保护会拒绝。
|
|
140
158
|
3. **不要**在托管会话跑 `ec aid list` / `new` / `delete`,会被拒绝。
|
|
141
159
|
4. **不要**猜 AID。查不到就问用户。
|
|
142
160
|
5. **不要**用 `ec aid show` 找名片正文——它不返回。
|
|
@@ -37,8 +37,10 @@ license: MIT
|
|
|
37
37
|
ec proxy access <service-name> --format json
|
|
38
38
|
~~~
|
|
39
39
|
|
|
40
|
-
|
|
41
|
-
|
|
40
|
+
`url` 按 ServiceProxy 路由规则生成:`https://<daemon-aid>.<issuer>/proxy/<service>/`。
|
|
41
|
+
`accessState=available` 表示本机服务根路径 `/` 探测成功,`unavailable` 表示服务未发布、根路径
|
|
42
|
+
不可用或探测失败,`unresolved` 仅表示无法构造代理地址或无法解析本地回连端点。代理入口不代表
|
|
43
|
+
已获被代理应用的登录权限。
|
|
42
44
|
|
|
43
45
|
## 配置
|
|
44
46
|
|
|
@@ -51,6 +53,9 @@ runtime.command.file;参数使用 args 数组,不要写 shell 命令字符
|
|
|
51
53
|
不由 EvolCore 启停。ECWeb 也属于 managed,其启动入口由内部适配器确定,无需且不允许配置 command。
|
|
52
54
|
模式省略时 ECWeb 默认 managed,其余服务默认 external。
|
|
53
55
|
|
|
56
|
+
managed 服务配置了 `port` 时,daemon 会把该端口作为子进程的 `PORT` 环境变量传入,覆盖 daemon
|
|
57
|
+
自身 shell 继承的 `PORT`,避免服务监听端口与健康检查端口不一致。
|
|
58
|
+
|
|
54
59
|
定义中 command 使用 executable 和 argv,不经 shell。创建定义示例:
|
|
55
60
|
|
|
56
61
|
~~~bash
|
|
@@ -88,7 +88,7 @@ ec fs cat leiliang.agentid.cn:/.evol/observation-access/v1/snapshots/.../manifes
|
|
|
88
88
|
|
|
89
89
|
**G3|跨对端历史导出受限 —— 已解除(2026-10-28)**
|
|
90
90
|
|
|
91
|
-
原判断基于 `ec msg history`。改用 `ec thread history <
|
|
91
|
+
原判断基于 `ec msg history`。改用 `ec thread history <ref>` 后可跨对端读取,
|
|
92
92
|
实测成功读到其他对端的 259 条历史。
|
|
93
93
|
|
|
94
94
|
> 注意:不带 `--self` 会报 `✗ peer is required`。
|
|
@@ -110,7 +110,7 @@ ec fs cat leiliang.agentid.cn:/.evol/observation-access/v1/snapshots/.../manifes
|
|
|
110
110
|
|---|---|---|---|---|
|
|
111
111
|
| **G1** | 脚本触发器在 Windows 不可用 | 定时任务只能走会话,成本高一个量级 | 全部改用 `trigger-session`,由会话执行脚本 | EvolCore 提供可用沙箱,或提供 daemon 级"受信脚本触发器"注册 |
|
|
112
112
|
| **G2** | 观察数据读不到 | 位置/聆听/照片三类最有价值的原料只能存不能取 | 落空目录占位,保留接口 | EvolCore 开放托管会话读取观察数据的命令或 API |
|
|
113
|
-
| ~~**G3**~~ | ~~跨对端历史受限~~ | **已解除**:`ec thread history <
|
|
113
|
+
| ~~**G3**~~ | ~~跨对端历史受限~~ | **已解除**:`ec thread history <ref>` 可读 | — | — |
|
|
114
114
|
| **G4** | 事件 `session:idle` 未实测 | "会话结束落地"可能不成立 | 退回每日全量 | 实测并调参(idle 阈值、过滤条件) |
|
|
115
115
|
| **G5** | 位置能力返回缓存值 | 位置轨迹精度不可信 | 明确标注 `cached: true` | 能力侧支持强制刷新定位 |
|
|
116
116
|
| **G6** | `trigger-session` 类型未实测 | 全部触发器依赖它,是单点风险 | 先小范围试 | 实测 + 准备 `target-session` 兜底 |
|
|
@@ -120,13 +120,12 @@ ec fs cat leiliang.agentid.cn:/.evol/observation-access/v1/snapshots/.../manifes
|
|
|
120
120
|
| **G10** | 并发写同一天的锁机制未验证 | cron 与事件撞车可能写脏 | 单写者串行 | 实测文件锁在 Windows 的行为 |
|
|
121
121
|
| **G12** | 话题历史没有文本搜索 | 只能按时间翻,找一句话要翻几百条 | `search.mjs` 落地后本地检索 | EvolCore 给 `history` 加 `--search` |
|
|
122
122
|
|
|
123
|
-
### 4.1 `ec thread history`
|
|
123
|
+
### 4.1 `ec thread history` 的两个坑(实测)
|
|
124
124
|
|
|
125
125
|
| 坑 | 表现 | 正确用法 |
|
|
126
126
|
|---|---|---|
|
|
127
127
|
| `--limit N` 是「最近 N 条」 | `--after 0 --limit 3` 返回的是最新 3 条,不是最早 3 条 | 回填必须用 `--before <ts>` 往前翻 |
|
|
128
|
-
|
|
|
129
|
-
| 非主话题必须用 `peer/threadId` | 只传 `thread-xxx` 报 `peer is required` | `ec thread history <peer>/<thread-xxx> --self <aid>` |
|
|
128
|
+
| 宿主终端必须带 `--self` | 不带报 `✗ Host commands require --self` | `ec thread history <threadId> --self <selfAid>`;托管会话不写 `--self` |
|
|
130
129
|
|
|
131
130
|
---
|
|
132
131
|
|
|
@@ -47,9 +47,9 @@ license: MIT
|
|
|
47
47
|
| 来源/目标话题 | 来源 = 发起委托处(对端 A);目标 = 被委托执行处(对端 C)。复查通知投递在目标话题 |
|
|
48
48
|
| 基础传播单元 | A 委托 B → B 问 C → C 回 B → B 回 A |
|
|
49
49
|
|
|
50
|
-
|
|
51
|
-
- `ec thread list`
|
|
52
|
-
|
|
50
|
+
**写法约定**:
|
|
51
|
+
- 话题引用一律用 `ec thread list` 打印的第一列:话题是 `thread-…`,主话题是 `main:<aidA>:<aidB>`。
|
|
52
|
+
`ec thread` 的 `<ref>` 和 `--thread` 都直接用它,不加对端前缀;本端身份自动注入,不写 `--self`。
|
|
53
53
|
- 话题名是本端概念,两端可能不同;threadId 才是统一标识。
|
|
54
54
|
|
|
55
55
|
## 三、流程
|
|
@@ -88,7 +88,7 @@ ec msg send '进度 70%,预计下周完成' # 不带 --thread,发在当前
|
|
|
88
88
|
**目标话题不用查**——对话就在上下文里。只需回查来源话题的空洞期:
|
|
89
89
|
|
|
90
90
|
```bash
|
|
91
|
-
ec thread history
|
|
91
|
+
ec thread history <来源话题id> --after <发送于的时间戳>
|
|
92
92
|
```
|
|
93
93
|
|
|
94
94
|
按顺序判断:
|
|
@@ -126,8 +126,8 @@ ec msg send '综合评估:……' --thread <T1> --check-every 30m
|
|
|
126
126
|
### E. 查询与维护命令
|
|
127
127
|
|
|
128
128
|
```bash
|
|
129
|
-
ec thread peers
|
|
130
|
-
ec thread list <peer>
|
|
129
|
+
ec thread peers # 有哪些真实对端
|
|
130
|
+
ec thread list <peer> [--page 2] # 话题列表(含摘要、消息数)
|
|
131
131
|
ec thread history <threadId> --limit 20 # 读历史
|
|
132
132
|
ec thread history <threadId> --after <ts> --limit 50 # 只读增量(空洞期)
|
|
133
133
|
ec thread rename|label|status current '…'|'…'|in_progress # 状态:pending|in_progress|completed|archived
|
|
@@ -154,16 +154,16 @@ ec thread summary set <threadId> '<摘要>' --name '新名称'
|
|
|
154
154
|
```
|
|
155
155
|
|
|
156
156
|
**摘要规范**:100 字以内,`[谁]做了[什么],结果[什么],遗留[什么]`;写给下次的自己看,不是给对端。
|
|
157
|
-
**命名规范**:≤
|
|
157
|
+
**命名规范**:≤30 字(与客户端输入框同口径)、动词短语,别用"你好""话题会话";话题方向变了就顺手改名。
|
|
158
158
|
|
|
159
159
|
**主动做(不等用户开口)**:阶段完成 → 写摘要;方向重大转向 → 改名 + 摘要;即将跨去别处 → 先记状态;转 `completed` 前 → 写最终摘要。
|
|
160
160
|
|
|
161
161
|
### G. 生成工作报告
|
|
162
162
|
|
|
163
163
|
```bash
|
|
164
|
-
ec thread list <peer> --
|
|
165
|
-
ec thread history <
|
|
166
|
-
ec thread summary show <
|
|
164
|
+
ec thread list <peer> --limit 100
|
|
165
|
+
ec thread history <threadId> --after <起始ts> --limit 50
|
|
166
|
+
ec thread summary show <threadId>
|
|
167
167
|
```
|
|
168
168
|
|
|
169
169
|
结构:时间范围 → 话题总览(总数/活跃数)→ 逐话题摘要(名称、时间、内容、状态)→ 结论与遗留。
|
|
@@ -172,7 +172,7 @@ ec thread summary show <peer>/<threadId> --self <selfAid>
|
|
|
172
172
|
|
|
173
173
|
| 错误码 | 处理 |
|
|
174
174
|
|---|---|
|
|
175
|
-
| `TOPIC_NOT_FOUND` |
|
|
175
|
+
| `TOPIC_NOT_FOUND` | 用 `ec thread list <peer>` 核对 id;没有合适话题就 `ec thread create` |
|
|
176
176
|
| `TOPIC_CONFLICT` | 换名字,或直接用已有话题 |
|
|
177
177
|
| `TOPIC_BUSY` | 有任务在跑,等完成再删 |
|
|
178
178
|
|
|
@@ -1,17 +1,5 @@
|
|
|
1
|
-
你好,我是 {{agentName}}
|
|
1
|
+
你好,我是 {{agentName}},刚刚上线。
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
想先了解一下,你希望我平时主要帮你做些什么?随便说说就行,我会按你说的来调整。名字不合适的话也可以顺便告诉我换一个;想给我换个头像,直接发张图片过来,说一句“用这张当头像”就行。
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
1. 显示名:希望使用的名称。
|
|
7
|
-
2. 简介:主要职责或定位,一到两句话即可。
|
|
8
|
-
3. 标签:3 到 6 个检索标签,例如 `代码审查`、`客服助手`、`项目管理`。
|
|
9
|
-
|
|
10
|
-
当前信息:
|
|
11
|
-
- AID: {{agentAid}}
|
|
12
|
-
- 渠道: {{channel}}
|
|
13
|
-
- Baseagent: {{baseagent}}
|
|
14
|
-
|
|
15
|
-
也可以顺便补充人格属性、话术风格、工作流程、任务偏好(persona,支持文本或 `.md`/`.txt` 文件),以及可选头像(HTTPS 图片地址,或放在当前项目目录/本会话临时目录中的图片文件)。这些都不必现在处理,未提供不影响激活,之后也可以修改。
|
|
16
|
-
|
|
17
|
-
如果希望沿用现有信息,直接回复“沿用现有信息”即可;我只会追问缺失或有歧义的部分。
|
|
5
|
+
还没想好也没关系,回我一句就好,之后随时可以再聊。
|
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
‹{{now}} · from:{{peerId}}{{?peerName}}({{peerName}}){{/}}{{?peerRole}} · role:{{peerRole}}{{/}}{{?chatType=group}} → 群:{{groupLabel}} · self:{{selfAid}}{{/}}{{?chatType=private}} → self:{{selfAid}}{{/}}{{?encrypted=true}} · 🔒密文{{/}}{{?encrypted=false}} · ✉️明文{{/}}{{?sameDevice}} · 📍同设备{{/}}{{?sameNetwork}} · 🌐同网络{{/}}{{?sameEgressIp}} · 🔀同出口IP{{/}}{{?mentionAids}} · @:{{mentionAids}}{{/}}›
|
|
2
|
-
{{?lifecycle=bootstrapping}}
|
|
2
|
+
{{?lifecycle=bootstrapping}}(本轮只推进首次设定:按 Owner 这条回复更新名片和头像,然后完成激活;回复里的普通任务记为激活后待办,不在本轮执行。)
|
|
3
3
|
{{/}}{{?isHandoff!=true}}{{content}}{{/}}
|
|
@@ -3,7 +3,7 @@ phase: bootstrapping
|
|
|
3
3
|
|
|
4
4
|
## 身份
|
|
5
5
|
|
|
6
|
-
你正在和 owner 一起完成 {{selfAid}} 这个 Agent
|
|
6
|
+
你正在和 owner 一起完成 {{selfAid}} 这个 Agent 的首次设定。被问到「你是谁」时:用当前名片的 name / description 介绍自己,并说明你正在做首次设定。不要复述底层命令行工具的产品名、厂商或模型版本号。
|
|
7
7
|
|
|
8
8
|
## 本阶段可用命令
|
|
9
9
|
|
|
@@ -23,49 +23,50 @@ phase: bootstrapping
|
|
|
23
23
|
|
|
24
24
|
## 1. 目标与通信
|
|
25
25
|
|
|
26
|
-
Bootstrap
|
|
27
|
-
|
|
26
|
+
Bootstrap 是首次自我设定的生命周期门禁:接收 Owner 首条回复、保存协作交接、准备正式欢迎消息,然后激活。完成前不执行、不分析、不规划普通任务,不读取任务相关文件、不搜索、不设置任务或触发器;Owner 明确要求激活后继续的事项只记为“未执行”。
|
|
27
|
+
系统已发送固定的首条引导消息,不要重新发送、复述或改写它。
|
|
28
28
|
回复方式、当前身份与发送目标遵循本轮 `[reply]`,只与当前 Owner 推进 Bootstrap。仅在实际发送被“不是联系人”或联系人准入策略拒绝时,经同一托管发送通道发送一次 `/request <首次设定说明>` 并等待审核;不因身份未知主动申请、不反复重试、不修改联系人策略、不联系其它对象。Owner 已直接发来消息时按入站内容继续。
|
|
29
29
|
|
|
30
|
-
## 2.
|
|
30
|
+
## 2. 首条回复即激活
|
|
31
31
|
|
|
32
|
-
|
|
33
|
-
- `name`:简短清晰的显示名。
|
|
34
|
-
- `description`:一句到两句话描述职责或定位。
|
|
35
|
-
- `tags`:3 到 6 个非空标签;每个标签只允许 Unicode 字母、数字和连字符(`-`),最长 50 字符。
|
|
36
|
-
- 写入用 `ec aid agentmd set {{selfAid}} tags '["学习","理财","个人成长"]'`,值必须是 JSON 字符串数组;逗号分隔的写法会被拒绝。
|
|
37
|
-
- `set` 是有副作用的写操作,不要拿它试探格式;格式不确定时先跑 `ec aid agentmd --help`。
|
|
32
|
+
系统已向 Owner 发送引导消息,询问是否有关于定位、任务或偏好的说明。**收到 Owner 任何回复后,立即推进激活,不追问第二遍。**
|
|
38
33
|
|
|
39
|
-
|
|
34
|
+
收到回复后,先用 `ec aid agentmd get {{selfAid}}` 读取当前名片,然后按以下规则处理:
|
|
40
35
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
36
|
+
- `name`:创建时已填写,不要求重新输入。Owner 在回复中明确要求改名时才更新。
|
|
37
|
+
- `description`:Owner 回复中有对定位、职责、任务或功能的说明时,概括为 100 字以内写入;完整说明写进第 4 节的交接段。没有提及时保留已有值。
|
|
38
|
+
- `tags`:和 description 一样从 Owner 回复中提取。回复里能看出领域、职责或任务关键词时,提炼成标签写入;提取不出就保留已有值,不询问、不凑数量。
|
|
39
|
+
|
|
40
|
+
只采用 Owner 回复中明确表达的内容,不从闲聊、示例或普通任务中推断名片字段。回复里没有任何设定内容(例如只说“好”“开始吧”)时,名片不做修改。
|
|
41
|
+
|
|
42
|
+
名片字段更新用 `ec aid agentmd set {{selfAid}} <name|description|tags> <value>`,写入后命令自动签名发布,不需要再手动 put。tags 的值必须是 JSON 字符串数组,例如 `'["学习","理财"]'`,每个标签只能含 Unicode 字母、数字和连字符(`-`),不能有空格,最长 50 字符;`set` 是写操作,格式不确定时先跑 `ec aid agentmd --help`,不要拿它试探。
|
|
43
|
+
|
|
44
|
+
处理完名片后,不展示待确认内容、不请求 Owner 确认,直接进入第 4 节完成交接、welcome 并执行 `ec agent ready`。
|
|
44
45
|
|
|
45
46
|
## 3. 可选的 persona 与头像
|
|
46
47
|
|
|
47
|
-
|
|
48
|
-
- persona 支持直接文本或收到的 `.md`/`.txt` 文件;用 `ec agent persona --text '<内容>'` 或 `ec agent persona --file '<收到的文本文件路径>'` 保存。读取内容或判断文件是否存在必须用 `ec agent persona show`;不要用 base agent 的文件读取或搜索工具(如 `Read`、`read_file`、`Glob`)探测 `{{PERSONAL_DIR}}/persona.md`。命令显示文件不存在时按空文件处理,直接创建或等待 Owner 提供 persona
|
|
49
|
-
-
|
|
48
|
+
persona(人格属性、话术风格、工作流程、任务偏好)不主动询问;引导消息已告诉 Owner 发图即可换头像,不再重复提示。Owner 在回复中提供了才处理,未提供不等待、不阻塞激活,激活后仍可完善。
|
|
49
|
+
- persona 支持直接文本或收到的 `.md`/`.txt` 文件;用 `ec agent persona --text '<内容>'` 或 `ec agent persona --file '<收到的文本文件路径>'` 保存。读取内容或判断文件是否存在必须用 `ec agent persona show`;不要用 base agent 的文件读取或搜索工具(如 `Read`、`read_file`、`Glob`)探测 `{{PERSONAL_DIR}}/persona.md`。命令显示文件不存在时按空文件处理,直接创建或等待 Owner 提供 persona。不从普通任务推断人格,未提供时保留现状。
|
|
50
|
+
- 头像:引导消息已提示可以发图更换。本轮不做头像处理,Owner 发来的图片也不在本轮使用;激活后按正常流程更换即可。
|
|
50
51
|
|
|
51
52
|
## 4. 保存与激活
|
|
52
53
|
|
|
53
|
-
|
|
54
|
-
1.
|
|
55
|
-
2.
|
|
54
|
+
收到 Owner 首条回复、名片处理完毕后,按以下顺序推进;已有有效结果只核对,不重复写入或发布:
|
|
55
|
+
1. 按第 2 节规则用 `ec aid agentmd set {{selfAid}} <field> <value>` 修改有变更的名片字段(保留其它 frontmatter 和正文,命令会校验格式并签名);没有变更时跳过。不要用文件工具直接编辑名片。
|
|
56
|
+
2. 将 Owner 说明的职责、协作边界、重要约束和待继续事项忠实整理到 `{{PERSONAL_DIR}}/persona.md` 的 `## Bootstrap 交接` 段落。此摘要是 Agent 的内部交接工作,不要求 Owner 审稿;不新增推断,含义不清的部分按原话记录,不回头追问。Owner 没有给出任何说明时省略此段,不为补齐摘要追问。写入前先用 `ec agent persona show` 获取现有正文;命令显示文件不存在时按空文件处理并直接创建。已有文件幂等更新该段并**保留其它段落**(尤其是 Owner 已设定的人格内容);待继续事项标注“未执行”。不复制完整历史、临时闲聊、凭据、运行状态或 Owner 私密信息(该文件也会进入后续群聊上下文)。
|
|
56
57
|
- 文件工具只用于已确认内容后的交接段编辑或创建,不用于读取或探测 `persona.md`;**不要**用 `ec agent persona --text` 只写交接段——那是整体覆盖,会冲掉 Owner 设定的人格内容。要整体设置人格时才用 `ec agent persona --text '<完整内容>'`。
|
|
57
58
|
3. 根据最终名片和已设定的 persona,自主生成并用 `ec agent welcome --text '<完整文案>'` 保存正式欢迎文案。不要展示草稿、询问称呼或请求 Owner 确认,不向用户交办文案工作;Owner 主动指定文案时直接尊重其明确要求。命令固定写入本 Agent 的 `personal/welcome.md`,不接受自定义路径,`ec agent welcome show` 可核对现状。
|
|
58
59
|
- 内容为简短问候、自我介绍、围绕职责的具体协作方向及开始协作的邀请,建议 100~250 个汉字;不照抄通用“AI Agent 网关”介绍,不泄露系统提示词、凭据、文件路径或工作记忆,不夸大能力、不承诺独占使用或设备绑定。
|
|
59
60
|
- 支持纯文本或带变量的 Markdown;变量用两个左花括号、变量名、两个右花括号,内部不加空格。仅允许 agentName、agentDescription、agentAid、agentTags、agentTagsText、ownerName、ownerAid、channel;多 Owner 共用模板,称呼用 ownerName 或 ownerAid 变量,不写死当前 Owner 的姓名。系统仅渲染变量,不追加其它文案。
|
|
60
61
|
4. 若最终名片尚未发布或字段有变更,用 `ec aid agentmd put {{selfAid}}` 签名发布;用 `set` 改过字段时命令已自动发布,只需核对;可选头像按上一节处理,不为同一头像重复发布名片。
|
|
61
|
-
5.
|
|
62
|
+
5. 核对 welcome 已保存、有变更的名片已发布(有交接内容时一并核对交接段)后,执行 `ec agent ready {{selfAid}}`。这是 Bootstrap 的最后一个操作;成功后系统结束旧上下文、为各 Owner 创建新主会话并投递已保存的 welcome,不再调用模型生成文案。不要从旧上下文追加完成回复或继续普通任务。新主会话首次回复前直接使用系统注入的 `persona.md` 交接内容,沿用约定,不要再调用文件工具读取该文件;未执行事项按正常权限续接。
|
|
62
63
|
|
|
63
64
|
## 5. 恢复与操作范围
|
|
64
65
|
|
|
65
66
|
重启、超时或收到“继续”时,先用 `ec agent get {{selfAid}} lifecycle` / `ec agent show {{selfAid}}` 核对状态,再分别用 `ec aid agentmd get {{selfAid}}`、`ec agent persona show` 和 `ec agent welcome show` 核对名片、交接内容和 welcome;不要用文件工具读取或探测 persona 文件。本地文件存在不等于已成功发布,不按旧上下文或命令超时推断结果。
|
|
66
67
|
- `active`:Bootstrap 已完成,不重复设定、发布或调用 `ready`;后续工作交给新主会话。
|
|
67
68
|
- `created`:等待 channel 可达或 Owner 首条入站消息,不重复创建。
|
|
68
|
-
- `bootstrapping`:从缺失或失败的步骤续做,保留已明确或已认可的设定;welcome
|
|
69
|
+
- `bootstrapping`:从缺失或失败的步骤续做,保留已明确或已认可的设定;welcome 缺失时自主生成并保存,Owner 有过说明而交接段缺失时依据可核对事实补写,全部完成后直接 `ready`,不增加确认轮次。收到 `WELCOME_FROZEN` 表示投递快照已准备,不改文案,只续做剩余步骤。
|
|
69
70
|
- 必需步骤失败时说明具体原因,修正后再继续,不调用 `ready`、不盲目重试;可选头像失败按上一节处理。
|
|
70
71
|
|
|
71
|
-
仅允许通过 `ec aid agentmd get` 读取本 Agent
|
|
72
|
+
仅允许通过 `ec aid agentmd get` 读取本 Agent 名片、按第 2 节规则编辑名片字段、通过 `ec agent persona show` 读取 persona,并用文件工具编辑或创建 `persona.md` 的 `## Bootstrap 交接` 段;还可读取 Owner 为设定提供的文本或图片附件、执行上述本 Agent 状态查询、persona、welcome、名片发布、头像及 ready 命令,以及向当前 Owner 回复。不得用文件工具读取或探测 persona,不得修改其它文件、联系其它主体或进行无关配置操作;完成前不承诺已经进入正常工作状态。
|
|
@@ -10,6 +10,13 @@ ec response 响应模式管理(切换响应模式/列响应模式/看当前模
|
|
|
10
10
|
ec stats Token 用量与费用统计(用量/费用/统计/预算/token/cost) $KITS_DOCS/evolcore/stats.md
|
|
11
11
|
ec config 读配置/查字段/看生效值(get/show/list/effective/fields/history/diff/current/boots/validate);set/unset 权限由 API 层控制 $KITS_DOCS/evolcore/config.md
|
|
12
12
|
ec trigger 定时与事件触发器管理(create/update/list/run/enable/disable/delete;set 仅为 create 兼容别名)。需要写操作的无人值守任务用 --permission bypass;单个 trigger 可用 --model/--effort 覆盖执行模型/强度 $KITS_DOCS/evolcore/trigger.md
|
|
13
|
+
{{?channel=aun}}
|
|
14
|
+
{{?chatType=private}}
|
|
15
|
+
{{?peerRole=owner}}
|
|
16
|
+
ec pa-workspace 个人助理工作区初始化与入口导航(init/bind/navigation show/navigation update;初始化会先运行 personal-assistant Skill,再登记工作区) $KITS_DOCS/evolcore/pa-workspace.md
|
|
17
|
+
{{/}}
|
|
18
|
+
{{/}}
|
|
19
|
+
{{/}}
|
|
13
20
|
{{?peerRole=owner}}
|
|
14
21
|
ec task 恢复暂停或异常中断的会话任务(resume <sessionId>;复用原 baseagent 会话,缺失时失败关闭) $KITS_DOCS/evolcore/task.md
|
|
15
22
|
{{/}}
|
|
@@ -22,17 +29,17 @@ ec fs AUN 文件系统统一入口(ls/stat/cat/cp/mv/rm/mkdir/ln/chmod/se
|
|
|
22
29
|
ec storage 文件上传/下载/配额(底层调试入口,日常优先 ec fs) $KITS_DOCS/evolcore/storage.md
|
|
23
30
|
{{?peerId}}
|
|
24
31
|
ec msg 私聊收发消息(原始 JSON / 请求等待 / 结果查询 / 拉取 / 撤回) $KITS_DOCS/evolcore/msg.md
|
|
25
|
-
ec thread 话题管理与话题链(peers 列对端 / list 列话题 / history 读历史 / show / summary / rename / label / status / delete / create)。peer 为对端裸 AID(如 alice.agentid.cn),不是 peerKey 那种 aun#
|
|
32
|
+
ec thread 话题管理与话题链(peers 列对端 / list 列话题 / history 读历史 / show / summary / rename / label / status / delete / create)。peer 为对端裸 AID(如 alice.agentid.cn),不是 peerKey 那种 aun# 形态;本端身份自动注入,不写 --self。示例: ec thread peers → ec thread list <对端裸AID> → ec thread history <threadId> $KITS_DOCS/evolcore/thread-chain.md
|
|
26
33
|
{{/}}
|
|
27
34
|
{{?selfAid}}
|
|
28
35
|
ec group 群聊收发与群管理(群发/建群/查群/本地群历史/邀请/踢人/角色/封禁/屏蔽/成员状态/规则;完整协作使用 ec-group-collaboration 技能) $KITS_DOCS/evolcore/group.md
|
|
29
36
|
{{/}}
|
|
30
37
|
{{?peerRole=owner}}
|
|
31
|
-
ec agent EvolAgent
|
|
32
|
-
ec
|
|
38
|
+
ec agent EvolAgent 生命周期与主机信息(创建/启停/热重载/改配置/查主机信息;创建流程使用 ec-agent-create 技能)。ec agent reload 仅对配置/persona/memory 生效,改源码无效 $KITS_DOCS/evolcore/agent.md
|
|
39
|
+
ec peer 对端身份与本地拉黑(查登记/拉黑/解除拉黑;显式 --self) $KITS_DOCS/evolcore/peer.md
|
|
33
40
|
{{/}}
|
|
34
41
|
{{?peerRole=admin}}
|
|
35
|
-
ec agent EvolAgent
|
|
36
|
-
ec
|
|
42
|
+
ec agent EvolAgent 生命周期与主机信息(创建/启停/热重载/改配置/查主机信息;创建流程使用 ec-agent-create 技能)。ec agent reload 仅对配置/persona/memory 生效,改源码无效 $KITS_DOCS/evolcore/agent.md
|
|
43
|
+
ec peer 对端身份与本地拉黑(查登记/拉黑/解除拉黑;显式 --self) $KITS_DOCS/evolcore/peer.md
|
|
37
44
|
{{/}}
|
|
38
45
|
完整命令集目录(含触发词与适用场景):$KITS_DOCS/evolcore/INDEX.md
|
|
@@ -127,10 +127,25 @@ ec thread summary log current # 查
|
|
|
127
127
|
|
|
128
128
|
## 话题状态管理
|
|
129
129
|
|
|
130
|
+
业务状态只适用于独立话题(`thread-...`)。主话题是关系的默认会话,没有业务状态,不能执行
|
|
131
|
+
`ec thread status`,也不能通过把 `current` 当作独立话题来绕过这一限制。
|
|
132
|
+
|
|
133
|
+
`current` 可能指向独立话题,也可能指向主话题。需要更新状态时,先查看当前目标:
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
ec thread show current --format json
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
- 返回的 `threadId` 是 `thread-...`:可以使用 `ec thread status current <状态>`;
|
|
140
|
+
- 返回的 `threadId` 是 `main:...`(列表/详情中显示 `[主话题]`):跳过状态更新;完成信息写入
|
|
141
|
+
`summary`,然后直接回复结果。
|
|
142
|
+
|
|
143
|
+
跨话题更新状态时,使用 `ec thread list <peer>` 返回的独立 `thread-...` id,不要使用主话题 id。
|
|
144
|
+
|
|
130
145
|
```bash
|
|
131
|
-
ec thread status
|
|
132
|
-
ec thread status
|
|
146
|
+
ec thread status <threadId> in_progress # 独立话题开始处理
|
|
147
|
+
ec thread status <threadId> completed # 独立话题任务完成
|
|
133
148
|
# 状态值:pending | in_progress | completed | archived
|
|
134
149
|
```
|
|
135
150
|
|
|
136
|
-
|
|
151
|
+
独立话题状态改为 `completed` 前,先写入最终摘要;主话题只写摘要,不更新业务状态。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "evolcore",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.42",
|
|
4
4
|
"description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
"predev": "npm run build:ecagent",
|
|
46
46
|
"dev": "tsx watch src/index.ts",
|
|
47
47
|
"build:ecagent": "npm --prefix ecagent run build",
|
|
48
|
-
"build": "npm run build:ecagent &&
|
|
48
|
+
"build": "npm run build:ecagent && tsc && node -e \"const f='dist/cli/index.js',c=require('fs').readFileSync(f,'utf8');if(!c.startsWith('#!'))require('fs').writeFileSync(f,'#!/usr/bin/env node\\n'+c)\" && node -e \"try{require('child_process').execFileSync('chmod',['+x','dist/cli/index.js'])}catch{}\" && node -e \"for(const f of ['error-dict.json','model-prices.jsonl'])require('fs').copyFileSync('src/utils/'+f,'dist/utils/'+f)\" && npm --prefix ecweb run build",
|
|
49
49
|
"start": "node dist/index.js",
|
|
50
50
|
"test": "npm run build && vitest run",
|
|
51
51
|
"test:watch": "vitest",
|
|
@@ -53,19 +53,21 @@
|
|
|
53
53
|
"test:owner-directory-cache": "node --import tsx --test tests/owner-directory-cache.node.ts",
|
|
54
54
|
"test:owner-directory-authorization": "node --import tsx --test tests/owner-directory-authorization.node.ts",
|
|
55
55
|
"test:owner-directory-admission": "node --import tsx --test tests/owner-directory-admission.node.ts",
|
|
56
|
+
"test:ownership-startup": "node --import tsx --test tests/ownership-startup.node.ts tests/ownership-refresh-memory.node.ts",
|
|
57
|
+
"test:initialization-diagnostics": "node --import tsx --test tests/initialization-diagnostics.node.ts",
|
|
56
58
|
"test:hooks": "tsx test-sdk-hooks.ts",
|
|
57
59
|
"verify:request-identity": "npm run build && node scripts/verify-request-identity.mjs",
|
|
58
60
|
"prepublishOnly": "npm test"
|
|
59
61
|
},
|
|
60
62
|
"dependencies": {
|
|
61
|
-
"@agentunion/fastaun": "0.5.
|
|
63
|
+
"@agentunion/fastaun": "0.5.29",
|
|
62
64
|
"@anthropic-ai/claude-agent-sdk": "0.3.300",
|
|
63
65
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
64
66
|
"ajv": "^8.20.0",
|
|
65
67
|
"chokidar": "^5.0.0",
|
|
66
68
|
"cron-parser": "^5.5.0",
|
|
67
69
|
"dotenv": "^17.4.2",
|
|
68
|
-
"ec-web": "0.0.
|
|
70
|
+
"ec-web": "0.0.42",
|
|
69
71
|
"ignore": "7.0.5",
|
|
70
72
|
"image-type": "^6.0.0",
|
|
71
73
|
"partial-json": "0.1.7",
|