Tokeny v1.3.0 新功能使用说明

本文档面向 Tokeny 用户，帮助你快速上手 v1.3.0 版本的所有新功能。

---

目录

• 多会话 Tab 栏
• 技能市场与插件生态
• 内嵌预览系统
• Goal 持续执行
• 用户认证系统
• 微信 & 飞书集成
• 浏览器扩展
• Web 服务模式
• 权限管理
• 体验优化亮点

---

多会话 Tab 栏

像浏览器标签页一样，在同一个工作空间内并行管理多个对话。

基本操作

操作	方式
新建 Tab	点击 Tab 栏右侧的 + 按钮，或双击 Tab 栏空白区域
切换 Tab	点击目标 Tab
关闭 Tab	点击 Tab 上的 × 按钮，或鼠标中键点击 Tab
拖拽排序	按住 Tab 拖动到目标位置释放
置顶 Tab	鼠标悬停 Tab 时点击 📌 图标，置顶的 Tab 始终排在最前

注意事项

• Tab 标题会自动与会话名称同步——当 AI 为对话生成标题后，Tab 标题实时更新。
• 关闭最后一个 Tab 后会自动回到欢迎页。
• Tab 顺序和置顶状态在切换工作空间后会自动恢复。
• 迷你模式下 Tab 栏替换为顶部 Header，通过下拉列表切换历史会话。

---

技能市场与插件生态

Skill（技能）是 Tokeny 最核心的扩展机制。v1.3.0 新增了在线市场和多种安装方式。

进入技能面板

点击左侧导航栏的 ⚡ Skills 图标，进入技能管理界面。顶部有两个 Tab：

• 已安装：查看和管理本地已有技能
• 市场：在线浏览和安装社区技能

安装技能

支持多种安装方式，满足不同场景：

从市场安装（推荐）：

1. 切换到「市场」Tab
2. 浏览分类标签或搜索关键词找到目标技能
3. 点击技能卡片查看详情（含文件预览和说明文档）
4. 点击「安装」按钮完成安装

从本地目录安装：

1. 点击「本地安装」下拉按钮
2. 选择「从本地目录安装」
3. 在弹出的文件选择器中选择技能目录

从 Git URL 安装：

1. 点击「本地安装」→「从 Git URL 安装」
2. 在弹窗中输入地址，支持以下格式：
   • user/repo（简写）
   • https://github.com/user/repo.git（HTTPS）
   • git@github.com:user/repo.git（SSH）
   • 支持仓库子路径

拖拽安装：

• 直接将技能目录或 .zip 文件拖入技能面板区域
• 支持批量拖入，一次安装多个技能
• 拖入时会出现虚线提示区域

管理技能

• 启用/禁用：每个技能卡片右上角有开关，控制是否对 AI 可用。
• Plugin 分组：来自同一插件的技能自动归为一组，以卡片形式展示。点击可查看子技能列表，支持逐项开关或整体开关。
• 卸载：点击技能/插件卡片上的删除按钮。

使用技能

技能安装并启用后，可通过两种方式触发：

• 斜杠命令：在聊天输入框输入 /技能名，支持多技能合并注入
• 自动路由：AI 会根据对话内容自动选择合适的技能

---

内嵌预览系统

无需离开 Tokeny，直接在应用内预览网页、代码、PDF 和文件差异。

打开预览

预览面板会在以下情况自动出现：

• 点击文件：在左侧文件资源管理器中点击任意文件
• AI 主动打开：AI 在工作过程中调用 open_preview 工具时自动打开
• AI 写文件后自动刷新：当 AI 修改了正在预览的文件，内容自动更新

预览面板默认显示在聊天区右侧，可通过设置切换到左侧。面板宽度通过拖拽中间分割条调整（20%~80%）。

预览 Tab 管理

预览面板顶部有独立的 Tab 栏：

操作	方式
切换预览	点击目标 Tab
关闭预览	点击 × 或鼠标中键
拖拽排序	拖动 Tab 调整顺序
关闭全部	点击 Tab 栏右侧的「全部关闭」按钮
独立窗口	点击 Tab 栏右侧的「弹出」图标，在新窗口中查看

HTML / 网页预览

打开 .html 文件时，进入 Webview 预览模式。工具栏提供以下能力：

