evolcore 0.0.49 → 0.0.51
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +103 -3
- package/bin/ec-build.mjs +60 -0
- package/bin/ecmsg.js +64 -57
- package/dist/ability/caller/authorization.js +21 -0
- package/dist/ability/caller/command.js +173 -0
- package/dist/ability/caller/contract.js +117 -0
- package/dist/ability/caller/credential-files.js +132 -0
- package/dist/ability/caller/daemon.js +183 -0
- package/dist/ability/caller/schema-view.js +157 -0
- package/dist/ability/caller/service.js +519 -0
- package/dist/ability/command-contract.js +5 -0
- package/dist/ability/daemon.js +5 -1
- package/dist/ability/interop-v1.js +156 -106
- package/dist/ability/management.js +1 -0
- package/dist/agent-template/jobs.js +79 -3
- package/dist/agent-template/runtime.js +459 -47
- package/dist/agent-template/service.js +1242 -198
- package/dist/agent-template/share.js +103 -0
- package/dist/agent-template/tool-runner.js +25 -0
- package/dist/agent-template/types.js +10 -2
- package/dist/agents/claude/availability.js +94 -0
- package/dist/agents/claude/capability-provider.js +154 -0
- package/dist/agents/claude/index.js +145 -0
- package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
- package/dist/agents/claude/session-file-adapter.js +246 -0
- package/dist/agents/codex/app-server-client.js +90 -10
- package/dist/agents/codex/availability.js +164 -0
- package/dist/agents/codex/capability-provider.js +138 -0
- package/dist/agents/codex/cli.js +38 -0
- package/dist/agents/codex/index.js +345 -0
- package/dist/agents/codex/mcp-elicitation.js +135 -0
- package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
- package/dist/agents/codex/session-file-adapter.js +834 -0
- package/dist/agents/dsh/availability.js +28 -0
- package/dist/agents/dsh/capability-provider.js +56 -0
- package/dist/agents/dsh/desktop-locations.ps1 +66 -0
- package/dist/agents/dsh/desktop-probe.cjs +37 -0
- package/dist/agents/dsh/index.js +98 -0
- package/dist/agents/dsh/installation.js +400 -0
- package/dist/agents/dsh/resources.js +755 -0
- package/dist/agents/dsh/runner.js +1183 -0
- package/dist/agents/dsh/runtime/README.md +243 -0
- package/dist/agents/dsh/runtime/authorization.js +23 -0
- package/dist/agents/dsh/runtime/bridge.js +837 -0
- package/dist/agents/dsh/runtime/config.js +271 -0
- package/dist/agents/dsh/runtime/entry.js +229 -0
- package/dist/agents/dsh/runtime/session-inspector.js +340 -0
- package/dist/agents/dsh/runtime/tool-policy.js +49 -0
- package/dist/agents/dsh/session-file-adapter.js +145 -0
- package/dist/agents/ecagent/index.js +215 -0
- package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
- package/dist/agents/ecagent/session-file-adapter.js +134 -0
- package/dist/agents/gemini/index.js +96 -0
- package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
- package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
- package/dist/aun/ability-device-routing.js +11 -17
- package/dist/aun/aid/agentmd.js +27 -1
- package/dist/aun/aid/control-aid.js +52 -32
- package/dist/aun/aid/managed-operation.js +6 -4
- package/dist/aun/group/invite-service.js +7 -37
- package/dist/aun/group/operations.js +6 -0
- package/dist/aun/menu/client.js +1 -1
- package/dist/aun/msg/history.js +1 -1
- package/dist/aun/msg/managed-operation.js +93 -21
- package/dist/aun/msg/mention-schema.js +1 -1
- package/dist/aun/msg/p2p.js +32 -4
- package/dist/aun/msg/upload.js +126 -3
- package/dist/aun/service-proxy.js +1 -1
- package/dist/aun/storage/index.js +242 -0
- package/dist/build-identity.json +1 -1
- package/dist/channels/aun.js +698 -213
- package/dist/channels/daemon.js +3 -2
- package/dist/channels/dingtalk.js +1 -1
- package/dist/channels/feishu.js +9 -9
- package/dist/channels/qqbot.js +1 -1
- package/dist/channels/wechat.js +2 -2
- package/dist/channels/wecom.js +1 -1
- package/dist/claude-gateway/agent-registration.js +389 -0
- package/dist/claude-gateway/binding.js +96 -0
- package/dist/claude-gateway/inbox.js +138 -0
- package/dist/claude-gateway/index.js +125 -0
- package/dist/claude-gateway/listing.js +330 -0
- package/dist/claude-gateway/router.js +328 -0
- package/dist/claude-gateway/sessions.js +128 -0
- package/dist/claude-gateway/terminal.js +250 -0
- package/dist/claude-gateway/transcript.js +272 -0
- package/dist/claude-gateway/types.js +14 -0
- package/dist/cli/ability-command.js +45 -0
- package/dist/cli/ability-output.js +182 -0
- package/dist/cli/agent-command.js +21 -2
- package/dist/cli/agent-create.js +197 -56
- package/dist/cli/agent-template.js +400 -27
- package/dist/cli/agent.js +105 -11
- package/dist/cli/aun-commands.js +237 -123
- package/dist/cli/bench.js +5 -2
- package/dist/cli/config.js +22 -6
- package/dist/cli/daemon-commands.js +283 -109
- package/dist/cli/data-command.js +1 -1
- package/dist/cli/debug-mode.js +9 -0
- package/dist/cli/directory.js +1 -2
- package/dist/cli/ecmsg-gateway.js +64 -26
- package/dist/cli/fs-command.js +67 -39
- package/dist/cli/index.js +45 -12
- package/dist/cli/init.js +161 -90
- package/dist/cli/managed-command-guard.js +3 -0
- package/dist/cli/menu-client.js +32 -7
- package/dist/cli/model.js +1 -1
- package/dist/cli/pay-command.js +30 -0
- package/dist/cli/provider-command.js +6 -2
- package/dist/cli/restart-monitor.js +4 -4
- package/dist/cli/services-command.js +35 -10
- package/dist/cli/skill-command.js +4 -4
- package/dist/cli/task-context.js +24 -14
- package/dist/cli/team-workspace-command.js +50 -52
- package/dist/cli/thread-command.js +81 -14
- package/dist/cli/trigger-command.js +47 -12
- package/dist/cli/watch-logs.js +2 -1
- package/dist/config/access-policy.js +16 -3
- package/dist/config/boot-log.js +3 -0
- package/dist/config/builtin-role-templates.js +1 -1
- package/dist/config/config-field-policy.js +26 -13
- package/dist/config/config-manager.js +113 -52
- package/dist/config/config-operation-service.js +22 -1
- package/dist/config/gateway-config.js +29 -44
- package/dist/config/invoke-ipc-service.js +1 -1
- package/dist/config/owner-config.js +5 -19
- package/dist/config/peer-book-store.js +2 -3
- package/dist/config/peer-book.js +2 -2
- package/dist/config/peer-role-resolver.js +3 -9
- package/dist/config/provider-identity-migration.js +24 -105
- package/dist/config/provider-ipc-service.js +13 -3
- package/dist/config/provider-local-sync.js +4 -1
- package/dist/config/provider-menu-request.js +21 -3
- package/dist/config/provider-templates.js +1 -1
- package/dist/config/providers-config.js +138 -31
- package/dist/config/providers-import.js +3 -3
- package/dist/config/providers-management.js +109 -118
- package/dist/config/resolved-config-op.js +1 -42
- package/dist/config/schema-migration.js +254 -15
- package/dist/config/schema-registry.js +53 -8
- package/dist/config-store.js +1343 -63
- package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
- package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
- package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
- package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
- package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
- package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
- package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
- package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
- package/dist/core/auth/agent-delegation.js +15 -8
- package/dist/core/auth/delegation-authorization.js +28 -0
- package/dist/core/auth/operation-authorizer.js +20 -2
- package/dist/core/auth/operation-catalog.js +80 -8
- package/dist/core/baseagent/baseagent-availability.js +197 -0
- package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
- package/dist/core/baseagent/baseagent-config-shared.js +56 -0
- package/dist/core/baseagent/baseagent-identity.js +68 -0
- package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
- package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
- package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
- package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
- package/dist/core/baseagent/baseagent.js +157 -0
- package/dist/{agents → core/baseagent}/runner-types.js +36 -4
- package/dist/core/capability/capability-manager.js +91 -33
- package/dist/core/capability/providers/claude-capability-provider.js +2 -154
- package/dist/core/capability/providers/codex-capability-provider.js +2 -136
- package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
- package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
- package/dist/core/command/agent-control.js +80 -17
- package/dist/core/command/agent-template-menu.js +23 -10
- package/dist/core/command/agentmd-menu-request.js +19 -8
- package/dist/core/command/agentmd-menu.js +14 -5
- package/dist/core/command/cli-intent-parser.js +15 -0
- package/dist/core/command/command-handler.js +127 -57
- package/dist/core/command/context-policy-menu.js +122 -0
- package/dist/core/command/data-root-resolver.js +157 -20
- package/dist/core/command/memory-slash.js +6 -6
- package/dist/core/command/menu-catalog.js +95 -19
- package/dist/core/command/menu-file-path.js +70 -0
- package/dist/core/command/menu-handler.js +392 -93
- package/dist/core/command/menu-protocol.js +47 -8
- package/dist/core/command/menu-query-batch.js +9 -5
- package/dist/core/command/private-mention-menu.js +71 -0
- package/dist/core/command/provider-menu.js +7 -11
- package/dist/core/command/role-menu.js +1 -1
- package/dist/core/command/skill-slash.js +17 -5
- package/dist/core/command/slash-gate.js +2 -4
- package/dist/core/command/slash-handler.js +143 -121
- package/dist/core/command/team-workspace-bootstrap.js +2 -1
- package/dist/core/command/team-workspace-team.js +3 -3
- package/dist/core/command/topic-slash.js +16 -10
- package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
- package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
- package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
- package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
- package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
- package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
- package/dist/core/file-integrity/store.js +1 -1
- package/dist/core/handoff/ipc-registration.js +3 -3
- package/dist/core/handoff/runtime.js +2 -2
- package/dist/{agents → core/inference}/request-identity.js +2 -2
- package/dist/core/inference/text-inference.js +4 -4
- package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
- package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
- package/dist/core/initialization/service.js +57 -9
- package/dist/core/invoke/executors/media.js +1 -1
- package/dist/core/invoke/executors/text.js +1 -1
- package/dist/core/memory/consolidation-context.js +3 -2
- package/dist/core/memory/consolidation-trigger.js +9 -3
- package/dist/core/memory/consolidation.js +39 -68
- package/dist/core/memory/memory-admin.js +6 -6
- package/dist/core/memory/memory-writer.js +1 -1
- package/dist/core/memory/relation-idle-monitor.js +1 -1
- package/dist/core/message/aun-ipc-sender.js +204 -88
- package/dist/core/message/aun-request-registry.js +44 -5
- package/dist/core/message/auto-mention-gate.js +1 -1
- package/dist/core/message/contact-admission.js +1 -1
- package/dist/core/message/im-renderer.js +19 -0
- package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
- package/dist/core/message/items-formatter.js +5 -5
- package/dist/core/message/message-admission.js +1 -1
- package/dist/core/message/message-bridge.js +239 -59
- package/dist/core/message/message-log.js +8 -0
- package/dist/core/message/message-queue.js +88 -7
- package/dist/core/message/message-utils.js +1 -1
- package/dist/core/message/peer-mode.js +16 -5
- package/dist/core/message/response-engine.js +351 -152
- package/dist/core/message/send-options.js +44 -7
- package/dist/core/message/send-routing.js +55 -115
- package/dist/core/message/stream-idle-monitor.js +1 -1
- package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
- package/dist/core/model/catalog-service.js +29 -8
- package/dist/core/model/model-capabilities.js +88 -0
- package/dist/core/model/model-catalog.js +18 -7
- package/dist/core/model/model-diagnostics.js +4 -4
- package/dist/core/ownership/owner-resolver.js +107 -101
- package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
- package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
- package/dist/core/permission/approval-gateway.js +9 -18
- package/dist/core/permission/ec-command-parser.js +242 -82
- package/dist/core/permission/managed-file.js +234 -0
- package/dist/core/permission/protected-paths.js +120 -9
- package/dist/core/permission/sandbox-runtime.js +267 -3
- package/dist/core/permission/services-path-acl.js +9 -2
- package/dist/core/permission/session-path-grants.js +1 -1
- package/dist/core/permission/shell-environment.js +15 -1
- package/dist/core/permission/tool-policy.js +21 -9
- package/dist/core/plugin/plugin-lifecycle.js +442 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
- package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
- package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
- package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
- package/dist/core/{background-session → session/background}/types.js +1 -1
- package/dist/core/session/session-file-health.js +2 -272
- package/dist/core/session/session-idle-monitor.js +1 -1
- package/dist/core/session/session-manager.js +76 -12
- package/dist/core/session/session-mapper.js +16 -0
- package/dist/core/session/session-terminal.js +185 -0
- package/dist/core/session/session-title.js +8 -11
- package/dist/core/{system-session → session/system}/memory.js +43 -9
- package/dist/core/{system-session → session/system}/registry.js +1 -1
- package/dist/core/{system-session → session/system}/types.js +1 -1
- package/dist/core/skill/index-generator.js +3 -3
- package/dist/core/skill/switch-resolver.js +3 -0
- package/dist/core/task/task-activity-store.js +112 -0
- package/dist/core/task/task-recovery-service.js +2 -2
- package/dist/core/thread/command-parser.js +4 -1
- package/dist/core/thread/ipc-operation.js +6 -4
- package/dist/core/thread/thread-operation.js +27 -11
- package/dist/core/thread/thread-route.js +5 -3
- package/dist/core/thread/thread-service.js +307 -58
- package/dist/core/thread/topic-id.js +52 -2
- package/dist/core/thread/types.js +15 -1
- package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
- package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
- package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
- package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
- package/dist/directory/{owner-directory-search.js → search.js} +50 -2
- package/dist/directory/{owner-directory-store.js → store.js} +2 -2
- package/dist/eck/kit-renderer.js +3 -2
- package/dist/eck/manifest-engine.js +64 -2
- package/dist/eck/message-renderer.js +35 -0
- package/dist/ecweb/basic-settings-service.js +12 -10
- package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
- package/dist/ecweb/dsh-native-service.js +413 -0
- package/dist/ecweb/providers-service.js +5 -3
- package/dist/ecweb/runtime/lifecycle.js +1 -1
- package/dist/ecweb/runtime/supervisor.js +1 -1
- package/dist/event-center/center-config.js +2 -2
- package/dist/event-center/dispatcher.js +1 -1
- package/dist/event-center/ipc-operation.js +12 -3
- package/dist/event-center/pack-loader.js +2 -2
- package/dist/event-center/registry.js +6 -6
- package/dist/event-center/runtime.js +2 -2
- package/dist/index.js +181 -77
- package/dist/ipc.js +161 -12
- package/dist/outputs/authorization.js +27 -0
- package/dist/outputs/events.js +10 -1
- package/dist/outputs/panel-cards.js +960 -0
- package/dist/paths.js +60 -1
- package/dist/pay/command.js +38 -0
- package/dist/pay/protocol.js +136 -0
- package/dist/pay/runtime.js +196 -0
- package/dist/pay/service.js +384 -0
- package/dist/pay/store.js +81 -0
- package/dist/response-system/engines/v1/proactive-flow.js +30 -3
- package/dist/services/dispatcher.js +25 -7
- package/dist/services/host/main.js +397 -0
- package/dist/services/host/protocol.js +125 -0
- package/dist/services/host/resident.js +347 -0
- package/dist/services/host-client.js +398 -0
- package/dist/services/host-deploy.js +180 -0
- package/dist/services/host-launch.js +117 -0
- package/dist/services/host-recycle.js +208 -0
- package/dist/services/host-runtime.js +841 -0
- package/dist/services/idempotency.js +44 -86
- package/dist/services/index-generator.js +4 -3
- package/dist/services/index.js +258 -36
- package/dist/services/ipc-operation.js +503 -78
- package/dist/services/pack-manager.js +2 -2
- package/dist/services/router.js +43 -3
- package/dist/services/script-runner.js +541 -100
- package/dist/services/service-payload.js +28 -1
- package/dist/services/validation.js +136 -5
- package/dist/stats/context-usage.js +110 -0
- package/dist/stats/model-resolver.js +103 -17
- package/dist/stats/query.js +5 -0
- package/dist/trigger/application-service.js +9 -6
- package/dist/trigger/authorization.js +36 -33
- package/dist/trigger/ipc-service.js +4 -4
- package/dist/trigger/local-files.js +8 -166
- package/dist/trigger/manager.js +2 -2
- package/dist/trigger/parser.js +48 -0
- package/dist/trigger/scheduler.js +35 -13
- package/dist/trigger/script-executor.js +21 -0
- package/dist/trigger/script-sandbox.js +77 -232
- package/dist/trigger/system-definitions.js +25 -0
- package/dist/trigger/validation.js +1 -1
- package/dist/utils/aid-bind.js +3 -0
- package/dist/utils/atomic-write.js +88 -1
- package/dist/utils/cross-platform.js +4 -42
- package/dist/utils/error-dict.json +22 -1
- package/dist/utils/error-utils.js +193 -6
- package/dist/utils/evolcore-version.js +2 -2
- package/dist/utils/host-info.js +74 -1
- package/dist/utils/logger.js +5 -3
- package/dist/utils/media-cache.js +284 -42
- package/dist/utils/restart-safety.js +14 -1
- package/dist/utils/startup-trace.js +20 -4
- package/dist/utils/system-memory.js +113 -25
- package/dist/utils/systemd-lifecycle.js +154 -0
- package/dist/utils/welcome.js +64 -20
- package/dist/utils/windows-shell-trust.js +7 -3
- package/ecagent/README.md +35 -0
- package/ecagent/dist/agent-loop.js +80 -30
- package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
- package/ecagent/dist/harness/env/nodejs.js +49 -20
- package/ecagent/dist/harness/messages.js +3 -2
- package/ecagent/dist/harness/types.d.ts +1 -0
- package/ecagent/dist/runtime/types.d.ts +2 -0
- package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
- package/ecagent/dist/runtime/utils/validation.js +42 -0
- package/ecagent/dist/types.d.ts +2 -0
- package/kits/docs/INDEX.md +3 -2
- 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 +1 -0
- package/kits/docs/channels/aun.md +1 -1
- package/kits/docs/channels/feishu.md +1 -1
- package/kits/docs/evolcore/INDEX.md +13 -9
- package/kits/docs/evolcore/agent-create.md +2 -0
- package/kits/docs/evolcore/agent.md +133 -11
- package/kits/docs/evolcore/aid.md +39 -6
- package/kits/docs/evolcore/config.md +95 -1
- package/kits/docs/evolcore/ctl.md +2 -1
- package/kits/docs/evolcore/ec-capabilities.md +7 -10
- package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
- package/kits/docs/evolcore/event.md +1 -1
- package/kits/docs/evolcore/fs.md +49 -3
- package/kits/docs/evolcore/group.md +5 -4
- package/kits/docs/evolcore/memory-consolidation.md +1 -1
- package/kits/docs/evolcore/memory-tags.md +2 -0
- package/kits/docs/evolcore/menu-client.md +3 -3
- package/kits/docs/evolcore/menu-protocol.md +31 -2
- package/kits/docs/evolcore/model.md +12 -1
- package/kits/docs/evolcore/msg.md +96 -36
- package/kits/docs/evolcore/pay.md +22 -0
- package/kits/docs/evolcore/plugin.md +74 -0
- package/kits/docs/evolcore/provider.md +29 -2
- package/kits/docs/evolcore/rpc.md +2 -2
- package/kits/docs/evolcore/services.md +46 -18
- package/kits/docs/evolcore/skill.md +17 -1
- package/kits/docs/evolcore/stats.md +5 -0
- package/kits/docs/evolcore/storage.md +22 -0
- package/kits/docs/evolcore/thread-chain.md +20 -9
- package/kits/docs/evolcore/tool-authorization.md +14 -0
- package/kits/docs/evolcore/trigger.md +89 -13
- package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
- package/kits/docs/venues/feishu-group.md +3 -2
- package/kits/docs/venues/feishu-private.md +3 -2
- package/kits/rules/01-overview.md +11 -32
- package/kits/rules/02-navigation.md +20 -6
- package/kits/rules/06-channel.md +20 -4
- package/kits/schemas/_meta.json +42 -5
- package/kits/schemas/agent-config.schema.21.json +974 -0
- package/kits/schemas/agent-config.schema.22.json +977 -0
- package/kits/schemas/agent-config.schema.23.json +974 -0
- package/kits/schemas/agent-config.schema.24.json +986 -0
- package/kits/schemas/agent-config.schema.25.json +986 -0
- package/kits/schemas/daemon.schema.10.json +373 -0
- package/kits/schemas/daemon.schema.11.json +487 -0
- package/kits/schemas/daemon.schema.12.json +505 -0
- package/kits/schemas/daemon.schema.9.json +12 -0
- package/kits/schemas/defaults.schema.7.json +472 -0
- package/kits/schemas/defaults.schema.8.json +484 -0
- package/kits/schemas/providers.schema.1.json +1 -1
- package/kits/schemas/providers.schema.2.json +1 -1
- package/kits/schemas/providers.schema.3.json +26 -4
- package/kits/schemas/relation-config.schema.13.json +289 -0
- package/kits/skills/.switches.json +17 -1
- package/kits/skills/ability/SKILL.md +395 -33
- package/kits/skills/ability/STRUCTURE.md +338 -0
- package/kits/skills/ability/references/cli.md +208 -0
- package/kits/skills/ability/references/development.md +107 -37
- package/kits/skills/ability/references/management.md +106 -46
- package/kits/skills/ability/references/runtime-protocol.md +65 -63
- package/kits/skills/agent-output-cards/SKILL.md +80 -37
- package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
- package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
- package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
- package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
- package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
- package/kits/skills/agent-output-cards/examples/surface.html +8 -0
- package/kits/skills/agent-template-project/SKILL.md +51 -0
- package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
- package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
- package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
- package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
- package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
- package/kits/skills/ec-group/SKILL.md +8 -6
- package/kits/skills/ec-group/TASK.md +186 -0
- package/kits/skills/ec-group/WORKLOG.md +180 -0
- package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
- package/kits/skills/ec-identity/SKILL.md +9 -6
- package/kits/skills/ec-pay/SKILL.md +223 -0
- package/kits/skills/ec-provider/SKILL.md +6 -6
- package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
- package/kits/skills/ec-service-call/SKILL.md +138 -0
- package/kits/skills/ec-service-pack/SKILL.md +277 -0
- package/kits/skills/ec-skill/SKILL.md +25 -9
- package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
- package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
- package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
- package/kits/skills/ec-trigger/SKILL.md +3 -3
- package/kits/skills/personal-assistant/SKILL.md +22 -22
- package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
- package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
- package/kits/skills/thread-ops/SKILL.md +19 -9
- package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
- package/kits/skills/wechat-article-reader/SKILL.md +2 -2
- package/kits/templates/memory-consolidation/notes.md +2 -2
- package/kits/templates/memory-consolidation/workflow.md +46 -0
- package/kits/templates/system-fragments/channel.md +13 -4
- package/kits/templates/system-fragments/commands.md +5 -4
- package/kits/templates/system-fragments/personal-assistant.md +2 -2
- package/kits/templates/system-fragments/reply.md +15 -9
- package/kits/templates/system-fragments/session.md +2 -2
- package/kits/templates/system-fragments/thread.md +30 -127
- package/kits/templates/system-fragments/venue.md +16 -0
- package/package.json +7 -7
- package/scripts/agent-template/index.mjs +7 -1
- package/scripts/agent-template/inspect.mjs +99 -39
- package/scripts/agent-template/overlay.mjs +126 -2
- package/scripts/agent-template/shared/common.mjs +49 -5
- package/scripts/agent-template/shared/plan.mjs +4 -2
- package/scripts/agent-template/shared/service-packs.mjs +104 -0
- package/scripts/agent-template/shared/team-schema.json +468 -39
- package/scripts/agent-template/shared/template-contract.mjs +93 -51
- package/scripts/agent-template/shared/template-package.mjs +225 -44
- package/scripts/agent-template/shared/template-runtime.mjs +137 -15
- package/scripts/agent-template/shared/template.mjs +31 -8
- package/scripts/agent-template/team-pack.mjs +528 -56
- package/scripts/agent-template/team-preview.mjs +102 -9
- package/scripts/aid-batch/identity-batch.mjs +1 -1
- package/dist/agents/baseagent-availability.js +0 -152
- package/dist/agents/baseagent.js +0 -750
- package/dist/agents/codex/catalog.js +0 -80
- package/dist/agents/ecagent-plugin-lazy.js +0 -41
- package/dist/agents/tool-time-context.js +0 -55
- package/dist/core/legacy-rename.js +0 -41
- package/dist/core/plugin-lifecycle.js +0 -137
- package/dist/core/rate-window.js +0 -53
- package/dist/core/runner-reload-transaction.js +0 -60
- package/dist/core/runtime-lock.js +0 -90
- package/dist/core/soul.js +0 -66
- package/dist/core/system-session/grants.js +0 -40
- package/dist/directory/owner-directory-agentmd-sync.js +0 -89
- package/dist/directory/owner-directory-request-operation.js +0 -79
- package/dist/directory/owner-directory-text.js +0 -60
- package/kits/docs/aun/ABILITY_CALLING.md +0 -280
- package/kits/docs/evolcore/ability.md +0 -185
- package/kits/skills/ability/references/calling.md +0 -56
- package/kits/skills/ability/references/contract-checklist.md +0 -37
- package/kits/skills/ability/references/recovery.md +0 -27
- /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
- /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
- /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
- /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
- /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
- /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
- /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
- /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
- /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
- /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
- /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
- /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
# 下载和安装
|
|
2
|
+
|
|
3
|
+
入口:[SKILL.md](../SKILL.md)。收到模板分享后,读取摘要和原始卡片附件,不自动下载或安装。
|
|
4
|
+
|
|
5
|
+
按「下载 → 预览 → 部署 → 检查」在当前会话推进。每阶段开始前告诉用户接下来要做什么,取得结果后按[固定版式](#阶段反馈版式)说明实际结果和下一步。相邻两步可用上一阶段的「下一步」衔接。按当前会话的回复规则投递阶段消息。作业耗时较长时,先取得回执,再用 `status` 跟踪。进入长时间等待、状态有实质变化或需要用户操作时及时更新。沿用已有决定,只询问影响本次结果的缺项。支持结构化提问时可用它呈现具体选项,否则在当前话题提问。等用户回答后再执行依赖步骤。
|
|
6
|
+
|
|
7
|
+
## 1. 下载 · 核实包与目标 Host
|
|
8
|
+
|
|
9
|
+
说明包的来源、已知版本和目标 Host。有多个可能的发行时,列出实际名称与版本供选择。已有本地包时,告诉用户将使用哪个文件,跳过下载。只要求下载时,反馈存放位置和校验结果后结束。
|
|
10
|
+
|
|
11
|
+
### 平台仓库
|
|
12
|
+
|
|
13
|
+
先查询目录和精确发行。
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
ec agent template list --store '<仓库AID>'
|
|
17
|
+
ec agent template detail '<releaseId>' --store '<仓库AID>'
|
|
18
|
+
ec agent template download '<releaseId>' --store '<仓库AID>' --path "$TMPDIR/agent-template/package.ectpl" --request-id '<本次稳定请求ID>' --format json
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
先确认目标 Host 的 capabilities.features.templateStore。list 可按 kind/publisher/template-id 过滤,offset/limit 分页;detail 可传 --from-version。list/detail 默认等待30秒。download 使用当前可信执行身份申请当前 Host 的授权,下载到 --path 指定的绝对路径,校验摘要、大小、PACKAGE/MANIFEST 和发行信息。不建立独立包缓存或 packageId 索引。普通下载不代表审核通过、启用升级或安装成功;不提供 versions 命令。
|
|
22
|
+
|
|
23
|
+
仓库下载或 Storage 下载成功后,告诉用户实际模板、版本、存放位置和校验结果。保存 `result.path` 和 `result.digest`,已授权安装时用该路径进入预览。失败或暂停时反馈具体阶段、原因和下一步,需要恢复时沿用原作业。
|
|
24
|
+
|
|
25
|
+
download 返回 paused/resumable=true 时保存并 resume 原 jobId;原 Caller、发行和摘要固定,过期授权只为同一发行续取。仓库拒绝保留原业务错误,不借用 Owner 身份。
|
|
26
|
+
|
|
27
|
+
确定 location、交接 digest、接收身份和安装 Host。以校验后的包为准;当前无来源签名,digest 不证明作者身份。
|
|
28
|
+
|
|
29
|
+
Agent 收到模板卡片时,模型输入中的 JSON 附件保存完整分享信息;读取附件的 `payload.location`、`payload.template.digest` 和有效期,构造下述 `source`。附件按原消息 ID 命名,历史保留 `$AGENT_DIR/attachments/...` 引用;其中记录的 senderAid 来自认证信封,卡片自报的 publisher 仅是声明。不要把接收 Agent 的 `recipient_download.shareId` 自动填成 Host 的 `source.download.shareId`。
|
|
30
|
+
|
|
31
|
+
- 接收方 App 用 recipient_download;Host 按条件 ACL 读 location/digest,不传接收人短码。
|
|
32
|
+
- 已授权 Host 的短码仍可用 download.shareId;失败先核实授权/期限,不自动换方式。
|
|
33
|
+
- 只下载时经受鉴权文件入口存当前项目或 `$TMPDIR` 并核 SHA-256,不继续安装。
|
|
34
|
+
|
|
35
|
+
### Storage 分享与已有文件
|
|
36
|
+
|
|
37
|
+
`pull` 仅下载和校验,不安装。模板操作需要目标主机的 DaemonOwner 权限;权限不足时,向当前 Agent 的 Owner 汇报模板来源、已完成步骤和阻塞,请 Owner 在与其 Agent 的私聊中明确提出下载或安装,由该会话核验目标主机 DaemonOwner 身份后继续。若该 Owner 不是目标主机的 DaemonOwner,须由目标主机 DaemonOwner 发起。不要在原 Agent-Agent 会话中重复重试。Host 需要独立的文件读取授权,不能直接使用仅授权接收 Agent 的短码。
|
|
38
|
+
|
|
39
|
+
已有 `.ectpl` 直接进入预览,使用 `preview --path`。临时包保存到当前会话 `$TMPDIR`,长期保存主动放到项目目录;文件被清理后重新下载。
|
|
40
|
+
|
|
41
|
+
Storage 分享使用 `pull --input-file FILE [--path PATH]`,source.kind=remote,形状为:
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
{"source":{"kind":"remote","location":{"aid":"sender.agentid.cn","path":"/templates/writer/writer-1.0.0.ectpl"},"digest":"<实际sha256摘要>"}}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
实际 Host 的授权短码可放在 source.download.shareId。动态 Host ACL 不需要短码。省略 `--path` 时,Host 在受管 TMPDIR 分配临时文件。也可用 `--path` 指定 Host 上的绝对文件路径。成功保存 result.path/digest/元数据/成员 key。历史 file/artifact 输入仍可校验原文件并返回路径,不另存副本。
|
|
48
|
+
|
|
49
|
+
仓库发行使用 `download`。preview 通过相同操作者成功下载作业中的路径和摘要沿用真实仓库来源;移动文件后不猜测来源。pull 不提供 `--store` 或 `--registry-aid`;本地文件及普通 Storage 分享不从分享者、文件位置或包内声明推断升级仓库。pack/push/publish 原有成品和 packageId 机制保留。
|
|
50
|
+
|
|
51
|
+
## 2. 预览 · 展示拟安装内容与目标
|
|
52
|
+
|
|
53
|
+
预览前告诉用户拟新建或覆盖哪些成员、安装在哪台 Host。目标或安装方式有待选择时,列出实际候选与影响,例如新建独立 Agent,或覆盖指定已有 Agent 的模板内容。沿用用户明确指定的目标和方式。
|
|
54
|
+
|
|
55
|
+
CLI preview 直接使用参数;writer 替换为包的真实成员 key:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
ec agent template preview --path "$TMPDIR/agent-template/package.ectpl" --install-mode create \
|
|
59
|
+
--default-aid-domain agentid.cn --member writer --aid auto \
|
|
60
|
+
--request-id '<本次preview请求ID>' --format json
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
无需创建 preview.json,CLI 不再接受 preview 的 `--input-file` 或 `--package-id`。多成员重复 `--member KEY`,后续 `--aid`、`--project`、模型和冲突选项归属当前成员。远程 Menu 使用相同 path/installMode/members 输入;历史 packageId 输入仍兼容已有成品。
|
|
64
|
+
|
|
65
|
+
| 模式 | 目标与约束 |
|
|
66
|
+
| --- | --- |
|
|
67
|
+
| create | 可一个或多个成员,全部新建;aid=auto 时顶层必填 defaultAidDomain。当前版本可省 project,由 Host 分配并固定;旧 Host 以其 schema 为准 |
|
|
68
|
+
| overwrite | 只支持单个已有 Agent,必须给真实 AID 和当前默认项目的绝对路径;保留身份、Owner、角色,不接受 auto/defaultAidDomain |
|
|
69
|
+
|
|
70
|
+
CLI 模型选择使用 `--provider codex=provider-12345678 --model codex=model-a --effort codex=xhigh`,基座名对应模板的 active_baseagent;`--effort codex=null` 清除显式 effort。模板的平台、Provider、模型和推理强度是建议;不匹配时 preview 给出提示并按目标 Host 同基座的可用配置回退。显式选择不可用也会提示回退,preview 的 members[key].models 展示 suggested/requested/selected/reasons。没有可用配置时仍可安装,但需补充配置,并以安装结果的 readiness 反映实际就绪情况。按默认基座匹配,不取 providers 首项;不携带来源凭证。包完整性、授权、资源冲突等其他检查仍然生效。
|
|
71
|
+
|
|
72
|
+
外部 AID 映射使用可重复的 `--external-aid 原AID=目标AID`。技能冲突使用 `--skill-resolution 技能名=overwrite|skip --current-digest sha256:... --incoming-digest sha256:...`;每次技能选择带同次预览的两个摘要,多个冲突逐个重复。内部继续映射到 members[key].providers/externalAids/skillResolutions 并按原 schema 校验。
|
|
73
|
+
|
|
74
|
+
部署前,在当前会话展示实际预览结果。逐个成员列出目标 AID、项目目录、将新增或覆盖的主要内容,以及基座、Provider、模型、推理强度的建议值和最终采用值。说明平台或配置回退提示、忽略项和未解决项对用户的实际影响,明确当前能否部署。需要用户决定时,列出具体选项,例如遇到同名技能时保留本地版本或覆盖。用户要求先看预览、变更超出已授权范围或冲突尚未解决时,等待用户决定。计划符合已有授权即可继续。
|
|
75
|
+
|
|
76
|
+
`executable=true` 且同次 `previewId` 和 `planDigest` 非空才可部署。回退先写入冻结计划,deploy 校验并执行同一配置,变更选择须重新预览。预览有效一小时,保留冻结计划和源路径/摘要,不再保存 source.ectpl 副本;部署前核对原文件。文件丢失须重新下载到同一路径,内容变化、预览过期或目标变化须重新预览。
|
|
77
|
+
|
|
78
|
+
技能安装仅处理 member.skills 声明中的资源与开关,旧包中未声明的多余技能文件忽略;目标 Host 的其他默认技能按目标端规则生效。
|
|
79
|
+
|
|
80
|
+
模板不携带来源 access 访问设置;旧包中的 access 同样忽略,新建沿用目标 Host 默认,覆盖保留目标 Agent 当前访问设置。
|
|
81
|
+
|
|
82
|
+
## 3. 部署 · 报告作业进度
|
|
83
|
+
|
|
84
|
+
拿到可执行预览后,告知用户将按已确定的方式部署到哪个目标,再发起作业。回执返回时保存 `requestId` 和 `jobId`。跟踪成功、失败或暂停前的实际阶段,只有状态变化对用户有用时才汇报,例如进入验证、等待 Owner 或需要处理冲突。
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
ec agent template deploy --preview-id <实际previewId> --plan-digest <同次planDigest> --request-id '<本次deploy请求ID>' --format json
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
暂停或失败时,说明作业 ID、已完成到哪一步、是否需要用户操作,以及如何继续原作业。`paused / awaiting_owner` 时先核实是在等归属结果还是需要 Owner 完成操作,再告诉用户具体情况。恢复按[升级和恢复](04-upgrade-and-recovery.md)处理,恢复未确认时保持等待。导入 Trigger 默认停用,启用另按用户授权操作。
|
|
91
|
+
|
|
92
|
+
## 4. 检查 · 核实已安装内容及就绪状态
|
|
93
|
+
|
|
94
|
+
确认部署已提交后,告诉用户正在检查 Agent 是否就绪。查询原作业并按需查询实际 Agent。远程目标通过同一受鉴权入口查询。
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
ec agent template status '<原部署jobId>' --format json
|
|
98
|
+
ec agent show '<实际AgentAID>' --format json
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
核实 `succeeded`、`committed`、实际 AID 和项目,以及 `readiness.runtimeReady`、`directoryReady`、`teamReady`。回复用户时给出实际名称和 AID、安装结果、运行和连接状态、需要补齐的配置。若提交成功但运行降级,直接说明「已安装,尚未就绪」及原因。业务检查按用户目标执行,说明实际验证了哪些功能、哪些尚未实测。若检查得出待选项,给出具体可选操作,等用户选择后再更改配置或启用 Trigger。
|
|
102
|
+
|
|
103
|
+
仅 create 新建安装在整体提交后逐个成员投递激活欢迎,遵循目标 Agent 的 enableWelcome;overwrite 覆盖安装和升级均不投递。result.welcome 按成员返回欢迎处理结果,投递失败不撤销安装成功,queued 由持久 outbox 继续投递。提交后中断或欢迎准备失败,可查询原作业恢复;已处理成员不重复准备欢迎。
|
|
104
|
+
|
|
105
|
+
模板仅安装实际声明成员;不提供可选成员后装或独立 Team 登记/发现。外部联系人继续由 memberReferences.external 携带,不创建身份。
|
|
106
|
+
|
|
107
|
+
## 阶段反馈版式
|
|
108
|
+
|
|
109
|
+
标题统一用「模板安装 N/4 · 阶段 · 状态」。开始时可只发标题和本阶段要做的事,反馈结果或作业状态时使用对应完整字段。按示例的字段名和顺序填写实际值,发送时去掉示例外层的代码围栏。已确认没有的项写「无」,还未取得的值写「待核实」,不适用于本次的项写「不适用」,尚未执行的业务检查写「未实测」。多成员按预览顺序逐个列出目标、变更、模型配置和检查结果。以下四段使用同一个虚构的模板安装场景。
|
|
110
|
+
|
|
111
|
+
### 1. 下载反馈
|
|
112
|
+
|
|
113
|
+
```markdown
|
|
114
|
+
**模板安装 1/4 · 下载 · 已校验**
|
|
115
|
+
|
|
116
|
+
- **模板** 写作助理 1.0.0
|
|
117
|
+
- **来源** 模板仓库 `store-demo.agentid.example`
|
|
118
|
+
- **目标主机** Linux 测试主机 `host-demo.agentid.example`
|
|
119
|
+
- **文件** `/workspace/templates/writer-1.0.0.ectpl`
|
|
120
|
+
- **校验** SHA-256 与发行记录一致,包完整性校验通过
|
|
121
|
+
- **下一步** 在该主机预览新建写作助理
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
已有文件时,状态写「已跳过」,来源填实际附件或原文件,校验填已完成的检查或「待预览核验」。仅下载时,下一步写「下载任务结束」。
|
|
125
|
+
|
|
126
|
+
### 2. 预览反馈
|
|
127
|
+
|
|
128
|
+
```markdown
|
|
129
|
+
**模板安装 2/4 · 预览 · 可部署**
|
|
130
|
+
|
|
131
|
+
- **模板** 写作助理 1.0.0
|
|
132
|
+
- **目标主机** Linux 测试主机 `host-demo.agentid.example`
|
|
133
|
+
- **安装方式** 新建
|
|
134
|
+
- **成员与变更** 写作助理(`writer`),目标 `writer-demo.agentid.example`,项目 `/workspace/writer`。新增名片、写作技能和项目示例
|
|
135
|
+
- **模型配置** Codex。模板建议 `provider-11111111 / model-a / xhigh`。本机采用 `provider-22222222 / model-b / high`
|
|
136
|
+
- **兼容性提示** 模板标注 Windows,目标是 Linux。建议的 Provider 在本机不可用,已采用本机配置
|
|
137
|
+
- **忽略项** 无
|
|
138
|
+
- **待解决事项** 无
|
|
139
|
+
- **下一步** 按已授权的新建方式部署
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
有用户显式指定的配置时,在「模型配置」同时列出指定值。覆盖时列出会新增、替换或保留的主要内容。按 `executable` 判断是否可部署,兼容性问题填「兼容性提示」。需要答复时,把具体问题填入「待解决事项」,在「下一步」写明选项和答复后的动作。例如「请选择 1 保留本地写作技能,或 2 覆盖为模板版本。选定后重新预览」。
|
|
143
|
+
|
|
144
|
+
### 3. 部署反馈
|
|
145
|
+
|
|
146
|
+
```markdown
|
|
147
|
+
**模板安装 3/4 · 部署 · 已暂停**
|
|
148
|
+
|
|
149
|
+
- **目标** 在 `host-demo.agentid.example` 新建 `writer-demo.agentid.example`
|
|
150
|
+
- **作业 ID** `job_00000000-0000-4000-8000-000000000001`
|
|
151
|
+
- **当前阶段** 等待归属确认,安装尚未提交
|
|
152
|
+
- **需要你操作** 无,归属确认仍在处理中
|
|
153
|
+
- **原因** 主机尚未取得新 Agent 的归属确认结果
|
|
154
|
+
- **恢复方式** 使用原作业 ID 恢复
|
|
155
|
+
- **下一步** 确认归属结果后恢复同一个作业
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
按实际回执使用「已受理」「进行中」「已暂停」「已失败」或「已提交」。需要 Owner 操作时,写清要由谁在哪里做什么。确认作业已提交后,在「下一步」安排就绪检查。
|
|
159
|
+
|
|
160
|
+
### 4. 检查反馈
|
|
161
|
+
|
|
162
|
+
```markdown
|
|
163
|
+
**模板安装 4/4 · 检查 · 已就绪**
|
|
164
|
+
|
|
165
|
+
- **模板** 写作助理 1.0.0
|
|
166
|
+
- **作业 ID** `job_00000000-0000-4000-8000-000000000001`
|
|
167
|
+
- **安装结果** 已提交
|
|
168
|
+
- **Agent** 写作助理 `writer-demo.agentid.example`,项目 `/workspace/writer`
|
|
169
|
+
- **就绪状态** 运行、名录、团队均已就绪
|
|
170
|
+
- **连接状态** AUN 已连接
|
|
171
|
+
- **业务检查** 未实测写作任务
|
|
172
|
+
- **待处理事项** 无
|
|
173
|
+
- **下一步** 安装检查结束
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
若已经提交但就绪检查降级,标题写「已安装,尚未就绪」,逐项填写运行、名录和团队的实际状态,把原因和需补齐的配置放入「待处理事项」。业务检查只填写实际执行过的项目和结果。
|
|
177
|
+
|
|
178
|
+
### 暂停、失败或待确认
|
|
179
|
+
|
|
180
|
+
沿用该阶段的标题和字段。暂停或失败时,在「下一步」前补充「作业 ID」(若本阶段已有此栏则直接填入)、「原因」和「恢复方式」。有原作业且允许恢复时继续原作业,失败原因未查明时填「待核实」。例如下载授权失效时可这样写。
|
|
181
|
+
|
|
182
|
+
```markdown
|
|
183
|
+
- **作业 ID** `job_00000000-0000-4000-8000-000000000002`
|
|
184
|
+
- **原因** 当前目标主机的下载授权已过期
|
|
185
|
+
- **恢复方式** 为同一发行续取授权后恢复原作业
|
|
186
|
+
- **下一步** 续取授权并恢复下载,校验通过后再预览
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
需要用户决定时,在「下一步」列出选项和选定后会做什么。若暂时只能等待,写明当前在等什么、何时再检查,或收到什么结果后会继续。
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# 升级和恢复
|
|
2
|
+
|
|
3
|
+
入口:[SKILL.md](../SKILL.md)。升级针对已安装 Agent 的模板发行;安装任意包见第三部分。
|
|
4
|
+
|
|
5
|
+
## 1. 检查升级资格与候选
|
|
6
|
+
|
|
7
|
+
需有 version、update.key(原始 Agent AID)、真实 update.registryAid、update.mode=manual|auto。disabled 禁止检查/升级,auto 只检查提醒。缺项由 Owner 通过现有配置入口补真实来源,不从 publisher/Host/Storage 推断仓库或擅自开启升级。
|
|
8
|
+
|
|
9
|
+
将 `{"targetAid":"writer.agentid.cn"}` 保存为当前 `$TMPDIR/agent-template/check-update.json`:
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
ec agent template check-update --input-file "$TMPDIR/agent-template/check-update.json" --request-id '<本次检查请求ID>' --format json
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
CLI 直接返回 data.currentVersion/updateAvailable/target/summary 或 error.code/message,不接受 --wait,无 update-status 子命令。Menu 检查仍为异步 job;其 update-status query 只读资格、最近检查和 activeJob。
|
|
16
|
+
|
|
17
|
+
手动检查不发提醒;后台 Trigger 默认每日检查并提醒 Owner。无新版就结束检查。
|
|
18
|
+
|
|
19
|
+
## 2. 固定发行升级
|
|
20
|
+
|
|
21
|
+
说明版本和组件变更,按用户授权执行。用检查返回的 target.releaseId 固定候选:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
ec agent template upgrade writer.agentid.cn --release-id <实际64位releaseId> --request-id '<本次升级请求ID>' --format json
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
目标为本机 Agent,与原始 update.key 不同。省略 release-id 会固定当前审核启用候选;指定候选变化报 UPGRADE_TARGET_CHANGED,重新检查,不静默换版。
|
|
28
|
+
|
|
29
|
+
upgrade 作业完成下载/校验/备份/应用/恢复,无需手工 pull/preview/deploy;下载缓存与预览由原作业管理,resume 沿用同一固定发行。保留本机 Provider、策略、仓库和原始 key。确认实际版本及运行状态,phase=no_update 表示未执行升级。
|
|
30
|
+
|
|
31
|
+
提交版本及 template.manifest.json 后,仅清理摘要匹配旧清单的备份,修改/未知项保留;旧清单无效则全保留。报告保留项,不手工清空。
|
|
32
|
+
|
|
33
|
+
## 3. 作业状态与恢复入口
|
|
34
|
+
|
|
35
|
+
| ID | 用途 |
|
|
36
|
+
| --- | --- |
|
|
37
|
+
| requestId | 原请求的幂等与找回键,同 ID 不变更参数 |
|
|
38
|
+
| jobId | 持久作业 ID,查询/恢复/取消使用 |
|
|
39
|
+
| packageId | pack 生成的本机成品句柄,供 push/publish 使用;历史预览输入继续兼容 |
|
|
40
|
+
| path | pull/download 的明确落点或已有 .ectpl 文件路径,供 preview 使用 |
|
|
41
|
+
| previewId + planDigest | 同一次固定安装预览 |
|
|
42
|
+
| releaseId | 仓库发行 ID,不能用版本号或 Storage 短码替代 |
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
ec agent template status --request-id <原请求ID> --format json
|
|
46
|
+
ec agent template status <原jobId> --format json
|
|
47
|
+
ec agent template resume <原jobId> --request-id '<本次恢复请求ID>' --format json
|
|
48
|
+
ec agent template cancel <原jobId> --request-id '<本次取消请求ID>' --format json
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
异步作业默认 --wait 0,可等待动作支持 0..300 秒,超时不取消。退出码:0=受理或成功,1=失败/取消/通信或业务错误,2=参数错误,3=paused 或等待未完成。status 查到 failed 的退出码 1 表示原作业失败,应读 error。
|
|
52
|
+
|
|
53
|
+
回执丢失按原 requestId 找回,已有 jobId 就查原作业;resumable=true 且状态允许才 resume。cancel 后查到终态和补偿结果;committed 部署不能取消,恢复未确认时不绕过工作门。
|
|
54
|
+
|
|
55
|
+
## 4. 按失败阶段处理
|
|
56
|
+
|
|
57
|
+
| 情况 | 下一步 |
|
|
58
|
+
| --- | --- |
|
|
59
|
+
| collect 来源变化或失败 | 修正选择后重做相关 inspect/collect;保留其他成功模块 |
|
|
60
|
+
| 显式冻结报 AGENT_BUSY | 保留用户冻结选择,说明忙碌;不自动改为不冻结 |
|
|
61
|
+
| pack 凭证、结构、依赖、大小或平台校验失败 | 改副本/选择,新 requestId 发起 pack;不可放行,不 resume 不可恢复作业 |
|
|
62
|
+
| pack 可恢复执行故障 | 原 job resume 使用已经固定的快照;改副本需要新 pack |
|
|
63
|
+
| push 权限拒绝 | 根据 stage/uploaderAid/location 修正目标或 Host 目录 rw;不可恢复时新 requestId 复用 packageId,不重采集封包 |
|
|
64
|
+
| VERSION_EXISTS | 先核实现存包;不同内容改版本重新封包,不覆盖原版本 |
|
|
65
|
+
| 短码写入结果未知 | 用 storage share action=status 查询原 requestId;list 候选不是原请求成功证明,不重复创建 |
|
|
66
|
+
| ACL 通信失败或 ACL_RESULT_UNKNOWN | 用 fs getfacl 查询原对象,核对 subject/perms/期限/次数后决定后续,不盲目重发 |
|
|
67
|
+
| 短码成功、ACL 失败 | 保存已成功短码,修复缺失授权;未全部核实前不发卡 |
|
|
68
|
+
| 授权完成、消息失败或未知 | 保存授权与卡片业务 ID,核查消息回执后处理发送,不重做包或重复建分享 |
|
|
69
|
+
| pull 摘要不符或授权失效 | 停止安装,找回正确包或重新取得实际 Host 授权 |
|
|
70
|
+
| 下载包缺失或内容变化 | 缺失时重新下载到原路径并恢复原作业;内容变化先重新 preview。升级作业重下固定发行,保留原计划;不绕过摘要检查 |
|
|
71
|
+
| preview 过期、目标配置变化 | 重新 preview 并评估新变更,不复用旧 planDigest |
|
|
72
|
+
| deploy/upgrade 暂停或恢复未完成 | 查 phase/error/resumable,按原 job 恢复;awaiting_owner 须完成真实 Owner 步骤 |
|
|
73
|
+
|
|
74
|
+
Storage state 与模板 job.status 分开核验。跨会话先找回持久回执,当前 `$TMPDIR` 缺文件不代表原操作未发生。
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# 发布到平台仓库
|
|
2
|
+
|
|
3
|
+
入口:[SKILL.md](../SKILL.md)。使用 `ec agent template publish` 将最终包发布到兼容 `services.templates.publish/status` 的仓库。默认目标为 `evolai.agentid.cn`,已有明确仓库选择时直接沿用。仅要求制作或设计方案时,不执行发布。
|
|
4
|
+
|
|
5
|
+
## 1. 确定包与真实发布身份
|
|
6
|
+
|
|
7
|
+
- 沿用用户确认的模板、版本、仓库和发布身份,仅补问缺项或变化。保存到第一册的打包确认清单,下次直接沿用。
|
|
8
|
+
- 托管会话自动使用当前执行 Agent 的真实 AUN 连接;宿主终端和 Control Menu 自动使用当前 daemon 的真实 Host Control 连接。无需传 agent/host 参数,不能指定任意 AID,也不借用 Owner 身份。
|
|
9
|
+
- 发布者须通过仓库 Core 服务准入及业务 publishers 授权,readers 权限不足以发布。Host 路线需要仓库明确准入该 Host。
|
|
10
|
+
- 包未完成时先走[采集和打包](01-collect-and-pack.md),在 pack 顶层明确 `publisherIdentity: "agent"` 或 `"host"`,使 PACKAGE.publisher.aid 与后续真实 Caller 一致。省略时保留原操作者署名;已有包署名不符须重新 pack,publish 不修改包字节。
|
|
11
|
+
- 单 Agent 的原始 AID key、成员版本及 PACKAGE/team 版本继续遵守现有契约;metadata 仍需明确填写,不自动继承或放宽空值。
|
|
12
|
+
|
|
13
|
+
先查看目标 Host 的 capabilities,确认 `actions` 含 publish,`features.templatePublish.identities` 含所需身份。旧 Host 不支持时提示升级,不自动改用其他身份或仓库。
|
|
14
|
+
|
|
15
|
+
## 2. 提交最终包
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
ec agent template publish '<最终packageId>' --store 'evolai.agentid.cn' --request-id '<本次稳定请求ID>' --wait 60 --format json
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
业务参数为一个 packageId 和必填 `--store AID`,不接受 `--input-file`;`--request-id`、`--wait 0..300`、`--format json` 是可选作业控制参数。替换示例中的占位内容,保存原命令和本地 jobId。
|
|
22
|
+
|
|
23
|
+
Core 在同一个持久作业内完成:
|
|
24
|
+
|
|
25
|
+
1. 核验真实连接、来源权限、最终包摘要和 publisher 声明。
|
|
26
|
+
2. 上传到发布者自身 Storage 的 `/templates/<id>/<id>-<version>.ectpl`,不覆盖同版本不同内容。
|
|
27
|
+
3. 创建仅仓库 AID 可读、有效一小时的私有下载授权。短码保存在内部检查点,不放入公开作业结果。
|
|
28
|
+
4. 以所选真实身份加密调用仓库 publish,保存稳定 operationId 和仓库 serviceJobId。
|
|
29
|
+
5. 查询仓库 status,核对 releaseId、发布者、模板 ID、版本、摘要、大小和仓库位置后才标记 succeeded。
|
|
30
|
+
|
|
31
|
+
无需再手工 push、创建短码或拼服务请求。给个人发送分享卡片继续走[上传和分享](02-upload-and-share.md),Owner App 的原 Storage 流程保持。
|
|
32
|
+
|
|
33
|
+
## 3. 进度、失败与恢复
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
ec agent template status '<本地jobId>' --format json
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
- `queued/running`:已受理或正在执行,phase 为 validating/uploading/granting/submitting/waiting_registry,尚未发行。
|
|
40
|
+
- `succeeded`:仓库业务成功且发行结果已核实。读取 result.releaseId、serviceJobId、digest、size 和 location。
|
|
41
|
+
- `paused` 且 `resumable=true`:结果未知或连接中断,保存原 jobId 后恢复,不换 requestId 重新 publish。
|
|
42
|
+
- `failed`:报告 error.code/message。署名不匹配报 PUBLISHER_MISMATCH,仓库拒绝保留原业务错误。修复包或明确失败的权限后,按实际原因重新封包/发起新作业;未知结果先恢复原作业。
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
ec agent template resume '<原本地jobId>' --request-id '<本次恢复请求ID>' --wait 60 --format json
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
agent 作业须从原执行 Agent 恢复。已知仓库 jobId 时只查询原任务;提交回执丢失时沿用原 operationId 和完全相同 source 补取任务。未知的授权创建不重复写入,需要核实原授权请求。提交仓库之后不支持 cancel,避免将可能已发行的作业当作取消成功;提交前可取消,已上传对象保留,下载授权按原期限过期。
|
|
49
|
+
|
|
50
|
+
本地回执丢失时先 `status --request-id '<原请求ID>'`。退出码 0 可能只表示受理,退出码 3 表示暂停或等待结束仍未完成,均不能代替成功终态。同发布者、同 ID/版本、同内容由仓库复用;同版异内容按仓库 VERSION_CONTENT_CONFLICT 处理,不自动增号。
|
|
51
|
+
|
|
52
|
+
## 4. Menu 与交付
|
|
53
|
+
|
|
54
|
+
受鉴权的 Host Control Menu 共用同一 publish 作业:
|
|
55
|
+
|
|
56
|
+
```json
|
|
57
|
+
{"type":"menu.action","id":"publish-001","name":"template","action":"publish","args":{"packageId":"<最终packageId>","storeAid":"evolai.agentid.cn"}}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Menu 没有托管 Agent 执行上下文,只能使用 host,不接受自报执行 Agent AID。进度继续用 template.job 事件和 job query。包须在 pack 时选 host 署名,App 原 Owner Storage 上传分享不必改走 publish。
|
|
61
|
+
|
|
62
|
+
交付仓库 AID、真实 publisher、模板 ID/版本、releaseId、本地 jobId、serviceJobId、SHA-256、大小和发行 location,并说明实际 reviewStatus/upgradeStatus。发行完成不等于审核通过、启用升级、安装或预构建。
|
|
@@ -34,17 +34,19 @@ license: MIT
|
|
|
34
34
|
群聊运行在 proactive 模式下,以 `[reply]` 段的实际 `chatMode` 为准:
|
|
35
35
|
|
|
36
36
|
- **直接输出不会进群**。它只是思考过程,前端能看见,但不会触发对端的消息接收,也不进其他 agent 的输入。
|
|
37
|
-
- **只有 `
|
|
37
|
+
- **只有 `ecmsg send` 的正文才会到达群里。**
|
|
38
38
|
|
|
39
39
|
命令语法只在此处完整写一遍,别处引用本节:
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
|
|
42
|
+
# 群会话里直接发;不在群会话里时用 --thread 指定该群的话题
|
|
43
|
+
ecmsg send '<text>' [选项]
|
|
44
|
+
ecmsg send '<text>' --thread main:<selfAid>:<groupId> [选项]
|
|
43
45
|
```
|
|
44
46
|
|
|
45
47
|
| 选项 | 说明 |
|
|
46
48
|
|---|---|
|
|
47
|
-
| `--encrypt`
|
|
49
|
+
| `--encrypt yes\|no\|auto` | 加密三态:`yes` 强制密文、`no` 强制明文、`auto` 跟随收到消息的加密状态;必须带取值,裸写是参数错误,不写才是默认 `auto` |
|
|
48
50
|
| `--mention '<aid1>,<aid2>'` | @ 成员。单引号包住、逗号分隔多个 aid,可重复传入 |
|
|
49
51
|
| `--mention-all` | @ 所有人 |
|
|
50
52
|
| `--file <path> [--as image\|video\|voice\|file]` | 发文件 |
|
|
@@ -69,7 +71,7 @@ ec group history <selfAid> <groupId> --limit 6 --format json
|
|
|
69
71
|
看该条的 `encrypt` 与 `transport.status`(`accepted` 表示已投递)和 `transport.seq`。
|
|
70
72
|
|
|
71
73
|
**参数校验发生在提交之前**,错法都有明确文案、不会静默降级:空正文报「缺少消息内容」;
|
|
72
|
-
`--encrypt`
|
|
74
|
+
`--encrypt` 只接受 `yes|no|auto`,必须带取值;裸写是参数错误。
|
|
73
75
|
|
|
74
76
|
**外层输出保持极简**:工具调用之外用一两句说清当前状态或意图就够,不要把要发的正文在外面再抄一遍——那是纯浪费。
|
|
75
77
|
|
|
@@ -211,14 +213,14 @@ ec group rules <selfAid> <groupId> get [--format json]
|
|
|
211
213
|
其余一律回「群聊中不支持 /xxx」。所以 `/chatmode`、`/activity` 以及 `/model` 的切换、重置、审批等
|
|
212
214
|
写操作在群内都不可用,需要走私聊或管理界面。
|
|
213
215
|
|
|
214
|
-
注意:这条白名单拦的是**客户端发来的 slash 消息**。你用 `
|
|
216
|
+
注意:这条白名单拦的是**客户端发来的 slash 消息**。你用 `ecmsg send` 发出去的 `/xxx` 只是一段
|
|
215
217
|
普通文字,不走命令解析——想通过群消息间接执行 slash 是行不通的。
|
|
216
218
|
|
|
217
219
|
## 七、命令速查
|
|
218
220
|
|
|
219
221
|
```bash
|
|
220
222
|
# 发消息(唯一完整语法在第二节)
|
|
221
|
-
|
|
223
|
+
ecmsg send '<text>' [--thread <群话题id>] [--encrypt yes|no|auto] [--mention '<aid1>,<aid2>']
|
|
222
224
|
|
|
223
225
|
# 查上下文
|
|
224
226
|
ec group history <selfAid> <groupId> --limit 50 --format json
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
# ec-group 任务文档
|
|
2
|
+
|
|
3
|
+
> 注(2026-11-10):消息信封已改版,`peerRole` 退出模型可见字段、旧 `item.md` 已拆分为 item-private / item-group / group-batch-item;本文为历史记录,以 docs/message-envelope/message-envelope-design.md 为准。
|
|
4
|
+
|
|
5
|
+
> 发送命令口径:全文统一用 `ecmsg send`(本端恒为当前会话本端;宿主终端用 `--from`)。
|
|
6
|
+
> 历史条目里的原始命令与报错文案按当时实际执行记录保留,不改写。
|
|
7
|
+
|
|
8
|
+
本文件是 `ec-group` 技能建设任务的**单一事实源**。私聊会话和群聊会话都往这里写,两边看到的进度以本文件为准。
|
|
9
|
+
逐轮流水记在 `WORKLOG.md`,本文件只保留当前状态。
|
|
10
|
+
|
|
11
|
+
**更新规则**
|
|
12
|
+
|
|
13
|
+
- 状态变化就改本文件,不要只写在聊天里。
|
|
14
|
+
- 每轮开工先读本文件,收工前把变化写回。
|
|
15
|
+
- 只写你**这一轮真读到或真跑出**的值。自报值、记忆里的旧值、别人转述的值一律标注来源和等级,不能当已验。
|
|
16
|
+
- 状态取值只用:`待做` / `进行中` / `已验` / `未验` / `受阻` / `废弃`。
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## 一、任务目标
|
|
21
|
+
|
|
22
|
+
把群聊知识从 ECK 抽离成内置技能 `ec-group`,按需加载;ECK 只保留必须条件渲染的参数注入和引导句。
|
|
23
|
+
技能本身要"跑起来顺、无多余步骤、无缺失步骤、不会出错",每个命令都要实机验证过。
|
|
24
|
+
|
|
25
|
+
## 二、当前状态
|
|
26
|
+
|
|
27
|
+
- 技能文件:`kits/skills/ec-group/SKILL.md`,`ec skill validate` 通过。
|
|
28
|
+
- 启用状态:内置级已设为缺省启用;dddd 与 2/3/4/5 号索引均已重建,六者 `.index-builtin.md` 均含 `- ec-group`。
|
|
29
|
+
- 形态:**草稿**。剩下三项群内实测见第五节"群会话待办",其余私聊侧任务已收口。
|
|
30
|
+
- 分工:**私聊侧(本会话)负责 ECK 清理、技能定稿、包发布边界、跨 agent 覆盖;群会话负责群内命令实测并回报。**
|
|
31
|
+
|
|
32
|
+
## 三、任务清单
|
|
33
|
+
|
|
34
|
+
### A. 群会话执行(私聊侧不重复做)
|
|
35
|
+
|
|
36
|
+
| # | 任务 | 状态 | 备注 |
|
|
37
|
+
|---|---|---|---|
|
|
38
|
+
| T3 | `ecmsg send` 全流程实测(`--mention`、加密参数、回执、失败态) | 群会话续做 | 群会话:`--mention` ✅、`--encrypt` ✅ 已投递(详见 WORKLOG 16:5x)。私聊侧补测失败态(见第四节之三)。**唯一留存**:人类前端能否读到密文,待 leiliang 目视确认——agent 侧没有第二视角。另发现:密文回执的 `seq` 显示为空,判据要看 `history` 里的 `transport.status`,不能只看回执那一行 |
|
|
39
|
+
| T4 | `ec fs` 群空间读实测(`ls` / `stat` / `cat` / `find`) | 群会话续做 | `ls` ✅ `stat` ✅ `find` ✅(`--name` 语法);**`cat` 与"有命中的 `find`"未跑**——5btgok22du 群空间是空的。**改去 `g-leiliang-g9lpwxdzqy` 跑**:该群空间有 `/blackboard.md` 和 `/rules.md`,能拿到真实命中 |
|
|
40
|
+
| T5 | `ec fs` 群空间写实测(admin 成功、member 被拒文案) | 群会话续做 | member 被拒 ✅(文案见第四节)。**admin 成功路径改去 `g-leiliang-g9lpwxdzqy` 跑**——dddd 在该群是 **admin**(`ec group members --format json` 可复算),而测试群 5btgok22du 里 dddd 是 member、本群无 admin。建议写 `/public/_probe.txt` 后立即 `rm` |
|
|
41
|
+
| T6 | 群内 slash 白名单实测(重点 `/effort`) | 已验(源码级) | 权威源是 `src/core/command/slash-gate.ts:111-137`,见第四节之二 |
|
|
42
|
+
|
|
43
|
+
T3 备注:原先判断"密文会把不可读消息推给全群"而不敢在群里试,owner 明确要求照发
|
|
44
|
+
("该撤就撤,你发给我,我看能不能看得到"),已在群内实发一条并投递成功。
|
|
45
|
+
结论是**可以发**,但只有人类客户端能确认可读性——agent 侧没有第二视角。
|
|
46
|
+
|
|
47
|
+
### B. 私聊侧执行(本会话)
|
|
48
|
+
|
|
49
|
+
| # | 任务 | 状态 | 备注 |
|
|
50
|
+
|---|---|---|---|
|
|
51
|
+
| T7 | "群里禁止创建/安装/删除技能"是否属实 | 已验(源码级) | **属实**。`kits/skills/ec-skill/scripts/skill.mjs:93` `assertPermission()`:`chatType === 'group'` 时对所有级别的技能操作直接抛「拒绝:本机级/Agent 级技能开关不支持在群聊中操作」。另:Agent 级要 `peerRole ∈ {owner,admin}`,本机级要 `peerId ∈ daemonOwners()`。已补进技能第六节。群内实测留待群会话复现文案 |
|
|
52
|
+
| T8 | 定稿 `SKILL.md`(按 T3–T7 结果校正命令流程与边界) | 待做 | 依赖 T3–T7、T11、T12 |
|
|
53
|
+
| T9 | ECK 清理:删 `docs/venues/group.md`、`docs/venues/aun-group.md` | 已验 | 两份均已删除(`kits/docs/venues/` 现存 `private.md` / `feishu-*.md` / `client-*.md` + `aun-private.md`)。同步改了 `kits/rules/05-venue.md` 的路径表:去掉 `group.md`,注明群聊指引已抽到 `ec-group`。`aun-group.md` 末段"物化到本地 venue 目录"的错误说法随删除一并清掉 |
|
|
54
|
+
| T10 | ECK 清理:删 `system-fragments/group-history.md` + manifest `group-history` 段(现 L281–308) | 待做 | 私聊侧已备好改法:删 `kits/templates/system-fragments/group-history.md`,再删 manifest 里 `id: "group-history"` 那一整块对象(含其前一个对象的尾逗号)。**暂缓执行**——该段是群会话每轮注入的唯一历史指路,T4 的 `cat`/有命中的 `find` 未验完前不删 |
|
|
55
|
+
| T11 | ECK 收口:`reply.md` / `channel.md` / `session.md` 三处重复的 `ecmsg send` 语法合并为一处 | 已验 | 已改 `session.md`:删除重复语法行,改为"群内公开发送用 ecmsg send;语法与选项见 [channel] 段"。`reply.md`(最小命令)与 `channel.md`(完整选项)**保留**——都带 `{{selfAid}}`/`{{groupId}}` 实参,是条件渲染的参数注入,属允许保留的部分 |
|
|
56
|
+
| T12 | ECK 引导句:确认"群聊场景请加载 ec-group 技能"落在哪一段 | 已验 | 落在 `session.md` 群分支(`{{?chatType=group}}` 内):"群聊:加载内置技能 `ec-group`,响应判断、发言方式、群资源查询都按它执行。话题与你无关就静默结束,不调用发送命令。" |
|
|
57
|
+
| T13 | `docs/evolcore/group-fs.md`(17 行废弃说明)是否删除或并入 `fs.md` | 已验 | 已删除。内容与 `fs.md` 的"群空间也用 `ec fs`,没有 `ec group fs`" + 路由规则 + 能力边界重复,`INDEX.md` 未引用它,直接删无悬空引用 |
|
|
58
|
+
| T14 | `TASK.md` / `WORKLOG.md` 的包发布边界 | 已定:随包发布 | 保持原位、随 `kits/` 发布,不做 `.dev-` 前缀、不移到 `docs/`。`package.json` 里原本的 `!kits/skills/ec-group/TASK.md` / `!kits/skills/ec-group/WORKLOG.md` 两条排除已于 2026-11-17 删除,`npm pack --dry-run` 实测两份均进包(16.3 kB / 15.0 kB) |
|
|
59
|
+
| T15 | 其他 agent 启用 `ec-group`(2/3/4/5 号) | 已验 | 机制查清:`switch-resolver.ts` 覆盖链为 **Agent → 本机 → 内置**;内置级写 `{"enabled":true,"locked":false}` 即可全队缺省启用,且各 agent 仍可单独关。已在 `kits/skills/.switches.json` 写入该条。已 refresh 2/3/4/5 号,四者 `.index-builtin.md` 均出现 `- ec-group` |
|
|
60
|
+
| T16 | 描述路由复核:首轮群消息能否命中本技能 | 未验 | 只有实际群会话能验;让群会话在回复里说明是否加载了 `ec-group` |
|
|
61
|
+
| T17 | 非 AUN 群(飞书群)适配决策 | 已验 | 已在 description 和正文首段声明:命令/权限部分(第二、四、六节)仅适用 `channel=aun`;非 AUN 群只有"要不要开口""发言节奏"通用,发送方式走当前渠道文档与 `[reply]` 段。渠道侧的飞书指引仍由 `venues/feishu-group.md` 提供 |
|
|
62
|
+
| T18 | 技能内命令的最终一致性复核(语法与 `group.md` 对齐) | 已验 | 逐条比对 `kits/docs/evolcore/group.md`:`send` 的选项集(`--encrypt yes|no|auto`/`--mention`/`--mention-all`/`--file`/`--as`/`--payload`/`--return`)一致;`history` 的 `--limit/--thread/--after/--direction` 与 `has_more`/`next_before` 翻页一致;`info/members/online/mention/member-statuses` 一致;`ec fs` 的 `--name <glob>` 一致;管理命令子集一致 |
|
|
63
|
+
| T19 | 定稿后 `ec skill refresh` 全 agent 重建索引 | 待做 | 依赖 T15 |
|
|
64
|
+
|
|
65
|
+
### C. 已完成
|
|
66
|
+
|
|
67
|
+
| # | 任务 | 状态 | 备注 |
|
|
68
|
+
|---|---|---|---|
|
|
69
|
+
| T1 | 重写 SKILL.md(精炼、命令语法只写一遍、删冗余) | 进行中 | 首版已成文,未定稿 |
|
|
70
|
+
| T2 | ECK 群内容盘点表 | 已验 | 见 `WORKLOG.md` 2026-10-08;仅盘点未改动 |
|
|
71
|
+
|
|
72
|
+
## 四、已确认的事实(私聊会话实测,可复算)
|
|
73
|
+
|
|
74
|
+
| 命令 / 位置 | 结论 |
|
|
75
|
+
|---|---|
|
|
76
|
+
| `ec group info/members/online/mention/history` | 纯文本模式只回 `✓ xxx 完成`,**要看内容必须加 `--format json`** |
|
|
77
|
+
| `ec group mention` | JSON 里 `mode` 是枚举值(如 `mention-only`),`source` 标明来源层级 |
|
|
78
|
+
| `ec group members` | `last_pull_at` 恒为 0、`member_type` 恒为 `human`,都不能当活跃判据;只有 `last_ack_*` 可用 |
|
|
79
|
+
| `ec group history` | `source: local`,只读,不改 pull/ack 游标;结果带 `has_more` 与 `next_before` |
|
|
80
|
+
| `ec fs <group-aid>:/...`(私聊会话) | 报 `Managed fs operations require the current AUN group relation`(`src/core/command/command-handler.ts:2983`)。群文件操作只在群会话可用 |
|
|
81
|
+
| `ec aid agentmd get <aid>` | 返回名片并打印签名验证结果 |
|
|
82
|
+
| 群 relation `config.json` | 只有 `mentionMode` 和 `$schema_version`,**没有 `role` 字段**;role 由别处解析,群会话里应实测本机角色 |
|
|
83
|
+
|
|
84
|
+
## 四之二、已确认的事实(群会话实测,可复算)
|
|
85
|
+
|
|
86
|
+
群:`g-leiliang-5btgok22du.agentid.cn`;测试者 `dddd.agentid.pub`,本群角色 **member**。
|
|
87
|
+
|
|
88
|
+
| 命令 / 位置 | 结论 |
|
|
89
|
+
|---|---|
|
|
90
|
+
| `ecmsg send ... --mention <aid>` | ✅ 生效,回执 `✓ 已发送 message_id=... seq=...`,exit 0 |
|
|
91
|
+
| `ec group mention --format json` | 本群 `mode:"disabled"`、`override:"disabled"`、`source:"relation"`、带 `revision:"sha256:..."` |
|
|
92
|
+
| `ec fs ls <group>:/` | ✅ exit 0,返回 `public` 与 `memberdata` 两个目录(私聊会话同命令报 relation 错误——再次确认群操作只在群会话可用) |
|
|
93
|
+
| `ec fs stat <group>:/public --format json` | ✅ 返回完整 node 元数据 |
|
|
94
|
+
| `ec fs find` 名称过滤 | 语法是 **`--name <glob>`**;写 `-name` → exit 1 `unsupported managed fs option: -name` |
|
|
95
|
+
| `ec fs mkdir <group>:/public/...`(member 身份) | ❌ exit 1 `{"ok":false,"code":"FS_OPERATION_FAILED","error":"跨域 group.fs.mkdir 失败: [-32004] forbidden"}` |
|
|
96
|
+
| `ec group rules ... get --format json` | 本群 `{"status":"missing","path":"/rules.md"}`——`missing` 时没有正文可注入 |
|
|
97
|
+
| `ec group members --format json` | total 3:`leiliang.agentid.cn`=owner、`dddd.agentid.pub`=member、`lwj3214.agentid.cn`=member。**本群无 admin** |
|
|
98
|
+
| 群内 slash 白名单(源码级) | 权威源 `src/core/command/slash-gate.ts`。`guardGroupSlashCommand()` 只放行两个集合:`GROUP_READ_ONLY_COMMANDS`(L111)= `/model` `/effort` `/perm` `/baseagent`,带参写操作拒;`GROUP_TASK_COMMANDS`(L112-114)= `/help` `/evolhelp` `/status` `/check` `/ask` `/pause` `/resume` `/stop` `/compact` `/renew` `/mention` **`/memory`**。其余一律 `GROUP_COMMAND_UNSUPPORTED` |
|
|
99
|
+
| 以 `ecmsg send` 发 `/effort` | ⚠️ **测不出白名单行为**——那只是一条普通正文,不会走命令解析。群内 slash 只能由客户端/人类消息触发,agent 侧无法自测 |
|
|
100
|
+
|
|
101
|
+
**据此浮现的技能缺陷(待 T8 定稿时改):**
|
|
102
|
+
|
|
103
|
+
1. `SKILL.md` 第一节把 `mention-only` 当默认描述。实测本群是关系级 `disabled` 覆盖,
|
|
104
|
+
且 `ec group mention` 会返回 `override` / `source` / `revision`。技能应说明"模式可被关系级覆盖,
|
|
105
|
+
以 `ec group mention` 的返回为准",而不是列举三个枚举值就算完。
|
|
106
|
+
2. 技能通篇没写 **群空间可能是空的**、`find` 可能返回 `[]`。`cat` / 下载类操作要有"先 ls 确认存在"
|
|
107
|
+
的前置步骤,否则新手会拿空目录当命令出错。
|
|
108
|
+
3. `SKILL.md` 第六节的 slash 白名单**漏了 `/memory`**(源码 `GROUP_TASK_COMMANDS` 里有),
|
|
109
|
+
且未说明白名单的判定分两层:只读命令(`/model` `/effort` `/perm` `/baseagent`)带参即拒,
|
|
110
|
+
任务命令整条放行。
|
|
111
|
+
4. `SKILL.md` 第二节没提醒 **agent 自己发的 `/xxx` 不触发命令解析**——`ecmsg send` 发的
|
|
112
|
+
slash 只是普通正文。这个坑会让后续维护者以为自己在"实测"其实是空测。
|
|
113
|
+
|
|
114
|
+
## 四之三、已确认的事实(私聊会话补测 `ecmsg send` 失败态,可复算)
|
|
115
|
+
|
|
116
|
+
在私聊会话里按跨会话调用(只测参数校验,不会真的投递):
|
|
117
|
+
|
|
118
|
+
| 命令 | 结果 |
|
|
119
|
+
|---|---|
|
|
120
|
+
| `ecmsg send <self> <group> "probe" --encrypt --no-encrypt` | ❌ exit 1 `--encrypt 与 --no-encrypt 不能同时使用` |
|
|
121
|
+
| `ecmsg send <self> <group> "" --no-encrypt` | ❌ exit 1 `缺少消息内容(文本或 --file/--payload)` |
|
|
122
|
+
| `ecmsg send <self> <group> "probe" --no-encrypt` | ❌ exit 1 `跨会话 ec msg/group send 必须显式指定 --return none\|required` |
|
|
123
|
+
|
|
124
|
+
要点:**参数校验在提交之前就完成**,三种错法都有明确文案、不静默降级。第二条尤其要写进技能——
|
|
125
|
+
空正文不是"发一条空消息",是直接报错。
|
|
126
|
+
|
|
127
|
+
## 四之四、已确认的事实(群会话加密路径 + 一条 shell 坑,可复算)
|
|
128
|
+
|
|
129
|
+
群:`g-leiliang-5btgok22du.agentid.cn`。
|
|
130
|
+
|
|
131
|
+
| 项 | 结论 |
|
|
132
|
+
|---|---|
|
|
133
|
+
| `ecmsg send ... --encrypt` 投递 | ✅ 成功。回执文本是 `✓ 已发送 message_id=m-2d40... seq=-`,**seq 显示为空**;历史里该条 `encrypt:true`、`transport:{"status":"accepted","seq":13}`。**判据要看 `ec group history`,不能只看回执那一行** |
|
|
134
|
+
| 密文的人类可读性 | ✅ **owner 目视确认可读**("看到文字内容了")。T3 至此全通过 |
|
|
135
|
+
| Git Bash 会改写 `/` 开头的参数 | ⚠️ 我发的 `/effort` 在群历史里存成了 `C:/Program Files/Git/effort`。MSYS 把以 `/` 起头的 token 当路径转换。**用 `ecmsg send` 发 slash 命令时正文必须加引号**,否则被改写成路径 |
|
|
136
|
+
|
|
137
|
+
后一条顺带解释了为什么自发 slash 测不出白名单:既不走命令解析,还可能被 shell 二次改写,双重无效。
|
|
138
|
+
|
|
139
|
+
## 五、群会话待办(下一步照这个跑,跑完把结果写回本节下方)
|
|
140
|
+
|
|
141
|
+
**群 `g-leiliang-g9lpwxdzqy.agentid.cn`**(dddd 在此群是 **admin**,空间里有 `/rules.md` 和 `/blackboard.md`)
|
|
142
|
+
用来补 T4 的读命中和 T5 的 admin 写路径:
|
|
143
|
+
|
|
144
|
+
```bash
|
|
145
|
+
# T4-a 有命中的 find(预期非空)
|
|
146
|
+
ec fs find g-leiliang-g9lpwxdzqy.agentid.cn:/ --name "*.md" --format json
|
|
147
|
+
# T4-b cat 真实文件
|
|
148
|
+
ec fs cat g-leiliang-g9lpwxdzqy.agentid.cn:/blackboard.md
|
|
149
|
+
ec fs cat g-leiliang-g9lpwxdzqy.agentid.cn:/rules.md
|
|
150
|
+
# T5-a admin 写入(预期成功)
|
|
151
|
+
ec fs cp <本地临时文件> g-leiliang-g9lpwxdzqy.agentid.cn:/public/_probe.txt
|
|
152
|
+
# T5-b 清理(不留垃圾)
|
|
153
|
+
ec fs rm g-leiliang-g9lpwxdzqy.agentid.cn:/public/_probe.txt
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
> 注意:`/public` 与 `/memberdata` 是群空间的两个顶层目录,落文件前先 `ls` 确认目标目录存在。
|
|
157
|
+
|
|
158
|
+
**T3 收尾**:密文可读性只能由人类确认 —— 请 leiliang 在自己的前端看一眼那条 `--encrypt` 消息是否正常显示,回一句即可。
|
|
159
|
+
|
|
160
|
+
**T16 路由复核**:群会话在下一轮回复里说明"本轮是否加载了 `ec-group`",作为 description 路由生效的凭据。
|
|
161
|
+
|
|
162
|
+
**跑完写回格式**:在下面"实测回执"里追加,标明命令、exit code、关键输出;自报值(如"我加载了技能")标注不可复算。
|
|
163
|
+
|
|
164
|
+
### 实测回执
|
|
165
|
+
|
|
166
|
+
(群会话在此追加,一行一条,最新在下)
|
|
167
|
+
|
|
168
|
+
- 待跑:T4-a / T4-b / T5-a / T5-b / T16
|
|
169
|
+
|
|
170
|
+
## 六、待澄清
|
|
171
|
+
|
|
172
|
+
1. `group-history` fragment 整段下线还是保留一行指路(T10)。
|
|
173
|
+
2. 非 AUN 群(飞书群)是否要更完整的指引——当前只在技能里声明了适用范围,没有展开飞书群细节。
|
|
174
|
+
|
|
175
|
+
## 七、写入约定
|
|
176
|
+
|
|
177
|
+
```bash
|
|
178
|
+
# 私聊会话与群聊会话都可用(写本机文件)
|
|
179
|
+
cat <包根>/kits/skills/ec-group/TASK.md # 读
|
|
180
|
+
cat >> <包根>/kits/skills/ec-group/WORKLOG.md # 追加流水
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
包根 = `C:\Users\agentcp\AppData\Roaming\Evol\default\workspace\evolcore`(dev 模式)。
|
|
184
|
+
|
|
185
|
+
群会话里额外可用 `ec group history` 补背景;私聊会话里额外可查 ECK 模板与源码。
|
|
186
|
+
两边信息不对称时,**以本文件为准**,不要各自维护一份。
|