Phantom Neural Cortex

幻影神经皮层v4.0——幻影代理系统

可部署的AI员工——PNC+NSS+echo_log+Mattermost统一

 ](CHANGELOG.md)

一个统一的人工智能代理系统，将编排（PNC）、安全（NSS）、工具执行（echo_log）和团队沟通（Mattermost）组合到一个可部署的人工智能员工中。

v4.0的新功能——幻影代理系统

v4.0将四个生产系统集成到一个可以计划、执行、通信和控制的代理中：

Core v4.0功能

• 人力资源管理控制器 --云LLM计划（Opus/Codex），本地模型执行（Ollama）
• NSS安全 --每个任务管道中的6层防御（SENTINEL、MARS、VIGIL、SHIELD）
• echo_log积分 --42个工具，RAG内存，通过HTTP进行4阶段推理
• 马特莫斯特大桥 --实时WebSocket通信（Jak-Bot模式）
• 三向Killswitch --终端（Ctrl+K），马特莫斯特(/killswitch)，REST API
• AGENT.yaml配置 --Pydantic使用角色模板验证代理配置
• 前往TUI航站楼 --带有活性剂监测的泡茶Kommandozentrale
• DSGVO+欧盟人工智能法案 --通过NSS合规（PII编辑、隐私预算、审计跟踪）

以前的功能（v3.x）

• 智能群路由（第5阶段） --基于分数的代理选择（IntelligenceEngine）
• 影响预测（干运行） --执行前模拟成本、质量和速度
• 自主反馈循环 --如果未达到质量阈值，则自动重新路由
• 高级CLI和仪表板（第6阶段） --交互式插座。IO CLI
• 持久性多后端内存（第4阶段） -SQL+Redis
• 砂箱硬化（第7阶段） --基于Docker的隔离执行

______________________________________________________________________

建筑

Task -> PhantomAgent.handle_task()
         |
         1. Killswitch Check
         2. NSS SENTINEL (Injection Defense)
         3. NSS MARS (Risk Scoring)
         4. HRM Router (Complexity Assessment)
         |                    |
     HIGH (>= 0.6)       LOW ( Plan Steps        (42 Tools)
     -> Executor
     (Ollama)
         |
     Feedback Loop
     (on failure -> refine plan)
         |
     MM Notification

服务体系结构

PNC Gateway :18789     -- Orchestration + Agent Management + Killswitch
NSS Gateway :11337     -- PII Redaction, STEER
NSS Guardian :11338    -- MARS, SENTINEL, VIGIL, SHIELD
NSS Governance :11339  -- Policy Engine, Privacy Budget, DPIA
echo_log VG :8085      -- 42 Tools, RAG, Reasoning
Ollama :11434          -- Local LLM Inference (GPU)
Mattermost :8065       -- Team Communication

______________________________________________________________________

快速开始

部署代理（5分钟）

# 1. Clone
git clone https://github.com/LEEI1337/phantom-neural-cortex
cd phantom-neural-cortex
pip install -r requirements.txt

# 2. Interactive Setup
./agent-setup.sh
# -> Creates agents//AGENT.yaml

# 3. Start Agent with Gateway
python run_agent.py --config agents/lisa01/AGENT.yaml --gateway
# -> Gateway on :18789, Agent listening on Mattermost

Docker Compose（全栈）

docker compose up -d
# Starts: PNC Gateway, 3x NSS, PostgreSQL, Redis, Prometheus, Grafana

提交任务

curl -X POST http://localhost:18789/agent/lisa01/task \
  -H "Content-Type: application/json" \
  -d '{"task": "Check all docker services and report unhealthy ones"}'

TUI终端（指挥中心）

cd kommandozentrale
go mod tidy && go build -o phantom-tui ./cmd/
./phantom-tui --pnc http://localhost:18789
# Ctrl+K = Killswitch | r = Revive | j/k = Navigate | q = Quit

传统CLI

python cli.py
# /status, /swarm-status, /preview , /context

______________________________________________________________________

关键组件

幻影药剂(agent.py)

统一代理类。从AGENT.yaml加载、启动、处理任务、停止：

agent = PhantomAgent.from_config("config/templates/lisa01.yaml")
await agent.start()     # Connect MM, register killswitch
result = await agent.handle_task("Deploy new monitoring stack")
await agent.stop()

人力资源管理控制器(hrm/)

分层推理模型——按复杂性划分的路线：

Killswitch(killswitch/)

具有SHA-256防篡改审计跟踪的三向紧急停止：

• 终端：TUI中的Ctrl+K
• Mattermost: /killswitch lisa01
• REST API: POST /killswitch/agent/lisa01/kill

特工yaml(config/)

agent:
  name: "lisa01"
  role: "Infrastructure Specialist"
llm:
  planner: "opus-4.6"
  executor: "mistral-small3.2"
  local_only: false
security:
  nss_enabled: true
  approval_level: "RISKY"
  killswitch_owners: ["joe"]

模板： lisa01 （基础设施）， jim01 （DevOps）， john01 （研究）

NSS安全（通过 integrations/nss_client.py)

每一项任务都要经过：

1. SENTINEL——注射检测
2. MARS——风险评分（0-3级）
3. VIGIL——工具安全（每一步之前）

优雅的降级：如果NSS脱机，则默认为SAFE。

______________________________________________________________________

项目结构

phantom-neural-cortex/
├── agent.py                    # PhantomAgent main class
├── run_agent.py                # CLI entry point
├── agent-setup.sh              # Interactive agent setup
├── hrm/                        # HRM Controller
│   ├── router.py               # Complexity assessment
│   ├── planner.py              # Cloud LLM planning
│   └── executor.py             # Ollama execution
├── integrations/               # Service clients
│   ├── nss_client.py           # NSS (3 services)
│   ├── echoLog_client.py       # echo_log VG
│   └── mm_bridge.py            # Mattermost WebSocket
├── killswitch/                 # Emergency stop
│   ├── handler.py              # Kill logic + audit
│   └── api.py                  # REST + MM webhook
├── config/                     # Agent configuration
│   ├── schema.py               # AGENT.yaml schema
│   └── templates/              # Role templates
├── kommandozentrale/           # Go TUI Terminal
│   ├── cmd/main.go
│   └── internal/tui/app.go
├── gateway/                    # PNC Gateway (existing)
├── dashboard/                  # Dashboard (existing)
├── memory/                     # Memory backends (existing)
├── skills/                     # Skills system (existing)
├── docker-compose.yml          # Full stack
└── docs/
    ├── PHANTOM-AGENT-SYSTEM.md # Full technical docs
    └── api/PHANTOM-AGENT-API.md

路线图

• \[x\] 第1-3阶段：基础开放式法律现代化
• \[x\] 阶段4：持久内存（SQL/Redis）
• \[x\] 阶段5：群体路由和影响预测
• \[x\] 第6阶段：CLI和仪表板
• \[x\] 第7阶段：砂箱硬化
• \[x\] 第8阶段：幻影代理系统（PNC+NSS+echo_log+MM）
• \[ \] 第9阶段：幻影链接（加密的代理间通信）
• \[ \] 第10阶段：培训管道集成（将知识烘焙到模型中）

文档

• 幻影代理系统（完整版）
• API 参考
• 系统架构
• 上下文管理
• 砂箱硬化

______________________________________________________________________

版本： 4.0.0 最后更新时间： 2026年3月