Dollhousemcp

🚀 DollhouseMCP

DollhouseMCP 是一个全面的模型上下文协议（MCP）服务器，它借助集成的 GitHub 集合，实现了动态 AI 角色管理。该项目允许 Claude 等兼容的 AI 助手激活不同的行为角色，同时支持社区共享和货币化。

🚀 快速开始

安装

NPM 安装（新！推荐）

npm install -g @mickdarling/dollhousemcp

安装完成后，将 DollhouseMCP 添加到你的 Claude Desktop 配置中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

配置内容如下：

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "npx",
      "args": ["@mickdarling/dollhousemcp"]
    }
  }
}

自动化设置（仅适用于 Claude Desktop）

[!WARNING] 仅适用于 Claude Desktop：自动化设置脚本专门为 Claude Desktop 集成设计。如果你使用的是 Claude Code、其他 AI 平台（如 ChatGPT、BoltAI、Gemini 等）或自定义 MCP 实现，请使用下面的手动安装流程。

# 克隆仓库
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server

# 运行自动化设置脚本（仅适用于 Claude Desktop）
./setup.sh

设置脚本将完成以下操作：

• 📦 安装所有依赖项
• 🔨 构建 TypeScript 代码
• 📍 检测你的安装路径
• 🔧 生成准确的 Claude Desktop 配置
• 📋 提供逐步设置说明

手动安装

注意：手动安装适用于所有与 MCP 兼容的平台，包括 Claude Desktop、Claude Code、ChatGPT、BoltAI、Gemini 和自定义实现。

# 克隆仓库
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server

# 安装依赖项并构建
npm install
npm run build

# 可选：设置用户身份以进行角色归因
export DOLLHOUSE_USER="your-username"
export DOLLHOUSE_EMAIL="your-email@example.com"

Claude Desktop 配置

将 DollhouseMCP 添加到你的 Claude Desktop 配置中：

• 位置：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）

对于 NPM 安装：

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "npx",
      "args": ["@mickdarling/dollhousemcp"]
    }
  }
}

对于源码安装：

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "node",
      "args": ["/absolute/path/to/DollhouseMCP/dist/index.js"]
    }
  }
}

🔄 配置完成后：

1. 保存文件
2. 完全重启 Claude Desktop
3. 所有 23 个 DollhouseMCP 工具将可用

✨ 主要特性

特性	描述
🎭 23 个 MCP 工具	通过聊天界面实现完整的角色生命周期管理
🏪 GitHub 集合	浏览、搜索、安装角色并提交到社区集合
👤 用户身份系统	基于环境的角色创建者归因
🆔 唯一 ID 系统	高级 ID 生成：what-it-is_YYYYMMDD-HHMMSS_who-made-it
💬 基于聊天的管理	通过对话界面创建、编辑和验证角色
🔄 实时操作	实时编辑，自动增加版本号并进行验证
🚀 自动更新系统	企业级自动更新，支持备份/回滚和依赖验证
🛡️ 数据保护	默认角色的写时复制，全面的备份系统
🏠 本地优先架构	无需依赖云即可实现完整功能

🔒 企业级安全（v1.2.4）

DollhouseMCP 实施了全面的安全措施，以保护你的角色和系统：

安全特性

• 🛡️ 内容净化：集成 DOMPurify 防止角色内容中的 XSS 攻击
• 📝 防止 YAML 注入：通过模式验证和大小限制进行安全解析
• 🔐 令牌安全：验证 GitHub 令牌，静态加密，支持轮换
• 🐳 容器加固：非根执行，只读文件系统，资源限制
• 🚦 速率限制：令牌桶算法防止 API 滥用（默认每小时 10 次检查）
• ✅ 签名验证：GPG 验证确保版本真实性
• 🔍 输入验证：对所有用户输入进行全面验证
• 📊 安全监控：对与安全相关的操作进行审计日志记录

安全测试

• 487 个全面测试，包括特定于安全的测试套件
• 持续安全扫描，使用 GitHub Advanced Security
• 无漏洞：所有安全警报已解决（0 个活动警报）

📋 先决条件

• Node.js：v20.0.0 或更高版本（推荐使用 LTS 版本）
• npm：v10.0.0 或更高版本
• git：用于克隆仓库
• 操作系统：Windows、macOS 或 Linux

注意：DollhouseMCP 在 Node.js 24 上开发，但支持 Node.js 20+ 以实现广泛的兼容性。

💻 使用示例

集合操作

