网盘设计

const FilenameReservedRegex = /[<>:"/\\|?*\u0000-\u001F]/g;
const WindowsReservedNameRegex = /^(con|prn|aux|nul|com\d|lpt\d)$/i;

# application/x-directory; charset=binary
file --mime-type --mime-encoding $PWD

namespace.attribute
user.mime_type
trusted.md5sum,
system.posix_acl_access
security.selinux

struct inode {
    struct hlist_node       i_hash;              /* hash list */
    struct list_head        i_list;              /* list of inodes */
    struct list_head        i_dentry;            /* list of dentries */
    unsigned long           i_ino;               /* inode number */
    atomic_t                i_count;             /* reference counter */
    umode_t                 i_mode;              /* access permissions */
    unsigned int            i_nlink;             /* number of hard links */
    uid_t                   i_uid;               /* user id of owner */
    gid_t                   i_gid;               /* group id of owner */
    kdev_t                  i_rdev;              /* real device node */
    loff_t                  i_size;              /* file size in bytes */
    struct timespec         i_atime;             /* last access time */
    struct timespec         i_mtime;             /* last modify time */
    struct timespec         i_ctime;             /* last change time */
    unsigned int            i_blkbits;           /* block size in bits */
    unsigned long           i_blksize;           /* block size in bytes */
    unsigned long           i_version;           /* version number */
    unsigned long           i_blocks;            /* file size in blocks */
    unsigned short          i_bytes;             /* bytes consumed */
    spinlock_t              i_lock;              /* spinlock */
    struct rw_semaphore     i_alloc_sem;         /* nests inside of i_sem */
    struct semaphore        i_sem;               /* inode semaphore */
    struct inode_operations *i_op;               /* inode ops table */
    struct file_operations  *i_fop;              /* default inode ops */
    struct super_block      *i_sb;               /* associated superblock */
    struct file_lock        *i_flock;            /* file lock list */
    struct address_space    *i_mapping;          /* associated mapping */
    struct address_space    i_data;              /* mapping for device */
    struct dquot            *i_dquot[MAXQUOTAS]; /* disk quotas for inode */
    struct list_head        i_devices;           /* list of block devices */
    struct pipe_inode_info  *i_pipe;             /* pipe information */
    struct block_device     *i_bdev;             /* block device driver */
    unsigned long           i_dnotify_mask;      /* directory notify mask */
    struct dnotify_struct   *i_dnotify;          /* dnotify */
    unsigned long           i_state;             /* state flags */
    unsigned long           dirtied_when;        /* first dirtying time */
    unsigned int            i_flags;             /* filesystem flags */
    unsigned char           i_sock;              /* is this a socket? */
    atomic_t                i_writecount;        /* count of writers */
    void                    *i_security;         /* security module */
    __u32                   i_generation;        /* inode version number */
    union {
            void            *generic_ip;         /* filesystem-specific info */
    } u;
};

struct inode_operations {
    int (*create) (struct inode *, struct dentry *,int);
    struct dentry * (*lookup) (struct inode *, struct dentry *);
    int (*link) (struct dentry *, struct inode *, struct dentry *);
    int (*unlink) (struct inode *, struct dentry *);
    int (*symlink) (struct inode *, struct dentry *, const char *);
    int (*mkdir) (struct inode *, struct dentry *, int);
    int (*rmdir) (struct inode *, struct dentry *);
    int (*mknod) (struct inode *, struct dentry *, int, dev_t);
    int (*rename) (struct inode *, struct dentry *,
                    struct inode *, struct dentry *);
    int (*readlink) (struct dentry *, char *, int);
    int (*follow_link) (struct dentry *, struct nameidata *);
    int (*put_link) (struct dentry *, struct nameidata *);
    void (*truncate) (struct inode *);
    int (*permission) (struct inode *, int);
    int (*setattr) (struct dentry *, struct iattr *);
    int (*getattr) (struct vfsmount *, struct dentry *, struct kstat *);
    int (*setxattr) (struct dentry *, const char *,
                      const void *, size_t, int);
    ssize_t (*getxattr) (struct dentry *, const char *, void *, size_t);
    ssize_t (*listxattr) (struct dentry *, char *, size_t);
    int (*removexattr) (struct dentry *, const char *);
};

export type CommonStatInfo = Readonly<{
  path: string;
  lastModifiedMs?: number;
  visibility?: string;
}>;

export type FileInfo = Readonly<
  {
    type: 'file';
    size?: number;
    isFile: true;
    isDirectory: false;
    mimeType?: string;
  } & CommonStatInfo
>;

export type DirectoryInfo = Readonly<
  {
    type: 'directory';
    isFile: false;
    isDirectory: true;
  } & CommonStatInfo
>;

export type StatEntry = FileInfo | DirectoryInfo;

export type FileContents = Iterable<any> | AsyncIterable<any> | NodeJS.ReadableStream | Readable | string;

export interface StorageAdapter {
  write(path: string, contents: Readable, options: WriteOptions): Promise<void>;
  read(path: string): Promise<FileContents>;
  deleteFile(path: string): Promise<void>;
  createDirectory(path: string, options: CreateDirectoryOptions): Promise<void>;
  copyFile(from: string, to: string, options: CopyFileOptions): Promise<void>;
  moveFile(from: string, to: string, options: MoveFileOptions): Promise<void>;
  stat(path: string): Promise<StatEntry>;
  list(path: string, options: { deep: boolean }): AsyncGenerator<StatEntry>;
  changeVisibility(path: string, visibility: string): Promise<void>;
  visibility(path: string): Promise<string>;
  deleteDirectory(path: string): Promise<void>;
  fileExists(path: string): Promise<boolean>;
  directoryExists(path: string): Promise<boolean>;
  publicUrl(path: string, options: PublicUrlOptions): Promise<string>;
  temporaryUrl(path: string, options: TemporaryUrlOptions): Promise<string>;
  checksum(path: string, options: ChecksumOptions): Promise<string>;
  mimeType(path: string, options: MimeTypeOptions): Promise<string>;
  lastModified(path: string): Promise<number>;
  fileSize(path: string): Promise<number>;
}

export type MiscellaneousOptions = {
  [option: string]: any;
};

export type MimeTypeOptions = MiscellaneousOptions & {
  disallowFallback?: boolean;
  fallbackMethod?: 'contents' | 'path';
};

export type VisibilityOptions = {
  visibility?: string;
  directoryVisibility?: string;
};
export type WriteOptions = VisibilityOptions &
  MiscellaneousOptions & {
    mimeType?: string;
    size?: number;
    cacheControl?: string;
  };

export type CreateDirectoryOptions = MiscellaneousOptions & Pick<VisibilityOptions, 'directoryVisibility'> & {};
export type PublicUrlOptions = MiscellaneousOptions & {};
export type CopyFileOptions = MiscellaneousOptions &
  VisibilityOptions & {
    retainVisibility?: boolean;
  };
export type MoveFileOptions = MiscellaneousOptions &
  VisibilityOptions & {
    retainVisibility?: boolean;
  };
export type ListOptions = { deep?: boolean };
export type TemporaryUrlOptions = MiscellaneousOptions & {
  expiresAt: ExpiresAt;
};

type setting struct {
    Name  string `xorm:"pk"`
    Value string `xorm:"varchar(4096) notnull"`
}
type counter struct {
    Name  string `xorm:"pk"`
    Value int64  `xorm:"notnull"`
}
type node struct {
    Inode  Ino    `xorm:"pk"`
    Type   uint8  `xorm:"notnull"`
    Flags  uint8  `xorm:"notnull"`
    Mode   uint16 `xorm:"notnull"`
    Uid    uint32 `xorm:"notnull"`
    Gid    uint32 `xorm:"notnull"`
    Atime  int64  `xorm:"notnull"`
    Mtime  int64  `xorm:"notnull"`
    Ctime  int64  `xorm:"notnull"`
    Nlink  uint32 `xorm:"notnull"`
    Length uint64 `xorm:"notnull"`
    Rdev   uint32
    Parent Ino
    AccessACLId  uint32 `xorm:"'access_acl_id'"`
    DefaultACLId uint32 `xorm:"'default_acl_id'"`
}
type edge struct {
    Id     int64  `xorm:"pk bigserial"`
    Parent Ino    `xorm:"unique(edge) notnull"`
    Name   []byte `xorm:"unique(edge) varbinary(255) notnull"`
    Inode  Ino    `xorm:"index notnull"`
    Type   uint8  `xorm:"notnull"`
}
type chunk struct {
    Id     int64  `xorm:"pk bigserial"`
    Inode  Ino    `xorm:"unique(chunk) notnull"`
    Indx   uint32 `xorm:"unique(chunk) notnull"`
    Slices []byte `xorm:"blob notnull"`
}
type sliceRef struct {
    Id   uint64 `xorm:"pk chunkid"`
    Size uint32 `xorm:"notnull"`
    Refs int    `xorm:"notnull"`
}
type symlink struct {
    Inode  Ino    `xorm:"pk"`
    Target []byte `xorm:"varbinary(4096) notnull"`
}
type xattr struct {
    Id    int64  `xorm:"pk bigserial"`
    Inode Ino    `xorm:"unique(name) notnull"`
    Name  string `xorm:"unique(name) notnull"`
    Value []byte `xorm:"blob notnull"`
}
type flock struct {
    Id    int64  `xorm:"pk bigserial"`
    Inode Ino    `xorm:"notnull unique(flock)"`
    Sid   uint64 `xorm:"notnull unique(flock)"`
    Owner int64  `xorm:"notnull unique(flock)"`
    Ltype byte   `xorm:"notnull"`
}
type plock struct {
    Id      int64  `xorm:"pk bigserial"`
    Inode   Ino    `xorm:"notnull unique(plock)"`
    Sid     uint64 `xorm:"notnull unique(plock)"`
    Owner   int64  `xorm:"notnull unique(plock)"`
    Records []byte `xorm:"blob notnull"`
}
type delfile struct {
    Inode  Ino    `xorm:"pk notnull"`
    Length uint64 `xorm:"notnull"`
    Expire int64  `xorm:"notnull"`
}
type delslices struct {
    Id      uint64 `xorm:"pk chunkid"`
    Deleted int64  `xorm:"notnull"`
    Slices  []byte `xorm:"blob notnull"`
}
type sustained struct {
    Id    int64  `xorm:"pk bigserial"`
    Sid   uint64 `xorm:"unique(sustained) notnull"`
    Inode Ino    `xorm:"unique(sustained) notnull"`
}

interface FileSystemHandle {
  readonly kind: 'file' | 'directory';
  readonly name: string;

  isSameEntry(other: FileSystemHandle): Promise<boolean>;
  queryPermission(descriptor?: FileSystemHandlePermissionDescriptor): Promise<PermissionState>;
  requestPermission(descriptor?: FileSystemHandlePermissionDescriptor): Promise<PermissionState>;

  /**
   * @deprecated Old property just for Chromium <=85. Use `kind` property in the new API.
   */
  readonly isFile: boolean;

  /**
   * @deprecated Old property just for Chromium <=85. Use `kind` property in the new API.
   */
  readonly isDirectory: boolean;
}
var FileSystemHandle: {
  prototype: FileSystemHandle;
  new (): FileSystemHandle;
};
type FileSystemHandleUnion = FileSystemFileHandle | FileSystemDirectoryHandle;

interface FilePickerAcceptType {
  description?: string | undefined;
  accept: Record<string, string | string[]>;
}

interface FilePickerOptions {
  types?: FilePickerAcceptType[] | undefined;
  excludeAcceptAllOption?: boolean | undefined;
}

interface OpenFilePickerOptions extends FilePickerOptions {
  multiple?: boolean | undefined;
}

interface SaveFilePickerOptions extends FilePickerOptions {
  suggestedName?: string;
}

// eslint-disable-next-line @typescript-eslint/no-empty-interface
interface DirectoryPickerOptions {}

type FileSystemPermissionMode = 'read' | 'readwrite';

interface FileSystemPermissionDescriptor extends PermissionDescriptor {
  handle: FileSystemHandle;
  mode?: FileSystemPermissionMode | undefined;
}

interface FileSystemHandlePermissionDescriptor {
  mode?: FileSystemPermissionMode | undefined;
}

interface FileSystemCreateWritableOptions {
  keepExistingData?: boolean | undefined;
}

interface FileSystemGetFileOptions {
  create?: boolean | undefined;
}

interface FileSystemGetDirectoryOptions {
  create?: boolean | undefined;
}

interface FileSystemRemoveOptions {
  recursive?: boolean | undefined;
}

type WriteParams =
  | { type: 'write'; position?: number | undefined; data: BufferSource | Blob | string }
  | { type: 'seek'; position: number }
  | { type: 'truncate'; size: number };

type FileSystemWriteChunkType = BufferSource | Blob | string | WriteParams;

// TODO: remove this once https://github.com/microsoft/TSJS-lib-generator/issues/881 is fixed.
// Native File System API especially needs this method.
interface WritableStream {
  close(): Promise<void>;
}

class FileSystemWritableFileStream extends WritableStream {
  write(data: FileSystemWriteChunkType): Promise<void>;
  seek(position: number): Promise<void>;
  truncate(size: number): Promise<void>;
}

interface FileSystemFileHandle extends FileSystemHandle {
  readonly kind: 'file';
  getFile(): Promise<File>;
  createWritable(options?: FileSystemCreateWritableOptions): Promise<FileSystemWritableFileStream>;
  /**
   * @deprecated Old property just for Chromium <=85. Use `kind` property in the new API.
   */
  readonly isFile: true;
  /**
   * @deprecated Old property just for Chromium <=85. Use `kind` property in the new API.
   */
  readonly isDirectory: false;
}

var FileSystemFileHandle: {
  prototype: FileSystemFileHandle;
  new (): FileSystemFileHandle;
};

interface FileSystemDirectoryHandle extends FileSystemHandle {
  readonly kind: 'directory';
  getDirectoryHandle(name: string, options?: FileSystemGetDirectoryOptions): Promise<FileSystemDirectoryHandle>;
  getFileHandle(name: string, options?: FileSystemGetFileOptions): Promise<FileSystemFileHandle>;
  removeEntry(name: string, options?: FileSystemRemoveOptions): Promise<void>;
  resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;
  keys(): AsyncIterableIterator<string>;
  values(): AsyncIterableIterator<FileSystemDirectoryHandle | FileSystemFileHandle>;
  entries(): AsyncIterableIterator<[string, FileSystemDirectoryHandle | FileSystemFileHandle]>;
  [Symbol.asyncIterator]: FileSystemDirectoryHandle['entries'];
  /**
   * @deprecated Old property just for Chromium <=85. Use `kind` property in the new API.
   */
  readonly isFile: false;
  /**
   * @deprecated Old property just for Chromium <=85. Use `kind` property in the new API.
   */
  readonly isDirectory: true;
}

var FileSystemDirectoryHandle: {
  prototype: FileSystemDirectoryHandle;
  new (): FileSystemDirectoryHandle;
};

interface DataTransferItem {
  getAsFileSystemHandle(): Promise<FileSystemHandle | null>;
}

interface StorageManager {
  getDirectory(): Promise<FileSystemDirectoryHandle>;
}

function showOpenFilePicker(
  options?: OpenFilePickerOptions & { multiple?: false | undefined },
): Promise<[FileSystemFileHandle]>;
function showOpenFilePicker(options?: OpenFilePickerOptions): Promise<FileSystemFileHandle[]>;
function showSaveFilePicker(options?: SaveFilePickerOptions): Promise<FileSystemFileHandle>;
function showDirectoryPicker(options?: DirectoryPickerOptions): Promise<FileSystemDirectoryHandle>;

// Old methods available on Chromium 85 instead of the ones above.

interface ChooseFileSystemEntriesOptionsAccepts {
  description?: string | undefined;
  mimeTypes?: string[] | undefined;
  extensions?: string[] | undefined;
}

interface ChooseFileSystemEntriesFileOptions {
  accepts?: ChooseFileSystemEntriesOptionsAccepts[] | undefined;
  excludeAcceptAllOption?: boolean | undefined;
}

/**
 * @deprecated Old method just for Chromium <=85. Use `showOpenFilePicker()` in the new API.
 */
function chooseFileSystemEntries(
  options?: ChooseFileSystemEntriesFileOptions & {
    type?: 'open-file' | undefined;
    multiple?: false | undefined;
  },
): Promise<FileSystemFileHandle>;
/**
 * @deprecated Old method just for Chromium <=85. Use `showOpenFilePicker()` in the new API.
 */
function chooseFileSystemEntries(
  options: ChooseFileSystemEntriesFileOptions & {
    type?: 'open-file' | undefined;
    multiple: true;
  },
): Promise<FileSystemFileHandle[]>;
/**
 * @deprecated Old method just for Chromium <=85. Use `showSaveFilePicker()` in the new API.
 */
function chooseFileSystemEntries(
  options: ChooseFileSystemEntriesFileOptions & {
    type: 'save-file';
  },
): Promise<FileSystemFileHandle>;
/**
 * @deprecated Old method just for Chromium <=85. Use `showDirectoryPicker()` in the new API.
 */
function chooseFileSystemEntries(options: { type: 'open-directory' }): Promise<FileSystemDirectoryHandle>;

interface GetSystemDirectoryOptions {
  type: 'sandbox';
}

interface FileSystemDirectoryHandle {
  /**
   * @deprecated Old property just for Chromium <=85. Use `.getFileHandle()` in the new API.
   */
  getFile: FileSystemDirectoryHandle['getFileHandle'];

  /**
   * @deprecated Old property just for Chromium <=85. Use `.getDirectoryHandle()` in the new API.
   */
  getDirectory: FileSystemDirectoryHandle['getDirectoryHandle'];

  /**
   * @deprecated Old property just for Chromium <=85. Use `.keys()`, `.values()`, `.entries()`, or the directory itself as an async iterable in the new API.
   */
  getEntries: FileSystemDirectoryHandle['values'];
}

interface FileSystemHandlePermissionDescriptor {
  /**
   * @deprecated Old property just for Chromium <=85. Use `mode: ...` in the new API.
   */
  writable?: boolean | undefined;
}

package vfs // import "golang.org/x/tools/godoc/vfs"

import (
	"io"
	"os"
)

// RootType indicates the type of files contained within a directory.
//
// It is used to indicate whether a directory is the root
// of a GOROOT, a GOPATH, or neither.
// An empty string represents the case when a directory is neither.
type RootType string

const (
	RootTypeGoRoot RootType = "GOROOT"
	RootTypeGoPath RootType = "GOPATH"
)

// The FileSystem interface specifies the methods godoc is using
// to access the file system for which it serves documentation.
type FileSystem interface {
	Opener
	Lstat(path string) (os.FileInfo, error)
	Stat(path string) (os.FileInfo, error)
	ReadDir(path string) ([]os.FileInfo, error)
	RootType(path string) RootType
	String() string
}

// Opener is a minimal virtual filesystem that can only open regular files.
type Opener interface {
	Open(name string) (ReadSeekCloser, error)
}

// A ReadSeekCloser can Read, Seek, and Close.
type ReadSeekCloser interface {
	io.Reader
	io.Seeker
	io.Closer
}

struct dirent {
  ino_t          d_ino;       /* Inode编号 */
  off_t          d_off;       /* 不是偏移量，详见下文 */
  unsigned short d_reclen;    /* 此记录的长度 */
  unsigned char  d_type;      /* 文件类型，不是所有文件系统都支持 */
  char           d_name[256]; /* 以空字符结尾的文件名 */
};


#define DT_UNKNOWN 0 // Unknown file type
#define DT_FIFO    1 // FIFO (named pipe)
#define DT_CHR     2 // Character device - 字符设备
#define DT_DIR     4 // Directory - 目录
#define DT_BLK     6 // Block device - 块设备
#define DT_REG     8 // Regular file - 文件
#define DT_LNK    10 // Symbolic link - 符号链接
#define DT_SOCK   12 // Socket - 套接字
#define DT_WHT    14 //

int            alphasort(const struct dirent **, const struct dirent **);
int            closedir(DIR *);
int            dirfd(DIR *);
DIR           *fdopendir(int);
DIR           *opendir(const char *);
ssize_t        posix_getdents(int, void *, size_t, int);
struct dirent *readdir(DIR *);
int            readdir_r(DIR *restrict, struct dirent *restrict, struct dirent **restrict);
void           rewinddir(DIR *);
int            scandir(const char *, struct dirent ***, int (*)(const struct dirent *), int (*)(const struct dirent **, const struct dirent **));
void           seekdir(DIR *, long);
long           telldir(DIR *);

[.ShellClassInfo]
LocalizedResourceName=显示名称

LocalizedResourceName=@%SystemRoot%\system32\shell32.dll,-21770

[Desktop Entry]
Name=显示名称
Name[zh_CN]=显示名称

// based on Apache commons-vfs2
class FileName {
  path: string;
  baseName: string;
  depth: number;
  extention: string;
  parent: FileName | null;
  root: FileName | null;
  schema: string;
  type: 'FILE' | 'FOLDER';
  uri: string;

  isAncestor(file: FileName): boolean;
  isDescendant(file: FileName, nameScope: 'FILE_SYSTEM' | 'CHILD' | 'DESCENDENT' | 'ANCESTOR'): boolean;
  isFile(): boolean;
}