theJayTea/WritingTools

Writing Tools – 全系統AI驅動的寫作助手

是什麼 – 一個開源桌面應用程式，可在 Windows、Linux 或 macOS 的任意視窗中呼叫大型語言模型（LLM）。透過一個快速鍵，即可執行校對、重寫、語氣轉換、翻譯、總結網頁或 YouTube 字幕，甚至與模型對話。

為何重要 – 它將 Apple 為 macOS 提供的 AI 輔助寫作功能帶到了其他平台，並允許使用者在雲端 API（Gemini、OpenAI、Anthropic、Mistral 等）與透過 Ollama、llama.cpp、MLX 等執行的本地模型之間自由選擇。結果是，為 Grammarly Premium 等商業產品提供了一個免費且以隱私為先的替代方案。

---

核心功能（README中描述）

• 全系統快速鍵（預設為 Ctrl+Space）：在任何允許程式讀取/取代選中文本的應用中均有效。
• 校對 / 重寫 / 語氣轉換：可從內建指令（親切、專業、簡潔）中選擇，或輸入自訂指令（例如："為這段程式碼加入註解"，"翻譯成法語"）。
• 摘要工具包：從選中文本、網頁或 YouTube 影片字幕中生成純文字摘要、重點清單或 Markdown 表格。輸出以支援 Markdown 渲染的彈出視窗顯示。
• 臨時聊天：不選中文本時按下快速鍵可開啟聊天視窗；視窗關閉時歷史記錄將被清除。
• 自訂按鈕：使用者可定義自己的提示按鈕並分配快速鍵，將應用轉變為個人 AI 命令中心。
• 主題與介面：兩種視覺主題（漸層模糊或純 Windows-V 風格）、深色模式支援，以及可變更快速鍵的設定面板。
• 多語言支援：支援任意語言；翻譯由 LLM 處理。
• 程式碼感知：可改善、翻譯或為程式碼片段加入註解。

---

平台支援

平台	實作方式	特別說明
Windows	可攜式可執行檔（Writing Tools.exe）。無需安裝程式；解壓後直接執行。首次啟動需管理員權限以寫入設定檔。
Linux	從原始碼執行；X11 下開箱即用。Wayland 支援透過 XWayland 或使用 Flatseal 個別應用停用實現。
macOS	原生 Swift/SwiftUI 應用（writing-tools.app）。需 macOS 14+（需存取權限和螢幕錄製權限）。可在 Apple Silicon 裝置上使用MLX執行本地模型，實現裝置內推論。

---

模型與提供者彈性

• 雲端：透過免費 API 金鑰輕鬆使用 Gemini 2.0 Flash（約 30B 參數），以及 OpenAI、Anthropic、Mistral、OpenRouter 等。應用使用 OpenAI 相容介面，因此任何支援該協定的提供者均可使用。
• 本地執行：Ollama（Ollama 支援的任意模型）、llama.cpp、KoboldCPP、TabbyAPI、vLLM，以及在 macOS 上使用 MLX 框架執行 Apple Silicon 優化模型。README 推薦使用 Llama 3.1 8B（約 8GB VRAM/RAM）。
• 提供者切換在設定面板中完成；甚至可為不同指令分配不同提供者。

---

安裝（快速入門）

• Windows – 從 Releases 頁面下載最新 Writing.Tools.zip，解壓後執行 Writing Tools.exe。可選：透過系統匣圖示啟用「開機啟動」。
• Linux – 參考連結的 從原始碼執行 指南；X11 下可直接執行，Wayland 有替代方案。
• macOS – 從 Releases 下載 .dmg，將 writing-tools.app 拖入 應用程式 檔案夾。提示時授予存取權限（可選：螢幕錄製權限）。

---

隱私與安全

• 應用本身不進行任何遙測、日誌記錄或資料收集。
• API 金鑰和設定檔本地儲存在使用者裝置上。
• 僅當使用者明確觸發指令時，文字才會傳送至遠端提供者；否則本地模型將所有資料保留在裝置內。
• 聊天視窗在關閉時會丟棄其歷史記錄。

---

許可證與社群

• 許可證：GNU GPL v3 – 可自由使用、修改和分發。
• 貢獻者：核心 Windows/Linux 貢獻者包括 momokrono、CameronRedmore、Soszust40 等；macOS Swift 版本由 Arya Mirsepasi 編寫，另有其他多人協助。
• 支援：主維護者（Jesai）和 macOS 維護者的 Buy-me-a-coffee 連結。
• 媒體報導：README 列出了超過 30 家出版物，並在 2024 年 10 月被評為頂級趨勢 AI 倉儲。

---

哪些人可能受益？

• 需要快速修正語法或調整語氣，但又不想離開目前應用程式的寫作者、學生或專業人士。
• 希望即時加入程式碼註解或翻譯的開發者。
• 偏好以隱私為先解決方案，並希望擁有本地執行 LLM 選項的任何人。

---

總結：Writing Tools 是一款真正的跨平台 AI 輔助寫作工具，結合雲端與本地 LLM，提供廣泛自訂功能，並以開源許可證發行。