add: 文件整理桌面版与自动发布流程

Author: cimorn

.github/workflows/release.yml

@@ -0,0 +1,143 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Release tag, for example v26.07.02
+        required: true
+        type: string
+
+permissions:
+  contents: write
+
+jobs:
+  windows-release:
+    name: Build Windows exe and publish release
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      - name: Set up pnpm
+        run: |
+          corepack enable
+          corepack prepare pnpm@11.7.0 --activate
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests
+        run: pnpm test
+
+      - name: Build desktop executable
+        env:
+          CSC_IDENTITY_AUTO_DISCOVERY: false
+        run: pnpm run release:desktop
+
+      - name: Resolve release tag
+        id: release
+        shell: pwsh
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          INPUT_TAG: ${{ inputs.tag }}
+          REF_TYPE: ${{ github.ref_type }}
+          REF_NAME: ${{ github.ref_name }}
+        run: |
+          [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+          $OutputEncoding = [System.Text.Encoding]::UTF8
+          $package = Get-Content package.json -Raw | ConvertFrom-Json
+          if ($env:EVENT_NAME -eq 'workflow_dispatch' -and $env:INPUT_TAG) {
+            $tag = $env:INPUT_TAG
+          } elseif ($env:REF_TYPE -eq 'tag') {
+            $tag = $env:REF_NAME
+          } else {
+            $tag = "v$($package.releaseVersion)"
+          }
+
+          if (-not $tag.StartsWith('v')) {
+            $tag = "v$tag"
+          }
+
+          "tag=$tag" | Out-File -FilePath $env:GITHUB_OUTPUT -Append -Encoding utf8
+          "title=[FileOrganizer](https://github.com/cimorn/FileOrganizer)-$tag" | Out-File -FilePath $env:GITHUB_OUTPUT -Append -Encoding utf8
+          "sourceAssetName=文件整理-$tag.exe" | Out-File -FilePath $env:GITHUB_OUTPUT -Append -Encoding utf8
+          "assetName=FileOrganizer-$tag.exe" | Out-File -FilePath $env:GITHUB_OUTPUT -Append -Encoding utf8
+
+      - name: Create or update GitHub release
+        shell: pwsh
+        env:
+          GH_TOKEN: ${{ github.token }}
+          RELEASE_TAG: ${{ steps.release.outputs.tag }}
+          RELEASE_TITLE: ${{ steps.release.outputs.title }}
+          SOURCE_ASSET_NAME: ${{ steps.release.outputs.sourceAssetName }}
+          ASSET_NAME: ${{ steps.release.outputs.assetName }}
+        run: |
+          $ErrorActionPreference = 'Stop'
+          [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+          $OutputEncoding = [System.Text.Encoding]::UTF8
+          $assetPath = Join-Path "dist" $env:SOURCE_ASSET_NAME
+          if (-not (Test-Path -LiteralPath $assetPath)) {
+            throw "Release asset not found: $assetPath"
+          }
+
+          $headers = @{
+            Authorization = "Bearer $env:GH_TOKEN"
+            Accept = "application/vnd.github+json"
+            "X-GitHub-Api-Version" = "2022-11-28"
+          }
+          $apiBase = "https://api.github.com/repos/$env:GITHUB_REPOSITORY"
+          $release = $null
+
+          try {
+            $release = Invoke-RestMethod -Headers $headers -Uri "$apiBase/releases/tags/$env:RELEASE_TAG"
+          } catch {
+            if ($_.Exception.Response.StatusCode.value__ -ne 404) {
+              throw
+            }
+          }
+
+          if ($release) {
+            foreach ($releaseAsset in $release.assets) {
+              if ($releaseAsset.name.EndsWith('.exe')) {
+                Invoke-RestMethod -Method Delete -Headers $headers -Uri "$apiBase/releases/assets/$($releaseAsset.id)"
+              }
+            }
+            $release = Invoke-RestMethod `
+              -Method Patch `
+              -Headers $headers `
+              -Uri "$apiBase/releases/$($release.id)" `
+              -ContentType "application/json" `
+              -Body (@{ name = $env:RELEASE_TITLE } | ConvertTo-Json)
+          } else {
+            $release = Invoke-RestMethod `
+              -Method Post `
+              -Headers $headers `
+              -Uri "$apiBase/releases" `
+              -ContentType "application/json" `
+              -Body (@{
+                tag_name = $env:RELEASE_TAG
+                target_commitish = "${{ github.sha }}"
+                name = $env:RELEASE_TITLE
+                generate_release_notes = $true
+              } | ConvertTo-Json)
+          }
+
+          $encodedName = [System.Uri]::EscapeDataString($env:ASSET_NAME)
+          Invoke-RestMethod `
+            -Method Post `
+            -Headers $headers `
+            -Uri "https://uploads.github.com/repos/$env:GITHUB_REPOSITORY/releases/$($release.id)/assets?name=$encodedName" `
+            -ContentType "application/octet-stream" `
+            -InFile $assetPath

.gitignore

@@ -0,0 +1,14 @@
+node_modules/
+dist/
+qa-output/
+
+.env
+.env.*
+*.log
+
+coverage/
+.vite/
+.turbo/
+
+Thumbs.db
+Desktop.ini

CHANGELOG.md

@@ -0,0 +1,40 @@
+# 更新日志
+
+**中文** | [English](CHANGELOG_EN.md)
+
+本文件记录文件整理的重要变更。
+
+## [26.07.02] - 2026-07-02
+
+### 新增
+
+- 软件名称统一为 `文件整理`，英文说明中使用 `File Organizer`。
+- 支持按时间线浏览图片、视频和普通文件。
+- 支持自定义批量改名模板，包括 `{yy}`、`{MM}`、`{dd}`、`{index}` 和 `{name}`。
+- 支持移动和“改名并移动”的文件夹模板。
+- 支持 Excel 导出、导入和表格改名。
+- 支持通过 Excel 修改后缀；新后缀为空时保留原后缀。
+- 支持按固定间隔批量修改文件创建时间、修改时间和访问时间。
+- 支持按大小和 SHA-256 哈希查找重复文件。
+- 支持操作历史和撤销改名、移动操作。
+- 执行文件操作前会检测目标冲突。
+- 为首个开源候选版本生成产品检测报告。
+
+### 调整
+
+- 将 UI 统一调整为蓝色系。
+- 将搜索、文件类型、包含子文件夹、页面切换和 Excel 操作移到顶部工具栏。
+- 将批量操作按钮和目标文件夹选择放到右侧预览区域。
+- 将生成的 Windows exe 改名为 `dist\文件整理.exe`。
+- 将项目元信息改为 `file-organizer`、`local.file-organizer` 和 `文件整理`。
+
+### 修复
+
+- 修复打包后主进程路径错误导致的启动失败。
+- 修复顶部工具栏和空状态页面的排版问题。
+- 清理蓝色主题更新后残留的旧绿色样式。
+
+### 已知说明
+
+- 如果 Windows exe 正在运行，`pnpm run build:desktop` 可能因为 `dist\文件整理.exe` 被占用而失败。重新打包前请先关闭软件。
+- `package.json` 使用 `26.7.2`，因为 npm 包版本需要符合语义化版本规则。公开发布版本仍为 `26.07.02`。

CHANGELOG_EN.md

@@ -0,0 +1,40 @@
+# Changelog
+
+[中文](CHANGELOG.md) | **English**
+
+This file documents notable changes to File Organizer.
+
+## [26.07.02] - 2026-07-02
+
+### Added
+
+- Unified the app name as `文件整理`, with `File Organizer` used in English documentation.
+- Added timeline browsing for photos, videos, and ordinary files.
+- Added custom batch rename templates, including `{yy}`, `{MM}`, `{dd}`, `{index}`, and `{name}`.
+- Added folder templates for move and rename-and-move operations.
+- Added Excel export, import, and spreadsheet-based rename workflows.
+- Added extension editing through Excel import. Empty new extension values keep the original extension.
+- Added batch editing for file creation, modified, and access times with configurable intervals.
+- Added duplicate file detection by size and SHA-256 hash.
+- Added operation history and undo support for completed rename and move operations.
+- Added conflict detection before file operations.
+- Added a product QA report for the first public release candidate.
+
+### Changed
+
+- Changed the visual theme to a blue color system.
+- Moved search, file type, recursive mode, page navigation, and Excel actions into the top toolbar.
+- Moved operation controls and destination folder selection into the right-side preview panel.
+- Renamed the generated Windows executable to `dist\文件整理.exe`.
+- Updated project metadata to `file-organizer`, `local.file-organizer`, and `文件整理`.
+
+### Fixed
+
+- Fixed a packaged app startup error caused by an incorrect main process path.
+- Fixed layout issues in the toolbar and empty state.
+- Removed old green theme remnants after the blue theme update.
+
+### Known Notes
+
+- If the Windows executable is running, `pnpm run build:desktop` may fail because Windows locks `dist\文件整理.exe`. Close the app before rebuilding.
+- `package.json` uses `26.7.2` because npm package versions must follow semantic version rules. The public release version remains `26.07.02`.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 File Organizer contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM,
+OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.