开发指南
本指南用于搭建与 GitHub CI 模型一致的本地开发环境。
环境要求
- Rust stable，并安装
rustfmt和clippy - Node.js
24.x - pnpm
>=10.30.0 - Docker 或 Docker Compose，用于测试容器化服务
bash
rustup component add rustfmt clippy
corepack enable克隆与安装
bash
git clone https://github.com/Wisdoverse/Wisdoverse-Nexus.git
cd Wisdoverse-Nexus
pnpm install --frozen-lockfile --ignore-scripts
cargo check --workspace常用命令
Rust workspace
bash
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo check --workspace
cargo test --workspace
cargo run -p nexis-gateway
cargo run -p nexis-cli -- --helpWeb 应用
bash
pnpm --filter @wisdoverse/nexus-web dev
pnpm --filter @wisdoverse/nexus-web buildMobile 应用
Mobile 应用由 Expo 管理。依赖升级时优先对齐当前 Expo SDK，而不是直接追 registry latest。
bash
pnpm --filter @wisdoverse/nexus-mobile exec expo install --check
pnpm --filter @wisdoverse/nexus-mobile typecheck
pnpm --filter @wisdoverse/nexus-mobile testSDK 与文档
bash
pnpm --filter @wisdoverse/nexus-sdk build
pnpm --dir docs docs:build本地 Docker
根目录 docker-compose.yml 用于启动 gateway 和本地持久化数据：
bash
docker compose up -d
docker compose ps
curl http://localhost:8080/healthdeploy/ 下包含开发基础设施：
bash
docker compose -f deploy/docker-compose.yml up -d仓库地图
| 路径 | 说明 |
|---|---|
crates/nexis-protocol | 协议和身份基础类型 |
crates/nexis-gateway | HTTP/WebSocket 网关 |
crates/nexis-ai | AI provider 与 MCP 集成 |
crates/nexis-context | 上下文管理 |
crates/nexis-plugin | 插件运行模型 |
crates/nexis-meeting, nexis-doc, nexis-task, nexis-calendar | 协作域模块 |
apps/web | React + Vite 应用 |
apps/mobile | Expo / React Native 应用 |
sdk/typescript, sdk/python | 客户端 SDK |
docs | VitePress 文档站 |
deploy | Compose、Helm、Prometheus、Grafana 资源 |
常见问题
cc linker not found
安装系统 C 工具链：
bash
# Debian / Ubuntu
sudo apt install build-essential
# macOS
xcode-select --installExpo 依赖不匹配
运行兼容检查，并安装 Expo 推荐版本：
bash
pnpm --filter @wisdoverse/nexus-mobile exec expo install --check8080 端口被占用
停止冲突进程，或在本地 compose 配置中覆盖端口后再启动 gateway。