DAG总览 / 组目录 / G16 文件系统

dsh-fs-observation-policy · @deepseek-ai/dsh-fs-observation-policy

Layer 0G16
目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游(该插件依赖的前驱):
无依赖(基础插件)
依赖链 · 下游(依赖该插件的节点):
无下游(叶子/被消费端)
同一拓扑层(Layer 0,层次遍历层序):
Layer 0↓ Layer 1(13 插件)

插件信息

包名@deepseek-ai/dsh-fs-observation-policy
分组G16 · 文件系统
拓扑层Layer 0(层次遍历:被依赖方先于依赖方)
源码路径packages/fs/fs-observation-policy

① 实现逻辑

事件专属的文件观察策略,不注册任何服务:ObservedStateGate 用 WeakMap(owner→targetKey→FsObservation) 记录每次权威的 present/absent 观察,区分「确认不存在」与「未见」 (src/index.ts:28-54, 91-94)。在 fs/write-intent 与 fs/edit-intent 两个单槽 waterfall 上据该状态派生 createIfAbsent/replaceIfVersion,或对未读/不存在抛 FS_NOT_OBSERVED/FS_NOT_FOUND (src/index.ts:65-88, 119-122);fs/observed 上同步记录且保持同步非抛 (src/index.ts:127-129)。无此插件时工具退回 provider 的无条件变更行为。

内部结构动态 DAG(深色主题:橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件)
本插件 上游依赖 下游依赖 外部 seam

② 注册/提供(provides)

③ 依赖(depends_on · 上游前驱)

无依赖(基础插件)

④ 被依赖(dependents · 下游消费者)

无下游(叶子/被消费端)