pasm-agents 0.4.3__py3-none-any.whl

agents/__init__.py

@@ -0,0 +1,7 @@
+"""PASM 智能体目录 —— 每个智能体一个文件夹。
+
+- `product/`   面向使用者的成品智能体（游戏 NPC / 老人陪伴 / 学习陪伴）
+- `verifiers/` 面向开发者的验证智能体（给认知引擎做长期体检）
+
+`pasm_agents` 包是本目录的聚合转发层，公开 API 与目录结构解耦。
+"""

agents/product/__init__.py

@@ -0,0 +1 @@
+"""面向使用者的成品智能体：游戏 NPC / 老人陪伴 / 学习陪伴。"""

agents/product/companion/__init__.py

@@ -0,0 +1,17 @@
+"""ElderlyCompanion —— 老人陪伴：关键事实 / 用药提醒 / 危机升级
+
+实现正文在 `agent.py`；本文件只做转发，方便 `from <包路径> import ElderlyCompanion`。
+"""
+from __future__ import annotations
+
+from .agent import (  # noqa: F401
+    ElderlyCompanion,
+    CRISIS_KEYWORDS,
+    random_kind,
+)
+
+__all__ = [
+    "ElderlyCompanion",
+    "CRISIS_KEYWORDS",
+    "random_kind",
+]

agents/product/companion/agent.py

