docs(memory): merge latest mem2.0 documentation updates

.gitignore

@@ -24,6 +24,7 @@ logs/
 automated_testing/data/
 evaluation/benchmark/data/
 results.json
+tmp/
 
 # 预下载的本地模型（GB 级二进制；用 deploy/docker/download-models.sh 自行拉取，不入库）
 deploy/docker/models/

agent_plugin/wikimem/AGENTS.md

@@ -0,0 +1,16 @@
+# wikimem agent adapter
+
+本目录承接 `rust/wikimem` 中不属于 mem2.0 core API 的 agent 侧能力。
+
+## 文件职责
+
+- `team_sync.py`：团队记忆目录同步 adapter，保留 `SyncState`、pull / push、ETag、checksum、delta、412/413、路径校验和 secret skip 语义。
+- `__init__.py`：导出 wikimem agent adapter 的稳定入口。
+
+## 边界
+
+- `team_sync.py` 可以读写本地 team memory 目录，也可以通过 `TeamMemoryRemote` 与远端同步。
+- `team_sync.py` 不得被 `MemoryAPI.recall`、`Retriever.retrieve` 或默认 Recaller 自动调用。
+- 远端副作用必须显式由 agent adapter、CLI 或评测准备脚本触发。
+- 远端 key 写入本地前必须经过相对路径校验，拒绝绝对路径、父级跳转、反斜杠和百分号编码跳转。
+- push 前必须跳过潜在 secret 文件，并在 summary 中返回 `skipped_secrets`，不能静默丢弃。

agent_plugin/wikimem/__init__.py

@@ -0,0 +1,45 @@
+"""wikimem agent adapters."""
+
+from __future__ import annotations
+
+from agent_plugin.wikimem.team_sync import (
+    FetchOutcome,
+    HashesProbe,
+    LocalTeamMemorySnapshot,
+    PullOutcome,
+    PushOutcomeSummary,
+    PutOutcome,
+    RemoteTeamMemoryData,
+    SkippedSecretFile,
+    SyncState,
+    TeamMemoryFailureKind,
+    TeamMemoryRemote,
+    TeamMemorySyncFailure,
+    batch_delta_by_bytes,
+    hash_content,
+    pull_team_memory,
+    push_team_memory,
+    read_local_team_memory,
+    validate_relative_team_memory_key,
+)
+
+__all__ = [
+    "FetchOutcome",
+    "HashesProbe",
+    "LocalTeamMemorySnapshot",
+    "PullOutcome",
+    "PushOutcomeSummary",
+    "PutOutcome",
+    "RemoteTeamMemoryData",
+    "SkippedSecretFile",
+    "SyncState",
+    "TeamMemoryFailureKind",
+    "TeamMemoryRemote",
+    "TeamMemorySyncFailure",
+    "batch_delta_by_bytes",
+    "hash_content",
+    "pull_team_memory",
+    "push_team_memory",
+    "read_local_team_memory",
+    "validate_relative_team_memory_key",
+]