mirror of https://github.com/farion1231/cc-switch.git synced 2026-03-22 15:08:22 +08:00

Files

Jason dafa77897b docs: add v3.8.0 release documentation and Japanese README

- Add CHANGELOG entry for v3.8.0
- Update README.md and README_ZH.md with v3.8.0 features
- Add Japanese README (README_JA.md)
- Add release notes in English, Chinese, and Japanese

2025-11-28 21:47:05 +08:00

10 KiB

Raw Blame History

CC Switch v3.8.0

永続化アーキテクチャを刷新し、クラウド同期の土台を構築

English → | 中文版 →

概要

CC Switch v3.8.0 はデータ永続化レイヤーと UI を大幅に作り替え、今後のクラウド同期やローカルプロキシ機能に向けた基盤を整えたメジャーアップデートです。

リリース日: 2025-11-28
コミット数: v3.7.1 以降 51 commits
変更量: 207 files, +17,297 / -6,870 lines

主要アップデート

永続化アーキテクチャの刷新

単一の JSON 保存から、階層化された SQLite + JSON の二層構造へ移行。

アーキテクチャ変更:

v3.7.x (旧)                       v3.8.0 (新)
┌─────────────────┐              ┌─────────────────────────────────┐
│  config.json    │              │  SQLite (同期対象データ)         │
│  ┌───────────┐  │              │  ├─ providers     プロバイダ設定 │
│  │ providers │  │              │  ├─ mcp_servers   MCP サーバー   │
│  │ mcp       │  │     ──>      │  ├─ prompts       プロンプト     │
│  │ prompts   │  │              │  ├─ skills        Skills         │
│  │ settings  │  │              │  └─ settings      汎用設定       │
│  └───────────┘  │              ├─────────────────────────────────┤
└─────────────────┘              │  JSON (デバイス固有データ)        │
                                 │  └─ settings.json ローカル設定    │
                                 │     ├─ ウィンドウ位置            │
                                 │     ├─ パスの上書き              │
                                 │     └─ 現在のプロバイダ ID        │
                                 └─────────────────────────────────┘

二層構造の設計:

レイヤー	ストレージ	データ種別	同期戦略
クラウド	SQLite	Providers, MCP, Prompts, Skills	将来同期対象
デバイス	JSON	ウィンドウ状態、ローカルパス	ローカル保持

実装ポイント:

スキーマバージョン管理: DB 構造のマイグレーションに対応
SQL インポート/エクスポート: backup.rs が SQL ダンプをサポート
トランザクション対応: SQLite ネイティブで整合性を確保
自動マイグレーション: 初回起動で config.json から自動移行

モジュール分割:

database/
├── mod.rs              Database 構造体と初期化
├── schema.rs           テーブル定義とスキーマ移行
├── backup.rs           SQL インポート/エクスポートとスナップショット
├── migration.rs        JSON → SQLite 変換エンジン
└── dao/                DAO レイヤー
    ├── providers.rs    プロバイダ CRUD
    ├── mcp.rs          MCP CRUD
    ├── prompts.rs      プロンプト CRUD
    ├── skills.rs       Skills CRUD
    └── settings.rs     設定 Key-Value 保存

新しいユーザーインターフェース

よりモダンな見た目と操作感に再設計。

レイアウト全面刷新、コンポーネントスタイルを統一
トランジションを滑らかにし、視覚的階層を最適化
メインビューのオーバースクロールバウンスを無効化
ブラウザ互換性向上のため Tailwind CSS を v4→v3.4 にダウングレード

日語化

UI が日本語に対応し、国際化が 3 言語（中/英/日）へ拡大。

新機能

Skills 递帰スキャン

Skills 管理がリポジトリを再帰的に走査し、ネストされた SKILL.md を自動検出。

複数階層のディレクトリに対応
すべての SKILL.md を自動発見
パスをキーにした重複排除で同名スキルを許容

プロバイダアイコン設定

プリセットがデフォルトアイコンを持ち、複製してもアイコンを保持。カスタム色も設定可能。

フォームバリデーション強化

必須項目にリアルタイム検証と分かりやすいエラーメッセージを追加し、トースト通知を統一。

自動起動

Windows/macOS/Linux で自動起動をサポート。

設定画面からワンクリックで ON/OFF
Registry / LaunchAgent / XDG autostart を使用

