# Telegram · Buyruq satri

Canonical page: https://phishdestroy.io/tgwitness/uz/docs/reference/cli/

Qidiruv, kontekstni o'qish, faoliyatni hisoblash va skriptlar hamda agentlardan saqlangan xabarlarni eksport qilish, --json chiqish, barqaror chiqish kodlari va doirali faqat o'qish uchun tokenlar bilan.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/uz/llms.txt)

Translation coverage: this edition includes material from the English original.

Qidiruv, kontekstni o'qish, faoliyatni hisoblash va skriptlar hamda agentlardan saqlangan xabarlarni eksport qilish, --json chiqish, barqaror chiqish kodlari va doirali faqat o'qish uchun tokenlar bilan.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Hujjatlash](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![Arxiv integratsiyalari](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074)

[Faqat o'qish uchun MCP](https://phishdestroy.io/tgwitness/uz/docs/reference/mcp/) · [To'liq matnli qidiruv](https://phishdestroy.io/tgwitness/uz/docs/reference/search/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md)

**Preview.** `tgwitness search`, `context`, `messages`, `stats` and `export` read saved observations for scripts and AI agents. They cannot send anything to Telegram, change settings or modify the signed journal. `tgwitness index` and `tgwitness backup` ([below](https://phishdestroy.io/tgwitness/uz/docs/reference/cli/#index-and-backup)) work on a local data directory and need no token.

Bilan `--json`, stdout aniq bir JSON hujjatni uzatadi (`export` JSON Lines yozadi). Taraqqiyot, ishoralar va xatoliklar stderr ga yuboriladi. Chiqish kodlari barqaror:

| Kod | Ma'no |
| --- | --- |
| `0` | Muvaffaqiyat, bo'sh natija ham kiritilgan |
| `1` | Xato: erishib bo'lmaydigan panel, o'qib bo'lmaydigan ma'lumot, uzilgan eksport |
| `2` | Foydalanish xatosi yoki noto'g'ri so'rov: noto'g'ri sana, noma'lum parametr, qidiruv indeksi noto'g'ri |
| `3` | Hozirda mavjud emas: ish maydoni ishga tushirilgan panelda ochiq yoki panel keyinroq qayta urinishni so'raydi (cheklov, vaqt tugashi) |
| `4` | Kirish rad etildi: token yetishmayapti, muddati tugagan yoki bekor qilingan, doirasidan tashqaridagi suhbat, ruxsat berilmaydigan vosita |

## Ikki o'qish usuli

**Panel orqali (`--url`).** Buyruq xuddi shu doiradagi arxiv API-dan foydalanadi MCP. **More tools → Integrations → MCP** bo'limida ulanish yarating: ish maydonlari va suhbatlarni, vositalarni va amal qilish muddatini tanlang, so'ng tokenni bir marta nusxalang. Ulanish faqat o'qish uchun mo'ljallangan, faqat shu suhbatlar bilan cheklangan, daqiqasiga 60 ta so'rov bilan tezlik bo'yicha cheklangan va istalgan vaqtda bekor qilinishi yoki aylantirilishi mumkin. Panelga kirish tokenlari va Telegram ma'lumotlari bu yerda ishlamaydi.

```
export TGWITNESS_URL=https://panel.example.org      # default http://127.0.0.1:8787
export TGWITNESS_MCP_TOKEN=tgw_mcp_...              # or --token-file path
tgwitness search 'перевод карта' --json
```

Masofaviy panel uchun HTTPS talab etiladi; oddiy HTTP faqat uchun qabul qilinadi `127.0.0.1`, `localhost` va `::1`Proxy muhit o'zgaruvchilari e'tiborsiz qoldiriladi va yo'naltirishlar rad etiladi, shuning uchun token faqat siz bergan manzilga yetib boradi.

**To'xtatilgan ish maydonidan to'g'ridan-to'g'ri (`--data-dir`).** Tokensiz, to'liq mahalliy kirish huquqi bilan ma'lumotlar katalogini o'qiydi. Ma'lumotlar katalogining nusxasida yoki yig'ish to'xtatilgan paytda ishlating. Imzolangan yozuvlar hech qachon o'zgartirilmaydi; panel kabi, ish maydonini ochish uning hosil qilingan indekslari yangilanishi mumkin. Panel ish maydonini ochgan paytda, buyruq kod bilan chiqadi `3`; o'rniga paneldan o'qish. `--data-dir`, `TGWITNESS_DATA`, `./data/live` yoki buyrug'ni bajarayotgan o'rnatmaning ma'lumotlar katalogi ishlatiladi.

`--workspace ID` ish maydonini tanlaydi (bo'sh `default`). `tgwitness messages
--workspaces` o'qish huquqiga ega bo'lganlarini ro'yxatlaydi.

## Buyruqlar

| Buyruq | Natija |
| --- | --- |
| `tgwitness search QUERY [--chat ID] [--since] [--until] [--any] [--limit N] [--offset N]` | Avvalo eng yaxshi mos keladiganlar, so'z shakllari, aniq iboralar ikki nuqtali qavs ichida, domenlar va `@username` ([sintaksis](https://phishdestroy.io/tgwitness/uz/docs/reference/search/#search-syntax)) |
| `tgwitness search QUERY --exact [--before SEQ]` | Aniq matn, eng yangi avval, indeksisiz |
| `tgwitness context CHAT_ID MESSAGE_ID [--limit N] [--before SEQ]` | Saqlangan xabarlar har ikkala tomondagi o'n xabar ID oralig'ida |
| `tgwitness messages [--limit N] [--offset N]` | O'qishingiz mumkin bo'lgan suhbatlar |
| `tgwitness messages CHAT_ID [--since] [--until] [--limit N] [--before SEQ]` | Suhbatning saqlangan xabarlari, eng yangilari birinchi |
| `tgwitness messages CHAT_ID --message ID` | Har bir saqlangan versiya va bitta xabarning o'chirish yozuvi |
| `tgwitness stats [--chat ID] [--sender ID] [--since] [--until] [--top N]` | Quyida faoliyat statistikasi |
| `tgwitness export [--chat ID] [--since] [--until] [--output FILE]` | Saqlangan kuzatuvlar jurnal tartibida JSON Lines shaklida |

Sanalar `2026-10-01` (UTC yarim kecha) yoki vaqt zonasini hisobga olgan ISO vaqtlari, `2026-10-01T09:00+03:00`. Uchun `search`, `messages` va `export` ular kuzatuv vaqtini tanlaydilar. Sahifalar 50 tagacha yozuvni saqlaydi: kuzatib boring `next_offset` (`--offset`) reytingli qidiruv va `next_before` (`--before`) boshqa joylarda.

Ranked search stops at 1,000 results. The final page may be shorter than `--limit`. When more observations match, the last page says so (`truncated: true` with `--json`); narrow the query, chat or period.

Har bir xabar natijasi `untrusted_content: true` , ish maydoni, suhbat va xabar IDlari, jurnal ketma-ketligi, saqlangan yozuv xeshini va panel havolasini o'z ichiga oladi. Tahrirlar, o'chirish bildirishnomalari va `missing_on_recheck` alohida yozuvlardir. `stats` dagi qamrov qidiruv natijasi qaysi davrlarni qamrab olishini ko'rsatadi.

### Faoliyat statistikasi

`stats` bir suhbat, bir jo'natuvchi yoki doiradagi barcha suhbatlar bo'yicha saqlangan kuzatuvlarni hisoblaydi:

- xabarlar UTC soati va haftaning kunlari bo'yicha (dushanba birinchi), eng gavjum soatlar va kunlar;
- tahrirlangan, o'chirilgan va `missing_on_recheck` ulashishlar;
- xabar soni va birinchi hamda oxirgi xabar yuborilgan vaqtlari bilan yuboruvchilar;
- eng ko'p uchraydigan domenlar va `@handles`, saqlangan versiyalar bo'ylab har bir xabar uchun bir marta hisoblanadi;
- qamrov: `coverage.gap` yozuvlarni va butun ish maydoniga kirish uchun davrlarni ulangan kollektor yuragi bo'lmagan davrlar (`collector_liveness`).

Davr tanlaydi **Telegram tomonidan xabar vaqti**. Soat va hafta kunlari soni jo'natuvchining vaqt zonasini taxmin qilishga yordam beradi. Raqamlar jurnal so'rovi bo'yicha hisoblanadi va saqlanmaydi. Har bir natija, agar sizning kirishingiz ish maydonini qamrab olsa, qaysi jurnal sarlavhasini qamrab olishini ko'rsatadi. Paneldan o'qish besh soniyadan so'ng to'xtaydi, yoki `--timeout` sekundlar mahalliy (bo'sh joy 30); keyin `complete` noto'g'ri bo'ladi va `partial` o'qilmagan birinchi yozuvni nomlaydi. Bu holda faqat eng so'nggi yozuvlar hisoblanadi.

### Eksport

`export` saqlangan kuzatuv uchun bitta JSON ob'ektini yozadi (yangi xabarlar, snapshotlar, tahrirlar, tiklangan xabarlar, o'chirish bildirishnomalari, `missing_on_recheck` va saqlangan media yozuvlari jurnal tartibida yoziladi. Har bir satr boshqa natijalar kabi bir xil maydonlarga ega bo'lib, to'liq matnni o'z ichiga oladi. `--output`, fayl quyidagi yo'lda yoziladi `.partial` nomini oladi va faqat panel yakuniy yozuvidan keyin qayta nomlanadi; to'xtatilgan eksport hech qanday fayl qoldirmaydi va kod bilan chiqadi `1`. `--output` mavjud faylni hech qachon ustiga yozmaydi. `--output` va `--json`, stdout orqali qisqacha hisobot chiqariladi: yozuvlar soni, oxirgi jurnal ketma-ketligi va butun ish maydoni bo'yicha kirish huquqi bo'lsa, jurnal sarlavhasi.

Paneldan eksport qilish uchun **Eksport xabarlariga ruxsat beruvchi ulanish talab etiladi (faqat buyruq satri)** ; bu bo'shlig'ida tanlanmagan. Ushbu fayl ishlash nusxasi hisoblanadi; tasdiqlanadigan topshirish uchun **Exports** bo'limidagi imzolangan eksportdan foydalaning, uni `python -m tgwitness.verify` tekshiradi.

Panel har bir yozuvni, jumladan yakuniy yozuvni chiqarishdan oldin kirishni qayta tekshiradi. Bekor qilingan yoki muddati tugagan kirish to'liq bo'lmagan eksportga olib keladi. Keyingi yuklash orqali sahifalarni o'qish arxiv ishchisi limitini boshqa so'rovlar bilan bo'lishadi va cheklangan kutish muddatiga ega.

### Index and backup

These two commands read the data directory directly and take no token or `--url`.

| Buyruq | Natija |
| --- | --- |
| `tgwitness index status [--workspace ID] [--data-dir DIR] [--json]` | Search index state of one workspace or, by default, every workspace: mode, `ready`, `building` or `not built`, indexed and journal head sequence. Works while the panel runs |
| `tgwitness index rebuild [--workspace ID] [--data-dir DIR] [--json]` | Rebuilds the index from the first journal record. Rewrites only the derived index, never the signed journal. Exits with code `3` while the panel has the workspace open. Nothing is built when the workspace keeps its index in memory or has search off |
| `tgwitness backup FOLDER [--data-dir DIR] [--json]` | Copies the whole data directory into a new or empty folder outside it while the panel keeps running, and writes `backup-manifest.json` with every file's SHA-256 and the journal heads |

`index` accepts `--workspace default` or a workspace ID; the default is `all`. The backup skips temporary exports, SQLite sidecar files and lock files. The folder holds the Telegram session and signing keys, so keep it as private as the data directory. [Backup, restore, and capacity](https://phishdestroy.io/tgwitness/uz/docs/reference/deployment/#backup-restore-and-capacity) describes restoring and what the next start records.

## Agent mahorati

[`.agents/skills/tgwitness-cli/SKILL.md`](https://github.com/phishdestroy/TgWitness/blob/main/.agents/skills/tgwitness-cli/SKILL.md) agentga bu buyruqlarni qanday ishlatishni, yozuvlarni qanday keltirishni va ushlangan matnni qanday qayta ishlashni tushuntiradi. O'qiydigan agentlar `.agents/skills` Uni ombordan yuklab oling. Claude Code uchun, nusxa ko'chiring `tgwitness-cli` papkaga `.claude/skills/` loyihangizga nusxa ko'chiring yoki `~/.claude/skills/`.

## MCP va buyruq qatori

Ikkalasi ham bir xil ulanishlar, doira tekshiruvlari va cheklovlardan foydalanadi. MCP natijalari bitta 64 KiB sahifaga cheklangan, shuning uchun MCP ommaviy eksportni taklif qilmaydi; buyruq satri uni oqim sifatida chiqaradi. `get_activity_stats` har ikkala holatda ham mavjud.
