evolcore 0.0.43-test.3 → 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 +36 -0
- 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 +130 -35
- package/dist/aun/aid/agentmd.js +31 -12
- 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/service-proxy.js +3 -0
- package/dist/channels/aun.js +26 -5
- package/dist/channels/daemon.js +10 -2
- package/dist/cli/agent-command.js +5 -0
- package/dist/cli/agent-create.js +28 -6
- package/dist/cli/agent.js +9 -3
- package/dist/cli/aun-commands.js +2 -2
- package/dist/cli/daemon-commands.js +30 -18
- package/dist/cli/directory.js +4 -7
- package/dist/cli/getmeta-command.js +2 -1
- package/dist/cli/init.js +13 -5
- package/dist/cli/trigger-command.js +20 -14
- package/dist/config/boot-log.js +12 -2
- package/dist/config/config-field-policy.js +2 -0
- package/dist/config/config-manager.js +9 -4
- package/dist/config/peer-role-resolver.js +1 -1
- package/dist/config/role-schema.js +3 -3
- 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 +3 -3
- package/dist/core/auth/operation-authorizer.js +2 -1
- 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/command/agent-control.js +4 -1
- package/dist/core/command/chatmode-config.js +46 -0
- package/dist/core/command/command-handler.js +5 -14
- package/dist/core/command/daemon-diagnostics.js +2 -1
- package/dist/core/command/menu-catalog.js +1 -1
- package/dist/core/command/menu-handler.js +16 -16
- package/dist/core/command/slash-handler.js +4 -26
- package/dist/core/daemon-lifecycle.js +35 -17
- package/dist/core/event-catalog.js +19 -0
- package/dist/core/evolagent-registry.js +3 -0
- package/dist/core/ipc-registration.js +6 -0
- package/dist/core/message/im-renderer.js +24 -19
- package/dist/core/message/message-admission.js +11 -2
- package/dist/core/message/response-engine.js +17 -18
- 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 +6 -6
- package/dist/core/permission/ec-command-parser.js +47 -12
- package/dist/core/plugin-lifecycle.js +6 -2
- package/dist/core/relation/pa-team.js +7 -2
- package/dist/directory/owner-directory-cache.js +4 -2
- package/dist/directory/owner-directory-query-operation.js +5 -7
- package/dist/ecweb/runtime/lifecycle.js +29 -5
- package/dist/ecweb/runtime/supervisor.js +83 -27
- package/dist/index.js +198 -38
- package/dist/proxy/service-supervisor.js +377 -141
- 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 +45 -10
- package/dist/trigger/validation.js +0 -13
- package/dist/utils/error-utils.js +8 -0
- 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/dist/harness/compaction/branch-summarization.js +1 -1
- package/ecagent/dist/harness/compaction/compaction.js +4 -4
- package/kits/docs/evolcore/INDEX.md +1 -1
- package/kits/docs/evolcore/file-navigation.md +63 -49
- package/kits/docs/evolcore/menu-protocol.md +1 -0
- package/kits/docs/evolcore/model.md +5 -3
- package/kits/docs/evolcore/response.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/eck_manifest.json +0 -21
- 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 +13 -26
- 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/skills/ec-service-proxy/SKILL.md +10 -0
- package/kits/skills/ec-trigger/SKILL.md +1 -1
- package/kits/templates/system-fragments/commands.md +1 -1
- package/kits/templates/system-fragments/identity.md +0 -1
- package/package.json +18 -13
- package/kits/schemas/agent-config.schema.20.json +0 -925
- package/kits/schemas/relation-config.schema.13.json +0 -289
- package/kits/schemas/role-config.schema.3.json +0 -1038
|
@@ -43,6 +43,15 @@ function approximateSelfStartTime() {
|
|
|
43
43
|
const uptimeMs = Math.round(process.uptime() * 1000);
|
|
44
44
|
return uptimeMs > 0 ? Date.now() - uptimeMs : Date.now();
|
|
45
45
|
}
|
|
46
|
+
/**
|
|
47
|
+
* 身份校验路径上同一个 PID 会被连着查两三次(`sameProcess()` 在优雅停止前后各查一次,
|
|
48
|
+
* 端口候选还要再查一次),Windows 上每次都是一整个 PowerShell 进程(约 0.5–1s)。
|
|
49
|
+
* 启动时间对同一个 PID 是常量,缓存复用没有语义风险;PID 复用要落到同一个缓存槽里
|
|
50
|
+
* 需要在一个 TTL 内退出并复刻出同一个 PID,实际不可能,且 `startTimeMatches` 本身
|
|
51
|
+
* 有 2s 容差。TTL 取短一些,避免让「进程已换人」的判断比容差更迟钝。
|
|
52
|
+
*/
|
|
53
|
+
const START_TIME_CACHE_TTL_MS = 5000;
|
|
54
|
+
const startTimeCache = new Map();
|
|
46
55
|
/**
|
|
47
56
|
* 获取进程启动时间(Unix 毫秒)。
|
|
48
57
|
* 拿不到时返回 null,调用方应保守处理(不杀该 PID)。
|
|
@@ -54,11 +63,22 @@ export function getProcessStartTime(pid) {
|
|
|
54
63
|
selfStartTime = approximateSelfStartTime();
|
|
55
64
|
return selfStartTime;
|
|
56
65
|
}
|
|
57
|
-
|
|
66
|
+
const cached = startTimeCache.get(pid);
|
|
67
|
+
const now = Date.now();
|
|
68
|
+
if (cached && now - cached.at < START_TIME_CACHE_TTL_MS)
|
|
69
|
+
return cached.startedAt;
|
|
70
|
+
const startedAt = readProcessStartTime(pid);
|
|
71
|
+
// 只缓存成功结果:查不到往往是权限或瞬时失败,缓存成 null 会掩盖后续可查到的情形。
|
|
72
|
+
if (startedAt === null)
|
|
73
|
+
startTimeCache.delete(pid);
|
|
74
|
+
else
|
|
75
|
+
startTimeCache.set(pid, { at: now, startedAt });
|
|
76
|
+
return startedAt;
|
|
58
77
|
}
|
|
59
78
|
/** 测试用:清掉自身启动时间缓存。 */
|
|
60
79
|
export function resetSelfStartTimeCache() {
|
|
61
80
|
selfStartTime = null;
|
|
81
|
+
startTimeCache.clear();
|
|
62
82
|
}
|
|
63
83
|
function readProcessStartTime(pid) {
|
|
64
84
|
try {
|
|
@@ -55,7 +55,13 @@ export class StartupTracer {
|
|
|
55
55
|
constructor(source, opts = {}) {
|
|
56
56
|
this.source = source;
|
|
57
57
|
this.kind = opts.kind ?? 'startup';
|
|
58
|
-
|
|
58
|
+
let traceId = opts.traceId;
|
|
59
|
+
if (source === 'daemon' && this.kind === 'startup') {
|
|
60
|
+
traceId ??= process.env[STARTUP_TRACE_ID_ENV] || undefined;
|
|
61
|
+
// 启动关联只消费一次,不能让重启监控或其它子进程继承本次编号。
|
|
62
|
+
delete process.env[STARTUP_TRACE_ID_ENV];
|
|
63
|
+
}
|
|
64
|
+
this.traceId = traceId ?? newStartupTraceId();
|
|
59
65
|
this.processStartMs = opts.processStartMs ?? processStartOfThisProcess();
|
|
60
66
|
this.cursorStartMs = this.processStartMs;
|
|
61
67
|
if (opts.firstPhase)
|
|
@@ -151,7 +151,7 @@ export async function generateBranchSummary(entries, options) {
|
|
|
151
151
|
timestamp: Date.now(),
|
|
152
152
|
},
|
|
153
153
|
];
|
|
154
|
-
const response = await models.completeSimple(model, { systemPrompt: SUMMARIZATION_SYSTEM_PROMPT, messages: summarizationMessages }, { signal, maxTokens: 2048 });
|
|
154
|
+
const response = await models.completeSimple(model, { systemPrompt: SUMMARIZATION_SYSTEM_PROMPT, messages: summarizationMessages }, { signal, maxTokens: 2048, metadata: { requestType: "branch_summary" } });
|
|
155
155
|
if (response.stopReason === "aborted") {
|
|
156
156
|
return err(new BranchSummaryError("aborted", response.errorMessage || "Branch summary aborted"));
|
|
157
157
|
}
|
|
@@ -379,8 +379,8 @@ export async function generateSummary(currentMessages, models, model, reserveTok
|
|
|
379
379
|
},
|
|
380
380
|
];
|
|
381
381
|
const completionOptions = model.reasoning && thinkingLevel && thinkingLevel !== "off"
|
|
382
|
-
? { maxTokens, signal, reasoning: thinkingLevel }
|
|
383
|
-
: { maxTokens, signal };
|
|
382
|
+
? { maxTokens, signal, reasoning: thinkingLevel, metadata: { requestType: "compaction" } }
|
|
383
|
+
: { maxTokens, signal, metadata: { requestType: "compaction" } };
|
|
384
384
|
const response = await models.completeSimple(model, { systemPrompt: SUMMARIZATION_SYSTEM_PROMPT, messages: summarizationMessages }, completionOptions);
|
|
385
385
|
if (response.stopReason === "aborted") {
|
|
386
386
|
return err(new CompactionError("aborted", response.errorMessage || "Summarization aborted"));
|
|
@@ -515,8 +515,8 @@ async function generateTurnPrefixSummary(messages, models, model, reserveTokens,
|
|
|
515
515
|
},
|
|
516
516
|
];
|
|
517
517
|
const response = await models.completeSimple(model, { systemPrompt: SUMMARIZATION_SYSTEM_PROMPT, messages: summarizationMessages }, model.reasoning && thinkingLevel && thinkingLevel !== "off"
|
|
518
|
-
? { maxTokens, signal, reasoning: thinkingLevel }
|
|
519
|
-
: { maxTokens, signal });
|
|
518
|
+
? { maxTokens, signal, reasoning: thinkingLevel, metadata: { requestType: "compaction" } }
|
|
519
|
+
: { maxTokens, signal, metadata: { requestType: "compaction" } });
|
|
520
520
|
if (response.stopReason === "aborted") {
|
|
521
521
|
return err(new CompactionError("aborted", response.errorMessage || "Turn prefix summarization aborted"));
|
|
522
522
|
}
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
| `ec update [status] [--format json]` | 发起/复用唯一升级任务,或查询当前升级状态 | 立即升级/升级状态 |
|
|
26
26
|
| `ec restart` | 重启目标 daemon(承载当前托管会话的实例受生命周期保护) | 重启 |
|
|
27
27
|
| `ec status [--format json]` | 查看运行状态、Agent、队列、渠道连接;JSON 快照 | 状态/查看状态 |
|
|
28
|
-
| `ec logs` | 查看日志(`--level` `--module` `--
|
|
28
|
+
| `ec logs` | 查看日志(`--level` `--module` `--no-color`);`--raw` 可在宿主终端或 trusted fullaccess 托管任务中使用 | 日志/查看日志 |
|
|
29
29
|
| `ec diagnose` | 诊断启动环境 | 诊断/环境诊断 |
|
|
30
30
|
|
|
31
31
|
ECWeb 托管重启、端口占用与升级失败处理见 `ecweb-lifecycle.md`。
|
|
@@ -1,36 +1,38 @@
|
|
|
1
1
|
# PA 工作区入口导航:agent 操作手册
|
|
2
2
|
|
|
3
|
-
个人助理(PA)自己的工作区产物,通过一份**入口导航**暴露给 Evol App 的头像入口。
|
|
3
|
+
个人助理(PA)自己的工作区产物,通过一份**入口导航**暴露给 Evol App 的头像入口。
|
|
4
4
|
新增一个产物目录要给用户看到,改导航即可,不需要 App 发版。
|
|
5
5
|
|
|
6
|
-
本文是给 agent 读的完整操作手册:文件在哪、格式是什么、怎么安全地改。
|
|
6
|
+
本文是给 agent 读的完整操作手册:文件在哪、格式是什么、怎么安全地改。
|
|
7
7
|
**本文自包含**,按本文即可完成导航的增删改,不需要读其他文档。
|
|
8
8
|
|
|
9
9
|
## 1. 文件在哪
|
|
10
10
|
|
|
11
11
|
```text
|
|
12
|
-
$AGENT_DATA_DIR
|
|
12
|
+
$AGENT_DATA_DIR/pa-workspace-state.json
|
|
13
|
+
|
|
13
14
|
```
|
|
14
15
|
|
|
15
|
-
其中 `rootPath` 是本机绝对路径,**永远不会发给 App**。
|
|
16
|
+
其中 `rootPath` 是本机绝对路径,**永远不会发给 App**。
|
|
16
17
|
被导航指向的真实文件在 PA 工作区里(`capture/`、`output/` 等),导航只存"指向哪里",不存内容。
|
|
17
18
|
|
|
18
19
|
### 1.1 三个名字指同一份数据
|
|
19
20
|
|
|
20
21
|
| 名字 | 指什么 |
|
|
21
22
|
| --- | --- |
|
|
22
|
-
|
|
|
23
|
-
|
|
|
24
|
-
|
|
|
23
|
+
| pa-workspace-state.json | 磁盘上的完整状态:绑定信息(workspaceId/ownerAid/rootPath)+ navigationRevision + entries |
|
|
24
|
+
| file-navigation.json | 导航内容本身,即 {version, entries} 这部分。协议与设计文档里的叫法 |
|
|
25
|
+
| --entries-json | 命令参数,取值就是 file-navigation.json 的 entries 数组 |
|
|
25
26
|
|
|
26
|
-
**改导航一律用命令**,把 `entries` 数组整体传给 `--entries-json`。命令会校验、
|
|
27
|
-
递增 `navigationRevision`、做并发保护,并对每个入口做真实路径检查。
|
|
27
|
+
**改导航一律用命令**,把 `entries` 数组整体传给 `--entries-json`。命令会校验、
|
|
28
|
+
递增 `navigationRevision`、做并发保护,并对每个入口做真实路径检查。
|
|
28
29
|
手工编辑 `pa-workspace-state.json` 会跳过全部这些保护。
|
|
29
30
|
|
|
30
31
|
导出当前导航为 `file-navigation.json`:
|
|
31
32
|
|
|
32
33
|
```bash
|
|
33
34
|
ec pa-workspace navigation show
|
|
35
|
+
|
|
34
36
|
```
|
|
35
37
|
|
|
36
38
|
该命令**只输出 JSON**,`--format json` / `--json` 可加但无区别。
|
|
@@ -44,13 +46,14 @@ ec pa-workspace navigation show
|
|
|
44
46
|
"version": 1,
|
|
45
47
|
"entries": []
|
|
46
48
|
}
|
|
49
|
+
|
|
47
50
|
```
|
|
48
51
|
|
|
49
52
|
`--entries-json` 只接收 `entries` 数组,`version` 由命令维护。
|
|
50
53
|
|
|
51
54
|
### 2.1 完整 Schema
|
|
52
55
|
|
|
53
|
-
Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读取下列字段,
|
|
56
|
+
Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读取下列字段,
|
|
54
57
|
其余字段被静默丢弃 —— 写错字段名不会报错,只会无声失效。
|
|
55
58
|
|
|
56
59
|
```json
|
|
@@ -123,32 +126,33 @@ Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读
|
|
|
123
126
|
}
|
|
124
127
|
}
|
|
125
128
|
}
|
|
129
|
+
|
|
126
130
|
```
|
|
127
131
|
|
|
128
132
|
### 2.2 字段行为细节
|
|
129
133
|
|
|
130
134
|
| 字段 | 省略时 | 校验失败时 |
|
|
131
135
|
| --- | --- | --- |
|
|
132
|
-
|
|
|
133
|
-
|
|
|
134
|
-
|
|
|
135
|
-
|
|
|
136
|
-
|
|
|
137
|
-
|
|
|
138
|
-
|
|
|
139
|
-
|
|
|
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 |
|
|
140
144
|
|
|
141
145
|
额外规则:
|
|
142
146
|
|
|
143
|
-
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
146
|
-
-
|
|
147
|
-
-
|
|
147
|
+
- `entries` 最多 200 项。
|
|
148
|
+
- `id` 不能重复,`path` 也不能重复,两者分别查重。
|
|
149
|
+
- 排序是 `order` 升序 → `title` 本地化字典序 → `path` 字典序,不只是 `order`。
|
|
150
|
+
- 目标不存在时,必须显式 `availability: "unavailable"` + `reason`,否则返回 `NOT_FOUND`。
|
|
151
|
+
- `path` 的反斜杠会被**替换**成 `/` 并归一化,不是报错;但归一化后不能命中隐藏路径。
|
|
148
152
|
|
|
149
153
|
### 2.3 隐藏路径的判据
|
|
150
154
|
|
|
151
|
-
任何一个路径段以 `.` 开头即被拒绝,`capture/_manifest` 也拒绝。
|
|
155
|
+
任何一个路径段以 `.` 开头即被拒绝,`capture/_manifest` 也拒绝。
|
|
152
156
|
所以 `output/reports` 可以,`output/.cache/reports` 和 `.assistant/state` 不行。
|
|
153
157
|
|
|
154
158
|
## 3. 怎么改
|
|
@@ -157,6 +161,7 @@ Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读
|
|
|
157
161
|
|
|
158
162
|
```bash
|
|
159
163
|
ec pa-workspace navigation show
|
|
164
|
+
|
|
160
165
|
```
|
|
161
166
|
|
|
162
167
|
拿到当前的 `navigationRevision`。
|
|
@@ -167,12 +172,13 @@ ec pa-workspace navigation show
|
|
|
167
172
|
ec pa-workspace navigation update \
|
|
168
173
|
--expected-revision 3 \
|
|
169
174
|
--entries-json '[{"id":"reports","title":"报告","path":"output/reports","kind":"directory","order":10},{"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20}]'
|
|
175
|
+
|
|
170
176
|
```
|
|
171
177
|
|
|
172
|
-
-
|
|
173
|
-
-
|
|
174
|
-
|
|
175
|
-
-
|
|
178
|
+
- `--entries-json` 必须是**完整数组**。要保留的入口必须一并传回,否则等于删除。
|
|
179
|
+
- `--expected-revision` 是数值并发校验。revision 已变则返回 `CONFLICT`:
|
|
180
|
+
重新 `show`、合并用户仍要保留的入口、再提交。**不要**覆盖并发修改。
|
|
181
|
+
- 成功后 `navigationRevision` 加 1,返回新状态。
|
|
176
182
|
|
|
177
183
|
### 3.3 先发布入口、后创建目录
|
|
178
184
|
|
|
@@ -180,6 +186,7 @@ ec pa-workspace navigation update \
|
|
|
180
186
|
|
|
181
187
|
```json
|
|
182
188
|
{"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20,"availability":"unavailable","reason":"目录尚未创建"}
|
|
189
|
+
|
|
183
190
|
```
|
|
184
191
|
|
|
185
192
|
目录建好后再次 update 改为 `available`。
|
|
@@ -192,46 +199,53 @@ ec pa-workspace navigation update \
|
|
|
192
199
|
|
|
193
200
|
| 用户说 | 怎么做 |
|
|
194
201
|
| --- | --- |
|
|
195
|
-
| "加一个旅行计划入口" | 确认
|
|
196
|
-
| "把报告放到最前面" | 把该 entry 的
|
|
197
|
-
| "把'报告'改名叫'周报'" | 只改
|
|
202
|
+
| "加一个旅行计划入口" | 确认 output/travel/ 存在(不存在则先建,或标 unavailable)→ 追加 entry → update |
|
|
203
|
+
| "把报告放到最前面" | 把该 entry 的 order 调成比其他都小 → update |
|
|
204
|
+
| "把'报告'改名叫'周报'" | 只改 title,保留原 id 和 path → update |
|
|
198
205
|
| "把 X 入口藏起来" | 从数组移除 X → update |
|
|
199
|
-
| "让 B 助理那边也显示我的报告" | 在
|
|
200
|
-
| "把我另一个助理的周报放进来看" |
|
|
206
|
+
| "让 B 助理那边也显示我的报告" | 在 B 的工作区执行 update,指到 B 自己可见的路径 |
|
|
207
|
+
| "把我另一个助理的周报放进来看" | 当前版本不支持,见 §6 |
|
|
201
208
|
|
|
202
209
|
## 5. 自检清单
|
|
203
210
|
|
|
204
211
|
改完逐条确认:
|
|
205
212
|
|
|
206
213
|
- [ ] 保留的入口都在新数组里(完整替换语义)
|
|
214
|
+
|
|
207
215
|
- [ ] `id` 没重复,改名时 ID 未变
|
|
216
|
+
|
|
208
217
|
- [ ] `path` 没重复
|
|
218
|
+
|
|
209
219
|
- [ ] `path` 不含冒号、绝对路径前缀、`..` 段
|
|
220
|
+
|
|
210
221
|
- [ ] `path` 没有以 `.` 开头的段,也没命中 `capture/_manifest`
|
|
222
|
+
|
|
211
223
|
- [ ] `kind` 与实际目标是目录还是文件一致
|
|
224
|
+
|
|
212
225
|
- [ ] `unavailable` 的入口都带了 `reason`
|
|
226
|
+
|
|
213
227
|
- [ ] 用 `ec pa-workspace navigation show` 复核结果
|
|
214
228
|
|
|
215
229
|
## 6. 当前版本不支持跨 Agent 入口
|
|
216
230
|
|
|
217
231
|
一个 PA 的导航**只能指向自己工作区里的文件**。
|
|
218
232
|
|
|
219
|
-
不要尝试写 `source` / `uri` / `fs://` 之类的字段来指向别的 Agent:
|
|
220
|
-
Core 的入口校验只读取 §2.2 列出的字段,**未知字段会被静默丢弃**,
|
|
233
|
+
不要尝试写 `source` / `uri` / `fs://` 之类的字段来指向别的 Agent:
|
|
234
|
+
Core 的入口校验只读取 §2.2 列出的字段,**未知字段会被静默丢弃**,
|
|
221
235
|
既不报错也不生效 —— 你会以为配置成功了,实际入口指向的还是自己。
|
|
222
236
|
|
|
223
|
-
跨 Agent 聚合仍在设计中,落地后本文会同步更新。在此之前,跨 Agent 的产物
|
|
237
|
+
跨 Agent 聚合仍在设计中,落地后本文会同步更新。在此之前,跨 Agent 的产物
|
|
224
238
|
由各自 PA 在自己的导航里发布。
|
|
225
239
|
|
|
226
240
|
## 7. 不能做的事
|
|
227
241
|
|
|
228
|
-
-
|
|
229
|
-
-
|
|
230
|
-
-
|
|
231
|
-
-
|
|
232
|
-
-
|
|
233
|
-
|
|
234
|
-
-
|
|
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 私聊托管会话中可用。
|
|
235
249
|
|
|
236
250
|
## 8. 点开后发生什么
|
|
237
251
|
|
|
@@ -250,16 +264,16 @@ App 按 `kind` 和实际文件格式决定展示方式:
|
|
|
250
264
|
|
|
251
265
|
## 9. 相关
|
|
252
266
|
|
|
253
|
-
-
|
|
254
|
-
-
|
|
255
|
-
-
|
|
267
|
+
- `ec pa-workspace init` / `bind`:初始化与更换工作区,见本目录 `pa-workspace.md`
|
|
268
|
+
- 文件读取协议:`menu-protocol.md` 的 file 段
|
|
269
|
+
- 工作区目录规范:`personal-assistant` Skill
|
|
256
270
|
|
|
257
271
|
## 10. 设计背景(仅源码仓库)
|
|
258
272
|
|
|
259
|
-
以下文档**只在 EvolCore 源码仓库里**,不随 npm 包发布,安装后的机器上打不开。
|
|
273
|
+
以下文档**只在 EvolCore 源码仓库里**,不随 npm 包发布,安装后的机器上打不开。
|
|
260
274
|
完成导航操作不需要读它们,仅在参与开发时参考:
|
|
261
275
|
|
|
262
276
|
| 文档 | 内容 |
|
|
263
277
|
| --- | --- |
|
|
264
|
-
|
|
|
265
|
-
|
|
|
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 请求上限。
|
|
@@ -45,6 +45,8 @@ ec response config set <key> <value> --mode <mode-id> --self <aid> [--peer <X>]
|
|
|
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
|
| 参数 | 作用域 | 落盘 |
|
|
@@ -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 list\|info\|refresh\|blocked --self <aid
|
|
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 身份绕过保护 |
|
|
@@ -241,12 +241,14 @@ script trigger 返回 `[[NOOP]]` 或 `outcome: "noop"` 时走 noop 分支;默
|
|
|
241
241
|
```bash
|
|
242
242
|
--model <模型>
|
|
243
243
|
--effort <low|medium|high|xhigh|max>
|
|
244
|
-
--baseagent <claude|codex|gemini>
|
|
245
244
|
```
|
|
246
245
|
|
|
247
246
|
`--model` / `--effort` 只覆盖本 trigger 执行时传给 base agent 的模型与推理强度。
|
|
248
|
-
`--baseagent`
|
|
249
|
-
|
|
247
|
+
`--baseagent` 已移除。`trigger-session` 始终使用所属 Agent 当前的 active baseagent,
|
|
248
|
+
历史定义中的 `execution.baseagent` 在加载时自动移除并记录迁移审计。
|
|
249
|
+
Agent 切换基座后,旧基座会话保留,新执行使用对应当前基座的会话,不跨基座恢复旧上下文。
|
|
250
|
+
`target-session` 仍由目标会话处理,`script` 不调用模型。已有模型覆盖不会自动清除;
|
|
251
|
+
切换基座时应确认 `--model` / `--effort` 与新基座兼容,或清除覆盖以继承 Agent 默认值。
|
|
250
252
|
|
|
251
253
|
无人值守 trigger 不适合 `request`。需要写文件、git、安装升级、重启服务、管理 trigger 时应显式使用:
|
|
252
254
|
|
|
@@ -272,7 +274,7 @@ owner/admin 通过 `/trigger create` 创建时默认使用 `bypass`;非 admin
|
|
|
272
274
|
```bash
|
|
273
275
|
ec trigger enable <triggerId>
|
|
274
276
|
ec trigger disable <triggerId>
|
|
275
|
-
ec trigger cancel <
|
|
277
|
+
ec trigger cancel <runId> # 中止当前活动运行
|
|
276
278
|
ec trigger delete <triggerId>
|
|
277
279
|
ec trigger remove <triggerId> # delete 的兼容别名
|
|
278
280
|
ec trigger rm <triggerId> # delete 的兼容别名
|
|
@@ -282,12 +284,13 @@ ec trigger rm <triggerId> # delete 的兼容别名
|
|
|
282
284
|
|
|
283
285
|
| 命令 | 定义文件 | 后续调度 | 当前 run | 可恢复 |
|
|
284
286
|
| --- | --- | --- | --- | --- |
|
|
285
|
-
| `disable`
|
|
287
|
+
| `disable` | 保留,写 `enabled: false` | 清理 | 不中断 | 可 `enable` |
|
|
288
|
+
| `cancel` | 保留定义,写入中断审计 | 不影响其它调度 | 中止指定活动 run | 不可恢复该 run |
|
|
286
289
|
| `delete` | 删除整个 trigger 运行态目录,保留 history tombstone | 清理 | 不中断 | 定义不可恢复,审计可复查 |
|
|
287
290
|
|
|
288
|
-
`delete` 不需要先执行 `disable
|
|
291
|
+
`delete` 不需要先执行 `disable`;它内部会先清理 timer/event/schedule,再删除定义。
|
|
289
292
|
|
|
290
|
-
> **用完即弃的 Trigger(如跨话题复查)结束时应使用 `delete` 而不是 `
|
|
293
|
+
> **用完即弃的 Trigger(如跨话题复查)结束时应使用 `delete` 而不是 `disable`**:`disable` 只写
|
|
291
294
|
> `enabled: false`,定义会一直留在 `$EVOLCORE_HOME/agents/<aid>/triggers/` 下,长期积累成
|
|
292
295
|
> 大量永不触发的死定义。
|
|
293
296
|
|
package/kits/eck_manifest.json
CHANGED
|
@@ -98,27 +98,6 @@
|
|
|
98
98
|
},
|
|
99
99
|
"description": "常驻自我定义(00-GUIDE 机制 + 身份/性格/职责/操作铁律;空文件不注入)"
|
|
100
100
|
},
|
|
101
|
-
{
|
|
102
|
-
"id": "peer-self-intro",
|
|
103
|
-
"type": "file",
|
|
104
|
-
"file": "$RELATIONS_DIR/{{peerKey}}/self-intro.md",
|
|
105
|
-
"order": 29,
|
|
106
|
-
"needsInjection": false,
|
|
107
|
-
"optional": true,
|
|
108
|
-
"when": {
|
|
109
|
-
"and": [
|
|
110
|
-
{
|
|
111
|
-
"var": "peerKey",
|
|
112
|
-
"neq": null
|
|
113
|
-
},
|
|
114
|
-
{
|
|
115
|
-
"var": "lifecycle",
|
|
116
|
-
"eq": "active"
|
|
117
|
-
}
|
|
118
|
-
]
|
|
119
|
-
},
|
|
120
|
-
"description": "本端向该对端的自我介绍流水"
|
|
121
|
-
},
|
|
122
101
|
{
|
|
123
102
|
"id": "owner-directory",
|
|
124
103
|
"type": "file",
|