Version 2.1.3-beta.2

ALCOMD3 v2.1.3-beta.2

English

This beta keeps installed packages visible in Manage Packages and makes filtered package lists easier to scan.

Package list reliability

• Installed packages are no longer hidden when their IDs are declared as legacy packages by another installed package.
• VRChat SDK filtering no longer removes installed dependent packages from the list.
• Alternating row backgrounds now follow visible search results instead of counting filtered-out rows.

日本語

この beta では、Manage Packages でインストール済みパッケージが正しく表示され、絞り込み後の一覧が見やすくなりました。

パッケージ一覧の信頼性

• インストール済みパッケージの ID が別のインストール済みパッケージから legacy package として宣言されていても、そのパッケージを非表示にしないようにしました。
• VRChat SDK の絞り込みで、インストール済みの依存パッケージが一覧から削除されないようにしました。
• 交互の行背景は、絞り込みで非表示になった行を数えず、表示中の検索結果に沿って適用されます。

中文

此测试版会在“管理软件包”中正确保留已安装软件包，并提升筛选后软件包列表的可读性。

软件包列表可靠性

• 当另一个已安装软件包将其 ID 声明为 legacy package 时，不再隐藏该已安装软件包。
• VRChat SDK 筛选不再从列表中移除已安装的依赖软件包。
• 交替行背景现在仅按搜索后仍可见的结果计算，不再计入被筛除的行。

Version 2.1.3-beta.1

ALCOMD3 v2.1.3-beta.1

English

ALCOMD3 2.1.3-beta.1 is a compatibility-focused beta that improves installation
on clean Windows systems and AppImage startup on Fedora Linux.

Fixes

• The Windows installer now explicitly extracts and launches the bundled
  Microsoft Edge WebView2 bootstrapper when the runtime is not already
  installed.
• The Linux AppImage now bundles the required libjpeg and libbz2 shared
  libraries instead of assuming they are provided by the host, fixing
  missing-library startup failures observed on Fedora.

Compatibility and notes

• This is a beta-channel release. The stable channel remains on ALCOMD3 2.1.2.
• The AppImage dependency fix does not change DEB update behavior. AppImage
  supports signed in-app updates; DEB continues to be updated through the
  system package manager.
• Intel Macs are not supported.
• The macOS build is ad-hoc signed but is not notarized by Apple. On first
  launch, macOS may require Open Anyway in System Settings → Privacy &
  Security after confirming the download came from the official ALCOMD3 website
  or GitHub Release. Follow Apple's official instructions
  for the system steps.
• Updater packages remain independently signed and verified; macOS ad-hoc code
  signing does not replace updater signature verification.
• No application data migration is required when upgrading from ALCOMD3 2.1.2
  or 2.1.2-beta.1.

日本語

ALCOMD3 2.1.3-beta.1 は、WebView2 が未導入の Windows 環境での
インストールと、Fedora Linux での AppImage 起動互換性を改善する beta release です。

修正

• Microsoft Edge WebView2 Runtime が未導入の場合、Windows installer が内蔵
  bootstrapper を明示的に展開して起動するよう修正しました。
• Linux AppImage がホスト側の提供を前提とせず、必要な libjpeg と libbz2 の
  shared library を同梱するようにし、Fedora で確認された library 不足による
  起動失敗を修正しました。

互換性と注意事項

• これは beta channel のリリースです。stable channel は ALCOMD3 2.1.2 のままです。
• AppImage の依存関係修正によって DEB の更新方法は変わりません。AppImage は署名済み
  アプリ内アップデートに対応し、DEB は引き続き system package manager で更新します。
• Intel Mac はサポートされません。
• macOS 版は ad-hoc 署名済みですが、Apple の notarization は受けていません。公式
  ALCOMD3 Web サイトまたは GitHub Release からのダウンロードであることを確認した場合のみ、
  初回起動時に「システム設定 → プライバシーとセキュリティ」で「このまま開く」を
  選択してください。操作手順は Apple 公式ガイドを参照してください。
• updater package は別途署名・検証されます。macOS の ad-hoc code signing が updater
  signature verification の代わりになることはありません。
• ALCOMD3 2.1.2 または 2.1.2-beta.1 からのアップグレードにデータ移行は不要です。

中文

ALCOMD3 2.1.3-beta.1 是以兼容性修复为主的测试版，改善未预装 WebView2 的
Windows 环境安装流程，以及 Fedora Linux 上的 AppImage 启动兼容性。

修复

• Microsoft Edge WebView2 Runtime 尚未安装时，Windows 安装器现在会显式解压并启动
  内嵌的 bootstrapper。
• Linux AppImage 现在会包含所需的 libjpeg 和 libbz2 共享库，不再假设系统已提供
  这些依赖，修复 Fedora 上出现的缺少共享库启动失败问题。

兼容性与注意事项

• 这是 beta 通道版本；stable 通道继续保持 ALCOMD3 2.1.2。
• AppImage 依赖修复不会改变 DEB 的更新方式。AppImage 支持已签名的应用内更新；
  DEB 继续通过系统包管理器更新。
• 本版本不支持 Intel Mac。
• macOS 版经过 ad-hoc 签名，但未经 Apple 公证。请仅在确认下载来自 ALCOMD3 官方网站或
  GitHub Release 后，在首次启动时前往“系统设置 → 隐私与安全性”选择“仍要打开”；具体操作请
  参阅 Apple 官方指南。
• updater 软件包仍会独立进行签名和验证；macOS ad-hoc 代码签名不能替代 updater
  签名校验。
• 从 ALCOMD3 2.1.2 或 2.1.2-beta.1 升级无需迁移应用数据。

Version 2.1.2

ALCOMD3 v2.1.2

English

ALCOMD3 2.1.2 brings the stable channel to Windows x64, Apple Silicon macOS,
and Linux x64, with signed updater packages and a dedicated multi-platform
download page.

Multi-platform distribution

• Added stable packages for Windows x64, Apple Silicon macOS, and Linux x64.
• Release filenames include the operating system and architecture so packages
  can be distinguished before downloading.
• Windows is distributed as a ZIP containing the installer, macOS as an ad-hoc
  signed DMG, and Linux as AppImage and DEB packages.
• Windows installation continues to register the application as ALCOMD3
  without appending the version to its display name.

Installation and updates

• Stable-channel in-app updates verify signed packages on Windows, Apple
  Silicon macOS, and Linux AppImage installations.
• Linux DEB installations remain under the system package manager's control and
  do not apply AppImage self-updates.
• Linux package handling now preserves ownership and semantics for files managed
  through dpkg-divert.

Website

• Moved platform downloads to a dedicated localized download page while keeping
  the homepage focused on the product overview.
• Added operating-system recommendations while retaining all published package
  choices, and standardized the platform download button layout.
• Stable 2.1.2 downloads are derived from the signed stable updater manifest;
  the legacy 2.1.1 Release remains a historical page without filename aliases.

Compatibility and notes

• Intel Macs are not supported in this release.
• The macOS build is ad-hoc signed but is not notarized by Apple. On first
  launch, macOS may require Open Anyway in System Settings → Privacy &
  Security after confirming the download came from the official ALCOMD3 website
  or GitHub Release. Follow Apple's official instructions
  for the system steps.
• Updater packages remain independently signed and verified; macOS ad-hoc code
  signing does not replace updater signature verification.
• No application data migration is required when upgrading from ALCOMD3 2.1.1
  or 2.1.2-beta.1.

日本語

