echocat-skill-panel 3.0 দিয়ে DSH Skills পরিচালনা ও ট্র্যাক করুন

প্রকল্প পরিচিতি

echocat-skill-panel 3.0 হলো DSH Desktop Beta-এর জন্য তৈরি একটি cordis প্লাগইন। এটি সেশন ইভেন্ট স্ট্রিম থেকে প্রতিটি কথোপকথন পর্বে বাস্তবে কোন কোন skill ব্যবহৃত হয়েছে তা নির্ধারণ করে, মডেলের নিজের রিপোর্টের ওপর নির্ভর করে না।

skill মডেল স্বয়ংক্রিয়ভাবে কল করুক, ব্যবহারকারী /name দিয়ে ম্যানুয়ালি কল করুক, অথবা ওই পর্বে কোনো skill কল না হোক, প্লাগইন প্রতিটি ক্ষেত্রের উপযুক্ত ফলাফল দেখায়।

তিনটি ইন্টারফেসের কাজ

প্লাগইনের তিনটি প্রবেশপথ একই ডেটা ব্যবহার করে, তবে ভিন্ন কাজের জন্য উপযোগী:

• ইনপুট বক্সের ওপরের বার: সবসময় এক লাইনের ফলাফল দেখায়; ক্লিক করলে সম্পূর্ণ রিপোর্ট খোলা যায়। এক ক্লিকে skill রেফারেন্স করার সুবিধা কেবল এই ইন্টারফেসেই রয়েছে।
• বাম পাশের আইকন: স্থায়ী প্রবেশপথ হিসেবে কাজ করে; ক্লিক করলে মাঝের অংশে প্যানেল খোলে।
• মাঝের প্যানেল: সম্পূর্ণ রিপোর্ট ও skill ডিরেক্টরি দেখার জন্য ব্যবহৃত হয়।

প্লাগইন ইনস্টল

পদ্ধতি এক: GitHub সোর্স থেকে ইনস্টল

সম্পূর্ণ প্যাকেজ পাওয়া যায় বলে সোর্স থেকে ইনস্টল করাই সুপারিশ করা হয়। PowerShell-এ চালান:

git clone https://github.com/VDERR/echocat-skill-panel-3.0.git
cd echocat-skill-panel-3.0
& ".\安装-3.0.ps1"

ইনস্টলেশন স্ক্রিপ্ট ধারাবাহিকভাবে profile তালিকার ব্যাকআপ নেবে, মিরর প্রক্রিয়া চালাবে, পুরোনো প্যাকেজের নাম পরিষ্কার করবে, লিংক তৈরি করবে, manifest পরিবর্তন করবে এবং pnpm install চালাবে।

পদ্ধতি দুই: npm বা DSH-এর মাধ্যমে ইনস্টল

প্লাগইনটি npm-এ প্রকাশিত হয়েছে; প্যাকেজের নাম echocat-skill-panel-3.0। DSH-কে ইনস্টল সম্পন্ন করতে দিতে পারেন:

dsh plugin --profile web add echocat-skill-panel-3.0

এটি সরাসরি profile ডিরেক্টরিতেও ইনস্টল করতে পারেন:

npm install echocat-skill-panel-3.0

@deepseek-ai/dsh-llm এবং @deepseek-ai/schemastery-কে ঐচ্ছিক peer dependencies হিসেবে ঘোষণা করা হয়েছে। এগুলো DSH runtime সরবরাহ করে, তাই npm হোস্টের সংস্করণের বিকল্প হিসেবে অতিরিক্ত কপি ডাউনলোড করবে না।

ইনস্টলেশন সম্পন্ন হলে DSH Desktop Beta অবশ্যই পুনরায় চালু করতে হবে। host-এর কোড চালুর সময় মেমরিতে লোড হয়, তাই host পরিবর্তন করলেও পুনরায় চালু করা আবশ্যক। শুধু ক্লায়েন্ট কোড পরিবর্তন করলে পেজ রিফ্রেশ করলেই ক্লায়েন্ট bundle আবার নেওয়া যাবে।

রোলব্যাক ও ইনস্টলেশন নিরাপত্তা

সোর্স ইনস্টলেশন স্ক্রিপ্ট কাজ শুরুর আগে profile তালিকার ব্যাকআপ নেয়। পুনরুদ্ধার করতে স্ক্রিপ্টের -Rollback প্যারামিটার ব্যবহার করুন। ম্যানুয়াল ইনস্টলেশন, আনইনস্টল রোলব্যাক এবং অ্যাপ চালু হতে বাধা দিতে পারে এমন কঠোর নিয়মের ক্ষেত্রে রিপোজিটরির ইনস্টলেশন নির্দেশিকা অনুসরণ করুন।