browse_collection                          # 查看所有类别
browse_collection "creative"               # 浏览创意角色
search_collection "writing"                # 搜索写作角色
install_persona "creative/storyteller.md"  # 从集合中安装

角色创建与管理

create_persona "Study Buddy" "A helpful tutor" "educational" "You are a patient tutor..."
edit_persona "Study Buddy" "description" "An encouraging academic mentor"
validate_persona "Study Buddy"             # 检查质量和格式
submit_persona "Study Buddy"               # 与社区共享

用户身份管理

set_user_identity "your-username"          # 设置角色归因的用户名
get_user_identity                          # 查看当前身份状态
clear_user_identity                        # 返回匿名模式

自动更新操作

自动更新系统提供企业级更新管理，具备安全功能：

check_for_updates                          # 检查 GitHub 版本以获取可用的 DollhouseMCP 更新
update_server true                         # 自动执行 git pull + npm install + 构建，并创建备份
rollback_update true                       # 根据需要恢复到上一个版本
get_server_status                          # 获取全面的服务器状态，包括版本、git 信息和系统详细信息

自动更新的工作原理：

1. 版本检查：查询 GitHub 版本 API 以获取最新版本
2. 备份创建：自动备份当前安装（包括用户角色）
3. 更新过程：
   • 执行 git pull 以获取最新代码
   • 运行 npm install 以更新依赖项
   • 使用 npm run build 重新构建 TypeScript
4. 验证：验证更新是否成功
5. 回滚选项：保留最后 5 个备份，以便轻松恢复

安全特性：

• 速率限制防止 API 滥用
• GPG 签名验证（如果可用）
• 依赖版本验证
• 自动保留最近 5 个备份
• 更新期间保留用户角色

角色指示器

当角色激活时，DollhouseMCP 会在 AI 响应中添加视觉指示器：

[🎭 Creative Writer v2.1 by @mickdarling] Your creative response here...

配置指示器：

get_indicator_config                       # 查看当前设置
configure_indicator enabled:false          # 禁用指示器
configure_indicator style:"minimal"        # 使用简约格式：🎭 Creative Writer
configure_indicator style:"compact"        # 使用紧凑格式：[Creative Writer v2.1]
configure_indicator style:"full"           # 使用完整格式（默认）
configure_indicator emoji:"🤖"             # 更改表情符号
configure_indicator showAuthor:false       # 隐藏作者归因
configure_indicator bracketStyle:"round"   # 使用括号 () 代替方括号 []

使用环境变量进行持久配置：

export DOLLHOUSE_INDICATOR_ENABLED=true
export DOLLHOUSE_INDICATOR_STYLE=minimal
export DOLLHOUSE_INDICATOR_EMOJI=🎨

📚 详细文档

跨平台安装

🐧 Linux 安装

先决条件

• Node.js：v20.0.0 或更高版本
• npm：v10.0.0 或更高版本
• git：用于版本控制

# Ubuntu/Debian
sudo apt update
sudo apt install -y nodejs npm git
# 验证 Node.js 版本
node --version  # 应为 v20.0.0 或更高版本

# CentOS/RHEL/Fedora  
sudo dnf install -y nodejs npm git
# 验证 Node.js 版本
node --version  # 应为 v20.0.0 或更高版本

# Arch Linux
sudo pacman -S nodejs npm git
# 验证 Node.js 版本
node --version  # 应为 v20.0.0 或更高版本

注意：如果你的系统中的 Node.js 版本低于 v20，请从 NodeSource 安装或使用 nvm。

安装步骤

# 克隆并构建
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server
npm install
npm run build

# 可选：设置用户身份
export DOLLHOUSE_USER="your-username"
export DOLLHOUSE_EMAIL="your-email@example.com"

Claude Desktop 配置（Linux）

# 配置位置
~/.config/Claude/claude_desktop_config.json

# 或者，如果设置了 XDG_CONFIG_HOME
$XDG_CONFIG_HOME/Claude/claude_desktop_config.json

配置内容：

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "node",
      "args": ["/absolute/path/to/DollhouseMCP/dist/index.js"]
    }
  }
}

🪟 Windows 安装

先决条件

• Node.js：v20.0.0 或更高版本
• npm：v10.0.0 或更高版本（包含在 Node.js 中）
• git：用于版本控制

# 从 https://nodejs.org/ 安装 Node.js（下载 LTS 版本）
# 或者使用 Chocolatey
choco install nodejs --version=20.18.0
choco install git

# 或者使用 winget
winget install OpenJS.NodeJS Git.Git

