evolcore 0.0.41-test.0 → 0.0.41-test.1
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 +49 -0
- package/dist/agents/baseagent-availability.js +1 -1
- package/dist/agents/baseagent.js +20 -43
- package/dist/agents/claude-runner.js +177 -92
- package/dist/agents/codex-runner.js +84 -28
- package/dist/agents/ecagent-runner.js +1 -1
- package/dist/agents/gemini-runner.js +1 -1
- package/dist/aun/group/fs-download.js +39 -0
- package/dist/aun/group/identity.js +36 -21
- package/dist/aun/group/operations.js +5 -0
- package/dist/aun/msg/managed-operation.js +68 -7
- package/dist/aun/msg/p2p.js +5 -0
- package/dist/aun/service-proxy.js +36 -12
- package/dist/channels/aun.js +334 -20
- package/dist/channels/daemon.js +15 -1
- package/dist/cli/aun-commands.js +4 -20
- package/dist/cli/daemon-commands.js +678 -697
- package/dist/cli/fs-command.js +64 -2
- package/dist/cli/index.js +48 -4
- package/dist/cli/managed-command-guard.js +4 -0
- package/dist/cli/model.js +40 -40
- package/dist/cli/proxy-command.js +92 -0
- package/dist/cli/role.js +85 -0
- package/dist/config/access-policy.js +7 -2
- package/dist/config/boot-log.js +38 -1
- package/dist/config/config-field-policy.js +5 -32
- package/dist/config/config-manager.js +46 -39
- package/dist/config/config-operation-service.js +5 -19
- package/dist/config/contact-book-store.js +47 -21
- package/dist/config/contact-book.js +18 -12
- package/dist/config/contact-operation-service.js +3 -4
- package/dist/config/contact-request-service.js +11 -0
- package/dist/config/daemon-services.js +11 -0
- package/dist/config/gateway-config.js +88 -594
- package/dist/config/peer-role-resolver.js +13 -11
- package/dist/config/providers-config.js +12 -7
- package/dist/config/providers-import.js +3 -21
- package/dist/config/resolved-config-op.js +3 -0
- package/dist/config/role-command-service.js +166 -0
- package/dist/config/role-request-service.js +193 -0
- package/dist/config/schema-migration.js +686 -25
- package/dist/config-store.js +79 -3
- package/dist/contracts/ecweb-instance.js +41 -0
- package/dist/contracts/ecweb-service-protocol.js +3 -1
- package/dist/core/agent-runtime.js +1 -1
- package/dist/core/auth/agent-delegation.js +2 -1
- package/dist/core/auth/auth-gateway.js +1 -1
- package/dist/core/auth/authorization-audit.js +17 -6
- package/dist/core/auth/delegation-authorization.js +3 -1
- package/dist/core/auth/operation-authorizer.js +15 -0
- package/dist/core/auth/operation-catalog.js +31 -6
- package/dist/core/command/agent-control.js +3 -7
- package/dist/core/command/agent-storage-menu.js +5 -3
- package/dist/core/command/cli-intent-parser.js +2 -1
- package/dist/core/command/command-handler.js +48 -99
- package/dist/core/command/connect-menu.js +11 -3
- package/dist/core/command/data-root-resolver.js +5 -4
- package/dist/core/command/memory-slash.js +16 -8
- package/dist/core/command/menu-catalog.js +5 -6
- package/dist/core/command/menu-handler.js +49 -62
- package/dist/core/command/role-menu.js +147 -30
- package/dist/core/command/slash-handler.js +123 -254
- package/dist/core/daemon-control.js +8 -14
- package/dist/core/evolagent-registry.js +4 -4
- package/dist/core/evolagent.js +2 -2
- package/dist/core/inference/text-inference.js +31 -40
- package/dist/core/ipc-registration.js +6 -2
- package/dist/core/memory/consolidation-context.js +51 -5
- package/dist/core/memory/consolidation-ops-records.js +1 -1
- package/dist/core/memory/consolidation-trigger.js +189 -189
- package/dist/core/memory/consolidation.js +316 -29
- package/dist/core/memory/forget-log.js +96 -0
- package/dist/core/memory/index-manager.js +27 -5
- package/dist/core/memory/memory-admin.js +45 -5
- package/dist/core/memory/memory-writer.js +163 -18
- package/dist/core/memory/relation-idle-monitor.js +119 -58
- package/dist/core/memory/relation-sweep.js +44 -39
- package/dist/core/message/aun-ipc-sender.js +8 -2
- package/dist/core/message/im-renderer.js +7 -4
- package/dist/core/message/message-admission.js +89 -4
- package/dist/core/message/message-bridge.js +31 -18
- package/dist/core/message/response-engine.js +77 -8
- package/dist/core/model/catalog-service.js +4 -2
- package/dist/core/model/config-scope.js +24 -64
- package/dist/core/model/field-scope.js +1 -1
- package/dist/core/model/model-catalog.js +30 -41
- package/dist/core/model/model-diagnostics.js +4 -3
- package/dist/core/model/model-fallback.js +10 -7
- package/dist/core/model/model-permission.js +3 -2
- package/dist/core/ownership/owner-resolver.js +23 -21
- package/dist/core/permission/ec-command-parser.js +30 -2
- package/dist/core/permission/sandbox-runtime.js +18 -1
- package/dist/core/permission/tool-policy.js +14 -3
- package/dist/core/relation/peer-identity.js +64 -1
- package/dist/core/role/runtime-policy.js +72 -13
- package/dist/core/session/session-capsule.js +1 -1
- package/dist/core/session/session-idle-monitor.js +1 -1
- package/dist/core/session/session-manager.js +20 -0
- package/dist/core/session/session-renew.js +3 -3
- package/dist/core/skill/index-generator.js +15 -5
- package/dist/core/system-session/memory.js +6 -1
- package/dist/core/thread/thread-service.js +19 -6
- package/dist/directory/owner-directory-admission.js +95 -0
- package/dist/directory/owner-directory-authorization.js +309 -0
- package/dist/directory/owner-directory-cache.js +635 -0
- package/dist/eck/kit-renderer.js +2 -2
- package/dist/ecweb/basic-settings-service.js +33 -40
- package/dist/ecweb/message-context-service.js +110 -0
- package/dist/index.js +76 -14
- package/dist/ipc.js +170 -12
- package/dist/paths.js +4 -0
- package/dist/proxy/command.js +122 -0
- package/dist/proxy/ipc-service.js +68 -0
- package/dist/proxy/manager.js +485 -0
- package/dist/proxy/service-supervisor.js +603 -0
- package/dist/response-system/engines/v1/proactive-flow.js +16 -6
- package/dist/utils/cross-platform.js +14 -0
- package/dist/utils/ecweb-supervisor.js +258 -83
- package/dist/utils/error-utils.js +2 -2
- package/dist/utils/logger.js +24 -5
- package/dist/utils/package-version-info.js +4 -2
- package/kits/docs/channels/aun.md +9 -0
- package/kits/docs/evolcore/agent.md +1 -1
- package/kits/docs/evolcore/config.md +17 -6
- package/kits/docs/evolcore/contact.md +3 -0
- package/kits/docs/evolcore/fs.md +11 -0
- package/kits/docs/evolcore/memory-architecture.md +2 -2
- package/kits/docs/evolcore/memory-consolidation.md +32 -8
- package/kits/docs/evolcore/memory.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +4 -0
- package/kits/docs/evolcore/model.md +23 -20
- package/kits/docs/evolcore/msg.md +4 -7
- package/kits/migrations/migrate-contact-book-v2.mjs +30 -11
- package/kits/schemas/_meta.json +37 -4
- package/kits/schemas/agent-config.schema.13.json +8 -3
- package/kits/schemas/agent-config.schema.16.json +891 -0
- package/kits/schemas/daemon.schema.9.json +366 -0
- package/kits/schemas/defaults.schema.5.json +406 -127
- package/kits/schemas/relation-config.schema.11.json +260 -0
- package/kits/schemas/role-config.schema.1.json +7 -7
- package/kits/skills/.switches.json +3 -7
- package/kits/skills/ec-service-proxy/SKILL.md +118 -0
- package/kits/skills/ec-trigger/SKILL.md +13 -5
- package/kits/skills/personal-assistant/SKILL.md +176 -0
- package/kits/skills/personal-assistant/references/01-workspace-spec.md +333 -0
- package/kits/skills/personal-assistant/references/02-bootstrap.md +205 -0
- package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +177 -0
- package/kits/skills/personal-assistant/references/04-frontend-contract.md +439 -0
- package/kits/skills/personal-assistant/references/05-directory-reference.md +292 -0
- package/kits/skills/personal-assistant/references/06-render-config.md +350 -0
- package/kits/skills/personal-assistant/schema/workspace.schema.json +85 -0
- package/kits/skills/personal-assistant/schema/workspace.v1.json +66 -0
- package/kits/skills/personal-assistant/scripts/archive.mjs +154 -0
- package/kits/skills/personal-assistant/scripts/check.mjs +114 -0
- package/kits/skills/personal-assistant/scripts/index-rebuild.mjs +252 -0
- package/kits/skills/personal-assistant/scripts/ingest.mjs +344 -0
- package/kits/skills/personal-assistant/scripts/init.mjs +270 -0
- package/kits/skills/personal-assistant/scripts/lib/apply.mjs +92 -0
- package/kits/skills/personal-assistant/scripts/lib/schema.mjs +96 -0
- package/kits/skills/personal-assistant/scripts/lib/time.mjs +28 -0
- package/kits/skills/personal-assistant/scripts/migrate.mjs +172 -0
- package/kits/skills/personal-assistant/scripts/search.mjs +172 -0
- package/kits/skills/personal-assistant/scripts/verify.mjs +196 -0
- package/kits/skills/personal-assistant/templates/INDEX.md.tpl +24 -0
- package/kits/skills/personal-assistant/templates/README.md.tpl +108 -0
- package/kits/skills/personal-assistant/triggers/ingest-daily.json +23 -0
- package/kits/skills/personal-assistant/triggers/memory-consolidate.json +23 -0
- package/kits/skills/personal-assistant/triggers/report-daily.json +23 -0
- package/kits/skills/personal-assistant/triggers/report-weekly.json +23 -0
- package/kits/templates/memory-consolidation/forget.md +19 -6
- package/kits/templates/memory-consolidation/notes.md +1 -1
- package/kits/templates/memory-consolidation/profile.md +2 -2
- package/kits/templates/memory-consolidation/promote.md +20 -3
- package/kits/templates/roles/member.json +8 -1
- package/kits/templates/system-fragments/baseagent.md +2 -2
- package/kits/templates/system-fragments/memory.md +4 -4
- package/package.json +6 -2
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"$id": "relation-config.schema.11.json",
|
|
4
|
+
"title": "RelationConfig v11 (agents/{aid}/relations/{peerKey}/config.json)",
|
|
5
|
+
"x-logical-name": "relation-config",
|
|
6
|
+
"x-scope": "relation",
|
|
7
|
+
"type": "object",
|
|
8
|
+
"additionalProperties": true,
|
|
9
|
+
"not": {
|
|
10
|
+
"anyOf": [
|
|
11
|
+
{
|
|
12
|
+
"required": [
|
|
13
|
+
"permissionMode"
|
|
14
|
+
]
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"required": [
|
|
18
|
+
"roles"
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"required": [
|
|
23
|
+
"aun"
|
|
24
|
+
],
|
|
25
|
+
"properties": {
|
|
26
|
+
"aun": {
|
|
27
|
+
"type": "object",
|
|
28
|
+
"required": [
|
|
29
|
+
"defaultEncrypt"
|
|
30
|
+
]
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
]
|
|
35
|
+
},
|
|
36
|
+
"properties": {
|
|
37
|
+
"$schema_version": {
|
|
38
|
+
"type": "number",
|
|
39
|
+
"const": 11,
|
|
40
|
+
"default": 11,
|
|
41
|
+
"x-merge": "scalar"
|
|
42
|
+
},
|
|
43
|
+
"targetKind": {
|
|
44
|
+
"type": "string",
|
|
45
|
+
"enum": [
|
|
46
|
+
"private",
|
|
47
|
+
"group"
|
|
48
|
+
],
|
|
49
|
+
"x-merge": "scalar"
|
|
50
|
+
},
|
|
51
|
+
"role": {
|
|
52
|
+
"type": [
|
|
53
|
+
"string",
|
|
54
|
+
"null"
|
|
55
|
+
],
|
|
56
|
+
"pattern": "^(?!owner$)[a-z0-9_-]+$",
|
|
57
|
+
"x-merge": "scalar",
|
|
58
|
+
"description": "关系角色;允许 admin/member/visitor/自定义角色,禁止 owner"
|
|
59
|
+
},
|
|
60
|
+
"chatmode": {
|
|
61
|
+
"type": "object",
|
|
62
|
+
"x-merge": "dict",
|
|
63
|
+
"properties": {
|
|
64
|
+
"private": {
|
|
65
|
+
"enum": [
|
|
66
|
+
"interactive",
|
|
67
|
+
"proactive"
|
|
68
|
+
]
|
|
69
|
+
},
|
|
70
|
+
"group": {
|
|
71
|
+
"enum": [
|
|
72
|
+
"interactive",
|
|
73
|
+
"proactive"
|
|
74
|
+
]
|
|
75
|
+
},
|
|
76
|
+
"nothuman": {
|
|
77
|
+
"enum": [
|
|
78
|
+
"interactive",
|
|
79
|
+
"proactive"
|
|
80
|
+
]
|
|
81
|
+
}
|
|
82
|
+
},
|
|
83
|
+
"additionalProperties": false
|
|
84
|
+
},
|
|
85
|
+
"mentionMode": {
|
|
86
|
+
"type": "string",
|
|
87
|
+
"enum": [
|
|
88
|
+
"disabled",
|
|
89
|
+
"mention-only",
|
|
90
|
+
"auto"
|
|
91
|
+
],
|
|
92
|
+
"x-merge": "scalar"
|
|
93
|
+
},
|
|
94
|
+
"autoMentionQuietWindowMs": {
|
|
95
|
+
"type": "number",
|
|
96
|
+
"minimum": 0,
|
|
97
|
+
"default": 3000,
|
|
98
|
+
"x-merge": "scalar",
|
|
99
|
+
"description": "群聊 auto 注意力分类的静默等待窗口,单位为毫秒;默认 3000"
|
|
100
|
+
},
|
|
101
|
+
"sessionLoop": {
|
|
102
|
+
"type": "object",
|
|
103
|
+
"x-merge": "scalar",
|
|
104
|
+
"description": "当前关系主会话的闲置触发设置;话题不继承",
|
|
105
|
+
"oneOf": [
|
|
106
|
+
{
|
|
107
|
+
"properties": {
|
|
108
|
+
"enabled": {
|
|
109
|
+
"const": false
|
|
110
|
+
}
|
|
111
|
+
},
|
|
112
|
+
"required": [
|
|
113
|
+
"enabled"
|
|
114
|
+
],
|
|
115
|
+
"additionalProperties": false
|
|
116
|
+
},
|
|
117
|
+
{
|
|
118
|
+
"properties": {
|
|
119
|
+
"enabled": {
|
|
120
|
+
"const": true
|
|
121
|
+
},
|
|
122
|
+
"idleSeconds": {
|
|
123
|
+
"type": "integer",
|
|
124
|
+
"minimum": 30,
|
|
125
|
+
"maximum": 86400
|
|
126
|
+
}
|
|
127
|
+
},
|
|
128
|
+
"required": [
|
|
129
|
+
"enabled",
|
|
130
|
+
"idleSeconds"
|
|
131
|
+
],
|
|
132
|
+
"additionalProperties": false
|
|
133
|
+
}
|
|
134
|
+
]
|
|
135
|
+
},
|
|
136
|
+
"sessionFullAccess": {
|
|
137
|
+
"type": "object",
|
|
138
|
+
"x-merge": "scalar",
|
|
139
|
+
"description": "当前关系主会话的 /fa 开关,跨 EC session 保留;话题不继承,仅由 /fa 和 session Menu 管理",
|
|
140
|
+
"properties": {
|
|
141
|
+
"enabled": {
|
|
142
|
+
"type": "boolean"
|
|
143
|
+
},
|
|
144
|
+
"authorizedBy": {
|
|
145
|
+
"type": "string",
|
|
146
|
+
"minLength": 1
|
|
147
|
+
}
|
|
148
|
+
},
|
|
149
|
+
"required": [
|
|
150
|
+
"enabled",
|
|
151
|
+
"authorizedBy"
|
|
152
|
+
],
|
|
153
|
+
"additionalProperties": false
|
|
154
|
+
},
|
|
155
|
+
"responseMode": {
|
|
156
|
+
"type": "string",
|
|
157
|
+
"x-merge": "scalar"
|
|
158
|
+
},
|
|
159
|
+
"responseModeParams": {
|
|
160
|
+
"type": "object",
|
|
161
|
+
"x-merge": "dict"
|
|
162
|
+
},
|
|
163
|
+
"flush_delay": {
|
|
164
|
+
"type": "number",
|
|
165
|
+
"x-merge": "scalar"
|
|
166
|
+
},
|
|
167
|
+
"debounce": {
|
|
168
|
+
"type": "number",
|
|
169
|
+
"x-merge": "scalar"
|
|
170
|
+
},
|
|
171
|
+
"show_activities": {
|
|
172
|
+
"type": "string",
|
|
173
|
+
"enum": [
|
|
174
|
+
"all",
|
|
175
|
+
"text",
|
|
176
|
+
"none"
|
|
177
|
+
],
|
|
178
|
+
"x-merge": "scalar"
|
|
179
|
+
},
|
|
180
|
+
"enable_rich_content": {
|
|
181
|
+
"type": "boolean",
|
|
182
|
+
"x-merge": "scalar"
|
|
183
|
+
},
|
|
184
|
+
"session_renew": {
|
|
185
|
+
"type": "object",
|
|
186
|
+
"x-merge": "dict",
|
|
187
|
+
"additionalProperties": false,
|
|
188
|
+
"properties": {
|
|
189
|
+
"enabled": {
|
|
190
|
+
"type": "boolean"
|
|
191
|
+
},
|
|
192
|
+
"after_hours": {
|
|
193
|
+
"type": "number",
|
|
194
|
+
"exclusiveMinimum": 0
|
|
195
|
+
},
|
|
196
|
+
"fallback_action": {
|
|
197
|
+
"type": "string",
|
|
198
|
+
"enum": [
|
|
199
|
+
"continue",
|
|
200
|
+
"new"
|
|
201
|
+
]
|
|
202
|
+
},
|
|
203
|
+
"new_probability_threshold": {
|
|
204
|
+
"type": "number",
|
|
205
|
+
"minimum": 0,
|
|
206
|
+
"maximum": 1
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
},
|
|
210
|
+
"memory": {
|
|
211
|
+
"type": "object",
|
|
212
|
+
"x-merge": "dict",
|
|
213
|
+
"additionalProperties": false,
|
|
214
|
+
"description": "关系级记忆开关;enableRelation 由对端自主配置,与 agent 级 memory.enableRelation 做 AND 合并(任意层为 false 则关闭)。",
|
|
215
|
+
"properties": {
|
|
216
|
+
"enableRelation": {
|
|
217
|
+
"type": "boolean",
|
|
218
|
+
"x-merge-logic": "AND",
|
|
219
|
+
"description": "对端自主控制本关系的 relation 作用域记忆是否启用;与 agent 级 enableRelation 做 AND 合并。"
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
},
|
|
223
|
+
"group_venue_sync": {
|
|
224
|
+
"type": "object",
|
|
225
|
+
"x-merge": "dict"
|
|
226
|
+
},
|
|
227
|
+
"groupRules": {
|
|
228
|
+
"type": "object",
|
|
229
|
+
"x-merge": "dict",
|
|
230
|
+
"additionalProperties": false,
|
|
231
|
+
"properties": {
|
|
232
|
+
"mode": {
|
|
233
|
+
"type": "string",
|
|
234
|
+
"enum": [
|
|
235
|
+
"load",
|
|
236
|
+
"ignore"
|
|
237
|
+
],
|
|
238
|
+
"default": "load",
|
|
239
|
+
"description": "是否读取并注入当前 AUN 群已发布的 /rules.md;默认 load。"
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
},
|
|
243
|
+
"render": {
|
|
244
|
+
"type": "object",
|
|
245
|
+
"x-merge": "dict"
|
|
246
|
+
},
|
|
247
|
+
"sessionManifests": {
|
|
248
|
+
"type": "object",
|
|
249
|
+
"x-merge": "dict"
|
|
250
|
+
},
|
|
251
|
+
"extra_backup": {
|
|
252
|
+
"type": "array",
|
|
253
|
+
"items": {
|
|
254
|
+
"type": "object"
|
|
255
|
+
},
|
|
256
|
+
"x-merge": "list"
|
|
257
|
+
}
|
|
258
|
+
},
|
|
259
|
+
"description": "关系级配置。模型参数(模型、服务商、推理强度、降级链)只在 Agent 级 config.json 配置。"
|
|
260
|
+
}
|
|
@@ -10,13 +10,13 @@
|
|
|
10
10
|
{ "value": "chatmode.private", "label": "Private Chat Mode", "description": "角色在私聊场景中的响应方式策略。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "interactive", "label": "Interactive" }, { "value": "proactive", "label": "Proactive" }] },
|
|
11
11
|
{ "value": "chatmode.group", "label": "Group Chat Mode", "description": "角色在群聊场景中的响应方式策略。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "interactive", "label": "Interactive" }, { "value": "proactive", "label": "Proactive" }] },
|
|
12
12
|
{ "value": "mentionMode", "label": "Group Mention Mode", "description": "角色在群聊场景中的提及响应策略。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "disabled", "label": "Disabled" }, { "value": "mention-only", "label": "Mention Only" }, { "value": "auto", "label": "Auto" }] },
|
|
13
|
-
{ "value": "baseagents.claude.model", "label": "Claude Model", "description": "
|
|
14
|
-
{ "value": "baseagents.claude.effort", "label": "Claude Effort", "description": "角色使用 Claude 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied":
|
|
15
|
-
{ "value": "baseagents.codex.model", "label": "Codex Model", "description": "
|
|
16
|
-
{ "value": "baseagents.codex.effort", "label": "Codex Effort", "description": "角色使用 Codex 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied":
|
|
17
|
-
{ "value": "baseagents.ecagent.model", "label": "EC Agent Model", "description": "
|
|
18
|
-
{ "value": "baseagents.ecagent.effort", "label": "EC Agent Effort", "description": "角色使用 ecagent 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied":
|
|
19
|
-
{ "value": "baseagents.gemini.model", "label": "Gemini Model", "description": "
|
|
13
|
+
{ "value": "baseagents.claude.model", "label": "Claude Model", "description": "角色对 Agent 级 Claude 模型的约束(固定模型 / 模型白名单);模型只在 Agent 级配置,角色不提供模型。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": false, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Claude models" }, { "value": "claude-opus-*", "label": "Claude Opus family" }, { "value": "claude-sonnet-*", "label": "Claude Sonnet family" }, { "value": "claude-haiku-*", "label": "Claude Haiku family" }] },
|
|
14
|
+
{ "value": "baseagents.claude.effort", "label": "Claude Effort", "description": "角色使用 Claude 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": false, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
|
|
15
|
+
{ "value": "baseagents.codex.model", "label": "Codex Model", "description": "角色对 Agent 级 Codex 模型的约束(固定模型 / 模型白名单);模型只在 Agent 级配置,角色不提供模型。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": false, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Codex models" }, { "value": "gpt-5.4*", "label": "GPT-5.4 family" }, { "value": "gpt-5.3-codex*", "label": "GPT-5.3 Codex family" }] },
|
|
16
|
+
{ "value": "baseagents.codex.effort", "label": "Codex Effort", "description": "角色使用 Codex 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": false, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
|
|
17
|
+
{ "value": "baseagents.ecagent.model", "label": "EC Agent Model", "description": "角色对 Agent 级 ecagent 模型的约束(固定模型 / 模型白名单);模型只在 Agent 级配置,角色不提供模型。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": false, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All ecagent models" }] },
|
|
18
|
+
{ "value": "baseagents.ecagent.effort", "label": "EC Agent Effort", "description": "角色使用 ecagent 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": false, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
|
|
19
|
+
{ "value": "baseagents.gemini.model", "label": "Gemini Model", "description": "角色对 Agent 级 Gemini 模型的约束(固定模型 / 模型白名单);模型只在 Agent 级配置,角色不提供模型。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": false, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Gemini models" }, { "value": "gemini-*", "label": "Gemini model family" }] }
|
|
20
20
|
],
|
|
21
21
|
"type": "object",
|
|
22
22
|
"additionalProperties": false,
|
|
@@ -23,19 +23,15 @@
|
|
|
23
23
|
"enabled": true,
|
|
24
24
|
"locked": true
|
|
25
25
|
},
|
|
26
|
-
"ec-
|
|
27
|
-
"enabled": true,
|
|
28
|
-
"locked": false
|
|
29
|
-
},
|
|
30
|
-
"ec-identity": {
|
|
26
|
+
"ec-agent-create": {
|
|
31
27
|
"enabled": true,
|
|
32
28
|
"locked": false
|
|
33
29
|
},
|
|
34
|
-
"ec-
|
|
30
|
+
"ec-group-collaboration": {
|
|
35
31
|
"enabled": true,
|
|
36
32
|
"locked": false
|
|
37
33
|
},
|
|
38
|
-
"ec-
|
|
34
|
+
"ec-service-proxy": {
|
|
39
35
|
"enabled": true,
|
|
40
36
|
"locked": false
|
|
41
37
|
}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ec-service-proxy
|
|
3
|
+
description: >-
|
|
4
|
+
查询和管理当前 EvolCore daemon 的本地服务与 AUN ServiceProxy。用户询问代理状态、
|
|
5
|
+
服务是否在线,或要求创建、修改、发布、撤销、启动、停止、重启受管服务时使用。
|
|
6
|
+
不用于设计或实现新的 Ability Provider,也不用于 Menu 协议、Agent 创建或 npm 发版。
|
|
7
|
+
license: MIT
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# EC ServiceProxy
|
|
11
|
+
|
|
12
|
+
用 ec proxy 管理当前 daemon 的 services 配置、AUN 代理发布,以及明确标记为 managed 的本地服务。
|
|
13
|
+
先查询当前状态;写操作必须用查询所得的 configRev 做 CAS。不要直接编辑 daemon.json。
|
|
14
|
+
|
|
15
|
+
## 查询
|
|
16
|
+
|
|
17
|
+
1. 列出服务和代理目标:
|
|
18
|
+
|
|
19
|
+
~~~bash
|
|
20
|
+
ec proxy list --format json
|
|
21
|
+
~~~
|
|
22
|
+
|
|
23
|
+
2. 查看服务的配置摘要和版本:
|
|
24
|
+
|
|
25
|
+
~~~bash
|
|
26
|
+
ec proxy show <service-name> --format json
|
|
27
|
+
ec proxy status <service-name> --format json
|
|
28
|
+
~~~
|
|
29
|
+
|
|
30
|
+
status 包含 runtime.state、健康状态、失败次数和 configRev。ServiceProxy 的 Gateway 登记与
|
|
31
|
+
本地代理隧道是分开的;proxy.proxyServer=unconfirmed 表示当前 SDK 没有向管理器暴露
|
|
32
|
+
ProxyServer 的发布确认,不能把它说成已完全验证。
|
|
33
|
+
|
|
34
|
+
3. 查看访问信息:
|
|
35
|
+
|
|
36
|
+
~~~bash
|
|
37
|
+
ec proxy access <service-name> --format json
|
|
38
|
+
~~~
|
|
39
|
+
|
|
40
|
+
只有返回权威访问地址时才提供给用户。accessState=unresolved 或 url=null 表示目前无法确认
|
|
41
|
+
HTTP 入口;不要从 AID 或服务名自行拼 URL。代理入口也不代表已获被代理应用的登录权限。
|
|
42
|
+
|
|
43
|
+
## 配置
|
|
44
|
+
|
|
45
|
+
服务定义使用 daemon services[]。创建前用 ec proxy list 确认服务名未占用。service JSON 至少
|
|
46
|
+
包含 name 和 enabled;启用 AUN 代理还需要 proxy.enabled、proxy.source 和 proxy.visibility。
|
|
47
|
+
source=instance 从已登记的本机实例读取端口;source=static 需要本地回环地址 proxy.endpoint。
|
|
48
|
+
|
|
49
|
+
如果要让 daemon 启动并守护服务,必须明确设置 runtime.mode=managed 以及绝对路径的
|
|
50
|
+
runtime.command.file;参数使用 args 数组,不要写 shell 命令字符串。external 配置 port 后可监控健康,
|
|
51
|
+
不由 EvolCore 启停。ECWeb 也属于 managed,其启动入口由内部适配器确定,无需且不允许配置 command。
|
|
52
|
+
模式省略时 ECWeb 默认 managed,其余服务默认 external。
|
|
53
|
+
|
|
54
|
+
定义中 command 使用 executable 和 argv,不经 shell。创建定义示例:
|
|
55
|
+
|
|
56
|
+
~~~bash
|
|
57
|
+
ec proxy build --json '{"name":"reports","enabled":true,"port":43100,"runtime":{"mode":"managed","command":{"file":"/usr/bin/node","args":["server.js"],"cwd":"/srv/reports"},"restart":{"enabled":true,"backoffMs":5000}},"health":{"type":"http","path":"/health"},"proxy":{"enabled":true,"source":"instance","visibility":"private"}}' --if-rev absent --operation-id create-reports-20261029-1 --format json
|
|
58
|
+
~~~
|
|
59
|
+
|
|
60
|
+
--json 是单个服务对象。更新使用 patch:
|
|
61
|
+
|
|
62
|
+
~~~bash
|
|
63
|
+
ec proxy update reports --json '{"health":{"type":"http","path":"/health","failureThreshold":3}}' --if-rev <configRev> --operation-id update-reports-20261029-1 --format json
|
|
64
|
+
~~~
|
|
65
|
+
|
|
66
|
+
managed task 中优先使用 --json,使获批命令参数绑定完整定义内容。宿主终端可用 --file 读取本机
|
|
67
|
+
JSON;此路径在 managed task 中被拒绝。Shell 正文中的单引号按托管 shell 规则转义。
|
|
68
|
+
|
|
69
|
+
每次写操作使用新的 operation-id。同一逻辑操作重试时复用原 ID;参数内容不同必须换新 ID。
|
|
70
|
+
更新、发布、撤销、启停、重载和删除前,先查询最新 configRev 并传 --if-rev。发生 CONFLICT 时
|
|
71
|
+
重新查询后再决定,不能去掉 CAS 继续。
|
|
72
|
+
|
|
73
|
+
## 发布与生命周期
|
|
74
|
+
|
|
75
|
+
构建或更新定义会保存配置并热应用,不要求重启 daemon。publish 只启用 AUN 代理;服务还未启用时
|
|
76
|
+
会拒绝,不会暗中启动服务。unpublish 只撤销 AUN 代理,保留本地运行状态。
|
|
77
|
+
|
|
78
|
+
~~~bash
|
|
79
|
+
ec proxy publish <name> --if-rev <configRev> --operation-id <unique-id> --format json
|
|
80
|
+
ec proxy unpublish <name> --if-rev <configRev> --operation-id <unique-id> --format json
|
|
81
|
+
~~~
|
|
82
|
+
|
|
83
|
+
start / stop 修改本地服务启用状态,支持 managed(含 ECWeb 内部适配器);external 服务须由原来的系统
|
|
84
|
+
服务管理器操作。stop 会撤销该服务的代理入口并停止受管进程;之后重新 start 时,代理是否恢复取决于
|
|
85
|
+
保留的 proxy.enabled 配置。
|
|
86
|
+
|
|
87
|
+
~~~bash
|
|
88
|
+
ec proxy start <name> --if-rev <configRev> --operation-id <unique-id> --format json
|
|
89
|
+
ec proxy stop <name> --if-rev <configRev> --operation-id <unique-id> --format json
|
|
90
|
+
ec proxy restart <name> --if-rev <configRev> --operation-id <unique-id> --format json
|
|
91
|
+
ec proxy reload <name> --if-rev <configRev> --operation-id <unique-id> --format json
|
|
92
|
+
~~~
|
|
93
|
+
|
|
94
|
+
restart / reload 按 runtime.mode 执行:managed 经其 supervisor 或内部适配器重新启动,external 拒绝进程控制。
|
|
95
|
+
普通 managed 服务等待健康检查就绪;ECWeb 启动后由实例发现检查就绪。reload 与 restart 等价,可能中断连接。
|
|
96
|
+
暂不支持文件监听热重载、原生信号重载或滚动发布,不要配置 runtime.reload 或 services[].watch。
|
|
97
|
+
|
|
98
|
+
## 监听与守护
|
|
99
|
+
|
|
100
|
+
- 运行状态周期检查进程和配置的 HTTP/TCP 健康探针,默认连续失败 3 次才触发恢复,成功一次清零连续失败数。
|
|
101
|
+
- TCP 启动中每 500 ms、运行中每 10 秒检查;HTTP 启动中每 1 秒、运行中每 15 秒检查,频率固定。
|
|
102
|
+
- managed 服务在 15 分钟内最多自动重试 3 次,默认等待 5、10、20 秒;仅 backoffMs 可调整初始等待。
|
|
103
|
+
- runtime.restart.enabled 默认 true,非主动退出(含退出码 0)及连续健康失败均尝试恢复;false 只监控。
|
|
104
|
+
- 恢复开关同样适用于 ECWeb,修改开关不重启健康服务,关闭开关会取消待执行的恢复任务。
|
|
105
|
+
- 恢复开关不禁止手动启停;external 无论开关取何值,都不操作进程。不再使用 builtin 或 restart.policy。
|
|
106
|
+
- 进程崩溃和健康检查失败共用重试额度。额度耗尽后进入 failed。先查询状态;确认原因并修复后,再运行
|
|
107
|
+
ec proxy reset-failure <name> --if-rev <configRev> --operation-id <unique-id>。
|
|
108
|
+
- 主动 stop 或 disabled 的服务不会被后台重新启动。
|
|
109
|
+
- managed 服务的进程只会按 supervisor 写入的 PID 和启动时间记录管理;不要建议按端口强杀进程。
|
|
110
|
+
|
|
111
|
+
变更后用 ec proxy status <name> 复核 desired 配置、进程健康和代理登记状态。写操作返回失败时读取
|
|
112
|
+
具体错误码处理;不要重复发送不确定的 start/restart 操作。
|
|
113
|
+
|
|
114
|
+
## 权限边界
|
|
115
|
+
|
|
116
|
+
服务状态查询由当前 Agent owner 权限授权;改动 daemon 级服务配置、发布代理及控制进程需要
|
|
117
|
+
DaemonOwner。Agent owner、permissionMode=bypass 和 skill 指令都不能提升为 DaemonOwner。
|
|
118
|
+
遇到 DAEMON_OWNER_REQUIRED 时停止写操作,并说明需要进程控制权限;不换命令、身份或配置入口绕过。
|
|
@@ -36,18 +36,24 @@ license: MIT
|
|
|
36
36
|
| 类型 | 谁在执行 | 用在哪 | 坑 |
|
|
37
37
|
|---|---|---|---|
|
|
38
38
|
| `trigger-session` | daemon 专属的 trigger 会话,**与用户对话隔离** | 周期巡检、生成摘要、独立判断。默认同 trigger 复用一条会话 | 只有它支持 `--baseagent`;`--trigger-thread per-run` 每次都开新会话 |
|
|
39
|
-
| `target-session` | 把提示词**当成一条消息**投进目标会话,由那个会话的 agent 处理 |
|
|
39
|
+
| `target-session` | 把提示词**当成一条消息**投进目标会话,由那个会话的 agent 处理 | 要在用户的对话里、带着上下文做的**轻量**事;跨话题复查(`--check-every`) | 不支持 `feedback=silent`;也不支持 `execution.thread`。**不跑复杂任务**(见下) |
|
|
40
40
|
| `script` | 确定性脚本,不过模型 | 只看数、查文件、调 IPC、算东西——**不需要模型判断**时优先用,又快又便宜 | 走沙箱,脚本不能读受保护路径;宿主执行要求独立批准 |
|
|
41
41
|
|
|
42
|
-
**结论**:用户要"看到结果"→
|
|
43
|
-
|
|
42
|
+
**结论**:用户要"看到结果"→ trigger-session 跑完,用 target feedback 把**结论**投到用户会话。
|
|
43
|
+
用户要"带着对话上下文做点小事"(复查提醒、追问、确认,几句话内完成)→ target-session。
|
|
44
|
+
用户要"有人替我去做判断"→ trigger-session。脚本能做的别用模型。
|
|
45
|
+
|
|
46
|
+
**target-session 不跑复杂任务**:它就在用户的会话里执行,中间过程全部挤进用户上下文,
|
|
47
|
+
执行期间还占用该会话(后到触发与用户消息都排队)。凡是生成/分析/巡检类输出可能超过
|
|
48
|
+
几句话的,一律 trigger-session 跑完再投递结论,别把重活塞进用户的主会话。
|
|
44
49
|
|
|
45
50
|
## 三、投递目标:结果落在哪
|
|
46
51
|
|
|
47
|
-
`feedback.strategy`
|
|
52
|
+
`feedback.strategy` 四个可用值:
|
|
48
53
|
|
|
49
54
|
- **`target`** — 送到 `--target-*` 指定的会话。**最常用**。
|
|
50
55
|
- **`origin`** — 送回创建它的那条会话。在某个话题里建、想回到该话题,用这个(比手写 target 稳)。
|
|
56
|
+
- **`event_session`** — 事件触发专属:路由回**事件来源的那个会话**(如 `task:error` 回到出错会话、`session:idle` 回到闲置会话),复用其上下文与加密状态;找不到原会话时失败关闭。只在事件源下有意义。
|
|
51
57
|
- **`silent`** — 不投递结果,只做副作用(只用于 `trigger-session` / `script`)。
|
|
52
58
|
|
|
53
59
|
单聊最省事的写法(AUN):
|
|
@@ -82,7 +88,9 @@ ec trigger create --cron '0 9 * * *' --tz Asia/Shanghai \
|
|
|
82
88
|
|
|
83
89
|
## 五、反直觉的语义(文档没写透的)
|
|
84
90
|
|
|
85
|
-
- **cron
|
|
91
|
+
- **cron 按"下一个匹配时刻"计算,不是从创建时刻加整周期**:17:41 建 `0 */2 * * *`,
|
|
92
|
+
`*/2` 匹配的是偶数小时(0/2/…/18),下一个匹配是 18:00——想"从现在起每 2 小时",
|
|
93
|
+
要按当前时刻对齐写表达式(如 `0 17-23/2 * * *`),或改用 `--every 2h`(真正的相对间隔)。
|
|
86
94
|
- **一次性来源自动关**:`--once` / `--delay` / `--at` 跑完一轮自动 `disable`,定义保留。
|
|
87
95
|
- **错过的时间点合并**:默认 `missedPolicy=run_once`,daemon 停机期间错过的几次只补跑一次。
|
|
88
96
|
- **并发**:默认 `forbid`——同一会话正被另一个 run 占用时,**后到的直接被 skip**;
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: personal-assistant
|
|
3
|
+
description: >-
|
|
4
|
+
个人助理工作区:把对话正文、记忆、手机观察、用户投喂、会议等原料落地成本地纯文本资产,
|
|
5
|
+
并产出日报/周报/月报、任务清单、画像、主题梳理。当用户要求"初始化个人助理/个人助手"、
|
|
6
|
+
"建助理工作区"、"安装个人助理",或要求归档对话、生成日报周报月报、整理记忆、管理任务、
|
|
7
|
+
检查工作区结构、升级工作区时使用。核心特征是数据主权:所有数据独立于宿主软件,
|
|
8
|
+
可被任意文本工具读取。
|
|
9
|
+
不适用于:单纯的日程查询(用日历能力)、群聊协作(用 ec-group-collaboration)、
|
|
10
|
+
技能系统本身的管理(用 ec-skill)。
|
|
11
|
+
license: MIT
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
# 个人助理
|
|
15
|
+
|
|
16
|
+
把一个人(owner)的数字生活,落成本地可读、可检索、可长期保管的文本资产。
|
|
17
|
+
|
|
18
|
+
**核心命题**:数据不能寄生在宿主软件里。宿主会升级、会改格式、会丢东西。
|
|
19
|
+
这里落地的是**档案**,不是缓存。
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 一、先判断当前处于哪个阶段
|
|
24
|
+
|
|
25
|
+
| 用户说什么 | 你该做什么 | 走哪节 |
|
|
26
|
+
|---|---|---|
|
|
27
|
+
| "初始化个人助理" | 建一个全新工作区 | §三 |
|
|
28
|
+
| "检查工作区" / "结构对不对" | 只读体检,不改任何东西 | §四 |
|
|
29
|
+
| "升级工作区" / "同步到新版本" | 先体检,再按迁移修正 | §五 |
|
|
30
|
+
| "生成日报/周报" | 直接产出报告 | §六 |
|
|
31
|
+
| "记一下这个" | 当场落地一条原料 | §七 |
|
|
32
|
+
|
|
33
|
+
**初始化之前必须先体检**。已有工作区时,初始化等于修复,不是推倒重来。
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## 二、三种驱动力,不许混用
|
|
38
|
+
|
|
39
|
+
| 驱动力 | 管什么 | 谁用 |
|
|
40
|
+
|---|---|---|
|
|
41
|
+
| 触发器(`ec trigger`) | 什么时候做 | 定时任务、事件订阅 |
|
|
42
|
+
| 模型(你) | 这次该做什么、写什么内容 | 判断、生成正文 |
|
|
43
|
+
| 脚本(`scripts/*.mjs`) | 具体怎么做 | 写文件、算摘要、校验 |
|
|
44
|
+
|
|
45
|
+
**规则**:
|
|
46
|
+
- 能用脚本做的,不要你用语言"手工"做——不确定、贵、会漂移
|
|
47
|
+
- 需要判断的,不要硬塞给脚本——规则写不全
|
|
48
|
+
- 脚本一律用**绝对路径**调用:`node "<技能目录>/scripts/xxx.mjs"`
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## 三、初始化
|
|
53
|
+
|
|
54
|
+
调用:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
node "<技能目录>/scripts/init.mjs" --workspace "<工作区绝对路径>" --owner "<owner AID>"
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
脚本会:检查前置条件 → 建目录 → 写 README/INDEX → 写 `.assistant/state.json` →
|
|
61
|
+
按需安装触发器 → 输出验收清单。
|
|
62
|
+
|
|
63
|
+
**装完必须报告三件事**:建了什么、装了什么触发器、**哪些能力不可用**(不要隐瞒降级)。
|
|
64
|
+
|
|
65
|
+
详细流程见 `references/02-bootstrap.md`。
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 四、体检(只读)
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
node "<技能目录>/scripts/check.mjs" --workspace "<工作区绝对路径>"
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
输出四类结论:
|
|
76
|
+
|
|
77
|
+
| 结论 | 含义 | 处置 |
|
|
78
|
+
|---|---|---|
|
|
79
|
+
| `OK` | 结构与当前 schema 一致 | 什么都不做 |
|
|
80
|
+
| `MISSING` | schema 要求但工作区没有 | 可安全补建 |
|
|
81
|
+
| `EXTRA` | 工作区有但 schema 没定义 | **不动**,只报告 |
|
|
82
|
+
| `DRIFT` | 版本落后,有未执行的迁移 | 需升级 |
|
|
83
|
+
|
|
84
|
+
`check` 永不写文件。它只告诉你差在哪。
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 五、升级
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
node "<技能目录>/scripts/check.mjs" --workspace "<路径>" # 1. 先看差什么
|
|
92
|
+
node "<技能目录>/scripts/migrate.mjs" --workspace "<路径>" # 2. 执行迁移
|
|
93
|
+
node "<技能目录>/scripts/check.mjs" --workspace "<路径>" # 3. 复查
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
迁移的硬规则:
|
|
97
|
+
|
|
98
|
+
1. **只做加法**:建目录、补字段、改元数据。**永不删用户数据。**
|
|
99
|
+
2. **可回滚**:每次迁移前把结构快照写进 `.assistant/logs/migrate-<ts>.json`
|
|
100
|
+
3. **幂等**:同一步迁移重复执行不产生副作用
|
|
101
|
+
4. **顺序执行**:从工作区当前版本逐级升到目标版本,不跳级
|
|
102
|
+
5. **`EXTRA` 不清理**:用户自己建的目录一律保留
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 六、产出报告
|
|
107
|
+
|
|
108
|
+
| 报告 | 原料 | 要点 |
|
|
109
|
+
|---|---|---|
|
|
110
|
+
| 日报 | 当天 `capture/` 全部 | 发生了什么、还剩什么、明天该做什么 |
|
|
111
|
+
| 周报 | 本周日报 + 任务 | 进展、卡点、下周重点 |
|
|
112
|
+
| 月报 | 本月周报 + 画像/主题变化 | 趋势,不是流水 |
|
|
113
|
+
|
|
114
|
+
**每条产物必须带 `source:`**,指向支撑它的原料路径。没有来源的结论不要写。
|
|
115
|
+
|
|
116
|
+
报告模板在 `references/01-workspace-spec.md` §3.2。
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## 七、当场落地一条原料
|
|
121
|
+
|
|
122
|
+
用户随口说的、转发的、发的照片,立刻落,不要攒:
|
|
123
|
+
|
|
124
|
+
| 类型 | 落点 | 要点 |
|
|
125
|
+
|---|---|---|
|
|
126
|
+
| 想法/口述 | `capture/notes/年/月/` | 原文照录,不要润色 |
|
|
127
|
+
| 链接 | `capture/links/年/月/` | **必须写摘要**——链接会失效 |
|
|
128
|
+
| 文件 | `capture/files/年/月/` | 原件 + 一条说明 |
|
|
129
|
+
| 现场照片 | `capture/scene/年/月/` | 照片引用 + 位置 + 一句话描述 |
|
|
130
|
+
|
|
131
|
+
**归不了类的,先丢 `capture/_inbox/`。** 绝不因为"不确定放哪"而拒收。
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## 八、边界
|
|
136
|
+
|
|
137
|
+
**不做**:
|
|
138
|
+
- 不做向量库、不上数据库。文本 + 目录 + grep 够了
|
|
139
|
+
- 不做实时同步。批处理落地,不追求强一致
|
|
140
|
+
- 不存录音和原图本体,只存引用和元数据
|
|
141
|
+
- 不替代宿主自带的运行时记忆——那套为上下文服务,这套为持久服务,并存
|
|
142
|
+
|
|
143
|
+
**不知道就说不知道**:能力缺口、权限不足、环境不支持,直接报,不要假装做成了。
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## 九、参考资料
|
|
148
|
+
|
|
149
|
+
| 文件 | 内容 |
|
|
150
|
+
|---|---|
|
|
151
|
+
| `references/01-workspace-spec.md` | 目录结构、每项目录的用途、流转机制、归档与检索 |
|
|
152
|
+
| `references/02-bootstrap.md` | 初始化流程、触发器清单、幂等与升级 |
|
|
153
|
+
| `references/03-data-flow-and-gaps.md` | 三种驱动力、实测记录、能力缺口清单、MVP 边界 |
|
|
154
|
+
| `references/04-frontend-contract.md` | 前端数据契约:frontmatter 字段、type 一览、解析规则 |
|
|
155
|
+
| `references/05-directory-reference.md` | 目录速查:各目录用途、生成时机、格式、流转机制 |
|
|
156
|
+
| `references/06-render-config.md` | 渲染配置:统一渲染模型、五种 layout、各目录 render.yaml 示例 |
|
|
157
|
+
| `schema/workspace.schema.json` | 目标结构的机器可读定义(`check` 依据) |
|
|
158
|
+
| `schema/migrations/` | 版本迁移步骤 |
|
|
159
|
+
|
|
160
|
+
主会话只读 SKILL.md。需要细节时按上表取用,不要一次全读。
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## 十、能力缺失时的说法
|
|
165
|
+
|
|
166
|
+
本技能的多项能力依赖宿主环境,已实测确认当前可能不可用:**脚本型触发器**、**手机观察数据读取**、
|
|
167
|
+
**跨对端历史导出**。
|
|
168
|
+
|
|
169
|
+
遇到这些时:
|
|
170
|
+
|
|
171
|
+
1. 明确说出"这一项现在做不了"
|
|
172
|
+
2. 说清原因(环境限制 / 权限 / 宿主未开放)
|
|
173
|
+
3. 给出替代方案或留占位
|
|
174
|
+
4. **不要把"留了空目录"说成"已经能落地"**
|
|
175
|
+
|
|
176
|
+
完整缺口清单见 `references/03-data-flow-and-gaps.md` §4。
|