একটি skill ইনস্টল

প্লাগইনের ইনস্টলেশন ইন্টারফেস খুলে লেখক প্রদত্ত সম্পূর্ণ ঠিকানা সরাসরি পেস্ট করতে পারেন; রিপোজিটরি, branch ও সাবডিরেক্টরি আলাদাভাবে পূরণ করার প্রয়োজন নেই।

উদাহরণস্বরূপ, নিচের GitHub সাবডিরেক্টরি ঠিকানাটি পেস্ট করুন:

https://github.com/owner/repo/tree/main/skills/my-skill

host ঠিকানার ধরন শনাক্ত করে ক্লোন করা নাকি ডাউনলোড করা উচিত তা নির্ধারণ করবে এবং লিংক থেকে branch ও সাবডিরেক্টরি পার্স করবে। প্লাগইন সমর্থিত ইনপুটের ধরনগুলো হলো:

• GitHub রিপোজিটরির হোমপেজের ঠিকানা।
• রিপোজিটরির কোনো ফোল্ডারের লিংক।
• SKILL.md ফাইলের লিংক।
• ZIP-এর সরাসরি লিংক।
• owner/repo ফরম্যাট।
• SSH ঠিকানা।
• স্থানীয় .md বা .zip ফাইল আপলোড।
• সম্পূর্ণ SKILL.md কনটেন্ট সরাসরি পেস্ট করা।

লক্ষ্য স্থানে একই নামের skill আগে থেকেই থাকলে প্লাগইন নীরবে সেটি ওভাররাইট করবে না; আগে ব্যাকআপ তৈরি করে তারপর প্রতিস্থাপন করবে। skill মুছে ফেললেও ফাইল ব্যাকআপ ডিরেক্টরিতে যাবে, স্থায়ীভাবে হার্ড ডিলিট হবে না।

প্রতিটি কথোপকথন পর্বে কোন skill ব্যবহৃত হয়েছে তা দেখা

স্বাভাবিকভাবে DSH ব্যবহার করে কথোপকথন শুরু করুন। প্রতিটি পর্ব শেষ হলে প্লাগইন সেশন ইভেন্ট স্ট্রিমের ভিত্তিতে রিপোর্ট তৈরি করবে এবং একবার সিস্টেমের নেটিভ নোটিফিকেশন দেখাবে।

1. প্রথমে একটি কথোপকথন পর্ব সম্পন্ন করুন।
2. ইনপুট বক্সের ওপরের বারে সংক্ষিপ্ত ফলাফল দেখুন।
3. বারে ক্লিক করে ওই পর্বের সম্পূর্ণ রিপোর্ট খুলুন।
4. বাম পাশের আইকন দিয়েও মাঝের প্যানেলে গিয়ে রিপোর্ট ও skill ডিরেক্টরি দেখা যায়।

এই শনাক্তকরণ পদ্ধতিতে মডেলকে উত্তরে নিজে ব্যবহৃত skill ঘোষণা করতে হয় না। তাই মডেল জানাতে ভুলে গেলেও প্যানেল ইভেন্ট রেকর্ডের ভিত্তিতে ফলাফল দেখাবে।

এক ক্লিকে skill রেফারেন্স ও কল

ইনপুট বক্সের ওপরের বারই এক ক্লিকে রেফারেন্স করার একমাত্র ইন্টারফেস। বারটি খুলে লক্ষ্য skill-এর কার্ডে রেফারেন্স-এ ক্লিক করলে প্লাগইন সংশ্লিষ্ট কমান্ডটি বর্তমান খসড়ায় যোগ করবে:

/নাম 

এরপর Enter চাপলে ম্যানুয়াল কমান্ডের মাধ্যমে ওই skill কল হবে। skill সফলভাবে ইনস্টল হওয়ার পর প্রদর্শিত বার্তাতেও একই বোতাম থাকে, তাই ইনস্টল শেষ হওয়ার সঙ্গে সঙ্গেই সেটি রেফারেন্স করে ব্যবহার করা যায়।

চীনা প্রদর্শন নাম সেট করা

প্লাগইন skill-এর নিজস্ব meta.yaml-এর display-name-zh ফিল্ড ব্যবহার করে চীনা নাম দেখায়। ইনস্টলের সময় এটি পূরণ করতে পারেন, অথবা ইনস্টল শেষ হওয়ার পর skill কার্ড থেকে পরিবর্তন করতে পারেন।

• চীনা নাম পূরণ করলে প্যানেল অগ্রাধিকার দিয়ে চীনা নাম দেখাবে।
• ফিল্ডটি খালি রাখলে চীনা প্রদর্শন নাম মুছে যাবে।
• /নাম কমান্ডে ASCII কোডই ব্যবহৃত হবে; চীনা প্রদর্শন নাম এতে কোনো প্রভাব ফেলবে না।

