字浮 CharFloat 字浮 CharFloat
下载客户端
字浮 字浮 CharFloat 官方使用手册 · 面向 WPS 与 Office 的本地 AI 外挂

字浮 CharFloat 使用手册

从安装字浮电脑版、为常用 AI 客户端完成一键授权，到直接在眼前打开的 WPS 与 Excel 中就地改表。这里整理了最简明、清晰的操作教程与排障技巧。

快速开始 第 1 章 · 快速开始

快速上手

字浮是完全免费、开源且运行在你本地的桌面桥梁（标准 MCP 插件）。它不需要把文件上传到任何云端，仅在你本机将 AI 客户端与正打开的办公软件安全互通。

一览流程

三步即可完成全链路协同，全程无需手动敲命令行：

1

下载桌面客户端

安装 macOS 或 Windows 客户端，自动部署 WPS / Office 本地插件。

2

授权你的 AI 助手

支持 WorkBuddy、豆包、千问、Kimi、Claude 或 Cursor 一键激活。

3

打开文档开始对话

直接跟 AI 讲大白话：“帮我把 8 月数据补齐，按原公式计算”。

方式一：下载桌面客户端（推荐 · 最省心）

最适合日常办公的开箱即用方式。桌面客户端启动后会自动守护本地回环服务，并为你提供实时连通拓扑、AI 授权卡片网格和安全时光机流水视图。

macOS macOS 客户端 (Apple 芯片 · arm64)

支持 macOS 12 (Monterey) 及以上版本。打开 DMG，将应用拖入 Applications 文件夹即可。

下载 Mac 安装包 (.dmg)
Windows Windows 客户端 (64 位)

支持 Windows 10 / 11 64 位。双击 EXE 安装包，按提示完成安装。

下载 Windows 安装包 (.exe)

▲ 字浮客户端大盘：展示办公软件连接状态、本地加密管道端口及已授权 AI 助手

首次运行须知

启动字浮客户端后，它会在菜单栏静默运行并自动检查加载项就绪情况。当你在 WPS 或 Excel 中打开表格时，客户端顶部的办公软件卡片会实时变为实时协同。

方式二：让你的 AI 自己把配置加上

如果你使用的是具备本地文件写入能力的 AI 编程助手（如 Cursor、Windsurf、VS Code Cline 或 Claude Code），无需手动翻找各家软件深层的配置文件路径，把下面这段配置提示词直接发给 AI 即可：

发给 AI 的一键自动配置指令
请帮我把「字浮 CharFloat」配置为你的 MCP 扩展工具，让我可以直接操控本地 WPS 与 Office。

MCP 服务配置信息如下：
服务名称: charfloat
启动配置: 使用字浮桌面客户端「AI 助手接入」中复制的本机 MCP 配置（包含实际启动命令、参数和环境变量）

请先读取我提供的本机 MCP 配置，再识别当前客户端，将 charfloat 条目安全合并到 MCP 配置文件中并激活，保留其他服务。若尚未提供本机配置，请提醒我从字浮客户端复制，不要猜测安装路径或从 npm 下载。

方式三：开发者从源码或命令行运行

字浮核心服务完全使用 Node.js / TypeScript 编写，克隆源码后可在开发者终端直接以后台守护或标准 stdio MCP Server 模式运行：

Terminal
# 1. 克隆代码并安装依赖
git clone https://github.com/Jolly-J/CharFloat.git
cd CharFloat
npm ci
npm run build

# 2. 一键配置本机 WPS 与 Office 加载项
npm run setup -- --addon

# 3. 常用后台管理指令
node dist/bridge/cli.cjs --start          # 启动后台守护服务
node dist/bridge/cli.cjs --status         # 查看宿主连接状态
node dist/bridge/cli.cjs --doctor         # 运行本地环境体检
node dist/bridge/cli.cjs --repair-addon    # 一键修复加载项
node dist/bridge/cli.cjs --stop           # 停止服务

提示：如果不带任何参数直接执行 node dist/bridge/cli.cjs，进程将作为标准 stdio MCP Server 运行，可直接挂接任意标准 MCP 客户端。

AI 助手接入 第 2 章 · AI 客户端接入

AI 助手接入

字浮基于开源开放的 Model Context Protocol (MCP) 协议构建。客户端内置了「AI 助手授权中心」，主流客户端均可一键完成配置写入。

