開發者文件

開發者文件

SnapTray 的技術文件主入口,集中整理建置、打包、架構與除錯整合資訊,不再把 GitHub README 撐成長文總表。

這裡是 SnapTray 技術文件的主入口。根 README 會保持產品導向;原本放在 README 與 AGENTS 的技術長文,現在集中整理於此。

這裡收錄什麼

  • 從原始碼建置:前置需求、腳本、手動 CMake 流程、快取工具與本地建置排錯
  • 發佈與打包:DMG / NSIS / MSIX 打包、簽章、公證、Store 提交流程與圖示資產
  • 架構總覽:專案結構、library 邊界、架構模式、平台對照與開發慣例

受眾分工

  • GitHub README:產品著陸頁、下載入口與高階工作流概覽
  • /docs/*:使用者教學、功能參考、疑難排解、FAQ 與 CLI 使用方式
  • /developer/*:貢獻者與 agent 需要的技術參考

真實來源原則

  • 產品介紹與價值主張放在 README 與網站首頁
  • 使用者操作細節放在 /docs/*
  • 建置、打包、架構、debug-only 整合資訊放在 /developer/*
  • AGENTS.md 只保留精簡操作索引,避免重複維護會漂移的長清單

建議閱讀順序

  1. 從原始碼建置
  2. 架構總覽
  3. 發佈與打包

相關使用者文件