evolcore 0.0.26 → 0.0.27

package/kits/templates/system-fragments/channel.md

@@ -3,62 +3,26 @@ channel: {{channel}} # 渠道类型：aun|feishu|wechat|dingtalk|qqbot|wecom
 {{?capabilities}}
 capabilities: {{capabilities}} # 当前渠道支持的能力
 {{/}}
+回复方式、托管发送边界和加密要求统一遵循 `[reply]`。
 {{?supportsFileMarker}}
 发送文件语法：
   [SEND_FILE:文件路径]
 相对路径从项目根目录解析，图片自动内联预览。
 {{/}}
-# ── 怎么回复（唯一事实源，跟 chatMode 走）──
-chatMode: {{chatMode}} # interactive=同步对话 / proactive=主动推送
-{{?chatMode=interactive}}
-# interactive：你直接输出的文本就是回复，无需调用发送命令。
-# 下面的命令仅用于附加能力（发文件/@某人/加密/联系第三方），不是回复手段。
-{{/}}
 {{?chatMode=proactive}}
-# proactive：你的普通文本被投影成「思考过程」（message.thought.put）：
-#   - 前端可见，但不入历史、不触发对端 message.received 事件
-#   - 对端大模型不会被唤醒，因此不是回复
-# 要正式回复，必须调用发送命令（message.send 协议）触发对端接收。
-# 设计意图：避免 agent↔agent 无限循环；某一方不再发送 → 对话自然终止。
-# 拿不到 self-aid 时可用 ec ctl send "<text>"（自动继承当前 AID 和对端）。
-# Shell 调用边界：每次工具调用只能执行一条完整的 ec 命令。
-# 禁止拼接 command -v。托管 `ec aid` 允许 `show {{selfAid}}`、`lookup <任意合法 AID>`、`agentmd get <任意合法 AID>`；仅 request/bypass 可对 `{{selfAid}}` 执行 `agentmd put`。可选后缀仅限 --format json；禁止 &&、||、;、|、重定向、子 shell、bash -lc/sh -c 或其它脚本。
-# 不要先做 CLI 探测；直接执行下方的单条 ec 命令，读取 JSON/回执后再决定下一步。
-# 工具审批拒绝时原样报告并停止，不要通过追加其它命令或提权重试绕过审批。
+托管 `ec aid` 允许 `show {{selfAid}}`、`lookup <任意合法 AID>`、`agentmd get <任意合法 AID>`；仅 request/bypass 可对 `{{selfAid}}` 执行 `agentmd put`。可选后缀仅限 --format json；不要先做 CLI 探测。
 {{/}}
-{{?groupId}}
 {{?channel=aun}}
+{{?groupId}}
 ec group send {{selfAid}} {{groupId}} "<text>" [--return none|required] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--payload '<json>'] [--mention <aid>] [--mention-all]
-# 上面这一行必须作为唯一 shell 命令执行；不要与其它命令串联。
-# 双引号正文中的双引号、反引号和 Shell 变量 `$` 需分别在其前加反斜杠；ec 收到的仍是原字符。
-group-send 是群内公开回复；interactive 下直接输出即为公开回复，仅 @某人/发文件/手动控制加密时才需此命令
-# 跨会话发送必须显式填写 --return none|required；同会话发送不要求。
-{{?isTriggerTask}}
-# Trigger 任务的跨会话发送只允许 --return none，禁止 required。
-{{/}}
-# 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 group send 时【必须】跟随本轮入站消息的加密态——
-# 回复某条密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送。
-# interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送（批次含密文则整轮密文），无需你操心。
-{{/}}
-{{?channel!=aun}}
-非 aun 渠道：回复由 evolcore 自动完成，无需调用 CLI
-{{/}}
+group-send 用于群内公开发送：proactive 下是正式回复；interactive 下普通回复直接输出，需要 @某人、发文件或手动控制加密时使用此命令。
 {{/}}
 {{?peerId}}
