docs: align search with workspace header UX

This commit is contained in:
2026-06-29 04:16:01 +08:00
parent 16eb932be2
commit 614eecc8a3
4 changed files with 134 additions and 1 deletions
@@ -23,6 +23,14 @@ Current implementation status:
`ReadPluginDataJSON` and `WritePluginDataJSON`, but the frontend plugin API
currently exposes only `settings`.
UX direction:
- the primary search entry point belongs in the workspace header next to the
workspace title;
- `verstak.search` remains the owner of indexing and provider hosting;
- a standalone Search workspace item may stay as an expanded results surface,
but it is not the primary entry point.
No visual companion is needed for this design because the decision is about
runtime contracts and data flow, not layout.
@@ -82,9 +90,13 @@ Use the recommended approach.
`verstak.search` becomes both:
- the workspace search UI;
- the workspace search runtime and expanded results UI;
- the runtime host for all enabled `searchProviders`.
The shell may render the compact input in the workspace header, but it should
call into the Search plugin/runtime contract rather than implement search
semantics in core.
The desktop and SDK expose a generic frontend storage surface:
```ts