ALCOMD3 2.1.2 では、stable channel が Windows x64、Apple Silicon macOS、
Linux x64 に対応し、署名済み updater package とマルチプラットフォーム専用の
ダウンロードページを利用できるようになりました。

マルチプラットフォーム配布

• Windows x64、Apple Silicon macOS、Linux x64 向けの stable package を追加しました。
• ダウンロード前に区別できるよう、Release のファイル名に OS とアーキテクチャを
  含めました。
• Windows 版は installer を含む ZIP、macOS 版は ad-hoc 署名済み DMG、Linux 版は
  AppImage と DEB package として配布します。
• Windows の登録済みアプリ名は、バージョンを付けず ALCOMD3 のまま表示されます。

インストールとアップデート

• stable channel のアプリ内アップデートは、Windows、Apple Silicon macOS、Linux
  AppImage の署名済み package を検証します。
• Linux DEB 版は引き続き system package manager が管理し、AppImage の self-update
  は適用しません。
• Linux の package 処理で、dpkg-divert が管理するファイルの所有権と動作を維持する
  ようにしました。

Web サイト

• 各言語の専用ダウンロードページに platform package を移動し、トップページは製品概要に
  集中する構成に戻しました。
• 公開済み package をすべて表示したまま OS に応じた推奨を行い、platform download
  button のレイアウトを統一しました。
• stable 2.1.2 のリンクは署名済み stable updater manifest から生成されます。旧 2.1.1
  Release はファイル名 alias を追加せず、履歴ページとして維持されます。

互換性と注意事項

• Intel Mac はこのリリースではサポートされません。
• macOS 版は ad-hoc 署名済みですが、Apple の notarization は受けていません。公式
  ALCOMD3 Web サイトまたは GitHub Release からのダウンロードであることを確認した場合のみ、
  初回起動時に「システム設定 → プライバシーとセキュリティ」で「このまま開く」を選択してください。
  操作手順は Apple 公式ガイドを参照してください。
• updater package は別途署名・検証されます。macOS の ad-hoc code signing が updater
  signature verification の代わりになることはありません。
• ALCOMD3 2.1.1 または 2.1.2-beta.1 からのアップグレードにデータ移行は不要です。

中文

ALCOMD3 2.1.2 将稳定通道扩展到 Windows x64、Apple Silicon macOS 和 Linux x64，
提供已签名的更新包与独立的多平台下载页面。

多平台分发

• 新增 Windows x64、Apple Silicon macOS 和 Linux x64 稳定版软件包。
• Release 文件名包含操作系统与架构，下载前即可区分不同平台的软件包。
• Windows 版以包含安装器的 ZIP 分发，macOS 版使用 ad-hoc 签名的 DMG，Linux 版提供
  AppImage 和 DEB 软件包。
• Windows 注册应用名称继续仅显示为 ALCOMD3，不会附加版本号。

安装与更新

• 稳定通道的应用内更新会验证 Windows、Apple Silicon macOS 和 Linux AppImage 的
  已签名更新包。
• Linux DEB 版继续由系统包管理器负责更新，不会应用 AppImage 自更新。
• Linux 软件包处理会保留由 dpkg-divert 管理的文件所有权与转移语义。

网站

• 将平台下载移至独立的多语言下载页面，主页恢复为以产品介绍为主的布局。
• 在保留全部已发布软件包选项的同时根据操作系统给出推荐，并统一各平台下载按钮样式。
• 稳定版 2.1.2 下载链接由已签名的 stable updater manifest 生成；旧 2.1.1 Release
  继续作为历史页面保留，不增加文件名兼容别名。

兼容性与注意事项

• 本版本不支持 Intel Mac。
• macOS 版经过 ad-hoc 签名，但未经 Apple 公证。请仅在确认下载来自 ALCOMD3 官方网站或
  GitHub Release 后，在首次启动时前往“系统设置 → 隐私与安全性”选择“仍要打开”；具体操作请
  参阅 Apple 官方指南。
• updater 软件包仍会独立进行签名和验证；macOS ad-hoc 代码签名不能替代 updater
  签名校验。
• 从 ALCOMD3 2.1.1 或 2.1.2-beta.1 升级无需迁移应用数据。

Version 2.1.2-beta.1

ALCOMD3 v2.1.2-beta.1

English

Changes

Multi-platform distribution

• ALCOMD3 is now available for Windows x64, Apple Silicon macOS, and Linux x64.
• Release filenames now include the operating system and architecture so packages
  can be distinguished before downloading.
• The website can recommend the appropriate package for the visitor's operating
  system while keeping every available package visible.
• Windows installation continues to display the application as ALCOMD3 without
  including the version in the registered application name.

Installation and updates

• Windows is distributed as a ZIP containing the signed installer.
• Apple Silicon macOS is distributed as an ad-hoc signed DMG. It is not
  notarized by Apple.
• Linux x64 is available as an AppImage or DEB package.
• Beta-channel in-app updates verify signed updater packages on Windows, Apple
  Silicon macOS, and Linux AppImage installations. DEB installations remain under
  the system package manager's control.

Notes

• This is a beta-channel release. The stable channel remains on ALCOMD3 2.1.1
  until the next stable version is published.
• Intel Macs are not supported by this beta.
• On first launch, macOS may block the application. Continue with Open
  Anyway in System Settings → Privacy & Security only after confirming the
  download came from the official ALCOMD3 website or GitHub Release.
• ALCOMD3 updater packages remain separately signed and verified; ad-hoc macOS
  code signing does not disable updater signature verification.
• No application data migration is required when upgrading from ALCOMD3 2.1.1.

日本語

変更点

マルチプラットフォーム配布

• ALCOMD3 を Windows x64、Apple Silicon macOS、Linux x64 で利用できるように
  なりました。
• ダウンロード前にパッケージを区別できるよう、Release のファイル名に OS と
  アーキテクチャを含めるようにしました。
• Web サイトは、すべてのパッケージを表示したまま、閲覧環境に適したパッケージを
  推奨できるようになりました。
• Windows の登録済みアプリ名は、バージョンを含めず引き続き ALCOMD3 と表示されます。

インストールとアップデート

• Windows 版は、署名済みインストーラーを含む ZIP として配布されます。
• Apple Silicon macOS 版は ad-hoc 署名済み DMG として配布され、Apple の
  notarization は受けていません。
• Linux x64 版は AppImage と DEB パッケージを選択できます。
• beta channel のアプリ内アップデートは、Windows、Apple Silicon macOS、Linux
  AppImage の署名済み updater package を検証します。DEB 版の更新は引き続き
  system package manager が管理します。

注意事項

• これは beta channel のリリースです。次の stable version が公開されるまで、stable
  channel は ALCOMD3 2.1.1 のままです。
• この beta は Intel Mac をサポートしていません。
• 初回起動時は macOS にブロックされる場合があります。ALCOMD3 公式 Web サイトまたは
  GitHub Release からのダウンロードであることを確認した場合のみ、「システム設定 →
  プライバシーとセキュリティ」で「このまま開く」を選択してください。
• ALCOMD3 updater package は別途署名・検証されます。macOS の ad-hoc code signing に
  よって updater signature verification が無効になることはありません。
• ALCOMD3 2.1.1 からのアップグレードにデータ移行は不要です。

中文

变化

多平台分发

• ALCOMD3 现在可用于 Windows x64、Apple Silicon macOS 和 Linux x64。
• Release 文件名现在包含操作系统和架构，下载前即可区分不同平台的软件包。
• 网站可以根据访问者的操作系统推荐合适的软件包，同时仍然显示全部可用软件包。
• Windows 注册应用名称继续仅显示为 ALCOMD3，不会附加版本号。

