From eb4f6c3eec2a7d77c46d853088926092967878af Mon Sep 17 00:00:00 2001 From: RiskeyL <7a8y@163.com> Date: Fri, 17 Jul 2026 15:20:21 +0800 Subject: [PATCH] fix: converge zh/ja webapp guides with current en - Retranslate zh embedding-in-websites from the current en source (cloud + self-host) - Drop the stale best-practices section from zh/ja workflow-webapp (en removed it in d68fded2) - Restructure the three em-dash sentences in cloud zh web-app-access per formatting-zh Part of DC-18; the EE-side copies follow after the DC-30 write freeze lifts. --- .../publish/webapp/workflow-webapp.mdx | 17 ---- .../publish/webapp/workflow-webapp.mdx | 17 ---- .../publish/webapp/embedding-in-websites.mdx | 87 ++++++++++--------- .../publish/webapp/web-app-access.mdx | 6 +- .../publish/webapp/workflow-webapp.mdx | 17 ---- .../publish/webapp/embedding-in-websites.mdx | 87 ++++++++++--------- .../publish/webapp/workflow-webapp.mdx | 17 ---- 7 files changed, 99 insertions(+), 149 deletions(-) diff --git a/ja/cloud/use-dify/publish/webapp/workflow-webapp.mdx b/ja/cloud/use-dify/publish/webapp/workflow-webapp.mdx index 4de8a26d60..e0f686cf28 100644 --- a/ja/cloud/use-dify/publish/webapp/workflow-webapp.mdx +++ b/ja/cloud/use-dify/publish/webapp/workflow-webapp.mdx @@ -144,20 +144,3 @@ Workflow アプリには、ユーザーが出力を整理し再利用するの 「類似生成」は特に、ユーザーが同じトピックに対する異なるアプローチを探索したいコンテンツ生成などのクリエイティブなワークフローでうまく機能します。 - -## ベストプラクティス - -**単一実行アプリの場合**: -- ユーザーが有用な情報を提供するよう導くクリアな入力フォームを設計 -- 複雑なパラメータには役立つ説明を含める -- 結果が期待に応えるかユーザーフローをテスト - -**バッチ処理アプリの場合**: -- サンプルデータを含む明確な CSV テンプレート例を提供 -- 一般的な入力エラーの検証を含める -- 非常に大きなバッチの処理制限を考慮 - -**結果管理の場合**: -- ユーザーが保持したい価値ある出力を生成するワークフローには保存を有効化 -- クリエイティブまたは探索的なワークフローには「類似生成」を使用 -- 外部アクセスが必要なユーザーのために結果エクスポートオプションを考慮 diff --git a/ja/self-host/use-dify/publish/webapp/workflow-webapp.mdx b/ja/self-host/use-dify/publish/webapp/workflow-webapp.mdx index a219b7fc1d..f743dc6fb6 100644 --- a/ja/self-host/use-dify/publish/webapp/workflow-webapp.mdx +++ b/ja/self-host/use-dify/publish/webapp/workflow-webapp.mdx @@ -144,20 +144,3 @@ Workflow アプリには、ユーザーが出力を整理し再利用するの 「類似生成」は特に、ユーザーが同じトピックに対する異なるアプローチを探索したいコンテンツ生成などのクリエイティブなワークフローでうまく機能します。 - -## ベストプラクティス - -**単一実行アプリの場合**: -- ユーザーが有用な情報を提供するよう導くクリアな入力フォームを設計 -- 複雑なパラメータには役立つ説明を含める -- 結果が期待に応えるかユーザーフローをテスト - -**バッチ処理アプリの場合**: -- サンプルデータを含む明確な CSV テンプレート例を提供 -- 一般的な入力エラーの検証を含める -- 非常に大きなバッチの処理制限を考慮 - -**結果管理の場合**: -- ユーザーが保持したい価値ある出力を生成するワークフローには保存を有効化 -- クリエイティブまたは探索的なワークフローには「類似生成」を使用 -- 外部アクセスが必要なユーザーのために結果エクスポートオプションを考慮 diff --git a/zh/cloud/use-dify/publish/webapp/embedding-in-websites.mdx b/zh/cloud/use-dify/publish/webapp/embedding-in-websites.mdx index e987651376..b995372422 100644 --- a/zh/cloud/use-dify/publish/webapp/embedding-in-websites.mdx +++ b/zh/cloud/use-dify/publish/webapp/embedding-in-websites.mdx @@ -1,33 +1,40 @@ --- -title: "网站嵌入" -sidebarTitle: "嵌入" +title: 嵌入 Web 应用 +sidebarTitle: 嵌入 +description: 通过 iframe、聊天气泡组件或自定义集成,将已发布的 Web 应用部署到任何网站 --- > 本文档由 AI 自动翻译。如有任何不准确之处,请参考 [英文原版](/en/cloud/use-dify/publish/webapp/embedding-in-websites)。 -将 Dify 应用嵌入到网站中,直接为网站访客提供 AI 能力。无论你想要一个浮动聊天按钮、全屏聊天界面,还是嵌入式小组件,Dify 都提供了适用于任何网站技术的灵活选项。 +已发布的 Web 应用可直接嵌入任何网站。这不是另一种发布方式:嵌入的仍是你已创建的同一个 Web 应用,只是呈现在你现有的网站中,而不是作为独立页面。 -## 嵌入选项 +## Web 应用嵌入的工作方式 + +在 Dify 中发布应用后,你会获得一个 Web 应用 URL。你可直接分享该 URL,也可通过以下方式将同一个应用嵌入你的网站: - - 浮动聊天按钮,打开你的 AI 助手,非常适合客户支持 + + Web 应用以浮动按钮呈现,访客点击即可打开完整界面 - 在网页内容中完整嵌入界面,直接访问 + Web 应用直接嵌入页面内容,始终可见、随时可用 - - 使用 JavaScript API 完全控制用户体验 + + 高级嵌入方式,可自定义样式和控制行为 - 所有嵌入都会自动适应不同的屏幕尺寸和设备 + 同一个 Web 应用自动适配任何展示形式 -## 聊天气泡设置 + +所有嵌入方式使用的都是你已发布的 Web 应用。应用配置的变更会自动应用到所有嵌入位置。 + + +## 聊天气泡组件 -浮动聊天按钮是最受欢迎的嵌入方法。它会在你的网站上添加一个可自定义的按钮,点击时打开你的 AI 助手。 +聊天气泡将 Web 应用显示为一个浮动按钮。访客点击后,应用以浮层形式打开,无需离开当前页面即可使用 AI 功能。 ### 配置选项 @@ -77,7 +84,7 @@ window.difyChatbotConfig = { - 在你的 Dify 应用中,前往 **发布 → 嵌入** 找到你的唯一令牌。 + 在你的 Dify 应用中,前往 **发布** > **嵌入** 找到唯一令牌。 @@ -95,7 +102,7 @@ window.difyChatbotConfig = { ## Iframe 嵌入 -为了获得更集成的体验,可以将你的 Dify 应用直接嵌入到网页内容中: +将 Web 应用直接嵌入页面内容,让它成为网站的组成部分: ```html ``` -### Iframe 优势 +### 为什么使用 Iframe 嵌入 -- **直接集成** - 应用作为页面内容的一部分出现 -- **完整功能** - 所有应用功能在 iframe 内正常工作 -- **响应式设计** - 自动适应容器大小 -- **无需 JavaScript** - 简单的 HTML 实现 +- **始终可见**:Web 应用直接可用,不必先点击按钮唤出 +- **功能完整**:Web 应用的所有功能在 iframe 中表现一致 +- **融入页面**:以页面原生内容呈现,而非浮层 +- **配置简单**:只需 HTML,无需 JavaScript 配置 ### 自定义选项 @@ -136,40 +143,42 @@ window.difyChatbotConfig = { ``` -## 使用场景和最佳实践 +## 选择嵌入方式 - - 使用聊天气泡进行即时帮助。将它们放在显著位置,并考虑预填充当前页面或用户账户信息等上下文。 + + **聊天气泡** 最合适:平时不打扰浏览,需要时随时可用。浮动按钮让访客边浏览边快速获取帮助。 - - - 直接在内容中嵌入线索收集表单。在专门的着陆页上使用 iframe 嵌入以获得更高的参与度。 + + + 应用是页面主要内容时,选 **Iframe 嵌入**。访客无需额外点击,直接看到并使用应用。 - + - 通过嵌入式演示展示 AI 功能。让访问者在不离开你网站的情况下试用你的应用。 + 在着陆页使用 **Iframe 嵌入**,让访客即刻体验你的 AI 能力,从感兴趣到上手没有任何门槛。 - - - 用交互式 AI 助手替换静态 FAQ。用户可以获得个性化答案,而不是搜索文档。 + + + 希望全站每个页面都能访问同一个应用时,选 **聊天气泡**。一段嵌入代码即可覆盖所有页面。 ## 故障排除 -**聊天按钮未出现:** -- 检查你的令牌是否正确 -- 确保嵌入脚本在配置之后加载 -- 验证浏览器控制台中没有 JavaScript 错误 +**组件未显示**: + +- 确认应用令牌与 Dify **发布** > **嵌入** 中显示的一致 +- 检查配置是否在嵌入脚本之前加载 +- 查看浏览器控制台是否有 JavaScript 错误 + +**Iframe 无法加载**: -**Iframe 无法加载:** -- 确认 iframe URL 包含你正确的应用令牌 -- 检查你的网站是否允许 iframe 内容 -- 如果你的 Dify 应用需要,确保父页面通过 HTTPS 提供服务 +- 确认 Web 应用 URL 中包含正确的令牌 +- 确保你的网站允许 iframe 内容(检查 Content Security Policy) +- 你的网站和 Dify 应用都应使用 HTTPS -在不同的浏览器和设备上测试你的嵌入以确保兼容性。某些企业防火墙可能会阻止 iframe 内容。 +Web 应用必须先发布才能嵌入。更新应用配置后,需重新发布,变更才会应用到嵌入版本。 你可以使用 CSS 变量或 `containerProps` 选项覆盖默认按钮样式。根据 CSS 特异性应用这些方法以实现你想要的自定义。 diff --git a/zh/self-host/use-dify/publish/webapp/workflow-webapp.mdx b/zh/self-host/use-dify/publish/webapp/workflow-webapp.mdx index 7dffb848b2..982ec9d8a2 100644 --- a/zh/self-host/use-dify/publish/webapp/workflow-webapp.mdx +++ b/zh/self-host/use-dify/publish/webapp/workflow-webapp.mdx @@ -143,20 +143,3 @@ Workflow 应用包含全面的结果管理功能,帮助用户整理和重复 "生成类似内容"对于内容生成等创意工作流特别有效,用户希望探索同一主题的不同方法。 - -## 最佳实践 - -**对于单次执行应用**: -- 设计清晰的输入表单,指导用户提供有用信息 -- 为复杂参数包含有用的描述 -- 测试用户流程以确保结果符合预期 - -**对于批处理应用**: -- 提供清晰的 CSV 模板示例和样本数据 -- 包含常见输入错误的验证 -- 考虑非常大批次的处理限制 - -**对于结果管理**: -- 为产生用户想要保留的有价值输出的工作流启用保存 -- 对创意或探索性工作流使用"生成类似内容" -- 考虑为需要外部访问的用户提供结果导出选项