AI导哈

Claude生态系统插件

一个全面的Claude Code插件，提供自主任务管理、持久化内存、语义搜索、深度推理和76项专业技能，通过钩子、MCP服务器和CLI工具集成。

  • by brdigetrlol
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 brdigetrlol/claude-ecosystem

使用说明

克劳德生态系统

一个全面的Claude Code插件，提供自主任务管理、持久内存、语义搜索、深度推理和76种专业技能，所有这些都通过钩子、MCP服务器和CLI工具集成在一起。

包含什么

组件 描述
ENGRAM+分类账 持久内存系统+带状态机工作流的任务跟踪器
合作皮层 通过语义嵌入实现自动任务创建、状态转换和轮班检测
甲骨文 具有蕴涵传播的混合语义搜索引擎（BM25+向量+蕴涵图）
占察 具有45多种工具的认知推理引擎——审议、调查、网络搜索、假设检验
单纯形 任务感知代码库上下文选择和导航
cRouter 具有级联故障转移的多模型LLM路由器（GLM/Gemini/Claude）
神盾 隐私保护盾——PII/PHI假名化、本地模型查询、加密映射存储
GPU加速器 CUDA加速向量/矩阵计算
MCP锻造 热可重新加载的MCP服务器基础架构（hotshell+守护进程）
76技能 Rust、C++、MCP、调试、测试、架构、工作流等
13个钩子脚本 会话生命周期自动化——任务跟踪、上下文注入、压缩恢复

系统要求

要求 最低要求 注意事项
操作系统 Linux（x86_64）、macOS（ARM/x86） 也支持WSL2
锈 1.75+ 通过安装 生锈
jq 任何 apt install jq （Linux）或 brew install jq （macOS）
磁盘 约2 GB 约1 GB构建工件+约500 MB嵌入模型+数据
随机存取存储器 Oracle索引建议使用4 GB+ 8 GB
CUDA 可选（仅限Linux） 在Oracle和GPU加速器中启用GPU加速嵌入
奥拉玛 可选 在Aegis+本地模型查询中启用基于NER的PII检测

快速开始

安装

git clone https://github.com/brdigetrlol/claude-ecosystem.git
cd claude-ecosystem
./install.sh

这将构建所有Rust二进制文件（第一次大约10-15分钟），创建数据目录，并下载嵌入模型。

用作插件

claude --plugin-dir /path/to/claude-ecosystem

更新

cd /path/to/claude-ecosystem
./update.sh

提取最新更改，显示更改的内容，并重建修改后的二进制文件。

仓库结构

claude-ecosystem/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest
├── .mcp.json                # MCP server definitions (7 servers)
├── hooks/
│   └── hooks.json           # Hook event registrations
├── skills/                  # 76 skill definitions (SKILL.md format)
│   ├── rust-expert/
│   ├── deep-solve/
│   ├── mcp-builder/
│   └── ...
├── agents/
│   └── file-researcher.md   # Subagent definitions
├── scripts/
│   └── hooks/               # 13 hook scripts
│       ├── SessionStart.sh
│       ├── UserPromptSubmit.sh
│       ├── PreToolUse.sh
│       ├── PostToolUse.sh
│       ├── cortex-prompt.sh
│       ├── cortex-pretool.sh
│       ├── cortex-posttool.sh
│       ├── cortex-stop.sh
│       ├── PreCompact.sh
│       └── ...
├── bin/                     # Shell wrappers + built binaries
│   ├── ledger               # Task management CLI
│   ├── engram               # Memory/knowledge CLI
│   ├── cortex               # Auto-task management CLI
│   └── ensure-coordinator   # Daemon health checker
├── src/                     # Rust source code (8 projects)
│   ├── engram-nexus/        # ENGRAM + LEDGER + Cortex
│   ├── oracle/              # Semantic search engine
│   ├── scry/                # Reasoning engine
│   ├── simplex/             # Context selection
│   ├── crouter/             # Multi-model LLM router
│   ├── mcp-forge/           # MCP infrastructure
│   ├── aegis/               # Privacy shield
│   └── gpu-accelerator/     # CUDA compute
├── config/
│   ├── CLAUDE.md            # Project instructions (portable)
│   └── permissions.json     # Recommended permissions
├── docs/                    # Design docs, research, analysis
├── install.sh               # First-time setup
├── build.sh                 # Build all Rust binaries
└── update.sh                # Pull + rebuild

MCP服务器

所有服务器都通过路由 mcp-hotshell 用于统一的生命周期管理。定义于 .mcp.json 便携式 ${CLAUDE_PLUGIN_ROOT} 路径。

服务器 模式 工具 目的
甲骨文 独立 15+ 语义搜索、蕴涵图、知识获取
占察 独立 45+ 认知推理、假设检验、网络研究
单纯形 独立 8 任务感知代码上下文选择、代码库导航
cRouter 守护进程 6+ 带断路器的多模型路由（GLM、Gemini、Claude）
神盾 守护进程 10+ PII/PHI假名化、本地模型查询、内存
GPU加速 独立 5 CUDA向量/矩阵运算，批处理执行
MCP示例 守护进程 3 参考实现（echo、add、status）

钉钩系统

该插件为6个生命周期事件注册挂钩：

事件 钩子 他们做什么
会话开始 1 初始化ENGRAM工作区，注入上下文
用户提示： 2 从提示符+Cortex跟踪自动创建LEDGER任务
预工具使用 2 记录工具使用情况，自动转换状态，检测工作班次
PostTool使用 2 检测测试通过/失败，捕获工具输出
停止 2 完成任务，同步到LEDGER，自动完成
准紧的 1 压缩前保存上下文以进行恢复

