[sixgodgit]

README 重写

README 从 1407 行缩到约 400 行，新结构如下：

• 为什么用 Nyx：每条卖点都配了实测数字
• 快速开始：Hermes / MCP / Python 三种接入
• 它怎么工作：写入走哪 5 步、召回走哪 5 步
• 能力一览：核心能力 + 一个可折叠的"更多模块"
• Déjà Vu
• 安装
• 配置
• MCP 工具
• 数据与隐私（新）：写明什么情况下会联网、发出去的是什么
• 常见问题（新）
• 已知局限（新）
• Benchmark
• 最近更新

完整的逐条更新日志原样移到了 CHANGELOG.md。

对照代码核实时查出并修掉的问题

1. 新装后 doctor 误报 ❌

• 还没有任何记忆时，倒排索引本来就是空的，但自检把"空"一律判成失败。新用户装完第一次自检就看到失败。
• 现在没有在世记忆时视为正常（no_data）。
• 新增测试"新装全绿"；撤掉修复时这条测试会失败。

2. install.sh / install.bat 停在 v3.4.1

• 问题：
  • 脚本要求 Python 3.8+，实际需要 3.10+；
  • 还在用旧的"复制文件"方式装插件；
  • 会额外装一个旧的网关插件。它在消息到达时写一次，现在的记忆插件又写一次，同一句话会被记两遍。
• 现在只做 pip 安装（--vector 可选），发现旧插件文件时提示删除，不会自动删。

3. Docker 跑不起来

• 原因：
  • 容器里是 stdio 方式的 MCP 服务，docker compose up -d 没有标准输入，进程启动后立刻退出、反复重启；
  • 暴露的 8765 端口上没有任何服务在监听。
• 现在改为由 MCP 客户端用 docker run -i --rm -v nyx-data:/data nyx-memory 启动。

4. README 里几处说错的地方

• MCP 服务是纯标准库实现，不需要 [mcp] 额外依赖。
• 隔离区到期后不会自动真删，现在写明了要手动执行的命令。
• 环境变量表补上了会让 Nyx 联网的三个变量：DEEPSEEK_API_KEY、OPENROUTER_API_KEY、WTHREAD_LLM_EXTRACTION。
• 站内链接改成绝对地址，在 PyPI 页面上也能点。

5. 其他

• PyPI 简介更新为现在的定位。
• Hermes 插件的 README 同步更新。

验证

• 全量测试 529 项通过。
• build + twine check --strict：sdist 和 wheel 都 PASSED。
• 真实 Hermes 检查通过。
• install.sh 在干净环境里实测：
  • 装上 7.13.8；
  • 发现旧插件目录时给出提示；
  • Python 版本不符时退出。
• 镜像内容：按 Dockerfile 的步骤在干净环境里安装，走完一遍 MCP 握手、写入、重启后召回。
• 没能验证的：容器构建本身。Docker Hub 限流，拉不到基础镜像。

🤖 Generated with Claude Code

https://claude.ai/code/session_019ZZeQFn5F6mEbmX8vPsf4g

---

Generated by Claude Code