写作工具

🍎 使用 Mac？跳转到 macOS（原生 Swift 移植）部分 → macOS

通过 AI 在全系统范围内即时校对和优化你的写作：

https://github.com/user-attachments/assets/d3ce4694-b593-45ff-ae9a-892ce94b1dc8

一键总结内容（网页、YouTube 视频、文档等）：

https://github.com/user-attachments/assets/76d13eb9-168e-4459-ada4-62e0586ae58c

添加你自己的按钮，释放无限可能！

✨ 什么是写作工具？

写作工具是一款受 Apple Intelligence 启发的跨平台应用，适用于 Windows、Linux 和 macOS，它通过 AI 大语言模型（云端或本地）来大幅提升你的写作效率。

只需按下一个热键，即可在全系统范围内修复语法、根据你的指令优化文本、总结内容（如网页、YouTube 视频等），以及执行更多操作。

目前，它是全球最智能的系统级语法助手，支持几乎所有语言，并已被🔥28+ 家全球媒体 报道（例如 Beebom、XDA、How-To Geek、Neowin、Windows Central...）。

此外，写作工具还跻身 GitHub 2024 年 10 月的 🔥全球十大热门 AI 项目。

---

大家好！我是来自班加罗尔的高中生 Jesai。在各位杰出贡献者的帮助下，我创建并维护着写作工具。特别要感谢为项目做出巨大贡献的 momokrono，以及完成了整个 macOS 移植工作的 Arya Mirsepasi！

写作工具将永远保持完全免费和开源。

如果你觉得它很有价值，希望你能继续支持我们，帮助我们不断改进。❤️

支持 Jesai（Windows/Linux）：	支持 Arya（macOS）：

---

⚡ 我究竟能用写作工具做什么？

1️⃣ 超智能写作工具：

• 在电脑上选择任意文本，然后按下 Ctrl+Space 调用写作工具。
• 选择“校对”、“改写”、“友好”、“专业”、“简洁”，或者输入自定义指令（例如：“给这段代码添加注释”、“首字母大写”、“翻译成法语”）。
• 文本会立即被 AI 优化后的版本替换。如果需要恢复原始文本，只需按下 Ctrl+Z 即可。

2️⃣ 强大的内容摘要功能，还能与之对话：

• 使用 Ctrl+A 选中任何网页、文档、邮件等内容中的全部文本，或者选择 YouTube 视频的字幕（从视频描述中获取）。
• 调用写作工具后，选择“摘要”、“要点”或“表格”。
• 你会看到一个格式清晰美观的弹出式摘要（支持 Markdown 渲染），帮你节省大量时间。
• 如果你想了解更多或有疑问，还可以直接与摘要进行对话。

3️⃣ 自定义专属按钮，随心所欲！

• 这些按钮就是你的魔法按键。只要你想得到什么效果，AI 都能帮你实现。

3️⃣ 随时随地一键与 LLM 对话：

• 不需选中文本，直接按下 Ctrl+Space，即可开始与你的 LLM 对话。（为了保护隐私，关闭窗口后聊天记录会被清除）

🌟 为什么选择写作工具？

除了它是唯一一款类似于 Apple Writing Tools 的 Windows/Linux 应用程序，也是在 Intel Mac 或欧盟地区使用类似功能的唯一途径之外：

