首页/快速开始/安装与启动

安装与启动

三端全覆盖,开箱即用。选择你的平台,开始和 AI 编程搭档一起工作。

下载 UseIO

UseIO 支持 Windows、macOS 和 Linux 三端平台。前往 下载页面 选择适合你系统的安装包。

💡
推荐使用镜像下载地址,国内网络环境下速度更快。GitHub Release 为官方源,需科学上网。

Windows 安装

  1. 下载 .exe 安装包(约 450MB)
  2. 双击运行安装程序,按提示完成安装
  3. 安装完成后从开始菜单或桌面图标启动 UseIO
  4. 首次启动时可按需设置启动验证密码,用于加密保护你的本地数据

macOS 安装

  1. 下载 .dmg 安装包(支持 Apple Silicon 和 Intel)
  2. 双击打开 .dmg,将 UseIO 拖入 Applications 文件夹
  3. 首次打开时如提示"无法验证开发者",前往系统设置 → 隐私与安全性 → 点击"仍要打开"

系统要求

平台最低系统版本架构磁盘空间
WindowsWindows 10 1809+x64> 2 GB
macOSmacOS 13 Ventura+Apple Silicon / Intel> 2 GB
LinuxUbuntu 20.04+x64> 2GB
首页/快速开始/首次配置

首次配置

安装完成后,进行简单的初始配置即可开始使用 UseIO。

配置大语言模型

UseIO 本身不内置大模型,需要你配置自己的模型 API。打开 左侧菜单 → 模型配置,填写以下信息:

配置项
# 以 OpenAI 兼容接口为例
API Base URL: https://api.openai.com/v1
API Key:      sk-xxxxxxxxxxxxxxxxxxxx
Model Name:   glm-5.3  # 或其他支持的模型

UseIO 兼容所有 OpenAI API 格式的模型服务,包括但不限于:

  • OpenAI — GLM / DeepSeek / Kimi / gpt / o4 等
  • Anthropic — claude-fable-5 / claude-opus-5 / claude-sonnet-5(通过兼容接口)
  • 本地模型 — Ollama / LM Studio / vLLM 等本地部署的模型
  • 第三方服务 — 阿里百炼 / 智谱 / 火山方舟 / 腾讯云等国内模型 API

模型配置方案

UseIO 支持多套模型配置方案,每套方案可以独立配置 5 个模型角色,适配不同场景的需求。你可以在对话框中随时切换方案,无需重新配置。

模型角色用途说明
通用默认模型未单独配置其他角色时,所有场景均使用通用模型
对话日常对话用于简单问答、概念解释等轻量交互场景
任务任务执行用于 Agent Loop 任务执行、代码生成等复杂场景,建议选择推理能力强的模型
视觉视觉分析用于屏幕读取、图片识别等视觉理解场景,需选择支持视觉的模型
记忆记忆处理用于记忆提取与摘要生成,可选择轻量模型以降低成本
💡
只需配置通用模型即可开始使用。其他角色为可选配置,按需设置即可——例如日常对话用轻量模型节省成本,复杂任务用强推理模型保证质量。

切换模型方案

切换模型方案有两种方式:

  • 对话框切换 — 在对话框右下角、发送图标按钮左侧,可以快速切换当前会话使用的模型配置方案,仅对当前会话生效
  • 模型配置页面启用 — 在模型配置页面中启用某个方案后全局生效,所有新会话默认使用该方案

不同方案可以针对不同场景优化——例如创建一套"经济方案"使用轻量模型降低日常成本,一套"高性能方案"使用最强模型应对复杂任务,按需切换。

模型温度设置

每个模型角色可以单独设置温度(Temperature)参数。对于最新的强推理模型(如 o4、kimi-k3 等),部分模型不支持自定义温度,可在模型配置中关闭自定义温度,使用模型默认值。

⚠️
视觉模型角色未配置时,屏幕读取分析和图片识别功能将不可用。建议在方案中配置视觉模型以获得完整体验。

设置工作空间

工作空间是 UseIO 操作文件的项目目录。UseIO 的所有文件读写、代码执行、命令运行都基于当前工作空间目录。

每个会话都可以独立设置不同的工作空间。对话界面顶部会显示一个工作空间栏,展示当前工作空间名称,点击即可在左侧打开工作空间抽屉栏。抽屉栏中可以查看当前工作空间的路径和文件树,并支持以下操作:

  • 更换目录 — 切换到其他文件夹作为当前会话的工作空间
  • 关闭空间 — 关闭当前工作空间,恢复为默认工作空间
  • 刷新 — 刷新文件树,同步目录中的最新变更
💡
工作空间按会话独立设置,不同会话可以使用不同的工作空间,互不影响。

启动验证密码(可选)

首次启动时,你可以按需设置一个启动验证密码。设置后,该密码用于加密保护你的本地数据(记忆、知识库、会话记录等),每次启动应用时需输入密码解锁;如不设置,可直接进入应用使用。

