使用文档

安装与启动

下载安装包

Tokeny 支持 Windows 和 macOS 两大平台。前往首页下载区选择对应平台的安装包：

• Windows：下载 .exe 安装包，双击运行安装向导完成安装
• macOS：下载 .dmg 文件，拖拽到 Applications 文件夹即可

首次启动

Tokeny 首次启动即可使用。应用会在本地创建 SQLite 数据库用于存储你的对话、设置和文件数据。

系统要求

内置环境与系统环境

Tokeny 提供了两种方式来管理运行时环境，确保你无需复杂配置即可开始使用：

内置环境初始化步骤：

1. 1打开应用后，进入「MCP → 环境检测」页面
2. 2如果看到 Node.js、Python 或 Git 显示为「未解压」状态，点击「初始化内置环境」按钮
3. 3等待解压完成（通常不到一分钟），完成后会自动进行验收测试
4. 4所有项目显示绿色对勾即表示环境就绪

配置 AI 模型

支持的服务商

Tokeny 支持 9 家大模型服务商，共 50+ 模型：

配置 API Key

1. 1点击左侧导航栏的「AI 模型」入口，进入模型配置页面
2. 2选择你要使用的服务商
3. 3在对应服务商栏目中填入 API Key
4. 4点击「测试连接」确认 Key 有效

选择与切换模型

配置 API Key 后，你可以在模型列表中选择默认使用的模型。对话过程中也可以随时切换不同服务商的不同模型，切换后新消息将使用新模型生成回复。

双协议切换

部分服务商同时提供 OpenAI 兼容 和 Anthropic 兼容 两种 API 协议。你可以在模型配置页面一键切换协议，系统会自动更新对应的 Base URL。

当前支持双协议切换的服务商：

Token Plan 套餐

部分服务商提供 Token Plan 套餐计费模式（包月/包量），开启后该服务商的 API 调用不再按量计费。Tokeny 会自动切换到套餐专用的 API 端点，并将费用统计置零。

当前支持 Token Plan 的服务商及适用模型：

开启方式：进入「AI 模型」设置页面，在对应服务商的配置区域中打开 Token Plan 开关即可。开启后：

• Base URL 自动切换到套餐专用端点，关闭时自动恢复
• 不在套餐范围内的模型会被自动禁用，关闭后恢复
• 费用统计中该服务商的调用费用显示为 0（仅记录 Token 用量）

模型推荐

Tokeny 是一个 AI Agent 应用，AI 不仅需要「聊天」，还需要「做事」——调用工具、读写文件、执行命令、多步骤规划和决策。这要求模型具备强大的 Agent 能力（函数调用 / 工具使用 / 指令遵循），而不仅仅是对话能力。

以下是我们基于实际使用效果的推荐（定价单位：元/百万 Token）：

🚀 高性能首选

Agent 能力顶尖，适合复杂多步任务和专业场景

💰 高性价比推荐

价格极低或免费，日常使用和轻量任务的绝佳选择

🧠 思考模式   🔧 工具调用   👁️ 视觉理解   定价格式：输入价 / 输出价（元/百万 Token）

不推荐用于 Agent

以下类型的模型虽然在特定场景下表现优秀，但 不适合作为 Tokeny 的主力模型，因为它们在工具调用和 Agent 任务中存在明显短板：

思考模式

部分推荐模型（如 DeepSeek-V3.2、Kimi K2.5、千问 3.5 Plus 等）支持可切换的「思考模式」。开启后模型会在回答前先进行一轮推理思考，适合需要深度分析的复杂问题。与 R1 等纯推理模型不同，这些模型在思考模式下仍然保持了完整的工具调用能力，不会影响 Agent 任务的执行。

对话功能

基础对话

在主界面底部输入框中输入问题或任务描述，按 Enter 发送。AI 会基于上下文理解你的意图并给出回复。支持多轮对话，AI 会自动记住当前会话中的所有上下文。

会话管理