• 比 Apple Writing Tools 和 Grammarly Premium 更智能： Apple 使用的是一个参数量仅为 30 亿的小型模型，而写作工具则允许你免费使用更先进的模型（例如 Gemini 2.0 Flash [约 300 亿参数]）。Grammarly 基于规则的 NLP 技术根本无法与 LLM 相提并论。
• 完全免费且开源： 无需订阅或支付任何隐藏费用。软件轻量无冗余，即使在使用时也仅占用约 0% 的 CPU 资源。
• 支持多种 AI 大语言模型： 你可以快速接入免费的 Gemini API 和 Gemini 2.0，也可以通过 Ollama [说明]、llama.cpp、KoboldCPP、TabbyAPI、vLLM 等丰富的本地 LLM，或者通过写作工具的 OpenAI API 兼容性连接到云端 LLM（如 ChatGPT、Mistral AI 等）。
• 不会干扰你的剪贴板，且可在全系统范围内运行。
• 注重隐私： 你的 API 密钥和配置文件都保存在你自己的设备上。绝不记录日志、收集诊断信息、追踪用户行为或投放广告。只有在你主动调用时才会运行。使用本地 LLM 时，数据完全保留在你的设备上，无需联网即可工作。
• 多语言支持： 支持所有语言，并且在文本翻译方面比 Google Translate 表现更好（只需在“描述你的修改…”中输入“翻译成[语言]”即可）。
• 代码支持： 你可以通过“描述你的修改…”来修复、优化、翻译代码，或为其添加注释。
• 主题、深色模式与自定义： 提供两种主题——模糊渐变主题和类似 Windows + V 快捷方式弹出框的简约主题！同时全面支持深色模式。你还可以自定义快捷键，以便快速访问。

✅ 1 分钟安装指南

🪟 Windows：

1. 访问 Releases 页面，下载最新的 Writing.Tools.zip 文件。
2. 将其解压到你想要的位置（推荐放在“文档”或“App Data/Local”目录下），然后运行 Writing Tools.exe，尽情享受吧！ :D

注意：写作工具是一款便携式应用。如果你将其解压到受保护的文件夹（如“Program Files”），至少在首次启动时需要以管理员身份运行，以便它能够创建或编辑自身的配置文件（位于与可执行文件相同的文件夹内）。

PS：前往写作工具的设置界面（通过任务栏右下角的托盘图标进入），启用开机自启动功能。

🐧 Linux（开发中）：

从源代码运行

Writing Tools 在 X11 上运行良好。但在 Wayland 上，有一些需要注意的地方：

• 它可以在 XWayland 应用程序上运行
• 如果你使用 Flatseal 为单个 Flatpak 禁用 Wayland，它也能正常工作。

🍎 macOS

macOS 版本是由 Arya Mirsepasi 开发的 原生 Swift 移植版。请查看 macOS 文件夹内的 README，以了解更多信息。

安装步骤如下：

1. 前往 Releases 页面，下载最新的 macOS .dmg 文件。
2. 打开 .dmg 文件，同时打开一个 Finder 窗口，将 writing-tools.app 拖入“应用程序”文件夹即可。完成！

注意：由于辅助功能 API 的要求，macOS 需要 14 或更高版本。

---

💎 为什么 macOS 移植版如此特别

• 真正原生：使用 Swift（必要时结合 SwiftUI 和 AppKit）构建，带来快速且精致的 Mac 体验。
• 私密且本地运行：在 Apple Silicon 设备上使用 MLX 运行 本地大语言模型 — 无需互联网连接。
• 富文本感知：校对功能会保留 RTF 格式（粗体、斜体、列表、链接），使文档外观保持不变，同时消除错误。
• 按你的流程定制：可以编辑和添加自定义命令，并分配快捷键。
• 多语言设计：应用界面支持 英语、德语、法语和西班牙语，而命令则适用于更多语言。
• 多种智能选择：可连接顶级提供商，也可完全使用本地模型——随时切换。
• 主题：提供多种主题（包括深色模式），以匹配你的桌面风格。

🧠 macOS 上的提供商与模型

• 云端：OpenAI、Google (Gemini)、Anthropic、Mistral、OpenRouter
• 本地：Ollama（通过兼容 OpenAI 的端点）以及 MLX on Apple Silicon，用于一流的低延迟本地推理。
• 你可以自由组合：将敏感内容留在本地使用 MLX 处理，而在需要更强大算力时再使用云端模型。

🖱️ macOS 上的系统级魔法

• 可在大多数 Mac 应用程序中使用——选中文本，调用 Writing Tools，即可立即进行 校对、改写、调整语气或 摘要。
• 无需选中文本，即可与你选择的模型进行 快速对话。

