CharFloat

关于「字浮 CharFloat」：

• 字浮 ≈ 字符：中文读音天然顺口，自然好记。

• Char + Float：英文自然拆解为 Character（字符）与 Float（漂浮），皆为熟悉的经典术语。

• 云朵形象：浮空云朵与品牌相扣，代表轻盈、无感进驻桌面。

• 开放延伸：不把能力局限在单一工具，未来作为 AI 扩展至更多桌面软件的原生桥梁。

大多数 AI 助手在 Office 里仍停留在“教你怎么做”或“重新生成一个新文件”。
字浮 CharFloat（前身 Office Agent Bridge）不是又一个独立的 AI 软件，而是给你现有常用 AI 的「外挂双手」：100% 免费纯本地运行，连接你正在运行的桌面 WPS / Microsoft Office，读懂当前状态，指哪改哪，当场把事情做完。

核心区别：在文件外重新生成 vs 在当前文档就地修改

传统 AI 办公模式要求你反复将文件上传云端解析，并另存一份新文件，导致本地堆满从 v1.xlsx 到 v100_最终不改版.xlsx 的副本，极易破坏排版、丢失原公式与宏。
字浮 CharFloat 让你留在当前工作区，通过本地原生结构化通道与文档双向交互，改到哪儿看到哪儿。

为什么更靠谱？

• 比视觉点鼠标更精准（GUI Agent）：不依赖截图和坐标猜测，直连宿主原生结构化 API，改动精准无漂移。

• 比离线脚本更实时（如 openpyxl）：操作当前活体进程，修改毫秒级呈现在眼前，无需反复保存重开。

• 指哪改哪，无需重来：已做好的 80% 格式与业务逻辑完整保留，只做你要求的增量修改。

Related MCP server: Office MCP Server

四大核心能力 · 原生操控更强大

赋予 AI 直接操控 WPS 与 Office 的底层双手，不再让 AI 在黑盒里盲猜重做文件：

桌面客户端核心功能一览

• 本地高保真拓扑：实时展示当前接入的 AI 智能体、字浮后台服务与桌面 WPS / Office 的连接状态。

• 安全时光机：修改自动成快照，随时一键对比并秒级还原，再也不怕 AI 改坏数据。

• AI 助手授权中心：一键识别本机安装的智能体客户端，免手动配置秒级打通。

你习惯用谁，就给谁装上字浮

无需改变日常工作习惯，也不用额外花钱订阅新 AI。装上字浮，一键为你电脑上已有的常用 AI 软件打通直接操控能力。

🏆 官方实测最佳搭配：WPS Office ➕ 腾讯 WorkBuddy

• WorkBuddy（首推搭档）：腾讯 WorkBuddy 原生联动，一键接入后在日常对话中唤醒本地 Office 驱动，指哪改哪。

• 豆包工作：字节跳动 AI 工作平台，打破网页边界，直接在正在运行的 WPS 中就地标色与修表。

• 通义千问：阿里巴巴通义桌面端，本地通道秒级接入，让长文本分析与复杂计算直接增量注入表格。

• Kimi：月之暗面长文本推理助手，配置就绪，直接在客户端对话中提取与回写眼前正打开的工作表。

• Claude Code / Desktop：Anthropic 官方智能助手与 CLI，原生支持标准 MCP 协议，代码级精准控制 Office 内部对象。

• ChatGPT / Codex：OpenAI 官方客户端与生态工具，秒级打通桌面通道，告别静态文件反复上传下载。

• Cursor / Windsurf / VS Code：代码与工作流智能体，直接调用字浮 MCP 工具，实现工程化的办公自动化。

真实提示词用例

装上字浮后，直接对你常用的 AI 助手说：

💬 增量补全：“帮我把 8 月数据补齐，按去年的计算口径把同比增长率算出来，原有公式别动。”
💬 条件标色：“把获客成本超标和转化率未达标的行标出来，不要标红，改成浅黄色。”
💬 就地画图：“根据 6 到 8 月的月度营收数据画一张折线图，放在表格右下方。”
💬 跨表对齐：“以员工工号为索引，把 Sheet2 的绩效评分匹配回写到主表的 F 列。”
💬 跨文档提取：“把左边正在打开的采购合同第 3 条付款条款金额，填入审批表 C5 单元格。”
💬 安全撤回：“刚才那步格式调整撤回，恢复刚才的初态，这个我自己来微调。”

