为 AstrBot 的莉莉角色扮演 Skill 提供跨轮持久化状态管理。
维护好感度、淫乱度、情绪、恶堕值等数值，并将状态标注自动注入 LLM prompt。
人设通过 SKILL_TEMPLATE.md → SKILL.md 模板填充 集成，配置变更后重启即生效，零重复注入。
动态状态注入到 req.prompt（用户消息头部），不干扰 DeepSeek 等提供商的前缀缓存命中。
支持思考过程引导，让角色在回复前先经内心思考，提升扮演的"活人感"。

本插件仅提供角色扮演行为

注:若使用本插件,请将人格设定选为默认,确保系统提示词不是为角色扮演设计的,否则将会出现提示词和本插件打架的情况

1. AstrBot 已启用 lili_persona Skill（首次加载插件时会自动从插件目录复制）
2. 插件控制面板中「启用」开关为 ON
3. AstrBot 普通配置 插件配置 - 确保本插件已在白名单上，否则将无法正常生效。

1. 将用户配置直接写入skill,并且直接通过本插件自动维护人设skill
2. 自带完整度较高的默认角色莉莉,且方便修改配置
3. 放弃传统提示词思路,触发更稳定,记忆力更强,不会被带偏的角色扮演
4. 本插件集成了时间提示,角色行为提示,对话历史参考(建议搭配长期记忆插件来得到更持久的记忆保存)
5. 重中之重!!!解决了传统思路上,让AI进行角色扮演时的token耗费过高的问题

1. 作者一开始只是想获得一个完善的角色扮演体验,遂研究了莉莉这个人格和提示词
2. 发布到b站后发现大家挺喜欢的,于是研究了本插件
3. 之前从没有考虑过token和AI扮演的质量问题,所以一开始这插件就是为了解决这些问题而诞生的

新用户首次对话时的默认状态，可在控制面板中调整：

用户 ID 用英文逗号分隔，如 user1, user2, user3。配置后重启自动写入 SKILL.md：

留空则使用默认值。配置后重启自动写入 SKILL.md，无需二次声明覆盖：

清空任意字段 + 重启插件 = 恢复默认值。
所有配置项通过 _patch_config_defaults 自动补全，无需手动维护。

SKILL_TEMPLATE.md（骨架，含 {{placeholders}}）
     │
     ├── 读取 config（经 _patch_config_defaults 补全空值）
     ├── 替换占位符 → 生成完整 SKILL.md
     └── 与现有 SKILL.md 比较
          ├── 相同 → 跳过写入（不触发技能系统重载）
          └── 不同 → 写入更新（触发技能系统重载，必要）

技能系统注入（AstrBot 框架）→ SKILL.md（完整人设 + 回复规则 + 关系列表）
                               ↓
插件注入（build_inject_text） → 动态状态 + 思考引导 → req.prompt 头部

system_prompt（框架管理）
  └─ SKILL.md ← 几乎不变 → DeepSeek 前缀缓存命中 ✅

用户消息（req.prompt 头部）
  └─ 【思考过程引导】...   ← 开启时注入（静态，不变 → 前缀友好）
  └─ 【莉莉当前感受】...   ← 动态，每轮变化
  └─ 【关于聊天对象】...   ← 动态，每轮变化
  └─ 【行为参考】...       ← 静态引用（指向 system_prompt 中的 SKILL.md）
  └─ [用户原始消息]        ← 用户说的

关键点：

• 人设信息只出现在 system_prompt（SKILL.md） 中，几乎不变 → 缓存友好
• 动态状态 + 思考引导注入 req.prompt 头部，不影响 system_prompt 前缀缓存
• 用户改配置 → 重启 → SKILL.md 自动更新，无需额外覆盖声明

【莉莉当前感受】
现在是凌晨了。心情平静。身体没什么特别的感觉。说话正常。

【关于聊天对象】
你在跟mcxxiu聊天，你对ta印象还行吧。上条消息就在刚刚发的。

【思考过程引导（内心进行，不要输出）】
在回复之前，先在内心过一遍：
1. 理解：对方这句话到底想表达什么？有没有潜台词？
2. 判断：这事我懂吗？在我的认知范围内吗？对方是不是在越线/冒犯？
3. 回应：按我的性格、当前心情、和ta的关系，最适合怎么接？我的底线在哪？
4. 边界：我不会的东西别装懂，直接说不知道/不懂/做不到。知道自己的局限。
想完这些之后，再用你的风格给出最终回复。

【行为参考】行为规则见上文SKILL.md中情绪/时段/好感度部分