💡
密码存储在本地,不会上传任何服务器。如遗忘密码,可通过自动备份恢复数据。
首页/快速开始/核心概念

核心概念

了解 UseIO 的核心设计理念与关键术语,快速建立整体认知。

Agent Loop 引擎

UseIO 的核心是自研的 Agent Loop 引擎——一个能理解意图、拆解任务、调用工具、逐步执行、并验证交付结果的超级智能体。当你提出一个复杂需求时,引擎会自动将其分解为多个步骤,每步选择合适的工具执行,并根据执行结果决定下一步操作,直到任务完成。引擎还内置自纠错机制,遇到执行失败会自动分析原因、调整策略重试;同时配备三级递进死循环检测,在 Agent 陷入重复操作时及时终止,确保任务始终向前推进。

原子能力

UseIO 内置 20+ 项原子能力,是 Agent 执行任务的基础单元。每项能力对应一类操作,如文件读写、代码执行、命令行操作、浏览器自动化、桌面自动化、屏幕读取等。原子能力之间可以组合,形成复杂的工作流。

工具体系

在原子能力之上,UseIO 还提供 30 余种内置工具,涵盖文件操作、搜索、代码执行、进程管理、浏览器自动化等。工具按安全级别分为三级:SAFE(静默执行)、CAUTION(需确认)、DANGEROUS(始终需确认)。

记忆图谱

UseIO 拥有可视化的多层记忆系统:核心信息常驻对话上下文,相关历史按需语义召回,本地知识库在需要时自动注入。记忆不会随会话结束而消散,而是在本地持续沉淀。

知识库

基于本地向量嵌入模型的语义检索系统。你可以将笔记、文档、代码片段等保存为知识条目,UseIO 会在对话中自动检索并注入相关知识。

技能系统

通过 SKILL.md 文件定义自定义技能,扩展 UseIO 的能力边界。技能可以包含执行脚本、模板文件等,支持导入/导出和社区分享。

本地化

UseIO 100% 本地运行,没有云端服务。所有数据(记忆、知识库、会话记录、技能)都在你的设备上处理与存储,隐私零上传。除应用更新检查、联网搜索等由你主动触发的请求外,不会产生其他网络连接。

首页/使用指南/对话与任务执行

对话与任务执行

掌握 UseIO 的对话交互模式,让 AI 高效完成你的任务。

基本对话

在对话框中输入你的需求,按 Enter 发送。UseIO 会理解你的意图,自动判断是简单问答还是需要执行复杂任务。

  • 简单问答 — 概念解释、知识查询等,直接回答
  • 任务执行 — 编程开发、文件操作、数据分析等,自动进入 Task 模式

@提及功能

在对话框中输入 @ 可以触发提及菜单,快速引用工作空间中的文件、目录或技能:

提及类型语法说明
文件@文件:路径引用工作空间中的文件,自动读取内容
目录@目录:路径引用目录,自动列出内容
技能@技能:名称加载并使用指定技能

消息队列

当 AI 正在执行任务时,你可以继续输入后续指令。这些消息会进入消息队列,按顺序依次处理,无需等待当前任务完成。

多会话任务(后台任务)

UseIO 支持多会话任务:一个任务执行期间,你可以切换到其他会话开启新任务,原任务转入后台继续运行,两者互不阻塞。

  • 后台运行 — 任务在后台持续推进,无需停留在该会话,完成后回到对应会话即可查看结果
  • 并发上限 — 考虑到并发压力与电脑负荷,最多支持 3 个任务同时进行
💡
同时运行的任务越多,对 CPU、内存等资源的占用也越高。需要集中处理复杂任务时,建议适当减少后台任务数量。

任务确认机制

对于涉及文件写入、命令执行等操作,UseIO 会根据安全级别请求确认:

💡
你可以在设置中开启信任模式,开启后所有工具调用自动批准,无需逐次确认。适合在可信环境下提升效率。

上下文管理

长任务执行中,系统会智能管理上下文,自动压缩不重要的历史信息,同时确保关键信息不丢失。

首页/使用指南/语音输入

语音输入

本地离线语音转文字(SenseVoice),说话即输入,AI 自动润色纠错,全程本地运行、隐私零上传。

开启语音输入

打开 左侧菜单 → 设置 → 通用,在「语音输入」中开启开关。首次使用前需下载语音识别模型,支持四种下载源:

下载源说明
GitHub官方源,需科学上网
GH-ProxyGitHub 镜像加速,国内网络推荐
HuggingFace模型仓库官方源
HF-MirrorHuggingFace 镜像加速,国内网络推荐
💡
模型下载一次即可离线使用,转写全程在本地完成,不产生任何网络请求。也支持从本地归档包离线导入模型,适合内网环境。

使用语音输入