系统架构与数据流

字浮采用分层解耦的架构设计。外部 AI 智能体通过标准的 MCP 协议与本地服务建立连接，所有操作在用户本机内存中闭环完成：

flowchart TD
    subgraph Agent [" AI 智能体层 "]
        A1["Cursor / Windsurf / VS Code"]
        A2["Claude Desktop"]
        A3["腾讯 WorkBuddy / 豆包工作"]
        A4["任意自定义 MCP Client"]
    end

    subgraph Bridge [" 字浮核心服务 (Local Daemon) "]
        MCP["MCP 协议网关<br/>(stdio / SSE)"]
        Router["请求分发与权限校验"]
        Snapshot["安全时光机快照栈<br/>(预写入差异记录)"]
        Adapter["宿主适配器 (Host Adapter)<br/>统一 WPS 与 MS Office 接口"]
        
        MCP --> Router --> Snapshot --> Adapter
    end

    subgraph Host [" 桌面办公软件活体进程 "]
        WPS["WPS Office (WebSocket RPC 加载项)"]
        MSO["Microsoft Office (Office.js / 原生驱动)"]
    end

    Agent ==>|JSON-RPC 2.0| MCP
    Adapter ==>|本地回环通道| WPS
    Adapter ==>|系统原生通道| MSO

数据流主要经历四个环节：

1. 协议接入：AI 客户端通过 stdio 或 SSE 协议向字浮发送标准的工具调用请求；

2. 安全快照：在执行任何写入动作前，网关会先读取目标区域的当前数据并生成快照，推入本地历史栈；

3. 宿主适配：统一适配器将标准调用转化为当前活跃办公软件的私有 API；

4. 即时渲染：指令通过本地长连接直达活体文档，修改效果当场呈现在用户眼前。

宿主与平台支持

已在 Windows 与 macOS 双平台完成功能测试与实机验证：

快速上手

方式一：下载桌面客户端（推荐，零配置）

安装字浮桌面客户端，客户端启动后会自动一键配置并激活本机已安装的 AI 软件，自带可视化监控与安全时光机。

• macOS 版：适用 macOS 12+（Apple Silicon M 系列及 Intel 芯片）

• Windows 版：适用 Windows 10 / 11 64 位

客户端内提供“安装 / 修复加载项”与“AI 授权中心”，一键完成本地环境就绪。

方式二：让 AI 为自己一键配置 MCP

如果你正在使用 Cursor、Windsurf、VS Code、Claude Code 等智能体工具，无需手动翻阅文档写配置，直接将下面这段调教好的指令复制发给你的 AI：

请帮我把「字浮 CharFloat」配置为你的 MCP 扩展工具，让我可以直接操控本地 WPS 与 Office。

MCP 服务配置信息如下：
服务名称: charfloat
启动命令: npx -y office-agent-bridge

请识别当前开发环境（如 Cursor、Windsurf、VS Code、Claude Code 等），自动将上述配置写入你的 MCP 配置文件（例如 .cursor/mcp.json 或对应客户端设置）中并激活。

AI 将自动识别当前环境写入配置文件并启用 MCP，当场获得操作 Office 的能力！

方式三：开发者 CLI 命令行

字浮支持通过 npm / npx 快速初始化与服务管理：

# 快速向导配置
npx office-agent-bridge setup

# 常用服务管理命令
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 运行。

源码启动

# 1. 安装依赖并构建
npm ci && npm run build

# 2. 启动桌面管理器
npm start

参与开发

本项目采用模块化协作规范，详细开发文档参见 AGENTS.md：

• MCP 路由与工具定义：src/bridge/AGENTS.md

• WPS 加载项：wps-addon/AGENTS.md

• Office.js 插件：office-addon/AGENTS.md

• 配套 Agent 技能：skills/charfloat/SKILL.md

• 官网宣传工程：website/AGENTS.md（在线预览：charfloat.utmolight.xyz，临时地址）

许可证 (License)

本项目采用 MIT License 授权开源。