🚀 Kimi 远程截图辅助工具

一个集成了 Kimi AI 智能分析功能的远程截图与剪贴板共享工具，专为提高工作效率和学习辅助而设计。

✨ 核心特性

📸 智能截图系统

• 一键截图：快速捕获屏幕内容并自动保存
• 历史管理：自动保存所有截图，支持历史记录查看
• 远程访问：支持局域网内多设备访问和操作

🤖 Kimi AI 集成

• 智能图片分析：基于 Kimi Vision API 的图片内容理解
• 多场景预设：内置题目解析、代码审查、数据分析等专业模板
• 对话式交互：支持多轮对话，保持上下文连贯性
• 自定义提示词：灵活配置分析需求

📋 剪贴板共享

• 跨设备同步：在不同设备间快速共享文本内容
• 实时传输：即时将文本发送到目标设备剪贴板
• Web界面操作：通过浏览器进行便捷操作

🎨 现代化界面

• 响应式设计：完美适配手机、平板、桌面设备
• 双面板布局：左侧截图操作，右侧AI分析
• 深色模式支持：自动适应系统主题设置
• 流畅动画：现代化的交互体验

🛠️ 技术架构

后端技术栈

• Flask 3.0.0：轻量级Web框架
• Flask-CORS：跨域资源共享支持
• OpenAI SDK：Kimi AI API集成
• Pillow：图像处理库
• PyAutoGUI & PyInput：系统交互支持

前端技术栈

• 原生HTML5/CSS3/JavaScript：无框架依赖
• 响应式CSS Grid/Flexbox：现代布局系统
• CSS动画：流畅的用户交互体验
• Progressive Web App：类原生应用体验

AI能力

• Kimi Vision API：图像理解与分析
• 多模态对话：文本与图像的智能交互
• 上下文记忆：保持对话连贯性

🚀 快速开始

环境要求

• Python 3.8+
• Windows/macOS/Linux
• 现代浏览器（Chrome、Firefox、Safari、Edge）

安装步骤

1. 克隆项目

git clone [项目地址]
cd kimi-remote-screenshot-assistant

2. 安装依赖

pip install -r requirements.txt

3. 配置 Kimi API

获取API密钥：访问 Kimi开放平台 申请API密钥

配置方式（二选一）：

方式A：环境变量（推荐）

# Windows PowerShell
$env:KIMI_API_KEY = "your-api-key-here"

# Linux/macOS
export KIMI_API_KEY="your-api-key-here"

方式B：Web界面配置 启动应用后访问设置页面进行配置

4. 启动应用

python app.py

5. 访问应用

• 主界面：http://localhost:8088/
• AI集成界面：http://localhost:8088/kimi
• 设置页面：http://localhost:8088/ai/settings

📱 使用指南

基础功能

📸 截图操作

1. 点击"截图"按钮进行屏幕捕获
2. 截图自动保存到 ./img 目录
3. 在界面下方查看最近截图

📋 文本共享

1. 在文本框输入要共享的内容
2. 点击"发送到剪贴板"
3. 内容已复制到系统剪贴板

🤖 AI分析

1. 选择预设分析模板或输入自定义提示词
2. 点击"分析最新截图"
3. 查看AI分析结果
4. 可继续对话深入讨论

预设分析模板

模板名称	适用场景	功能描述
🎓 题目解析	教育学习	分析题目，提供详细解题步骤
💻 代码审查	编程开发	代码分析、错误检查、优化建议
🔍 代码解题	算法学习	理解问题并提供Python解决方案
📊 数据分析	数据处理	分析图表、统计信息、关键发现

远程访问

1. 获取本机IP地址

# Windows
ipconfig

# Linux/macOS
ifconfig

2. 局域网访问 在其他设备浏览器中访问：http://[你的IP]:8088/kimi

3. 防火墙配置 确保8088端口允许入站连接

🔧 高级配置

自定义预设模板

编辑 app.py 中的 PRESET_PROMPTS 字典：

PRESET_PROMPTS = {
    "自定义模板": "你的提示词内容...",
    # 添加更多模板
}

修改AI模型

# 文本模型
model="kimi-k2-0905-preview"

# 视觉模型  
model="moonshot-v1-8k-vision-preview"

端口配置

修改 app.py 中的端口设置：

app.run(host='0.0.0.0', port=8088, debug=False)

📊 API接口

核心接口

接口	方法	功能
/ai/chat	POST	文本对话
/ai/analyze-image	POST	图片分析
/ai/settings	GET/POST	API配置
/grapScreen	GET	执行截图
/getContent	POST	发送文本到剪贴板

使用示例

# 文本对话
curl -X POST http://localhost:8088/ai/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "你好", "session_id": "default"}'

# 图片分析
curl -X POST http://localhost:8088/ai/analyze-image \
  -H "Content-Type: application/json" \
  -d '{"preset": "题目解析", "session_id": "default"}'

🔒 安全建议

1. API密钥安全

   • 使用环境变量存储密钥
   • 定期更新API密钥
   • 避免在代码中硬编码

2. 网络安全

   • 仅在可信网络环境使用
   • 考虑添加访问认证
   • 监控API使用情况

3. 数据隐私

   • 截图文件本地存储
   • 敏感信息谨慎分析
   • 定期清理历史数据

🐛 故障排除

常见问题

Q: API密钥验证失败

• 检查密钥格式是否正确
• 确认网络连接正常
• 验证Kimi平台账户状态

Q: 截图功能不工作

• 确认系统权限设置
• 检查img目录是否存在
• 验证Pillow库安装正确

Q: 远程访问失败

• 检查防火墙设置
• 确认IP地址和端口正确
• 验证网络连通性

调试模式

启用详细日志：

app.run(host='0.0.0.0', port=8088, debug=True)

📈 性能优化

• 图片压缩：自动优化截图文件大小
• 缓存机制：减少重复API调用
• 异步处理：提升响应速度
• 资源管理：自动清理临时文件

🤝 贡献指南

欢迎提交Issue和Pull Request！

1. Fork项目
2. 创建特性分支
3. 提交更改
4. 推送到分支
5. 创建Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

• Kimi AI - 提供强大的AI能力
• Flask - 优秀的Web框架
• OpenAI - 标准化的API接口

📞 联系方式

• 项目主页：[GitHub地址]
• 问题反馈：[Issues页面]
• 技术交流：[讨论区]

---

让AI助力你的工作和学习！ ✨