安装与更新

• Windows 版以包含已签名安装器的 ZIP 形式分发。
• Apple Silicon macOS 版以 ad-hoc 签名的 DMG 形式分发，未经 Apple 公证。
• Linux x64 版提供 AppImage 和 DEB 两种软件包。
• beta 通道的应用内更新会在 Windows、Apple Silicon macOS 和 Linux AppImage
  安装中验证已签名的 updater 软件包；DEB 安装仍由系统包管理器负责更新。

注意事项

• 这是 beta 通道版本；在下一个稳定版发布前，stable 通道继续保持 ALCOMD3 2.1.1。
• 此 beta 暂不支持 Intel Mac。
• 首次启动时，macOS 可能阻止应用运行。请仅在确认下载来自 ALCOMD3 官方网站或
  GitHub Release 后，前往“系统设置 → 隐私与安全性”选择“仍要打开”。
• ALCOMD3 updater 软件包仍会单独进行签名和验证；macOS ad-hoc 代码签名不会关闭
  updater 签名校验。
• 从 ALCOMD3 2.1.1 升级无需迁移应用数据。

Version 2.1.1

ALCOMD3 v2.1.1

English

ALCOMD3 2.1.1 is a maintenance release that updates desktop and local MCP
compatibility, refines the default interface, and improves the website's MCP
documentation and download experience.

Application updates

• Updated the Windows desktop runtime and supporting components for compatibility
  with current Tauri and MCP SDK releases.
• Updated local MCP task handling while retaining task listing, status and result
  queries, cancellation, progress reporting, and lifecycle behavior.
• Increased the default desktop window width from 1300 to 1400 pixels.
• Replaced the generic network icon in the sidebar with the MCP mark so the MCP
  entry is easier to identify.

Website updates

• Added complete MCP guide pages in Simplified Chinese, Traditional Chinese,
  Japanese, and English. The guides cover setup, client configuration, available
  tools, lifecycle behavior, permission boundaries, and troubleshooting.
• Improved website navigation and language switching for documentation pages, and
  clarified the homepage description of ALCOMD3, VPM management, and optional
  local MCP capabilities.
• Improved search and social-sharing metadata so localized ALCOMD3 pages and MCP
  documentation are easier to discover.

Installation and upgrade

• The website download button now provides the Release ZIP corresponding to the
  signed Windows installer. In-app updates continue to download and verify the
  signed installer directly.
• Upgrading from ALCOMD3 2.1.0 requires no data migration. Existing application
  data paths and updater identity remain unchanged.

Compatibility and security

• MCP remains disabled by default and continues to communicate only through the
  local stdio bridge and local IPC; this release does not add a network listener.
• Release assets and updater metadata are verified against the tagged source,
  exact version and filenames, cryptographic signatures, and immutable Release
  attestations before updater metadata is distributed.

日本語

ALCOMD3 2.1.1 は、デスクトップアプリとローカル MCP の互換性を更新し、既定の画面構成を
調整するとともに、Web サイトの MCP ドキュメントとダウンロード体験を改善する
メンテナンスリリースです。

アプリの更新

• Windows デスクトップランタイムと関連コンポーネントを更新し、現行の Tauri および
  MCP SDK との互換性を確保しました。
• ローカル MCP のタスク処理を更新し、タスク一覧、状態と結果の取得、キャンセル、進捗通知、
  ライフサイクルの動作を維持しました。
• デスクトップウィンドウの既定幅を 1300 ピクセルから 1400 ピクセルに広げました。
• サイドバーの汎用ネットワークアイコンを MCP マークに変更し、MCP 項目を見つけやすく
  しました。

Web サイトの更新

• 簡体字中国語、繁体字中国語、日本語、英語の完全な MCP ガイドページを追加しました。
  有効化手順、クライアント設定、利用可能なツール、ライフサイクル、権限範囲、
  トラブルシューティングを確認できます。
• ドキュメントページのナビゲーションと言語切り替えを改善し、トップページにおける
  ALCOMD3、VPM 管理、任意のローカル MCP 機能の説明を明確にしました。
• 検索およびソーシャル共有用のメタデータを改善し、各言語の ALCOMD3 ページと MCP
  ドキュメントを見つけやすくしました。

インストールとアップグレード

• Web サイトのダウンロードボタンは、署名済み Windows インストーラーに対応する
  Release ZIP を提供するようになりました。アプリ内更新は引き続き署名済み
  インストーラーを直接ダウンロードして検証します。
• ALCOMD3 2.1.0 からのアップグレードにデータ移行は不要です。既存のアプリデータパスと
  updater identity は変更されません。

互換性とセキュリティ

• MCP は引き続き既定で無効で、ローカル stdio bridge とローカル IPC のみを使用します。
  このリリースでネットワークリスナーが追加されることはありません。
• updater metadata の配布前に、Release assets と updater metadata がタグ付きソース、
  正確なバージョンとファイル名、暗号署名、Immutable Release attestation と一致することを
  検証します。

中文

ALCOMD3 2.1.1 是一个维护版本，更新桌面端与本地 MCP 的兼容性，调整默认界面，并改进
网站的 MCP 文档和下载体验。

应用更新

• 更新 Windows 桌面运行时和相关组件，以兼容当前的 Tauri 与 MCP SDK 版本。
• 更新本地 MCP 任务处理，同时保留任务列表、状态与结果查询、取消、进度报告和生命周期行为。
• 桌面窗口默认宽度由 1300 像素调整为 1400 像素。
• 将侧栏中的通用网络图标替换为 MCP 标志，使 MCP 入口更容易识别。

网站更新

• 新增简体中文、繁体中文、日语和英语的完整 MCP 指南页面，涵盖启用方式、客户端配置、
  可用工具、生命周期行为、权限边界和故障排除。
• 改进文档页面的导航与语言切换，并更清楚地介绍 ALCOMD3、VPM 管理和可选的本地 MCP 能力。
• 改进搜索和社交分享元数据，使各语言的 ALCOMD3 页面与 MCP 文档更容易被找到。

安装与升级

• 网站下载按钮现在提供与已签名 Windows 安装器对应的 Release ZIP；应用内更新仍会直接
  下载并验证已签名安装器。
• 从 ALCOMD3 2.1.0 升级无需迁移数据，现有应用数据路径和 updater 标识保持不变。

兼容性与安全

• MCP 仍默认关闭，并继续仅通过本地 stdio bridge 和本机 IPC 通信；本版本不会新增网络监听。
• 在分发 updater metadata 前，会核验 Release 资产和 updater metadata 是否与 tag 源码、
  精确版本及文件名、加密签名和 Immutable Release attestation 一致。

Version 2.1.0

ALCOMD3 v2.1.0

English

ALCOMD3 2.1.0 is the first stable release of the independent ALCOMD3 product
line. It is a desktop tool for managing VRChat projects and VPM packages, with
project workflows, repositories, templates, backups, logs, updates, and
optional local MCP integration.

Projects and packages

• Create VRChat projects, register existing projects, and organize them in list
  or grid views with their added dates.
• Copy projects and create or restore backups with visible progress and
  cancellation controls.
• Manage VPM repositories and packages with compatibility checks based on the
  Unity major and minor versions declared by each package.
• Project and repository readers isolate malformed entries so the rest of the
  collection stays available.
