phone-act-x 1.0.0__tar.gz

phone_act_x-1.0.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: phone-act-x
+Version: 1.0.0
+Summary: 微信视频号私信自动回复引擎 — 贷款业务场景关键词匹配
+Author: phone-act
+License: MIT
+Requires-Python: >=3.10

phone_act_x-1.0.0/phone_act/__init__.py

@@ -0,0 +1,22 @@
+"""
+phone_act — 微信视频号私信自动回复引擎
+=========================================
+
+用法:
+    from phone_act import process, PhoneAct
+
+    # 快捷方式
+    result = process("我征信不好")
+    if result["matched"]:
+        wechat_send(result["reply"])
+
+    # 完整控制
+    bot = PhoneAct()
+    bot.add_rule("欢迎", ["你好"], "您好！")
+    result = bot.process("你好")
+"""
+
+from phone_act.engine import PhoneAct, process, get_bot, clean_text, encode_phone, decode_phone
+
+__version__ = "1.0.0"
+__all__ = ["PhoneAct", "process", "get_bot", "clean_text", "encode_phone", "decode_phone"]

phone_act_x-1.0.0/phone_act/engine.py

@@ -0,0 +1,429 @@
+"""
+phone_act 引擎 — 关键词规则匹配 + 频控 + 手机号编码
+"""
+
+import json
+import os
+import re
+import sys
+import time
+from datetime import datetime, timezone, timedelta
+
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+
+
+def _default_data_dir() -> str:
+    """数据文件目录，优先当前目录，fallback 到包目录"""
+    cwd = os.getcwd()
+    if os.path.isdir(cwd):
+        return cwd
+    return _HERE
+
+
+def _now() -> str:
+    bj = timezone(timedelta(hours=8))
+    return datetime.now(timezone.utc).astimezone(bj).strftime("%Y-%m-%d %H:%M:%S")
+
+
+# ===================================================================
+#  默认规则（贷款业务）
+# ===================================================================
+
+DEFAULT_RULES = [
+    {
+        "id": 1,
+        "name": "联系方式",
+        "keywords": ["怎么联系", "联系方式", "电话", "加你", "加您", "加微信",
+                      "联系你", "联系您", "怎么加", "加个微信", "留个电话"],
+        "match_mode": "any",
+        "reply": "幺捌伍幺叁零陆陆伍柒贰",
+        "enabled": True,
+        "priority": 20,
+    },
+    {
+        "id": 2,
+        "name": "征信不好→问爱人",
+        "keywords": ["征信不好", "征信不太好", "征信不行", "征信差", "征信有问题",
+                      "征信花了", "征信黑", "征信不过", "征信没通过",
+                      "逾期了", "有逾期", "当前逾期", "逾期过"],
+        "match_mode": "any",
+        "reply": "您爱人征信怎么样？",
+        "enabled": True,
+        "priority": 16,
+    },
+    {
+        "id": 3,
+        "name": "征信确认",
+        "keywords": ["征信", "逾期", "信用", "黑户", "失信", "黑名单",
+                      "法院", "执行", "老赖"],
+        "match_mode": "any",
+        "reply": "您征信怎么样？有当前逾期吗？",
+        "enabled": True,
+        "priority": 15,
+    },
+    {
+        "id": 4,
+        "name": "要号码",
+        "keywords": ["然后", "接下来", "怎么操作", "要什么", "资料",
+                      "提供什么", "需要什么", "怎么办"],
+        "match_mode": "any",
+        "reply": "您的号码是多少？",
+        "enabled": True,
+        "priority": 12,
+    },
+    {
+        "id": 5,
+        "name": "贷款咨询",
+        "keywords": ["贷款", "怎么贷", "怎么申请", "能贷多少", "能贷吗",
+                      "借款", "借钱", "办贷款", "做贷款", "放款", "下款",
+                      "利息", "利率", "额度", "怎么弄"],
+        "match_mode": "any",
+        "reply": "您今年多大了？征信怎么样？方便的话我先了解下您的情况。",
+        "enabled": True,
+        "priority": 10,
+    },
+    {
+        "id": 6,
+        "name": "打招呼/求助",
+        "keywords": ["你好", "在吗", "hello", "hi", "在不在", "咨询", "请问",
+                      "帮助", "帮忙", "帮帮我", "急", "着急", "经理", "老师",
+                      "能不能", "可以吗", "行吗"],
+        "match_mode": "any",
+        "reply": "您好！您今年多大了？",
+        "enabled": True,
+        "priority": 5,
+    },
+    {
+        "id": 99,
+        "name": "兜底",
+        "keywords": [],
+        "match_mode": "fallback",
+        "reply": "您好！方便说一下您今年多大了吗？我帮您看看能不能做。",
+        "enabled": True,
+        "priority": 0,
+    },
+]
+
+
+# ===================================================================
+#  工具函数
+# ===================================================================
+
+def clean_text(text: str) -> str:
+    """清洗客户消息：去标点、空格，提高命中率"""
+    text = text.strip()
+    text = re.sub(r"[，。！？、；：“”‘’（）【】《》…—\s]+", "", text)
+    text = re.sub(r"[,\.!\?;:\"'\(\)\[\]{}@#$%^&*+=~`|<>/\\-]+", "", text)
+    return text.lower()
+
+
+_DIGIT_MAP = {
+    "0": "零", "1": "壹", "2": "贰", "3": "叁", "4": "肆",
+    "5": "伍", "6": "陆", "7": "柒", "8": "捌", "9": "玖",
+}
+_REVERSE_MAP = {v: k for k, v in _DIGIT_MAP.items()}
+_REVERSE_MAP["幺"] = "1"
+_REVERSE_MAP["两"] = "2"
+
+
+def encode_phone(phone: str) -> str:
+    """13800138000 → 壹叁捌零零壹叁捌零零零"""
+    return "".join(_DIGIT_MAP.get(d, d) for d in phone)
+
+
+def decode_phone(encoded: str) -> str:
+    """幺捌伍幺叁零陆陆伍柒贰 → 18513066572"""
+    result = []
+    for ch in encoded:
+        d = _REVERSE_MAP.get(ch)
+        if d is not None:
+            result.append(d)
+        elif ch.isdigit():
+            result.append(ch)
+    return "".join(result)
+
+
+# ===================================================================
+#  引擎
+# ===================================================================
+
+
+class PhoneAct:
+    """关键词自动回复引擎"""
+
+    def __init__(self, rules_file: str = None, cooldown: int = 60, max_per_minute: int = 30):
+        self.rules_file = rules_file or os.path.join(_default_data_dir(), "rules.json")
+        self.cooldown = cooldown
+        self.max_per_minute = max_per_minute
+        self._reply_times: dict[str, float] = {}
+        self._minute_count: list[tuple[str, int]] = []
+
+    # ====== 规则管理 ======
+
+    def load_rules(self) -> list[dict]:
+        if not os.path.exists(self.rules_file):
+            self.save_rules(DEFAULT_RULES)
+            return [r for r in DEFAULT_RULES if r.get("enabled", True)]
+        try:
+            with open(self.rules_file, "r", encoding="utf-8") as f:
+                rules = json.load(f)
+        except (json.JSONDecodeError, IOError):
+            rules = DEFAULT_RULES
+        return sorted(
+            [r for r in rules if r.get("enabled", True)],
+            key=lambda r: r.get("priority", 0),
+            reverse=True,
+        )
+
+    def save_rules(self, rules: list[dict]) -> None:
+        with open(self.rules_file, "w", encoding="utf-8") as f:
+            json.dump(rules, f, ensure_ascii=False, indent=2)
+
+    def get_all_rules(self) -> list[dict]:
+        if not os.path.exists(self.rules_file):
+            return list(DEFAULT_RULES)
+        try:
+            with open(self.rules_file, "r", encoding="utf-8") as f:
+                return json.load(f)
+        except (json.JSONDecodeError, IOError):
+            return list(DEFAULT_RULES)
+
+    def add_rule(self, name: str, keywords: list[str], reply: str,
+                 match_mode: str = "any", priority: int = 0) -> dict:
+        rules = self.get_all_rules()
+        new_id = max((r.get("id", 0) for r in rules), default=0) + 1
+        rule = {
+            "id": new_id, "name": name, "keywords": keywords,
+            "match_mode": match_mode, "reply": reply,
+            "enabled": True, "priority": priority,
+        }
+        rules.append(rule)
+        self.save_rules(rules)
+        return rule
+
+    def update_rule(self, rule_id: int, **kwargs) -> dict | None:
+        rules = self.get_all_rules()
+        for r in rules:
+            if r.get("id") == rule_id:
+                r.update(kwargs)
+                self.save_rules(rules)
+                return r
+        return None
+
+    def delete_rule(self, rule_id: int) -> bool:
+        rules = self.get_all_rules()
+        new_rules = [r for r in rules if r.get("id") != rule_id]
+        if len(new_rules) < len(rules):
+            self.save_rules(new_rules)
+            return True
+        return False
+
+    def toggle_rule(self, rule_id: int) -> dict | None:
+        rules = self.get_all_rules()
+        for r in rules:
+            if r.get("id") == rule_id:
+                r["enabled"] = not r.get("enabled", True)
+                self.save_rules(rules)
+                return r
+        return None
+
+    # ====== 消息处理 ======
+
+    def process(self, content: str, from_user: str = "",
+                conversation_id: str = "") -> dict:
+        content = content.strip()
+        if not content:
+            return {"matched": False, "reply": "", "reason": "消息为空"}
+
+        rules = self.load_rules()
+        if not rules:
+            return {"matched": False, "reply": "", "reason": "没有启用的规则"}
+
+        cleaned = clean_text(content)
+        cid = conversation_id or from_user or "default"
+
+        for rule in rules:
+            mode = rule.get("match_mode", "any")
+            reply_text = rule.get("reply", "").strip()
+
+            if mode == "fallback":
+                if not reply_text:
+                    continue
+                if not self._check_rate(cid):
+                    return {"matched": True, "reply": "", "reason": "频控冷却中",
+                            "keyword": "（兜底）", "rule_id": rule["id"]}
+                self._reply_times[cid] = time.time()
+                self._log(content, reply_text, from_user, cid, "（兜底）", rule["id"])
+                return {
+                    "matched": True, "reply": reply_text,
+                    "keyword": "（兜底）", "rule_id": rule["id"],
+                    "rule_name": rule.get("name", ""), "match_mode": "fallback",
+                }
+
+            keywords = rule.get("keywords", [])
+            if not keywords or not reply_text:
+                continue
+
+            kw = self._match(keywords, cleaned, mode, content)
+            if not kw:
+                continue
+
+            if not self._check_rate(cid):
+                return {
+                    "matched": True, "reply": "",
+                    "reason": "冷却中", "keyword": kw, "rule_id": rule["id"],
+                }
+
+            self._reply_times[cid] = time.time()
+            self._log(content, reply_text, from_user, cid, kw, rule["id"])
+            return {
+                "matched": True, "reply": reply_text,
+                "keyword": kw, "rule_id": rule["id"],
+                "rule_name": rule.get("name", ""), "match_mode": mode,
+            }
+
+        self._log(content, "", from_user, cid, "", None)
+        return {"matched": False, "reply": "", "reason": "无匹配规则"}
+
+    def process_batch(self, messages: list[dict]) -> list[dict]:
+        return [self.process(**m) if isinstance(m, dict) else
+                self.process(str(m)) for m in messages]
+
+    # ====== 内部 ======
+
+    @staticmethod
+    def _match(keywords: list[str], cleaned: str, mode: str,
+               original: str = "") -> str | None:
+        if mode == "exact":
+            for kw in keywords:
+                if original.strip() == kw:
+                    return kw
+        elif mode == "all":
+            hits = [kw for kw in keywords if kw in cleaned]
+            return ", ".join(hits) if len(hits) == len(keywords) else None
+        else:
+            for kw in keywords:
+                if kw in cleaned:
+                    return kw
+        return None
+
+    def _check_rate(self, cid: str) -> bool:
+        if cid in self._reply_times:
+            if time.time() - self._reply_times[cid] < self.cooldown:
+                return False
+        return self._check_global_rate()
+
+    def _check_global_rate(self) -> bool:
+        now = time.time()
+        minute_key = time.strftime("%Y%m%d%H%M", time.localtime(now))
+        self._minute_count = [
+            (k, c) for k, c in self._minute_count
+            if now - self._parse_minute_ts(k) < 120
+        ]
+        current = sum(c for k, c in self._minute_count if k == minute_key)
+        if current >= self.max_per_minute:
+            return False
+        for i, (k, c) in enumerate(self._minute_count):
+            if k == minute_key:
+                self._minute_count[i] = (k, c + 1)
+                return True
+        self._minute_count.append((minute_key, 1))
+        return True
+
+    @staticmethod
+    def _parse_minute_ts(key: str) -> float:
+        try:
+            return time.mktime(time.strptime(key, "%Y%m%d%H%M"))
+        except (ValueError, OverflowError):
+            return 0
+
+    def _log(self, content: str, reply: str, from_user: str,
+             conversation_id: str, keyword: str, rule_id: int | None) -> None:
+        log_file = os.path.join(_default_data_dir(), "message_logs.json")
+        entry = {
+            "from_user": from_user,
+            "conversation_id": conversation_id,
+            "content": content[:200],
+            "reply": reply[:200],
+            "keyword": keyword,
+            "rule_id": rule_id,
+            "matched": bool(reply),
+            "time": _now(),
+        }
+        try:
+            with open(log_file, "a", encoding="utf-8") as f:
+                f.write(json.dumps(entry, ensure_ascii=False) + "\n")
+        except IOError:
+            pass
+
+
+# ===================================================================
+#  全局单例
+# ===================================================================
+
+_bot: PhoneAct | None = None
+
+
+def get_bot() -> PhoneAct:
+    global _bot
+    if _bot is None:
+        _bot = PhoneAct()
+    return _bot
+
+
+def process(content: str, from_user: str = "", conversation_id: str = "") -> dict:
+    """快捷函数 — workbuddy 里直接调这个"""
+    return get_bot().process(content, from_user=from_user, conversation_id=conversation_id)
+
+
+# ===================================================================
+#  CLI
+# ===================================================================
+
+def main():
+    """CLI 入口: phone-act '消息'"""
+    bot = PhoneAct()
+
+    if len(sys.argv) > 1:
+        arg = sys.argv[1]
+        if arg in ("-h", "--help"):
+            print("phone-act — 微信视频号私信自动回复")
+            print("用法:")
+            print("  phone-act '消息内容'           匹配消息")
+            print("  echo '消息' | phone-act         管道输入")
+            print("  phone-act --rules              查看所有规则")
+            print("  phone-act --init               生成默认规则文件 rules.json")
+            print("  phone-act --encode 13800138000 手机号编码")
+            sys.exit(0)
+        if arg == "--rules":
+            rules = bot.get_all_rules()
+            print(json.dumps(rules, ensure_ascii=False, indent=2))
+            sys.exit(0)
+        if arg == "--init":
+            bot.save_rules(DEFAULT_RULES)
+            print(f"已生成 rules.json → {bot.rules_file}")
+            sys.exit(0)
+        if arg == "--encode":
+            phone = sys.argv[2] if len(sys.argv) > 2 else ""
+            if phone.isdigit() and len(phone) == 11:
+                print(f"原始: {phone}")
+                print(f"编码: {encode_phone(phone)}")
+            else:
+                print("请输入11位手机号")
+            sys.exit(0)
+        if arg == "--decode":
+            encoded = " ".join(sys.argv[2:]) if len(sys.argv) > 2 else ""
+            if encoded:
+                print(f"解码: {decode_phone(encoded)}")
+            sys.exit(0)
+
+        msg = " ".join(sys.argv[1:])
+    else:
+        msg = sys.stdin.read().strip()
+        if not msg:
+            print("用法: phone-act '消息内容'")
+            sys.exit(0)
+
+    result = bot.process(msg)
+    print(json.dumps(result, ensure_ascii=False, indent=2))

