release: public alpha 0.6.0 baseline

extensions/friends/README.md

@@ -0,0 +1,12 @@
+# Friend Extensions
+
+Reviewed private contributions from trusted friends belong here.
+
+Create a command-extension skeleton with:
+
+```sh
+./tools/create-plugin.py weather-command /weather --author FriendName
+```
+
+Generated code is not approved or activated until tests, manifest validation,
+capability review, and code review pass.

extensions/jwebot/README.md

@@ -0,0 +1,6 @@
+# jwebot
+
+Reviewed local extensions maintained by the JWeBot project. Each independently understandable function is packaged separately; dice and dice challenge intentionally remain one complete feature collection.
+
+Every child directory is generated from the authoritative local extension
+ownership inventory.

extensions/jwebot/coin/README.md

@@ -0,0 +1,17 @@
+# coin
+
+Author: `jwebot`
+
+抛一枚硬币
+
+Help:
+
+- `/翻硬币`
+
+Registered commands:
+
+- `/翻硬币`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `coin` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/coin/plugin.toml

@@ -0,0 +1,14 @@
+id = "coin"
+author = "jwebot"
+description = "抛一枚硬币"
+help = ["/翻硬币"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "coin:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/翻硬币"]
+storage = false
+network_profiles = []
+service_profiles = ["coin"]

extensions/jwebot/coin/src/coin.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for coin."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'coin'
+AUTHOR = 'jwebot'
+DESCRIPTION = '抛一枚硬币'
+HELP_ENTRIES = ('/翻硬币',)
+COMMANDS = ('/翻硬币',)
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/coin/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from coin import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '抛一枚硬币')
+        self.assertEqual(HELP_ENTRIES, ('/翻硬币',))
+        self.assertIn('/翻硬币', registered)
+        self.assertEqual(len(registered), 1)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/daily-fortune/README.md

@@ -0,0 +1,17 @@
+# daily-fortune
+
+Author: `jwebot`
+
+生成当天稳定一致的运势
+
+Help:
+
+- `/今日运势`
+
+Registered commands:
+
+- `/今日运势`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `daily-fortune` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/daily-fortune/plugin.toml

@@ -0,0 +1,14 @@
+id = "daily-fortune"
+author = "jwebot"
+description = "生成当天稳定一致的运势"
+help = ["/今日运势"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "daily_fortune:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/今日运势"]
+storage = false
+network_profiles = []
+service_profiles = ["daily-fortune"]

extensions/jwebot/daily-fortune/src/daily_fortune.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for daily-fortune."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'daily-fortune'
+AUTHOR = 'jwebot'
+DESCRIPTION = '生成当天稳定一致的运势'
+HELP_ENTRIES = ('/今日运势',)
+COMMANDS = ('/今日运势',)
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/daily-fortune/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from daily_fortune import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '生成当天稳定一致的运势')
+        self.assertEqual(HELP_ENTRIES, ('/今日运势',))
+        self.assertIn('/今日运势', registered)
+        self.assertEqual(len(registered), 1)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/dice/README.md

@@ -0,0 +1,21 @@
+# dice
+
+Author: `jwebot`
+
+骰子和多人骰子挑战
+
+Help:
+
+- `/丢骰子 [NdM]`
+- `/丢骰子挑战 [5d6|5d20|状态|结算|战绩|结束]`
+
+Registered commands:
+
+- `/丢骰子`
+- `/骰子`
+- `/丢骰子挑战`
+- `/骰子挑战`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `dice` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/dice/plugin.toml

@@ -0,0 +1,14 @@
+id = "dice"
+author = "jwebot"
+description = "骰子和多人骰子挑战"
+help = ["/丢骰子 [NdM]", "/丢骰子挑战 [5d6|5d20|状态|结算|战绩|结束]"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "dice:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/丢骰子", "/骰子", "/丢骰子挑战", "/骰子挑战"]
+storage = false
+network_profiles = []
+service_profiles = ["dice"]

extensions/jwebot/dice/src/dice.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for dice."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'dice'
+AUTHOR = 'jwebot'
+DESCRIPTION = '骰子和多人骰子挑战'
+HELP_ENTRIES = ('/丢骰子 [NdM]', '/丢骰子挑战 [5d6|5d20|状态|结算|战绩|结束]')
+COMMANDS = ('/丢骰子', '/骰子', '/丢骰子挑战', '/骰子挑战')
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/dice/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from dice import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '骰子和多人骰子挑战')
+        self.assertEqual(HELP_ENTRIES, ('/丢骰子 [NdM]', '/丢骰子挑战 [5d6|5d20|状态|结算|战绩|结束]'))
+        self.assertIn('/丢骰子', registered)
+        self.assertEqual(len(registered), 4)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/draw-lot/README.md