新プロバイダプリセット

MiniMax - 公式パートナー

バグ修正

重要修正

カスタムエンドポイント消失

原因: SQLite の INSERT OR REPLACE が内部で DELETE + INSERT を実行し、外部キーのカスケード削除が発生
対応: 既存プロバイダ更新を UPDATE に変更

Gemini 設定

カスタム環境変数が .env に正しく書き込まれない問題を修正
認証設定が他ファイルに誤って書き込まれる問題を修正

プロバイダ検証

現在プロバイダ ID が欠落している場合のバリデーションエラーを修正
複製時にアイコンフィールドが失われる問題を修正

プラットフォーム互換性

Linux

WebKitGTK の DMA-BUF 描画問題を解消
ユーザーの .desktop カスタマイズを保持

その他修正

アプリ切り替え時の不要な使用量クエリを削減
DMXAPI プリセットの誤ったトークンフィールドを修正
Deeplink コンポーネントの欠損翻訳キーを補完
使用量スクリプトテンプレート初期化を修正

技術的改善

アーキテクチャ再編

Provider Service のモジュール化:

services/provider/
├── mod.rs          追加/更新/削除/切替/検証の中核
├── live.rs         ライブ設定ファイル操作
├── gemini_auth.rs  Gemini 認証タイプ検出
├── endpoints.rs    カスタムエンドポイント管理
└── usage.rs        使用量スクリプト実行

Deeplink のモジュール化:

deeplink/
├── mod.rs       エクスポート
├── parser.rs    URL パース
├── provider.rs  プロバイダ取り込み
├── mcp.rs       MCP 取り込み
├── prompt.rs    プロンプト取り込み
├── skill.rs     Skills 取り込み
└── utils.rs     ユーティリティ

コード品質

レガシーな JSON 時代のインポート/エクスポート死蔵コードを削除
使われていない MCP 型を削除し、エラーハンドリングを統一
テストを SQLite バックエンドに移行し、MSW ハンドラを最新 API に合わせて更新

技術統計

全体変更:
- コミット: 51
- 変更ファイル: 207
- 追加: +17,297 行
- 削除: -6,870 行
- 純増: +10,427 行

コミット種別:
- fix: 25
- refactor: 11
- feat: 9
- test: 1
- other: 5

変更箇所:
- フロントエンド: 112 files
- Rust バックエンド: 63 files
- テスト: 20 files
- i18n: 3 files

マイグレーションガイド

v3.7.x からのアップグレード

自動マイグレーション（初回起動時）:

config.json の存在を検出
全データをトランザクションで SQLite に移行
デバイス設定を settings.json へ移行
移行成功の通知を表示

データ保護:

元の config.json は保持（削除しない）
失敗時はエラーダイアログを表示し、config.json を温存
Dry-run モードで検証可能

ダウンロード & インストール

システム要件

Windows: Windows 10+
macOS: macOS 10.15 (Catalina)+
Linux: Ubuntu 22.04+ / Debian 11+ / Fedora 34+

ダウンロード

Releases から入手:

Windows: CC-Switch-v3.8.0-Windows.msi または -Portable.zip
macOS: CC-Switch-v3.8.0-macOS.tar.gz または .zip
Linux: CC-Switch-v3.8.0-Linux.AppImage または .deb

Homebrew (macOS)

brew tap farion1231/ccswitch
brew install --cask cc-switch

アップデート:

brew upgrade --cask cc-switch

謝辞

コントリビューター

@YoVinchen - UI とデータベースリファクタ
@farion1231 - バグ修正と機能拡張
コミュニティの皆さん - テストとフィードバック

スポンサー

Zhipu AI - GLM CODING PLAN スポンサー
10% オフリンク

PackyCode - API リレーサービスパートナー
登録時に「cc-switch」で 10% オフ

ShandianShuo - ローカルファースト音声入力
Mac/Windows 無料ダウンロード

MiniMax - MiniMax M2 CODING PLAN スポンサー
ブラックフライデーセール中、$2 から

フィードバック & サポート

Issue: GitHub Issues
Discussions: GitHub Discussions
ドキュメント: README
更新履歴: CHANGELOG.md

今後のロードマップ

v3.9.0 予告（予定）:

ローカルプロキシ機能

続報にご期待ください！

Happy Coding!

10 KiB Raw Blame History