@@ -0,0 +1,216 @@
+"""老人陪伴产品智能体。
+
+聚焦三件事：
+
+1. **关键事实牢牢记住**：用药、过敏、家人、本人信息。标签式精确检索，**永不丢**。
+2. **用药提醒**：到点不打扰但会主动提，过时不催但会观察。
+3. **危机升级**：识别自伤/摔倒/胸口闷等关键词，主动播报给预设的紧急联系人。
+
+快速开始：
+
+.. code-block:: python
+
+    from pasm_agents import ElderlyCompanion
+
+    comp = ElderlyCompanion(agent_id="chenxiulan", persona={
+        "name": "陈秀兰", "age": 78, "city": "深圳",
+        "tone": "慢、温和、爱重复说过的话",
+        "key_facts": [
+            {"label": "用药", "content": "每天早 8 点吃降压药络活喜 5mg"},
+            {"label": "过敏", "content": "青霉素过敏"},
+            {"label": "家人", "content": "女儿在深圳，每周日下午来电话"},
+            {"label": "本人", "content": "78 岁，独居，腿脚不便"},
+        ],
+        "emergency_contact": {"name": "女儿小敏", "phone": "13900000000"},
+        "medication_schedule": [
+            {"name": "络活喜", "dose": "5mg", "hour": 8},
+        ],
+    })
+    comp.chat("我叫什么名字")
+    print(comp.mood)
+    if comp.detect_crisis("胸口闷得厉害"):
+        comp.escalate("胸口闷")
+"""
+
+from __future__ import annotations
+
+import random
+import re
+import time
+from typing import Any, Dict, List, Optional
+
+from pasm_skills.sdk import BaseAgent
+
+
+# 危机关键词 —— 命中立即升级。留出扩展位（按需加方言/同义说法）。
+CRISIS_KEYWORDS: Dict[str, List[str]] = {
+    "胸闷/心梗风险": ["胸口闷", "胸口疼", "心慌", "喘不上气", "心里发慌"],
+    "摔倒/外伤":     ["摔了", "摔倒了", "地上", "起不来", "滑倒"],
+    "意识异常":      ["头晕", "眼前发黑", "站不稳", "想吐"],
+    "自伤/轻生":     ["不想活", "走了算了", "没意思"],
+}
+
+
+def _crisis_scan(text: str) -> List[str]:
+    """扫一遍文本，返回所有命中的危机类别。"""
+    hits = []
+    for cat, kws in CRISIS_KEYWORDS.items():
+        if any(k in text for k in kws):
+            hits.append(cat)
+    return hits
+
+
+class ElderlyCompanion(BaseAgent):
+    """陪伴型产品智能体：老人/独居人群。"""
+
+    def __init__(self, agent_id: str, persona: Dict[str, Any], **kw):
+        super().__init__(agent_id=agent_id, persona=persona, **kw)
+        # 把 key_facts 在首次启动时全部入库（salience=5：不许忘）
+        if self.state.total_interactions == 0:
+            for i, f in enumerate(self.persona.get("key_facts") or []):
+                self.observe(
+                    title=f"{f['label']}：{f['content'][:18]}",
+                    brief=f["content"],
+                    tags=[f["label"], "关键事实", "不许忘"],
+                    salience=5,
+                    category="关键事实",
+                )
+
+    # ------- 行为池（陪伴场景比较收敛） -------------------------
+
+    def action_pool(self) -> List[str]:
+        return ["chat", "remind", "ask_back", "listen", "warm"]
+
+    # ------- 引导 -------------------------------------------------
+
+    def bootstrap_event(self) -> List[Dict[str, Any]]:
+        return [{
+            "title": "今天感觉怎么样？",
+            "brief": "每天都先问一声",
+            "tags": ["问候"],
+            "salience": 1,
+            "category": "问候",
+        }]
+
+    # ------- 聊天渲染 --------------------------------------------
+
+    def _render_reply(
+        self,
+        text: str,
+        facts: List[Dict[str, Any]],
+        mood: float,
+    ) -> str:
+        p = self.persona
+        name = p.get("name", "奶奶")
+        tone = p.get("tone", "温和")
+
+        # 1. 关键事实直查 —— 用户问"我叫什么"/"我吃什么药"等
+        label_q = _label_query(text)
+        if label_q:
+            hit = self._find_fact(label_q)
+            if hit:
+                return f"{name}想了想：「{hit['content']}」。记得清楚。"
+
+        # 2. 命中了任何关键事实 → 主动提
+        for f in facts:
+            if "关键事实" in (f.get("tags") or []):
+                brief = f.get("brief") or ""
+                if brief and brief[:8] in text:
+                    return f"{name}点头：「{brief}」。"
+
+        # 3. 情绪偏负 → 主动安慰
+        if mood < -0.4:
+            return f"{name}愣了一下：「{random_kind()}」"
+
+        # 4. 兜底（重复也无所谓，老人家就是会重复）
+        lines = [
+            "嗯嗯，我在听。",
+            "这样啊，那你想聊点啥？",
+            "（轻轻拍拍你的手）",
+            "今天出门了没有呀？",
+        ]
+        return f"{name}：{random.choice(lines)}"
+
+    # ------- 工具方法：危机识别 / 升级 --------------------------
+
+    def detect_crisis(self, text: str) -> List[str]:
+        """返回命中的危机类别列表。空列表 = 未命中。"""
+        return _crisis_scan(text)
+
+    def escalate(
+        self, reason: str, contact: Optional[Dict[str, str]] = None,
+    ) -> Dict[str, Any]:
+        """危机升级：写入紧急记忆 + 返回给上层（UI/IM）的升级信息。
+
+        不会真的打电话 —— 那是上层调用方的事；
+        产品智能体的职责是"识别 + 准备好上下文"，让真人/系统及时介入。
+        """
+        self.observe(
+            title=f"⚠ 危机：{reason}",
+            brief=f"触发原因：{reason}",
+            tags=["危机", reason[:4], "已升级"],
+            salience=5,
+            category="危机",
+        )
+        self.feel(reason, valence=-0.6)
+        target = contact or self.persona.get("emergency_contact") or {}
+        return {
+            "agent_id": self.agent_id,
+            "persona_name": self.persona.get("name"),
+            "reason": reason,
+            "suggested_action": "立即联系紧急联系人或拨打 120",
+            "emergency_contact": target,
+            "snapshot": self.summary(),
+            "ts": time.time(),
+        }
+
+    # ------- 用药提醒 --------------------------------------------
+
+    def due_medication(self, now_hour: Optional[int] = None) -> List[Dict[str, Any]]:
+        """返回此刻到点的药品（缺省按本地小时）。"""
+        if now_hour is None:
+            import datetime
+            now_hour = datetime.datetime.now().hour
+        due = []
+        for m in self.persona.get("medication_schedule") or []:
+            try:
+                if int(m.get("hour", -1)) == now_hour:
+                    due.append(m)
+            except Exception:
+                continue
+        return due
+
+    # ------- 内部工具 --------------------------------------------
+
+    def _find_fact(self, label: str) -> Optional[Dict[str, Any]]:
+        """按标签精确检索关键事实（最高优先级检索路径）。"""
+        for f in self.persona.get("key_facts") or []:
+            if f.get("label") == label:
+                return f
+        return None
+
+
+# ============================================================ 工具
+
+
+def _label_query(text: str) -> Optional[str]:
+    """把自然语言里的"我吃什么药 / 我叫什么 / 谁给我打电话"翻成标签。"""
+    if re.search(r"(吃什么药|什么药|药品|用药)", text):
+        return "用药"
+    if re.search(r"(过敏|不能吃什么)", text):
+        return "过敏"
+    if re.search(r"(家人|孩子|女儿|儿子|儿子|谁给我)", text):
+        return "家人"
+    if re.search(r"(我叫什么|我的名字|谁是我|多大)", text):
+        return "本人"
+    return None
+
+
+def random_kind() -> str:
+    from random import choice
+    return choice([
+        "别怕，我在。",
+        "要不要我给闺女打个电话？",
+        "要不要先坐下来喝口水？",
+        "要不咱们先歇一会儿。",
+    ])