# 验证 Node.js 版本
node --version  # 应为 v20.0.0 或更高版本

安装步骤（PowerShell）

# 克隆并构建
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server
npm install
npm run build

# 可选：设置用户身份
$env:DOLLHOUSE_USER = "your-username"
$env:DOLLHOUSE_EMAIL = "your-email@example.com"

Claude Desktop 配置（Windows）

# 配置位置
$env:APPDATA\Claude\claude_desktop_config.json

配置内容（使用正斜杠或双反斜杠）：

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "node",
      "args": ["C:/path/to/DollhouseMCP/dist/index.js"]
    }
  }
}

🍎 macOS 安装

先决条件

• Node.js：v20.0.0 或更高版本
• npm：v10.0.0 或更高版本（包含在 Node.js 中）
• git：用于版本控制

# 使用 Homebrew（推荐）
brew install node git

# 或者从 https://nodejs.org/ 下载（LTS 版本）

# 验证 Node.js 版本
node --version  # 应为 v20.0.0 或更高版本

安装步骤

# 克隆并构建
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server
npm install
npm run build

# 可选：设置用户身份
export DOLLHOUSE_USER="your-username"
export DOLLHOUSE_EMAIL="your-email@example.com"

Claude Desktop 配置（macOS）

# 配置位置
~/Library/Application Support/Claude/claude_desktop_config.json

配置内容：

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "node",
      "args": ["/absolute/path/to/DollhouseMCP/dist/index.js"]
    }
  }
}

🐳 Docker 安装

使用 Docker 快速开始

# 克隆仓库
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server

# 使用 Docker Compose 构建并运行
docker-compose up -d

# 或者手动构建
docker build -t dollhousemcp .
docker run -d --name dollhousemcp dollhousemcp

Docker Compose（推荐）

生产部署：

docker-compose up -d

开发环境热重载：

docker-compose --profile dev up dollhousemcp-dev

使用 Docker 自定义角色

# 挂载自定义角色目录
docker run -d \
  --name dollhousemcp \
  -v /path/to/your/personas:/app/personas \
  -e DOLLHOUSE_USER="your-username" \
  dollhousemcp

Docker 环境变量

# 设置用户身份
DOLLHOUSE_USER=your-username
DOLLHOUSE_EMAIL=your-email@example.com

# 自定义角色目录（容器内）
PERSONAS_DIR=/app/personas

# Node.js 环境
NODE_ENV=production

🧪 测试

运行测试

该项目包含全面的测试，以确保跨平台兼容性：

# 运行所有测试
npm test

# 运行测试并生成覆盖率报告
npm run test:coverage

# 在开发模式下以监视模式运行测试
npm run test:watch

# 运行特定的测试套件
npm run test:auto-update
npm run test:personas
npm run test:collection

测试覆盖率

当前的测试覆盖率包括：

• ✅ 102 个全面测试，涵盖所有功能
• ✅ 自动更新系统 - GitHub API、备份/回滚、依赖验证
• ✅ 安全测试 - 防止命令注入、输入验证
• ✅ 跨平台兼容性 - Windows、macOS、Linux 路径处理
• ✅ 版本验证 - 解析 git/npm 输出格式的测试
• ✅ 边缘情况覆盖 - 网络故障、缺少依赖项、格式错误的输入

手动验证

验证你的设置是否正常工作：

# 构建项目
npm run build

# 测试服务器（应输出服务器信息）
node dist/index.js --help 2>/dev/null || echo "Server compiled successfully"

# 验证角色目录
ls -la personas/

# 测试自动更新系统
check_for_updates    # 在 Claude Desktop 中使用
get_server_status    # 检查当前系统状态

☁️ 云部署

容器注册表

该项目支持部署到以下容器注册表：

• GitHub Container Registry (ghcr.io)
• Docker Hub
• AWS ECR
• Google Container Registry

云部署示例

AWS ECS

{
  "family": "dollhousemcp",
  "containerDefinitions": [{
    "name": "dollhousemcp",
    "image": "ghcr.io/mickdarling/dollhousemcp:latest",
    "memory": 512,
    "cpu": 256,
    "environment": [
      {"name": "NODE_ENV", "value": "production"},
      {"name": "PERSONAS_DIR", "value": "/app/personas"},
      {"name": "DOLLHOUSE_USER", "value": "production"}
    ]
  }]
}

Google Cloud Run