• Built-in Unity 2022 Worlds templates include the UDON scripting define, and
  custom templates can be duplicated and managed from the template interface.

Data and import

• ALCOMD3 uses its own data root, with config/, state/, templates/,
  activity-logs/, and technical-logs/ directories for distinct types of
  application data.
• Top-level settings.json and vcc.liteDb files provide VPM/VCC-compatible
  environment and project data.
• First setup and Settings offer optional manual import from VCC, ALCOM, and
  ALCOMD3 2.1.0 beta data layouts.
• Settings provides shortcuts to the active configuration, log, and template
  locations.

Logs and diagnostics

• Activity records provide a user-readable history, with persistent display
  preferences and efficient rendering for longer histories.
• Multi-line technical log entries are collapsed by default for easier
  inspection.
• Log queries and returned log text redact token, password, and related
  sensitive fields.

Local MCP integration

• MCP access is disabled by default and is limited to a local stdio bridge and
  local IPC.
• MCP tools cover project and repository registration; project, repository,
  package, activity-record, and technical-log queries; and selected project
  backup, copy, restore, and package operations.
• Project creation supports cancellation and rollback to avoid leaving partial
  state after an unsuccessful operation.
• The MCP page groups tools by purpose and shows active tool activity.

Desktop experience, updates, and languages

• The Material Design 3-style interface supports theme customization.
• Stable and beta update channels are available separately.
• The update dialog supports localized summaries, a 7-day remind-later action,
  and a GitHub Release link for the complete release notes.
• The interface uses the configured ALCOMD3 product name and includes the full
  supported locale key set.

Compatibility and licensing

• Templates, repositories, project configuration, and the vcc:// workflow
  are compatible with the VPM/VCC ecosystem.
• ALCOMD3 2.1.0 is licensed under AGPL-3.0-or-later.
• Built-in templates are licensed under the MIT License. Third-party resources,
  dependencies, and template assets retain their respective licenses.

Getting started

• First setup guides the choice of project and backup locations and offers
  optional data import.
• Settings can be used at any time to review paths, templates, repositories,
  update channels, and local MCP access.

日本語

ALCOMD3 2.1.0 は、独立した ALCOMD3 製品ラインの最初の安定版です。VRChat
プロジェクトと VPM パッケージを管理するデスクトップツールとして、プロジェクト操作、
リポジトリ、テンプレート、バックアップ、ログ、更新、任意で利用できるローカル MCP
連携を備えています。

プロジェクトとパッケージ

• VRChat プロジェクトの作成、既存プロジェクトの登録に対応し、追加日時付きのリスト表示
  またはグリッド表示で整理できます。
• プロジェクトのコピー、バックアップの作成と復元に対応し、進行状況の表示とキャンセル操作を
  利用できます。
• 各パッケージが宣言する Unity のメジャーおよびマイナーバージョンを基に互換性を確認し、
  VPM リポジトリとパッケージを管理できます。
• プロジェクトやリポジトリに不正な項目が含まれていても、その項目を分離し、残りの一覧を
  利用できます。
• Unity 2022 Worlds の組み込みテンプレートには UDON スクリプト定義が含まれ、
  カスタムテンプレートはテンプレート画面から複製および管理できます。

データとインポート

• ALCOMD3 は専用のデータルートを使用し、アプリケーションデータの種類ごとに
  config/、state/、templates/、activity-logs/、technical-logs/
  ディレクトリへ保存します。
• トップレベルの settings.json と vcc.liteDb は、VPM/VCC 互換の環境データと
  プロジェクトデータを提供します。
• 初回セットアップと設定画面から、VCC、ALCOM、ALCOMD3 2.1.0 ベータ版のデータ配置を
  任意で手動インポートできます。
• 設定画面には、使用中の設定、ログ、テンプレートの保存場所を開くショートカットがあります。

ログと診断

• アクティビティ記録ではユーザーが読める操作履歴を確認でき、表示設定は保存され、長い履歴も
  効率よく表示されます。
• 複数行の技術ログは既定で折りたたまれ、確認しやすくなっています。
• ログの検索結果と取得したログ本文では、トークン、パスワードなどの機密フィールドが
  マスキングされます。

ローカル MCP 連携

• MCP アクセスは既定で無効で、ローカルの stdio ブリッジとローカル IPC のみに限定されます。
• MCP ツールは、プロジェクトとリポジトリの登録、プロジェクト、リポジトリ、パッケージ、
  アクティビティ記録、技術ログの照会、および一部のプロジェクトのバックアップ、コピー、
  復元、パッケージ操作に対応します。
• プロジェクト作成はキャンセルとロールバックに対応し、処理に失敗した場合に不完全な状態が
  残ることを防ぎます。
• MCP 画面ではツールを用途別に分類し、実行中のツールを表示します。

デスクトップ体験、更新、言語

• Material Design 3 スタイルの画面でテーマをカスタマイズできます。
• 安定版とベータ版の更新チャンネルを個別に選択できます。
• 更新ダイアログは、言語別の概要、7 日後に再通知する操作、完全なリリースノートを開く
  GitHub Release リンクに対応します。
• 画面全体で設定された ALCOMD3 製品名を使用し、対応する全ロケールのキーを収録しています。

互換性とライセンス

• テンプレート、リポジトリ、プロジェクト設定、vcc:// ワークフローは VPM/VCC
  エコシステムと互換性があります。
• ALCOMD3 2.1.0 は AGPL-3.0-or-later で提供されます。
• 組み込みテンプレートは MIT License で提供されます。サードパーティーのリソース、依存関係、
  テンプレート素材には、それぞれのライセンスが適用されます。

はじめに

• 初回セットアップでは、プロジェクトとバックアップの保存場所を選択し、必要に応じてデータを
  インポートできます。
• 設定画面では、パス、テンプレート、リポジトリ、更新チャンネル、ローカル MCP アクセスを
  いつでも確認できます。

中文

ALCOMD3 2.1.0 是 ALCOMD3 独立产品线的首个稳定版本。它是一款面向 VRChat 项目与 VPM
软件包管理的桌面工具，提供项目工作流、仓库、模板、备份、日志、更新以及可选的本地 MCP
集成。

项目与软件包

• 支持创建 VRChat 项目、登记已有项目，并通过列表或网格视图按添加时间整理项目。
• 支持复制项目以及创建或恢复备份，并提供进度显示和取消操作。
• 支持管理 VPM 仓库与软件包，并根据软件包声明的 Unity 主版本和次版本检查兼容性。
• 项目或仓库中存在异常条目时，会将其单独隔离，其他内容仍可正常使用。
• Unity 2022 Worlds 内置模板包含 UDON 脚本定义；自定义模板可在模板界面中复制和管理。

数据与导入

• ALCOMD3 使用独立的数据根目录，并通过 config/、state/、templates/、
  activity-logs/ 和 technical-logs/ 分别存放不同类型的应用数据。
• 顶层 settings.json 和 vcc.liteDb 提供与 VPM/VCC 兼容的环境和项目数据。
• 首次设置和设置页面可按需手动导入 VCC、ALCOM 以及 ALCOMD3 2.1.0 beta 布局的数据。
• 设置页面提供当前配置、日志和模板位置的快捷入口。

日志与诊断

• 活动记录提供用户可读的操作历史，支持持久化显示偏好，并可高效展示较长的历史记录。
• 多行技术日志默认折叠，便于检查和浏览。
• 日志查询结果与返回的日志文本会对 token、password 等敏感字段进行脱敏。

本地 MCP 集成

