TidGi-Desktop

For testing.

发布日期：2026-08-01 基于标签：v0.14.2-prerelease3 → v0.14.2-prerelease4 改动范围：24 个文件变更，新增 933 行，删除 465 行

目录

1. 修复 Windows 安装器 Hook 超时
2. 修复应用退出时结构化日志崩溃
3. 收紧 Electron Web Security 范围
4. 加固发布资产与校验和流程
5. 复用通用代理 E2E 测试步骤

1. 修复 Windows 安装器 Hook 超时 (#751)

• 将 Electron 主进程拆分为轻量入口和完整应用初始化模块
• 在加载日志、数据库、Worker 等完整服务之前处理 Squirrel 安装事件
• 避免安装 Hook 进入普通应用启动与退出清理流程并超过 Squirrel 超时时间
• 补充 Bootstrap 回归测试，确保安装事件不会加载完整应用

2. 修复应用退出时结构化日志崩溃 (#751)

• 关闭旋转日志流之前先停止接受新的结构化日志写入
• 已排队但尚未执行的日志回调会正常完成，不再写入已经结束的 RotatingFileStream
• 修复 Windows 退出应用时出现的 Error: write after end 主进程异常弹窗
• 增加日志关闭时序回归测试

3. 收紧 Electron Web Security 范围 (#751)

• 移除进程级 --disable-web-security 开关
• 普通 BrowserWindow 恢复 webSecurity: true 和安全的混合内容默认值
• 仅 Wiki WebContentsView 暂时保留无 CORS 服务兼容例外
• HTTP/HTTPS CSP 绕过仅用于开发和测试环境
• 修正 app.commandLine.appendSwitch() 参数不应包含前导 -- 的遗留问题

4. 加固发布资产与校验和流程 (#748)

• 每个平台和架构生成独立的 SHA256SUMS 文件
• 构建阶段验证 Linux DEB/RPM、macOS ZIP、Windows EXE/MSIX 是否完整存在
• Draft Release 同时上传发行包及六份平台校验和文件
• 为 Windows 与 Linux x64 生成可供后续 Steam 手动发布流程使用的 Depot 归档
• 补充 Release、Steam 和社区包管理器维护说明

5. 复用通用代理 E2E 测试步骤 (#749)

• 删除代理功能新增的重复 Cucumber 步骤定义
• 通过现有场景 Fixture 配置 Mock Proxy
• 复用通用 TiddlyWiki 代码步骤验证 Wiki 前端、Wiki 后端与 Git 代理请求
• Mock Proxy 不转发公网流量，同时记录并验证目标 URL

完整 PR / 提交列表

完整对比: https://github.com/tiddly-gittly/TidGi-Desktop/compare/v0.14.2-prerelease3...v0.14.2-prerelease4

Release Date: 2026-08-01 Tag Range: v0.14.2-prerelease3 → v0.14.2-prerelease4 Scope: 24 files changed, 933 insertions, 465 deletions

Table of Contents

1. Fix Windows Installer Hook Timeout
2. Fix Structured Logging Crash During App Exit
3. Scope Electron Web Security Exceptions
4. Harden Release Assets and Checksums
5. Reuse Generic Proxy E2E Steps

1. Fix Windows Installer Hook Timeout (#751)

• Split the Electron main process into a lightweight entry point and the full application initialization module
• Handle Squirrel installer events before loading logging, databases, Workers, and other application services
• Prevent installer hooks from entering the normal startup and shutdown path and exceeding Squirrel's timeout
• Add bootstrap regression tests that ensure installer events do not load the complete application

2. Fix Structured Logging Crash During App Exit (#751)

• Stop accepting structured log writes before ending rotating file streams
• Complete callbacks for queued records without writing them to an already-ended RotatingFileStream
• Fix the Error: write after end main-process exception dialog shown when exiting the Windows application
• Add a regression test for the logger shutdown ordering

3. Scope Electron Web Security Exceptions (#751)

• Remove the process-wide --disable-web-security switch
• Restore webSecurity: true and safe mixed-content defaults for regular BrowserWindows
• Keep the no-CORS compatibility exception temporarily scoped to Wiki WebContentsViews
• Limit HTTP/HTTPS CSP bypass registration to development and test environments
• Fix the legacy leading -- in the app.commandLine.appendSwitch() argument

4. Harden Release Assets and Checksums (#748)

• Generate a separate SHA256SUMS file for every platform and architecture
• Validate that Linux DEB/RPM, macOS ZIP, and Windows EXE/MSIX artifacts all

For testing.

发布日期：2026-07-30 基于标签：v0.14.2-prerelease2 → v0.14.2-prerelease3 改动范围：96 个文件变更，新增 3,508 行，删除 744 行

目录

1. Linux 原生包与窗口使用 TidGi 图标
2. 工作区级结构化日志查看器
3. 设置页虚拟化与可靠导航
4. 分组件网络代理设置
5. 跨功能质量与安全加固

1. Linux 原生包与窗口使用 TidGi 图标 (#745)

• Electron Packager 按目标平台选择应用图标
• DEB / RPM 安装包显式使用 TidGi PNG，不再回退到 Electron 默认图标
• Linux BrowserWindow 使用随应用打包的运行时图标资源

2. 工作区级结构化日志查看器 (#746)

• 按日期、工作区和进程写入结构化 JSONL 日志
• Git 工作按工作区隔离到 UtilityProcess，并将日志归属到对应工作区
• 新增支持虚拟滚动、搜索、按需加载完整记录及 Monaco 展开的日志查看器
• 可从开发者工具与工作区菜单打开前端或服务端日志
• 日志轮转改用稳定文件名，读取采用有界反向扫描并限制单条记录大小，避免旧引用失效和超大记录占用过多内存
• 对日志详情引用校验记录 ID；应用退出时等待结构化日志完全写入
• Wiki 页面不再获得跨工作区日志读取接口，Worker 启动日志也不再记录认证令牌等敏感配置

3. 设置页虚拟化与可靠导航 (#747)

• 全局设置与工作区设置改为可变高度虚拟列表，只挂载视口及缓冲区内容
• 大型设置分区按批次渐进渲染，搜索结果同样虚拟化
• Deep Link 与侧栏导航统一为按索引、请求感知的定位流程，并在实际测量后重新对齐
• 修复搜索状态下导航请求被提前消费的问题
• 保存在虚拟滚动中暂时卸载的输入草稿，避免代理 URL 和多行设置在滚动后丢失
• 切换工作区时重建编辑窗口，避免复用上一工作区的表单状态

4. 分组件网络代理设置 (#744)

• 新增 Default、Wiki 服务端、Wiki 网页和 Git 四组独立代理配置
• Electron session、Wiki UtilityProcess 与 Git 子进程分别应用对应代理
• 抽取可复用的纵向键值标签页组件，并复用于外部 API Provider 配置
• 补充不会转发公网流量的 mock proxy E2E 场景，验证请求确实经过指定代理
• 未配置代理时保持 Git 直连环境有效，并处理代理偏好变更后的 session / Worker 更新

5. 跨功能质量与安全加固

• 共享同一祖先仓库的多个工作区改用规范化 repo path 的 FIFO 写锁，避免并发 Git 写操作互相破坏
• Git 历史回滚、恢复和忽略文件操作固定使用发起工作区的 Worker；退出时回收全部 Git Worker
• 日志搜索增加防抖和请求代次校验，避免旧异步结果覆盖新筛选条件
• 停止跟随日志后不再后台轮询覆盖已加载的旧记录
• 子 Wiki 的前端日志菜单正确映射到主 Wiki renderer

完整 PR / 提交列表

完整对比: https://github.com/tiddly-gittly/TidGi-Desktop/compare/v0.14.2-prerelease2...v0.14.2-prerelease3

Release Date: 2026-07-30 Tag Range: v0.14.2-prerelease2 → v0.14.2-prerelease3 Scope: 96 files changed, 3,508 insertions, 744 deletions

Table of Contents

1. Use TidGi Icons in Linux Native Packages and App Windows
2. Workspace-Scoped Structured Log Viewer
3. Virtualized Settings and Reliable Navigation
4. Per-Component Network Proxy Settings
5. Cross-Feature Quality and Security Hardening

1. Use TidGi Icons in Linux Native Packages and App Windows (#745)

• Select the application icon for the Electron Packager target platform
• Explicitly use the TidGi PNG in DEB / RPM packages instead of falling back to Electron's default icon
• Use the packaged runtime icon for Linux BrowserWindows

2. Workspace-Scoped Structured Log Viewer (#746)

• Write structured JSONL logs grouped by date, workspace, and process
• Isolate Git work in per-workspace UtilityProcesses and attribute logs to the correct workspace
• Add a virtualized, searchable Log Viewer with lazy full-record loading and Monaco expansion
• Open renderer or server logs from Developer Tools and workspace menus
• Use immutable rotated filenames, bounded backward reads, and per-record size limits to keep references valid and memory use bounded
• Verify record IDs when resolving details and wait for structured log streams to flush during shutdown
• Remove cross-workspace log access from wiki pages and redact authentication secrets from Worker startup logs

3. Virtualized Settings and Reliable Navigation (#747)

• Render global and workspace settings with variable-height virtual lists that mount only the viewport and overscan
• Progressively batch large sections

For testing.

发布日期：2026-07-27 基于标签：v0.14.1 → v0.14.2-prerelease2 改动范围：96 个文件变更，新增 4,331 行，删除 2,378 行

目录

1. Git Worker 迁移至 Electron UtilityProcess（崩溃隔离）
2. 避免嵌套 Git 仓库
3. 子 Wiki 路由信息与 Git 作用域 UI
4. Windows 安装器（Squirrel）稳定性修复
5. 修复原生打包与 E2E 隔离
6. CI 与杂项

1. Git Worker 迁移至 Electron UtilityProcess（崩溃隔离）(#736)

将 Git Worker 从原有 worker 适配方案迁移到 Electron UtilityProcess，让 Git 相关崩溃与主进程隔离，提升桌面端稳定性。

• 移除 workerAdapter，统一走 UtilityProcess 生命周期与通信
• 调整 Vite / Forge 构建配置以适配新的 worker 打包路径
• 相关 Git / Wiki 服务接口同步更新

2. 避免嵌套 Git 仓库 (#737)

修复在已有 Git 仓库目录内新建文件夹 Wiki 时产生嵌套 .git 的问题（#730）：

• 检测祖先仓库并复用外层 repo，而不是再初始化内层仓库
• 补充 Git scope 相关单元测试

3. 子 Wiki 路由信息与 Git 作用域 UI (#735)

• 新增 getTiddlerRoutingInfo，便于子 Wiki 路由 UI 展示与调试
• 增强 routingUtilities / FileSystemAdaptor 的路由判断与测试覆盖
• 工作区设置新增 Git repo scope 自定义项；澄清工作区 filter 是追加到标签规则，而非替换
• 新建文件夹 Wiki 时相关表单与路径处理改进

4. Windows 安装器（Squirrel）稳定性修复

• 修复 Squirrel 安装卡住：改用本地卸载图标资源
• 修补 Setup 日志按钮，并支持跨平台打开安装器日志
• 新增 prepareSquirrelVendor 脚本与相关测试

5. 修复原生打包与 E2E 隔离 (#741)

• 修复原生模块打包（afterPack / Squirrel nuspec 等），解决 Windows win/x64 与 win/arm64 构建失败
• 加强 E2E 路径与步骤定义的隔离，减少用例互相干扰
• Agent 定义保存队列化，避免并发保存竞态
• Git identity / worker 相关修复与单测补充
• 清理 .pnpmfile.cjs，同步依赖与 CI workflow

6. CI 与杂项

• Release App 并发组按分支隔离，避免不同分支互相取消 (#738)
• 依赖与 lockfile 同步更新

完整 PR / 提交列表

完整对比: https://github.com/tiddly-gittly/TidGi-Desktop/compare/v0.14.1...v0.14.2-prerelease2

Release Date: 2026-07-27 Tag Range: v0.14.1 → v0.14.2-prerelease2 Scope: 96 files changed, 4,331 insertions, 2,378 deletions

Table of Contents

1. Migrate Git Worker to Electron UtilityProcess (Crash Isolation)
2. Avoid Nested Git Repositories
3. Sub-Wiki Routing Info & Git Scope UI
4. Windows Installer (Squirrel) Stability Fixes
5. Fix Native Packaging and E2E Isolation
6. CI & Miscellaneous

1. Migrate Git Worker to Electron UtilityProcess (Crash Isolation) (#736)

Moved the Git Worker onto Electron UtilityProcess so Git-related crashes are isolated from the main process.

• Removed workerAdapter in favor of UtilityProcess lifecycle and IPC
• Updated Vite / Forge build config for the new worker packaging path
• Synced related Git / Wiki service interfaces

2. Avoid Nested Git Repositories (#737)

Fixes creating nested .git directories when adding a folder wiki inside an existing Git repo (#730):

• Detect an ancestor repository and reuse it instead of initializing a nested repo
• Added Git scope unit tests

3. Sub-Wiki Routing Info & Git Scope UI (#735)

• Added getTiddlerRoutingInfo for sub-wiki routing UI
• Strengthened routingUtilities / FileSystemAdaptor routing logic and tests
• Added Git repo scope item in workspace settings; clarified that workspace filters add to tag r

@ -0,0 +1,99 @@

发布日期：2026-07-21 基于标签：v0.14.0-1（GitHub Release v0.14.0） → v0.14.1 改动范围：5 个文件变更，新增 59 行，删除 38 行

目录

1. 升级内置 TiddlyWiki 至 5.4.1
2. Windows 安装器日志路径修复
3. 完整 PR / 提交列表

1. 升级内置 TiddlyWiki 至 5.4.1

将内置 TiddlyWiki 从 5.4.0 升级到 5.4.1（维护版，修复 5.4.0 引入的回归）。

主要上游修复包括：

• EventCatcher 在新窗口中使用时报错
• textarea 最小高度处理
• 解析树节点 source position 无效
• Freelinks 插件可靠性与准确性
• SelectWidget 多选问题
• Katex 插件缺失字体恢复
• 日语与波兰语翻译更新

2. Windows 安装器日志路径修复 (#731)

• 向应用上下文暴露 INSTALLER_LOG_FOLDER，便于定位安装器日志
• 补充 docs/ErrorDuringStart.md，说明 Windows 安装器日志按钮相关问题与排查方式

完整 PR / 提交列表

完整对比: https://github.com/tiddly-gittly/TidGi-Desktop/compare/v0.14.0-1...v0.14.1

Release Date: 2026-07-21 Tag Range: v0.14.0-1 (GitHub Release v0.14.0) → v0.14.1 Scope: 5 files changed, 59 insertions, 38 deletions

Table of Contents

1. Upgrade Built-in TiddlyWiki to 5.4.1
2. Windows Installer Log Path Fix
3. Complete PR / Commit List

1. Upgrade Built-in TiddlyWiki to 5.4.1

Upgraded the bundled TiddlyWiki from 5.4.0 to 5.4.1 (maintenance release fixing regressions from 5.4.0).

Notable upstream fixes:

• EventCatcher errors when used in new windows
• Textarea minimum height handling
• Invalid source positions in parse tree nodes
• Freelinks plugin reliability and accuracy
• SelectWidget multi-select issues
• Restored missing font in the Katex plugin
• Japanese and Polish translation updates

2. Windows Installer Log Path Fix (#731)

• Expose INSTALLER_LOG_FOLDER in app context for locating installer logs
• Document Windows installer log button issues and troubleshooting in docs/ErrorDuringStart.md

Complete PR / Commit List

Full Changelog: https://github.com/tiddly-gittly/TidGi-Desktop/compare/v0.14.0-1...v0.14.1

Full Changelog: https://github.com/tiddly-gittly/TidGi-Desktop/compare/v0.14.0-1...v0.14.1