HENGSHI SENSE FAQ 总览
如果你已经遇到了具体问题，不想先读完整产品说明，可以从这个 FAQ 总览直接进入高频问题。
先按问题类型找入口
| 你遇到的问题 | 优先查看 |
|---|---|
| 想隐藏按钮、改文案、做 OEM 样式 | 全局定制与 OEM、全局 CSS 设置、全局 JS 设置 |
| 做 iframe / URL 嵌入时遇到语言、刷新、全屏、跨域问题 | 嵌入集成、嵌入样式定制化、外部控制嵌入 URL |
| 想知道公开链接为什么和用户权限不一致 | 权限模型、公开链接 |
| 外部认证配置错了，登录不上，或者不知道 JWT 该不该用 | 认证与 JWT、认证方式 |
| 数据源接入、批量同步、日志排障不知道先查哪一层 | 数据接入与运维、批量同步、数据连接 |
| 不知道该用 API 服务、API 查询数据集还是 API 数据源 | 数据服务与 API、API 服务、API 数据源 |
| 模板导入导出、协作、副本、发布快照这些交付边界搞不清 | 应用交付与模板、模板市场、应用发布 |
| 安装、启动、升级、截图导出、字体或代理有问题 | 安装相关问题、启动相关问题、软件配置问题、其他问题 |
| 迁移、升级、备份恢复、端口、防火墙、代理缓存失效这类运维问题 | 部署升级与备份恢复、数据备份与恢复、部署后工作及注意事项 |
| 导出、截图、日志导出、实时调试不知道先查哪里 | 导出、截图与日志、系统调试、运行日志清理 |
| 安全策略、导出管控、水印、HMAC、审计日志、第三方白名单经常混淆 | 安全与审计、安全策略、系统日志 |
| 感觉查询慢、页面慢，或者不知道为什么“不够实时” | 性能与实时性、产品使用性能问题指引 |
| 平台方给租户交付资源、做多租户，或者做 OEM 白标 | 多租户与 OEM、租户管理、全局 CSS 设置 |
| Data Agent / ChatBI 不知道该选哪种入口、哪种模式、怎么排障 | Data Agent 与 ChatBI、Data Agent 调优、Data Agent 使用指南 |
| CLI 使用报错、连接不上、命令不会用 | CLI 排障与 FAQ |
产品使用 FAQ
定制与白标
- 全局定制与 OEM：全局 CSS / 全局 JS / i18n Hook / Tool 应该怎么选。
- 全局 CSS 设置：什么时候该用 CSS，适合哪些隐藏/样式场景。
- 全局 JS 设置：什么时候该用全局 JS、
customI18nPostProcessor、createTool()。 - Data Agent 调优：什么时候应该创建自定义 Tool。
嵌入与集成
- 嵌入集成：URL 拼接、常用参数、跨域、宿主刷新与全屏怎么处理。
- 嵌入样式定制化：语言、全屏、刷新、跨域等嵌入 FAQ。
- 外部控制嵌入 URL：嵌入 URL 的常用参数和控制方式。
- 嵌入页面的外部控制：宿主页面如何控制嵌入内容。
数据服务与 API
- 数据服务与 API：API 服务、API 查询数据集、API 数据源分别该怎么用。
- API 服务：对外发布 API、授权、限流、监控等正式说明。
- API 查询数据集：把 HTTP JSON API 接成数据集。
- API 数据源：把外部 API 平台接成连接。
应用交付与模板
- 应用交付与模板：模板、发布快照、协作、副本、跨环境导入这些边界怎么理解。
- 模板市场：模板市场、上架、应用模板的正式说明。
- 应用发布：发布、重新发布、导出模板、暂停服务等正式说明。
- 应用协作：协作边界与权限。
权限与访问方式
- 权限模型：公开链接、使用者模式、行权限、平台/租户授权边界。
- 认证与 JWT：认证方式怎么选、JWT 适用边界、回退登录与映射常见误区。
- 公开链接：公开链接的适用边界，以及为什么
使用者模式不能开启公开链接。 - 认证方式：外部认证配置与回退登录。
性能与实时性
- 性能与实时性：怎么区分“慢”与“不实时”，以及优先排查什么。
- 产品使用性能问题指引：常规性能优化建议。
多租户与 OEM
Data Agent / ChatBI
- Data Agent 与 ChatBI：入口、模式、调优、向量化、Tool 与排障怎么选。
- Data Agent：Data Agent 的能力、准备工作与使用方式。
- Data Agent 调优：提示词、分析模板、自定义 Tool 等调优入口。
安装、运维与排障 FAQ
- 部署升级与备份恢复：迁移、升级、备份恢复、端口、防火墙、代理缓存失效等高频问题。
- 数据接入与运维：连接、同步、日志、目标写权限、Mongo BI Connector 等高频排障问题。
- 导出、截图与日志：导出 timeout、日志导出失败、实时调试与历史日志的选择。
- 安全与审计：安全策略拦截、导出控制、水印、HMAC、审计日志、第三方白名单排障。
- 安装相关问题
- 启动相关问题
- 软件配置问题
- 安全漏洞问题
- 其他问题
CLI FAQ
建议阅读方式
如果你是第一次接触 HENGSHI SENSE，建议先看正常产品文档；如果你已经遇到“为什么不能这样”“为什么和我想的不一样”的问题，就从这个 FAQ 页直接跳转，会更快。