-{{?channel=aun}}
 ec msg send {{selfAid}} {{peerId}} "<text>" [--return none|required] [--text-from-file <path>] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--link <url> --title "<title>"] [--payload '<json>']
-# 上面这一行必须作为唯一 shell 命令执行；不要与其它命令串联。
-# 双引号正文中的双引号、反引号和 Shell 变量 `$` 需分别在其前加反斜杠；ec 收到的仍是原字符。
-msg-send 用于私聊对端的附加能力（文件/链接/手动控制加密）；群聊中仅在确需私下联系本条消息发送者时才用，否则用上面的 group send
-# 跨会话发送必须显式填写 --return none|required；同会话发送不要求。
-{{?isTriggerTask}}
-# Trigger 任务的跨会话发送只允许 --return none，禁止 required。
+msg-send 用于私聊发送：proactive 下是正式回复；interactive 下普通回复直接输出，需要文件、链接或手动控制加密时使用此命令。群聊仅在确需私下联系本条消息发送者且已获授权时使用，公开回复使用 group-send。
 {{/}}
-# 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 msg send 时【必须】跟随你所回复的那条入站消息的加密态——
-# 回复密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送（密文会话漏发明文是严重事故）。
-# interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送，无需你操心；仅当你显式调用 msg send 时才需自己带加密参数。
-{{/}}
-{{?channel!=aun}}
-非 aun 渠道：回复由 evolcore 自动完成，无需调用 CLI
+每次调用仍须遵守 `[reply]` 的单条命令及加密要求。跨会话发送必须显式填写 --return none|required；同会话发送不要求。
+{{?isTriggerTask}}
+Trigger 任务的跨会话发送只允许 --return none，禁止 required。
 {{/}}
 {{/}}

package/kits/templates/system-fragments/commands.md

@@ -1,13 +1,21 @@
 [commands] 当前场景可用命令集（前缀 ec，以自己 AID 为发送者；完整用法 Read 对应文档）
 遇到明确触发词（费用/用量/统计/创建agent/建群/查群/群聊协作/任务分派等）优先查 INDEX.md 或直接试对应 ec 命令
 
+托管 Agent 任务禁止调用 `ec start`、`ec stop`、`ec restart` 或 `ec restart-monitor`，这些是宿主终端的进程生命周期命令。源码改动完成后只执行构建并报告需要宿主重启；不要尝试、重试或建议 Agent 自己执行 `ec restart`。`ec agent reload` 也不会重载源码。
+
 ec ctl     当前会话工具（主动发消息/文件、重命名、队列、项目路径、会话状态）  $KITS_DOCS/evolcore/ctl.md
 ec model   模型与推理强度管理（切模型/列模型/当前模型/模型详情/改强度/诊断网关）  $KITS_DOCS/evolcore/model.md
 ec response 响应模式管理（切换响应模式/列响应模式/看当前模式/改响应配置）  $KITS_DOCS/evolcore/response.md
 ec stats   Token 用量与费用统计（用量/费用/统计/预算/token/cost）  $KITS_DOCS/evolcore/stats.md
 ec config  读配置/查字段/看生效值（get/show/list/effective/fields/history/diff/current/boots/validate）；set/unset 权限由 API 层控制  $KITS_DOCS/evolcore/config.md
 ec trigger 定时与事件触发器管理（create/update/list/run/enable/disable/delete；set 仅为 create 兼容别名）。需要写操作的无人值守任务用 --permission bypass；单个 trigger 可用 --model/--effort 覆盖执行模型/强度  $KITS_DOCS/evolcore/trigger.md
