CHANGELOG.md

@@ -1,8 +1,5 @@
 # Changelog
 
-## v1.5.2 (2026-06-08)
-- **JS 对齐**: 将所有注册到 `jsmod` 的导出方法名统一为 PascalCase（如 `Read`, `Write`, `GetFileInfo`），消除 JS 环境下的调用摩擦。
-
 ## [1.3.3] - 2026-05-30
 - **新增**: 注册到 `jsmod`，将所有文件操作方法（Read/Write/Archive 等）注册为高危方法（unsafeList），确保安全沙箱隔离。
 

file.go

@@ -308,9 +308,9 @@ func VerifyPathForSafeMode(ctx context.Context, path string) (string, error) {
 		return RealPath(path), nil
 	}
 
-	// 1. 获取白名单
+	// 1. 获取白名单 (约定从 ctx 获取 "AllowedDirs")
 	var allowedDirs []string
-	cast.Convert(&allowedDirs, jsmod.Get(ctx, "AllowedDirs"))
+	cast.Convert(&allowedDirs, ctx.Value("AllowedDirs"))
 	if len(allowedDirs) == 0 {
 		return "", fmt.Errorf("file: access denied, AllowedDirs not found in context")
 	}

js_export.go

@@ -9,42 +9,42 @@ import (
 func init() {
 	jsmod.Register("file", map[string]any{
 		// 读操作 (映射到私有包装器)
-		"Exists": func(ctx context.Context, path string) bool {
+		"exists": func(ctx context.Context, path string) bool {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return false
 			}
 			return Exists(p)
 		},
-		"Read": func(ctx context.Context, path string) (string, error) {
+		"read": func(ctx context.Context, path string) (string, error) {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return "", err
 			}
 			return Read(p)
 		},
-		"ReadBytes": func(ctx context.Context, path string) ([]byte, error) {
+		"readBytes": func(ctx context.Context, path string) ([]byte, error) {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return nil, err
 			}
 			return ReadBytes(p)
 		},
-		"ReadLines": func(ctx context.Context, path string) ([]string, error) {
+		"readLines": func(ctx context.Context, path string) ([]string, error) {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return nil, err
 			}
 			return ReadLines(p)
 		},
-		"ReadDir": func(ctx context.Context, path string) ([]FileInfo, error) {
+		"readDir": func(ctx context.Context, path string) ([]FileInfo, error) {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return nil, err
 			}
 			return ReadDir(p)
 		},
-		"GetFileInfo": func(ctx context.Context, path string) *FileInfo {
+		"getFileInfo": func(ctx context.Context, path string) *FileInfo {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return nil
@@ -53,35 +53,35 @@ func init() {
 		},
 
 		// 写操作
-		"Write": func(ctx context.Context, path string, content string) error {
+		"write": func(ctx context.Context, path string, content string) error {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return err
 			}
 			return Write(p, content)
 		},
-		"WriteBytes": func(ctx context.Context, path string, content []byte) error {
+		"writeBytes": func(ctx context.Context, path string, content []byte) error {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return err
 			}
 			return WriteBytes(p, content)
 		},
-		"Remove": func(ctx context.Context, path string) error {
+		"remove": func(ctx context.Context, path string) error {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return err
 			}
 			return Remove(p)
 		},
-		"Mkdir": func(ctx context.Context, path string) error {
+		"mkdir": func(ctx context.Context, path string) error {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return err
 			}
 			return Mkdir(p)
 		},
-		"Copy": func(ctx context.Context, from, to string) error {
+		"copy": func(ctx context.Context, from, to string) error {
 			pFrom, err := VerifyPathForSafeMode(ctx, from)
 			if err != nil {
 				return err
@@ -92,7 +92,7 @@ func init() {
 			}
 			return Copy(pFrom, pTo)
 		},
-		"Move": func(ctx context.Context, from, to string) error {
+		"move": func(ctx context.Context, from, to string) error {
 			pFrom, err := VerifyPathForSafeMode(ctx, from)
 			if err != nil {
 				return err
@@ -103,7 +103,7 @@ func init() {
 			}
 			return Move(pFrom, pTo)
 		},
-		"Replace": func(ctx context.Context, path, old, new string) error {
+		"replace": func(ctx context.Context, path, old, new string) error {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return err
@@ -112,21 +112,21 @@ func init() {
 		},
 
 		// 序列化
-		"UnmarshalFile": func(ctx context.Context, path string, to any) error {
+		"unmarshalFile": func(ctx context.Context, path string, to any) error {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return err
 			}
 			return UnmarshalFile(p, to)
 		},
-		"MarshalFile": func(ctx context.Context, path string, data any) error {
+		"marshalFile": func(ctx context.Context, path string, data any) error {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return err
 			}
 			return MarshalFile(p, data)
 		},
-		"MarshalFilePretty": func(ctx context.Context, path string, data any) error {
+		"marshalFilePretty": func(ctx context.Context, path string, data any) error {
 			p, err := VerifyPathForSafeMode(ctx, path)
 			if err != nil {
 				return err
@@ -135,7 +135,7 @@ func init() {
 		},
 
 		// 归档
-		"Archive": func(ctx context.Context, src, dest string) error {
+		"archive": func(ctx context.Context, src, dest string) error {
 			pSrc, err := VerifyPathForSafeMode(ctx, src)
 			if err != nil {
 				return err
@@ -146,7 +146,7 @@ func init() {
 			}
 			return Archive(pSrc, pDest)
 		},
-		"Extract": func(ctx context.Context, src, dest string, strip bool) error {
+		"extract": func(ctx context.Context, src, dest string, strip bool) error {
 			pSrc, err := VerifyPathForSafeMode(ctx, src)
 			if err != nil {
 				return err
@@ -159,7 +159,7 @@ func init() {
 		},
 
 		// 压缩工具 (无路径，不校验)
-		"Compress":   Compress,
+		"compress":   Compress,
-		"Decompress": Decompress,
+		"decompress": Decompress,
 	})
 }

memory.go

@@ -186,7 +186,7 @@ func LoadFileToB64(filename string) *MemFileB64 {
 					ModTime:    info.ModTime(),
 					IsDir:      false,
 					Size:       info.Size(),
-					DataB64:    []byte(encoding.Base64(data)),
+					DataB64:    encoding.Base64(data),
 					Compressed: compressed,
 				}
 			}