flyingmouse-format

环境要求

• Windows 10/11（另有 macOS 版说明），需从 Releases 下载对应系统安装包
• 从源码运行需已安装 Node.js 与 npm
• 源码仓库不含 FFmpeg、LibreOffice、Poppler、Tesseract 等大体积引擎资源，开发者需自行准备 bin/ 下资源
• 本软件仅供个人免费使用，禁止商业售卖或套壳重新发布

安装与启动步骤

1. 1下载安装包

   到 Releases 页面下载 v0.7.0 对应系统的安装包；本轮只交付源码与 Windows Store APPX，NSIS/DMG 未发布，只有出现在资产列表才可下载。

2. 2安装并启动

   运行下载到的安装包完成安装，然后启动 FlyingMouse Format，进入鼠鼠主界面。

3. 3拖入文件转换

   把文件拖入窗口，选择目标格式后开始转换；完成后选择保存位置，软件会记住目标格式与保存目录。

4. 4从源码运行

   源码仓库不含 FFmpeg、LibreOffice、Poppler、Tesseract 引擎资源，运行完整转换功能前需自行准备 bin/ 下的资源。

   npm install
   npm run desktop

   复制

5. 5命令行转换

   用 cli.js 查询能力、查询目标格式并执行单个或批量转换、图片合并 PDF、PDF 合并；加 --json 输出 JSON。

   node cli.js capabilities --json
   node cli.js targets example.pdf --json
   node cli.js convert input.docx --to pdf --output output.pdf --json
   node cli.js convert a.png b.png --to webp --output-dir converted --json
   node cli.js images-to-pdf 1.jpg 2.jpg --output album.pdf --json
   node cli.js merge-pdfs a.pdf b.pdf --output merged.pdf --json

   复制

6. 6接入 Agent

   在软件顶部点击“接入 Agent”，会检索已存在的 skills 目录，确认后安装或更新配套 skill，不会自动创建未安装产品的目录。

7. 7测试与打包

   开发者可用以下命令运行测试与打包，需在项目根目录且已执行过 npm install。

   npm test
   npm run dist

   复制

如何确认成功

界面出现鼠鼠主界面即启动成功；命令行可执行 node cli.js capabilities --json，返回能力清单说明 CLI 可用。

常见问题

注意事项

• 首次启动语言跟随系统，手动选择后会记住设置；外观可选浅色、深色或跟随系统。
• 软件按源文件格式分别记住上次选择的目标格式，并记住上次保存目录。
• 安装版也可通过入口调用 CLI：macOS 为 FlyingMouse Format.app/Contents/MacOS/FlyingMouse Format --cli ...，Windows 为 FlyingMouse Format.exe --cli ...。
• 项目为开源发布，但许可明确限制商用，使用前请阅读 LICENSE。