@@ -0,0 +1,17 @@
+# draw-lot
+
+Author: `jwebot`
+
+抽取一条本地签文
+
+Help:
+
+- `/抽签`
+
+Registered commands:
+
+- `/抽签`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `draw-lot` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/draw-lot/plugin.toml

@@ -0,0 +1,14 @@
+id = "draw-lot"
+author = "jwebot"
+description = "抽取一条本地签文"
+help = ["/抽签"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "draw_lot:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/抽签"]
+storage = false
+network_profiles = []
+service_profiles = ["draw-lot"]

extensions/jwebot/draw-lot/src/draw_lot.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for draw-lot."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'draw-lot'
+AUTHOR = 'jwebot'
+DESCRIPTION = '抽取一条本地签文'
+HELP_ENTRIES = ('/抽签',)
+COMMANDS = ('/抽签',)
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/draw-lot/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from draw_lot import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '抽取一条本地签文')
+        self.assertEqual(HELP_ENTRIES, ('/抽签',))
+        self.assertIn('/抽签', registered)
+        self.assertEqual(len(registered), 1)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/guess-number/README.md

@@ -0,0 +1,18 @@
+# guess-number
+
+Author: `jwebot`
+
+群内持久化猜数字游戏
+
+Help:
+
+- `/猜数字 开始 [上限]；/猜 数字；/猜数字 [状态|结束]`
+
+Registered commands:
+
+- `/猜数字`
+- `/猜`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `guess-number` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/guess-number/plugin.toml

@@ -0,0 +1,14 @@
+id = "guess-number"
+author = "jwebot"
+description = "群内持久化猜数字游戏"
+help = ["/猜数字 开始 [上限]；/猜 数字；/猜数字 [状态|结束]"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "guess_number:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/猜数字", "/猜"]
+storage = false
+network_profiles = []
+service_profiles = ["guess-number"]

extensions/jwebot/guess-number/src/guess_number.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for guess-number."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'guess-number'
+AUTHOR = 'jwebot'
+DESCRIPTION = '群内持久化猜数字游戏'
+HELP_ENTRIES = ('/猜数字 开始 [上限]；/猜 数字；/猜数字 [状态|结束]',)
+COMMANDS = ('/猜数字', '/猜')
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/guess-number/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from guess_number import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '群内持久化猜数字游戏')
+        self.assertEqual(HELP_ENTRIES, ('/猜数字 开始 [上限]；/猜 数字；/猜数字 [状态|结束]',))
+        self.assertIn('/猜数字', registered)
+        self.assertEqual(len(registered), 2)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/history-search/README.md

@@ -0,0 +1,18 @@
+# history-search
+
+Author: `jwebot`
+
+搜索本地群聊文字记录
+
+Help:
+
+- `/查记录 关键词`
+
+Registered commands:
+
+- `/查记录`
+- `/历史搜索`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `history-search` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/history-search/plugin.toml

@@ -0,0 +1,14 @@
+id = "history-search"
+author = "jwebot"
+description = "搜索本地群聊文字记录"
+help = ["/查记录 关键词"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "history_search:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/查记录", "/历史搜索"]
+storage = false
+network_profiles = []
+service_profiles = ["history-search"]

extensions/jwebot/history-search/src/history_search.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for history-search."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'history-search'
+AUTHOR = 'jwebot'
+DESCRIPTION = '搜索本地群聊文字记录'
+HELP_ENTRIES = ('/查记录 关键词',)
+COMMANDS = ('/查记录', '/历史搜索')
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/history-search/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from history_search import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '搜索本地群聊文字记录')
+        self.assertEqual(HELP_ENTRIES, ('/查记录 关键词',))
+        self.assertIn('/查记录', registered)
+        self.assertEqual(len(registered), 2)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/random-number/README.md

@@ -0,0 +1,17 @@
+# random-number
+
+Author: `jwebot`
+
+在指定整数范围内取随机数
+
+Help:
+
+- `/随机数 最小值 最大值`
+
+Registered commands:
+
+- `/随机数`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `random-number` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/random-number/plugin.toml