চীনা নামহীন skill-এর জন্য প্লাগইন স্বয়ংক্রিয়ভাবে প্রদর্শন নাম অনুবাদ করে ক্যাশও করতে পারে।

উন্নত ব্যবহারের পরামর্শ

শুধু-পঠন মোড বুঝে নিন

হোস্ট পরিবেশে লেখার অনুমতি না থাকলে প্লাগইন স্বয়ংক্রিয়ভাবে শুধু-পঠন অবস্থায় চলে যাবে এবং কারণ জানাবে। তখনও রিপোর্ট ও ডিরেক্টরি দেখা যাবে, তবে ইনস্টল, পরিবর্তন বা মুছে ফেলার কাজ হোস্টের অনুমতির সীমাবদ্ধতার অধীন থাকবে।

ভুল操作 এড়াতে ব্যাকআপ ব্যবহার করুন

একই নামের skill প্রতিস্থাপনের আগে স্বয়ংক্রিয়ভাবে ব্যাকআপ নেওয়া হয়; মুছে ফেলার কাজেও ফাইল হার্ড ডিলিট হয় না। আপগ্রেড বা অজানা উৎসের skill পরীক্ষামূলকভাবে ইনস্টল করার আগে ব্যাকআপ ডিরেক্টরি ও profile তালিকার ব্যাকআপ ব্যবহারযোগ্য আছে কি না নিশ্চিত করুন, যাতে প্রয়োজনে ফিরিয়ে আনা যায়।

ক্লায়েন্ট ও host-এর পরিবর্তন আলাদা করুন

পেজ খোলার সময় ক্লায়েন্ট bundle আবার নেওয়া হয়, তাই শুধু ক্লায়েন্ট পরিবর্তন করলে সাধারণত পেজ রিফ্রেশ করাই যথেষ্ট। host-এর কনটেন্ট DSH চালুর সময় মেমরিতে লোড হয়; host পরিবর্তন বা প্লাগইন ইনস্টল সম্পন্ন হলে DSH Desktop Beta পুনরায় চালু করা উচিত।

ডার্ক থিম ও অন্যান্য কনফিগারেশন চালু করা

প্লাগইন ডার্ক থিম, প্রতিটি পর্ব শেষে সিস্টেম নোটিফিকেশন, স্বয়ংক্রিয় অনুবাদ ক্যাশ এবং সম্পূর্ণ কনফিগারেশন সমর্থন করে। নির্দিষ্ট বিকল্প ও ইনস্টলেশন সীমাবদ্ধতার জন্য ইনস্টলেশন নির্দেশিকা দেখুন।

উন্নয়ন ও বিল্ড

src/client/ পরিবর্তন করলে ক্লায়েন্ট বিল্ড আউটপুট পুনরায় তৈরি করতে হবে:

node tools/build-client.mjs

lib/client.js রিপোজিটরিতে জমা দেওয়া আবশ্যক বিল্ড আউটপুট, কারণ লক্ষ্য মেশিনে টুলচেইন নাও থাকতে পারে। src/client/-এর পরিবর্তন ও পুনর্নির্মিত ফাইল একই কমিটে রাখতে হবে; তা না হলে verify-install.mjs-এর bundle ও প্যাকেজ সামঞ্জস্য যাচাই ব্যর্থ হবে।

প্রজেক্ট চালানোর সময় অতিরিক্ত কোনো dependency নেই; উভয় peer dependencies-ই host সরবরাহ করে। আর্কিটেকচার ডিজাইন, ইনস্টলেশন ইঞ্জিনের নিরাপত্তা নিয়ম, বাস্তবায়নের ঝুঁকি এবং পরীক্ষার বিস্তারিত জানতে ডিজাইন নীতিমালা দেখুন।

সারসংক্ষেপ

echocat-skill-panel 3.0 DSH Desktop Beta-এর মধ্যে skill কল ট্র্যাকিং, ডিরেক্টরি ব্রাউজ, ইনস্টল, রেফারেন্স, চীনা প্রদর্শন এবং নিরাপদ আনইনস্টল একত্র করেছে। প্লাগইন ইনস্টল করে অ্যাপ পুনরায় চালু করার পর ইনপুট বক্সের ওপরের বার থেকে প্রতিটি পর্বের রিপোর্ট দ্রুত দেখা যাবে এবং রেফারেন্স বোতাম দিয়ে লক্ষ্য skill খসড়ায় যোগ করা যাবে। প্রকল্পটি MIT লাইসেন্সের অধীনে প্রকাশিত।