帧澈 ZENCHE

跨平台相机控制与影像传输工具

Capture · Connect · Flow

连接相机，也连接完整工作流

简体中文 · English · 日本語

帧澈 ZENCHE 是一套本地优先的原生相机工作流工具：通过 USB/PTP 连接并控制 Nikon 相机，通过 FTP、HTTP 或 WebDAV 接收影像，再在同一个应用里完成预览、 管理、导入与分享。

• 当前源码版本：1.2.0
• 原生目标：macOS · Windows · Android · HarmonyOS · iOS / iPadOS
• 界面语言：简体中文 · English · 日本語（可在齿轮设置中即时切换）
• 相机档案：20 款 Nikon EXPEED 5 / 6 / 7 机型
• 项目仓库：github.com/Tauber01/ZENCHE
• 安装包：GitHub Releases

实时取景与原生参数控制	FTP / HTTP / WebDAV 无线收件箱

LUT、直方图、波形、矢量示波器、峰值对焦、假色和条纹图案只影响监看画面， 不修改原片，也不写入相机的视频设置。 具体能力取决于平台、相机固件、镜头和当前拍摄模式。

五个目标均为原生实现，不使用 WebView 复用界面。

iOS/iPadOS 的公开 API 不向普通应用开放 Nikon 厂商 USB/PTP 控制，因此当前不能 通过 iPhone 或 iPad 调整 Nikon 机身参数或下载 USB 原片。外接 UVC 只作为视频源， 不会被标记为 Nikon 原生控制。

项目内置以下 20 款机型的 USB 档案：

• EXPEED 5： D500、D7500、D850
• EXPEED 6： Z7、Z6、Z50、D780、D6、Z5、Z7II、Z6II、Z fc、Z30
• EXPEED 7： Z9、Z8、Z f、Z6III、Z50II、Z5II、ZR

机型档案表示应用能够正确识别设备并选择相应参数范围，不代表所有固件、镜头和 USB 主机组合均已完成实机验证。请使用 相机实机验收清单记录结果。

前往 GitHub Releases 下载已发布 版本及同名 .sha256 校验文件。1.2.0 的交付文件命名如下：

Windows 相机接口可能需要切换为 WinUSB。操作前请阅读 Windows 构建与 USB 驱动，避免影响 NX Tether、 Camera Control Pro 或系统照片导入。HarmonyOS 与 iOS 的签名说明分别见 HarmonyOS 构建与部署和 iOS 签名与发布。

校验下载文件：

shasum -a 256 -c ZENCHE-1.2.0-macOS-arm64.dmg.sha256

Windows PowerShell：

Get-FileHash .\ZENCHE-1.2.0-Windows-x64-Setup.exe -Algorithm SHA256

五个原生客户端会在启用“启动时自动检查更新”后优先请求 Mirror酱，并在服务不可用、CDK 无效或没有可直接安装的 完整包时自动回退 GitHub Releases。设置页可填写可选 CDK；iOS / iPadOS 与 macOS 保存到系统钥匙串，Android 使用 Android Keystore，Windows 使用 DPAPI， HarmonyOS 保存到应用私有设置，所有平台都不会把 CDK 写入诊断日志。

为避免破坏签名与平台安装状态，客户端不会直接覆盖应用文件，也不会应用 Mirror酱增量包；仅接受完整安装包并交给各平台原生安装流程。资源标识当前预留为 ZENCHE。在 Mirror酱完成资源注册和平台包映射前，客户端会显示“资源尚未配置” 并继续使用 GitHub，不影响原有更新检查。服务端接入与上传令牌配置请参考 MirrorChyan 官方集成指南。

1. 关闭 NX Tether、Camera Control Pro、照片、图像捕捉等可能占用 PTP 接口的软件。
2. 使用支持数据传输的 USB 线直连设备；首次排查时不要经过扩展坞。
3. 打开帧澈 ZENCHE，选择“连接相机”，并允许系统访问 USB 设备。
4. 等待实时取景出现，再调整参数或拍摄。
5. 在“文件”中确认影像已经写入本地图库后，再断开相机。

macOS 的系统 PTP 服务有时会先占用相机；应用会尝试释放并重新连接。拍摄或修改 参数时，实时取景短暂停顿属于正常现象。若机身报告温度过高，请停止取景并等待 相机冷却。

让相机和接收设备连接到同一个可信局域网，在“传输”页开启无线接收，然后按应用 显示的地址配置发送端。

HTTP/WebDAV 使用同一组 Basic Auth 凭据，上传请求必须提供 Content-Length。

curl --user nikonlink:nikonlink \
  --upload-file DSC_0001.NEF \
  http://192.168.1.20:8080/upload/DSC_0001.NEF

