evolcore 0.0.50 → 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 +39 -2
- package/bin/ec-build.mjs +60 -0
- package/bin/ecmsg.js +65 -63
- package/dist/ability/caller/command.js +24 -15
- package/dist/ability/caller/contract.js +24 -9
- package/dist/ability/caller/credential-files.js +132 -0
- package/dist/ability/caller/daemon.js +32 -7
- package/dist/ability/caller/schema-view.js +157 -0
- package/dist/ability/caller/service.js +202 -63
- package/dist/ability/interop-v1.js +156 -113
- package/dist/agent-template/jobs.js +14 -110
- package/dist/agent-template/runtime.js +331 -193
- package/dist/agent-template/service.js +1029 -1104
- package/dist/agent-template/share.js +103 -0
- package/dist/agent-template/tool-runner.js +25 -0
- package/dist/agent-template/types.js +10 -3
- 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} +74 -158
- 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} +648 -382
- 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 +55 -10
- package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
- package/dist/aun/ability-device-routing.js +11 -17
- package/dist/aun/aid/agentmd.js +27 -1
- package/dist/aun/aid/managed-operation.js +6 -4
- package/dist/aun/group/invite-service.js +1 -1
- 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/p2p.js +6 -6
- 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 +180 -43
- 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/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
- package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
- package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
- package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
- package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
- package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
- package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
- package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
- package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
- package/dist/cli/ability-command.js +8 -5
- package/dist/cli/ability-output.js +182 -0
- package/dist/cli/agent-command.js +1 -1
- package/dist/cli/agent-create.js +123 -42
- package/dist/cli/agent-template.js +400 -29
- package/dist/cli/agent.js +14 -11
- package/dist/cli/aun-commands.js +167 -111
- package/dist/cli/daemon-commands.js +38 -8
- 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 +55 -19
- package/dist/cli/fs-command.js +67 -39
- package/dist/cli/index.js +25 -11
- package/dist/cli/init.js +124 -29
- package/dist/cli/managed-command-guard.js +2 -0
- package/dist/cli/model.js +1 -1
- package/dist/cli/restart-monitor.js +2 -2
- package/dist/cli/services-command.js +24 -1
- 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 +3 -2
- package/dist/cli/trigger-command.js +47 -12
- package/dist/cli/watch-logs.js +2 -1
- package/dist/config/boot-log.js +3 -0
- package/dist/config/builtin-role-templates.js +1 -1
- package/dist/config/config-field-policy.js +10 -6
- package/dist/config/config-manager.js +33 -12
- package/dist/config/gateway-config.js +21 -37
- package/dist/config/invoke-ipc-service.js +1 -1
- package/dist/config/owner-config.js +5 -3
- package/dist/config/peer-book-store.js +2 -3
- package/dist/config/peer-book.js +2 -2
- package/dist/config/peer-role-resolver.js +2 -2
- 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 +39 -15
- package/dist/config/providers-import.js +3 -3
- package/dist/config/providers-management.js +74 -99
- package/dist/config/schema-migration.js +177 -11
- package/dist/config/schema-registry.js +1 -1
- package/dist/config-store.js +38 -50
- package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -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} +102 -25
- package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
- package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
- package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
- package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
- package/dist/core/auth/agent-delegation.js +1 -8
- package/dist/core/auth/delegation-authorization.js +28 -0
- package/dist/core/auth/operation-authorizer.js +7 -4
- package/dist/core/auth/operation-catalog.js +34 -5
- 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} +62 -6
- package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
- package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
- 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 +79 -30
- 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} +18 -18
- package/dist/core/command/agent-control.js +60 -15
- package/dist/core/command/agent-template-menu.js +21 -9
- package/dist/core/command/agentmd-menu-request.js +19 -8
- package/dist/core/command/agentmd-menu.js +14 -5
- 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 +80 -20
- package/dist/core/command/menu-handler.js +305 -25
- package/dist/core/command/menu-protocol.js +42 -8
- package/dist/core/command/menu-query-batch.js +9 -5
- 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 +127 -96
- package/dist/core/command/team-workspace-team.js +3 -3
- package/dist/core/command/topic-slash.js +10 -10
- package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
- package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
- package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
- package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
- package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
- 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 +1 -1
- 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 +54 -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 +1 -1
- package/dist/core/memory/consolidation-trigger.js +9 -3
- package/dist/core/memory/consolidation.js +4 -4
- 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 +114 -75
- package/dist/core/message/aun-request-registry.js +13 -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} +4 -4
- 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 +135 -54
- package/dist/core/message/message-queue.js +83 -4
- package/dist/core/message/message-utils.js +1 -1
- package/dist/core/message/peer-mode.js +1 -1
- package/dist/core/message/response-engine.js +347 -163
- package/dist/core/message/send-options.js +9 -6
- package/dist/core/message/send-routing.js +45 -109
- 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 +14 -3
- package/dist/core/model/model-diagnostics.js +4 -4
- package/dist/core/ownership/owner-resolver.js +95 -15
- package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -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 +70 -34
- package/dist/core/permission/managed-file.js +234 -0
- package/dist/core/permission/protected-paths.js +56 -0
- package/dist/core/permission/sandbox-runtime.js +267 -3
- package/dist/core/permission/session-path-grants.js +1 -1
- package/dist/core/permission/shell-environment.js +15 -1
- package/dist/core/plugin/plugin-lifecycle.js +442 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
- package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
- 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 +29 -2
- 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 +1 -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/ipc-operation.js +2 -2
- package/dist/core/thread/thread-operation.js +2 -1
- package/dist/core/thread/thread-route.js +5 -3
- package/dist/core/thread/thread-service.js +14 -4
- 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 +1 -1
- package/dist/eck/manifest-engine.js +64 -2
- package/dist/eck/message-renderer.js +35 -0
- package/dist/ecweb/basic-settings-service.js +9 -3
- 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 +1 -1
- 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 +71 -42
- package/dist/ipc.js +103 -10
- 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 +12 -0
- package/dist/pay/command.js +1 -1
- package/dist/pay/runtime.js +18 -10
- package/dist/response-system/engines/v1/proactive-flow.js +1 -1
- package/dist/services/dispatcher.js +2 -2
- package/dist/services/host/main.js +10 -1
- package/dist/services/host/protocol.js +9 -2
- package/dist/services/host/resident.js +37 -0
- package/dist/services/host-client.js +12 -0
- package/dist/services/host-recycle.js +8 -3
- package/dist/services/host-runtime.js +54 -15
- package/dist/services/index.js +83 -19
- package/dist/services/ipc-operation.js +303 -38
- package/dist/services/pack-manager.js +2 -2
- package/dist/services/router.js +43 -3
- package/dist/services/script-runner.js +34 -25
- package/dist/services/service-payload.js +28 -1
- package/dist/services/validation.js +28 -2
- 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 +3 -2
- package/dist/trigger/authorization.js +36 -33
- package/dist/trigger/ipc-service.js +4 -4
- package/dist/trigger/local-files.js +8 -176
- package/dist/trigger/manager.js +2 -2
- package/dist/trigger/parser.js +48 -0
- package/dist/trigger/scheduler.js +14 -2
- package/dist/trigger/script-executor.js +21 -0
- package/dist/trigger/script-sandbox.js +57 -243
- package/dist/trigger/system-definitions.js +25 -0
- package/dist/trigger/validation.js +1 -1
- 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 +1 -1
- package/dist/utils/logger.js +3 -1
- package/dist/utils/media-cache.js +99 -4
- package/dist/utils/startup-trace.js +20 -4
- package/dist/utils/welcome.js +64 -20
- 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 +1 -1
- package/kits/docs/channels/feishu.md +1 -1
- package/kits/docs/evolcore/INDEX.md +10 -7
- package/kits/docs/evolcore/agent-create.md +2 -0
- package/kits/docs/evolcore/agent.md +100 -13
- package/kits/docs/evolcore/aid.md +19 -3
- package/kits/docs/evolcore/config.md +94 -0
- 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 +3 -3
- package/kits/docs/evolcore/memory-consolidation.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +24 -2
- package/kits/docs/evolcore/model.md +9 -1
- package/kits/docs/evolcore/msg.md +30 -28
- package/kits/docs/evolcore/pay.md +8 -20
- package/kits/docs/evolcore/plugin.md +74 -0
- package/kits/docs/evolcore/provider.md +8 -2
- package/kits/docs/evolcore/rpc.md +2 -2
- 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 +19 -10
- package/kits/docs/evolcore/tool-authorization.md +4 -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/02-navigation.md +20 -13
- package/kits/rules/06-channel.md +18 -2
- package/kits/schemas/_meta.json +8 -4
- package/kits/schemas/agent-config.schema.23.json +19 -3
- 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.11.json +487 -0
- package/kits/schemas/daemon.schema.12.json +505 -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 +8 -2
- package/kits/skills/.switches.json +4 -0
- package/kits/skills/ability/SKILL.md +194 -27
- package/kits/skills/ability/STRUCTURE.md +5 -0
- package/kits/skills/agent-output-cards/SKILL.md +90 -54
- 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 +3 -3
- package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
- package/kits/skills/ec-identity/SKILL.md +9 -6
- package/kits/skills/ec-pay/SKILL.md +163 -41
- package/kits/skills/ec-provider/SKILL.md +5 -5
- package/kits/skills/ec-service-call/SKILL.md +3 -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 +2 -2
- 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/system-fragments/commands.md +1 -1
- package/kits/templates/system-fragments/personal-assistant.md +2 -2
- package/kits/templates/system-fragments/reply.md +14 -9
- package/kits/templates/system-fragments/session.md +1 -1
- package/kits/templates/system-fragments/thread.md +10 -5
- package/package.json +6 -5
- package/scripts/agent-template/index.mjs +7 -1
- package/scripts/agent-template/inspect.mjs +81 -35
- package/scripts/agent-template/overlay.mjs +110 -4
- package/scripts/agent-template/shared/common.mjs +36 -4
- 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 +467 -54
- package/scripts/agent-template/shared/template-contract.mjs +70 -68
- package/scripts/agent-template/shared/template-package.mjs +153 -36
- package/scripts/agent-template/shared/template-runtime.mjs +76 -64
- package/scripts/agent-template/shared/template.mjs +11 -46
- package/scripts/agent-template/team-pack.mjs +451 -35
- package/scripts/agent-template/team-preview.mjs +75 -226
- package/scripts/aid-batch/identity-batch.mjs +1 -1
- package/dist/agents/baseagent-availability.js +0 -176
- package/dist/agents/baseagent-capability-adapter.js +0 -102
- package/dist/agents/baseagent-plugin-loader.js +0 -145
- package/dist/agents/baseagent.js +0 -816
- 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/skills/ec-pay/references/pay-cli.md +0 -110
- /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
- /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
- /package/dist/{agents/claude-gateway → claude-gateway}/types.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,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agent-template-project
|
|
3
|
+
description: >-
|
|
4
|
+
Agent 模板的采集打包、上传分享、发布到平台仓库、下载安装、升级恢复。
|
|
5
|
+
收到模板分享,或用户要求制作模板、给自己打包、整理模板资料、分享已有模板、发布模板到平台仓库、安装模板、检查模板更新或恢复模板作业时使用。
|
|
6
|
+
不用于普通项目开发、记忆导出、跨 Host 身份迁移或 EvolCore/npm 本身升级。
|
|
7
|
+
license: MIT
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Agent 模板操作入口
|
|
11
|
+
|
|
12
|
+
复用 `ec agent template`、Storage、文件授权、消息和平台仓库 service。按任务只读对应分册,不默认全部加载。
|
|
13
|
+
|
|
14
|
+
收到模板分享后,读取摘要和原始卡片附件,不自动下载或安装。
|
|
15
|
+
|
|
16
|
+
## 按任务进入
|
|
17
|
+
|
|
18
|
+
| 用户目标 | 必读文档 | 起点与完成结果 |
|
|
19
|
+
| --- | --- | --- |
|
|
20
|
+
| 制作模板、自打包、整理资料 | [采集和打包](references/01-collect-and-pack.md) | 来源与模块 → 可编辑副本 → 最终 packageId/digest |
|
|
21
|
+
| 上传、分享已有包、撤销分享 | [上传和分享](references/02-upload-and-share.md) | packageId 或已有 Storage 对象 → 上传/授权/发卡回执 |
|
|
22
|
+
| 收到模板分享 | [下载和安装](references/03-download-and-install.md) | 读取摘要和原始卡片附件 |
|
|
23
|
+
| 发布到平台仓库 | [发布到平台仓库](references/05-publish-to-platform.md) | 最终包与仓库 AID → 上传/读取授权 → publish → status 确认发行 |
|
|
24
|
+
| 下载、安装、覆盖现有 Agent | [下载和安装](references/03-download-and-install.md) | 下载 → 预览 → 部署 → 检查,按分册中的固定版式反馈 |
|
|
25
|
+
| 检查更新、升级、失败续作 | [升级和恢复](references/04-upgrade-and-recovery.md) | 已安装 Agent 或原作业 ID → 固定发行升级/原作业恢复 |
|
|
26
|
+
|
|
27
|
+
路径相对于加载回执的 `skillDir`,读取时拼成绝对路径;已有包可从第二或第三部分开始。
|
|
28
|
+
|
|
29
|
+
## 共用规则
|
|
30
|
+
|
|
31
|
+
1. 制作前先读已有打包确认清单,沿用适用的选择和授权;首次或有变化时与用户确定用途、来源和具体范围,按第一册持久保存。当前 Owner 已明确要求四轮确认时,必须按第一册分四次逐轮询问、每轮等答后记录,再进入下一轮;不得合并询问或把未答当作同意。每次按来源 Agent 记录其本次选择,后续只沿用仍适用的已确认项。上传前确定 Storage 归属,分享前确定接收方;未指定期限默认72小时,接收方短码与 Host ACL 期限对齐,明确约定的期限优先,仅补问缺项或变化。
|
|
32
|
+
2. 先查目标 Host 的 `ec agent template capabilities`;短用法查 `<动作> --help`。远程走该 Host 的受鉴权 template Menu,以其版本/schema 为准。
|
|
33
|
+
如果返回 `DAEMON_OWNER_REQUIRED`,向当前 Agent 的 Owner 汇报来源、进度和阻塞,请 Owner 在与其 Agent 的私聊中发起所需操作;该会话仍须核验 Owner 是否为目标主机的 DaemonOwner。若不是,由目标主机 DaemonOwner 发起。不要在原 Agent-Agent 会话中重复重试。
|
|
34
|
+
3. 临时文件放当前会话 `$TMPDIR`,长期包主动放项目目录。已有 `.ectpl` 直接 `preview --path PATH`。Storage 分享用 `pull --input-file FILE [--path PATH]`,省略 `--path` 时由 Host 在受管 TMPDIR 分配临时文件。仓库发行统一使用 `download RELEASE_ID --store AID --path PATH`,成功后直接 preview,无需再 pull。下载和安装不建立独立包缓存/索引;pack/push/publish 保留原有成品和 packageId 机制。仓库统一用 `--store AID`;身份按当前可信入口自动确定,详见下载和发布分册。
|
|
35
|
+
4. 保存各阶段 requestId/jobId/结果,成功后再进入依赖步骤。退出码 0 可能只表示受理;按 status/phase/seq 跟踪,异常见第四部分。
|
|
36
|
+
5. 只编辑采集副本,不改来源;排除记忆、会话、私钥、Provider 凭证及运行数据。按第一册逐类判断删除、变量替换、样例化或保留,保存处理约定;pack 检测不能代替内容分析。
|
|
37
|
+
6. Agent 代办优先使用当前执行 Agent 自身 Storage,Owner Storage 主要通过 Evol App 完成;已有明确归属直接沿用。对外上传、分享或发布前,按第二册完成最终包与对外范围的 Owner 确认。上传、授权、消息回执分别核验。消息走当前会话 delegated sender。
|
|
38
|
+
|
|
39
|
+
inspect/collect/pack/push 与远程 pull 的 CLI 通式(替换动作、文件名和独立请求 ID):
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
ec agent template <动作> --input-file "$TMPDIR/agent-template/<动作>.json" --request-id '<本次请求ID>' --format json
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## 交付口径
|
|
46
|
+
|
|
47
|
+
按实际阶段报告已封包/上传/授权/消息受理/安装,附摘要、位置、对应 ID 和未完成项。收到分享不自动安装;安装、升级按用户授权执行,消息成功不代表安装成功。
|
|
48
|
+
|
|
49
|
+
平台仓库发布以业务任务 `state=completed` 且 `ok=true` 为准,交付真实 releaseId、版本、摘要和仓库位置。
|
|
50
|
+
|
|
51
|
+
通用命令参考:`$KITS_DOCS/evolcore/agent.md`、`$KITS_DOCS/evolcore/storage.md`、`$KITS_DOCS/evolcore/fs.md`。按当前包根解析文档路径,内置和本机覆盖安装使用同一份命令文档。
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
# 采集和打包
|
|
2
|
+
|
|
3
|
+
入口:[SKILL.md](../SKILL.md)。本册生成最终包,已有包转[上传和分享](02-upload-and-share.md)。
|
|
4
|
+
|
|
5
|
+
## 1. 与用户明确用途和来源
|
|
6
|
+
|
|
7
|
+
先读取下节约定的已有打包确认清单,沿用仍适用的决定;首次制作再了解模板给谁用、用于什么任务、复用哪些能力和资料,以及本次只制作本地包还是还需上传/分享。支持当前或同 Host Agent、schema 支持的模板目录;Agent 采集须通过操作者的 DaemonOwner 与来源 Agent 协议 Owner 核验。
|
|
8
|
+
|
|
9
|
+
用户只说“帮我打包”时,不默认所有模块和整个项目全选。先根据用途提出建议,用实际候选补齐下节清单;已有明确选择和授权直接沿用。
|
|
10
|
+
|
|
11
|
+
每个实际成员必须采集 config/profile,其余按需选择,不强制包含 project:
|
|
12
|
+
|
|
13
|
+
| 模块 | 内容与 collect 的 include |
|
|
14
|
+
| --- | --- |
|
|
15
|
+
| config | 行为配置、默认基座的 Provider/模型/推理强度引用;`{baseagents:[默认基座]}`,不打包其他基座配置或 access 访问设置 |
|
|
16
|
+
| profile | agent.md 展示字段、头像原 URL、welcome;`{}` |
|
|
17
|
+
| soul | 常驻设定分册;`{files:[分册名]}`,空说明文件不代表成熟人格 |
|
|
18
|
+
| skill | 仅选中技能的开关与附属资源;`{skills:[技能名]}`,不自动附带内置或继承开关 |
|
|
19
|
+
| trigger | Trigger 定义与脚本;`{triggers:[ID]}` |
|
|
20
|
+
| event | 事件包;`{events:[ID]}` |
|
|
21
|
+
| service | 服务包;`{services:[ID]}` |
|
|
22
|
+
| project | 项目知识、代码、素材和样例;`{}`,另需 selectionIndex |
|
|
23
|
+
|
|
24
|
+
### Owner 要求的四轮确认
|
|
25
|
+
|
|
26
|
+
当前 Owner 已明确要求模板范围分四轮逐项确认。首次制作或选择有变化时,inspect 后按以下顺序分四次询问;每次只提出当前一轮,等 Owner 回答并将决定写入本次 `pack-plan.md` 后,再进入下一轮。不能把四轮合并成一份总确认,也不能把摘要、未回答或上一轮的“确认”当作后续轮次的同意。既有、仍适用的偏好可以在该轮明确列为沿用项,请 Owner 确认是否有变化。
|
|
27
|
+
|
|
28
|
+
| 轮次 | 必须展示的实际候选与选择 |
|
|
29
|
+
| --- | --- |
|
|
30
|
+
| 1. 基础设置 | 对照 capabilities/schema 列出支持的 baseagent、来源实际基座、模型与推理强度、支持平台/操作系统;跨主机模板默认移除来源 Provider ID,且不包含凭证。逐项列出盘点值和可选变更。 |
|
|
31
|
+
| 2. 名片与 soul | 列出名片每个可采集字段及实际值;逐份列出所有 soul 文档、是否有有效正文及其主题,区分空分册、填写指南和可复用设定,说明拟保留、变量化或排除的内容。 |
|
|
32
|
+
| 3. 自主任务、技能、事件包与服务包 | 分别列出每个自主任务/Trigger、技能及其用途和依赖、事件包、服务包;技能须区分文件来源、最终启用状态和开关生效层级,本机共享不等于来源 Agent 显式启用。没有候选的类别明确写“无”。逐项给出纳入或排除选项,不用数量汇总代替清单。 |
|
|
33
|
+
| 4. 项目目录 | 展示来源实际项目路径、与用途相关的目录/文件清单、候选文件和依赖;共享目录逐项核对归属,归属未明的内容不自动纳入。明确整目录或逐项范围、排除项、目标包内落点及路径变量处理。不能只用“项目目录”概括。 |
|
|
34
|
+
|
|
35
|
+
操作系统展示为 Linux、macOS、Windows,字段仍使用 `linux`、`darwin`、`win32`。来源基座(如 `dsh`)不在当前 schema 支持范围,或平台声明被拒时,说明具体限制并确认取舍;不得自行映射成另一基座或缩减平台后继续对外交付。来源系统不代表其他平台已经实测。
|
|
36
|
+
|
|
37
|
+
每次模板制作都要以来源 Agent AID 和模板 ID 标明偏好归属,将四轮答案、未选项、确认时间及消息/话题依据写入该次 `pack-plan.md`;在 `$AGENT_DIR/index/INDEX.md` 建立按来源 Agent 可查的入口。不同来源 Agent 的选择不得混用。将过往选择沿用为默认之前,核实来源和资源仍匹配,并区分可复用偏好与该模板的一次性授权;有变化只询问受影响的轮次,保留变更记录。
|
|
38
|
+
|
|
39
|
+
## 2. 按模块 inspect → 确定采集范围 → collect
|
|
40
|
+
|
|
41
|
+
每模块独立 inspect,以下 JSON 替换来源和成员 key,保存为 `$TMPDIR/agent-template/inspect.json`,按入口通式执行:
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
{"module":"profile","members":{"writer":{"source":{"kind":"agent","aid":"writer.agentid.cn"}}}}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
inspect 是只读盘点,可以先执行。确认 succeeded,保存 jobId、result.inventoryDigest 和候选资源,再向用户说明具体建议:
|
|
48
|
+
|
|
49
|
+
| 确认事项 | 需要确定的内容 |
|
|
50
|
+
| --- | --- |
|
|
51
|
+
| 来源和成员 | 哪个 Host、哪些 Agent/目录及成员 key;不得混淆执行者与来源 |
|
|
52
|
+
| 模块和资源 | 默认基座沿用来源配置;除必需 config/profile 外选哪些模块、soul 分册、技能、Trigger、事件包、服务包;project 选哪些目录/文件 |
|
|
53
|
+
| 排除和脱敏 | 私有资料及不分享的内容,个人/组织信息保留或替换的范围;凭证和运行数据始终排除,不展示原始秘密 |
|
|
54
|
+
| 模板信息 | ID、显示名、版本、平台;尚不能确定的平台须核实依赖后补齐 |
|
|
55
|
+
|
|
56
|
+
每轮用简短清单列出本轮已有选择、推荐项和待定项,只询问会影响本轮结果的缺项;不能把建议或未回答当作同意。按轮次盘点并确认,相关范围明确并获授权后再 collect。用户已委托在指定范围内自行取舍时,按授权执行并报告选择。上传归属、接收方及期限按[第二册](02-upload-and-share.md)确定,已明确的无需重复询问。
|
|
57
|
+
|
|
58
|
+
### 保存并复用打包确认清单
|
|
59
|
+
|
|
60
|
+
- 确认后将决定持久保存为执行 Agent 的 `$AGENT_DIR/output/agent-template/<templateId>/pack-plan.md`,在其索引登记并告知用户位置;不能只留在聊天或 `$TMPDIR`。已约定其他持久位置时沿用,并在索引保留入口。
|
|
61
|
+
- 保存用途、来源 Host/Agent/目录及成员 key、所选模块和具体资源、项目整选/部分选择与排除项、脱敏约定、模板元数据/版本规则、依赖与平台;记录确认人、时间、确认消息或话题引用及授权适用范围。待定项明确标记,上传/分享的选择随确认补齐,不保存凭证或访问短码。
|
|
62
|
+
- 下次先读清单,再用本次 inspect 核对来源和资源是否仍适用;适用项直接执行,只询问缺项、冲突或超出原约定的变化。目录整选沿用原递归规则,范围内新增合格文件不逐个重问;未约定纳入的模块或资源不自动全选。
|
|
63
|
+
- 用户确认变更后更新原清单并保留简短变更记录。每次重新生成绑定当前 inspect 的 selectionIndex 和请求,旧 jobId、摘要或授权回执仅用于追溯,不能代替本次盘点及权限核验。
|
|
64
|
+
- 清单是制作约定,采集副本、作业回执和包摘要另行保存;该清单默认排除在分享包外,不写入 `team.json`,不把其中的私人信息带入模板。
|
|
65
|
+
|
|
66
|
+
skill 模块的 member.skills 只包含 include.skills 选中项。编辑副本删除某项声明后,pack 沿用声明筛选资源,不携带该技能目录;不展开来源 Host 的默认技能开关。
|
|
67
|
+
|
|
68
|
+
config 模块的行为配置只采集来源 defaults.json 与 Agent config.json 中的显式设置,不写入 Schema 自动补出的默认值。部分配置只保留已设置的子字段;显式值即使与默认值相同也保留。未设置的行为参数由安装目标的默认配置生效。
|
|
69
|
+
|
|
70
|
+
collect 引用原 inspect,模块/成员 key 一致。例如 profile 的 collect.json:
|
|
71
|
+
|
|
72
|
+
```json
|
|
73
|
+
{"module":"profile","inspectionJobId":"<实际inspect作业ID>","inventoryDigest":"<实际sha256摘要>","members":{"writer":{"include":{}}}}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
inspect 不冻结;collect.freeze 默认 false,可活跃自打包。显式 true 只冻结采集期,忙碌报 AGENT_BUSY。各模块独立 jobId,失败只重做对应模块;全部所选模块 succeeded 才可 pack。
|
|
77
|
+
|
|
78
|
+
## 3. project 的选择索引
|
|
79
|
+
|
|
80
|
+
仅 project 需要本节。inspect 不返回全量文件树,按需通过 file.list 或本地受鉴权入口浏览,展示相关候选及缺项。
|
|
81
|
+
|
|
82
|
+
将具体目录/文件、整选或部分选择、排除项纳入第二节的范围清单;用户未选择时,不默认整选项目。
|
|
83
|
+
|
|
84
|
+
索引保存在当前 `$TMPDIR`,格式如下;成员 key 必须完整,不带资料的成员 entries=[]:
|
|
85
|
+
|
|
86
|
+
```json
|
|
87
|
+
{
|
|
88
|
+
"schemaVersion":1,
|
|
89
|
+
"inspectionJobId":"<实际project inspect作业ID>",
|
|
90
|
+
"inventoryDigest":"<实际sha256摘要>",
|
|
91
|
+
"members":{"writer":{
|
|
92
|
+
"projectRevision":"<实际projectRevision>",
|
|
93
|
+
"entries":[{"path":"docs","type":"directory"},{"path":"examples/demo.json","type":"file"}]
|
|
94
|
+
}}
|
|
95
|
+
}
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
整选目录递归采集当前合格文件,部分选择只列所选项;展开浏览不改变选择。删除跳过、修改读当前内容,非空选择最终无文件报 PROJECT_FILES_EMPTY。索引最多 8 MiB、每成员 20,000 项,以 capabilities 为准。
|
|
99
|
+
|
|
100
|
+
按 UTF-8 实际字节算 size 和 sha256,上传索引:
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
ec storage upload <当前AgentAID> "$TMPDIR/agent-template/selection.json" /template-input/selection.json --format json
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
核实上传后定向授权来源 Host(见[第二部分](02-upload-and-share.md)),project collect 额外传:
|
|
107
|
+
|
|
108
|
+
```json
|
|
109
|
+
{"selectionIndex":{"location":{"aid":"<索引Storage所有者AID>","path":"/template-input/selection.json"},"download":{"shareId":"<实际十位短码>"},"digest":"<索引sha256摘要>","size":123}}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
这段合入 collect 请求,不单独发送;size 替换为实际值。project 的 include 为 `{}`,不传 include.files;soul 的 include.files 仍有效。
|
|
113
|
+
|
|
114
|
+
## 4. 阅读分析并修改副本
|
|
115
|
+
|
|
116
|
+
成功 collect 的本机 result.workspace 或远端 workspaceRef 指向副本,远端经受鉴权文件入口访问。每模块有 `<workspace>/<memberKey>/member.json` 和 `files/`;project 资料在 `files/workspace/<memberKey>/`,其 member.json 为空对象。
|
|
117
|
+
|
|
118
|
+
### 4.1 按用途和语义决定处理动作
|
|
119
|
+
|
|
120
|
+
先读已保存清单,再实际阅读所选内容。对每类信息依次判断:是否为模板用途所需、是否应随安装对象变化、是否包含凭证或未经约定分享的资料。长文分段阅读;不能仅按文件名或字符串外形判定。
|
|
121
|
+
|
|
122
|
+
| 内容及语义 | 处理规则 |
|
|
123
|
+
| --- | --- |
|
|
124
|
+
| 私钥、密码、Token、Cookie、连接凭证、带凭证的链接 | 移除真实值;不使用部分遮罩保留秘密。配置中的凭证字段整体删除;跨主机模板默认删除来源 Provider 引用,保留模型、推理强度及必要参数,由目标环境选择可用 Provider。已明确约定保留的引用除外,凭证始终不携带;脚本确需凭证时按下节改成目标程序实际支持的读取方式 |
|
|
125
|
+
| 表示“本 Agent / 当前 Owner / 当前 Host”的身份引用 | 使用相应模板变量;表示团队内部成员时使用真实成员 key 的成员变量。复核权限、投递对象和个人资料中的语义,不能把作者或外部服务身份一律当作安装目标 |
|
|
126
|
+
| 来源项目绝对路径、本机工具和环境依赖 | 项目内路径优先改为正确的相对路径,确需项目根目录时用支持的路径变量;外部工具路径改用可配置方式并说明要求,不能用项目变量替代所有绝对路径 |
|
|
127
|
+
| 姓名、电话、地址、账号、订单及客户记录等私人信息 | 用途不需要则删除;仅为说明结构或流程时换成一致的合成样例,例如“示例客户”,不保留可拼回原信息的遮罩片段;确需真实资料时沿用明确的分享范围,缺少决定只询问该项 |
|
|
128
|
+
| 内部业务资料、组织信息、非公开代码或素材 | 按已确认用途和分享范围选择保留、概括或样例化;不相关或明确不分享的内容排除。改写须保持技术含义、数据结构和必要约束 |
|
|
129
|
+
| soul 的人格、职责、行为规则及 welcome | 保留可复用设定;将只属于来源 Owner 的私有关系和经历按约定删除或泛化。改变核心人格、职责或功能时说明影响并确认差异 |
|
|
130
|
+
| 外部联系人、第三方服务地址、公开文档及素材链接 | 必需且在约定范围内的固定依赖保留并说明用途;无关私有联系人删除。原公开头像 URL 保留来源地址,含临时凭证或私有授权的 URL 改用获准公开链接或省略 |
|
|
131
|
+
| 图片、PDF、Office 文档、压缩包、二进制或非 UTF-8 文件 | 用相应工具检查可见内容、嵌入内容和元数据;其中个人信息按上述规则处理。无法检查的内容标明未核实,不能以 pack 未报错认定已脱敏;依照已确认范围处理,必要取舍只询问该项 |
|
|
132
|
+
|
|
133
|
+
始终排除 `.git`、`.claude`、`.env*`、node_modules、密钥、运行数据库和会话、日志及 `.template-work`。collect 会按已知来源值替换部分身份/路径,仍须复核替换后的语义;公开地址不等于其中所有内容均适合本次分享。
|
|
134
|
+
|
|
135
|
+
### 4.2 使用确实可解析的替换方式
|
|
136
|
+
|
|
137
|
+
| 替换方式 | 适用范围与约束 |
|
|
138
|
+
| --- | --- |
|
|
139
|
+
| `{{agent.aid}}`、`{{owner.aid}}`、`{{host.aid}}`、`{{project.path}}` | 模板内当前 Agent、Owner、Host 和项目根目录,安装时由目标上下文渲染 |
|
|
140
|
+
| `{{members.writer.aid}}`、`{{members.writer.project}}` | 团队成员引用;writer 是示例,须换为本次实际声明的成员 key,成员改名时同步引用 |
|
|
141
|
+
| 环境变量或目标程序的配置入口 | 仅在目标组件实际支持时使用。Shell 示例 `API_KEY=${OWNER_API_KEY}`,Node 脚本可读取 `process.env.OWNER_API_KEY`;目标环境需另行配置,模板系统不自动注入这些值 |
|
|
142
|
+
| 合成样例或说明文字 | 用于文档和样例数据,明确其示例性质;不能放进执行字段冒充有效身份、路径、凭证或地址 |
|
|
143
|
+
|
|
144
|
+
不能自行发明 `{{API_KEY}}`、`{{客户名称}}` 等自动填值变量。JSON 按结构修改字符串值,保留类型和转义;脚本按其语言读取配置,不能把 `${ENV}` 当作所有文件通用的插值语法。配置中的禁用凭证字段即使填入占位符也会被拒绝,不能靠更名、编码或拆分隐藏真实值。
|
|
145
|
+
|
|
146
|
+
### 4.3 保存规则并复核结果
|
|
147
|
+
|
|
148
|
+
- 将处理约定写回 `pack-plan.md`:适用的文件/字段和语义角色、删除/变量化/样例化/保留动作、使用的变量或样例、必要保留理由、目标需补齐的配置,以及确认依据。不记录原始秘密,后续按规则处理新内容,只询问超出原约定的差异。
|
|
149
|
+
- 逐项检查关联说明、样例、脚本和资源引用是否一致,变量是否可解析,删改是否破坏语法、结构、依赖或业务含义。明确外部工具、平台及安装后需提供的配置。
|
|
150
|
+
- 保持模块目录边界,新增资料进 project;缺依赖须补采对应模块,新增模块或扩大文件范围先确认变化。符合已确认规则的常规处理直接完成。
|
|
151
|
+
- pack 对 UTF-8 明文按凭证特征拦截,主要包括密钥前缀、私钥头及部分密钥赋值形式;会跳过二进制/非 UTF-8 内容,不替 Agent 判断普通个人或业务信息。命中后回到副本按语义处理,不反复改写来绕过规则;未命中也不等于脱敏完成。
|
|
152
|
+
|
|
153
|
+
没有 scan-report/review-scan、findingId 放行或 artifact 管理步骤。
|
|
154
|
+
|
|
155
|
+
## 5. pack 并核实结果
|
|
156
|
+
|
|
157
|
+
封包前对照已保存清单核对实际所含模块/资源、删改和脱敏摘要、外部依赖及 ID/显示名/版本/共同支持的平台。符合已确认范围即可继续;有影响用途或范围的变化,只确认差异并更新清单后再 pack,不要求用户重复批准原清单。目标已有不同内容的同版本包时须改版本。
|
|
158
|
+
|
|
159
|
+
保存 pack JSON,collections 引用成功 collect 作业,不引用 inspect 作业:
|
|
160
|
+
|
|
161
|
+
```json
|
|
162
|
+
{
|
|
163
|
+
"metadata":{"id":"writer","name":"写作助理","version":"1.0.0","platforms":["linux"]},
|
|
164
|
+
"members":{"writer":{"collections":[{"jobId":"<config collect作业ID>"},{"jobId":"<profile collect作业ID>"}]}}
|
|
165
|
+
}
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
同成员的模块须同来源、同成员 key。多成员扩展 members,外部联系人用 memberReferences.external,参数查 capabilities。pack 从编辑副本重新算摘要,不重采集,产出 v1 包。
|
|
169
|
+
|
|
170
|
+
后续要发布到平台仓库时,在 pack 顶层指定 `"publisherIdentity":"agent"` 或 `"host"`,由 Core 读取真实连接身份写入 PACKAGE.publisher.aid;与后续 publish 的第三个参数保持一致。agent 是当前执行 Agent,host 是当前 daemon 的控制身份。未指定仍沿用原操作者署名;publish 不修改已封包署名,不匹配时需重新 pack。记录原选择供后续沿用;metadata 和成员版本仍按现有要求明确填写,不自动继承或接受空值。
|
|
171
|
+
|
|
172
|
+
封包自动移除 team.json 顶层及成员层的 resources 盘点字段;文件清单/摘要由包内 MANIFEST.json 生成,安装配置与技能状态等声明保留。
|
|
173
|
+
|
|
174
|
+
确认 succeeded,保存 packageId/path/digest/size/metadata/memberKeys;push/publish 沿用 packageId,本机 preview 使用 result.path,后续映射取真实 memberKeys。SENSITIVE_CONTENT 仅返回路径/行号,改副本后新 pack,详见[恢复](04-upgrade-and-recovery.md)。交付列出所含模块、排除项和外部依赖。
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# 上传和分享
|
|
2
|
+
|
|
3
|
+
入口:[SKILL.md](../SKILL.md)。packageId 可直接上传;已有 Storage 包核实位置/摘要/元数据后直接分享。
|
|
4
|
+
|
|
5
|
+
需要正式发行时,转[发布到平台仓库](05-publish-to-platform.md),继续执行 publish 和 status 核验。
|
|
6
|
+
|
|
7
|
+
对外上传、分享或发布前,向 Owner 展示最终包的 packageId、digest、size、所含内容、平台、验证结果、Storage 归属、准确的接收方或仓库 AID,以及适用的授权期限。默认 72 小时也须明确写出。取得针对该包和本次对外范围的确认后再执行;相同摘要与范围的已有确认可沿用,包或范围变化只确认差异。仅制作模板不代表已授权对外操作。
|
|
8
|
+
|
|
9
|
+
最终包先按[第三册](03-download-and-install.md)做 preview,报告兼容性提示与未解决项;无法预览时说明原因,由 Owner 决定是否继续。需要 deploy 自测时仅在已获授权的隔离环境执行,不能默认创建或覆盖真实 Agent;未做部署或业务验证如实标明。核对接收方使用明确授权的 AID,`firstContact=true` 本身不代表越权,也不要求先加入联系人。
|
|
10
|
+
|
|
11
|
+
## 1. 选择存储归属并上传
|
|
12
|
+
|
|
13
|
+
Agent 代办制作、上传和分享时,未另有明确约定,优先上传到当前执行 Agent 自身 Storage,并由其完成授权分享;无需再为默认存储路线单独询问。为其他 Agent 打包时,默认仍使用执行者自身空间。将实际存储所有者 AID 和所选路线写入 `pack-plan.md`,后续沿用。
|
|
14
|
+
|
|
15
|
+
用户明确选择 Owner Storage 或使用 Evol App 的 Owner 上传流程时,保留该路线,由 App 完成 Owner 侧授权和分享。分享已有包时沿用其实际存储位置,无需为适配默认路线重新上传。
|
|
16
|
+
|
|
17
|
+
| 路线 | 实际上传者与前置授权 | 分享由谁执行 |
|
|
18
|
+
| --- | --- | --- |
|
|
19
|
+
| 当前执行 Agent Storage(Agent 代办优先) | 当前 Agent 的真实连接上传自身空间 | 当前 Agent 的 storage share 与 fs ACL |
|
|
20
|
+
| Owner Storage(主要由 Evol App 完成) | Owner App 授予来源 Host 模板目录 rw,Agent 发起 push,Host 上传 | Owner App 使用 Owner SDK |
|
|
21
|
+
|
|
22
|
+
location.aid 是 Storage 所有者,非接收人或投稿仓库。跨 AID 上传须授权 Host,给 Agent 授权不能替代;托管 storage share 只操作自身,不能填 Owner AID 代办 Owner 分享。
|
|
23
|
+
|
|
24
|
+
push JSON 的路径必须符合 metadata 的 ID/版本:
|
|
25
|
+
|
|
26
|
+
```json
|
|
27
|
+
{"packageId":"<实际packageId>","location":{"aid":"<选定Storage所有者AID>","path":"/templates/writer/writer-1.0.0.ectpl"}}
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
按入口通式 push,确认 succeeded,保存 location/digest/size/metadata。Owner 路线交接 App 创建授权和卡片;以下用于 Agent 自身 Storage。
|
|
31
|
+
|
|
32
|
+
需要回读或取得卡片元数据时:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
ec fs cp <当前AgentAID>:/templates/writer/writer-1.0.0.ectpl "$TMPDIR/agent-template/download.ectpl" --format json
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
比对 SHA-256;确需覆盖加 --overwrite。从本地包读取 PACKAGE.json 与成员 profile 展示字段;包结构校验见[第三部分](03-download-and-install.md)。
|
|
39
|
+
|
|
40
|
+
## 2. 授权接收方及安装 Host
|
|
41
|
+
|
|
42
|
+
将私有短码请求保存为 `$TMPDIR/agent-template/share.json`:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{"action":"create","requestId":"<本次分享请求ID>","path":"/templates/writer/writer-1.0.0.ectpl","allowedAids":["recipient.agentid.cn"],"expireInSeconds":259200,"maxUses":0}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
ec storage share <当前AgentAID> --input-file "$TMPDIR/agent-template/share.json" --format json
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
核实退出码 0、state=succeeded、有效 result.share_id。接收方可在 App 选择 Host 时,另授予其直接 Host 条件读 ACL:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
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","max_uses":0}' --expires '<实际到期Unix秒>' --format json
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
替换身份、路径和到期值。未指定期限时默认72小时(259200秒),ACL 取与短码对齐的到期 Unix 秒;明确约定的期限优先,明确永久才两者均填 0。expireInSeconds 为时长,expires_at/--expires 为到期时间,不能照抄数值;有限 max_uses 在整条规则内共享。
|
|
59
|
+
|
|
60
|
+
规则使用 Ownership direct AND 可信 card.type=[host]、perms=r,Storage 动态核验归属。核实退出码 0、ok=true 和实际规则回执;两授权均成功才发卡,接收人不匹配 Host 条件,仍需短码。
|
|
61
|
+
|
|
62
|
+
仅指定 Host 时,allowedAids 填实际 Host,无需动态 ACL;交付 location/shareId/digest/授权对象/期限。
|
|
63
|
+
|
|
64
|
+
project 索引临时分享同样使用 create,将 allowedAids 限定为实际来源 Host;不发送模板卡片。
|
|
65
|
+
|
|
66
|
+
## 3. 发送 v2 模板卡片
|
|
67
|
+
|
|
68
|
+
保存对象本身到 `$TMPDIR/agent-template/template-share-card.json`;替换示例值,expires_at 占位须换数值,不包外层 payload:
|
|
69
|
+
|
|
70
|
+
```json
|
|
71
|
+
{
|
|
72
|
+
"type":"agent.template.share","schema_version":2,
|
|
73
|
+
"share_id":"tshare-<本次卡片UUID>","chat_id":"<实际chat_id>","text":"Agent 模板:写作助理",
|
|
74
|
+
"location":{"aid":"sender.agentid.cn","path":"/templates/writer/writer-1.0.0.ectpl"},
|
|
75
|
+
"publisher":{"aid":"sender.agentid.cn","name":"分享者"},
|
|
76
|
+
"recipient_download":{"aid":"recipient.agentid.cn","shareId":"<真实十位短码>","url":"<真实回执url>","share_url":"<真实回执share_url>"},
|
|
77
|
+
"template":{"id":"writer","version":"1.0.0","name":"写作助理","description":"模板简介","digest":"<实际sha256摘要>","size":12345,"compat":{"platforms":["linux"],"baseagents":["codex"]}},
|
|
78
|
+
"expires_at":<实际到期Unix秒>,"note":""
|
|
79
|
+
}
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
- template 取真实封包结果/PACKAGE.json,avatar 取包内 profile,可选值缺失则省略。
|
|
83
|
+
- recipient_download 取真实短码和 URL 回执;publisher 为实际发送者,不改包内 publisher。
|
|
84
|
+
- expires_at 取两授权最早到期秒,均永久才为 0;每接收方独立业务 share_id,发送重试保留,勿混用 Storage 短码。
|
|
85
|
+
- chat_id 取实际会话;投递由 --to/--thread 决定。
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
ecmsg send --thread main:<本端AID>:<接收方AID> --payload-file "$TMPDIR/agent-template/template-share-card.json" --encrypt yes --format json
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
单独发送并核验回执;App v2 渲染、真实动态 ACL 按实际联调情况说明,不能用模拟测试证明对端可安装。
|
|
92
|
+
|
|
93
|
+
接收方为 Agent 时,同一张卡片由 Core 校验后进入私聊模型会话,展示发送方、模板名称、版本、摘要和有效期;完整卡片保存为该 Agent 的 JSON 附件,入模文本和历史保留文件引用。无需另发一条通知,卡片也不附加要求通知 Owner 的指令。联系人准入及私聊提及规则仍生效;AUN `delivered` 只证明传输送达,不能代替对端处理确认。下载权限及拒绝后的处理见[下载和安装](03-download-and-install.md)。
|
|
94
|
+
|
|
95
|
+
需要附件交付时单独发送本地包,附件不替代授权:
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
ecmsg send --file "$TMPDIR/agent-template/download.ectpl" --as file --text 'Agent 模板包'
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## 4. 撤销与部分成功
|
|
102
|
+
|
|
103
|
+
撤销接收方短码使用 `ec storage share` 的 `action=revoke`、独立 requestId、原 shareId。撤销动态 Host ACL:
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
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
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
分别核验两项撤销。同对象同接收方的 ACL 被多卡共用,撤销影响这些卡片;撤销不会删除已下载副本。部分成功与未知结果见[恢复](04-upgrade-and-recovery.md)。
|
|
@@ -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` 缺文件不代表原操作未发生。
|