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 header、URL query 或 URL 凭据。
• 技术日志读取大型近期文件时会按字节跳过被截断的 UTF-8 前缀，因此包含非 ASCII 文本的大日志仍可查询。
• 摘要工具现在也会对分组结果应用 offset/limit。
• 模板导入、Unity 启动、更新检查、软件包操作和多个项目流程中，实际失败或没有导入内容的操作不再容易被记录为成功，而是更清楚地记录为失败、取消或部分完成状态。

文档与发布维护

• MCP 和维护文档补充了活动记录模型、日志查询边界、保留策略、脱敏预期和 MCP 活动审计说明。
• 已发布 release notes 已恢复并作为历史记录保护；后续变化应写入新的 release notes，而不是改写已发布说明。
• 发布文档现在说明了多语言 updater notes，以及用于生成 updater metadata 的 sidecar 文件。

安装说明

已经使用 v2.1.0-beta.2 的用户不需要手动迁移数据。MCP 仍默认关闭，本地 MCP 客户端需要先在 MCP 页面启用后才能查询 ALCOMD3 数据。活动记录和技术日志都保留在现有 ALCOMD3 本地数据目录中。