evolcore 0.0.43-test.2 → 0.0.43-test.4
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 +44 -1
- package/bin/ecmsg.js +229 -0
- package/bin/install-codex-managed-hooks.mjs +130 -8
- package/dist/ability/application-service.js +37 -0
- package/dist/ability/resources.js +28 -0
- package/dist/ability/runtime.js +6 -1
- package/dist/agents/claude-runner.js +7 -5
- package/dist/agents/codex/app-server-client.js +0 -12
- package/dist/agents/codex-runner.js +0 -37
- package/dist/agents/ecagent-runner.js +138 -36
- package/dist/aun/aid/agentmd.js +52 -13
- package/dist/aun/menu/client.js +8 -7
- package/dist/aun/menu/index.js +1 -1
- package/dist/aun/menu/transport.js +8 -5
- package/dist/aun/msg/p2p.js +4 -2
- package/dist/aun/service-proxy.js +3 -0
- package/dist/channels/aun.js +105 -53
- package/dist/channels/daemon.js +14 -2
- package/dist/cli/agent-command.js +5 -0
- package/dist/cli/agent-create.js +31 -11
- package/dist/cli/agent.js +9 -3
- package/dist/cli/aun-commands.js +19 -21
- package/dist/cli/daemon-commands.js +30 -18
- package/dist/cli/directory.js +98 -56
- package/dist/cli/getmeta-command.js +2 -1
- package/dist/cli/index.js +1 -1
- package/dist/cli/init.js +13 -5
- package/dist/cli/peer.js +2 -1
- package/dist/cli/task-context.js +3 -1
- package/dist/cli/trigger-command.js +20 -14
- package/dist/config/access-policy.js +0 -1
- package/dist/config/boot-log.js +12 -2
- package/dist/config/builtin-role-templates.js +2 -2
- package/dist/config/builtin-roles.js +2 -1
- package/dist/config/config-field-policy.js +7 -0
- package/dist/config/config-manager.js +30 -10
- package/dist/config/peer-role-resolver.js +23 -1
- package/dist/config/role-schema.js +25 -1
- package/dist/config/role-service.js +9 -4
- package/dist/config/role-store.js +30 -8
- package/dist/config/schema-migration.js +121 -0
- package/dist/core/agent-application-service.js +11 -0
- package/dist/core/agent-ipc-registration.js +2 -0
- package/dist/core/agent-runtime.js +41 -9
- package/dist/core/auth/auth-gateway.js +14 -4
- package/dist/core/auth/operation-authorizer.js +19 -1
- package/dist/core/auth/operation-catalog.js +12 -2
- package/dist/core/baseagent-loader.js +11 -3
- package/dist/core/bootstrap-service.js +8 -0
- package/dist/core/channel-loader.js +61 -23
- package/dist/core/channel-runtime.js +5 -0
- package/dist/core/command/agent-control.js +5 -2
- package/dist/core/command/agentmd-menu-request.js +50 -0
- package/dist/core/command/agentmd-menu.js +156 -0
- package/dist/core/command/chatmode-config.js +46 -0
- package/dist/core/command/command-handler.js +44 -17
- package/dist/core/command/daemon-diagnostics.js +2 -1
- package/dist/core/command/menu-catalog.js +14 -1
- package/dist/core/command/menu-handler.js +74 -24
- package/dist/core/command/menu-protocol.js +8 -0
- package/dist/core/command/role-menu.js +23 -9
- package/dist/core/command/slash-handler.js +52 -47
- package/dist/core/daemon-lifecycle.js +43 -17
- package/dist/core/event-catalog.js +19 -0
- package/dist/core/evolagent-registry.js +3 -0
- package/dist/core/evolagent.js +5 -4
- package/dist/core/ipc-registration.js +6 -0
- package/dist/core/lifecycle-notice.js +185 -0
- package/dist/core/message/aun-ipc-sender.js +30 -24
- package/dist/core/message/contact-admission.js +1 -19
- package/dist/core/message/im-renderer.js +81 -40
- package/dist/core/message/message-admission.js +21 -62
- package/dist/core/message/message-bridge.js +18 -5
- package/dist/core/message/message-utils.js +9 -0
- package/dist/core/message/peer-mode.js +16 -8
- package/dist/core/message/response-engine.js +67 -47
- package/dist/core/model/model-capabilities.js +37 -0
- package/dist/core/model/model-catalog.js +6 -2
- package/dist/core/ownership/owner-resolver.js +74 -36
- package/dist/core/permission/ec-command-parser.js +62 -13
- package/dist/core/plugin-lifecycle.js +6 -2
- package/dist/core/relation/pa-team.js +132 -0
- package/dist/core/role/runtime-policy.js +4 -3
- package/dist/core/thread/thread-service.js +6 -4
- package/dist/directory/owner-directory-admission.js +0 -3
- package/dist/directory/owner-directory-cache.js +201 -17
- package/dist/directory/owner-directory-markdown.js +44 -21
- package/dist/directory/owner-directory-policy.js +1 -1
- package/dist/directory/owner-directory-query-operation.js +218 -98
- package/dist/directory/owner-directory-request-operation.js +76 -0
- package/dist/directory/owner-directory-scope.js +35 -4
- package/dist/directory/owner-directory-search.js +76 -23
- package/dist/directory/owner-directory-store.js +5 -38
- package/dist/directory/owner-directory-text.js +60 -0
- package/dist/eck/kit-renderer.js +6 -3
- package/dist/eck/message-renderer.js +2 -5
- package/dist/ecweb/message-context-service.js +4 -0
- package/dist/ecweb/runtime/lifecycle.js +29 -5
- package/dist/ecweb/runtime/supervisor.js +83 -27
- package/dist/index.js +209 -38
- package/dist/paths.js +4 -2
- package/dist/product.js +1 -0
- package/dist/proxy/service-supervisor.js +377 -141
- package/dist/response-system/engines/v1/index.js +2 -4
- package/dist/response-system/modes/single-session/index.js +1 -1
- package/dist/trigger/audit.js +3 -2
- package/dist/trigger/authorization.js +2 -3
- package/dist/trigger/history.js +4 -3
- package/dist/trigger/ipc-service.js +24 -19
- package/dist/trigger/manager.js +3 -5
- package/dist/trigger/parser.js +4 -21
- package/dist/trigger/patch.js +3 -15
- package/dist/trigger/scheduler.js +53 -13
- package/dist/trigger/validation.js +0 -13
- package/dist/utils/error-utils.js +15 -5
- package/dist/utils/macos-autostart.js +31 -0
- package/dist/utils/model-prices.jsonl +15 -8
- package/dist/utils/process-introspect.js +21 -1
- package/dist/utils/startup-trace.js +7 -1
- package/dist/utils/windows-autostart.js +1 -0
- package/ecagent/README.md +18 -0
- package/ecagent/dist/harness/agent-harness.d.ts +2 -0
- package/ecagent/dist/harness/agent-harness.js +24 -8
- package/ecagent/dist/harness/compaction/branch-summarization.js +1 -1
- package/ecagent/dist/harness/compaction/compaction.js +7 -4
- package/ecagent/dist/harness/types.d.ts +1 -0
- package/kits/docs/channels/aun.md +1 -1
- package/kits/docs/context-assembly.md +1 -1
- package/kits/docs/evolcore/INDEX.md +5 -2
- package/kits/docs/evolcore/directory.md +125 -35
- package/kits/docs/evolcore/ecweb-lifecycle.md +26 -0
- package/kits/docs/evolcore/file-navigation.md +279 -0
- package/kits/docs/evolcore/menu-protocol.md +1 -0
- package/kits/docs/evolcore/model.md +5 -3
- package/kits/docs/evolcore/msg.md +1 -0
- package/kits/docs/evolcore/peer.md +2 -1
- package/kits/docs/evolcore/response.md +4 -2
- package/kits/docs/evolcore/task.md +2 -0
- package/kits/docs/evolcore/thread-chain.md +1 -1
- package/kits/docs/evolcore/tool-authorization.md +4 -1
- package/kits/docs/evolcore/trigger.md +10 -7
- package/kits/docs/identity/ROLE_DETAIL.md +2 -0
- package/kits/eck_manifest.json +6 -23
- package/kits/eck_manifest.memory.json +26 -1
- package/kits/rules/01-overview.md +42 -44
- package/kits/rules/02-navigation.md +44 -53
- package/kits/rules/03-identity.md +21 -25
- package/kits/rules/04-relation.md +23 -33
- package/kits/rules/05-venue.md +24 -25
- package/kits/schemas/_meta.json +10 -10
- package/kits/schemas/agent-config.schema.19.json +10 -6
- package/kits/schemas/relation-config.schema.12.json +2 -2
- package/kits/schemas/role-config.schema.2.json +5 -5
- package/kits/schemas/role-registry.schema.1.json +3 -2
- package/kits/skills/ec-service-proxy/SKILL.md +10 -0
- package/kits/skills/ec-trigger/SKILL.md +1 -1
- package/kits/templates/soul/00-GUIDE.md +20 -42
- package/kits/templates/system-fragments/channel.md +2 -2
- package/kits/templates/system-fragments/commands.md +1 -1
- package/kits/templates/system-fragments/directory-contacts.md +1 -1
- package/kits/templates/system-fragments/identity.md +0 -1
- package/kits/templates/system-fragments/personal-assistant.md +2 -17
- package/kits/templates/system-fragments/reply.md +7 -0
- package/kits/templates/system-fragments/session.md +6 -2
- package/package.json +18 -13
- package/dist/eck/paactive-context.js +0 -45
- package/dist/response-system/engines/v1/paactive-flow.js +0 -18
- package/kits/eck_manifest.paactive.json +0 -528
- package/kits/eck_message_manifest.paactive.json +0 -233
- package/kits/templates/message-fragments/paactive/item.md +0 -3
- package/kits/templates/system-fragments/paactive/channel.md +0 -25
- package/kits/templates/system-fragments/paactive/reply.md +0 -25
- package/kits/templates/system-fragments/paactive/session.md +0 -32
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# ec directory — Owner
|
|
1
|
+
# ec directory — Owner 名录查询、入录申请与本地备注
|
|
2
2
|
|
|
3
3
|
`ec directory` 读的是 **Owner 下发的名录副本** `<agent>/directory/contacts.json`(只读),
|
|
4
4
|
以及本地补充的**备注文件** `<agent>/directory/remarks/<aid>.md`。
|
|
@@ -6,56 +6,115 @@
|
|
|
6
6
|
触发词:联系人/通讯录/名录/找人的 AID/这个人是谁/内外联系人/拉黑名单/记备注。
|
|
7
7
|
|
|
8
8
|
它不是联系人管理入口:谁能联系这个 Agent、名录里有哪些人,由 Owner 在 Evol App 里决定,
|
|
9
|
-
Agent
|
|
9
|
+
Agent 侧可以查询或向 Owner 发送入录申请,不能直接增删名录条目。
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## 命令面
|
|
12
|
+
|
|
13
|
+
命令与 `ec skill` 对齐:**`list` 列举/过滤,`info` 看单条详情**。
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
ec directory list [<关键词>...] [--filter '<kw1,kw2>']... [--type <type>] [--scope internal|external|all] [--owner <aid|unbound>] [--limit <n>] [--page <n>] [--format json]
|
|
17
|
+
ec directory info <contact-aid|名字> [--limit <n>] [--format json]
|
|
18
|
+
ec directory refresh [--format json]
|
|
19
|
+
ec directory blocked [--format json]
|
|
20
|
+
ec directory request <target-aid> [--note <申请说明>] [--format json]
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
旧名仍可用:`find <关键词>` 等价于 `list <关键词>`,`show <AID|名字>` 等价于 `info`。
|
|
24
|
+
|
|
25
|
+
`--self` 缺省时:托管会话取**当前任务所属 Agent**(来自委托凭据,等于当前会话的
|
|
26
|
+
`selfAid`),非托管会话取 `EVOLCORE_SELF_AID`。显式传 `--self` 时必须等于当前任务
|
|
27
|
+
所属 Agent,否则报 `SCOPE_MISMATCH`。
|
|
28
|
+
|
|
29
|
+
> 托管 runner 不注入 `EVOLCORE_SELF_AID`,所以以前在托管会话里省略 `--self` 会直接
|
|
30
|
+
> 报 `--self <agent-aid> is required`。现在与 `ec peer` / `ec role` 一致,由 daemon
|
|
31
|
+
> 用委托凭据补齐。
|
|
32
|
+
|
|
33
|
+
## 申请加入 Owner 名录
|
|
34
|
+
|
|
35
|
+
当发送因目标不在本端 Owner 名录中被拒绝时,执行:
|
|
12
36
|
|
|
13
37
|
```bash
|
|
14
|
-
ec directory
|
|
15
|
-
ec directory show <contact-aid|名字> --self <agent-aid> [--limit <n>] [--format json]
|
|
16
|
-
ec directory list --self <agent-aid> [--type <type>] [--scope internal|external|all] [--owner <aid|unbound>] [--limit <n>] [--format json]
|
|
17
|
-
ec directory refresh --self <agent-aid> [--format json]
|
|
18
|
-
ec directory blocked --self <agent-aid> [--format json]
|
|
38
|
+
ec directory request evolapplwj.agentid.cn --note "三藏希望了解项目接下来的工作重点"
|
|
19
39
|
```
|
|
20
40
|
|
|
21
|
-
|
|
41
|
+
`request` 自动确定本端 Agent 与其 Owner,向 Owner 发送一条**加密加好友申请**(app-v1
|
|
42
|
+
`friend.invite.v1`),列明本端 Agent、目标 AID 和申请说明(最多 500 字符)。Owner 需要在
|
|
43
|
+
Evol App 中处理该申请,并把目标加入联系人名录、允许本 Agent 访问对应的联系人范围。
|
|
44
|
+
申请不会给目标发送消息,也不会修改本地名录、准入开关或自动重发原消息。
|
|
45
|
+
|
|
46
|
+
成功返回 `action: request`、`targetAid`、`status: sent` 和 `message_id`,
|
|
47
|
+
仅表示申请消息已发送,**不表示 Owner 已同意或目标已入录**。Owner 处理后执行
|
|
48
|
+
`ec directory refresh`,同步名录后再重试原发送命令。
|
|
49
|
+
|
|
50
|
+
## list — 列举与关键词过滤
|
|
51
|
+
|
|
52
|
+
不给关键词时列举名录;给关键词时按 **AID、名字、备注、描述、exttype** 做子串匹配,
|
|
53
|
+
不区分大小写,比较前统一归一(全角转半角、去零宽字符、折叠空格)。
|
|
54
|
+
|
|
55
|
+
两种写法:
|
|
56
|
+
|
|
57
|
+
- `--filter '<kw1,kw2>'`:与 `ec skill list --filter` 同语义,**组内逗号分隔为 OR,
|
|
58
|
+
多个 `--filter` 之间为 AND**;
|
|
59
|
+
- 位置参数(`list 张三 采购`):保留旧 `find` 的语义,多个词**同时命中**(AND)。
|
|
22
60
|
|
|
23
|
-
|
|
61
|
+
其它过滤:`--type`、`--scope internal|external|all`(默认 `all`)、
|
|
62
|
+
`--owner <aid|unbound>`(按条目归属过滤,`unbound` 只列没有 `owner_aid` 的条目)。
|
|
24
63
|
|
|
25
|
-
|
|
64
|
+
**分页**:默认每页 20 条,上限 100。`--limit` / `--page` 可调;JSON 结果带
|
|
65
|
+
`page` / `limit` / `total` / `hasMore`。
|
|
26
66
|
|
|
27
|
-
|
|
28
|
-
按命中字段打分排序(精确 AID/名字 > 前缀 > 备注 > 域段 > 包含 > 描述)。
|
|
67
|
+
输出(文本与 JSON 一致)包含完整条目字段:
|
|
29
68
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
69
|
+
```
|
|
70
|
+
名字 | AID | type | exttype | 备注名 | 描述 | Owner: <owner_aid|(无)> | 归属: owned|unknown
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
- `ownershipStatus`(归属:)是 `contacts.json` 里的双边归属核验结果;
|
|
74
|
+
`ownershipVerified` 为 `true` 表示 `owned`。
|
|
75
|
+
- 本地备注正文(`localRemark`)**不在 list 展示**;要看正文用 `ec directory info <AID>`。
|
|
76
|
+
- **Owner 与个人助理**也属于可查询条目(它们在快照顶层,不在 `entries` 里)。
|
|
77
|
+
- 归属未核实、没有 `owner_aid`、`type` 不合规的条目**同样会被 list 出来**,
|
|
78
|
+
并带上 `ownerAid` / `ownershipStatus`,方便判断为什么它们不在注入的“内部联系人”里。
|
|
79
|
+
|
|
80
|
+
不命中时会触发一次有界同步再查一遍(“刚更新还没拉下来”,不是“没有这个人”)。
|
|
34
81
|
|
|
35
|
-
|
|
82
|
+
## info — 单条详情
|
|
36
83
|
|
|
37
|
-
接受 **AID
|
|
84
|
+
接受 **AID 或名字**两种形式,Owner 与个人助理同样可查。AID 大小写不敏感,也接受
|
|
85
|
+
`@aid` 前缀。
|
|
38
86
|
|
|
39
87
|
- 合法 AID → 精确匹配,返回一条。
|
|
40
|
-
- 其它值 →
|
|
41
|
-
|
|
88
|
+
- 其它值 → 按名字匹配**显示名、远端备注名、本地备注名**,分两级:
|
|
89
|
+
1. **精确**:比较前先归一(全角转半角、去零宽字符、折叠空格、忽略大小写),
|
|
90
|
+
并忽略名字结尾括号里的称呼(`李文江(研发)` 与 `李文江` 视为同名);
|
|
91
|
+
2. 精确没命中才放宽为**名字/称呼包含**查询串(只在名字与称呼里找,**不匹配描述**,
|
|
92
|
+
避免把「李文江的助理」当成李文江本人)。这一级结果带 `matchKind: "fuzzy"`,
|
|
93
|
+
需要调用方自己再确认。
|
|
94
|
+
- 两级都没命中时报 `NOT_FOUND`,错误信息里附最多 3 条**相近条目**(按编辑距离,
|
|
95
|
+
用于纠正错字/称呼差异)。`--format json` 时同样给出结构化错误。
|
|
42
96
|
- 默认最多 20 条,`--limit` 可改;超出时结果带 `truncated` 字段。
|
|
43
97
|
|
|
44
|
-
|
|
98
|
+
返回完整记录(描述与本地备注正文都不截断),并带 `ownerAid` /
|
|
99
|
+
`ownershipStatus` / `ownershipVerified`。远端字段与本地备注**并列返回,互不覆盖**:
|
|
45
100
|
`description` 始终是远端描述,本地正文放在 `localRemark`;
|
|
46
101
|
`remark` 优先取本地称呼(没有则回落远端备注名),`ownerRemark` 保留远端备注名。
|
|
47
102
|
|
|
48
|
-
###
|
|
103
|
+
### 三种“看详情”不要混
|
|
49
104
|
|
|
50
|
-
|
|
105
|
+
| 想看什么 | 命令 |
|
|
106
|
+
|---|---|
|
|
107
|
+
| 名录档案(type/exttype/描述/本地备注正文/归属状态) | `ec directory info <AID>` |
|
|
108
|
+
| 名片正文(agent.md 全文,下载 + 验签,任意合法 AID) | `ec aid agentmd get <AID>` |
|
|
109
|
+
| 本地身份诊断(私钥/证书/agent.md 状态;托管会话仅限 self) | `ec aid show <AID>` |
|
|
51
110
|
|
|
52
|
-
|
|
111
|
+
## refresh
|
|
53
112
|
|
|
54
|
-
强制拉一次最新名录并落地,不看摘要门控(区别于 `
|
|
113
|
+
强制拉一次最新名录并落地,不看摘要门控(区别于 `list` 不命中时的顺带同步)。
|
|
55
114
|
|
|
56
115
|
**需要该 Agent 的 channel 在线**:没有活连接时返回 `REFRESH_UNAVAILABLE`,不会静默假装成功。
|
|
57
116
|
|
|
58
|
-
|
|
117
|
+
## blocked
|
|
59
118
|
|
|
60
119
|
列出被拉黑的主体,合并两个来源:
|
|
61
120
|
|
|
@@ -69,6 +128,29 @@ ec directory blocked --self <agent-aid> [--format json]
|
|
|
69
128
|
|
|
70
129
|
> 本地拉黑用 `ec peer block/unblock`(见 `peer.md`),`ec directory blocked` 只做查看。
|
|
71
130
|
|
|
131
|
+
## 归属核验(ownership_status)
|
|
132
|
+
|
|
133
|
+
`contacts.json` 每条带 `ownership_status`(`owned` / `unknown`)与
|
|
134
|
+
`ownership_checked_at_ms`。它是 Owner 侧对“这条主体是否确实归属于本 Owner”的
|
|
135
|
+
**双边核验结果**。
|
|
136
|
+
|
|
137
|
+
判定口径(渲染、准入、查询三处一致):
|
|
138
|
+
|
|
139
|
+
```
|
|
140
|
+
agent 类型:内部联系人 = owner_aid == owner.aid AND ownership_status == 'owned'
|
|
141
|
+
human 等非 agent 类型:内部联系人 = owner_aid == owner.aid
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
- 门禁只作用于 **`type=agent`**:会自称“我是某某的 Agent”并据此索取内部待遇的
|
|
145
|
+
是 Agent;人类联系人由 Owner 在名录里直接维护,`owner_aid` 本身就是明确指派;
|
|
146
|
+
- agent 的 `unknown`、字段缺失、`owner_aid` 指向别人或没有 `owner_aid`,都**不是内部**,
|
|
147
|
+
不参与 `allowInternalContacts` 的默认放行;
|
|
148
|
+
- Owner / 个人助理两个顶层身份块单独处理:它们已与 `authorization.json` 的授权
|
|
149
|
+
Owner 做过一致性校验,按已核验对待。
|
|
150
|
+
|
|
151
|
+
没有这条门禁时,一个 Agent 只要在名录里把 `owner_aid` 写成我们的 Owner,
|
|
152
|
+
就能拿到内部联系人的默认放行——这是必须堵住的口子。
|
|
153
|
+
|
|
72
154
|
## 备注
|
|
73
155
|
|
|
74
156
|
备注描述的是「**这个 Agent 自己怎么看这个人**」,和 Owner 发布的远端条目不是一回事。
|
|
@@ -94,7 +176,7 @@ updated_at: <unix 秒>
|
|
|
94
176
|
- 文件名必须与 frontmatter 的 `aid` 一致,否则整条作废——防止备注挂到别人头上。
|
|
95
177
|
- `remark` 可以写**多个称呼**,用中英文逗号、顿号或空格分隔:`remark: 蒋总, 老蒋, 蒋先生`。
|
|
96
178
|
名字后括号里放第一个,其余与 Owner 的备注名一起进备注名列(`蒋先福(蒋总) | … | 老蒋、蒋先生`)。
|
|
97
|
-
- `
|
|
179
|
+
- `list` 与 `info` 对**每一个**称呼都能命中;同名重复的自动去重。
|
|
98
180
|
- 正文**不覆盖**描述,而是**追加**在远端描述之后、带 `备注:` 前缀单独占一列。
|
|
99
181
|
远端描述是对方或 Owner 写的身份,本地正文是 PA 自己记的「什么事该找他」,
|
|
100
182
|
替换掉等于把原始事实删了;前缀让模型能分清哪段是谁写的。
|
|
@@ -107,31 +189,39 @@ updated_at: <unix 秒>
|
|
|
107
189
|
| 形态 | 内容 | 用于 |
|
|
108
190
|
|---|---|---|
|
|
109
191
|
| `full` | 名字 \| AID \| 类型 \| 备注名 \| 描述 \| 备注:… | 内部联系人、白名单联系人 |
|
|
110
|
-
| `brief` | 名字 \| 备注名 | 外部 Agent
|
|
192
|
+
| `brief` | 名字 \| 备注名 | 外部 Agent/人类、加入的群、归属未核实 |
|
|
193
|
+
|
|
194
|
+
「内部联系人」组只收 `exttype` 以 `pa.` 打头的本 Owner 条目;其余内部主体不注入。
|
|
111
195
|
|
|
112
196
|
`brief` 组里**有本地备注的条目会逐条升级为 `full`**——记了备注就等于把这个人从"只有名字"
|
|
113
|
-
变成"可以直接用",不用再
|
|
197
|
+
变成"可以直接用",不用再 list + info 两次。
|
|
114
198
|
|
|
115
|
-
`
|
|
116
|
-
|
|
199
|
+
**归属未核实组**:`type=agent` 且 `ownership_status !== 'owned'`、没有 `owner_aid`、
|
|
200
|
+
或 `type` 不在协议 8 种之内(`agent`/`human`/`group`/`service`/`device`/`org`/`custom`/`host`)
|
|
201
|
+
的条目,只注入**名字**(有本地备注时也带称呼),不展示 AID、类型与描述,并明确提示
|
|
202
|
+
“不要当作内部联系人、不要主动联系”。完整字段用 `ec directory list` 现查。
|
|
117
203
|
|
|
118
204
|
## 输出与错误
|
|
119
205
|
|
|
120
|
-
`--format json`
|
|
206
|
+
`--format json` 输出结构化结果,**失败时也是 JSON**:`{ ok: false, code, error }`
|
|
207
|
+
(此前失败只打印 `❌ …` 文本,调用方拿不到错误码)。常见失败码:
|
|
121
208
|
|
|
122
209
|
| code | 含义 |
|
|
123
210
|
|---|---|
|
|
124
211
|
| `NOT_AUTHORIZED` | 这个 Agent 没有可用的名录授权(`authorization.json` 缺失或与身份不符) |
|
|
125
212
|
| `NO_SNAPSHOT` | 已授权但本地还没有快照(从未成功拉取过) |
|
|
126
|
-
| `NOT_FOUND` | `
|
|
213
|
+
| `NOT_FOUND` | `info` 找不到目标 |
|
|
127
214
|
| `REFRESH_UNAVAILABLE` | `refresh` 时没有可用的 channel 连接 |
|
|
128
215
|
| `AGENT_NOT_FOUND` | `--self` 指向的 Agent 不存在 |
|
|
216
|
+
| `OWNER_NOT_FOUND` | `request` 无法确定本端 Owner,未发送申请 |
|
|
217
|
+
| `OWNER_REQUEST_FAILED` | 申请消息发送失败或未取得发送回执 |
|
|
129
218
|
|
|
130
219
|
## 权限边界
|
|
131
220
|
|
|
132
221
|
| 操作 | 授权目录项 | 说明 |
|
|
133
222
|
|---|---|---|
|
|
134
|
-
| `
|
|
223
|
+
| `list` / `info` / `refresh` / `blocked`(含旧名 `find` / `show`) | `ec.directory.query` | 只读 |
|
|
224
|
+
| `request` | `ec.directory.request` | 向当前 Agent 的 Owner 发送加密申请;按 Agent Owner + bypass 授权 |
|
|
135
225
|
|
|
136
226
|
托管会话里 CLI 不直接读盘,携带 task delegation token 调 daemon `directory.op`;
|
|
137
227
|
缺 token、token 伪造或跨会话时失败关闭。显式 `--self` 必须等于当前任务所属 Agent。
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# ECWeb 生命周期与升级
|
|
2
|
+
|
|
3
|
+
## 源码归属
|
|
4
|
+
|
|
5
|
+
宿主侧 ECWeb 集成集中在 `src/ecweb/`:`runtime/supervisor.ts` 负责守护与恢复调度,`runtime/lifecycle.ts` 负责退出确认和重启就绪校验,`runtime/launch.ts` 负责启动入口及版本兼容检查,`pairing.ts` 负责配对 IPC、访问链接和提示文案。通用跨平台进程工具仍留在 `src/utils/`;独立 Web 服务自身代码留在 `ecweb/src/`。
|
|
6
|
+
|
|
7
|
+
## 重启顺序
|
|
8
|
+
|
|
9
|
+
托管 ECWeb 的重启由 `restart-monitor` 协调:
|
|
10
|
+
|
|
11
|
+
1. 停止旧 daemon,并等待其退出。
|
|
12
|
+
2. 在替换安装包或启动新 daemon 前,核验并停止旧 ECWeb。
|
|
13
|
+
3. 先发送优雅退出信号,超时后才发送强制退出信号。
|
|
14
|
+
4. 新 daemon 写入 `ready.signal` 后,还必须通过 ECWeb `/api/health`、`/api/ready` 和实例登记校验。
|
|
15
|
+
|
|
16
|
+
## 安全边界
|
|
17
|
+
|
|
18
|
+
- 已登记实例核验登记契约、所属 Home、PID 与启动时间;未登记实例还必须核验 ECWeb 启动入口、`--home` 和服务健康身份。
|
|
19
|
+
- 旧版本没有实例登记时,只有端口监听进程的命令行和 `/api/health` 都匹配,才允许回收。
|
|
20
|
+
- PID 被复用时不向新进程发送信号;启动时间不可读取、服务身份不匹配或端口仍被占用时中止重启,不发送不确定的终止信号。
|
|
21
|
+
- 停止后除扫描监听 PID,还实际绑定并释放目标端口,避免系统扫描工具缺失或失败时误判端口空闲。
|
|
22
|
+
- `runtimeMode=external` 或服务禁用时,不由 EvolCore 管理其进程。
|
|
23
|
+
|
|
24
|
+
## 故障处理
|
|
25
|
+
|
|
26
|
+
ECWeb 停止失败会留下可诊断的实例登记,不替换安装包,也不继续启动重复实例。状态命令会扫描配置端口,即使登记文件丢失,也会报告端口占用和 PID,提示先核实进程归属。
|
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
# PA 工作区入口导航:agent 操作手册
|
|
2
|
+
|
|
3
|
+
个人助理(PA)自己的工作区产物,通过一份**入口导航**暴露给 Evol App 的头像入口。
|
|
4
|
+
新增一个产物目录要给用户看到,改导航即可,不需要 App 发版。
|
|
5
|
+
|
|
6
|
+
本文是给 agent 读的完整操作手册:文件在哪、格式是什么、怎么安全地改。
|
|
7
|
+
**本文自包含**,按本文即可完成导航的增删改,不需要读其他文档。
|
|
8
|
+
|
|
9
|
+
## 1. 文件在哪
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
$AGENT_DATA_DIR/pa-workspace-state.json
|
|
13
|
+
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
其中 `rootPath` 是本机绝对路径,**永远不会发给 App**。
|
|
17
|
+
被导航指向的真实文件在 PA 工作区里(`capture/`、`output/` 等),导航只存"指向哪里",不存内容。
|
|
18
|
+
|
|
19
|
+
### 1.1 三个名字指同一份数据
|
|
20
|
+
|
|
21
|
+
| 名字 | 指什么 |
|
|
22
|
+
| --- | --- |
|
|
23
|
+
| pa-workspace-state.json | 磁盘上的完整状态:绑定信息(workspaceId/ownerAid/rootPath)+ navigationRevision + entries |
|
|
24
|
+
| file-navigation.json | 导航内容本身,即 {version, entries} 这部分。协议与设计文档里的叫法 |
|
|
25
|
+
| --entries-json | 命令参数,取值就是 file-navigation.json 的 entries 数组 |
|
|
26
|
+
|
|
27
|
+
**改导航一律用命令**,把 `entries` 数组整体传给 `--entries-json`。命令会校验、
|
|
28
|
+
递增 `navigationRevision`、做并发保护,并对每个入口做真实路径检查。
|
|
29
|
+
手工编辑 `pa-workspace-state.json` 会跳过全部这些保护。
|
|
30
|
+
|
|
31
|
+
导出当前导航为 `file-navigation.json`:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
ec pa-workspace navigation show
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
该命令**只输出 JSON**,`--format json` / `--json` 可加但无区别。
|
|
39
|
+
|
|
40
|
+
## 2. 格式
|
|
41
|
+
|
|
42
|
+
`file-navigation.json` 顶层:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"version": 1,
|
|
47
|
+
"entries": []
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
`--entries-json` 只接收 `entries` 数组,`version` 由命令维护。
|
|
53
|
+
|
|
54
|
+
### 2.1 完整 Schema
|
|
55
|
+
|
|
56
|
+
Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读取下列字段,
|
|
57
|
+
其余字段被静默丢弃 —— 写错字段名不会报错,只会无声失效。
|
|
58
|
+
|
|
59
|
+
```json
|
|
60
|
+
{
|
|
61
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
62
|
+
"$id": "urn:evol:schema:file-navigation:v1",
|
|
63
|
+
"title": "PA workspace file navigation v1",
|
|
64
|
+
"type": "object",
|
|
65
|
+
"additionalProperties": false,
|
|
66
|
+
"required": ["version", "entries"],
|
|
67
|
+
"properties": {
|
|
68
|
+
"version": { "const": 1 },
|
|
69
|
+
"entries": {
|
|
70
|
+
"type": "array",
|
|
71
|
+
"maxItems": 200,
|
|
72
|
+
"items": { "$ref": "#/$defs/entry" }
|
|
73
|
+
}
|
|
74
|
+
},
|
|
75
|
+
"$defs": {
|
|
76
|
+
"entry": {
|
|
77
|
+
"type": "object",
|
|
78
|
+
"additionalProperties": false,
|
|
79
|
+
"required": ["path", "kind"],
|
|
80
|
+
"properties": {
|
|
81
|
+
"id": {
|
|
82
|
+
"type": "string",
|
|
83
|
+
"minLength": 1,
|
|
84
|
+
"maxLength": 200,
|
|
85
|
+
"description": "稳定标识。省略时由 path 的 sha256 前缀自动生成。改名必须保留原 id。"
|
|
86
|
+
},
|
|
87
|
+
"title": {
|
|
88
|
+
"type": "string",
|
|
89
|
+
"minLength": 1,
|
|
90
|
+
"maxLength": 200,
|
|
91
|
+
"description": "展示名。省略时回落为 path 的最后一段。"
|
|
92
|
+
},
|
|
93
|
+
"path": {
|
|
94
|
+
"type": "string",
|
|
95
|
+
"minLength": 1,
|
|
96
|
+
"maxLength": 2048,
|
|
97
|
+
"description": "工作区根下的相对路径。反斜杠会被归一化为 /。拒绝绝对路径、冒号、NUL、.. 段,以及任何以 . 开头的路径段和 capture/_manifest。"
|
|
98
|
+
},
|
|
99
|
+
"kind": {
|
|
100
|
+
"enum": ["file", "directory"],
|
|
101
|
+
"description": "必须与真实目标类型一致;目标不存在且 availability=unavailable 时按声明值保留。"
|
|
102
|
+
},
|
|
103
|
+
"order": {
|
|
104
|
+
"type": "integer",
|
|
105
|
+
"minimum": 0,
|
|
106
|
+
"maximum": 1000000,
|
|
107
|
+
"description": "升序展示。省略时回落为数组下标。"
|
|
108
|
+
},
|
|
109
|
+
"icon": {
|
|
110
|
+
"type": "string",
|
|
111
|
+
"minLength": 1,
|
|
112
|
+
"maxLength": 100,
|
|
113
|
+
"description": "语义图标名。超长截断而非报错;不认识的图标 App 用默认图标。"
|
|
114
|
+
},
|
|
115
|
+
"availability": {
|
|
116
|
+
"enum": ["available", "unavailable"],
|
|
117
|
+
"default": "available"
|
|
118
|
+
},
|
|
119
|
+
"reason": {
|
|
120
|
+
"type": "string",
|
|
121
|
+
"minLength": 1,
|
|
122
|
+
"maxLength": 500,
|
|
123
|
+
"description": "availability=unavailable 时必填。超长截断。"
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
### 2.2 字段行为细节
|
|
133
|
+
|
|
134
|
+
| 字段 | 省略时 | 校验失败时 |
|
|
135
|
+
| --- | --- | --- |
|
|
136
|
+
| id | 由 path 自动生成 pa-<sha256前16位> | 重复 ID → INVALID_ARGUMENT |
|
|
137
|
+
| title | 回落 path 最后一段 | 超 200 字符 → INVALID_ARGUMENT |
|
|
138
|
+
| path | 不可省略 | 绝对路径/冒号/../隐藏段 → INVALID_ROOT_PATH |
|
|
139
|
+
| kind | 不可省略 | 与真实目标不一致 → INVALID_ARGUMENT |
|
|
140
|
+
| order | 回落数组下标 | 非 0..1000000 整数 → INVALID_ARGUMENT |
|
|
141
|
+
| icon | 无图标 | 超 100 字符截断,不报错 |
|
|
142
|
+
| availability | available | 非法值 → INVALID_ARGUMENT |
|
|
143
|
+
| reason | — | unavailable 却没给 → INVALID_ARGUMENT |
|
|
144
|
+
|
|
145
|
+
额外规则:
|
|
146
|
+
|
|
147
|
+
- `entries` 最多 200 项。
|
|
148
|
+
- `id` 不能重复,`path` 也不能重复,两者分别查重。
|
|
149
|
+
- 排序是 `order` 升序 → `title` 本地化字典序 → `path` 字典序,不只是 `order`。
|
|
150
|
+
- 目标不存在时,必须显式 `availability: "unavailable"` + `reason`,否则返回 `NOT_FOUND`。
|
|
151
|
+
- `path` 的反斜杠会被**替换**成 `/` 并归一化,不是报错;但归一化后不能命中隐藏路径。
|
|
152
|
+
|
|
153
|
+
### 2.3 隐藏路径的判据
|
|
154
|
+
|
|
155
|
+
任何一个路径段以 `.` 开头即被拒绝,`capture/_manifest` 也拒绝。
|
|
156
|
+
所以 `output/reports` 可以,`output/.cache/reports` 和 `.assistant/state` 不行。
|
|
157
|
+
|
|
158
|
+
## 3. 怎么改
|
|
159
|
+
|
|
160
|
+
### 3.1 先读,再写
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
ec pa-workspace navigation show
|
|
164
|
+
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
拿到当前的 `navigationRevision`。
|
|
168
|
+
|
|
169
|
+
### 3.2 完整替换,不是局部 patch
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
ec pa-workspace navigation update \
|
|
173
|
+
--expected-revision 3 \
|
|
174
|
+
--entries-json '[{"id":"reports","title":"报告","path":"output/reports","kind":"directory","order":10},{"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20}]'
|
|
175
|
+
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
- `--entries-json` 必须是**完整数组**。要保留的入口必须一并传回,否则等于删除。
|
|
179
|
+
- `--expected-revision` 是数值并发校验。revision 已变则返回 `CONFLICT`:
|
|
180
|
+
重新 `show`、合并用户仍要保留的入口、再提交。**不要**覆盖并发修改。
|
|
181
|
+
- 成功后 `navigationRevision` 加 1,返回新状态。
|
|
182
|
+
|
|
183
|
+
### 3.3 先发布入口、后创建目录
|
|
184
|
+
|
|
185
|
+
目标还没建好时,用 `unavailable` 占位:
|
|
186
|
+
|
|
187
|
+
```json
|
|
188
|
+
{"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20,"availability":"unavailable","reason":"目录尚未创建"}
|
|
189
|
+
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
目录建好后再次 update 改为 `available`。
|
|
193
|
+
|
|
194
|
+
### 3.4 隐藏入口
|
|
195
|
+
|
|
196
|
+
从 `entries` 数组里**移除**即可。不要用 `unavailable` 假装隐藏 —— 那会留一个带原因的可见入口。
|
|
197
|
+
|
|
198
|
+
## 4. 常见任务
|
|
199
|
+
|
|
200
|
+
| 用户说 | 怎么做 |
|
|
201
|
+
| --- | --- |
|
|
202
|
+
| "加一个旅行计划入口" | 确认 output/travel/ 存在(不存在则先建,或标 unavailable)→ 追加 entry → update |
|
|
203
|
+
| "把报告放到最前面" | 把该 entry 的 order 调成比其他都小 → update |
|
|
204
|
+
| "把'报告'改名叫'周报'" | 只改 title,保留原 id 和 path → update |
|
|
205
|
+
| "把 X 入口藏起来" | 从数组移除 X → update |
|
|
206
|
+
| "让 B 助理那边也显示我的报告" | 在 B 的工作区执行 update,指到 B 自己可见的路径 |
|
|
207
|
+
| "把我另一个助理的周报放进来看" | 当前版本不支持,见 §6 |
|
|
208
|
+
|
|
209
|
+
## 5. 自检清单
|
|
210
|
+
|
|
211
|
+
改完逐条确认:
|
|
212
|
+
|
|
213
|
+
- [ ] 保留的入口都在新数组里(完整替换语义)
|
|
214
|
+
|
|
215
|
+
- [ ] `id` 没重复,改名时 ID 未变
|
|
216
|
+
|
|
217
|
+
- [ ] `path` 没重复
|
|
218
|
+
|
|
219
|
+
- [ ] `path` 不含冒号、绝对路径前缀、`..` 段
|
|
220
|
+
|
|
221
|
+
- [ ] `path` 没有以 `.` 开头的段,也没命中 `capture/_manifest`
|
|
222
|
+
|
|
223
|
+
- [ ] `kind` 与实际目标是目录还是文件一致
|
|
224
|
+
|
|
225
|
+
- [ ] `unavailable` 的入口都带了 `reason`
|
|
226
|
+
|
|
227
|
+
- [ ] 用 `ec pa-workspace navigation show` 复核结果
|
|
228
|
+
|
|
229
|
+
## 6. 当前版本不支持跨 Agent 入口
|
|
230
|
+
|
|
231
|
+
一个 PA 的导航**只能指向自己工作区里的文件**。
|
|
232
|
+
|
|
233
|
+
不要尝试写 `source` / `uri` / `fs://` 之类的字段来指向别的 Agent:
|
|
234
|
+
Core 的入口校验只读取 §2.2 列出的字段,**未知字段会被静默丢弃**,
|
|
235
|
+
既不报错也不生效 —— 你会以为配置成功了,实际入口指向的还是自己。
|
|
236
|
+
|
|
237
|
+
跨 Agent 聚合仍在设计中,落地后本文会同步更新。在此之前,跨 Agent 的产物
|
|
238
|
+
由各自 PA 在自己的导航里发布。
|
|
239
|
+
|
|
240
|
+
## 7. 不能做的事
|
|
241
|
+
|
|
242
|
+
- 不要把这份数据叫 `manifest` —— 会和 EvolCore 已有的 manifest 体系混淆。
|
|
243
|
+
- 不要把主机绝对路径、IP、端口写进导航。
|
|
244
|
+
- 不要在导航里放短期凭证。凭证由 Core 在读取时另行签发。
|
|
245
|
+
- 不要指望 App 按入口 ID 写死专用页面。`id` 只用于稳定关联,不影响能否打开。
|
|
246
|
+
- 不要修改 `pa-workspace-state.json` 的 `workspaceId`、`ownerAid`、`rootPath`。
|
|
247
|
+
改绑定用 `ec pa-workspace bind --workspace "<新路径>"`。
|
|
248
|
+
- 本命令只在当前 Agent 与其 Owner 的 AUN 私聊托管会话中可用。
|
|
249
|
+
|
|
250
|
+
## 8. 点开后发生什么
|
|
251
|
+
|
|
252
|
+
App 按 `kind` 和实际文件格式决定展示方式:
|
|
253
|
+
|
|
254
|
+
| 格式 | 展示 |
|
|
255
|
+
| --- | --- |
|
|
256
|
+
| Markdown | Markdown 阅读页,相对链接和图片可解析 |
|
|
257
|
+
| 静态 HTML | 静态文档阅读,保留版式与相对 CSS/图片,脚本被移除 |
|
|
258
|
+
| 纯文本 | 等宽文本 |
|
|
259
|
+
| JSON / JSONL / YAML | 按文本展示 |
|
|
260
|
+
| 图片 / 音频 / 视频 / PDF | 有预览能力则预览,否则显示"不支持预览" |
|
|
261
|
+
| 未知二进制 | 文件信息 |
|
|
262
|
+
|
|
263
|
+
**新增产物只要落在通用阅读能力内,就不需要 App 发版。**
|
|
264
|
+
|
|
265
|
+
## 9. 相关
|
|
266
|
+
|
|
267
|
+
- `ec pa-workspace init` / `bind`:初始化与更换工作区,见本目录 `pa-workspace.md`
|
|
268
|
+
- 文件读取协议:`menu-protocol.md` 的 file 段
|
|
269
|
+
- 工作区目录规范:`personal-assistant` Skill
|
|
270
|
+
|
|
271
|
+
## 10. 设计背景(仅源码仓库)
|
|
272
|
+
|
|
273
|
+
以下文档**只在 EvolCore 源码仓库里**,不随 npm 包发布,安装后的机器上打不开。
|
|
274
|
+
完成导航操作不需要读它们,仅在参与开发时参考:
|
|
275
|
+
|
|
276
|
+
| 文档 | 内容 |
|
|
277
|
+
| --- | --- |
|
|
278
|
+
| docs/personal-assistant/workspace-browser-v1/schema.json | evol.pa-workspace 导航响应的正式 JSON Schema(与本文的写入格式不同) |
|
|
279
|
+
| docs/personal-assistant/13-cross-agent-artifact-navigation.md | 跨 Agent 入口的设计、双端实施清单、权限边界 |
|
|
@@ -14,6 +14,7 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
|
|
|
14
14
|
| 参数 | 值 | 说明 |
|
|
15
15
|
|------|-----|------|
|
|
16
16
|
| `to` | daemon control AID | 目标 daemon 的 AID |
|
|
17
|
+
| `message_class` | `control` | Menu 是应用控制协议,使用独立 control 消息流;不使用 SDK 内部的 `sdk_control` |
|
|
17
18
|
| `encrypt` | `true` | 必须 E2EE 加密 |
|
|
18
19
|
| `ttl` | `60` | 秒,短生命周期 |
|
|
19
20
|
| `payload` | menu request 对象 | 见下方消息类型 |
|
|
@@ -68,12 +68,14 @@ ec model check [--self <aid>]
|
|
|
68
68
|
|
|
69
69
|
| Base agent | 执行与统计的处理方式 |
|
|
70
70
|
|------------|--------------------|
|
|
71
|
-
| Claude Code |
|
|
72
|
-
| ecagent |
|
|
71
|
+
| Claude Code | 使用统一能力解析器读取模型目录与本地参数,设置 SDK 自动压缩阈值;查询与手动压缩使用同一解析路径 |
|
|
72
|
+
| ecagent | 从本次请求的 Provider 模型目录解析 `contextWindow` 和输出上限 `maxTokens`;查询、手动压缩和上下文统计共用参数 |
|
|
73
73
|
| Codex | 优先使用 app-server 实时窗口;缺窗口时仅用参数表补齐统计,不修改 Codex 的执行窗口或压缩配置 |
|
|
74
74
|
| Gemini | 执行窗口和压缩仍交给 Gemini CLI 管理,不从参数表注入执行参数 |
|
|
75
75
|
|
|
76
|
-
Claude Code 和 ecagent 的窗口优先级为:显式 `[1m]` / `[200k]` 后缀 → 有效参数表记录 → runner
|
|
76
|
+
Claude Code 和 ecagent 的窗口优先级为:显式 `[1m]` / `[200k]` 后缀 → 当前 Provider 模型目录 → 有效参数表记录 → runner 原有保守兜底。输出上限独立按目录 → 本地参数 → 兜底解析。统一解析器支持运行时报告窗口优先校正;没有实际报告时不猜测模型容量。
|
|
77
77
|
ecagent 发给网关的模型 ID 不携带窗口后缀。Codex 没有实时窗口且参数表也无记录时,不虚构通用窗口。
|
|
78
78
|
|
|
79
|
+
ecagent 自动压缩阈值为 `min(650000, contextWindow - max(压缩预留, 输出上限, 安全预留))`,安全预留为窗口的 5%(最多 10000),阈值至少为 1。压缩预留使用 harness 的实际默认设置(16384)。统计中的 `autoCompactTokens` 与 harness 使用同一阈值,`contextWindowSource` 和运行日志区分目录、本地参数、显式后缀及保守兜底;没有参数的未知模型回退到 128k,不代表模型官方上限。
|
|
80
|
+
|
|
79
81
|
模型理论窗口与网关、团队的请求额度是不同限制;查表得到 1M 窗口,不代表可以突破团队的 200K 请求上限。
|
|
@@ -4,7 +4,8 @@
|
|
|
4
4
|
|
|
5
5
|
它**不是**联系人管理入口。谁能联系这个 Agent 由 Owner 在 Evol App 的联系人名录里决定,
|
|
6
6
|
准入按名录归属分三档(见 `config.md` 的「Agent 消息准入策略」)。添加联系人、审批入群申请都由 Owner 完成,
|
|
7
|
-
Agent
|
|
7
|
+
Agent 侧可以通过 `ec directory request <target-aid> --self <agent-aid> [--note <申请说明>]`
|
|
8
|
+
向本端 Owner 申请添加目标(见 `directory.md`);添加和审批仍由 Owner 在 Evol App 中完成。
|
|
8
9
|
|
|
9
10
|
`peers.json` 与 Owner 名录副本 `contacts.json` 是两份不同的文件:后者是 Owner 侧推下来的只读名录,
|
|
10
11
|
前者是本 Agent 自己的身份映射表。
|
|
@@ -39,12 +39,14 @@ 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
|
|
42
|
+
`paactive` 是 PA 私聊的展示分支:它复用 interactive 的执行流、ECK manifest/vars、工具、文件、审批/提问和 notify;模型公开文本(含最终文本)改为 AUN `activity.item.kind=text`,正式回复须经托管 `ec msg send`。它不使用 proactive 的工具表态门禁或 thought.put,只在 active AUN 人类 Owner 私聊主会话与话题生效。群聊不支持 interactive/paactive,固定使用 proactive。
|
|
43
43
|
|
|
44
|
-
可由目标私聊的 `/chatmode paactive`、Menu 或 Agent `chatmode.private` 配置选择。关系级写入要求已有 `targetKind=private` 的 AUN 关系;`chatmode.group`
|
|
44
|
+
可由目标私聊的 `/chatmode paactive`、Menu 或 Agent `chatmode.private` 配置选择。关系级写入要求已有 `targetKind=private` 的 AUN 关系;`chatmode.group` 只允许 proactive。旧 schema 保存的 group=interactive 读取时按 proactive 兼容,新写入会被拒绝。配置变更对下一任务生效,当前运行任务保持原模式。
|
|
45
45
|
|
|
46
46
|
paactive 的 `show_activities=all/text/none` 保持原显示设置:`all` 展示过程文本和工具活动,`text` 展示过程文本,`none` 隐藏中间过程;最终模型文本均投影为 activity。activity 投递失败不会降级成普通回复。
|
|
47
47
|
|
|
48
|
+
proactive 也遵守 `show_activities`:`all` 投递全部 thought,`text` 只投递模型文本,`none` 不投递 thought(含最终模型文本)。未显式配置时,群聊默认 `none`,私聊默认 `all`;显式配置仍按关系 > Agent > defaults 覆盖。群聊通过 Menu 或 `ec config` 调整,私聊也可使用 `/activity all|text|none`。本地任务活动记录、正式 `ec msg/group send` 和任务状态通知不受此参数影响。
|
|
49
|
+
|
|
48
50
|
## 作用域(越具体越优先:关系 > agent > 全局)
|
|
49
51
|
|
|
50
52
|
| 参数 | 作用域 | 落盘 |
|
|
@@ -11,6 +11,8 @@ ec task resume <sessionId> --format json
|
|
|
11
11
|
|
|
12
12
|
`__task-recovery` 自动恢复要求原错误事件和持久终态都明确为 `recoverable: true`;`false` 或缺失不自动重试。依赖缺失、权限或配置问题需先修复,之后可人工执行本命令;人工恢复不受该布尔字段限制,但仍遵守会话绑定、待审批、任务代际和取消等安全检查。
|
|
13
13
|
|
|
14
|
+
零工作协议失败(`input_not_consumed` / `empty_success`)在本轮协议重放耗尽后标记为可恢复失败,错误事件和持久终态均为 `recoverable: true`,由现有任务恢复机制处理;不因此放宽未闭合工具或交互的恢复条件。
|
|
15
|
+
|
|
14
16
|
恢复任务继承原任务的审批交互策略,而非因为自动恢复使用 Trigger 就禁止审批。普通会话(包括 Agent 间和群聊的 proactive 模式)允许申请审批;无人值守 Trigger 禁止申请审批。Handoff 回流同样继承发起任务的策略。继承策略不等于复用旧审批,新的待审批操作仍须发起新请求;缺少历史策略时,自动恢复和 Handoff 回流默认禁止审批,手动恢复默认允许申请。
|
|
15
17
|
|
|
16
18
|
以下情况会安全结束而不创建新会话:任务已完成或正在运行、任务等待必要输入/审批、会话已删除、原 provider 会话文件不存在、渠道不可用,或任务状态已被更新。
|
|
@@ -167,7 +167,7 @@ ec msg send '<消息内容>' --thread <threadId> --check-every 30m
|
|
|
167
167
|
- 通知内容:复查次数、来源话题(名称 + threadId)、当前话题、发送时间、已过时长、
|
|
168
168
|
复查周期、Trigger id、原消息正文
|
|
169
169
|
- 结束/调整用返回的 `trigger_id`(形如 `trig_…`)——`ec trigger` 的定位标识是 **id 不是名称**
|
|
170
|
-
- **结束复查用 `ec trigger delete <id>`,不要用 `ec trigger
|
|
170
|
+
- **结束复查用 `ec trigger delete <id>`,不要用 `ec trigger disable`**:disable 只是停用后续调度,
|
|
171
171
|
定义和调度状态仍留在磁盘上,复查这种用完即弃的 Trigger 会积压成大量永不触发的死定义
|
|
172
172
|
- **每次发送都新建一个复查**;要延长周期请用 `ec trigger update <id> --every <时长>`,
|
|
173
173
|
不要重发一条带 `--check-every` 的消息
|
|
@@ -91,8 +91,11 @@ trusted fullaccess
|
|
|
91
91
|
| 命令/操作 | Owner + bypass 托管任务 | trusted fullaccess 任务 | DaemonOwner 管理请求 |
|
|
92
92
|
|---|---|---|---|
|
|
93
93
|
| `ec aid list` | 可列本地身份及受支持的筛选项 | 可执行 | 宿主或受支持的控制面入口处理 |
|
|
94
|
-
| `ec directory
|
|
94
|
+
| `ec directory list\|info\|refresh\|blocked --self <aid>` | 需要符合当前 Agent/同 Owner 的目标范围 | 可进入授权执行路径 | 不能仅凭 DaemonOwner 身份推导出该 Agent 的 Owner 关系 |
|
|
95
95
|
| `ec provider list` | 不能单凭 Agent Owner+bypass 获得进程权限 | 通用授权允许 | 受认证的 DaemonOwner 控制入口允许 |
|
|
96
|
+
| `ec logs --raw` | 托管任务不可用 | 通过 daemon 验证后使用宿主日志路径输出原始日志 | 宿主终端可用 |
|
|
97
|
+
| `ec start\|stop\|restart\|restart-monitor`;`ec update` | 托管任务不可用 | 不能改变承载当前任务的实例生命周期;`ec upgrade` 检查和 `ec update status` 可用 | 宿主终端按目标实例执行 |
|
|
98
|
+
| `ec config set\|unset fullaccess.*` | 托管 CLI 不允许修改持久 Agent fullaccess 策略 | 托管 CLI 不允许修改持久 Agent fullaccess 策略 | 通过受支持的 ECWeb/双 Owner 管理入口配置 |
|
|
96
99
|
| `ec fs` 访问当前 Agent 个人存储 | Owner 身份满足个人存储角色要求,路径等仍需通过 | 通过通用角色授权,资源校验仍在 | 不从 DaemonOwner 自动推导出 Agent Owner 关系 |
|
|
97
100
|
| `ec msg history` 的非 AUN selector | CLI 送 daemon 判断;普通托管任务仍受 Trigger 等专用目标约束 | 可通过相关授权分支,仍验证 selector 和历史资源 | 取决于实际请求入口,不是一般的 process 操作 |
|
|
98
101
|
| 重启承载当前任务的 EvolCore 实例 | bypass 不解除保护 | fullaccess 也不解除保护 | 可由获准的宿主管理入口执行;托管任务不能借操作人的 Owner 身份绕过保护 |
|