通过对话框输入区的麦克风按钮进行录音,录音结束后自动转写为文字插入输入框,随后由 AI 结合最近对话自动润色纠错:

  • 先插原文再润色 — 转写原文先插入输入框,润色完成后替换,不影响你正在输入的内容
  • 润色纠错可关闭 — 在设置中可关闭 AI 润色,任何润色失败都会自动回退为原始转写文本
  • 录音时长上限 — 单次录音有时长上限,达到上限自动结束并转写

模型管理

在设置页的语音输入区域可以管理语音识别模型:

  • 下载模型 — 选择下载源开始下载,实时查看下载进度
  • 离线导入 — 从本地模型归档包导入,无需联网
  • 删除模型 — 释放磁盘空间,可随时重新下载
  • 打开模型目录 — 查看模型在本地磁盘的存放位置

麦克风权限与隐私

首次使用语音输入时系统会请求麦克风权限。UseIO 仅在自身界面内使用麦克风,不会将麦克风授权给远程内容;录音数据仅在本地处理与转写,隐私零上传。

⚠️
语音识别模型未下载时无法使用语音输入,请先在设置中完成模型下载或离线导入。
首页/使用指南/文件与项目管理

文件与项目管理

UseIO 能直接在你的电脑上读写文件、管理目录,接管你的开发工作流。

工作空间目录树

界面左侧显示工作空间的文件目录树,支持展开/折叠、宽度拖动调整。右键菜单提供在浏览器中打开、复制路径等快捷操作。

文件读取

UseIO 支持读取多种文件格式,自动根据扩展名选择正确的读取方式:

  • 文本/代码文件 — txt/md/json/yaml/js/ts/vue/py 等,直接读取内容
  • Office 文档 — docx/pptx/xlsx/pdf,自动提取结构化内容
  • 图片文件 — png/jpg/jpeg/webp,调用视觉模型分析内容
💡
对于较大的文件,UseIO 会智能分段读取,确保内容完整呈现,无需手动处理。

文件编辑

UseIO 支持增量编辑,无需全量重写文件:

  • replace — 精确匹配并替换文本片段
  • insert — 在指定行号插入新内容
  • delete — 删除指定行

编辑前必须先读取文件确认当前内容。系统自动处理 CRLF/LF 换行符差异。

检查点与撤销

每次敏感操作(删除/移动/写入/编辑)前,系统自动创建检查点。你可以:

  • 撤销 — 回滚到上一个检查点状态
  • 重做 — 恢复被撤销的操作
💡
撤销操作会回滚该检查点之后的所有文件改动,调用前请确认。
首页/使用指南/代码执行与终端

代码执行与终端

UseIO 内置代码沙箱和集成终端,可以直接运行代码和命令。

JavaScript 沙箱

内置 JavaScript 执行环境,支持安全的模块访问,有代码大小和执行时间限制。

javascript
// 读取并统计目录中的文件数量
const fs = require('fs');
const path = require('path');

const dir = './src';
const files = fs.readdirSync(dir);
console.log(`Found ${files.length} files`);

Python 沙箱

内置 Python 执行环境,支持常见科学计算和数据处理库,有安全限制和执行时间限制。

集成终端

UseIO 内置集成终端,支持执行 shell 命令。分为两种模式:

  • 同步执行 — 命令执行完毕后返回 stdout/stderr,适合短命令
  • 常驻进程 — 后台运行不会退出的命令(如 dev server),立即返回 PID 和会话 ID
💡
常驻进程的输出可随时查看,也可在任务完成后手动终止。

多会话管理

支持同时管理多个终端会话,每个会话独立运行。可通过 action: "list" 列出所有正在运行的进程及其状态。

首页/使用指南/浏览器自动化

浏览器自动化

控制 Chrome 浏览器执行多步骤网页操作,实现数据采集、表单填写、信息查询等任务。

启动浏览器

UseIO 会自动尝试启动系统 Chrome。如浏览器未安装,需先安装 Chrome 浏览器。

核心操作

操作说明
navigate导航到指定 URL
get_state获取页面状态和可交互元素列表
click / type点击元素 / 输入文本
scroll滚动页面
extract_content提取页面内容
screenshot截取页面截图并分析
eval_in_page在页面上下文执行 JS
get_console_logs查询浏览器控制台日志
get_network_logs查询网络请求日志
get_network_request查看具体网络请求详情

操作流程

  1. 使用 navigate 打开目标网页
  2. 使用 get_state 获取页面元素列表和 ID
  3. 使用 click / type 操作具体元素
  4. 使用 extract_content 提取所需数据
⚠️
浏览器操作涉及用户隐私,导航/点击/输入等操作需要用户确认。只读操作(get_state/screenshot/wait)免确认。

SPA 页面处理

对于异步渲染的 SPA 页面,优先使用 wait_for_selector 等待目标元素出现,而非固定等待时间。

DevTools 观测能力

浏览器自动化集成了 DevTools 观测能力,可以在不干预页面的前提下,查询控制台日志和网络请求信息,用于排查页面异常的根因。这三项操作均为只读操作,免用户确认。

