Skip to content

Releases: HBLADEH/CatScope

Release list

CatScope v0.6.7

CatScope v0.6.7 Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 13 Sep 18:01
v0.6.7
e8baf49

CatScope v0.6.7

本次补丁修复日志量较大或窗口较窄时，日志列表文字重叠的问题。

修复

  • 保留已测量的日志行高度，避免持续接收日志时，多行消息与后续行重叠。
  • 按日志 ID 关联虚拟列表的行高缓存，避免缓冲区满后淘汰旧日志造成位置错乱。
  • 日志达到 100000 条后，仍能自动跟随最新日志；保留多行预览和完整日志详情。

安装与升级

  • Windows 10 / 11：下载 CatScope-v0.6.7-windows-amd64.exe 后运行，需要 Microsoft WebView2 Runtime。已有 v0.6.6 的用户可以在“应用更新”中检查更新并安装重启。
  • macOS：下载 CatScope-v0.6.7-macos-universal.dmg，打开后将 CatScope 拖入 Applications；支持 Intel Mac 和 Apple Silicon。
  • 实时 Logcat 需要本机 ADB 和已授权的 Android 设备或模拟器。

已知限制

  • macOS 仍为 universal preview，尚未完成 Apple notarization，首次打开可能被 Gatekeeper 拦截；确认下载来源后可在系统“隐私与安全性”中允许打开。
  • macOS 需要手动安装更新；Windows 应用内更新需要 EXE 所在目录可写。

验证与校验

  • 本地已验证窄窗口、持续追加及 100000 条缓冲区满载场景。
  • Release workflow 分别构建 Windows EXE 和 macOS universal DMG，并验证产物。
  • 两个平台均提供同名 .sha256 文件。Windows 使用 Get-FileHash <文件名> -Algorithm SHA256；macOS 使用 shasum -a 256 -c CatScope-v0.6.7-macos-universal.dmg.sha256。
Assets 6
Loading

CatScope v0.6.6

CatScope v0.6.6

Choose a tag to compare

View all tags
@github-actions github-actions released this 15 Jul 19:09
v0.6.6
6d05da8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

CatScope v0.6.6

这个版本为 CatScope 加入自动检测升级，并让 Windows 便携版在保持单 EXE 分发的同时支持校验后安装和重启。发版流程也增加了版本一致性保护。

新增

  • 启动后自动检查 GitHub Release，也可以在左侧“应用更新”区域手动检查。
  • 默认只接收正式版，可选择接收 Preview 版本。
  • Windows 便携版支持“安装并重启”：下载当前架构对应的 EXE，校验同名 SHA256，退出后替换原文件并重新启动。
  • 自动替换不可用时，可以直接打开对应 GitHub Release 手动下载。

改进

  • 程序运行时版本、Windows 资源版本、前端包版本统一为 0.6.6。
  • Release workflow 会在 Windows 和 macOS 构建前校验源码版本与 tag 是否一致，不一致时停止发版。
  • Windows Release 继续同时提供版本化 EXE 和 .sha256 文件，供用户校验和应用内升级使用。
  • 前端生产构建会先清理旧的 dist 资源，避免历史 JS / CSS 被重复打进 EXE。

使用方式

  1. 启动 CatScope，默认会在约 1.5 秒后静默检查一次正式版更新。
  2. 在左侧“应用更新”区域可以关闭自动检查、接收 Preview，或手动检查。
  3. Windows 发现新版本后点击“安装并重启”。下载和 SHA256 校验完成后，CatScope 会自动退出、替换并重新打开。
  4. 如果 EXE 所在目录不可写，请点击“查看 Release”并手动下载替换。

已知限制

  • macOS 当前支持检测更新和打开 Release 页面，但不会自动替换 .app；后续应结合 Developer ID 签名和 notarization 接入。
  • Windows EXE 如果位于无写权限目录，应用内替换会失败。
  • 当前完整性校验使用 GitHub Release HTTPS 和 SHA256。面向更广泛用户发布时，仍建议为 Windows EXE 增加 Authenticode 数字签名。

运行要求

  • Windows 10 / 11 + Microsoft WebView2 Runtime，或 macOS。
  • Android SDK Platform Tools；实时 Logcat 仍需要已授权的 Android 设备或模拟器。

校验方式

  • 运行 go test ./...。
  • 在 frontend/ 运行 npm run build。
  • 运行 go run scripts/check-version.go v0.6.6。
  • Windows 使用 scripts/check.ps1 和 scripts/build-windows.ps1。
  • Release 中 Windows EXE 和 macOS DMG 均提供同名 .sha256 文件。
Loading

CatScope v0.6.5

CatScope v0.6.5

Choose a tag to compare

View all tags
@github-actions github-actions released this 10 Jul 09:47
v0.6.5
6e69494

