@dbx-tools/fs (英语)

使用 @dbx-tools/shared-fs 与来自Node.js的本地磁盘签订合同。 这个 执行中增加了主机分隔器转换,节点一/O,并联封存, 错误映射到 BaseFileSystem。 。 。 .

快开始

import { LocalFileSystem } from "@dbx-tools/fs";

const files = new LocalFileSystem({ root: "./data" });
await files.init();
await files.writeFile("hello.txt", "hi");

执行工作规定:

• 在已配置的根下包含默认路径解析
• ~ 编号 : ~/... 使用 os.homedir() (在 HOME,则 数据砖App /home/app,然后创建一个 ./.home (创建失败跳过)
• 使用时间 os.tmpdir() 接下来 TMPDIR 编号 : TMP 编号 : TEMP,则 <home>/.tmp (每个候选人都必须通过书面/删除探测)
• 阅读/写作/附录/复制/移动外加mkdir/rmdir/readdir/stat/性别歧视
• 可选只读模式
• 在可用时使用节点创建附件、复制并重命名
• 同一稳定临时树同时重建的跨进程序列化

选择应用程序或代理文件系统

打电话者要讲便携时用这个 FileSystem 接口(相同) 表面 FTP、 对象存储或 Databricks 挂载可以执行) 而不是 节点API直接. 到达 node:fs 当你只需要一次性的本地 I/O.

当应用程序路径或UI 组件需要管理时使用 AppKit 文件插件 统一目录体积操作. 使用 @dbx-tools/ 数据砖 用于服务器侧工作空间,音量,或 DBFS访问. 挂载任何便携式 FileSystem 输入 @dbx-tools/appkit-mastra (英语) 当代理需要文件工具时. 在主机本地数据和临时工作树上使用此软件包 .

文件系统助手

import { LocalFileSystem, localFS } from "@dbx-tools/fs";

const local = new LocalFileSystem({ root: "./data" });
await local.init();
await local.writeFile("hello.txt", "hi");

const home = localFS.homeFS("projects/data");
const scratch = localFS.tmpFS("job-42");

// A throwaway working directory no other run can collide with.
const work = localFS.scratchFS("import-job");
await work.init(); // only needed when handing the root to `node:fs` or a subprocess

// Regenerate on every boot, but into one stable directory: the callback writes
// into a scratch root that replaces the stable one only on success, so restarts
// don't pile up directories, a failed rebuild keeps the last good tree, and
// concurrent rebuilds of the same key are serialized across processes.
const skills = await localFS.rebuildFS("agent-skills", async (scratch) => {
  await scratch.writeFile("SKILL.md", "# Generated skill\n");
});

模块

相邻 : @dbx-tools/shared-fs (单位:千美元)FileSystem 合同+ BaseFileSystem) (中文(简体) ).