evolcore 0.0.40 → 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 +94 -1
- package/bin/codex-managed-hook.mjs +11 -0
- package/bin/ec-safe-output.js +11 -1
- package/dist/agents/baseagent-availability.js +1 -1
- package/dist/agents/baseagent.js +20 -43
- package/dist/agents/claude-runner.js +197 -197
- package/dist/agents/codex-runner.js +535 -259
- package/dist/agents/ecagent-runner.js +31 -12
- package/dist/agents/gemini-runner.js +27 -7
- package/dist/agents/runner-types.js +11 -3
- package/dist/aun/ability-device-routing.js +26 -0
- package/dist/aun/aid/client.js +1 -1
- package/dist/aun/group/fs-download.js +39 -0
- package/dist/aun/group/identity.js +36 -13
- package/dist/aun/group/operations.js +5 -0
- package/dist/aun/msg/managed-operation.js +72 -11
- package/dist/aun/msg/p2p.js +32 -7
- package/dist/aun/service-proxy.js +36 -12
- package/dist/aun/storage/download.js +30 -0
- package/dist/aun/storage/index.js +14 -6
- package/dist/channels/aun.js +367 -24
- package/dist/channels/daemon.js +39 -5
- package/dist/cli/agent-command.js +2 -0
- package/dist/cli/agent-create.js +98 -19
- package/dist/cli/agent.js +10 -3
- package/dist/cli/aun-commands.js +85 -41
- package/dist/cli/daemon-commands.js +678 -688
- 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/restart-monitor.js +17 -0
- package/dist/cli/role.js +85 -0
- package/dist/cli/session-command.js +128 -13
- package/dist/cli/stats.js +60 -4
- package/dist/cli/trigger-command.js +2 -2
- package/dist/config/access-policy.js +8 -1
- 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 +8 -11
- 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 +89 -595
- package/dist/config/peer-role-resolver.js +15 -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-application-service.js +11 -1
- package/dist/core/agent-ipc-registration.js +4 -0
- package/dist/core/agent-runtime.js +1 -1
- package/dist/core/auth/agent-delegation.js +82 -6
- package/dist/core/auth/auth-gateway.js +1 -1
- package/dist/core/auth/authorization-audit.js +37 -9
- 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 +39 -6
- package/dist/core/command/agent-control.js +94 -19
- 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 +105 -145
- package/dist/core/command/connect-menu.js +31 -2
- 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 +6 -6
- package/dist/core/command/menu-handler.js +87 -163
- package/dist/core/command/menu-protocol.js +9 -2
- package/dist/core/command/role-menu.js +148 -30
- package/dist/core/command/slash-gate.js +13 -10
- package/dist/core/command/slash-handler.js +157 -352
- package/dist/core/daemon-control.js +8 -14
- package/dist/core/event-catalog.js +15 -0
- 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 +24 -3
- 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 +190 -190
- 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 +34 -7
- package/dist/core/message/aun-request-registry.js +97 -3
- package/dist/core/message/im-renderer.js +11 -4
- package/dist/core/message/message-admission.js +97 -8
- package/dist/core/message/message-bridge.js +71 -24
- package/dist/core/message/message-log.js +55 -0
- package/dist/core/message/message-queue.js +5 -5
- package/dist/core/message/response-engine.js +387 -144
- 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 +37 -47
- 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 +25 -23
- package/dist/core/permission/ec-command-parser.js +138 -5
- package/dist/core/permission/sandbox-runtime.js +18 -1
- package/dist/core/permission/tool-policy.js +42 -10
- 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 +197 -0
- package/dist/core/session/session-idle-monitor.js +1 -1
- package/dist/core/session/session-manager.js +168 -14
- package/dist/core/session/session-mapper.js +2 -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 +79 -17
- package/dist/ipc.js +189 -17
- 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/stats/budget.js +1 -1
- package/dist/stats/db.js +15 -0
- package/dist/stats/index.js +2 -2
- package/dist/stats/price-resolver.js +304 -5
- package/dist/stats/query.js +82 -3
- package/dist/stats/writer.js +38 -5
- package/dist/trigger/feedback.js +18 -7
- package/dist/trigger/manager.js +20 -3
- package/dist/trigger/parser.js +6 -3
- package/dist/trigger/patch.js +1 -1
- package/dist/trigger/system-definitions.js +43 -7
- package/dist/trigger/validation.js +13 -5
- package/dist/utils/cross-platform.js +14 -0
- package/dist/utils/ecweb-supervisor.js +258 -83
- package/dist/utils/error-utils.js +16 -2
- package/dist/utils/logger.js +24 -5
- package/dist/utils/npm-ops.js +2 -1
- package/dist/utils/package-version-info.js +5 -3
- package/dist/utils/upgrade-jobs.js +45 -5
- package/kits/docs/INDEX.md +1 -1
- package/kits/docs/aun/ABILITY_CALLING.md +20 -2
- package/kits/docs/channels/aun.md +9 -0
- package/kits/docs/evolcore/INDEX.md +2 -1
- package/kits/docs/evolcore/agent-create.md +3 -2
- package/kits/docs/evolcore/agent.md +1 -1
- package/kits/docs/evolcore/config.md +18 -7
- package/kits/docs/evolcore/contact.md +3 -0
- package/kits/docs/evolcore/event.md +1 -0
- package/kits/docs/evolcore/fs.md +16 -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 +36 -0
- package/kits/docs/evolcore/model.md +23 -20
- package/kits/docs/evolcore/msg.md +21 -8
- package/kits/docs/evolcore/session.md +14 -0
- 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 +23 -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/aid-ability/SKILL.md +35 -6
- 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/session-capsule/recovery.md +5 -0
- package/kits/templates/session-capsule/renew.md +5 -0
- package/kits/templates/system-fragments/baseagent.md +2 -2
- package/kits/templates/system-fragments/bootstrap.md +6 -6
- package/kits/templates/system-fragments/channel.md +1 -1
- package/kits/templates/system-fragments/memory.md +4 -4
- package/package.json +7 -3
- package/dist/stats/billing.js +0 -215
|
@@ -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。
|
|
@@ -0,0 +1,333 @@
|
|
|
1
|
+
# 个人助理工作区规范
|
|
2
|
+
|
|
3
|
+
> 版本:0.1(草案,待评审)
|
|
4
|
+
> 状态:设计定稿中,尚未落地到真实数据
|
|
5
|
+
> 适用:任何按本规范创建的个人助理工作区
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. 设计理念
|
|
10
|
+
|
|
11
|
+
### 1.1 数据主权高于一切
|
|
12
|
+
|
|
13
|
+
所有数据属于使用者本人,**不依赖任何软件的内部格式**。
|
|
14
|
+
|
|
15
|
+
EvolCore 会升级、会重构、会改存储格式。任何寄生在系统内部的数据,都会在一次不兼容升级后变得不可读。"落地"不是备份,是把所有权拿回来。
|
|
16
|
+
|
|
17
|
+
判据:**把这个 Skill 卸掉、把 EvolCore 换掉,数据还能用文本编辑器直接打开、还能被 grep 搜到。**做不到的,就是设计错了。
|
|
18
|
+
|
|
19
|
+
### 1.2 代码与数据分家
|
|
20
|
+
|
|
21
|
+
| 类别 | 位置 | 特征 |
|
|
22
|
+
|---|---|---|
|
|
23
|
+
| 数据 | 工作区 `capture/` `output/` | 唯一、不可重建、必须保管 |
|
|
24
|
+
| 技能代码 | 技能包(工作区之外) | 可升级、可替换、可复制给别人 |
|
|
25
|
+
| 运行时状态 | 工作区 `.assistant/` | 可重建、可随时删除 |
|
|
26
|
+
|
|
27
|
+
升级技能不动一个字节的数据;换工作区不用重装技能。这条界线一旦模糊,两边都会烂。
|
|
28
|
+
|
|
29
|
+
### 1.3 原料与产物分离
|
|
30
|
+
|
|
31
|
+
- **原料**(`capture/`):外部给的、系统采集的。**只增不改。**
|
|
32
|
+
- **产物**(`output/`):提炼的、生成的、演进的。**可覆盖、可重建。**
|
|
33
|
+
|
|
34
|
+
分开的意义:原料永远在,产物坏了能重做。混在一起,就分不清"这是事实还是我的判断"。
|
|
35
|
+
|
|
36
|
+
### 1.4 机器产物必须可重建
|
|
37
|
+
|
|
38
|
+
索引、缓存、日志、临时文件——**全删掉,一条命令恢复**。
|
|
39
|
+
|
|
40
|
+
判据:删掉 `.assistant/` 之后,数据零损失。
|
|
41
|
+
|
|
42
|
+
### 1.5 结论必须可追溯
|
|
43
|
+
|
|
44
|
+
任何产物、任何记忆条目,都带 `source:` 指向原料的具体路径。
|
|
45
|
+
|
|
46
|
+
判据:从一份月报,能一路点到支撑它的那条对话原文。
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 2. 根目录
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
toleiliang8/ ← 工作区根
|
|
54
|
+
├── README.md 这是什么、怎么用
|
|
55
|
+
├── INDEX.md 总索引(脚本生成)
|
|
56
|
+
├── capture/ 原料层
|
|
57
|
+
├── output/ 产出层
|
|
58
|
+
└── .assistant/ 运行时状态(隐藏,可删可重建)
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
**看得见四个。** 第五条是隐藏目录,符合 `.git` 这类工程惯例——它不属于"内容",属于"机器的内脏"。
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## 3. 目录详解
|
|
66
|
+
|
|
67
|
+
### 3.1 `capture/` —— 原料层
|
|
68
|
+
|
|
69
|
+
**统一规则**:只增不改,永不覆盖。写错就写新的一条,旧的不动。
|
|
70
|
+
|
|
71
|
+
| 子目录 | 装什么 | 写入者 | 生命周期 |
|
|
72
|
+
|---|---|---|---|
|
|
73
|
+
| `conversation/` | 对话正文(md + jsonl 双份) | 每日落地 / 会话结束落地 | 3 个月后归档 |
|
|
74
|
+
| `notes/` | 用户口述的想法、随笔 | 会话内即时 | 3 个月后归档 |
|
|
75
|
+
| `links/` | 转发的链接与文章(含摘要) | 会话内即时 | 3 个月后归档 |
|
|
76
|
+
| `files/` | 收到的文件原件 | 会话内即时 | 3 个月后归档 |
|
|
77
|
+
| `scene/` | 看现场:照片引用 + 位置 + 描述 | 消息到达时 | 3 个月后归档 |
|
|
78
|
+
| `listening/` | 非会议的持续聆听(转写 + 音频引用) | 聆听结束事件 | 3 个月后归档 |
|
|
79
|
+
| `meeting/` | 会议原料(转写、参与人、音频引用) | 会议结束事件 | 3 个月后归档 |
|
|
80
|
+
| `track/` | 行为轨迹:位置、应用使用、设备、通讯 | 每日快照 | 3 个月后归档 |
|
|
81
|
+
| `_manifest/` | 落地清单:文件数、字节数、sha256 | 每次落地 | **永不删除** |
|
|
82
|
+
| `_inbox/` | 兜底暂存(48 小时内必须归位) | 任意 | 归位后清空 |
|
|
83
|
+
| `_archive/` | 冷归档 | 每月巡检 | 永久 |
|
|
84
|
+
|
|
85
|
+
#### conversation/
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
capture/conversation/2026/10/27/
|
|
89
|
+
└── main:leiliang.agentid.cn:toleiliang8.agentid.pub/
|
|
90
|
+
├── meta.json threadId / peer / 话题名 / 起止时间 / 消息条数
|
|
91
|
+
├── transcript.md 正文,人读,带时间戳
|
|
92
|
+
└── transcript.jsonl 逐条机读:{msgId, dir, from, to, ts, type, text}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
**为什么 md + jsonl 双份**:md 给人看、给全文搜;jsonl 给脚本算(统计、抽取任务、生成摘要)。只有 md 则脚本要写脆弱的正则解析;只有 jsonl 则人读不了。
|
|
96
|
+
|
|
97
|
+
**幂等键**:`threadId + msgId`。同一话题下 msgId 稳定唯一,重复落地不产生第二条。
|
|
98
|
+
|
|
99
|
+
**增量游标**:每个话题在 `.assistant/state.json` 里记一个 `lastTs`,下次用 `--after lastTs` 接着取。
|
|
100
|
+
首次回填用 `--before <now>` 往前翻页——注意 `--limit N` 取的是**区间内最近 N 条**,不是最早 N 条。
|
|
101
|
+
|
|
102
|
+
#### meeting/ 与 listening/ 的分界
|
|
103
|
+
|
|
104
|
+
**有 `meeting_id` → `meeting/`;没有 → `listening/`。**
|
|
105
|
+
|
|
106
|
+
同一份能力(持续聆听),按有没有会议载体分两处。会议有参与人、有议题、有产出总结;口述只是一个人的独白,两者下游完全不同。
|
|
107
|
+
|
|
108
|
+
#### track/
|
|
109
|
+
|
|
110
|
+
按天一个目录,一天内按数据类型分文件:
|
|
111
|
+
|
|
112
|
+
```
|
|
113
|
+
capture/track/2026/10/27/
|
|
114
|
+
├── location.jsonl 位置点(含精度)
|
|
115
|
+
├── app-usage.jsonl 前台应用切换
|
|
116
|
+
├── device.jsonl 电量、屏幕、健康
|
|
117
|
+
└── comms.md 通话与短信摘要(人读)
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
**原件不落地**:录音、原始照片本体留在存储层,这里只存引用和元数据。理由是体积和隐私——引用可以随时重新取,复制一份反而增加泄露面。
|
|
121
|
+
|
|
122
|
+
#### _manifest/
|
|
123
|
+
|
|
124
|
+
**这是数据,不是缓存。** 它证明"某天该落的东西都落了"。
|
|
125
|
+
|
|
126
|
+
```json
|
|
127
|
+
{
|
|
128
|
+
"date": "2026-10-27",
|
|
129
|
+
"ingested_at": "2026-10-27T23:52:11+08:00",
|
|
130
|
+
"sources": [
|
|
131
|
+
{"type": "conversation", "objects": 3, "bytes": 18234, "sha256": "..."},
|
|
132
|
+
{"type": "track", "objects": 4, "bytes": 9810, "sha256": "..."}
|
|
133
|
+
],
|
|
134
|
+
"missing": []
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
没有清单,"防丢失"就是一句空话——系统升级后你无法证明"没丢"。
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
### 3.2 `output/` —— 产出层
|
|
143
|
+
|
|
144
|
+
**统一规则**:可覆盖、可重建。每份产物都带 `source:` 指回原料。
|
|
145
|
+
|
|
146
|
+
| 子目录 | 装什么 | 生成方式 | 生命周期 |
|
|
147
|
+
|---|---|---|---|
|
|
148
|
+
| `reports/daily/` | 日报 | 每日定时 | 3 个月后归档 |
|
|
149
|
+
| `reports/weekly/` | 周报 | 每周定时 | 3 个月后归档 |
|
|
150
|
+
| `reports/monthly/` | 月报 | 每月定时 | 3 个月后归档 |
|
|
151
|
+
| `reports/quarterly/` | 季报 | 每季定时 | 1 年后归档 |
|
|
152
|
+
| `reports/yearly/` | 年报 | 每年定时 | 永久 |
|
|
153
|
+
| `meetings/` | 会议总结(对应 capture/meeting) | 会议结束后提炼 | 3 个月后归档 |
|
|
154
|
+
| `tasks/` | 任务:唯一事实源 | 会话内维护 | 完成后归档 |
|
|
155
|
+
| `knowledge/memory/` | 记忆条目 | 记忆整理任务 | **永不归档** |
|
|
156
|
+
| `knowledge/profile/` | 主人/他人/组织画像 | 周期性更新 | **永不归档** |
|
|
157
|
+
| `knowledge/topics/` | 主题梳理 | 按需 | **永不归档** |
|
|
158
|
+
| `_archive/` | 产物冷归档 | 每月巡检 | 永久 |
|
|
159
|
+
|
|
160
|
+
#### reports/
|
|
161
|
+
|
|
162
|
+
命名即时间:`2026-10-27.md`、`2026-W43.md`、`2026-10.md`、`2026-Q4.md`、`2026.md`。
|
|
163
|
+
|
|
164
|
+
**周期报告的归档时间以"报告覆盖的周期"为准**,不以生成时间为准。10 月 27 日总结 26 号的事,归到 26 号所属的周和月。
|
|
165
|
+
|
|
166
|
+
#### tasks/
|
|
167
|
+
|
|
168
|
+
```
|
|
169
|
+
tasks/
|
|
170
|
+
├── QUEUE.md 第三方事务队列(pending → reported → done/dropped)
|
|
171
|
+
├── today.md 当天任务
|
|
172
|
+
├── short.md 短期(周级)
|
|
173
|
+
├── long.md 长期(月级+)
|
|
174
|
+
└── done/2026-10.md 已完成,按月归档
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
**唯一事实源的意义**:所有提醒、巡检、汇报都从这里读,不各自维护一份。两处都记,就一定有一处是错的。
|
|
178
|
+
|
|
179
|
+
#### knowledge/
|
|
180
|
+
|
|
181
|
+
这是整个工作区里**唯一永不归档**的部分。记忆、画像、主题是累积物,不是流水——越用越准,越放越值钱。
|
|
182
|
+
|
|
183
|
+
**记忆的"不遗忘"是字面意义的:**
|
|
184
|
+
|
|
185
|
+
```yaml
|
|
186
|
+
status: active | superseded
|
|
187
|
+
supersedes: <旧条目 id>
|
|
188
|
+
superseded_by: <新条目 id>
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
改主意了不改老条目,而是写一条新的、把老的标 `superseded`。**旧版本永久保留**,于是你能查到"九月我以为 A,十月改成了 B,因为当时出了什么事"。这是运行时记忆系统**故意做不到**的事。
|
|
192
|
+
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
### 3.3 `.assistant/` —— 运行时状态
|
|
196
|
+
|
|
197
|
+
| 路径 | 内容 | 可删性 |
|
|
198
|
+
|---|---|---|
|
|
199
|
+
| `state.json` | 工作区版本、技能版本、初始化时间、已装触发器清单 | 删了要重新初始化 |
|
|
200
|
+
| `index/` | 分片索引(tags、by-source、by-date、翻月归档) | 可删,重建索引恢复 |
|
|
201
|
+
| `logs/` | 运行日志,按天滚动,30 天自动清 | 可删 |
|
|
202
|
+
| `tmp/` | 临时文件,7 天自动清 | 可删 |
|
|
203
|
+
| `locks/` | 脚本互斥锁 | 可删 |
|
|
204
|
+
| `cache/` | 解析缓存 | 可删 |
|
|
205
|
+
|
|
206
|
+
**唯一例外是 `state.json`**:删了不会丢数据,但会丢失"这个工作区装过哪版技能、装过哪些触发器"的记录,需要重新初始化才能恢复自动运转。
|
|
207
|
+
|
|
208
|
+
---
|
|
209
|
+
|
|
210
|
+
## 4. 命名与格式规范
|
|
211
|
+
|
|
212
|
+
### 4.1 文件命名
|
|
213
|
+
|
|
214
|
+
```
|
|
215
|
+
<日期>-<时分>-<简短标题>.md 例:2026-10-27-1200-会议模式界面.md
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
- 日期一律 `YYYY-MM-DD`
|
|
219
|
+
- 时分 24 小时制 `HHmm`
|
|
220
|
+
- 标题 ≤ 20 字,不加书名号、不加标点
|
|
221
|
+
- **文件名里不出现空格**,需要分隔用 `-`
|
|
222
|
+
|
|
223
|
+
### 4.2 目录时间层级
|
|
224
|
+
|
|
225
|
+
```
|
|
226
|
+
<年>/<月>/ 例:2026/10/
|
|
227
|
+
<年>/<月>/<日>/ 例:2026/10/27/ (仅 track 和 conversation 用日级)
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
### 4.3 frontmatter(所有 md 通用)
|
|
231
|
+
|
|
232
|
+
```yaml
|
|
233
|
+
---
|
|
234
|
+
id: 2026-10-27-1200-会议模式界面
|
|
235
|
+
date: 2026-10-27T12:00:00+08:00
|
|
236
|
+
type: note | link | scene | meeting | listening | report | task | profile | memory | topic
|
|
237
|
+
tags: [标签1, 标签2]
|
|
238
|
+
source: 自己 | 网友名 | 设备名 | <capture/ 下的相对路径>
|
|
239
|
+
ref: capture/meeting/2026/10/26-xxx # 可选,指向原料
|
|
240
|
+
status: active | superseded # 仅 knowledge/ 使用
|
|
241
|
+
---
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
**`source` 是硬性要求。** 没有来源的结论,等于没有结论。
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
## 5. 数据流转机制
|
|
249
|
+
|
|
250
|
+
### 5.1 总图
|
|
251
|
+
|
|
252
|
+
```
|
|
253
|
+
┌─────────────── 触发器(何时)───────────────┐
|
|
254
|
+
│ cron 定时 事件(session:idle 等) │
|
|
255
|
+
└───────────────────┬────────────────────────┘
|
|
256
|
+
▼
|
|
257
|
+
┌──────────── 会话(判断)────────────┐
|
|
258
|
+
│ 模型读上下文,决定这次该做什么 │
|
|
259
|
+
└───────────────────┬────────────────┘
|
|
260
|
+
▼
|
|
261
|
+
┌──────────── 脚本(执行)────────────┐
|
|
262
|
+
│ 确定性操作:写文件、建目录、算摘要 │
|
|
263
|
+
└───────────────────┬────────────────┘
|
|
264
|
+
▼
|
|
265
|
+
capture/ ──▶ output/
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
**三种驱动力各司其职**:触发器管"什么时候",模型管"做什么",脚本管"怎么做"。
|
|
269
|
+
|
|
270
|
+
### 5.2 五条数据流
|
|
271
|
+
|
|
272
|
+
| # | 数据 | 源 | 触发 | 落点 | 幂等键 |
|
|
273
|
+
|---|---|---|---|---|---|
|
|
274
|
+
| 1 | 对话正文 | 话题历史(`ec thread history`) | 每日 cron + `session:idle` | `capture/conversation/` | threadId + msgId |
|
|
275
|
+
| 2 | 记忆 | EvolCore 记忆文件 | 每日 cron | `output/knowledge/memory/` | 条目 slug + 版本 |
|
|
276
|
+
| 3 | 手机观察 | `personal/observations` 快照 | 每日 cron | `capture/track/` `listening/` `scene/` | 对象 id |
|
|
277
|
+
| 4 | 用户直接投喂 | 消息到达 | 即时(会话内) | `capture/notes/` `links/` `files/` | 消息 id |
|
|
278
|
+
| 5 | 会议 | 带 meeting_id 的聆听 | 聆听结束事件 | `capture/meeting/` | meeting_id |
|
|
279
|
+
|
|
280
|
+
产物流:
|
|
281
|
+
|
|
282
|
+
```
|
|
283
|
+
capture/* ──每日/周/月──▶ output/reports/*
|
|
284
|
+
capture/meeting ──会议结束──▶ output/meetings/*
|
|
285
|
+
capture/* + output/* ──每日──▶ output/knowledge/memory/
|
|
286
|
+
所有写入 ──增量──▶ .assistant/index/ ;每日全量重建 ──▶ INDEX.md
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
### 5.3 每项数据的管理机制
|
|
290
|
+
|
|
291
|
+
| 机制 | 作用对象 | 频率 | 说明 |
|
|
292
|
+
|---|---|---|---|
|
|
293
|
+
| **落地清单** | capture 全部 | 每次落地 | 记录落了什么、多少、摘要,用于证明没丢 |
|
|
294
|
+
| **增量索引** | 所有 md | 每次写入 | 追加到 `.assistant/index/` |
|
|
295
|
+
| **全量重建** | INDEX.md + 分片 | 每日 | 从 frontmatter 汇总,覆盖生成 |
|
|
296
|
+
| **冷热分层** | capture + output | 每月 1 号 | 超过 3 个月搬进 `_archive/` |
|
|
297
|
+
| **互斥锁** | 所有写操作 | 每次 | 防止 cron 与事件触发同时写同一天 |
|
|
298
|
+
| **完整性校验** | capture | 每周 | 比对 `_manifest/` 的 sha256,发现损坏 |
|
|
299
|
+
| **记忆演进** | knowledge/memory | 每次变更 | 旧的标 superseded,不删除 |
|
|
300
|
+
|
|
301
|
+
### 5.4 归档规则
|
|
302
|
+
|
|
303
|
+
| 区域 | 归档阈值 | 去向 |
|
|
304
|
+
|---|---|---|
|
|
305
|
+
| `capture/conversation` `notes` `links` `files` `scene` `listening` `meeting` `track` | 3 个月 | `capture/_archive/年/月/` |
|
|
306
|
+
| `output/reports`(日/周/月) | 3 个月 | `output/_archive/年/月/` |
|
|
307
|
+
| `output/meetings` | 3 个月 | `output/_archive/年/月/` |
|
|
308
|
+
| `output/reports/quarterly` | 1 年 | `output/_archive/年/` |
|
|
309
|
+
| `output/reports/yearly` | 永不 | — |
|
|
310
|
+
| `output/knowledge/**` | **永不归档** | — |
|
|
311
|
+
|
|
312
|
+
**归档不改变内容,只改变位置**,并同步更新索引的归档分片。
|
|
313
|
+
|
|
314
|
+
---
|
|
315
|
+
|
|
316
|
+
## 6. 检索机制
|
|
317
|
+
|
|
318
|
+
三路,从快到兜底:
|
|
319
|
+
|
|
320
|
+
1. **索引**:`INDEX.md` → 分片 → 直达。用于"我知道要什么"
|
|
321
|
+
2. **元数据过滤**:按 `date/type/tags/source` 筛。用于"10 月的所有会议"
|
|
322
|
+
3. **全文搜索**:grep 全库。用于"我记得好像说过某某"
|
|
323
|
+
|
|
324
|
+
三路都建立在同一件事上:**frontmatter 字段统一**。字段一乱,三路全废。
|
|
325
|
+
|
|
326
|
+
---
|
|
327
|
+
|
|
328
|
+
## 7. 边界:这个工作区不做什么
|
|
329
|
+
|
|
330
|
+
- **不做全文数据库**:不需要 SQLite、不建向量库。文本 + 目录 + grep 够了,多一层依赖就多一个会坏的部件。
|
|
331
|
+
- **不做实时同步**:落地是批处理,不是实时镜像。实时同步意味着强一致,强一致意味着停摆。
|
|
332
|
+
- **不存原件**:录音、大图只存引用。原件在存储层,引用随时可重新取。
|
|
333
|
+
- **不替代运行时记忆**:EvolCore 的记忆继续为上下文服务;工作区的记忆为持久服务。两套并存,各管一段。
|