你可以创建多个独立的会话，每个会话拥有独立的上下文和对话历史。在左侧会话列表中：

• 点击「新建会话」创建新对话
• 点击已有会话切换上下文
• 右键会话可重命名或删除
• 所有会话数据存储在本地数据库中

文件与图片

你可以在对话中发送文件和图片。将文件拖拽到输入框或点击附件按钮选择文件。AI 能够理解文本文件、代码文件、图片等多种格式，并基于文件内容进行分析和回答。

流式输出

所有 AI 回复均采用流式输出，你可以实时看到生成过程。如果对当前回复不满意，可以点击「停止生成」按钮中断输出。

消息队列

当 AI 正在执行任务时（如运行命令、调用工具、生成报告），你仍然可以继续输入新的消息。这些消息不会丢失，而是自动进入消息队列，排队等待 AI 完成当前任务后依次处理。

• 在 AI 执行中发送的消息会显示「排队中」标记
• AI 完成当前任务后，会自动取出队列中的下一条消息继续处理
• 队列中的消息可以随时删除（点击消息旁的取消按钮）
• 多条消息按发送顺序依次执行，先进先出

打断与插队

如果 AI 正在执行的任务不是你想要的，或者你有更紧急的需求，可以随时打断当前任务：

• 停止生成：点击「停止」按钮，AI 会立即中断当前任务。已生成的部分内容会保留在对话中，不会丢失。
• 立即发送（插队）：队列中的消息支持「立即发送」操作。点击后会先中断 AI 当前正在执行的任务，然后立刻开始处理这条插队消息。

Skill 技能系统

什么是 Skill

Skill 是 Tokeny 的核心能力扩展机制。每个 Skill 是一个独立的专业技能模块，通过标准化的 SKILL.md 文件定义其能力、触发条件和行为指令。当 Skill 被激活时，系统会将其专业指令注入到 AI 的提示词中，使 AI 具备该领域的专业能力。

内置技能列表

Tokeny 随附 9 个内置技能，开箱即用：

手动触发与自动路由

手动触发：在输入框中输入 / 可查看所有可用技能列表，选择后直接触发。例如输入 /deep-research 量子计算发展现状 将启动深度研究技能。

自动路由：AI 会根据你的对话内容自动判断是否需要激活某个技能。例如当你说「帮我搜索一下最新的 AI 新闻」时，系统会自动识别并激活联网搜索技能。

扩展市场

除了内置技能外，Tokeny 还提供扩展市场，你可以安装额外的技能来增强 AI 能力。当前扩展市场提供：

• 📄 Word 文档处理：读取和生成 Word 文档
• 📊 Excel 表格处理：读取和生成 Excel 表格
• 📋 PDF 工具：PDF 文件解析与处理

技能管理

在左侧导航栏进入「技能」页面，可以查看所有已安装的技能。点击任一技能可查看详细信息，包括 SKILL.md 源码内容。你可以在此安装、卸载或查看第三方技能的完整提示词。

MCP 工具扩展

什么是 MCP

MCP（Model Context Protocol）是一套开放的工具扩展协议，允许 AI 调用外部服务来完成特定任务。通过 MCP，Tokeny 可以连接各种第三方服务，如数据库查询、邮件发送、浏览器操作等，大幅扩展 AI 的实际操作能力。

内置服务

Tokeny 内置了以下 MCP 服务，开箱即用无需额外配置：

• WebFetch：获取网页内容，支持 HTML 转 Markdown，内置 SSRF 防护
• 联网搜索：通过搜索引擎获取互联网最新信息
• Playwright 浏览器：自动化浏览器操作（点击、填表、截图、数据提取），支持 Chrome/Edge/Chromium
• 邮件服务：支持 IMAP 收件和 SMTP 发件，可配置多个邮箱账户，实现邮件自动收发

添加第三方服务

