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.
Files changed (109) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/bin/ecmsg.js +229 -0
  3. package/bin/install-codex-managed-hooks.mjs +130 -8
  4. package/dist/ability/application-service.js +37 -0
  5. package/dist/ability/resources.js +28 -0
  6. package/dist/ability/runtime.js +6 -1
  7. package/dist/agents/claude-runner.js +7 -5
  8. package/dist/agents/codex/app-server-client.js +0 -12
  9. package/dist/agents/codex-runner.js +0 -37
  10. package/dist/agents/ecagent-runner.js +130 -35
  11. package/dist/aun/aid/agentmd.js +31 -12
  12. package/dist/aun/menu/client.js +8 -7
  13. package/dist/aun/menu/index.js +1 -1
  14. package/dist/aun/menu/transport.js +8 -5
  15. package/dist/aun/service-proxy.js +3 -0
  16. package/dist/channels/aun.js +26 -5
  17. package/dist/channels/daemon.js +10 -2
  18. package/dist/cli/agent-command.js +5 -0
  19. package/dist/cli/agent-create.js +28 -6
  20. package/dist/cli/agent.js +9 -3
  21. package/dist/cli/aun-commands.js +2 -2
  22. package/dist/cli/daemon-commands.js +30 -18
  23. package/dist/cli/directory.js +4 -7
  24. package/dist/cli/getmeta-command.js +2 -1
  25. package/dist/cli/init.js +13 -5
  26. package/dist/cli/trigger-command.js +20 -14
  27. package/dist/config/boot-log.js +12 -2
  28. package/dist/config/config-field-policy.js +2 -0
  29. package/dist/config/config-manager.js +9 -4
  30. package/dist/config/peer-role-resolver.js +1 -1
  31. package/dist/config/role-schema.js +3 -3
  32. package/dist/config/schema-migration.js +121 -0
  33. package/dist/core/agent-application-service.js +11 -0
  34. package/dist/core/agent-ipc-registration.js +2 -0
  35. package/dist/core/agent-runtime.js +41 -9
  36. package/dist/core/auth/auth-gateway.js +3 -3
  37. package/dist/core/auth/operation-authorizer.js +2 -1
  38. package/dist/core/baseagent-loader.js +11 -3
  39. package/dist/core/bootstrap-service.js +8 -0
  40. package/dist/core/channel-loader.js +61 -23
  41. package/dist/core/command/agent-control.js +4 -1
  42. package/dist/core/command/chatmode-config.js +46 -0
  43. package/dist/core/command/command-handler.js +5 -14
  44. package/dist/core/command/daemon-diagnostics.js +2 -1
  45. package/dist/core/command/menu-catalog.js +1 -1
  46. package/dist/core/command/menu-handler.js +16 -16
  47. package/dist/core/command/slash-handler.js +4 -26
  48. package/dist/core/daemon-lifecycle.js +35 -17
  49. package/dist/core/event-catalog.js +19 -0
  50. package/dist/core/evolagent-registry.js +3 -0
  51. package/dist/core/ipc-registration.js +6 -0
  52. package/dist/core/message/im-renderer.js +24 -19
  53. package/dist/core/message/message-admission.js +11 -2
  54. package/dist/core/message/response-engine.js +17 -18
  55. package/dist/core/model/model-capabilities.js +37 -0
  56. package/dist/core/model/model-catalog.js +6 -2
  57. package/dist/core/ownership/owner-resolver.js +6 -6
  58. package/dist/core/permission/ec-command-parser.js +47 -12
  59. package/dist/core/plugin-lifecycle.js +6 -2
  60. package/dist/core/relation/pa-team.js +7 -2
  61. package/dist/directory/owner-directory-cache.js +4 -2
  62. package/dist/directory/owner-directory-query-operation.js +5 -7
  63. package/dist/ecweb/runtime/lifecycle.js +29 -5
  64. package/dist/ecweb/runtime/supervisor.js +83 -27
  65. package/dist/index.js +198 -38
  66. package/dist/proxy/service-supervisor.js +377 -141
  67. package/dist/trigger/audit.js +3 -2
  68. package/dist/trigger/authorization.js +2 -3
  69. package/dist/trigger/history.js +4 -3
  70. package/dist/trigger/ipc-service.js +24 -19
  71. package/dist/trigger/manager.js +3 -5
  72. package/dist/trigger/parser.js +4 -21
  73. package/dist/trigger/patch.js +3 -15
  74. package/dist/trigger/scheduler.js +45 -10
  75. package/dist/trigger/validation.js +0 -13
  76. package/dist/utils/error-utils.js +8 -0
  77. package/dist/utils/macos-autostart.js +31 -0
  78. package/dist/utils/model-prices.jsonl +15 -8
  79. package/dist/utils/process-introspect.js +21 -1
  80. package/dist/utils/startup-trace.js +7 -1
  81. package/dist/utils/windows-autostart.js +1 -0
  82. package/ecagent/dist/harness/compaction/branch-summarization.js +1 -1
  83. package/ecagent/dist/harness/compaction/compaction.js +4 -4
  84. package/kits/docs/evolcore/INDEX.md +1 -1
  85. package/kits/docs/evolcore/file-navigation.md +63 -49
  86. package/kits/docs/evolcore/menu-protocol.md +1 -0
  87. package/kits/docs/evolcore/model.md +5 -3
  88. package/kits/docs/evolcore/response.md +2 -0
  89. package/kits/docs/evolcore/thread-chain.md +1 -1
  90. package/kits/docs/evolcore/tool-authorization.md +4 -1
  91. package/kits/docs/evolcore/trigger.md +10 -7
  92. package/kits/eck_manifest.json +0 -21
  93. package/kits/rules/01-overview.md +42 -44
  94. package/kits/rules/02-navigation.md +44 -53
  95. package/kits/rules/03-identity.md +21 -25
  96. package/kits/rules/04-relation.md +23 -33
  97. package/kits/rules/05-venue.md +24 -25
  98. package/kits/schemas/_meta.json +13 -26
  99. package/kits/schemas/agent-config.schema.19.json +10 -6
  100. package/kits/schemas/relation-config.schema.12.json +2 -2
  101. package/kits/schemas/role-config.schema.2.json +5 -5
  102. package/kits/skills/ec-service-proxy/SKILL.md +10 -0
  103. package/kits/skills/ec-trigger/SKILL.md +1 -1
  104. package/kits/templates/system-fragments/commands.md +1 -1
  105. package/kits/templates/system-fragments/identity.md +0 -1
  106. package/package.json +18 -13
  107. package/kits/schemas/agent-config.schema.20.json +0 -925
  108. package/kits/schemas/relation-config.schema.13.json +0 -289
  109. 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
