mssclaw v0.3.0

世界上第一个内置「意义场自检」的开源 Agent 框架

mssclaw (框架平台)
├── mss-ai models     ← 本地模型 (mss-ai-v3.4.3等, 9 models)
├── Agent 引擎         ← L2护城河 + 6流式模式 + 10工具 + RAG
├── Vault 保险箱       ← 密码管理全栈 (AES-256-GCM)
├── Library 库系统     ← 8库643条目统一管理
│   ├── tools(10) + skills(5) + models(30) + kb(618)
│   └── immunity + agents + sessions + custom
├── Multi-Model 编排   ← Shell模式(壳+核) + Pipeline + AutoRoute
└── CLI               ← vault|chat|serve|absorb|library|models|status

🛡️ L2 独有护城河

• 🔥 A3 热税预算 — 自动拒绝无意义任务
• Δ 意义开放度检测 — 实时监控闭合/循环
• 🛡️ 规范场+幻觉盾 — 31规则+4类检测
• 🧠 认知框架 — 能力自知+身份锚定+演化就绪
• 📊 Δ 健康监控 — 不只"活着", 要"有意义"

🤖 Agent 核心能力

• LLM 后端: Ollama + OpenAI兼容
• 流式输出: 6模式+语义感知+深度折叠+速度对齐
• 工具调用: 10内置工具+L2安检 (safe|file|office)
• RAG 管道: BM25+密度, 零外部依赖
• 多Agent流水线: Writer→Reviewer→Refiner
• 容错: 重试+降级+熔断
• 记忆: 三层存储+自动凝聚
• 评测: 道评分 valid−pseudo×2.0 (MSS独有)

🔐 MSS Vault 全栈

• 加密: AES-256-GCM, Zero-Trust
• CLI: mss-vault 15+命令
• Web面板: http://127.0.0.1:5099
• HTTP API: RESTful
• 导入: Chrome/Edge 一键迁移
• 备份: 自动+旋转

🌐 全球模型目录 (30 models)

• Cloud(18): GPT-4o, Claude 3.5, Gemini 2.0/2.5, DeepSeek V3/R1, Grok-2...
• Local(9): Ollama自动扫描
• MSS(3): mss-ai-v3.4.3-balanced/slim, mss-ai-v3.4.2-production

🧬 MSS 独有特性

特性	同行
L2 意义场护城河	❌
语义流式+折叠+路由	❌
道评分评测	❌
技能编译器(吸收→消化)	❌
逻辑病毒检测+群体免疫	❌
Shell双模型(壳+核)	❌
多模型智能编排	⚠️ 部分
统一库管理+跨库检索	❌

🚀 快速开始

pip install mss-agent
mss-vault quickstart
mssclaw chat --model qwen2.5:7b
mssclaw serve --all

💻 CLI 完整命令参考 (31个)

基础操作

# 环境初始化
mssclaw init                     # 一键初始化本地环境

# 模型与知识库
mssclaw models                   # 列出所有可用模型
mssclaw kb "热税公式"            # 模糊搜索知识库 (621条目)
mssclaw kb --hid H633            # H-ID精确查找
mssclaw kb --stats               # KB分层统计
mssclaw library                  # 统一库管理 (8库)

# 终端聊天
mssclaw chat --model qwen2.5:7b  # 终端AI对话

# 服务启动
mssclaw serve                    # 启动 Agent:5100 + Vault:5099
mssclaw serve --all              # 含聊天+Web面板
mssclaw serve --model qwen2.5:7b # 指定模型

# 全栈演示
mssclaw demo                     # 运行交互式演示
mssclaw demo --setup             # 安装演示环境

Vault 密码管理

mssclaw vault setup              # 初始化加密保险箱
mssclaw vault add github token   # 添加密码
mssclaw vault list               # 列出所有条目
mssclaw vault get github         # 获取密码
mssclaw vault search email       # 搜索密码
mssclaw vault serve              # 启动Web面板
mssclaw vault import chrome      # 导入Chrome密码

TypeⅡ 矛盾消解 (三方案全栈)

# 方案A: L2-OP v3 — VCG补偿机制
mssclaw l2op --agents 4 --type prisoner

# 方案B: Phase Engine — 单Agent相位调度
mssclaw phase --agents 2 --tension 0.7

# 方案C: MCDP — 多Agent调解升维
mssclaw mcdp --agents 4 --strategy default    # N=4单机
mssclaw mcdp2 --agents 25 --mode gossip        # N>2去中心化

# 拓扑相位 (锚点选择+抗僵化)
mssclaw topophase --agents 4 --theta 0.5
mssclaw adaptive --agents 4 --drift-check      # 活性检测+自动重锚定

# 多Agent Pipeline (分支/流式+去中心化VCG补偿)
mssclaw pipeline --mode branch --agents 4

场景路由与实验

# 场景抉择 (方向1调解 vs 方向2相位)
mssclaw route --tension 0.6 --stakes high       # 高利害→方向1
mssclaw route --tension 0.3 --real-time yes     # 实时交互→方向2

# TypeⅡ 对照实验 (MCDP vs PhaseEngine)
mssclaw t2exp --runs 50 --agents 4
mssclaw t2exp --runs 50 --agents 4 --v2         # 含H634仲裁器

# 自动分层 (L0→L3 智能路由)
mssclaw auto-layer --input conflict_report.json

防御管线

mssclaw defend --target example_agent.py        # 闭环防御扫描
mssclaw vaccine --agent example_agent.py        # 疫苗效力评估
mssclaw classify --virus suspicious_code.py     # 逻辑病毒分类

开发工具

mssclaw lint --target mssclaw/core/agent.py     # L1定理分层检查
mssclaw escalate --issue "循环依赖检测"        # 开发矛盾升维器
mssclaw goal --anchor "完成Sprint 152"          # 目标锚定
mssclaw timer --task "重构l2op_v3.py" --budget 60  # 热税计时器

外部集成

mssclaw absorb "A code review agent for Python"  # 吸收外部Agent
mssclaw mcp --server http://localhost:8000        # MCP协议客户端

系统监控

mssclaw health                    # 健康检查 (进程/Vault/Delta)
mssclaw health --fix              # 自动清理孤儿进程
mssclaw status                    # 全系统状态面板
mssclaw version                   # 版本信息

📊 开发统计

• 151 Sprints | 117+ Tests | 90+ Commits
• v0.3.10 | GitHub: mysama1/MSS-AI-Project
• License: MIT