# superun Documentation

> superun is an AI-powered builder for apps and web, from prompt to publish with code and visual editing. Complete documentation for superun features, integrations, tips & tricks, and use cases.

## Documentation

- [Feature Announcements](https://docs.superun.ai/superun/announcements/features): Record important feature launches and capability upgrades, e.g. manual editing, team workspace, Task Center, social features.
- [Announcements](https://docs.superun.ai/superun/announcements/index): Unified notices for important changes, billing updates, breaking changes, downtime, and security events.
- [Integration Announcements](https://docs.superun.ai/superun/announcements/integrations): Record important third-party integration changes: office platforms, voice services, skill library, API changes.
- [Maintenance Announcements](https://docs.superun.ai/superun/announcements/maintenance): Record service downtime, upgrade maintenance, performance optimization, and outage announcements.
- [Billing Announcements](https://docs.superun.ai/superun/announcements/pricing): Record important billing-related changes: pricing rules, top-up plans, refund policies, and payment channels.
- [Security Announcements](https://docs.superun.ai/superun/announcements/security): Record account security, data compliance, privacy policy, and security event announcements.
- [变更日志](https://docs.superun.ai/superun/changelog): 来自 superun 工程团队的消息.
- [AI功能使用指南](https://docs.superun.ai/superun/detailed-tips-modules/ai-features-guide): AI功能的使用技巧和问题解决方案.
- [音效播放问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/audio-playback-guide): 音效播放相关问题的解决方案.
- [对话功能问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/chat-function-guide): 对话功能相关问题的解决方案.
- [superun 文件存储使用指南](https://docs.superun.ai/superun/detailed-tips-modules/cloud-storage-guide): superun 文件存储的使用技巧和问题解决方案.
- [咨询功能使用指南](https://docs.superun.ai/superun/detailed-tips-modules/consultation-guide): 咨询功能的使用技巧和问题解决方案.
- [代币使用指南](https://docs.superun.ai/superun/detailed-tips-modules/credits-guide): 代币使用技巧和问题解决方案.
- [资料库问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/database-guide): 资料库相关问题的解决方案.
- [部署问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/deployment-guide): 部署相关问题的解决方案.
- [设计编辑器使用指南](https://docs.superun.ai/superun/detailed-tips-modules/design-editor-guide): 设计编辑器的使用技巧和问题解决方案.
- [开发工具使用指南](https://docs.superun.ai/superun/detailed-tips-modules/dev-tools-guide): 开发工具的使用技巧.
- [域名绑定与SEO问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/domain-seo-guide): 域名绑定和SEO相关问题的解决方案.
- [邮件服务配置指南](https://docs.superun.ai/superun/detailed-tips-modules/email-service-guide): 邮件服务配置技巧,包括 Resend 和 SMTP 配置.
- [字体与样式修改问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/font-style-guide): 字体和样式修改相关问题的解决方案.
- [功能修复问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/function-fix-guide): 功能修复反复失败相关问题的解决方案.
- [通用问题解决流程指南](https://docs.superun.ai/superun/detailed-tips-modules/general-troubleshooting-guide): 遇到问题时的标准解决流程.
- [图片上传使用指南](https://docs.superun.ai/superun/detailed-tips-modules/image-upload-guide): 图片上传和替换的使用技巧和问题解决方案.
- [邀请奖励指南](https://docs.superun.ai/superun/detailed-tips-modules/invite-reward-guide): 了解 superun 邀请注册奖励机制，包括两种奖励模式和邮箱注册方式。
- [知识库管理使用指南](https://docs.superun.ai/superun/detailed-tips-modules/knowledge-base-guide): 知识库管理的使用技巧.
- [登录/身份验证问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/login-auth-guide): 登录和身份验证相关问题的解决方案.
- [移动端使用指南](https://docs.superun.ai/superun/detailed-tips-modules/mobile-guide): 移动端使用技巧和问题解决方案.
- [网络问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/network-guide): 网络异常和任务卡住相关问题的解决方案.
- [办公插件配置指南](https://docs.superun.ai/superun/detailed-tips-modules/office-plugin-guide): 配置企业微信、飞书、钉钉插件，将 superun 项目与办公平台无缝集成。
- [页面显示问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/page-display-guide): 页面显示异常相关问题的解决方案.
- [支付问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/payment-guide): 支付相关问题的解决方案.
- [预览窗口问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/preview-window-guide): 预览窗口相关问题的解决方案.
- [项目规划与提示编写指南](https://docs.superun.ai/superun/detailed-tips-modules/project-planning-guide): 项目规划技巧和提示编写方法,包括需求澄清、风格选择、演示版本、研发阶段等.
- [砍一刀社交玩法指南](https://docs.superun.ai/superun/detailed-tips-modules/share-cut-guide): 通过砍一刀活动邀请好友帮砍代币，了解完整的分享和领取流程。
- [语音引擎配置指南](https://docs.superun.ai/superun/detailed-tips-modules/speech-engine-guide): 语音转文字（ASR）和文字转语音（TTS）引擎接入说明.
- [风格生成与「再来一批」指南](https://docs.superun.ai/superun/detailed-tips-modules/style-generation-guide): 掌握风格选择和定向生成技巧，精准获取你想要的设计风格。
- [系统更新问题解决指南](https://docs.superun.ai/superun/detailed-tips-modules/system-update-guide): 系统更新相关问题的解决方案.
- [团队管理指南](https://docs.superun.ai/superun/detailed-tips-modules/team-management-guide): 从创建团队到分配额度，全面掌握 superun 团队协作功能。
- [版本管理使用指南](https://docs.superun.ai/superun/detailed-tips-modules/version-management-guide): 版本管理的使用技巧和问题解决方案,包括版本历史、回滚等.
- [检修](https://docs.superun.ai/superun/features/auto-fix): 在预览阶段检修常见问题 — 不需要消耗任何 Credits.
- [免费咨询](https://docs.superun.ai/superun/features/chat-mode): 免费咨询 superun AI 助手,了解您的项目而不进行任何改动.
- [代码模式](https://docs.superun.ai/superun/features/code-mode): 在构建标签页中切换到代码模式,直接查看项目代码.
- [自定义域](https://docs.superun.ai/superun/features/custom-domain): 将自定义域名绑定到您的 superun 项目以进行品牌推广和 SEO;设置Step和常见问题解答.
- [设计选项](https://docs.superun.ai/superun/features/design-options): 在建立完整界面前探索多种设计选项——superun 会生成四个设计选项供你选择.
- [可编辑的设计](https://docs.superun.ai/superun/features/editable-design): superun 中的全页可视化编辑 — 可视化编辑任何元素;Boxify 需要消耗积分,其他编辑是免费的.
- [项目功能列表](https://docs.superun.ai/superun/features/feature-list): 项目功能列表会依据你的项目内容自动生成建议清单,协助补齐细节,完善产品结构,并可一键启用所需能力,让项目为正式上线做好准备.
- [GEO (AI & Search Visibility)](https://docs.superun.ai/superun/features/geo): Check and improve your published site’s discoverability, metadata, and how well it can be understood and cited by major AI models. One-click optimization with the Agent, with post-publish re-checks.
- [图片上传](https://docs.superun.ai/superun/features/image-upload): 在对话中上传图片,协助 superun 更准确理解你的需求与意图.
- [定制知识](https://docs.superun.ai/superun/features/knowledge): 提供长期项目背景（目标,规则,资产）以可靠地指导 superun.
- [手动编辑](https://docs.superun.ai/superun/features/manul-edit): 在不改动程序码的前提下,通过「手动编辑（Manul Edit）」以所见即所得的方式微调单一页面的布局,样式与文案,并选择应用或放弃这次修改.
- [superun 模式](https://docs.superun.ai/superun/features/modes): 了解 superun 的模式——代理自主与引导式聊天和视觉/代码编辑——以更快,更可靠的方式构建.
- [私人项目](https://docs.superun.ai/superun/features/private-projects): 在 superun 中控制项目可见性 — 公共与私人,安全说明和计划可用性.
- [想法建立](https://docs.superun.ai/superun/features/prompt-question): 了解 superun 如何通过引导式问题,更深入理解你的产品想法.
- [发布](https://docs.superun.ai/superun/features/publish): 发布您的 superun 项目,安全共享并连接自定义域.
- [安全](https://docs.superun.ai/superun/features/security): 安全性与合规性（superun）
- [版本历史回滚](https://docs.superun.ai/superun/features/version-history): 管理并还原项目的先前版本——查看版本历史,使用版本历史回滚功能一键还原任何先前的状态.
- [superun AI](https://docs.superun.ai/superun/integrations/ai): superun AI 让你轻松将 GPT-4,Claude,Gemini 等强大 AI 模型整合到 Web 应用中,支持智慧聊天机器人,内容生成,表单处理,多语言翻译等能力,并通过统一的 Credits 代币系统计费.
- [superun 云计算](https://docs.superun.ai/superun/integrations/cloud): 无需构建复杂的应用程序
- [Custom SMS Provider](https://docs.superun.ai/superun/integrations/custom-sms-provider): Implement custom SMS provider using Supabase Auth Hooks
- [钉钉插件](https://docs.superun.ai/superun/integrations/dingtalk): 在 superun 中接入钉钉登录、企业成员校验与文档能力的总览说明。
- [常见问题解答](https://docs.superun.ai/superun/integrations/faq): 有关 superun 功能,工作流程,数据,安全性和策略的常见问题的解答.
- [飞书插件](https://docs.superun.ai/superun/integrations/feishu): superun 飞书插件介绍：它能做什么、为什么值得用、如何开始。
- [介绍](https://docs.superun.ai/superun/integrations/introduction): 使用集成和外部 API 扩展您的 superun 应用程序功能
- [superun 生图](https://docs.superun.ai/superun/integrations/nano-banana): 在 superun 中使用 superun 生图 影像模型,完成进阶的图片生成,编辑与影像工作流程.
- [Resend 集成](https://docs.superun.ai/superun/integrations/resend): 使用 Resend 将电子邮件功能添加到您的 superun 应用程序.Resend 是一个现代化的电子邮件 API.
- [SMS Login](https://docs.superun.ai/superun/integrations/sms-login): Implement custom SMS provider for user registration and login using Edge Functions
- [superun 文件存储](https://docs.superun.ai/superun/integrations/storage): 将储存功能整合到您的产品中.安全地储存和检索数据.
- [Stripe 集成](https://docs.superun.ai/superun/integrations/stripe): 使用 Stripe 将支付处理功能添加到您的 superun 应用程序
- [superun Pay](https://docs.superun.ai/superun/integrations/superun-payment): Fully managed WeChat Pay and Alipay for mainland China: no merchant onboarding on your side, hosted checkout, orders, and wallet.
- [superun SMS Provider](https://docs.superun.ai/superun/integrations/superun-sms-provider): 使用 superun 云计算 整合 SMS 手机验证 - 自动配置并可直接使用
- [企业微信插件](https://docs.superun.ai/superun/integrations/wecom): 在 superun 中接入企业微信登录、消息推送与成员管理能力的总览说明。
- [superun FAQ](https://docs.superun.ai/superun/introduction/faq): Answers to common questions about superun features, workflows, data, security, and policies.
- [入门](https://docs.superun.ai/superun/introduction/getting-started): superun 入门:从第一次提示到发布 — 设置,工作流程和集成.
- [欢迎来到superun](https://docs.superun.ai/superun/introduction/welcome): 探索 superun.com,这是一款由 AI 驱动的应用与网站建置平台.通过自然语言即可建立并发布应用,结合代码模式与可视化编辑,适合各种技能层级的用户快速上手.
- [定价方案](https://docs.superun.ai/superun/pricing): 了解 superun 代币充值方案,Credits（代币）如何运作,以及每个方案包含的内容.
- [支付宝回调问题排查与补偿方案](https://docs.superun.ai/superun/skills/alipay-notify-troubleshooting): 支付宝异步回调（notify_url）常见问题的排查思路、诊断日志设计和三层自动补偿机制，确保支付状态不丢失.
- [技能指南](https://docs.superun.ai/superun/skills/all): superun 技能指南合集 — 涵盖支付接入,邮箱配置,语音引擎,平台集成,OAuth 登录与 SEO 优化等实用教程.
- [使用个人网易邮箱配置 SMTP](https://docs.superun.ai/superun/skills/configure-163-smtp): 教你用个人 163 邮箱在 superun 中快速配置 SMTP,无需企业邮箱或云服务.
- [支付宝 H5 支付接入指南](https://docs.superun.ai/superun/skills/configure-alipay-pay): 教你如何在 superun 中一步步接入支付宝 H5 支付,包括注册应用,获取支付凭证,配置环境变数等完整流程.
- [微信公众号接入指南](https://docs.superun.ai/superun/skills/configure-wechat-official-account): 基于项目的实际实现，详细说明如何通过 Supabase Edge Functions 接入微信公众号 API，包括令牌管理、数据统计、图文管理和菜单管理.
- [微信 H5 支付接入指南](https://docs.superun.ai/superun/skills/configure-wechat-pay): 教你如何在 superun 中一步步接入微信 H5 支付,包括注册商户号,获取支付凭证,配置环境变数等完整流程.
- [微信扫码登录对接文档](https://docs.superun.ai/superun/skills/configure-wechat-qrcode-oauth): 微信开放平台网站应用扫码登录完整对接指南，包括微信端配置、前端实现、后端 Edge Function 和 Supabase Auth 集成.
- [钉钉集成指南](https://docs.superun.ai/superun/skills/dingtalk/all): superun 钉钉集成指南合集 — 涵盖钉钉应用创建、OAuth 扫码登录等实用教程.
- [钉钉文档写入（知识库 + 空文档 + Markdown 覆写）](https://docs.superun.ai/superun/skills/dingtalk/dingtalk-document-write-guide): 基于企业令牌与用户令牌双令牌体系，完成钉钉知识库文档创建与内容覆写的完整接入流程。
- [钉钉扫码登录 + 企业白名单校验](https://docs.superun.ai/superun/skills/dingtalk/dingtalk-qrcode-oauth-guide): 钉钉 OAuth 2.0 二维码扫码登录接入说明，内嵌扫码面板模式，支持企业白名单校验。
- [钉钉企业内部应用后台配置指南](https://docs.superun.ai/superun/skills/dingtalk/dingtalk-self-built-app-setup): 在钉钉开放平台创建企业内部应用、配置权限与回调域名的完整步骤说明，为后续 OAuth 登录等整合做准备。
- [飞书集成指南](https://docs.superun.ai/superun/skills/feishu/all): superun 飞书集成指南合集 — 涵盖飞书扫码登录、机器人消息推送、群消息看板等实用教程.
- [群消息看板](https://docs.superun.ai/superun/skills/feishu/feishu-chat): 飞书群消息看板 Agent 实施说明，涵盖事件订阅、历史消息 API、落库去重与 Realtime 推送.
- [群消息看板使用指南](https://docs.superun.ai/superun/skills/feishu/feishu-chat-dashboard-guide): 飞书群消息看板的完整使用指南,包括权限配置、事件订阅和看板操作说明.
- [Feishu QR Code OAuth Login + Enterprise Whitelist Validation](https://docs.superun.ai/superun/skills/feishu/feishu-qrcode-oauth-guide): Feishu OAuth 2.0 QR code login integration with support for enterprise whitelist validation.
- [飞书扫码 OAuth 登录](https://docs.superun.ai/superun/skills/feishu/feishu-qrcode-oauth-guide/index): 飞书 OAuth 2.0 二维码扫码登录技术详解，涵盖整体架构、关键代码、SDK 机制、接口清单与踩坑记录.
- [飞书扫码 OAuth 登录 — 配置与接入指南](https://docs.superun.ai/superun/skills/feishu/feishu-qrcode-oauth-guide/user): 飞书 OAuth 2.0 二维码扫码登录：应用配置、Edge Function、前端 Hook、回调与 Supabase 会话；含企业白名单与排错清单.
- [飞书机器人消息推送](https://docs.superun.ai/superun/skills/feishu/feishu-robot): 飞书机器人消息推送对接说明，支持 Webhook 与 API 双通道及 Edge Function 路由.
- [启用飞书 — 自建应用配置指南](https://docs.superun.ai/superun/skills/feishu/feishu-self-built-app-setup): 在飞书开放平台创建企业自建应用并获取 App ID 与 App Secret，完成飞书集成的第一步。
- [飞书通讯录查询](https://docs.superun.ai/superun/skills/feishu/feishu-structure): 飞书通讯录 API 对接指南，支持部门层级查询、成员列表获取与用户详情拉取.
- [Feishu Multi-dimensional Table Data Sync Integration Guide](https://docs.superun.ai/superun/skills/feishu/feishu-sync-guide): Complete guide for integrating Feishu multi-dimensional table data synchronization, including Feishu configuration, database table structure, Edge Function core code, and frontend call examples.
- [微信小程序能力指南](https://docs.superun.ai/superun/skills/miniprogram/all): superun 微信小程序能力生成总览，按 Core、Runner、Passthrough 与 Template-built 组织，提供能力路由与生成规范。
- [superun/skills/miniprogram/login](https://docs.superun.ai/superun/skills/miniprogram/login)
- [微信小程序 — Runner 能力生成协议](https://docs.superun.ai/superun/skills/miniprogram/runner_capability): Runner 类小程序能力的判定标准、数据流模式、代码模板与生成步骤。AI 生成 Runner 能力的唯一入口文档。
- [WebView 兼容性指南](https://docs.superun.ai/superun/skills/miniprogram/webview-compatibility): 微信小程序 WebView 环境下的 H5 编码约束与错误模式库，用于预防兼容性问题并加速定位根因。
- [第三方平台 Token 统一缓存方案](https://docs.superun.ai/superun/skills/platform-token-cache): 企业微信、飞书、钉钉等平台 access_token 的统一缓存与刷新机制，包括数据库表结构、核心函数实现、被动失效处理和代理转发配合方案。
- [固定 IP 代理转发方案](https://docs.superun.ai/superun/skills/proxy-forward): 企业微信IP 白名单限制下的固定出口 IP 代理转发方案，包括代理接口规范、Edge Function 调用方式、使用场景判断和与 Token 缓存的协作流程。
- [开箱即用 API 密钥](https://docs.superun.ai/superun/skills/ready-to-use/all): 使用我们的开箱即用 API 密钥测试您的整合.这些密钥是共享的,可能因使用量过高或提供商限制而无法使用.
- [高德地图](https://docs.superun.ai/superun/skills/ready-to-use/amap): 整合高德地图服务,实现地图,地理编码和基于位置的功能
- [Pexels](https://docs.superun.ai/superun/skills/ready-to-use/pexels): 整合 Pexels API 以取得高品质,免版税的图片和照片搜寻功能
- [Unsplash](https://docs.superun.ai/superun/skills/ready-to-use/unsplash): 整合 Unsplash API 以取得高品质,免版税的图片和照片搜寻功能
- [Windy Weather](https://docs.superun.ai/superun/skills/ready-to-use/windy): 整合 Windy API 以取得即时天气资料,预报和气象视觉化
- [SEO 优化指南](https://docs.superun.ai/superun/skills/seo/all): SEO 能力总入口：面向 Agent 的诊断与执行规则。每次 SEO 任务先做技术审计，再按优先级推进改造。
- [CSR 项目改造为 SSG（vite-react-ssg）](https://docs.superun.ai/superun/skills/seo/ssg): 将现有 CSR 项目迁移到 Vite + React SSG：保持 App.tsx 路由源、补齐 ssg-entry 与 getStaticPaths、处理 i18n/主题/Sonner 的 SSR 安全，并确保可构建与稳定 hydration。
- [语音引擎接入指南](https://docs.superun.ai/superun/skills/speech-engines): 语音转文字（ASR）和文字转语音（TTS）引擎接入说明 — 支持百度,讯飞,火山,阿里云四大引擎.
- [第三方 OAuth 登录 + Supabase Auth 会话管理集成](https://docs.superun.ai/superun/skills/third-party-oauth-architecture): 第三方 OAuth（飞书、微信等）与 Supabase Auth 会话管理架构说明 — 身份验证、user_identities 表设计与 RLS 集成方案.
- [企业微信集成指南](https://docs.superun.ai/superun/skills/wecom/all): superun 企业微信集成指南合集 — 涵盖企业微信扫码登录、企业成员校验、通讯录 API 等实用教程.
- [企微通讯录 API](https://docs.superun.ai/superun/skills/wecom/wecom-contacts-api): 企业微信通讯录服务端 API 速查：部门与成员接口、参数与返回示例、自建应用字段限制与通用错误码。
- [企业微信登录方案（扫码 + 静默授权双模式）](https://docs.superun.ai/superun/skills/wecom/wecom-login): 整合两种企业微信登录方式：外部浏览器扫码登录 + 企微内置浏览器静默授权。前端自动检测环境切换模式，后端共用同一套 code 兑换与会话签发流程。
- [WeCom QR Code Login + Enterprise Member Validation](https://docs.superun.ai/superun/skills/wecom/wecom-qrcode-oauth-guide): WeCom OAuth 2.0 QR code login integration with embedded scan panel mode, restricted to enterprise members only.
- [企业微信自建应用后台配置指南](https://docs.superun.ai/superun/skills/wecom/wecom-self-built-app-setup): 在企业微信管理后台创建自建应用、配置应用能力与回调 URL 的完整步骤说明，为后续 OAuth 登录、消息接收等整合做准备。
- [避免安全陷阱](https://docs.superun.ai/superun/tips-tricks/avoiding-security-pitfalls): 避免 superun 中常见的安全陷阱 — 秘密,最小权限,API 保护和预发布检查.
- [最佳实践](https://docs.superun.ai/superun/tips-tricks/best-practice): 在superun中构建的最佳实践——提示,版本,Supabase,高效性和故障排除.
- [支付宝 H5 支付接入指南](https://docs.superun.ai/superun/tips-tricks/configure-alipay-pay): 教你如何在 superun 中一步步接入支付宝 H5 支付,包括注册应用,获取支付凭证,配置环境变数等完整流程.
- [WeChat H5 Payment Setup Guide](https://docs.superun.ai/superun/tips-tricks/configure-wechat-pay): Step-by-step guide to integrate WeChat H5 payment in superun, including merchant account registration, payment credentials, and environment variable configuration.
- [使用技巧详解](https://docs.superun.ai/superun/tips-tricks/detailed-tips): superun 详细使用技巧,涵盖项目规划,设计,开发,发布等各个阶段.
- [从想法到工作应用程序](https://docs.superun.ai/superun/tips-tricks/from-idea-to-app): 使用 superun 将想法转化为工作产品的实用路径 - 范围,砖块,混音和验证.
- [常见问题排查](https://docs.superun.ai/superun/tips-tricks/troubleshooting): superun 使用过程中遇到的常见问题及解决方案,包含数据回滚,AI 功能异常,代币问题等.
- [在superun中使用图片](https://docs.superun.ai/superun/tips-tricks/using-images): 在superun中添加/图像替换的四种方式 - 聊天上传,可编辑设计,外部URL和公共资产.
- [建立旅游规划网页应用程序](https://docs.superun.ai/superun/use-case/build-web-app): 逐步示范如何使用 superun 建立一个由 AI 驱动的旅游规划 Web App.
- [灵感展示墙](https://docs.superun.ai/superun/use-case/inspiration-showcase): 浏览由 superun 生成的真实界面,登陆页,仪表板与创意 UI 范例,作为你的设计灵感.
- [灵感](https://docs.superun.ai/superun/use-case/inspiration-time): superun 示例和灵感 - 登陆页面,教育,全栈产品和游戏.
- [登陆页面](https://docs.superun.ai/superun/use-case/landing-page): 在 superun 中构建登陆页面的两种方法 — 一次性生成或使用可编辑设计逐节生成.
- [原型](https://docs.superun.ai/superun/use-case/prototype): 使用 superun 构建功能原型 — 流程,最小页面和基本 Supabase 集成.
- [软件即服务](https://docs.superun.ai/superun/use-case/saas): 使用 superun 构建 SaaS — 模块,集成（Supabase/Stripe/Resend）和推荐的工作流程.