- return readProcessStartTime(pid);
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
- this.traceId = opts.traceId ?? newStartupTraceId();
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)
@@ -566,6 +566,7 @@ export function configureWindowsAutostart(enabled, runtimeRoot) {
566
566
  return {
567
567
  ok: false,
568
568
  enabled: false,
569
+ nonFatal: true,
569
570
  error: `已存在同名计划任务 \\${WINDOWS_AUTOSTART_TASK_NAME},但其启动命令不属于 EvolCore;为避免覆盖已停止配置。`,
570
571
  };
571
572
  }
@@ -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` `--raw` `--no-color`) | 日志/查看日志 |
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/<自己的 AID>/pa-workspace-state.json
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
- | `pa-workspace-state.json` | 磁盘上的完整状态:绑定信息(`workspaceId`/`ownerAid`/`rootPath`)+ `navigationRevision` + `entries` |
23
- | `file-navigation.json` | **导航内容本身**,即 `{version, entries}` 这部分。协议与设计文档里的叫法 |
24
- | `--entries-json` | 命令参数,取值就是 `file-navigation.json` 的 `entries` 数组 |
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
- | `id` | 由 `path` 自动生成 `pa-<sha256前16位>` | 重复 ID → `INVALID_ARGUMENT` |
133
- | `title` | 回落 `path` 最后一段 | 超 200 字符 → `INVALID_ARGUMENT` |
134
- | `path` | **不可省略** | 绝对路径/冒号/`..`/隐藏段 → `INVALID_ROOT_PATH` |
135
- | `kind` | **不可省略** | 与真实目标不一致 → `INVALID_ARGUMENT` |
136
- | `order` | 回落数组下标 | 非 `0..1000000` 整数 → `INVALID_ARGUMENT` |
137
- | `icon` | 无图标 | 超 100 字符截断,不报错 |
138
- | `availability` | `available` | 非法值 → `INVALID_ARGUMENT` |
139
- | `reason` | — | `unavailable` 却没给 → `INVALID_ARGUMENT` |
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
- - `entries` 最多 200 项。
144
- - `id` 不能重复,`path` 也不能重复,两者分别查重。
145
- - 排序是 `order` 升序 → `title` 本地化字典序 → `path` 字典序,不只是 `order`。
146
- - 目标不存在时,必须显式 `availability: "unavailable"` + `reason`,否则返回 `NOT_FOUND`。
147
- - `path` 的反斜杠会被**替换**成 `/` 并归一化,不是报错;但归一化后不能命中隐藏路径。
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
- - `--entries-json` 必须是**完整数组**。要保留的入口必须一并传回,否则等于删除。
173
- - `--expected-revision` 是数值并发校验。revision 已变则返回 `CONFLICT`:
174
- 重新 `show`、合并用户仍要保留的入口、再提交。**不要**覆盖并发修改。
175
- - 成功后 `navigationRevision` 加 1,返回新状态。
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
- | "加一个旅行计划入口" | 确认 `output/travel/` 存在(不存在则先建,或标 `unavailable`)→ 追加 entry → update |
196
- | "把报告放到最前面" | 把该 entry 的 `order` 调成比其他都小 → update |
197
- | "把'报告'改名叫'周报'" | 只改 `title`,**保留原 `id` 和 `path`** → update |
202
+ | "加一个旅行计划入口" | 确认 output/travel/ 存在(不存在则先建,或标 unavailable)→ 追加 entry → update |
203
+ | "把报告放到最前面" | 把该 entry 的 order 调成比其他都小 → update |
204
+ | "把'报告'改名叫'周报'" | 只改 title,保留原 id 和 path → update |
198
205
  | "把 X 入口藏起来" | 从数组移除 X → update |
199
- | "让 B 助理那边也显示我的报告" | 在 **B** 的工作区执行 update,指到 B 自己可见的路径 |
200
- | "把我另一个助理的周报放进来看" | **当前版本不支持**,见 §6 |
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
- - 不要把这份数据叫 `manifest` —— 会和 EvolCore 已有的 manifest 体系混淆。
229
- - 不要把主机绝对路径、IP、端口写进导航。
230
- - 不要在导航里放短期凭证。凭证由 Core 在读取时另行签发。
231
- - 不要指望 App 按入口 ID 写死专用页面。`id` 只用于稳定关联,不影响能否打开。
232
- - 不要修改 `pa-workspace-state.json` 的 `workspaceId`、`ownerAid`、`rootPath`。
233
- 改绑定用 `ec pa-workspace bind --workspace "<新路径>"`。
234
- - 本命令只在当前 Agent 与其 Owner 的 AUN 私聊托管会话中可用。
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
- - `ec pa-workspace init` / `bind`:初始化与更换工作区,见本目录 `pa-workspace.md`
254
- - 文件读取协议:`menu-protocol.md` 的 file 段
255
- - 工作区目录规范:`personal-assistant` Skill
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
- | `docs/personal-assistant/workspace-browser-v1/schema.json` | `evol.pa-workspace` 导航**响应**的正式 JSON Schema(与本文的写入格式不同) |
265
- | `docs/personal-assistant/13-cross-agent-artifact-navigation.md` | 跨 Agent 入口的设计、双端实施清单、权限边界 |
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 | 由参数表解析窗口,设置 SDK 自动压缩阈值;查询与手动压缩使用同一解析路径 |
72
- | ecagent | 由参数表设置模型对象的 `contextWindow` 和输出上限 `maxTokens`;查询、手动压缩和上下文统计共用参数 |
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 cancel`**:cancel 只是 disable,
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>`(旧名 `find` / `show` 同) | 需要符合当前 Agent/同 Owner 的目标范围 | 可进入授权执行路径 | 不能仅凭 DaemonOwner 身份推导出该 Agent 的 Owner 关系 |
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` 仅支持 `--exec trigger-session`,用于给该 trigger 会话单独选择 base agent;
249
- `script` 和 `target-session` 不接受该参数。未设置时沿用 trigger 所属 agent 当前 active baseagent。
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 <triggerId> # disable 的兼容别名
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` / `cancel` | 保留,写 `enabled: false` | 清理 | 不中断 | 可 `enable` |
287
+ | `disable` | 保留,写 `enabled: false` | 清理 | 不中断 | 可 `enable` |
288
+ | `cancel` | 保留定义,写入中断审计 | 不影响其它调度 | 中止指定活动 run | 不可恢复该 run |
286
289
  | `delete` | 删除整个 trigger 运行态目录,保留 history tombstone | 清理 | 不中断 | 定义不可恢复,审计可复查 |
287
290
 
288
- `delete` 不需要先执行 `disable/cancel`;它内部会先清理 timer/event/schedule,再删除定义。
291
+ `delete` 不需要先执行 `disable`;它内部会先清理 timer/event/schedule,再删除定义。
289
292
 
290
- > **用完即弃的 Trigger(如跨话题复查)结束时应使用 `delete` 而不是 `cancel`**:`cancel` 只写
293
+ > **用完即弃的 Trigger(如跨话题复查)结束时应使用 `delete` 而不是 `disable`**:`disable` 只写
291
294
  > `enabled: false`,定义会一直留在 `$EVOLCORE_HOME/agents/<aid>/triggers/` 下,长期积累成
292
295
  > 大量永不触发的死定义。
293
296
 
@@ -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",