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
|
@@ -1,17 +1,65 @@
|
|
|
1
1
|
# ec agent — EvolAgent 生命周期管理
|
|
2
2
|
|
|
3
|
-
管理本机托管的 EvolAgent
|
|
3
|
+
管理本机托管的 EvolAgent(创建、启停、配置、热重载、模板)。触发词:创建/新建/列出/查看/启用/禁用/删除/热重载/改配置/打包模板/收到模板分享/下载模板/安装模板。
|
|
4
4
|
|
|
5
5
|
## Agent 模板
|
|
6
6
|
|
|
7
|
+
本地中文帮助可离线查看:`ec agent template --help` 列出子命令的简短用途、常用流程及通用选项;`ec agent template <子命令> --help`(也支持 `-h`)提供语法、关键参数/默认值、一个短示例与必要下一步。帮助不展开完整 schema 或恢复教程,也不读取输入文件、连接 daemon 或执行模板操作。完整字段与复杂分支查询 `ec agent template capabilities` 返回的 `data.inputSchemas`,模块 include 与 project 索引结构分别见 `data.modules`、`data.selectionIndexSchema`;该查询需要 daemon,不同版本以目标 Host 为准。本节保留安装模式、采集索引、外部联系人与作业恢复的详细说明。
|
|
8
|
+
|
|
9
|
+
`pull` 仅下载和校验,不安装。需要目标主机的 DaemonOwner 权限;权限不足时,通知 Owner 并询问后续操作。
|
|
10
|
+
|
|
11
|
+
| 子命令 | 用途与主要输入 |
|
|
12
|
+
| --- | --- |
|
|
13
|
+
| `inspect` | 按 `module` 盘点 `members` 的 Agent 或目录来源,返回后续采集所需清单 |
|
|
14
|
+
| `collect` | 引用成功 `inspectionJobId`、`inventoryDigest` 和模块 `include`,生成可编辑副本 |
|
|
15
|
+
| `pack` | 用 `metadata` 与 `members[key].collections[].jobId` 组合成功采集副本 |
|
|
16
|
+
| `push` | 将 `packageId` 上传到 `location`;路径须为 `/templates/<id>/<id>-<version>.ectpl` |
|
|
17
|
+
| `list` | `--store AID` 查询仓库,可选 `--kind agent\|team --publisher AID --template-id ID --offset N --limit 1..50` |
|
|
18
|
+
| `detail` | `RELEASE_ID --store AID [--from-version VERSION]` 查看精确发行与组件汇总 |
|
|
19
|
+
| `publish` | `PACKAGE_ID --store AID` 上传到发布者自身 Storage、授权仓库读取并确认发行 |
|
|
20
|
+
| `download` | `RELEASE_ID --store AID --path PATH` 申请本 Host 下载授权,下载到指定路径并校验精确发行 |
|
|
21
|
+
| `pull` | `--input-file FILE [--path PATH]` 下载 Storage 分享,JSON 指定远程 source |
|
|
22
|
+
| `preview` | `--path PATH --install-mode create\|overwrite --member KEY --aid AID`,直接读取本地包,选择目标与本机 Provider |
|
|
23
|
+
| `deploy` | `--preview-id ID --plan-digest DIGEST` 执行同一次可执行预览 |
|
|
24
|
+
| `status` | `JOB_ID` 或 `--request-id ORIGINAL` 二选一查询作业 |
|
|
25
|
+
| `resume` | `JOB_ID` 恢复原可恢复作业 |
|
|
26
|
+
| `cancel` | `JOB_ID` 请求取消并查询恢复结果 |
|
|
27
|
+
| `capabilities` | 无业务参数,查询动作/模块/schema/平台/限制 |
|
|
28
|
+
| `check-update` | `targetAid` 直接返回当前版本与本次仓库检查结果或失败原因,不安装、不提醒 |
|
|
29
|
+
| `upgrade` | `TARGET_AID [--release-id ID]` 发起单 Agent 固定发行升级 |
|
|
30
|
+
|
|
31
|
+
`inspect/collect/pack/push/check-update` 通过 `--input-file FILE` 传入 JSON。已有本地包直接 `preview --path PATH`,无需 pull。远程 Storage 使用 `pull --input-file FILE [--path PATH]`,省略 `--path` 时由 Host 在受管 TMPDIR 分配临时文件。`preview` 只接受命令行参数,不再接受 `--input-file` 或 `--package-id`;Menu 的 preview 使用 path,历史 packageId 输入仍兼容。`--format json` 可省,业务结果默认即为 JSON。除 `status/capabilities/check-update` 外,解析器接受可选的 `--request-id ID` 和 `--wait 0..300`;`check-update` 接受 `--request-id`,直接等待本次检查结果,不接受 `--wait`。`status` 的 `--request-id` 仅表示查询原请求,不能与 JOB_ID 同传。
|
|
32
|
+
|
|
33
|
+
Store 四个命令都要求 `--store`,不接受 `--input-file`。`list/detail` 默认等待30秒,其余动作默认不等待;超时不取消原作业,返回的 jobId 可用 status/resume。`list` 默认每页20项;`releaseId` 是64位小写十六进制精确发行 ID。暂不提供 versions 命令。
|
|
34
|
+
|
|
35
|
+
Store 调用身份由可信入口决定:托管会话使用当前执行 Agent,宿主终端或 Control Menu 使用实际 Host;无需传身份参数,不借用 Owner 身份。远端仍分别检查 Caller 准入与业务权限。`download` 固定发行、摘要、大小和目标 Host,授权过期时 resume 原作业只续取原发行。成功后用 result.path 继续 preview/deploy;普通下载不要求发行已审核或启用升级,也不自动安装。`pull` 只负责普通 Storage 来源,不查询 Store 或替用户申请仓库下载授权。
|
|
36
|
+
|
|
37
|
+
单 Agent 升级沿 template Menu/CLI,要求本地 `version`、`update.key`(原始 Agent AID)、`update.registryAid` 及 `update.mode=manual|auto` 齐全。真实 Owner 使用现有配置入口管理来源和开关;`disabled` 禁止检查/升级,`auto` 只检查提醒。新包不会覆盖本机策略、仓库或原始 key。历史未知来源保持未知,不根据 publisher、Storage 主体或 Host 推断仓库。
|
|
38
|
+
|
|
39
|
+
CLI 升级流程为 `check-update → upgrade → status`。`ec agent template check-update --input-file FILE`(内容 `{"targetAid":"目标AID"}`)直接返回 `data.currentVersion/updateAvailable/target/summary`,其中 target 含固定候选 releaseId;不能检查时返回 `error.code/message` 和经鉴权可读取的当前版本。它查询本次仓库唯一审核且启用的目标及上一发行到目标的组件汇总,保存检查结果,不安装、不向 Owner 或 Agent 会话发送提醒,也不写入新的已通知记录。无需先查本地状态或再查检查作业。CLI `update-status` 已移除。
|
|
40
|
+
|
|
41
|
+
`ec agent template upgrade 目标AID [--release-id 精确发行ID] --request-id 稳定请求ID --wait 300 --format json` 一次发起固定候选升级,随后使用 `status JOB_ID`、`resume JOB_ID` 或 `cancel JOB_ID`。Menu 仍保留 `template` 的 `check-update/upgrade` action 与 `job/update-status` query:Menu 检查继续返回原异步 job(也不发提醒),`update-status` 只读取本地资格、来源、最近检查及 activeJob;内部 `updateStatus` 继续供页面和 CLI 失败结果读取当前版本。升级 action 参数仅 `targetAid` 与可选 `releaseId`。无逐文件 diff 或冲突选项。
|
|
42
|
+
|
|
43
|
+
内置 `__agent-template-upgrade-check` Trigger 默认每日检查,与 Core/npm 检查独立;可按原 Trigger 入口调整周期,启动不覆盖调整。只有后台定时检查发送新版提醒,由目标 Agent 的真实渠道向当前 Owner 主会话发送 notice,成功回执持久去重,失败重试,不调用模型、不自动安装。手动检查保留已有通知回执,不把本次检查记成已通知;之后后台仍检查并发送尚未通知的新版提醒。
|
|
44
|
+
|
|
45
|
+
安装沿原工作门和持久作业备份、应用、验证,提交版本及渲染后 `template.manifest.json`;仅提交后清理摘要匹配旧清单的备份,修改/未知项保留并在结果中列出。旧清单失效时保留全备份,不猜测移除旧资源。
|
|
46
|
+
|
|
47
|
+
仓库下载统一使用 `download RELEASE_ID --store AID --path PATH`。下载和安装不新建独立包缓存或 record.json 索引;临时文件放当前会话 TMPDIR,长期保存主动放项目目录。preview 用同一操作者成功下载作业中的路径及摘要沿用仓库来源;文件移动后不猜测来源。pull 不提供仓库选项。原 file/artifact JSON 可校验原文件并返回路径,不另存副本;历史包索引、作业及 pack/push/publish 的成品机制保留。单 Agent 原始 key 跨安装和再打包保留,作者一个版本一致写入 PACKAGE/team/member。旧方案的绑定、逐文件预览及已读动作已退役。
|
|
48
|
+
|
|
7
49
|
单成员、多成员共用 `ec agent template`。新建支持一个或多个成员,只创建成员 AID,沿用本机 Host 和经鉴权的 Owner;覆盖仅支持一个已有 Agent,保留其 AID、Owner、角色和默认项目目录。打包不带记忆、消息、私钥或 Provider 凭证;导入的 Trigger 默认停用并携带脚本。来源采集和覆盖要求操作者同时是 DaemonOwner 和对应 Agent 的协议 Owner。
|
|
8
50
|
|
|
9
51
|
```bash
|
|
10
52
|
ec agent template inspect --input-file inspect.json --request-id <稳定ID>
|
|
11
|
-
ec agent template
|
|
53
|
+
ec agent template collect --input-file collect.json --request-id <稳定ID>
|
|
54
|
+
ec agent template pack --input-file pack.json --request-id <稳定ID>
|
|
12
55
|
ec agent template push --input-file push.json --request-id <稳定ID>
|
|
13
|
-
ec agent template
|
|
14
|
-
ec agent template
|
|
56
|
+
ec agent template list --store <仓库AID>
|
|
57
|
+
ec agent template detail <releaseId> --store <仓库AID>
|
|
58
|
+
ec agent template publish <packageId> --store <仓库AID> --request-id <稳定ID> --wait 60
|
|
59
|
+
ec agent template download <releaseId> --store <仓库AID> --path '<下载落点绝对路径>' --wait 60
|
|
60
|
+
ec agent template pull --input-file pull.json --path '<下载落点绝对路径>' --request-id <稳定ID>
|
|
61
|
+
ec agent template preview --path '<包的绝对路径>' --install-mode create \
|
|
62
|
+
--default-aid-domain agentid.cn --member writer --aid auto --request-id <稳定ID>
|
|
15
63
|
ec agent template deploy --preview-id <previewId> --plan-digest sha256:<摘要> --request-id <稳定ID>
|
|
16
64
|
ec agent template status <jobId>
|
|
17
65
|
ec agent template status --request-id <原请求ID>
|
|
@@ -20,20 +68,81 @@ ec agent template cancel <jobId> --request-id <本次取消ID>
|
|
|
20
68
|
ec agent template capabilities
|
|
21
69
|
```
|
|
22
70
|
|
|
23
|
-
`
|
|
71
|
+
`capabilities` 返回支持模块、模块 include schema、动作输入 schema、状态及平台能力;CLI 将安装参数转换成同一份业务结构再校验,不提供独立 modules 命令。文件模板沿用 v1 的 `agents[]/key`、PACKAGE/MANIFEST 和资源结构。Core 作业以成员 key 关联,不按数组位置配对。Menu 使用进程级 `name: "template"`,动作与 CLI 一致;查询使用 `args.view: "job"` 或 `"capabilities"`。
|
|
72
|
+
|
|
73
|
+
模板仅安装 `agents[]` 声明的实际成员,不支持可选成员、后装票据或独立 Team 实例登记/发现。`memberReferences` 只接受 `{external:[{aid,name?}]}`;外部联系人保持未知归属,不变为实际成员。主助理和 `open_pa_context` 继续由现有名录机制管理。历史作业、交付和备份不在线迁移或删除。
|
|
74
|
+
|
|
75
|
+
来源 Agent 的 access 访问设置不进入采集副本或新包;旧包中的 access 在安装计划中忽略。新建沿用目标 Host 默认访问设置,覆盖与升级保留目标 Agent 当前访问设置。
|
|
76
|
+
|
|
77
|
+
模板声明 `team.json` 使用 `id` 作稳定标识、`title` 作显示名;旧顶层 `name` 只兼容输入,归一化、导入保存及打包导出均移除该字段。旧 name-only 转为 id;id/name 并存须同值,否则拒绝。旧表单 schema 的 name 约束与 required 迁到 id,不再生成 name 控件,title 保留。`PACKAGE.name` 和请求 `metadata.name` 继续表示显示名,对应 `team.title`;Agent 的 `profile.name`、成员 key 与身份 AID 保持既有语义。示例:`{"name":"demo","title":"演示团队",...}` 读入后为 `{"id":"demo","title":"演示团队",...}`,格式版本仍为 v1。
|
|
78
|
+
|
|
79
|
+
build 指整个制作过程,采集动作为 collect。制作流程:按模块 `inspect → collect → Agent直接阅读分析并修改工作副本 → pack → push`;Menu 页面可直接 collect → pack,不依赖中途调用 Agent。模块为 config/profile/soul/skill/trigger/event/service/project。头像随 profile 的 agent.md 原 URL 保留,welcome 并入 profile;soul 独立,不导出记忆正文。collect 成功只表示采集完成,不表示已经脱敏或封包。工作副本位于 `.template-work/<collectJobId>/`,member.json 是可编辑声明,files/ 是该成员可编辑文件;status 返回副本位置和清单,不在事件里传输正文。
|
|
80
|
+
|
|
81
|
+
inspect 示例:`{"module":"soul","members":{"writer":{"source":{"kind":"agent","aid":"writer.agentid.cn"}}}}`,成功直接 succeeded,不持有采集冻结。collect 示例:`{"module":"soul","inspectionJobId":"job_<uuid>","inventoryDigest":"sha256:<摘要>","freeze":false,"members":{"writer":{"include":{"files":["01-identity.md"]}}}}`。freeze 可省略且默认 false;true 仅采集期间冻结,来源忙碌返回 AGENT_BUSY,失败或取消释放已取得的门,采集完成即释放。默认模式可在活跃会话自打包;显式冻结自己仍会忙碌。
|
|
82
|
+
|
|
83
|
+
config 的 include 为 `{baseagents:[默认基座]}`,采集和封包仅保留 active_baseagent 对应的 Provider/模型/推理强度配置,其他基座不进入新包;profile/project 的 include 为 `{}`;soul 为 `{files:[分册名...]}`;skill/trigger/event/service 分别为 `{skills:[...]}`、`{triggers:[...]}`、`{events:[...]}`、`{services:[...]}`。skill 只采集选中项的开关与资源,不自动附带内置或继承开关;pack 按最终 member.skills 筛选技能资源,preview 安装忽略旧包未声明的多余技能文件。无关字段拒绝。每次只读取本模块所选资源,未选资源变化不让整次制作失败。
|
|
84
|
+
|
|
85
|
+
project 模块 inspect 不返回 resources.files;仅 project 的 collect 必填 selectionIndex 文件引用并拒绝 include.files。目录浏览复用原 file.list。整选目录递归包含新增,部分选择不纳入新增同层文件;删除跳过,修改读取当前内容,非空选择最终无文件报 PROJECT_FILES_EMPTY。索引绑定 inspectionJobId/inventoryDigest/projectRevision,引用含 location/download.shareId/digest/size;允许当前 Owner 或可信执行 Agent 的索引,分享须授权实际来源 Host 读取。统计仍返回 selected/copied/skippedMissing。
|
|
86
|
+
|
|
87
|
+
selectionIndex 引用为 `{location:{aid,path},download:{shareId},digest,size}`,path 为 Storage 绝对路径,size 是实际字节数,digest 为 `sha256:` 加 64 位小写十六进制。文件为 UTF-8 JSON:`{schemaVersion:1,inspectionJobId,inventoryDigest,members:{成员key:{projectRevision,entries:[{path,type}]}}}`;entries 的 path 为项目相对路径,type 为 file/directory。索引最多 8 MiB、每成员最多 20000 项;字段校验以 `capabilities` 的 `selectionIndexSchema` 为准。
|
|
88
|
+
|
|
89
|
+
脱敏由 Agent 阅读和编辑副本完成,没有 scan-report/review-scan、发现项决定或 artifact 管理命令。pack 输入示例:`{"metadata":{"id":"writer","name":"写作助理","version":"1.0.0","platforms":["linux"]},"members":{"writer":{"collections":[{"jobId":"job_<config>"},{"jobId":"job_<profile>"},{"jobId":"job_<soul>"}]}}}`。每个实际成员必须有 config/profile,其他模块可选;只能组合相同来源、相同成员 key 的成功 collect。pack 使用修改后的副本,重新计算摘要,不比对原采集摘要;验证模块路径边界、结构和依赖后持久保存封包快照,resume/replay 沿用该快照。push 仅接受最终 packageId/location,不再接受 releasedFindings。
|
|
90
|
+
|
|
91
|
+
每次 inspect/collect/pack/push 各有独立 jobId:collect 引用 inspect 的 inspectionJobId;pack 的 members[key].collections 引用成功 collect 的 jobId;push 使用 pack 成功返回的 packageId。App 收到回执即保存 ID,通过 template.job/query 跟踪各模块状态、phase 和错误;选用模块未全部成功前不进入 pack,失败只重做相关模块。采集上报 loading_selection/validating_selection(project)、acquiring/releasing(可选冻结)、collecting、validating、collected;封包上报 assembling/validating/sealing/completed,不承诺百分比或快速阶段逐一送达。
|
|
92
|
+
|
|
93
|
+
pack 复用资源文本凭证检测,命中返回 SENSITIVE_CONTENT 及文件路径/行号,不返回正文。凭证、结构、大小、平台或完整性等校验错误 failed/resumable=false,修改副本或重采集后新 pack;未知执行故障仍可按原快照恢复。Owner Storage 原流程保持:App 使用 Owner SDK 授予 Host 目录 rw,push 指定 Owner AID,由 Host 按授权上传,再由 App 使用 Owner SDK 分享。
|
|
24
94
|
|
|
25
|
-
|
|
95
|
+
托管 Agent 可将最终包 push 到自身 AID 的 Storage,由真实执行 Agent 连接上传;执行身份从委派上下文取得,不能自报 AID 借用他人连接。显式上传到 Owner 空间仍由 Host 上传并需要相应目录读写授权。私有分享使用 `ec storage share <当前AgentAID> --input-file FILE --format json`,JSON action=create/list/revoke/status,create 明确 allowedAids 为接收方实际 Host。pull 的 source 带 location、download.shareId 和 digest。模板签名仍未提供。
|
|
26
96
|
|
|
27
|
-
|
|
97
|
+
`publish PACKAGE_ID --store AID` 接收一个位置参数和仓库选项,不接受 `--input-file`;可选 `--request-id/--wait/--format json`。身份按可信执行入口自动确定;pack 顶层可选 `publisherIdentity=agent|host`,由 Core 写入相应 PACKAGE.publisher.aid,省略仍保留原操作者署名。publish 要求声明与真实 Caller 一致,不修改包字节。单 Agent metadata 仍明确填写,不在本功能内自动继承或接受空值。
|
|
28
98
|
|
|
29
|
-
|
|
99
|
+
publish 自动上传发布者自身 Storage、创建仅仓库可读的一小时授权、加密提交 `services.templates.publish` 并查询 status。仓库须准入实际发布者;succeeded 表示发行 ID、版本、摘要、大小及仓库位置已核实,结果含 serviceJobId/releaseId/location 和实际审核/升级状态。phase 为 validating/uploading/granting/submitting/waiting_registry/completed。未知结果 paused/resumable 后恢复原 jobId,保留原 operationId/source/仓库任务;提交仓库后禁止 cancel,提交前取消保留已上传对象和原期限授权。Menu 使用相同 action 与 `{packageId,storeAid}`,由真实 Host 调用;旧 Menu 参数与持久作业继续兼容。Owner Storage 原 push/分享流程保持。
|
|
30
100
|
|
|
31
|
-
|
|
101
|
+
`push.location.aid` 指定 Storage 所有者,不是分享接收方或模板仓库投稿目标。目标为非执行 Agent 自身的 AID 时,实际上传者是本机 Host;目标需对 Host 授予模板目录 `rw`,不能只给执行 Agent 授权。push 先权威读取已有对象再上传,拒绝时 error.details 标明 stage、uploaderAid、location 和可用的 upstreamCode。status 查到 failed 时退出码 1 表示原作业失败;权限修正后用新 requestId 和原 packageId 再 push,无需重做 collect/pack。
|
|
102
|
+
|
|
103
|
+
Agent 给接收方分享可沿“自身 push → storage share create 授权接收方 → 通用 fs setfacl 授权其直接 Host subaid → ecmsg 发送 v2 agent.template.share 卡片”。模板技能用通用 ACL JSON 表达 Ownership direct、card.type=[host]、perms=r,按 Storage 动态归属判权;无须枚举 Host。接收方短码放 recipient_download,Host 安装用条件 ACL 按 location/digest pull,不把接收方短码当作 Host 授权。两项都成功才发卡片,撤销也分别处理。Owner Storage 原流程及指定 Host 短码方式保留;卡片字段与发送命令见 agent-template-project 技能。
|
|
104
|
+
|
|
105
|
+
CLI preview 必填 `--path`、`--install-mode create|overwrite`,每成员用 `--member KEY --aid AID`。可重复 `--member`,其后的 `--aid`、`--project`、模型和冲突选项都归属当前成员;同成员同字段重复或成员选项出现在首个 `--member` 前会报错。模型选择用 `--provider 基座=ID --model 基座=MODEL`,可选 `--effort 基座=VALUE`;`--effort 基座=null` 清除显式强度。preview 根据 active_baseagent 匹配并校验对应 Provider/model,不使用 providers 首项;兼容旧包中存在的其他基座配置,不因其不可用阻断默认基座。外部映射用可重复的 `--external-aid 原AID=目标AID`。技能冲突用 `--skill-resolution 技能名=overwrite|skip`,随后必填本次技能的 `--current-digest sha256:... --incoming-digest sha256:...`;切换成员后须重新选择技能,不沿用前一个成员的选择。
|
|
106
|
+
|
|
107
|
+
远程 Menu 传 path、installMode 和成员 key → target/providers/externalAids/skillResolutions。新建输入示例:`{"path":"/workspace/writer.ectpl","installMode":"create","defaultAidDomain":"agentid.cn","members":{"writer":{"target":{"aid":"auto"},"providers":{"ecagent":{"provider":"provider-12345678","model":"model-a"}}}}}`。历史 packageId 预览仍兼容。CLI 的 `--aid auto` 对应顶层 `--default-aid-domain`,不接受 `issuer`;模板 Host 配置的对应字段是 `host.config.aun.defaultAidDomain`。新建可省略 `--project`,由目标 Host 按默认项目根目录和最终 AID 分配不重名目录;显式目录须为目标 Host 绝对路径。实际目录在 result.members[key].target.project 返回并持久保存,deploy/resume 不重新分配。覆盖仅支持单个已有 AID,须传其当前默认项目目录,不允许 auto/defaultAidDomain。平台及 Provider/model/effort 不匹配仅提示,模型配置优先回退到本机可用值;缺少可用配置可继续安装,运行是否就绪以 readiness 为准。预览不注册身份;只有 executable=true 才能把同次 previewId 和非空 planDigest 交给 deploy,计划有效期 1 小时。预览保存源路径和摘要及冻结计划,不保存 source.ectpl 副本;应用前校验原包,丢失需重下相同文件,内容变化需重做预览。多成员必须全部新建,不提供已有成员配对。旧版 0.0.49 仍要求 project,以所选 Host 的 capabilities 输入 schema 为准,不能按开发机状态推定远端支持。参数错误保留具体字段及原因,不归类为模板不支持。
|
|
108
|
+
|
|
109
|
+
异步命令默认 `--wait 0`,可设 0..300 秒,超时不取消作业。退出码 0 表示成功或未等待的已受理/进行中,不代表异步执行完成;失败/取消/通信或业务错误为 1、参数错误为 2、paused 或 `--wait>0` 返回时仍 queued/running/cancelling 为 3。作业型命令的 requestId 是请求关联与幂等键,同 ID 不可变更参数;jobId 是持久执行 ID。回执丢失先 `status --request-id ORIGINAL`,已知作业则 `status JOB_ID`;确认 resumable 后以 `resume JOB_ID` 恢复原作业,不用新部署请求重试未知结果。packageId 是封包句柄,previewId/planDigest 标识冻结安装计划,releaseId 是 64 位小写十六进制发行 ID;升级的 targetAid 是本机目标,update.key 则保留模板原始 Agent AID,两者不混用。Menu 事件统一为 `template.job`,seq 单调递增;状态包括 queued/running/paused/failed/cancelling/cancelled/succeeded。
|
|
110
|
+
|
|
111
|
+
模板 Provider/模型/推理强度是建议值,显式选择优先。建议不可用时回退目标 Host 同基座的默认配置(覆盖优先目标 Agent 本地配置,升级保留可用的当前 Provider);默认强度也不可用则清除显式值,使用模型默认。预览的 `members[key].models` 返回 `suggested/selected/reasons`,`warnings` 解释替换原因。只有显式选择无效或本机仍缺可用配置才列入 `unresolved`。回退结果写入冻结计划,deploy 验证同一最终配置;配置改变须重新预览。
|
|
32
112
|
|
|
33
113
|
成员注册和 Owner 绑定使用随包的 `scripts/aid-batch/identity-batch.mjs`,持久检查点保存原操作与收据;Owner 待确认时暂停,恢复不重复注册或绑定。全组准备并验证后才提交并开放任务;取消保留已创建身份。覆盖失败恢复本次实际写入的文件与名片,恢复未确认时保持目标暂停。
|
|
34
114
|
|
|
35
115
|
工具随包位于 `scripts/agent-template/`;本机 CLI 经控制令牌 IPC,托管 CLI 经原委派通道,Menu 发往 Host Control AID。远端 Menu 不读取任意本机路径。Provider 模型通过进程级 model Menu 的 catalog 查询;作业 readiness 分别表示运行、名录和团队就绪,不以本地成员表代替 Owner 名录授权。接口细节及当前验收边界见 `docs/agent-template/agent-template-app-integration.md`。真实容器已验证注册/绑定/Storage/恢复及覆盖;App 界面、真实模型推理和名录互聊待验收。
|
|
36
116
|
|
|
117
|
+
## 本机项目地址变更
|
|
118
|
+
|
|
119
|
+
项目文件单次复制并保留源目录,迁移原基座会话、保留原 AID、话题和 session/thread ID。关联 Agent 由用户多选,默认仅当前 Agent;未选中者继续使用旧目录。Core、CLI、Menu 和 ECWeb 共用 Agent 应用服务。
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
ec agent project <aid> preview --target '<新绝对目录>' [--agents '<aid1>,<aid2>'] [--format json]
|
|
123
|
+
ec agent stop <aid> [--format json]
|
|
124
|
+
ec agent project <aid> move --target '<新绝对目录>' [--agents '<aid1>,<aid2>'] [--format json]
|
|
125
|
+
ec agent project <aid> status [--format json]
|
|
126
|
+
ec agent project <aid> resolve --conflict '<status返回的conflict.id>' --decision skip|abort [--format json]
|
|
127
|
+
ec agent start <aid> [--format json]
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
只有 preview/move 接受 --target 和 --agents;不传 --agents 为仅入口 aid。所选 Agent 须逐个显式停止。preview 不持久化计划;move 重新检查并在所选 Agent 独占门内执行。普通项目增删改不触发追平;同一实际原生文件到同一目标只复制一次。连接超时不取消操作,按 Agent 查询 status。
|
|
131
|
+
|
|
132
|
+
status 返回 currentStep、totalSteps=7、currentPhase、steps、updatedAt;阶段依次为 checking/freezing/preparing/copying/sessions/committing/finalizing。冲突为 awaiting_decision,说明原因、资源和依赖范围,用户选择 skip 或 abort。skip 不会跳过必需原生文件后继续更新其绑定;abort 恢复本次核心修改,保留源目录和普通项目副本。异常中断或恢复未完成时使用:
|
|
133
|
+
|
|
134
|
+
```bash
|
|
135
|
+
ec agent project <aid> recover [--format json]
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
recover 只继续恢复旧绑定,不执行用户任务;独立修改无法撤销时保持 paused 并阻止启动。成功迁移或恢复后仍保持停止,由用户显式启动。跳过整个 Agent 且恢复完成后解除它的迁移限制。停止/启动复用原生命周期入口。
|
|
139
|
+
|
|
140
|
+
Menu 使用 name=agent、action=project,args 为 aid、operation;preview/move 另传 target 和可选 aids 数组;resolve 传 conflictId、decision=skip|abort。远端请求须加密,并核验 DaemonOwner、入口 Agent 和每个所选 Agent 的新鲜 Owner 共识;托管 CLI 保留原委派 IPC。
|
|
141
|
+
|
|
142
|
+
ECWeb:Agent 列表 → 编辑 → 变更项目地址。显示新地址、Agent 多选、预览、步骤 x/7、阶段及结果。冲突显示“跳过”“终止迁移”;paused 显示“恢复旧绑定”。关闭页面不代答,重开恢复选择与冲突。停止/启动在原操作菜单完成;Evol App 原生页面按相同接口接入。
|
|
143
|
+
|
|
144
|
+
配置仅修改有关字段,索引按对应记录更新,第三种值或分叉历史不覆盖。目标冲突、核心文件变化、共享记录不能同时表达新旧路径等均明确提示跳过范围。完整流程、参数、Menu 示例与验证见[实施与用法](../../../docs/agent-template/agent-project-path-implementation.md),十类不能自动合并的情况见[修订说明](../../../docs/agent-template/agent-project-path-revision.md)。跨操作系统/跨 Host 实机续接另行验收。
|
|
145
|
+
|
|
37
146
|
## 子命令
|
|
38
147
|
|
|
39
148
|
```bash
|
|
@@ -94,6 +203,9 @@ ec agent disable <aid>
|
|
|
94
203
|
ec agent get <aid> <key>
|
|
95
204
|
ec agent set <aid> <key> <val>
|
|
96
205
|
|
|
206
|
+
# 关闭激活欢迎(不影响设定引导)
|
|
207
|
+
ec agent set <aid> enableWelcome false
|
|
208
|
+
|
|
97
209
|
# 读取或保存 Bootstrap 中 Agent 自主准备的 welcome 文案
|
|
98
210
|
ec agent welcome show
|
|
99
211
|
ec agent welcome --text '<完整 Markdown 文案>'
|
|
@@ -145,7 +257,7 @@ ec agent delete <aid> [--purge]
|
|
|
145
257
|
- `ec agent welcome --text <text>` 用于保存 Bootstrap 中 Agent 自主准备的完整正式文案,不要求 Owner 起草、审稿或确认;命令固定写入当前 Agent 的 `$PERSONAL_DIR/welcome.md`,不接受自定义路径。`welcome show` 读取该文件。
|
|
146
258
|
- welcome 托管写入要求当前 Agent 私聊 Owner;admin 仅可读。模板上限 4 KiB,渲染上限 8 KiB;变量为 `agentName`、`agentDescription`、`agentAid`、`agentTags`、`agentTagsText`、`ownerName`、`ownerAid`、`channel`,支持标签循环和真值条件。写入保留原始文本,投递不附加额外文案。
|
|
147
259
|
- `agent show <target-aid>` 与 `agent get <target-aid> <key>` 的跨 Agent 读取对 owner/admin 开放,但普通 Agent 角色只获得安全摘要;敏感配置值和物理路径仅对 DaemonOwner 返回原值。跨 Agent 写入、启停、删除和 reload 仍遵循各自的目标与 DaemonOwner 权限边界。
|
|
148
|
-
- Agent 配置可包含 `fullaccess.enabled`(默认关闭),作为全局开关;开启后对符合条件的私聊直接生效,局部 `/fa on|off` 不改变全局授权。Menu 写入全局开关要求请求者同时是目标 Agent Owner 与 daemon Owner。关闭全局开关时,私聊 `/fa on|off` 管理当前作用域:主会话写 relation 配置并跨 EC session/backend 续接保留,话题会话写自身 session metadata;`/fa <任务信息>` 或 `/fullaccess <任务信息>` 则由 daemon Owner 发起一次性 fullaccess 任务,不改变会话开关。群聊不支持。实际运行时逐次复核相应 Owner 授权、会话绑定和 Runner fullaccess 能力;Trigger
|
|
260
|
+
- Agent 配置可包含 `fullaccess.enabled`(默认关闭),作为全局开关;开启后对符合条件的私聊直接生效,局部 `/fa on|off` 不改变全局授权。Menu 写入全局开关要求请求者同时是目标 Agent Owner 与 daemon Owner。关闭全局开关时,私聊 `/fa on|off` 管理当前作用域:主会话写 relation 配置并跨 EC session/backend 续接保留,话题会话写自身 session metadata;`/fa <任务信息>` 或 `/fullaccess <任务信息>` 则由 daemon Owner 发起一次性 fullaccess 任务,不改变会话开关。群聊不支持。实际运行时逐次复核相应 Owner 授权、会话绑定和 Runner fullaccess 能力;Trigger 不会因该开关自动提权。(这里指已存在的 Trigger 不会被自动升级;**该开关提供的是创建/修改 fullaccess Trigger 的资格**,在有效期内设置的 Trigger 会记录批准人,关闭开关后仍按批准链运行。详见 trigger.md「提权到 fullaccess」。)经 daemon 验证的 fullaccess 任务可进入原本由托管 CLI 顶层白名单拒绝的命令,并可通过受管文件入口访问 H-Class 路径;当前会话承载的 EvolCore 实例仍受生命周期保护。
|
|
149
261
|
|
|
150
262
|
## 创建 Agent
|
|
151
263
|
|
|
@@ -171,9 +283,19 @@ EC Web 有两个独立入口:`action: create` 沿用 Bootstrap 流程(与 `-
|
|
|
171
283
|
|
|
172
284
|
## Bootstrap 通知状态与重试
|
|
173
285
|
|
|
286
|
+
设定引导与激活欢迎是两个阶段:
|
|
287
|
+
|
|
288
|
+
- 设定引导使用随包模板 `kits/templates/bootstrap-intro.md`,用于询问职责、名字等。
|
|
289
|
+
- 激活欢迎在设定完成后发送,正文使用 `personal/welcome.md` 或 `--initialize` 的内置文案。
|
|
290
|
+
Agent 配置 `enableWelcome` 控制是否发送,默认 `true`;设为 `false` 不影响设定引导。
|
|
291
|
+
- 模板仅在 `create` 新建安装整体提交后逐成员投递激活欢迎;覆盖安装和升级不投递。原作业的 `result.welcome` 返回各成员处理结果;欢迎投递失败不影响已提交的安装,待发消息沿用持久 outbox,准备失败可通过原作业 `status` 恢复。
|
|
292
|
+
- 旧字段 `bootstrapWelcome` 在读取时兼容为 `enableWelcome`,下次保存时只写新字段;
|
|
293
|
+
显式布尔值保持不变,未配置时不补写默认值。新旧字段同时存在且值冲突时拒绝读取或保存。
|
|
294
|
+
该开关不控制 IM 首次交互欢迎或好友申请通过后的欢迎。
|
|
295
|
+
|
|
174
296
|
交互式 Bootstrap 的 `ready` 要求有效的 `personal/welcome.md`:缺失返回 `WELCOME_REQUIRED`,损坏返回 `WELCOME_INVALID`,均保持 Bootstrap 状态。已准备 completion outbox 后修改文案返回 `WELCOME_FROZEN`。
|
|
175
297
|
|
|
176
|
-
`--initialize` 模式不产生也不需要 `welcome.md`:它的欢迎文案由 daemon
|
|
298
|
+
`--initialize` 模式不产生也不需要 `welcome.md`:它的欢迎文案由 daemon 用内置模板按最终名片渲染,取名片 frontmatter 的 `name` 作为身份、`description` 作为职责,不写死能力清单;`ec agent welcome --text` 在这种目标上会返回 `INVALID_LIFECYCLE`。同一份默认模板也用于 IM 渠道的首次交互欢迎。
|
|
177
299
|
|
|
178
300
|
`ready` 成功表示 Agent 已进入 `active`;欢迎消息单独返回在 `welcome.deliveries`,每位 Owner 一项:
|
|
179
301
|
|
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# ec aid — AID 身份管理
|
|
2
2
|
|
|
3
|
+
## 本机 Claude Code 网关
|
|
4
|
+
|
|
5
|
+
Claude 网关是将 AUN 消息投递到本机终端会话的入口,不是新的 baseagent。消息在
|
|
6
|
+
MessageBridge 分流,不进入普通 message-queue 或 ResponseEngine,也不加载模型 runner。
|
|
7
|
+
本机终端自身的授权及执行环境继续生效。
|
|
8
|
+
|
|
9
|
+
默认关闭。宿主 Owner 可显式设置 `ec config set ccAgent.enabled true --process`,
|
|
10
|
+
由宿主重新启动 EvolCore 后初始化网关身份。未启用时不自动注册 AID;已有网关身份也不自动删除。
|
|
11
|
+
初始化必须确认网关与 daemon 的协议 Owner 一致,不能把“已提交绑定请求”视为已就绪。
|
|
12
|
+
|
|
13
|
+
仅接受同时拥有本机与网关的 Owner 在加密设备私聊中操作。绑定按本端、Owner、设备、
|
|
14
|
+
Ownership 版本和话题隔离。主话题先选本机会话,之后的消息投递给该会话;发送“列表”可重新查看。
|
|
15
|
+
网关只回传新出现的 assistant 文本,不重放历史或工具输入;Owner 变化、关闭开关或会话解绑后停止回传。
|
|
16
|
+
|
|
3
17
|
管理本地 AID 身份(证书、私钥、agent.md 名片与头像),以及远程探测对端 AID。触发词:身份/证书/名片/头像/换头像/探测对端/创建身份。
|
|
4
18
|
|
|
5
19
|
## 运行边界
|
|
@@ -29,7 +43,7 @@ ec aid transfer <subAid> <newOwnerAid> --subject <当前OwnerAID> [--format json
|
|
|
29
43
|
ec aid bind accept <operationId> [--subject <本地AID>] [--format json]
|
|
30
44
|
ec aid bind reject <operationId> [--reason '<原因>'] [--subject <本地AID>] [--format json]
|
|
31
45
|
ec aid agentmd put <当前 self AID> [--format json]
|
|
32
|
-
ec aid agentmd set <当前 self AID> <name|type|description|version|tags|exttype> <value> [--format json]
|
|
46
|
+
ec aid agentmd set <当前 self AID> <name|type|description|version|tags|exttype|visibility> <value> [--format json]
|
|
33
47
|
ec aid avatar <当前 self AID> (--file <path> | --url <https-url>) [--format json]
|
|
34
48
|
```
|
|
35
49
|
|
|
@@ -43,7 +57,7 @@ ec aid avatar <当前 self AID> (--file <path> | --url <https-url>) [--format js
|
|
|
43
57
|
|
|
44
58
|
`ec init --non-interactive --owner <aid> --format json` 首先按普通 host 类型注册控制 AID,
|
|
45
59
|
完成主机名片和配置落盘后,通过独立 `ownership-UUID` slot 的短连接调用 SDK `bindOwneraid` 发起邀约。
|
|
46
|
-
该注册调用不等待人工审批、不启动 daemon
|
|
60
|
+
该注册调用不等待人工审批、不启动 daemon;`--owner` 只作为本次邀约目标,不写入 `daemon.json`——控制 Owner 只由 ownership 协议授予。
|
|
47
61
|
SDK 不持久化 Ownership task/WAL;`OwnershipTaskResult` 只是本次调用结果。
|
|
48
62
|
提交后应以当前 NS 状态和 `checkOwnershipConsensus` 为准,不依赖重启后恢复相同 operation ID。
|
|
49
63
|
|
|
@@ -121,9 +135,12 @@ SDK 的 `transferLocalSubaid` 完成本地三身份编排;否则调用 `transf
|
|
|
121
135
|
|
|
122
136
|
## Ownership 共识缓存
|
|
123
137
|
|
|
124
|
-
Agent
|
|
138
|
+
Agent 的 Owner 只由 ownership 协议授予,配置中的 owner 字段不作为授权来源。
|
|
139
|
+
|
|
140
|
+
本机 Daemon Owner 可在该 Agent 的 AUN 私聊中发送纯 `/bind`,由 Agent
|
|
125
141
|
以发送者 AID 发起协议 ownership 绑定。带参数的 `/bind feishu [实例名]` 等仍是外部渠道联系人绑定,
|
|
126
|
-
不会修改 ownership
|
|
142
|
+
不会修改 ownership;非 Daemon Owner 不能使用纯 `/bind` 代替手动绑定,须由 Daemon Owner 在宿主端
|
|
143
|
+
为该 Agent 指定绑定目标。
|
|
127
144
|
|
|
128
145
|
Ownership 共识不再每 15 秒轮询。普通消息、控制消息、查询和路由读取复用最长 30 分钟的共识结果;敏感授权、审批授权兑现、初始化激活及高权限执行使用同一结果,但要求核验时间不超过 5 分钟。读取不会延长缓存有效期,到期本身不会发请求;需要结果的异步调用在过期后等待刷新。控制通道的配对和诊断命令按敏感操作使用 5 分钟窗口。
|
|
129
146
|
|
|
@@ -167,7 +184,21 @@ Agent 展示通过 `knownOwner/knownOwners` 读取关系快照,详情另返回
|
|
|
167
184
|
|
|
168
185
|
托管会话中的本地图片必须位于当前会话项目目录或本会话的托管 `$TMPDIR`;相对路径以会话项目目录为基准。不能读取受保护的 EvolCore 路径、符号链接,或托管临时目录中的硬链接。
|
|
169
186
|
|
|
170
|
-
|
|
187
|
+
当前对端发来的图片和文件落盘在 agent 级附件目录,按月分目录:
|
|
188
|
+
|
|
189
|
+
```
|
|
190
|
+
$AGENT_DIR/attachments/<YYYY-MM>/<原始文件名>
|
|
191
|
+
$AGENT_DIR/attachments/index/<peerKey>.jsonl ← 归属索引(谁是发送方、何时、sha256)
|
|
192
|
+
$AGENT_DIR/attachments/index/sha256/<前2位>.jsonl ← 内容反查索引
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
- 一个月一个目录,本月收发的本体都在当月目录下。
|
|
196
|
+
- 同名不同内容会在同月目录里加 `-1`、`-2` 编号;不同名但内容相同的文件复用同一份本体。
|
|
197
|
+
- 归属信息在 `index/<peerKey>.jsonl`,**不再有同名 `.json` sidecar 文件**。要确认某张图是谁发的、什么时候发的,按文件名去对应的 peerKey 索引里查。
|
|
198
|
+
|
|
199
|
+
要拿某张图当头像,先把文件复制到当前项目目录或本会话 `$TMPDIR`,再把复制后的路径传给 `--file`;`--file` 只接受这两处路径。非正方形或超过 500 KiB 的图片会自动补白边、缩放并压缩成 JPEG。
|
|
200
|
+
|
|
201
|
+
历史消息里的路径是 `$AGENT_DIR/…` 别名,使用前先按 `[venue]` 段的 AGENT_DIR 值展开。
|
|
171
202
|
|
|
172
203
|
上传复用 menu 的头像处理流程:校验图片、上传到 AUN storage、更新并发布 `agent.md` 的 `avatar` 字段,成功后发出 `agent:avatar_updated` 事件。无需手动修改名片或再次执行 `agentmd put`。托管 Agent 只能修改自身头像,仍需通过角色与命令授权检查。
|
|
173
204
|
|
|
@@ -192,7 +223,7 @@ ec aid lookup <aid>
|
|
|
192
223
|
# agent.md 名片:签名上传 / 下载验签
|
|
193
224
|
ec aid agentmd put <aid>
|
|
194
225
|
ec aid agentmd get <aid>
|
|
195
|
-
ec aid agentmd set <aid> <name|type|description|version|tags|exttype> <value>
|
|
226
|
+
ec aid agentmd set <aid> <name|type|description|version|tags|exttype|visibility> <value>
|
|
196
227
|
ec aid avatar <aid> (--file <path> | --url <https-url>)
|
|
197
228
|
ec aid bind <ownerAid> [--subject <subjectAid>] [--local-control]
|
|
198
229
|
ec aid transfer <subAid> <newOwnerAid> --subject <currentOwnerAid> [--local-control]
|
|
@@ -206,6 +237,8 @@ ec aid delete <aid>
|
|
|
206
237
|
|
|
207
238
|
## 证书续期
|
|
208
239
|
|
|
240
|
+
`ec aid agentmd set <aid> visibility private` 会更新并签名发布名片的可见性字段。该字段接受 `public`、`unlisted` 或 `private`。
|
|
241
|
+
|
|
209
242
|
在独立宿主终端执行 `ec aid cert renew <aid>`,复用 SDK 的 `AIDStore.renewCert()`,
|
|
210
243
|
使用原私钥完成挑战签名,再将服务端签发的新证书保存到 `AIDs/<aid>/public/cert.pem`。
|
|
211
244
|
不会生成新密钥、重新注册 AID、修改 Owner 或发布 `agent.md`。托管 Agent 会话不能执行;
|
|
@@ -192,6 +192,96 @@ ConfigManager 只合并上述物理层并返回物理来源。角色策略不进
|
|
|
192
192
|
- Agent 和 defaults 均未设置模型时,Claude/Codex 回落到本机 CLI 配置;再缺省时使用 runner 的内置默认模型。推理强度按同一层级逐字段回落。
|
|
193
193
|
- 只有当前 Agent 的 owner / admin(或 DaemonOwner)可以写模型参数。
|
|
194
194
|
|
|
195
|
+
### Agent 自动压缩阈值(Claude Code / Codex / DSH)
|
|
196
|
+
|
|
197
|
+
每个 Agent 在自己的 `config.json` 配置 `baseagents.<baseagent>.autoCompactThresholdTokens`,
|
|
198
|
+
单位 tokens,必须是正的安全整数。该字段只读
|
|
199
|
+
Agent 文件,不从 defaults 或 relation 继承,也没有 schema 默认值。
|
|
200
|
+
|
|
201
|
+
```json
|
|
202
|
+
{
|
|
203
|
+
"baseagents": {
|
|
204
|
+
"claude": { "autoCompactThresholdTokens": 550000 },
|
|
205
|
+
"codex": { "autoCompactThresholdTokens": 1000000 }
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
字段不存在时,Claude 保留旧 `--autocompact` 参数及任务开始前的检查。Codex
|
|
211
|
+
按真实 Provider 窗口传入模型容量,并用 258400 作为压缩窗口。设置的 `autoCompactThresholdTokens`
|
|
212
|
+
只控制压缩窗口,不改变模型的真实上下文容量。
|
|
213
|
+
删除字段后,Claude 后续任务重新走原生策略;Codex 后续 turn 使用代码默认压缩阈值 258400。
|
|
214
|
+
读取新字段不会创建或自动补写配置。
|
|
215
|
+
|
|
216
|
+
显式配置后,窗口优先使用当前 Provider 对当前模型返回的 `context_window`;缺失或无效时
|
|
217
|
+
Codex 采用 258400,Claude 使用原 runner 的保守窗口兜底。其他 Provider 的价格参考目录不参与
|
|
218
|
+
窗口解析。Codex 在线程配置中同时下发真实的 `model_context_window` 与独立的
|
|
219
|
+
`model_auto_compact_token_limit`,
|
|
220
|
+
涵盖新建、恢复、分叉和压缩前恢复,不修改 `~/.codex/config.toml`。容量按网关声明下发,不用
|
|
221
|
+
本地模型表的较小值覆盖;运行时实际报告的窗口仍单独保留,原生预留可能使它小于下发值。
|
|
222
|
+
|
|
223
|
+
Claude 原生参数表示压缩窗口,并非精确触发点。当前适配按 Claude Code 2.1.300 的
|
|
224
|
+
`min(max_output_tokens, 20000) + 13000` 预留换算,受原生参数 100K–1M 和显式模型窗口后缀限制。
|
|
225
|
+
例如最大输出不少于 20K 时,配置 550000 会下发 583000;百万模型可表达的最高触发估计为
|
|
226
|
+
967000。工具结果、原生估算及 CLI 版本可能影响实际时点,不能作为严格请求 token 上限。
|
|
227
|
+
显式配置会覆盖自动压缩窗口和百分比的环境变量覆盖;未配置时保留这些原生行为。
|
|
228
|
+
配置超过能力范围会记录 `adjusted` 和实际采用值;正在执行的任务不被中途修改。
|
|
229
|
+
|
|
230
|
+
DSH 在恢复会话并取得写入权后、接收本轮输入前检查原生上下文用量,达到阈值便调用原生压缩。
|
|
231
|
+
默认采用 EvolCore 的预压缩阈值,已知窗口时为 `min(550000, 窗口 - 预留)`,预留为窗口的 5%,最多 10000。
|
|
232
|
+
执行时阈值受当前模型的实际窗口约束。DSH 原生会在运行中的模型步骤之间继续处理上下文压力及超限恢复,
|
|
233
|
+
有可能先于上述阈值触发。
|
|
234
|
+
|
|
235
|
+
Owner 通过原生 Agent 级 Menu 读写配置,由服务端直接调用配置管理代码,不执行 CLI。
|
|
236
|
+
先查询(也支持 `menu.query` 的 queries 批量和 catalog values 批量):
|
|
237
|
+
|
|
238
|
+
```json
|
|
239
|
+
{
|
|
240
|
+
"type": "menu.query",
|
|
241
|
+
"id": "context-codex",
|
|
242
|
+
"name": "context-policy",
|
|
243
|
+
"args": { "scope": "agent", "baseagent": "codex" }
|
|
244
|
+
}
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
再把响应 `data.revision` 原样传入更新请求。`value` 是 tokens 整数,不是字符串;
|
|
248
|
+
`baseagent` 在写入时必填,可选择 `claude`、`codex` 或 `dsh`:
|
|
249
|
+
|
|
250
|
+
```json
|
|
251
|
+
{
|
|
252
|
+
"type": "menu.update",
|
|
253
|
+
"id": "context-codex-set",
|
|
254
|
+
"name": "context-policy",
|
|
255
|
+
"args": {
|
|
256
|
+
"scope": "agent",
|
|
257
|
+
"baseagent": "codex",
|
|
258
|
+
"expectedRevision": "<查询返回的 revision>"
|
|
259
|
+
},
|
|
260
|
+
"value": 1000000
|
|
261
|
+
}
|
|
262
|
+
```
|
|
263
|
+
|
|
264
|
+
恢复默认时使用同一更新协议,将 `value` 设为 `null`,并使用最新的 `revision`。
|
|
265
|
+
服务端会删除该字段,返回重新计算的代码默认值;不会把默认值写回配置。
|
|
266
|
+
更新只修改目标 Agent 对应后端的阈值,保留其他配置;旧 revision 或查询期间模型切换返回
|
|
267
|
+
`CONFLICT`,调用方需重新查询。成功返回完整策略、新 `revision`、`changed` 和
|
|
268
|
+
`effectiveFrom: "next-turn"`。超出能力范围的正整数仍保存原值,并返回 `adjusted` 与实际采用值。
|
|
269
|
+
|
|
270
|
+
Menu catalog 提供 `contextPolicy.claude`、`contextPolicy.codex` 和 `contextPolicy.dsh`。缺少文件配置时仍返回
|
|
271
|
+
`autoCompactThresholdTokens` 的代码默认值及 `thresholdSource: "code-default"`,不返回空阈值;
|
|
272
|
+
Codex 未配置时默认展示 258400;这是压缩窗口,不是模型上下文窗口。
|
|
273
|
+
`mode: "legacy"` 表示 Agent 没有显式压缩阈值;Codex 仍会向线程下发真实模型窗口和 258400 默认压缩阈值。
|
|
274
|
+
同时返回 `gatewayContextWindowTokens`、`contextWindowTokens`、`executionContextWindowTokens`、`contextWindowSource`、
|
|
275
|
+
`minConfigurableThresholdTokens`、`maxConfigurableThresholdTokens`、配置原值、实际采用阈值及原生参数。
|
|
276
|
+
网关字段缺失返回 null,兜底窗口单列。CC 还返回 `estimatedNativeTriggerTokens`,区分旧窗口参数
|
|
277
|
+
与原生触发估计。Codex 同时查询当前 Agent、模型、Provider 匹配的最近一次 turn 记录:
|
|
278
|
+
`runtimeAutoCompactTokens` 是运行记录里的 Codex 压缩阈值(旧记录缺少该字段时使用历史默认值),`runtimeAutoCompactRecordedAt` 是记录时间(Unix 毫秒),
|
|
279
|
+
`runtimeStatus: "last-model-call"` 表示历史记录,并非当前实时探测。该记录只作运行诊断,不覆盖网关返回的真实模型上下文窗口,
|
|
280
|
+
也不把压缩窗口误当模型容量;无匹配记录时诊断字段返回 null,
|
|
281
|
+
状态为 `not-observed-by-this-query`。历史运行窗口不限制显式配置时的网关容量,保存配置也不会
|
|
282
|
+
把新容量伪装成已运行的窗口;恢复默认时不复用带显式阈值的历史运行记录。
|
|
283
|
+
该 Menu 仅允许当前 Agent Owner 读写,不支持跨 Agent 自指、options 或 action。
|
|
284
|
+
|
|
195
285
|
### Codex 用户提问
|
|
196
286
|
|
|
197
287
|
`baseagents.codex.enableRequestUserInput` 走 defaults → agent 覆盖,默认 `true`;relation 层不承载 `baseagents`。
|
|
@@ -307,7 +397,11 @@ Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行,不会
|
|
|
307
397
|
- **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled` 缺失时关闭。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner。私聊中的 `/fa`、`/fa on`、`/fa off` 管理当前 EC 会话;主会话写 Agent 配置,话题会话写 session metadata。`/fa <任务信息>` / `/fullaccess <任务信息>` 执行一次性 fullaccess 任务,不改变会话开关;群聊拒绝。每次 Runner 执行仍复核相应 Owner 授权、会话绑定和 fullaccess 能力;CLI 和托管任务不能直接 set/unset Agent fullaccess。Fullaccess Trigger 使用独立的持久授权链。经 daemon 验证的 fullaccess 任务可绕过托管 CLI 顶层白名单和 H-Class 文件入口限制,但当前会话承载的 EvolCore 生命周期保护、参数校验和文件完整性校验仍生效。
|
|
308
398
|
- **源码诊断白名单**:`readonlySourceDiagnostics` 默认关闭;开启后只读会话仅可在项目源码目录执行受限、可证明只读查询,配置/证书/快照/session/锁文件仍禁止访问
|
|
309
399
|
- **基座 skill 总开关**:`baseagentSkills` 默认关闭,设为 `true` 统一开放;仅 Agent 级、仅 owner 可写(`ec config set`,Menu 协议经 `name=cli action=exec` 传同一 argv,ECWeb 编辑 Agent 抽屉),对所有基座统一生效(Claude 的 Skill 工具、Codex 的 skills);关闭时 `/capability` 的 skill 策略不可修改。它不影响 EC 技能,EC 技能用 `ec skill enable/disable` 管理
|
|
310
|
-
|
|
400
|
+
`/capability` 查询同时返回 `baseagentSkillsEnabled`,各类型的 `support` 为 `supported / unsupported / unavailable`,
|
|
401
|
+
表示基座原生扩展管理的支持状态;`supportReason` 保留该层原因,`canUpdate` 表示当前开关条件下能否修改策略。
|
|
402
|
+
ECWeb 将关闭的 Skill 显示为“已关闭”;开启后继续依据基座支持状态显示“可配置”“不支持配置”或“未接入管理”。
|
|
403
|
+
“可配置”指设置继承、全部启用/关闭及单项启用策略,不表示升级版本。未保存的开关修改只展示预览。
|
|
404
|
+
- **仅人可写**:channels / admins / 凭证 / aid / enabled / projects / aun
|
|
311
405
|
- Agent 托管环境写仅人字段被拒
|
|
312
406
|
|
|
313
407
|
**操作权限**:
|
|
@@ -26,7 +26,8 @@ H 类拒绝保留 `policyCode=h_class_protection`、`executed=false` 和原始
|
|
|
26
26
|
|
|
27
27
|
- `/loop`:查看持久开关及待执行的单次提示词;回显为单行,不显示会话 ID。
|
|
28
28
|
- `/loop on [seconds]`:开启持久闲置触发,默认 300 秒,可设 30–86400 秒;每次普通任务结束后重新计时。
|
|
29
|
-
- `/loop
|
|
29
|
+
- 空闲时,`/loop <提示词>` 先提交提示词,入队成功后执行 `/loop on`。任务结束后按默认 300 秒开始计算闲置时间。
|
|
30
|
+
- 忙碌时,`/loop <提示词>` 安排在会话连续闲置 300 秒后执行该提示词一次。
|
|
30
31
|
- 新的单次提示词替换上一条待执行提示词;已有任务运行或新任务到达时,从任务结束后重新计时。
|
|
31
32
|
- `/loop off`:关闭持久触发并取消尚未入队的单次提示词;已经开始的任务不受影响。
|
|
32
33
|
- 持久开关按主会话 `relation-main` / 独立话题 `topic-session` 存储;单次请求始终只绑定发起时的确切会话。
|
|
@@ -163,22 +163,19 @@ $AGENT_DIR/skills/.index-local.md 本机技能索引
|
|
|
163
163
|
|
|
164
164
|
---
|
|
165
165
|
|
|
166
|
-
## 5.
|
|
166
|
+
## 5. 路径:技能目录写成 `{{skillDir}}`
|
|
167
167
|
|
|
168
168
|
EC **不会把 cwd 设到技能目录**(runner 拉起 base agent 时 cwd 固定为项目目录,且 Claude Code 的
|
|
169
|
-
Bash 工具没有 cwd
|
|
169
|
+
Bash 工具没有 cwd 参数),所以正文里的脚本路径必须是绝对路径。
|
|
170
170
|
|
|
171
|
-
|
|
171
|
+
技能目录要引用的地方,一律写成 `{{skillDir}}`,`ec skill load` 输出时替换成本机技能目录的
|
|
172
|
+
绝对路径(统一正斜杠;旧写法 `<技能目录>` 同样处理):
|
|
172
173
|
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
根目录: <该组的真实绝对路径>
|
|
176
|
-
技能目录 = 根目录 + 路径分隔符 + 技能名
|
|
177
|
-
SKILL.md = 技能目录 + 路径分隔符 + "SKILL.md"
|
|
178
|
-
执行脚本时必须写完整绝对路径。
|
|
174
|
+
```bash
|
|
175
|
+
node "{{skillDir}}/scripts/foo.mjs"
|
|
179
176
|
```
|
|
180
177
|
|
|
181
|
-
|
|
178
|
+
正文因此不含任何本机路径,换机器、换安装位置都不用改。
|
|
182
179
|
|
|
183
180
|
配套硬要求:**脚本内部必须用自身位置定位资源,不能依赖 cwd**。
|
|
184
181
|
|
|
@@ -2,7 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
## 源码归属
|
|
4
4
|
|
|
5
|
-
宿主侧 ECWeb 集成集中在 `src/ecweb/`:`runtime/supervisor.ts` 负责守护与恢复调度,`runtime/lifecycle.ts` 负责退出确认和重启就绪校验,`runtime/launch.ts` 负责启动入口及版本兼容检查,`pairing.ts` 负责配对 IPC、访问链接和提示文案。通用跨平台进程工具仍留在 `src/utils
|
|
5
|
+
宿主侧 ECWeb 集成集中在 `src/ecweb/`:`runtime/supervisor.ts` 负责守护与恢复调度,`runtime/lifecycle.ts` 负责退出确认和重启就绪校验,`runtime/launch.ts` 负责启动入口及版本兼容检查,`pairing.ts` 负责配对 IPC、访问链接和提示文案。通用跨平台进程工具仍留在 `src/utils/`。
|
|
6
|
+
|
|
7
|
+
仓库根目录的 `ecweb/` 是独立 npm 包 `ec-web`,包含 HTTP 服务、静态页面和 IPC 客户端,拥有独立的依赖和构建配置。EvolCore 依赖该包,仓库的 `npm run build` 会分别构建宿主与 Web 包。
|
|
8
|
+
|
|
9
|
+
`src/ecweb/contracts/` 存放宿主侧的实例登记和握手契约。`ecweb/src/` 声明客户端的最低协议要求,并校验宿主的握手响应。两端通过协议兼容,Web 包无需导入宿主源码。
|
|
6
10
|
|
|
7
11
|
新建 ECWeb 代理默认使用 `visibility: public`,初始化与设置页面保持一致。显式配置的 `private`、`aun-auth` 以及关闭设置均保留;迁移旧版配置时继续保留原有访问策略。此字段用于 AUN 代理注册,ECWeb 的配对与 token 鉴权独立生效。
|
|
8
12
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Trigger Event Catalog
|
|
2
2
|
|
|
3
3
|
本目录用于编写 `source.type = "event"` 的 trigger 时按需查阅。最终事实源是
|
|
4
|
-
`$PACKAGE_ROOT/src/core/event-bus.ts` 的 `GatewayEvent` 类型;本文只做面向 trigger
|
|
4
|
+
`$PACKAGE_ROOT/src/core/event/event-bus.ts` 的 `GatewayEvent` 类型;本文只做面向 trigger
|
|
5
5
|
作者的事件索引和使用约定。
|
|
6
6
|
|
|
7
7
|
## Event Source 规则
|
package/kits/docs/evolcore/fs.md
CHANGED
|
@@ -10,6 +10,8 @@
|
|
|
10
10
|
|
|
11
11
|
无 `:` 的路径是本地路径。操作者身份用 `--as <aid>`,agent 会话内通常由 `EVOLCORE_SELF_AID` 注入,可省略。
|
|
12
12
|
|
|
13
|
+
托管会话同样支持 `cp` 上传、单文件下载和同目标远程复制。下载目标限当前项目或当前会话 `$TMPDIR`,相对路径按会话项目解析;传入已有目录时使用远端路径的文件名。默认不覆盖,显式 `--overwrite` 才覆盖普通文件;拒绝越界路径、符号链接文件和硬链接文件。下载会重新读取并校验 SHA-256,无需先生成下载链接。个人空间仍限当前 Agent(当前私聊对端仅可 `cat`),群空间仍限当前群,远端权限不变。
|
|
14
|
+
|
|
13
15
|
## 已实现命令
|
|
14
16
|
|
|
15
17
|
```bash
|
|
@@ -55,11 +57,11 @@ ec fs umount <AID>:<path> # 卸载挂载点
|
|
|
55
57
|
- `--head-bytes <n>`:`cat` 二进制头部字节数,默认 256
|
|
56
58
|
- `--visibility public|private`:`chmod` 可见性
|
|
57
59
|
- `--allow-roles <roles>`:`chmod` 角色约束,写法固定为单引号包住、逗号分隔,如 `--allow-roles 'owner,admin'`
|
|
58
|
-
- `-m aid:<aid>:<perms>` / `-x aid:<aid>`:`setfacl`
|
|
60
|
+
- `-m aid:<aid>:<perms>` / `-x aid:<aid>`:`setfacl` 增删单个 AID 的 ACL;也支持下述通用 ACL JSON
|
|
59
61
|
- `--source <AID>:<path>` / `--volume <id>`:`mount` 来源
|
|
60
62
|
- `--expires <time>`:`mount/token/ACL` 过期时间,Unix 秒或 ISO 日期
|
|
61
63
|
- `--require-approval`:挂载需要来源 owner 审批
|
|
62
|
-
- `--max-uses <n>`:ACL
|
|
64
|
+
- `--max-uses <n>`:ACL 最大使用次数,0表示不限;ACL 的 `--expires 0` 表示不过期
|
|
63
65
|
- `--max-reads <n>`:访问 token 最大读取次数
|
|
64
66
|
- `--readonly` / `--readwrite`:挂载为只读或读写
|
|
65
67
|
- `--name <glob>` / `--type <f|d|l>`:`find` 名称或类型过滤
|
|
@@ -90,6 +92,50 @@ ec fs ls g-team.agentid.pub:/archive/
|
|
|
90
92
|
ec fs cp ./weekly.md g-team.agentid.pub:/archive/weekly.md
|
|
91
93
|
```
|
|
92
94
|
|
|
95
|
+
## 通用 ACL
|
|
96
|
+
|
|
97
|
+
个人空间的 `setfacl -m` 接受与 Storage RPC 同形的 JSON;`-x` 接受相同主体选择器。
|
|
98
|
+
本地 CLI 与托管 Agent 共用解析和执行逻辑,原 `aid:<aid>[:<perms>]` 写法保留。
|
|
99
|
+
|
|
100
|
+
| 字段 | 说明 |
|
|
101
|
+
|---|---|
|
|
102
|
+
| `grantee_aid` | 单个指定 AID |
|
|
103
|
+
| `grantee_aids` | 非空 AID 数组,去重并保留首次顺序 |
|
|
104
|
+
| `subject` | 条件主体;与上面两项必须且只能选一种 |
|
|
105
|
+
| `subject.ownership.owner_aid` | 按该 Owner 当前声明匹配 sub;Owner 本身不属于 sub |
|
|
106
|
+
| `subject.ownership.scope` | `direct`(默认)或 `descendants` |
|
|
107
|
+
| `subject.card.type` / `exttype` | 可选的非空字符串数组;同属性内 OR,属性之间及 Ownership 与名片之间 AND |
|
|
108
|
+
| `perms` | 设置时必填,`r/w/x` 可组合;删除时不能传 |
|
|
109
|
+
| `expires_at` | Unix 秒,0不过期;也可用 `--expires <Unix秒或ISO日期>` |
|
|
110
|
+
| `max_uses` | 非负整数,0不限;也可用 `--max-uses`。条件规则共享计数,具体 AID 分别计数 |
|
|
111
|
+
|
|
112
|
+
JSON 与命令行不能重复指定同一有效期或次数字段;删除不接受权限、有效期或次数。
|
|
113
|
+
省略限制字段沿用 Storage 的默认及更新语义,需要清除旧限制时显式传0。
|
|
114
|
+
目标所有者和路径始终来自 `<AID>:<path>`,JSON 不接受 owner_aid/path/bucket 等路由字段。
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
# 批量授权
|
|
118
|
+
ec fs setfacl sender.agentid.cn:/reports -m '{"grantee_aids":["reader.agentid.cn","worker.agentid.cn"],"perms":"rw","expires_at":0,"max_uses":0}' --format json
|
|
119
|
+
|
|
120
|
+
# 条件授权:接收方名下的直接 Host subaid 可读取此模板文件
|
|
121
|
+
ec fs setfacl sender.agentid.cn:/templates/writer/writer-1.0.0.ectpl -m '{"subject":{"ownership":{"owner_aid":"recipient.agentid.cn","scope":"direct"},"card":{"type":["host"]}},"perms":"r","expires_at":0,"max_uses":0}' --format json
|
|
122
|
+
|
|
123
|
+
# 查询、撤销同一条件规则
|
|
124
|
+
ec fs getfacl sender.agentid.cn:/templates/writer/writer-1.0.0.ectpl --format json
|
|
125
|
+
ec fs setfacl sender.agentid.cn:/templates/writer/writer-1.0.0.ectpl -x '{"subject":{"ownership":{"owner_aid":"recipient.agentid.cn","scope":"direct"},"card":{"type":["host"]}}}' --format json
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
设置与删除分别调用 `storage.set_acl/remove_acl`,查询沿用 `storage.list_acl`。
|
|
129
|
+
Storage 动态核验 Owner 声明及可信名片,客户端不能自报名片属性。路径是前缀授权,作用于该路径及子路径;
|
|
130
|
+
模板分享选完整包文件路径,其他场景可选目录。普通私有对象的指定 AID 下载分享继续使用 `ec storage share create`,
|
|
131
|
+
不要把具体 AID ACL 的 authoritative 读取权限与分享短码下载混为一谈。
|
|
132
|
+
|
|
133
|
+
仅在回执的目标、路径、主体及已指定的权限/限制匹配后返回成功,批量操作必须有完整且不重复的逐项回执。
|
|
134
|
+
`ACL_RESULT_UNKNOWN` 或通信中断不表示写入未发生,先 `getfacl` 核实再决定下一步,CLI 不自动重试写入;
|
|
135
|
+
批量存储异常可能已完成部分项目。删除回执中的 removed=false 表示对应规则原本不存在。
|
|
136
|
+
托管 Agent 只可用当前任务身份管理自身个人空间;授权内容进入权限判断和审计,不能用 `--as` 切换身份。
|
|
137
|
+
群空间继续使用 `-m role:member:rw`、`-m role:admin:<perms>` 或 `-x role:<role>`,不接受个人空间 JSON 和限制字段。
|
|
138
|
+
|
|
93
139
|
## 路由规则
|
|
94
140
|
|
|
95
141
|
CLI 读取目标 AID 的 `agent.md`:
|
|
@@ -137,7 +183,7 @@ ec fs cat <current-peer-aid>:/data/directories/v1/agents/manifest.json --authori
|
|
|
137
183
|
|
|
138
184
|
- `ln -s` 只在 personal storage 创建软链;group fs facade 暂无 symlink 接口。
|
|
139
185
|
- `chmod` 只映射到 personal storage 的 `setVisibility`;group fs facade 暂无 chmod/setVisibility 接口。
|
|
140
|
-
- `setfacl/getfacl
|
|
186
|
+
- `setfacl/getfacl` 同时支持个人空间和群空间;群空间使用既有角色 ACL。`token/approve/reject` 仅接 personal storage。
|
|
141
187
|
- personal storage 的 `mv` 仅支持同 owner;跨 owner 请先 `cp` 再 `rm`。
|
|
142
188
|
- personal/group 混合远程 `cp/mv` 不支持;请先下载到本地再上传。
|
|
143
189
|
|