evolcore 0.0.43-test.1 → 0.0.43-test.3

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 (200) hide show
  1. package/CHANGELOG.md +31 -1
  2. package/README.md +22 -0
  3. package/dist/agents/claude-runner.js +26 -2
  4. package/dist/agents/codex/app-server-client.js +12 -0
  5. package/dist/agents/codex-runner.js +49 -8
  6. package/dist/agents/ecagent-runner.js +39 -15
  7. package/dist/agents/gemini-runner.js +15 -12
  8. package/dist/agents/tool-time-context.js +55 -0
  9. package/dist/aun/aid/agentmd.js +21 -1
  10. package/dist/aun/menu/client.js +1 -1
  11. package/dist/aun/model-headers.js +17 -0
  12. package/dist/aun/msg/p2p.js +7 -2
  13. package/dist/channels/aun.js +522 -50
  14. package/dist/channels/builtin-plugins.js +16 -11
  15. package/dist/channels/daemon.js +4 -0
  16. package/dist/channels/dingtalk.js +83 -31
  17. package/dist/channels/feishu.js +29 -13
  18. package/dist/channels/qqbot.js +32 -11
  19. package/dist/channels/wechat.js +13 -3
  20. package/dist/channels/wecom.js +67 -27
  21. package/dist/cli/agent-command.js +3 -86
  22. package/dist/cli/agent-create.js +20 -6
  23. package/dist/cli/agent.js +1 -79
  24. package/dist/cli/aun-commands.js +18 -19
  25. package/dist/cli/config.js +1 -1
  26. package/dist/cli/daemon-commands.js +47 -2
  27. package/dist/cli/data-command.js +9 -1
  28. package/dist/cli/debug-mode.js +1 -1
  29. package/dist/cli/diag.js +1 -1
  30. package/dist/cli/directory.js +149 -91
  31. package/dist/cli/getmeta-command.js +1 -1
  32. package/dist/cli/index.js +79 -22
  33. package/dist/cli/init.js +1 -23
  34. package/dist/cli/link-rules.js +1 -1
  35. package/dist/cli/managed-command-guard.js +0 -1
  36. package/dist/cli/pa-workspace-command.js +36 -2
  37. package/dist/cli/peer.js +3 -2
  38. package/dist/cli/restart-monitor.js +17 -3
  39. package/dist/cli/role.js +1 -1
  40. package/dist/cli/session-command.js +1 -1
  41. package/dist/cli/stats.js +2 -2
  42. package/dist/cli/task-context.js +3 -1
  43. package/dist/cli/thread-command.js +1 -1
  44. package/dist/cli/watch-msg.js +1 -1
  45. package/dist/config/builtin-role-templates.js +2 -2
  46. package/dist/config/builtin-roles.js +2 -1
  47. package/dist/config/config-field-policy.js +7 -2
  48. package/dist/config/config-manager.js +32 -10
  49. package/dist/config/peer-role-resolver.js +23 -1
  50. package/dist/config/role-schema.js +29 -4
  51. package/dist/config/role-service.js +12 -7
  52. package/dist/config/role-store.js +30 -8
  53. package/dist/config-store.js +75 -4
  54. package/dist/core/agent-ipc-registration.js +16 -59
  55. package/dist/core/auth/auth-gateway.js +14 -4
  56. package/dist/core/auth/authorization-audit.js +52 -14
  57. package/dist/core/auth/operation-authorizer.js +17 -11
  58. package/dist/core/auth/operation-catalog.js +5 -13
  59. package/dist/core/channel-loader.js +152 -16
  60. package/dist/core/channel-runtime.js +5 -0
  61. package/dist/core/command/agent-control.js +2 -1
  62. package/dist/core/command/agentmd-menu-request.js +50 -0
  63. package/dist/core/command/agentmd-menu.js +156 -0
  64. package/dist/core/command/cli-intent-parser.js +0 -8
  65. package/dist/core/command/command-handler.js +47 -40
  66. package/dist/core/command/connect-menu.js +7 -3
  67. package/dist/core/command/menu-catalog.js +16 -2
  68. package/dist/core/command/menu-handler.js +107 -14
  69. package/dist/core/command/menu-protocol.js +28 -0
  70. package/dist/core/command/role-menu.js +23 -9
  71. package/dist/core/command/slash-handler.js +139 -51
  72. package/dist/core/daemon-file-cache.js +3 -3
  73. package/dist/core/daemon-lifecycle.js +9 -1
  74. package/dist/core/evolagent-registry.js +5 -4
  75. package/dist/core/evolagent.js +10 -12
  76. package/dist/core/handoff/argv-parse.js +115 -0
  77. package/dist/core/handoff/ipc-registration.js +1 -1
  78. package/dist/core/ipc-registration.js +19 -2
  79. package/dist/core/lifecycle-notice.js +185 -0
  80. package/dist/core/memory/consolidation.js +8 -1
  81. package/dist/core/memory/relation-sweep.js +20 -8
  82. package/dist/core/message/aun-ipc-sender.js +35 -2
  83. package/dist/core/message/contact-admission.js +530 -0
  84. package/dist/core/message/im-renderer.js +111 -16
  85. package/dist/core/message/message-admission.js +29 -54
  86. package/dist/core/message/message-bridge.js +62 -8
  87. package/dist/core/message/message-utils.js +9 -5
  88. package/dist/core/message/peer-mode.js +55 -13
  89. package/dist/core/message/response-engine.js +298 -78
  90. package/dist/core/message/retry-scheduler.js +4 -0
  91. package/dist/core/ownership/owner-resolver.js +72 -34
  92. package/dist/core/permission/ec-command-parser.js +25 -38
  93. package/dist/core/permission/readonly-shell-query.js +34 -8
  94. package/dist/core/permission/tool-policy.js +50 -5
  95. package/dist/core/relation/pa-team.js +127 -0
  96. package/dist/core/role/runtime-policy.js +18 -5
  97. package/dist/core/session/session-manager.js +9 -1
  98. package/dist/core/soul.js +66 -0
  99. package/dist/core/system-session/memory.js +2 -2
  100. package/dist/core/thread/thread-service.js +6 -4
  101. package/dist/directory/contact-admission-paths.js +9 -0
  102. package/dist/directory/owner-directory-admission.js +125 -29
  103. package/dist/directory/owner-directory-cache.js +554 -58
  104. package/dist/directory/owner-directory-identity.js +60 -0
  105. package/dist/directory/owner-directory-markdown.js +154 -58
  106. package/dist/directory/owner-directory-policy.js +108 -0
  107. package/dist/directory/owner-directory-query-operation.js +399 -90
  108. package/dist/directory/owner-directory-remarks.js +29 -2
  109. package/dist/directory/owner-directory-request-operation.js +76 -0
  110. package/dist/directory/owner-directory-scope.js +35 -4
  111. package/dist/directory/owner-directory-search.js +118 -33
  112. package/dist/directory/owner-directory-store.js +117 -30
  113. package/dist/directory/owner-directory-text.js +60 -0
  114. package/dist/eck/kit-renderer.js +18 -8
  115. package/dist/eck/manifest-engine.js +55 -6
  116. package/dist/ecweb/basic-settings-service.js +2 -2
  117. package/dist/ecweb/message-context-service.js +28 -16
  118. package/dist/index.js +20 -5
  119. package/dist/ipc.js +1 -1
  120. package/dist/paths.js +29 -1
  121. package/dist/product.js +1 -0
  122. package/dist/response-system/config-resolver.js +1 -1
  123. package/dist/response-system/engines/v1/index.js +2 -1
  124. package/dist/response-system/modes/single-session/index.js +7 -2
  125. package/dist/trigger/scheduler.js +7 -4
  126. package/dist/trigger/validation.js +4 -0
  127. package/dist/utils/error-utils.js +12 -7
  128. package/dist/utils/logger.js +13 -4
  129. package/dist/utils/npm-ops.js +2 -2
  130. package/dist/utils/windows-autostart.js +1 -1
  131. package/ecagent/README.md +18 -0
  132. package/ecagent/dist/agent-loop.js +43 -1
  133. package/ecagent/dist/harness/agent-harness.d.ts +2 -0
  134. package/ecagent/dist/harness/agent-harness.js +24 -8
  135. package/ecagent/dist/harness/compaction/compaction.js +3 -0
  136. package/ecagent/dist/harness/types.d.ts +1 -0
  137. package/kits/docs/INDEX.md +1 -0
  138. package/kits/docs/channels/aun.md +1 -1
  139. package/kits/docs/context-assembly.md +21 -6
  140. package/kits/docs/eck_templates/INDEX.template.md +1 -2
  141. package/kits/docs/evolcore/INDEX.md +4 -1
  142. package/kits/docs/evolcore/agent-create.md +5 -5
  143. package/kits/docs/evolcore/agent.md +4 -9
  144. package/kits/docs/evolcore/directory.md +227 -0
  145. package/kits/docs/evolcore/ecweb-lifecycle.md +26 -0
  146. package/kits/docs/evolcore/file-navigation.md +265 -0
  147. package/kits/docs/evolcore/menu-protocol.md +55 -0
  148. package/kits/docs/evolcore/msg.md +1 -0
  149. package/kits/docs/evolcore/peer.md +2 -1
  150. package/kits/docs/evolcore/response.md +7 -1
  151. package/kits/docs/evolcore/task.md +2 -0
  152. package/kits/docs/evolcore/tool-authorization.md +1 -1
  153. package/kits/docs/evolcore/trigger.md +4 -0
  154. package/kits/docs/identity/ROLE_DETAIL.md +2 -0
  155. package/kits/docs/prompt-loading-architecture.md +6 -2
  156. package/kits/eck_manifest.auxiliary.json +1 -0
  157. package/kits/eck_manifest.json +64 -7
  158. package/kits/eck_manifest.memory.json +93 -4
  159. package/kits/rules/01-overview.md +2 -2
  160. package/kits/rules/03-identity.md +10 -9
  161. package/kits/rules/05-venue.md +2 -4
  162. package/kits/rules/06-channel.md +1 -1
  163. package/kits/schemas/_meta.json +44 -3
  164. package/kits/schemas/agent-config.schema.18.json +5 -0
  165. package/kits/schemas/agent-config.schema.19.json +924 -0
  166. package/kits/schemas/agent-config.schema.20.json +925 -0
  167. package/kits/schemas/relation-config.schema.12.json +289 -0
  168. package/kits/schemas/relation-config.schema.13.json +289 -0
  169. package/kits/schemas/role-config.schema.2.json +215 -0
  170. package/kits/schemas/role-config.schema.3.json +1038 -0
  171. package/kits/schemas/role-registry.schema.1.json +3 -2
  172. package/kits/skills/ec-skill/scripts/cli.mjs +3 -2
  173. package/kits/skills/ec-trigger/SKILL.md +4 -4
  174. package/kits/skills/personal-assistant/SKILL.md +109 -53
  175. package/kits/skills/personal-assistant/references/02-bootstrap.md +73 -30
  176. package/kits/skills/personal-assistant/scripts/clean.mjs +35 -18
  177. package/kits/skills/personal-assistant/scripts/init.mjs +41 -2
  178. package/kits/skills/personal-assistant/scripts/lib/persona.mjs +185 -0
  179. package/kits/skills/personal-assistant/scripts/migrate.mjs +55 -4
  180. package/kits/skills/personal-assistant/scripts/pa.mjs +173 -0
  181. package/kits/skills/personal-assistant/scripts/uninstall.mjs +130 -0
  182. package/kits/skills/personal-assistant/templates/persona-section.md +3 -3
  183. package/kits/templates/message-fragments/handoff-request-to-target.md +1 -1
  184. package/kits/templates/soul/00-GUIDE.md +39 -0
  185. package/kits/templates/soul/01-identity.md +5 -0
  186. package/kits/templates/soul/02-persona.md +11 -0
  187. package/kits/templates/soul/03-duties.md +5 -0
  188. package/kits/templates/soul/04-working-style.md +5 -0
  189. package/kits/templates/system-fragments/bootstrap.md +7 -7
  190. package/kits/templates/system-fragments/channel.md +2 -2
  191. package/kits/templates/system-fragments/commands.md +3 -2
  192. package/kits/templates/system-fragments/directory-contacts.md +9 -0
  193. package/kits/templates/system-fragments/memory.md +1 -1
  194. package/kits/templates/system-fragments/personal-assistant.md +50 -0
  195. package/kits/templates/system-fragments/reply.md +7 -0
  196. package/kits/templates/system-fragments/session.md +6 -2
  197. package/package.json +3 -2
  198. package/dist/cli/handoff-command.js +0 -353
  199. package/dist/directory/owner-directory-remark-operation.js +0 -147
  200. package/kits/docs/evolcore/self-summary.md +0 -29