• MCP 默认关闭，仅通过本地 stdio bridge 和本机 IPC 工作。
• MCP 工具支持登记项目与仓库，查询项目、仓库、软件包、活动记录和技术日志，以及执行部分
  项目备份、复制、恢复与软件包操作。
• 项目创建支持取消和回滚，避免失败操作留下不完整状态。
• MCP 页面按用途对工具分组，并显示正在活动的工具。

桌面体验、更新与语言

• Material Design 3 风格的界面支持主题自定义。
• stable 与 beta 更新渠道可分别选择。
• 更新弹窗支持多语言摘要、“7 天后再提醒”，并提供 GitHub Release 链接以查看完整发布说明。
• 界面统一使用配置中的 ALCOMD3 产品名，并覆盖全部受支持语言的 locale key。

兼容性与许可证

• 模板、仓库、项目配置以及 vcc:// 工作流与 VPM/VCC 生态兼容。
• ALCOMD3 2.1.0 使用 AGPL-3.0-or-later 许可证。
• 内置模板使用 MIT License；第三方资源、依赖和模板素材分别遵循各自的许可证。

开始使用

• 首次设置会引导选择项目和备份位置，并可按需导入数据。
• 设置页面可随时检查路径、模板、仓库、更新渠道和本地 MCP 访问状态。

Version 2.1.0-beta.5

ALCOMD3 v2.1.0-beta.5

English

Changes

Compatibility and migration

• ALCOMD3 now keeps new runtime files under its current config/, state/,
  templates/, activity-logs/, and technical-logs/ paths instead of writing
  new runtime data under vrc-get/.
• Installing ALCOMD3 or updating from 2.0.0 or earlier to 2.1.0 or later starts
  with a fresh ALCOMD3 data root; legacy VCC or ALCOM data can still be imported
  manually from first setup or Settings.
• External app import can also recover ALCOMD3 2.1.0 beta runtime settings from
  the old beta layout.
• Settings and log-page file/folder shortcuts now open the current ALCOMD3
  config, template, and technical-log paths instead of the old vrc-get/ paths.

UI and logs

• Activity log preferences are now persisted.
• Activity log rendering is optimized for larger result sets.
• Every supported UI language now covers the complete ALCOMD3 locale key set.
• Update dialogs now keep the GitHub Release link, use the ALCOMD3 product name,
  and respect the 7-day remind-later action on startup.

MCP

• MCP now includes write tools to create new projects, add existing project
  folders, and add VPM repositories.
• MCP project creation keeps cancellation active through package resolution and
  apply, and rolls back unregistered project folders if that stage fails.

日本語

変更点

互換性と移行

• ALCOMD3 の新しい runtime file は vrc-get/ 配下ではなく、現在の
  config/、state/、templates/、activity-logs/、technical-logs/
  path に保存されるようになりました。
• ALCOMD3 の install、または 2.0.0 以前から 2.1.0 以降への update は、fresh
  ALCOMD3 data root から開始します。legacy VCC / ALCOM data は first setup または
  Settings から手動 import できます。
• External app import は、旧 beta layout にある ALCOMD3 2.1.0 beta runtime
  settings も復元できるようになりました。
• Settings と log page の file/folder shortcut は、旧 vrc-get/ path ではなく
  現在の ALCOMD3 config / template / technical log path を開くようになりました。

UI とログ

• Activity log preferences が保存されるようになりました。
• 大きな result set に対する activity log rendering を最適化しました。
• すべての対応 UI language が ALCOMD3 の完全な locale key set を cover するようになりました。
• Update dialog は GitHub Release link を維持し、ALCOMD3 product name を使用し、
  startup 時の 7 日後に再通知する操作を反映するようになりました。

MCP

• MCP に new project 作成、existing project folder 追加、VPM repository 追加の
  write tool を追加しました。
• MCP project 作成では package resolve / apply 中も cancel が有効になり、その段階で
  失敗した場合は未登録の project folder を rollback するようになりました。

中文

变化

兼容性和迁移

• ALCOMD3 新的运行时文件现在写入当前的 config/、state/、templates/、
  activity-logs/ 和 technical-logs/ 路径，不再在 vrc-get/ 下新增运行时数据。
• 安装 ALCOMD3，或从 2.0.0 及以前更新到 2.1.0 及以后时，会从全新的 ALCOMD3
  数据根开始；legacy VCC 或 ALCOM 数据仍可从首次设置或设置页手动导入。
• 外部应用导入也可以从旧 beta 布局恢复 ALCOMD3 2.1.0 beta 运行时设置。
• 设置页和日志页的文件/目录快捷入口现在会打开当前 ALCOMD3 配置、模板和技术日志路径，
  不再指向旧 vrc-get/ 路径。

UI 和日志

• 活动日志偏好设置现在会持久保存。
• 优化了较大结果集下的活动日志渲染。
• 所有当前支持的 UI 语言现在都会覆盖完整的 ALCOMD3 locale key 集合。
• 更新对话框现在会保留 GitHub Release 链接，使用 ALCOMD3 产品名，并在启动时尊重“7 天后再提醒”。

MCP

• MCP 现在包含新建项目、添加已有项目文件夹和添加 VPM 存储库的写入工具。
• MCP 新建项目现在会在软件包解析/应用阶段继续响应取消；该阶段失败时会回滚尚未登记的项目目录。

Version 2.1.0-beta.4

ALCOMD3 v2.1.0-beta.4

English

Changes

Compatibility and reliability

• Repository and package views now skip malformed user repository entries that
  have neither an id nor a URL instead of panicking.
• VRCSDK and VPM Resolver package compatibility now requires matching Unity
  major/minor versions when the package manifest declares a Unity version,
  preventing Unity 6000 projects from selecting Unity 2022 SDK packages.
• Built-in Unity 2022 Worlds templates now include the UDON scripting define
  again.
• Linux AppImage bundling on Debian-like builders now includes the required
  WebKitGTK/enchant runtime libraries.
• Hardened shared VPM package-name validation so GUI and MCP project package
  installs reject manifest/package names with path components before package
  files are cached, extracted, or moved.

UI

• Custom templates can now be duplicated from the template menu.
• Multi-line technical log entries now collapse by default, keeping long log
  rows easier to scan.
• Project lists and grids can now show and sort by the date a project was added.
• The project management package table now uses backend-built package rows, so
  GUI and MCP share prerelease, yanked, hidden-source, same-name merge, source
  priority, and Unity compatibility behavior.

MCP and project packages

• Added MCP write tools for installing, uninstalling, and reinstalling one
  package in a registered project: alcomd3_install_project_package,
  alcomd3_uninstall_project_package, and
  alcomd3_reinstall_project_package.
• Project package writes reuse the same pending-change, apply, cancellation,
  and activity-record path as the GUI. Conflicts and legacy file/folder removals
  are blocked unless the request opts in with allow_conflicts.
• The MCP page now lists and highlights the activity and technical log query
  tools.
• Log redaction now also covers spaced sensitive assignments such as
  token = ... and common password keys before logs are returned through MCP.

Downloads and release infrastructure

• Kept the website download button as a direct installer link from the
  site-published updater manifest and removed misleading non-cryptographic
  signature-match wording from the download flow.
• VCC-style repository downloads now require confirmation before fetching
  repository lists from custom protocol links, and the deep-link confirmation
  flow handles retry and cancellation more reliably.
• ALCOMD3 product, updater, release, and artifact naming is now centralized in
  shared configuration used by the GUI, website, and release tooling.

日本語

変更点

