---
url: /v6.2/faq.md
---
# HENGSHI SENSE FAQ 总览

如果你已经遇到了具体问题，不想先读完整产品说明，可以从这个 FAQ 总览直接进入高频问题。

## 先按问题类型找入口

|你遇到的问题|优先查看|
|-|-|
|想隐藏按钮、改文案、做 OEM 样式|[全局定制与 OEM](customization-oem-faq.md)、[全局 CSS 设置](global-css.md)、[全局 JS 设置](global-js.md)|
|做 iframe / URL 嵌入时遇到语言、刷新、全屏、跨域问题|[嵌入集成](embed-faq.md)、[嵌入样式定制化](embed/iframe.md)、[外部控制嵌入 URL](embed/url.md)|
|想知道公开链接为什么和用户权限不一致|[权限模型](permission-faq.md)、[公开链接](app-public-link.md)|
|外部认证配置错了，登录不上，或者不知道 JWT 该不该用|[认证与 JWT](auth-jwt-faq.md)、[认证方式](authorization.md)|
|数据源接入、批量同步、日志排障不知道先查哪一层|[数据接入与运维](data-integration-ops-faq.md)、[批量同步](batch-sync.md)、[数据连接](connecting-connection.md)|
|不知道该用 API 服务、API 查询数据集还是 API 数据源|[数据服务与 API](api-data-service-faq.md)、[API 服务](api.md)、[API 数据源](connecting-ext-api.md)|
|模板导入导出、协作、副本、发布快照这些交付边界搞不清|[应用交付与模板](app-delivery-template-faq.md)、[模板市场](template.md)、[应用发布](app-publish.md)|
|安装、启动、升级、截图导出、字体或代理有问题|[安装相关问题](installation-faq.md)、[启动相关问题](startup-faq.md)、[软件配置问题](software-config-faq.md)、[其他问题](other-faq.md)|
|迁移、升级、备份恢复、端口、防火墙、代理缓存失效这类运维问题|[部署升级与备份恢复](deployment-upgrade-faq.md)、[数据备份与恢复](backup-restore.md)、[部署后工作及注意事项](post-deployment.md)|
|导出、截图、日志导出、实时调试不知道先查哪里|[导出、截图与日志](export-screenshot-log-faq.md)、[系统调试](debug-log.md)、[运行日志清理](clean-log.md)|
|安全策略、导出管控、水印、HMAC、审计日志、第三方白名单经常混淆|[安全与审计](security-audit-faq.md)、[安全策略](security-policy.md)、[系统日志](audit-log.md)|
|感觉查询慢、页面慢，或者不知道为什么“不够实时”|[性能与实时性](performance-faq.md)、[产品使用性能问题指引](solutions-use-performance.md)|
|平台方给租户交付资源、做多租户，或者做 OEM 白标|[多租户与 OEM](tenant-oem-faq.md)、[租户管理](tenant.md)、[全局 CSS 设置](global-css.md)|
|Data Agent / ChatBI 不知道该选哪种入口、哪种模式、怎么排障|[Data Agent 与 ChatBI](data-agent-chatbi-faq.md)、[Data Agent 调优](agent-tune.md)、[Data Agent 使用指南](chatbi.md)|
|CLI 使用报错、连接不上、命令不会用|[CLI 排障与 FAQ](cli-faq.md)|

## 产品使用 FAQ

### 定制与白标

* [全局定制与 OEM](customization-oem-faq.md)：全局 CSS / 全局 JS / i18n Hook / Tool 应该怎么选。
* [全局 CSS 设置](global-css.md)：什么时候该用 CSS，适合哪些隐藏/样式场景。
* [全局 JS 设置](global-js.md)：什么时候该用全局 JS、`customI18nPostProcessor`、`createTool()`。
* [Data Agent 调优](agent-tune.md)：什么时候应该创建自定义 Tool。

### 嵌入与集成