这些入口没有 TLS 加密，只适合在可信局域网内临时开启。传输完成后请关闭接收， 不要将端口暴露到公网；iOS/iPadOS 进入后台时会自动停止无线服务。

macOS 主机可统一构建 macOS、Android，并在工具链可用时构建 iOS 与 HarmonyOS：

./scripts/build-all.sh

常用环境：

• macOS 14+、Apple Silicon、Homebrew、libgphoto2
• OpenJDK 17、Android SDK 35、Gradle 8.10.2
• 完整 Xcode 与 iPhoneOS SDK
• DevEco Studio 6.0.1+、HarmonyOS SDK API 12+
• Windows 11、.NET 8 SDK、NSIS 3、对应架构的 libusb-1.0.dll

单平台构建：

./scripts/build-macos.sh
./scripts/build-android.sh
./scripts/build-ios.sh --unsigned
./scripts/build-harmony.sh

Windows 需在 Windows 主机运行：

.\scripts\build-windows.ps1 `
  -Runtime win-x64 `
  -LibUsbDll C:\path\to\libusb-1.0.dll

生成已签名 iOS 包：

IOS_DEVELOPMENT_TEAM=你的TeamID ./scripts/build-ios.sh --signed

所有产物写入 dist/，并生成 SHA-256 校验文件。运行共享测试：

npm test

native/
  macos/          SwiftUI / AppKit
  windows/        WPF / .NET 8
  android/        Android Views / USB Host
  harmony/        Stage / ArkUI
  ios/            SwiftUI / AVFoundation / PhotoKit
scripts/          构建、签名与打包脚本
docs/             平台、术语、安全与实机验收文档
icons/            产品图标与品牌资产
PV/               宣传视频工程与交付说明

延伸阅读：

• 版本记录
• Nikon 中文术语与 PTP 映射
• 相机实机验收清单
• Windows 构建与 USB 驱动
• HarmonyOS 构建与部署
• iOS 签名与发布
• 安全策略
• 第三方许可

提交问题前，请记录相机型号、固件、镜头、数据线、主机系统和复现步骤，并附上应用 生成的脱敏诊断信息：

• 提交 Issue
• 查看现有 Issues
• 安全漏洞报告

应用不会自动上传照片或完整日志。预填 Issue 会先交给用户检查，再由用户手动提交。

项目源码使用 MIT License，第三方组件说明见 THIRD_PARTY_NOTICES.md。

Nikon 及文中相机型号为 Nikon Corporation 的商标。本项目与 Nikon Corporation 无隶属、合作、赞助或背书关系。

帧澈 ZENCHE is a local-first, cross-platform camera control and image transfer tool for macOS, Windows, Android, HarmonyOS, and iOS/iPadOS.

It connects supported Nikon EXPEED 5/6/7 cameras through native USB/PTP implementations where the operating system permits it, provides live view and capture controls, receives images through FTP/HTTP/WebDAV, and keeps the files in a local library for review and export.

• Source version: 1.2.0
• Native targets: macOS · Windows · Android · HarmonyOS · iOS / iPadOS
• Interface languages: Simplified Chinese · English · Japanese (switch instantly from the gear settings)
• Camera profiles: 20 Nikon EXPEED 5 / 6 / 7 bodies
• Downloads: GitHub Releases
• Hardware validation: Camera test checklist

LUTs, scopes, focus peaking, false color, and zebra overlays affect only the monitoring image. They do not modify the original file or write video settings to the camera. Capabilities vary with the platform, camera firmware, lens, and shooting mode.

All five targets use native implementations rather than a shared WebView UI.

Public iOS/iPadOS APIs do not expose Nikon vendor-specific USB/PTP control to ordinary apps. On Apple mobile platforms, ZENCHE supports the system camera, compatible external UVC video input on iPadOS, local file workflows, and foreground FTP/HTTP/WebDAV receiving.

• EXPEED 5: D500, D7500, and D850
• EXPEED 6: Z7, Z6, Z50, D780, D6, Z5, Z7II, Z6II, Z fc, and Z30
• EXPEED 7: Z9, Z8, Z f, Z6III, Z50II, Z5II, and ZR

All profiles use Nikon USB Vendor ID 0x04b0. A built-in camera profile means that ZENCHE can identify the device and select the intended parameter range; it does not mean that every firmware, lens, cable, and USB host combination has completed hardware validation.

Download published packages and their matching .sha256 files from GitHub Releases. Version 1.2.0 uses the following delivery names:

Windows may require binding the camera PTP interface to WinUSB. Read Windows build and USB driver first, because changing the interface driver can affect NX Tether, Camera Control Pro, or system photo import. See HarmonyOS build and deployment and iOS signing and release for platform signing details.

