@ziioapp/os-features

浏览器文件工具与 ZiioApp OPFS 目录协议。当前包含文本编码识别、对象 URL 生命周期辅助、OPFS 路径与读写操作，以及 ZiioApp 应用目录布局。

import { decodeTextFile } from "@ziioapp/os-features";
import {
  ensureZiioOpfsLayout,
  getZiioOpfsAppPaths,
  readOpfsTextFile,
} from "@ziioapp/os-features/opfs";

await ensureZiioOpfsLayout({ appIds: ["my-app"] });
const paths = getZiioOpfsAppPaths("my-app");
const text = await readOpfsTextFile(`${paths.appData}/notes.txt`);

OPFS 操作需要支持 navigator.storage.getDirectory() 的浏览器环境；不提供 Node.js 文件系统或 Electron 主进程实现。OPFS 数据按浏览器 origin／存储分区隔离，安装同一包不会使不同应用自动共享文件。

/.ziio、/users、/apps 等路径及 ziioOpfsLayoutVersion 是持久化协议的一部分，后续修改须考虑已有数据迁移。开发时可使用根入口和 /files/*、/opfs、/opfs/* 子路径；发布产物提供对应的 JavaScript 与类型声明。