* [嵌入集成](embed-faq.md)：URL 拼接、常用参数、跨域、宿主刷新与全屏怎么处理。
* [嵌入样式定制化](embed/iframe.md)：语言、全屏、刷新、跨域等嵌入 FAQ。
* [外部控制嵌入 URL](embed/url.md)：嵌入 URL 的常用参数和控制方式。
* [嵌入页面的外部控制](embed/events.md)：宿主页面如何控制嵌入内容。

### 数据服务与 API

* [数据服务与 API](api-data-service-faq.md)：API 服务、API 查询数据集、API 数据源分别该怎么用。
* [API 服务](api.md)：对外发布 API、授权、限流、监控等正式说明。
* [API 查询数据集](dataset-api.md)：把 HTTP JSON API 接成数据集。
* [API 数据源](connecting-ext-api.md)：把外部 API 平台接成连接。

### 应用交付与模板

* [应用交付与模板](app-delivery-template-faq.md)：模板、发布快照、协作、副本、跨环境导入这些边界怎么理解。
* [模板市场](template.md)：模板市场、上架、应用模板的正式说明。
* [应用发布](app-publish.md)：发布、重新发布、导出模板、暂停服务等正式说明。
* [应用协作](app-collaborate.md)：协作边界与权限。

### 权限与访问方式

* [权限模型](permission-faq.md)：公开链接、使用者模式、行权限、平台/租户授权边界。
* [认证与 JWT](auth-jwt-faq.md)：认证方式怎么选、JWT 适用边界、回退登录与映射常见误区。
* [公开链接](app-public-link.md)：公开链接的适用边界，以及为什么`使用者`模式不能开启公开链接。
* [认证方式](authorization.md)：外部认证配置与回退登录。

### 性能与实时性

* [性能与实时性](performance-faq.md)：怎么区分“慢”与“不实时”，以及优先排查什么。
* [产品使用性能问题指引](solutions-use-performance.md)：常规性能优化建议。

### 多租户与 OEM

* [多租户与 OEM](tenant-oem-faq.md)：平台方/租户协作边界、OEM 与多租户的区别、字体与资源交付注意点。
* [租户管理](tenant.md)：多租户正式功能说明。
* [全局 CSS 设置](global-css.md)、[全局 JS 设置](global-js.md)：OEM 与品牌化定制入口。

### Data Agent / ChatBI

* [Data Agent 与 ChatBI](data-agent-chatbi-faq.md)：入口、模式、调优、向量化、Tool 与排障怎么选。
* [Data Agent](chatbi.md)：Data Agent 的能力、准备工作与使用方式。
* [Data Agent 调优](agent-tune.md)：提示词、分析模板、自定义 Tool 等调优入口。

## 安装、运维与排障 FAQ

* [部署升级与备份恢复](deployment-upgrade-faq.md)：迁移、升级、备份恢复、端口、防火墙、代理缓存失效等高频问题。
* [数据接入与运维](data-integration-ops-faq.md)：连接、同步、日志、目标写权限、Mongo BI Connector 等高频排障问题。
* [导出、截图与日志](export-screenshot-log-faq.md)：导出 timeout、日志导出失败、实时调试与历史日志的选择。
* [安全与审计](security-audit-faq.md)：安全策略拦截、导出控制、水印、HMAC、审计日志、第三方白名单排障。
* [安装相关问题](installation-faq.md)
* [启动相关问题](startup-faq.md)
* [软件配置问题](software-config-faq.md)
* [安全漏洞问题](security-faq.md)
* [其他问题](other-faq.md)

## CLI FAQ

* [CLI 排障与 FAQ](cli-faq.md)

## 建议阅读方式

如果你是第一次接触 HENGSHI SENSE，建议先看正常产品文档；如果你已经遇到“为什么不能这样”“为什么和我想的不一样”的问题，就从这个 FAQ 页直接跳转，会更快。