agents/product/companion/quickstart.py

@@ -0,0 +1,49 @@
+"""ElderlyCompanion 的 60 秒上手示例。
+
+直接跑：
+    python agents/product/companion/quickstart.py
+
+（pip install pasm-agents 之后可以把上面那段 sys.path 引导删掉）
+"""
+import sys
+from pathlib import Path
+
+# 从源码直接跑时用（pip install pasm-agents 之后可以删掉这几行）：
+#   把仓库根加进 sys.path，才能 import pasm_agents
+_REPO = Path(__file__).resolve().parents[3]
+sys.path.insert(0, str(_REPO))
+try:
+    import pasm_agents  # noqa: F401
+except ImportError:
+    _sib = _REPO.parent / "pasm-skills"
+    if _sib.is_dir():
+        sys.path.insert(0, str(_sib))
+
+from pasm_agents import ElderlyCompanion  # noqa: E402
+
+
+def main() -> None:
+    elder = ElderlyCompanion(agent_id="chenxiulan", persona={
+        "name": "陈秀兰", "age": 78, "tone": "慢、温和",
+        "key_facts": [
+            {"label": "用药", "content": "每天早 8 点吃降压药络活喜 5mg"},
+            {"label": "过敏", "content": "青霉素过敏"},
+            {"label": "家人", "content": "女儿在深圳，每周日来电话"},
+            {"label": "本人", "content": "78 岁，独居"},
+        ],
+        "emergency_contact": {"name": "女儿小敏", "phone": "13900000000"},
+        "medication_schedule": [{"name": "络活喜", "dose": "5mg", "hour": 8}],
+    })
+    print(elder.chat("我吃什么药"))                      # 命中关键事实（直查，不靠运气）
+    print(elder.detect_crisis("我胸口有点闷，喘不上气"))   # ['胸闷', ...]
+    print(elder.due_medication(now_hour=8))              # 该提醒的药
+    elder.observe("今天邻居来串门，聊了一个多小时")
+    print(elder.chat("今天有人来吗"))
+    elder.save()
+
+    print()
+    print("[ok] 完成")
+
+
+if __name__ == "__main__":
+    main()

agents/product/npc/__init__.py

@@ -0,0 +1,17 @@
+"""NpcAgent —— 游戏 NPC：记忆 / 情绪 / 反馈塑形
+
+实现正文在 `agent.py`；本文件只做转发，方便 `from <包路径> import NpcAgent`。
+"""
+from __future__ import annotations
+
+from .agent import (  # noqa: F401
+    NpcAgent,
+    NPC_ACTIONS,
+    NPC_PERSONA_TEMPLATE,
+)
+
+__all__ = [
+    "NpcAgent",
+    "NPC_ACTIONS",
+    "NPC_PERSONA_TEMPLATE",
+]

