From 8d8880abca18d6e442f23f8a56fed1fe944ea6f2 Mon Sep 17 00:00:00 2001 From: clice-bot <306533837+clice-bot@users.noreply.github.com> Date: Sun, 27 Sep 2026 10:28:19 +0000 Subject: [PATCH] docs: sync clice --- en/clice/design/overview.md | 2 +- zh/clice/design/overview.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/en/clice/design/overview.md b/en/clice/design/overview.md index c4e89b3b..b129caa7 100644 --- a/en/clice/design/overview.md +++ b/en/clice/design/overview.md @@ -27,7 +27,7 @@ General-purpose utilities and infrastructure shared by all other modules. ### `src/vfs/` — File Identity and Versions -- `FileTable`: Internalizes file paths as stable `Fid` identifiers used throughout the system, and owns the shared per-file facts derived from them — the last observation of each file on disk, content versions, scan results, directory listings. A file has one `Fid` however a path spells it: it is identified by the name the operating system gives it (through symlinks, and on Windows through letter case, junctions and subst drives), and shown to the user under the name the user knows it by — the open document's, else the build's. The two-layer freshness check (stat fast path, then content hash) lives here once and is shared by every consumer: PCH validation, index staleness, and disk polling. Every look that finds other content than the last one is reported as a change, whoever looked. +- `FileTable`: Internalizes file paths as stable `Fid` identifiers used throughout the system, and owns the shared per-file facts derived from them — the last observation of each file on disk, content versions, scan results, directory listings. A file has one `Fid` however a path spells it: it is identified by the name the operating system gives it (through symlinks, and on Windows through letter case, junctions and subst drives), and shown to the user under the name the user knows it by — the open document's, else its own path under the workspace folder the user opened, never the spelling an include lookup reached it by. The two-layer freshness check (stat fast path, then content hash) lives here once and is shared by every consumer: PCH validation, index staleness, and disk polling. Every look that finds other content than the last one is reported as a change, whoever looked. ### `src/config/` — Configuration diff --git a/zh/clice/design/overview.md b/zh/clice/design/overview.md index 36f7f906..b776d8b3 100644 --- a/zh/clice/design/overview.md +++ b/zh/clice/design/overview.md @@ -27,7 +27,7 @@ clice 是一个全新的 C++ 语言服务器，从架构层面重新设计，旨 ### `src/vfs/` — 文件标识与版本 -- `FileTable`：将文件路径映射为全系统使用的稳定 `Fid` 标识，并管理据此得到的各文件共享信息——每个文件在磁盘上最近一次的观察记录、内容版本、扫描结果和目录列表。同一个文件无论路径怎么写，都只有一个 `Fid`：识别文件时用的是操作系统给它的名字（穿透符号链接；在 Windows 上还会穿透大小写差异、junction 和 subst 盘符），展示给用户时则用用户熟悉的名字——已打开文档所用的名字，否则是构建所用的名字。两层时效性检查（先走 stat 快速路径，再计算内容哈希）集中实现在此处，供所有使用方共享：PCH 验证、索引过期判断和磁盘轮询。无论由谁查看，只要某次查看发现的内容与上一次不同，就会报告为一次变化。 +- `FileTable`：将文件路径映射为全系统使用的稳定 `Fid` 标识，并管理据此得到的各文件共享信息——每个文件在磁盘上最近一次的观察记录、内容版本、扫描结果和目录列表。同一个文件无论路径怎么写，都只有一个 `Fid`：识别文件时用的是操作系统给它的名字（穿透符号链接；在 Windows 上还会穿透大小写差异、junction 和 subst 盘符），展示给用户时则用用户熟悉的名字——已打开文档所用的名字，否则是它在用户所打开工作区文件夹下的路径，从不使用 include 查找时找到它所用的写法。两层时效性检查（先走 stat 快速路径，再计算内容哈希）集中实现在此处，供所有使用方共享：PCH 验证、索引过期判断和磁盘轮询。无论由谁查看，只要某次查看发现的内容与上一次不同，就会报告为一次变化。 ### `src/config/` — 配置