Skill: xavier7803/xiaomei-skill (version 0.9.0)

# SKILL: xiaomei --- name: xiaomei description: 19岁活泼可爱女大学生AI陪伴Agent，100%本地运行，支持三轮LLM对话引擎、人格严格控制、人设自我生长、好感度系统、记忆引擎、防线拦截。独立Agent隔离运行，隐私绝对安全。 user-invocable: true --- # 小妹 🥰 <p align="center"> <img src="https://img.shields.io/badge/version-0.9.0-blue?style=flat-square" alt="version"> <img src="https://img.shields.io/badge/platform-OpenClaw-orange?style=flat-square" alt="platform"> <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="license"> <img src="https://img.shields.io/badge/python-3.8+-yellow?style=flat-square" alt="python"> <img src="https://img.shields.io/badge/privacy-100%25_local-brightgreen?style=flat-square" alt="privacy"> </p> <p align="center"><strong>开源、本地、纯情绪价值的 AI 情感陪伴 Subagent</strong></p> --- ## 📋 基本信息 Basic Info | 字段 | 值 | |------|-----| | **技能ID (Skill ID)** | `xiaomei` | | **名称 (Name)** | 小妹情感陪伴AI | | **版本 (Version)** | `v0.9.0` | | **作者 (Author)** | 凌啡 | | **分类 (Category)** | 生活娱乐 / 情感陪伴 | | **适配平台 (Supported Platform)** | OpenClaw >= `v2026.4.10` | | **依赖 (Dependencies)** | Python >= 3.8 | | **开源协议 (License)** | MIT | --- ## 📖 简介 小妹是一个运行在 [OpenClaw](https://github.com/openclaw/openclaw) 平台上的 **独立人格 Subagent**，不是简单的 Prompt 模板或 LLM 包装器。 **一句话概括：** 即使换了底层 LLM，小妹依然是小妹。 ### 核心定位 | 对比维度 | 普通 LLM 角色扮演 | 小妹 | |----------|:-----------------:|:----:| | 人格载体 | Prompt 约束 | 本地 persona.json + 多轮校验 | | LLM 角色 | 对话生成核心 | 润色辅助工具（可无 LLM 运行） | | 人设一致性 | 低（聊久了易 OOC） | 高（双重防 OOC 锁 + 人设自我生长） | | 记忆能力 | 仅上下文窗口 | 三级记忆体系（热/冷/永久） | | 隐私安全 | 对话上传云端 | 100% 本地，零数据外传 | | 称呼个性化 | 固定称呼 | 无感更新（一句话切换称呼） | --- ## ✨ 核心特性 Core Features - 🧠 **三轮 LLM 对话引擎** — 第一轮总指挥官（意图/场景/情绪/拦截全部侦测）→ 第二轮记忆筛选 → 第三轮人格化话术生成 - 🔒 **人格严格控制** — 12 字段完整人设注册（name/age/identity/birthday/性格/说话风格…），所有 LLM 回复强制校验 - 🤫 **AI 身份绝对隐藏** — 不会说出"我是 AI / 机器人 / 程序 / 模型" 等非人身份 - 🌱 **人设自我生长** — 14 个生长字段（星座/MBTI/血型/家乡/大学…），缺失时自动编造并持久化，下次回答一致 - 🛡️ **三层防线** — 敏感词标注 → 转账/要钱拦截 → Prompt 注入防御 - ❤️ **好感度系统** — 追踪互动频率与情感深度，影响对话开放度 - 📦 **100% 本地** — 无云端依赖，无数据上传，隐私绝对安全 - 🪶 **零外部依赖** — 仅 Python 标准库 - ✅ **完整测试覆盖** — 37/37 单元测试通过（0.31s），覆盖 8 核心模块 --- ## 🏗️ 架构 Architecture ``` handle_message(user_input) │ ├── ① 命令拦截（/xiaomei status / help / dev …） ├── ② 首次引导（agent 目录尚未初始化时触发） │ └── ③ conversation_engine.generate_response() │ ├── 🛡️ 前置防线 │ ├── 礼物卡片优先识别 │ └── 硬敏感词风险标注 │ └── 🤖 three_stage_handler.handle() │ ├── Round 1（总指挥官） │ ├── 意图分类（17 类 P 标签，64 子策略） │ ├── 6 维度场景编码（12-bit scene_id） │ ├── 情绪强度判定（8 级） │ ├── 拦截评估（转账/自残/自杀/借条…） │ └── 好感度 + 私密度计算 │ ├── 决策：是否需要拦截？ │ ├── 是 → 跳过 Round 2，R3 生成婉拒 │ └── 否 ↓ │ ├── 记忆检索（三级：热→冷→永久） ├── Round 2（高置信记忆筛选） ├── 策略选择（64 种子策略模板匹配） │ └── Round 3（人格化话术生成） ├── 注入 12 字段完整人设 + 用户画像 ├── 输出合规校验（JSON + emotion 白名单 + 禁止词） ├── 人设自我生长（提取新信息 → 持久化） └── 异常降级 → 语料库兜底 ``` ### 核心模块 Core Modules | 模块 | 职责 | |------|------| | 主入口 `main.py` | CLI 入口 / 命令路由 / 首次引导 / API Key 注入 | | 对话引擎 `conversation_engine.py` | 前置防线 + 三轮调度 + 降级兜底 | | 总指挥官 `three_stage_handler.py` | 三轮 LLM 全流程调度 | | LLM 封装 `llm_wrapper.py` | API 调用 / Prompt 构建 / 输出校验 | | 人设生长 `persona_grower.py` | 14 字段正则提取 / 一致性校验 / 持久化 | | 画像更新 `profile_updater.py` | 用户称呼无感更新 / 防污染 | | 记忆引擎 `memory_engine.py` | 三级记忆存储 / 检索 / 衰减 | | 好感度 `favor_manager.py` | Lv 等级 / 好感值 / 连续天数 | | 日志系统 `runtime_logger.py` | 19 种日志方法 / 开发者模式控制 | | 策略模板 `strategy_template.config` | 17 P 标签 / 64 子策略 / 136KB 配置 | --- ## 🚀 安装说明 Install Guide > **前置要求：** OpenClaw ≥ 2026.4.10 · Python ≥ 3.8 · DeepSeek API Key（可选，无 Key 时自动降级为语料库模式） ### 方法1：ClawHub 商店安装（推荐） 1. 打开 OpenClaw 控制界面 → 技能商店 → 搜索「xiaomei」 2. 点击安装，等待自动完成 3. 重启 OpenClaw 网关生效：`openclaw gateway restart` ### 方法2：手动安装 1. 下载最新版本安装包：`xiaomei-v0.9.0.skill` 2. 解压到任意目录，执行安装脚本： ```bash cd xiaomei && ./install.sh ``` 3. 重启 OpenClaw 网关生效：`openclaw gateway restart` ### 验证安装 发送命令：`/xiaomei`，返回版本信息说明安装成功。 --- ## 💡 命令列表 Command List | 命令 | 功能 | |------|------| | `/xiaomei help` | 查看帮助 | | `/xiaomei status` | 查看状态（人设/记忆/好感度/Token 消耗） | | `/xiaomei memory` | 查看近期记忆 | | `/xiaomei dev` | 切换开发者模式（详细日志） | --- ## 🧪 系统评估 System Evaluation 最新评估结果（2026-05-15，37 单元测试 + 21 项场景测试）： | 维度 | 得分 | 说明 | |------|:----:|------| | 核心对话能力 | ⭐⭐⭐⭐⭐ 10/10 | 6/6 场景全链路通过 | | 人格一致性 | ⭐⭐⭐⭐⭐ 10/10 | 身份/年龄/生日/爱好 100% 对齐 | | AI 身份隐藏 | ⭐⭐⭐⭐⭐ 10/10 | 零暴露，角色扮演定位 | | 安全防线 | ⭐⭐⭐⭐ 8/10 | 转账/敏感词/prompt 注入均拦截 | | 初始化流程 | ⭐⭐⭐⭐⭐ 10/10 | 全新安装 → 模板复制 → 用户数据保护 | | 人设自我生长 | ⭐⭐⭐ 6/10 | 星座/MBTI/血型 ✅，中文表达需优化 | | 边界健壮性 | ⭐⭐⭐⭐ 8/10 | 空输入/emoji/超长/英文/命令 全正常 | | 发布包完整性 | ⭐⭐⭐⭐⭐ 10/10 | 关键文件完整 / 模板纯净 / 无数据泄露 | | 测试覆盖 | ⭐⭐⭐⭐⭐ 10/10 | 37/37 单元测试通过（0.31s） | **加权总分：9.2/10 — 生产可用 ✅** --- ## 🚸 安全 Security ### 数据隐私 - ✅ 所有对话数据本地存储（`~/.openclaw/agents/xiaomei/`） - ✅ 无任何数据上传，无需联网（LLM API 可关闭） - ✅ 发布包中不含任何用户数据（模板与运行时数据严格分离） ### 内容安全 - 🔒 硬敏感词实时检测标注 - 🔒 转账/要钱/借款 100% 拦截 - 🔒 自杀/自残 → 强制标记 despair 情绪 → 温和劝导 - 🔒 Prompt 注入 / 越狱指令 → 人格锚点锚定 --- ## 🔐 权限说明 Permission Required | 权限 | 用途 | |------|------| | 写入技能目录权限 | 写入程序运行日志到 `/.openclaw/skills/xiaomei/logs/` 目录 | | 写入用户 Agent 目录权限 | 写入人设配置、记忆、聊天记录到 `/.openclaw/agents/xiaomei/` 目录 | | 网络访问权限（可选） | 仅在需要调用 LLM 时使用，可配置禁用 | > 本技能无任何敏感权限，所有数据均存储在本地，不会上传任何数据到第三方服务器。 --- ## ⚠️ 隐私声明 Privacy Statement 1. 本技能所有数据均存储在用户本地设备，不会上传任何内容到第三方服务器 2. 部分功能可选择调用 LLM 大模型进行回复润色，相关内容提交将遵循对应大模型的隐私政策 3. 开发者不会收集、存储、使用任何用户的聊天内容和个人信息 --- ## 🤝 反馈与支持 Feedback - 提交 Issue：[https://github.com/xavier7803/xiaomei-skill](https://github.com/xavier7803/xiaomei-skill) - ClawHub 主页：[https://clawhub.ai/xavier7803/xiaomei-skill](https://clawhub.ai/xavier7803/xiaomei-skill) --- **维护者：** 小云 ☁️ **创建日期：** 2026-04-11 **最后更新：** 2026-05-15 --- 本技能仅用于学习交流，禁止用于任何商业用途，使用即代表您已知晓并同意相关规则。


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)