CatScope v0.6.5

Release assets generated by GitHub Actions.

Loading

CatScope v0.6.4

CatScope v0.6.4

Choose a tag to compare

View all tags
@github-actions github-actions released this 08 Jul 17:14
v0.6.4
8805fe6

这个版本主要改善 Logcat 搜索和日志表格阅读体验，同时修复发布 workflow 里前端依赖没有安装就开始构建的问题。

重点变化

  • 搜索框支持字段查询语法，例如 tag:ActivityManager、pid:1234、level:E、message:error、-message:noise。
  • 字段查询支持包含、精确匹配、前缀匹配和正则匹配，便于在大量日志里快速缩小范围。
  • 普通关键词搜索会同时覆盖 package、PID、TID、level、tag、message 和 raw 文本。
  • 清空搜索时会同步重置 level、tag、排除词和 regex 状态，回到更直观的默认过滤条件。
  • 日志表格改为按实际行高测量虚拟滚动项，长 message 最多显示 4 行，减少内容被截断后难以判断的问题。
  • Release workflow 会在 Windows 和 macOS 构建前执行 npm ci --prefix frontend，避免 CI 找不到 vue-tsc。
  • 协作说明补充规则：如果为了测试启动了前端开发服务，测试结束后要主动关闭。

运行要求

  • Windows + Microsoft WebView2 Runtime，或 macOS。
  • Android SDK Platform Tools，并确保 adb 能通过 PATH、ANDROID_HOME、ANDROID_SDK_ROOT 或 CatScope 配置找到。
  • 如果要看实时 Logcat，需要设备开启 USB 调试，并允许当前电脑授权。
  • 离线日志和 session 查看不依赖连接设备。

使用提示

  1. 在搜索框输入普通关键词，可以继续按文本搜索日志。
  2. 输入 tag:ActivityManager 可以只看 tag 包含 ActivityManager 的日志。
  3. 输入 pid:1234 level:E 可以同时限定 PID 和日志级别。
  4. 输入 -message:noise 可以排除 message 中包含 noise 的日志。
  5. 长日志 message 会在列表里显示多行预览，点击日志行仍可在详情面板查看完整内容。

已知限制

  • CatScope 不是完整 IDE，也不是 Android Studio 替代品。
  • Build / Install / Launch 目前还是基础能力，不做 Gradle Project Sync，也不包含代码编辑器。
  • AI Context 只在本地生成 Markdown，不调用外部 AI API。
  • 前端构建时 Vite 可能提示 chunk size warning，目前不影响发版。

SHA256

请查看 Release 里上传的同名 .sha256 文件。

校验方式

  • Go 后端：go test ./...
  • 前端：npm run build
  • 发布产物：使用 Release workflow 生成 Windows EXE 和 macOS DMG，并校验对应 SHA256 文件。
Loading

CatScope v0.6.3

CatScope v0.6.3

Choose a tag to compare

View all tags
@HBLADEH HBLADEH released this 07 Jul 18:42
v0.6.3
ec92dd8

这个版本主要补齐 macOS universal 预览包，让 CatScope 可以在 Windows 之外，也先跑在 Intel Mac 和 Apple Silicon Mac 上。

重点变化

  • 新增 macOS universal 构建流程，一个包同时支持 Intel Mac 和 Apple Silicon Mac。
  • 新增 DMG 打包和 SHA256 校验文件，方便作为 GitHub Release 资产发布。
  • 固定 macOS bundle id：正式构建使用 com.hbladeh.catscope，开发构建使用 com.hbladeh.catscope.dev。
  • 修复 macOS 手动选择 adb 时文件选择框崩溃的问题。
  • 更新 macOS 安装、adb 路径、QA 和发布资产说明。

运行要求

  • macOS，或 Windows + Microsoft WebView2 Runtime。
  • Android SDK Platform Tools，并确保 adb 能通过 PATH、ANDROID_HOME、ANDROID_SDK_ROOT 或 CatScope 配置找到。
  • 如果要看实时 Logcat，需要设备开启 USB 调试，并允许当前电脑授权。
  • 离线日志和 session 查看不依赖连接设备。

macOS 安装方式

  1. 从 GitHub Release 下载 CatScope-v0.6.3-preview-macos-universal.dmg。
  2. 如需校验完整性，可以使用同名 .sha256 文件。
  3. 打开 DMG，把 CatScope.app 拖到 Applications。
  4. 启动 CatScope，选择 Android 设备并点击 Start Logcat；也可以直接打开离线日志或 session 文件。

这个预览版 DMG 目前是 self-signed/ad-hoc signed，还没有做 Apple notarization。第一次启动如果被 macOS Gatekeeper 拦截，可以在 Finder 里右键选择 Open，或到系统设置里允许该应用。后续正式面向普通用户发布时，建议接入 Developer ID 签名、notarization 和 stapling。

