mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
BeaconCat
363861c917
Restructure all 6 README files (en, zh, ja, fr, pt-br, vi) from
~1200-1580 lines down to ~250 lines each. Long sections (Chat Apps,
Providers, Configuration, Docker, Spawn Tasks, Troubleshooting, Tools)
are extracted into dedicated docs under docs/{lang}/ subdirectories.
Changes:
- Split README content into 7 sub-documents per language (42 new files)
- Update News section with v0.2.3/v0.2.1/v0.2.0/20K milestones
- Add 3 new Features (MCP Support, Vision Pipeline, Smart Routing)
- Complete CLI reference (14 commands, was 7)
- Fix Go badge 1.21+ -> 1.25+ (matches go.mod)
- Add LoongArch to architecture badge
- Fix Install section: hardcoded v0.1.1 -> latest/download URL
- Add Termux GitHub links
- Fix currency symbol placement ($599 not 599$)
- Add missing channels (Feishu, Slack, IRC, OneBot, MaixCam, Pico)
- Add missing providers (Kimi, Minimax, Avian, Mistral, Longcat, ModelScope)
- Add missing security docs (allow_read/write_paths, allow_remote, symlink)
- Remove incorrect azure from Providers table (azure uses model_list only)
- Cross-verified all claims against source code
Co-authored-by: BeaconCat <BeaconCat@users.noreply.github.com>
69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
# 🔄 非同期タスクと Spawn
|
|
|
|
> [README](../../README.ja.md) に戻る
|
|
|
|
### Spawn を使用した非同期タスク
|
|
|
|
長時間実行タスク（Web 検索、API 呼び出し）には、`spawn` ツールを使用して**サブ Agent (subagent)** を作成します：
|
|
|
|
```markdown
|
|
# Periodic Tasks
|
|
|
|
## Quick Tasks (respond directly)
|
|
|
|
- Report current time
|
|
|
|
## Long Tasks (use spawn for async)
|
|
|
|
- Search the web for AI news and summarize
|
|
- Check email and report important messages
|
|
```
|
|
|
|
**主な動作：**
|
|
|
|
| 特性 | 説明 |
|
|
| ---------------- | ------------------------------------------------ |
|
|
| **spawn** | 非同期サブ Agent を作成、メインハートビートをブロックしない |
|
|
| **独立コンテキスト** | サブ Agent は独自のコンテキストを持ち、セッション履歴なし |
|
|
| **message tool** | サブ Agent は message ツールでユーザーと直接通信 |
|
|
| **ノンブロッキング** | spawn 後、ハートビートは次のタスクに進む |
|
|
|
|
#### サブ Agent の通信の仕組み
|
|
|
|
```
|
|
ハートビートトリガー (Heartbeat triggers)
|
|
↓
|
|
Agent が HEARTBEAT.md を読み取り
|
|
↓
|
|
長時間タスクの場合: サブ Agent を spawn
|
|
↓ ↓
|
|
次のタスクに進む サブ Agent が独立して作業
|
|
↓ ↓
|
|
すべてのタスク完了 サブ Agent が "message" ツールを使用
|
|
↓ ↓
|
|
HEARTBEAT_OK を応答 ユーザーが直接結果を受信
|
|
```
|
|
|
|
サブ Agent はツール（message、web_search など）にアクセスでき、メイン Agent を経由せずにユーザーと独立して通信できます。
|
|
|
|
**設定：**
|
|
|
|
```json
|
|
{
|
|
"heartbeat": {
|
|
"enabled": true,
|
|
"interval": 30
|
|
}
|
|
}
|
|
```
|
|
|
|
| オプション | デフォルト値 | 説明 |
|
|
| ---------- | ------------ | ------------------------------ |
|
|
| `enabled` | `true` | ハートビートの有効/無効 |
|
|
| `interval` | `30` | チェック間隔（分単位、最小: 5）|
|
|
|
|
**環境変数:**
|
|
|
|
- `PICOCLAW_HEARTBEAT_ENABLED=false` で無効化
|
|
- `PICOCLAW_HEARTBEAT_INTERVAL=60` で間隔を変更
|