操作用途说明
get_console_logs控制台日志查询浏览器控制台输出,支持按级别过滤(log / info / warning / error / pageerror),默认仅返回 error 和 pageerror
get_network_logs网络请求列表查询页面发出的网络请求,支持按资源类型过滤(document / xhr / fetch / script 等),可筛选仅返回失败请求(HTTP 状态码 ≥ 400 或网络层失败)
get_network_request请求详情根据 requestId 查看具体网络请求的详细信息,包括请求头、响应状态码和响应体

典型排查场景

当浏览器自动化任务出现异常时(如点击无反应、页面白屏、数据未加载),可按以下思路排查:

  1. 使用 get_console_logs 查看控制台是否有 JavaScript 报错或未捕获异常
  2. 使用 get_network_logs 查看是否存在失败的网络请求(如接口 500、资源 404)
  3. 使用 get_network_request 查看失败请求的响应体,定位具体错误信息
  4. 根据根因调整操作策略,如等待元素加载完成后再操作、修正选择器等
💡
DevTools 观测能力让 UseIO 不仅能"操作"浏览器,还能"诊断"浏览器——像开发者打开 F12 一样,精准定位页面问题根因,再决策下一步操作。
首页/使用指南/屏幕读取与视觉分析

屏幕读取与视觉分析

UseIO 能查看你的电脑屏幕,配合视觉模型精准识别 UI 结构、错误信息、图表数据。

屏幕读取

UseIO 可以读取所有显示器的全屏画面,并调用视觉模型分析屏幕内容。多屏时返回多张画面,每张附带几何信息。

💡
描述你希望重点关注的区域(如“读出当前错误信息”“看右上角图标”),可显著提升分析精度。

图片文件分析

除了读屏,UseIO 还能直接读取本地图片文件(png/jpg/jpeg/webp)并分析内容。适用于分析 UI 设计稿、图表数据、截图等场景。

视觉模型配置

屏幕读取和图片分析依赖视觉模型。需在模型配置中配置一个支持视觉理解的模型(如 qwen3.8-max)。

⚠️
视觉模型未配置时,读屏和图片分析功能不可用。如已配置但调用失败,可能是模型上下文不足,建议切换更大上下文的模型。

隐私保护

读屏可能包含敏感信息(项目代号、文件名、聊天内容等)。分析结果回复时不会逐字罗列所有可见文字,仅围绕用户问题与关注重点回答。

首页/使用指南/桌面自动化

桌面自动化

UseIO 能像人一样操作你的电脑:看屏幕、点鼠标、敲键盘,控制浏览器之外的任意桌面应用。

能力概览

浏览器自动化负责网页内的操作,桌面自动化则把 UseIO 的执行范围扩展到整个操作系统——记事本、Office、系统设置、文件资源管理器等任何桌面应用都可以操控:

能力说明
屏幕感知截取屏幕画面并调用视觉模型分析,识别界面结构、按钮位置和当前状态
窗口管理枚举当前打开的窗口,将目标窗口带到前台
鼠标操作单击、双击、右键、拖拽,点按屏幕上的目标位置
键盘输入输入文本、模拟按键、组合键(如 Ctrl+C / Ctrl+V),支持中文输入
剪贴板读取或写入系统剪贴板,配合组合键实现可靠的文本输入
滚动在任意应用窗口内滚动页面

操作流程

桌面自动化遵循「先看后动」的节奏:

  1. 感知 — 截屏分析当前桌面状态,确认目标应用和界面元素
  2. 激活 — 将目标窗口带到前台,确保操作落在正确的应用上
  3. 操作 — 点击、输入、滚动,完成界面交互
  4. 验证 — 再次截屏确认操作生效,未生效则调整重试

与浏览器自动化的分工

场景推荐能力
网页元素点击、表单填写、网页数据采集浏览器自动化(元素级定位,更精准)
记事本 / Office / 系统设置等桌面应用操作桌面自动化
没有网页界面、只能通过客户端使用的软件桌面自动化
💡
两类能力会自动协同:网页内的操作优先使用浏览器自动化,浏览器之外交给桌面自动化,无需你手动指定。

安全确认

截屏分析、窗口枚举等只读操作无需确认;点击、输入等会改变系统状态的操作,需要你确认后才会执行。连续多轮操作无进展时,UseIO 会自动停下并向你说明,避免盲目重试。

⚠️
屏幕感知依赖视觉模型。请确保当前模型方案中已配置支持视觉理解的模型,否则截屏分析不可用。
首页/使用指南/自动化任务

自动化任务

预设指令 + 触发时机,让 UseIO 到点自动执行任务,无人值守完成例行工作。

什么是自动化任务

自动化任务让你把重复性的例行工作交给 UseIO 定时执行:提前写好预设指令并设定触发时机,到点后 UseIO 会在指定工作空间中自动执行指令,全程无需人工值守。适合每日新闻总结、定时数据整理、周期性报告生成等场景。

创建任务

在左侧菜单 → 自动化任务中点击新建,填写以下配置:

