Telegram · কমান্ড লাইন

টিজিউইটনেস / ডকুমেন্টেশন

শুধুমাত্র-পঠনযোগ্য MCP · পূর্ণ-পাঠ অনুসন্ধান · উইকি

প্রিভিউ। tgwitness search, context, messages, stats এবং export পড়ুন স্ক্রিপ্ট এবং AI এজেন্টদের জন্য সংরক্ষিত পর্যবেক্ষণ। তারা টেলিগ্রামে কিছুই পাঠাতে পারে না, সেটিংস পরিবর্তন করতে পারে না বা স্বাক্ষরিত জার্নাল সংশোধন করতে পারে না।

সহ --json, stdout ঠিক একটি JSON ডকুমেন্ট বহন করে (export JSON Lines লিখে)। প্রগ্রেস, ইঙ্গিত এবং ত্রুটি stderr-এ যায়। এক্সিট কোড স্থিতিশীল:

পড়ার দুইটি উপায়#

প্যানেলের মাধ্যমে (--url)। কমান্ডটি MCP-এর মতো একই স্কোপড আর্কাইভ API ব্যবহার করে। Integrations → MCP-এ একটি সংযোগ তৈরি করুন: ওয়ার্কস্পেস এবং চ্যাট, টুলস এবং মেয়াদোত্তীর্ণ সময় নির্বাচন করুন, তারপর টোকেন একবার কপি করুন। সংযোগটি শুধুমাত্র-পঠনযোগ্য, শুধুমাত্র সেই চ্যাটগুলোর জন্য সীমাবদ্ধ, প্রতি মিনিটে ৬০টি অনুরোধে রেট-লিমিটেড এবং যে কোনো সময় বাতিল বা রোট করা যেতে পারে। প্যানেল লগইন টোকেন এবং টেলিগ্রাম ক্রেডেনশিয়াল এখানে কাজ করে না।

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 প্রয়োজন; শুধুমাত্র plain HTTP গ্রহণযোগ্য 127.0.0.1, localhost এবং ::1প্রক্সি পরিবেশ ভেরিয়েবলগুলো উপেক্ষিত এবং রিডাইরেক্টগুলো প্রত্যাখ্যাত, তাই টোকেন শুধুমাত্র আপনি যে ঠিকানা দেন সেখানে পৌঁছায়।

থামানো ওয়ার্কস্পেস থেকে সরাসরি (--data-dir)। টোকেন ছাড়াই সম্পূর্ণ স্থানীয় অ্যাক্সেসের সাথে ডেটা ডিরেক্টরি পড়ে। ডেটা ডিরেক্টরির একটি অনুলিপি বা সংগ্রহ থামিয়ে থাকা অবস্থায় এটি ব্যবহার করুন। স্বাক্ষরিত রেকর্ডগুলি কখনোই পরিবর্তিত হয় না; প্যানেলের মতো, একটি ওয়ার্কস্পেস খুললে এর ডেরাইভড ইনডেক্সগুলো আপডেট হতে পারে। যখন প্যানেল ওয়ার্কস্পেস খোলা থাকে, কমান্ডটি কোড 3; বরং প্যানেলের মাধ্যমে পড়ুন। ছাড়া --data-dir, TGWITNESS_DATA, ./data/live অথবা কমান্ডটি চালানো ইনস্টলেশনের ডেটা ডিরেক্টরিটি ব্যবহার করা হয়।

--workspace ID একটি ওয়ার্কস্পেস নির্বাচন করে (ডিফল্ট default). tgwitness messages --workspaces আপনি যেগুলো পড়তে পারেন সেগুলো তালিকাভুক্ত করে।

কমান্ডসমূহ#

তারিখগুলো 2026-10-01 (UTC মধ্যরাত) অথবা টাইমজোনসহ ISO সময়, 2026-10-01T09:00+03:00. জন্য search, messages এবং export তারা পর্যবেক্ষণের সময় নির্বাচন করে। পৃষ্ঠাগুলো সর্বোচ্চ ৫০টি রেকর্ড ধারণ করে: অনুসরণ করুন next_offset (--offset) র‌্যাঙ্কড অনুসন্ধানের জন্য এবং next_before (--before) অন্যত্র।

র‍্যাঙ্কড অনুসন্ধান 1,000টি ফলাফলে থেমে যায়। চূড়ান্ত পৃষ্ঠা --limit-এর চেয়ে ছোট হতে পারে; যখন আরও মিলিত পর্যবেক্ষণ থাকে, তখন অনুসন্ধান, চ্যাট বা সময়সীমা সংকীর্ণ করুন।

প্রতিটি বার্তার ফলাফল বহন করে untrusted_content: true, ওয়ার্কস্পেস, চ্যাট এবং মেসেজ আইডি, জার্নাল ক্রম, সংরক্ষিত রেকর্ড হ্যাশ এবং একটি প্যানেল লিঙ্ক। সম্পাদনা, মুছে ফেলার বিজ্ঞপ্তি এবং missing_on_recheck সম্পাদনা, মুছে ফেলার বিজ্ঞপ্তি এবং ___ পৃথক রেকর্ড। কোনো রেকর্ডের অনুপস্থিতি কোনো ঘটনা কখনোই ঘটেনি তা প্রমাণ করে না।

সক্রিয়তার পরিসংখ্যান#

stats একটি চ্যাট, একটি প্রেরক, অথবা স্কোপের মধ্যে থাকা প্রতিটি চ্যাটের সংরক্ষিত পর্যবেক্ষণগুলো গণনা করে:

