From 0ef7dd8fc2f2ed2fef2f5fd8f10ab93b2731d2da Mon Sep 17 00:00:00 2001
From: JYC333 <22962980+JYC333@users.noreply.github.com>
Date: Mon, 9 Mar 2026 15:57:47 +0000
Subject: [PATCH] refactor: minor cleanup

---
 .agents/migration_plan_autocomplete.md        | 14 +++++++++++++-
 apps/client/src/services/note_autocomplete.ts |  4 +---
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/.agents/migration_plan_autocomplete.md b/.agents/migration_plan_autocomplete.md
index f1e1ed8272..fa00076c1c 100644
--- a/.agents/migration_plan_autocomplete.md
+++ b/.agents/migration_plan_autocomplete.md
@@ -22,6 +22,8 @@
 1. **不使用 wrapper/适配层**，直接在各 service 中调用 `autocomplete()` API
 2. 消费者代码需要适配：传入容器 `<div>` 而非 `<input>`，通过 API/回调读写值
 3. 增量迁移：每个使用点独立迁移，逐一验证
+4. **优先保留旧版业务逻辑与交互语义**：迁移时默认以旧版 `autocomplete.js` 行为为准，不主动重设计状态流或交互。
+5. **只有在新旧包能力或生命周期模型存在冲突、无法直接一一映射时，才允许添加补丁逻辑**；这类补丁的目标不是“接近”，而是尽可能恢复与旧版完全相同的 behavior。
 
 ### 涉及的功能区域
 1. **属性名称自动补全** — `attribute_autocomplete.ts` → `attribute_detail.ts`、`RelationMap.tsx`
@@ -138,12 +140,22 @@
 
 ---
 
-### Step 4: 迁移辅助函数
+### Step 4: 迁移辅助函数 ✅ 完成
 **文件变更：**
 - `apps/client/src/services/note_autocomplete.ts` — `clearText`, `setText`, `showRecentNotes` 等函数
 
 **说明：**
 这些函数使用旧库的操作 API（`$el.autocomplete("val", value)` 等），需要改为新库的 `api.setQuery()` / `api.setIsOpen()` / `api.refresh()`。
+这一步与 **Step 3.4** 有交叉，但并不重复：
+- **Step 3.4** 关注的是 IME、快捷键、按钮点击后的交互语义是否与旧版一致
+- **Step 4** 关注的是 helper 函数本身是否已经彻底切到新 API，而不再依赖旧版 `.autocomplete("...")`
+
+**当前完成情况：**
+- ✅ `clearText()` 已改为通过 headless instance 清空 query、关闭面板并触发 `change`
+- ✅ `setText()` 已改为通过 `showQuery()` 驱动 `setQuery()` / `refresh()`
+- ✅ `showRecentNotes()` 已改为走 `openRecentNotes()`，不再依赖旧版 `.autocomplete("open")`
+- ✅ `showAllCommands()` 已改为直接设置 `">"` query 打开命令面板
+- ✅ `fullTextSearch()` 已改为使用新状态流重跑全文搜索
 
 **验证方式：**
 - 最近笔记按钮 → 下拉菜单正常打开
diff --git a/apps/client/src/services/note_autocomplete.ts b/apps/client/src/services/note_autocomplete.ts
index f030670b17..5f25bd99c8 100644
--- a/apps/client/src/services/note_autocomplete.ts
+++ b/apps/client/src/services/note_autocomplete.ts
@@ -63,7 +63,6 @@ interface ManagedInstance {
     panelEl: HTMLElement;
     clearCursor: () => void;
     isPanelOpen: () => boolean;
-    getQuery: () => string;
     suppressNextClosedReset: () => void;
     showQuery: (query: string) => void;
     openRecentNotes: () => void;
@@ -189,7 +188,7 @@ function createSuggestionSource(options: Options, onSelectItem: (item: Suggestio
     return {
         sourceId: "note-suggestions",
         async getItems({ query }: { query: string }) {
-            return await fetchSuggestions(query, options);
+            return await fetchResolvedSuggestions(query, options);
         },
         getItemInputValue({ item }: { item: Suggestion }) {
             return getSuggestionInputValue(item);
@@ -789,7 +788,6 @@ function initNoteAutocomplete($el: JQuery<HTMLElement>, options?: Options) {
         panelEl,
         clearCursor,
         isPanelOpen: () => wasPanelOpen,
-        getQuery: () => currentQuery,
         suppressNextClosedReset,
         showQuery,
         openRecentNotes,