配置项说明
任务名称任务的可读名称,最长 30 字,如“每日行业新闻总结”
预设指令到点后 AI 自动执行的指令(Prompt),建议写明任务目标与输出要求,如“总结今天的 AI 行业新闻,输出为 Markdown 清单,重点标注国内动态”
触发方式任务何时触发,支持单次 / 每天 / 每周 / 每月 / Cron 表达式
工作空间任务执行时绑定的工作空间,可选默认空间、最近使用目录或自选本地目录

触发方式

触发方式配置项说明
单次指定时刻在指定时刻执行一次,过期后不再触发
每天时 : 分每天固定时刻执行
每周星期 + 时:分每周指定星期几的固定时刻执行
每月日期 + 时:分每月指定日期的指定时刻执行
CronCron 表达式使用标准 Cron 表达式定义触发计划,适合复杂调度规则

任务管理

任务列表支持按关键字搜索,并可按触发方式和运行状态筛选。每个任务支持以下操作:

  • 启用 / 禁用 — 禁用后任务不参与调度,可随时重新启用
  • 立即运行 — 不等触发点,手动立即执行一次
  • 停止运行 — 请求停止正在运行的任务,运行结束后状态更新
  • 编辑 — 修改名称、指令、触发配置或工作空间绑定
  • 运行记录 — 查看每次触发的历史与执行结果
  • 删除 — 删除任务后不再定时执行,历史运行记录保留

运行状态

状态说明
运行中任务正在执行
已完成本次执行正常结束
失败执行过程出错
已中止被手动停止
已跳过触发时未满足执行条件,本次跳过

工作空间绑定

每个任务可以绑定独立的工作空间:可选默认空间、最近使用的目录,或通过“选择目录”指定任意本地文件夹。任务执行时在该空间内工作,不会切换你当前前台正在使用的工作空间,互不干扰。

运行记录

每个任务都有独立的运行记录,记录每次触发的时间与结果状态。任务被删除后,历史运行记录仍会保留,方便回溯。

💡
预设指令写得越具体,执行效果越稳定。建议明确任务目标、输出格式与保存位置,如“总结今天的 AI 行业新闻,输出为 Markdown 清单,重点标注国内动态”。
⚠️
自动化任务到点自动执行、无人值守,请确保电脑处于开机状态,且当前模型方案配置可用。涉及文件写入等敏感操作时,请合理设置信任模式与指令内容。
首页/使用指南/文档解析与附件

文档解析与附件

UseIO 支持解析 Office 文档和 PDF,提取结构化内容,配合 OCR 识别图片中的文字。

支持的格式

格式扩展名处理方式
Word.docx / .odt / .rtf提取纯文本和元数据
PowerPoint.pptx / .odp提取幻灯片文本和结构
Excel.xlsx / .ods提取表格数据
PDF.pdf提取文本和结构化内容树

附件处理

在对话中发送附件时,系统会自动提取内容。提取质量因文件复杂度而异,复杂格式可能需要额外处理。

OCR 图片文字识别

对于文档中的图片,可启用 OCR 功能识别图片中的文字。支持中文(chi_sim)和英文(eng)两种语言。

💡
OCR 速度较慢,每张图片约 1-5 秒。内网环境可正常使用(本地 tessdata)。
首页/功能介绍/Agent Loop 引擎

Agent Loop 引擎

UseIO 的核心驱动力 — 自研 Agent Loop 引擎,不止于单步操作,而是驱动 AI 贴合用户目标,自主拆解并稳定执行长任务、复杂任务,交付高质量结果。

工作原理

Agent Loop 引擎采用感知-决策-执行-反馈的循环架构:

  1. 感知 — 理解用户意图,分析当前任务上下文
  2. 决策 — 拆解任务为多个步骤,选择合适的工具
  3. 执行 — 调用工具执行操作,获取执行结果
  4. 反馈 — 根据结果判断是否完成,决定下一步

这个循环会持续进行,直到任务完成或需要用户决策。

任务拆解

对于复杂任务,引擎会自动生成实施规划,将任务拆解为可执行的步骤。每个步骤都有清晰的状态跟踪,你可以实时了解任务进展。

死循环检测

引擎内置智能死循环检测机制,当 Agent 陷入重复操作或连续失败时会自动终止并反馈,避免无限循环消耗资源。

上下文管理

长任务执行中,系统会智能管理上下文,自动压缩不重要的历史信息,同时确保关键信息不丢失。

首页/功能介绍/原子能力与工具

原子能力与工具

20+ 项原子能力 + 30 余种内置工具,构成 UseIO 执行任务的基础设施。

原子能力

UseIO 内置丰富的原子能力,覆盖文件读写与编辑、目录管理、代码执行、命令行操作、进程管理、浏览器自动化、桌面自动化、屏幕读取、文档解析、记忆与知识库、技能加载、计划生成、用户交互等全方位操作场景。这些能力可自由组合,形成复杂的工作流。

安全分级