@@ -0,0 +1,14 @@
+id = "random-number"
+author = "jwebot"
+description = "在指定整数范围内取随机数"
+help = ["/随机数 最小值 最大值"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "random_number:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/随机数"]
+storage = false
+network_profiles = []
+service_profiles = ["random-number"]

extensions/jwebot/random-number/src/random_number.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for random-number."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'random-number'
+AUTHOR = 'jwebot'
+DESCRIPTION = '在指定整数范围内取随机数'
+HELP_ENTRIES = ('/随机数 最小值 最大值',)
+COMMANDS = ('/随机数',)
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/random-number/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from random_number import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '在指定整数范围内取随机数')
+        self.assertEqual(HELP_ENTRIES, ('/随机数 最小值 最大值',))
+        self.assertIn('/随机数', registered)
+        self.assertEqual(len(registered), 1)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/repeat-ranking/README.md

@@ -0,0 +1,18 @@
+# repeat-ranking
+
+Author: `jwebot`
+
+查看北京时间今日复读排行
+
+Help:
+
+- `/复读榜`
+
+Registered commands:
+
+- `/复读榜`
+- `/复读`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `repeat-ranking` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/repeat-ranking/plugin.toml

@@ -0,0 +1,14 @@
+id = "repeat-ranking"
+author = "jwebot"
+description = "查看北京时间今日复读排行"
+help = ["/复读榜"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "repeat_ranking:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/复读榜", "/复读"]
+storage = false
+network_profiles = []
+service_profiles = ["repeat-ranking"]

extensions/jwebot/repeat-ranking/src/repeat_ranking.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for repeat-ranking."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'repeat-ranking'
+AUTHOR = 'jwebot'
+DESCRIPTION = '查看北京时间今日复读排行'
+HELP_ENTRIES = ('/复读榜',)
+COMMANDS = ('/复读榜', '/复读')
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/repeat-ranking/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from repeat_ranking import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '查看北京时间今日复读排行')
+        self.assertEqual(HELP_ENTRIES, ('/复读榜',))
+        self.assertIn('/复读榜', registered)
+        self.assertEqual(len(registered), 2)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/rock-paper-scissors/README.md

@@ -0,0 +1,17 @@
+# rock-paper-scissors
+
+Author: `jwebot`
+
+多人石头剪刀布游戏
+
+Help:
+
+- `/石头剪刀布 [开始|加入|出 选择|状态|结算|结束]`
+
+Registered commands:
+
+- `/石头剪刀布`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `rock-paper-scissors` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/rock-paper-scissors/plugin.toml

@@ -0,0 +1,14 @@
+id = "rock-paper-scissors"
+author = "jwebot"
+description = "多人石头剪刀布游戏"
+help = ["/石头剪刀布 [开始|加入|出 选择|状态|结算|结束]"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "rock_paper_scissors:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/石头剪刀布"]
+storage = false
+network_profiles = []
+service_profiles = ["rock-paper-scissors"]

extensions/jwebot/rock-paper-scissors/src/rock_paper_scissors.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for rock-paper-scissors."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'rock-paper-scissors'
+AUTHOR = 'jwebot'
+DESCRIPTION = '多人石头剪刀布游戏'
+HELP_ENTRIES = ('/石头剪刀布 [开始|加入|出 选择|状态|结算|结束]',)
+COMMANDS = ('/石头剪刀布',)
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/rock-paper-scissors/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from rock_paper_scissors import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '多人石头剪刀布游戏')
+        self.assertEqual(HELP_ENTRIES, ('/石头剪刀布 [开始|加入|出 选择|状态|结算|结束]',))
+        self.assertIn('/石头剪刀布', registered)
+        self.assertEqual(len(registered), 1)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/scan-ranking/README.md

@@ -0,0 +1,19 @@
+# scan-ranking
+
+Author: `jwebot`
+
+查看北京时间今日扫码排行
+
+Help:
+
+- `/扫码排行`
+
+Registered commands:
+
+- `/扫码排行`
+- `/扫码榜`
+- `/今日扫码`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `scan-ranking` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/scan-ranking/plugin.toml

@@ -0,0 +1,14 @@
+id = "scan-ranking"
+author = "jwebot"
+description = "查看北京时间今日扫码排行"
+help = ["/扫码排行"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "scan_ranking:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/扫码排行", "/扫码榜", "/今日扫码"]
+storage = false
+network_profiles = []
+service_profiles = ["scan-ranking"]

