Skip to content

Commit 178a6e4

Browse files
committed
docs: 同步 README 目录结构和 MCP 工具表为最新布局
1 parent 07ba74a commit 178a6e4

1 file changed

Lines changed: 43 additions & 51 deletions

File tree

README.md

Lines changed: 43 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)