mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
feat(agent): support btw side questions (#2532)
This commit is contained in:
lxowalle
+2
-1
@@ -62,7 +62,7 @@ picoclaw gateway
|
||||
|
||||
**4. Telegram command menu (auto-registered at startup)**
|
||||
|
||||
PicoClaw now keeps command definitions in one shared registry. On startup, Telegram will automatically register supported bot commands (for example `/start`, `/help`, `/show`, `/list`, `/use`) so command menu and runtime behavior stay in sync.
|
||||
PicoClaw now keeps command definitions in one shared registry. On startup, Telegram will automatically register supported bot commands (for example `/start`, `/help`, `/show`, `/list`, `/use`, `/btw`) so command menu and runtime behavior stay in sync.
|
||||
Telegram command menu registration remains channel-local discovery UX; generic command execution is handled centrally in the agent loop via the commands executor.
|
||||
|
||||
If command registration fails (network/API transient errors), the channel still starts and PicoClaw retries registration in the background.
|
||||
@@ -73,6 +73,7 @@ You can also manage installed skills directly from Telegram:
|
||||
- `/use <skill> <message>`
|
||||
- `/use <skill>` and then send the actual request in the next message
|
||||
- `/use clear`
|
||||
- `/btw <question>` to ask an immediate side question without changing the active session history; `/btw` is handled as a no-tool query and does not enter the normal tool-execution flow
|
||||
|
||||
**4. Advanced Formatting**
|
||||
You can set use_markdown_v2: true to enable enhanced formatting options. This allows the bot to utilize the full range of Telegram MarkdownV2 features, including nested styles, spoilers, and custom fixed-width blocks.
|
||||
|
||||
@@ -103,12 +103,14 @@ Once skills are installed, you can inspect and force them directly from a chat c
|
||||
- `/use <skill> <message>` forces a specific skill for a single request.
|
||||
- `/use <skill>` arms that skill for your next message in the same chat session.
|
||||
- `/use clear` cancels a pending skill override created by `/use <skill>`.
|
||||
- `/btw <question>` asks an immediate side question without changing the current session history. `/btw` is handled as a no-tool query and does not enter the normal tool-execution flow.
|
||||
|
||||
Examples:
|
||||
|
||||
```text
|
||||
/list skills
|
||||
/use git explain how to squash the last 3 commits
|
||||
/btw remind me what we already decided about the deploy plan
|
||||
/use italiapersonalfinance
|
||||
dammi le ultime news
|
||||
```
|
||||
@@ -116,7 +118,7 @@ dammi le ultime news
|
||||
### Unified Command Execution Policy
|
||||
|
||||
- Generic slash commands are executed through a single path in `pkg/agent/loop.go` via `commands.Executor`.
|
||||
- Channel adapters no longer consume generic commands locally; they forward inbound text to the bus/agent path. Telegram still auto-registers supported commands at startup.
|
||||
- Channel adapters no longer consume generic commands locally; they forward inbound text to the bus/agent path. Telegram still auto-registers supported commands such as `/start`, `/help`, `/show`, `/list`, `/use`, and `/btw` at startup.
|
||||
- Unknown slash command (for example `/foo`) passes through to normal LLM processing.
|
||||
- Registered but unsupported command on the current channel (for example `/show` on WhatsApp) returns an explicit user-facing error and stops further processing.
|
||||
|
||||
|
||||
@@ -61,11 +61,19 @@ picoclaw gateway
|
||||
|
||||
**4. Menu de commandes Telegram (enregistré automatiquement au démarrage)**
|
||||
|
||||
PicoClaw conserve les définitions de commandes dans un registre partagé unique. Au démarrage, Telegram enregistre automatiquement les commandes bot prises en charge (par exemple `/start`, `/help`, `/show`, `/list`) afin que le menu de commandes et le comportement à l'exécution restent synchronisés.
|
||||
PicoClaw conserve les définitions de commandes dans un registre partagé unique. Au démarrage, Telegram enregistre automatiquement les commandes bot prises en charge (par exemple `/start`, `/help`, `/show`, `/list`, `/use`, `/btw`) afin que le menu de commandes et le comportement à l'exécution restent synchronisés.
|
||||
L'enregistrement du menu de commandes Telegram reste une découverte UX locale au canal ; l'exécution générique des commandes est gérée de manière centralisée dans la boucle agent via l'exécuteur de commandes.
|
||||
|
||||
Si l'enregistrement des commandes échoue (erreurs transitoires réseau/API), le canal démarre quand même et PicoClaw réessaie l'enregistrement en arrière-plan.
|
||||
|
||||
Vous pouvez aussi gerer les competences installees directement depuis Telegram :
|
||||
|
||||
- `/list skills`
|
||||
- `/use <skill> <message>`
|
||||
- `/use <skill>` puis envoyer la vraie requete dans le message suivant
|
||||
- `/use clear`
|
||||
- `/btw <question>` pour poser une question annexe immediate sans modifier l'historique actif de la session ; `/btw` est traite comme une requete directe sans outils et n'entre pas dans le flux normal d'execution des outils
|
||||
|
||||
</details>
|
||||
|
||||
<a id="discord"></a>
|
||||
|
||||
@@ -80,10 +80,30 @@ Pour les configurations avancées/de test, vous pouvez remplacer la racine des c
|
||||
export PICOCLAW_BUILTIN_SKILLS=/path/to/skills
|
||||
```
|
||||
|
||||
### Utiliser les Commandes Depuis les Canaux de Chat
|
||||
|
||||
Une fois les compétences installées, vous pouvez aussi les inspecter et les activer directement depuis un canal de chat :
|
||||
|
||||
- `/list skills` affiche les noms des compétences installées visibles pour l'agent courant.
|
||||
- `/use <skill> <message>` force une compétence pour une seule requête.
|
||||
- `/use <skill>` prépare cette compétence pour votre prochain message dans la meme conversation.
|
||||
- `/use clear` annule une surcharge de compétence en attente creee via `/use <skill>`.
|
||||
- `/btw <question>` pose une question annexe immediate sans modifier l'historique courant de la session. `/btw` est traite comme une requete directe sans outils et n'entre pas dans le flux normal d'execution des outils.
|
||||
|
||||
Exemples :
|
||||
|
||||
```text
|
||||
/list skills
|
||||
/use git explique comment squash les 3 derniers commits
|
||||
/btw rappelle-moi ce qu'on a deja decide pour le plan de deploiement
|
||||
/use italiapersonalfinance
|
||||
dammi le ultime news
|
||||
```
|
||||
|
||||
### Politique Unifiée d'Exécution des Commandes
|
||||
|
||||
- Les commandes slash génériques sont exécutées via un chemin unique dans `pkg/agent/loop.go` via `commands.Executor`.
|
||||
- Les adaptateurs de canaux ne consomment plus les commandes génériques localement ; ils transmettent le texte entrant au chemin bus/agent. Telegram enregistre toujours automatiquement les commandes prises en charge au démarrage.
|
||||
- Les adaptateurs de canaux ne consomment plus les commandes génériques localement ; ils transmettent le texte entrant au chemin bus/agent. Telegram enregistre toujours automatiquement au démarrage les commandes prises en charge, comme `/start`, `/help`, `/show`, `/list`, `/use` et `/btw`.
|
||||
- Une commande slash inconnue (par exemple `/foo`) passe au traitement LLM normal.
|
||||
- Une commande enregistrée mais non prise en charge sur le canal actuel (par exemple `/show` sur WhatsApp) renvoie une erreur explicite à l'utilisateur et arrête le traitement ultérieur.
|
||||
|
||||
|
||||
@@ -65,7 +65,7 @@ picoclaw gateway
|
||||
|
||||
**4. Telegram コマンドメニュー（起動時に自動登録）**
|
||||
|
||||
PicoClaw は統一されたコマンド定義を使用します。起動時に Telegram がサポートするコマンド（例: `/start`、`/help`、`/show`、`/list`）を Bot コマンドメニューに自動登録し、メニュー表示と実際の動作を一致させます。
|
||||
PicoClaw は統一されたコマンド定義を使用します。起動時に Telegram がサポートするコマンド（例: `/start`、`/help`、`/show`、`/list`、`/use`、`/btw`）を Bot コマンドメニューに自動登録し、メニュー表示と実際の動作を一致させます。
|
||||
Telegram 側はコマンドメニュー登録機能を保持し、汎用コマンドの実行は Agent Loop 内の commands executor で統一的に処理されます。
|
||||
|
||||
ネットワークや API の一時的なエラーで登録に失敗しても、チャネルの起動はブロックされません。システムがバックグラウンドで自動リトライします。
|
||||
|
||||
@@ -81,10 +81,30 @@ PicoClaw は設定されたワークスペース（デフォルト: `~/.picoclaw
|
||||
export PICOCLAW_BUILTIN_SKILLS=/path/to/skills
|
||||
```
|
||||
|
||||
### チャットチャネルからスキルとコマンドを使う
|
||||
|
||||
スキルをインストールすると、チャットチャネルから直接確認したり明示的に適用したりできます：
|
||||
|
||||
- `/list skills` は現在の Agent から見えるインストール済みスキル名を表示します。
|
||||
- `/use <skill> <message>` は 1 回のリクエストだけそのスキルを強制します。
|
||||
- `/use <skill>` は同じチャット内の次のメッセージにそのスキルを予約します。
|
||||
- `/use clear` は `/use <skill>` で設定した保留中のスキル上書きを解除します。
|
||||
- `/btw <question>` は現在のセッション履歴を変更せずに即時の横道の質問を送ります。`/btw` はツールなしの直接質問として処理され、通常のツール実行フローには入りません。
|
||||
|
||||
例：
|
||||
|
||||
```text
|
||||
/list skills
|
||||
/use git 直近 3 つのコミットを squash する方法を教えて
|
||||
/btw さっきのデプロイ方針の結論だけもう一度教えて
|
||||
/use italiapersonalfinance
|
||||
dammi le ultime news
|
||||
```
|
||||
|
||||
### 統一コマンド実行ポリシー
|
||||
|
||||
- 汎用スラッシュコマンドは `pkg/agent/loop.go` 内の `commands.Executor` を通じて統一的に実行されます。
|
||||
- チャネルアダプターはローカルで汎用コマンドを消費しなくなりました。受信テキストを bus/agent パスに転送するだけです。Telegram は起動時にサポートするコマンドメニューを自動登録します。
|
||||
- チャネルアダプターはローカルで汎用コマンドを消費しなくなりました。受信テキストを bus/agent パスに転送するだけです。Telegram は起動時に `/start`、`/help`、`/show`、`/list`、`/use`、`/btw` などのサポート済みコマンドを自動登録します。
|
||||
- 未登録のスラッシュコマンド（例: `/foo`）は通常の LLM 処理にパススルーされます。
|
||||
- 登録済みだが現在のチャネルでサポートされていないコマンド（例: WhatsApp での `/show`）は、明示的なユーザー向けエラーを返し、以降の処理を停止します。
|
||||
|
||||
|
||||
@@ -60,11 +60,19 @@ picoclaw gateway
|
||||
|
||||
**4. Menu arahan Telegram (auto-register semasa startup)**
|
||||
|
||||
PicoClaw kini menyimpan definisi arahan dalam satu registry bersama. Semasa startup, Telegram akan mendaftarkan arahan bot yang disokong secara automatik (contohnya `/start`, `/help`, `/show`, `/list`) supaya menu arahan dan tingkah laku runtime sentiasa selari.
|
||||
PicoClaw kini menyimpan definisi arahan dalam satu registry bersama. Semasa startup, Telegram akan mendaftarkan arahan bot yang disokong secara automatik (contohnya `/start`, `/help`, `/show`, `/list`, `/use`, `/btw`) supaya menu arahan dan tingkah laku runtime sentiasa selari.
|
||||
Pendaftaran menu arahan Telegram kekal sebagai UX penemuan setempat saluran; pelaksanaan arahan generik dikendalikan secara berpusat dalam gelung agen melalui commands executor.
|
||||
|
||||
Jika pendaftaran arahan gagal (ralat sementara rangkaian/API), saluran tetap akan bermula dan PicoClaw akan mencuba semula pendaftaran di latar belakang.
|
||||
|
||||
Anda juga boleh mengurus skill yang dipasang terus dari Telegram:
|
||||
|
||||
- `/list skills`
|
||||
- `/use <skill> <message>`
|
||||
- `/use <skill>` kemudian hantar permintaan sebenar dalam mesej seterusnya
|
||||
- `/use clear`
|
||||
- `/btw <question>` untuk bertanya soalan sampingan segera tanpa mengubah sejarah sesi aktif; `/btw` dikendalikan sebagai pertanyaan langsung tanpa tool dan tidak memasuki aliran pelaksanaan tool biasa
|
||||
|
||||
**4. Pemformatan Lanjutan**
|
||||
Anda boleh menetapkan `use_markdown_v2: true` untuk mengaktifkan pilihan pemformatan yang lebih maju. Ini membolehkan bot menggunakan keseluruhan set ciri Telegram MarkdownV2, termasuk gaya bersarang, spoiler, dan blok lebar tetap tersuai.
|
||||
|
||||
|
||||
@@ -63,10 +63,30 @@ Untuk setup lanjutan/ujian, anda boleh menindih root builtin skills dengan:
|
||||
export PICOCLAW_BUILTIN_SKILLS=/path/to/skills
|
||||
```
|
||||
|
||||
### Menggunakan Skill dan Arahan Dari Saluran Chat
|
||||
|
||||
Selepas skill dipasang, anda boleh menyemak dan memaksanya terus dari saluran chat:
|
||||
|
||||
- `/list skills` memaparkan nama skill dipasang yang kelihatan kepada agen semasa.
|
||||
- `/use <skill> <message>` memaksa satu skill untuk satu permintaan sahaja.
|
||||
- `/use <skill>` menyediakan skill itu untuk mesej anda yang seterusnya dalam chat yang sama.
|
||||
- `/use clear` membatalkan skill override tertunda yang dibuat melalui `/use <skill>`.
|
||||
- `/btw <question>` bertanya soalan sampingan segera tanpa mengubah sejarah sesi semasa. `/btw` dikendalikan sebagai pertanyaan langsung tanpa tool dan tidak memasuki aliran pelaksanaan tool biasa.
|
||||
|
||||
Contoh:
|
||||
|
||||
```text
|
||||
/list skills
|
||||
/use git terangkan cara squash 3 commit terakhir
|
||||
/btw ingatkan saya semula apa keputusan tadi untuk pelan deploy
|
||||
/use italiapersonalfinance
|
||||
dammi le ultime news
|
||||
```
|
||||
|
||||
### Polisi Pelaksanaan Arahan Bersepadu
|
||||
|
||||
- Generic slash command dilaksanakan melalui satu laluan dalam `pkg/agent/loop.go` melalui `commands.Executor`.
|
||||
- Adapter saluran tidak lagi menggunakan generic command secara setempat; ia memajukan teks masuk ke laluan bus/agent. Telegram masih auto-register arahan yang disokong semasa startup.
|
||||
- Adapter saluran tidak lagi menggunakan generic command secara setempat; ia memajukan teks masuk ke laluan bus/agent. Telegram masih auto-register arahan yang disokong semasa startup seperti `/start`, `/help`, `/show`, `/list`, `/use`, dan `/btw`.
|
||||
- Slash command yang tidak dikenali (contohnya `/foo`) akan diteruskan ke pemprosesan LLM biasa.
|
||||
- Arahan yang didaftarkan tetapi tidak disokong pada saluran semasa (contohnya `/show` di WhatsApp) akan memulangkan ralat yang jelas kepada pengguna dan menghentikan pemprosesan lanjut.
|
||||
|
||||
|
||||
@@ -61,11 +61,19 @@ picoclaw gateway
|
||||
|
||||
**4. Menu de comandos do Telegram (registrado automaticamente na inicialização)**
|
||||
|
||||
O PicoClaw agora mantém definições de comandos em um registro compartilhado. Na inicialização, o Telegram registrará automaticamente os comandos de bot suportados (por exemplo `/start`, `/help`, `/show`, `/list`) para que o menu de comandos e o comportamento em tempo de execução permaneçam sincronizados.
|
||||
O PicoClaw agora mantém definições de comandos em um registro compartilhado. Na inicialização, o Telegram registrará automaticamente os comandos de bot suportados (por exemplo `/start`, `/help`, `/show`, `/list`, `/use`, `/btw`) para que o menu de comandos e o comportamento em tempo de execução permaneçam sincronizados.
|
||||
O registro do menu de comandos do Telegram permanece como descoberta UX local do canal; a execução genérica de comandos é tratada centralmente no loop do agente via commands executor.
|
||||
|
||||
Se o registro de comandos falhar (erros transitórios de rede/API), o canal ainda inicia e o PicoClaw tenta novamente o registro em segundo plano.
|
||||
|
||||
Voce tambem pode gerenciar skills instaladas diretamente pelo Telegram:
|
||||
|
||||
- `/list skills`
|
||||
- `/use <skill> <message>`
|
||||
- `/use <skill>` e depois enviar a solicitacao real na proxima mensagem
|
||||
- `/use clear`
|
||||
- `/btw <question>` para fazer uma pergunta lateral imediata sem alterar o historico ativo da sessao; `/btw` e tratado como uma consulta direta sem ferramentas e nao entra no fluxo normal de execucao de ferramentas
|
||||
|
||||
</details>
|
||||
|
||||
<a id="discord"></a>
|
||||
|
||||
@@ -81,10 +81,30 @@ Para configurações avançadas/de teste, você pode substituir o diretório rai
|
||||
export PICOCLAW_BUILTIN_SKILLS=/path/to/skills
|
||||
```
|
||||
|
||||
### Usando Skills e Comandos em Canais de Chat
|
||||
|
||||
Depois que as skills estiverem instaladas, voce pode inspeciona-las e aplica-las diretamente de um canal de chat:
|
||||
|
||||
- `/list skills` mostra os nomes das skills instaladas visiveis para o agente atual.
|
||||
- `/use <skill> <message>` força uma skill para uma unica requisicao.
|
||||
- `/use <skill>` prepara essa skill para a sua proxima mensagem no mesmo chat.
|
||||
- `/use clear` cancela uma substituicao pendente criada por `/use <skill>`.
|
||||
- `/btw <question>` faz uma pergunta lateral imediata sem alterar o historico atual da sessao. `/btw` e tratado como uma consulta direta sem ferramentas e nao entra no fluxo normal de execucao de ferramentas.
|
||||
|
||||
Exemplos:
|
||||
|
||||
```text
|
||||
/list skills
|
||||
/use git explique como fazer squash dos ultimos 3 commits
|
||||
/btw me relembre o que ja decidimos sobre o plano de deploy
|
||||
/use italiapersonalfinance
|
||||
dammi le ultime news
|
||||
```
|
||||
|
||||
### Política Unificada de Execução de Comandos
|
||||
|
||||
- Comandos slash genéricos são executados através de um único caminho em `pkg/agent/loop.go` via `commands.Executor`.
|
||||
- Os adaptadores de canal não consomem mais comandos genéricos localmente; eles encaminham o texto de entrada para o caminho bus/agent. O Telegram ainda registra automaticamente os comandos suportados na inicialização.
|
||||
- Os adaptadores de canal não consomem mais comandos genéricos localmente; eles encaminham o texto de entrada para o caminho bus/agent. O Telegram ainda registra automaticamente na inicialização comandos suportados como `/start`, `/help`, `/show`, `/list`, `/use` e `/btw`.
|
||||
- Comando slash desconhecido (por exemplo `/foo`) passa para o processamento normal do LLM.
|
||||
- Comando registrado mas não suportado no canal atual (por exemplo `/show` no WhatsApp) retorna um erro explícito ao usuário e interrompe o processamento.
|
||||
|
||||
|
||||
@@ -61,11 +61,19 @@ picoclaw gateway
|
||||
|
||||
**4. Menu lệnh Telegram (tự động đăng ký khi khởi động)**
|
||||
|
||||
PicoClaw hiện lưu trữ định nghĩa lệnh trong một registry chung. Khi khởi động, Telegram sẽ tự động đăng ký các lệnh bot được hỗ trợ (ví dụ `/start`, `/help`, `/show`, `/list`) để menu lệnh và hành vi runtime luôn đồng bộ.
|
||||
PicoClaw hiện lưu trữ định nghĩa lệnh trong một registry chung. Khi khởi động, Telegram sẽ tự động đăng ký các lệnh bot được hỗ trợ (ví dụ `/start`, `/help`, `/show`, `/list`, `/use`, `/btw`) để menu lệnh và hành vi runtime luôn đồng bộ.
|
||||
Đăng ký menu lệnh Telegram vẫn là UX khám phá cục bộ của kênh; thực thi lệnh chung được xử lý tập trung trong vòng lặp agent qua commands executor.
|
||||
|
||||
Nếu đăng ký lệnh thất bại (lỗi tạm thời mạng/API), kênh vẫn khởi động và PicoClaw thử lại đăng ký trong nền.
|
||||
|
||||
Ban cung co the quan ly skill da cai dat truc tiep tu Telegram:
|
||||
|
||||
- `/list skills`
|
||||
- `/use <skill> <message>`
|
||||
- `/use <skill>` roi gui yeu cau that o tin nhan tiep theo
|
||||
- `/use clear`
|
||||
- `/btw <question>` de hoi them mot cau ngoai le ngay lap tuc ma khong thay doi lich su phien dang hoat dong; `/btw` duoc xu ly nhu mot truy van truc tiep khong dung cong cu va khong di vao luong thuc thi cong cu thong thuong
|
||||
|
||||
</details>
|
||||
|
||||
<a id="discord"></a>
|
||||
|
||||
@@ -81,10 +81,30 @@ Cho thiết lập nâng cao/test, bạn có thể ghi đè thư mục gốc skil
|
||||
export PICOCLAW_BUILTIN_SKILLS=/path/to/skills
|
||||
```
|
||||
|
||||
### Dung Skill va Lenh Tu Kenh Chat
|
||||
|
||||
Sau khi cai dat skill, ban co the xem va ep dung truc tiep tu kenh chat:
|
||||
|
||||
- `/list skills` hien ten cac skill da cai dat ma agent hien tai co the dung.
|
||||
- `/use <skill> <message>` ep dung mot skill cho duy nhat mot yeu cau.
|
||||
- `/use <skill>` dat san skill do cho tin nhan tiep theo trong cung cuoc tro chuyen.
|
||||
- `/use clear` huy skill override dang cho duoc tao boi `/use <skill>`.
|
||||
- `/btw <question>` dat cau hoi phu ngay lap tuc ma khong thay doi lich su phien hien tai. `/btw` duoc xu ly nhu mot truy van truc tiep khong dung cong cu va khong di vao luong thuc thi cong cu thong thuong.
|
||||
|
||||
Vi du:
|
||||
|
||||
```text
|
||||
/list skills
|
||||
/use git giai thich cach squash 3 commit cuoi
|
||||
/btw nhac lai giup toi chung ta da chot gi cho ke hoach deploy
|
||||
/use italiapersonalfinance
|
||||
dammi le ultime news
|
||||
```
|
||||
|
||||
### Chính Sách Thực Thi Lệnh Thống Nhất
|
||||
|
||||
- Lệnh slash chung được thực thi qua một đường dẫn duy nhất trong `pkg/agent/loop.go` qua `commands.Executor`.
|
||||
- Adapter kênh không còn xử lý lệnh chung cục bộ; chúng chuyển tiếp văn bản đầu vào đến đường dẫn bus/agent. Telegram vẫn tự động đăng ký lệnh được hỗ trợ khi khởi động.
|
||||
- Adapter kênh không còn xử lý lệnh chung cục bộ; chúng chuyển tiếp văn bản đầu vào đến đường dẫn bus/agent. Telegram vẫn tự động đăng ký khi khởi động các lệnh được hỗ trợ như `/start`, `/help`, `/show`, `/list`, `/use`, va `/btw`.
|
||||
- Lệnh slash không xác định (ví dụ `/foo`) được chuyển sang xử lý LLM bình thường.
|
||||
- Lệnh đã đăng ký nhưng không được hỗ trợ trên kênh hiện tại (ví dụ `/show` trên WhatsApp) trả về lỗi rõ ràng cho người dùng và dừng xử lý tiếp.
|
||||
|
||||
|
||||
@@ -65,7 +65,7 @@ picoclaw gateway
|
||||
|
||||
**4. Telegram 命令菜单（启动时自动注册）**
|
||||
|
||||
PicoClaw 使用统一的命令定义来源。启动时会自动将 Telegram 支持的命令（例如 `/start`、`/help`、`/show`、`/list`、`/use`）注册到 Bot 命令菜单，确保菜单展示与实际行为一致。
|
||||
PicoClaw 使用统一的命令定义来源。启动时会自动将 Telegram 支持的命令（例如 `/start`、`/help`、`/show`、`/list`、`/use`、`/btw`）注册到 Bot 命令菜单，确保菜单展示与实际行为一致。
|
||||
Telegram 侧保留的是命令菜单注册能力；通用命令的实际执行统一走 Agent Loop 中的 commands executor。
|
||||
|
||||
如果注册因网络或 API 短暂异常失败，不会阻塞 channel 启动；系统会在后台自动重试。
|
||||
@@ -76,6 +76,7 @@ Telegram 侧保留的是命令菜单注册能力；通用命令的实际执行
|
||||
- `/use <skill> <message>`
|
||||
- `/use <skill>`，然后在下一条消息里发送真正的请求
|
||||
- `/use clear`
|
||||
- `/btw <question>`，用于发起一个不改动当前会话历史的即时旁支提问；`/btw` 会按一次无工具的直接问答处理，不会进入常规的工具执行流程
|
||||
|
||||
</details>
|
||||
|
||||
|
||||
@@ -101,12 +101,14 @@ export PICOCLAW_BUILTIN_SKILLS=/path/to/skills
|
||||
- `/use <skill> <message>`：只对当前这一条请求强制使用指定技能。
|
||||
- `/use <skill>`：为同一会话中的下一条消息预先启用该技能。
|
||||
- `/use clear`：取消通过 `/use <skill>` 设置的待应用技能。
|
||||
- `/btw <question>`：发起一个即时的旁支提问，且不改动当前会话历史。`/btw` 会按一次无工具的直接问答处理，不会进入常规的工具执行流程。
|
||||
|
||||
示例：
|
||||
|
||||
```text
|
||||
/list skills
|
||||
/use git explain how to squash the last 3 commits
|
||||
/btw 帮我回顾一下刚才关于发布方案的结论
|
||||
/use italiapersonalfinance
|
||||
dammi le ultime news
|
||||
```
|
||||
@@ -114,7 +116,7 @@ dammi le ultime news
|
||||
### 统一命令执行策略
|
||||
|
||||
- 通用斜杠命令通过 `pkg/agent/loop.go` 中的 `commands.Executor` 统一执行。
|
||||
- Channel 适配器不再在本地消费通用命令；它们只负责把入站文本转发到 bus/agent 路径。Telegram 仍会在启动时自动注册其支持的命令菜单。
|
||||
- Channel 适配器不再在本地消费通用命令；它们只负责把入站文本转发到 bus/agent 路径。Telegram 仍会在启动时自动注册其支持的命令菜单，例如 `/start`、`/help`、`/show`、`/list`、`/use` 和 `/btw`。
|
||||
- 未注册的斜杠命令（例如 `/foo`）会透传给 LLM 按普通输入处理。
|
||||
- 已注册但当前 channel 不支持的命令（例如 WhatsApp 上的 `/show`）会返回明确的用户可见错误，并停止后续处理。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user