提示：如果快捷键与 Spotlight 或输入法切换冲突，请在 Writing Tools 中设置自定义热键，或者在 macOS 设置中调整： 系统设置 → 键盘 → 键盘快捷键（Spotlight / 输入法）。

🔐 macOS 首次启动权限

为确保完整功能，macOS 会提示你授予以下权限：

• 辅助功能（用于读取或替换选中文本）
• 屏幕录制（针对某些限制文本访问的应用）

你可以在 系统设置 → 隐私与安全性 中管理这些权限。

⚙️ macOS 的强大功能

• 命令编辑器：创建可重复使用的按钮来执行自定义提示，并分配快捷键。
• 模型灵活性：支持自定义 API 密钥，可根据任务切换提供商。
• 文档友好：RTF 保留型 校对 功能可保持格式不变。
• 本地化：UI 支持 EN/DE/FR/ES；命令也适用于多种语言。
• 主题支持：提供多种主题，包括深色模式。

🧩 macOS 故障排除

• 快捷键不起作用？ 更改 Writing Tools 中的快捷键，并确保没有其他功能使用相同的组合键（如 Spotlight 或输入法切换）。
• 在特定应用中无法替换文本？ 确保已为 Writing Tools 启用 辅助功能；对于某些应用，还需要 屏幕录制 权限。
• 本地模型有问题？ 确认 Ollama/MLX 模型正在运行，并且设置中的基础 URL 和模型名称正确。

---

👀 使用技巧

1️⃣ 根据 YouTube 视频的字幕总结视频内容：

https://github.com/user-attachments/assets/dd4780d4-7cdb-4bdb-9a64-e93520ab61be

2️⃣ 让 Writing Tools 在 MS Word 中更好地工作：Ctrl+Space 快捷键被映射为“清除格式”，会导致段落缩进丢失。以下是改进方法：

注：使用 Writing Tools 时，Word 的富文本格式（粗体、斜体、下划线、颜色等）将会丢失。而像 Obsidian 这样的 Markdown 编辑器则不存在这个问题。

https://github.com/user-attachments/assets/42a3d8c7-18ac-4282-9478-16aab935f35e

🔒 隐私政策

我坚信保护你的隐私至关重要。Writing Tools：

• 不会自行收集或存储你的任何写作数据。它甚至不收集通用日志，因此非常轻量且注重隐私。
• 允许你使用本地大语言模型，在设备上完全处理你的文本。
• 只有当你明确选择某个选项时，才会将文本加密后发送到选定的 AI 提供商。
• 仅会在你的设备本地存储你的 API 密钥。

注意：如果你选择使用基于云的大语言模型，请参考相应 AI 提供商的隐私政策和服务条款。

✨ 功能说明

• 校对：最智能的语法和拼写纠正工具。对不起 Grammarly Premium，但我们更好！
• 改写：优化你的文本措辞。
• 调整语气：将文本调整为友好或专业风格。
• 自定义指令：通过“描述你的修改……”来自定义请求（例如“翻译成法语”）。

以下选项会在弹出窗口中显示（支持 Markdown 渲染、文本选择以及可在应用重启时保存并应用的缩放级别）：

• 摘要：生成清晰简洁的摘要。
• 提取要点：突出最重要的内容。
• 创建表格：将文本转换为格式化的表格。提示：你可以将表格复制并粘贴到 MS Word 中。

🦙 （可选）Ollama 本地 LLM 使用说明 [适用于 Windows/Linux v7 及以上版本]：

以下说明适用于 Writing Tools Windows/Linux v7+，使用其原生 Ollama 提供者：

1. 下载 并安装 Ollama。
2. 从 这里 选择一个 LLM。推荐使用 Llama 3.1 8B（约需 8GB VRAM）。
3. 在终端中运行 ollama pull llama3.1:8b 下载模型。
4. 打开 Writing Tools 设置，直接选择 Ollama AI 提供者。默认模型名称已设置为 Llama 3.1 8B。
5. 完成！尽情享受 Writing Tools 带来的绝对隐私和无需联网的体验吧！ 🎉 从今以后，你只需在后台启动 Ollama 和 Writing Tools，它们就能正常工作。

