综合介绍
AI 写作助手 是一个基于 Next.js 开发的开源 AI 写作助手,托管于 GitHub,旨在帮助作家、内容创作者和文案专业人员通过人工智能技术提升写作效率与质量。这个工具允许用户通过详细的提示词风格编辑器组织写作需求,并将指令发送给多种大型语言模型(LLM)生成内容。它支持主流的 API 接口如 OpenAI、Claude 和 Grok,并提供灵活的配置选项与用户友好的界面。无论是创作文章、调整语气还是导出 Markdown 文件,这个项目都为用户提供了高效的写作支持,是技术与创作结合的优秀范例。
功能列表
- 提示词风格定制:支持语言、结构、情感等多维度编辑,生成符合用户需求的文本。
- 多模型支持:兼容 OpenAI、Claude、Gemini 等多种 LLM API,满足不同场景需求。
- API 配置灵活:通过可折叠面板轻松设置 API 密钥和端点。
- 实时内容编辑:生成文本后可在内置编辑器中直接修改。
- Markdown 导出:一键将内容导出为 Markdown 格式,方便保存和分享。
- 调试信息查看:提供详细的 API 响应日志,便于排查问题。
- 主题切换:支持深色和浅色模式,适配用户偏好。
- 代理支持:内置代理功能,解决网络访问或 CORS 限制问题。
使用帮助
AI 写作助手 是一个开源工具,用户需要通过 GitHub 获取代码并在本地运行。以下是详细的安装和使用指南,帮助用户快速上手。
安装流程
要使用这个工具,你需要一定的技术基础,包括 Node.js 环境和 Git 操作。以下是具体步骤:
- 准备环境
- 确保电脑已安装 Node.js 16.20.0 或更高版本(下载地址:
https://nodejs.org/
)。 - 安装 Git 工具(下载地址:
https://git-scm.com/
),用于克隆代码。
- 确保电脑已安装 Node.js 16.20.0 或更高版本(下载地址:
- 获取项目代码
- 打开浏览器,访问
https://github.com/GeekyWizKid/writing-helper
。 - 点击绿色 “Code” 按钮,复制仓库地址:
https://github.com/GeekyWizKid/writing-helper.git
。 - 打开终端,输入以下命令克隆项目:
git clone https://github.com/GeekyWizKid/writing-helper.git
- 进入项目目录:
cd writing-helper
- 打开浏览器,访问
- 安装依赖
- 在终端中运行以下命令,安装项目所需依赖:
npm install
- 等待几分钟,直到所有依赖安装完成。
- 在终端中运行以下命令,安装项目所需依赖:
- 启动开发服务器
- 输入以下命令启动项目:
npm run dev
- 启动成功后,打开浏览器,访问
http://localhost:3000
,即可看到工具界面。
- 输入以下命令启动项目:
- 故障排查
- 如果启动失败,检查 Node.js 版本是否正确,或查看终端错误信息。
- 可访问 GitHub 的 “Issues” 页面,搜索类似问题或提交新问题求助。
主要功能操作
安装完成后,用户可以通过浏览器操作界面使用以下功能:
API 设置
- 打开设置面板:进入主页后,点击左侧 “API 设置” 按钮,展开配置面板。
- 选择模型:在下拉菜单中选择支持的 API(如 OpenAI、Claude、Grok 等)。
- 输入密钥:在对应字段中输入你的 API 密钥(需从相应平台获取,例如 OpenAI 官网)。
- 自定义端点:若使用代理或本地模型,可在 “API 基础 URL” 中输入自定义地址。
- 保存配置:点击 “保存” 或直接进入下一步,配置会自动生效。
内容设置与风格定制
- 设定主题:在 “文章主题” 输入框中填写创作目标,例如 “科技新闻稿”。
- 添加关键词:在 “关键词” 字段输入相关词,如 “人工智能, 技术趋势”,用逗号分隔。
- 目标字数:输入期望的字数,例如 500。
- 风格编辑器:
- 点击 “风格编辑器” 按钮,进入详细设置。
- 基本风格:输入整体描述,如 “简洁明了”。
- 语言风格:选择句型(短句为主)或修辞(如比喻)。
- 结构:设置段落长度(每段 3-5 句)和过渡方式(自然衔接)。
- 情感:调整基调(如积极乐观)。
- 保存后返回主界面。
生成与编辑内容
- 生成内容:点击 “生成内容” 按钮,等待几秒钟,右侧编辑器会显示生成结果。
- 实时修改:直接在编辑器中调整文本,例如删除冗余句子或添加细节。
- 导出文件:点击 “导出为 Markdown” 按钮,选择保存路径,文件将以
.md
格式下载。
调试与优化
- 查看日志:若生成失败,点击 “调试信息” 查看 API 响应详情,检查密钥或网络问题。
- 使用代理:若遇到 CORS 错误,在 API 设置中勾选 “使用代理服务器”,通过内置代理解决问题。
特色功能详解
- 多模型切换:
用户可随时切换模型,例如从 OpenAI 的 GPT-4 切换到 Grok,比较不同模型的生成效果。操作步骤:进入 API 设置,选择新模型,输入对应密钥,保存并重新生成。 - 风格深度定制:
风格编辑器是核心亮点。例如,设置叙述视角为 “第一人称”、情感基调为 “幽默轻松”、节奏为 “短句快节奏”,生成的内容会严格遵循这些要求。 - Grok API 测试:
若使用 Grok 模型,可访问http://localhost:3000/grok
路径,测试连接状态并查看详细响应日志。
使用建议
- 初次使用:建议先尝试 OpenAI 的 GPT-3.5-Turbo 模型,配置简单且响应快。
- 保存密钥:为避免重复输入,建议将 API 密钥记录在安全位置。
- 社区参与:若功能不够完善,可在 GitHub 提交 Pull Request,贡献代码或建议。
通过以上步骤,用户可以充分利用 AI 写作助手 的强大功能,无论是快速生成草稿还是深度定制内容,都能显著提升写作效率。