evolcore 0.0.41-test.2 → 0.0.42-test.0

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