chore: Add PyPI package support for uvx/pip installation (#1764)

* Initial plan

* Add package structure and resource path utilities

- Created langbot/ package with __init__.py and __main__.py entry point
- Added paths utility to find frontend and resource files from package installation
- Updated config loading to use resource paths
- Updated frontend serving to use resource paths
- Added MANIFEST.in for package data inclusion
- Updated pyproject.toml with build system and entry points

Co-authored-by: RockChinQ <45992437+RockChinQ@users.noreply.github.com>

* Add PyPI publishing workflow and update license

- Created GitHub Actions workflow to build frontend and publish to PyPI
- Added license field to pyproject.toml to fix deprecation warning
- Updated .gitignore to exclude build artifacts
- Tested package building successfully

Co-authored-by: RockChinQ <45992437+RockChinQ@users.noreply.github.com>

* Add PyPI installation documentation

- Created PYPI_INSTALLATION.md with detailed installation and usage instructions
- Updated README.md to feature uvx/pip installation as recommended method
- Updated README_EN.md with same changes for English documentation

Co-authored-by: RockChinQ <45992437+RockChinQ@users.noreply.github.com>

* Address code review feedback

- Made package-data configuration more specific to langbot package only
- Improved path detection with caching to avoid repeated file I/O
- Removed sys.path searching which was incorrect for package data
- Removed interactive input() call for non-interactive environment compatibility
- Simplified error messages for version check

Co-authored-by: RockChinQ <45992437+RockChinQ@users.noreply.github.com>

* Fix code review issues

- Use specific exception types instead of bare except
- Fix misleading comments about directory levels
- Remove redundant existence check before makedirs with exist_ok=True
- Use context manager for file opening to ensure proper cleanup

Co-authored-by: RockChinQ <45992437+RockChinQ@users.noreply.github.com>

* Simplify package configuration and document behavioral differences

- Removed redundant package-data configuration, relying on MANIFEST.in
- Added documentation about behavioral differences between package and source installation
- Clarified that include-package-data=true uses MANIFEST.in for data files

Co-authored-by: RockChinQ <45992437+RockChinQ@users.noreply.github.com>

* chore: update pyproject.toml

* chore: try pack templates in langbot/

* chore: update

* chore: update

* chore: update

* chore: update

* chore: update

* chore: adjust dir structure

* chore: fix imports

* fix: read default-pipeline-config.json

* fix: read default-pipeline-config.json

* fix: tests

* ci: publish pypi

* chore: bump version 4.6.0-beta.1 for testing

* chore: add templates/**

* fix: send adapters and requesters icons

* chore: bump version 4.6.0b2 for testing

* chore: add platform field for docker-compose.yaml

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: RockChinQ <45992437+RockChinQ@users.noreply.github.com>
Co-authored-by: Junyan Qin <rockchinq@gmail.com>

src/langbot/pkg/pipeline/resprule/entities.py

@@ -0,0 +1,9 @@
+import pydantic
+
+import langbot_plugin.api.entities.builtin.platform.message as platform_message
+
+
+class RuleJudgeResult(pydantic.BaseModel):
+    matching: bool = False
+
+    replacement: platform_message.MessageChain = None

src/langbot/pkg/pipeline/resprule/resprule.py

@@ -0,0 +1,58 @@
+from __future__ import annotations
+
+
+from . import rule
+
+from .. import stage, entities
+from ...utils import importutil
+
+import langbot_plugin.api.entities.builtin.pipeline.query as pipeline_query
+
+from . import rules
+
+importutil.import_modules_in_pkg(rules)
+
+
+@stage.stage_class('GroupRespondRuleCheckStage')
+class GroupRespondRuleCheckStage(stage.PipelineStage):
+    """群组响应规则检查器
+
+    仅检查群消息是否符合规则。
+    """
+
+    rule_matchers: list[rule.GroupRespondRule]
+    """检查器实例"""
+
+    async def initialize(self, pipeline_config: dict):
+        """初始化检查器"""
+
+        self.rule_matchers = []
+
+        for rule_matcher in rule.preregisetered_rules:
+            rule_inst = rule_matcher(self.ap)
+            await rule_inst.initialize()
+            self.rule_matchers.append(rule_inst)
+
+    async def process(self, query: pipeline_query.Query, stage_inst_name: str) -> entities.StageProcessResult:
+        if query.launcher_type.value != 'group':  # 只处理群消息
+            return entities.StageProcessResult(result_type=entities.ResultType.CONTINUE, new_query=query)
+
+        rules = query.pipeline_config['trigger']['group-respond-rules']
+
+        use_rule = rules
+
+        # TODO revert it
+        # if str(query.launcher_id) in rules:
+        #     use_rule = rules[str(query.launcher_id)]
+
+        for rule_matcher in self.rule_matchers:  # 任意一个匹配就放行
+            res = await rule_matcher.match(str(query.message_chain), query.message_chain, use_rule, query)
+            if res.matching:
+                query.message_chain = res.replacement
+
+                return entities.StageProcessResult(
+                    result_type=entities.ResultType.CONTINUE,
+                    new_query=query,
+                )
+
+        return entities.StageProcessResult(result_type=entities.ResultType.INTERRUPT, new_query=query)

src/langbot/pkg/pipeline/resprule/rule.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+import abc
+import typing
+
+from ...core import app
+from . import entities
+
+import langbot_plugin.api.entities.builtin.platform.message as platform_message
+import langbot_plugin.api.entities.builtin.pipeline.query as pipeline_query
+
+
+preregisetered_rules: list[typing.Type[GroupRespondRule]] = []
+
+
+def rule_class(name: str):
+    def decorator(cls: typing.Type[GroupRespondRule]) -> typing.Type[GroupRespondRule]:
+        cls.name = name
+        preregisetered_rules.append(cls)
+        return cls
+
+    return decorator
+
+
+class GroupRespondRule(metaclass=abc.ABCMeta):
+    """群组响应规则的抽象类"""
+
+    name: str
+
+    ap: app.Application
+
+    def __init__(self, ap: app.Application):
+        self.ap = ap
+
+    async def initialize(self):
+        pass
+
+    @abc.abstractmethod
+    async def match(
+        self,
+        message_text: str,
+        message_chain: platform_message.MessageChain,
+        rule_dict: dict,
+        query: pipeline_query.Query,
+    ) -> entities.RuleJudgeResult:
+        """判断消息是否匹配规则"""
+        raise NotImplementedError

src/langbot/pkg/pipeline/resprule/rules/atbot.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+
+from .. import rule as rule_model
+from .. import entities
+import langbot_plugin.api.entities.builtin.platform.message as platform_message
+import langbot_plugin.api.entities.builtin.pipeline.query as pipeline_query
+
+
+@rule_model.rule_class('at-bot')
+class AtBotRule(rule_model.GroupRespondRule):
+    async def match(
+        self,
+        message_text: str,
+        message_chain: platform_message.MessageChain,
+        rule_dict: dict,
+        query: pipeline_query.Query,
+    ) -> entities.RuleJudgeResult:
+        found = False
+
+        def remove_at(message_chain: platform_message.MessageChain):
+            nonlocal found
+            for component in message_chain.root:
+                if isinstance(component, platform_message.At) and str(component.target) == str(
+                    query.adapter.bot_account_id
+                ):
+                    message_chain.remove(component)
+                    found = True
+                    break
+
+        remove_at(message_chain)
+        remove_at(message_chain)  # 回复消息时会at两次，检查并删除重复的
+
+        return entities.RuleJudgeResult(matching=found, replacement=message_chain)

src/langbot/pkg/pipeline/resprule/rules/prefix.py

@@ -0,0 +1,30 @@
+from .. import rule as rule_model
+from .. import entities
+import langbot_plugin.api.entities.builtin.platform.message as platform_message
+import langbot_plugin.api.entities.builtin.pipeline.query as pipeline_query
+
+
+@rule_model.rule_class('prefix')
+class PrefixRule(rule_model.GroupRespondRule):
+    async def match(
+        self,
+        message_text: str,
+        message_chain: platform_message.MessageChain,
+        rule_dict: dict,
+        query: pipeline_query.Query,
+    ) -> entities.RuleJudgeResult:
+        prefixes = rule_dict['prefix']
+
+        for prefix in prefixes:
+            if message_text.startswith(prefix):
+                # 查找第一个plain元素
+                for me in message_chain:
+                    if isinstance(me, platform_message.Plain):
+                        me.text = me.text[len(prefix) :]
+
+                return entities.RuleJudgeResult(
+                    matching=True,
+                    replacement=message_chain,
+                )
+
+        return entities.RuleJudgeResult(matching=False, replacement=message_chain)

src/langbot/pkg/pipeline/resprule/rules/random.py

@@ -0,0 +1,21 @@
+import random
+
+
+from .. import rule as rule_model
+from .. import entities
+import langbot_plugin.api.entities.builtin.platform.message as platform_message
+import langbot_plugin.api.entities.builtin.pipeline.query as pipeline_query
+
+
+@rule_model.rule_class('random')
+class RandomRespRule(rule_model.GroupRespondRule):
+    async def match(
+        self,
+        message_text: str,
+        message_chain: platform_message.MessageChain,
+        rule_dict: dict,
+        query: pipeline_query.Query,
+    ) -> entities.RuleJudgeResult:
+        random_rate = rule_dict['random']
+
+        return entities.RuleJudgeResult(matching=random.random() < random_rate, replacement=message_chain)

src/langbot/pkg/pipeline/resprule/rules/regexp.py

@@ -0,0 +1,30 @@
+import re
+
+
+from .. import rule as rule_model
+from .. import entities
+import langbot_plugin.api.entities.builtin.platform.message as platform_message
+import langbot_plugin.api.entities.builtin.pipeline.query as pipeline_query
+
+
+@rule_model.rule_class('regexp')
+class RegExpRule(rule_model.GroupRespondRule):
+    async def match(
+        self,
+        message_text: str,
+        message_chain: platform_message.MessageChain,
+        rule_dict: dict,
+        query: pipeline_query.Query,
+    ) -> entities.RuleJudgeResult:
+        regexps = rule_dict['regexp']
+
+        for regexp in regexps:
+            match = re.match(regexp, message_text)
+
+            if match:
+                return entities.RuleJudgeResult(
+                    matching=True,
+                    replacement=message_chain,
+                )
+
+        return entities.RuleJudgeResult(matching=False, replacement=message_chain)