extensions/jwebot/scan-ranking/src/scan_ranking.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for scan-ranking."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'scan-ranking'
+AUTHOR = 'jwebot'
+DESCRIPTION = '查看北京时间今日扫码排行'
+HELP_ENTRIES = ('/扫码排行',)
+COMMANDS = ('/扫码排行', '/扫码榜', '/今日扫码')
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/scan-ranking/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from scan_ranking import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, '查看北京时间今日扫码排行')
+        self.assertEqual(HELP_ENTRIES, ('/扫码排行',))
+        self.assertIn('/扫码排行', registered)
+        self.assertEqual(len(registered), 3)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/jwebot/steam-presence/README.md

@@ -0,0 +1,17 @@
+# steam-presence
+
+Author: `jwebot`
+
+Steam 状态与时长
+
+Help:
+
+- `/steam；/steam时长 游戏[、玩家]`
+
+Registered commands:
+
+- `/steam`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `steam-presence` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/steam-presence/plugin.toml

@@ -0,0 +1,14 @@
+id = "steam-presence"
+author = "jwebot"
+description = "Steam 状态与时长"
+help = ["/steam；/steam时长 游戏[、玩家]"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "steam_presence:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/steam"]
+storage = false
+network_profiles = []
+service_profiles = ["steam-presence"]

extensions/jwebot/steam-presence/src/steam_presence.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for steam-presence."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'steam-presence'
+AUTHOR = 'jwebot'
+DESCRIPTION = 'Steam 状态与时长'
+HELP_ENTRIES = ('/steam；/steam时长 游戏[、玩家]',)
+COMMANDS = ('/steam',)
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/jwebot/steam-presence/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from steam_presence import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'jwebot')
+        self.assertEqual(DESCRIPTION, 'Steam 状态与时长')
+        self.assertEqual(HELP_ENTRIES, ('/steam；/steam时长 游戏[、玩家]',))
+        self.assertIn('/steam', registered)
+        self.assertEqual(len(registered), 1)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/official/README.md

@@ -0,0 +1,6 @@
+# official
+
+Official-owned reviewed extensions. Person memory is the only official command plugin in the current inventory.
+
+Every child directory is generated from the authoritative local extension
+ownership inventory.

extensions/official/debug-telemetry/README.md

@@ -0,0 +1,17 @@
+# debug-telemetry
+
+Author: `official`
+
+埋点 p50/p95
+
+Help:
+
+- `/debug`
+
+Registered commands:
+
+- `/debug`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `debug-telemetry` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/official/debug-telemetry/plugin.toml

@@ -0,0 +1,14 @@
+id = "debug-telemetry"
+author = "official"
+description = "埋点 p50/p95"
+help = ["/debug"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "debug_telemetry:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/debug"]
+storage = false
+network_profiles = []
+service_profiles = ["debug-telemetry"]

extensions/official/debug-telemetry/src/debug_telemetry.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for debug-telemetry."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'debug-telemetry'
+AUTHOR = 'official'
+DESCRIPTION = '埋点 p50/p95'
+HELP_ENTRIES = ('/debug',)
+COMMANDS = ('/debug',)
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/official/debug-telemetry/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from debug_telemetry import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'official')
+        self.assertEqual(DESCRIPTION, '埋点 p50/p95')
+        self.assertEqual(HELP_ENTRIES, ('/debug',))
+        self.assertIn('/debug', registered)
+        self.assertEqual(len(registered), 1)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/official/jwebot-version/README.md

@@ -0,0 +1,17 @@
+# jwebot-version
+
+Author: `official`
+
+JWeBot 版本
+
+Help:
+
+- `/version`
+
+Registered commands:
+
+- `/version`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `jwebot-version` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/official/jwebot-version/plugin.toml

@@ -0,0 +1,14 @@
+id = "jwebot-version"
+author = "official"
+description = "JWeBot 版本"
+help = ["/version"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "jwebot_version:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/version"]
+storage = false
+network_profiles = []
+service_profiles = ["jwebot-version"]

extensions/official/jwebot-version/src/jwebot_version.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for jwebot-version."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'jwebot-version'
+AUTHOR = 'official'
+DESCRIPTION = 'JWeBot 版本'
+HELP_ENTRIES = ('/version',)
+COMMANDS = ('/version',)
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/official/jwebot-version/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from jwebot_version import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'official')
+        self.assertEqual(DESCRIPTION, 'JWeBot 版本')
+        self.assertEqual(HELP_ENTRIES, ('/version',))
+        self.assertIn('/version', registered)
+        self.assertEqual(len(registered), 1)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/official/person-memory/README.md