技能（76）

技能被调用为 /claude-ecosystem:<skill-name> 插件安装后。

锈 (20+): rust-expert, rust-async-concurrency, rust-cargo-ecosystem, rust-cli, rust-collections, rust-database, rust-design-patterns, rust-error-handling, rust-iterators, rust-macros, rust-memory, rust-networking, rust-performance, rust-serde, rust-testing, rust-traits-generics, rust-unsafe-ffi, rust-web, rust-contracts-patterns, rust-verification-layer

C (10): cpp-expert, cpp-build-cmake, cpp-concurrency, cpp-memory, cpp-performance, cpp-safety, cpp-stl, cpp-testing, cpp-version-features, cpp-templates

主控程序 (5): mcp-builder, mcp-doctor, mcp-orchestrator, mcp-pathfixer, mcp-tester

方法论: deep-solve, markovian-reasoning, L3-complex-solve-framework, cognitive-nexus-orchestrator

领域: deadlock-diagnosis, performance, process-debugging, cuda-gpu-acceleration, diffusion-model-optimization, neural-architecture-search, curriculum-learning-expert

工作流程: documentation, git-workflow, testing-standards, version-management, ledger-task-management, engram-labeling, oracle-recovery, session-repair

CLI工具

安装后，以下CLI包装器在中可用 bin/:

# Task management
ledger add "Fix authentication bug" --task-type bug --complexity moderate
ledger show <ID>
ledger list
ledger complete <ID> --verified-build --verified-tests

# Memory / knowledge
engram write -t decision "Use JWT for auth"
engram query "authentication approach"
engram checkpoint save --focus "auth system"

# Automatic task tracking
cortex ensure-task --session <SID> --prompt "..."
cortex current --session <SID>
cortex detect-shift --session <SID> --tool Edit --file src/auth.rs

数据目录

用户数据存储在外部（不在插件中）：

路径 内容
~/.engram/ RocksDB、成绩单、备份、协调器套接字/PID
~/.oracle_index/ 搜索索引（通过重建 oracle_index)
~/.scry/sessions/ 推理会话持久性
~/.cache/huggingface/ 嵌入模型缓存

配置

环境变量

变量 默认值 描述
CLAUDE_PLUGIN_ROOT （自动检测到） 插件根目录。由Claude Code为已安装的插件设置。
ECOSYSTEM_ROOT （无） 在开发中手动覆盖插件根。
RUST_LOG info MCP服务器的日志级别(debug, info, warn, error)
Oracle_GPU_MEM_LIMIT_MB 4096 Oracle嵌入的GPU内存限制
Oracle_SKIP_INDEX true Oracle启动时跳过自动索引
GEMINI_MODE cascade cRouter模式： cascade, claude, gemini, glm, auto

自定义MCP服务器

编辑 .mcp.json 调整服务器配置。所有路径使用 ${CLAUDE_PLUGIN_ROOT} 为了便于携带。要禁用服务器，请从文件中删除其条目。

自定义挂钩

编辑 hooks/hooks.json 启用/禁用特定挂钩。Hook脚本在 scripts/hooks/.

从源头构建

./build.sh

构建所有8个Rust项目并将二进制文件复制到 bin/.单个项目可以单独建造：

cargo build --release --manifest-path src/oracle/Cargo.toml
cargo build --release --manifest-path src/scry/Cargo.toml

故障排除

构建失败

  • “找不到链接器cc”：安装构建必备(apt install build-essential 在Linux上， xcode-select --install 在macOS上）
  • 构建过程中内存不足：构建单个项目，而不是一次性构建所有项目。每 cargo build 在 build.sh 是独立的。
  • CUDA编译错误：CUDA是可选的。移除 gpu-accelerator 从 build.sh 如果你不需要GPU计算。

MCP服务器问题

  • 启动时服务器超时：增加克劳德代码设置中的超时时间。服务器初始化时，首次启动可能需要更长的时间。
  • “找不到工具”错误：验证 bin/mcp-hotshell 存在并且可执行。跑 ./build.sh 如果丢失。
  • Oracle“嵌入失败”：嵌入模型可能无法下载。跑 ./install.sh 再次或手动下载 sentence-transformers/all-MiniLM-L6-v2 到 ~/.cache/huggingface/hub/.

钩子问题

  • 钩子没有开火：检查一下 hooks/hooks.json 条目指向中的现有脚本 scripts/hooks/.
  • “找不到命令：engram”：The bin/ 目录必须在PATH中，或者钩子必须使用通过的绝对路径 ${CLAUDE_PLUGIN_ROOT}/bin/.

数据恢复

  • ENGRAM数据：存储在 ~/.engram/rocksdb/ 具有自动备份功能 ~/.engram/rocksdb-backups/.
  • Oracle索引：重建 oracle_index(path: "/path/to/your/codebase") 通过Oracle MCP工具。

建筑

Claude Code
  ├── Hooks (SessionStart, PreToolUse, PostToolUse, Stop, PreCompact)
  │     └── scripts/hooks/*.sh → bin/{engram,cortex,ledger}
  │           └── engram-coordinator (RocksDB daemon)
  │
  ├── MCP Servers (via mcp-hotshell)
  │     ├── Oracle (semantic search + entailment)
  │     ├── SCRY (cognitive reasoning)
  │     ├── Simplex (context selection)
  │     ├── cRouter (multi-model routing)
  │     ├── Aegis (privacy shield)
  │     └── GPU Accelerator (CUDA compute)
  │
  ├── Skills (76 specialized prompts)
  │
  └── Agents (file-researcher, etc.)

许可证

麻省理工学院——见 许可证 了解详情。

相关 MCP