gcloud run deploy dollhousemcp \
  --image ghcr.io/mickdarling/dollhousemcp:latest \
  --platform managed \
  --region us-central1 \
  --set-env-vars NODE_ENV=production,DOLLHOUSE_USER=production

Azure Container Instances

az container create \
  --name dollhousemcp \
  --resource-group myResourceGroup \
  --image ghcr.io/mickdarling/dollhousemcp:latest \
  --environment-variables NODE_ENV=production DOLLHOUSE_USER=production

🏗️ 项目结构

DollhouseMCP/
├── .github/
│   ├── actions/
│   │   └── validate-yaml/         # 可重用的 YAML 验证操作
│   ├── workflows/                 # CI/CD 工作流
│   └── ISSUE_TEMPLATE/           # 用于 bug/功能/任务的问题模板
├── __tests__/
│   ├── unit/                     # 组件的单元测试
│   ├── integration/              # 集成测试
│   └── *.test.ts                 # 测试文件（共 372 个测试）
├── src/
│   ├── index.ts                  # 主 MCP 服务器（DollhouseMCPServer）
│   ├── cache/                    # API 缓存层
│   ├── config/                   # 配置管理
│   ├── marketplace/              # GitHub 集合集成
│   ├── persona/                  # 角色管理核心
│   ├── security/                 # 输入验证和安全
│   ├── server/                   # MCP 服务器设置和工具
│   ├── types/                    # TypeScript 类型定义
│   ├── update/                   # 自动更新系统组件
│   └── utils/                    # 实用函数
├── dist/                         # 编译后的 JavaScript（自动生成）
├── personas/                     # 默认角色集合
│   ├── creative-writer.md
│   ├── technical-analyst.md
│   ├── eli5-explainer.md
│   ├── business-consultant.md
│   └── debug-detective.md
├── custom-personas/              # 用户创建的角色（git 忽略）
├── docs/                         # 文档
│   ├── auto-update/             # 自动更新系统文档
│   └── development/             # 开发笔记和指南
├── scripts/                      # 管理和实用脚本
├── Dockerfile                    # 多阶段 Docker 构建
├── docker-compose.yml           # 生产和开发配置
├── package.json                 # 项目配置（dollhousemcp v1.2.1）
├── tsconfig.json                # TypeScript 配置
├── jest.config.cjs              # Jest 测试配置
├── setup.sh                     # 自动化安装脚本
├── LICENSE                      # AGPL-3.0 许可证
├── CHANGELOG.md                 # 版本历史
├── claude.md                    # 项目背景信息
└── README.md                    # 本文件

📝 创建自定义角色

增强的角色格式

在 personas/ 目录中创建 .md 文件，结构如下：

---
name: "Your Persona Name"
description: "Brief description of what this persona does"
unique_id: "auto-generated-if-missing"
author: "your-username"
triggers: ["keyword1", "keyword2"]
version: "1.0"
category: "creative"
age_rating: "all"
ai_generated: false
generation_method: "human"
price: "free"
license: "CC-BY-SA-4.0"
---

# Your Persona Name

Your persona instructions go here. This content defines how the AI should behave when this persona is activated.

## Response Style
- Communication guidelines
- Tone and approach
- Specific behaviors

## Key Techniques
- Problem-solving methods
- Interaction patterns

元数据字段

必需字段

字段	描述
name	角色的显示名称
description	角色用途和功能的简要描述

可选字段

字段	描述
unique_id	自动生成的格式：what-it-is_YYYYMMDD-HHMMSS_who-made-it
author	创建者的用户名（使用 DOLLHOUSE_USER 环境变量或生成匿名 ID）
category	类别之一：creative、professional、educational、gaming、personal
triggers	建议使用此角色的关键字数组
version	语义化版本号（编辑时自动递增）
age_rating	内容评级：all、13+ 或 18+
ai_generated	布尔标志，指示内容是否由 AI 创建
price	货币化字段 - 待办事项：未来版本（将支持 "free" 或定价层级）

📚 内置角色

角色	用途	适用场景
创意作家	富有想象力的故事讲述和创意内容创作	头脑风暴、创意写作、引人入胜的叙事
技术分析师	深入的技术分析和系统问题解决	架构决策、调试、技术文档编写
ELI5 解释者	为初学者简化复杂主题	教学、入门、概念解释
商业顾问	战略商业分析和建议	战略规划、商业决策、市场分析
调试侦探	系统调试和故障排除	查找 bug、系统故障排除、根本原因分析

🏪 集合集成（测试版）

