ReMe/docs/en
Ziyang Guo b616944265
docs(operations): explain that reindex cannot refresh stale chunks (#585)
* docs(operations): explain that reindex cannot refresh stale chunks

#524 reports that persisted chunks survive a chunker change and are never
re-chunked. Maintainers closed #528 with the position that automatic
invalidation stays out of scope and the recovery path is to clear derived
state and let the watchers rescan, but that path was only described in the
issue thread. The operations guide already warned that reindex does not
rechunk; add the missing half: reindex reuses stored chunks as-is, so a
chunker change requires the re-chunk recovery instead.

* docs(operations): narrow recovery scope and stop the service before cleanup

Review on #585: moving the whole metadata/ tree makes the resource
watcher treat existing resources as newly added, which can update daily
notes - so 'source files are never modified' was too broad, and the
cleanup should target only the affected store's derived state while
preserving unrelated catalogs. The recovery sequence now also stops the
service before moving anything, so shutdown persistence cannot write the
old in-memory state back over the cleanup.

The reindex paragraph drops the repeated 'does not rechunk' explanation
and focuses on when a rebuild from source is needed. English and
Chinese pages stay symmetric.

* docs(operations): simplify rechunk recovery guidance

---------

Co-authored-by: jinli.yl <jinli.yl@alibaba-inc.com>
2026-10-15 22:17:01 +08:00
..
reference docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
auto_dream.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
auto_link.md feat(evolve): tag auto-dream outputs (#538) 2026-09-11 14:08:29 +08:00
auto_memory.md feat(auto-memory): save session images with source links (#574) 2026-10-09 17:42:13 +08:00
auto_resource.md feat(auto-resource): unify text and image auto-resource using agentwrapper (#555) 2026-09-23 10:20:35 +08:00
blog_20260920.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
blog_20261009.md docs: add bilingual multimodal memory blog and latest updates (#601) 2026-10-12 17:19:22 +08:00
configuration.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
contributing.md docs: rebuild documentation site with VitePress (#518) 2026-09-04 14:50:50 +08:00
docker.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
faq.md feat(proactive): separate proactive refresh from auto dream (#488) 2026-09-07 17:23:37 +08:00
framework.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
index.md feat(docs): redesign homepage and add traffic dashboard (#522) 2026-09-05 00:53:32 +08:00
integrations.md feat(integrations): add automatic memory plugins for Claude Code and Codex (#575) 2026-10-12 20:12:47 +08:00
memory_as_file.md feat(proactive): separate proactive refresh from auto dream (#488) 2026-09-07 17:23:37 +08:00
memory_search.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
operations.md docs(operations): explain that reindex cannot refresh stale chunks (#585) 2026-10-15 22:17:01 +08:00
plugin_development.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
plugin_management.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
proactive.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
quick_start.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
reme-blog.md docs: refresh agent integration guides (#545) 2026-09-14 17:55:08 +08:00
reme_scene.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
services.md docs: recommend two-stage service usage across guides (#620) 2026-10-15 11:41:17 +08:00
traffic.md feat(docs): redesign homepage and add traffic dashboard (#522) 2026-09-05 00:53:32 +08:00