• 导航：后退、前进、刷新
• 设备仿真（📱 图标）：从预设设备列表选择手机/平板分辨率，或拖拽边框自定义尺寸
• 元素选择器（⊕ 图标）：点击后进入选择模式，点击页面任意元素可高亮并查看其 CSS 选择器和计算样式。选中的元素可作为上下文引用发送给 AI
• 标注模式（✏️ 图标）：截取当前页面，在覆盖层上手绘标注，完成后自动附加到聊天输入
• 幻灯片模式：检测到 Deck 结构时自动激活，支持翻页和导出（PNG / PDF / PPTX）

代码预览

打开代码文件时，使用 Monaco 编辑器展示：

• 直接编辑：可在预览中修改代码，Ctrl+S 保存
• Ask Agent：选中一段代码后，光标处会浮现「Ask Agent」按钮——点击将代码引用插入聊天输入框，方便就选中代码向 AI 提问
• 编码切换：底部状态栏可切换文件编码（UTF-8 / GB18030 / Big5 / Shift-JIS / Latin-1）
• 编辑未保存时，Tab 标签会显示 • 脏标记

文件快照与版本对比

AI 每次修改文件都会自动创建快照。在文件资源管理器的「变更」面板中查看：

• 查看差异：点击快照条目，预览区打开 Diff 对比视图（左侧原始 / 右侧修改后）
• 视图切换：支持并排视图和内联视图
• Hunk 级回退：每个差异块左侧有 ↩ 图标，可单独回退该段变更
• 直接编辑：可在 Diff 视图的右侧面板直接修改内容并保存
• 接受变更：点击 ✅ 图标永久保留修改
• 回退变更：点击 🔄 图标恢复到修改前状态
• 全部回退：顶部「全部回退」按钮可一键撤销本次会话的所有文件修改

---

Goal 持续执行

设定一个目标，让 AI 自动持续工作直到完成——无需反复发送消息。

设定目标

在聊天输入框中输入：

/goal <你的目标描述>

例如：/goal 将所有组件的 CSS 类名迁移到 Tailwind

执行过程

目标设定后，输入框上方出现 Goal 状态栏，实时显示：

• 当前状态（执行中 / 评估中 / 已暂停 / 已完成 / 失败）
• 目标描述摘要
• 执行进度（已完成轮次 / 最大轮次）

AI 会自动循环执行，每轮结束后评估是否达成目标。消息列表中会出现「目标续行」卡片，展示评估结果和下一步计划。

控制执行

状态栏提供三个控制按钮：

按钮	说明
⏸ 暂停	中止当前执行并保留进度，可随时恢复
▶ 恢复	从暂停处继续执行
✕ 取消	终止目标，不再继续

注意事项

• 默认最大轮次为 20 轮，硬上限 50 轮。
• 当 AI 触发需要审批的工具时，Goal 会自动暂停等待你的确认，审批通过后自动恢复。
• 支持断点续行——即使暂停或中断，恢复后会接续之前的进度。

---

微信 & 飞书集成

将 Tokeny 连接到微信或飞书，通过 IM 消息与 AI 交互。

进入配置

点击左侧导航栏的 💬 IM 图标，进入 IM 配置面板。

飞书配置（4 步向导）

第 1 步 — 创建应用：前往 飞书开放平台 创建一个自建应用。

第 2 步 — 填写凭据：

• 输入应用的 App ID 和 App Secret
• 点击「测试连接」验证配置是否正确
• 保存后继续

第 3 步 — 配置事件订阅：按引导在飞书后台配置事件订阅（长连接模式）。

第 4 步 — 开启能力权限：按需开启各项能力（消息增强为必选）：

• 多维表格、文档、云空间
• 日历、通讯录、知识库
• 群管理

配置完成后进入管理视图，可查看连接状态和切换 HITL 审批模式。

微信配置

1. 在 IM 面板选择「微信」Tab
2. 自动生成二维码，使用微信扫码
3. 等待扫码确认（超时可自动刷新，最多 3 次）
4. 绑定成功后即可通过微信收发消息

高级设置：可配置自定义微信 API 服务地址（baseUrl）。

---

浏览器扩展

通过浏览器扩展，让 AI 能直接操控和感知你的浏览器页面。

启用扩展