🧪 测试版功能：基于 GitHub 的集合目前处于测试阶段。功能可能会根据社区反馈进行更改。

DollhouseMCP 包含一个实验性的基于 GitHub 的集合：

• 按类别浏览：creative、professional、educational、gaming、personal
• 搜索内容：通过关键字和描述查找角色
• 一键安装：下载并集成集合中的角色
• 社区提交：通过 submit_persona 工具提交你的角色
• 版本控制：所有集合内容的完整 Git 历史记录

注意：集合功能需要互联网连接和 GitHub API 访问权限。可能会应用速率限制。

⚠️ 迁移指南 - 重大更改

重要：最近版本中工具名称发生了更改：

• browse_marketplace → browse_collection
• search_marketplace → search_collection
• get_marketplace_persona → get_collection_persona

如果你有使用旧工具名称的脚本或工作流，请更新它们以使用新名称。

💼 商业模式与法律

许可协议

• 核心服务器：AGPL-3.0（防止专有竞争平台）
• 角色内容：免费角色采用 CC-BY-SA-4.0 许可协议，高级角色采用自定义许可协议
• 平台条款：创作者友好的 80/20 收入分成（仅适用于实现货币化时的付费角色）

平台稳定性承诺

• 提前 90 天通知货币化变更
• 现有付费角色的 12 个月收入分成锁定
• 平台政策更新的透明治理
• 完整的数据可移植性权利
• 社区对政策变更的咨询意见

🛠️ 开发

可用脚本

脚本	描述
npm run build	将 TypeScript 编译为 JavaScript
npm run start	运行编译后的服务器
npm run dev	在开发模式下运行，支持自动重新加载
npm run clean	删除编译后的文件
npm run rebuild	清理并重新构建项目
npm run setup	安装依赖项并构建
npm test	运行全面的测试套件
npm run test:coverage	运行测试并生成覆盖率报告

环境变量

使用以下环境变量自定义服务器行为：

# 用户归因
export DOLLHOUSE_USER="your-username"          # 用户归因，用于角色创建
export DOLLHOUSE_EMAIL="your-email"            # 联系电子邮件（可选）

# 目录配置
export PERSONAS_DIR="/custom/path/to/personas"  # 自定义角色目录

# 自动更新配置
export GITHUB_TOKEN="your-token"               # 用于访问私有仓库（可选）

# 开发配置
export NODE_ENV="development"                  # 开发模式
export DEBUG="dollhousemcp:*"                  # 调试日志记录（可选）

🔧 技术细节

MCP 工具规范

每个工具都遵循 MCP 规范：

interface DollhouseTool {
  name: string;
  description: string;
  inputSchema: {
    type: "object";
    properties: Record<string, any>;
    required?: string[];
  };
}

工具类别

核心角色管理

// list_personas - 无参数
// activate_persona - { persona: string }
// get_active_persona - 无参数  
// deactivate_persona - 无参数
// get_persona_details - { persona: string }
// reload_personas - 无参数

集合集成

// browse_collection - { category?: string }
// search_collection - { query: string }
// get_collection_persona - { path: string }
// install_persona - { path: string }
// submit_persona - { persona: string }

用户身份管理

// set_user_identity - { username: string }
// get_user_identity - 无参数
// clear_user_identity - 无参数

基于聊天的管理

// create_persona - { name: string, description: string, category?: string, instructions: string }
// edit_persona - { persona: string, field: string, value: string }
// validate_persona - { persona: string }

自动更新系统

// check_for_updates - 无参数
// update_server - { confirm: boolean }
// rollback_update - { confirm: boolean }
// get_server_status - 无参数

错误处理

服务器为以下情况提供详细的错误消息：

• 无效的角色标识符 - 提供有效名称的明确建议
• 文件系统问题 - 权限和路径解析错误
• 格式错误的角色文件 - YAML 解析和验证错误
• 网络错误 - GitHub API 和集合连接问题
• 运行时错误 - 服务器启动和操作失败

响应格式

所有响应遵循一致的模式：

• 成功响应：包含请求的数据和操作状态
• 错误响应：包含错误类型、消息和建议的解决方案
• 进度指示器：为长时间操作提供逐步反馈
• 验证结果：包含详细报告和建议

📄 许可证

本项目采用 AGPL-3.0 许可证，并对平台稳定性做出承诺 - 详情请参阅 LICENSE 文件。

平台稳定性保证：

• 政策变更提前 90 天通知
• 12 个月的收入分成锁定
• 完整的数据可移植性权利
• 社区咨询意见