互換性と信頼性

• id と URL のどちらも持たない壊れた user repository entry があっても、
  repository / package view が panic せずにその entry を skip するようになりました。
• package manifest が Unity version を宣言している場合、VRCSDK と VPM Resolver
  package は Unity の major/minor version が一致する場合のみ compatible と扱います。
  これにより Unity 6000 project が Unity 2022 SDK package を選択する問題を防ぎます。
• Built-in Unity 2022 Worlds template に UDON scripting define を再追加しました。
• Debian 系 builder で Linux AppImage を作成する際、必要な WebKitGTK / enchant
  runtime library を同梱するようになりました。
• 共有 VPM package name 検証を強化し、GUI と MCP の project package install が
  path component を含む manifest/package name を、package file の cache、extract、move
  の前に拒否するようにしました。

UI

• custom template を template menu から複製できるようになりました。
• 複数行の technical log entry は既定で折りたたまれ、長い log row を確認しやすくなりました。
• project list / grid で、project が追加された日付の表示と並び替えができるようになりました。
• Project management page の package table は backend-built package row を使用するように
  なり、GUI と MCP で prerelease、yanked、hidden source、same-name merge、source
  priority、Unity compatibility behavior が共通になります。

MCP とプロジェクトパッケージ

• 登録済み project に 1 つの package を install / uninstall / reinstall する MCP write
  tool を追加しました: alcomd3_install_project_package、
  alcomd3_uninstall_project_package、alcomd3_reinstall_project_package。
• Project package write は GUI と同じ pending changes、apply、cancellation、
  activity record path を使用します。conflict や legacy file/folder removal がある場合は、
  request が allow_conflicts を指定しない限り apply しません。
• MCP page で activity log / technical log query tool を一覧表示し、呼び出し時に
  highlight できるようになりました。
• MCP 経由で log を返す前の redaction で、token = ... のような空白を含む
  sensitive assignment と一般的な password key も処理するようになりました。

ダウンロードとリリース基盤

• ウェブサイトの download button はサイトで公開している updater manifest から得た
  installer への direct link のままにし、download flow から暗号学的検証ではない
  signature match 表示を削除しました。
• VCC-style repository download は custom protocol link から repository list を取得する前に
  confirmation を要求するようになり、deep-link confirmation flow の retry / cancellation
  もより確実になりました。
• ALCOMD3 の product、updater、release、artifact naming は GUI、website、release tooling
  が共有する設定に集約されました。

中文

变化

兼容性和可靠性

• 仓库和软件包页面现在会跳过同时缺少 id 和 URL 的异常用户仓库条目，而不是 panic。
• 当软件包清单声明 Unity 版本时，VRCSDK 和 VPM Resolver 软件包现在必须匹配 Unity
  主版本和次版本才会被视为兼容，避免 Unity 6000 项目选择 Unity 2022 SDK 软件包。
• 内置 Unity 2022 Worlds 模板已重新包含 UDON scripting define。
• 在 Debian 类构建环境创建 Linux AppImage 时，现在会随包包含所需的 WebKitGTK /
  enchant 运行时库。
• 强化共享 VPM 软件包名称校验，GUI 和 MCP 项目软件包安装会在缓存、解压或移动
  软件包文件前拒绝包含路径组件的 manifest/package name。

UI

• 现在可以从模板菜单复制自定义模板。
• 多行技术日志条目现在默认折叠，长日志行更容易浏览。
• 项目列表和网格现在可以显示并按项目添加日期排序。
• 项目管理页的软件包表改为使用后端构建的软件包行，GUI 和 MCP 共享预发布、yanked、
  隐藏来源、同名包合并、来源优先级和 Unity 兼容行为。

MCP 和项目软件包

• 新增 MCP 写工具，可为已登记项目安装、卸载、重装单个软件包：
  alcomd3_install_project_package、alcomd3_uninstall_project_package 和
  alcomd3_reinstall_project_package。
• 项目软件包写入复用 GUI 的 pending changes、apply、取消和活动记录路径。存在冲突或
  legacy 文件/文件夹删除时，默认阻断；请求显式传入 allow_conflicts 后才会继续应用。
• MCP 页面现在会列出并高亮活动记录和技术日志查询工具。
• 通过 MCP 返回日志前的脱敏现在也会覆盖 token = ... 这类带空格的敏感赋值，
  以及常见密码键。

下载和发布基础设施

• 保持网站下载按钮为来自网站发布的 updater manifest 的安装包直接链接，并移除下载流程中
  容易误导为密码学验证的 signature match 文案。
• VCC 风格仓库下载现在会在通过 custom protocol link 获取仓库列表前要求确认，
  deep-link 确认流程的重试和取消处理也更可靠。
• ALCOMD3 的产品、updater、release 和 artifact 命名已集中到 GUI、website 和发布工具
  共用的配置中。

Version 2.1.0-beta.3

ALCOMD3 v2.1.0-beta.3

English

ALCOMD3 v2.1.0-beta.3 is a beta release focused on update experience, local
activity visibility, MCP log query tools, and safer log handling.

Changes since v2.1.0-beta.2

Update Experience

• Update dialogs now support localized updater notes from the updater metadata,
  so the in-app update prompt can show a short summary in the user's language.
• The update dialog reminder flow was refined, including clearer remind-later
  behavior, website/update actions, and fallback text when update notes are
  missing.
• Update installation progress is now visible from the sidebar while an update
  is running.
• Release tooling now supports explicit localized updater-note sidecars and
  rejects malformed or empty updater-note values before release metadata is
  generated.

Projects and Legacy Import

• The empty Projects page now offers a direct import path for existing
  VCC/ALCOM data.
• Legacy import UI logic was shared between entry points so setup, settings, and
  the empty Projects page stay consistent.
• Legacy project/template import paths now create clearer activity records for
  success, failure, duplicate, skipped, and partial-import outcomes.

Activity Records

• Added a user-readable Activity Records view under the Logs page. It is now the
  default log view, with technical logs kept as a troubleshooting tab.
• Activity records cover meaningful GUI, MCP, Deep Link, and System operations,
  including project/package/repository/template/settings changes, update checks,
  Unity Hub refreshes, deep-link actions, MCP calls, failures, cancellations, and
  important passive refreshes.
• Activity entries include structured source, kind, status, operation, target,
  duration, details, and error information. Secondary records can be hidden by
  default while staying filterable.
• Activity log files are stored locally under the existing ALCOMD3 data tree with
  bounded retention.

MCP and Log Query Tools

• MCP now includes selective read-only tools for activity logs:
  alcomd3_search_activity_logs, alcomd3_get_activity_log_entry,
  alcomd3_summarize_activity_logs, and alcomd3_get_activity_log_context.
• MCP now includes selective read-only tools for technical logs:
  alcomd3_search_technical_logs, alcomd3_get_technical_log_entry, and
  alcomd3_summarize_technical_logs.
• MCP tool calls are recorded in the local activity log with request id, tool
  name, client summary when available, status, and sanitized details.
• The MCP page now lists and highlights the activity and technical log query
  tools when they are called.
• Log search and summary responses are paginated and bounded. Recent-file
  technical log reads are limited to recent log tails instead of reading entire
  large files into memory.
• Technical log parsing preserves multiline formatting and useful local paths
  while still truncating and redacting returned messages.

Privacy, Reliability, and Audit Fixes

• Log redaction now covers token-like values, authorization material, API keys,
  common password keys, URL userinfo, URL query strings, URL fragments, JSON-style
  assignments, colon assignments, and spaced assignments such as token = ....
