图文安装教程
手把手教你安装和配置，从获取软件到开始使用只需 5 分钟。
一、下载独立客户端
蛙趣拼文现已推出独立客户端，无需安装任何 IDE，下载即用。
获取客户端
购买成功后将通过 邮件 / 微信 发送专属下载链接及激活码，下载完成后双击安装包即可运行。
📬 已购买？请查收订单邮件，或联系客服（491145@qq.com）补发。
💡 安装说明
- 下载后双击安装包，一路点击"下一步"完成安装
- 安装完成后直接打开客户端即可使用
- 无需额外配置 IDE 或安装插件
二、插件安装（可选）
如需在 VS Code / Cursor 等 IDE 中使用，购买后将通过邮件 / 微信收到插件文件，按以下步骤安装。
安装步骤
1️⃣ 打开 IDE
打开已安装的 IDE，界面显示如下：
2️⃣ 获取插件文件
购买成功后，下载链接将通过邮件 / 微信发送给你，收到后下载 .vsix 压缩包并解压备用。
3️⃣ 安装插件
在 IDE 中：扩展 → 更多操作 → 从 VSIX 安装… → 选择解压好的插件文件
安装完成后，点击左侧小书本图标即可看到插件界面：
✅ 安装完成
插件安装后即可使用全部功能，输入购买时获得的激活码完成激活。
三、配置免费大模型（阿里云）
阿里云提供各大模型的免费使用，新用户 3 个月免费。
获取免费 API 密钥
3️⃣ 创建 API 密钥
在控制台中点击「密钥管理」→「创建」按钮即可生成密钥。
在软件中填写配置
https://dashscope.aliyuncs.com/compatible-mode/v1安装指南
按照以下步骤，3 分钟内完成安装并开始使用。
2) 安装运行
双击下载好的安装包，按指引完成安装后直接打开客户端即可使用。
支持主流操作系统，无需额外配置
3) 配置与激活
设置里填 API 配置 → 输入授权码（License Key）→ 在线验证后使用。
安装前准备
- 独立客户端：购买后通过邮件/微信获得专属下载地址，安装后无需 IDE 即可直接使用；也支持以插件方式在 VS Code 等 IDE 中使用（详见下方列表）
- API 服务：准备一个支持 OpenAI 格式的 API 服务（如 OpenAI、Azure、Anthropic 等）。
- API Key：从你的 API 服务商获取 API Key。
- 激活码：购买后通过邮件/微信获得激活码，在软件设置中填入即可完成激活。
支持的智能IDE列表
本插件支持 10+ 主流智能IDE，涵盖免费和付费选择：
✓ 免费智能IDE
- 微软 VS Code - 全球最受欢迎的开源编辑器，需要 1.85+ 版本
- 腾讯 CodeBuddy - 国内团队协作友好
- 字节 Trae - 抖音出品，轻量高效
- 阿里 Linma - 阿里云生态集成
- 谷歌 Antigravity - 免费 GEMINI 3 Pro（需网络支持，需梯子）
💎 付费智能IDE
- Cursor - AI 代码编辑器标杆
- 亚马逊 Kiro - AWS 开发者首选
- 更多... - 持续更新支持其他商业IDE
安装方式：所有支持的IDE都通过 扩展 → 更多操作 → 从 VSIX 安装... 统一安装，简单快捷。
3 分钟上手工作流
新用户一眼看懂：安装 → 配置 → 生成 → 管理一致性 → 迭代。
1) 安装与配置
安装 VSIX → 在设置里填写 API Key / Base / Model → 用"测试 API 连接"验证。
2) 生成与预览
选择节奏档位、走向约束与伏笔 → 生成章节 → 先预览再二改。
3) 管理一致性
小说世界观/角色/伏笔结构化维护 → 项目设定跟随剧情更新 → 长篇越写越稳。
进阶使用技巧
- 模板沉淀：将你满意的写作风格保存为模板，下次直接使用。
- 伏笔管理：提前规划伏笔，在生成时指定，让剧情更紧凑。
- 节奏控制：根据章节重要性调整节奏等级，高潮章节用高节奏。
- 多轮迭代：利用"生成→预览→二改"的闭环，逐步优化质量。
- 团队协作：共享模板和设定，保持团队文风统一。
常见问题（FAQ）
把用户最担心的三件事提前回答：配置、隐私、激活。
Q：API Key 会上传到你们服务器吗？
A：不会。API Key 存在本地智能IDE设置中，插件用它去调用你配置的外部 AI 服务。
Q：我不想把内容上传到云端怎么办？
A：你可以选择自己的 API 服务，并在自己的可控范围内使用；插件本身不强制云端存储。
Q：激活码丢了怎么办？
A：请提供订单信息或购买凭证联系支持，我们会协助找回授权码。
Q：支持哪些 AI 模型？
A：支持所有 OpenAI 格式兼容的 API 服务，包括 OpenAI、Azure、Anthropic、Claude 等。支持所有AI大模型
Q：生成的内容能用吗？
A：可以用，但AI生成的文章没有灵魂,需要你人工二改和润色。AI 是加速器，不是替代品。
Q：如何保证内容一致性？
A：通过世界观/角色/伏笔的结构化管理，让 AI 始终基于"当前版本的设定"生成。
Q：插件需要联网吗？
A：生成内容需要联网调用 AI API，本地数据存储不需要联网。
Q：如何更换 AI 模型？
A：在设置中修改 API 配置（API Key、Base URL、Model 名称），然后测试连接。
Q：数据保存在哪里？
A：所有创作数据保存在本地工作区，你可以自由备份、迁移和分享。
问题排查
遇到问题？这里有一些常见问题的解决方法。
常见问题及解决方案
问题：生成失败，提示 API 错误
解决方案：
- 检查 API Key 是否正确
- 检查 API 服务是否正常（访问服务商官网）
- 检查 Base URL 和 Model 名称是否正确
- 使用"测试 API 连接"功能验证配置
问题：授权验证失败（License Key 无效 / 已到期 / 设备数超限）
解决方案：
- 确认已正确填写 License Key（建议直接复制粘贴）
- 确认网络可访问授权服务器（企业网络/代理可能需要放行域名）
- 如提示设备数超限：联系支持解绑旧设备或升级设备数
- 如提示已到期：续费后重新验证即可生效
问题：生成速度慢
解决方案：
- 检查网络连接是否稳定
- 更换响应更快的 AI 模型
- 减少单次生成的字数
- 检查 API 服务是否有流量限制
问题：插件无法正常加载
解决方案：
- 检查智能IDE版本是否满足要求
- 重新安装插件
- 检查扩展面板的错误提示
- 重启智能IDE
学习资源
进一步了解如何使用蛙趣拼文。
官方文档
详细的功能说明和使用指南，帮助你充分发挥插件潜力。
视频教程
手把手教你如何使用各项功能，从基础到进阶。
社区交流
加入我们的用户社区，与其他创作者交流经验和技巧。
提示：你可以把仓库里的"安装测试指南/激活验证用户指南"提炼成官网的图文教程页（后续我也能帮你做）。