Release beta 2.0.5.1023

CHANGELOG.md

@@ -1,5 +1,173 @@
 # Changelog
 
+## beta 2.0.5.1023 - 2026-10-23 17:16:12
+
+- 21 点胜率显示修复完成：`/摩拉` 里的 21 点战绩现在会和 `/21点 胜率` 使用同一套统计口径。
+- 修复 `/摩拉` 误读旧版通用胜负字段的问题，避免旧抽奖等历史数据污染 21 点胜率展示。
+- 超时认输、主动认输、单人结算和多人牌桌仍统一写入 `blackjack_stats`，本次只调整展示读取来源。
+
+## beta 2.0.4.1023 - 2026-10-23 16:56:33
+
+- 许愿池和 21 点小版本更新完成：`/抽奖` 已并入许愿池，21 点新增群内胜率统计并调整下注上限。
+- 旧 `/抽奖` 返倍玩法合并进许愿池，保留 `/抽奖 金额` 与 `/draw 金额` 入口，使用方式与 `/许愿池 金额` 一致。
+- 许愿池每 1000 摩拉结算 1 愿，单次支持 1000～10000 摩拉，可能获得摩拉回响、扫码概率券、Taffy 发话额度或原石。
+- 许愿池新增公共池水、8 愿无道具保底和池底大愿；游戏记录和 Taffy 摩拉统计会按“许愿池”归档。
+- 21 点单人下注范围调整为 1～2000，多人牌桌下注范围调整为 1～2000；`/21点 胜率` 会展示当前群玩家和 Taffy 的胜/负/平、胜率与净收支。
+
+## beta 2.0.3.1023 - 2026-10-23 16:09:38
+
+- 冷门知识问答小版本更新完成：题库外置为 500 题，并会优先抽取更少出现过的题。
+- 知识问答基础题库迁移到 `jwebot_kernel/data/trivia_questions.json`，运行时启动校验并展开为 500 道选项题。
+- 题库补充更多机制、数值、版本与活动细节题，覆盖反恐精英、顶点英雄、守望先锋、英雄联盟、少女乐团派对、韩流、原神、缪斯学园偶像和我的世界。
+- 出题历史新增 `ask_counts`，每次选题优先从当前主题内出现次数最低的基础题中抽取，并继续避开最近题目。
+- 问答题头新增 `出现次数：N` 标志，复看当前题时也能看到这题已经出现过几次。
+
+## beta 2.0.2.1021 - 2026-10-21 18:11:35
+
+- 上下文追问小版本更新完成：Taffy 现在会优先相信本地游戏状态，并能把短句追评接到上一条 21 点或主动发言。
+- 普通聊天入口新增本地游戏事实抢答：命中“某人在玩什么/现在咋样”等问题时，直接读取本地账本回复，不再排队生成可能互相矛盾的第二条闲聊最终回复。
+- 新增群级 `active_threads` 线程锚点，Taffy 本地命令结果、聊天最终回复和主动广播都会短时记录为当前话题，供“还真是”“胆子大”等短追评优先引用。
+- 上下文打分增强 `active_thread` 标记，并在系统提示中要求模型优先采用 `local_result`/`active_thread` 本地事实，只有多个候选冲突时才追问。
+- 单人和多人 21 点状态现在可被本地摘要复用，回答会包含当前牌局、手牌点数、下注、阶段和轮到谁操作等关键信息。
+
+## beta 2.0.1.1021 - 2026-10-21 17:32:46
+
+- 上下文管理小版本更新完成：Taffy 现在会按发送者、点名对象和游戏结果结构化选取上下文，低置信身份不再写入记忆或执行绑定命令。
+- 聊天生成改用 `STRUCTURED_RECENT_GROUP_CONTEXT`，历史片段带有
+  speaker、route、reason、score 和 tags，避免把不同群友的消息当成同一个人连续发言。
+- 上下文候选扩容并加入本地相关性打分：同发送者、被点名人物、词面重叠、
+  本地游戏/命令结果和追问语义会被优先保留；自指问题默认不混入其他人的历史。
+- Edge 事件和本地上下文历史新增 sender/body confidence、source 和 observed_at
+  持久化；低置信 sender 只保留文本证据，不绑定人物记忆、账户或奖励类命令。
+- Taffy 的可见回复和已送达主动广播会写入上下文历史，后续追问能引用；
+  主动冒泡仍跳过 Taffy 自己的话，避免自我循环。
+
+## beta 2.0.0.1021 - 2026-10-21 16:57:39
+
+- Beta 2.0 架构更新完成：插件 SDK 统一服务适配器上线，本地命令插件联动改为受控服务调用，私聊 shadow 测试保持只观察不发送，安全边界和时延打点一起收口。
+- 新增公开 SDK `ServiceCommandAdapter`，生成插件不再重复手写 service-broker
+  转发逻辑；插件仍只能返回结构化 `ReplyPlan` 和受控 metadata。
+- 同步更新官方本地命令适配器生成器，所有 reviewed command adapter 统一走
+  `ServiceCommandAdapter`，避免插件联动接口漂移。
+- 私聊 shadow 测试继续 fail-closed：只接受显式配置的会话标题哈希，生成
+  `shadow_only=true`、`dispatch_allowed=false` 观察事件，Edge 在路由和账本写入前拒绝。
+- 保留现有多条消息发送策略：Kernel 统一拆分 `multi_text`，逐条视觉确认，并在消息间随机等待
+  0.5 到 1.0 秒，插件不能绕过 GUI 发送链路。
+- 发布前后保留性能基线对比要求，重点观察本地命令、chat ack、direct queue 和
+  extension-host 打点，避免架构封装影响运行时延。
+
+## beta 1.2.8.1019 - 2026-10-19 22:49:30
+
+- 冷门知识问答题库整体重写：改为更偏游戏内机制、数值、版本和活动细节的深度题。
+- Trivia display now allows necessary proper nouns while preferring
+  Chinese-first names such as 中文（English） when a common translation exists.
+
+## beta 1.2.7.1019 - 2026-10-19 22:37:40
+
+- 冷门知识问答新增缪斯学园偶像和我的世界题库，并支持 LoveLive 与 Minecraft 主题别名。
+- LoveLive trivia is limited to μ's-only facts, while displayed trivia content
+  remains localized in Chinese.
+
+## beta 1.2.6.1019 - 2026-10-19 22:26:26
+
+- 冷门知识问答新增少女乐团派对、韩流和原神题库，并支持 `/知识问答 主题` 定向开题。
+- Unknown trivia topics now return the supported topic list, while automatic
+  quiz broadcasts still draw from the full trivia bank.
+
+## beta 1.2.5.1019 - 2026-10-19 22:12:52
+
+- 冷门知识问答题库改为中文展示：题干、选项和解释不再混用英文词。
+- Keep trivia answer letters unchanged while localizing displayed trivia
+  domains, prompts, choices, and explanations.
+
+## beta 1.2.4.1019 - 2026-10-19 18:15:01
+
+- 增强 Taffy 对本地游戏结果的理解：闲聊上下文扩大到 25 轮，并明确标注本地命令结果的发送者和类型。
+- Format local command history as tagged context entries so follow-up phrases
+  like "这一把" can link back to recent blackjack and other game results.
+
+## beta 1.2.3.1019 - 2026-10-19 18:04:57
+
+- 扩大 Taffy 闲聊可读取的上下文窗口：后续回复现在最多参考最近 15 轮相关对话。
+- Increase the default direct-chat context window from 6 to 15 retained turns.
+
+## beta 1.2.2.1019 - 2026-10-19 17:31:56
+
+- 修复本地命令后的闲聊断上下文，新增 `/知识问答` 强制开题，并让多条回复按 0.5～1 秒随机间隔逐条发送。
+- Include non-tool local command results in the follow-up chat context so game
+  and account actions like `/原石祈愿` can be referenced naturally afterward.
+- Exclude utility local commands such as `/version`, `/状态`, `/debug`, and
+  feature-list output from chat context to avoid noisy system details.
+- Add randomized spacing between queued multi-part replies and immediate local
+  multi-reply sends.
+- Add `/知识问答` as a Kernel-owned local command that starts a cold-knowledge
+  quiz immediately while reusing the active five-minute question when one is
+  already running.
+
+## beta 1.2.1.1019 - 2026-10-19 17:23:58
+
+- 修复 Taffy 短句拆分只换行不分条的问题：多句闲聊现在会按多条消息逐条发送。
+- Encode multi-sentence chat replies with the existing multi-reply marker so
+  direct and cloud chat results enter the multi-message delivery path.
+- Split queued delivery helper calls per message part, giving each part a
+  stable per-part event id while preserving structured local command output.
+
+## beta 1.2.0.1019 - 2026-10-19 17:05:47
+
+- 优化 Taffy 群聊语气：回复更短、更像群友，减少 AI 式自我解释，并保留主动插话、冷门问答和更新状态提示。
+- Add a chat-specific reply style layer that removes common AI-like padding,
+  keeps direct unknown-subject clarification, and splits long casual replies
+  into shorter lines.
+- Apply the style rule to direct chat and cloud-agent replies while leaving
+  structured local command output unchanged.
+- This 1.2 release grants each existing account both 200 Mora and
+  1 primogem.
+
+## beta 1.1.2.1019 - 2026-10-19 16:38:10
+
+- 新增低频主动插话、随机冷门知识问答和更新生命周期提示：Taffy 会偶尔自然冒泡，抛出限时答题奖励摩拉，并在停机、上线和更新就绪时主动说明状态。
+- Use recent safe group context to replace some hourly scan slots with an
+  ambient chat message during active daytime windows.
+- Add a 200+ question CS, Apex, Overwatch, and LoL trivia bank with
+  five-minute `/回答 A/B/C/D` answers, recent-question avoidance, and
+  rarity-based Mora rewards.
+- Limit ambient chat with deterministic probability, multi-hour cooldown, and
+  minimum recent-speaker activity so proactive replies feel occasional.
+- Send guarded shutdown and startup lifecycle notices during production
+  cutover before the normal ready-stage update announcement and compensation.
+
+## beta 1.1.1.1016 - 2026-10-16 17:19:45
+
+- 修复扫码加权重复购买只刷新不叠加的问题。
+- Change scan boost semantics to stack each successful purchase as an
+  independent 24-hour +5 weight entry.
+- Preserve legacy boost entries by deriving their 24-hour expiry from their
+  creation time.
+
+## beta 1.1.0.1016 - 2026-10-16 17:04:25
+
+- 修复 OCR 偶发重复识别消耗型命令导致重复回复的问题，并完善摩拉/扫码榜展示。
+- Extend OCR semantic duplicate suppression for resource-mutating local
+  commands so a visible command bubble re-detected after the short 8 second
+  window is still ignored.
+- Keep ordinary local commands on the short duplicate window to avoid blocking
+  intentional repeated game/query commands.
+- Show scan-boost coupon count in `/摩拉`, and make `/扫码榜` list every
+  configured scan candidate plus next-hour scan weights.
+- This major settlement grants each existing account both 200 Mora and
+  1 primogem.
+
+## beta 1.0.5.1016 - 2026-10-16 16:30:44
+
+- 新增原石系统：成就可获得原石，并开放祈愿、扫码加权、Taffy发话和原石榜。
+- Add primogem account state, primogem movement history, wish records, scan
+  boost coupons, Taffy speech credits, scheduled speech delivery, and
+  primogem-source ranking without a SQLite schema migration.
+- Award primogems from blackjack natural 21, blackjack 20-to-21 hit challenges,
+  Taffy blackjack win streaks, and personal consecutive lottery high-hit pairs.
+- Extend post-release settlement so this version grants each existing account
+  both 200 Mora and 1 primogem, and show `/version` update time down to seconds.
+
 ## beta 1.0.4.1016 - 2026-10-16
 
 - 新增版本更新补偿流程：每次生产更新后向所有既有账户发放 200 摩拉，并在目标群发布更新公告。

README.md

@@ -8,12 +8,13 @@ JWeBot 是运行于 Linux 的单群微信自动回复系统。它通过本地 OC
 观察选定的微信窗口，将消息写入持久化 Edge 账本，调用经过审核的命令插件，
 并通过带视觉确认的 GUI 发送链路回复。
 
-当前版本：`beta 1.0.4.1016`，更新日期：2026-10-16。
+当前版本：`beta 2.0.5.1023`，更新时间：2026-10-23 17:16:12。
 
 1.0 Beta 收口了当前稳定功能：本地命令插件、人物与上下文索引、
 Steam 状态与时长查询、虚拟摩拉游戏、多人彩票、21 点、CS Major
 自走棋、生产部署与回滚门禁。CS Major 自走棋的选手、教练、叙事和规则
-已经外置为包内 JSON，虚拟摩拉支持转账、贷款、还款和群内排行榜。
+已经外置为包内 JSON，知识问答题库也以 500 题 JSON 数据随 Kernel
+发布，虚拟摩拉支持转账、贷款、还款和群内排行榜。
 
 完整命令见[命令目录](docs/command-catalog.md)。历史版本记录见
 [CHANGELOG](CHANGELOG.md)。