1. 点击左侧导航栏 🧩 插件 图标
2. 找到「浏览器扩展」卡片并点击
3. 配置面板打开时 WebSocket 服务自动启动

安装到浏览器

快捷安装：

• 点击「安装到 Chrome」或「安装到 Edge」按钮
• 自动复制扩展路径并打开浏览器扩展管理页

手动安装：

1. 点击「打开扩展目录」获取扩展文件路径
2. 在浏览器扩展管理页开启「开发者模式」
3. 点击「加载已解压的扩展程序」，选择扩展目录

使用说明

• 扩展连接后，AI 可以获取页面的可访问性树（DOM 结构感知）
• 支持快照引擎（Playwright 风格），自动稀疏模式和 20 层深度
• 首次连接时会询问是否禁用 Playwright MCP server（避免冲突）

高级设置：可修改 WebSocket 端口号（默认 3211，需在服务停止状态下修改）。

---

Web 服务模式

将 Tokeny 变为一个局域网 AI 服务，支持浏览器和 VS Code 远程访问。

启用方式

1. 点击左侧导航栏 🧩 插件 图标
2. 找到「Web 服务」卡片并点击
3. 配置以下选项：

配置项	说明	默认值
端口	服务监听端口	3210
绑定地址	0.0.0.0（所有网卡）或 127.0.0.1（仅本机）	0.0.0.0
访问 Token	客户端连接的认证凭据，可查看/复制/重新生成	自动生成 32 位随机 token
随应用启动	是否在 Tokeny 启动时自动开启	关闭

4. 点击启动后，面板展示可用的局域网地址列表（支持一键复制）

连接方式

• 浏览器：在同一局域网内的设备上访问显示的地址，通过 SSE 实时推送流式响应
• VS Code：安装 tokeny-vscode 扩展后，配置服务地址和 Token 即可连接

⚠️ 安全提醒：Web 服务仅建议在受信任的内网环境中使用。

---

权限管理

v1.3.0 对权限系统进行了全面升级，提供更精细的控制。

权限模式

在输入框右下角可快速切换权限模式：

模式	说明
默认权限	AI 执行敏感操作时需逐一确认（推荐）
完全访问	跳过所有权限检查（慎用）
全自动	自动批准所有操作（⚠️ 高风险）

实时审批

当 AI 触发需要审批的操作时，输入框上方会出现 审批条：

• 拒绝：阻止本次操作
• 允许：仅允许本次操作
• 下拉选项：
  • 始终允许该指令（创建持久化规则）
  • 在当前会话始终允许
  • 在当前工作空间始终允许

高风险操作（如删除文件、执行系统命令）会以红色边框和警告文字突出显示。

查看和管理规则

1. 打开右侧工作空间面板
2. 切换到「权限」Tab
3. 查看两类规则：
   • 持久化规则：跨会话生效的长期规则
   • 会话级规则：仅在当前会话内生效
4. 鼠标悬停规则行，点击删除按钮可移除不需要的规则

当权限模式为「完全访问」或「全自动」时，规则不生效，面板顶部会显示提示。

---

体验优化亮点

聊天界面升级

• Mermaid 流程图：AI 输出的 Mermaid 代码块会自动渲染为可视化图表
• HTML 渲染：AI 回复中的 HTML 内容可直接渲染展示
• 富媒体交互卡片：AI 的 ask_user 交互升级为图文选项卡片，操作更直观
• 多技能输入：支持在一条消息中同时输入多个 /技能 命令
• 虚拟滚动：长对话滚动更流畅，不再卡顿
• Activity Bar 拖拽排序：左侧导航图标可拖拽自定义排列顺序

工具执行进度

长时间运行的工具操作（如 modifyFile）现在会实时显示执行进度，不再只有"执行中"的等待状态。

通知优化

应用在前台时自动抑制系统通知，不会再出现重复弹窗。

工作空间管理

删除工作空间时，系统会明确提示关联的定时任务将一并清理，避免意外残留。

---

安全性提升

• Windows 代码签名：安装时不再弹出安全警告
• 文件保护：文件工具强制执行先读后写检查，防止意外覆盖
• 模型白名单：媒体和语音模型增加白名单校验

---

如有问题或反馈，欢迎在应用内向 AI 提问或访问项目仓库提交 Issue。