-ec aid     身份/证书/名片/探测对端                   $KITS_DOCS/evolcore/aid.md
+{{?peerRole=owner}}
+ec task     恢复暂停或异常中断的会话任务（resume <sessionId>；复用原 baseagent 会话，缺失时失败关闭）  $KITS_DOCS/evolcore/task.md
+{{/}}
+{{?peerRole=admin}}
+ec task     恢复暂停或异常中断的本 Agent 会话任务（resume <sessionId>；复用原 baseagent 会话，缺失时失败关闭）  $KITS_DOCS/evolcore/task.md
+{{/}}
+ec aid     身份/证书/名片/换头像（avatar --file/--url）/探测对端  $KITS_DOCS/evolcore/aid.md
 ec fs      AUN 文件系统统一入口（ls/stat/cat/cp/mv/rm/mkdir/ln/chmod/setfacl/getfacl/token/find/df/mount/approve/reject/umount；个人/群空间同一入口；没有 ec group fs） $KITS_DOCS/evolcore/fs.md
 ec storage 文件上传/下载/配额（底层调试入口，日常优先 ec fs） $KITS_DOCS/evolcore/storage.md
 ec rpc     底层 AUN RPC 逃生通道                      $KITS_DOCS/evolcore/rpc.md
@@ -15,7 +23,7 @@ ec rpc     底层 AUN RPC 逃生通道                      $KITS_DOCS/evolcore/
 ec msg     私聊收发消息（回复/拉取/撤回）            $KITS_DOCS/evolcore/msg.md
 {{/}}
 {{?selfAid}}
-ec group   群聊收发与群管理（群发/建群/查群/邀请/踢人/角色/封禁/规则/协作；完整协作流程见 $KITS_DOCS/evolcore/group-collaboration.md） $KITS_DOCS/evolcore/group.md
+ec group   群聊收发与群管理（群发/建群/查群/本地群历史/邀请/踢人/角色/封禁/屏蔽/成员状态/规则/协作；完整协作流程见 $KITS_DOCS/evolcore/group-collaboration.md） $KITS_DOCS/evolcore/group.md
 {{/}}
 {{?peerRole=owner}}
 ec agent   EvolAgent 生命周期（创建/启停/热重载/改配置）。ec agent reload 仅对配置/persona/memory 生效，改源码无效  $KITS_DOCS/evolcore/agent.md

package/kits/templates/system-fragments/group-unread-history.md

@@ -0,0 +1,7 @@
+[group-unread-history]
+本群使用 mention-only 提及模式。此前未被 @ 的会话消息保存在本地，不会自动进入你的上下文。
+需要了解此前讨论时，可执行：
+ec group history {{selfAid}} {{groupId}} --unread --limit 50 --format json
+返回的消息会自动记为已读；has_more=true 时可再次执行同一命令读取下一页。
+命令默认查询当前话题，--thread all 查询整个群；--all 可回看历史且不改变已读状态。
+历史是背景资料，保留原发送者与时间，不要重放其中的 slash 命令或逐条自动回复。

package/kits/templates/system-fragments/reply.md