已知限制

  • CatScope 不是完整 IDE，也不是 Android Studio 替代品。
  • macOS 支持仍是 preview 级别。遇到 adb 检测、设备连接、文件选择框、Gatekeeper 相关问题时，请带上 macOS 版本和芯片架构一起反馈。
  • 从 Finder 启动的 GUI 应用不一定继承 shell 里的 PATH。如果 CatScope 找不到 adb，请手动配置完整路径，例如 /Users/<you>/Library/Android/sdk/platform-tools/adb。
  • Build / Install / Launch 目前还是基础能力，不做 Gradle Project Sync，也不包含代码编辑器。
  • AI Context 只在本地生成 Markdown，不调用外部 AI API。
  • 前端构建时 Vite 可能提示 chunk size warning，目前不影响发版。

SHA256

请查看 Release 里上传的 CatScope-v0.6.3-preview-macos-universal.dmg.sha256。

构建说明

  • 本地构建命令：scripts/build-macos.sh
  • Wails target：darwin/universal
  • 期望架构：x86_64 arm64
  • 期望产物：
    • CatScope-v0.6.3-preview-macos-universal.dmg
    • CatScope-v0.6.3-preview-macos-universal.dmg.sha256
Loading

CatScope v0.6.2-preview

CatScope v0.6.2-preview Pre-release
Pre-release

Choose a tag to compare

View all tags
@HBLADEH HBLADEH released this 06 Jul 17:35
v0.6.2-preview
45277c3

GitHub Preview Release preparation for CatScope, a lightweight Android Logcat workbench for Windows.

Highlights

  • Lightweight Android Logcat Workbench for focused Android troubleshooting without opening Android Studio.
  • Package-aware filtering with package selection, PID tracking, level filters, tags, keywords, exclusions, and regex search.
  • Rule-based Crash Analyzer for Java crashes, ANR, native crashes, JNI errors, and install failures.
  • Local AI Context Generator that creates Markdown context without calling external AI APIs.
  • Offline Log Viewer and .catscope-session restore flow for returning to a saved debugging state.
  • README branding, final logo usage, screenshots, demo recording guide, and release asset checklist are ready for the first public preview.

Features

  • Device discovery through local adb and Android SDK Platform Tools.
  • Live threadtime Logcat streaming with a large ring buffer and virtualized frontend table.
  • Search, level, tag, exclude keyword, regex, package, and PID tracking filters.
  • Offline .txt, .log, .jsonl, and CatScope session workflows.
  • TXT / JSONL export and local Markdown AI context export.
  • Basic Build / Install / Launch workflow for Gradle wrapper projects.
  • Workspace and filter preset persistence in local CatScope configuration.
  • Screenshot documentation for Live Logcat, Analysis, and Build / Install / Launch views.

Requirements

  • Windows with Microsoft WebView2 Runtime installed.
  • Android SDK Platform Tools with adb available through PATH, ANDROID_HOME, ANDROID_SDK_ROOT, or CatScope configuration.
  • USB debugging enabled and authorized for live device logging.
  • An Android device or emulator for live Logcat; offline log and session workflows can be used without a connected device.

Installation

  1. Download CatScope.exe from the GitHub Release assets.
  2. Optionally verify the SHA256 checksum below.
  3. Start CatScope.exe.
  4. Select an Android device and click Start Logcat, or open an offline log/session file.

Known Issues

  • CatScope is not a complete IDE and is not an Android Studio replacement.
  • Gradle Project Sync and code editing are not supported.
  • Module and variant selection in Build / Install / Launch is still basic.
  • Launcher activity automatic parsing is not complete.
  • External AI APIs are not integrated; AI Context is local Markdown generation only.
  • Large session files are not compressed or split.
  • Vite may show a chunk size warning during build; this does not currently block release preparation.
  • Logo.candidate.png is a raw logo candidate with a white background and should not be used in README, release assets, app icons, or screenshots.

SHA256

CatScope.exe  ACB30A8597C1FBF43D6F79ED49549C7F4B1A36791F37E01F69D20546CA256579

Changelog Summary

  • Prepared first GitHub preview release notes for v0.6.2-preview.
  • Verified pre-release checks, Windows build, Wails doctor, Go tests, frontend build, and Git whitespace check.
  • Generated Windows executable at build/bin/CatScope.exe.
  • Added release-facing documentation for logo usage, screenshots, demo recording, and release asset preparation.
  • Integrated real README screenshots for Live Logcat, Analysis, and Build / Install / Launch.
Loading

CatScope v0.6.0-preview

CatScope v0.6.0-preview Pre-release
Pre-release

Choose a tag to compare

