使用指南
从安装到进阶使用，这里有你需要的一切帮助信息。
安装指南
按照以下步骤，3 分钟内完成安装并开始使用。
2) 安装到智能IDE
选择任意支持的IDE：扩展 → 更多操作 → 从 VSIX 安装… → 选择文件。
支持 VS Code、CodeBuddy、Trae、Linma、Cursor、Kiro 等 10+ 智能IDE
3) 配置与激活
设置里填 API 配置 → 输入授权码（License Key）→ 在线验证后使用。
安装前准备
- 智能IDE：支持 10+ 主流智能IDE（详见下方支持的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：所有创作数据保存在本地工作区，你可以自由备份、迁移和分享。
更多问题？
如果以上 FAQ 没有解答你的问题，欢迎通过以下方式联系我们：
- 邮箱：491145#qq.com
- 微信/QQ 群：购买后加微信群
我们会在 24 小时内回复你的问题。
问题排查
遇到问题？这里有一些常见问题的解决方法。
常见问题及解决方案
问题：生成失败，提示 API 错误
解决方案：
- 检查 API Key 是否正确
- 检查 API 服务是否正常（访问服务商官网）
- 检查 Base URL 和 Model 名称是否正确
- 使用"测试 API 连接"功能验证配置
问题：授权验证失败（License Key 无效 / 已到期 / 设备数超限）
解决方案：
- 确认已正确填写 License Key（建议直接复制粘贴）
- 确认网络可访问授权服务器（企业网络/代理可能需要放行域名）
- 如提示设备数超限：联系支持解绑旧设备或升级设备数
- 如提示已到期：续费后重新验证即可生效
问题：生成速度慢
解决方案：
- 检查网络连接是否稳定
- 更换响应更快的 AI 模型
- 减少单次生成的字数
- 检查 API 服务是否有流量限制
问题：插件无法正常加载
解决方案：
- 检查智能IDE版本是否满足要求
- 重新安装插件
- 检查扩展面板的错误提示
- 重启智能IDE
学习资源
进一步了解如何使用蛙趣拼文。
官方文档
详细的功能说明和使用指南，帮助你充分发挥插件潜力。
视频教程
手把手教你如何使用各项功能，从基础到进阶。
社区交流
加入我们的用户社区，与其他创作者交流经验和技巧。
提示：你可以把仓库里的"安装测试指南/激活验证用户指南"提炼成官网的图文教程页（后续我也能帮你做）。