三端全覆盖，开箱即用。选择你的平台，开始和 AI 编程搭档一起工作。
UseIO 支持 Windows、macOS 和 Linux 三端平台。前往 下载页面 选择适合你系统的安装包。
.exe 安装包（约 300MB）.dmg 安装包（支持 Apple Silicon 和 Intel）.dmg，将 UseIO 拖入 Applications 文件夹| 平台 | 最低系统版本 | 架构 | 磁盘空间 |
|---|---|---|---|
| Windows | Windows 10 1809+ | x64 | > 2 GB |
| macOS | macOS 11 Big Sur+ | Apple Silicon / Intel | > 2 GB |
| Linux | Ubuntu 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 格式的模型服务，包括但不限于：
如需使用屏幕读取与视觉分析功能，需额外配置一个支持视觉的模型（如 qwen3.8-max）。在设置中开启视觉模型选项并填写对应的 API 信息。
工作空间是 UseIO 操作文件的项目目录。UseIO 的所有文件读写、代码执行、命令运行都基于当前工作空间目录。
每个会话都可以独立设置不同的工作空间。对话界面顶部会显示一个工作空间栏，展示当前工作空间名称，点击即可在左侧打开工作空间抽屉栏。抽屉栏中可以查看当前工作空间的路径和文件树，并支持以下操作：
首次启动时，你可以按需设置一个启动验证密码。设置后，该密码用于加密保护你的本地数据（记忆、知识库、会话记录等），每次启动应用时需输入密码解锁；如不设置，可直接进入应用使用。
了解 UseIO 的核心设计理念与关键术语，快速建立整体认知。
UseIO 的核心是自研的 Agent Loop 引擎——一个能理解意图、拆解任务、调用工具、逐步执行、并验证交付结果的超级智能体。当你提出一个复杂需求时，引擎会自动将其分解为多个步骤，每步选择合适的工具执行，并根据执行结果决定下一步操作，直到任务完成。引擎还内置自纠错机制，遇到执行失败会自动分析原因、调整策略重试；同时配备三级递进死循环检测，在 Agent 陷入重复操作时及时终止，确保任务始终向前推进。
UseIO 内置 18 项原子能力，是 Agent 执行任务的基础单元。每项能力对应一类操作，如文件读写、代码执行、命令行操作、屏幕读取等。原子能力之间可以组合，形成复杂的工作流。
在原子能力之上，UseIO 还提供 30 余种内置工具，涵盖文件操作、搜索、代码执行、进程管理、浏览器自动化等。工具按安全级别分为三级：SAFE（静默执行）、CAUTION（需确认）、DANGEROUS（始终需确认）。
UseIO 拥有可视化的多层记忆系统：核心信息常驻对话上下文，相关历史按需语义召回，本地知识库在需要时自动注入。记忆不会随会话结束而消散，而是在本地持续沉淀。
基于本地向量嵌入模型的语义检索系统。你可以将笔记、文档、代码片段等保存为知识条目，UseIO 会在对话中自动检索并注入相关知识。
通过 SKILL.md 文件定义自定义技能，扩展 UseIO 的能力边界。技能可以包含执行脚本、模板文件等，支持导入/导出和社区分享。
UseIO 100% 本地运行，没有云端服务。所有数据（记忆、知识库、会话记录、技能）都在你的设备上处理与存储，隐私零上传。唯一的网络请求是你配置的大模型 API。
掌握 UseIO 的对话交互模式，让 AI 高效完成你的任务。
在对话框中输入你的需求，按 Enter 发送。UseIO 会理解你的意图，自动判断是简单问答还是需要执行复杂任务。
在对话框中输入 @ 可以触发提及菜单，快速引用工作空间中的文件、目录或技能：
| 提及类型 | 语法 | 说明 |
|---|---|---|
| 文件 | @文件：路径 | 引用工作空间中的文件，自动读取内容 |
| 目录 | @目录：路径 | 引用目录，自动列出内容 |
| 技能 | @技能：名称 | 加载并使用指定技能 |
当 AI 正在执行任务时，你可以继续输入后续指令。这些消息会进入消息队列，按顺序依次处理，无需等待当前任务完成。
对于涉及文件写入、命令执行等操作，UseIO 会根据安全级别请求确认：
长任务执行中，系统会智能管理上下文，自动压缩不重要的历史信息，同时确保关键信息不丢失。
UseIO 能直接在你的电脑上读写文件、管理目录，接管你的开发工作流。
界面左侧显示工作空间的文件目录树，支持展开/折叠、宽度拖动调整。右键菜单提供在浏览器中打开、复制路径等快捷操作。
UseIO 支持读取多种文件格式，自动根据扩展名选择正确的读取方式：
UseIO 支持增量编辑，无需全量重写文件：
编辑前必须先读取文件确认当前内容。系统自动处理 CRLF/LF 换行符差异。
每次敏感操作（删除/移动/写入/编辑）前，系统自动创建检查点。你可以：
UseIO 内置代码沙箱和集成终端，可以直接运行代码和命令。
内置 JavaScript 执行环境，支持安全的模块访问，有代码大小和执行时间限制。
// 读取并统计目录中的文件数量
const fs = require('fs');
const path = require('path');
const dir = './src';
const files = fs.readdirSync(dir);
console.log(`Found ${files.length} files`);内置 Python 执行环境，支持常见科学计算和数据处理库，有安全限制和执行时间限制。
UseIO 内置集成终端，支持执行 shell 命令。分为两种模式：
支持同时管理多个终端会话，每个会话独立运行。可通过 action: "list" 列出所有正在运行的进程及其状态。
控制 Chrome 浏览器执行多步骤网页操作，实现数据采集、表单填写、信息查询等任务。
UseIO 会自动尝试启动系统 Chrome。如浏览器未安装，需先安装 Chrome 浏览器。
| 操作 | 说明 |
|---|---|
| navigate | 导航到指定 URL |
| get_state | 获取页面状态和可交互元素列表 |
| click / type | 点击元素 / 输入文本 |
| scroll | 滚动页面 |
| extract_content | 提取页面内容 |
| screenshot | 截取页面截图并分析 |
| eval_in_page | 在页面上下文执行 JS |
navigate 打开目标网页get_state 获取页面元素列表和 IDclick / type 操作具体元素extract_content 提取所需数据对于异步渲染的 SPA 页面，优先使用 wait_for_selector 等待目标元素出现，而非固定等待时间。
UseIO 能查看你的电脑屏幕，配合视觉模型精准识别 UI 结构、错误信息、图表数据。
UseIO 可以读取所有显示器的全屏画面，并调用视觉模型分析屏幕内容。多屏时返回多张画面，每张附带几何信息。
除了读屏，UseIO 还能直接读取本地图片文件（png/jpg/jpeg/webp）并分析内容。适用于分析 UI 设计稿、图表数据、截图等场景。
屏幕读取和图片分析依赖视觉模型。需在模型配置中配置一个支持视觉理解的模型（如 qwen3.8-max）。
读屏可能包含敏感信息（项目代号、文件名、聊天内容等）。分析结果回复时不会逐字罗列所有可见文字，仅围绕用户问题与关注重点回答。
UseIO 支持解析 Office 文档和 PDF，提取结构化内容，配合 OCR 识别图片中的文字。
| 格式 | 扩展名 | 处理方式 |
|---|---|---|
| Word | .docx / .odt / .rtf | 提取纯文本和元数据 |
| PowerPoint | .pptx / .odp | 提取幻灯片文本和结构 |
| Excel | .xlsx / .ods | 提取表格数据 |
| 提取文本和结构化内容树 |
在对话中发送附件时，系统会自动提取内容。提取质量因文件复杂度而异，复杂格式可能需要额外处理。
对于文档中的图片，可启用 OCR 功能识别图片中的文字。支持中文（chi_sim）和英文（eng）两种语言。
UseIO 的核心驱动力 — 自研 Agent Loop 引擎，不止于单步操作，而是驱动 AI 贴合用户目标，自主拆解并稳定执行长任务、复杂任务，交付高质量结果。
Agent Loop 引擎采用感知-决策-执行-反馈的循环架构：
这个循环会持续进行，直到任务完成或需要用户决策。
对于复杂任务，引擎会自动生成实施规划，将任务拆解为可执行的步骤。每个步骤都有清晰的状态跟踪，你可以实时了解任务进展。
引擎内置智能死循环检测机制，当 Agent 陷入重复操作或连续失败时会自动终止并反馈，避免无限循环消耗资源。
长任务执行中，系统会智能管理上下文，自动压缩不重要的历史信息，同时确保关键信息不丢失。
18 项原子能力 + 30 余种内置工具，构成 UseIO 执行任务的基础设施。
UseIO 内置丰富的原子能力，覆盖文件读写与编辑、目录管理、代码执行、命令行操作、进程管理、浏览器自动化、屏幕读取、文档解析、记忆与知识库、技能加载、计划生成、用户交互等全方位操作场景。这些能力可自由组合，形成复杂的工作流。
工具按安全级别分级管理：低风险操作静默执行，中风险操作需用户确认，高风险操作始终需要确认。你可以在设置中开启信任模式以自动批准所有操作。
可视化的多层记忆系统，让 UseIO 用得越久越懂你。
UseIO 的记忆系统智能管理不同重要程度的信息：关键偏好和核心事实长期保留并常驻上下文，历史信息按需召回，临时信息在使用后自动清理。
当对话中涉及历史信息时，UseIO 会通过语义检索从记忆库中召回相关记忆，自然融入回答。你不需要手动翻找历史对话。
记忆有智能的生命周期管理，长期未被使用的记忆会自动降低优先级，保持记忆库的高效和准确。
核心记忆由系统自动维护，无需手动操作。UseIO 会在对话中自动识别并记住你的偏好、习惯和重要信息。
本地语义检索引擎驱动，自动注入相关知识。
UseIO 使用本地语义检索引擎对知识条目进行索引。对话时，系统自动检索与当前话题最相关的知识条目，注入到上下文中。
知识库支持 5 个分类：
| 分类 | 适用场景 |
|---|---|
| tech | 技术知识、编程笔记 |
| ideas | 创意想法、灵感记录 |
| reading | 阅读笔记、文章摘要 |
| work | 工作文档、项目记录 |
| life | 生活备忘、日常记录 |
当你询问过往笔记、技术知识、阅读记录等内容时，UseIO 会自动检索知识库并注入相关知识。检索到的知识会自然融入回答。
通过知识提取元技能，可以从历史对话中自动提取有价值的信息保存为知识条目。也支持在历史对话列表中右键一键提取知识。
通过 SKILL.md 自定义技能，扩展 UseIO 的能力边界，打造专属工作流。
技能是 UseIO 的可扩展能力单元。每个技能由一个 SKILL.md 元数据文件和可选的执行脚本、模板文件组成。加载技能后，UseIO 会按照 SKILL.md 中的指引执行任务。
UseIO 预装了以下技能：
有两种方式使用技能：
@技能：名称 直接加载技能支持导入和导出，方便在不同设备间同步或与社区分享。导出的技能包含完整的目录结构和所有资源文件。
通过 MCP 协议接入外部工具，无限扩展 UseIO 的能力边界。
MCP（Model Context Protocol）是一种标准化的工具接入协议，允许 UseIO 与外部服务进行通信。通过 MCP，你可以将数据库查询、API 调用、第三方服务等接入 UseIO。
在设置中添加 MCP 服务器配置，指定服务器地址和可用工具。配置完成后，MCP 工具会自动出现在 UseIO 的工具列表中，Agent 可以像调用内置工具一样调用它们。
通过 SKILL.md 规范创建你自己的技能，扩展 UseIO 的能力。
最简单的方式是使用内置的 skill-generator 技能。只需描述你想要的技能功能，UseIO 会自动生成完整的技能目录结构和所有资源文件。
# 在对话框中输入
@技能：skill-generator
帮我创建一个技能，用于自动格式化项目中的所有代码文件每个技能的核心是 SKILL.md 文件，包含以下元数据：
my-skill/
├── SKILL.md # 元数据与执行指引
├── scripts/ # 执行脚本（可选）
│ └── run.sh
├── templates/ # 模板文件（可选）
│ └── output.md
└── files.json # 子文件清单技能创建后需通过质量校验清单：格式统一、逻辑闭环、脚本可执行。确保每个技能都能稳定运行。
了解 UseIO 的记忆管理机制，优化你的使用体验。
每条记忆都有重要性标记，影响其在记忆库中的留存时间：
记忆会根据时间和使用频率自动衰减。不常被召回的记忆会逐渐降低优先级，最终被清理。这确保了记忆库始终保持高效和准确。
你可以在记忆图谱界面中手动查看、编辑或删除记忆条目。对于不再需要的记忆，可以手动清理以保持记忆库的整洁。
| 特性 | 记忆 | 知识库 |
|---|---|---|
| 生成方式 | 对话中自动提取 | 手动保存或提取 |
| 检索方式 | 语义召回 | 语义检索 |
| 生命周期 | 自动衰减 | 永久保留 |
| 用途 | 记住用户偏好和历史 | 存储参考资料和笔记 |
系统性地构建你的个人知识库，让 UseIO 成为你越用越强的知识助手。
在知识库界面中手动添加知识条目，每条包含标题、内容、分类和标签。
两种方式从对话中提取知识：
为知识条目添加标签可以提高检索精度。建议使用简洁的关键词作为标签，如 vue、performance、deploy 等。
安装和运行 UseIO 时遇到的常见问题解答。
推荐使用镜像下载地址（GH-Proxy 加速），支持 IPv4 和 IPv6。GitHub Release 为官方源，国内网络可能需要科学上网。
前往 系统设置 → 隐私与安全性，找到提示 UseIO 的地方，点击"仍要打开"即可。
尝试以下步骤：
启动验证密码用于加密本地数据，设置后无法找回。如遗忘密码，可通过自动备份恢复数据：卸载后重新安装，在首次启动时选择从备份恢复。
Linux 版本目前处于 Beta 阶段（.AppImage 格式），正式版即将推出。请关注 GitHub Release 获取最新动态。
模型 API 配置和使用中的常见问题。
UseIO 兼容所有 OpenAI API 格式的模型服务，包括 OpenAI GPT 系列、Anthropic Claude（通过兼容接口）、GLM、DeepSeek、Kimi等国内模型，以及 Ollama / LM Studio 等本地部署的模型。
以 GLM 为例，在模型配置中填写：
https://open.bigmodel.cn/api/paas/v4glm-5.3不是必须的。但未配置视觉模型时，屏幕读取分析和本地图片识别功能将不可用。建议配置以获得完整体验。
可以。你可以在设置中配置多个模型，在对话中切换使用。不同任务可以选择最适合的模型。
/v1 后缀）使用 UseIO 各功能时遇到的常见问题。
可以，但需要使用绝对路径，且工作空间外的写操作会升级为 DANGEROUS 级别，需要额外确认。系统关键目录会被阻止操作。
目前支持 Chrome 浏览器。如未安装 Chrome，需先安装。UseIO 会自动尝试启动系统 Chrome。
JavaScript 沙箱和 Python 沙箱均有代码大小和执行时间限制，并做了安全隔离，防止危险操作。
建议：
@目录：路径 让 UseIO 了解项目结构UseIO 内置死循环检测机制，Agent 陷入重复操作时会自动终止。如果长时间无响应，可以手动终止当前任务并重新描述需求。
关于数据隐私和安全的常见问题。
不会。UseIO 100% 本地运行，没有云端服务。所有数据（记忆、知识库、会话记录、技能）都在你的设备上处理与存储。唯一的网络请求是你配置的大模型 API。
所有数据存储在本地应用数据目录中。若设置了启动验证密码，数据将进行加密保护。不同操作系统的存储位置：
%APPDATA%/UseIO~/Library/Application Support/UseIO~/.config/UseIOUseIO 支持自动备份功能，会定期备份你的数据。你也可以在设置中手动触发备份。备份文件可以用于跨设备迁移或灾难恢复。
UseIO 发送给大模型 API 的内容仅包含对话上下文和必要的任务信息。你的记忆、知识库等本地数据不会全部发送，仅在语义检索后将相关片段注入上下文。建议选择你信任的模型服务提供商。
启动验证密码是可选功能，用于加密保护你的本地数据。设置后，每次启动应用时需输入密码解锁；即使他人获取了你的设备，也无法直接读取你的数据。你也可以选择不设置，直接使用应用。