YuAI Tools 使用文档

2.1 全局交互与窗口能力

• 托盘常驻（含 Preferences、登录/退出入口）
• 全局快捷键呼出面板
  • Alt+R：主搜索面板
  • Alt+Ctrl+V：剪贴板面板
  • Alt+Ctrl+S：Snippet 面板
  • Esc：隐藏当前面板
• 主窗口置顶显示、失焦自动隐藏、返回原焦点应用
• 悬浮小组件（可拖拽定位，显示待处理数量徽标）
• 记住窗口位置（搜索面板位置、悬浮球位置）

2.2 统一搜索（Workflow 总线）

搜索面板会聚合多个工作流结果，并支持"使用习惯学习排序"（常用结果会逐步提前）。

搜索面板示例

2.3 JSON 工具（集成在搜索面板）

• 关键字触发：json
• 支持操作：
  • 从剪贴板粘贴 JSON
  • JSON 格式化
  • JSON 压缩
  • 复制格式化结果
  • 复制压缩结果
  • 节点折叠/展开
• 空输入时会尝试自动读取剪贴板 JSON 预填

2.4 剪贴板历史系统

• 自动监听剪贴板变化（文本/文件/图片）
• 持久化到本地 SQLite（去重 + 上限裁剪）
• 记录来源应用与时间
• 支持双栏视图：
  • 左侧列表检索
  • 右侧内容预览（文本/图片/文件列表）
• 回车可将选中内容重新写回剪贴板
• macOS 下支持回填后自动模拟粘贴

剪贴板面板示例

2.5 Snippet（文本片段）系统

• Snippet 面板：按 key/group/value 搜索并快速复制 value
• 全局输入自动展开：
  • 在任意输入场景输入已配置 key，可自动替换为 value
  • 支持边界判断与防抖逻辑
• 支持分组管理与条目管理（key/value）

2.6 Widget 小组件（待办 + Link Tab）

• 悬浮球单击展开/收起面板
• Todo Tab
  • 新增任务
  • 状态切换（未完成/已完成）
  • 截止日期编辑
  • 筛选：全部、今天、最近 7 天
  • 分页加载（未完成/已完成）
• Link Tab（自定义栏目）
  • 新增/编辑/删除栏目
  • 每个栏目绑定一个列表接口 URL
  • 支持分页加载、刷新、错误提示
  • 统计各栏目待处理总量
• 待办数徽标与通知
  • 悬浮球显示总待处理数（99+ 上限展示）
  • 某栏目待办增长时通知
  • Link Tab 刷新失败通知（含冷却抑制）

Widget 小组件示例

2.7 账号与云端 API 能力

• 邮箱密码登录
• AccessToken/RefreshToken 持久化
• 自动刷新 Token
• 认证失败自动登出
• 已接入云端能力：
  • Todo 列表/创建/更新
  • Link Tab 列表/创建/更新/删除

2.8 设置中心（Preferences）

设置中心示例

2.9 跨平台与系统集成

• 桌面框架：Avalonia（跨平台）
• 应用扫描与进程扫描支持 Win/macOS/Linux
• macOS 增强能力：
  • 原生窗口置顶与当前 Space 展示
  • 前台应用捕获与恢复
  • 系统通知
  • Safari 书签解析

2.10 书签浏览器 / 快捷书签（新增）

功能名：书签浏览器 / 快捷书签

功能介绍：收藏常用网址，按文件夹管理书签；内嵌浏览器支持快速预览，无需切换应用即可访问常用网页。

• 支持书签新增、编辑、删除与分组管理
• 支持按文件夹快速筛选，常用链接可一键直达
• 内嵌预览窗口可快速查看页面内容，减少应用切换
• 快捷键：Ctrl+Alt+B

2.11 搜索学习看板（新增）

在 Preferences -> Learning 查看学习数据概览：

• Learned Items（已学习条目数）
• Total Uses（累计命中使用次数）
• Last Updated（统计更新时间）

提供 Top 列表（默认最多 50 条）：

• 排名、标题、工作流来源、匹配字段
• GlobalUseCount、QueryUseCount、HotScore
• 最近使用时间

支持：

• Refresh：手动刷新统计快照
• Clear Learning Data：清空搜索学习数据并立即生效

4.1 主搜索面板

1. 按 Alt+R 呼出主面板。
2. 输入关键词（如 bm github、app rider、=3*(4+2)、uuid、encode hello world、qrcode https://example.com）。
3. 使用方向键选择结果，按回车执行。
4. Esc 可快速关闭并返回原应用。

4.2 JSON 模式

1. 输入 json 进入 JSON 模式。
2. 可直接粘贴 JSON，或点"粘贴"按钮从剪贴板导入。
3. 使用"整理/复制/复制压缩/全展/全收"完成处理。

4.3 剪贴板面板

1. 按 Alt+Ctrl+V 打开。
2. 输入关键字筛选历史内容。
3. 左侧选中项，右侧查看完整预览。
4. 回车将条目写回剪贴板（macOS 下自动尝试粘贴）。

4.4 Snippet 面板与自动展开

1. 在 Preferences -> Features -> Snippets 配置条目。
2. 按 Alt+Ctrl+S 打开 Snippet 面板，检索后回车快速复制。
3. 在任意输入框键入 snippet key，触发全局自动展开替换。

4.5 Widget（Todo）

1. 单击悬浮球打开 Widget。
2. 选择 Todo 页签：
   • 点击"新增任务"
   • 勾选状态切换完成/未完成
   • 设置截止日期
   • 通过"全部/今天待办/最近7天"切换视图
3. 使用"加载更多"分页浏览。

4.6 Widget（Link Tab）

1. 点击"新增栏目"，填写栏目名和接口 URL。
2. 栏目内点击"刷新"拉取列表数据。
3. 如有更多数据，点击"加载更多"分页获取。
4. 支持编辑栏目与删除栏目。

4.7 账号登录

1. 托盘菜单点击"登录"或在需要鉴权操作时按提示登录。
2. 输入邮箱和密码提交。
3. 登录成功后可访问 Todo/LinkTab 云端能力。
4. 托盘菜单点击"退出（邮箱）"可登出。

4.8 Learning 学习看板（新增）

1. 打开 Preferences -> Learning。
2. 查看三项总览指标：
   • 已学习条目数
   • 累计使用次数
   • 更新时间
3. 在列表中查看高热度条目（包含工作流来源、热度、最近使用时间）。
4. 点击 Refresh 手动刷新统计。
5. 点击 Clear Learning Data 清空学习记录（会重置个性化排序历史）。

5.1 目录结构

    WorkflowsRoot/
      MyWorkflow/
        manifest.json
        script.sh

5.2 manifest 示例

    {
      "name": "My Workflow",
      "keyword": "mw",
      "script": "script.sh",
      "action": "open",
      "icon": "icon.png"
    }

5.3 输出格式

支持 JSON：

    {
      "items": [
        { "title": "Title", "subtitle": "Sub", "arg": "value", "icon": "icon.png" }
      ]
    }

也兼容 XML items/item 结构。