@@ -0,0 +1,21 @@
+# person-memory
+
+Author: `official`
+
+管理个人和同群人物记忆
+
+Help:
+
+- `/记住 内容；/我的记忆；/忘记 关键词或全部；/人物记忆 [显示名]`
+
+Registered commands:
+
+- `/记住`
+- `/我的记忆`
+- `/忘记`
+- `/人物记忆`
+- `/记忆帮助`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `person-memory` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/official/person-memory/plugin.toml

@@ -0,0 +1,14 @@
+id = "person-memory"
+author = "official"
+description = "管理个人和同群人物记忆"
+help = ["/记住 内容；/我的记忆；/忘记 关键词或全部；/人物记忆 [显示名]"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "person_memory:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/记住", "/我的记忆", "/忘记", "/人物记忆", "/记忆帮助"]
+storage = false
+network_profiles = []
+service_profiles = ["person-memory"]

extensions/official/person-memory/src/person_memory.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for person-memory."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'person-memory'
+AUTHOR = 'official'
+DESCRIPTION = '管理个人和同群人物记忆'
+HELP_ENTRIES = ('/记住 内容；/我的记忆；/忘记 关键词或全部；/人物记忆 [显示名]',)
+COMMANDS = ('/记住', '/我的记忆', '/忘记', '/人物记忆', '/记忆帮助')
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/official/person-memory/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from person_memory import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'official')
+        self.assertEqual(DESCRIPTION, '管理个人和同群人物记忆')
+        self.assertEqual(HELP_ENTRIES, ('/记住 内容；/我的记忆；/忘记 关键词或全部；/人物记忆 [显示名]',))
+        self.assertIn('/记住', registered)
+        self.assertEqual(len(registered), 5)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/official/server-status/README.md

@@ -0,0 +1,18 @@
+# server-status
+
+Author: `official`
+
+服务器状态
+
+Help:
+
+- `/状态；/status`
+
+Registered commands:
+
+- `/状态`
+- `/status`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `server-status` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/official/server-status/plugin.toml

@@ -0,0 +1,14 @@
+id = "server-status"
+author = "official"
+description = "服务器状态"
+help = ["/状态；/status"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "server_status:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/状态", "/status"]
+storage = false
+network_profiles = []
+service_profiles = ["server-status"]

extensions/official/server-status/src/server_status.py

@@ -0,0 +1,37 @@
+"""Generated reviewed adapter for server-status."""
+
+from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+
+
+PROFILE = 'server-status'
+AUTHOR = 'official'
+DESCRIPTION = '服务器状态'
+HELP_ENTRIES = ('/状态；/status',)
+COMMANDS = ('/状态', '/status')
+
+
+def _handler(context: SingleGroupContext, command: str):
+    def handle(event: Event, arguments: str) -> ExtensionResult:
+        response = context.services.call(
+            PROFILE,
+            operation="execute",
+            payload={
+                "command": command,
+                "arguments": arguments,
+                "event": event.to_mapping(),
+            },
+        )
+        text = response.get("text")
+        if not isinstance(text, str) or not text.strip():
+            raise ValueError("local service returned invalid text")
+        return ExtensionResult(
+            reply=ReplyPlan.text(text),
+            metadata={"local_extension": PROFILE, "author": AUTHOR},
+        )
+
+    return handle
+
+
+def plugin(context: SingleGroupContext) -> None:
+    for command in COMMANDS:
+        context.commands.register(command, _handler(context, command))

extensions/official/server-status/tests/test_plugin.py

@@ -0,0 +1,29 @@
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+SOURCE = Path(__file__).resolve().parents[1] / "src"
+sys.path.insert(0, str(SOURCE))
+
+from server_status import AUTHOR, DESCRIPTION, HELP_ENTRIES, plugin
+
+
+class PluginTests(unittest.TestCase):
+    def test_registers_declared_commands_and_author(self):
+        context = mock.Mock()
+        plugin(context)
+        registered = [
+            call.args[0]
+            for call in context.commands.register.call_args_list
+        ]
+        self.assertEqual(AUTHOR, 'official')
+        self.assertEqual(DESCRIPTION, '服务器状态')
+        self.assertEqual(HELP_ENTRIES, ('/状态；/status',))
+        self.assertIn('/状态', registered)
+        self.assertEqual(len(registered), 2)
+
+
+if __name__ == "__main__":
+    unittest.main()