工具按安全级别分级管理:低风险操作静默执行,中风险操作需用户确认,高风险操作始终需要确认。你可以在设置中开启信任模式以自动批准所有操作。

首页/功能介绍/记忆图谱

记忆图谱

可视化的多层记忆系统,让 UseIO 用得越久越懂你。

记忆分层

UseIO 的记忆系统智能管理不同重要程度的信息:关键偏好和核心事实长期保留并常驻上下文,历史信息按需召回,临时信息在使用后自动清理。

语义召回

当对话中涉及历史信息时,UseIO 会通过语义检索从记忆库中召回相关记忆,自然融入回答。你不需要手动翻找历史对话。

记忆衰减

记忆有智能的生命周期管理,长期未被使用的记忆会自动降低优先级,保持记忆库的高效和准确。

自动维护

核心记忆由系统自动维护,无需手动操作。UseIO 会在对话中自动识别并记住你的偏好、习惯和重要信息。

💡
所有记忆数据都在本地处理与存储,隐私零上传。用得越久,记忆资产越多,AI 越懂你的习惯与偏好。
首页/功能介绍/知识库语义检索

知识库语义检索

本地语义检索引擎驱动,自动注入相关知识。

工作原理

UseIO 使用本地语义检索引擎对知识条目进行索引。对话时,系统自动检索与当前话题最相关的知识条目,注入到上下文中。

知识分类

知识库支持 5 个分类:

分类适用场景
tech技术知识、编程笔记
ideas创意想法、灵感记录
reading阅读笔记、文章摘要
work工作文档、项目记录
life生活备忘、日常记录

自动注入

当你询问过往笔记、技术知识、阅读记录等内容时,UseIO 会自动检索知识库并注入相关知识。检索到的知识会自然融入回答。

知识提取

通过知识提取元技能,可以从历史对话中自动提取有价值的信息保存为知识条目。也支持在历史对话列表中右键一键提取知识。

首页/功能介绍/技能系统

技能系统

通过 SKILL.md 自定义技能,扩展 UseIO 的能力边界,打造专属工作流。

什么是技能

技能是 UseIO 的可扩展能力单元。每个技能由一个 SKILL.md 元数据文件和可选的执行脚本、模板文件组成。加载技能后,UseIO 会按照 SKILL.md 中的指引执行任务。

内置技能

UseIO 预装了以下技能:

  • browser-automation — 浏览器自动化操作
  • skill-generator — 技能生成器,用于创建新技能
  • knowledge-extractor — 知识提取元技能

使用技能

有两种方式使用技能:

  • @提及 — 在对话框输入 @技能:名称 直接加载
  • 自动识别 — UseIO 根据任务描述自动判断是否需要加载某技能

导入与导出

技能支持导入和导出,方便在不同设备间同步或与社区分享。导出的技能包含完整的目录结构和所有资源文件。

首页/功能介绍/MCP 工具集成

MCP 工具集成

通过 MCP 协议接入外部工具,无限扩展 UseIO 的能力边界。

什么是 MCP

MCP(Model Context Protocol)是一种标准化的工具接入协议,允许 UseIO 与外部服务进行通信。通过 MCP,你可以将数据库查询、API 调用、第三方服务等接入 UseIO。

配置 MCP 工具

在设置中添加 MCP 服务器配置,指定服务器地址和可用工具。配置完成后,MCP 工具会自动出现在 UseIO 的工具列表中,Agent 可以像调用内置工具一样调用它们。

认证方式

MCP 服务器支持两种认证方式,在编辑服务器配置时选择:

认证方式说明
静态 Headers手动填写请求头(如 Bearer Token),适用于使用固定密钥的 MCP 服务
OAuth 2.1通过标准授权流程接入要求 OAuth 的远程 MCP 服务,授权与凭证由应用自动管理

OAuth 2.1 授权

UseIO 支持为远程 MCP 服务器接入 OAuth 2.1 授权,可直接连接 GitHub、Notion、Cloudflare 等要求 OAuth 认证的 MCP 服务,无需手动申请和填写长期 Token。

配置步骤

  1. 在 MCP 服务器配置中,将「认证方式」选择为 OAuth 2.1
  2. (可选)填写「授权范围 scope」,留空则由服务器按需自动请求
  3. (可选)填写「Client ID」,仅在授权服务器不支持动态注册时需要;留空由应用自动注册
  4. 保存后发起连接,应用会打开浏览器引导你完成授权,授权完成后自动建立连接

授权状态与凭证管理

  • 凭证明文不出本机 — OAuth 凭证经操作系统级加密(Windows DPAPI / macOS Keychain / Linux libsecret)存储,不落 IndexedDB,渲染进程无法读取
  • 自动续期 — 支持 refresh_token 无感刷新;Token 失效时进入「需要授权」状态,可按提示重新发起授权
  • 重新授权 / 退出授权 — 已授权的服务器可在列表中直接重新授权或退出授权
  • 配置变更自动失效 — 修改服务器地址、scope 或 Client ID 后,旧凭证自动清除,下次连接走全新授权