• Activity details continue to keep full local filesystem paths when those paths
  are useful for diagnosing Unity, VPM, and non-ASCII path problems, but raw MCP
  params, HTTP headers, URL queries, and URL credentials are not stored.
• Technical log recent-file reads now skip truncated UTF-8 prefixes by bytes, so
  large logs with non-ASCII text remain queryable.
• Summary tools now apply offset/limit to grouped results.
• Operations that previously could be reported as successful despite failing or
  importing nothing now record clearer failed, cancelled, or partial-completion
  activity states. This includes template import, Unity launch, update checks,
  package operations, and several project workflows.

Documentation and Release Maintenance

• MCP and maintenance documentation now describe the activity-record model, log
  query boundaries, retention, redaction expectations, and MCP activity auditing.
• Published release notes were restored and protected as historical records, and
  future changes are expected to go into new release notes instead of rewriting
  already-published notes.
• Release documentation now covers localized updater notes and the sidecar file
  used to generate updater metadata.

Installation Notes

No manual data migration is required for users already running v2.1.0-beta.2.
MCP remains disabled by default and must be enabled from the MCP page before a
local MCP client can query ALCOMD3 data. Activity records and technical logs stay
local to the existing ALCOMD3 data directory.

日本語

ALCOMD3 v2.1.0-beta.3 は、update experience、local activity visibility、MCP
log query tool、安全な log handling を中心にした beta release です。

v2.1.0-beta.2 からの変更点

Update Experience

• Updater metadata の localized updater notes に対応し、アプリ内 update prompt が
  ユーザーの言語で短い更新概要を表示できるようになりました。
• Update dialog の remind-later flow、website/update action、update notes がない場合
  の fallback text を調整しました。
• Update install 中は sidebar から進行状況を確認できるようになりました。
• Release tooling は明示的な localized updater-note sidecar に対応し、metadata 生成前に
  不正または空の updater-note value を拒否するようになりました。

Projects and Legacy Import

• 空の Projects page から既存の VCC/ALCOM data を直接 import できるようになりました。
• Legacy import UI logic を entry point 間で共有し、setup、settings、空の Projects
  page の挙動を揃えました。
• Legacy project/template import は、success、failure、duplicate、skipped、partial
  import の結果をより明確な activity record として残すようになりました。

Activity Records

• Logs page にユーザー向けの Activity Records view を追加しました。Technical logs は
  troubleshooting 用 tab として残し、Activity Records が既定の log view になります。
• Activity records は project/package/repository/template/settings の変更、update
  check、Unity Hub refresh、deep-link action、MCP call、failure、cancellation、重要な
  passive refresh など、意味のある GUI、MCP、Deep Link、System operation を記録します。
• Activity entry には source、kind、status、operation、target、duration、details、error
  information が構造化されて含まれます。Secondary records は既定で隠せますが、filter
  から確認できます。
• Activity log file は既存の ALCOMD3 data tree に local 保存され、bounded retention を
  使用します。

MCP and Log Query Tools

• MCP に activity log 用の selective read-only tool を追加しました:
  alcomd3_search_activity_logs、alcomd3_get_activity_log_entry、
  alcomd3_summarize_activity_logs、alcomd3_get_activity_log_context。
• MCP に technical log 用の selective read-only tool を追加しました:
  alcomd3_search_technical_logs、alcomd3_get_technical_log_entry、
  alcomd3_summarize_technical_logs。
• MCP tool call は request id、tool name、利用可能な client summary、status、
  sanitized details とともに local activity log に記録されます。
• MCP page は activity / technical log query tool を一覧表示し、呼び出し中の tool を
  highlight するようになりました。
• Log search / summary response は paginated かつ bounded です。Recent-file technical
  log read は巨大な file 全体ではなく、最近の tail に制限されます。
• Technical log parsing は multiline formatting と有用な local path を保ちながら、
  返却 message を truncate / redact します。

Privacy, Reliability, and Audit Fixes

• Log redaction は token-like value、authorization material、API key、一般的な password
  key、URL userinfo、URL query string、URL fragment、JSON-style assignment、colon
  assignment、token = ... のような spaced assignment を処理するようになりました。
• Activity details は Unity、VPM、非 ASCII path 問題の診断に必要な full local filesystem
  path を保持します。一方で raw MCP params、HTTP header、URL query、URL credential は
  保存しません。
• Technical log recent-file read は truncated UTF-8 prefix を byte 単位で skip するため、
  非 ASCII text を含む大きな log も query しやすくなりました。
• Summary tools は grouped result にも offset/limit を適用します。
• Template import、Unity launch、update check、package operation、複数の project workflow
  で、実際には失敗または未 import だった operation が成功として記録されにくくなり、
  failed、cancelled、partial-completion state がより明確に残ります。

Documentation and Release Maintenance

• MCP / maintenance documentation に activity-record model、log query boundary、
  retention、redaction expectation、MCP activity auditing を追記しました。
• 公開済み release notes を historical record として復元・保護しました。今後の変更は公開済み
  notes を書き換えず、新しい release notes に記録します。
• Release documentation に localized updater notes と updater metadata 生成用 sidecar file
  の説明を追加しました。

インストールについて

v2.1.0-beta.2 からの手動 data migration は不要です。MCP は引き続き既定で disabled であり、
local MCP client が ALCOMD3 data を query するには MCP page から有効化する必要があります。
Activity records と technical logs は既存の ALCOMD3 data directory 内に local 保存されます。

中文

ALCOMD3 v2.1.0-beta.3 是一个 beta 版本，重点改进更新体验、本地活动可见性、MCP 日志查询工具，以及更安全的日志处理。

相比 v2.1.0-beta.2 的变化

更新体验

• 更新对话框现在支持 updater metadata 中的多语言更新说明，可在应用内更新提示中显示用户语言的简短摘要。
• 优化了更新对话框的稍后提醒流程、官网/更新操作，以及缺少更新说明时的回退文案。
• 安装更新时，现在可以从侧边栏看到安装进度。
• 发布工具现在支持显式的多语言 updater-note sidecar，并会在生成 metadata 前拒绝格式错误或空值的更新摘要。

项目与旧数据导入

• 空项目页现在提供直接导入现有 VCC/ALCOM 数据的入口。
• 旧数据导入 UI 逻辑在初始化、设置和空项目页之间复用，入口行为更加一致。
• 旧项目和模板导入现在会为成功、失败、重复、跳过和部分导入结果写入更清晰的活动记录。

活动记录

• 日志页新增面向用户的活动记录视图。活动记录现在是默认日志视图，技术日志保留为排障用 tab。
• 活动记录覆盖有意义的 GUI、MCP、Deep Link 和 System 操作，包括项目、软件包、存储库、模板、设置变更，更新检查，Unity Hub 刷新，深链接操作，MCP 调用，失败，取消，以及重要的被动刷新。
• 活动条目包含结构化的来源、类型、状态、操作、对象、耗时、详情和错误信息。辅助记录可默认隐藏，但仍可通过筛选查看。
• 活动日志文件保存在现有 ALCOMD3 本地数据树下，并使用有界保留策略。

MCP 与日志查询工具

