# file_manager

**Repository Path**: giaog/file_manager

## Basic Information

- **Project Name**: file_manager
- **Description**: No description available
- **Primary Language**: Python
- **License**: MPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uTools 网络文件夹

这是一个 macOS uTools 插件，将 Windows UNC 网络路径转换为 Finder 可识别的 SMB 地址并打开。

## 在 uTools 中接入开发

1. 打开 uTools 开发者工具并新建项目。
2. 在项目的应用开发页面选择 `src/plugin.json`。
3. 点击“接入开发”，再点击“打开”。

可在 uTools 主输入框中输入“网络文件夹”打开完整界面。直接粘贴形如 `\\server\share\folder` 或 `smb://server/share/folder` 的路径，选择“在 Finder 中打开网络路径”即可自动唤起 Finder，无需再点击插件按钮。

## 界面操作

- 输入或粘贴 Windows UNC 路径。
- 确认自动生成的 `smb://` Finder 地址。
- 点击“在 Finder 中打开”，或按 `Command + Enter`。
- 首次访问 NAS 时，Finder 可能弹出登录框；凭据由 macOS Finder/钥匙串管理。
- 插件仅支持 macOS；网络路径匹配后由 Finder 负责连接和登录。

## 测试

```bash
node src/test_core.js
PYTHONPATH=src python3 -m unittest -v src/test_open_unc.py
```

原 Python 原型 `src/open_unc.py` 保留作独立命令行工具；uTools 插件本身不依赖 Python。

## 离线打包

在 uTools 开发者工具中选择“打包”，将 `src/` 目录作为插件工程。正式打包前可删除仅用于开发验证的文件：

```bash
src/open_unc.py
src/test_open_unc.py
src/test_core.js
```