feat(developer-portal): integrate docs AI widget and landing updates by wabicai · Pull Request #687 · OneKeyHQ/hardware-js-sdk

wabicai · 2026-03-03T08:19:44Z

Changes

integrate the Docs AI widget into developer-portal and keep the modal available by default
route chat requests by deployment hostname, while still allowing NEXT_PUBLIC_DOCS_AI_API_URL to override for local or staging
sanitize retrieval scaffold text in assistant messages so the UI only shows the grounded answer content
fix source-only responses so copy and retry continue to work correctly, and keep source cards rendered separately
polish the Search / Ask AI panel visual design and keyboard navigation bridge
sync the landing page footer with the latest hardware-js-sdk PR fix(developer-portal): restore footer layout with SDK version and commit hash #692 layout updates

Validation

removed local Playwright screenshots and other test artifacts from the worktree before pushing
yarn build:docs
verified previously with local end-to-end flows against the RAG service for source display, copy, and retry behavior

Notes

this PR depends on the RAG service changes for direct Context7 answers, but the frontend now handles fallback responses correctly
direct answers from Context7 still depend on the final docs site origin being allowed in the widget settings

revan-zhang · 2026-03-03T08:20:01Z

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues
✅	Licenses	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

socket-security · 2026-03-03T08:20:36Z

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Action	Severity	Alert (click "▶" to expand/collapse)
Warn		Obfuscated code: npm `@polkadot/util-crypto` is 91.0% likely obfuscated Confidence: 0.91 Location: Package overview From: packages/connect-examples/expo-example/package.json → `npm/@polkadot/util-crypto@13.1.1` ℹ Read more on: This package \| This alert \| What is obfuscated code? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at `support@socket.dev`. Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment `@SocketSecurity ignore npm/@polkadot/util-crypto@13.1.1`. You can also ignore all packages with `@SocketSecurity ignore-all`. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		Obfuscated code: npm `@react-native/debugger-frontend` is 96.0% likely obfuscated Confidence: 0.96 Location: Package overview From: `?` → `npm/@react-native/debugger-frontend@0.73.3` ℹ Read more on: This package \| This alert \| What is obfuscated code? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at `support@socket.dev`. Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment `@SocketSecurity ignore npm/@react-native/debugger-frontend@0.73.3`. You can also ignore all packages with `@SocketSecurity ignore-all`. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.

View full report

socket-security · 2026-03-09T08:58:09Z

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security
	@polkadot/util-crypto@13.1.1
	@babel/plugin-proposal-object-rest-spread@7.20.7
	@babel/plugin-proposal-optional-chaining@7.21.0
	@radix-ui/react-separator@1.1.7
	@tamagui/babel-plugin@1.90.2
	@radix-ui/react-progress@1.1.7
	@radix-ui/react-slot@1.2.3
	@nexajs/script@23.12.13
	@types/bchaddrjs@0.4.3
	@radix-ui/react-checkbox@1.3.2
	@babel/preset-react@7.22.15
	@radix-ui/react-dropdown-menu@2.1.15
	@radix-ui/react-dialog@1.1.14
	@tamagui/toast@1.90.2
	@radix-ui/react-tooltip@1.2.7
	@react-navigation/bottom-tabs@6.5.12
	@radix-ui/react-toast@1.2.14
	@babel/preset-typescript@7.23.3
	@types/bytebuffer@5.0.43
	@radix-ui/react-scroll-area@1.2.9
	@onekeyfe/cross-inpage-provider-core@0.0.17
	@react-navigation/native-stack@6.9.18
	@alephium/web3-wallet@1.5.2
	@radix-ui/react-select@2.2.5
	@types/bn.js@5.1.5
	@nexajs/address@23.12.25
	@react-navigation/native@6.1.10
	@tamagui/config@1.90.2
	@onekeyfe/react-native-ble-utils@0.1.4
	@babel/core@7.28.5 ⏵ 7.23.9	⁺¹
	@ckb-lumos/helpers@0.23.0
	@ton/core@0.57.0
	@scure/bip39@1.3.0
See 19 more rows in the dashboard

View full report