• MCP 新增活动记录选择性只读工具：alcomd3_search_activity_logs、alcomd3_get_activity_log_entry、alcomd3_summarize_activity_logs 和 alcomd3_get_activity_log_context。
• MCP 新增技术日志选择性只读工具：alcomd3_search_technical_logs、alcomd3_get_technical_log_entry 和 alcomd3_summarize_technical_logs。
• MCP 工具调用会写入本地活动记录，包含 request id、工具名、可用时的客户端摘要、状态和脱敏后的详情。
• MCP 页面现在会列出活动记录和技术日志查询工具，并在调用时高亮对应工具。
• 日志搜索和摘要结果都带分页和上限。读取最近技术日志文件时，只读取近期尾部内容，而不是把大型日志文件整体读入内存。
• 技术日志解析会保留多行格式和有助于排障的本地路径，同时继续对返回消息做截断和脱敏。

隐私、可靠性与审计修复

• 日志脱敏现在覆盖疑似 token、authorization 材料、API key、常见密码键、URL userinfo、URL query、URL fragment、JSON 风格赋值、冒号赋值，以及 token = ... 这类带空格的赋值。
• 活动详情继续保留用于排查 Unity、VPM 和非 ASCII 路径问题的完整本地文件路径，但不会保存原始 MCP params、HTTP head...

Version 2.1.0-beta.2

ALCOMD3 v2.1.0-beta.2

English

ALCOMD3 v2.1.0-beta.2 is a beta release focused on improving MCP project operations, package lookup behavior, project progress UI, and ALCOMD3-specific maintenance details.

Changes since v2.1.0-beta.1

MCP

• MCP now includes expanded read-only package and repository lookup tools, including paginated GUI-visible package lists, package details, and repository package listing.
• MCP package list counts now match the GUI package summary behavior by keeping only the latest visible version per package and source.
• MCP repository and package results now label official default, curated default, user repository, and local user package sources explicitly.
• MCP now includes limited project write tools for backing up registered projects, copying registered projects, and restoring projects from zip backups.
• MCP project backup, copy, and restore tools now support task-aware execution with task lookup, task results, cancellation, and progress notifications.
• Disabling MCP now rejects new tool calls and new project task starts while preserving follow-up access to already-started project tasks until they reach a terminal state.
• MCP tool execution errors now set the MCP isError flag while preserving the existing structured ok: false payload.
• MCP IPC boundaries and local task activity tracking were tightened.

Project Operations

• Project backup, copy, and restore progress now uses a shared stacked tray, so concurrent minimized project operations remain reachable.
• Restore-from-backup progress can now be canceled from the GUI.
• Project copy and project restore now use separate backend task locks, so one running operation no longer blocks the other while same-kind duplicate runs are still rejected.
• Project task parameter naming and progress state handling were aligned between GUI commands and MCP tools.

Website, Documentation, and Maintenance

• The website MCP permission copy and advantages section layout were updated.
• ALCOMD3 app data path handling is now centralized for GUI, MCP, and shared package code.
• Project licensing metadata and documentation were migrated to AGPL-3.0-or-later.
• Maintenance and MCP documentation now describe disabled MCP task follow-up behavior and avoid stale release version references.

Installation Notes

This beta keeps the ALCOMD3-specific app identity and updater channel introduced in v2.1.0-beta.1.
No manual data migration is required for users already running v2.1.0-beta.1.

日本語

ALCOMD3 v2.1.0-beta.2 は、MCP project operation、package lookup behavior、project progress UI、ALCOMD3 固有の maintenance detail を改善する beta release です。

v2.1.0-beta.1 からの変更点

MCP

• MCP に paginated GUI-visible package list、package details、repository package listing など、read-only package / repository lookup tool を追加・拡張しました。
• MCP package list の件数は GUI package summary と同じく、package と source ごとの最新 visible version だけを数えるようになりました。
• MCP repository / package result は official default、curated default、user repository、local user package の source を明示するようになりました。
• MCP に、registered project の backup、registered project の copy、zip backup からの restore を行う限定 project write tool を追加しました。
• MCP project backup、copy、restore tool は task lookup、task result、cancellation、progress notification を含む task-aware execution に対応しました。
• MCP を disabled にすると、新しい tool call と新しい project task start は拒否されますが、すでに開始済みの project task は terminal state になるまで follow-up access を維持します。
• MCP tool execution error は、既存の structured ok: false payload を保ったまま MCP isError flag を設定するようになりました。
• MCP IPC boundary と local task activity tracking を強化しました。

Project Operations

• Project backup、copy、restore progress は shared stacked tray を使うようになり、minimize された複数の project operation にアクセスしやすくなりました。
• GUI から restore-from-backup progress をキャンセルできるようになりました。
• Project copy と project restore は separate backend task locks を使うようになり、片方の実行中でももう片方を block しません。同種の重複実行は引き続き拒否されます。
• GUI command と MCP tool の間で project task parameter naming と progress state handling を揃えました。

Website, Documentation, and Maintenance

• Website の MCP permission copy と advantages section layout を更新しました。
• GUI、MCP、shared package code の ALCOMD3 app data path handling を centralized しました。
• Project licensing metadata と documentation を AGPL-3.0-or-later に移行しました。
• Maintenance / MCP documentation に disabled MCP task follow-up behavior を記載し、古い release version reference を避けるようにしました。

インストールについて

この beta は v2.1.0-beta.1 で導入した ALCOMD3 固有の app identity と updater channel を維持します。
すでに v2.1.0-beta.1 を使用している場合、手動の data migration は不要です。

中文

ALCOMD3 v2.1.0-beta.2 是一个 beta 版本，重点改进 MCP 项目操作、软件包查询行为、项目进度界面，以及 ALCOMD3 自身维护细节。

相比 v2.1.0-beta.1 的变化

MCP

• MCP 扩展了只读软件包和存储库查询工具，包括分页的 GUI 可见软件包列表、软件包详情和按存储库列出软件包。
• MCP 软件包列表计数现在与 GUI 软件包摘要行为一致：同一来源内同一包名只保留最新可见版本。
• MCP 存储库和软件包结果现在会明确标注官方默认、Curated 默认、用户存储库和本地用户包来源。
• MCP 新增有限项目写入工具，可备份已登记项目、复制已登记项目，并从 zip 备份恢复项目。
• MCP 项目备份、复制和恢复工具现在支持 task-aware execution，包括任务查询、任务结果、取消和进度通知。
• MCP 停用后会拒绝新的工具调用和新的项目任务启动，但已启动的项目任务在进入终止状态前仍可继续查询结果或取消。
• MCP 工具执行错误现在会设置 MCP isError 标记，同时保留既有的结构化 ok: false 载荷。
• MCP IPC 边界和本地任务活动跟踪进一步收紧。

项目操作

• 项目备份、复制和恢复进度现在使用共享的堆叠托盘，多个最小化的项目操作仍然都能访问。
• GUI 中的从备份恢复进度现在可以取消。
• 项目复制和项目恢复现在使用独立后端任务锁，因此其中一个正在运行时不再阻塞另一个；同类重复运行仍会被拒绝。
• GUI 命令和 MCP 工具之间的项目任务参数命名与进度状态处理已对齐。

网站、文档与维护

• 网站的 MCP 权限说明和优势区块布局已更新。
• GUI、MCP 和共享包代码中的 ALCOMD3 应用数据路径处理已集中化。
• 项目授权元数据和文档已迁移到 AGPL-3.0-or-later。
• 维护和 MCP 文档现在说明了 MCP 停用后的任务 follow-up 行为，并避免过期的发布版本引用。

安装说明

此 beta 继续使用 v2.1.0-beta.1 引入的 ALCOMD3 专属应用身份和 updater channel。
已经使用 v2.1.0-beta.1 的用户不需要手动迁移数据。