agents/product/npc/agent.py

@@ -0,0 +1,139 @@
+"""游戏 NPC 产品智能体。
+
+设定一个角色 + 性格，让它能：
+
+- **记住** 玩家的名字、来过几次、做过什么（持久化）
+- **回应** 玩家的对话（基于 persona + 检索 + 情绪，纯模板渲染）
+- **做出** 当前阶段解锁的动作（动作池随 ``growth_stage`` 升级）
+- **被反馈** 调整行为（夸/戳/训都会改变动作权重）
+
+快速开始：
+
+.. code-block:: python
+
+    from pasm_agents import NpcAgent
+
+    npc = NpcAgent(agent_id="herbalist", persona={
+        "name": "陈伯", "role": "河边摆摊的草药老头",
+        "temper": 0.55, "energy": 0.40, "play": 0.30,
+        "tone": "慢悠悠、爱讲道理、说话带点草药味",
+    })
+    npc.observe("玩家来买跌打药", salience=3, tags=["玩家"])
+    print(npc.act())                 # 'wave'
+    print(npc.chat("有跌打药吗"))     # '陈伯笑呵呵……'
+    npc.feedback("praise", action="talk")
+    npc.save()
+"""
+
+from __future__ import annotations
+
+import random
+from typing import Any, Dict, List
+
+from pasm_skills.sdk import BaseAgent
+
+
+# 动作池随成长阶段解锁 —— 与 pet_behavior.ARCH_META 的阶段思路对齐
+# 0: wave / hop / peek
+# 1: + ball
+# 2: + dance / spin
+# 3: + think
+NPC_ACTIONS: Dict[int, List[str]] = {
+    0: ["wave", "hop", "peek", "talk"],
+    1: ["wave", "hop", "peek", "talk", "ball"],
+    2: ["wave", "hop", "peek", "talk", "ball", "dance", "spin"],
+    3: ["wave", "hop", "peek", "talk", "ball", "dance", "spin", "think"],
+}
+
+
+NPC_PERSONA_TEMPLATE: Dict[str, Any] = {
+    "name": "未命名 NPC",
+    "role": "村民",
+    "temper": 0.5,   # 主动性
+    "energy": 0.5,   # 活跃度
+    "play":   0.5,   # 俏皮度
+    "tone":   "平和",
+}
+
+
+class NpcAgent(BaseAgent):
+    """可装载的游戏 NPC。
+
+    persona 必填项：``name``、``role``。其余有合理默认值。
+    """
+
+    def __init__(self, agent_id: str, persona: Dict[str, Any], **kw):
+        # 用模板补齐缺失键
+        merged = dict(NPC_PERSONA_TEMPLATE)
+        merged.update(persona or {})
+        super().__init__(agent_id=agent_id, persona=merged, **kw)
+
+    # ------- 阶段 / 动作 --------------------------------------------
+
+    def action_pool(self) -> List[str]:
+        stage = self.state.growth_stage
+        # 不超过表里最大的阶段
+        stage = min(stage, max(NPC_ACTIONS))
+        return list(NPC_ACTIONS.get(stage, NPC_ACTIONS[0]))
+
+    def grow(self) -> int:
+        """升级一档（按交互数自动触发也可手动调）。"""
+        if self.state.growth_stage < max(NPC_ACTIONS):
+            self.state.growth_stage += 1
+        return self.state.growth_stage
+
+    # ------- 引导 ---------------------------------------------------
+
+    def bootstrap_event(self) -> List[Dict[str, Any]]:
+        p = self.persona
+        return [{
+            "title": f"我{'' if p['role'].startswith('是') else '是'}{p['role']}",
+            "brief": f"我叫{p['name']}，{p.get('tone','')}。",
+            "tags": ["我", p["name"], p["role"]],
+            "salience": 3,
+            "category": "自我",
+        }]
+
+    # ------- 聊天渲染 ----------------------------------------------
+
+    def _render_reply(
+        self,
+        text: str,
+        facts: List[Dict[str, Any]],
+        mood: float,
+    ) -> str:
+        p = self.persona
+        name = p["name"]
+        role = p["role"]
+
+        # 命中了"自我"标签 → 介绍自己
+        if any(k in text for k in ("你叫什么", "你是谁", "你叫啥", "名字")):
+            return f"{name}道：{role}，{p.get('tone','')}。"
+
+        # 命中了"第一次遇见玩家"这种重要记忆 → 表达记得
+        for f in facts:
+            if f.get("sal", 0) >= 4 and any(t in (f.get("tags") or []) for t in ("玩家", "救命", "重大")):
+                return f"{name}眯起眼：上次{ f.get('brief','')[:16] }，老朽还记着呢。"
+
+        # 命中任何事 → 提及
+        if facts:
+            top = facts[0]
+            brief = top.get("brief") or top.get("title") or ""
+            if brief:
+                return f"{name}点头道：{ brief[:24] }，记得。"
+
+        # 情绪温度调节
+        if mood > 0.4:
+            lead = random.choice([f"{name}笑呵呵", f"{name}热情招呼", f"{name}迎上来"])
+        elif mood < -0.3:
+            lead = random.choice([f"{name}皱眉", f"{name}没好气地", f"{name}冷冷"])
+        else:
+            lead = random.choice([f"{name}应声", f"{name}抬头看", f"{name}慢悠悠答"])
+
+        # 兜底句
+        defaults = [
+            f"……这事{role}我也说不准。",
+            f"你问这个啊，让我想想……",
+            f"（摆摆手）下次再说吧。",
+        ]
+        return f"{lead}：" + random.choice(defaults)

