HENGSHI SENSE FAQ Overview

If you already have a concrete problem and do not want to read the full product manual first, start from this FAQ hub.

Start with the problem type

Problem	Start here
Hide buttons, replace copy, or customize OEM styling	Global Customization and OEM, Global CSS Settings, Global JS Settings
Embedding with iframe / URL and hitting language, refresh, fullscreen, or cross-domain issues	Embedding Integration, Customizing Embedded Styles, External Control Embed URL
Public-link behavior does not match user-level permissions	Permission Model, Share Link
External authentication is misconfigured, or you are unsure whether JWT is the right fit	Authentication and JWT, Authentication Method
Data-source onboarding, batch sync, or log-based troubleshooting is unclear	Data Access and Operations, Batch Sync, Data Connections
Unsure whether to use API Service, API Query Dataset, or API Data Source	Data Service and API, API Service, API Data Source
Unclear about template import/export, collaboration, copies, and publish-snapshot boundaries	App Delivery and Template, Template Market, App Publish
Installation, startup, upgrade, screenshot export, fonts, or proxy issues	Installation-related issues, Startup-related issues, Software configuration issue, Other questions
Migration, upgrade, backup/restore, ports, firewall, or proxy cache-invalid issues	Deployment, Upgrade, and Backup, Backup and Restore, Post-deployment Notes
Unsure where to start for export, screenshot, log export, or realtime debug problems	Export, Screenshot, and Log, System Debug, Runtime Log Cleanup
Security policy, export control, watermark, HMAC, audit logs, and third-party whitelists keep getting mixed together	Security and Audit, Security Policy, System Log
Queries feel slow, pages feel slow, or data does not look realtime	Performance and Realtime, Performance Usage Guide
Platform-to-tenant delivery, multi-tenant boundaries, or OEM white-label setup	Tenant and OEM, Tenant Management, Global CSS Settings
Unsure which Data Agent / ChatBI entry, mode, or troubleshooting path to use	Data Agent and ChatBI, Data Agent Tuning, Data Agent User Guide
CLI errors, connection failures, or command usage questions	CLI Troubleshooting & FAQ

Product Usage FAQs

Customization and white-labeling

• Global Customization and OEM: how to choose between Global CSS, Global JS, the i18n hook, and Tools.
• Global CSS Settings: when CSS is the right fit and what kinds of UI hiding/styling it should cover.
• Global JS Settings: when to use Global JS, customI18nPostProcessor, or createTool().
• Data Agent Tuning: when you should create a custom tool.

Embedding and integration

• Embedding Integration: URL composition, common parameters, cross-domain setup, host refresh, and fullscreen handling.
• Customizing Embedded Styles: embedding FAQs for locale, fullscreen, refresh, and cross-domain setup.
• External Control Embed URL: common embed URL parameters and control patterns.
• External Control Embedded in Page: how the host page can control embedded content.

Data service and API

• Data Service and API: how to choose between API Service, API Query Dataset, and API Data Source.
• API Service: formal documentation for API publishing, authorization, rate limiting, and monitoring.
• API Query Dataset: turning HTTP JSON APIs into datasets.
• API Data Source: connecting external API platforms as data sources.

App delivery and templates

• App Delivery and Template: how to understand templates, publish snapshots, collaboration, copies, and cross-environment imports.
• Template Market: formal documentation for template market, publishing, and template usage.
• App Publish: formal documentation for publish, republish, export template, and service pause.
• App Collaboration: collaboration boundaries and permissions.

Permissions and access models

• Permission Model: public links, User mode, row-level permissions, and platform/tenant boundaries.
• Authentication and JWT: how to choose an auth method, JWT fit boundaries, recovery login, and mapping pitfalls.
• Share Link: public-link boundaries and why User mode does not support public links.
• Authentication Method: external auth setup and recovery login.

Performance and realtime

• Performance and Realtime: how to separate "slow" from "not realtime" and where to investigate first.
• Performance Usage Guide: normal optimization guidance.

Tenant and OEM

• Tenant and OEM: platform/tenant collaboration boundaries, OEM vs tenant model, and branding delivery pitfalls.
• Tenant Management: formal multi-tenant feature documentation.
• Global CSS Settings, Global JS Settings: entry points for OEM and branding customization.

Data Agent / ChatBI

• Data Agent and ChatBI: how to choose entries, modes, tuning, vectorization, Tools, and troubleshooting paths.
• Data Agent: capabilities, preparation work, and usage.
• Data Agent Tuning: tuning prompts, analysis templates, and custom tools.

Installation, Operations, and Troubleshooting FAQs

• Deployment, Upgrade, and Backup: migration, upgrade, backup/restore, ports, firewall, and proxy cache-invalid issues.
• Data Access and Operations: connection, sync, logs, target write permissions, Mongo BI Connector, and similar high-frequency troubleshooting topics.
• Export, Screenshot, and Log: export timeout, log-export failures, and when to choose realtime versus historical logs.
• Security and Audit: security interception, export control, watermark, HMAC, audit logs, and third-party whitelist troubleshooting.
• Installation-related issues
• Startup-related issues
• Software configuration issue
• Security vulnerability issue
• Other questions

CLI FAQ

• CLI Troubleshooting & FAQ

Recommended reading pattern

If you are new to HENGSHI SENSE, start with the normal product documentation. If you are already asking "why doesn't this work the way I expected?", jump in from this FAQ hub first.