dsh-ace

LIMITATIONS

Known limitations

**结论：下面几条是当前设计的边界，不是待修的缺陷——写在这里免得被当成意外。** - **并发新增只拦「重复」，不拦「不同」。** 两个实例同时往同一本手册加条目时，冲突检测**也参与 add**：只拦与「自快照以来新出现**或被改名**的条目」构成重复的那些（内容完全相同、标题相同、或 BM25 相似度超阈值），其余照常落盘。**与快照里本就存在、且未被改名的条目重复不算冲突**——那是 Curator 去重（LLM 判 new/update/drop）的职责，不在冲突层重复拦。近似重复那一层**只比正文**（条件/做法/依据，不含标题）、相似度用**对称比率**并封顶 100%，所以「同领域的不同经验」不会被误判成重复。 - **编号可能被复用一次。** 条目编号单调递增，但**人同时删掉最高编号的条目和文档头的高水位标记**时，历史最大值无法从文件本身恢复，那个编号可能被复用一次（之后标记会被重写成当前最大编号，也就是刚被复用的那个号，因此只会复用这一次）。这是已知边界，不是并发写导致的。 - **旧工作区里的手册不会自动搬迁。** 升级前放在 `<workspace>/.ace/playbook.md` 的手册**原样保留**、不会被搬到共享层，也不会被合并——共享层是另一本独立的手册。想继续用旧的，把 `playbookPath` 设成那个相对路径即可。 - **多实例共享一本手册时，后写者仍可能覆盖先写者。** 锁只保证「读-改-写」区间不重叠（不并发写坏文件），不保证跨实例的语义不冲突；后者靠上面的逐条冲突检测挑出来、回报给你重试。