phone_act_x-1.0.0/phone_act_x.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: phone-act-x
+Version: 1.0.0
+Summary: 微信视频号私信自动回复引擎 — 贷款业务场景关键词匹配
+Author: phone-act
+License: MIT
+Requires-Python: >=3.10

phone_act_x-1.0.0/phone_act_x.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+pyproject.toml
+phone_act/__init__.py
+phone_act/engine.py
+phone_act_x.egg-info/PKG-INFO
+phone_act_x.egg-info/SOURCES.txt
+phone_act_x.egg-info/dependency_links.txt
+phone_act_x.egg-info/entry_points.txt
+phone_act_x.egg-info/top_level.txt
+tests/test_phone_act.py

phone_act_x-1.0.0/phone_act_x.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

phone_act_x-1.0.0/phone_act_x.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+phone-act = phone_act.engine:main

phone_act_x-1.0.0/phone_act_x.egg-info/top_level.txt

@@ -0,0 +1 @@
+phone_act

phone_act_x-1.0.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "phone-act-x"
+version = "1.0.0"
+description = "微信视频号私信自动回复引擎 — 贷款业务场景关键词匹配"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [{name = "phone-act"}]
+
+dependencies = []
+
+[project.scripts]
+phone-act = "phone_act.engine:main"
+
+[tool.setuptools.packages.find]
+include = ["phone_act*"]