💡
OAuth 2.1 仅适用于远程 MCP 传输(Streamable HTTP / SSE)。本地 stdio 方式启动的 MCP 服务不支持 OAuth。
✅
采用标准授权码 + PKCE 流程,符合 MCP 安全最佳实践;授权 URL 会校验协议,仅允许 http/https。

使用场景

  • 接入 Context7 查询最新的库文档和代码示例
  • 接入数据库工具直接查询数据
  • 接入项目管理工具(Jira/Linear 等)操作任务
  • 接入 GitHub / Notion 等要求 OAuth 授权的第三方服务
  • 接入自定义 API 服务
💡
MCP 工具与内置工具使用方式完全一致,Agent 会根据任务需求自动选择合适的工具。
首页/进阶用法/自定义技能开发

自定义技能开发

通过 SKILL.md 规范创建你自己的技能,扩展 UseIO 的能力。

使用技能生成器

最简单的方式是使用内置的 skill-generator 技能。只需描述你想要的技能功能,UseIO 会自动生成完整的技能目录结构和所有资源文件。

对话示例
# 在对话框中输入
@技能:skill-generator
帮我创建一个技能,用于自动格式化项目中的所有代码文件

SKILL.md 结构

每个技能的核心是 SKILL.md 文件,包含以下元数据:

  • id — 技能唯一标识符
  • name — 技能名称
  • description — 技能描述和适用场景
  • 参考词 — 触发技能的关键词列表
  • 执行指引 — SKILL.md 正文,指导 Agent 如何执行

技能目录结构

目录结构
my-skill/
├── SKILL.md          # 元数据与执行指引
├── scripts/          # 执行脚本(可选)
│   └── run.sh
├── templates/        # 模板文件(可选)
│   └── output.md
└── files.json        # 子文件清单

质量校验

技能创建后需通过质量校验清单:格式统一、逻辑闭环、脚本可执行。确保每个技能都能稳定运行。

首页/进阶用法/记忆管理策略

记忆管理策略

了解 UseIO 的记忆管理机制,优化你的使用体验。

记忆重要性分级

每条记忆都有重要性标记,影响其在记忆库中的留存时间:

  • 重要 — 长期保留,如用户偏好、核心事实
  • 普通 — 正常生命周期,如工作记录
  • 临时 — 短期保留,会话后清理

记忆衰减机制

记忆会根据时间和使用频率自动衰减。不常被召回的记忆会逐渐降低优先级,最终被清理。这确保了记忆库始终保持高效和准确。

手动管理

你可以在记忆图谱界面中手动查看、编辑或删除记忆条目。对于不再需要的记忆,可以手动清理以保持记忆库的整洁。

记忆与知识库的区别

特性记忆知识库
生成方式对话中自动提取手动保存或提取
检索方式语义召回语义检索
生命周期自动衰减永久保留
用途记住用户偏好和历史存储参考资料和笔记
首页/进阶用法/知识库构建

知识库构建

系统性地构建你的个人知识库,让 UseIO 成为你越用越强的知识助手。

手动添加知识

在知识库界面中手动添加知识条目,每条包含标题、内容、分类和标签。

从对话中提取

两种方式从对话中提取知识:

  • 知识提取技能 — 加载 knowledge-extractor 技能,自动从当前对话中提取有价值的信息
  • 右键提取 — 在历史对话列表中右键,选择"一键提取知识"

知识分类最佳实践

💡
建议的分类策略:
• tech — 编程技巧、框架用法、踩坑记录
• reading — 书籍摘要、文章笔记、技术博客要点
• work — 项目文档、会议纪要、工作流程
• ideas — 产品创意、架构方案、改进想法
• life — 日常备忘、生活技巧

标签使用

为知识条目添加标签可以提高检索精度。建议使用简洁的关键词作为标签,如 vue、performance、deploy 等。

首页/常见问题/安装与运行

常见问题 · 安装与运行

安装和运行 UseIO 时遇到的常见问题解答。

Q: 下载速度很慢怎么办?

推荐使用镜像下载地址(GH-Proxy 加速),支持 IPv4 和 IPv6。GitHub Release 为官方源,国内网络可能需要科学上网。

Q: macOS 提示"无法验证开发者"怎么办?

前往 系统设置 → 隐私与安全性,找到提示 UseIO 的地方,点击"仍要打开"即可。

Q: 启动后白屏/闪退怎么办?

尝试以下步骤:

  1. 确保系统版本满足最低要求(Windows 10 1809+ / macOS 13+)
  2. 检查是否有杀毒软件拦截,尝试添加白名单
  3. 清除 UseIO 配置目录后重新启动

Q: 忘记启动验证密码怎么办?

启动验证密码用于加密本地数据,设置后无法找回。如遗忘密码,可通过自动备份恢复数据:卸载后重新安装,在首次启动时选择从备份恢复。

Q: Linux 版本什么时候发布?

