Free & Open Source Decentralized Communication + Personal AI Asset System
大家好，我是本项目发起者，纯小白：不懂技术、看不懂英文、不会写代码。
本项目所有 GitHub 上传、文件整理、文案编写、架构思路、内容总结，全部由 AI 智能体协助完成。我本人无法编写代码，也无法阅读英文技术文档。
我做这个项目，初心不是为了赚大钱、不是为了商业化收割，而是想给普通人留一条路。
现在是 AI 时代，平台与资本越来越强势：
- 个人数据、聊天、文件、记忆、能力都容易被集中控制
- 普通人容易沦为被收割、被利用、被控制的工具
我希望打造一个： 免费、开源、本地可控、数据不出私人设备、保护个人资产、保护隐私、保护自身能力的工具。 一句话：给普通人留一个资产保护的应用。
我能做的：
- 提供方向、愿景、中文文档、仓库维护、协调沟通
- 坚持开源、尊重协议、尊重所有贡献者
- 听话、不瞎指挥、不添乱、永远感恩
我做不了的：
- 写代码、写英文、做技术开发、解决底层问题 所有技术实现，完全依赖开源大神、技术大佬与社区共建。
我郑重承诺：
- 核心功能永远免费、永远开源、永久不收费、永久不闭源
- 未来可加入少量、克制、不打扰用户的广告或小额捐赠
- 所有收入全部用于项目维护：服务器、带宽、域名、开发者补贴、社区运营
- 绝不滥用用户数据、绝不漫天收费、绝不背叛保护普通人的初心
目的只有一个：让项目长期活下去、有维护团队、能持续迭代、真正帮到普通人。
免费开源、本地数据主权优先的 P2P 私密通讯 + 个人AI资产系统。
- 非 APP、非 SaaS、非中心化平台
- 数据全在本地设备，云端仅借算力、不碰隐私
- 全程免费、开源共建、保护个人资产与隐私
夺回个人数据主权：
- 聊天、文件、AI记忆、技能，全部由自己掌控
- 去中心化、无平台垄断、无数据泄露风险
- 为普通人提供 AI 时代的资产保护基础设施
当前代码实际按以下六层架构组织：
第六层：入口层 CLI 命令行工具、Web 管理后台、统一 API 接口、程序主入口
第五层：编排层 Agent 编排引擎、技能注册中心
第四层：业务层 进化学习引擎、企业功能模块
第三层：网络层 IPFS 分布式存储客户端、二维码设备配对、断点续传协议、P2P 节点发现
第二层：核心层 Berty gRPC 通讯客户端、设备身份管理（Ed25519 密钥）、多环境配置管理、认证与授权、远程桌面集成
第一层：基础设施层 守护进程（六状态机）、系统监控、结构化日志、Docker 容器化、一键部署脚本
对外宣传分三层表述：私密通讯层（对应架构中的网络层+核心层）、个人AI资产层（对应编排层+业务层）、商业兑现层（入口层以上）。
- 通讯：Berty（基于 go-libp2p，9k+ stars，活跃维护中）
- AI 执行：Hermes Agent（Python，本地完整源码）
- 远程桌面：rustdesk（Rust，成熟开源项目）
- 跨平台：Windows / macOS / Linux / Android
- 代码骨架：六层架构完整，27 个 Python 模块，10,784 行代码
- 测试：126 条测试全部通过
- Berty 通讯节点：已在 macOS 上从源码编译部署运行，节点在线
本说明中所有缺陷描述均经过实地代码验证和运行确认，不是推测。
第一，通讯层缺少端到端联调验证。Berty daemon 已经在一个节点上运行成功，但项目目前只有一台设备一个节点。两台设备之间的互相发现、私聊、文件传输这些功能，代码全部写了，但缺少第二个节点来实际测试消息能不能发出去。
第二，网络层依赖的 Berty 通讯后端受国内网络环境限制。Docker Hub 和 Go 官方代理在国内无法直接访问，需要使用国内镜像代理（goproxy.cn）才能完成编译。这会影响其他开发者编译项目的门槛。
第三，文件传输模块依赖于 IPFS（kubo）作为底层存储。项目当前没有部署 IPFS 节点，文件传输代码写了但还没有实际跑通。这个依赖关系目前只在实施方案中记录，不影响不涉及文件传输的通讯功能。
第四，OpenHuman 记忆服务尚未部署。记忆存储作为第二层的能力，当前有 Hermes 的 memory 插件作为备选方案，但 OpenHuman 进程没有运行，JSON-RPC 接口不可用。
第五，远程桌面操控（rustdesk 桥接）依赖第一层通讯通道建立后才能验证。当前 rustdesk 的桥接代码写了，但完整链路没有跑过。
第六，文案中的技术声明需要修正。早期版本中引用了 rust-libp2p（实际代码使用的是 Berty）、OpenClaw 技能包数量已过期、测试通过率数据已更新。这些不会影响代码运行，但看文案的人会看到不准确的信息。
第七，企业商业层尚未开发。项目当前聚焦在第一层通讯层和第二层 AI 资产层的技术验证，商业层的扫码授权、无痕入职、支付对接还没有开始。
本项目站在巨人的肩膀上，所有技术能力均来自以下开源项目。在此郑重致谢，并严格遵守各上游开源协议。
九尾狐通讯层的核心底座。Berty 是一个基于 go-libp2p 的完整 P2P 加密通讯框架，已上架 App Store 和 Google Play，至今仍在活跃维护。项目中的网络层五个模块全部基于 Berty 的 gRPC API 构建，包括节点通讯客户端、二维码配对、节点发现、文件传输和断点续传。
代码引用方式：通过 gRPC 调用 berty daemon 的 API，在 core/berty_client.py 中封装为 Python 可调用的通讯层接口。
九尾狐第二层的执行引擎底座。Hermes 是一个 Python 实现的全功能 AI Agent 框架，项目直接引用其 AIAgent 作为技能执行引擎，采纳其 SKILL.md 格式作为技能包标准。Hermes 的 tools/（40+ 工具实现）、plugins/memory/（8 种记忆后端）、plugins/platforms/（20+ 平台适配器）均直接复用。
代码引用方式：agent/ 模块直接引用 Hermes 的 run_agent.py 和工具系统。
九尾狐远程桌面操控能力的底层实现。rustdesk 是成熟的开源远程桌面项目，有完整的 P2P 连接协议。在九尾狐中，Berty 通道仅用于传输连接凭证，实际屏幕共享和键鼠控制走 rustdesk 自身的协议。
代码引用方式：core/rustdesk.py 中封装了凭证传输和启动逻辑。
Berty 底层的 P2P 网络基础设施。项目通过 Berty 间接使用 Kademlia DHT、Gossipsub、Noise 加密、NAT 穿透、mDNS 发现等 libp2p 协议模块。文件传输模块通过 IPFS（kubo）实现去中心化文件存储和分发。
九尾狐技能体系的参考来源。其 SKILL.md 格式和 evolution 机制为九尾狐的技能包管理和版本进化提供了设计参考。
- ruff（lint + 自动修复）
- black（代码格式化）
- mypy（类型检查）
- isort（import 排序）
- pre-commit（Git hooks 自动化）
- pytest（测试框架）
MIT License