1. 1进入「设置 → MCP 服务」页面
2. 2点击「添加服务」按钮
3. 3选择接入方式：SSE（网络地址）、stdio（本地命令）或 StreamableHTTP
4. 4填入服务地址或启动命令
5. 5保存后系统自动连接并加载工具列表

服务管理

在 MCP 管理页面可以查看所有已连接服务的状态（连接中/已连接/已断开）、提供的工具列表、以及运行日志。支持手动重连、禁用或删除服务。系统内置了断线自动重连机制，网络恢复后会自动恢复连接。

内置工具

Tokeny 内置 30+ 工具，覆盖文件操作、命令执行、搜索、媒体生成、自动化等多个领域。你可以在应用内的「工具」页面管理每个工具的启用/禁用状态。

文件操作

AI 可以在你的工作空间内进行文件操作。支持 10 种操作：

Shell 命令执行

AI 可以生成并执行 Shell 命令来完成安装依赖、运行脚本、编译项目等任务。支持实时输出和交互式命令。每条命令执行前都会弹出审批弹窗，你可以选择：

• 批准：仅批准当前这一条命令。执行完毕后，如果 AI 需要执行下一条命令，会再次弹出审批弹窗。这是最安全的方式，推荐日常使用。
• 自动执行：开启后，AI 在当前会话中后续产生的所有 Shell 命令将自动执行，不再逐条弹窗确认。适合你信任当前任务且需要连续执行大量命令的场景（如项目初始化、批量安装依赖）。
• 拒绝：取消执行当前命令，AI 会根据你的反馈调整方案。

搜索定位

AI 可以在工作空间中快速定位文件和内容：

• grep —— 内容搜索，支持正则表达式、文件类型过滤、递归搜索
• glob —— 路径匹配，按文件名模式快速定位文件

用户交互与规划

AI 在执行复杂任务时，会主动与你协作：

• 询问用户 —— 需要额外信息时主动向你提问
• 任务计划 —— 将复杂任务分解为步骤清单，实时更新进度
• 进度报告 —— 长任务执行中汇报当前进展
• 文件预览 —— 在应用内直接预览生成的文件

媒体生成

AI 可以调用配置的媒体模型来生成图片和视频。你可以在「AI 模型」设置中分别指定用于图片生成和视频生成的模型（如硅基流动、豆包等）。

自动化与委派

高级自动化工具，帮助 AI 处理更复杂的场景：

• 定时任务 —— AI 可以创建和管理 Cron 定时任务
• 子任务委派 —— 将子任务分配给独立的 Agent 实例隔离执行，避免上下文干扰

管理与扩展

AI 可以在对话中直接管理 Skill 技能和 MCP 服务，无需手动进入设置页面：

• 技能管理 —— 列出、安装、卸载 Skill（支持从 URL、市场、工作空间安装）
• MCP 管理 —— 列出、添加、删除、启停 MCP 服务和查询可用工具
• 安全审核 —— 对高风险命令进行 AI 语义安全分析

安全审批

审批流程

当 AI 需要执行高风险操作（如运行 Shell 命令、删除文件）时，系统会自动暂停并弹出审批弹窗。你有三个选择：

• ✅ 批准：确认执行原始命令
• ✏️ 编辑后执行：修改命令内容后再执行
• ❌ 拒绝：取消执行，AI 会根据你的反馈调整方案

双层安全审核

Tokeny 采用双层安全审核机制，确保高风险操作得到充分评估：

• 第一层：快速风险识别：系统自动对每条命令进行风险评估，识别危险操作模式并标注风险等级，响应速度极快。
• 第二层：AI 深度分析：对被标记为高风险的命令，额外进行 AI 语义分析，生成风险摘要和详细说明，展示在审批弹窗中供你参考。

权限管控

Tokeny 提供三级权限管控体系，按工作空间独立配置，满足不同场景的安全需求：

文件保护

文件系统安全验证器提供三阶段路径验证防护：规范化路径、检测路径穿越攻击、验证符号链接目标。所有文件操作都被限制在工作空间沙箱内，确保 AI 无法访问或修改系统关键文件。