Linux 版本目前处于 Beta 阶段(.AppImage 格式),正式版即将推出。请关注 GitHub Release 获取最新动态。

首页/常见问题/模型与配置

常见问题 · 模型与配置

模型 API 配置和使用中的常见问题。

Q: 支持哪些大语言模型?

UseIO 兼容所有 OpenAI API 格式的模型服务,包括 OpenAI GPT 系列、Anthropic Claude(通过兼容接口)、GLM、DeepSeek、Kimi等国内模型,以及 Ollama / LM Studio 等本地部署的模型。

Q: 如何配置模型?

以 GLM 为例,在模型配置中填写:

  • API Base URL: https://open.bigmodel.cn/api/paas/v4
  • API Key: 你的 API Key
  • Model Name: glm-5.3

Q: 视觉模型必须配置吗?

不是必须的。但未配置视觉模型时,屏幕读取分析和本地图片识别功能将不可用。建议配置以获得完整体验。

Q: 可以同时配置多个模型吗?

可以。UseIO 支持多套模型配置方案,每套方案可独立配置通用、对话、任务、视觉、记忆 5 个模型角色。你可以在对话框右下角发送按钮左侧随时切换方案,不同场景使用不同的模型组合。

Q: API 调用失败怎么排查?

  1. 检查 API Key 是否正确
  2. 检查 API Base URL 是否完整(包含 /v1 后缀)
  3. 检查网络连接是否正常
  4. 查看终端输出中的错误信息
首页/常见问题/功能使用

常见问题 · 功能使用

使用 UseIO 各功能时遇到的常见问题。

Q: UseIO 能操作工作空间外的文件吗?

可以,但需要使用绝对路径,且工作空间外的写操作会升级为 DANGEROUS 级别,需要额外确认。系统关键目录会被阻止操作。

Q: 浏览器自动化支持哪些浏览器?

目前支持 Chrome 浏览器。如未安装 Chrome,需先安装。UseIO 会自动尝试启动系统 Chrome。

Q: 桌面自动化和浏览器自动化有什么区别?

浏览器自动化针对网页内容,通过元素级定位操作,更精准可靠;桌面自动化针对浏览器之外的任意桌面应用(记事本、Office、系统设置等),通过截屏感知配合鼠标键盘操作完成。UseIO 会根据任务目标自动选择合适的能力,无需你手动指定。

Q: 代码沙箱有什么限制?

JavaScript 沙箱和 Python 沙箱均有代码大小和执行时间限制,并做了安全隔离,防止危险操作。

Q: 如何让 UseIO 更好地理解我的项目?

建议:

  • 使用 @目录:路径 让 UseIO 了解项目结构
  • 将项目文档、架构说明等保存到知识库
  • 在对话中明确说明技术栈和约束条件

Q: 连接要求登录授权的 MCP 服务(如 GitHub)怎么配置?

在 MCP 服务器配置中将「认证方式」选择为 OAuth 2.1,保存后发起连接,按提示在打开的浏览器页面完成授权即可。授权凭证由应用加密保存并支持自动续期,无需手动维护 Token。OAuth 2.1 仅适用于远程传输(Streamable HTTP / SSE),本地 stdio 服务不支持。

Q: Agent 执行任务时卡住了怎么办?

UseIO 内置死循环检测机制,Agent 陷入重复操作时会自动终止。如果长时间无响应,可以手动终止当前任务并重新描述需求。

首页/常见问题/隐私与安全

常见问题 · 隐私与安全

关于数据隐私和安全的常见问题。

Q: UseIO 会上传我的数据吗?

不会。UseIO 100% 本地运行,没有云端服务。所有数据(记忆、知识库、会话记录、技能)都在你的设备上处理与存储。除应用更新检查、联网搜索等由你主动触发的请求外,不会产生其他网络连接。

Q: 数据存储在哪里?

所有数据存储在本地应用数据目录中。若设置了启动验证密码,数据将进行加密保护。不同操作系统的存储位置:

  • Windows: %APPDATA%/UseIO
  • macOS: ~/Library/Application Support/UseIO
  • Linux: ~/.config/UseIO

Q: 如何备份数据?

UseIO 支持自动备份功能,会定期备份你的数据。你也可以在设置中手动触发备份。备份文件可以用于跨设备迁移或灾难恢复。

Q: 使用大模型 API 时数据安全吗?

UseIO 发送给大模型 API 的内容仅包含对话上下文和必要的任务信息。你的记忆、知识库等本地数据不会全部发送,仅在语义检索后将相关片段注入上下文。建议选择你信任的模型服务提供商。

Q: 启动验证密码的作用是什么?

启动验证密码是可选功能,用于加密保护你的本地数据。设置后,每次启动应用时需输入密码解锁;即使他人获取了你的设备,也无法直接读取你的数据。你也可以选择不设置,直接使用应用。

✅
UseIO 的隐私保护设计:本地优先、零云端、密码加密、自动备份。你的数据始终在你的掌控之中。