@@ -234,7 +234,7 @@ export async function requireOptional(pkg, autoInstall = true) {
234
234
  if (e.code !== 'ERR_MODULE_NOT_FOUND' && e.code !== 'MODULE_NOT_FOUND')
235
235
  throw e;
236
236
  if (!autoInstall)
237
- throw new Error(`依赖 ${pkg} 未安装。请运行: npm install -g ${pkg}`);
237
+ throw Object.assign(new Error(`依赖 ${pkg} 未安装。请运行: npm install ${pkg}`, { cause: e }), { code: e.code });
238
238
  const { logger } = await import('./logger.js');
239
239
  logger.info(`正在安装可选依赖 ${pkg}...`);
240
240
  await npmInstallGlobal(pkg);
@@ -426,7 +426,7 @@ export async function preparePackageCache(target, registry, options = {}) {
426
426
  // and is reused when npm can do so.
427
427
  await run(['cache', 'add', spec, '--prefer-online']);
428
428
  options.onPhase?.('tarball-check');
429
- const metadata = JSON.parse(await run(['view', spec, 'name', 'version', 'dist', '--json', '--offline']));
429
+ const metadata = JSON.parse(await run(['view', spec, 'name', 'version', 'dist', '--json', '--prefer-online']));
430
430
  const [packed] = JSON.parse(await run(['pack', spec, '--dry-run', '--json', '--offline']));
431
431
  if (metadata?.name !== MAIN_PACKAGE_NAME || metadata.version !== target || packed?.name !== MAIN_PACKAGE_NAME || packed.version !== target
432
432
  || !(typeof metadata.dist?.integrity === 'string' ? packed.integrity === metadata.dist.integrity
@@ -713,7 +713,7 @@ export function configureWindowsAutostart(enabled, runtimeRoot) {
713
713
  return {
714
714
  ...fallback,
715
715
  warning: isAccessDenied(result)
716
- ? '任务计划程序拒绝访问,已回退到当前用户 HKCU Run 自启动(无需管理员权限)。如需改用计划任务,请以管理员身份再次运行 ec init --auto-start。'
716
+ ? '当前终端非管理员身份运行,任务计划未能添加,改为当前用户 HKCU Run 自启动(非管理员权限)。如需改用计划任务,请以管理员身份再次运行 ec init --auto-start。'
717
717
  : `任务计划程序创建失败:${commandError(result, '找不到指定的文件或路径')};已回退到当前用户 HKCU Run 自启动(无需管理员权限)。`,
718
718
  };
719
719
  }
package/ecagent/README.md CHANGED
@@ -60,6 +60,24 @@ pending, interruption terminates all processes in its job. Long-running managed
60
60
  services should use EvolCore's service manager rather than rely on an open Bash
61
61
  tool call. The supervisor fails closed if job assignment is unavailable.
62
62
 
63
+ ## Automatic context compaction
64
+
65
+ `AgentHarness` accepts an optional `autoCompactWindow` token threshold. When set
66
+ to a positive number, the harness checks context usage before each model request,
67
+ including requests between tool batches. It summarizes older history, persists a
68
+ compaction entry, and rebuilds the context without restarting the task or replaying
69
+ tools. The public `compact()` method still requires an idle harness.
70
+
71
+ The threshold is opt-in for standalone callers. EvolCore supplies the same
72
+ window-aware threshold used by its Claude adapter: the smaller of 650,000 tokens
73
+ and the model window minus a reserve of up to 10,000 tokens (5% for smaller
74
+ windows). EvolCore's task-start check and context-overflow recovery remain in place.
75
+
76
+ Automatic summaries inherit the active run's cancellation signal. Context estimates
77
+ ignore usage recorded before the latest compaction; retained recent messages are
78
+ estimated until a new provider response reports usage for the compacted context.
79
+ This is threshold-based summarization, not continuous history pruning.
80
+
63
81
  ## Build from source
64
82
 
65
83
  ```bash
@@ -68,6 +68,26 @@ export async function runAgentLoopContinue(context, config, emit, signal, stream
68
68
  await runLoop(currentContext, newMessages, config, signal, emit, streamFn);
69
69
  return newMessages;
70
70
  }
71
+ async function emitAbortedResponse(context, config, signal, emit) {
72
+ const message = {
73
+ role: "assistant",
74
+ content: [],
75
+ api: config.model.api,
76
+ provider: config.model.provider,
77
+ model: config.model.id,
78
+ stopReason: "aborted",
79
+ errorMessage: signal?.reason instanceof Error ? signal.reason.message : String(signal?.reason ?? "Operation aborted"),
80
+ timestamp: Date.now(),
81
+ usage: {
82
+ input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0,
83
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
84
+ },
85
+ };
86
+ context.messages.push(message);
87
+ await emit({ type: "message_start", message });
88
+ await emit({ type: "message_end", message });
89
+ return message;
90
+ }
71
91
  function createAgentStream() {
72
92
  return new EventStream((event) => event.type === "agent_end", (event) => (event.type === "agent_end" ? event.messages : []));
73
93
  }
@@ -78,13 +98,23 @@ async function runLoop(initialContext, newMessages, initialConfig, signal, emit,
78
98
  let currentContext = initialContext;
79
99
  let config = initialConfig;
80
100
  let firstTurn = true;
101
+ const finishAbortedRun = async () => {
102
+ const message = await emitAbortedResponse(currentContext, config, signal, emit);
103
+ newMessages.push(message);
104
+ await emit({ type: "turn_end", message, toolResults: [] });
105
+ await emit({ type: "agent_end", messages: newMessages });
106
+ };
81
107
  // Check for steering messages at start (user may have typed while waiting)
82
- let pendingMessages = (await config.getSteeringMessages?.()) || [];
108
+ let pendingMessages = signal?.aborted ? [] : (await config.getSteeringMessages?.()) || [];
83
109
  // Outer loop: continues when queued follow-up messages arrive after agent would stop
84
110
  while (true) {
85
111
  let hasMoreToolCalls = true;
86
112
  // Inner loop: process tool calls and steering messages
87
113
  while (hasMoreToolCalls || pendingMessages.length > 0) {
114
+ if (signal?.aborted) {
115
+ await finishAbortedRun();
116
+ return;
117
+ }
88
118
  if (!firstTurn) {
89
119
  await emit({ type: "turn_start" });
90
120
  }
@@ -128,6 +158,10 @@ async function runLoop(initialContext, newMessages, initialConfig, signal, emit,
128
158
  }
129
159
  }
130
160
  await emit({ type: "turn_end", message, toolResults });
161
+ if (signal?.aborted) {
162
+ await finishAbortedRun();
163
+ return;
164
+ }
131
165
  const nextTurnContext = {
132
166
  message,
133
167
  toolResults,
@@ -147,6 +181,10 @@ async function runLoop(initialContext, newMessages, initialConfig, signal, emit,
147
181
  : nextTurnSnapshot.thinkingLevel,
148
182
  };
149
183
  }
184
+ if (signal?.aborted) {
185
+ await finishAbortedRun();
186
+ return;
187
+ }
150
188
  if (await config.shouldStopAfterTurn?.({
151
189
  message,
152
190
  toolResults,
@@ -175,6 +213,8 @@ async function runLoop(initialContext, newMessages, initialConfig, signal, emit,
175
213
  * This is where AgentMessage[] gets transformed to Message[] for the LLM.
176
214
  */
177
215
  async function streamAssistantResponse(context, config, signal, emit, streamFn) {
216
+ if (signal?.aborted)
217
+ return emitAbortedResponse(context, config, signal, emit);
178
218
  // Apply context transform if configured (AgentMessage[] → AgentMessage[])
179
219
  let messages = context.messages;
180
220
  if (config.transformContext) {
@@ -191,6 +231,8 @@ async function streamAssistantResponse(context, config, signal, emit, streamFn)
191
231
  const streamFunction = streamFn || streamSimple;
192
232
  // Resolve API key (important for expiring tokens)
193
233
  const resolvedApiKey = (config.getApiKey ? await config.getApiKey(config.model.provider) : undefined) || config.apiKey;
234
+ if (signal?.aborted)
235
+ return emitAbortedResponse(context, config, signal, emit);
194
236
  const response = await streamFunction(config.model, llmContext, {
195
237
  ...config,
196
238
  apiKey: resolvedApiKey,
@@ -13,6 +13,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
13
13
  private thinkingLevel;
14
14
  private systemPrompt;
15
15
  private streamOptions;
16
+ private readonly autoCompactWindow?;
16
17
  private resources;
17
18
  private tools;
18
19
  private activeToolNames;
@@ -63,6 +64,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
63
64
  tokensBefore: number;
64
65
  details?: unknown;
65
66
  }>;
67
+ private performCompaction;
66
68
  navigateTree(targetId: string, options?: {
67
69
  summarize?: boolean;
68
70
  customInstructions?: string;
@@ -1,6 +1,6 @@
1
1
  import { runAgentLoop } from "../agent-loop.js";
2
2
  import { collectEntriesForBranchSummary, generateBranchSummary } from "./compaction/branch-summarization.js";
3
- import { compact, DEFAULT_COMPACTION_SETTINGS, prepareCompaction } from "./compaction/compaction.js";
3
+ import { compact, DEFAULT_COMPACTION_SETTINGS, estimateContextTokens, prepareCompaction } from "./compaction/compaction.js";
4
4
  import { convertToLlm } from "./messages.js";
5
5
  import { formatPromptTemplateInvocation } from "./prompt-templates.js";
6
6
  import { formatSkillInvocation } from "./skills.js";
@@ -124,6 +124,7 @@ export class AgentHarness {
124
124
  this.models = options.models;
125
125
  this.resources = options.resources ?? {};
126
126
  this.streamOptions = cloneStreamOptions(options.streamOptions);
127
+ this.autoCompactWindow = options.autoCompactWindow;
127
128
  this.systemPrompt = options.systemPrompt;
128
129
  this.validateUniqueNames((options.tools ?? []).map((tool) => tool.name), "Duplicate tool name(s)");
129
130
  for (const tool of options.tools ?? []) {
@@ -325,9 +326,18 @@ export class AgentHarness {
325
326
  model: turnState.model,
326
327
  reasoning: turnState.thinkingLevel === "off" ? undefined : turnState.thinkingLevel,
327
328
  convertToLlm,
328
- transformContext: async (messages) => {
329
- const result = await this.emitHook({ type: "context", messages: [...messages] });
330
- return result?.messages ?? messages;
329
+ transformContext: async (messages, signal) => {
330
+ let currentMessages = messages;
331
+ signal?.throwIfAborted();
332
+ if (this.autoCompactWindow && this.autoCompactWindow > 0
333
+ && estimateContextTokens(messages).tokens >= this.autoCompactWindow) {
334
+ await this.flushPendingSessionWrites();
335
+ await this.performCompaction(undefined, signal);
336
+ signal?.throwIfAborted();
337
+ currentMessages = (await this.session.buildContext()).messages;
338
+ }
339
+ const result = await this.emitHook({ type: "context", messages: [...currentMessages] }, signal);
340
+ return result?.messages ?? currentMessages;
331
341
  },
332
342
  beforeToolCall: async ({ toolCall, args }, signal) => {
333
343
  const result = await this.emitHook({
@@ -614,8 +624,13 @@ export class AgentHarness {
614
624
  async compact(customInstructions) {
615
625
  if (this.phase !== "idle")
616
626
  throw new AgentHarnessError("busy", "compact() requires idle harness");
627
+ return this.performCompaction(customInstructions);
628
+ }
629
+ async performCompaction(customInstructions, signal) {
630
+ const previousPhase = this.phase;
617
631
  this.phase = "compaction";
618
632
  try {
633
+ signal?.throwIfAborted();
619
634
  const model = this.model;
620
635
  if (!model)
621
636
  throw new AgentHarnessError("invalid_state", "No model set for compaction");
@@ -631,16 +646,17 @@ export class AgentHarness {
631
646
  preparation,
632
647
  branchEntries,
633
648
  customInstructions,
634
- signal: new AbortController().signal,
635
- });
649
+ signal: signal ?? new AbortController().signal,
650
+ }, signal);
636
651
  if (hookResult?.cancel)
637
652
  throw new AgentHarnessError("compaction", "Compaction cancelled");
638
653
  const provided = hookResult?.compaction;
639
654
  const compactResult = provided
640
655
  ? { ok: true, value: provided }
641
- : await compact(preparation, this.models, model, customInstructions, undefined, this.thinkingLevel);
656
+ : await compact(preparation, this.models, model, customInstructions, signal, this.thinkingLevel);
642
657
  if (!compactResult.ok)
643
658
  throw compactResult.error;
659
+ signal?.throwIfAborted();
644
660
  const result = compactResult.value;
645
661
  const entryId = await this.session.appendCompaction(result.summary, result.firstKeptEntryId, result.tokensBefore, result.details, provided !== undefined);
646
662
  const entry = await this.session.getEntry(entryId);
@@ -653,7 +669,7 @@ export class AgentHarness {
653
669
  throw normalizeHarnessError(error, "compaction");
654
670
  }
655
671
  finally {
656
- this.phase = "idle";
672
+ this.phase = previousPhase;
657
673
  }
658
674
  }
659
675
  async navigateTree(targetId, options) {
@@ -87,7 +87,10 @@ export function getLastAssistantUsage(entries) {
87
87
  return undefined;
88
88
  }
89
89
  function getLastAssistantUsageInfo(messages) {
90
+ const summary = messages.find((message) => message.role === "compactionSummary");
90
91
  for (let i = messages.length - 1; i >= 0; i--) {
92
+ if (summary && messages[i].timestamp <= summary.timestamp)
93
+ continue;
91
94
  const usage = getAssistantUsage(messages[i]);
92
95
  if (usage)
93
96
  return { usage, index: i };
@@ -610,6 +610,7 @@ export interface AgentHarnessOptions<TSkill extends Skill = Skill, TPromptTempla
610
610
  }) => string | Promise<string>);
611
611
  /** Curated stream/provider request options. Snapshotted at turn start. */
612
612
  streamOptions?: AgentHarnessStreamOptions;
613
+ autoCompactWindow?: number;
613
614
  model: Model<any>;
614
615
  thinkingLevel?: ThinkingLevel;
615
616
  activeToolNames?: string[];
@@ -32,6 +32,7 @@ EvolCore 能力插件体系的实施设计位于源码仓库 `$PACKAGE_ROOT/docs
32
32
  | 命令集目录 | `evolcore/INDEX.md` | msg/group/agent/aid/storage/ctl/rpc/bench 全集索引 |
33
33
  | Provider 注册表 | `evolcore/provider.md` | 宿主进程级 Provider CRUD、JSON 导入及 CLI/Menu 边界 |
34
34
  | 对端命令 | `evolcore/peer.md` | 对端身份表、拉黑与托管会话权限边界 |
35
+ | Owner 名录命令 | `evolcore/directory.md` | 名录查询、强制刷新、拉黑总览与本地备注(仅 PA 可写) |
35
36
  | Agent 生命周期与 Bootstrap | `evolcore/agent-create.md` | 生命周期与新 Agent 首次设定参考;创建者操作已迁移到 `ec-agent-create` 技能 |
36
37
  | 群聊协作入口 | `evolcore/group-collaboration.md` | 旧文档入口;完整任务流程已迁移到 `ec-group-collaboration` 技能 |
37
38
 
@@ -57,7 +57,7 @@ AUN keystore seed 由 EvolCore 使用固定应用值管理,不再提供配置
57
57
  - **身份与信任**:每条入站消息携带发送者 AID,经四级 X.509 证书链(Root CA → Registry CA → Issuer CA → Agent)验签。
58
58
  - **agent.md 缓存**:对端名片 `https://<aid>/agent.md` 由 **AUN SDK 自动拉取并缓存**(`AgentMdManager`,带 ETag/TTL,默认 1 天内不重复探测)。缓存落在 **`$EVOLCORE_HOME/AIDs/<aid>/`**,每个 AID 两个文件:`agent.md`(带签名正文)+ `agentmd.json`(元数据:etag/last_modified/checked_at/verify_status)。本端与对端的 agent.md 都缓存于此。
59
59
  - 关系层另存一份**派生**的精简身份 `relations/<peerKey>/peer-identity.json`(type/isAgent/name),由 evolcore 从 agent.md 提取,不是 agent.md 本体。
60
- - **E2EE 加密**:可选端到端加密,回复默认跟随对端消息加密状态(密文回密文,明文回明文);keystore seed 由 EvolCore 固定管理。
60
+ - **E2EE 加密**:可选端到端加密,回复默认跟随对端消息加密状态(密文回密文,明文回明文);主动发起默认明文,只有显式 `--encrypt` 或 `aun.defaultEncrypt: true` 才加密;keystore seed 由 EvolCore 固定管理。
61
61
  - **断线重连**:SDK 内置退避策略自动重连。实时连接状态用 `ec watch aid` 查看(`ec aid` 是身份/证书管理,不显示连接状态)。
62
62
  - **群 ID 格式**:使用 `{base}.{issuer}`,如 `ontology.agentid.cn` 或 `g-12345.agentid.cn`。EvolCore 默认创建 `g-` 加五位数字(10000–99999)的名称,issuer 以群服务返回为准。群命令支持 base 简写;不再支持或转换 `group.{issuer}/{base}`,也不支持 `base@issuer`。`g-` 是名称的一部分,不应剥离,也不能仅凭群 AID 的格式判断主体类型。
63
63
  - **群 @ 处理策略**:`mention_mode=disabled|mention-only` 是群级配置,只决定哪些群消息进入 Agent LLM 上下文,不影响 AUN 协议层投递;被过滤消息仍应本地存档。
@@ -49,6 +49,8 @@ evolcore 收到消息 → 构造一份 **vars**(运行时变量,见下)→
49
49
  渲染时按 `session.sessionType`(缺省 `'main'`)依次查:`sessionManifests` 覆盖 → 内置映射 → `eck_manifest.json`(`resolveSessionManifest`)。bootstrapping 阶段固定用 `eck_manifest.json`。
50
50
  **每个 manifest 文件各自两级合并**(`$KITS/<file>` + `$ECK/<file>`),互不干扰。
51
51
 
52
+ `chatMode=paactive` 是私聊文本展示分支,不是新的 `sessionType` 或独立上下文体系。active AUN 人类 Owner 私聊(含话题)继续使用按现有生命周期、sessionType 和 `sessionManifests` 选择的 system/message manifest,并复用基础 vars;`chatMode` 保持 `paactive`。派生变量 `activePush=true` 表示正式回复使用托管发送,供共用模板复用发送说明。Proactive 工具门禁变量仅在 proactive 任务注入。群聊固定 proactive;interactive 和 paactive 仅适用于私聊。
53
+
52
54
  ## section 字段
53
55
 
54
56
  manifest 是 `{ "$schema_version": 1, "sections": [...] }`。每个 section:
@@ -126,10 +128,18 @@ manifest 是 `{ "$schema_version": 1, "sections": [...] }`。每个 section:
126
128
 
127
129
  ## 目录加载限额(安全保护)
128
130
 
129
- `type: directory` 段加载整个目录,若目录内容失控会撑爆提示词。两层限额保护:
131
+ `type: directory` 段加载整个目录,若目录内容失控会撑爆提示词。四层限额保护:
130
132
 
131
133
  - **单目录限额**(`maxFiles` 20 / `maxBytes` 40KB):单个目录段最多加载多少。超出时停止加载该目录后续文件,并在该段末尾注入一行截断说明:
132
134
  `[注意] 目录 $KITS_RULES 未完整加载:N 个文件未加载(达文件数上限 20 个)。`
135
+ - **骨架豁免**(`skipUnchangedTemplate` + `unchangedTemplateKeep`,仅 soul 段启用):
136
+ 内容仍等于 `kits/templates/<dir>/<同名文件>` 的分册视为「还没写」,不加载;
137
+ `unchangedTemplateKeep` 里的文件名(如 `00-GUIDE.md`)即使未改动也照常加载,因为模板本身就是内容。
138
+ - **单文件限额**(`maxFileBytes` 8192 = 8KB):单个文件超过上限时**截断**(不丢弃),
139
+ 在该文件内容末尾追加一行 `[注意] 本文件超过单文件上限 8KB,已截断(原 37KB)。`,
140
+ 其余文件照常加载。
141
+ 这条是为了堵住「至少保留 1 个文件」的漏洞:没有单文件上限时,一个超大文件会独占本段额度,
142
+ 甚至吃掉全局总闸,把后面所有段挤掉。截断只损失一个文件末尾,不影响其它段。
133
143
  - **总闸限额**(`totalMaxFiles` 50 / `totalMaxBytes` 100KB):整个清单所有段加起来的上限。达到后停止加载后续所有命中段,末尾注入总截断说明,**带上未加载的 section id 集合**:
134
144
  `[注意] 上下文清单总量超限(>50 文件 / >100KB),以下 section 未加载:goal-fragment, extra-docs。`
135
145
 
@@ -137,8 +147,12 @@ manifest 是 `{ "$schema_version": 1, "sections": [...] }`。每个 section:
137
147
  > 单目录"至少保留 1 个文件"——避免单个超大文件导致整段为空。
138
148
  > 截断信息同时写入调试输出(`manifest-*.md`),便于排查。
139
149
 
140
- > **现状**:当前唯一目录段 `$KITS_RULES` = 6 文件 / ~18KB,远低于默认限额,不受影响。
141
- > 新增规则文档时注意别让该目录逼近 40KB。
150
+ > **现状**:目录段有两个——
151
+ > - `$KITS_RULES` = 6 文件 / ~32KB,显式把单文件上限放宽到 16KB(规则文件本来就比其他段长,
152
+ > 8KB 默认值会把 `01-overview.md` 截断)。
153
+ > - `$PERSONAL_DIR/soul` = 常驻自我定义,收紧为 12 文件 / 24KB / 单文件 8KB。
154
+ >
155
+ > 默认单文件 8KB 是给「agent 自己写的目录」用的;随包发布的文档按需在 section 上放宽。
142
156
 
143
157
  ## when 条件求值
144
158
 
@@ -243,7 +257,7 @@ manifest 中常用路径变量的展开值:
243
257
  2. **变量替换**:`{{key}}` 替换为值,非真值替换为空串。
244
258
  3. **清理**:删掉空行。
245
259
 
246
- `needsInjection:false` 的文件原样读入,不做任何替换(如 rules 目录、persona.md、各 venue 文档)。
260
+ `needsInjection:false` 的文件原样读入,不做任何替换(如 rules 目录、soul 分册、各 venue 文档)。
247
261
 
248
262
  ## 运行时变量(vars)目录
249
263
 
@@ -257,7 +271,7 @@ vars 由 evolcore 在 `message-processor.ts` 按当前会话构造。分两类
257
271
  | 变量 | 含义 |
258
272
  |------|------|
259
273
  | `selfAid` / `selfName` | 当前 agent 身份 |
260
- | `hasPersona` | 是否有人格 |
274
+ | `hasPersona` | 是否有自我定义内容(soul/ 下除指南外有非空文件) |
261
275
  | `peerId` / `peerKey` / `peerName` | 对端原生 ID / 跨渠道键 / 显示名 |
262
276
  | `peerRole` / `peerType` | 对端角色(owner/admin/member/visitor/自定义角色/none)/ 类型(human/agent) |
263
277
  | `groupId` | 群 ID(群聊时) |
@@ -294,7 +308,8 @@ coding 场景(无 channel/无身份)下,`chatType`、`channel`、`selfAid`
294
308
  | 10 | rules | 目录 `$KITS_RULES` | active | ✗ |
295
309
  | 15 | bootstrap-guide | `bootstrap.md` | lifecycle=bootstrapping | ✓ |
296
310
  | 20 | identity-layer | fragment | active 且 chatType≠null | ✓ |
297
- | 21 | persona | `$PERSONAL_DIR/persona.md` | active 且 chatType≠null | ✗ |
311
+ | 21 | soul | 目录 `$PERSONAL_DIR/soul`(`*.md`) | active 且 chatType≠null | ✗ |
312
+ | 29.5 | pa-profile | fragment | active 且 isPersonalAssistant=true | ✓ |
298
313
  | 30 | relation-layer | fragment | active 且 chatType∈{private,group} | ✓ |
299
314
  | 35 | memory | `$KITS_FRAGMENTS/memory.md` | active 且 memoryEnableRelation≠false | ✓ |
300
315
  | 36 | agent-memory | `$PERSONAL_DIR/memory/MEMORY.md` | active 且 memoryEnableAgent≠false | ✗ |
@@ -12,8 +12,7 @@
12
12
 
13
13
  | 文档 | 路径 | 说明 | 最后更新 |
14
14
  |------|------|------|----------|
15
- | 人格档案 | `$SELF_DIR/persona.md` | 行为规范与人格定义 | {{CREATED_AT}} |
16
- | 工作记忆 | `$SELF_DIR/memory/working.md` | 短期关注点 | {{CREATED_AT}} |
15
+ | 自我定义 | `$SELF_DIR/soul/` | 常驻 system prompt 的身份/性格/职责/操作铁律;`00-GUIDE.md` 说明各分册用途 | {{CREATED_AT}} |
17
16
 
18
17
  ## 关系档案
19
18
 
@@ -28,6 +28,8 @@
28
28
  | `ec logs` | 查看日志(`--level` `--module` `--raw` `--no-color`) | 日志/查看日志 |
29
29
  | `ec diagnose` | 诊断启动环境 | 诊断/环境诊断 |
30
30
 
31
+ ECWeb 托管重启、端口占用与升级失败处理见 `ecweb-lifecycle.md`。
32
+
31
33
  Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSecurityInfoW ... 5`、`unelevated ... cannot enforce deny-read` 或 daemon 管道 `EPERM` 时,参见 `codex-windows-sandbox.md`。
32
34
 
33
35
  ## 对外通信 / 网络类(连 AUN,以 AID 为发送者)
@@ -45,6 +47,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
45
47
  | `ec storage` | 文件存储底层调试入口 | storage 调试/旧命令/底层上传下载 | 任意有渠道场景 | `storage.md` |
46
48
  | `ec agent` | EvolAgent 生命周期与主机信息 | 创建/启停/热重载/改配置/查主机信息 | 管理操作按目标与角色鉴权 | `agent.md`;创建流程用 `ec-agent-create` 技能,Bootstrap 参考见 `agent-create.md` |
47
49
  | `ec peer` | 对端身份与本地拉黑 | 查已登记对端、拉黑/解除拉黑 | 拉黑为 Agent 自身行为;添加联系人与审批归 Owner | `peer.md` |
50
+ | `ec directory` | Owner 名录查询、入录申请与本地备注 | 联系人/通讯录/名录/找人的 AID/申请添加联系人/这个人是谁/内外联系人/拉黑名单/记备注 | 查询需 Owner 名录授权;申请通过 `request` 发给本端 Owner | `directory.md` |
48
51
  | `ec rpc` | 底层 AUN RPC(逃生通道) | 直接调协议方法 | 仅宿主终端;托管会话仅可查看帮助 | `rpc.md` |
49
52
  | `ec menu-client` | 远程 Daemon Menu 请求 | 远程诊断/远程 daemon 操作/daemon 日志/监控/原始配置/跨主机 | 运维主机或具备 `ec.menu.request` 权限的托管 Agent | `menu-client.md` |
50
53
 
@@ -81,6 +84,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
81
84
  | `ec task` | 恢复暂停或异常中断的会话任务 | 任务恢复/异常中断/继续任务/resume | `task.md` |
82
85
  | `ec skill` | EC 技能管理(新建/安装/删除/启用/禁用/校验/查路径) | 创建技能/新建 skill/安装技能/装个 skill/删除技能/禁用技能/启用技能/看看有哪些技能/技能为什么没生效 | `ec-capabilities.md` |
83
86
  | `ec pa-workspace` | 在 Owner 的 AUN 私聊中查看和维护 PA 工作区入口导航 | 个人助理工作区/工作区入口调整/产物入口/报告入口/任务入口/隐藏入口/改名入口/排序入口 | `pa-workspace.md` |
87
+ | `ec pa-workspace` | 入口导航文件的位置、格式、schema 与安全改法;含跨 Agent 入口 | 导航格式/入口格式/加个入口/产物给用户看/加个报告入口/入口指向别的助理/file-navigation/导航文件在哪 | `file-navigation.md` |
84
88
 
85
89
  ## 开发者工具(非 agent 会话能力)
86
90
 
@@ -104,6 +108,5 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
104
108
 
105
109
  | 文档 | 说明 |
106
110
  |------|------|
107
- | `self-summary.md` | 自我总结流程指南(**早期设计稿,源码未实现,可删除**;记忆以 `memory-architecture.md` 为准) |
108
111
  | `memory-architecture.md` | 记忆系统概述(作用域、流水线、开关、目录) |
109
112
  | `memory-consolidation-batches.md` | 整理批次目录结构(整理批次目录、checkpoint、话题快照、产物目录) |
@@ -72,7 +72,7 @@ active
72
72
 
73
73
  如果创建命令已提供头像,创建流程会在初始 `agent.md` 发布成功后自动处理;Bootstrap 不重复询问或上传。头像支持 PNG、JPEG、WebP,创建流程会保持完整画面、补白边、缩放到头像尺寸并压缩到 500 KiB 内;原图不会被覆盖。若无法解码或规范化,创建会返回具体的可恢复错误。引导消息会告诉 Owner:想换头像就直接发张图片,说一句“用这张当头像”。AUN 渠道收到的图片落盘到 `$EVOLCORE_HOME/agents/<selfAid>/relations/aun#<Owner AID>/attachments/`,每张图旁的同名 `.json` 里有 `createdAt`;新 Agent 据此找到最新那张,复制到当前项目目录或本会话 `$TMPDIR`,再执行 `ec aid avatar <当前 self AID> --file <复制后的路径>`。Owner 给的是 HTTPS 地址时用 `--url <HTTPS URL>`。命令会自动补白边、缩放压缩,并更新、发布名片中的 `avatar` 字段;激活后也可用同一命令更换。不要要求新 Agent 读取创建者其它会话的临时路径。
74
74
 
75
- persona 同样不主动询问。Owner 在回复中提供了人格设定(直接文本或 `.md`/`.txt` 文件)时,用 `ec agent persona --text '<完整内容>'` 或 `ec agent persona --file '<路径>'` 保存;读取 persona 内容或判断文件是否存在只用 `ec agent persona show`,不要调用 base agent 的文件读取或搜索工具探测 `personal/persona.md`;命令显示不存在时按空文件处理。persona 与头像未提供时不等待、不影响 `ready`,激活后仍可完善。
75
+ persona 同样不主动询问。Owner 在回复中提供了人格设定(直接文本或 `.md`/`.txt` 文件)时,先读 `$PERSONAL_DIR/soul/00-GUIDE.md`,再按内容拆分写进对应分册(身份 → 「身份」`01-identity.md`,性格语气 → 「性格」`02-persona.md`,职责边界 → 「职责」`03-duties.md`)。目录与分册在创建时已铺好,不需要先判断存在性。persona 与头像未提供时不等待、不影响 `ready`,激活后仍可完善。
76
76
 
77
77
  Bootstrap 完成前,新 Agent 不处理普通任务,也不执行与本流程无关的工具或命令。Owner 在回复中交办的普通任务记入交接摘要的待继续事项,标注“未执行”,激活后由新主会话续接。
78
78
 
@@ -83,13 +83,13 @@ Owner 回复中有明确的名称、定位或标签内容时,新 Agent 用 `ec
83
83
  - 只修改 `name`、`description`、`tags`,不改其它 frontmatter 字段或正文。
84
84
  - 名片文件位于受保护路径,用文件工具直接读写会被拒绝;`set` 命令会自己写回并签名。
85
85
 
86
- 对话式 Bootstrap 中,新 Agent 还要在 `$PERSONAL_DIR/persona.md` 中写入交接摘要(一次性 `--initialize` 模式不经过这段对话,也不会自动生成此摘要):
86
+ 对话式 Bootstrap 中,新 Agent 还要把交接内容写进 `$PERSONAL_DIR/soul/03-duties.md`(一次性 `--initialize` 模式不经过这段对话,也不会自动生成此摘要):
87
87
 
88
88
  - 忠实整理 Owner 回复中明确提供的职责、协作边界、重要约束和激活后待继续事项,不新增推断或约定;此内部交接不要求 Owner 审稿,含义不清的部分按原话记录,不回头追问。待继续事项标注“未执行”,不启动任务或设置自动触发。
89
89
  - Owner 没有给出任何说明时省略整个交接段;只有部分内容时省略缺失的条目,不为补齐摘要增加追问。
90
90
  - 不复制完整 Bootstrap 历史、临时闲聊、凭据、运行状态或未确认推断;此文件会进入后续私聊和群聊上下文,不写 Owner 的私密信息。
91
- - 写入前用 `ec agent persona show` 获取现有正文;命令显示文件不存在时直接按空文件创建。已有文件只新增或幂等更新 `## Bootstrap 交接` 段落,**保留其它段落**(尤其是 Owner 已设定的人格内容)。
92
- - 文件工具只用于已确认内容后的交接段编辑或创建,不用于读取或探测 `persona.md`;不要用 `ec agent persona --text` 只写交接段——那是整体覆盖。要整体设置人格时才用 `ec agent persona --text '<完整内容>'`。
91
+ - 读取现有正文后,用文件工具只新增或幂等更新 `## Bootstrap 交接` 段落,**保留其它段落**(尤其是 Owner 已设定的人格内容)。
92
+ - 不要整体重写分册:这些文件每轮都会注入,覆盖式写入会冲掉已设定的内容。
93
93
  - 交接摘要保存失败时不得执行 `ready`;不要把摘要整理变成名片确认后的另一轮确认。
94
94
 
95
95
  ## 4. Agent 自主准备正式欢迎文案并发布名片
@@ -131,7 +131,7 @@ ec agent ready helper.agentid.pub
131
131
  3. 为共识确认的 Owner 创建全新的主会话(有多位时逐个创建)。
132
132
  4. 向这些 Owner 发送正式欢迎消息,并把已保存的 welcome 绑定到各自的新会话。
133
133
 
134
- 新主会话会在文件存在时自动注入 `$PERSONAL_DIR/persona.md`。新 Agent 首次回复前,应先阅读其中的 `## Bootstrap 交接`,沿用已确认的职责和约定;仅对标注为未执行的事项按正常权限继续沟通,不把它们误称为已经完成。这个方案由新 Agent 在 `ready` 前写入摘要,不是系统自动复制或总结旧 Bootstrap 历史,会话切换机制保持不变。
134
+ 新主会话会自动注入 `$PERSONAL_DIR/soul/` 下的非空分册。新 Agent 首次回复前,应先阅读其中的职责与交接内容,沿用已确认的约定;仅对标注为未执行的事项按正常权限继续沟通,不把它们误称为已经完成。这个方案由新 Agent 在 `ready` 前写入摘要,不是系统自动复制或总结旧 Bootstrap 历史,会话切换机制保持不变。
135
135
 
136
136
  新 Agent 在 `ready` 成功后不要从旧 Bootstrap 上下文再输出一段完成说明,也不要继续处理先前夹带的普通任务;后续工作从新主会话开始。
137
137
 
@@ -14,7 +14,7 @@ ec agent list [--format json]
14
14
  | 列 | 说明 |
15
15
  |---|---|
16
16
  | 名称 | agent.md 中的显示名(displayName),回退到 aid |
17
- | Personal名 | persona.md 中 `我是/我叫` 提取的简称;无 persona 时显示 `—` |
17
+ | Personal名 | soul 分册中 `我是/我叫` 提取的简称;无内容时显示 `—` |
18
18
  | 状态 | 运行状态;lifecycle 非 `active` 时追加括号标注,如 `running (bootstrapping)` |
19
19
  | 渠道 | 已订阅的 AUN channel 列表 |
20
20
  | 项目 | 关联项目目录名(basename) |
@@ -62,11 +62,6 @@ ec agent disable <aid>
62
62
  ec agent get <aid> <key>
63
63
  ec agent set <aid> <key> <val>
64
64
 
65
- # 读取或设置当前 Agent 的 persona.md
66
- ec agent persona show
67
- ec agent persona --text <text>
68
- ec agent persona --file <path>
69
-
70
65
  # 读取或保存 Bootstrap 中 Agent 自主准备的 welcome 文案
71
66
  ec agent welcome show
72
67
  ec agent welcome --text '<完整 Markdown 文案>'
@@ -86,7 +81,7 @@ ec agent delete <aid> [--purge]
86
81
 
87
82
  ## 创建模式与参数
88
83
 
89
- `welcome --text`、`persona --text`、创建时的 `--description` / `--persona-text` 按一次 `\n` / `\r` / `\t` / `\\` 解码;已传入的物理换行保留。不要使用 PowerShell 反引号换行转义;Windows PowerShell 中直接使用命令名,不要用批处理入口传物理多行。文件、路径、`--tags` JSON 不解码;`--name` / `rename` 名称不允许换行。
84
+ `welcome --text`、创建时的 `--description` / `--persona-text` 按一次 `\n` / `\r` / `\t` / `\\` 解码;已传入的物理换行保留。不要使用 PowerShell 反引号换行转义;Windows PowerShell 中直接使用命令名,不要用批处理入口传物理多行。文件、路径、`--tags` JSON 不解码;`--name` / `rename` 名称不允许换行。
90
85
 
91
86
  `ec agent new <aid>` 默认使用 `--initialize`,要求显式提供 `--owner`、`--name`、`--description` 和 `--tags`。显式选择 `--bootstrap` 才进入对话式首次设定;两者互斥,且均隐含非交互创建。`--non-interactive` 继续保留,单独使用时不改变默认的初始化模式。
92
87
 
@@ -106,8 +101,8 @@ ec agent delete <aid> [--purge]
106
101
  - `--bootstrap` 与 `--initialize` 互斥,进入原 Bootstrap 流程并隐含 `--non-interactive`。
107
102
  - `--non-interactive` 继续保留;单独使用时等同于默认的 `--initialize`。
108
103
  - `--wait <seconds>` 仅初始化模式有效,取值 0–300,默认 60。超时返回 `INITIALIZE_PENDING`,**CLI 退出码为 2**;普通失败退出码为 1;初始化完成但运行时未连接返回 `INITIALIZE_NOT_USABLE`。
109
- - `--persona-file` / `--persona-text` 可选;两者互斥。初始化失败可用 `ec agent initialize <aid> --resume` 按原计划恢复,不能用普通 `new --force` 覆盖。`--force` 只对 `--bootstrap` 有效。
110
- - `ec agent persona show` 读取当前 Agent 的 `$PERSONAL_DIR/persona.md`;`--text` 或 `--file <path>` 可由当前 Agent 的 owner 写入。文件内容限制为 UTF-8 文本,`--file` 仅接受 `.md`/`.txt`。
104
+ - `--persona-file` / `--persona-text` 可选;两者互斥,内容写入 `soul/02-persona.md`(「性格」分册)。初始化失败可用 `ec agent initialize <aid> --resume` 按原计划恢复,不能用普通 `new --force` 覆盖。`--force` 只对 `--bootstrap` 有效。
105
+ - `$PERSONAL_DIR/soul/` 是常驻自我定义目录,没有命令行读写入口:创建 agent 时铺好 `00-GUIDE.md`(机制说明)和 4 个空分册,之后一律用文件工具直接编辑。**每个非空 `.md` 都会注入 system prompt**(空文件不注入),改完按 mtime 自动生效,下一轮即重组,不需要 reload。
111
106
  - `ec agent welcome --text <text>` 用于保存 Bootstrap 中 Agent 自主准备的完整正式文案,不要求 Owner 起草、审稿或确认;命令固定写入当前 Agent 的 `$PERSONAL_DIR/welcome.md`,不接受自定义路径。`welcome show` 读取该文件。
112
107
  - welcome 托管写入要求当前 Agent 私聊 Owner;admin 仅可读。模板上限 4 KiB,渲染上限 8 KiB;变量为 `agentName`、`agentDescription`、`agentAid`、`agentTags`、`agentTagsText`、`ownerName`、`ownerAid`、`channel`,支持标签循环和真值条件。写入保留原始文本,投递不附加额外文案。
113
108
  - `agent show <target-aid>` 与 `agent get <target-aid> <key>` 的跨 Agent 读取对 owner/admin 开放,但普通 Agent 角色只获得安全摘要;敏感配置值和物理路径仅对 DaemonOwner 返回原值。跨 Agent 写入、启停、删除和 reload 仍遵循各自的目标与 DaemonOwner 权限边界。