When Automatically check for updates at launch is enabled, all five native clients query MirrorChyan first and fall back to GitHub Releases when the service is unavailable, the CDK is invalid, or no directly installable full package is returned. The optional CDK is stored in the Apple Keychain on iOS, iPadOS, and macOS, Android Keystore on Android, DPAPI on Windows, and private app settings on HarmonyOS. It is never written to diagnostic logs.

To preserve code signatures and platform installation state, clients do not overwrite application files or apply MirrorChyan incremental packages. They accept full installers only and hand them to the native installation flow. The reserved resource ID is ZENCHE. Until that resource and its platform package mappings are registered with MirrorChyan, clients report that the resource is not configured and continue using GitHub. See the official MirrorChyan integration guide for server-side registration and upload-token setup.

1. Quit NX Tether, Camera Control Pro, Photos, Image Capture, and other software that may claim the PTP interface.
2. Connect the camera directly with a data-capable USB cable. Avoid a hub while troubleshooting the first connection.
3. Open ZENCHE, choose Connect camera, and grant USB access.
4. Wait for live view before changing parameters or capturing.
5. Confirm that the image appears in the local library before disconnecting.

The macOS PTP service may claim the camera first; ZENCHE attempts to release and reconnect it. A short live-view pause during capture or parameter changes is normal. Stop live view and let the camera cool if it reports overheating.

Connect the camera and receiver to the same trusted LAN, enable wireless receiving in ZENCHE, and configure the sender with the address shown by the app.

HTTP/WebDAV uses the same credentials through Basic Auth and requires Content-Length.

curl --user nikonlink:nikonlink \
  --upload-file DSC_0001.NEF \
  http://192.168.1.20:8080/upload/DSC_0001.NEF

These services do not provide TLS. Enable them only temporarily on a trusted LAN and never expose the ports to the public Internet. iOS/iPadOS stops all wireless listeners when the app enters the background.

On macOS, build macOS and Android plus iOS and HarmonyOS when their toolchains are available:

./scripts/build-all.sh

Individual targets:

./scripts/build-macos.sh
./scripts/build-android.sh
./scripts/build-ios.sh --unsigned
./scripts/build-harmony.sh

Build Windows on a Windows host:

.\scripts\build-windows.ps1 `
  -Runtime win-x64 `
  -LibUsbDll C:\path\to\libusb-1.0.dll

All artifacts are written to dist/ with SHA-256 checksum files. Run shared tests with npm test. Some project directories, schemes, package identifiers, and environment variables retain NikonLink / com.tauber.nikonlink for upgrade compatibility; all public branding and delivery filenames use ZENCHE.

Before opening an Issue, record the camera, firmware, lens, cable, host OS, reproduction steps, and redacted diagnostics. ZENCHE does not automatically upload photos or complete logs.

Source code is released under the MIT License. Third-party notices are listed in THIRD_PARTY_NOTICES.md.

Nikon and all camera model names are trademarks of Nikon Corporation. This project is not affiliated with, endorsed by, or sponsored by Nikon Corporation.

帧澈 ZENCHE は、macOS、Windows、Android、HarmonyOS、iOS/iPadOS に対応する、 ローカル優先設計のクロスプラットフォーム・カメラ制御／画像転送ツールです。 OS が許可する環境では Nikon カメラを USB/PTP で接続・制御し、FTP、HTTP、 WebDAV で画像を受信して、同じアプリ内でプレビュー、管理、読み込み、共有まで 行えます。

• 現在のソースバージョン：1.2.0
• ネイティブ対象：macOS · Windows · Android · HarmonyOS · iOS / iPadOS
• 表示言語：簡体字中国語 · English · 日本語（歯車の設定から即時切り替え）
• カメラプロファイル：Nikon EXPEED 5 / 6 / 7 の 20 機種
• ダウンロード：GitHub Releases
• 実機検証：カメラ実機テストチェックリスト

LUT、スコープ、フォーカスピーキング、フォルスカラー、ゼブラはモニター画像だけに 適用されます。原本を変更したり、カメラ本体の動画設定へ書き込んだりしません。利用できる機能は、 プラットフォーム、ファームウェア、レンズ、撮影モードによって異なります。

5 つの対象はすべてネイティブ実装で、共通 WebView UI は使用していません。

iOS/iPadOS の公開 API は、一般アプリに Nikon 固有の USB/PTP 制御を提供して いません。Apple のモバイル環境では、システムカメラ、iPadOS の互換外付け UVC 入力、ローカルファイル管理、フォアグラウンドの FTP/HTTP/WebDAV 受信に対応します。

• EXPEED 5： D500、D7500、D850
• EXPEED 6： Z7、Z6、Z50、D780、D6、Z5、Z7II、Z6II、Z fc、Z30
• EXPEED 7： Z9、Z8、Z f、Z6III、Z50II、Z5II、ZR

