内容
# 二进制网格
私人语义二进制网格代理 — 用于代码分析、漏洞搜索和自动修复生成的自主AI系统，使用物理启发的确定性智能。
## 架构
二进制网格实现**确定性智能** — 一种基于物理的方法，其中AI不“生成”解决方案，而是导航预计算的解决方案空间：
- **模式槽**: 二进制编码的成功模式（修复、重构、不变性）
- **网格查询**: 跨16K+槽的语义搜索 → 直接命中（sim ≥ 0.85）= 0 LLM调用，<1ms
- **飞轮学习**: 将成功的解决方案提炼成可重用的二进制格式
- **质量矩阵**: L0-L9综合评分（稳定性、有用性、可重用性、延迟、完成度）
### 核心组件
| 组件 | 路径 | 目的 |
|-----------|------|---------|
| bin_gg | `cmd/binarymesh` | 主服务器：HTTP API (:1337)，集群 (:1447)，编排器 |
| binary-mesh-mcp | `cmd/mcp` | OpenCode集成的MCP服务器（57种工具） |
| 嵌入器 | `pkg/embed` | 384维int8量化嵌入 |
| 网格 | `pkg/mesh` | 模式槽的语义搜索 |
| 编排器 | `pkg/orchestrator` | 统一管道：直接 → 丰富 → 推理 |
| 二进制运行时 | `pkg/do` | 执行引擎（28个操作码，C支持I/O） |
| 搜索 | `pkg/hunt` | 使用超级不变量的自动漏洞发现 |
| RAG | `pkg/rag` | 5信号混合搜索（语义、AST、关键词、markdown、注释） |
| 项目地图 | `pkg/projectmap` | SQLite O(1)符号/包查找 |
## 快速入门
### 构建
```bash
cd embryo
# 主二进制文件（CGO_ENABLED=0用于静态构建）
CGO_ENABLED=0 go build -ldflags="-s -w" -o bin_gg ./cmd/binarymesh
# MCP服务器
CGO_ENABLED=0 go build -ldflags="-s -w" -o binary-mesh-mcp ./cmd/mcp
```
### 运行服务器
```bash
# 设置所需的环境变量
export INFERENCE_KEY="sk-..."
export INFERENCE_URL="https://proxy.gonka.gg/v1/chat/completions"
export INFERENCE_MODEL="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8"
export EMBEDDER_URL="http://localhost:1227"
# 启动服务器
./bin_gg gg --addr=:1337 --data-dir=/data
```
### MCP集成
```bash
# MCP二进制文件位置
/home/user/bin/binary-mesh-mcp
# OpenCode配置（embryo/.opencode.json）：
{
"mcp": {
"binary-mesh": {
"type": "local",
"command": "/home/user/bin/binary-mesh-mcp",
"enabled": true
}
}
}
```
## 关键命令
```bash
# 网格操作
./bin_gg query --task "fix concurrent map write"
./bin_gg stats
# 搜索漏洞
./bin_gg hunt --protocol gonka --gap memory_safety --depth 50
# 解决任务（端到端）
./bin_gg solve --task "description here" --workspace /path/to/repo
# 提炼模式
./bin_gg distill --invariant "concurrent access requires mutex" --domain go
# 吸收仓库
./bin_gg ingest --repo /root/binary-mesh-data/repos/gonka.git
./bin_gg ingest-all
```
## MCP工具（57种可用）
### 核心操作
- `binary-mesh_solve` — 全管道：网格查询 → 直接命中或推理 → 补丁
- `binary-mesh_hunt` — 使用超级不变量的漏洞搜索器（~3000个令牌）
- `binary-mesh_dual_solve` — 2种方法 + AI审查 + 有效性比较
### 网格操作
- `binary-mesh_mesh_query` — 语义搜索（sim ≥ 0.85 = 直接命中）
- `binary-mesh_mesh_enrich` — 用网格模式丰富任务
- `binary-mesh_mesh_distill` — 将解决方案提炼成网格
- `binary-mesh_mesh_add_slot` — 手动添加模式槽
### RAG和项目地图
- `binary-mesh_rag_search` — 5信号混合搜索（语义、AST、关键词、markdown、注释）
- `binary-mesh_project_map_lookup` — O(1)符号/包查找
- `binary-mesh_project_map_flow` — 调用图分析
### 分析和质量
- `binary-mesh_code_quality_audit` — 全包分析（未使用的导出、违规行为）
- `binary-mesh_full_file_analysis` — 文件 + 索引上下文
- `binary-mesh_project_inference` — 代码分类：应用程序 vs 框架 vs 供应商
### Git和部署
- `binary-mesh_git_status` / `_add` / `_commit` / `_push`
- `binary-mesh_deploy_status` / `_pull` / `_restart` / `_cycle`
### 监控
- `binary-mesh_health` — 快速健康检查
- `binary-mesh_observer_stats` — 搜索统计
- `binary-mesh_quality` — 质量矩阵L0-L9分数
- `binary-mesh_buckets` — 按协议/间隙查找结果
- `binary-mesh_survival` — Git blame生存分析
## 端口分配（X_X7模式）
| 端口 | 服务 | 描述 |
|------|---------|-------------|
| 1227 | 嵌入器 | 矢量嵌入服务 |
| 1337 | GG API | 普通HTTP API（59个路由，保留） |
| 1447 | 集群 | bin_gg集群/服务 |
| 2022 | SSH | 服务器访问（root@10.0.0.10） |
| | UI | Docker服务Web UI |
| 2022 | SSH | 服务器访问（root@10.0.0.10） |
## 运行时环境
关键环境变量（通过`embryo/install.sh`强制执行）：
```bash
NATIVE_TOOL_CALLS=false
SIMULATE_TOOL_CALLS=true
HASH_ALL_ACTION_BYTES=true
BYTE_INTEGRITY_CHECK=sha256
TOOL_CALL_PARSER=simulate
```
## CI/CD
- **分支**: `embryo`（开发），`git_dumb`（部署）
- **GitHub Actions**: Go 1.24，setup-go@v5
- **部署流程**: 推送到`git_dumb` → SSH到服务器 → docker cp → 重启
## 测试命令
```bash
cd embryo
# 单元测试（仅pkg/dumb和pkg/do）
go test ./pkg/dumb/... ./pkg/do/... -v -timeout 120s
# 注意：pkg/do需要CGO与libcore一起使用以获得完整功能
# pkg/dumb测试通过（10/10测试）
```
## 提炼源
在`embryo/repos.json`中配置：
- gonka（gonka-ai/gonka）
- kubernetes（kubernetes/kubernetes）
- moby（moby/moby）
- golang（golang/go）
- vllm（vllm-project/vllm）
- consul（hashicorp/consul）
- etcd（etcd-io/etcd）
- containerd（containerd/containerd）
- prometheus（prometheus/prometheus）
- traefik（traefik/traefik）
- opentelemetry-go（open-telemetry/opentelemetry-go）
- ethereum（ethereum/go-ethereum）
## 关键架构事实
- **入口点**: `embryo/cmd/binarymesh` → `bin_gg`（21MB静态二进制文件）
- **MCP服务器**: `embryo/cmd/mcp` → `binary-mesh-mcp`（8.9MB）
- **数据目录**: `/data`（服务器），`/root/binary-mesh-data/repos`（克隆仓库）
- **Docker镜像**: `golang:1.24-bookworm`构建器 → `debian:bookworm-slim`运行时
- **协议**: Gonka-ai de-ai-dapi（自主主流协议）
## 基于物理的智能
二进制网格实现基本的物理原理：
1. **最小作用原理**: 轨迹最小化S = α·成本 + β·时间 + γ·风险
2. **量子干涉**: 成功模式放大（建设性），失败创建“黑洞”
3. **守恒定律**: 不变性（类型安全、确定性）在转换过程中保持
4. **相变**: 提炼将成功的轨迹结晶成模式槽
5. **贝叶斯推理**: 后验 = sim（查询，中心）× 先验
参见`PHYSICS_ARCHITECTURE_MAPPING.md`获取详细的数学建模。
## 项目状态
当前指标（来自运行系统）：
- **网格**: 36个映射中298,135个槽
- **生存指数**: 69.2%（顶部提交：29K幸存行）
- **质量**: 综合4738（L0=8000稳定性，L6=2300可重用性，L9=7072完成度）
- **RAG**: 180,684个Qdrant点（38K AST，117K关键词，6K markdown，5K注释）
- **搜索**: gonka + go-ethereum协议中700个被拒绝的发现
## 参考
- `AGENTS.md` — OpenCode会话的紧凑指南
- `PHYSICS_ARCHITECTURE_MAPPING.md` — 基于物理的架构（541行）
- `GAP_NANOOPS_MANIFEST.md` — 间隙策略（73690字节）
- `INIT.DOC` — 二进制格式文档
- `embryo/install.sh` — 运行时强制执行脚本
- `embryo/docs/` — 附加文档（架构、CLI、GONKAGATE API）