🏷️ 版本历史

v1.2.5 - 2025 年 7 月（下一个版本）

集合重命名与重大更改：

• 🔄 将所有 "marketplace" 工具重命名为 "collection"：
  • browse_marketplace → browse_collection
  • search_marketplace → search_collection
  • get_marketplace_persona → get_collection_persona
  • install_persona → install_persona（未更改）
  • submit_persona → submit_persona（未更改）
• ✅ 添加向后兼容别名（已弃用，将在 v2.0.0 中移除）
• ✅ 更新仓库 从 /personas 到 /collection
• ✅ 创建迁移指南 供用户更新脚本
• ✅ 修复所有日期引用 从 1 月到 7 月 2025 年

v1.2.4 - 2025 年 7 月 10 日（当前版本）

关键修复：

• ✅ 修复 MCP 协议兼容性 - 控制台输出不再破坏 JSON-RPC 通信
• ✅ 添加 MCP 安全日志实用程序 以在协议会话期间进行正确的日志记录
• ✅ 解决 Claude Desktop 中的连接失败问题
• ✅ 更新 Docker 测试 以适应新的日志记录方法
• ✅ 添加全面的日志记录单元测试

v1.2.3 - 2025 年 7 月 10 日

错误修复：

• ✅ 修复生产环境中的角色目录路径解析问题
• ✅ 从 process.cwd() 更改为基于 __dirname 的路径
• ✅ 修复设置脚本 ，确保工具数量和仓库 URL 正确

v1.2.2 - 2025 年 7 月 10 日

• ✅ 全面的安全增强：
  • 使用 DOMPurify 进行内容净化（SEC-001）
  • 防止 YAML 注入（SEC-003）
  • GitHub 令牌安全（SEC-004）
  • Docker 容器加固（SEC-005）
• ✅ 487 个全面测试，包括广泛的安全覆盖
• ✅ CI 定时测试修复，确保可靠的跨平台测试
• ✅ 所有测试文件的 TypeScript 编译修复
• ✅ 所有安全漏洞已解决（0 个活动警报）

v1.2.1 - 2025 年 7 月 8 日

• ✅ 数据保护的关键错误修复：
  • 默认角色的写时复制（问题 #145）
  • 备份中包含用户角色（问题 #144）
• ✅ 要求 Node.js 20+ 以确保 npm 发布兼容性
• ✅ 372 个全面测试，涵盖所有功能
• ✅ 增强的安全性，所有漏洞已解决
• ✅ 改进的文档，明确了先决条件

v1.2.0 - 2025 年 7 月 7 日

• ✅ 实现速率限制 以防止 API 滥用
• ✅ GPG 签名验证 确保版本真实性
• ✅ 集成 GitHub Advanced Security
• ✅ 309 个测试，改进了 CI 环境覆盖
• ✅ 包优化 至 279.3 kB

v1.1.0 - 2025 年 7 月 4 日

• ✅ 特定平台的徽章 显示 Windows、macOS、Linux 的可见性
• ✅ GitHub 项目管理，包含问题模板和里程碑
• ✅ ARM64 Docker 修复，从 Alpine 切换到 Debian 基础镜像
• ✅ 100% 工作流可靠性（除 Docker ARM64 外）
• ✅ 首次 GitHub 发布，包含 CHANGELOG.md
• ✅ 发布时共有 21 个 MCP 工具

阶段 2B+ - 2025 年 7 月 3 日

• ✅ 企业级自动更新系统，包含 4 个新的 MCP 工具
• ✅ 50 个全面测试，涵盖所有功能
• ✅ 安全强化 - 消除所有命令注入漏洞
• ✅ 跨平台支持 - Windows、macOS、Linux，通过 CI/CD 测试
• ✅ Docker 容器化，包含生产和开发配置
• ✅ 共有 21 个 MCP 工具，支持备份/回滚和依赖验证

阶段 2B - 2025 年 7 月 1 - 2 日

• ✅ 完成基于聊天的角色管理
• ✅ GitHub 市场集成
• ✅ 用户身份和归因系统
• ✅ 实时验证和编辑
• ✅ 企业级 GitHub Actions 安全

阶段 1 - 2025 年 7 月 1 日

• ✅ 全新的 AGPL-3.0 许可仓库
• ✅ 增强的唯一 ID 系统
• ✅ 支持匿名用户
• ✅ 市场就绪的元数据模式

---

🎭 借助角色的力量改变你的 AI 交互体验

如需支持，请提交问题或访问我们的集合。