全プロファイルの Nikon USB Vendor ID は 0x04b0 です。内蔵プロファイルは、 機器を識別して想定されるパラメーター範囲を選択できることを示しますが、すべての ファームウェア、レンズ、ケーブル、USB ホストの組み合わせで実機検証済みという 意味ではありません。

GitHub Releases から公開済み パッケージと同名の .sha256 ファイルをダウンロードしてください。1.2.0 の 配布ファイル名は次のとおりです。

Windows ではカメラの PTP インターフェースを WinUSB に割り当てる必要がある場合が あります。NX Tether、Camera Control Pro、システムの写真読み込みへ影響する可能性 があるため、先に Windows ビルドと USB ドライバーを 確認してください。署名については HarmonyOS ビルドと配備および iOS 署名とリリースを参照してください。

「起動時にアップデートを自動確認」を有効にすると、5 つのネイティブクライアントは まず MirrorChyan を確認し、サービスを利用できない場合、 CDK が無効な場合、または直接インストールできる完全パッケージが返らない場合に GitHub Releases へ自動的に切り替えます。任意の CDK は iOS / iPadOS と macOS では Apple Keychain、Android では Android Keystore、Windows では DPAPI、 HarmonyOS ではアプリの非公開設定に保存され、診断ログには記録されません。

コード署名と各プラットフォームのインストール状態を保護するため、クライアントは アプリファイルを直接上書きせず、MirrorChyan の差分パッケージも適用しません。 完全なインストーラーのみを各 OS の標準インストール手順へ渡します。予約済みの リソース ID は ZENCHE です。MirrorChyan 側でリソース登録とプラットフォーム別 パッケージの対応付けが完了するまでは「リソース未設定」と表示し、GitHub による 更新確認を継続します。サーバー側の登録とアップロードトークン設定は MirrorChyan 公式統合ガイドを参照してください。

1. NX Tether、Camera Control Pro、「写真」、「イメージキャプチャ」など、 PTP インターフェースを使用するソフトウェアを終了します。
2. データ通信対応 USB ケーブルでカメラを直接接続します。初回の問題切り分けでは ハブを使用しないでください。
3. ZENCHE を開き、「カメラを接続」を選択して USB アクセスを許可します。
4. ライブビューが表示されてから、パラメーター変更や撮影を行います。
5. 切断前に画像がローカルライブラリへ保存されたことを確認します。

macOS の PTP サービスが先にカメラを占有する場合、ZENCHE は解放と再接続を 試みます。撮影や設定変更中の短いライブビュー停止は正常です。カメラが過熱を 報告した場合はライブビューを停止し、冷却を待ってください。

カメラと受信端末を同じ信頼できる LAN に接続し、ZENCHE でワイヤレス受信を 有効にして、アプリに表示されるアドレスを送信側へ設定します。

HTTP/WebDAV は同じ認証情報の Basic Auth を使用し、Content-Length が必要です。

curl --user nikonlink:nikonlink \
  --upload-file DSC_0001.NEF \
  http://192.168.1.20:8080/upload/DSC_0001.NEF

これらのサービスは TLS を提供しません。信頼できる LAN 内で一時的にだけ有効にし、 ポートをインターネットへ公開しないでください。iOS/iPadOS ではアプリがバック グラウンドへ移行すると、すべてのワイヤレス受信を停止します。

macOS では macOS と Android をビルドし、利用可能なツールチェーンに応じて iOS と HarmonyOS もビルドできます。

./scripts/build-all.sh

個別ターゲット：

./scripts/build-macos.sh
./scripts/build-android.sh
./scripts/build-ios.sh --unsigned
./scripts/build-harmony.sh

Windows は Windows ホストでビルドします。

.\scripts\build-windows.ps1 `
  -Runtime win-x64 `
  -LibUsbDll C:\path\to\libusb-1.0.dll

すべての成果物は dist/ に出力され、SHA-256 チェックサムが生成されます。 共有テストは npm test で実行します。アップグレード互換性を維持するため、 一部のディレクトリ、scheme、パッケージ識別子、環境変数には NikonLink / com.tauber.nikonlink が残っていますが、公開ブランドと配布 ファイル名はすべて ZENCHE です。

Issue を作成する前に、カメラ、 ファームウェア、レンズ、ケーブル、ホスト OS、再現手順、匿名化済み診断情報を 記録してください。ZENCHE が写真や完全なログを自動アップロードすることは ありません。

ソースコードは MIT License で公開されています。第三者コンポーネント については THIRD_PARTY_NOTICES.md を参照してください。

Nikon および各カメラ機種名は Nikon Corporation の商標です。本プロジェクトは Nikon Corporation と提携、承認、スポンサー関係にありません。