✨ 特性

• 🔄 方案管理 — 保存/切换多套人设，随心换心情
• 📤 导入导出 — JSON 配置分享，一键迁移
• 🔒 本地存储 — 数据不离开你的设备
• 🌐 通用兼容 — 不绑定任何特定框架，环境变量可配
• ⚖️ 安全合规 — 亲密尺度分级 + 内容边界控制 + 免责声明

🆕 v2 新增能力（Agent 级）

设计原则：离线重处理、在线轻注入。重活全部在对话间隙离线完成，
单轮额外系统开销硬约束在 500 Token 以内，不挤占正常对话带宽。

在线唯一入口是 scripts/pipeline/orchestrator.py 的 Session：
prepare（注入前准备）→ after_reply（回复后沉淀）→ proactive（主动关怀）。

🚀 快速开始

1️⃣ 安装

将本仓库克隆到你的 AI Agent 技能目录：

git clone https://github.com/MoYan1638/love-companion.git

2️⃣ 启用

向你的 AI Agent 发送：

/恋人启用

3️⃣ 选择人设

/恋人预设          # 查看所有预设
/恋人套用 2        # 一键套用温柔治愈型

或自定义：

/恋人名字 小晴
/恋人叫我 宝贝
/恋人性格 温柔体贴，偶尔小傲娇
/恋人尺度 3

4️⃣ 开始对话

直接聊天即可，恋人会越来越懂你 🌸

🎭 预设人设一览

每套预设都支持套用后继续微调，混搭出你的专属恋人！

📂 项目结构

love-companion/
├── 📄 SKILL.md              # 技能主文件（核心逻辑与架构）
├── 📄 README.md             # 项目说明（你正在看）
├── 📄 LICENSE               # CC BY-NC 4.0 许可证
├── 📁 scripts/
│   ├── 🐍 manager.py        # v1 配置与记忆管理（全部保留，向后兼容）
│   ├── 📁 core/             # schema · 设置读取 · 数据可靠性 · 隐私脱敏 · 内容边界
│   ├── 📁 pipeline/         # 离线任务队列 · 轻注入器 · 调度器 · 在线编排 Session
│   ├── 📁 memory/           # 六类记忆：采集 · 检索召回 · 衰减
│   ├── 📁 persona/          # 人格克隆（解析/三层提取/人格库/镜像）+ v1 适配层
│   ├── 📁 user/             # 恋人式用户理解 + 依恋规则引擎
│   ├── 📁 style/            # 语气贴合 + AI 腔守门
│   ├── 📁 care/             # 主动关怀：三道闸门 + 话术模板
│   ├── 📁 trends/           # 趋势感知：源路由 + 趋势知识库
│   ├── 📁 multimodal/       # 配图计划
│   ├── 📁 panel/            # 可解释面板 + 控制开关
│   └── 📁 migrate/          # v1 → v2 无损迁移
├── 📁 tests/                # 296 项回归测试（覆盖 v1 兼容与 v2 全流程）
├── 📁 docs/
│   └── 📐 architecture.md   # 架构设计（在线/离线边界、设计取舍、数据可靠性）
└── 📁 references/
    ├── 📋 commands.md       # 完整指令参考手册
    ├── 📖 instructions.md   # 详细使用教程
    └── 🎭 personas.md       # 8套预设人设模板

零第三方依赖，只用 Python 标准库——不需要装任何东西，克隆即可用。

⌨️ 指令速查

核心开关

人设配置

快捷配置

方案管理

记忆系统

导入导出

v2 新增指令

系统

🔧 高级配置

自定义存储路径

默认数据存储在 ~/.love-companion/data/，可通过以下方式自定义：

方式一：环境变量

export LOVE_COMPANION_DATA_DIR=/your/custom/path

方式二：指令配置

/恋人配置 storage=/your/custom/path

亲密尺度分级

⚠️ 尺度 4-5 级严格遵守内容安全策略，超出合规边界的请求将被拒绝。

🔄 从 v1 升级

无需任何操作，直接拉取新版本即可——v2 是 v1 的严格超集：

• 8 套预设、/恋人… 全部指令、manager.py 的 API 与数据目录全部保留
• 老版本的 persona.json / memory.json 可直接被 v2 读取（v2 的 memory.json 结构是 v1 的超集）
• 迁移会自动先备份再写入，备份目录形如 backup_v1_<时间戳>/，可随时回退

想先看一眼迁移会做什么，可以预演（不改动任何文件）：

python scripts/migrate/migrate_v1.py --dry-run

重复执行迁移是安全的（幂等），已迁移过的文件不会被再次改动。

v2 常用运维脚本

python scripts/pipeline/orchestrator.py --status   # 查看在线编排状态与注入预算
python scripts/panel/controls.py status            # 查看模块开关与特征权重
python scripts/memory/store.py stats               # 记忆库统计
python scripts/trends/store.py digest              # 查看趋势知识库摘要

数据与隐私

• 所有数据只保存在本地 ~/.love-companion/data/，不离开你的设备（可用 LOVE_COMPANION_DATA_DIR 覆盖）
• 用户理解模块只存特征不存原文，采集开关可随时关闭
• 数据文件损坏时会自动隔离为 *.bad-<时间戳> 并降级到默认值，不会导致数据静默丢失
• /恋人导出全部 可一次性导出全部本地数据，/恋人遗忘 [名字] 可精确清除某段关系

🧪 测试

python -m unittest discover -s tests -t .

296 项回归测试，覆盖 v1 兼容、v2 各模块、数据可靠性与 CLI 冒烟。

⚠️ 免责声明

• 本项目为 AI 角色扮演工具，所有对话均为 AI 生成，不代表真实人际关系。
• 请勿将 AI 陪伴替代真实社交或专业心理辅导。
• 如您正在经历心理健康困扰，请寻求专业帮助。
• 本项目遵循 CC BY-NC 4.0 许可证，使用者需自行承担使用风险。

🤝 贡献指南

欢迎贡献！你可以：

• 🎭 提交新预设人设 — Fork → 添加预设 → PR
• 🐛 报告 Bug — 提交 Issue 描述问题
• 💡 建议新功能 — 提交 Issue 标注 enhancement
• 📖 改进文档 — 修复错别字、补充说明
• 🌍 多语言支持 — 帮助翻译为其他语言

提交预设人设

1. Fork 本仓库
2. 在 references/personas.md 末尾按 ### 【N号】类型名 的格式添加新预设（含 json 配置块与 **特点**： 描述）
3. 无需改动 scripts/manager.py——运行时会自动解析该文件。提交前建议自测：
   python scripts/manager.py presets 能正常列出，且 python scripts/manager.py apply N 能套用
4. 提交 Pull Request

📊 Star History

如果这个项目对你有帮助，点个 ⭐ 支持一下！

📄 许可证

CC BY-NC 4.0 — 个人学习、使用、修改、二次创作免费，需署名并附原仓库链接；禁止商业用途（含倒卖、打包进付费产品/服务），商用授权请联系作者。