工作空间

文件管理

工作空间是 AI 和你共享的文件目录。你可以在右侧面板中浏览文件树、创建文件夹、上传文件。AI 生成的文件（如研究报告、代码文件、PPT）都会保存在工作空间中。

文件预览

工作空间内置多格式文件预览器，支持以下格式的在线预览：

• Markdown（.md）：渲染后的富文本展示
• Word 文档（.docx）：完整的文档预览
• PPT 演示文稿：Reveal.js 幻灯片预览与播放
• HTML 项目：内嵌浏览器渲染，支持多文件项目实时预览
• 代码文件：语法高亮显示
• 图片文件：支持常见图片格式预览
• 视频文件：内置播放器预览

报告导出

工作空间中的报告和文档支持导出为 PDF 或 Markdown 格式。点击文件预览界面的导出按钮，选择目标格式即可。PDF 导出使用内置渲染引擎，确保样式与预览一致。

智能记忆

自动记忆提取

每次对话结束后，系统会异步分析对话内容，自动提取你的偏好和关键事实（如编程语言偏好、项目背景、常用工具等）。下次对话时，相关记忆会自动注入到 AI 的上下文中，让 AI 越用越懂你。

记忆管理

在左侧导航栏进入「记忆」页面，可以查看、编辑或删除已保存的记忆条目。你可以手动添加重要的个人偏好，也可以删除不准确的记忆。

定时任务

创建任务

在「设置 → 定时任务」中可以创建自动执行的任务。每个任务包含一个自然语言描述的指令和一个执行时间表。到达指定时间时，系统会自动创建一个新会话并执行任务指令。

Cron 表达式

定时任务使用 Cron 表达式定义执行时间。常用示例：

任务管理

在定时任务页面可以查看所有任务的状态、上次执行时间和执行记录。支持启用/禁用、编辑和删除任务。

IM 消息集成

什么是 IM 集成

IM 消息集成让你可以通过企业即时通讯平台（如飞书）直接与 Tokeny 对话。配置完成后，在 IM 中发送消息，Tokeny 会自动接收并处理，响应结果回传到 IM 聊天窗口中。无需打开桌面应用即可远程使用 AI 能力。

支持的平台

当前已支持的 IM 平台：

• 飞书 —— 完整支持，包括长连接消息收发、卡片交互、文件/图片上传
• 企业微信 —— 接口已预留，即将上线
• 钉钉 —— 接口已预留，即将上线

配置与使用

以飞书为例，配置步骤如下：

1. 1在飞书开发者后台创建自建应用（机器人类型）
2. 2获取 App ID 和 App Secret
3. 3在 Tokeny 左侧导航栏进入「IM」页面，填入凭证信息
4. 4开启连接后，Tokeny 会通过长连接自动接收飞书消息
5. 5在飞书中 @ 你的机器人或私聊发送消息，即可与 Tokeny 交互

连接成功后，你可以在 IM 中直接使用 Tokeny 的所有核心功能：对话、触发 Skill、执行工具等。IM 会话与桌面应用会话相互独立，各有独立的上下文。

主题与设置

主题切换

Tokeny 支持三种主题模式：深色、浅色和跟随系统。点击左侧导航栏底部的主题按钮可循环切换。选择「跟随系统」后，应用会自动匹配操作系统的深色/浅色设置。主题偏好会自动保存。

数据存储

Tokeny 的所有数据都存储在本地 SQLite 数据库中，包括：

• 对话历史和消息记录
• 应用设置和偏好
• 工作空间文件和目录
• 持久记忆数据
• API Key（加密存储）
• 定时任务配置和执行记录

Token 用量统计

在「设置」面板中可以查看详细的 Token 用量统计，帮助你了解和控制 AI 使用成本：

• 按会话查看输入/输出 Token 消耗
• 按模型和服务商分类汇总
• 实时显示当前对话的 Token 成本
• 子任务和后台任务的用量也会被统计

快捷操作