这个软件的来源是我某次现场值守无聊，写了一个简易版本

后来仔细一想，这个东西不如拿去当毕设...

于是又在某一次值守现场，花了两个小时去完善了一下

🚀 NeedingChats

🖧 零依赖、开箱即用的点对点加密聊天工具

Needing Chat 是一个纯 Python 实现的点对点即时通讯应用，让你无需任何中间服务器即可与朋友安全聊天。基于标准库构建，支持一键生成连接链接、端到端加密、跨平台运行，是技术爱好者和隐私保护用户的理想选择。

36917773e3e3b017df094a7eb48602bb.png

---

🤔 为什么选择 Needing Chat？

特性	Needing Chat	传统IM	其他P2P工具
安装部署	零依赖，单文件	需安装客户端	依赖复杂
隐私保护	无服务器存储	云端存档	部分支持
使用门槛	复制链接即用	注册登录	配置复杂
跨平台	✅ 全平台	✅ 全平台	⚠️ 部分支持
源码可读性	🌟🌟🌟🌟🌟	⭐ 闭源	🌟🌟🌟

结论：

如果你追求极致简洁与隐私，Needing Chat 是你的最佳选择。

---

📋 目录

• ✨ 核心特性
• 🎯 快速开始
• 📦 安装部署
• 🎮 使用指南
• 🔧 技术架构
• 📁 项目结构
• ⚙️ 配置说明
• 🤝 贡献指南
• 📈 路线图
• 📝 许可证
• 🏆 致谢

---

✨ 核心特性

特性	说明
🔌 纯P2P架构	无服务器中转，端到端直接通信
🔐 轻量级加密	基于用户名派生密钥的XOR加密（演示级）
🎯 一键连接	自动生成p2pchat://链接，复制粘贴即可连接
🎨 智能UI	彩色终端界面，Windows专属优化
💾 本地持久化	用户名自动保存，无需重复输入
🔄 会话切换	聊天中随时粘贴新链接切换对端
📱 跨平台	支持Windows/Linux/macOS
🚫 零依赖	仅使用Python标准库

---

🎯 快速开始

# 克隆项目
git clone https://github.com/username/p2p-chat.git
cd p2p-chat

# 直接运行（推荐作为服务器启动）
python p2p_chat.py -s

作为服务器启动后，程序会自动生成连接链接并复制到剪贴板，将链接发送给朋友即可开始聊天！

---

📦 安装部署

系统要求

• Python 3.6 或更高版本
• 支持终端的彩色输出

安装步骤

# 方式一：直接运行源码
cd p2p-chat
python p2p_chat.py

# 方式二：添加到PATH（可选）
chmod +x p2p_chat.py
sudo ln -s $(pwd)/p2p_chat.py /usr/local/bin/p2p-chat

---

🎮 使用指南

启动模式

1️⃣ 服务器模式（推荐）

python p2p_chat.py -s

• 自动分配端口并监听
• 生成连接链接并复制到剪贴板
• 等待对方连接

2️⃣ 客户端模式

python p2p_chat.py

• 手动输入或粘贴聊天链接
• 主动连接对端

聊天命令

命令	说明
/help	显示帮助信息
/status	查看当前连接状态
/quit 或 Ctrl+C	退出程序
/clear	清屏

连接流程

graph TD
    A[启动应用] --> B{选择模式};
    B -->|服务器模式| C[生成p2pchat://链接];
    B -->|客户端模式| D[输入链接];
    C --> E[复制链接给好友];
    D --> F[解析并连接];
    E --> G[等待连接];
    F --> H[建立P2P连接];
    G --> H;
    H --> I[开始加密聊天];

---

🔧 技术架构

模块化设计

┌─────────────────────────────────────────┐
│              控制台 UI (ui.py)           │
│  (事件渲染/用户交互/跨平台输入处理)       │
└─────────────────┬───────────────────────┘
                  │
┌─────────────────▼───────────────────────┐
│            通信核心 (core.py)            │
│  (TCP套接字/线程管理/状态维护)          │
└──────┬──────────────────┬───────────────┘
       │                  │
┌──────▼──────┐     ┌────▼───────┐
│  加密模块   │     │ 链接协议   │
│ (crypto.py) │     │(link_utils)│
└─────────────┘     └────────────┘

通信模型

• 传输层: TCP套接字
• 并发模型: 单发送主线程 + 单接收子线程
• 消息格式: JSON封装，包含时间戳、用户名、加密标志
• 状态管理: 核心维护对端连接生命周期

加密机制

⚠️ 安全警告
当前使用XOR加密+用户名派生密钥，仅用于演示和学习目的。
请勿用于真实敏感信息传输！
如需生产级安全，建议替换为TLS或Signal协议。

# 密钥派生逻辑示例
def derive_key(username: str) -> int:
    key = 0
    for i, char in enumerate(username):
        key = (key + ord(char) + i) % 256
    return key

# 加密过程：message[i] XOR key XOR i

---

📁 项目结构

p2p-chat/
├── p2p_chat.py           # 入口脚本
├── core.py               # 通信核心
├── crypto.py             # 加密工具
├── link_utils.py         # 链接协议
├── env_utils.py          # 环境配置
├── ui.py                 # 控制台UI
├── .env                  # 用户名持久化
├── README.md             # 项目文档
└── LICENSE               # MIT许可证

---

⚙️ 配置说明

环境变量

项目自动管理 .env 文件，包含：

USERNAME=YourName

手动配置

如需修改默认行为，可直接编辑各模块的常量：

文件	配置项	说明
core.py	BUFFER_SIZE	TCP缓冲区大小（默认4096）
crypto.py	ENCRYPTION_ENABLED	全局加密开关
ui.py	COLOR_SCHEME	终端配色方案

---

🤝 贡献指南

欢迎贡献代码、提出Issue或分享建议！

开发环境搭建

git clone https://github.com/username/p2p-chat.git
cd p2p-chat
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

贡献流程

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

代码规范

• 遵循 PEP 8 编码规范
• 函数需包含 docstring
• 关键逻辑添加注释
• 保持零依赖原则

---

📈 路线图

• 基础P2P通信
• 消息加密
• 自动链接生成
• Windows平台优化
• 多用户聊天室支持
• 文件传输功能
• 端到端加密（E2EE）升级
• GUI图形界面

---

📝 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

MIT License

Copyright (c) 2024 Needing Chat Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
...

---

🏆 致谢

• 感谢 Python 社区提供的优雅标准库
• 灵感来源于经典的P2P即时通讯理念

---

📞 支持与联系

• 📧 联系作者 - 请在互联网上寻找出Needingcen的电话号码

---

⭐ 如果这个项目对你有帮助，请给它一个Star！⭐