docs: rescan rebased documentation hierarchy

This commit is contained in:
Turtle
2026-08-05 12:46:38 +08:00
parent 012bb0a549
commit 8af3babaea
304 changed files with 1091 additions and 1983 deletions

View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/util/atomic-write/README.md
README.md: 2ff4abb6ac10d8b592ccd2056b4f1f92cc8518b0
README.zh.md: bd5d3f1f2583ff1b97a80ce2c1c6ca7989e13d15
README.zh.md: 4284d06422564268bb9e31d1a1ed06ab5271e562

View File

@@ -30,15 +30,15 @@ await withFileLock('/home/u/.dsh/settings.yaml', async () => {
`withFileLock` 跨进程串行化同一文件的写入方,服务于单靠原子提交无法保证安全的读-渲染-提交循环。锁是以 `wx` 创建的同目录 `<filename>.lock`,因此读取方从不参与竞争;等待方按指数退避,超时即失败而非无限阻塞。竞争者绝不移除现有锁:锁龄无法区分已经崩溃的所有者与被暂停但仍存活的写入方。
## Model Experience
## 模型体验
无:本包是纯文件系统原语,此处没有任何内容会到达模型请求。
#### KV Cache effect
#### KV Cache 影响
无;此处没有任何内容会进入请求前缀。
## Known Limitations and Deferred Work
## 已知限制与暂缓事项
- **原子但不保证持久**——不对文件或其所在目录做 `fsync`,因此崩溃后可能观察到 rename 被回退。此处的文件型存储在启动时重新读取并重新发布,把持久性留作调用方的策略。
- **仅支持字符串内容**——在有消费方需要之前,不提供 `Buffer` 或流式形态。