▲ AI 助手授权中心：自动检测本机安装的客户端，勾选后点击一键配置即生效

1. 腾讯 WorkBuddy

腾讯推出的桌面智能助手，也是目前与字浮本地长连接协同体验最为丝滑的一套组合。

  1. 打开字浮桌面客户端，在「AI 助手授权中心」找到 WorkBuddy 卡片并勾选；
  2. 点击底部的 一键配置已选助手，字浮会自动将服务写入 ~/.workbuddy/mcp.json；
  3. 在 WorkBuddy 软件界面中进入设置或点击字浮卡片上的 打开管理，刷新后即可看到名为 charfloat 的工具集；
  4. 日常在 WorkBuddy 对话框中直接提及“改当前表格”即可实时唤起本地驱动。

2. 字节 豆包工作

字节跳动 AI 工作平台。由于豆包工作客户端采用了专属的本地连接器管理机制，配置过程非常简明：

  1. 在字浮中点击一键配置后，字浮会首先将 4 个专属 Office 提示词技能自动同步至本地 .user_skills 目录；
  2. 打开豆包工作桌面端，左侧菜单进入 【技能 · 连接器 · 伙伴】，点击右上角 【新建自定义连接器】；
  3. 对照下方参数填入：
    字浮 CharFloat
    HTTP
    http://127.0.0.1:19890/mcp
    无需填写，直接留空即可
  4. 点击保存即可完成连接。后续对话时豆包可直接识别表格中的数据并完成标色或填值。

3. 阿里 通义千问办公端

通义千问桌面端支持标准 MCP 工具挂载。在字浮客户端中勾选千问办公，一键配置后自动打通本地通道，适合处理包含大段文字提取回写到表格的复杂场景。

4. 月之暗面 Kimi

支持 MCP 扩展能力的 Kimi 客户端。字浮会自动识别其配置目录并完成注册，长文本逻辑推理完成后直接增量写入眼前正打开的表格。

5. Anthropic Claude Code / Claude Desktop

Anthropic 官方对 MCP 协议支持最为原生与完善。在 Claude Desktop 中，字浮会自动将配置合并进 claude_desktop_config.json；使用 Claude Code 命令行时，可以直接添加：

Claude Code CLI
claude mcp add charfloat -- node /绝对路径/dist/bridge/cli.cjs

6. Cursor / Windsurf / VS Code / Cline

在主流 AI 编辑器中，字浮会自动写入对应的 MCP 配置文件（如 Cursor 的 ~/.cursor/mcp.json 或 Windsurf 的 ~/.codeium/windsurf/mcp_config.json）：

mcp.json 范例
{
  "mcpServers": {
    "charfloat": {
      "command": "node",
      "args": ["/Users/yourname/CharFloat/dist/bridge/cli.cjs"]
    }
  }
}
办公软件协同 第 3 章 · 办公软件协同

WPS 与 Office 协同

字浮的核心理念是“你说，它当场在你眼前改”。告别过去把文件上传到网页端、让 AI 另存一份副本的痛苦流程。

WPS Office 联动要点（主推 · 最推荐）

字浮对 WPS Office 的支持最为完善且经过了双平台全量实测。支持表格精准就地读写、单元格样式标色、原生图表嵌入以及 Word / PPT 基础交互。

  • 如何确认加载项已就绪：安装字浮客户端后打开 WPS，在顶部「开始」功能区最右侧会看到「字浮」侧栏入口。首次打开时侧栏会自动建立与本地服务（端口 19890）的 WebSocket 连接。
  • 侧栏收起也不受影响：侧栏打开建立好连接后，你完全可以将其折叠或收起，后台通信通道依然保持畅通。
  • 多文档感知：当你在 WPS 中同时打开多个工作簿时，字浮会自动识别你当前聚焦活动的窗口和选区。

Microsoft Excel 协同

针对 Microsoft Excel，字浮提供了 Office.js 加载项（macOS 与 Windows 统一架构）与 Windows COM 原生驱动双通道回退支持：

  • Windows Office：支持 Office 2016 / 2019 / 2021 及 Microsoft 365。首次安装加载项清单后在「插入 → 我的加载项」即可看到字浮。
  • macOS Office：通过 Office.js 任务窗格通道进行交互，支持完整的结构化单元格读写与公式应用。

