[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82099":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":15,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":17,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":14,"starSnapshotCount":14,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},82099,"MacArkPet","Wanduforl\u002FMacArkPet","Wanduforl","Unofficial GPL-3.0 native macOS desktop pet app inspired by Ark-Pets.",null,"JavaScript",150,1,26,0,48,121,8,0.9,"GNU General Public License v3.0",false,"main",true,[24,25,26,27,28,29],"appkit","arknights","desktop-pet","macos","spine","swift","2026-06-12 02:04:23","# MacArkPet\n\nMacArkPet is an unofficial native macOS desktop pet app for browsing and running\nArk-style Spine models as small interactive desktop characters.\n\nIt is inspired by Ark-Pets, but the macOS runtime is native Swift\u002FAppKit\u002FSwiftUI.\nThis repository is released under GNU GPL v3.0 to preserve license\ncompatibility with the upstream Ark-Pets project.\n\n## Project Statement\n\nMacArkPet borrows ideas from and is inspired by isHarryh's original Windows\n[Ark-Pets](https:\u002F\u002Fgithub.com\u002FisHarryh\u002FArk-Pets), especially its desktop-pet\nexperience and model ecosystem. This macOS version exists so more Arknights\nfans who only have a Mac, and do not have a Windows machine, can also enjoy a\nsmall operator desktop pet.\n\nThe upstream Ark-Pets project is licensed under GPL-3.0. In accordance with\nthat license, MacArkPet preserves the original project attribution and is\nreleased under the same GNU GPL v3.0 license.\n\n## Features\n\n- Native macOS launcher window with search, filters, preview, size, and speed controls\n- Transparent borderless desktop pet window\n- Spine\u002FWebGL model rendering through `WKWebView`\n- Walking, sitting, sleeping, interaction, and special-action states\n- Basic gravity and support surfaces for the desktop, Dock area, and window tops\n- Menu bar controls for launcher, click-through, always-on-top, reset position, and quit\n- Model sync from the community Ark-Models repository\n\n## Important Legal Note\n\nThis repository does not include Arknights game assets or model packages.\n\nMacArkPet can download community model resources at runtime, but those resources\nare not owned by this project. The Ark-Models README states that those materials\nbelong to Shanghai Hypergryph Network Technology Co., Ltd. and must not be used\ncommercially or in a way that harms the rights holder's interests.\n\nIf you publish forks, builds, or releases, do not bundle downloaded game\u002Fmodel\nassets unless you have permission from the relevant rights holders.\n\nMacArkPet is an unofficial fan-made project. It is not affiliated with,\nendorsed by, or maintained by Hypergryph, Yostar, the Ark-Pets maintainers, or\nthe Ark-Models maintainers.\n\nSpine runtime code is included under its own license. See\n`Resources\u002Fspine-ts-LICENSE`, `NOTICE.md`, `THIRD_PARTY_NOTICES.md`, and\n`docs\u002FLEGAL.md`.\n\n## Requirements\n\n- macOS 13 or later\n- Xcode command line tools or Xcode with Swift 5.9+\n\n## Player Guide\n\nDownload the app from GitHub Releases, unzip it, and move `MacArkPet.app` to\n`Applications`.\n\nIf macOS says Apple cannot check the app for malicious software, see the\nEnglish [User Guide](docs\u002FUSAGE.md). It also explains how to use `Sync Models`,\nthe bottom progress indicator, and the model library location:\n\n```text\n~\u002FLibrary\u002FApplication Support\u002FMacArkPet\u002FArkModels\n```\n\n## Run From Source\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FWanduforl\u002FMacArkPet.git\ncd MacArkPet\n.\u002Fscript\u002Fbuild_and_run.sh\n```\n\nThe first launch may show an empty or partial model list until you click\n`Sync Models`. During sync, the launcher footer shows a circular progress\nindicator with the percentage, current stage, and save location.\n\nFor local development with an existing Ark-Pets checkout, you may point the app\nat local assets:\n\n```bash\nARK_PETS_ASSETS=\u002Fpath\u002Fto\u002FArk-Pets\u002Fassets .\u002Fscript\u002Fbuild_and_run.sh\n```\n\n## Build A Release Zip\n\n```bash\n.\u002Fscript\u002Fpackage_release.sh\n```\n\nThe zip will be created under `release\u002F`, for example:\n\n```text\nrelease\u002FMacArkPet-0.1.0-macOS.zip\n```\n\nBy default the app is ad-hoc signed, not notarized. Players may need to right\nclick the app and choose `Open` the first time. For public distribution without\nGatekeeper friction, sign with a Developer ID certificate and notarize:\n\n```bash\nCODESIGN_IDENTITY=\"Developer ID Application: Your Name (TEAMID)\" .\u002Fscript\u002Fpackage_release.sh\n```\n\n## GitHub Release Flow\n\nThis repository includes GitHub Actions:\n\n- `CI` builds the Swift package on macOS.\n- `Release` runs on tags like `v0.1.0` and uploads the packaged zip to the GitHub Release.\n\nCreate a release tag:\n\n```bash\ngit tag v0.1.0\ngit push origin main --tags\n```\n\n## Controls\n\n- Left drag: move the desktop pet\n- Right click the pet or click the `AP` menu bar item: open the control menu\n- `Click Through`: let mouse clicks pass through the pet window\n- `Reset Position`: recover the pet if it is off-screen\n\n## Project Layout\n\n```text\nSources\u002FMacArkPet\u002F     Swift app source\nResources\u002F             App icon and Spine runtime\nscript\u002F                Build and release scripts\ndocs\u002F                  Usage and legal\u002Fdistribution notes\n```\n\n## License\n\nMacArkPet source code is released under the GNU General Public License v3.0.\nSee [LICENSE](LICENSE).\n\nThird-party runtime code and model resources remain under their respective\nlicenses and terms. This repository does not grant rights to Arknights game\nassets or community model resources downloaded at runtime.\n\nSee [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) and\n[docs\u002FLEGAL.md](docs\u002FLEGAL.md) before redistributing builds.\n","MacArkPet 是一款非官方的 macOS 桌面宠物应用程序，灵感来源于 Ark-Pets。它使用 Swift\u002FAppKit\u002FSwiftUI 构建，支持在桌面上浏览和运行基于 Spine 的互动模型角色。核心功能包括原生的启动器窗口、透明无边框的桌面宠物窗口、通过 `WKWebView` 渲染 Spine\u002FWebGL 模型、多种互动状态（如行走、坐着、睡觉等），以及基本的重力和支撑表面模拟。此外，还提供了菜单栏控制选项，方便用户进行操作。该应用适用于喜欢《明日方舟》且仅拥有 Mac 设备的玩家，让他们也能享受桌面宠物的乐趣。项目遵循 GNU GPL v3.0 许可协议。",2,"2026-06-11 04:07:44","CREATED_QUERY"]