# Telegram · کمانڈ لائن

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

تلاش کریں، سیاق و سباق پڑھیں، سرگرمی کی گنتی کریں اور اسکرپٹس اور ایجنٹس سے محفوظ شدہ پیغامات برآمد کریں، --json آؤٹ پٹ، مستحکم ایگزٹ کوڈز اور محدود دائرہ کار کے ریڈ-اونلی ٹوکنز کے ساتھ۔

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

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

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

تلاش کریں، سیاق و سباق پڑھیں، سرگرمی کی گنتی کریں اور اسکرپٹس اور ایجنٹس سے محفوظ شدہ پیغامات برآمد کریں، --json آؤٹ پٹ، مستحکم ایگزٹ کوڈز اور محدود دائرہ کار کے ریڈ-اونلی ٹوکنز کے ساتھ۔

[ٹی جی وٹنس](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [دستاویزات](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![آرکائیو انٹیگریشنز](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074)

[صرف پڑھنے کے لیے MCP](https://phishdestroy.io/tgwitness/ur/docs/reference/mcp/) · [مکمل متن تلاش](https://phishdestroy.io/tgwitness/ur/docs/reference/search/) · [ویکی](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/ur/docs/reference/cli/#index-and-backup)) work on a local data directory and need no token.

کے ساتھ `--json`، stdout بالکل ایک JSON دستاویز منتقل کرتا ہے (`export` JSON Lines لکھتا ہے). پیش رفت، اشارے اور غلطیاں stderr پر جاتی ہیں۔ ایگزٹ کوڈز مستحکم ہیں:

| کوڈ | معنی |
| --- | --- |
| `0` | کامیابی، بشمول خالی نتیجہ |
| `1` | ناکامی: ناقابلِ رسائی پینل، ناقابلِ مطالعہ ڈیٹا، منقطع برآمد |
| `2` | استعمال میں غلطی یا غیر درست درخواست: غلط تاریخ، نامعلوم آپشن، تلاش کا انڈیکس درست نہیں |
| `3` | فی الحال دستیاب نہیں: ورک اسپیس ایک چلتی ہوئی پینل میں کھلا ہوا ہے، یا پینل بعد میں دوبارہ کوشش کرنے کو کہتا ہے (ریٹ لمیٹ، ٹائم آؤٹ) |
| `4` | رسائی سے انکار: ٹوکن غائب، ختم شدہ یا منسوخ شدہ، اس کے دائرہ اختیار سے باہر ایک چیٹ، ایک ایسا ٹول جس کی اجازت نہیں ہے۔ |

## پڑھنے کے دو طریقے

**پینل کے ذریعے (`--url`).** یہ کمانڈ اسی محدود دائرہ کار والے آرکائیو API کا استعمال کرتا ہے جیسا کہ MCP۔ **More tools → Integrations → MCP** میں ایک کنکشن بنائیں: ورک اسپیسز اور چیٹس، ٹولز اور میعادِ ختم ہونے کا انتخاب کریں، پھر ٹوکن کو ایک بار کاپی کریں۔ یہ کنکشن صرف پڑھنے کے لیے ہے، ان مخصوص چیٹس تک محدود ہے، فی منٹ 60 درخواستوں کی شرح سے محدود ہے اور کسی بھی وقت منسوخ یا گردش کیا جا سکتا ہے۔ پینل لاگ ان ٹوکنز اور ٹیلیگرام کی اسناد یہاں کام نہیں کرتیں۔

```
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
```

ایک ریموٹ پینل کو HTTPS کی ضرورت ہے؛ سادہ HTTP صرف کے لیے قبول کیا جاتا ہے `127.0.0.1`, `localhost` اور `::1`پراکسی ماحول کے متغیرات کو نظر انداز کیا جاتا ہے اور ری ڈائریکٹس کو مسترد کر دیا جاتا ہے، لہٰذا ٹوکن صرف آپ کے دیے گئے پتے تک پہنچتا ہے۔

**براہِ راست ایک روکے ہوئے ورک اسپیس (`--data-dir`) سے۔** ڈیٹا ڈائریکٹری کو مکمل مقامی رسائی کے ساتھ، ٹوکن کے بغیر پڑھتا ہے۔ اسے ڈیٹا ڈائریکٹری کی ایک کاپی پر یا جب کلیکشن رکاوٹ میں ہو استعمال کریں۔ دستخط شدہ ریکارڈز کبھی تبدیل نہیں ہوتے؛ پینل کی طرح، ورک اسپیس کھولنے سے اس کے مشتق انڈیکسز تازہ ترین ہو سکتے ہیں۔ جب پینل ورک اسپیس کھولے ہوئے ہو، تو کمانڈ کوڈ کے ساتھ نکلتا ہے `3`؛ اس کی بجائے پینل کے ذریعے پڑھیں۔ بغیر `--data-dir`, `TGWITNESS_DATA`, `./data/live` یا کمانڈ چلانے والی تنصیب کا ڈیٹا ڈائریکٹری استعمال کیا جاتا ہے۔

`--workspace ID` ایک ورک اسپیس منتخب کرتا ہے (ڈیفالٹ `default`). `tgwitness messages
--workspaces` وہ ورک اسپیس درج کرتا ہے جنہیں آپ پڑھ سکتے ہیں۔

## حکم

| کمانڈ | نتیجہ |
| --- | --- |
| `tgwitness search QUERY [--chat ID] [--since] [--until] [--any] [--limit N] [--offset N]` | سب سے بہترین ملاپ پہلے، لفظی شکلوں کے ساتھ، بالکل درست عبارتوں کو اقتباس میں، ڈومینز اور `@username` ([سینٹیکس](https://phishdestroy.io/tgwitness/ur/docs/reference/search/#search-syntax)) |
| `tgwitness search QUERY --exact [--before SEQ]` | بالکل اصل متن، نئے سے شروع، انڈیکس کے بغیر |
| `tgwitness context CHAT_ID MESSAGE_ID [--limit N] [--before SEQ]` | دونوں اطراف کے دس میسج آئی ڈیز کے اندر محفوظ کردہ پیغامات |
| `tgwitness messages [--limit N] [--offset N]` | وہ چیٹس جو آپ پڑھ سکتے ہیں |
| `tgwitness messages CHAT_ID [--since] [--until] [--limit N] [--before SEQ]` | چٹ کے محفوظ شدہ پیغامات، نئے ترین پہلے |
| `tgwitness messages CHAT_ID --message ID` | ہر محفوظ شدہ ورژن اور ایک پیغام کے حذف ہونے کا ریکارڈ |
| `tgwitness stats [--chat ID] [--sender ID] [--since] [--until] [--top N]` | سرگرمی کے اعدادوشمار، ذیل میں |
| `tgwitness export [--chat ID] [--since] [--until] [--output FILE]` | محفوظ شدہ مشاہدات JSON Lines کی شکل میں جرنل کی ترتیب کے مطابق |

تاریخیں ہیں `2026-10-01` (UTC نصف شب) یا وقت کے زون کے ساتھ ISO اوقات، `2026-10-01T09:00+03:00`۔ کے لیے `search`, `messages` اور `export` وہ مشاہدے کا وقت منتخب کرتے ہیں۔ صفحات میں زیادہ سے زیادہ 50 ریکارڈز ہوتے ہیں: فالو کریں `next_offset` (`--offset`) درجہ بندی شدہ تلاش کے لیے اور `next_before` (`--before`) کہیں اور۔

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.

ہر پیغام کے نتیجے میں `untrusted_content: true` ، ورک اسپیس، چیٹ اور پیغام کے آئی ڈی، جرنل کا تسلسل، محفوظ شدہ ریکارڈ کا ہیش اور ایک پینل لنک شامل ہوتا ہے۔ ترامیم، مٹانے کے نوٹس اور `missing_on_recheck` الگ الگ ریکارڈز ہیں۔ `stats` میں کوریج اُن ادوار کو دکھاتی ہے جن کے لیے تلاش کا نتیجہ بولتا ہے۔

### سرگرمی کے اعدادوشمار

`stats` محفوظ شدہ مشاہدات کی گنتی ایک چیٹ کے لیے، ایک بھیجنے والے کے لیے، یا دائرہ کار میں شامل ہر چیٹ کے لیے:

- پیغامات UTC گھنٹے اور ہفتے کے دن کے حساب سے (پہلا پیر)، سب سے مصروف گھنٹے اور دن؛
- ترمیم شدہ، حذف شدہ اور `missing_on_recheck` شیئرز؛
- پیغامات کی تعداد اور پہلا اور آخری پیغام بھیجنے کے اوقات کے ساتھ بھیجنے والے؛
- سب سے زیادہ عام ڈومینز اور `@handles`، اس کے محفوظ شدہ ورژنز میں ہر پیغام کے لیے ایک بار گنا گیا؛
- کوریج: `coverage.gap` ریکارڈز اور پورے ورک اسپیس تک رسائی کے لیے وقفے جب کنکٹڈ کلیکٹر کی دل کی دھڑکن بند ہو (`collector_liveness`).

یہ مدت **ٹیلیگرام کی طرف سے رپورٹ کردہ پیغام کے وقت کا** انتخاب کرتی ہے۔ گھنٹے اور ہفتے کے دنوں کی تعداد ایک بھیجنے والے کے ٹائم زون کا اندازہ لگانے میں مدد کرتی ہے۔ اعداد و شمار جرنل کی درخواست پر شمار کیے جاتے ہیں اور محفوظ نہیں کیے جاتے۔ ہر نتیجہ اس جرنل ہیڈ کا نام بتاتا ہے جسے یہ کور کرتا ہے جب آپ کی رسائی ورک اسپیس میں پھیلی ہوتی ہے۔ پانچ سیکنڈ کے بعد پڑھنا پینل کے ذریعے رک جاتا ہے، یا مقامی طور پر `--timeout` سیکنڈ کے بعد (ڈیفالٹ 30)؛ پھر `complete` غلط ہوتا ہے اور `partial` پہلے ریکارڈ کا نام بتاتا ہے جو پڑھا نہیں گیا تھا۔ اس صورت میں صرف تازہ ترین ریکارڈز گنے جاتے ہیں۔

### ایکسپورٹ

`export` ہر محفوظ شدہ مشاہدے کے لیے ایک JSON آبجیکٹ لکھتا ہے (نئے پیغامات، اسنیپ شاٹس، ترمیمات، بازیافت شدہ پیغامات، حذف کرنے کے نوٹس، `missing_on_recheck` اور محفوظ شدہ میڈیا ریکارڈز) جرنل کی ترتیب میں۔ ہر لائن میں دیگر نتائج کی طرح وہی فیلڈز ہوتے ہیں، مکمل متن کے ساتھ۔ کے ساتھ `--output`، فائل ایک کے تحت لکھی جاتی ہے `.partial` نام اور دوبارہ نام صرف پینل کے مکمل ریکارڈ کے بعد لکھا جاتا ہے؛ ایک منقطع ایکسپورٹ کوئی فائل نہیں چھوڑتا اور کوڈ کے ساتھ نکل جاتا ہے `1`. `--output` موجودہ فائل کو کبھی اووررائٹ نہیں کرتا۔ کے ساتھ `--output` اور `--json` کے ساتھ، stdout ایک خلاصہ دکھاتا ہے: ریکارڈز کی تعداد، آخری جرنل ترتیب اور پورے ورک اسپیس تک رسائی کے لیے، جرنل ہیڈ۔

پینل کے ذریعے ایکسپورٹ کے لیے ایک ایسے کنکشن کی ضرورت ہوتی ہے جو **پیغامات کو ایکسپورٹ کرنے کی اجازت دیتا ہو (صرف کمانڈ لائن)** ؛ یہ پہلے سے منتخب نہیں ہوتا۔ یہ فائل ایک کام کرنے والی کاپی ہے؛ تصدیق شدہ حوالگی کے لیے **Exports** میں موجود دستخط شدہ ایکسپورٹ استعمال کریں، جسے `python -m tgwitness.verify` چیک کرتا ہے۔

پینل ہر ریکارڈ کو جاری کرنے سے پہلے رسائی کی دوبارہ جانچ کرتا ہے، بشمول تکمیل ریکارڈ کے۔ منسوخ شدہ یا میعاد ختم شدہ رسائی ایک نامکمل برآمد چھوڑ دیتی ہے۔ سست صفحہ خوانی دیگر استفسارات کے ساتھ آرکائیو ورکر کی حد شیئر کرتی ہے اور اس کا انتظار محدود ہوتا ہے۔

### Index and backup

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

| کمانڈ | نتیجہ |
| --- | --- |
| `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/ur/docs/reference/deployment/#backup-restore-and-capacity) describes restoring and what the next start records.

## ایجنٹ کی مہارت

[`.agents/skills/tgwitness-cli/SKILL.md`](https://github.com/phishdestroy/TgWitness/blob/main/.agents/skills/tgwitness-cli/SKILL.md) ایجنٹ کو بتاتا ہے کہ ان کمانڈز کو کیسے استعمال کرنا ہے، ریکارڈز کا حوالہ کیسے دینا ہے اور حاصل کردہ متن کے ساتھ کیسے پیش آنا ہے۔ ایجنٹس جو پڑھتے ہیں `.agents/skills` اسے ریپوزیٹری چیک آؤٹ سے لوڈ کریں۔ Claude Code کے لیے، کاپی کریں `tgwitness-cli` فولڈر میں `.claude/skills/` اپنے پروجیکٹ میں `~/.claude/skills/`.

## MCP اور کمانڈ لائن

دونوں ایک ہی کنکشنز، اسکوپ چیکس اور حدود استعمال کرتے ہیں۔ MCP کے نتائج ایک 64 KiB صفحے تک محدود ہیں، لہٰذا MCP کسی بھی بلک ایکسپورٹ کی سہولت فراہم نہیں کرتا؛ کمانڈ لائن اسے اسٹریم کرتی ہے۔ `get_activity_stats` دونوں کے لیے دستیاب ہے۔
