synapseed

# SYNAPSEED **一款实用的代码智能工具，帮助 AI 助手理解您的代码库。** [](https://github.com/fabriziosalmi/synapseed/actions) [](https://codecov.io/gh/fabriziosalmi/synapseed) [](https://opensource.org/licenses/Apache-2.0) [](https://www.rust-lang.org/) [](https://modelcontextprotocol.io/) --- ## 今日它能做什么？ SYNAPSEED 是一款**代码分析工具**，为 AI 助手（如 Claude）提供对代码库的深入理解： - 🔍 **立即查找符号** - 在整个项目中搜索函数、结构体或变量 - 🛡️ **捕获泄露前的安全问题** - 实时扫描 API 密钥、密码和敏感数据 - 📊 **了解代码演变** - 通过 git 历史分析查看谁更改了什么、何时以及为什么 - 🏗️ **衡量代码健康状况** - 获取架构质量分数并识别耦合问题 - 🐛 **实时错误检测** - 背景编译并提供即时诊断 把它想象成给你的 AI 助手提供代码的 X 光视野。 AI 不仅仅看到文本文件，还能理解结构、关系和历史。 ### 现实世界的例子 **示例 1：查找身份验证代码** ```bash $ synapseed search "authentication logic" ✓ Found in src/auth/verify.rs:45 - verify_user_credentials() ✓ Found in src/middleware/auth.rs:12 - AuthenticationMiddleware ✓ Found in tests/auth_test.rs:67 - test_invalid_credentials() ``` **示例 2：检测秘密** ```bash $ synapseed scan --text "AWS_KEY=AKIAIOSFODNN7EXAMPLE" ⚠ ALERT: AWS 访问密钥在位置 8 处被检测到 ✓ 已净化：AWS_KEY=[REDACTED] ``` **示例 3：了解代码更改** ```bash $ synapseed ask "为什么登录失败？" 🔍 分析代码库... ✓ 过去 48 小时内发现 3 处最近的更改 ✓ 提交 abc123: "fix: 处理空密码情况" ✓ 可能的原因：verify_credentials() 中的新验证可能拒绝边缘情况 ``` ### 主要功能 | 它能做什么 | 它如何帮助 | | :--- | :--- | | **解析代码结构** | AI 看到函数和关系，而不仅仅是文本 | | **语义搜索** | 查找诸如“错误处理”之类的概念，即使代码中没有明确说明 | | **秘密检测** | 在 AI 交互中防止泄露 API 密钥和密码 | | **git 分析** | 了解谁更改了什么以及为什么 | | **实时诊断** | 在手动运行 cargo 之前捕获编译错误 | | **架构评分** | 获取代码组织的健康分数（A-F） | | **零网络调用** | 所有操作都在本地机器上运行 | --- ## 快速入门（30 秒） **安装：** ```bash git clone https://github.com/fabriziosalmi/synapseed.git cd synapseed cargo install --path bin/synapseed --force ``` **试用：** ```bash # 搜索代码库 synapseed search "error handling" --project /path/to/your/project # 检查秘密 echo "password=secret123" | synapseed scan # 获取项目概览 synapseed ask "what does this project do?" --project . ``` **与 Claude 配合使用：** 将以下内容添加到您的 Claude Desktop 配置文件中，然后重启 Claude： ```json { "mcpServers": { "synapseed": { "command": "synapseed", "args": ["serve", "--project", "/path/to/your/project"] } } } ``` 然后询问 Claude： *"这个代码库中有哪些函数？"* - 它现在可以查看您的实际代码结构！ 📖 **SYNAPSEED 新手？** 尝试 [5 分钟快速入门指南](FIRST_5_MINUTES.md)，进行动手操作。 **先决条件：** Rust 1.75+，Git。 --- ## 集成 ### Claude Desktop 将以下内容添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）： ```json { "mcpServers": { "synapseed": { "command": "synapseed", "args": ["serve", "--project", "/path/to/your/project"], "env": { "RUST_LOG": "warn" } } } } ``` ### Claude 代码 将以下内容添加到 `~/.claude/settings.json` 或项目根目录下的 `.mcp.json`： ```json { "mcpServers": { "synapseed": { "command": "synapseed", "args": ["serve", "--project", "."], "env": { "RUST_LOG": "warn" } } } } ``` ### VS Code / Cursor / Copilot 将以下内容添加到 `.vscode/mcp.json`： ```json { "servers": { "synapseed": { "command": "synapseed", "args": ["serve", "--project", "${workspaceFolder}"], "env": { "RUST_LOG": "warn" } } } } ``` 查看 [完整集成指南](docs/integration/) 以获取系统提示模板和高级配置。 ### VS Code 扩展 安装 SYNAPSEED 扩展，以在 VS Code 侧边栏中直接获取实时指标、诊断和架构健康状况。 ```bash cd vscode-extension npm install && npm run package code --install-extension synapseed-0.4.0.vsix ``` 功能：5 个侧边栏面板（概览、诊断、代码质量、安全、Git）、仪表盘 Web 视图、基准测试结果查看器、询问面板、自动刷新、状态栏集成、带有 churn 风险的代码镜头、文件装饰和不稳定性徽章。所有 Web 视图都使用 CSP 随机数安全、结构化日志记录和专用输出通道。有关详细信息，请参见 [扩展 README](vscode-extension/README.md)。 --- ## 它是如何工作的（简单版） ``` ┌─────────────────────────────────────────────┐ │ 您的 AI 助手（Claude 等） │ └────────────────┬────────────────────────────┘ │ 提出问题 ▼ ┌─────────────────────────────────────────────┐ │ SYNAPSEED（在您的机器上运行） │ │ ┌─────────────────────────────────────┐ │ │ │ 1. 解析您的代码结构 │ │ │ │ 2. 搜索相关部分 │ │ │ │ 3. 扫描安全问题 │ │ │ │ 4. 分析 git 历史 │ │ │ │ 5. 返回智能答案 │ │ │ └─────────────────────────────────────┘ │ └────────────────┬────────────────────────────┘ │ 读取 ▼ ┌─────────────────────────────────────────────┐ │ 您的代码库（保留在磁盘上） │ └─────────────────────────────────────────────┘ ``` **技术架构**（适用于想要了解细节的开发者）： SYNAPSEED 由 16 个专用模块构建，每个模块处理代码智能的一个方面： ``` ┌──────────────────────────────────────────────────────────────────────┐ │ MCP JSON-RPC（stdio） │ ├──────────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────┐ ┌──────┐ ┌──────┐ ┌─────────┐ ┌───────┐ ┌─────┐ │ │ │ Cortex │ │ Husk │ │ Root │ │ Chronos │ │Search │ │ Gym │ │ │ │ （AST） │ │（DLP）│ │（Cmd）│ │ （Git） │ │（FTS） │ │（RL） │ │ │ └────┬────┘ └──┬───┘ └──┬───┘ └────┬────┘ └───┬───┘ └──┬──┘ │ │ │ │ │ │ │ │ │ │ ┌────┴──────────┴─────────┴────────────┴───────────┴──────────┴──┐ │ │ │ SynapseContext（事件总线 + 会话） │ │ │ └────┬──────────┬─────────┬────────────┬──────────┬──────────┬───┘ │ │ │ │ │ │ │ │ │ │ ┌────┴────┐ ┌──┴───┐ ┌──┴──┐ ┌───┴────┐ ┌─┴───┐ │ │ │ Shadow │ │Whis- │ │Tele-│ │Janitor │ │Arch-│ │ │ │（编译）│ │ per │ │metry│ │（维护）│ │itect│ │ │ └─────────┘ └──────┘ └─────┘ └────────┘ └─────┘ │ │ │ └──────────────────────────────────────────────────────────────────────┘ 16 个 crate · 插件架构 · 基于优先级初始化 · HCI 调整 ``` ```mermaid graph LR LLM["LLM / AI 代理"] MCP["MCP 服务器<br/>(JSON-RPC stdio)"] LLM <-->|"工具 · 资源 · 提示"| MCP subgraph 插件 Cortex["Cortex<br/>AST + CodeGraph"] Husk["Husk<br/>DLP Shield"] Root["Root<br/>Sentinel"] Chronos["Chronos<br/>Git History"] Search["Search<br/>Tantivy FTS"] Whisper["Whisper<br/>Intent Router"] end MCP --> Cortex & Husk & Root & Chronos & Search & Whisper Cortex -->|"tree-sitter"| FS["文件系统"] Chronos -->|"git2"| Git["Git 仓库"] Root -->|"policy eval"| Shell["Shell 命令"] ``` | Crate | 角色 | | :--- | :--- | | `synapseed-core` | 事件总线、插件特征、上下文、会话持久性、HCI 配置 | | `synapseed-cortex` | Tree-sitter AST（Rust/Python/JS + 27 个备用），后台索引 | | `synapseed-husk` | DLP Shield — Aho-Corasick + 正则表达式秘密检测 + 熵门控编码 | | `synapseed-root` | 命令 Sentinel — 基于策略的命令评估 | | `synapseed-chronos` | Git 历史记录，语义提交标签，意图分析，AI 属性跟踪 | | `synapseed-search` | Tantivy FTS + 前缀匹配 + 向量嵌入（fastembed，余弦） | | `synapseed-shadow-check` | 背景 `cargo check`，严重性过滤和自适应延迟 | | `synapseed-whisper` | 意图路由器 — 多意图分类，并行收集，分数感知上下文 | | `synapseed-telemetry-sink` | OTLP gRPC 接收器，端口 4317，SpanStore，热图 | | `synapseed-gym` | RL 沙盒 — 安全代码评估，编译 + 测试反馈 | | `synapseed-janitor` | 自主维护 — clippy + 未使用的依赖，验证提案 | | `synapseed-architect` | 依赖图，耦合指标，循环检测，评分（A-F） | | `synapseed-decompiler` | 神经反编译器 — ELF/Mach-O/PE 二进制分析，符号提取，行为推理 | | `synapseed-bench` | 基准测试引擎 — 可重复的 SCR 评估，带有 JSONL 问题套件 | | `synapseed-mcp` | MCP 协议处理程序 — 25 个工具，13 个资源，6 个提示 | --- ## 证明它有效：基准和比较 ### 真实性能数据 SYNAPSEED 包含一个全面的基准测试套件，用于衡量其影响力。以下是数据显示的内容： **编码任务准确性（使用多个模型测试）：** - **无 SYNAPSEED（盲）：** 40-60% 正确的答案 - **使用 SYNAPSEED：** 75-90% 正确的答案 - **改进：** ~50% 提高准确率（见 [benchmark/](benchmark/) 获取详细结果） **搜索质量指标：** - **平均倒数排名（MRR）：** 0.85（行业基准：0.70） - **Precision@5：** 0.92（在前 5 个结果中找到相关结果） - **查询响应时间：** 大多数搜索 < 10ms **安全扫描：** - **检测率：** 99.8% 已知秘密模式（AWS 密钥、API 令牌等） - **误报率：** < 0.1% 白名单调整 - **扫描速度：** ~500MB/s 典型硬件 ### 自己运行基准测试 ```bash cd benchmark python3 -m venv venv && source venv/bin/activate pip install -r requirements.txt python run.py coding --quick # 比较盲 vs SYNAPSEED 辅助 python run.py search # 测试搜索质量 ``` 结果保存在 `benchmark/results/` 中为 JSON 以实现可重复性。 ### 比较：SYNAPSEED 与传统方法 | 能力 | 无 SYNAPSEED | 有 SYNAPSEED | |------------|------------------|----------------| | 查找函数 | AI 从文件名猜测 | AI 看到确切的符号位置 | | 了解关系 | AI 读取整个文件 | AI 获取结构化依赖图 | | 检查秘密 | 手动审查或提交后钩子 | 实时扫描 AI 看到的数据 | | 代码演变 | AI 读取 git 日志为文本 | AI 获取语义更改分析 | | 架构质量 | 主观评估 | 客观 A-F 分级和指标 | --- ### 模型层 — 上下文预算 SYNAPSEED 适应上下文注入到下游模型的能力。所有预算都源自单个 `token_budget()` 参数： | 层级 | 模型大小 | Token 预算 | 策略 | 最大目标 | 最大集群 | | :--- | :--- | :--- | :--- | :--- | :--- | | **原子** | < 1B | 2K | Chirurgica — 仅限确切符号 | 2 | 1 | | **分子** | 1B–4B | 8K | Relazionale — 2-3 个文件链接 | 5 | 2 | | **银河系** | 4B–14B | 16K | Architetturale — 完整模块 | 10 | 3 | | **通用** | >14B / 云 | 32K+ | Olistica — 大规模合成 | 15 | 5 | **80% 规则** 保留 20% 为系统提示和用户查询。 通过 `hci.model_profile` 在 `dna.yaml` 或自动检测自 MCP 客户端名称进行配置。 ### MCP 工具（25 个） | 工具 | 层级 | CLI 别名 | 描述 | | :--- | :--- | :--- | :--- | | `ask` | 主要 | `ask_synapseed`, `whisper` | 基于意图的编排 — 从这里开始提问 | | `hoist` | 低级别 | `get_code_skeleton` | 解析项目 AST 并返回符号图 | | `lookup` | 低级别 | `lookup_symbol` | 按名称查找函数/结构体/特征 | | `search` | 低级别 | `semantic_search` | 通过 Tantivy 进行基于概念的代码搜索 | | `scan` | 低级别 | `scan_security` | DLP 扫描，检测秘密（API 密钥，密码，私钥） | | `check` | 低级别 | `check_command` | 根据安全策略评估 shell 命令 | | `blame` | 低级别 | `git_history` | 语义 git blame 和文件历史 | | `analyze` | 低级别 | `analyze_history` | 变更分析，风险评分，变更模式 | | `intent` | 低级别 | `git_intent_summary` | 按类别总结最近的提交意图 | | `diagnostics` | 低级别 | `get_diagnostics` | 实时编译器错误和警告 | | `quickfix` | 低级别 | `apply_quick_fix` | 自动应用编译器建议的修复 | | `consult` | 低级别 | `consult_architect` | 项目 DNA 配置的架构指导 | | `diagnose` | 低级别 | `project_diagnose` | 跨所有子系统的完整系统诊断 | | `reset-telemetry` | 低级别 | `reset_telemetry` | 清空遥测范围存储和指标 | | `train` | 专业化 | `train_code` | 在隔离的沙盒（The Gym）中评估 Rust 代码 | | `janitor` | 专业化 | `janitor_run_now` | 扫描 clippy 警告和未使用的依赖项 | | `janitor-fix` | 专业化 | `janitor_apply_fix` | 应用 Janitor 修复（默认情况下进行干预预览） | | `approve-fix` | 专业化 | `approve_fix` | 应用 RepairOrchestrator 自动修复提案（默认情况下进行干预预览） | | `architect` | 专业化 | `architect_analyze` | 结构健康分析（分数，周期，耦合） | | `oracle` | 专业化 | `oracle_fix_docs` | 自动修复漂移的文档（版本，计数） | | `similar` | 专业化 | `semantic_similarity` | 向量嵌入相似性搜索 | | `verify_path` | 低级别 | `verify_path` | 验证文件路径存在（防止 LLM 幻觉） | | `analyze_binary` | 专业化 | `neural_decompiler` | 分析 ELF/Mach-O/PE 二进制文件（符号，字符串，调用图） | | `explain_dependency` | 专业化 | — | 通过二进制分析解释已编译的 Rust 依赖项 | | `run_benchmark` | 专业化 | `benchmark` | 运行可复制的 SCR 评估套件（F1，SID，幻觉率） | ## MCP 资源（13） | URI | 描述 | | :--- | :--- | | `synapseed://status` | 项目状态（状态，指标，插件） | | `synapseed://dna` | 项目 DNA 配置 | | `synapseed://security/policy` | 活动安全策略规则 | | `synapseed://diagnostics/active` | 当前编译器诊断信息 | | `synapseed://pipeline/metrics` | 管道指标（摄取吞吐量，富集统计） | | `synapseed://telemetry/hotspots` | 来自 OTLP 跨度的前 10 个性能热点 | | `synapseed://janitor/proposals` | Janitor 修复提案 | | `synapseed://architect/health` | 架构健康分数和违规行为 | | `synapseed://consistency` | 一致性 Oracle 报告（漂移检测） | | `synapseed://session/recorder` | Flight Recorder — 会话内存，带有工作集和旅程图 | | `synapseed://session/context` | 认知账本 — 确定性操作时刻分类和会话脉搏 | | `synapseed://context/active` | 动态项目简介（预加载以实现即时情境感知） | | `synapseed://pulse` | 脉冲活动计数器 — 指数衰减工作集（文件和符号） | ## MCP 提示（5） - **`describe_architecture`** — 使用语义理解分析并描述项目架构 - **`fix_build_errors`** — 使用 shadow 编译器诊断和修复当前的构建错误 - **`explain_evolution`** — 通过 git 历史记录，跟踪代码演变，变更分析和共同变更模式 - **`security_audit`** — 跨 DLP，命令和 git 历史记录的综合安全审计 - **`optimize_hotspots`** — 从 OTLP 遥测数据分析运行时性能热点 --- ## CLI 命令 每个 MCP 工具都作为 CLI 命令提供。旧的 MCP 名称（例如 `ask_synapseed`，`get_code_skeleton`）被接受为可见的别名。未识别的输入被视为 `ask` 查询。 ```bash # ── 快速询问（默认回退） ── synapseed "为什么登录失败了？” # `ask` 查询的简写 # ── 服务器和系统 ── synapseed serve --project . # 启动 MCP 服务器（stdio） synapseed init --project . # 初始化所有插件并广播事件 synapseed status --project . # 运行时指标和系统状态 synapseed diagnose --project . # 完整的系统诊断 # ── 代码分析 ── synapseed hoist # 索引项目并打印 AST 骨架 synapseed hoist src/ # 索引特定子目录 synapseed lookup <name> --project . # 按名称查找符号 synapseed search "auth login" -l 10 # 通过 Tantivy 进行语义搜索 synapseed similar "error handling" # 向量嵌入相似性搜索 synapseed ask "为什么登录失败？” # 调用 SYNAPSEED（编排所有功能） ``` # ── 安全 ── synapseed scan -c "secret=..." # DLP扫描敏感数据 synapseed scan --content "..." -m dlp # 仅DLP扫描模式 echo "data" | synapseed scan # 从标准输入扫描 synapseed check "cargo test" # 根据安全策略评估命令 # ── Git ── synapseed history --limit 20 # 带有语义提交标签的Git历史记录 synapseed blame <file> -s 1 -e 30 # 文件行范围的Git blame synapseed analyze <file> # 变更分析、热点、风险评分 synapseed intent --limit 10 # 语义提交意图摘要 # ── 编译器与维护 ── synapseed diagnostics # 实时编译器错误和警告 synapseed quickfix <file> <code> # 自动应用编译器建议的修复 synapseed janitor # 扫描clippy警告 + 未使用的依赖项 synapseed janitor-fix <id> --confirm # 应用 janitor 修复提案 # ── 架构 ── synapseed architect --refresh # 结构健康分析（A-F评分） synapseed consult "which runtime?" # 咨询架构策略（DNA） synapseed oracle # 自动修复漂移的文档 # ── 沙盒 ── synapseed train src.rs --adversarial # 在Gym沙盒中评估Rust代码 synapseed reset-telemetry # 清除OTLP遥测数据 --- ## 自身遥测（Dogfooding） SYNAPSEED可以通过向其自身的OTLP接收器发送跟踪跨度来观察其自身的性能： ```bash SYNAPSEED_SELF_TELEMETRY=1 synapseed serve --project . ``` 这启用了一个反馈循环：SYNAPSEED操作通过`BatchSpanProcessor`发出跨度到`localhost:4317`，遥测接收器将它们摄入SpanStore。查询`synapseed://telemetry/hotspots`资源以识别性能瓶颈。 --- ## 配置 在项目根目录中创建`.synapseed/dna.yaml`（或用户级别的默认`~/.config/synapseed/dna.yaml`）： ```yaml workspace_strategy: monorepo naming: core_crate: core bin_name: my-app preferred_libs: async: tokio json: serde_json error: thiserror http: axum plugins: - cortex - husk - root - chronos - search - shadow - whisper - telemetry dlp_level: standard # off | low | standard | strict | paranoid hci: background_indexing: true # 非阻塞启动（Cortex在后台索引） adaptive_linting: true # Shadow-check debounce在快速编辑期间升级 mentor_mode: true # 响应深度适应查询复杂度 session_persistence: true # 在MCP重启期间恢复上下文 memory_ceiling_files: 10000 # 限制索引文件以限制内存使用 ``` 所有字段都是可选的 - 省略的字段使用合理的默认值。项目级配置覆盖用户级配置。有关完整的注释示例，请参见[`examples/dna.yaml`](examples/dna.yaml)。 ### 搜索索引 默认情况下，Tantivy搜索索引**在内存**（仅RAM）中运行以实现即时启动。对于大型代码库，请启用磁盘持久性以避免每次MCP服务器重启时重新索引： ```yaml # .synapseed/dna.yaml search: persistence: true # 将索引持久化到.synapseed/index/ ``` ### 环境变量 | 变量 | 默认值 | 描述 | | :--- | :--- | :--- | | `RUST_LOG` | `info` | 日志级别过滤器 | | `SYNAPSEED_LOG_FORMAT` | `compact` | 日志格式（`compact`或`json`） | | `SYNAPSEED_SELF_TELEMETRY` | `0` | 启用自我检测（启用为`1`） | --- ## 安全 SYNAPSEED强制执行**纵深防御，失败关闭**的安全模型： 1. **DLP Shield（Husk）** - Aho-Corasick + 正则表达式扫描阻止API密钥、密码、私钥和PII到达LLM 2. **命令哨兵（Root）** - 拒绝优先策略，带有shell链接防御（拆分`;`、`|`、`&&`、`||`、换行符）、空字节拒绝和命令替换、base64伪装和解释器内联执行的拒绝规则 3. **网络隔离** - 所有服务器仅绑定到`127.0.0.1`，无出站调用 4. **进程边界** - 无任意子进程生成，读取AST分析 ### 自定义安全规则 在`.synapseed/dna.yaml`中添加自定义DLP规则： ```yaml dlp_level: strict dlp_custom_rules: - name: internal_api_key pattern: "INTERNAL-[A-Z0-9]{16}" action: redact - name: corporate_email pattern: "\\b[\\w.]+@corp\\.example\\.com\\b" action: audit ``` 规则操作：`redact`（替换为`[REDACTED]`）、`deny`（完全阻止）、`audit`（仅记录）、`allow`（跳过）。 ### DLP白名单 使用`.synapseed/dna.yaml`中的正则表达式模式抑制假阳性DLP发现： ```yaml dlp_whitelist: - "(?i)token\\s*[:=]\\s*[A-Z]\\w+" # CancellationToken等 - "(?i)shutdown_token" # Rust异步关闭模式 ``` 内置默认值已经抑制了Rust代码库中常见的`CancellationToken`和`shutdown_token`模式。 Sentinel使用**拒绝优先**模型和shell链接防御：命令按shell运算符（`;`、`|`、`&&`、`||`）拆分，每个段独立评估。默认拒绝列表包括`rm -rf`、`curl | sh`、`chmod 777/0777/a+rwx`、`mkfs`、`$()`、反引号、`base64 -d`、解释器`-c`/`-e`、`nohup`和`LD_PRELOAD`。 --- ## 文档 完整文档位于[docs/](docs/)目录中，使用VitePress构建： ```bash cd docs npm install npm run dev # 打开 http://localhost:5173 ``` ### 快速访问指南 - 🚀 **[前5分钟指南](FIRST_5_MINUTES.md)** - 立即使用动手示例启动 - 🏗️ **[架构解释](ARCHITECTURE_EXPLAINED.md)** - SYNAPSEED工作原理的简单解释 - 🎯 **[良好初始问题](GOOD_FIRST_ISSUES.md)** - 适合初学者的贡献想法 - 📖 **[贡献指南](CONTRIBUTING.md)** - 代码标准和开发工作流 ### 完整文档 章节：[指南](docs/guide/) · [架构](docs/architecture/) · [功能](docs/features/) · [MCP参考](docs/reference/) · [集成](docs/integration/) · [安全](docs/security/) --- ## 贡献 我们欢迎贡献！无论您是修复错别字还是添加功能，每一份贡献都很重要。 👋 **新贡献者：** 从[GOOD_FIRST_ISSUES.md](GOOD_FIRST_ISSUES.md)开始，获取适合初学者的任务。 📋 **标准工作流程：** 1. 复刻仓库 2. 创建功能分支（`git checkout -b feature/amazing-feature`） 3. 进行更改并测试它们（`cargo test`） 4. 提交清晰的信息（`git commit -m 'feat: add amazing feature'`） 5. 推送到分支（`git push origin feature/amazing-feature`） 6. 打开拉取请求 📖 **详细指南：** 查看[CONTRIBUTING.md](CONTRIBUTING.md)，了解代码标准和开发工作流程。 --- ## 许可证 在Apache License 2.0下分发。有关更多信息，请参见`LICENSE`。 --- **由Rust构建 [Fabrizio Salmi](https://github.com/fabriziosalmi)**