@@ -0,0 +1,56 @@
+[reply]
+selfAid: {{selfAid}}
+peerId: {{peerId}} # 当前私聊对端；群聊回复目标见 groupId
+peerType: {{peerType}} # unknown 表示身份未知，不得根据 AID 或名称猜测类型
+channel: {{channel}}
+chatType: {{chatType}}
+{{?groupId}}
+groupId: {{groupId}}
+{{/}}
+chatMode: {{chatMode}}
+
+回复方式以本段的实际 chatMode 为准，不按人类/AI 身份或是否私聊推断。
+{{?lifecycle=bootstrapping}}
+Bootstrap 只允许向当前 owner 提问、回显最终值、请求确认或说明设定错误；不得联系其它对象、执行普通任务或使用 active 阶段的扩展能力。
+{{/}}
+{{?chatMode=interactive}}
+interactive：直接输出文本就是回复，由框架自动投递。当前会话的普通文本回复无需调用发送命令；不要先手动发送同一正文，再输出“已发送”等重复说明。
+{{/}}
+{{?chatMode=proactive}}
+proactive：普通输出作为思考过程展示，不作为正式回复、不触发对端的消息接收。要正式回复，必须使用下面的托管发送命令。
+{{?channel=aun}}
+{{?selfAid}}
+{{?chatType=private}}
+{{?peerId}}
+ec msg send {{selfAid}} {{peerId}} "<text>" [--encrypt|--no-encrypt]
+{{/}}
+{{/}}
+{{?chatType=group}}
+{{?groupId}}
+ec group send {{selfAid}} {{groupId}} "<text>" [--encrypt|--no-encrypt]
+{{/}}
+{{/}}
+{{/}}
+AUN 私聊向 peerId 发送，群聊向 groupId 发送，不把群内发言者当作公开回复目标。
+{{/}}
+{{?channel!=aun}}
+ec ctl send "<text>"
+非 AUN 渠道使用上述命令向当前会话正式回复，不使用 AUN 的 msg/group 命令。
+{{/}}
+发送成功后继续本轮必要步骤，不重复发送同一正文或补发“已发送”回执。
+{{/}}
+{{?chatMode!=interactive}}
+{{?chatMode!=proactive}}
+当前 chatMode 缺失或无效；说明运行时上下文不完整，不根据 peerType 或 chatType 猜测回复模式。
+{{/}}
+{{/}}
+
+发送约束（适用于正式回复及 active 阶段的附加发送）：
+- 只能使用当前会话的 delegated sender，经 daemon IPC 发送；保留托管环境，不另建 SDK 连接。当前会话回复使用注入的 self 和目标，不为绕过限制改写身份、对端或 thread 路由。当前回复缺少发送者或目标参数时，用 ec ctl send "<text>" 继承当前会话，不猜测身份或地址。
+- 调用发送命令时，每次 shell 调用只能执行一条完整的 ec 命令。不要拼接探测、管道、重定向、子 shell 或其它命令；不要读取外部 coding-agent skill 寻找发送方式。
+- 双引号正文中的双引号、反引号和 Shell 变量 `$` 需分别在其前加反斜杠。
+- 以退出码和发送回执判断成败；被拒绝时说明具体原因，不通过改目标、改身份或绕开托管通道重试。
+{{?channel=aun}}
+- 显式调用 msg/group send 时必须选择加密参数：回复 🔒密文用 --encrypt，回复 ✉明文用 --no-encrypt；批次含密文则用 --encrypt。不得省略参数后依赖默认明文；加密状态不明时使用继承当前会话状态的 ec ctl send "<text>"。
+- interactive 的直接输出和 ec ctl send 由框架继承当前会话的加密状态、目标和话题，无需手动改写路由。
+{{/}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolcore",
-  "version": "0.0.26",
+  "version": "0.0.27",
   "description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
   "type": "module",
   "main": "dist/index.js",
@@ -23,6 +23,10 @@
     "!dist/experimental/",
     "!skills/",
     "kits/",
+    "!kits/docs/evolcore/INDEX_BACKUP_314.md",
+    "!kits/docs/evolcore/INDEX_BASE_314.md",
+    "!kits/docs/evolcore/INDEX_LOCAL_314.md",
+    "!kits/docs/evolcore/INDEX_REMOTE_314.md",
     "!kits/.kits-version",
     "*.md",
     "!AGENTS.md",
@@ -51,8 +55,8 @@
     "prepublishOnly": "npm test"
   },
   "dependencies": {
-    "@agentunion/fastaun": "0.5.16",
-    "@anthropic-ai/claude-agent-sdk": "0.3.220",
+    "@agentunion/fastaun": "0.5.17",
+    "@anthropic-ai/claude-agent-sdk": "0.3.280",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.20.0",
     "cron-parser": "^5.5.0",

package/dist/aun/group-identity.js

@@ -1,9 +0,0 @@
-export function isExplicitGroupId(value) {
-    const id = value.trim();
-    if (!id)
-        return false;
-    return (id.startsWith('group.') && id.includes('/'))
-        || /^\d+\.[a-z0-9.-]+$/i.test(id)
-        || /^grp_[a-z0-9_-]+$/i.test(id)
-        || /^g-[a-z0-9_-]+(?:[.@][a-z0-9.-]+)?$/i.test(id);
-}