@@ -82,13 +83,16 @@ PATH="$PWD/.venv/bin:$PATH" ./tools/check-local.sh
 /功能列表
 /上下文 [100|200|300]（/context）
 /人物列表 [页码]（/people）；/人物 [名称或别名]（/person）
-/摩拉（兼容 /金币、/wallet）；/抽奖 [金额]（/draw）
+/摩拉（兼容 /金币、/wallet）；/许愿池 金额（兼 /许愿、/抽奖、/draw）
 /大富翁榜（/摩拉排行，兼容 /金币排行）
 /转账 对方 金额（/transfer name amount）
 /贷款 [金额]（/loan amount）；/还款 [金额|全部]（/repay）
 /彩票 开始|报名|当前状态|开奖|取消（/lottery）
-/21点 开始 [1～500]；开局后 /21点 要牌|停牌|状态|结束
+/21点 开始 [1～2000]；开局后 /21点 要牌|停牌|状态|结束；/21点 胜率
 /21点 多人 启动；/21点 加入；/21点 多人 开始；/21点 放200
+/摩拉（兼 /原石）；/原石祈愿；/原石榜；/扫码加权 人名（24小时+5）；/Taffy发话 内容
+/知识问答 [主题]；500 题冷门题库，优先抽取少出现过的题并显示出现次数；支持主题：反恐精英、顶点英雄、守望先锋、英雄联盟、少女乐团派对、韩流、原神、缪斯学园偶像、我的世界；/回答 A
+/游戏记录 [页码]（/gamehistory）
 /游戏记录 [页码]（/gamehistory）
 /游戏帮助（/games）
 /自走棋开始|报名|开赛|状态|档案
@@ -190,7 +194,10 @@ sudo ./deploy/scripts/deploy-jwebot-production.sh /path/to/JWeBot jwebot
 
 部署必须通过微信窗口就绪、队列清空、Edge 健康、SQLite 完整性和自适应
 录制服务重启稳定性检查。切换成功后，部署器按版本幂等地向每个既有账户
-发放 200 摩拉、写入账户流水，并使用当前 changelog 的第一条摘要发布群公告。
+发放摩拉、写入账户流水，并使用当前 changelog 的第一条摘要发布群公告。
+普通小版本发放 200 摩拉；`beta 1.0.5.1016`、`beta 1.1.0.1016`
+和 `beta 1.2.0.1019` 额外发放 1 原石；`beta 2.0.0.1021`
+作为架构级大版本发放 400 摩拉和 2 原石。
 旧 OCR 服务保留安装，但保持禁用。
 
 ### 仓库结构
@@ -265,16 +272,17 @@ visually confirmed GUI bridge.
 Current version:
 
 ```text
-beta 1.0.4.1016
+beta 2.0.5.1023
 ```
 
-Updated: 2026-10-16.
+Updated: 2026-10-23 17:16:12.
 
 The 1.0 Beta baseline consolidates the stable local command set, person and
 context indexes, Steam presence/playtime queries, virtual coin games,
 multiplayer lottery, blackjack, CS Major autochess, and production deployment
-gates. CS Major autochess game content is now packaged as JSON data, and
-virtual coins support transfer, loans, repayment, and group leaderboards.
+gates. CS Major autochess game content and the 500-question trivia bank are
+now packaged as JSON data, and virtual coins support transfer, loans,
+repayment, and group leaderboards.
 
 ## Runtime Flow
 
@@ -455,8 +463,11 @@ sudo ./deploy/scripts/deploy-jwebot-production.sh /path/to/JWeBot jwebot
 The deployer refuses cutover unless the ready-window, empty-queue, Edge health,
 SQLite integrity, and adaptive restart-stability gates pass. Legacy OCR units
 remain installed but disabled. After cutover, version-idempotent release
-settlement grants 200 Mora to every existing account, records the movement,
-and sends the first changelog bullet as the guarded group announcement.
+settlement grants Mora to every existing account, records the movement, and
+sends the first changelog bullet as the guarded group announcement. Ordinary
+patch releases grant 200 Mora. `beta 1.0.5.1016`, `beta 1.1.0.1016`, and
+`beta 1.2.0.1019` also grant 1 primogem once. `beta 2.0.0.1021` is the
+architecture-level major release and grants 400 Mora plus 2 primogems.
 
 ## Repository Map
 

VERSION

@@ -1 +1 @@
-beta 1.0.4.1016
+beta 2.0.5.1023

deploy/scripts/deploy-jwebot-production.sh

@@ -341,6 +341,19 @@ verify_edge_health() {
         'import json,sys; value=json.load(sys.stdin); raise SystemExit(0 if value.get("status") == "ok" else 1)'
 }
 
