使用文档

安装与启动

下载安装包

Tokeny 支持 Windows、macOS、Linux 三大平台。前往官网首页下载区，系统会自动识别当前设备并推荐对应的安装包，你也可以手动切换平台：

• Windows：下载 .exe 安装包，双击运行安装向导完成安装
• macOS：下载 .dmg 文件，拖拽到 Applications 文件夹即可（区分 Apple 芯片与 Intel 芯片两个版本）
• Linux：下载 Linux（x64）安装包

首次启动与登录

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

启动后你可以登录 Tokeny 统一账号——与官网 tokeny.cn 使用同一账号，支持手机号（短信验证码或密码）和微信扫码登录。登录后可解锁会员权益、市场一键安装与投稿等在线能力；不登录也可以通过自带服务商 API Key 使用本地功能。

系统要求

内置环境与系统环境

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

内置环境初始化步骤：

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

配置 AI 模型

支持的服务商

Tokeny 内置 10 家模型渠道，同时支持本地部署与自定义渠道：

此外还有 Ollama（本地部署） 与 自定义渠道（兼容 OpenAI / Anthropic 协议，支持自定义 Base URL）。模型清单随版本持续更新，以应用内为准。

配置 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 的思考过程支持展开与收起，以打字机效果展示。API 调用失败时会自动重试，网络波动不会中断对话。如果对当前回复不满意，可以点击「停止生成」按钮中断输出。

消息队列

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

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

打断与插队

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

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

Skill 技能系统

什么是 Skill

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

内置技能列表

Tokeny 内置多个专业技能，开箱即用，常用技能如下：

手动触发与自动路由

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

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

技能市场

Tokeny 技能市场收录官方与社区技能。打开 tokeny.cn/skills 可浏览精选、热门、最新区块，按分类筛选与搜索；客户端内也可以浏览市场并一键安装。

在官网详情页点击「安装到 Tokeny」可一键唤起客户端安装，也可以下载 ZIP 包手动导入。

官方扩展示例：

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

自定义技能

除了使用内置技能和市场技能，你还可以创建自己的 Skill：

• 以 SKILL.md 定义能力，支持文件编辑与热重载，修改即时生效
• 安装来源支持技能市场、GitHub 仓库（含 monorepo 子路径）与本地工作空间
• 技能可设置中文显示名，安装后写入 SKILL.md 并在「已安装」列表展示

AI 还会把常用操作沉淀并建议为技能，使用 /save-as-skill 即可将当前工作流保存为可复用的 Skill。

投稿发布

在官网市场页点击「投稿」即可进入投稿向导：

1. 1导入 —— 支持 GitHub 链接、粘贴 SKILL.md 全文或上传 ZIP 包
2. 2预览 —— 自动解析名称、简介与说明文档
3. 3确认提交 —— 补全分类与标签，首次发布需上传完整 ZIP 安装包（不超过 30MB）并填写版本号

投稿限额为每小时最多 5 条、每天最多 10 条。一次投稿对应一次审核，通过即发布；被驳回可修改后重新提交。全部投稿与版本可在官网「个人中心 → 我的投稿」中管理。

技能管理

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

MCP 工具扩展

什么是 MCP

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

内置服务

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

• WebFetch：获取网页内容，支持 HTML 转 Markdown，内置 SSRF 防护
• 联网搜索：通过搜索引擎获取互联网最新信息
• Playwright 浏览器：自动化浏览器操作，三种连接模式：启动新实例、复用本机浏览器 Profile、直连 CDP；工具连接在后台异步建立，服务掉线不会卡住 AI 回复
• 邮件服务：支持 IMAP 收件和 SMTP 发件，可配置多个邮箱账户，实现邮件自动收发
• Tokeny Connector 浏览器扩展：接管你已登录的浏览器，自动填表、抓取与提交，全程截图存证

MCP 市场

官网 MCP 市场（tokeny.cn/mcp）收录官方与社区 MCP Server，可按分类浏览、搜索；详情页提供安装命令与远程地址一键复制，也可以一键唤起客户端安装。

欢迎投稿自己的 MCP Server：支持 GitHub 仓库导入或远程 URL 接入，投稿入口见市场页「投稿」按钮。

添加第三方服务

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 模型」设置中分别指定用于图片生成和视频生成的模型（如硅基流动、豆包等）。

多智能体协作

Tokeny 支持多种多智能体协作方式：

• 群聊协作 —— 多个智能体在同一对话中通过 @ 交棒协作完成任务
• 子任务委派 —— 将子任务分配给独立的 Agent 实例隔离执行，避免上下文干扰，完成后结果汇报给主任务
• 预置智能体 —— 内置 25 个角色（技术负责人、深度研究员、会议纪要、记账助手等）开箱即用
• 自定义智能体 —— 用一句自然语言描述即可创建自己的智能体

此外，AI 还可以创建和管理 Cron 定时任务，详见「定时任务」一章。

管理与扩展

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 导出使用内置渲染引擎，确保样式与预览一致。

智能记忆

自动记忆提取

Tokeny 会在对话结束后异步提取你的偏好与关键事实。记忆系统采用双层架构与结构化分类，让 AI 越用越懂你：

• 双层记忆架构：全局记忆跨工作空间生效，工作空间记忆只在当前项目生效。
• 七种结构化分类：记忆按偏好、事实、指令、事件、画像、关系、目标七种分类归档。
• 三层智能注入：下次对话时，相关记忆会经过三层智能注入机制进入 AI 的上下文。
• 全文搜索与冲突合并：记忆支持全文搜索，冲突的记忆会自动合并。

记忆维护

后台维护系统会定期自动整理记忆，让记忆库长期保持健康：

• 清理过期记忆
• 衰减长期不活跃的记忆
• 合并碎片记忆
• 检测并提示矛盾记忆

你还可以为记忆系统单独指定一个模型（例如选择更便宜的模型承担记忆提取与维护），不影响主对话模型。

记忆管理

在左侧导航栏进入「记忆」页面，可以查看、编辑或删除已保存的记忆条目。记忆以结构化卡片展示，支持按分类筛选与全文搜索。你可以手动添加重要的个人偏好，也可以删除不准确的记忆。

定时任务

创建任务

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

Cron 表达式

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

任务管理

定时任务拥有独立的汇总页面，集中展示全部任务的状态与上次执行时间。任务执行结果以通知卡片展示，支持实时查看执行过程。你可以随时启用/禁用、编辑和删除任务。

智能资产

什么是智能资产

AI 在对话中产生的报告、演示文稿、笔记、图片等成果，会自动收进本地智能资产库（Labs）统一保管，不再散落各处。

浏览与管理

资产库支持标签云筛选、预览弹窗与完整的增删改查；内置全文搜索，本地秒级定位历史成果。

在任务中引用

对话中可引用资产库中的内容作为素材，让 AI 基于既有成果继续创作。

IM 消息集成

什么是 IM 集成

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

支持的平台

当前已支持的 IM 平台：

• 飞书 —— 完整支持：直接执行模式，无需反复确认卡片；工具体系覆盖消息/群聊与平台能力两大模块，可操作多维表格、文档、日历、通讯录、云空间、知识库；IM 中可调用 MCP 外部工具
• 企业微信 —— 接口已预留，即将上线
• 钉钉 —— 接口已预留，即将上线

配置与使用

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

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 成本
• 子任务和后台任务的用量也会被统计

设置页按主题分组为多个标签页（模型、工具、定时任务等），信息组织更清晰。

快捷操作