@@ -39,12 +39,12 @@ dir # Windows 查看文件列表
3939| ------| ------| ------|
4040| ** 全局 CLAUDE.md** | ` CLAUDE.md ` | 身份定义、行为边界、工具规则、自动调用策略 |
4141| ** 设置** | ` settings.json ` | API 端点、模型、权限、环境变量 |
42- | ** MCP 免费工具** | ` mcp-servers/mcp-chatgpt-mirror/ ` | ChatGPT 镜像站,不消耗 API token |
43- | | ` mcp-servers/mcp-chatgpt-official/ ` | ChatGPT 官方站,不消耗 API token |
44- | | ` mcp-servers/mcp-deepseek/ ` | DeepSeek 网页版,不消耗 API token |
45- | | ` mcp-servers/mcp-doubao/ ` | 豆包 AI,支持图片/文档识别、PPT 生成 |
42+ | ** AI 服务(MCP)** | ` mcp-servers/ai-services/ ` | ChatGPT/DeepSeek/豆包等 AI 网页版 MCP |
43+ | ** MinerU 文档解析** | ` mineru-open-mcp ` (MCP 工具) | PDF/图片/Office → Markdown,支持 OCR |
44+ | ** PDF 工具** | ` pdf-toolkit ` (MCP 工具) | 合并/拆分/加密/水印/压缩 PDF |
4645| ** 死循环监控** | ` deadloop-monitor/ ` | 检测输出死循环 → AutoIt 打断 → 摘要求助 |
47- | ** 内嵌 Python** | ` mcp-servers/python3.13.3/ ` | 嵌入式 Python,无需系统安装,供 GUI 配置界面使用 |
46+ | ** 办公工具** | ` mcp-servers/office-tools/ ` | Markdown → PDF(7 套主题) |
47+ | ** 内嵌 Python** | ` mcp-servers/python3.13.3/ ` | 嵌入式 Python,无需系统安装 |
4848| ** 会话数据** | ` projects/**/*.jsonl ` | 对话记录(git 排除,不上传) |
4949| ** 跨对话记忆** | ` projects/<slug>/memory/ ` | 持久化的用户偏好和项目上下文 |
5050
@@ -223,41 +223,39 @@ Ctrl+Shift+P → 输入 "Reload Window" → 回车
223223本节适合需要深度定制自动化工作流、MCP 工具链和死循环监控的用户。
224224如果只是基础使用,请参见上文的【基础设置】。
225225
226- ### MCP 免费工具:三合一
226+ ### MCP 免费工具
227227
228- 三个独立 MCP 服务,分别调用 ChatGPT 镜像站、ChatGPT 官方站和 DeepSeek 网页版 ,不消耗 API token,适合复杂代码审查、长文本分析、联网查资料等场景 。
228+ 四个独立 MCP 服务,分别调用 ChatGPT 镜像站、ChatGPT 官方站、 DeepSeek 网页版和豆包 AI ,不消耗 API token,适合复杂代码审查、长文本分析、视觉识别等场景 。
229229
230- | 工具 | 服务端 | 说明 |
231- | ------| --------| ------|
232- | ` ask_chatgpt_mirror ` | ` mcp-chatgpt-mirror ` | ChatGPT 镜像站 2233.ai,优先使用 |
233- | ` ask_chatgpt_official ` | ` mcp-chatgpt-official ` | ChatGPT 官方站 chatgpt.com,需 VPN |
234- | ` ask_deepseek ` | ` mcp-deepseek ` | DeepSeek 网页版,国内直连 |
235- | ` ask_doubao ` | ` mcp-doubao ` | 豆包 AI,图片/文档识别、PPT 生成、Excel 表格 |
236- | ` download_doubao_file ` | ` mcp-doubao ` | 下载豆包生成的 PPT/Excel 文件 |
230+ | 工具 | 位置 | 说明 |
231+ | ------| ------| ------|
232+ | ` ask_chatgpt_mirror ` | ` ai-services/chatgpt-mirror/ ` | ChatGPT 镜像站 2233.ai,支持图片输入,优先使用 |
233+ | ` ask_chatgpt_official ` | ` ai-services/chatgpt-official/ ` | ChatGPT 官方站 chatgpt.com,需 VPN |
234+ | ` ask_deepseek ` | ` ai-services/deepseek/ ` | DeepSeek 网页版,国内直连 |
235+ | ` ask_doubao ` | ` ai-services/doubao/ ` | 豆包 AI,图片/文档识别、PPT 生成、Excel 表格 |
236+ | ` download_doubao_file ` | ` ai-services/doubao/ ` | 下载豆包生成的 PPT/Excel 文件 |
237+ | ` parse_documents ` | ` mineru-open-mcp ` (工具名) | 文档/图片 OCR 提取文字到 Markdown |
238+ | ` pdf_* ` 系列 | ` pdf-toolkit ` (工具名) | 合并/拆分/加密/水印/加页码等 |
237239
238240
239241
240242#### 文件结构
241243
242244```
243245~/.claude/
244- ├── mcp-servers/ # MCP 服务(聊天机器人网页版)
245- │ ├── mcp-chatgpt-mirror/ # ChatGPT 镜像站
246- │ ├── mcp-chatgpt-official/ # ChatGPT 官方站
247- │ ├── mcp-deepseek/ # DeepSeek 网页版
248- │ └── mcp-doubao/ # 豆包 AI(图片识别/PPT 生成)
249- ├── shared/ # MCP 共享模块
250- │ ├── browser.mjs
251- │ ├── answer.mjs
252- │ ├── upload.mjs
253- │ └── role.mjs
254- ├── node_modules/ # MCP 依赖
255- ├── python3.13.3/ # 内嵌 Python
256- ├── deadloop-monitor/ # 死循环监控(可选装)
257- ├── scripts/ # 工具脚本
258- │ ├── setup-proxy.mjs # 一键配置代理
259- │ └── proxy-detect.sh # 终端动态检测
260- ├── skills/ # Skills
246+ ├── mcp-servers/
247+ │ ├── ai-services/ # AI 网页版 MCP 服务
248+ │ │ ├── chatgpt-mirror/ # ChatGPT 镜像站
249+ │ │ ├── chatgpt-official/ # ChatGPT 官方站
250+ │ │ ├── deepseek/ # DeepSeek 网页版
251+ │ │ ├── doubao/ # 豆包 AI
252+ │ │ └── shared/ # 共享模块(browser/answer/upload/role)
253+ │ ├── office-tools/ # 办公工具(md-to-pdf 等)
254+ │ ├── deadloop-monitor/ # 死循环监控
255+ │ ├── python3.13.3/ # 内嵌 Python
256+ │ └── node_modules/ # 依赖
257+ ├── skills/ # /mcp-baipiao、/mcp-office-tool 等
258+ ├── scripts/ # 工具脚本
261259├── install-mcp-deps.bat
262260└── install-mcp-config.mjs
263261```
@@ -403,25 +401,23 @@ claude mcp add --transport stdio mineru-open-mcp -- npx -y mineru-open-mcp
403401
404402#### API Key 配置(Precision 模式)
405403
406- 在 [ mineru.net] ( https://mineru.net ) 注册并获取 API Token 后,设置环境变量:
407-
408- ``` bash
409- # 临时设置(当前终端有效)
410- export MINERU_API_TOKEN=" 你的token"
411-
412- # 永久设置(写入 .bashrc)
413- echo ' export MINERU_API_TOKEN="你的token"' >> ~ /.bashrc
414- ```
415-
416- 或在 ` settings.json ` 的 ` env ` 字段添加:
404+ 在 [ mineru.net] ( https://mineru.net ) 注册并获取 API Token 后,配置到 ` ~/.claude.json ` (用户家目录,不会被 git 跟踪):
417405
418406``` json
419- "env" : {
420- "MINERU_API_TOKEN" : " 你的token"
407+ {
408+ "mcpServers" : {
409+ "mineru-open-mcp" : {
410+ "command" : " uvx" ,
411+ "args" : [" mineru-open-mcp" ],
412+ "env" : {
413+ "MINERU_API_TOKEN" : " 你的token"
414+ }
415+ }
416+ }
421417}
422418```
423419
424- 配置后,MCP 服务会自动加载 token,无需重启 。
420+ ⚠️ 每次修改 ` ~/.claude.json ` 后需要 ** Reload Window ** 让 MCP 进程重新加载 。
425421
426422#### 使用方式
427423
@@ -443,11 +439,7 @@ ocr 识别这张图片中的文字
443439
444440** 方式二:通过 Skill 调用**
445441
446- ``` text
447- /mineru-doc-extractor flash-extract 报告.pdf
448- ```
449-
450- 或使用 ` /mcp-baipiao ` 自动匹配场景。
442+ 使用 ` /mcp-office-tool ` 或 ` /mcp-baipiao ` 自动匹配场景。
451443
452444#### 调用逻辑
453445
@@ -485,7 +477,7 @@ Claude 将结果呈现给用户
485477- 文件发送到 mineru.net 处理后不留存
486478- 参数 ` language ` 默认 ` ch ` ,英文文档建议设为 ` en `
487479
488- > ** ⚠️ 能力边界:** MinerU 的图片处理是 ** OCR + 版面分析** ,能识别图片中的文字、表格、公式,但** 不具备图像理解能力** 。如果需要"这张截图有什么问题"、"这张照片里是什么"等视觉分析,应使用 ` ask_doubao ` (豆包支持多模态识别 )。简单区分:** 要提取文字 → MinerU,要理解画面 → 豆包 ** 。
480+ > ** ⚠️ 能力边界:** MinerU 的图片处理是 ** OCR + 版面分析** ,能识别图片中的文字、表格、公式,但** 不具备图像理解能力** 。如果需要"这张截图有什么问题"、"这张照片里是什么"等视觉分析,应使用 ` ask_chatgpt_mirror ` (支持图片输入 )。简单区分:** 要提取文字 → MinerU,要理解画面 → mirror ** 。
489481---
490482
491483### 死循环监控(Dead Loop Monitor)
0 commit comments