View all tags
@HBLADEH HBLADEH released this 05 Jul 18:22
v0.6.0-preview
a2f7795

CatScope v0.6.0-preview is the first release-preparation preview for the lightweight Android Logcat debugging workbench. This version focuses on making the current MVP usable as a Windows preview build, with live Logcat, offline logs, sessions, analyzers, local AI Context generation, and basic Build / Install / Launch workflows.

This is a preview release. CatScope is not an Android Studio replacement, and several IDE-level features are intentionally out of scope.

Highlights

  • Lightweight Android Logcat workbench for Windows.
  • Live Logcat streaming through local adb.
  • Offline .txt, .log, .jsonl, and .catscope-session workflows.
  • Rule-based Java Crash, Native Crash, ANR, JNI Error, and Install Error Analyzer.
  • Local AI Context Markdown generation without external AI API calls.
  • Basic Build / Install / Launch helper workflow for Android Gradle wrapper projects.
  • Release preparation scripts and documentation for GitHub Releases.

Features

  • ADB discovery from configured path, ANDROID_HOME, ANDROID_SDK_ROOT, and PATH.
  • Device list parsing with device, offline, unauthorized, and unknown states.
  • Device details including model, brand, Android version, SDK, ABI, and emulator detection.
  • Live adb logcat -v threadtime -b main,system,crash streaming.
  • 100000-line ring buffer with dropped-line tracking.
  • Virtualized log table for large sessions.
  • Search, Level, Tag, Exclude, Regex, Package, and PID Tracking filters.
  • Package selector with third-party package mode.
  • Multiline Java stacktrace merging and threadtime parsing.
  • TXT and JSONL export.
  • Offline Log File Viewer for .txt, .log, and .jsonl.
  • Session save and restore with .catscope-session.
  • Analysis Tab for rule-based crash and install diagnostics.
  • Local AI Context copy/export as Markdown.
  • Workspace and Filter Preset persistence through local config.json.
  • Basic Build / Install / Launch:
    • detect gradlew / gradlew.bat;
    • run assembleDebug by default;
    • find latest debug APK;
    • install with adb;
    • launch package with adb shell monkey.

Windows Notes

  • This preview build targets Windows.
  • Microsoft WebView2 Runtime is required.
  • Android SDK Platform Tools are required for live device workflows.
  • adb must be available through PATH, ANDROID_HOME, ANDROID_SDK_ROOT, or CatScope configuration.
  • On first USB connection, authorize USB debugging on the Android device.
  • The preview executable is unsigned, so Windows SmartScreen may show a warning.

Requirements

  • Windows 10 / Windows 11.
  • Microsoft WebView2 Runtime.
  • Android SDK Platform Tools.
  • Android device or emulator with USB debugging enabled for Live Logcat.
  • No device is required for Offline Log File Viewer or Session mode.

Installation

  1. Download the Windows portable zip from this release.
  2. Extract the zip.
  3. Run CatScope.exe.
  4. Connect an Android device and authorize USB debugging, or open an offline log/session file.

Privacy

  • CatScope reads logs through local adb.
  • Offline logs and sessions are read from local disk only.
  • Workspace and filter settings are stored locally in CatScope configuration.
  • AI Context is generated locally as Markdown.
  • CatScope does not upload logs.
  • CatScope does not call OpenAI, Claude, Gemini, or any external AI API.

Known Issues

  • CatScope is not a complete IDE.
  • CatScope is not an Android Studio replacement.
  • Gradle Project Sync is not supported.
  • Code editing is not supported.
  • Module and variant selection for Build / Install / Launch is still basic.
  • Launcher activity automatic parsing is not complete.
  • External AI APIs are not integrated.
  • Large .catscope-session files are not compressed or split.
  • Vite may print a chunk size warning during frontend builds; this does not currently block use.
  • The Windows preview build is unsigned.

Checksums

Add the SHA256 checksum after packaging the release artifact:

<sha256>  CatScope-v0.6.0-preview-windows-amd64-portable.zip

Changelog

  • Prepared app metadata for v0.6.0-preview.
  • Added Windows build script: scripts/build-windows.ps1.
  • Added pre-release check script: scripts/check.ps1.
  • Added release documentation:
    • docs/RELEASE_NOTES_TEMPLATE.md;
    • docs/KNOWN_ISSUES.md;
    • docs/USER_GUIDE.md;
    • docs/USER_GUIDE.zh-CN.md;
    • docs/screenshots/README.md.
  • Expanded English and Chinese README files with Quick Start, Requirements, Windows usage, adb setup, USB debugging authorization, FAQ, and privacy notes.
  • Hid Windows child console windows for adb / Gradle subprocesses.
  • Improved small-window layout behavior to avoid log table and details panel overlap.
Loading