窗口
窗口 API 用于显示或隐藏主窗口、退出插件、调整高度、打开独立窗口、跨插件跳转和控制宿主标题栏。
showMainWindow
显示并聚焦 ToolZen 主窗口。返回 false 表示当前宿主没有可用主窗口。
api.showMainWindow(): Promise<boolean>
setExpendHeight
调整主窗口内容高度。方法名沿用兼容 API 的拼写；独立窗口调用返回 0。
api.setExpendHeight(
height: number,
options?: { minimumHeight?: number; animate?: boolean; durationMs?: number }
): Promise<number>
await api.setExpendHeight(560, { minimumHeight: 420, animate: true })
height 会由宿主限制在当前屏幕可用范围内，返回值是实际落地的高度。
hideMainWindow
最小化主窗口，不会主动卸载当前插件。
api.hideMainWindow(): void
if (api && api.hideMainWindow) api.hideMainWindow()
outPlugin
主窗口中返回搜索首页；独立窗口中关闭当前插件窗口。
if (api && api.outPlugin) api.outPlugin()
detachWindow
将当前插件分离为独立窗口。
api.detachWindow(options?: PluginDetachWindowOptions): Promise<boolean>
type PluginDetachWindowOptions = {
title?: string
featureCode?: string
initialText?: string
width?: number
height?: number
}
const opened = api && api.detachWindow
? await api.detachWindow({
title: '文本工作台',
initialText: text.value,
width: 720,
height: 560
})
: false
isDetachedWindow
判断当前实例是否运行在独立窗口中。
api.isDetachedWindow(): boolean
const detached = Boolean(api && api.isDetachedWindow && api.isDetachedWindow())
getWindowType
读取当前插件窗口类型。
api.getWindowType(): 'main' | 'detach'
'main' 表示插件运行在主窗口工作区，'detach' 表示运行在可调整尺寸的独立窗口。
redirect
打开另一个已安装插件，并把可选文本传给目标插件。
api.redirect(code: string, payload?: string): void
if (api && api.redirect) api.redirect('json_toolbox', text.value)
setSubtitle
设置宿主标题栏中插件名右侧的功能副标题，最多 40 个字符。传空字符串可清除。
api.setSubtitle(text: string): void
if (api && api.setSubtitle) api.setSubtitle('文本工作台')
setDetachPayload
注册一个函数，让宿主在用户双击标题栏分离窗口时读取最新内容。
api.setDetachPayload(
provider: (() => PluginDetachWindowOptions | null | void) | null
): void
if (api && api.setDetachPayload) {
api.setDetachPayload(() => ({
initialText: text.value,
width: 720,
height: 560
}))
}
组件卸载时调用 api.setDetachPayload(null) 取消注册。
isDarkColors
读取宿主当前是否使用深色主题。
api.isDarkColors(): boolean
const dark = Boolean(api && api.isDarkColors && api.isDarkColors())
插件不要自绘宿主标题栏，也不要声明 -webkit-app-region: drag。