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，提供广泛自定义功能，并以开源许可证发布。