- Add i18n to DeviceActionAnimation (7 hardcoded Chinese strings) - Fix Chinese fallback text in PinDialog and PassphraseDialog t() calls - Fix Chinese console.log/error messages in GlobalDialogManager, PinDialog, PassphraseDialog - Fix Chinese default title in UnifiedLogger - Add deviceAction i18n keys to en.ts and zh.ts - Fix malformed code blocks in nip04.decrypt.mdx and nip04.encrypt.mdx - Fix stray code block delimiter in devicesettings.mdx (en + zh) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The commit hash is already displayed in the bottom corner, so the one in the header is redundant. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Replace streaming <pre> raw-text fallback with ReactMarkdown + disableHighlight during streaming, eliminating the jarring jump from plain text to fully-rendered markdown when a response completes - Remove redundant normalizeMarkdownArtifacts wrapper that duplicated the same replacements already applied by sanitizeDocAIMessageText; pass the pre-sanitized text prop directly to ReactMarkdown - Rename .assistantIcon → .emptyStateIcon to fix a CSS specificity bug where the second .assistantIcon/.avatar rule overrode the empty-state container from 48 px down to 26 px; align the JSX size prop to 22 px to match the CSS .avatarLogo rule - Show the "Generating…" status dots only while status === 'submitted' (waiting for first token) so they disappear once streaming text is visible, removing the redundant double indicator - Remove dead searchCount JSX render and its always-hidden CSS rule - Remove redundant max-height on .panel (height already constrains it) - Remove dead .streamingText CSS class now that the <pre> branch is gone Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…ator - Add transformSourceUrl() to rewrite GitHub developer-portal content URLs to live docs page URLs via regex, e.g. github.com/.../developer-portal/content/en/hardware-sdk/foo.mdx → {origin}/en/hardware-sdk/foo No static mapping table needed; works across test and prod origins automatically via window.location.origin - Replace status === 'submitted' streaming indicator condition with isWaitingForContent = isGenerating && no renderable text yet, so the "Generating…" dots stay visible until the first token actually renders in the message list, eliminating the blank gap between dot-disappear and text-appear during the LLM time-to-first-token window Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(developer-portal): 接入 assistant-ui 文档对话弹窗

ff1b589

wabicai changed the title ~~feat(developer-portal): 接入 assistant-ui 文档 AI 对话弹窗~~ feat(developer-portal): 接入文档 AI 对话弹窗 Mar 3, 2026

wabicai marked this pull request as draft March 3, 2026 08:22

wabicai added 17 commits March 3, 2026 17:16

feat(developer-portal): 增加 Context7 本地网关与联调脚本

05b2418

fix(docs): 修复 AI 弹窗 markdown 渲染与布局样式

bb96b57

feat(docs): 对齐 inkeep 风格并补齐 gfm markdown 支持

45d8970

feat(docs): 切换到 Vercel AI SDK 自定义对话弹窗

d76d871

style(docs): 进一步对齐 Inkeep 弹窗视觉与交互

7a37772

style(docs): 细化 Inkeep 对齐风格和输入区交互

adb0f7f

style(docs): 优化输入框与发送按钮样式并对齐 Inkeep

9c0a706

style(docs): 去除分区线并继续贴近 Inkeep 面板层级

a9cf2d4

style(docs): 高精度对齐 Inkeep 弹窗布局与空态结构

6dedd36

refactor(docs): 拆分AI弹窗组件样式并修复markdown与输入框对齐

bea2710

fix(docs): 修复markdown代码渲染与输入框一体化样式

f66e7a7

fix(docs): 使用react-markdown节点信息修复代码块判定

56b3554

fix(docs-ai): 修复弹窗样式污染与输入框渲染问题

10ec05b

feat(docs-ai): 对齐 Inkeep 间距并增强 markdown 高亮

4668b69

perf(docs-ai): 修复流式渲染卡顿并调整弹窗尺寸间距

8bddc89

feat(developer-portal): 重构文档助手为居中Search/Ask AI交互

c9f09c7

Merge branch 'onekey' into codex/add-doc-ai-chat-widget

30c639e

wabicai changed the title ~~feat(developer-portal): 接入文档 AI 对话弹窗~~ feat(developer-portal): integrate docs AI chat widget Mar 5, 2026

feat(developer-portal): add docs ai chat experience

7ec8c89

fix(developer-portal): polish docs ai widget rendering

48b6d51

wabicai changed the title ~~feat(developer-portal): integrate docs AI chat widget~~ feat(developer-portal): integrate docs AI widget and landing updates Mar 11, 2026

wabicai marked this pull request as ready for review March 11, 2026 04:59

wabicai force-pushed the codex/add-doc-ai-chat-widget branch from 0bcf166 to 99d2b2d Compare March 13, 2026 03:37

wabicai and others added 5 commits March 13, 2026 11:37

Merge branch 'onekey' into codex/add-doc-ai-chat-widget

6efd90e

fix(playground): remove duplicate commit hash from header

2cc3a56

The commit hash is already displayed in the bottom corner, so the one in the header is redundant. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

fix(playground): add favicon.ico and update shortcut icon reference

1fe51e1

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(developer-portal): integrate docs AI widget and landing updates#687

feat(developer-portal): integrate docs AI widget and landing updates#687
wabicai wants to merge 26 commits intoonekeyfrom
codex/add-doc-ai-chat-widget

wabicai commented Mar 3, 2026 •

edited

Loading

Uh oh!

revan-zhang commented Mar 3, 2026 •

edited

Loading

Uh oh!

socket-security bot commented Mar 3, 2026 •

edited

Loading

Uh oh!

socket-security bot commented Mar 9, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

wabicai commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Validation

Notes

Uh oh!

revan-zhang commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Snyk checks have passed. No issues have been found so far.

Uh oh!

socket-security bot commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

socket-security bot commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

wabicai commented Mar 3, 2026 •

edited

Loading

revan-zhang commented Mar 3, 2026 •

edited

Loading

socket-security bot commented Mar 3, 2026 •

edited

Loading

socket-security bot commented Mar 9, 2026 •

edited

Loading