100 lines
4.0 KiB
Markdown
100 lines
4.0 KiB
Markdown
# 我的提示词弹窗与工具窗口启用经验
|
||
|
||
更新日期：2026-04-27
|
||
|
||
## 背景
|
||
|
||
提示词选择器标题从“提示词”改为“我的提示词”后，点击标题需要打开同名工具窗口，并进入当前生成类型对应的分类筛选。
|
||
|
||
这条链路横跨 AI 输入栏、提示词选择器、工具窗口服务、WinBox 管理器和“我的提示词”工具本体。问题不是单个按钮文案，而是“轻量入口如何唤醒重工具窗口”的协作边界。
|
||
|
||
## 问题现象
|
||
|
||
- 第一次点击“我的提示词”没有弹出窗口。
|
||
- 控制台显示 `toolWindowService.openTool` 已创建 `prompt-history` 实例，状态也是 `open`。
|
||
- 用户看到的状态却像是窗口仍在左侧工具栏或没有出现。
|
||
|
||
关键日志：
|
||
|
||
```text
|
||
[PromptHistoryPopover] open my prompts beforeStatus: undefined
|
||
[ToolWindowService] openTool:new-instance status: open
|
||
[PromptHistoryPopover] requested my prompts open afterStatus: open
|
||
```
|
||
|
||
这说明服务层状态已成功打开，问题不在 `openTool` 本身，而在渲染这个状态的 WinBox 管理器没有提前启用。
|
||
|
||
## 根因
|
||
|
||
`ToolWinBoxManager` 是延迟功能，只有 `toolWindowManagerEnabled` 为 true 时才挂载。左侧工具栏按钮会通过 `enableToolWindows` 先启用工具窗口运行时，再打开工具。
|
||
|
||
提示词选择器属于 AI 输入栏里的轻量入口，最初直接调用：
|
||
|
||
```ts
|
||
toolWindowService.openTool(tool, { componentProps });
|
||
```
|
||
|
||
这会造成一种半成功状态：
|
||
|
||
- 服务层已经有 `open` 实例。
|
||
- 管理器尚未挂载，因此没有 WinBox 来消费和渲染这条状态。
|
||
- 后续其它入口启用工具窗口后，之前的状态才可能显现，用户会误以为第一次点击失败。
|
||
|
||
## 修复思路
|
||
|
||
打开“我的提示词”前先唤醒工具窗口管理器，再调用 `openTool`。
|
||
|
||
落地方式：
|
||
|
||
- `Drawnix` 将现有 `enableToolWindows` 传给 `DeferredAIInputBar`。
|
||
- `DeferredAIInputBar` 继续传给 `AIInputBar`。
|
||
- `AIInputBar` 再传给 `PromptHistoryPopover`。
|
||
- `PromptHistoryPopover` 在点击“我的提示词”时先调用 `onBeforeOpenMyPrompts`，再 `openTool`。
|
||
|
||
这样入口不再依赖隐式全局状态，且复用已有工具窗口启用机制。
|
||
|
||
## 分类筛选经验
|
||
|
||
打开“我的提示词”时，要把当前生成类型作为 `componentProps.initialCategory` 传入：
|
||
|
||
```ts
|
||
toolWindowService.openTool(tool, {
|
||
componentProps: {
|
||
initialCategory: generationType,
|
||
},
|
||
});
|
||
```
|
||
|
||
“我的提示词”工具接收 `initialCategory` 后：
|
||
|
||
- 初始化分类为对应类型。
|
||
- 复用已打开窗口时同步切换分类。
|
||
- 清空旧的搜索词和 Skill 筛选，避免上一次筛选污染当前入口。
|
||
|
||
## 日志定位经验
|
||
|
||
这类跨层 UI 问题要按状态流分层打点：
|
||
|
||
- 入口层：点击前后的 `getToolState`。
|
||
- 服务层：`openTool` 的 launchMode、复用/新建分支、实例状态。
|
||
- 渲染层：`ToolWinBoxManager` 是否收到对应状态。
|
||
- 工具栏层：最小化/常驻图标点击时的状态。
|
||
|
||
如果服务层显示 `status: open`，但渲染层没有日志，优先检查管理器是否启用，而不是继续追 `openTool`。
|
||
|
||
## 后续规则
|
||
|
||
- 轻量入口打开 WinBox 工具前，必须先启用工具窗口管理器。
|
||
- `openTool` 成功不代表 UI 已渲染，必须确认消费状态的管理器已挂载。
|
||
- 入口传业务上下文用 `componentProps`，不要用全局变量或窗口级临时状态。
|
||
- 复用窗口时要显式同步筛选条件，避免保留上一次入口的 UI 状态。
|
||
- 定位日志要分层、带 instanceId/status/isLauncher/isPinned，问题确认后再移除或降级。
|
||
|
||
## 回归检查清单
|
||
|
||
- 首次点击提示词选择器标题是否立即打开“我的提示词”窗口？
|
||
- 窗口已最小化时，再次点击标题是否恢复窗口？
|
||
- 当前生成类型为图片/视频/音频/文本/Agent 时，是否进入对应分类？
|
||
- 搜索词或 Skill 筛选是否不会污染下一次从选择器打开？
|
||
- 控制台是否能看到入口、服务层和 WinBox 管理器的状态链路？
|