zn-ai/docs/Vue-Exit-Checklist.md

zn-ai Vue 退场清单

目标：在 React 接管默认入口后，按清单删除所有仅服务 Vue 的资产，最终收敛为 React-only。

当前状态

• Home 的 React 主链路已经接入真实 chat/task/channel store、真实 IPC，以及 TaskOperationDialog / AddChannelDialog。
• Home 这批旧 Vue 文件目前仍被 src/router/index.ts -> src/pages/home/index.vue 的 Vue fallback 引用，因此本轮不能直接删除。
• 其余主页面虽然已有 src-react/pages/* 路由壳，但当前大多还是占位页，尚不满足“删除 Vue 路由与页面”的退场条件。

当前删除策略：

1. 先停止新增对 src/pages/home/**、src/stores/chat.ts、src/stores/task.ts、src/stores/channel.ts 的 React 侧依赖。
2. 等 Agents / Knowledge / Skills / Cron / Scripts / Setting / Login 的 React 页面完成真实迁移后，再统一删除 src/router/*、.vue 页面和旧 Pinia store。
3. 在此之前，只做“替换引用”和“收口依赖”，不做会破坏 Vue fallback 的物理删除。

1. 入口与切换层

• src/main-vue.ts
• src/framework.ts
• src/main.ts
• src/App.vue
• src/permission.ts

退场标准：

• src/main.ts 不再分流 Vue 入口。
• src/framework.ts 不再保留 vue 分支。
• src/main-vue.ts 删除。
• src/App.vue 和 src/permission.ts 只要还依赖 Vue 生命周期或 Router 守卫，就必须迁入 React 后再删除旧文件。

2. Vue 页面

以下页面都属于 Vue 退场范围，React 版本完成后删除：

• src/pages/home/index.vue
• src/pages/home/ChatBox.vue
• src/pages/home/ChatHistory.vue
• src/pages/home/TaskCenter.vue
• src/pages/home/components/*.vue
• src/pages/login/index.vue
• src/pages/agents/index.vue
• src/pages/knowledge/index.vue
• src/pages/skills/index.vue
• src/pages/skills/components/*.vue
• src/pages/cron/index.vue
• src/pages/cron/components/*.vue
• src/pages/setting/index.vue
• src/pages/setting/components/*.vue

建议删除顺序：

1. 先迁 home，再迁其余业务页。
2. 先删纯展示/表单页，再删聊天主链路。
3. 最后统一清理页面下的 Vue 子组件目录。

3. Vue Store

以下 Pinia store 是 Vue 体系的核心状态，React 完成对等实现后删除：

• src/stores/chat.ts
• src/stores/providers.ts
• src/stores/channel.ts
• src/stores/cron.ts
• src/stores/script.ts
• src/stores/skills.ts
• src/stores/task.ts
• src/stores/theme.ts
• src/stores/locale.ts
• src/stores/update.ts
• src/stores/userinfo.ts
• src/stores/sharedStore.ts

退场标准：

• React 侧已具备对等 store 后，旧 Pinia store 不再被任何路由或组件引用。
• src/stores/* 不再承担主流程状态。

4. Router 与守卫

需要替换或删除的 Vue 路由资产：

• src/router/index.ts
• src/constant/menus.ts
• src/permission.ts
• src/components/SideMenus/index.vue

退场标准：

• 路由切换完全由 React Router 接管。
• 菜单配置不再依赖 Vue 路由表。
• 登录守卫迁到 React 侧后，旧守卫文件删除。

5. 仅服务 Vue 的共享组件

这些组件如果只被 Vue 页面使用，应在 React 对等实现后删除：

• src/components/Layout/index.vue
• src/components/Layout/TitleBar/index.vue
• src/components/NativeTooltip/index.vue
• src/components/Pagination/index.vue
• src/components/TitleSection/index.vue

6. Vue 依赖与构建项

package.json 中后续需要删除或替换的 Vue 依赖：

• vue
• vue-router
• pinia
• vue-i18n
• element-plus
• @vueuse/core
• @vitejs/plugin-vue
• @lucide/vue
• @remixicon/vue
• vue-codemirror
• vue-markdown-render

vite.config.ts 中后续需要清理的 Vue 构建项：

• vue() 插件
• unplugin-auto-import 的 Vue 自动导入配置
• 与 Vue 页面强绑定的 src/auto-imports.d.ts 生成链路
• 所有仅为 Vue 入口保留的分支判断

7. 最终删除判定

只有在以下条件都满足后，才允许进入最终清理提交：

• 默认入口只剩 React。
• 所有主页面都已迁到 src-react/。
• src/pages/** 中不再存在可执行的 Vue 页面。
• src/stores/** 中不再存在被运行时调用的 Vue 状态。
• package.json 和 vite.config.ts 中不再保留 Vue 构建依赖。
• 仓库中不再需要 VITE_UI_FRAMEWORK=vue 作为运行开关。