+send_release_lifecycle_notice() {
+  local stage=$1
+  /usr/sbin/runuser -u "${target_user}" -- /usr/bin/env \
+    HOME="${target_home}" \
+    XDG_RUNTIME_DIR="${user_runtime}" \
+    DBUS_SESSION_BUS_ADDRESS="unix:path=${user_runtime}/bus" \
+    "${runtime_python}" "${source_dir}/jwebot_release_update.py" \
+      --release-file "${source_dir}/VERSION" \
+      --database "${target_edge_state}/edge.sqlite3" \
+      --delivery-helper "${target_runtime}/jwebot_edge_delivery.py" \
+      --lifecycle-stage "${stage}"
+}
+
 render_root_configuration() {
   local output_dir="$1"
   sed \
@@ -471,6 +484,9 @@ jwebot_log "backup ready path=${backup_dir}"
 armed=1
 jwebot_progress 3 8 "stop services"
 jwebot_log "cutover starting"
+jwebot_log "release lifecycle shutdown notice starting"
+send_release_lifecycle_notice shutdown
+jwebot_log "release lifecycle shutdown notice ready"
 user_systemctl stop \
   wechat-ocr-adaptive-recorder.service \
   jwebot-edge.service \
@@ -609,6 +625,10 @@ if [[ -f "${target_edge_state}/edge.sqlite3" ]]; then
 fi
 jwebot_log "database ready quick_check=${db_check:-absent}"
 
+jwebot_log "release lifecycle startup notice starting"
+send_release_lifecycle_notice startup
+jwebot_log "release lifecycle startup notice ready"
+
 jwebot_progress 7 8 "verify backup"
 (
   cd "${backup_dir}"

deploy/scripts/install-wechat-health-watch.sh

@@ -7,6 +7,7 @@ user_unit_source_dir="$source_dir/deploy/systemd/user"
 config_source_dir="$source_dir/packages/jwebot-config/src/jwebot_config"
 sdk_source_dir="$source_dir/packages/jwebot-sdk/src/jwebot_sdk"
 kernel_source_dir="$source_dir/packages/jwebot-kernel/src/jwebot_kernel"
+kernel_data_source_dir="$kernel_source_dir/data"
 official_source_dir="$source_dir/packages/jwebot-official-extensions/src/jwebot_official_extensions"
 official_adapter_source_dir="$official_source_dir/adapters"
 official_autochess_data_source_dir="$official_source_dir/data/cs_autochess"
@@ -358,6 +359,7 @@ install -d -m 0700 \
     "$target_dir/jwebot_config" \
     "$target_dir/jwebot_sdk" \
     "$target_dir/jwebot_kernel" \
+    "$target_dir/jwebot_kernel/data" \
     "$target_dir/jwebot_official_extensions" \
     "$target_dir/jwebot_official_extensions/adapters" \
     "$target_dir/jwebot_official_extensions/data" \
@@ -371,6 +373,10 @@ done
 for path in "$kernel_source_dir"/*.py; do
     install -m 0600 "$path" "$target_dir/jwebot_kernel/$(basename "$path")"
 done
+for path in "$kernel_data_source_dir"/*.json; do
+    [ -e "$path" ] || continue
+    install -m 0600 "$path" "$target_dir/jwebot_kernel/data/$(basename "$path")"
+done
 for path in "$official_source_dir"/*.py; do
     install -m 0600 "$path" "$target_dir/jwebot_official_extensions/$(basename "$path")"
 done

docs/command-catalog.md

@@ -1,6 +1,6 @@
 # JWeBot Command Catalog
 
-Current baseline: `beta 1.0.1.1016`.
+Current baseline: `beta 2.0.0.1021`.
 
 This catalog records the reviewed commands shipped with the built-in local
 extensions. Runtime ownership is frozen at startup from the generated
@@ -12,7 +12,7 @@ descriptor inventory; plugin code delegates to reviewed service profiles.
 |---|---|---|
 | `/功能列表` | `/help` | Show the command list. |
 | `/状态` | `/status` | Show local runtime status. |
-| `/version` | - | Show installed package versions plus the latest changelog date and summary. |
+| `/version` | `/版本` | Show installed package versions plus the latest changelog time and summary. |
 | `/debug` | - | Show privacy-safe telemetry diagnostics. |
 | `/余额` | - | Show configured direct-provider balance status. |
 
@@ -33,7 +33,7 @@ descriptor inventory; plugin code delegates to reviewed service profiles.
 
 | Command | Alias | Purpose |
 |---|---|---|
-| `/扫码排行` | - | Show scan ranking for the current group. |
+| `/扫码排行` | `/扫码榜`, `/今日扫码` | Show all scan candidates, today's counts, and next-hour scan weights for the current group. |
 | `/复读榜` | - | Show repeat ranking for the current group. |
 | `/查记录 关键词` | - | Search local group history by keyword. |
 
@@ -41,26 +41,34 @@ descriptor inventory; plugin code delegates to reviewed service profiles.
 
 | Command | Alias | Purpose |
 |---|---|---|
-| `/摩拉` | `/金币`, `/wallet` | Initialize or show the current person's Mora account. |
+| `/摩拉` | `/金币`, `/原石`, `/wallet` | Initialize or show the current person's Mora and primogem account. |
 | `/大富翁榜 [人数]` | `/摩拉排行`, `/摩拉排行榜`, `/金币排行`, `/金币排行榜`, `/richlist` | Show the group-scoped Mora leaderboard. |
 | `/转账 对方 金额` | `/transfer name amount` | Transfer virtual coins to an initialized group account. |
 | `/贷款 [金额]` | `/loan amount`, `/借款` | Borrow up to 500 virtual coins. |
 | `/还款 [金额|全部]` | `/repay [amount|all]` | Repay an active virtual coin loan. |
-| `/抽奖 [金额]` | `/draw` | Play a single-player prize draw. |
+| `/原石祈愿` | `/祈愿`, `/wish` | Spend 1 primogem to draw 20-10000 Mora with expected value 3600 Mora, with a chance to gain a scan-boost ticket. |
+| `/原石榜 [人数]` | `/primogem榜` | Show the group primogem leaderboard with source details. |
+| `/扫码加权 人名` | `/扫码概率 人名` | Spend a scan-boost ticket or 1 primogem to give that person +5 hourly scan weight for 24 hours. |
+| `/Taffy发话 内容` | `/taffysay content` | Spend Taffy speech credit; 1 primogem converts to 2 credits when needed. |
+| `/Taffy发话 定时 HH:MM 内容` | - | Schedule a Taffy speech through the guarded clock delivery queue. |
+| `/知识问答 [主题]` | - | Start a five-minute cold-knowledge quiz immediately, optionally limited to one supported topic. Supported topics: 反恐精英, 顶点英雄, 守望先锋, 英雄联盟, 少女乐团派对, 韩流, 原神, 缪斯学园偶像, 我的世界. English aliases like `LoveLive` and `Minecraft` are accepted as input. |
+| `/回答 A` | `/answer A` | Answer the active five-minute cold-knowledge quiz for a rarity-based Mora reward. |
+| `/许愿池 金额` | `/许愿`, `/抽奖`, `/draw` | Put 1000-10000 Mora into the wish pool in 1000-Mora units for Mora echoes, scan-boost tickets, Taffy speech credits, primogems, pool jackpot, and pity progress. |
 | `/彩票 开始` | `/lottery start` | Open a multiplayer lottery round. |
 | `/彩票 报名 数字 金额` | `/lottery join` | Join or update a lottery entry. |
 | `/彩票 状态` | `/lottery status` | Show the current lottery round. |
 | `/彩票 开奖` | `/lottery draw` | Host-only draw for the current lottery round. |
 | `/彩票 取消` | `/lottery cancel` | Host-only cancellation with refunds. |
-| `/21点 开始 [1-500]` | `/blackjack start` | Start a blackjack round with the chosen stake. |
+| `/21点 开始 [1-2000]` | `/blackjack start` | Start a blackjack round with the chosen stake. |
 | `/21点 要牌` | `/blackjack hit` | Draw one blackjack card. |
 | `/21点 停牌` | `/blackjack stand` | Stand and settle against the dealer. |
 | `/21点 状态` | `/blackjack status` | Show the current blackjack round. |
 | `/21点 结束` | `/blackjack end` | End the current blackjack round. |
+| `/21点 胜率` | `/blackjack stats` | Show every player and Taffy's group-scoped win rate and net Mora result. |
 | `/21点 多人 启动` | - | Open a Taffy-hosted blackjack table and auto-seat the host. |
 | `/21点 加入` | - | Join the current blackjack table before betting starts. |
 | `/21点 多人 开始` | - | Host-only close joining and start ordered betting prompts. |
-| `/21点 放金额` | - | Place the prompted table stake, 1-10000 coins. |
+| `/21点 放金额` | - | Place the prompted table stake, 1-2000 Mora. |
 | `/游戏记录 [页码]` | `/gamehistory` | Show indexed personal game history. |
 | `/游戏帮助` | `/games` | Show local game rules. |
 

docs/conversation-shadow-testing.md

@@ -0,0 +1,61 @@
+# Private Conversation Shadow Testing
+
+This prototype observes one manually selected private conversation without
+changing the production group workflow.
+
+It is intentionally unable to switch conversations or send replies:
+
+- The recorder never enqueues matching shadow events.
+- Every observation carries `shadow_only=true` and `dispatch_allowed=false`.
+- JWeBot Edge ignores marked observations before routing or persistence.
+- The shadow registry accepts private targets only. The main group cannot be
+  added to it.
+- No setting in the shadow registry can enable delivery.
+
+## Local Configuration
+
+Keep the real file outside the repository:
+
+```text
+~/.config/jwebot/conversation-shadow.json
+```
+
+Example with placeholder values:
+
+```json
+{
+  "format_version": 1,
+  "enabled": true,
+  "targets": [
+    {
+      "key": "test-direct",
+      "kind": "direct",
+      "title_fingerprint": "<64 lowercase SHA-256 characters>",
+      "sender": "<local test label>"
+    }
+  ]
+}
+```
+
+Set `JWEBOT_CONVERSATION_SHADOW_CONFIG` to that absolute path only in a local
+test process. Without the variable, the feature is not imported or enabled.
+
+The title fingerprint is the SHA-256 value returned by
+`title_fingerprint(image)` for a screenshot where the intended conversation is
+selected. It is an opaque routing value, not a trusted contact identity.
+
+## Controlled Test
+
+1. Keep production services unchanged.
+2. Run the recorder in a separate local test state directory.
+3. Select the allowlisted private conversation manually.
+4. Let the first capture establish a baseline.
+5. Send `/状态` or `JWeBot: 测试` from the other account.
+6. Inspect the local history for `shadow_only=true`.
+7. Assert that the OCR queue remains empty and no outgoing bubble appears.
+
+Ordinary private messages are observed but do not set `mention_bot`. Only slash
+commands and the configured wake word are treated as potential triggers.
+
+Do not point this prototype at production state paths and do not add the
+environment variable to a deployed runtime profile.

docs/group-lottery-0.6.3.md

@@ -50,7 +50,7 @@
 
 ## 个人局号与记录
 
-抽奖、彩票和 21 点分别维护本人的游戏局号。第一次参与某种游戏显示
+许愿池、彩票和 21 点分别维护本人的游戏局号。第一次参与某种游戏显示
 `Jacky #1：...`，下一把显示 `Jacky #2：...`。配置别名解析到同一人物时，
 共用同一账户、局号和历史。
 
@@ -58,7 +58,7 @@
 `/gamehistory [page]` 查看最近记录，每页五条。记录包含游戏、个人局号、
 结果、下注、返还和净变化，最多保留最近 50 条。
 
-21 点下注范围同步调整为 1～500。`/21点 开始 100` 只表示本局下注 100；
+21 点下注范围现为 1～2000。`/21点 开始 100` 只表示本局下注 100；
 发牌后再单独发送 `/21点 要牌` 或 `/21点 停牌`。
 
 ## 持久化与并发

docs/local-plugins-0.6.1.md

@@ -11,7 +11,7 @@ OpenClaw；中文、英文命令对应同一实现，英文不区分大小写，
 | coin-ranking | `/大富翁榜`、`/摩拉排行`（兼容 `/金币排行`） | `/richlist` |
 | coin-transfer | `/转账 对方 金额` | `/transfer name amount` |
 | coin-loan | `/贷款 [金额]`、`/还款 [金额\|全部]` | `/loan amount`、`/repay [amount\|all]` |
-| single-player-games | `/抽奖 [金额]` | `/draw [金额]` |
+| single-player-games | `/许愿池 金额`（兼容 `/许愿`、`/抽奖`） | `/draw 金额` |
 | single-player-games | `/彩票 开始/报名/当前状态/开奖/取消` | `/lottery start/join/status/draw/cancel` |
 | single-player-games | `/21点 开始 [金额]`（空格可省略） | `/blackjack start [金额]`（空格可省略） |
 | single-player-games | `/21点 要牌/停牌/状态/结束` | `/blackjack hit/stand/status/end` |
@@ -60,8 +60,9 @@ person_key。相同人物的已配置别名共用摩拉和牌局，其他群使
 ## 虚拟摩拉与游戏管理
 
 每个群内人物首次使用账户时一次性获得 1000 虚拟摩拉。再次查询、
-重启服务或切换已配置别名都不会重复领取。抽奖下注为 2～100，彩票和
-21 点下注为 1～500；余额不足或参数非法不扣款。
+重启服务或切换已配置别名都不会重复领取。许愿池投入为 1000～10000，
+按 1000 摩拉递增；彩票下注为 1～500，21 点下注为 1～2000；
+余额不足或参数非法不扣款。
 
 `/转账 对方 金额` 会把本人的虚拟摩拉转给同群已初始化账户，英文为
 `/transfer name amount`。金额范围 1～100000；不允许给自己转账。
@@ -76,12 +77,14 @@ person_key。相同人物的已配置别名共用摩拉和牌局，其他群使
 调用者账户。榜单按当前摩拉余额降序排列，人数范围 1～20；账户存在
 未还贷款时会在名字后标注贷款本金。
 
-抽奖默认下注 10：5% 概率返还五倍下注，20% 返还两倍，其余无返还。
+`/许愿池 金额` 会把摩拉投入公共许愿池，每 1000 摩拉结算 1 愿；
+`/许愿`、`/抽奖` 和 `/draw` 是同一功能入口。许愿可能获得摩拉回响、
+扫码概率券、Taffy 发话额度、原石或池底大愿，8 愿没有道具类奖励后触发保底。
 alpha 0.6.3 将旧的个人即时彩票替换为群内多人轮次。三位数字顺序无关，
 下注范围 1～500，命中 1/2/3 个分别返还 50%/120%/300%。完整流程见
 [多人彩票与游戏记录](group-lottery-0.6.3.md)。
 
-21 点默认下注 50、范围 1～500。`/21点 开始 100` 表示拿 100 摩拉作为本局下注进场，
+21 点默认下注 50、范围 1～2000。`/21点 开始 100` 表示拿 100 摩拉作为本局下注进场，
 等价的 OCR 紧凑形式是 `/21点开始100`。开局会扣除下注并发两张牌，
 然后根据牌面单独发送 `/21点 要牌` 或 `/21点 停牌`；开局与操作写在
 同一条消息时不会扣款，而会返回分步提示。牌局使用洗牌后的单副 52 张牌，
@@ -93,12 +96,15 @@ alpha 0.6.3 将旧的个人即时彩票替换为群内多人轮次。三位数
 
 多人 21 点使用 `/21点 多人 启动` 创建 Taffy 牌桌，开桌者自动入座。
 其他玩家在下注前用 `/21点 加入` 进入当前牌桌；主持人发送 `/21点 多人 开始`
-后，Taffy 会按座位顺序提示每个人 `/21点 放200` 放筹码，范围 1～10000。
+后，Taffy 会按座位顺序提示每个人 `/21点 放200` 放筹码，范围 1～2000。
 所有玩家下注后统一发牌，轮到本人时用 `/21点 要牌` 或 `/21点 停牌` 操作；
 结算按座位顺序列出每个人的下注、返还、净变化和当前摩拉。
 自然 21 点立即结算，返还 2.5 倍下注向下取整；普通胜利返还两倍，
 平局返还下注，失败不返还。每人最多一局；牌局进行中不接受另一笔
-抽奖或 21 点开局，多人彩票报名仍可独立进行。
+许愿池或 21 点开局，多人彩票报名仍可独立进行。
+
+`/21点 胜率` 会列出当前群所有有已结算记录的玩家，以及 Taffy 的
+胜/负/平、胜率和累计净赚净亏；主动认输和超时计负，牌桌取消不计入统计。
 
 十分钟无有效游戏操作的牌局在下一次账户操作时按认输结束；查询状态
 不延长有效期。主动结束同样按认输处理，不退下注。其他人可以各自

extensions/jwebot/coin-loan/src/coin_loan.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin-loan."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin-loan'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = '贷款'
 HELP_ENTRIES = ('/贷款；/还款',)
 COMMANDS = ('/贷款', '/借款', '/loan', '/borrow', '/还款', '/repay')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/coin-ranking/src/coin_ranking.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin-ranking."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin-ranking'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = '富榜'
 HELP_ENTRIES = ('/大富翁榜',)
 COMMANDS = ('/摩拉排行', '/摩拉排行榜', '/金币排行', '/金币排行榜', '/大富翁榜', '/richlist')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/coin-taffy/src/coin_taffy.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin-taffy."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin-taffy'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = 'Taffy摩拉'
 HELP_ENTRIES = ('/Taffy摩拉（兼容 /Taffy金币）',)
 COMMANDS = ('/Taffy摩拉', '/Taffy金币', '/taffycoins')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/coin-transfer/src/coin_transfer.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin-transfer."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin-transfer'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = '摩拉转账'
 HELP_ENTRIES = ('/转账 对方 金额；/transfer',)
 COMMANDS = ('/转账', '/transfer')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/coin/src/coin.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/cs-major-autochess/src/cs_major_autochess.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for cs-major-autochess."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'cs-major-autochess'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = '自走棋'
 HELP_ENTRIES = ('/自走棋 开始|报名|选',)
 COMMANDS = ('/自走棋', '/cs自走棋', '/autochess', '/选', '/刷新', '/锁定', '/战术', '/升级教练', '/上阵', '/下阵', '/出售', '/阵容', '/赛程', '/结束回合')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for daily-fortune."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'daily-fortune'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/dice/src/dice.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for dice."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'dice'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for draw-lot."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'draw-lot'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/game-history/README.md

@@ -0,0 +1,19 @@
+# game-history
+
+Author: `jwebot`
+
+游戏记录
+
+Help:
+
+- `/游戏记录 /个人记录 /gamehistory`
+
+Registered commands:
+
+- `/游戏记录`
+- `/个人记录`
+- `/gamehistory`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `game-history` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/game-history/plugin.toml

@@ -0,0 +1,14 @@
+id = "game-history"
+author = "jwebot"
+description = "游戏记录"
+help = ["/游戏记录 /个人记录 /gamehistory"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "game_history:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/游戏记录", "/个人记录", "/gamehistory"]
+storage = false
+network_profiles = []
+service_profiles = ["game-history"]

extensions/jwebot/game-history/src/game_history.py

@@ -0,0 +1,18 @@
+"""Generated reviewed adapter for game-history."""
+
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
+
+
+PROFILE = 'game-history'
+AUTHOR = 'jwebot'
+DESCRIPTION = '游戏记录'
+HELP_ENTRIES = ('/游戏记录 /个人记录 /gamehistory',)
+COMMANDS = ('/游戏记录', '/个人记录', '/gamehistory')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
+
+
+def plugin(context: SingleGroupContext) -> None:
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/game-history/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 game_history 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, ('/游戏记录 /个人记录 /gamehistory',))
+        self.assertIn('/游戏记录', registered)
+        self.assertEqual(len(registered), 3)
+
+
+if __name__ == "__main__":
+    unittest.main()

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for guess-number."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'guess-number'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for history-search."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'history-search'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/primogem-economy/README.md

@@ -0,0 +1,25 @@
+# primogem-economy
+
+Author: `jwebot`
+
+原石系统
+
+Help:
+
+- `/原石祈愿 /原石榜；/扫码加权 人；/Taffy发话 [定时HH:MM] 内容`
+
+Registered commands:
+
+- `/原石祈愿`
+- `/祈愿`
+- `/wish`
+- `/原石榜`
+- `/primogem榜`
+- `/扫码加权`
+- `/扫码概率`
+- `/Taffy发话`
+- `/taffysay`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `primogem-economy` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/primogem-economy/plugin.toml

@@ -0,0 +1,14 @@
+id = "primogem-economy"
+author = "jwebot"
+description = "原石系统"
+help = ["/原石祈愿 /原石榜；/扫码加权 人；/Taffy发话 [定时HH:MM] 内容"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "primogem_economy:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/原石祈愿", "/祈愿", "/wish", "/原石榜", "/primogem榜", "/扫码加权", "/扫码概率", "/Taffy发话", "/taffysay"]
+storage = false
+network_profiles = []
+service_profiles = ["primogem-economy"]

extensions/jwebot/primogem-economy/src/primogem_economy.py

@@ -0,0 +1,18 @@
+"""Generated reviewed adapter for primogem-economy."""
+
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
+
+
+PROFILE = 'primogem-economy'
+AUTHOR = 'jwebot'
+DESCRIPTION = '原石系统'
+HELP_ENTRIES = ('/原石祈愿 /原石榜；/扫码加权 人；/Taffy发话 [定时HH:MM] 内容',)
+COMMANDS = ('/原石祈愿', '/祈愿', '/wish', '/原石榜', '/primogem榜', '/扫码加权', '/扫码概率', '/Taffy发话', '/taffysay')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
+
+
+def plugin(context: SingleGroupContext) -> None:
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/primogem-economy/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 primogem_economy 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, ('/原石祈愿 /原石榜；/扫码加权 人；/Taffy发话 [定时HH:MM] 内容',))
+        self.assertIn('/原石祈愿', registered)
+        self.assertEqual(len(registered), 9)
+
+
+if __name__ == "__main__":
+    unittest.main()

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for random-number."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'random-number'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for repeat-ranking."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'repeat-ranking'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for rock-paper-scissors."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'rock-paper-scissors'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for scan-ranking."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'scan-ranking'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/single-player-games/README.md

@@ -6,17 +6,16 @@ Author: `jwebot`
 
 Help:
 
-- `/摩拉（兼容 /金币）/wallet；/游戏记录 /gamehistory`
-- `/抽奖 [金额]；/draw`
-- `/彩票 开始|报名|状态|开奖|取消；/lottery`
-- `/21点 单人开始|要牌|停牌|状态；多人启动|加入|开始|放200`
-- `/游戏帮助；/games`
+- `/摩拉/原石 /许愿池 /彩票 /21点 /游戏帮助`
 
 Registered commands:
 
 - `/摩拉`
 - `/金币`
 - `/wallet`
+- `/原石`
+- `/许愿池`
+- `/许愿`
 - `/抽奖`
 - `/draw`
 - `/彩票`
@@ -25,9 +24,6 @@ Registered commands:
 - `/21点`
 - `/二十一点`
 - `/blackjack`
-- `/游戏记录`
-- `/个人记录`
-- `/gamehistory`
 - `/游戏帮助`
 - `/games`
 

extensions/jwebot/single-player-games/plugin.toml

@@ -1,14 +1,14 @@
 id = "single-player-games"
 author = "jwebot"
 description = "摩拉游戏"
-help = ["/摩拉（兼容 /金币）/wallet；/游戏记录 /gamehistory", "/抽奖 [金额]；/draw", "/彩票 开始|报名|状态|开奖|取消；/lottery", "/21点 单人开始|要牌|停牌|状态；多人启动|加入|开始|放200", "/游戏帮助；/games"]
+help = ["/摩拉/原石 /许愿池 /彩票 /21点 /游戏帮助"]
 version = "1.0.0"
 api_version = "1"
 entrypoint = "single_player_games:plugin"
 type = "command"
 
 [capabilities]
-commands = ["/摩拉", "/金币", "/wallet", "/抽奖", "/draw", "/彩票", "/买彩票", "/lottery", "/21点", "/二十一点", "/blackjack", "/游戏记录", "/个人记录", "/gamehistory", "/游戏帮助", "/games"]
+commands = ["/摩拉", "/金币", "/wallet", "/原石", "/许愿池", "/许愿", "/抽奖", "/draw", "/彩票", "/买彩票", "/lottery", "/21点", "/二十一点", "/blackjack", "/游戏帮助", "/games"]
 storage = false
 network_profiles = []
 service_profiles = ["single-player-games"]

extensions/jwebot/single-player-games/src/single_player_games.py

@@ -1,45 +1,18 @@
 """Generated reviewed adapter for single-player-games."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'single-player-games'
 AUTHOR = 'jwebot'
 DESCRIPTION = '摩拉游戏'
-HELP_ENTRIES = ('/摩拉（兼容 /金币）/wallet；/游戏记录 /gamehistory', '/抽奖 [金额]；/draw', '/彩票 开始|报名|状态|开奖|取消；/lottery', '/21点 单人开始|要牌|停牌|状态；多人启动|加入|开始|放200', '/游戏帮助；/games')
-COMMANDS = ('/摩拉', '/金币', '/wallet', '/抽奖', '/draw', '/彩票', '/买彩票', '/lottery', '/21点', '/二十一点', '/blackjack', '/游戏记录', '/个人记录', '/gamehistory', '/游戏帮助', '/games')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+HELP_ENTRIES = ('/摩拉/原石 /许愿池 /彩票 /21点 /游戏帮助',)
+COMMANDS = ('/摩拉', '/金币', '/wallet', '/原石', '/许愿池', '/许愿', '/抽奖', '/draw', '/彩票', '/买彩票', '/lottery', '/21点', '/二十一点', '/blackjack', '/游戏帮助', '/games')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/single-player-games/tests/test_plugin.py

@@ -20,7 +20,7 @@ class PluginTests(unittest.TestCase):
         ]
         self.assertEqual(AUTHOR, 'jwebot')
         self.assertEqual(DESCRIPTION, '摩拉游戏')
-        self.assertEqual(HELP_ENTRIES, ('/摩拉（兼容 /金币）/wallet；/游戏记录 /gamehistory', '/抽奖 [金额]；/draw', '/彩票 开始|报名|状态|开奖|取消；/lottery', '/21点 单人开始|要牌|停牌|状态；多人启动|加入|开始|放200', '/游戏帮助；/games'))
+        self.assertEqual(HELP_ENTRIES, ('/摩拉/原石 /许愿池 /彩票 /21点 /游戏帮助',))
         self.assertIn('/摩拉', registered)
         self.assertEqual(len(registered), 16)
 

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for steam-presence."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'steam-presence'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/trivia-quiz/README.md

@@ -0,0 +1,18 @@
+# trivia-quiz
+
+Author: `jwebot`
+
+冷门知识问答
+
+Help:
+
+- `/回答 A；/answer A`
+
+Registered commands:
+
+- `/回答`
+- `/answer`
+
+The adapter has no direct Ledger, GUI, environment, shell, or network access.
+It delegates to the reviewed `trivia-quiz` Kernel service profile
+and returns a structured `ReplyPlan`.

extensions/jwebot/trivia-quiz/plugin.toml

@@ -0,0 +1,14 @@
+id = "trivia-quiz"
+author = "jwebot"
+description = "冷门知识问答"
+help = ["/回答 A；/answer A"]
+version = "1.0.0"
+api_version = "1"
+entrypoint = "trivia_quiz:plugin"
+type = "command"
+
+[capabilities]
+commands = ["/回答", "/answer"]
+storage = false
+network_profiles = []
+service_profiles = ["trivia-quiz"]

extensions/jwebot/trivia-quiz/src/trivia_quiz.py

@@ -0,0 +1,18 @@
+"""Generated reviewed adapter for trivia-quiz."""
+
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
+
+
+PROFILE = 'trivia-quiz'
+AUTHOR = 'jwebot'
+DESCRIPTION = '冷门知识问答'
+HELP_ENTRIES = ('/回答 A；/answer A',)
+COMMANDS = ('/回答', '/answer')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
+
+
+def plugin(context: SingleGroupContext) -> None:
+    ADAPTER.register(context, COMMANDS)

extensions/jwebot/trivia-quiz/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 trivia_quiz 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, ('/回答 A；/answer A',))
+        self.assertIn('/回答', registered)
+        self.assertEqual(len(registered), 2)
+
+
+if __name__ == "__main__":
+    unittest.main()

extensions/official/context-summary/src/context_summary.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for context-summary."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'context-summary'
@@ -8,38 +8,11 @@ AUTHOR = 'official'
 DESCRIPTION = '上下文总结'
 HELP_ENTRIES = ('/上下文 [100|200|300]；/context [100|200|300]',)
 COMMANDS = ('/上下文', '/context')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for debug-telemetry."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'debug-telemetry'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

extensions/official/jwebot-version/README.md

@@ -6,10 +6,11 @@ JWeBot 版本
 
 Help:
 
-- `/version`
+- `/version /版本`
 
 Registered commands:
 
+- `/版本`
 - `/version`
 
 The adapter has no direct Ledger, GUI, environment, shell, or network access.

extensions/official/jwebot-version/plugin.toml

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

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

@@ -1,45 +1,18 @@
 """Generated reviewed adapter for jwebot-version."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+HELP_ENTRIES = ('/version /版本',)
+COMMANDS = ('/版本', '/version')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -20,9 +20,9 @@ class PluginTests(unittest.TestCase):
         ]
         self.assertEqual(AUTHOR, 'official')
         self.assertEqual(DESCRIPTION, 'JWeBot 版本')
-        self.assertEqual(HELP_ENTRIES, ('/version',))
-        self.assertIn('/version', registered)
-        self.assertEqual(len(registered), 1)
+        self.assertEqual(HELP_ENTRIES, ('/version /版本',))
+        self.assertIn('/版本', registered)
+        self.assertEqual(len(registered), 2)
 
 
 if __name__ == "__main__":

extensions/official/person-directory/README.md

@@ -2,7 +2,7 @@
 
 Author: `official`
 
-查询当前群已配置人物、基本属性和别名
+人物索引
 
 Help:
 

extensions/official/person-directory/plugin.toml

@@ -1,6 +1,6 @@
 id = "person-directory"
 author = "official"
-description = "查询当前群已配置人物、基本属性和别名"
+description = "人物索引"
 help = ["/人物列表 [页码] /people；/人物 [名称或别名] /person"]
 version = "1.0.0"
 api_version = "1"

extensions/official/person-directory/src/person_directory.py

@@ -1,45 +1,18 @@
 """Generated reviewed adapter for person-directory."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'person-directory'
 AUTHOR = 'official'
-DESCRIPTION = '查询当前群已配置人物、基本属性和别名'
+DESCRIPTION = '人物索引'
 HELP_ENTRIES = ('/人物列表 [页码] /people；/人物 [名称或别名] /person',)
 COMMANDS = ('/人物列表', '/别名列表', '/people', '/人物', '/个人属性', '/person')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -19,7 +19,7 @@ class PluginTests(unittest.TestCase):
             for call in context.commands.register.call_args_list
         ]
         self.assertEqual(AUTHOR, 'official')
-        self.assertEqual(DESCRIPTION, '查询当前群已配置人物、基本属性和别名')
+        self.assertEqual(DESCRIPTION, '人物索引')
         self.assertEqual(HELP_ENTRIES, ('/人物列表 [页码] /people；/人物 [名称或别名] /person',))
         self.assertIn('/人物列表', registered)
         self.assertEqual(len(registered), 6)

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for person-memory."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'person-memory'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

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

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for server-status."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'server-status'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

jwebot_release_update.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Apply the mandatory post-release Mora grant and group announcement."""
+"""Apply the mandatory release lifecycle notices, grant, and announcement."""
 
 from __future__ import annotations
 
@@ -26,20 +26,32 @@ sys.path[:0] = [
 from jwebot_official_extensions import __version__ as OFFICIAL_VERSION  # noqa: E402
 from jwebot_official_extensions.player_games import (  # noqa: E402
     append_coin_event,
+    append_primogem_event,
     normalize_player_account,
 )
 
 
 COMPENSATION_AMOUNT = 200
+MORA_COMPENSATION_RELEASES = {
+    "beta 2.0.0.1021": 400,
+}
+PRIMOGEM_COMPENSATION_RELEASES = {
+    "beta 1.0.5.1016": 1,
+    "beta 1.1.0.1016": 1,
+    "beta 1.2.0.1019": 1,
+    "beta 2.0.0.1021": 2,
+}
 MAX_BALANCE = 1_000_000_000
 MAX_SUMMARY_CHARS = 300
 MAX_ANNOUNCEMENT_CHARS = 900
+MAX_LIFECYCLE_CHARS = 300
+LIFECYCLE_STAGES = frozenset({"shutdown", "startup"})
 RELEASE_PATTERN = re.compile(
     r"^beta (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)\.(?P<date>\d{4})$"
 )
 CHANGELOG_HEADING = re.compile(
     r"^##\s+(?P<release>beta \d+\.\d+\.\d+\.\d{4})"
-    r"(?:\s+-\s+\d{4}-\d{2}-\d{2})?\s*$"
+    r"(?:\s+-\s+\d{4}-\d{2}-\d{2}(?:\s+\d{2}:\d{2}:\d{2})?)?\s*$"
 )
 
 
@@ -119,11 +131,14 @@ def read_changelog_summary(path: Path, release: str) -> str:
 
 
 def build_announcement(release: str, summary: str) -> str:
+    mora = mora_compensation_amount(release)
+    primogems = primogem_compensation_amount(release)
+    extra = f"，原石 x{primogems}" if primogems else ""
     announcement = (
         "亲爱的群友：\n"
         f"{release} 更新现已完成。\n"
         f"更新内容：{summary}\n"
-        f"更新补偿：摩拉 x{COMPENSATION_AMOUNT}\n"
+        f"更新补偿：摩拉 x{mora}{extra}\n"
         "补偿范围：截至本公告发布前已创建摩拉账户的玩家\n"
         "发放方式：补偿已直接到账，无需领取\n"
         "感谢大家对 Taffy 的支持与理解，祝大家游戏愉快！"
@@ -133,10 +148,42 @@ def build_announcement(release: str, summary: str) -> str:
     return announcement
 
 
+def build_lifecycle_message(release: str, stage: str) -> str:
+    if stage == "shutdown":
+        if release == "beta 2.0.0.1021":
+            message = (
+                "Taffy 准备停机更新，本次更新是架构级大版本更新，"
+                f"预期版本{release}，离线的时候保持耐心迎接Taffy的归来哦~"
+            )
+        else:
+            message = (
+                f"Taffy 准备停机更新到 {release}，会短暂离线一下；"
+                "别慌，我很快回来喵"
+            )
+    elif stage == "startup":
+        message = (
+            f"Taffy 刚上线，正在做 {release} 的最后自检；"
+            "确认就绪后会发送更新内容和补偿说明喵"
+        )
+    else:
+        raise ReleaseUpdateError(f"unsupported lifecycle stage: {stage}")
+    if len(message) > MAX_LIFECYCLE_CHARS:
+        raise ReleaseUpdateError("release lifecycle message is too long")
+    return message
+
+
 def compensation_key(release: str) -> str:
     return f"release_compensation:{release}"
 
 
+def mora_compensation_amount(release: str) -> int:
+    return int(MORA_COMPENSATION_RELEASES.get(release, COMPENSATION_AMOUNT))
+
+
+def primogem_compensation_amount(release: str) -> int:
+    return int(PRIMOGEM_COMPENSATION_RELEASES.get(release, 0))
+
+
 def announcement_key(release: str, group_fingerprint: str) -> str:
     group_hash = hashlib.sha256(group_fingerprint.encode()).hexdigest()
     return f"release_announcement:{release}:{group_hash}"
@@ -146,7 +193,26 @@ def release_slug(release: str) -> str:
     return re.sub(r"[^a-zA-Z0-9]+", "-", release).strip("-").lower()
 
 
+def release_groups(database_path: Path) -> list[str]:
+    connection = sqlite3.connect(f"file:{database_path}?mode=ro", uri=True)
+    try:
+        if connection.execute("PRAGMA quick_check").fetchone()[0] != "ok":
+            raise ReleaseUpdateError("Edge SQLite integrity check failed")
+        rows = connection.execute(
+            """
+            SELECT DISTINCT group_fingerprint
+            FROM player_accounts
+            ORDER BY group_fingerprint
+            """
+        ).fetchall()
+    finally:
+        connection.close()
+    return [str(row[0]) for row in rows]
+
+
 def checked_marker(raw: str, release: str) -> dict[str, Any]:
+    expected_mora = mora_compensation_amount(release)
+    expected_primogems = primogem_compensation_amount(release)
     try:
         marker = json.loads(raw)
     except json.JSONDecodeError as error:
@@ -154,7 +220,9 @@ def checked_marker(raw: str, release: str) -> dict[str, Any]:
     if (
         not isinstance(marker, dict)
         or marker.get("release") != release
-        or marker.get("amount") != COMPENSATION_AMOUNT
+        or marker.get("amount") != expected_mora
+        or marker.get("mora_amount") not in {None, expected_mora}
+        or marker.get("primogem_amount") not in {None, expected_primogems}
         or not isinstance(marker.get("group_fingerprints"), list)
     ):
         raise ReleaseUpdateError("release compensation marker does not match")
@@ -234,8 +302,12 @@ def apply_compensation(
             ).fetchall()
             groups = sorted({str(row["group_fingerprint"]) for row in rows})
             old_balance_sum = 0
+            old_primogem_sum = 0
+            mora_amount = mora_compensation_amount(release)
+            primogem_amount = primogem_compensation_amount(release)
             timestamp = isoformat_utc(applied_at)
             event_reason = f"{release} 版本更新补偿"
+            primogem_reason = f"{release} 版本更新补偿"
             for row in rows:
                 try:
                     state = json.loads(str(row["state_json"]))
@@ -247,13 +319,24 @@ def apply_compensation(
                 balance = state.get("balance")
                 if (
                     type(balance) is not int
-                    or not 0 <= balance <= MAX_BALANCE - COMPENSATION_AMOUNT
+                    or not 0 <= balance <= MAX_BALANCE - mora_amount
                 ):
                     raise ReleaseUpdateError("Mora account balance is invalid")
                 old_balance_sum += balance
-                state["balance"] = balance + COMPENSATION_AMOUNT
-                append_coin_event(state, COMPENSATION_AMOUNT, event_reason)
+                old_primogem_sum += int(state["primogems"])
+                state["balance"] = balance + mora_amount
+                state["primogems"] += primogem_amount
+                append_coin_event(state, mora_amount, event_reason)
                 state["coin_events"][-1]["created_at"] = applied_at.timestamp()
+                if primogem_amount:
+                    append_primogem_event(
+                        state,
+                        primogem_amount,
+                        primogem_reason,
+                    )
+                    state["primogem_events"][-1]["created_at"] = (
+                        applied_at.timestamp()
+                    )
                 connection.execute(
                     """
                     UPDATE player_accounts
@@ -269,12 +352,18 @@ def apply_compensation(
                 )
             marker = {
                 "release": release,
-                "amount": COMPENSATION_AMOUNT,
+                "amount": mora_amount,
+                "mora_amount": mora_amount,
+                "primogem_amount": primogem_amount,
                 "accounts": len(rows),
                 "group_fingerprints": groups,
                 "old_balance_sum": old_balance_sum,
                 "new_balance_sum": (
-                    old_balance_sum + COMPENSATION_AMOUNT * len(rows)
+                    old_balance_sum + mora_amount * len(rows)
+                ),
+                "old_primogem_sum": old_primogem_sum,
+                "new_primogem_sum": (
+                    old_primogem_sum + primogem_amount * len(rows)
                 ),
                 "applied_at": timestamp,
                 "backup": backup_path.name,
@@ -522,7 +611,8 @@ def run_release_update(
         "status": "ok",
         "release": release,
         "compensation": compensation_state,
-        "amount_each": COMPENSATION_AMOUNT,
+        "amount_each": mora_compensation_amount(release),
+        "primogems_each": primogem_compensation_amount(release),
         "accounts": int(marker["accounts"]),
         "groups": len(groups),
         "announcements_delivered": announcement_result["delivered"],
@@ -531,6 +621,34 @@ def run_release_update(
     }
 
 
+def run_release_lifecycle(
+    *,
+    release_file: Path,
+    database_path: Path,
+    delivery_helper: Path,
+    stage: str,
+    deliverer: Callable[[Path, str, str, str], None] = run_delivery_helper,
+) -> dict[str, Any]:
+    if stage not in LIFECYCLE_STAGES:
+        raise ReleaseUpdateError(f"unsupported lifecycle stage: {stage}")
+    release = read_release(release_file)
+    message = build_lifecycle_message(release, stage)
+    groups = release_groups(database_path)
+    delivered = 0
+    for group in groups:
+        group_hash = hashlib.sha256(group.encode()).hexdigest()[:12]
+        event_id = f"release-{release_slug(release)}-{stage}-{group_hash}"
+        deliverer(delivery_helper, group, message, event_id)
+        delivered += 1
+    return {
+        "status": "ok",
+        "release": release,
+        "stage": stage,
+        "groups": len(groups),
+        "delivered": delivered,
+    }
+
+
 def parse_args() -> argparse.Namespace:
     home = Path.home()
     parser = argparse.ArgumentParser(description=__doc__)
@@ -564,20 +682,33 @@ def parse_args() -> argparse.Namespace:
         action="store_true",
         help="retry only after visually confirming that the prior send did not land",
     )
+    parser.add_argument(
+        "--lifecycle-stage",
+        choices=sorted(LIFECYCLE_STAGES),
+        help="send a guarded lifecycle notice instead of release settlement",
+    )
     return parser.parse_args()
 
 
 def main() -> int:
     args = parse_args()
     try:
-        result = run_release_update(
-            release_file=args.release_file,
-            changelog=args.changelog,
-            database_path=args.database,
-            backup_dir=args.backup_dir,
-            delivery_helper=args.delivery_helper,
-            retry_uncertain=args.retry_uncertain_announcement,
-        )
+        if args.lifecycle_stage:
+            result = run_release_lifecycle(
+                release_file=args.release_file,
+                database_path=args.database,
+                delivery_helper=args.delivery_helper,
+                stage=args.lifecycle_stage,
+            )
+        else:
+            result = run_release_update(
+                release_file=args.release_file,
+                changelog=args.changelog,
+                database_path=args.database,
+                backup_dir=args.backup_dir,
+                delivery_helper=args.delivery_helper,
+                retry_uncertain=args.retry_uncertain_announcement,
+            )
     except ReleaseUpdateError as error:
         print(
             json.dumps(

packages/jwebot-config/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jwebot-config"
-version = "1.0.4b1+1016"
+version = "2.0.5b1+1023"
 description = "Profile-based configuration compiler for JWeBot"
 requires-python = ">=3.9"
 dependencies = [

packages/jwebot-config/src/jwebot_config/__init__.py

@@ -36,4 +36,4 @@ __all__ = [
     "write_default_profile",
 ]
 
-__version__ = "1.0.4b1+1016"
+__version__ = "2.0.5b1+1023"

packages/jwebot-extension-host/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jwebot-extension-host"
-version = "1.0.4b1+1016"
+version = "2.0.5b1+1023"
 description = "Single-release, single-invocation process host for JWeBot extensions"
 requires-python = ">=3.9"
 dependencies = [
-  "jwebot-sdk==1.0.4b1+1016",
-  "jwebot-kernel==1.0.4b1+1016",
+  "jwebot-sdk==2.0.5b1+1023",
+  "jwebot-kernel==2.0.5b1+1023",
 ]
 
 [project.scripts]

packages/jwebot-extension-host/src/jwebot_extension_host/__init__.py

@@ -16,4 +16,4 @@ __all__ = [
     "process_request",
 ]
 
-__version__ = "1.0.4b1+1016"
+__version__ = "2.0.5b1+1023"

packages/jwebot-kernel/pyproject.toml

@@ -4,15 +4,18 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jwebot-kernel"
-version = "1.0.4b1+1016"
+version = "2.0.5b1+1023"
 description = "Stable routing and extension authority for JWeBot"
 requires-python = ">=3.9"
 dependencies = [
-  "jwebot-config==1.0.4b1+1016",
-  "jwebot-sdk==1.0.4b1+1016",
-  "jwebot-official-extensions==1.0.4b1+1016",
+  "jwebot-config==2.0.5b1+1023",
+  "jwebot-sdk==2.0.5b1+1023",
+  "jwebot-official-extensions==2.0.5b1+1023",
   "tomli>=2; python_version < '3.11'",
 ]
 
 [tool.setuptools.packages.find]
 where = ["src"]
+
+[tool.setuptools.package-data]
+jwebot_kernel = ["data/*.json"]

packages/jwebot-kernel/src/jwebot_kernel/__init__.py

@@ -107,4 +107,4 @@ __all__ = [
     "verify_installed_release_signature",
 ]
 
-__version__ = "1.0.4b1+1016"
+__version__ = "2.0.5b1+1023"

packages/jwebot-kernel/src/jwebot_kernel/conversation_scope.py

@@ -0,0 +1,248 @@
+"""Fail-closed conversation identities for local OCR shadow testing."""
+
+from __future__ import annotations
+
+import hashlib
+import json
+import os
+import re
+from dataclasses import dataclass
+from enum import Enum
+from pathlib import Path
+from typing import Any, Mapping
+
+
+SHADOW_CONFIG_ENV = "JWEBOT_CONVERSATION_SHADOW_CONFIG"
+SHADOW_CONFIG_VERSION = 1
+MAX_SHADOW_TARGETS = 8
+MAX_EVENT_TEXT = 5_000
+CONVERSATION_KEY = re.compile(r"^[a-z0-9][a-z0-9._-]{0,63}$")
+TITLE_FINGERPRINT = re.compile(r"^[0-9a-f]{64}$")
+
+
+class ConversationConfigError(ValueError):
+    """Raised when an opt-in shadow conversation registry is invalid."""
+
+
+class ConversationKind(str, Enum):
+    GROUP = "group"
+    DIRECT = "direct"
+
+
+def _required_text(value: object, *, name: str, limit: int) -> str:
+    text = str(value or "").strip()
+    if not text:
+        raise ConversationConfigError(f"{name} is required")
+    if len(text) > limit:
+        raise ConversationConfigError(f"{name} exceeds {limit} characters")
+    return text
+
+
+def _trigger_question(text: str, *, bot_mention: str, direct: bool) -> str:
+    mention_prefix = r"(?:[@＠]\s*)?" if direct else r"[@＠]\s*"
+    mention = re.compile(
+        rf"^\s*{mention_prefix}{re.escape(bot_mention)}"
+        r"(?:\s*[:：,，])?\s*(\S.*)$",
+        re.IGNORECASE,
+    )
+    for line in text.splitlines():
+        stripped = line.strip()
+        if direct and stripped.startswith("/"):
+            return stripped
+        match = mention.match(line)
+        if match:
+            return match.group(1).strip()
+    return ""
+
+
+@dataclass(frozen=True)
+class ConversationTarget:
+    """One explicitly registered title fingerprint in shadow mode."""
+
+    key: str
+    kind: ConversationKind
+    title_fingerprint: str
+    sender: str = ""
+
+    def __post_init__(self) -> None:
+        if not CONVERSATION_KEY.fullmatch(self.key):
+            raise ConversationConfigError("conversation key must be an opaque slug")
+        if not TITLE_FINGERPRINT.fullmatch(self.title_fingerprint):
+            raise ConversationConfigError(
+                "title_fingerprint must be a lowercase SHA-256 digest"
+            )
+        if self.kind is ConversationKind.DIRECT:
+            _required_text(self.sender, name="direct sender", limit=120)
+        elif self.sender:
+            raise ConversationConfigError("group targets cannot define a fixed sender")
+
+    @classmethod
+    def from_mapping(cls, value: Mapping[str, Any]) -> "ConversationTarget":
+        if not isinstance(value, Mapping):
+            raise ConversationConfigError("conversation target must be an object")
+        unknown = set(value) - {
+            "key",
+            "kind",
+            "title_fingerprint",
+            "sender",
+        }
+        if unknown:
+            raise ConversationConfigError("conversation target has unknown fields")
+        try:
+            kind = ConversationKind(str(value.get("kind", "")))
+        except ValueError as error:
+            raise ConversationConfigError("conversation kind is invalid") from error
+        return cls(
+            key=_required_text(value.get("key"), name="conversation key", limit=64),
+            kind=kind,
+            title_fingerprint=_required_text(
+                value.get("title_fingerprint"),
+                name="title_fingerprint",
+                limit=64,
+            ).casefold(),
+            sender=str(value.get("sender", "")).strip(),
+        )
+
+    def question(self, text: str, *, bot_mention: str) -> str:
+        return _trigger_question(
+            text,
+            bot_mention=bot_mention,
+            direct=self.kind is ConversationKind.DIRECT,
+        )
+
+
+@dataclass(frozen=True)
+class ShadowConversationRegistry:
+    """A registry that can observe but can never authorize delivery."""
+
+    enabled: bool = False
+    targets: tuple[ConversationTarget, ...] = ()
+
+    def __post_init__(self) -> None:
+        keys = [target.key for target in self.targets]
+        fingerprints = [target.title_fingerprint for target in self.targets]
+        if len(keys) != len(set(keys)):
+            raise ConversationConfigError("conversation keys must be unique")
+        if len(fingerprints) != len(set(fingerprints)):
+            raise ConversationConfigError("title fingerprints must be unique")
+
+    @classmethod
+    def disabled(cls) -> "ShadowConversationRegistry":
+        return cls()
+
+    @classmethod
+    def from_mapping(cls, value: Mapping[str, Any]) -> "ShadowConversationRegistry":
+        if not isinstance(value, Mapping):
+            raise ConversationConfigError("shadow registry must be an object")
+        unknown = set(value) - {"format_version", "enabled", "targets"}
+        if unknown:
+            raise ConversationConfigError("shadow registry has unknown fields")
+        if value.get("format_version") != SHADOW_CONFIG_VERSION:
+            raise ConversationConfigError("unsupported shadow registry version")
+        enabled = value.get("enabled", False)
+        if not isinstance(enabled, bool):
+            raise ConversationConfigError("shadow registry enabled must be boolean")
+        raw_targets = value.get("targets", [])
+        if not isinstance(raw_targets, list):
+            raise ConversationConfigError("shadow registry targets must be a list")
+        if len(raw_targets) > MAX_SHADOW_TARGETS:
+            raise ConversationConfigError("shadow registry has too many targets")
+        targets = tuple(ConversationTarget.from_mapping(item) for item in raw_targets)
+        if any(target.kind is not ConversationKind.DIRECT for target in targets):
+            raise ConversationConfigError("shadow registry accepts direct targets only")
+        return cls(enabled=enabled, targets=targets)
+
+    @classmethod
+    def from_environment(
+        cls,
+        environment: Mapping[str, str] | None = None,
+    ) -> "ShadowConversationRegistry":
+        source = environment if environment is not None else os.environ
+        raw_path = str(source.get(SHADOW_CONFIG_ENV, "")).strip()
+        if not raw_path:
+            return cls.disabled()
+        path = Path(raw_path).expanduser()
+        if path.is_symlink() or not path.is_file():
+            raise ConversationConfigError("shadow registry path must be a regular file")
+        try:
+            value = json.loads(path.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError) as error:
+            raise ConversationConfigError("shadow registry cannot be read") from error
+        if not isinstance(value, Mapping):
+            raise ConversationConfigError("shadow registry must be an object")
+        return cls.from_mapping(value)
+
+    def target_for_fingerprint(
+        self,
+        fingerprint: str,
+    ) -> ConversationTarget | None:
+        if not self.enabled:
+            return None
+        normalized = str(fingerprint).casefold()
+        return next(
+            (
+                target
+                for target in self.targets
+                if target.title_fingerprint == normalized
+            ),
+            None,
+        )
+
+
+def build_shadow_event(
+    target: ConversationTarget,
+    *,
+    observed_at: str,
+    text: str,
+    body_confidence: float,
+    visual_signature: str,
+    bot_mention: str,
+    observed_sender: str = "",
+    sender_confidence: float = 0.0,
+    ordinal: int = 0,
+) -> dict[str, Any]:
+    """Build a non-dispatchable observation for synthetic and shadow tests."""
+
+    content = _required_text(text, name="event text", limit=MAX_EVENT_TEXT)
+    question = target.question(content, bot_mention=bot_mention)
+    sender = (
+        target.sender
+        if target.kind is ConversationKind.DIRECT
+        else _required_text(observed_sender, name="observed sender", limit=120)
+    )
+    effective_sender_confidence = (
+        1.0
+        if target.kind is ConversationKind.DIRECT
+        else max(0.0, min(1.0, float(sender_confidence)))
+    )
+    effective_body_confidence = max(0.0, min(1.0, float(body_confidence)))
+    seed = (
+        f"{target.key}\n{observed_at}\n{ordinal}\n{visual_signature}\n"
+        f"{sender}\n{content}"
+    )
+    return {
+        "version": 1,
+        "event_id": f"shadow-{hashlib.sha256(seed.encode()).hexdigest()[:24]}",
+        "observed_at": observed_at,
+        "sender": sender,
+        "text": content,
+        "question": question,
+        "confidence": min(
+            effective_sender_confidence,
+            effective_body_confidence,
+        ),
+        "sender_confidence": effective_sender_confidence,
+        "body_confidence": effective_body_confidence,
+        "side": "incoming",
+        "mention_bot": bool(question),
+        "group_fingerprint": target.title_fingerprint,
+        "conversation_key": target.key,
+        "conversation_kind": target.kind.value,
+        "source": (
+            "rapidocr-private-shadow"
+            if target.kind is ConversationKind.DIRECT
+            else "rapidocr-group-shadow"
+        ),
+        "shadow_only": True,
+        "dispatch_allowed": False,
+    }

packages/jwebot-official-extensions/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jwebot-official-extensions"
-version = "1.0.4b1+1016"
+version = "2.0.5b1+1023"
 description = "Reviewed local command adapters and broker implementation for JWeBot"
 requires-python = ">=3.9"
 dependencies = [
-  "jwebot-sdk==1.0.4b1+1016",
+  "jwebot-sdk==2.0.5b1+1023",
 ]
 
 [tool.setuptools.packages.find]

packages/jwebot-official-extensions/src/jwebot_official_extensions/__init__.py

@@ -90,4 +90,4 @@ __all__ = [
     "render_feature_list",
 ]
 
-__version__ = "1.0.4b1+1016"
+__version__ = "2.0.5b1+1023"

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/coin.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/coin_loan.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin-loan."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin-loan'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = '贷款'
 HELP_ENTRIES = ('/贷款；/还款',)
 COMMANDS = ('/贷款', '/借款', '/loan', '/borrow', '/还款', '/repay')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/coin_ranking.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin-ranking."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin-ranking'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = '富榜'
 HELP_ENTRIES = ('/大富翁榜',)
 COMMANDS = ('/摩拉排行', '/摩拉排行榜', '/金币排行', '/金币排行榜', '/大富翁榜', '/richlist')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/coin_taffy.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin-taffy."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin-taffy'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = 'Taffy摩拉'
 HELP_ENTRIES = ('/Taffy摩拉（兼容 /Taffy金币）',)
 COMMANDS = ('/Taffy摩拉', '/Taffy金币', '/taffycoins')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/coin_transfer.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for coin-transfer."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'coin-transfer'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = '摩拉转账'
 HELP_ENTRIES = ('/转账 对方 金额；/transfer',)
 COMMANDS = ('/转账', '/transfer')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/context_summary.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for context-summary."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'context-summary'
@@ -8,38 +8,11 @@ AUTHOR = 'official'
 DESCRIPTION = '上下文总结'
 HELP_ENTRIES = ('/上下文 [100|200|300]；/context [100|200|300]',)
 COMMANDS = ('/上下文', '/context')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/cs_major_autochess.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for cs-major-autochess."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'cs-major-autochess'
@@ -8,38 +8,11 @@ AUTHOR = 'jwebot'
 DESCRIPTION = '自走棋'
 HELP_ENTRIES = ('/自走棋 开始|报名|选',)
 COMMANDS = ('/自走棋', '/cs自走棋', '/autochess', '/选', '/刷新', '/锁定', '/战术', '/升级教练', '/上阵', '/下阵', '/出售', '/阵容', '/赛程', '/结束回合')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/daily_fortune.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for daily-fortune."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'daily-fortune'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/debug_telemetry.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for debug-telemetry."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'debug-telemetry'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/dice.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for dice."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'dice'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/draw_lot.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for draw-lot."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'draw-lot'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/game_history.py

@@ -0,0 +1,18 @@
+"""Generated reviewed adapter for game-history."""
+
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
+
+
+PROFILE = 'game-history'
+AUTHOR = 'jwebot'
+DESCRIPTION = '游戏记录'
+HELP_ENTRIES = ('/游戏记录 /个人记录 /gamehistory',)
+COMMANDS = ('/游戏记录', '/个人记录', '/gamehistory')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
+
+
+def plugin(context: SingleGroupContext) -> None:
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/guess_number.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for guess-number."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'guess-number'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/history_search.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for history-search."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'history-search'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/jwebot_version.py

@@ -1,45 +1,18 @@
 """Generated reviewed adapter for jwebot-version."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+HELP_ENTRIES = ('/version /版本',)
+COMMANDS = ('/版本', '/version')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/person_directory.py

@@ -1,45 +1,18 @@
 """Generated reviewed adapter for person-directory."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'person-directory'
 AUTHOR = 'official'
-DESCRIPTION = '查询当前群已配置人物、基本属性和别名'
+DESCRIPTION = '人物索引'
 HELP_ENTRIES = ('/人物列表 [页码] /people；/人物 [名称或别名] /person',)
 COMMANDS = ('/人物列表', '/别名列表', '/people', '/人物', '/个人属性', '/person')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/person_memory.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for person-memory."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'person-memory'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/primogem_economy.py

@@ -0,0 +1,18 @@
+"""Generated reviewed adapter for primogem-economy."""
+
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
+
+
+PROFILE = 'primogem-economy'
+AUTHOR = 'jwebot'
+DESCRIPTION = '原石系统'
+HELP_ENTRIES = ('/原石祈愿 /原石榜；/扫码加权 人；/Taffy发话 [定时HH:MM] 内容',)
+COMMANDS = ('/原石祈愿', '/祈愿', '/wish', '/原石榜', '/primogem榜', '/扫码加权', '/扫码概率', '/Taffy发话', '/taffysay')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
+
+
+def plugin(context: SingleGroupContext) -> None:
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/random_number.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for random-number."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'random-number'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/repeat_ranking.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for repeat-ranking."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'repeat-ranking'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/rock_paper_scissors.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for rock-paper-scissors."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'rock-paper-scissors'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/scan_ranking.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for scan-ranking."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'scan-ranking'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/server_status.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for server-status."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'server-status'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/single_player_games.py

@@ -1,45 +1,18 @@
 """Generated reviewed adapter for single-player-games."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'single-player-games'
 AUTHOR = 'jwebot'
 DESCRIPTION = '摩拉游戏'
-HELP_ENTRIES = ('/摩拉（兼容 /金币）/wallet；/游戏记录 /gamehistory', '/抽奖 [金额]；/draw', '/彩票 开始|报名|状态|开奖|取消；/lottery', '/21点 单人开始|要牌|停牌|状态；多人启动|加入|开始|放200', '/游戏帮助；/games')
-COMMANDS = ('/摩拉', '/金币', '/wallet', '/抽奖', '/draw', '/彩票', '/买彩票', '/lottery', '/21点', '/二十一点', '/blackjack', '/游戏记录', '/个人记录', '/gamehistory', '/游戏帮助', '/games')
-
-
-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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+HELP_ENTRIES = ('/摩拉/原石 /许愿池 /彩票 /21点 /游戏帮助',)
+COMMANDS = ('/摩拉', '/金币', '/wallet', '/原石', '/许愿池', '/许愿', '/抽奖', '/draw', '/彩票', '/买彩票', '/lottery', '/21点', '/二十一点', '/blackjack', '/游戏帮助', '/games')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/steam_presence.py

@@ -1,6 +1,6 @@
 """Generated reviewed adapter for steam-presence."""
 
-from jwebot_sdk import Event, ExtensionResult, ReplyPlan, SingleGroupContext
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
 
 
 PROFILE = 'steam-presence'
@@ -8,38 +8,11 @@ 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(),
-            },
-        )
-        texts = response.get("texts")
-        if isinstance(texts, list) and texts and all(
-            isinstance(item, str) and item.strip() for item in texts
-        ):
-            return ExtensionResult(
-                reply=ReplyPlan.multi_text(texts),
-                metadata={"local_extension": PROFILE, "author": AUTHOR},
-            )
-        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
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
 
 
 def plugin(context: SingleGroupContext) -> None:
-    for command in COMMANDS:
-        context.commands.register(command, _handler(context, command))
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/adapters/trivia_quiz.py

@@ -0,0 +1,18 @@
+"""Generated reviewed adapter for trivia-quiz."""
+
+from jwebot_sdk import ServiceCommandAdapter, SingleGroupContext
+
+
+PROFILE = 'trivia-quiz'
+AUTHOR = 'jwebot'
+DESCRIPTION = '冷门知识问答'
+HELP_ENTRIES = ('/回答 A；/answer A',)
+COMMANDS = ('/回答', '/answer')
+ADAPTER = ServiceCommandAdapter(
+    PROFILE,
+    metadata={"local_extension": PROFILE, "author": AUTHOR},
+)
+
+
+def plugin(context: SingleGroupContext) -> None:
+    ADAPTER.register(context, COMMANDS)

packages/jwebot-official-extensions/src/jwebot_official_extensions/descriptors.py

@@ -34,6 +34,7 @@ LOCAL_COMMAND_ALIASES = {
     "历史搜索": "history_search",
     "状态": "local_status",
     "status": "server_status",
+    "版本": "jwebot_version",
     "version": "jwebot_version",
     "debug": "telemetry_debug",
     "余额": "deepseek_balance",
@@ -52,6 +53,19 @@ LOCAL_COMMAND_ALIASES = {
     "Taffy摩拉": "taffy_coins",
     "Taffy金币": "taffy_coins",
     "taffycoins": "taffy_coins",
+    "原石": "wallet",
+    "原石祈愿": "primogem_wish",
+    "祈愿": "primogem_wish",
+    "wish": "primogem_wish",
+    "原石榜": "primogem_ranking",
+    "primogem榜": "primogem_ranking",
+    "扫码加权": "scan_boost",
+    "扫码概率": "scan_boost",
+    "Taffy发话": "taffy_say",
+    "taffysay": "taffy_say",
+    "知识问答": "trivia_start",
+    "回答": "trivia_answer",
+    "answer": "trivia_answer",
     "转账": "transfer",
     "transfer": "transfer",
     "贷款": "loan",
@@ -60,6 +74,8 @@ LOCAL_COMMAND_ALIASES = {
     "borrow": "loan",
     "还款": "repay",
     "repay": "repay",
+    "许愿池": "prize_draw",
+    "许愿": "prize_draw",
     "抽奖": "prize_draw",
     "draw": "prize_draw",
     "彩票": "lottery",
@@ -138,6 +154,11 @@ DIRECT_KERNEL_COMMANDS = (
         help_entries=("/余额",),
         command_kinds=("deepseek_balance",),
     ),
+    KernelCommandDescriptor(
+        description="冷门问答",
+        help_entries=("/知识问答 [主题]",),
+        command_kinds=("trivia_start",),
+    ),
 )
 DIRECT_KERNEL_COMMAND_KINDS = frozenset(
     kind
@@ -158,21 +179,23 @@ LOCAL_EXTENSIONS = (
         author=JWEBOT_AUTHOR,
         description="摩拉游戏",
         help_entries=(
-            "/摩拉（兼容 /金币）/wallet；/游戏记录 /gamehistory",
-            "/抽奖 [金额]；/draw",
-            "/彩票 开始|报名|状态|开奖|取消；/lottery",
-            "/21点 单人开始|要牌|停牌|状态；多人启动|加入|开始|放200",
-            "/游戏帮助；/games",
+            "/摩拉/原石 /许愿池 /彩票 /21点 /游戏帮助",
         ),
         command_kinds=(
             "wallet",
             "prize_draw",
             "lottery",
             "blackjack",
-            "game_history",
             "game_rules",
         ),
     ),
+    LocalExtensionDescriptor(
+        extension_id="game-history",
+        author=JWEBOT_AUTHOR,
+        description="游戏记录",
+        help_entries=("/游戏记录 /个人记录 /gamehistory",),
+        command_kinds=("game_history",),
+    ),
     LocalExtensionDescriptor(
         extension_id="coin-transfer",
         author=JWEBOT_AUTHOR,
@@ -194,6 +217,20 @@ LOCAL_EXTENSIONS = (
         help_entries=("/Taffy摩拉（兼容 /Taffy金币）",),
         command_kinds=("taffy_coins",),
     ),
+    LocalExtensionDescriptor(
+        extension_id="primogem-economy",
+        author=JWEBOT_AUTHOR,
+        description="原石系统",
+        help_entries=(
+            "/原石祈愿 /原石榜；/扫码加权 人；/Taffy发话 [定时HH:MM] 内容",
+        ),
+        command_kinds=(
+            "primogem_wish",
+            "primogem_ranking",
+            "scan_boost",
+            "taffy_say",
+        ),
+    ),
     LocalExtensionDescriptor(
         extension_id="coin-loan",
         author=JWEBOT_AUTHOR,
@@ -201,6 +238,13 @@ LOCAL_EXTENSIONS = (
         help_entries=("/贷款；/还款",),
         command_kinds=("loan", "repay"),
     ),
+    LocalExtensionDescriptor(
+        extension_id="trivia-quiz",
+        author=JWEBOT_AUTHOR,
+        description="冷门知识问答",
+        help_entries=("/回答 A；/answer A",),
+        command_kinds=("trivia_answer",),
+    ),
     LocalExtensionDescriptor(
         extension_id="cs-major-autochess",
         author=JWEBOT_AUTHOR,
@@ -213,7 +257,7 @@ LOCAL_EXTENSIONS = (
     LocalExtensionDescriptor(
         extension_id="person-directory",
         author=OFFICIAL_AUTHOR,
-        description="查询当前群已配置人物、基本属性和别名",
+        description="人物索引",
         help_entries=("/人物列表 [页码] /people；/人物 [名称或别名] /person",),
         command_kinds=("person_directory", "person_info"),
     ),
@@ -244,7 +288,7 @@ LOCAL_EXTENSIONS = (
         extension_id="jwebot-version",
         author=OFFICIAL_AUTHOR,
         description="JWeBot 版本",
-        help_entries=("/version",),
+        help_entries=("/version /版本",),
         command_kinds=("jwebot_version",),
     ),
     LocalExtensionDescriptor(

packages/jwebot-official-extensions/src/jwebot_official_extensions/local_commands.py

@@ -27,7 +27,9 @@ BEIJING_TIMEZONE = ZoneInfo("Asia/Shanghai")
 DICE_PATTERN = re.compile(r"^(?:(\d{1,2})[dD](\d{1,3}))?$")
 RANDOM_NUMBER_PATTERN = re.compile(r"^(-?\d{1,6})\s+(-?\d{1,6})$")
 MULTI_REPLY_MARKER = "\x1eJWEBOT_MULTI_REPLY_V1\x1e"
-CHANGELOG_HEADING = re.compile(r"^##\s+(.+?)(?:\s+-\s+(\d{4}-\d{2}-\d{2}))?\s*$")
+CHANGELOG_HEADING = re.compile(
+    r"^##\s+(.+?)(?:\s+-\s+(\d{4}-\d{2}-\d{2}(?:\s+\d{2}:\d{2}:\d{2})?))?\s*$"
+)
 
 
 class LocalCommandError(RuntimeError):
@@ -166,6 +168,10 @@ class LocalCommandEngine:
             "blackjack",
             "game_history",
             "game_rules",
+            "primogem_wish",
+            "primogem_ranking",
+            "scan_boost",
+            "taffy_say",
         }:
             return self.reply_cleaner(self.players.handle(row, kind, arguments))
         if kind == "cs_autochess":
@@ -216,6 +222,8 @@ class LocalCommandEngine:
             return self.reply_cleaner(self.deepseek_balance())
         if kind == "steam_friends":
             return self.reply_cleaner(self.steam_friends(arguments))
+        if kind == "trivia_answer":
+            return self.reply_cleaner(self.trivia_answer(row, arguments))
         raise LocalCommandError("unsupported local command")
 
     @staticmethod
@@ -240,17 +248,28 @@ class LocalCommandEngine:
 
     def scan_ranking(self, row: dict[str, Any]) -> str:
         local_date = datetime.now(BEIJING_TIMEZONE).date().isoformat()
-        ranking = self.ledger.clock_scan_ranking(
-            str(row["group_fingerprint"]),
+        group = str(row["group_fingerprint"])
+        ranking = self.ledger.clock_scan_ranking_all(
+            group,
             local_date,
         )
+        weights = self.ledger.next_clock_scan_weights(
+            str(row["group_fingerprint"]),
+        )
         if not ranking:
-            return "北京时间今天还没有已确认送达的扫码记录"
+            return "北京时间今天还没有可展示的扫码候选"
         listing = "；".join(
             f"{index}. {entry['display_name']} {entry['scan_count']} 次"
             for index, entry in enumerate(ranking, start=1)
         )
-        return f"北京时间今日扫码排行：{listing}"
+        weight_listing = "；".join(
+            f"{entry['display_name']} {entry['weight']}（{entry['share']:.1f}%）"
+            for entry in weights
+        )
+        return (
+            f"北京时间今日扫码排行：{listing}\n"
+            f"下一小时扫码权重：{weight_listing}"
+        )
 
     def repeat_ranking(self, row: dict[str, Any]) -> str:
         self.ledger.bootstrap_repeat_history()
@@ -433,6 +452,8 @@ class LocalCommandEngine:
                     continue
                 version = match.group(1).strip()
                 updated_at = (match.group(2) or "").strip()
+                if re.fullmatch(r"\d{4}-\d{2}-\d{2}", updated_at):
+                    updated_at = f"{updated_at} 00:00:00"
                 bullet_parts: list[str] = []
                 collecting = False
                 for item in lines[index + 1 :]:
@@ -604,6 +625,17 @@ class LocalCommandEngine:
             return "Steam 查询当前不可用"
         return self.steam.render(arguments)
 
+    def trivia_answer(self, row: dict[str, Any], arguments: str) -> str:
+        answer = normalize_text(arguments)
+        if not answer:
+            return "用法：/回答 A、/回答 B、/回答 C 或 /回答 D"
+        return self.ledger.answer_trivia(
+            str(row["group_fingerprint"]),
+            str(row["sender"]),
+            str(row["event_id"]),
+            answer,
+        )
+
     def profile_for_row(self, row: dict[str, Any]) -> dict[str, Any] | None:
         person = self.ledger.resolve_person(
             str(row["group_fingerprint"]),

packages/jwebot-sdk/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jwebot-sdk"
-version = "1.0.4b1+1016"
+version = "2.0.5b1+1023"
 description = "Typed, capability-limited extension API for JWeBot plugins"
 requires-python = ">=3.9"
 dependencies = []

packages/jwebot-sdk/src/jwebot_sdk/__init__.py

@@ -8,6 +8,7 @@ from .context import (
     PluginLogger,
     PluginStorage,
     Scheduler,
+    ServiceCommandAdapter,
     SingleGroupContext,
 )
 from .contracts import (
@@ -35,7 +36,8 @@ __all__ = [
     "PluginStorage",
     "ReplyPlan",
     "Scheduler",
+    "ServiceCommandAdapter",
     "SingleGroupContext",
 ]
 
-__version__ = "1.0.4b1+1016"
+__version__ = "2.0.5b1+1023"

packages/jwebot-sdk/src/jwebot_sdk/context.py

@@ -2,10 +2,10 @@
 
 from __future__ import annotations
 
-from collections.abc import Callable, Mapping
+from collections.abc import Callable, Iterable, Mapping
 from typing import Protocol
 
-from .contracts import Event, ExtensionResult, Fact
+from .contracts import Event, ExtensionResult, Fact, ReplyPlan
 
 
 CommandHandler = Callable[[Event, str], ExtensionResult]
@@ -68,3 +68,67 @@ class SingleGroupContext(Protocol):
     facts: FactWriter
     scheduler: Scheduler
     logger: PluginLogger
+
+
+class ServiceCommandAdapter:
+    """Register commands that delegate only to declared kernel service profiles."""
+
+    def __init__(
+        self,
+        profile: str,
+        *,
+        operation: str = "execute",
+        metadata: Mapping[str, str] | None = None,
+    ) -> None:
+        self.profile = self._bounded_text(profile, "profile")
+        self.operation = self._bounded_text(operation, "operation")
+        self.metadata = {
+            str(key): str(value)
+            for key, value in (metadata or {}).items()
+        }
+
+    @staticmethod
+    def _bounded_text(value: object, name: str) -> str:
+        text = str(value or "").strip()
+        if not text or len(text) > 80:
+            raise ValueError(f"{name} is invalid")
+        return text
+
+    def _handler(self, context: SingleGroupContext, command: str) -> CommandHandler:
+        command_name = self._bounded_text(command, "command")
+
+        def handle(event: Event, arguments: str) -> ExtensionResult:
+            response = context.services.call(
+                self.profile,
+                operation=self.operation,
+                payload={
+                    "command": command_name,
+                    "arguments": str(arguments),
+                    "event": event.to_mapping(),
+                },
+            )
+            texts = response.get("texts")
+            if isinstance(texts, list) and texts:
+                if not all(isinstance(item, str) and item.strip() for item in texts):
+                    raise ValueError("service returned invalid text parts")
+                return ExtensionResult(
+                    reply=ReplyPlan.multi_text(texts),
+                    metadata=self.metadata,
+                )
+            text = response.get("text")
+            if not isinstance(text, str) or not text.strip():
+                raise ValueError("service returned invalid text")
+            return ExtensionResult(
+                reply=ReplyPlan.text(text),
+                metadata=self.metadata,
+            )
+
+        return handle
+
+    def register(
+        self,
+        context: SingleGroupContext,
+        commands: Iterable[str],
+    ) -> None:
+        for command in commands:
+            context.commands.register(command, self._handler(context, command))

pyproject.toml

@@ -1,5 +1,5 @@
 [tool.jwebot]
-release = "beta 1.0.4.1016"
+release = "beta 2.0.5.1023"
 production_deployments_enabled_by_default = false
 
 [tool.jwebot.workspace]

tests/test_conversation_scope.py

@@ -0,0 +1,236 @@
+#!/usr/bin/env python3
+
+import hashlib
+import json
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+
+PROJECT_ROOT = Path(__file__).resolve().parents[1]
+sys.path[:0] = [
+    str(PROJECT_ROOT / "packages" / "jwebot-config" / "src"),
+    str(PROJECT_ROOT / "packages" / "jwebot-sdk" / "src"),
+    str(PROJECT_ROOT / "packages" / "jwebot-official-extensions" / "src"),
+    str(PROJECT_ROOT / "packages" / "jwebot-kernel" / "src"),
+]
+
+from jwebot_kernel.conversation_scope import (  # noqa: E402
+    ConversationConfigError,
+    ConversationKind,
+    ConversationTarget,
+    ShadowConversationRegistry,
+    build_shadow_event,
+)
+
+
+def fingerprint(label: str) -> str:
+    return hashlib.sha256(label.encode()).hexdigest()
+
+
+class ConversationTargetTests(unittest.TestCase):
+    def test_group_requires_an_explicit_mention(self):
+        target = ConversationTarget(
+            key="main-group",
+            kind=ConversationKind.GROUP,
+            title_fingerprint=fingerprint("main-group"),
+        )
+
+        self.assertEqual(
+            target.question("@JWeBot hello", bot_mention="JWeBot"),
+            "hello",
+        )
+        self.assertEqual(target.question("hello", bot_mention="JWeBot"), "")
+
+    def test_direct_chat_accepts_only_commands_or_wake_words(self):
+        target = ConversationTarget(
+            key="test-direct",
+            kind=ConversationKind.DIRECT,
+            title_fingerprint=fingerprint("test-direct"),
+            sender="Test User",
+        )
+
+        self.assertEqual(
+            target.question("/状态", bot_mention="JWeBot"),
+            "/状态",
+        )
+        self.assertEqual(
+            target.question("JWeBot: hello", bot_mention="JWeBot"),
+            "hello",
+        )
+        self.assertEqual(target.question("普通聊天", bot_mention="JWeBot"), "")
+
+    def test_direct_chat_requires_a_configured_sender(self):
+        with self.assertRaisesRegex(ConversationConfigError, "direct sender"):
+            ConversationTarget(
+                key="test-direct",
+                kind=ConversationKind.DIRECT,
+                title_fingerprint=fingerprint("test-direct"),
+            )
+
+    def test_title_identity_must_be_a_sha256_digest(self):
+        with self.assertRaisesRegex(ConversationConfigError, "SHA-256"):
+            ConversationTarget(
+                key="test-direct",
+                kind=ConversationKind.DIRECT,
+                title_fingerprint="visible-contact-name",
+                sender="Test User",
+            )
+
+
+class ShadowRegistryTests(unittest.TestCase):
+    def test_registry_is_disabled_without_an_explicit_path(self):
+        registry = ShadowConversationRegistry.from_environment({})
+
+        self.assertFalse(registry.enabled)
+        self.assertEqual(registry.targets, ())
+
+    def test_disabled_registry_never_matches_targets(self):
+        digest = fingerprint("test-direct")
+        registry = ShadowConversationRegistry.from_mapping(
+            {
+                "format_version": 1,
+                "enabled": False,
+                "targets": [
+                    {
+                        "key": "test-direct",
+                        "kind": "direct",
+                        "title_fingerprint": digest,
+                        "sender": "Test User",
+                    }
+                ],
+            }
+        )
+
+        self.assertIsNone(registry.target_for_fingerprint(digest))
+
+    def test_explicit_config_loads_only_shadow_targets(self):
+        digest = fingerprint("test-direct")
+        config = {
+            "format_version": 1,
+            "enabled": True,
+            "targets": [
+                {
+                    "key": "test-direct",
+                    "kind": "direct",
+                    "title_fingerprint": digest,
+                    "sender": "Test User",
+                }
+            ],
+        }
+        with tempfile.TemporaryDirectory() as directory:
+            path = Path(directory) / "shadow.json"
+            path.write_text(json.dumps(config), encoding="utf-8")
+            registry = ShadowConversationRegistry.from_environment(
+                {"JWEBOT_CONVERSATION_SHADOW_CONFIG": str(path)}
+            )
+
+        self.assertTrue(registry.enabled)
+        self.assertEqual(registry.target_for_fingerprint(digest), registry.targets[0])
+
+    def test_duplicate_title_fingerprints_are_rejected(self):
+        digest = fingerprint("duplicate")
+        with self.assertRaisesRegex(ConversationConfigError, "fingerprints"):
+            ShadowConversationRegistry.from_mapping(
+                {
+                    "format_version": 1,
+                    "enabled": True,
+                    "targets": [
+                        {
+                            "key": "direct-a",
+                            "kind": "direct",
+                            "title_fingerprint": digest,
+                            "sender": "Test A",
+                        },
+                        {
+                            "key": "direct-b",
+                            "kind": "direct",
+                            "title_fingerprint": digest,
+                            "sender": "Test B",
+                        },
+                    ],
+                }
+            )
+
+    def test_group_targets_are_rejected_in_private_shadow_phase(self):
+        with self.assertRaisesRegex(ConversationConfigError, "direct targets only"):
+            ShadowConversationRegistry.from_mapping(
+                {
+                    "format_version": 1,
+                    "enabled": True,
+                    "targets": [
+                        {
+                            "key": "main-group",
+                            "kind": "group",
+                            "title_fingerprint": fingerprint("main-group"),
+                        }
+                    ],
+                }
+            )
+
+    def test_unknown_delivery_field_is_rejected(self):
+        with self.assertRaisesRegex(ConversationConfigError, "unknown fields"):
+            ShadowConversationRegistry.from_mapping(
+                {
+                    "format_version": 1,
+                    "enabled": True,
+                    "delivery_enabled": True,
+                    "targets": [],
+                }
+            )
+
+
+class ShadowEventTests(unittest.TestCase):
+    def test_direct_event_uses_verified_conversation_identity(self):
+        digest = fingerprint("test-direct")
+        target = ConversationTarget(
+            key="test-direct",
+            kind=ConversationKind.DIRECT,
+            title_fingerprint=digest,
+            sender="Test User",
+        )
+
+        event = build_shadow_event(
+            target,
+            observed_at="2026-10-20T12:00:00+08:00",
+            text="/状态",
+            body_confidence=0.98,
+            visual_signature="visual-1",
+            bot_mention="JWeBot",
+        )
+
+        self.assertEqual(event["sender"], "Test User")
+        self.assertEqual(event["sender_confidence"], 1.0)
+        self.assertEqual(event["question"], "/状态")
+        self.assertTrue(event["mention_bot"])
+        self.assertEqual(event["group_fingerprint"], digest)
+        self.assertEqual(event["conversation_kind"], "direct")
+        self.assertTrue(event["shadow_only"])
+        self.assertFalse(event["dispatch_allowed"])
+
+    def test_unaddressed_direct_message_is_observed_but_not_triggered(self):
+        target = ConversationTarget(
+            key="test-direct",
+            kind=ConversationKind.DIRECT,
+            title_fingerprint=fingerprint("test-direct"),
+            sender="Test User",
+        )
+
+        event = build_shadow_event(
+            target,
+            observed_at="2026-10-20T12:00:00+08:00",
+            text="普通聊天",
+            body_confidence=0.98,
+            visual_signature="visual-2",
+            bot_mention="JWeBot",
+        )
+
+        self.assertEqual(event["question"], "")
+        self.assertFalse(event["mention_bot"])
+        self.assertTrue(event["shadow_only"])
+        self.assertFalse(event["dispatch_allowed"])
+
+
+if __name__ == "__main__":
+    unittest.main()

tests/test_deployment_scripts.py

@@ -62,6 +62,8 @@ class DeploymentScriptTests(unittest.TestCase):
             "jwebot_config",
             "jwebot_sdk",
             "jwebot_kernel",
+            "jwebot_kernel/data",
+            "kernel_data_source_dir",
             "jwebot_official_extensions",
             "data/cs_autochess",
             "official_autochess_data_source_dir",
@@ -127,6 +129,10 @@ class DeploymentScriptTests(unittest.TestCase):
             'jwebot_log "runtime install ready"',
             'jwebot_log "edge active"',
             'jwebot_log "adaptive active"',
+            'send_release_lifecycle_notice shutdown',
+            'send_release_lifecycle_notice startup',
+            'jwebot_log "release lifecycle shutdown notice ready"',
+            'jwebot_log "release lifecycle startup notice ready"',
             'jwebot_log "release settlement starting"',
             '"${target_runtime}/jwebot_release_update.py"',
             'jwebot_log "release settlement ready"',
@@ -142,10 +148,20 @@ class DeploymentScriptTests(unittest.TestCase):
             source.count("xdotool"),
             source.count("/usr/bin/xdotool"),
         )
+        cutover_index = source.index('jwebot_log "cutover starting"')
+        actual_stop_index = source.index("user_systemctl stop", cutover_index)
+        self.assertLess(
+            source.index('jwebot_log "release lifecycle shutdown notice ready"'),
+            actual_stop_index,
+        )
         self.assertLess(
             source.index("trap - EXIT HUP INT TERM"),
             source.index('jwebot_log "release settlement starting"'),
         )
+        self.assertLess(
+            source.index('jwebot_log "release lifecycle startup notice ready"'),
+            source.index('jwebot_log "release settlement starting"'),
+        )
         self.assertLess(
             source.index('jwebot_log "release settlement ready"'),
             source.index('jwebot_log "deployment ready version='),