xai-fsnotify

01

固定源码基线

公开仓库提交 8adf9013

查看快照 ↗

工具与工作区

xai-fsnotify

把本地文件系统变化归一化为单一因果语义事件流。

Cargo description: Local-filesystem event source: single causal stream of semantic FsEvents

7生产文件

10Rust 文件总数

5,954生产代码行

30收录公开符号

职责与架构位置

xai-fsnotify 位于“工具与工作区”层。它的首要职责是：把本地文件系统变化归一化为单一因果语义事件流。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

成员路径为 crates/codegen/xai-fsnotify，清单位于 Cargo.toml。

关键入口

SOURCElib.rscrates/codegen/xai-fsnotify/src/lib.rs:1–1121 行 · 模块入口↗SOURCERawFsEventcrates/codegen/xai-fsnotify/src/watcher.rs:52–623,882 行 · 公开符号入口↗SOURCESTATS_TARGETcrates/codegen/xai-fsnotify/src/source.rs:43–531,499 行 · 公开符号入口↗SOURCECOOLDOWN_MScrates/codegen/xai-fsnotify/src/state.rs:5–15374 行 · 公开符号入口↗SOURCEclassify_git_pathcrates/codegen/xai-fsnotify/src/paths.rs:13–2386 行 · 公开符号入口↗SOURCEFsEventcrates/codegen/xai-fsnotify/src/event.rs:19–2977 行 · 公开符号入口↗

入口文件优先按 lib.rs/main.rs、公开符号密度和文件规模选择。这是一条面向阅读的路径，不表示其他文件不重要；下方完整文件索引覆盖该 crate 的全部 Rust 源码、测试、示例、基准与 Fuzz 文件。

依赖与调用者

直接依赖

xai-tracing-macros

直接调用者

xai-grok-shellxai-grok-workspace

依赖边来自固定提交中的 Cargo manifest，只表示编译期直接依赖。运行时控制流还需结合 trait 实现、构造位置和消息通道判断；反向依赖为空也不代表 crate 没有入口，它可能直接生成二进制或由外部协议调用。

关键公开符号

类型	符号	文件与行号
enum	FsNotifyError	crates/codegen/xai-fsnotify/src/error.rs:5
enum	FsEvent	crates/codegen/xai-fsnotify/src/event.rs:21
enum	FsEventKind	crates/codegen/xai-fsnotify/src/event.rs:54
enum	GitMetaKind	crates/codegen/xai-fsnotify/src/event.rs:67
fn	classify_git_path	crates/codegen/xai-fsnotify/src/paths.rs:15
const	STATS_TARGET	crates/codegen/xai-fsnotify/src/source.rs:45
struct	FsWatcherStats	crates/codegen/xai-fsnotify/src/source.rs:49
fn	stats	crates/codegen/xai-fsnotify/src/source.rs:65
fn	set_runtime_handle	crates/codegen/xai-fsnotify/src/source.rs:81
fn	shared	crates/codegen/xai-fsnotify/src/source.rs:112
struct	FsConfig	crates/codegen/xai-fsnotify/src/source.rs:173
fn	with_debounce_ms	crates/codegen/xai-fsnotify/src/source.rs:189
fn	with_ignore_patterns	crates/codegen/xai-fsnotify/src/source.rs:195
struct	FsEventSource	crates/codegen/xai-fsnotify/src/source.rs:209
fn	start	crates/codegen/xai-fsnotify/src/source.rs:220
fn	start_on	crates/codegen/xai-fsnotify/src/source.rs:228
fn	subscribe	crates/codegen/xai-fsnotify/src/source.rs:272
fn	os_watch_count	crates/codegen/xai-fsnotify/src/source.rs:281
fn	shutdown	crates/codegen/xai-fsnotify/src/source.rs:286
const	COOLDOWN_MS	crates/codegen/xai-fsnotify/src/state.rs:7
const	SETTLE_MS	crates/codegen/xai-fsnotify/src/state.rs:13
enum	LockState	crates/codegen/xai-fsnotify/src/state.rs:21
enum	LockTransition	crates/codegen/xai-fsnotify/src/state.rs:42
fn	drive	crates/codegen/xai-fsnotify/src/state.rs:55
struct	StaleWarn	crates/codegen/xai-fsnotify/src/state.rs:130
fn	check	crates/codegen/xai-fsnotify/src/state.rs:135
struct	RawFsEvent	crates/codegen/xai-fsnotify/src/watcher.rs:54
struct	FsNotifyConfig	crates/codegen/xai-fsnotify/src/watcher.rs:76
fn	sapling_enabled	crates/codegen/xai-fsnotify/src/watcher.rs:122
enum	WatchStrategy	crates/codegen/xai-fsnotify/src/watcher.rs:132

公开符号用于快速判断 crate 对外暴露的数据、trait 和执行入口。私有实现仍会出现在完整文件索引中；本文不会仅凭 pub 推断某个符号就是长期稳定 API。

关联深度文章

Workspace Execution、VCS、FS Events 与 Gix Status串联命令执行、版本控制状态、语义文件事件和线程预算。

完整 Rust 文件索引

共 10 个 Rust 文件，其中 7 个被覆盖校验认定为生产源码。测试、示例、基准和 Fuzz 文件不会从图谱删除，而是使用不同标签展示。

基准crates/codegen/xai-fsnotify/benches/startup.rs148 行 · 0 个公开符号示例crates/codegen/xai-fsnotify/examples/watch_stats.rs212 行 · 0 个公开符号生产源码crates/codegen/xai-fsnotify/src/error.rs15 行 · 1 个公开符号生产源码crates/codegen/xai-fsnotify/src/event.rs77 行 · 3 个公开符号生产源码crates/codegen/xai-fsnotify/src/lib.rs21 行 · 0 个公开符号生产源码crates/codegen/xai-fsnotify/src/paths.rs86 行 · 1 个公开符号生产源码crates/codegen/xai-fsnotify/src/source.rs1,499 行 · 12 个公开符号生产源码crates/codegen/xai-fsnotify/src/state.rs374 行 · 7 个公开符号生产源码crates/codegen/xai-fsnotify/src/watcher.rs3,882 行 · 11 个公开符号测试crates/codegen/xai-fsnotify/tests/integration.rs371 行 · 0 个公开符号

覆盖说明

该页面由固定源码基线生成。CI 会重新扫描 crates/codegen/xai-fsnotify，验证文件数量、行数、公开符号、依赖和入口是否与提交到站点的数据一致。若上游基线升级而图谱没有重新生成，构建会失败，避免页面显示已经不存在的路径。