phone_act_x-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

phone_act_x-1.0.0/tests/test_phone_act.py

@@ -0,0 +1,139 @@
+"""
+phone_act 测试
+运行: cd /Users/yuxia/Desktop/phone-act && python3 -m pytest tests/ -v
+"""
+
+import json
+import os
+import sys
+import tempfile
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from phone_act import PhoneAct, process, clean_text, encode_phone, decode_phone
+
+_passed = 0
+_failed = 0
+
+
+def ok(label: str, result: dict, **expected):
+    global _passed, _failed
+    fail = False
+    for key, val in expected.items():
+        if result.get(key) != val:
+            print(f"  ✗ {label}: {key}={result.get(key)!r}, 期望={val!r}")
+            fail = True
+    if not fail:
+        _passed += 1
+        print(f"  ✓ {label}")
+    else:
+        _failed += 1
+
+
+def eq(label: str, got, expected):
+    global _passed, _failed
+    if got == expected:
+        _passed += 1
+        print(f"  ✓ {label}")
+    else:
+        _failed += 1
+        print(f"  ✗ {label}: got={got!r}, 期望={expected!r}")
+
+
+# ============================================================
+print("【真实客户消息】")
+bot = PhoneAct()
+
+ok("征信没问题 → 征信确认",
+   bot.process("征信没问题。贷款不出", conversation_id="t1"), matched=True, rule_id=3)
+
+ok("征信不好 → 问爱人",
+   bot.process("我征信不好能贷吗", conversation_id="t2"), matched=True, rule_id=2)
+
+ok("有逾期 → 问爱人",
+   bot.process("我有逾期怎么办", conversation_id="t3"), matched=True, rule_id=2)
+
+ok("怎么贷款的 → 贷款咨询",
+   bot.process("你们怎么贷款的", conversation_id="t4"), matched=True, rule_id=5)
+
+ok("怎么联系 → 联系方式",
+   bot.process("怎么联系你", conversation_id="t5"), matched=True, rule_id=1)
+
+ok("你好 → 打招呼",
+   bot.process("你好", conversation_id="t6"), matched=True, rule_id=6)
+
+ok("黑户 → 征信确认",
+   bot.process("我黑户能贷吗", conversation_id="t7"), matched=True, rule_id=3)
+
+ok("帮帮我 → 打招呼",
+   bot.process("帮帮我急用钱", conversation_id="t8"), matched=True, rule_id=6)
+
+ok("然后怎么操作 → 要号码",
+   bot.process("然后怎么操作", conversation_id="t9"), matched=True, rule_id=4)
+
+ok("需要资料 → 要号码",
+   bot.process("需要什么资料", conversation_id="t10"), matched=True, rule_id=4)
+
+ok("留电话 → 联系方式",
+   bot.process("留个电话", conversation_id="t11"), matched=True, rule_id=1)
+
+ok("兜底",
+   bot.process("今天吃了没", conversation_id="t12"), matched=True, rule_id=99)
+
+# ============================================================
+print("\n【频控】")
+bot2 = PhoneAct(cooldown=999)
+r1 = bot2.process("你好", conversation_id="cool1")
+ok("首次回复", r1, matched=True)
+r2 = bot2.process("你好", conversation_id="cool1")
+ok("冷却中", r2, matched=True, reply="")
+r3 = bot2.process("你好", conversation_id="cool2")
+ok("其他用户不受影响", r3, matched=True)
+
+# ============================================================
+print("\n【规则管理】")
+
+with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+    json.dump([], f)
+    rf = f.name
+
+bot3 = PhoneAct(rules_file=rf)
+r = bot3.add_rule("测试", ["测试词"], "测试回复", priority=10)
+ok("添加", r, name="测试")
+ok("匹配", bot3.process("测试词来了", conversation_id="m1"), matched=True, reply="测试回复")
+
+bot3.toggle_rule(r["id"])
+ok("禁用后不匹配", bot3.process("测试词", conversation_id="m2"), matched=False)
+
+bot3.toggle_rule(r["id"])
+ok("重新启用", bot3.process("测试词", conversation_id="m3"), matched=True)
+
+bot3.delete_rule(r["id"])
+ok("删除", bot3.process("测试词", conversation_id="m4"), matched=False)
+
+r2 = bot3.add_rule("更新测试", ["旧词"], "旧回复", priority=10)
+bot3.update_rule(r2["id"], reply="已更新", keywords=["新关键词"])
+ok("更新后", bot3.process("这个新关键词来了", conversation_id="m5"), matched=True, reply="已更新")
+
+os.unlink(rf)
+
+# ============================================================
+print("\n【文本清洗】")
+eq("中文标点", clean_text("你好，在吗？"), "你好在吗")
+eq("混合标点", clean_text("征信没问题。 贷款不出！"), "征信没问题贷款不出")
+
+# ============================================================
+print("\n【手机号编码】")
+eq("编码", encode_phone("18513066572"), "壹捌伍壹叁零陆陆伍柒贰")
+eq("解码", decode_phone("幺捌伍幺叁零陆陆伍柒贰"), "18513066572")
+
+# ============================================================
+print("\n【快捷函数】")
+ok("process()", process("你好", from_user="test", conversation_id="s1"), matched=True)
+
+# ============================================================
+print(f"\n{'='*40}")
+print(f"  通过: {_passed}  失败: {_failed}")
+print(f"{'='*40}")
+
+sys.exit(0 if _failed == 0 else 1)