@yottameta/yotta-logs 0.1.0 → 0.2.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yottameta/yotta-logs",
-  "version": "0.1.0",
-  "description": "元史 —— 跨智能体的历史会话日志检索技能：零依赖检索 / 分析会话 JSONL 记录，回溯旧对话与父会话上下文，为跨会话追溯提供原始日志依据。触发：用户问起先前聊过的内容 / 父会话 / 历史上下文、要查以前说过的结论、跨会话回溯某次讨论、需要从会话日志定位某段决策时。边界：仅读取本机自己的会话日志文件；不修改、不删除会话记录；只查本地日志不联网上传。",
+  "version": "0.2.1",
+  "description": "Yuanshi — a skill for retrieving historical session / memory logs across AI agents: zero-dependency search and analysis of JSONL, JSON, SQLite and Markdown session & memory files (unified Record + field-alias normalization + config fallback), with full source discovery to recall past conversations and parent-session context. Triggers when the user asks about previously discussed content / a parent session / historical context, wants to look up an earlier conclusion, traces a past discussion across sessions, or needs to locate a decision in session logs or memory files. Boundaries: reads only the local agent's own session logs / memory files; never modifies or deletes records; local-only, never uploaded.",
   "license": "MIT",
   "keywords": [
     "agent-skills",
@@ -17,7 +17,8 @@
     "assets",
     "bin",
     "NOTICE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "README.zh-CN.md"
   ],
   "repository": {
     "type": "git",

package/references/agent-formats.md

@@ -0,0 +1,127 @@
+# AI 智能体会话 / 记忆存储格式普查登记表（agent-formats）
+
+> v0.2.0 通用化依据：元史（yotta-logs）不再只认 JSONL，按「格式族 × 字段别名归一 + 配置兜底」适配一切格式。
+> 本表是普查结论：6 大格式族、统一记录模型、字段别名映射、已知根与配置兜底。引擎行为见 `cli.md` / `format.md`。
+
+## 一、总览：6 大格式族
+
+| # | 格式族 | format | 代表智能体 / 存储 | 特征 |
+|---|---|---|---|---|
+| 1 | JSONL | jsonl | Claude Code / Codex CLI / Gemini 新版 / Copilot / Qwen / 多数会话 | 每行一个 JSON 对象，追加写入 |
+| 2 | 单文件 JSON | json | Cline / Roo / Continue / Gemini 旧版 | 一个文件存整个会话 / 会话集（数组或对象） |
+| 3 | SQLite | sqlite | opencode / Cursor state.vscdb / Trae / Copilot CLI session-store / CodeBuddy | 关系表存会话 / 消息 / 片段，字段多为 JSON 字符串 |
+| 4 | Markdown | markdown | Aider .aider.chat.history.md / 各类自由笔记 | # 标题 + 正文 |
+| 5 | 结构化 Markdown（YAML frontmatter） | markdown | yotta-memory / agent-code / opencode-agent-memory | --- frontmatter 元数据 + 正文 |
+| 6 | 二进制 / 专有 / 加密 | binary | Windsurf pbtxt / Cascade / JetBrains Nitrite | 只降级读标题，不崩 |
+
+## 二、统一记录模型 Record
+
+所有 reader 产同构记录：`{source, format, kind, session, time, role, text, path, meta}`。
+
+| 字段 | 说明 | 字段别名（按序取首个命中） |
+|---|---|---|
+| source | 来源名（如 codex-sessions / opencode-db / yottamemory-facts / codex-notes） | 来源登记名 |
+| format | jsonl / json / sqlite / markdown / binary | 文件嗅探 / 配置 |
+| kind | session / memory / note / log | 来源登记或逐记录判定 |
+| session | 会话 ID / 文件名主干 / 相对路径 | session_id / thread_id / sessionId / session / conversation_id / threadId；缺省取文件主干 |
+| time | 归一化 ISO 时间戳（秒 / 毫秒自动推断） | timestamp / time_created / created / time / ts / date / created_at / mtime / updated |
+| role | user / assistant / tool / system / developer；结构化 md 的 type=FACT/PREF/BOUND/COMMIT → role | role / type / kind（message 内或 payload 内均可） |
+| text | 人类可读文本 | text / content / body / message / statement；content 列表取 type=text / input_text / output_text |
+| path | 绝对路径 | 文件路径 |
+| meta | 额外字段（title / tags / tools / cost / tokens…） | title←title / subject / name / # 一级标题 |
+
+## 三、各格式族详情
+
+### 3.1 JSONL（jsonl）
+
+- 代表：Claude Code（~/.claude/projects/*）、Codex CLI（~/.codex/sessions，CODEX_HOME 可覆盖；嵌套子目录）、Clawdbot（~/.clawdbot/agents/*/sessions）、opencode sessions 目录、Gemini 新版、Copilot、Qwen。
+- 每行一个 JSON 对象：`type=session/message`；`message.role`；`message.content` 字符串或列表（type=text/toolCall/toolResult）；`message.usage`。
+- Codex rollout 形态（本机实测 2026-08-27）：`{timestamp, type, payload:{type, role, content, usage}}`——`payload.type=message` 取 role / content；`payload.type=function_call / function_call_output / local_shell_call` 归一为 tool 并提取工具名；reasoning / event_msg 不进文本。
+- 可选 `sessions.json` 索引（别名 → 会话 ID）。
+- 容错：坏行跳过并计数，不中断。
+
+### 3.2 单文件 JSON（json）
+
+- 代表：Cline / Roo / Continue（~/.continue/sessions/*.json）、Gemini 旧版。
+- 形态：JSON 数组（每条一个消息）；对象 {会话ID: [消息...]}；对象 {会话ID: 单消息}。
+- 归一：数组逐条；对象遍历值。
+
+### 3.3 SQLite（sqlite）
+
+- 代表：opencode（~/.local/share/opencode/opencode.db；本机实测 D:\AI_WorkDir\.OpenCodeData\data\opencode\opencode.db，走 XDG_DATA_HOME / OPENCODE_DATA）、Cursor state.vscdb、Trae、Copilot CLI session-store、CodeBuddy。
+- opencode 实测 schema（2026-08-27，D:\AI_WorkDir\.OpenCodeData\data\opencode\opencode.db）：
+  - `session(id, project_id, title, cost, tokens_input, tokens_output, time_created[毫秒], ...)`
+  - `message(id, session_id, time_created[毫秒], data[JSON: role, time, agent, model, ...])`
+  - `part(id, message_id, session_id, time_created[毫秒], data[JSON: type=text/tool/reasoning/step-start...])`——text 部分取 `text` 字段；tool 部分取 `tool` 字段为工具名。
+- 只读连接：`sqlite3.connect("file:<path>?mode=ro", uri=True)`，绝不写库。
+- 通用兜底：配置指定 `table / col_time / col_role / col_text / col_session / col_title`；未指定则按字段别名嗅探「消息类」表。
+
+### 3.4 Markdown（markdown）
+
+- 代表：Aider（repo 下 *.aider.chat.history.md）、各类自由笔记（Codex memories）。
+- 无 frontmatter：`# 一级标题` → title，正文 → text，文件 mtime → time，kind=note。
+
+### 3.5 结构化 Markdown（markdown + YAML frontmatter）
+
+- 代表：yotta-memory（记忆库 facts / private / archive 下的 *.md）、agent-code、opencode-agent-memory。
+- frontmatter：`type`（FACT/PREF/BOUND/COMMIT → role）、`subject` → title、`statement` → text、`created / updated / date` → time、`tags / confidence / scope / owner / immutable` → meta。
+- 本机实测样本（2026-08-27）：D:\AI_WorkDir\.yottamemory\facts\2026-08-25-0002.md（记忆库位置由 ~/.yottamemory/config.json 的 `memory_home` 决定）。
+- frontmatter 解析为零依赖 YAML 子集（key: value / key: [a, b] / 引号），非完整 YAML。
+
+### 3.6 二进制 / 专有 / 加密（binary）
+
+- 代表：Windsurf pbtxt（~/.codeium/windsurf/**/*.pbtxt）、Cascade、JetBrains Nitrite。
+- 只降级读 title（文件名 / 首个可读片段），不崩；kind=log，默认关。
+
+## 四、已知根（discover 全源登记）
+
+| 来源名 | 根路径 | format | kind | 默认范围 |
+|---|---|---|---|---|
+| codex-sessions | ~/.codex/sessions（CODEX_HOME 覆盖，支持嵌套子目录） | jsonl | session | 开 |
+| claude-projects | ~/.claude/projects/* | jsonl | session | 开 |
+| clawdbot-sessions | ~/.clawdbot/agents/*/sessions | jsonl | session | 开 |
+| opencode-sessions | ~/.config/opencode/sessions | jsonl | session | 开 |
+| gemini-sessions | ~/.gemini/sessions | jsonl | session | 开 |
+| agents-sessions | ~/.agents/sessions | jsonl | session | 开 |
+| opencode-db | ~/.local/share/opencode/opencode.db；$XDG_DATA_HOME/opencode/opencode.db；$OPENCODE_DATA；~/.OpenCodeData/data/opencode/opencode.db | sqlite | session | 开 |
+| cursor-state / code-state | VS Code / Cursor globalStorage 下 state.vscdb（Windows / Linux / macOS） | sqlite | session | 开 |
+| continue-sessions | ~/.continue/sessions、~/.config/continue/sessions | json | session | 开 |
+| yottamemory-facts | 记忆库 facts（memory_home 配置） | markdown | memory | 开 |
+| yottamemory-private | 记忆库 private（memory_home 配置） | markdown | memory | 开 |
+| yottamemory-archive | 记忆库 archive（memory_home 配置） | markdown | memory | 开 |
+| codex-notes | $CODEX_HOME/memories、~/.CodexData/memories | markdown | note | 关（显式开） |
+| aider-history | 当前目录 *.aider.*.md | markdown | session | 开 |
+| windsurf-conv | ~/.codeium/windsurf、~/.windsurf 下 *.pbtxt | binary | log | 关 |
+| 自定义 sources | 配置 sources[]（见下） | 任意 | 任意 | 配置 default_scope |
+
+## 五、配置兜底（config.json）
+
+路径：`$YOTTA_LOGS_CONFIG` 或 `~/.config/yotta-logs/config.json`。
+
+```json
+{
+  "default_scope": ["session", "memory"],
+  "sources": [
+    {
+      "name": "myapp",
+      "path": "/path/to/logs",
+      "format": "sqlite",
+      "kind": "session",
+      "table": "messages",
+      "col_time": "created_at",
+      "col_role": "role",
+      "col_text": "content",
+      "col_session": "session_id",
+      "col_title": "title"
+    }
+  ]
+}
+```
+
+引擎零改动即可接入怪格式（个别 agent 私有 schema 用列映射接入）。
+
+## 六、默认检索范围（2026-08-27 老张拍板）
+
+- 会话源（kind=session）+ 结构化记忆源（kind=memory）**默认开**；
+- 自由笔记（kind=note）与二进制日志（kind=log）**默认关**，可 `--kind note` / `--kind log` 显式开；
+- 显式指定 `--dir / --source / --format / --kind` 时以显式条件为准。

package/references/cli.md

@@ -6,45 +6,50 @@
 
 | 选项 | 说明 |
 |---|---|
-| --dir PATH | 会话日志目录；缺省读环境变量 YOTTA_LOGS_DIR，再自动定位首个已知目录 |
+| --dir PATH | 日志 / 记忆目录或文件；目录自动嗅探格式族（jsonl / json / sqlite / markdown），也支持单文件（含 .db / .md / .jsonl） |
+| --source NAME | 只检索指定来源（可多次；名称见 locate 登记，如 codex-sessions / opencode-db / yottamemory-facts / codex-notes） |
+| --kind KIND | 只检索指定类型：session / memory / note / log |
+| --format FMT | 只检索指定格式：jsonl / json / sqlite / markdown / binary |
 | --json | 输出纯净 JSON（stdout 无其它噪音） |
 | --no-redact | 关闭默认脱敏 |
 | --limit N | 最多返回 N 条（默认 50） |
 | --version | 打印版本 |
 
+未指定 --dir 时：依次尝试 YOTTA_LOGS_DIR → discover 全源登记（locate 逻辑），并按默认检索范围（会话 + 结构化记忆开、自由笔记 / 二进制日志关）过滤；显式 --source / --kind / --format 可覆盖默认范围。
+
 ## 子命令
 
 ### locate
-自动发现本机常见会话日志目录（`~/.clawdbot/agents/*/sessions`、`~/.codex/sessions`、`~/.claude/projects/*`、`~/.config/opencode/sessions`、`~/.gemini/sessions`、`~/.agents/sessions`），只返回存在且含 `*.jsonl` 的目录。
+全源登记：遍历所有 reader 的 discover()，登记本机存在的日志 / 记忆源（来源 / 格式 / 类型 / 路径 / 默认开关）。`--json` 输出 `{tool, version, default_scope, sources[]}`。无源退出码 1。
 
 ### scan
-列出目录下所有会话：ID / 日期（首条消息）/ 消息数 / 大小 / sessions.json 别名。支持 `--limit`、`--json`。空目录退出码 1。
+列出所有会话（跨源）：来源 / 会话 ID / 日期（首条消息）/ 消息数 / 大小 / 别名。支持 `--source/--kind/--format`、`--limit`（全局截断）、`--json`。空结果退出码 1。
 
 ### search <query>
-跨会话检索，输出时间线命中（会话 / 时间 / 角色 / 原文片段）。
+跨源检索，输出时间线命中（来源 / 会话 / 时间 / 角色 / 原文片段）。
 
 | 选项 | 说明 |
 |---|---|
 | --regex | 把 query 当正则（默认不区分大小写） |
 | --date YYYY-MM-DD | 只检索指定日期（也支持 YYYY-MM） |
 | -s / --session SID | 只检索指定会话 ID / 别名（可多次） |
-| --role ROLE | user / assistant / tool / system |
+| --role ROLE | user / assistant / tool / system / developer |
 | --context N | 命中上下文半径字符数（默认 40） |
 | --limit N | 最多返回 N 条（默认 50） |
 
---json 输出：`{command, tool, version, query, regex, dir, total_matches, sessions_hit, truncated, matches[]}`，每条命中含 `session / timestamp / role / line / match / text`。
+--json 输出：`{command, tool, version, query, regex, sources[], total_matches, sessions_hit, truncated, matches[]}`，每条命中含 `source / format / kind / session / timestamp / role / line / match / text`。
 
 ### session <sid>
-提取单个会话原文（时间线 + 角色 + 文本）。`--role` 过滤、`--tools` 标注工具调用、`--limit`、`--json`。未知会话退出码 4。
+提取单个会话原文（时间线 + 角色 + 文本）。`--role` 过滤、`--tools` 标注工具调用、`--source/--kind/--format`、`--limit`、`--json`。未知会话退出码 4。跨源同名会话取第一个，可用 `--source` 消歧。
 
 ### stats
-会话统计：消息 / 角色分布 / token / 成本 / 时间范围；`--daily` 输出每日汇总；`-s/--session` 限定单会话。空目录退出码 1。
+会话统计（跨源）：会话 / 消息 / 角色分布 / token / 成本 / 时间范围 / 分源（by_source）；`--daily` 输出每日汇总；`-s/--session` 限定单会话。空结果退出码 1。
 
 ### tools
-工具调用次数排行（`toolCall` / `toolResult` 的工具名计数），`-s/--session` 限定单会话。
+工具调用次数排行（toolCall / toolResult / payload function_call 的工具名计数），`-s/--session` 限定单会话。
 
 ### version
-打印 `yotta-logs 0.1.0`。
+打印 `yotta-logs 0.2.0`。
 
 ## 退出码
 
@@ -52,9 +57,16 @@
 |---|---|
 | 0 | 成功（检索到结果 / 操作完成） |
 | 1 | 无匹配 / 空结果集 |
-| 4 | 用法错误 / 目录不存在 / 未知会话 / 致命异常 |
+| 4 | 用法错误 / 路径不存在 / 未知会话 / 致命异常 |
 
 ## JSON 输出约定
 
 - stdout 只输出 JSON，进度 / 提示走 stderr；
 - `ensure_ascii=False`，中文原样输出；stdout 已重配 UTF-8（GBK 控制台不炸）。
+
+## 配置（配置兜底）
+
+- 配置文件：`$YOTTA_LOGS_CONFIG` 或 `~/.config/yotta-logs/config.json`；
+- `default_scope`：默认检索范围（默认 `["session", "memory"]`）；
+- `sources[]`：自定义源（path / format / kind / name / table / col_time / col_role / col_text / col_session / col_title），引擎零改动接入怪格式。
+- 示例见 `agent-formats.md` 第五节。

package/references/format.md

@@ -1,40 +1,75 @@
-# 会话日志格式（format）
+# 日志 / 记忆格式（format）
 
-元史按「目录 = 会话集」工作：一个目录下有若干 `*.jsonl` 会话文件，可选一个 `sessions.json` 索引。目录由 `--dir` 指定（缺省读环境变量 `YOTTA_LOGS_DIR`，再自动定位首个已知目录）。
+元史 v0.2.0 起按「格式族 × 字段别名归一 + 配置兜底」适配一切格式，统一产出 Record。
+格式普查与各智能体存储位置见 `agent-formats.md`。
 
-## 会话文件（*.jsonl）
+## 统一记录模型 Record
 
-每行一个 JSON 对象，追加写入。常见字段：
+所有 reader 产同构记录：
 
 | 字段 | 说明 |
 |---|---|
-| type | `session`（会话元数据）或 `message`（消息） |
-| timestamp | ISO 时间戳（如 `2026-08-26T03:00:01+08:00`） |
-| message.role | `user` / `assistant` / `toolResult`（归一为 `tool`） |
-| message.content | 文本或列表；列表项 `type=text` 取文本，`type=toolCall` / `toolResult` 取工具名 |
-| message.usage.cost.total | 单条成本 |
-| message.usage.input_tokens / output_tokens | token 数 |
+| source | 来源名（codex-sessions / opencode-db / yottamemory-facts / codex-notes …） |
+| format | jsonl / json / sqlite / markdown / binary |
+| kind | session / memory / note / log |
+| session | 会话 ID / 文件名主干 |
+| time | 归一化 ISO 时间戳（秒 / 毫秒自动推断，Z 转 +00:00） |
+| role | user / assistant / tool / system / developer；结构化 md 为 FACT/PREF/BOUND/COMMIT |
+| text | 人类可读文本 |
+| path | 绝对路径 |
+| meta | 额外字段（title / tags / tools / cost / tokens_in / tokens_out / line …） |
 
-会话 ID = 文件名主干（去掉 `.jsonl`）。文件只被读取，绝不写入 / 修改 / 删除。
+## 字段别名归一（适配一切关键字段）
 
-## 索引文件（sessions.json）
+| 语义 | 别名（按序取首个命中） |
+|---|---|
+| time | timestamp / time_created / created / time / ts / date / created_at / mtime / updated |
+| role | role / type / kind（message 内或 payload 内均可） |
+| text | text / content / body / message / statement / text_content |
+| session | session_id / thread_id / sessionId / session / conversation_id / threadId |
+| title | title / subject / name / heading；md 无 frontmatter 时取 # 一级标题 |
+
+- content 为列表时取 `type=text / input_text / output_text` 项；
+- JSON 字符串字段自动解包一层；
+- 秒 / 毫秒时间戳自动推断（13 位及以上按毫秒）。
+
+## 各格式族读取规则
+
+### JSONL（jsonl）
+
+- 目录 = 会话集（支持嵌套子目录，如 Codex `sessions/2026/08/27/xxx.jsonl`）；可选 `sessions.json` 索引（别名 → 会话 ID）。
+- 每行一个 JSON 对象；`message` / `payload` 内取 role / content / usage。
+- Codex rollout 形态：`payload.type=message` 取 role / content；`function_call / function_call_output / local_shell_call` 归一为 tool 并提取工具名；reasoning / event_msg 不进文本。
+- 坏行跳过并计入 invalid。
+
+### 单文件 JSON（json）
+
+- 数组 = 一条条消息；对象 = {会话ID: [消息...]} 或 {会话ID: 单消息}。
+
+### SQLite（sqlite）
+
+- 只读连接 `file:<path>?mode=ro`（uri=True），绝不写库。
+- opencode schema 实测：session(id, title, cost, tokens_input, tokens_output, time_created[毫秒]) + message(id, session_id, data[JSON role]) + part(message_id, data[JSON type=text/tool/reasoning])。text 部分取 text 字段；tool 部分取 tool 字段为工具名；reasoning 不进文本。
+- 通用兜底：配置指定 table / col_time / col_role / col_text / col_session / col_title；未指定则按字段别名嗅探消息类表。
+
+### Markdown（markdown）
+
+- 有 YAML frontmatter（`---` 开头）：type→role、subject→title、statement→text、created/updated/date→time、tags/confidence/scope/owner/immutable→meta；kind=memory。
+- 无 frontmatter：# 一级标题→title，正文→text，mtime→time；kind=note。
+- frontmatter 解析为零依赖 YAML 子集（key: value / key: [a, b] / 引号包裹）。
 
-可选，把别名映射到会话 ID。两种形态均可：
+### 二进制 / 专有 / 加密（binary）
 
-```json
-{ "微信-部署": "a1", "ci-排查": "b2" }
-```
+- 只降级读 title（文件名 / 首个可读片段），不崩；kind=log。
 
-```json
-[ { "key": "微信-部署", "sessionId": "a1" } ]
-```
+## 会话 ID 规则
 
-search / session / stats / tools 的 `--session` / `-s` 参数同时接受会话 ID 与别名。
+- JSONL / Markdown / Binary：文件名主干（去掉扩展名）；
+- 单文件 JSON 数组：文件主干；对象：键名（会话 ID）；
+- SQLite：session 表 id（opencode）或 col_session 列值；无会话列时取文件主干。
 
 ## 容错规则
 
-- content 为字符串时直接作为文本；为列表时只取 `type=text` 项；
-- role 可在 message 内或顶层；`toolResult` / `tool_result` 统一归一为 `tool`；
-- usage 可在 message 内或顶层；
-- 坏行（非法 JSON / 非对象）跳过并计入 `invalid`，不中断检索；
-- 非 `.jsonl` 文件（如 `sessions.json`、`notes.txt`）不会被当作会话。
+- 坏行 / 坏 JSON 字段跳过并计数（invalid），不中断检索；
+- 二进制 / 加密文件只回退标题，不抛错；
+- 所有读取均为只读，绝不修改 / 删除 / 写入。

package/references/security.md

@@ -2,7 +2,7 @@
 
 ## 只读保证
 
-- 引擎只调用读取类操作（`open(path, "r")`），对会话目录不做任何写入 / 修改 / 删除；
+- 引擎只调用读取类操作（`open(path, "r")`、SQLite `file:<path>?mode=ro` 只读 URI），对任何日志 / 记忆文件与数据库不做写入 / 修改 / 删除；
 - 检索、提取、统计全程无网络请求；不把日志内容上传到任何服务；
 - 测试含只读回归：跑完 scan / search / session / stats / tools 后目录文件清单与大小不变。
 
@@ -26,17 +26,18 @@ URL 路径（非凭据）原文保留，方便回溯链接。
 
 ## 边界
 
-- 只检索 `*.jsonl` 会话文件与 `sessions.json` 索引；不读取、不分析其它文件；
-- 检索范围限定用户显式传入的 `--dir`（或环境变量 / 自动定位结果），不主动扫描磁盘；
-- 输出可能包含会话原文中的隐私，默认脱敏且仅用于本机回溯，请勿外传。
+- 只检索显式传入的 `--dir`（或环境变量 / discover 登记的来源），不主动扫描整盘；
+- 默认检索范围只含会话源 + 结构化记忆源；自由笔记（kind=note）与二进制日志（kind=log）默认不读，需显式 `--kind note / --kind log` 或配置 default_scope 开启；
+- discover 只登记已知根（见 agent-formats.md 第四节），命中即登记来源，不展开内容；
+- 输出可能包含会话 / 记忆原文中的隐私，默认脱敏且仅用于本机回溯，请勿外传。
 
 ## 与元忆（yotta-memory）的分工
 
 | 维度 | yotta-logs（元史） | yotta-memory（元忆） |
 |---|---|---|
-| 定位 | 原始会话日志（JSONL 事实） | 语义记忆（结构化条目） |
-| 输出 | 原文片段 + 行号 + 时间戳 | 记忆条目 + 权限边界 + 画像 |
+| 定位 | 原始会话日志 / 记忆文件（JSONL / JSON / SQLite / Markdown 事实） | 语义记忆（结构化条目 + 权限边界） |
+| 输出 | 原文片段 + 行号 + 时间戳 + 来源 | 记忆条目 + 权限边界 + 画像 |
 | 写操作 | 无（只读） | 支持（remember / forget / archive） |
-| 权限 | 目录级只读 | 类型 / 属主级权限边界 |
+| 权限 | 目录 / 来源级只读 | 类型 / 属主级权限边界 |
 
 回溯「原文」用元史；沉淀「长期知识 / 偏好 / 承诺」用元忆，二者互补。