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
|
@@ -61,41 +61,27 @@ function refreshHint() {
|
|
|
61
61
|
// 群聊一律拒绝——包括 owner 亲自下指令。技能开关是 agent 的自身配置,
|
|
62
62
|
// 不该被群里的对话推动(owner 要改就私聊说)。
|
|
63
63
|
//
|
|
64
|
-
//
|
|
65
|
-
//
|
|
64
|
+
// 托管写操作通过 daemon IPC 验证任务委托及当前 Ownership 协议共识,
|
|
65
|
+
// 不将环境变量副本或旧 daemon.json.owners 当作授权依据。
|
|
66
66
|
// 无上下文(宿主终端直连、daemon 自己的调度脚本、CI)视为本机管理员在操作,放行。
|
|
67
67
|
//
|
|
68
|
-
//
|
|
69
|
-
//
|
|
68
|
+
// CLI(ec skill)和模型侧脚本共用本文件的 IPC 校验入口,
|
|
69
|
+
// daemon 根据实际命令作用域决定写权限。
|
|
70
70
|
|
|
71
71
|
const RUNTIME_CONTEXT_ENV = 'EVOLCORE_TASK_RUNTIME_CONTEXT';
|
|
72
72
|
|
|
73
|
-
/** 读取 daemonowner 名单(daemon.json 的 owners[]);读不到返回空数组 */
|
|
74
|
-
function daemonOwners() {
|
|
75
|
-
const file = path.join(evolcoreHome(), 'daemon.json');
|
|
76
|
-
try {
|
|
77
|
-
const data = JSON.parse(fs.readFileSync(file, 'utf-8'));
|
|
78
|
-
if (!Array.isArray(data?.owners)) return [];
|
|
79
|
-
return data.owners.map(v => String(v || '').trim()).filter(Boolean);
|
|
80
|
-
} catch {
|
|
81
|
-
return [];
|
|
82
|
-
}
|
|
83
|
-
}
|
|
84
|
-
|
|
85
73
|
/**
|
|
86
74
|
* 校验当前调用方对某一级的写权限。
|
|
87
75
|
* @param {'agent'|'local'} scope
|
|
88
76
|
*/
|
|
89
|
-
function assertPermission(scope) {
|
|
90
|
-
const
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
return; // 上下文损坏按无上下文处理,与本目录既有的「读不到就退回默认」一致
|
|
98
|
-
}
|
|
77
|
+
async function assertPermission(scope, argv) {
|
|
78
|
+
const managed = process.env[RUNTIME_CONTEXT_ENV] !== undefined
|
|
79
|
+
|| process.env.EVOLCORE_SESSION_ID !== undefined
|
|
80
|
+
|| process.env.EVOLCORE_DELEGATION_TOKEN !== undefined
|
|
81
|
+
|| process.env.EVOLCORE_CODEX_SESSION_TOKEN !== undefined;
|
|
82
|
+
if (!managed) return; // 宿主终端直连
|
|
83
|
+
const { authorizeLocalCommand } = await import(pathToFileURL(path.join(packageRoot(), 'dist', 'cli', 'task-context.js')).href);
|
|
84
|
+
const ctx = await authorizeLocalCommand(['skill', ...argv]);
|
|
99
85
|
|
|
100
86
|
const chatType = ctx?.chatType;
|
|
101
87
|
const target = scope === 'local' ? '本机级' : 'Agent 级';
|
|
@@ -104,7 +90,12 @@ function assertPermission(scope) {
|
|
|
104
90
|
// Do not trust the environment marker by itself; it is only present here
|
|
105
91
|
// after the managed command context was validated through IPC.
|
|
106
92
|
if (ctx?.processRole === 'fullaccess-run' && ctx?.dataScope === 'daemon'
|
|
107
|
-
&& ctx?.permissionMode === 'fullaccess' && ctx?.authorizedBy)
|
|
93
|
+
&& ctx?.permissionMode === 'fullaccess' && ctx?.authorizedBy) {
|
|
94
|
+
setAgentContext(ctx);
|
|
95
|
+
return;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
if (ctx?.permissionMode === 'readonly') throw new Error('拒绝:只读任务不能修改技能。');
|
|
108
99
|
|
|
109
100
|
if (chatType === 'group') {
|
|
110
101
|
throw new Error(
|
|
@@ -118,17 +109,24 @@ function assertPermission(scope) {
|
|
|
118
109
|
`拒绝:Agent 级技能开关仅限本 Agent 的 owner 或 admin(当前角色:${ctx?.peerRole || '未知'})。`
|
|
119
110
|
);
|
|
120
111
|
}
|
|
112
|
+
setAgentContext(ctx);
|
|
121
113
|
return;
|
|
122
114
|
}
|
|
123
115
|
|
|
124
116
|
// 本机级:所有 agent 共享,仅 daemonowner 可改
|
|
125
117
|
const peerId = String(ctx?.peerId || '').trim();
|
|
126
|
-
if (!peerId ||
|
|
118
|
+
if (!peerId || ctx?.processRole !== 'daemon-owner' || ctx?.dataScope !== 'daemon') {
|
|
127
119
|
throw new Error(
|
|
128
120
|
`拒绝:本机级技能为整机所有 agent 共享,仅限 daemonowner 安装、删除、创建与开关。`
|
|
129
121
|
+ `\n 当前身份:${peerId || '未知'}(可用 ec skill where 查看本机级目录)`
|
|
130
122
|
);
|
|
131
123
|
}
|
|
124
|
+
setAgentContext(ctx);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
function setAgentContext(ctx) {
|
|
128
|
+
process.env.EVOLCORE_SELF_AID = ctx.selfAid;
|
|
129
|
+
process.env.EVOLCORE_AGENT_DIR = path.join(evolcoreHome(), 'agents', ctx.selfAid);
|
|
132
130
|
}
|
|
133
131
|
|
|
134
132
|
// ── 开关读写 ──────────────────────────────────────────────────────────
|
|
@@ -466,8 +464,8 @@ export function resolveSkillDirArg(target) {
|
|
|
466
464
|
throw new Error(`找不到技能: ${target}`);
|
|
467
465
|
}
|
|
468
466
|
|
|
469
|
-
export function cmdCreate(name, { desc = '', force = false, enable = false, json = false } = {}) {
|
|
470
|
-
assertPermission('local')
|
|
467
|
+
export async function cmdCreate(name, { desc = '', force = false, enable = false, json = false, argv } = {}) {
|
|
468
|
+
await assertPermission('local', argv ?? ['create', name, '--desc', desc, ...(force ? ['--force'] : []), ...(enable ? ['--enable'] : [])]);
|
|
471
469
|
if (!name) throw new Error(`缺少技能名。用法:ec skill create <name> --desc '...'`);
|
|
472
470
|
if (!NAME_RE.test(name)) {
|
|
473
471
|
throw new Error(`技能名「${name}」不符合 kebab-case(小写字母/数字/连字符,如 my-skill)`);
|
|
@@ -505,14 +503,14 @@ export function cmdCreate(name, { desc = '', force = false, enable = false, json
|
|
|
505
503
|
'下一步:',
|
|
506
504
|
' 1. 补全 SKILL.md 的 description(决定技能会不会被选中,务必写清触发场景)',
|
|
507
505
|
' 2. 正文写清步骤;需要时把大块资料放 references/',
|
|
508
|
-
' 3.
|
|
506
|
+
' 3. 脚本放 scripts/,内部用 import.meta.dirname 自定位;正文里写 node "{{skillDir}}/scripts/xxx"',
|
|
509
507
|
enable ? ` 4. 如需停用: ec skill disable ${name}` : ` 4. 完成后启用: ec skill enable ${name}`,
|
|
510
508
|
...(enable ? ['', refreshHint()] : []),
|
|
511
509
|
].join('\n');
|
|
512
510
|
}
|
|
513
511
|
|
|
514
|
-
export function cmdInstall(src, { force = false, enable = false, json = false } = {}) {
|
|
515
|
-
assertPermission('local')
|
|
512
|
+
export async function cmdInstall(src, { force = false, enable = false, json = false, argv } = {}) {
|
|
513
|
+
await assertPermission('local', argv ?? ['install', src, ...(force ? ['--force'] : []), ...(enable ? ['--enable'] : [])]);
|
|
516
514
|
if (!src) throw new Error('缺少源。用法:ec skill install <目录|zip文件|SKILL.md>');
|
|
517
515
|
if (!fs.existsSync(src)) throw new Error(`源不存在: ${src}`);
|
|
518
516
|
|
|
@@ -584,8 +582,8 @@ export function cmdInstall(src, { force = false, enable = false, json = false }
|
|
|
584
582
|
}
|
|
585
583
|
}
|
|
586
584
|
|
|
587
|
-
export function cmdRemove(name, { json = false } = {}) {
|
|
588
|
-
assertPermission('local');
|
|
585
|
+
export async function cmdRemove(name, { json = false, argv } = {}) {
|
|
586
|
+
await assertPermission('local', argv ?? ['remove', name]);
|
|
589
587
|
if (!name) throw new Error('缺少技能名。用法:ec skill remove <name>');
|
|
590
588
|
const roots = skillRoots();
|
|
591
589
|
const target = path.join(roots.local, name);
|
|
@@ -617,13 +615,13 @@ export function cmdRemove(name, { json = false } = {}) {
|
|
|
617
615
|
return [`✅ 已删除本机技能 ${name}`, refreshHint()].join('\n');
|
|
618
616
|
}
|
|
619
617
|
|
|
620
|
-
export function cmdEnableDisable(name, enabled, { level = 'agent', json = false } = {}) {
|
|
618
|
+
export async function cmdEnableDisable(name, enabled, { level = 'agent', json = false, argv } = {}) {
|
|
621
619
|
if (!name) throw new Error(`缺少技能名。用法:ec skill ${enabled ? 'enable' : 'disable'} <name>`);
|
|
622
620
|
if (!['agent', 'local'].includes(level)) {
|
|
623
621
|
throw new Error(`--level 只能是 agent 或 local(内置级不可写)`);
|
|
624
622
|
}
|
|
625
623
|
// 级别校验通过后再判权限,避免非法 --level 先撞权限门禁而掩盖真实错因
|
|
626
|
-
assertPermission(level === 'local' ? 'local' : 'agent');
|
|
624
|
+
await assertPermission(level === 'local' ? 'local' : 'agent', argv ?? [enabled ? 'enable' : 'disable', name, '--level', level]);
|
|
627
625
|
|
|
628
626
|
const roots = skillRoots();
|
|
629
627
|
const dir = roots[level];
|
|
@@ -746,10 +744,26 @@ export async function cmdLoad(name, { source = null, withFrontmatter = false, js
|
|
|
746
744
|
if (!withFrontmatter) {
|
|
747
745
|
content = content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '');
|
|
748
746
|
}
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
747
|
+
// {{skillDir}} 是技能自带的路径占位符:正文里只写相对结构({{skillDir}}/scripts/x.mjs),
|
|
748
|
+
// 加载时渲染成本机绝对路径。这样换机器、换安装位置都不用改正文,
|
|
749
|
+
// 也不会把用户名之类的本机信息写死在技能里。
|
|
750
|
+
// 旧写法 `<技能目录>` 一并兼容。
|
|
751
|
+
const raw = content.trimStart();
|
|
752
|
+
// 字符数按码点算,中文一字算 1;用 body.length 会把 emoji 算成 2。
|
|
753
|
+
// 先算再渲染占位符,chars 才反映技能正文本身,不受安装路径长度影响。
|
|
754
|
+
const chars = Array.from(raw).length;
|
|
755
|
+
// 只替换后面紧跟路径分隔符的占位符。正文里讲占位符本身的句子(「写成 {{skillDir}}」)
|
|
756
|
+
// 不该被替换,否则说明文字会变成一句实际路径,读起来自相矛盾。
|
|
757
|
+
// Windows 绝对路径是反斜杠,正文里占位符后面写的是 /,混拼会出 `...\ec-skill/scripts`;
|
|
758
|
+
// 统一渲染成正斜杠,Windows 的 node 也认。
|
|
759
|
+
const dirForBody = skillDir.replace(/\\/g, '/');
|
|
760
|
+
const body = raw
|
|
761
|
+
.replace(/\{\{skillDir\}\}(?=[\\/])/g, dirForBody)
|
|
762
|
+
.replace(/<技能目录>(?=[\\/])/g, dirForBody);
|
|
763
|
+
const footer = `\n---\nskillDir: ${skillDir}\nchars: ${chars}\n`;
|
|
764
|
+
const output = body + footer;
|
|
765
|
+
|
|
766
|
+
if (json) return { name, skillDir, chars, content: output };
|
|
753
767
|
return output;
|
|
754
768
|
}
|
|
755
769
|
|
|
@@ -25,6 +25,15 @@ description: >-
|
|
|
25
25
|
- 输入缺失时如何处理
|
|
26
26
|
- 遇到不适用场景时如何退出
|
|
27
27
|
|
|
28
|
+
## 脚本
|
|
29
|
+
|
|
30
|
+
需要脚本就放 `scripts/`,脚本内部用 `import.meta.dirname` 自定位,不要依赖 cwd。
|
|
31
|
+
正文里引用脚本时,技能目录写 `{{skillDir}}`:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
node "{{skillDir}}/scripts/foo.mjs"
|
|
35
|
+
```
|
|
36
|
+
|
|
28
37
|
## 参考资料
|
|
29
38
|
|
|
30
39
|
(大块资料放 `references/`,在这里指出文件名。不要把它塞进本文件。)
|
|
@@ -21,7 +21,7 @@ license: MIT
|
|
|
21
21
|
|---|---|
|
|
22
22
|
| "明天早上 9 点提醒我带合同" | 一次 `--at` 或单次 cron,**trigger-session**,投递到用户的会话 |
|
|
23
23
|
| "以后每天 9 点给我出昨日总结" | `--cron '0 9 * * *' --tz Asia/Shanghai`,**trigger-session**,投递用户会话 |
|
|
24
|
-
| "帮我把这个任务跟到底,对方回了我马上告诉我" | 跨话题委托时用 `
|
|
24
|
+
| "帮我把这个任务跟到底,对方回了我马上告诉我" | 跨话题委托时用 `ecmsg send --thread <话题id> --check-every`,**不要自建 trigger**(见 thread-ops) |
|
|
25
25
|
| "每 30 分钟看一眼升级有没有新版本" | `--every 30m`,**trigger-session**,提示词写"无变化只输出 `[[NOOP]]`",加 `--max-runs` |
|
|
26
26
|
| "任务失败就自动继续 / 出错误告诉我" | `--event 'task:error'` 或 `--event 'message:received' --event-filter ...` |
|
|
27
27
|
| "帮我盯着这个会话,闲下来时看看有没有漏掉的事" | 这是会话 loop,`/loop 300`(事件 `session:idle`),**不是**普通 trigger |
|
|
@@ -93,7 +93,7 @@ ec trigger create --cron '0 9 * * *' --tz Asia/Shanghai \
|
|
|
93
93
|
- **你被 trigger 唤醒时**:信封里的 `触发于:` 是排定时刻(firedAt),不是唤醒时刻;
|
|
94
94
|
proactive 模式下正文流式输出会被丢弃,**回复必须走 `ec ctl send`**;`[[NOOP]]` 仍适用,
|
|
95
95
|
只用它、别在它前后多说一句。
|
|
96
|
-
- **提示词里能用的变量**:`{{trigger.name}}`、`{{run.number}}`(第几次)、`{{run.elapsed}}
|
|
96
|
+
- **提示词里能用的变量**:`{{trigger.name}}`、`{{run.number}}`(第几次)、`{{run.elapsed}}`、`{{run.every}}`(当前周期,仅 interval),
|
|
97
97
|
`{{date}}`、`{{time}}`,事件触发另有 `{{event.<字段>}}`。提示词正文走同一套渲染。
|
|
98
98
|
- **每次创建都是新 trigger**:重复建同一个提醒会得到多个 trigger,各自都会触发。先 `list` 查。
|
|
99
99
|
- **列表默认只显示 enabled**:排查"怎么没有"要 `ec trigger list --all`。
|
|
@@ -144,7 +144,7 @@ ec trigger create --event 'task:error' \
|
|
|
144
144
|
5. 不直接读 `trigger.json`、`scripts/*`、`data/`、`AIDs/` 这类受保护路径——沙箱按 H 类拦截,
|
|
145
145
|
脚本会直接启动失败。
|
|
146
146
|
6. 提示词超过 4096 字符用 `--prompt-file`,不要硬塞。
|
|
147
|
-
7. 群聊里不要用 `--mention` 去 @ 人做提醒——`
|
|
147
|
+
7. 群聊里不要用 `--mention` 去 @ 人做提醒——`ecmsg send` 和 trigger 提示词不共享参数;
|
|
148
148
|
要在群里点名,写进目标会话的提示词里,或让 target-session 在群里自己 @。
|
|
149
149
|
|
|
150
150
|
## 九、排查手册
|
|
@@ -47,7 +47,7 @@ license: MIT
|
|
|
47
47
|
**规则**:
|
|
48
48
|
- 能用脚本做的,不要你用语言"手工"做——不确定、贵、会漂移
|
|
49
49
|
- 需要判断的,不要硬塞给脚本——规则写不全
|
|
50
|
-
- 脚本一律用**绝对路径**调用:`node "
|
|
50
|
+
- 脚本一律用**绝对路径**调用:`node "{{skillDir}}/scripts/xxx.mjs"`
|
|
51
51
|
|
|
52
52
|
---
|
|
53
53
|
|
|
@@ -59,10 +59,10 @@ license: MIT
|
|
|
59
59
|
传工作区路径和 AID,剩下全部由脚本完成。**
|
|
60
60
|
|
|
61
61
|
```bash
|
|
62
|
-
node "
|
|
63
|
-
node "
|
|
64
|
-
node "
|
|
65
|
-
node "
|
|
62
|
+
node "{{skillDir}}/scripts/pa.mjs" init --workspace <路径> --self <AID> [--owner <AID>]
|
|
63
|
+
node "{{skillDir}}/scripts/pa.mjs" clean --workspace <路径> --self <AID> [--yes]
|
|
64
|
+
node "{{skillDir}}/scripts/pa.mjs" uninstall --workspace <路径> --self <AID> [--remove-triggers]
|
|
65
|
+
node "{{skillDir}}/scripts/pa.mjs" update --workspace <路径> --self <AID>
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
| 操作 | 做什么 | 工作区档案 | 什么时候用 |
|
|
@@ -112,14 +112,14 @@ node "<技能目录>/scripts/pa.mjs" update --workspace <路径> --self <AID>
|
|
|
112
112
|
|
|
113
113
|
```bash
|
|
114
114
|
# 1. 体检(先看是不是已经初始化过——见 3.2.1)
|
|
115
|
-
node "
|
|
115
|
+
node "{{skillDir}}/scripts/check.mjs" --workspace "<工作区绝对路径>"
|
|
116
116
|
|
|
117
117
|
# 2. 初始化(参数一次给全,尤其 --self 和 --with-triggers)
|
|
118
|
-
node "
|
|
118
|
+
node "{{skillDir}}/scripts/pa.mjs" init --workspace "<工作区绝对路径>" \
|
|
119
119
|
--owner "<owner AID>" --self "<本 Agent AID>" --with-triggers
|
|
120
120
|
|
|
121
121
|
# 3. 重建索引(init 已写 README/INDEX,这一步确保与现有文件一致)
|
|
122
|
-
node "
|
|
122
|
+
node "{{skillDir}}/scripts/index-rebuild.mjs" --workspace "<工作区绝对路径>"
|
|
123
123
|
```
|
|
124
124
|
|
|
125
125
|
最后再跑一次 `check.mjs` 验收。**共 4 步。**
|
|
@@ -228,11 +228,11 @@ node "<技能目录>/scripts/index-rebuild.mjs" --workspace "<工作区绝对路
|
|
|
228
228
|
|
|
229
229
|
```bash
|
|
230
230
|
# 清空重来(先不带 --yes 预览)
|
|
231
|
-
node "
|
|
232
|
-
node "
|
|
231
|
+
node "{{skillDir}}/scripts/pa.mjs" clean --workspace "<工作区绝对路径>" --self "<本 Agent AID>"
|
|
232
|
+
node "{{skillDir}}/scripts/pa.mjs" clean --workspace "<工作区绝对路径>" --self "<本 Agent AID>" --yes
|
|
233
233
|
|
|
234
234
|
# 撤装保档
|
|
235
|
-
node "
|
|
235
|
+
node "{{skillDir}}/scripts/pa.mjs" uninstall --workspace "<工作区绝对路径>" --self "<本 Agent AID>" --remove-triggers
|
|
236
236
|
```
|
|
237
237
|
|
|
238
238
|
**`--workspace` 必传,不是摆设。** 脚本会读出 persona 标记块里登记的路径做比对:
|
|
@@ -252,7 +252,7 @@ node "<技能目录>/scripts/pa.mjs" uninstall --workspace "<工作区绝对路
|
|
|
252
252
|
## 四、体检(只读)
|
|
253
253
|
|
|
254
254
|
```bash
|
|
255
|
-
node "
|
|
255
|
+
node "{{skillDir}}/scripts/check.mjs" --workspace "<工作区绝对路径>"
|
|
256
256
|
```
|
|
257
257
|
|
|
258
258
|
输出四类结论:
|
|
@@ -271,9 +271,9 @@ node "<技能目录>/scripts/check.mjs" --workspace "<工作区绝对路径>"
|
|
|
271
271
|
## 五、升级
|
|
272
272
|
|
|
273
273
|
```bash
|
|
274
|
-
node "
|
|
275
|
-
node "
|
|
276
|
-
node "
|
|
274
|
+
node "{{skillDir}}/scripts/check.mjs" --workspace "<路径>" # 1. 先看差什么
|
|
275
|
+
node "{{skillDir}}/scripts/pa.mjs" update --workspace "<路径>" --self "<本 Agent AID>" # 2. 迁移 + 刷新 persona
|
|
276
|
+
node "{{skillDir}}/scripts/check.mjs" --workspace "<路径>" # 3. 复查
|
|
277
277
|
```
|
|
278
278
|
|
|
279
279
|
`--self` 不是必须,但给了就会顺带按新模板刷新 `soul/04-working-style.md` 里的工作区入口——
|
|
@@ -392,10 +392,10 @@ node "<技能目录>/scripts/check.mjs" --workspace "<路径>"
|
|
|
392
392
|
|
|
393
393
|
```bash
|
|
394
394
|
# 1. 先预览(默认就是预览,不加 --yes 什么都不删)
|
|
395
|
-
node "
|
|
395
|
+
node "{{skillDir}}/scripts/clean.mjs" --workspace "<路径>" --self "<AID>"
|
|
396
396
|
|
|
397
397
|
# 2. 确认后执行
|
|
398
|
-
node "
|
|
398
|
+
node "{{skillDir}}/scripts/clean.mjs" --workspace "<路径>" --self "<AID>" --yes
|
|
399
399
|
```
|
|
400
400
|
|
|
401
401
|
**清理是不可逆的,所以默认只预览。** 这不是多余的谨慎——工作区里可能有用户几个月的数据。
|
|
@@ -416,8 +416,8 @@ node "<技能目录>/scripts/clean.mjs" --workspace "<路径>" --self "<AID>" --
|
|
|
416
416
|
工作区确认无误、数据已经定稿时锁定:
|
|
417
417
|
|
|
418
418
|
```bash
|
|
419
|
-
node "
|
|
420
|
-
node "
|
|
419
|
+
node "{{skillDir}}/scripts/lock.mjs" --workspace "<路径>" --reason "定稿,2026 年度档案" --yes
|
|
420
|
+
node "{{skillDir}}/scripts/lock.mjs" --workspace "<路径>" --show # 查状态
|
|
421
421
|
```
|
|
422
422
|
|
|
423
423
|
**锁定是单向的,没有 unlock。**
|
|
@@ -452,11 +452,11 @@ node "<技能目录>/scripts/lock.mjs" --workspace "<路径>" --show # 查
|
|
|
452
452
|
|
|
453
453
|
```bash
|
|
454
454
|
# 1. 建
|
|
455
|
-
node "
|
|
455
|
+
node "{{skillDir}}/scripts/pa.mjs" init --workspace "<路径>" --owner "<AID>" --self "<AID>" --with-triggers
|
|
456
456
|
# 2. 验
|
|
457
|
-
node "
|
|
457
|
+
node "{{skillDir}}/scripts/check.mjs" --workspace "<路径>"
|
|
458
458
|
# 3. 清空(连触发器、persona 入口一起)
|
|
459
|
-
node "
|
|
459
|
+
node "{{skillDir}}/scripts/pa.mjs" clean --workspace "<路径>" --self "<AID>" --yes
|
|
460
460
|
# 4. 回到第 1 步
|
|
461
461
|
```
|
|
462
462
|
|
|
@@ -99,7 +99,7 @@ ec fs cat leiliang.agentid.cn:/.evol/observation-access/v1/snapshots/.../manifes
|
|
|
99
99
|
|---|---|
|
|
100
100
|
| `ec trigger show <id>` 报错 | `Cannot find module dist/cli/trigger-command.js`。`list`/`create`/`delete` 正常,只有 `show` 坏 |
|
|
101
101
|
| `calendar/manage` 的 `list` 不接受 `calendar_id` | 带上就返回 `params_invalid`,去掉即可 |
|
|
102
|
-
|
|
|
102
|
+
| 能力调用可省略 `--device-id` | 不带即广播,Provider 路由到在线设备、按设备逐条收结果;要限定单台才指定 |
|
|
103
103
|
| `--return required` 可能返回 `message_expired` | 设备不在线时的表现,不是参数错误 |
|
|
104
104
|
|
|
105
105
|
---
|
|
@@ -41,11 +41,11 @@ description: 使用 html2text 从 URL 抓取可读正文(含图片),按优
|
|
|
41
41
|
2. 已安装 `uv`(依赖走 uv 全局缓存,不需要 venv)。
|
|
42
42
|
3. 机器可访问目标 URL。
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
脚本位置不固定,路径一律写成 `{{skillDir}}`(即本技能所在目录,加载时替换成本机绝对路径)。约定写法见下方「路径约定」。
|
|
45
45
|
|
|
46
46
|
## 路径约定
|
|
47
47
|
|
|
48
|
-
EC 不会把 cwd
|
|
48
|
+
EC 不会把 cwd 设到技能目录,所以命令里的脚本路径**必须写成绝对路径**,技能目录用 `{{skillDir}}`。不要依赖 cwd 或 `~`。
|
|
49
49
|
|
|
50
50
|
脚本内部也不依赖 cwd:`run_pipeline.sh` 用自身位置定位同目录的其它脚本。
|
|
51
51
|
|
|
@@ -54,7 +54,7 @@ EC 不会把 cwd 设到技能目录,所以命令里的脚本路径**必须写
|
|
|
54
54
|
不要假设系统一定有 `python` 别名,统一先跑 wrapper:
|
|
55
55
|
|
|
56
56
|
```bash
|
|
57
|
-
bash "
|
|
57
|
+
bash "{{skillDir}}/scripts/run_pipeline.sh"
|
|
58
58
|
```
|
|
59
59
|
|
|
60
60
|
该 wrapper 会优先选 `python3`,其次 `python`,避免「环境有 Python,但入口命令写死导致误判」。
|
|
@@ -69,7 +69,7 @@ bash "<技能目录>/scripts/run_pipeline.sh"
|
|
|
69
69
|
用 `uv` 的全局缓存装依赖,使用 `--no-project` 避免在当前目录建 `.venv`:
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
uv run --no-project --with lxml --with cssselect --with html2text python "
|
|
72
|
+
uv run --no-project --with lxml --with cssselect --with html2text python "{{skillDir}}/scripts/scrapling_fetch.py" <url> [max_chars]
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
依赖只进 uv 全局缓存(`uv cache dir`),跨技能共享、装一次后秒级启动,不落任何项目目录。
|
|
@@ -103,7 +103,7 @@ uv run --no-project --with lxml --with cssselect --with html2text python "<技
|
|
|
103
103
|
3. 用 `render_markdown_reply.py` 生成固定格式的回复:
|
|
104
104
|
|
|
105
105
|
```bash
|
|
106
|
-
python3 "
|
|
106
|
+
python3 "{{skillDir}}/scripts/render_markdown_reply.py" <title> <url> <markdown_file>
|
|
107
107
|
```
|
|
108
108
|
|
|
109
109
|
无 `python3` 时改用 `python`,优先复用 wrapper 选出的解释器。
|
|
@@ -5,7 +5,7 @@ description: >-
|
|
|
5
5
|
**以下两种消息必须先加载本 skill 再处理**:① 消息开头是
|
|
6
6
|
「‹提醒:跨话题委托 · 原话题:…›」(你跨话题委托出去的消息,对端回复了);
|
|
7
7
|
② 消息开头是「‹【跨话题复查】原话题:…›」(复查通知)。
|
|
8
|
-
|
|
8
|
+
也用于:要联系当前会话以外的对象("帮我问一下 X"、"转告 Y"、"去查 Z")、
|
|
9
9
|
处理收到的委托、汇报回来源话题。
|
|
10
10
|
用户说"总结一下话题""总结话题""更新一下摘要""summarize this topic"时同样加载。
|
|
11
11
|
license: MIT
|
|
@@ -65,17 +65,20 @@ license: MIT
|
|
|
65
65
|
# 1. 找或建与 C 的话题
|
|
66
66
|
ec thread list <C的AID>
|
|
67
67
|
ec thread create <C的AID> --name '项目进度查询' # 没有合适话题时;返回裸 threadId
|
|
68
|
+
# 首次联系也可以直接写主话题 main:<本端AID>:<C的AID>,会话随首条消息建立
|
|
68
69
|
|
|
69
70
|
# 2. 发消息,--check-every 一步搞定复查
|
|
70
|
-
#
|
|
71
|
+
# 省略时默认 20m;取时长(5m / 30m / 2h / 1d)即建周期复查;
|
|
71
72
|
# 取 none 则只写 thread-inbox、不建复查(收尾汇报等不需要被叫醒的场景)
|
|
72
73
|
ecmsg send '项目当前进度如何?' --thread <裸threadId> --check-every 5m
|
|
73
74
|
|
|
74
75
|
# 3. 本 turn 结束,不阻塞
|
|
75
76
|
```
|
|
76
77
|
|
|
77
|
-
-
|
|
78
|
+
- 不写 `--to` / `--from`:接收方由话题和模式推出,跨话题默认就是委托给该话题的对端。
|
|
79
|
+
- `--thread` 不能是当前话题;话题的本端必须是当前会话本端。
|
|
78
80
|
- 副作用:本端写 thread-inbox +(非 none 时)创建复查。回执里 `trigger_id` 要记住,后面靠它取消。
|
|
81
|
+
- 创建复查 Trigger 时,必须按任务设置最长有效期(`--max-duration`)或最多运行轮数(`--max-runs`);由 `--check-every` 自动创建的,拿到回执中的 `trigger_id` 后用 `ec trigger update` 补设。
|
|
79
82
|
- 每 5 分钟向 T2 投递一条复查通知;C 若已回复,通知到达时 T2 上下文里就有 C 的回复。
|
|
80
83
|
|
|
81
84
|
### B. 处理收到的委托
|
|
@@ -109,7 +112,7 @@ ec thread history <来源话题id> --after <发送于的时间戳>
|
|
|
109
112
|
```bash
|
|
110
113
|
ec trigger delete <trig_id> # 完成:删除,不留残留
|
|
111
114
|
ec trigger update <trig_id> --every 30m # 放宽
|
|
112
|
-
ecmsg send 'C 回复:进度 70%' --thread <来源threadId> --check-every none #
|
|
115
|
+
ecmsg send 'C 回复:进度 70%' --thread <来源threadId> --check-every none # 汇报(跨话题委托,收尾不再复查)
|
|
113
116
|
```
|
|
114
117
|
|
|
115
118
|
**关键点**:
|
|
@@ -156,7 +159,7 @@ ec thread status current closed # 状态:active|clos
|
|
|
156
159
|
核心:**先拿覆盖游标 → 读增量 → 再写**。`summary set` 会把游标推进到当时最新一条,所以**必须先读完增量**,否则被跳过的消息下次不会再返回。
|
|
157
160
|
|
|
158
161
|
```bash
|
|
159
|
-
#
|
|
162
|
+
# 当前话题内总结(上次摘要后的对话都在上下文时,不用读历史;缺失则补读增量)
|
|
160
163
|
ec thread summary show current
|
|
161
164
|
ec thread summary set current '<100字以内摘要>' --name '动词短语描述的核心动作'
|
|
162
165
|
# --name 必填;不想改名显式传 --name -
|
|
@@ -170,9 +173,14 @@ ec thread summary set <threadId> '<摘要>' --name '新名称'
|
|
|
170
173
|
```
|
|
171
174
|
|
|
172
175
|
**摘要规范**:100 字以内,`[谁]做了[什么],结果[什么],遗留[什么]`;写给下次的自己看,不是给对端。
|
|
176
|
+
更新时合并旧摘要仍有效的目标、关键结果与待办/阻塞,删去已失效信息;不要只写最后一轮操作,丢掉恢复所需的任务背景。
|
|
173
177
|
**命名规范**:≤30 字(与客户端输入框同口径)、动词短语,别用"你好""话题会话";话题方向变了就顺手改名。
|
|
174
178
|
|
|
175
|
-
|
|
179
|
+
**主动做(不等用户开口)**:完整任务线收尾且有新成果 → 写摘要;方向重大转向 → 按需改名并更新摘要;跨话题交接缺少恢复信息 → 补齐摘要;转 `closed` 前 → 写最终摘要。单步操作不单独触发。
|
|
180
|
+
|
|
181
|
+
**主动更新限制**:成功写入后,接下来 3 轮对话不主动更新;用户明确要求总结、独立话题转 `closed` 前除外。
|
|
182
|
+
|
|
183
|
+
**语义判重**:更新前先对照旧摘要,没有新增恢复信息就不主动写。
|
|
176
184
|
|
|
177
185
|
### G. 生成工作报告
|
|
178
186
|
|
|
@@ -189,13 +197,15 @@ ec thread summary show <threadId>
|
|
|
189
197
|
| 错误码 | 处理 |
|
|
190
198
|
|---|---|
|
|
191
199
|
| `TOPIC_NOT_FOUND` | 用 `ec thread list <peer>` 核对 id;没有合适话题就 `ec thread create` |
|
|
192
|
-
| `
|
|
200
|
+
| `TOPIC_IS_CURRENT` | `--thread` 写成了当前话题:当前话题消息直接省略 `--thread` |
|
|
201
|
+
| `SELFMODE_REQUIRES_THREAD` | `--selfmode` 必须与 `--thread` 同用 |
|
|
202
|
+
| `FROM_NOT_ALLOWED` / `TO_REMOVED` | 托管会话不写 `--from` / `--to` |
|
|
193
203
|
| `TOPIC_BUSY` | 有任务在跑,等完成再删 |
|
|
194
204
|
|
|
195
205
|
**不要**:
|
|
196
206
|
1. 发完阻塞等回复——turn 已结束,回复会触发新 turn。
|
|
197
|
-
2. 漏掉 `--check-every
|
|
198
|
-
3.
|
|
207
|
+
2. 漏掉 `--check-every`——跨话题委托省略时默认 20m;不想被叫醒就显式 `none`,否则对端不回也会持续复查。
|
|
208
|
+
3. 托管会话里写 `--from` / `--to`:本端恒为会话本端,接收方由话题和模式推出。
|
|
199
209
|
4. 把复查通知当"强制回复"或执行脚本。
|
|
200
210
|
5. 在复查 turn 里再 `--check-every <时长>`(会套娃)。
|
|
201
211
|
6. 期望"等齐"原语,或期望话题名两端一致。
|
|
@@ -24,13 +24,13 @@ license: MIT
|
|
|
24
24
|
## 用法
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
|
-
python3 "
|
|
27
|
+
python3 "{{skillDir}}/scripts/download.py" "<文章URL>" "<输出目录>"
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
**示例:**
|
|
31
31
|
|
|
32
32
|
```bash
|
|
33
|
-
python3 "
|
|
33
|
+
python3 "{{skillDir}}/scripts/download.py" \
|
|
34
34
|
"https://mp.weixin.qq.com/s/xxxxxx" \
|
|
35
35
|
"./wechat-output"
|
|
36
36
|
```
|
|
@@ -30,13 +30,13 @@ license: MIT
|
|
|
30
30
|
## 用法
|
|
31
31
|
|
|
32
32
|
```bash
|
|
33
|
-
node "
|
|
33
|
+
node "{{skillDir}}/scripts/fetch.mjs" "<文章URL>" [输出目录]
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
**示例:**
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
|
-
node "
|
|
39
|
+
node "{{skillDir}}/scripts/fetch.mjs" \
|
|
40
40
|
"https://mp.weixin.qq.com/s/xxxxxx"
|
|
41
41
|
```
|
|
42
42
|
|
|
@@ -124,9 +124,9 @@ note 是零散的竖切面,会话历史能补上上下文——某条 note 是
|
|
|
124
124
|
| 协作关系 | 其他联系人及其联系方式、各方的角色划分、沟通渠道偏好、协作约定 |
|
|
125
125
|
| 约束与权限 | 明确的禁止事项、需要授权的操作、访问范围、资源配额 |
|
|
126
126
|
|
|
127
|
-
**触发条件**:对端在会话中**明确交代**这类信息,但没有形成 note
|
|
127
|
+
**触发条件**:对端在会话中**明确交代**这类信息,但没有形成 note;或者我自己在会话中**核实出**、且会改变后续判断的环境事实、技术结论(磁盘容量、网络限制、平台支持边界这类)。这时应补写记忆,否则压缩或新会话后就会忘记。
|
|
128
128
|
|
|
129
|
-
**判断标准**:是否满足「压缩后会丢 +
|
|
129
|
+
**判断标准**:是否满足「压缩后会丢 + 有实际影响」两个条件。对端说的是主要来源,我自己核实并实测过的事实同样算;闲聊、一次性状态、含糊的意向不写。
|
|
130
130
|
|
|
131
131
|
## 周期补漏的特殊情况
|
|
132
132
|
|
|
@@ -40,6 +40,8 @@
|
|
|
40
40
|
- ❌ 不允许:`ls "..."/*`(通配符不支持,用 Glob 代替)
|
|
41
41
|
- ❌ 不允许:`cmd1 && cmd2 && cmd3`(只允许单条命令或两条只读命令用 && 连接)
|
|
42
42
|
|
|
43
|
+
**引号写法**:`--desc`、正文、`--keywords` 一律用单引号包住。双引号里的反引号和 `$` 会被 shell 当成命令替换,整条命令会被拒绝。正文含单引号时改用 `$'…'`:内部单引号写 `\'`,换行写 `\n`。被拒时按运行时给出的报错文案改。
|
|
44
|
+
|
|
43
45
|
**任务书里已给出的可读路径**(复制粘贴即可):
|
|
44
46
|
- 批次目录:本次任务初始消息里的 `整理上下文文件路径` 的父目录
|
|
45
47
|
- processingDir / consolidatedDir / indexPath:任务书「整理目标」章节里列出
|
|
@@ -66,6 +68,48 @@
|
|
|
66
68
|
|
|
67
69
|
不值得写的:一次性任务的进展、临时状态、闲聊内容。不写记忆,在反馈里说明丢弃了哪些、为什么。
|
|
68
70
|
|
|
71
|
+
**已经常驻注入的内容不写记忆。** `soul/`、`$KITS_RULES`、`$KITS_FRAGMENTS`、MODULE.md 这些由 ECK 每轮载入,压缩不会丢。写进记忆只会变成第二份副本——改了一处,另一处就成了旧的。这类内容既不写正文,也不写指针。
|
|
72
|
+
|
|
73
|
+
## 等对端拍板的事项
|
|
74
|
+
|
|
75
|
+
结论还没定的选择可以写,但必须同时给出:
|
|
76
|
+
|
|
77
|
+
- 待定的是哪几项,各自的代价是什么;
|
|
78
|
+
- 拍板之后由哪种模式收口(通常就是下次 notes,凭 `pending` 扫到)。
|
|
79
|
+
|
|
80
|
+
`pending` 只表示「等确认」,不表示「正在做」。泛化和提升模式不得提升带 `pending` 的记忆——结论没定就升上去,等于把半成品扩散到更大的范围。
|
|
81
|
+
|
|
82
|
+
## 与别的 scope 的旧结论矛盾时
|
|
83
|
+
|
|
84
|
+
notes 只写 relation 作用域,但错误的旧结论可能已经泛化到 agent 级。发现矛盾时:
|
|
85
|
+
|
|
86
|
+
- 正文里点明纠正对象,写「纠正 <slug>:……」;
|
|
87
|
+
- 在反馈的「遗留」里单列,交给下一轮泛化模式去改那一条;
|
|
88
|
+
- 该写的关系级记忆照写,不要因为改不了别的 scope 就放弃。
|
|
89
|
+
|
|
90
|
+
## 正文里的时间
|
|
91
|
+
|
|
92
|
+
用对端本地时区,只写 `YYYY-MM-DD`,不写时分秒和时区标记。上下文文件和批次目录的时间戳是 UTC,会话里看到的是 +08;UTC 17:00 之后的事件本地已是次日,照抄会错一天。
|
|
93
|
+
|
|
94
|
+
## 可用的标签
|
|
95
|
+
|
|
96
|
+
| 标签 | 用在什么上 |
|
|
97
|
+
|---|---|
|
|
98
|
+
| rule | 工作方式上的正向约定 |
|
|
99
|
+
| prohibition | 明确禁止的事 |
|
|
100
|
+
| preference | 对端的稳定偏好、风格、习惯 |
|
|
101
|
+
| fact | 项目、环境、技术的客观事实 |
|
|
102
|
+
| decision | 已拍板的方向性结论 |
|
|
103
|
+
| feedback | 对端对我工作的纠正或评价 |
|
|
104
|
+
| context | 阶段背景,不属于以上几类 |
|
|
105
|
+
| important / urgent | 忘了会出事 / 当前就要用 |
|
|
106
|
+
| long-term | 长时间成立,不随任务结束过期 |
|
|
107
|
+
| verified / inferred | 对端确认过 / 我自己推断的,两者不同时贴 |
|
|
108
|
+
| in-progress / pending / blocked / cancelled / done | 任务状态,只能选一个 |
|
|
109
|
+
| to-generalize / to-promote | 待泛化 / 待提升,判据见 notes 模式的「什么时候打升级标记」 |
|
|
110
|
+
|
|
111
|
+
面向人阅读的完整说明在 `$KITS_DOCS/evolcore/memory-tags.md`。整理会话的可读范围不含它,需要的都在上表。
|
|
112
|
+
|
|
69
113
|
## update 还是 create --replaces
|
|
70
114
|
|
|
71
115
|
**update 改不了正文。** 内容一变,描述和关键词都得跟着变,那就 `create --replaces` 一条新的。
|
|
@@ -93,6 +137,8 @@ update 只用于正文不变、状态变了的情况:
|
|
|
93
137
|
- **模式**:本次模式(notes / generalize / promote / profile / forget)
|
|
94
138
|
- **处理结果**:新建 / 更新 / 归档的记忆条数
|
|
95
139
|
- **要点**:一句话概括这次整理做了什么(哪些主题的记忆被合并、提升、归档)
|
|
140
|
+
- **来源拆分**:来自 note 几条、主动补漏几条(有补漏时写)
|
|
141
|
+
- **遗留**:与别的 scope 的冲突、等对端拍板的事项、程序没覆盖的问题(有则写)
|
|
96
142
|
- 若本次无可整理内容(输出 `[[NOOP]]`),写一句说明即可,例如「本次没有可整理的 note,未产生改动」。
|
|
97
143
|
- 若过程中遇到异常(某条候选读不了、写入被拒),如实写出来。
|
|
98
144
|
- 不要在反馈文本里堆砌日志路径和原始文件列表——那些在批次目录里有,反馈是给人看的一句话级结论。
|
|
@@ -14,14 +14,23 @@ capabilities: {{capabilities}} # 当前渠道支持的能力
|
|
|
14
14
|
{{/}}
|
|
15
15
|
{{?channel=aun}}
|
|
16
16
|
{{?groupId}}
|
|
17
|
-
ecmsg send '<text>' [--file <path> --as image|video|voice|file] [--payload '<json>'] [--mention '<aid1>,<aid2>'] [--mention-all]
|
|
17
|
+
ecmsg send '<text>' [--file <path> --as image|video|voice|file|widget_card] [--payload '<json>'] [--mention '<aid1>,<aid2>'] [--mention-all]
|
|
18
18
|
群聊会话下 `ecmsg send` 即群内公开发送,无需写群 AID。
|
|
19
19
|
{{/}}
|
|
20
20
|
{{?peerId}}
|
|
21
|
-
ecmsg send '<text>' [--text-from-file <path>] [--encrypt yes|no|auto] [--file <path> --as image|video|voice|file] [--link <url> --title '<title>'] [--payload '<json>' --return none|required --timeout <duration> --format json]
|
|
21
|
+
ecmsg send '<text>' [--text-from-file <path>] [--encrypt yes|no|auto] [--file <path> --as image|video|voice|file|widget_card] [--link <url> --title '<title>'] [--payload '<json>' --return none|required --timeout <duration> --format json]
|
|
22
22
|
`ecmsg send` 在 proactive 下是正式回复;interactive 下普通回复直接输出,只在需要文件、链接或手动控制加密时才用。
|
|
23
|
-
|
|
24
|
-
|
|
23
|
+
需要把本地生成的报告、截图、补丁或其它文件交付给对端时,必须使用 `ecmsg send --file <path>` 发送附件,并可用 `--text '<说明>'` 添加说明;不要只在正文粘贴本地路径。附件源文件必须位于当前项目目录或当前会话 `$TMPDIR`,其它位置的文件先复制到这两个位置之一。只有明确要求对端在其工作区读取文件时,才发送路径文本。
|
|
24
|
+
能力调用:用户要“用我的手机/我的位置/拍个照/读某人的数据/调某个 AID 的能力”时,先解析主体——
|
|
25
|
+
{{?chatType=private}}
|
|
26
|
+
本私聊中“我/我的”指对端 `{{peerId}}`,“你/你的”指本 Agent `{{selfAid}}`。
|
|
25
27
|
{{/}}
|
|
28
|
+
{{?chatType=group}}
|
|
29
|
+
“我/我的”按当前消息发言人的 AID 解析,`peerId` 是群 AID。
|
|
30
|
+
{{/}}
|
|
31
|
+
主体明确后 `ec skill load ability`,按技能正文执行;不要在注入段里凭记忆拼 `ec ability remote` 参数。
|
|
32
|
+
`ec ability list --self` 是宿主插件管理,不是对端能力目录——空列表不代表对方手机没有能力。
|
|
33
|
+
{{/}}
|
|
34
|
+
WidgetCard:需要 HTML 表单交互时先读 `$KITS_DOCS/evolcore/msg.md`,生成一个带标准 name/value 控件的 form,再单独执行 `ecmsg send --file <html路径> --as widget_card --title '<标题>' --text '<说明>'`。通用脚本负责转 JSON;无需编写采集与发送脚本。回复以 widget_card_reply 关联原话题,App 需支持浏览器消息桥。
|
|
26
35
|
每次调用仍须遵守 `[reply]` 的单条命令及加密要求。
|
|
27
36
|
{{/}}
|