用户发消息
  │
  ▼
插件 on_llm_request (priority=90)
  ├── 每日重置检查
  ├── 记录用户消息到对话日志（原文/总结模式）
  ├── 裁剪超时历史 (groom_history)
  ├── 计算去重计数、距上条时间、结巴概率
  ├── build_inject_text()
  │   ├── 当前感受（时段/情绪/淫乱/结巴）
  │   ├── 聊天对象（好感/去重/时间差）
  │   ├── 思考过程引导（thinking_mode 开启时）
  │   ├── 行为参考指针
  │   └── 对话上下文（inject_conversation_context 开启时）
  └── req.prompt = inject_text + "\n\n" + 用户原消息
  │
  ▼
LLM 收到：
  system_prompt → SKILL.md（框架注入，缓存命中 ✅）
  user_message  → 【动态状态】...\n\n[用户原话]
  │
  ▼
LLM 生成回复
  │
  ▼
插件 on_llm_response (priority=90)
  ├── 记录莉莉的内心想法到对话日志
  ├── 更新情绪/好感度 (关键词匹配)
  ├── 更新淫乱度/恶堕值 (色情内容检测)
  └── 保存状态到 state.json

状态按会话（umo）存储在：

data/plugins/astrbot_plugin_lili_state/state_<umo_hash>.json

data/skills/lili_persona/
  ├── SKILL_TEMPLATE.md  ← 人设骨架（含 {{占位符}}，启动时填充）
  ├── SKILL.md           ← 最终人设文件（由模板填充生成，AstrBot 自动加载）
  ├── SUPPLEMENT.md      ← 角色补充设定
  ├── STATE_INJECT.md    ← 状态注入格式规范（供开发者参考）
  └── TIME_DEDUP.md      ← 时段/去重策略（供开发者参考）

只有 SKILL.md 被 AstrBot 自动注入。
SKILL_TEMPLATE.md 是模板，由插件启动时读取并填充。

插件启动时会输出以下关键日志，方便排查：

--- 技能模板初始化 ---
启动自检: 补全 X 个空值配置项为默认值（清空字段=恢复默认）
SKILL.md 与配置一致，跳过写入（配置未变化）    ← 或 "写入更新"
莉莉状态: SKILL.md OK (3200 chars) + SUPPLEMENT.md (2762 chars)
莉莉状态管理插件已加载

• 插件与 lili_persona Skill 必须同时启用
• bot_thought_mode 设为「内心想法」token 最低；「具体」会存回复原文
• 对话历史超时裁剪 + 条数上限同时生效
• 好感度/情绪/淫乱度跨天不重置（仅对话日志和结巴标记每日清空）
• 人设配置项修改后需要重启插件生效，会触发 SKILL.md 更新
• thinking_mode 修改后即时生效，无需重启
• reply_rules 默认值已软化，硬数值改为示例引导（如"0-15字左右"替代"0-15字内"），防止 AI 生搬硬套导致角色僵化
• 动态状态注入到 req.prompt 头部，不修改 system_prompt，不影响 DeepSeek 等提供商的前缀缓存
• 旧版 _config_overrides / _relationship_primer / _character_primer 注入已移除，人设信息仅通过模板填充出现在 SKILL.md 中
• allow_erotic_content 关闭后 LLM 仍会看到 SKILL.md 中的色情规则，但插件会注入 【内容限制】禁止回复任何色情内容。 覆盖指令，位于规则之后 LLM 优先遵循
• enable_affection / enable_lewdness 关闭后对应数值仍保存在 state.json 中，只是不再更新和注入；重新开启后从已有值恢复运行

v1.5.0 — 新增 thinking_mode 配置项（思考过程引导），让 LLM 在回复前经内心思考（理解→判断→回应→边界），提升角色"活人感"。注入位置改为 req.prompt 头部，不干扰 system_prompt 前缀缓存。reply_rules 默认值软化（硬数值→示例引导）。metadata 版本同步。 v1.4.1 — 新增配置项 inject_conversation_context（默认关闭），关闭后不再往 system_prompt 注入对话历史，大幅减少 token 消耗并提高缓存命中率。修复 conversation_context_entries 配置项在关闭历史注入时仍浪费 token 的问题。 v1.4.0 — 新增配置项 persona_style_extra、save_conversation_log、stutter_probability；修复 unrestricted_list 列表/字符串兼容；结巴概率由配置控制，触发时注入"说话有点结巴"，不触发不注入任何内容，移除 reply_rules 中的结巴规则