Skip to content

Commit 7e511b4

Browse files
committed
docs: 同步更新教程 HTML,匹配最新 README 内容
1 parent be19832 commit 7e511b4

1 file changed

Lines changed: 110 additions & 53 deletions

File tree

docs/Claude-Config-tutorial.html

Lines changed: 110 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -257,10 +257,12 @@ <h3>目录结构</h3>
257257
<tr><th>组件</th><th>路径</th><th>说明</th></tr>
258258
<tr><td><strong>全局 CLAUDE.md</strong></td><td><code>CLAUDE.md</code></td><td>身份定义、行为边界、工具规则</td></tr>
259259
<tr><td><strong>设置</strong></td><td><code>settings.json</code></td><td>API 端点、模型、权限</td></tr>
260-
<tr><td><strong>MCP 免费工具</strong></td><td><code>mcp-servers/chatgpt-mcp/</code></td><td>ChatGPT 网页版,不消耗 API token</td></tr>
261-
<tr><td></td><td><code>mcp-servers/deepseek-mcp/</code></td><td>DeepSeek 网页版,不消耗 API token</td></tr>
260+
<tr><td><strong>MCP 免费工具</strong></td><td><code>mcp-servers/mcp-chatgpt-mirror/</code></td><td>ChatGPT 镜像站,不消耗 API token</td></tr>
261+
<tr><td></td><td><code>mcp-servers/mcp-chatgpt-official/</code></td><td>ChatGPT 官方站,不消耗 API token</td></tr>
262+
<tr><td></td><td><code>mcp-servers/mcp-deepseek/</code></td><td>DeepSeek 网页版,不消耗 API token</td></tr>
263+
<tr><td></td><td><code>mcp-servers/mcp-doubao/</code></td><td>豆包 AI,图片/文档识别、PPT 生成</td></tr>
262264
<tr><td><strong>死循环监控</strong></td><td><code>mcp-servers/deadloop-monitor/</code></td><td>输出死循环检测 → AutoIt 打断 → 摘要求助</td></tr>
263-
<tr><td><strong>会话数据</strong></td><td><code>projects/**/*.jsonl</code></td><td>对话记录(git 排除,不上传)</td></tr>
265+
<tr><td><strong>内嵌 Python</strong></td><td><code>mcp-servers/python3.13.3/</code></td><td>嵌入式 Python,无需系统安装,供 GUI 使用</td></tr>
264266
<tr><td><strong>跨对话记忆</strong></td><td><code>projects/&lt;slug&gt;/memory/</code></td><td>持久化的用户偏好和项目上下文</td></tr>
265267
</table>
266268
</div>
@@ -302,8 +304,11 @@ <h3>基础配置(settings.json)</h3>
302304
"effortLevel": "high",
303305
"permissions": {
304306
"allow": [
305-
"mcp__chatgpt__ask_chatgpt",
306-
"mcp__deepseek__ask_deepseek"
307+
"mcp__chatgpt-mirror__ask_chatgpt_mirror",
308+
"mcp__chatgpt-official__ask_chatgpt_official",
309+
"mcp__deepseek__ask_deepseek",
310+
"mcp__doubao__ask_doubao",
311+
"mcp__doubao__download_doubao_file"
307312
]
308313
}
309314
}</code></pre>
@@ -364,7 +369,6 @@ <h3>备份与同步(可选)</h3>
364369
<p><strong>自动排除的内容(已在 .gitignore 中配置):</strong></p>
365370
<ul>
366371
<li><code>settings.json</code>(含 API token,需手动复制)</li>
367-
<li><code>node_modules/</code>(各设备自行 npm install)</li>
368372
<li><code>projects/**/*.jsonl</code>(对话记录,不跨设备共享)</li>
369373
<li>运行时标记文件(<code>.deadloop-*</code>, <code>*.heartbeat</code></li>
370374
</ul>
@@ -377,22 +381,27 @@ <h3>备份与同步(可选)</h3>
377381

378382
<!-- ============ Section 2: MCP 免费工具 ============ -->
379383
<div class="section" id="s2">
380-
<h2><span class="icon" style="background:rgba(34,197,94,0.2);">🤖</span> MCP 免费工具:ask_chatgpt &amp; ask_deepseek</h2>
384+
<h2><span class="icon" style="background:rgba(34,197,94,0.2);">🤖</span> MCP 免费工具:四合一</h2>
381385

382-
<p>这两个 MCP 服务分别调用 ChatGPT 网页版和 DeepSeek 网页版,不消耗 API token,适合复杂代码审查、长文本分析、联网查资料等场景。</p>
383-
384-
<div class="highlight">
385-
<strong>💡 说明:</strong> <code>ask_chatgpt</code> 通过 <code>target</code> 参数统一支持镜像站(<code>"mirror"</code>)和官方站(<code>"official"</code>),无需独立的 mirror MCP 服务。默认先尝试第三方镜像,再尝试官方网站。
386-
</div>
386+
<p>四个独立 MCP 服务,分别调用 ChatGPT 镜像站、ChatGPT 官方站、DeepSeek 网页版和豆包 AI,不消耗 API token,适合复杂代码审查、长文本分析、联网查资料、图片识别等场景。</p>
387387

388388
<div class="service-grid">
389389
<div class="service-card" onclick="this.classList.toggle('active')">
390390
<span class="tag tag-primary">✨ 优先使用</span>
391-
<h3>ask_chatgpt</h3>
392-
<p>ChatGPT 网页版 · target 参数支持 official / mirror</p>
391+
<h3>ask_chatgpt_mirror</h3>
392+
<p>ChatGPT 镜像站 2233.ai</p>
393+
<div class="detail">
394+
<p>自动打开 Chromium 浏览器 → 手动登录 → session 自动保存 → 后续免登录</p>
395+
<p>国内网络可直接访问,无需 VPN</p>
396+
</div>
397+
</div>
398+
<div class="service-card" onclick="this.classList.toggle('active')">
399+
<span class="tag tag-green">🔄 备用</span>
400+
<h3>ask_chatgpt_official</h3>
401+
<p>ChatGPT 官方站 chatgpt.com</p>
393402
<div class="detail">
394403
<p>自动打开 Chromium 浏览器 → 手动登录 → session 自动保存 → 后续免登录</p>
395-
<p>支持 target="official"(chatgpt.com)和 target="mirror"(镜像站)</p>
404+
<p>需要 VPN 访问</p>
396405
</div>
397406
</div>
398407
<div class="service-card" onclick="this.classList.toggle('active')">
@@ -404,31 +413,50 @@ <h3>ask_deepseek</h3>
404413
<p>国内网络可直接访问,无需 VPN</p>
405414
</div>
406415
</div>
416+
<div class="service-card" onclick="this.classList.toggle('active')">
417+
<span class="tag tag-green">🖼️ 视觉</span>
418+
<h3>ask_doubao</h3>
419+
<p>豆包 AI · 图片/文档识别、PPT 生成</p>
420+
<div class="detail">
421+
<p>自动打开 Chromium 浏览器 → 手动登录豆包 → session 自动保存 → 后续免登录</p>
422+
<p>支持图片识别、PPT 生成、Excel 表格处理</p>
423+
<p>使用 <code>download_doubao_file</code> 工具下载生成的文件</p>
424+
</div>
425+
</div>
407426
</div>
408427

409428
<h3>文件结构</h3>
410429
<pre><code>~/.claude/mcp-servers/
411-
├── chatgpt-mcp/ # ChatGPT 官方站
412-
│ ├── server.js # MCP 服务入口
413-
│ ├── package.json
414-
│ └── node_modules/
415-
├── deepseek-mcp/ # DeepSeek 网页版
416-
│ ├── server.js
417-
│ └── ...</code></pre>
418-
419-
<h3>一键安装依赖(批处理)</h3>
420-
<p><code>~/.claude/</code> 目录下创建 <code>install-mcp-deps.bat</code></p>
430+
├── mcp-chatgpt-mirror/ # ChatGPT 镜像站
431+
├── mcp-chatgpt-official/ # ChatGPT 官方站
432+
├── mcp-deepseek/ # DeepSeek 网页版
433+
├── mcp-doubao/ # 豆包 AI(图片识别/PPT 生成)
434+
├── deadloop-monitor/ # 死循环监控
435+
├── shared/ # 共享模块(四服务共用)
436+
│ ├── browser.mjs # 浏览器生命周期
437+
│ ├── answer.mjs # 回答检测/提取
438+
│ ├── upload.mjs # 文件上传
439+
│ └── role.mjs # 角色模板
440+
├── python3.13.3/ # 内嵌 Python(GUI 配置界面)
441+
├── node_modules/ # 依赖(四服务共用)
442+
├── install-mcp-deps.bat # 一键安装
443+
└── install-mcp-config.mjs # 自动注册 MCP 配置</code></pre>
444+
445+
<h3>一键安装(批处理)</h3>
446+
<p><code>~/.claude/</code> 目录下双击 <code>install-mcp-deps.bat</code></p>
421447
<pre><code>@echo off
422-
echo Installing MCP dependencies...
423-
cd /d "%~dp0mcp-servers\chatgpt-mcp" && npm install && npx playwright install chromium
424-
cd /d "%~dp0mcp-servers\deepseek-mcp" && npm install && npx playwright install chromium
425-
echo All MCP dependencies installed.
448+
echo [1/2] Installing Chromium browser for Playwright...
449+
cd /d "%~dp0"
450+
npx playwright install chromium
451+
echo [2/2] Registering MCP server config...
452+
node install-mcp-config.mjs
453+
echo Done! Please Reload Window (Ctrl+Shift+P -> Reload Window).
426454
pause</code></pre>
427455
<p><strong>运行方式:</strong>右键 → <strong>以管理员身份运行</strong>(或双击运行)。</p>
428456
<ul style="color:#cbd5e1;font-size:0.95em;padding-left:20px;">
429-
<li>每个服务安装 Chromium 浏览器约 300MB,总下载量约 600MB</li>
430-
<li>如果中途失败,可以单独执行对应服务的安装命令重试</li>
431-
<li><code>node_modules/</code> 已被 .gitignore 排除,不会上传到 GitHub</li>
457+
<li>Chromium 浏览器约 300MB,首次安装需要较长时间(视网速 5-30 分钟)</li>
458+
<li><code>node_modules/</code><code>python3.13.3/</code> 已直接入仓,clone 后无需额外安装依赖</li>
459+
<li>四个服务共用同一份 Chromium</li>
432460
</ul>
433461
<div class="highlight">
434462
💡 也可以直接对我说 <strong>"帮我安装 MCP 依赖"</strong>,AI 会自动完成以上安装步骤。
@@ -438,30 +466,62 @@ <h3>首次使用与登录</h3>
438466
<div class="step-list">
439467
<div class="step-card">
440468
<h3>手动登录</h3>
441-
<p>在弹出窗口中手动登录对应服务(ChatGPT / DeepSeek)</p>
469+
<p>在弹出窗口中手动登录对应服务(ChatGPT 镜像站 / ChatGPT 官方站 / DeepSeek / 豆包</p>
442470
</div>
443471
<div class="step-card">
444472
<h3>关闭窗口</h3>
445-
<p>登录完成后关闭浏览器窗口,session 自动保存</p>
473+
<p>登录完成后关闭浏览器窗口,session 自动保存到独立配置文件中</p>
446474
</div>
447475
<div class="step-card">
448476
<h3>后续复用</h3>
449477
<p>后续调用不再需要重新登录,直接复用已保存的会话</p>
450478
</div>
451479
</div>
452480
<div class="highlight">
453-
<strong>注意:</strong>两个服务使用独立的浏览器配置文件,需要分别登录一次。<br>
454-
若需隐藏浏览器窗口(无人值守场景),在 settings.json 的 env 中设置 <code>"CHATGPT_HEADLESS": "true"</code>
481+
<strong>注意:</strong>四个服务使用独立的浏览器配置文件,需要分别登录一次。<br>
482+
若需隐藏浏览器窗口(无人值守场景),在 settings.json 的 env 中设置 <code>"CHATGPT_HEADLESS": "true"</code><code>"DEEPSEEK_HEADLESS": "true"</code><code>"DOUBAO_HEADLESS": "true"</code>
455483
</div>
456484

457485
<h3>提示词模板(代码审查专用)</h3>
458-
<div class="highlight">
459-
<strong>[待补充:用户提供的提示词模板]</strong>
460-
</div>
486+
<pre><code># 代码审查请求
487+
488+
请对以下代码进行全面的代码审查。请遵循以下要求:
489+
490+
## 一、代码背景(请根据实际情况填写)
491+
- **代码语言**:[如 Python / TypeScript / Go / Rust]
492+
- **功能简介**:[用一两句话说明代码的作用]
493+
- **审查重点**:[可选:性能 / 安全性 / 可维护性 / 边界条件 / 并发安全]
494+
495+
## 二、输出格式要求
496+
请按以下结构输出审查结果:
497+
1. **总体评价**(简短总结,2-3 句)
498+
2. **具体问题列表**(按严重程度从高到低排序)- 问题描述- 位置(行号/函数名)- 影响- 建议修复方式
499+
3. **优化建议**(非必须但能提升质量)
500+
501+
## 三、审查维度(请全部覆盖)
502+
- **正确性与逻辑**:是否存在潜在的逻辑漏洞、条件遗漏、边界未处理?
503+
- **错误处理**:异常是否被捕获?错误信息是否有用?资源是否释放?
504+
- **性能**:有无不必要的循环、重复计算、IO 阻塞?算法复杂度是否合理?
505+
- **安全性**:是否存在注入风险(SQL/命令)、敏感信息泄露、权限绕过?
506+
- **可维护性**:命名是否清晰?函数是否过长?有无重复代码?注释是否恰当?
507+
- **测试性**:代码是否易于测试?依赖是否可注入?
508+
509+
## 四、特殊要求
510+
- 如果发现**死循环**或**无限递归**的风险,请明确指出并给出检测方法。
511+
- 如果代码涉及并发(多线程/异步),请审查竞态条件和死锁风险。
512+
- 对于不安全的操作(如 eval、exec、直接拼接用户输入)给出警告。</code></pre>
461513

462514
<h3>角色模板文件</h3>
515+
<p>角色模板存放在 <code>mcp-servers/roles/</code> 目录下,每个文件是一个 <code>.md</code> 文件,文件名即为角色名(如 <code>python_tutor.md</code> → 角色名 <code>python_tutor</code>)。</p>
516+
<p>调用时通过 <code>role</code> 参数传入角色名:</p>
517+
<pre><code>askChatGPT(question, attachments, "python_tutor")</code></pre>
518+
<table>
519+
<tr><th>角色名</th><th>适用场景</th></tr>
520+
<tr><td><code>python_tutor</code></td><td>Python 代码审查、教学、调试(Django/Flask/数据分析)</td></tr>
521+
<tr><td><code>nodejs_tutor</code></td><td>Node.js/TypeScript/前端代码审查、教学、调试</td></tr>
522+
</table>
463523
<div class="highlight">
464-
<strong>[待补充:用户提供的角色模板格式说明]</strong>
524+
💡 也可以直接对我说 <strong>"帮我配置 settings.json"</strong>,AI 会自动从模板复制并引导你填写关键字段。
465525
</div>
466526
</div>
467527

@@ -486,12 +546,10 @@ <h3>扩展包文件架构</h3>
486546
└── install-extension.mjs # 扩展安装脚本</code></pre>
487547

488548
<h3>一键安装(批处理)</h3>
489-
<p>创建 <code>install-deadloop.bat</code></p>
549+
<p>运行 <code>install-deadloop.bat</code></p>
490550
<pre><code>@echo off
491-
echo Installing deadloop monitor dependencies...
551+
echo [1/1] Installing deadloop VS Code extension...
492552
cd /d "%~dp0mcp-servers\deadloop-monitor"
493-
npm install
494-
echo Extension installation...
495553
node install-extension.mjs
496554
echo Done. Please reload VS Code window (Ctrl+Shift+P -> Reload Window).
497555
pause</code></pre>
@@ -502,10 +560,9 @@ <h3>一键安装(批处理)</h3>
502560
<h3>扩展安装与界面</h3>
503561
<div class="step-list">
504562
<div class="step-card">
505-
<h3>安装依赖</h3>
563+
<h3>安装扩展</h3>
506564
<p>运行 <code>install-deadloop.bat</code>,或在终端手动执行:</p>
507565
<pre><code>cd ~/.claude/mcp-servers/deadloop-monitor
508-
npm install
509566
node install-extension.mjs</code></pre>
510567
</div>
511568
<div class="step-card">
@@ -602,11 +659,11 @@ <h3>检测到死循环</h3>
602659
</div>
603660
<div class="step-card">
604661
<h3>注入求助指令</h3>
605-
<p><code>inject_file</code> 将预置的摘要生成指令粘贴到 Claude Code 输入框并自动提交 → 收到注入消息后,Claude Code 自动调用 <code>ask_chatgpt</code> 发送问题</p>
662+
<p><code>inject_file</code> 将预置的摘要生成指令粘贴到 Claude Code 输入框并自动提交 → 收到注入消息后,Claude Code 自动调用 MCP 工具(<code>ask_chatgpt_mirror</code> / <code>ask_deepseek</code> / <code>ask_doubao</code>发送问题</p>
606663
</div>
607664
<div class="step-card">
608665
<h3>获取外部答案</h3>
609-
<p>ChatGPT 网页版返回代码审查结果或修复建议 → Claude Code 按返回内容修改代码</p>
666+
<p>AI 网页版返回代码审查结果或修复建议 → Claude Code 按返回内容修改代码</p>
610667
</div>
611668
<div class="step-card">
612669
<h3>冷却恢复</h3>
@@ -616,7 +673,7 @@ <h3>冷却恢复</h3>
616673

617674
<h3>配置要点</h3>
618675
<ul style="color:#cbd5e1;font-size:0.95em;padding-left:20px;">
619-
<li>确保 settings.json 中 permissions.allow 包含 <code>mcp__chatgpt__ask_chatgpt</code><code>mcp__deepseek__ask_deepseek</code></li>
676+
<li>确保 settings.json 中 permissions.allow 包含所有 MCP 工具:<code>mcp__chatgpt-mirror__ask_chatgpt_mirror</code><code>mcp__chatgpt-official__ask_chatgpt_official</code><code>mcp__deepseek__ask_deepseek</code><code>mcp__doubao__ask_doubao</code><code>mcp__doubao__download_doubao_file</code></li>
620677
<li>死循环监控的 <code>config.mjs</code> 中的冷却时间、触发阈值可根据工作节奏调整</li>
621678
<li>若需长期无人值守,将 <code>CHATGPT_HEADLESS=true</code> 设为隐藏浏览器模式(但首次仍需登录)</li>
622679
</ul>
@@ -639,15 +696,15 @@ <h2><span class="icon" style="background:rgba(239,68,68,0.2);">❓</span> 常见
639696
<span>"Failed to launch browser" 错误</span>
640697
<span class="arrow"></span>
641698
</div>
642-
<div class="faq-a">Playwright Chromium 没有正确安装。手动运行:<br><code>cd ~/.claude/mcp-servers/chatgpt-mcp && npx playwright install chromium</code></div>
699+
<div class="faq-a">Playwright Chromium 没有正确安装。手动运行:<br><code>cd ~/.claude/mcp-servers && npx playwright install chromium</code></div>
643700
</div>
644701

645702
<div class="faq-item" onclick="toggleFaq(this)">
646703
<div class="faq-q">
647-
<span>ask_chatgpt 报 "Page crashed"</span>
704+
<span>MCP 工具报 "Page crashed"</span>
648705
<span class="arrow"></span>
649706
</div>
650-
<div class="faq-a">常见原因:1) 无法访问目标站点(尝试切换 target 参数);2) 浏览器配置目录被锁定(结束所有 Chrome 进程后重试)。</div>
707+
<div class="faq-a">常见原因:1) 无法访问目标站点(国内访问官方站需 VPN,尝试切换镜像站);2) 浏览器配置目录被锁定(结束所有 Chrome 进程后重试)。</div>
651708
</div>
652709

653710
<div class="faq-item" onclick="toggleFaq(this)">
@@ -697,7 +754,7 @@ <h3>安装死循环监控</h3>
697754
</div>
698755

699756
<footer style="text-align:center;padding:40px 0 20px;color:#475569;font-size:0.85em;">
700-
<p>基于 README.md 最新内容生成 · 2026-05-22</p>
757+
<p>基于 README.md 最新内容生成 · 2026-05-26</p>
701758
</footer>
702759

703760
</div>

0 commit comments

Comments
 (0)