技术支持渠道：遇到问题怎么联系科哥？
1. 这不是一份“客服指南”，而是一份“高效解决问题的路线图”
你刚部署好fft npainting lama图像修复镜像，上传了一张带水印的电商主图，用画笔标好了区域，点击“ 开始修复”——结果右下角弹出一行小字：“ 未检测到有效的mask标注”。
你愣了一下，重试三次，还是同样提示。
这时候，你真正需要的，不是再看一遍操作手册第4.2节，而是一个能立刻帮你定位问题、给出可执行方案的人。
科哥就是这个人。
但别急着打开微信发一句“你好，我修不了图”，先花3分钟读完这篇内容。它不会教你如何写代码，也不会讲傅里叶变换原理，它只做一件事：让你在最短时间内，用最有效的方式，把问题变成解决方案。
这不是“联系谁”的清单，而是“怎么问才最快得到答案”的实战经验总结。所有信息都来自真实用户高频反馈和科哥本人的响应习惯。
2. 三类问题，对应三种联系路径（别走错）
2.1 第一类：界面卡住 / 启动失败 / 根本打不开WebUI
→优先查日志，再截图，最后联系
这类问题90%能靠自查解决，盲目联系反而拉长处理时间。
自查三步法：
回到终端，确认服务是否真在运行：
ps aux | grep app.py如果没输出，说明服务根本没起来；如果有输出但浏览器打不开，继续下一步。
检查端口是否被占：
lsof -ti:7860如果返回一串数字，说明7860端口正被其他进程占用。执行
kill -9 <PID>释放端口，再重新运行bash start_app.sh。查看启动日志最后一行：
tail -n 20 /root/cv_fft_inpainting_lama/logs/start.log常见报错如
ModuleNotFoundError: No module named 'torch'，说明依赖没装全；OSError: [Errno 98] Address already in use就是端口冲突。
联系前必须准备：
- 终端中执行上述三条命令的完整输出截图（不是只截错误那行）
- 你使用的服务器系统版本（
cat /etc/os-release） - 镜像部署方式（是直接拉取CSDN星图镜像？还是自己git clone构建？）
注意：如果连终端都进不去，或SSH连接失败，请先检查服务器基础网络和权限，这类问题不属于本镜像技术支持范围。
2.2 第二类：修复效果不理想（边缘生硬、颜色偏移、结构错乱）
→提供原始图 + 标注图 + 输出图，三图对照
这是最常被低估的沟通成本。很多人只发一张“修坏了”的结果图，科哥看到后第一反应是：“你标的是哪块？用的什么参数？原图什么样？”
没有上下文，再强的模型也无从诊断。
正确提交方式（缺一不可）：
- 原始图像（original.png）：未经任何编辑的源文件
- 标注图像（mask.png）：在WebUI中按
Ctrl+Shift+I导出的mask图（白色为修复区，黑色为保留区） - 输出图像（output.png）：当前生成的结果
小技巧：在WebUI界面右上角点击「⚙ 设置」→ 勾选「导出mask时包含透明通道」，这样导出的mask图能清晰显示你实际涂抹的边界。
联系时同步说明：
- 你期望修复成什么效果（例如：“希望背景自然融合，不要看出拼接感”）
- 你尝试过的调整（例如：“已用小画笔重标三次，扩大了2像素边缘”）
- 是否在其他图上测试过相同操作（例如：“同一套操作在另一张人像上效果很好”）
2.3 第三类：功能需求 / 二次开发咨询 / 集成到自有系统
→明确说清“要做什么”，而不是“想要什么”
比如不要说：“能不能加个自动识别水印的功能？”
而要说：“我们每天要处理5000张商品图，水印位置固定在右下角100×30像素区域，希望能跳过手动标注，直接调用API传入坐标参数触发修复。”
后者让科哥能立刻判断：
- 是改前端交互（简单）
- 还是需新增后端路由和坐标解析逻辑（中等）
- 或涉及训练新检测模型（超出本镜像范畴）
高效沟通模板：
【场景】我们在XX业务中需要…… 【现状】目前靠人工标注，单图耗时约X分钟，日均处理Y张 【目标】希望实现Z效果，接受的响应延迟上限是__秒 【已有条件】服务器环境是Ubuntu 22.04，已部署本镜像，Python 3.10 【特别约束】不能改动现有WebUI界面，需通过API调用3. 联系科哥的四种方式（按推荐顺序排列）
3.1 首选：微信（312088415）——仅限技术问题，非闲聊
- 适合：已按前文完成自查/素材准备，问题描述清晰，需快速响应
- ❌不适合：问“这个能修吗？”“怎么安装？”“有教程吗？”（这些在文档里都有）
- 关键规则：
- 第一句话必须是问题类型编号：
[P1]、[P2]或[P3]（对应上一节三类问题） - 第二句话附带核心信息：如
[P2] 人像去痣，原图/标注/输出三图已打包，微信无法发送，稍后邮箱发您 - 禁用语音消息、模糊截图、长段文字无分段
示例合格消息：
[P2] 修复后背景色偏青，三图已上传网盘，链接：xxx，密码：1234。原图是室内拍摄，期望保持暖色调。示例不合格消息：
科哥在吗？我那个图修不好，你帮我看下呗？（无类型、无信息、无上下文）
3.2 次选：邮件（kege@cv-ai.dev）——适合需留痕、含大附件的深度问题
- 适合：需提交多组测试数据、完整日志、自定义配置文件
- 邮件标题规范：
[FFT-LAMA][P2] 电商主图水印去除色差问题 - XX公司 - 正文必须包含：
- 问题分类（P1/P2/P3）
- 镜像版本号（执行
cat /root/cv_fft_inpainting_lama/VERSION） - 简明复现步骤（3步以内）
- 附件命名规则：
companyname_original.png、companyname_mask.png等
3.3 备选：CSDN星图镜像广场评论区——适合通用型问题，惠及他人
- 适合：发现文档未覆盖的典型问题（如“Chrome浏览器粘贴图片失效”）、有普适性的使用技巧
- 发布前自查：
- 该问题是否已在「常见问题」章节提及？
- 是否已搜索评论区关键词（如“水印”“边缘”“颜色”）？
- 优质评论特征：
- 问题描述具体（“在Mac Safari 17.4中，拖拽PNG文件无反应”）
- 附带解决方案（“降级到Safari 17.3可临时解决”）
- 标注验证环境（“已验证：Ubuntu 22.04 + Chrome 125 正常”）
3.4 应急通道：GitHub Issues（仅限镜像源码级Bug）
- 适合：确认是代码缺陷导致的问题（如模型加载崩溃、特定尺寸图像必报Segmentation Fault）
- ❌不适合：效果优化、参数调整、使用疑问
- 提交必填项：
Environment：系统、CUDA版本、PyTorch版本（执行nvidia-smi和python -c "import torch; print(torch.__version__)"）Steps to reproduce：精确到命令行的复现步骤Expected behavior与Actual behavior对比Error traceback完整日志（非截图）
4. 什么问题科哥不接？提前避坑指南
技术支援不是万能接口。以下情况请自行解决或寻求其他途径：
4.1 明确不支持的范畴
- 服务器基础运维问题：如磁盘满、内存溢出、防火墙拦截、SSH密钥失效
- 跨平台兼容性问题：在Windows Subsystem for Linux (WSL) 或 Docker Desktop for Mac 上部署失败（本镜像仅验证 Ubuntu 20.04+/CentOS 8+ 物理机或标准云服务器）
- 非本镜像功能请求：如“能否接入我的私有MinIO？”“支持批量导入Excel坐标列表？”（这些属于定制开发，需另行协商）
- 效果主观争议：如“修复后不够艺术感”“不如某商业软件自然”（本镜像定位是实用型修复，非创意生成）
4.2 常见“伪问题”自查清单（省下90%沟通时间）
| 现象 | 自查动作 | 快速解法 |
|---|---|---|
| 修复后图像全黑 | 检查mask图是否全白（误将整个图涂白） | 用画笔工具点选“橡皮擦”，清除多余区域 |
| 右侧结果区空白 | 浏览器控制台（F12 → Console）是否有Uncaught TypeError | 刷新页面，或换Chrome/Firefox最新版 |
| 下载按钮灰色不可点 | 检查输出路径/root/cv_fft_inpainting_lama/outputs/权限 | chmod -R 755 /root/cv_fft_inpainting_lama/outputs/ |
| 修复速度极慢（>2分钟） | 执行nvidia-smi确认GPU是否被占用 | fuser -v /dev/nvidia*查杀其他进程 |
提示：所有自查命令均可在WebUI界面底部「🔧 开发者工具」中直接运行（需管理员权限开启）。
5. 让每次沟通都更高效的三个细节
5.1 学会看懂状态栏里的“人话”
WebUI右下角的状态提示不是装饰，而是精准的故障定位线索：
| 状态文本 | 真实含义 | 下一步动作 |
|---|---|---|
初始化...卡住超30秒 | 模型权重文件损坏或路径错误 | 重新执行bash download_weights.sh |
执行推理...卡住超2分钟 | GPU显存不足（<6GB）或输入图超大（>3000px） | 缩放图像至2000px内，或添加--lowvram启动参数 |
完成！已保存至: xxx.png但文件为空 | 磁盘写入失败（空间满/权限不足） | df -h查空间，ls -ld /root/cv_fft_inpainting_lama/outputs/查权限 |
5.2 保存你的“黄金参数组合”
不同场景有最佳实践参数，记下来比反复调试快十倍：
| 场景 | 推荐设置 | 效果提升点 | |--------------|---------------------------------------|--------------------------| | 人像去痣 | 画笔大小=3px，启用"边缘羽化" | 避免生硬圆形痕迹 | | 商品图去水印 | 标注时向外扩展5像素，关闭"颜色保真" | 强制匹配背景纹理 | | 老照片修复 | 先用大画笔覆盖大面积划痕，再用小画笔精修 | 分层处理，避免细节丢失 |5.3 一个被99%用户忽略的救命键：Ctrl+R
当WebUI界面异常（按钮失灵、图像不刷新、状态不更新），不要关浏览器，不要重启服务，直接按Ctrl+R强制刷新前端。90%的UI偶发故障由此解决。这是前端React应用的热重载机制，比重启服务快10倍。
6. 总结：从“找人帮忙”到“自主掌控”的思维升级
联系科哥，从来不是为了把问题丢给别人，而是为了更快地理解系统边界、掌握调试方法、积累实战经验。
- 当你第一次因“未检测到mask”而焦虑时，下次就能看懂状态栏含义；
- 当你第十次发送三图对照时，其实已能独立判断是标注问题还是模型局限；
- 当你第N次收到“建议扩大标注范围”的回复时，你脑中已形成一套自己的修复策略库。
真正的技术支持，不是消除问题，而是让你不再需要频繁求助。
所以，下次遇到问题，请先打开终端、截三张图、想清楚要表达什么——然后，再联系科哥。你会发现自己解决问题的速度，正在以肉眼可见的速度变快。
--- > **获取更多AI镜像** > > 想探索更多AI镜像和应用场景？访问 [CSDN星图镜像广场](https://ai.csdn.net/?utm_source=mirror_blog_end)，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
