桌面应用【免费下载链接】itch The best way to play your itch.io games项目地址https://gitcode.com/gh_mirrors/it/itch点击查看免费下载本文以 itch 仓库的 README 为主体系统讲解 itchitch.io 官方桌面客户端的整体架构Electron 主进程/渲染进程分工、Go 守护进程 butler 与 itch-setup 的职责、butlerd JSON-RPC 协议绑定以及 broth 组件版本管理系统的版本选择与升级流程。读完你可以独立完成 itch 的本地开发npm start起服务、理解 butler 版本如何被自动选取与校验并会跑集成测试、区分 itch/kitch 双变体。项目定位与三大组件itch 的目标是提供一个桌面应用用于下载并运行 itch.io 上的游戏同时支持游戏更新与更新提醒。项目明确声明其定位不是替代 itch.io 网站而是作为游戏的本地管理入口。从 README 给出的架构图可以清晰看到itch 由三个协同工作的组件构成┌─────────────────────────────────────────────────────────────┐ │ itch (Electron App) │ │ ┌─────────────────────┐ ┌────────────────────────────┐ │ │ │ Main Process │ │ Renderer Process │ │ │ │ (Node.js) │◄──►│ (React) │ │ │ │ │ │ │ │ │ │ • State (Redux) │ │ • UI components │ │ │ │ • Reactors │ │ • User interactions │ │ │ │ • Process mgmt │ │ • State display │ │ │ └──────────┬──────────┘ └────────────────────────────┘ │ └─────────────┼───────────────────────────────────────────────┘ │ TCP/RPC ▼ ┌─────────────────────────────┐ ┌───────────────────────────┐ │ butler │ │ itch-setup │ │ (Go daemon) │ │ (Go executable) │ │ │ │ │ │ • Game downloads/installs │ │ • App installation │ │ • Launch management │ │ • Self-updates │ │ • SQLite database │ │ │ └─────────────────────────────┘ └───────────────────────────┘ ▲ ▲ └──────── broth.itch.zone ─────┘ (binary distribution)三个组件的分工如下itch本仓库Electron 应用多进程架构。Main ProcessNode.js负责状态管理Redux、业务逻辑、与 butler/itch-setup 的协调采用 reactor 模式处理 Redux action 带来的副作用Renderer Process 是基于 React 的 UI状态通过 electron-redux 从主进程同步。butler一个 Go 守护进程负责全部游戏操作——下载、安装、更新、启动游戏维护 SQLite 数据库存储安装数据通过基于 TCP 的 RPC 与 itch 通信。它被 itch 作为子进程启动生命周期与 itch 绑定。itch-setup一个 Go 可执行文件负责应用本身的安装与自更新包括各平台的初始安装、自更新检查与重启。主进程与 butler 的衔接在源码中非常直接make-butler-instance.ts 通过itchio/butlerd包提供的Instance启动 butler 二进制启动参数包括--dbpathSQLite 库路径、--address、--user-agent以及关键的--destiny-pid——传入 itch 主进程的 PID用于把 butler 的生命周期“拴”在 itch 上。开发模式下还会追加--log开启日志。开发快速上手以下命令继承自 README 的 Development Quick Start是当前仓库package.jsonscripts 中已确认存在的脚本# Install dependencies npm install # Start the app in development mode (watches for changes and rebuilds) npm start # Type check the project npm run ts-check # Build assets npm run compile # Use a local/development version of butler instead of the bundled one BROTH_USE_LOCALbutler npm start结合 package.json 中的脚本定义与 develop.mjs 的实现可以补充几点实操细节npm start实际执行node develop.mjs先用 esbuild 分别构建 main 与 renderer 两个 bundle写入dist/目录并生成 metafile然后进入 watch 模式监听变更最后以--inspect9222启动 Electron。设置ITCH_BREAK1时会改用inspect-brk即启动时断点等待调试器附加。npm run ts-check拆分为ts-check:apptsc -b覆盖 main/preload/renderer 三套 tsconfig与ts-check:releasetsc -p release检查 release 打包脚本的类型。BROTH_USE_LOCAL是 broth 系统的开发覆盖开关从 package.ts 的源码看该环境变量按逗号分隔解析process.env.BROTH_USE_LOCAL.split(,)因此也可以同时指定多个组件例如BROTH_USE_LOCALbutler,itch-setup。启用后ensure流程会跳过下载直接通过which在PATH中查找本地二进制并用-V打印版本。npm run compile以NODE_ENVproduction执行生产构建npm test运行unit-tests.mjs中的单元测试。注意一个容易踩坑的点本仓库package.json的name字段是kitch因此本地开发启动的始终是 kitchcanary变体详见下文双变体一节。butlerd自动生成的 JSON-RPC 绑定itch 与 butler 之间的通信协议叫butlerd是一个 JSON-RPC 2.0 协议。所有 RPC 请求、通知和数据类型的 TypeScript 定义集中在 messages.ts当前约 6000 行该文件由工具generous从 butler 仓库itchio/butler的 Go 类型定义自动生成——文件头部注释也标明了 These bindings were generated by generous。从源码结构看整个绑定链路是generous 解析 Go struct 及其注释注解如name、category、caller在ts模式下产出 TypeScript 接口、枚举以及 request/notification 辅助函数生成的 messages.ts 从 npm 包itchio/butlerd导入createRequest和createNotification辅助函数itchio/butlerd在 package.json 中版本为^15.0.0提供运行时能力启动 butler 守护进程、经 TCP 连接、收发 JSON-RPC 消息。makeButlerInstance得到的Instance上通过getEndpoint()拿到端点再new Client(endpoint)发起调用——例如 formulas.ts 中的 sanity check 就是启动 butler 后立即调用messages.VersionGet验证其可用性。当 butler 的 API 发生变化时重新生成绑定的方式README 与package.json的sync-butler脚本一致# Requires the butler repo checked out as a sibling directory (../butler) npm run sync-butler该脚本实际执行为cd ../butler go run ./butlerd/generous ts ../itch/src/common/butlerd/messages.ts随后用 prettier 格式化。生成的messages.ts需要提交回本仓库。brothGo 组件的版本管理系统broth 是 itch 用来自动管理 butler 与 itch-setup 版本的分发系统本质上是一个代理 itch.io API 的服务为应用相关的二进制提供固定 URL的下载端点。远端分发 URL二进制托管在https://broth.itch.zone/{package}/{platform}/{version}形式的路径下urls.ts 中brothRepo常量即为https://broth.itch.zone。平台标识采用 Go 风格的{os}-{arch}如linux-amd64、darwin-arm64、windows-386——platform.ts 的platformString()会做 Node 到 Go 的映射win32→windows、x64→amd64、ia32→386。本地存储布局manager.ts 中 broth 前缀为join(app.getPath(userData), broth)例如 Linux 上 itch 稳定版为~/.config/itch/broth/broth/ ├── butler/ │ ├── versions/{version-hash}/butler # Extracted binary │ ├── downloads/ # Temporary during download │ └── .chosen-version # Currently active version └── itch-setup/ └── [same structure]Manager 管理的包列表是[appName, butler, itch-setup]其中 appName 对应SelfPackageitch 自身butler 与 itch-setup 对应 Package 类。注意但ler 在 formula 中标记了requiredAtStartup: true即启动时没有有效版本就必须安装itch-setup 则允许启动时跳过、后续再补齐。版本选择semver 约束版本约束集中定义在 formulas.ts。README 表格中给出的示例为 butler^15.20.0、itch-setup^1.8.0以当前仓库源码为准getSemverConstraint()实际返回的是 butler^15.32.0源码注释标明 15.32.0 引入Collections.*系列请求与 itch-setup^1.8.0且仅在非 canary 下生效——canary 直接返回null。package.ts 的getLatestVersion()实现了两种选择策略有 semver 约束stable请求{baseURL}/versions端点得到按新到旧排序的版本列表用semver.satisfies挑选第一个满足约束的版本找不到则报错无约束canary请求{baseURL}/LATEST端点取返回的最新版本号。canary 的-head通道由 formula 的transformChannel实现env.isCanary为真时把通道linux-amd64改写为linux-amd64-headbutler 与 itch-setup 两个 formula 共用同样的逻辑。升级流程doUpgrade()的实现与 README 描述的四步升级流程一一对应可以补充更多源码细节校验已选版本ensure()先读.chosen-version标记文件若存在则验证该版本目录下的.installed标记isVersionValid有效则直接复用避免重复下载检查新版本拉取最新版本号若与当前激活版本相同则跳过下载与解压从{baseURL}/{version}/{name}.zip下载downloadToFileWithRetry带重试随后用 unzip.ts 解压。解压基于 yauzl 流式逐条目写入每个条目写入后chmod 0o755并逐文件用 zlib 的 CRC32 与 zip 条目记录比对不匹配则删除该文件并抛错——这就是 README 提到的 CRC32 verification落地与清理写入.installed安装标记、更新.chosen-version再调用 formula 的postSwitch钩子itch-setup 用它执行--appname {name} --sync-launcher把新二进制同步到 shim/快捷方式指向的稳定位置最后清空 downloads 目录并清理旧版本。整个过程的阶段assess/download/install/idle与进度下载占 30%、解压占 30% 权重都会通过 Redux action 派发到 store供 UI 展示安装进度。itch 与 kitch双变体机制代码库同时支持两个应用变体itchstable和kitchcanary二者可并行安装。区分依据是构建时使用的 git tag——以-canary结尾的 tag如v0.1.2-canary产出 kitch否则产出 itch。变体的判定时机构建时release/common.js 从GITHUB_REF_NAME读取 tag非 tag 环境回落到v9999.0.0-canary因此本地构建天然落在 canary 通道getAppName()通过正则/-canary$/判定应用名。由于package.json的name字段默认就是kitch本地开发npm start始终运行在 kitch 模式生产打包时才为非 canary 构建把 name 覆写为itch。运行时src/common/env.ts 的isCanary逻辑非常直接——app.getName() kitch。src/main/env.ts 在此基础上派生出env.isCanary、env.appNamekitch或itch与env.channelcanary或stablebroth 的通道改写与 semver 约束全部依赖这两个值。关键差异Areaitch (stable)kitch (canary)URL protocolsitchio://、itch://仅生产kitchio://、kitch://Broth channels常规通道如darwin-amd64-head后缀如darwin-amd64-headSemver constraints当前源码butler^15.32.0、itch-setup^1.8.0无约束总是最新macOS bundle IDio.itch.macio.kitch.macTray/window iconsitch.png、window/itch/kitch.png、window/kitch/Binary/artifact nameitchkitch上表各行都能在源码中找到对应macOS bundle ID 由 release/common.js 的appBundleId()拼出io.${getAppName()}.macURL 协议在 register-shell-protocol.ts 与 preboot.ts 中按env.appName分别注册图标文件则位于 README 表格列出的src/static/images/对应目录图标资源同时见 release/images/ 下的打包用图标集。集成测试仓库内置一套用 Go 编写的集成测试通过 ChromeDriver 控制 Electron 应用覆盖登录、安装游戏、UI 导航等用户流程入口在 integration-tests/main.go 与 flow-all.go。前置条件Go测试运行器为 Go 编写需先编译release/packaging/test.js 会执行go build -o runner -v桌面环境测试需要显示器Linux CI 上使用xvfb-run -a -s -screen 0 1280x720x24运行itch.io API key使用专用测试账号itch-test-account的 API key 完成鉴权。ChromeDriver 版本匹配集成测试下载特定版本的 ChromeDriver它必须与应用所用 Electron 版本匹配。如果更新了package.json中的 Electron 版本必须同步更新 integration-tests/versions.goconst electronVersion 44.5.1 // Must match package.json electron version const chromeDriverVersionString ChromeDriver 152.0.7977.130 // Chrome version for that Electron当前仓库中 Electron 为^44.5.1与 versions.go 保持一致。确定某 Electron 版本对应的 Chrome 版本时可查阅 Electron 官方发布页。运行测试# Set the API key for the test account (itch-test-account) export ITCH_TEST_ACCOUNT_API_KEYyour-api-key # Run integration tests against a packaged build npm run integration-tests # Run against the development version (faster iteration, no packaging step) node release/test.js --test-dev # Run fresh (clear cached chromedriver and test artifacts) rm -rf integration-tests/.chromedriver integration-tests/tmp integration-tests/screenshots node release/test.js --test-dev从 release/packaging/context.js 的参数解析看node release/test.js还接受--os、--arch、--detect-osarch参数npm run integration-tests即node release/test.js --detect-osarch的封装自动识别本机操作系统与架构。--test-dev模式下会清除ITCH_INTEGRATION_BINARY_PATH环境变量直接测试开发版应用否则该变量指向打包产物路径artifacts/{os}-{arch}/下的{appName}或 macOS 的{appName}.app/Contents/MacOS/对生产构建进行测试。核心文件索引主题文件开发启动esbuild watch Electrondevelop.mjsbroth 管理器与包注册src/main/broth/manager.tsbutler / itch-setup 公式通道、约束、sanity checksrc/main/broth/formulas.ts版本选择、下载、升级、清理src/main/broth/package.tsCRC32 校验解压src/main/broth/unzip.ts平台标识Go 风格 os-archsrc/main/broth/platform.tsbutlerd TypeScript 绑定自动生成src/common/butlerd/messages.tsbutler 进程启动src/main/butlerd/make-butler-instance.tsitch/kitch 运行时判定src/common/env.ts构建时变体判定tag 解析release/common.js集成测试入口与版本常量integration-tests/main.go、integration-tests/versions.go集成测试编排release/test.js、release/packaging/test.jsitch 采用 MIT License 发布完整条款见 LICENSE。其架构的核心思路值得借鉴UI 层Electron React Redux与游戏引擎层Go 守护进程通过稳定的 JSON-RPC 契约解耦契约由 generous 从 Go 类型自动生成从而避免手工同步而 broth 系统则用“semver 约束 固定 URL 分发 CRC32 校验 安装标记”这套组合把第三方 Go 组件的版本演进完全自动化stable 与 canary 双通道并行。赞分享桌面应用【免费下载链接】itch The best way to play your itch.io games项目地址https://gitcode.com/gh_mirrors/it/itch点击查看免费下载相关推荐PrivateGPT向量数据库深度解析Qdrant配置、Embedding选型与维度避坑PrivateGPT向量数据库深度解析Qdrant配置、Embedding选型与维度避坑 PrivateGPT 是一个运行在本地模型上的完整 AI API 层人工智能大模型RAG本地部署LLM 网关后端Nextcloud桌面客户端3.16.5版本深度解析Nextcloud桌面客户端3.16.5版本深度解析 Nextcloud桌面客户端是一款开源的云存储同步工具它允许用户在本地计算机和Nextcloud服务器之桌面应用Nextcloud桌面客户端3.15.3版本深度解析Nextcloud桌面客户端3.15.3版本深度解析 Nextcloud是一款开源的私有云存储解决方案其桌面客户端允许用户在本地计算机与Nextcloud服务桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