• UTC ঘণ্টা ও সপ্তাহের দিন (সোমবার প্রথম) অনুযায়ী বার্তা, সবচেয়ে ব্যস্ত ঘণ্টা ও দিন;
• সম্পাদিত, মুছে ফেলা এবং missing_on_recheck শেয়ার;
• বার্তা সংখ্যা এবং প্রথম ও শেষ বার্তার সময়সহ প্রেরকরা;
• সবচেয়ে ঘন ঘন ডোমেইন এবং @handles, এর সংরক্ষিত সংস্করণগুলো জুড়ে প্রতিটি বার্তায় একবার গণনা করা হয়েছে;
• কভারেজ: coverage.gap রেকর্ড করে এবং পুরো ওয়ার্কস্পেসে অ্যাক্সেসের জন্য, সংযুক্ত কালেক্টর হার্টবিট ছাড়া সময়কাল (collector_liveness).

এই সময়সীমা টেলিগ্রাম দ্বারা রিপোর্ট করা বার্তার সময় নির্বাচন করে। ঘণ্টা ও সপ্তাহের দিনের গণনা প্রেরকের সময় অঞ্চল অনুমান করতে সাহায্য করতে পারে; তবে তা নিশ্চিত করে না। সংখ্যাগুলো জার্নাল থেকে অনুরোধের ভিত্তিতে গণনা করা হয় এবং সংরক্ষণ করা হয় না। প্রতিটি ফলাফল সেই জার্নাল হেডের নাম উল্লেখ করে যা আপনার অ্যাক্সেস ওয়ার্কস্পেস জুড়ে বিস্তৃত হলে তা কভার করে। প্যানেলের মাধ্যমে পাঁচ সেকেন্ডের পর পড়া বন্ধ হয়ে যায়, অথবা --timeout স্থানীয়ভাবে সেকেন্ড (ডিফল্ট ৩০); তারপর complete মিথ্যা এবং partial পড়তে না হওয়া প্রথম রেকর্ডের নাম দেয়। সেক্ষেত্রে শুধুমাত্র সবচেয়ে সাম্প্রতিক রেকর্ডগুলোই গণনা করা হয়।

রপ্তানি#

export প্রতি সংরক্ষিত পর্যবেক্ষণের জন্য একটি JSON অবজেক্ট লেখে (নতুন বার্তা, স্ন্যাপশট, সম্পাদনা, পুনরুদ্ধারকৃত বার্তা, মুছে ফেলার বিজ্ঞপ্তি, missing_on_recheck এবং সংরক্ষিত মিডিয়া রেকর্ড) জার্নাল ক্রমে। প্রতিটি লাইনে অন্যান্য ফলাফলের মতোই ক্ষেত্রসমূহ রয়েছে, সম্পূর্ণ পাঠ্যসহ। With --output, ফাইলটি একটি .partial নাম এবং নাম পরিবর্তন করা হয় শুধুমাত্র প্যানেলের সমাপ্তি রেকর্ডের পর; একটি বিঘ্নিত এক্সপোর্ট কোনো ফাইল রেখে যায় না এবং কোড নিয়ে প্রস্থান করে 1. --output কখনই বিদ্যমান কোনো ফাইল ওভাররাইট করে না। With --output এবং --json, stdout-এ একটি সারসংক্ষেপ দেখায়: রেকর্ডের সংখ্যা, শেষ জার্নাল ক্রম এবং, পুরো ওয়ার্কস্পেস অ্যাক্সেসের জন্য, জার্নাল হেড।

প্যানেলের মাধ্যমে রপ্তানি করতে একটি সংযোগ প্রয়োজন যা 'বার্তা রপ্তানি' (শুধুমাত্র কমান্ড লাইন) অনুমতি দেয়; এটি ডিফল্টভাবে নির্বাচিত নয়। এই ফাইলটি একটি কার্যকরী কপি, প্রমাণ নয়: যাচাইযোগ্য হস্তান্তরের জন্য Exports-এ স্বাক্ষরিত রপ্তানি ব্যবহার করুন, যা python -m tgwitness.verifyচেক করে।

প্যানেল প্রতিটি রেকর্ড, সমাপ্তি রেকর্ড সহ, প্রেরণের আগে অ্যাক্সেস পুনরায় যাচাই করে। বাতিল বা মেয়াদোত্তীর্ণ অ্যাক্সেস একটি অসম্পূর্ণ রপ্তানি রেখে যায়। অলস পৃষ্ঠা পড়া অন্যান্য কোয়েরির সাথে আর্কাইভ ওয়ার্কার সীমা ভাগ করে এবং একটি সীমিত অপেক্ষার সময় থাকে।

এজেন্ট দক্ষতা#

.agents/skills/tgwitness-cli/SKILL.md এজেন্টকে জানায় কীভাবে এই কমান্ডগুলো ব্যবহার করতে হয়, কীভাবে রেকর্ড উদ্ধৃত করতে হয় এবং ধরা পড়া টেক্সট কীভাবে পরিচালনা করতে হয়। এজেন্টরা যারা পড়ে .agents/skills এটি একটি রিপোজিটরি চেকআউট থেকে লোড করুন। Claude Code-এর জন্য, কপি করুন tgwitness-cli ফোল্ডার থেকে .claude/skills/ আপনার প্রকল্পেফোল্ডারটি কপি করুন অথবা ~/.claude/skills/.

MCP এবং কমান্ড লাইন#

উভয়ই একই সংযোগ, স্কোপ চেক এবং সীমা ব্যবহার করে। MCP ফলাফল একটি 64 KiB পৃষ্ঠায় সীমাবদ্ধ, তাই MCP কোনো বাল্ক এক্সপোর্ট অফার করে না; কমান্ড লাইন থেকে এটি স্ট্রিম করে। get_activity_stats উভয়ের জন্যই উপলব্ধ।