核心特性：公式继承、条件标色与就地画图

不同于很多用 Python 脚本粗暴重写 Excel 文件导致样式公式全毁的工具，字浮是通过活体进程 API 精准操作：

智能公式与增量补齐

识别已有计算口径，按业务逻辑补齐缺失单元格，复杂公式与引用联动 100% 保持。

智能公式补齐效果

口语化条件标色

“把成本超标的标黄，不要标红”。精准识别对应行并柔和着色，绝不破坏原有字体字号。

条件标色效果

WPS 原生图表就地生成

直接在当前工作表右下方生成嵌入式原生走势图，绑定数据源，随时可在软件里双击调整。

原生图表效果
安全时光机 第 4 章 · 安全时光机

安全时光机与撤回

把文件交给 AI 改，最怕的就是改错或者把原来辛苦做好的数据覆写掉。字浮内置了严密的本地安全快照栈，让你永远拥有“后悔药”。

▲ 安全时光机：记录每次 AI 操作的目标工作表、选区与修改时间，支持一键撤销并回滚数值

自动快照保护机制

每次 AI 助手准备对单元格值或公式动手之前，字浮都会先在本地以微秒级速度把目标区域的初态读取并压入快照栈。全程在电脑内存和本地存储中闭环，不会拖慢整体操作速度。

单元格 Diff 对比与秒级还原

万一 AI 算偏了、公式写错了，或者你发现结果不如预期，有两种极简的恢复方式：

  1. 方式一：在字浮客户端上一键还原：打开字浮客户端切换到「安全时光机」，找到刚才那笔记录，点击后面的 一键撤销，目标单元格当场还原为改动前的初态；点击记录还可以查看变更前后详细的红绿 Diff 差异对比。
  2. 方式二：直接口头跟 AI 说撤回：直接在 AI 聊天框里输入“刚才那步格式调整撤回，恢复刚才的初态”，AI 会自动调用字浮提供的回滚工具就地还原。
常见问题 第 5 章 · 常见问题

常见问题与排障指南

整理了我们在实际测试和用户反馈中最常遇到的高频疑问与解决办法。

1. macOS 打开提示“已损坏，无法打开”或提示开发者未验证？

由于字浮目前为个人开源项目，未购买 Apple 每年昂贵的商业开发者证书，macOS Gatekeeper 安全机制会在首次打开由浏览器下载的应用时添加隔离属性（quarantine）。

安全提醒

请确保你的安装包是从字浮官网（charfloat.online）或官方 GitHub 仓库下载的。确认无误后再执行下方移除隔离标记的命令。

打开 Mac 的「终端 (Terminal)」应用，复制并运行下方这一条命令即可：

macOS Terminal
sudo xattr -r -d com.apple.quarantine "/Applications/字浮 CharFloat.app"

* 按回车后输入电脑开机密码（输入时终端不会显示字符，直接输完按回车即可），然后重新打开应用即可正常启动。

2. 办公软件与字浮未能成功连接？

按照下方 3 步即可快速排障：

  1. 检查字浮后台是否在运行：查看系统菜单栏是否有字浮图标，或打开字浮客户端确认顶部是否显示“本地加密通道已监听端口 19890”。
  2. 先保存，再重新打开文档：首次配置加载项后，建议保存手头的文档并完整退出一次 WPS / Excel，然后重新打开。
  3. 运行客户端一键体检：打开字浮客户端「系统设置与高级维护」抽屉，点击 一键全面体检 (Bridge Doctor)，会自动检查后台守护进程、端口冲突和加载项完整度并给出针对性修复建议。

3. 怎么跟 AI 说话效果最好？

“把 AI 当成坐在你身边的同事，而不是一个脚本生成器。”
避免让它“生成一份表格”，而是明确告诉它在当前文件上怎么动：

❌ 容易得到多余副本的问法：

“帮我写个 Python 脚本分析一下这个表格的数据，然后生成一个 excel 给我下载。”

✅ 字浮推荐的大白话指令：

“就看我当前开着的这个表，把 8 月的缺失数据补齐，按去年的计算口径算同比增长，原有公式别动。”

字浮 CharFloat © 2026. 纯本地运行 · 保护文档隐私。
官网首页 GitHub 开源 回到顶部 ↑