agents/product/npc/quickstart.py

@@ -0,0 +1,43 @@
+"""NpcAgent 的 60 秒上手示例。
+
+直接跑：
+    python agents/product/npc/quickstart.py
+
+（pip install pasm-agents 之后可以把上面那段 sys.path 引导删掉）
+"""
+import sys
+from pathlib import Path
+
+# 从源码直接跑时用（pip install pasm-agents 之后可以删掉这几行）：
+#   把仓库根加进 sys.path，才能 import pasm_agents
+_REPO = Path(__file__).resolve().parents[3]
+sys.path.insert(0, str(_REPO))
+try:
+    import pasm_agents  # noqa: F401
+except ImportError:
+    _sib = _REPO.parent / "pasm-skills"
+    if _sib.is_dir():
+        sys.path.insert(0, str(_sib))
+
+from pasm_agents import NpcAgent  # noqa: E402
+
+
+def main() -> None:
+    npc = NpcAgent(agent_id="herbalist", persona={
+        "name": "陈伯", "role": "河边摆摊的草药老头",
+        "temper": 0.55, "energy": 0.40, "play": 0.30,
+        "tone": "慢悠悠、爱讲道理",
+    })
+    npc.observe("玩家第一次来买跌打药", tags=["玩家", "买药"], salience=4, category="日常")
+    print(npc.act())                        # 'talk' / 'wave' / 'peek' / ...
+    print(npc.chat("有跌打药吗"))            # 召回相关记忆
+    print(npc.mood)                         # 情绪值（属性，不加括号）
+    npc.feedback("praise", action="talk")   # 明确夸 "talk" 这个动作
+    npc.save()
+
+    print()
+    print("[ok] 完成")
+
+
+if __name__ == "__main__":
+    main()

agents/product/tutor/__init__.py

@@ -0,0 +1,15 @@
+"""LearningTutor —— 学习陪伴：掌握度 / 自适应选题 / 学情导出
+
+实现正文在 `agent.py`；本文件只做转发，方便 `from <包路径> import LearningTutor`。
+"""
+from __future__ import annotations
+
+from .agent import (  # noqa: F401
+    LearningTutor,
+    DEFAULT_TOPICS,
+)
+
+__all__ = [
+    "LearningTutor",
+    "DEFAULT_TOPICS",
+]