Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
e0e08e7
docs: plan bilingual desktop delivery
IZCosmos Nov 20, 2026
8e8e329
feat(i18n): add bilingual catalogs and persisted desktop language pre…
IZCosmos Nov 20, 2026
af9fecb
feat(i18n): localize desktop workflows and retained notifications
IZCosmos Nov 20, 2026
e146912
test(i18n): verify scan admission errors across both languages
IZCosmos Nov 20, 2026
4f70e17
test(i18n): build accessibility fixtures after desktop locales load
IZCosmos Nov 20, 2026
befbaf5
docs: add the Chinese README with centered language links
IZCosmos Nov 21, 2026
43015ba
feat(i18n): add Japanese and identify Simplified Chinese by script
IZCosmos Nov 21, 2026
bf2d074
fix(i18n): remove the unreleased language preference alias
IZCosmos Nov 21, 2026
5a93706
docs(i18n): define internationalization requirements for contributors
IZCosmos Nov 21, 2026
78e1c61
fix(i18n): preserve selection after changing languages back
IZCosmos Nov 21, 2026
7e69c00
fix(i18n): localize storage location conflicts
IZCosmos Nov 21, 2026
af97d7e
fix(i18n): translate complete sidebar action labels
IZCosmos Nov 21, 2026
0ff1f3d
fix(i18n): reflect storage diagnostic disclosure state
IZCosmos Nov 21, 2026
9832966
fix(i18n): declare storage error presentation contract
IZCosmos Nov 21, 2026
5973b9c
fix(i18n): align workbench backgrounds with localized rail width
IZCosmos Nov 21, 2026
9052f95
fix(i18n): align photo information columns across languages
IZCosmos Nov 21, 2026
d9d0f0f
fix(ui): dismiss hover tooltips when actions are pressed
IZCosmos Nov 21, 2026
fdfead7
fix(ui): acknowledge persistent viewer analysis notices
IZCosmos Nov 21, 2026
6382988
fix(viewer): reuse decoded thumbnails during filmstrip navigation
IZCosmos Nov 21, 2026
984def6
fix(i18n): let forms and viewer readouts fit enlarged text
IZCosmos Nov 21, 2026
951b534
test(ui): align layout fixtures with reported window dimensions
IZCosmos Nov 21, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 2 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -215,6 +215,8 @@ replacement, redesign or extra features. Follow the existing design system and a
Follow the [component implementation requirements](docs/product/gallery-ui.md#component-implementation)
for admission, pinned-SDK proof, framework ownership, bounded rendering and accessibility, and the
[content/action rules](docs/product/gallery-ui.md#content-and-action-wording) for affected text.
Follow the [internationalization standard](docs/development/internationalization.md) when changing
user-facing text, language preferences, translations or localized READMEs.

Bottom feedback and image-preview top notices follow the
[feedback templates](docs/product/gallery/feedback.md#feedback-templates), including their shared component
Expand Down
55 changes: 55 additions & 0 deletions README.ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
![Cedarflake Ame](docs/images/ame.png)

<p align="center"><a href="./README.md">English</a> | <a href="./README.zh-Hans.md">简体中文</a> | 日本語</p>

Ame は、大量の画像を自分の PC で閲覧、検索、整理できる Windows アプリです。普段使っているフォルダーを追加すると、重複した写真やよく似た写真を探したり、お気に入りやアルバムにまとめたりできます。

![Ame の Windows 版ギャラリー。左にフォルダー一覧、中央に写真、右に日付のタイムラインが並ぶ](docs/images/ame-gallery.png)

## ダウンロード

Ame は現在 **Alpha 版**です。[リリースページ](https://github.com/Cedarflake/Cedarflake-Ame/releases)から **Windows 11 x64** 向けのパッケージをダウンロードできます。

- **MSI インストーラー**には画像解析モデルとランタイムが含まれています。ライブラリをバックグラウンドで更新する Windows サービスもインストールします。インストールには管理者権限が必要です。
- **ポータブル版 ZIP** は、すべてのファイルを展開してから `Cedarflake-Ame/cedarflake_ame.exe` を実行してください。画像解析モデルは初めて使うときにダウンロードされます。Windows サービスのインストールは不要です。

[Windows 11 向けプレビュー版](https://github.com/Cedarflake/Cedarflake-Ame/actions/workflows/quality_windows_arm64.yml)には、x64 版と ARM64 版の MSI、および ARM64 用のポータブル版 ZIP があります。Arm 搭載 PC で x64 版の MSI を使用している場合は、先にアンインストールしてから ARM64 版をインストールしてください。

Ame の更新は手動です。更新前にアプリを終了し、ポータブル版はバージョンごとに別のフォルダーへ展開してください。リリース版とプレビュー版のパッケージは未署名です。変更点や既知の制限は[リリースノート](docs/releases/README.md)に記載しています。

## 写真を閲覧する

写真を縦横比のまま一覧表示したり、正方形のグリッドに並べたりできます。タイムラインから日付を選ぶと、その日の写真に移動します。写真を開いたら、拡大、回転、2 枚の比較ができます。画面下のサムネイルを展開すると、前後の写真も選べます。ギャラリーに戻ると、直前まで見ていた位置から閲覧を続けられます。

異なるドライブのフォルダーを同じライブラリに追加でき、特定のフォルダーだけに絞って表示することもできます。Ame はファイルの変更をバックグラウンドで反映します。アプリを閉じていた間の変更を反映している間も、写真を閲覧できます。

## 写真を探す・比較する

ファイル名やパスで検索したり、探したい写真を言葉で説明したり、表示中の写真に関連する画像を探したりできます。ファイル形式、日付、画像の寸法、ファイルサイズ、カメラ情報による絞り込みも組み合わせられます。スマートアルバムは SigLIP 2 を使って PC 上で写真を分類します。対応するデバイスでは GPU アクセラレーションが既定で有効になっており、設定からオフにできます。

内容が完全に一致するファイルは重複写真として検出されます。ギャラリーで複数のコピーを 1 枚にまとめ、それぞれの保存場所を確認したり、重複写真の画面で比較したりできます。グループの代表にする写真を選ぶことも、すべて残したいグループを整理対象から除外することもできます。見た目が似ている写真は別にグループ化され、類似度の基準を調整できます。

## 写真を整理する

写真をお気に入りやアルバムに追加し、アルバムごとにアイコンを選べます。写真を 1 枚ずつ整理しているときは進行状況が保存され、次回は続きから再開できます。

Ame から Windows の機能を使ってファイルのコピー、移動、名前の変更、削除ができます。削除すると通常はごみ箱に移動します。完全に削除する場合は、その操作を明示的に選びます。重複写真や類似写真を整理するときは、自分で選んだ写真が残ります。選んでいない場合はグループの代表写真が残り、削除前に対象のファイル数を確認できます。結果はファイル操作履歴で確認でき、中断した操作は内容に応じて再開できます。

## ソースから実行する

Ame は開発中です。Windows 11 x64 でビルドするには、Flutter **3.50.0**、[rust-toolchain.toml](rust-toolchain.toml) で指定された Rust ツールチェーン、Visual Studio 2022 が必要です。Visual Studio では「C++ によるデスクトップ開発」ワークロード、Windows SDK、CMake ツールをインストールしてください。Windows on Arm でビルドする場合は、[ARM64 のビルド手順](docs/acceptance/quality/commands.md#build-on-windows-arm64)を参照してください。

```powershell
flutter pub get
flutter run -d windows
```

画面には Flutter と Material 3 を使用しています。Rust がカタログ、ファイルの変更追跡、プレビュー、画像解析、ファイル操作を担当し、ライブラリのデータは SQLite に保存されます。

詳しくは[ロードマップ](docs/roadmap.md)、[開発ガイド](docs/development/repository-layout.md)、[ビルドとテストのコマンド](docs/acceptance/quality-gates.md)、[アーキテクチャの解説](docs/architecture/README.md)を参照してください。

## ライセンス

Copyright 2026 Cedarflake Ame contributors.

特記がある場合を除き、Cedarflake Ame には [Apache License, Version 2.0](LICENSE)(`Apache-2.0`)が適用されます。サードパーティのコード、依存ライブラリ、モデルの重み、リソースには、それぞれのライセンスと表記が適用されます。
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
![Cedarflake Ame](docs/images/ame.png)

<p align="center">English | <a href="./README.zh-Hans.md">简体中文</a> | <a href="./README.ja.md">日本語</a></p>

Ame is a local-first Windows app for browsing, searching, and organizing large image collections.
Add the folders you already use, find duplicates and similar images, and organize your collection
with favorites, albums, or file operations.
Expand Down
55 changes: 55 additions & 0 deletions README.zh-Hans.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
![Cedarflake Ame](docs/images/ame.png)

<p align="center"><a href="./README.md">English</a> | 简体中文 | <a href="./README.ja.md">日本語</a></p>

Ame 是一款在本地浏览、搜索和整理大量图片的 Windows 应用。把平时存放图片的文件夹添加到图库,就可以查找重复或相似的图片,用收藏和相册整理它们,也可以直接管理文件。

![Ame 的 Windows 图库界面,左侧是文件夹导航,中间是图片墙,右侧是日期时间轴](docs/images/ame-gallery.png)

## 下载

Ame 目前处于 **Alpha 阶段**。在[发布页面](https://github.com/Cedarflake/Cedarflake-Ame/releases)可以下载适用于 **Windows 11 x64** 的安装版或便携版。

- **MSI 安装程序**需要管理员权限。安装包自带图片分析模型和运行时,并会安装用于在后台更新图库的 Windows 服务。
- 使用**便携版 ZIP** 时,请先完整解压,再运行 `Cedarflake-Ame/cedarflake_ame.exe`。便携版不安装 Windows 服务,图片分析模型会在首次使用时下载。

[Windows 11 预览版](https://github.com/Cedarflake/Cedarflake-Ame/actions/workflows/quality_windows_arm64.yml)提供 x64 和 ARM64 两种 MSI 安装包,以及 ARM64 便携版 ZIP。如果你的 Arm 电脑上已安装 x64 版 MSI,请先卸载,再安装 ARM64 版。

Ame 需要手动升级。升级前请先关闭应用,不同版本的便携版请解压到各自的文件夹。发布包和预览包均未签名。各版本的改动和已知限制见[发行说明](docs/releases/README.md)。

## 浏览图库

可以用图片墙或方形网格浏览图片,也可以沿时间轴跳到想看的日期。打开大图后,可以放大查看、对比两张图片或旋转画面。展开底部的缩略图条,就能切换到前后的图片。退出大图后会回到图库中原来的位置。

不同硬盘上的文件夹可以放进同一个图库,也可以只浏览其中一个来源。Ame 会在后台跟踪文件变化。如果文件在应用关闭期间发生了变化,下次打开时可以照常浏览,图库会在后台更新。

## 查找和比较图片

可以按文件名或路径搜索,用自然语言描述想找的画面,或从当前图片查找相关图片。还可以组合使用文件格式、日期、图片尺寸、文件大小和相机信息等筛选条件。智能相册使用 SigLIP 2 在本地为图片分类。在支持的设备上,GPU 加速默认开启,可以在设置中关闭。

Ame 按文件内容识别完全相同的图片。在图库中,可以把多个副本折叠成一项,查看每份文件的位置,也可以打开重复图片视图进行比较。你可以为每组选择一张代表图,如果打算保留整组,也可以将它标记为忽略。画面相似的图片会单独分组,你可以调整相似度。

## 整理图库

可以收藏图片、将图片加入相册,也可以为相册选择图标。逐张整理图片时,Ame 会保存进度,下次可以从上次停下的地方继续。

Ame 支持通过 Windows 复制、移动、重命名和删除文件。删除的文件默认进入回收站,也可以手动选择永久删除。清理重复或相似图片时,Ame 会保留你选定的图片。如果没有手动选择,就保留自动选出的那张。删除前会请你确认文件数量。你可以在操作记录中查看结果,部分操作中断后也可以恢复。

## 从源码运行

Ame 仍在开发中。在 Windows 11 x64 上构建需要 Flutter **3.50.0**、[rust-toolchain.toml](rust-toolchain.toml) 指定的 Rust 工具链,以及 Visual Studio 2022。安装 Visual Studio 时,请勾选「使用 C++ 的桌面开发」工作负载,并安装 Windows SDK 和 CMake 工具。在 Windows on Arm 设备上构建请参阅 [ARM64 构建指南](docs/acceptance/quality/commands.md#build-on-windows-arm64)。

```powershell
flutter pub get
flutter run -d windows
```

界面使用 Flutter 和 Material 3 构建。Rust 负责图库索引、文件跟踪、预览、图片分析和文件操作,图库数据存储在 SQLite 中。

更多信息见[路线图](docs/roadmap.md)、[开发指南](docs/development/repository-layout.md)、[构建与测试命令](docs/acceptance/quality-gates.md)和[架构说明](docs/architecture/README.md)。

## 许可证

版权所有 © 2026 Cedarflake Ame 贡献者。

除另有说明外,Cedarflake Ame 使用 [Apache 许可证 2.0](LICENSE)(`Apache-2.0`)。第三方代码、依赖项、模型权重和资源各自适用其原有的许可证和声明。
2 changes: 2 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@ only the contracts, execution details, and evidence that own the task.
| How will R8 use Windows file operations and verify recovery? | [R8 execution plan](plans/r8-file-organization.md), [product scope](product/organization-workflows.md#r8---file-organization-and-recovery) and [filesystem verification](acceptance/r8-file-operations.md) |
| How will R9 move album files by year, and where does ExifTool fit? | [R9 execution plan](plans/r9-album-files-by-year.md) and [roadmap disposition](roadmap.md#r9--album-files-by-year) |
| What remains before the first Beta? | [R10 execution plan](plans/r10-beta-readiness.md) and [roadmap disposition](roadmap.md#r10--beta-readiness) |
| How is desktop language support delivered? | [Internationalization plan](plans/desktop-internationalization.md) and [application language behavior](product/gallery-ui.md#scope-and-authority) |
| How do I change user-facing text or add a language? | [Internationalization standard](development/internationalization.md) |
| Where will official Material spring motion be adopted? | [Material motion plan](plans/material-motion.md) and [roadmap disposition](roadmap.md#material-motion-adoption) |
| How is the Material wide-screen workbench implemented? | [Workbench layout plan](plans/material-workbench.md) and [roadmap disposition](roadmap.md#material-desktop-workbench) |
| How will transition costs be reduced without changing accepted effects? | [Motion performance plan](plans/motion-performance.md) and [roadmap disposition](roadmap.md#transition-performance) |
Expand Down
Loading
Loading