🦙 （可选）Ollama 本地 LLM 使用说明：

这些说明适用于所有版本的 Writing Tools，使用 OpenAI 兼容提供商时适用：

1. 下载 并安装 Ollama。
2. 从 这里 选择一个 LLM。推荐：Llama 3.1 8B（约需 8GB 显存/内存）。
3. 在终端中运行 ollama pull llama3.1:8b 来下载 Llama 3.1。
4. 在 Writing Tools 中，设置 OpenAI 兼容 提供商，配置如下：
   • API 密钥：ollama（提示：对于大多数本地 LLM 提供商，此处填写任意随机字符串即可）
   • API 基础 URL：http://localhost:11434/v1
   • API 模型：llama3.1:8b
5. 就这样！尽情享受 Writing Tools 带来的_绝对_隐私和无网络连接体验吧！ 🎉 从今以后，你只需在后台启动 Ollama 和 Writing Tools 即可正常使用。

🐞 已知问题

1. （正在调查中）在某些设备上，Writing Tools 使用默认快捷键时无法正常工作。

   解决方法：将快捷键更改为 ctrl+` 或 ctrl+j，然后重启 Writing Tools。提示：如果某个快捷键已被其他程序或后台进程占用，Writing Tools 可能无法拦截该快捷键。上述快捷键通常未被使用。

2. 首次启动 Writing Tools.exe 时可能会耗时较长——这似乎是因为杀毒软件会在允许其运行前对这个新可执行文件进行深度扫描。一旦它在后台加载到内存中，就会像往常一样立即运行。

👨‍💻 直接从源代码运行 Writing Tools

说明在此！

👨‍💻 自行编译应用程序：

说明在此！

🌟 贡献者

如果没有这些出色的贡献者，Writing Tools 不可能发展到今天的水平：

🪟🐧 Windows & Linux 版本：

1. momokrono：

增加了对 Linux 的支持，切换到 pynput API 以提高 Windows 系统的稳定性。添加了 Ollama API 支持、可自定义按钮的核心逻辑以及多语言支持。修复了各种 bug，并通过处理 SIGINT 信号实现了优雅退出功能。

@momokrono 非常友善且乐于助人，我非常感激有他这样的贡献者。他不仅在代码方面给予了大量帮助，还在管理 GitHub 问题上发挥了重要作用。—— Jesai

2. Cameron Redmore (CameronRedmore)：

对 Writing Tools 进行了大规模重构，增加了 OpenAI 兼容 API 支持、流式响应功能以及未选中文本时的聊天模式。

3. Soszust40 (Soszust40)：

协助添加了深色模式、简洁主题、托盘菜单修复及 UI 改进。

4. Alok Saboo (arsaboo)：

帮助提升了文本选择的可靠性。

5. raghavdhingra24：

使圆角抗锯齿效果更佳，外观更加美观。

6. ErrorCatDev：

显著改进了关于窗口，使其可滚动并进行了清理。同时还优化了我们的 .gitignore 和 requirements.txt 文件。

7. Vadim Karpenko：

协助添加了开机自启设置！

🍎 macOS 版本：

由 Arya Mirsepasi 完全独立开发的原生 Swift 移植版！这是一项巨大的工程，他做得非常出色。

在多次邮件交流中，@Aryamirsepasi 一直是我非常敬佩的人，像他这样善良的人实属罕见。我们对他在这里的所有贡献都深表感谢！—— Jesai

1. Joaov41：

为 WritingTools 开发了 Gemini 中令人惊叹的图片处理功能，使应用现在不仅可以处理文本，还可以处理图像！

2. drankush：

修复了一个问题，该问题会导致当 OpenAI 提供商配置了自定义基础 URL 时（例如用于 Groq 或其他兼容服务），应用无法完成请求。

3. gdmka：

• 添加了一项更改，使 ResponseView 能够记住用户在每次启动应用时偏好的文本大小。
• 实现了为每个命令单独设置自定义提供商的功能。

🤝 贡献

我欢迎大家的贡献！:D

如果您想改进 Writing Tools，请随时提交 Pull Request 或与我联系（邮箱见下文）。

如果您有重大改动的想法，在动手之前先与我沟通可能会更好。

📬 联系方式

邮箱：jesaitarun@gmail.com

由一名高中生用心制作。请查看我的另一款应用 Bliss AI，一款免费的 AI 辅导工具！

📄 许可证

根据 GNU 通用公共许可证 v3.0 发布。

WritingTools 快速上手指南

WritingTools 是一款受 Apple Intelligence 启发的开源 AI 写作助手，支持 Windows、Linux 和 macOS。它允许用户在任何应用程序中通过快捷键调用 AI，实现语法校对、文本润色、内容摘要及自定义指令处理。

环境准备

系统要求

• Windows: 任意现代版本（便携版应用，无需安装）。
• macOS: macOS 14 (Sonoma) 或更高版本（需满足辅助功能 API 要求）。
• Linux: 推荐 X11 环境；Wayland 环境下需使用 XWayland 或通过 Flatseal 为特定 Flatpak 应用禁用 Wayland。

前置依赖与模型配置

本工具本身不内置模型，需配置以下任一 AI 服务：

1. 云端模型（推荐新手）:
   • Google Gemini API (免费额度可用)
   • OpenAI, Mistral AI, Anthropic 等（需自备 API Key）
2. 本地模型（注重隐私）:
   • Windows/Linux: 需预先安装 Ollama、llama.cpp 或 KoboldCPP。
   • macOS: 支持 Ollama 或原生 MLX (Apple Silicon 芯片专用)。

注意：若选择本地模型，请确保对应服务已在后台运行并可被访问。

安装步骤

🪟 Windows

1. 访问 Releases 页面 下载最新的 Writing.Tools.zip。
2. 将压缩包解压至目标文件夹（推荐 Documents 或 AppData/Local，避免直接放在 Program Files 以免权限问题）。
3. 双击运行 Writing Tools.exe。
4. （可选）右键点击任务栏托盘图标，进入设置开启“开机自启”。

🍎 macOS

1. 访问 Releases 页面 下载最新的 .dmg 文件。
2. 打开 .dmg 文件，将 writing-tools.app 拖入“应用程序”文件夹。
3. 首次启动时，系统会提示授权：
   • 辅助功能 (Accessibility)：用于读取和替换选中文本。
   • 屏幕录制 (Screen Recording)：部分受限应用需要此权限才能获取文本。
   • 设置路径：系统设置 → 隐私与安全性。

🐧 Linux

目前建议从源码运行：

git clone https://github.com/theJayTea/WritingTools.git
cd WritingTools
# 请参考仓库内详细文档安装 Python 依赖并启动

基本使用

1. 核心快捷键

• 唤起工具：选中任意文本后，按下 ctrl+space (macOS 可能需在设置中确认快捷键，避免与 Spotlight 冲突)。
• 直接对话：不选中文本，直接按下 ctrl+space 可开启与 LLM 的聊天窗口。

2. 常用功能示例

唤起工具后，弹出菜单提供以下预设操作：

• Proofread: 自动校对语法和拼写。
• Rewrite / Friendly / Professional: 根据语气重写文本。
• Summary / Key Points: 选中网页文章或视频字幕后，一键生成摘要或关键点列表。
• Custom Instructions: 在输入框中输入自定义指令，例如：
  • "translate to Chinese" (翻译成中文)
  • "add comments to this code" (为代码添加注释)
  • "make it title case" (转换为标题大小写)

3. 配置模型

点击任务栏托盘图标（或菜单栏图标）进入 Settings：

• Cloud Provider: 选择提供商（如 Google Gemini），填入 API Key。
• Local Provider: 若使用 Ollama，确保 Base URL 为 http://localhost:11434 并选择已拉取的模型名称。

4. 撤销操作

如果 AI 修改结果不满意，直接在原应用中按下 ctrl+z (macOS: cmd+z) 即可恢复原文本。