# 👥 dsh-background-agents - **1024 स्टोर चैनल**: एक बार `npm i -g dsh1024`, फिर `dsh1024 plugin --profile web add dsh-background-agents` ([deepseek1024.com](https://deepseek1024.com) इंस्टॉल रैंकिंग में गिना जाता है)। **DeepSeek Harness के लिए इंटरैक्टिव लंबी-सत्र वाले बैकग्राउंड एजेंट और लगातार बने रहने वाले मल्टी-एजेंट टीम रूम — एक टिकाऊ चाइल्ड एजेंट शुरू करें जो काम करता रहे जबकि आप बातचीत जारी रखें।** *सत्रों के बीच सक्रिय बातचीत चलाएँ और एक टीम का समन्वय करें; सब कुछ harness के अपने स्टोरेज से रीस्टार्ट के बाद भी बना रहता है।* [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE) [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-background-agents) [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin) [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-background-agents.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章) [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/) [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#) [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-background-agents/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-background-agents/actions) [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-background-agents?label=version)](https://github.com/PerryLink/dsh-background-agents/releases) [![npm version](https://img.shields.io/npm/v/dsh-background-agents)](https://www.npmjs.com/package/dsh-background-agents) [![npm downloads](https://img.shields.io/npm/dm/dsh-background-agents)](https://www.npmjs.com/package/dsh-background-agents) [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)

--- ## अनुकूलता होस्ट `0.1.2-alpha.2` और बाद के संस्करण सत्र इवेंट शब्दावली पर बंद-विफल होते हैं, इसलिए यह प्लगइन वहाँ अपने केवल-लॉग तथ्य इवेंट (`background-agents/fact`, `team-room/fact`) नहीं लिखता: तथ्य लॉगर/पैनल चैनल से जाते हैं और प्रोजेक्शन खाली फोल्ड में बदल जाते हैं। पुरानी rc लाइनें (`0.1.1-rc.2` तक) ignorable-मार्कर अनुशासन बनाए रखती हैं। क्लाइंट आधा अब वर्तमान क्लाइंट पैकेज (`dsh-api-session-controller`, `dsh-client-web`) और वर्तमान सबएजेंट रिमोट (`interruptByParent`, क्लाइंट-निर्मित `requestId` के साथ `prompt`; पुराना `history` RPC हटा दिया गया — परिणाम झलकियाँ चाइल्ड सत्र के `conversation` प्रोजेक्शन से पढ़ी जाती हैं) का उपयोग करता है। 0.1.2-rc.1 (2026-09-04 को अनुकूलित): सत्र लिफ़ाफ़ा अपना ignorable फ़ील्ड केवल संग्रहीत-लॉग पठन संगतता के लिए रखता है - Session.append अभी भी इसे स्टैम्प नहीं कर सकता (तीसरा पैरामीटर केवल सतह इवेंट प्रकारों के लिए SurfaceIntent है, कभी विकल्प-बैग नहीं), इसलिए तथ्य-गेट व्यवहार अपरिवर्तित है। 0.1.3-alpha.1 (2026-09-06 को अनुकूलित): CI हार्नेस पिन मास्टर checkout (`d347e7039`) पर चला जाता है - session-persistence सेवा का हैंडल सीम (`open → read → close`)। प्रकाशित 0.1.2-rc.1 रनटाइम open() से पहले का है, इसलिए bg_result की कोल्ड रीड सीम का पता लगाकर load() पर फ़ॉलबैक करती है - दोनों लाइनों पर व्यवहार समान है। 2026-09-06 को dsh-v0.1.3-alpha.1 मास्टर checkout के विरुद्ध सत्यापित (पूर्ण गेट श्रृंखला + प्रोफ़ाइल इंस्टॉल स्मोक)। 0.1.5-alpha.1 (2026-09-09 को अनुकूलित): `SessionHandleReadResult` अब `{ eventState, events }` लौटाता है, इसलिए bg_result की कोल्ड रीड हैंडल सीम से `.events` डीस्ट्रक्चर करती है (प्रकाशित लाइन का `load()` फ़ॉलबैक अपरिवर्तित है)। CI हार्नेस पिन सार्वजनिक tag commit `5dda764ed3aa` पर चला जाता है (स्थानीय checkout 13 infra commits आगे है और CI से पहुँच से बाहर) और compat जाँचें alpha लाइन इंस्टॉल करती हैं। peers को `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0` तक बढ़ाया गया (prerelease-tuple नियम: अकेला पहला ब्राज़ `0.1.5-alpha.1` से मेल नहीं खाता) और devDeps `0.1.5-alpha.1` पर पिन हैं। 2026-09-09 को `dsh-v0.1.5-alpha.1` के विरुद्ध सत्यापित (पूर्ण गेट श्रृंखला)। पहले का `0.1.3-alpha.1` दावा अब अप्रचलित है: वह प्रीरिलीज़ दोनों peer ब्राज़ों से बाहर है। 0.1.5-rc.1 (2026-09-10 को अनुकूलित): निर्भरता पिन प्रकाशित 0.1.5-rc.1 लाइन पर चले जाते हैं; कोई seam परिवर्तन इस प्लगइन के व्यवहार को प्रभावित नहीं करता। 0.1.5-rc.2 (2026-09-11 को अनुकूलित): निर्भरता पिन प्रकाशित 0.1.5-rc.2 लाइन पर चले जाते हैं; कोई seam परिवर्तन इस प्लगइन के व्यवहार को प्रभावित नहीं करता। 0.1.6-alpha.2 (2026-09-18 को अनुकूलित): क्लाइंट सेशन सेवा ने अपना सबएजेंट-नेविगेशन कॉल हटा दिया, इसलिए यह क्रिया अब स्पष्ट रूप से बताती है कि नेविगेशन सेशन हेडर के स्वामित्व में है (`ui-subagent` की lineage सीट), चुपचाप विफल होने के बजाय; रूम पैनल अपना वर्तमान सेशन मुख्य-व्यू retention (`retainedBy.mainView`) से निकालता है क्योंकि `SessionListState.current` अब नहीं है। `agent/created` कैच-अप लिसनर अपनी 2 सेकंड सीमा के भीतर समकालिक रूप से लौटता है, और अपठनीय चाइल्ड लॉग खाली टेक्स्ट के बजाय `unavailable` बताता है। सेशन-लॉग फ़ैक्ट चैनल से मिलने वाले dashboard मेट्रिक्स इस लाइन पर **अनुपलब्ध** रहते हैं (गैर-सरफ़ेस फ़ैक्ट इवेंट पर अब भी ignore मार्कर नहीं लग सकता) — टिकाऊ रूम टेबल और पैनल का प्रोजेक्शन मान ही रिकॉर्ड हैं। 2026-09-18 को सत्यापित (दोनों typecheck + पूरी टेस्ट सूट); ब्राउज़र-दृश्य आधा भाग अभी **मशीन-सत्यापित नहीं** है। | सतह | स्थिति | |---|---| | Harness | DeepSeek Harness `dsh-v0.1.5-rc.2` (GitHub tag, 2026-09-11 को सत्यापित; dev और runtime पिन `0.1.5-rc.2`, peers `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0`) | | Node | `^22.19.0 \|\| >=24.0.0` | | प्लेटफ़ॉर्म | सभी (होस्ट टूल; स्टोरेज-डोमेन क्षमता के ज़रिए वैकल्पिक वेब साइडबार पैनल और टीम रूम) | | मॉडल | कोई भी (चाइल्ड पैरेंट का मार्ग लेते हैं; `childProvider`/`childModel` उसे बदलते हैं) | ## आपको क्या मिलता है `dsh-background-agents` DSH के फायर-एंड-फॉरगेट बैकग्राउंड *जॉब* को दो समन्वित सतहों में बदल देता है: 1. **पाँच स्टीयरिंग टूल** — `background_agent` आधिकारिक उप-एजेंट सीम पर एक टिकाऊ, जारी रहने योग्य चाइल्ड शुरू करता है (वैकल्पिक `tool_filter` — टूल हटाता है, कभी नए नहीं देता; `persona`; `max_depth`; `childProvider`/`childModel` मार्ग)। `bg_message` बाद का टर्न पहुँचाता है; `bg_list` स्थिति बताता है (या `parentId`/`depth` के साथ वंशज ट्री); `bg_result` नवीनतम परिणाम पाठ पढ़ता है (रीज़निंग फ़ॉलबैक को `textSource: 'reasoning'` चिह्नित किया जाता है); `bg_stop` रुकावट का अनुरोध करता है। 2. **प्रगति और संग्रह** — `autoReport` हर चाइल्ड टर्न के बाद एक थ्रॉटल्ड प्रगति पंक्ति इंजेक्ट करता है; `reportDelivery: wakeup` पैरेंट के निष्क्रिय होने पर पैरेंट टर्न शुरू करता है। निष्क्रियता स्वीप शांत चाइल्ड को संग्रहीत करता है और `bg_message` उन्हें फिर जगा देता है (`autoArchive: false` की स्थिति में शांत वॉचर को पार्क कर देता है)। 3. **डैशबोर्ड प्रोजेक्शन + वेब पैनल** — `backgroundAgents` सत्र प्रोजेक्शन पैरेंट लॉग को पंक्तियों में मोड़ता है; एक साइडबार पैनल लाइव स्थिति, जंप, संदेश, रोक और परिणाम झलक दिखाता है। सब कुछ टिकाऊ लॉग से फिर से बनता है — कोई अलग डेटाबेस नहीं। 4. **टीम रूम (v0.5.0+)** — `/room` कमांड परिवार और आठ `room_*` टूल लगातार मल्टी-एजेंट रूम बनाते हैं: सदस्य (हर एक स्वतंत्र सत्र), एक संदेश बस (निर्देशित/प्रसारण), एक साझा टास्क बोर्ड और एक साझा टाइमलाइन — `team_rooms` स्टोरेज डोमेन (SQLite या JSONL) में संग्रहीत और DSH रीस्टार्ट के बाद पुनर्प्राप्त। क्रॉस-सदस्य टास्क हैंडऑफ़ आधिकारिक अनुमोदन सीम से गुजरते हैं। ## त्वरित शुरुआत ```sh # 1. अपने प्रोफ़ाइल में बंडल इंस्टॉल करें dsh plugin --profile web add "github:PerryLink/dsh-background-agents#main" # या npm से (प्रकाशित रिलीज़) dsh plugin --profile web add dsh-background-agents # 2. पुनः प्रारंभ करें और पंक्ति सत्यापित करें dsh --profile web --dump-config | grep -A4 'id: background-agents' ``` बंडल पैच प्लगइन पंक्ति रखता है; `provider` अनिवार्य है। रेपो अपना बिल्ड आउटपुट (`lib/`) कमिट करता है, इसलिए git इंस्टॉल को बिल्ड चरण की आवश्यकता नहीं होती। प्लगइन को उप-एजेंट स्पाइन पहले से माउंट होना चाहिए (`@deepseek-ai/dsh-base` पर बना कोई भी प्रोफ़ाइल इसे रखता है)। टीम रूम वहीं माउंट होते हैं जहाँ स्टोरेज डोमेन (`@deepseek-ai/dsh-storage-domain`) बना हो; पाँच `bg_*` टूल इसके बिना भी काम करते हैं। फिर, किसी भी सत्र में, बस मॉडल से कहें — या टूल सीधे कॉल करें: ``` background_agent "watch the repo for test failures and keep me posted" (label: test-watch) bg_list bg_message "also check the snapshot tests now" bg_stop ``` ## इंस्टॉल और अनइंस्टॉल - **git चैनल** (नवीनतम `main`): `dsh plugin --profile web add "github:PerryLink/dsh-background-agents#main"` — `lib/` कमिटेड, कोई `prepare` या `allowBuilds` चरण नहीं। - **npm चैनल** (प्रकाशित रिलीज़): `dsh plugin --profile web add dsh-background-agents`। - **tarball चैनल**: इस रेपो में `pnpm pack`, फिर `dsh plugin --profile web add ./dsh-background-agents-.tgz`। - **अनइंस्टॉल**: `dsh plugin --profile web remove dsh-background-agents` (या प्रोफ़ाइल पैच से पंक्ति हटाएँ)। ## कॉन्फ़िगरेशन हर ट्यूनेबल एक सत्यापित Schemastery `Config` फ़ील्ड है — इसे cordis.yml में बदलें, कोड में कभी नहीं। केवल `provider` अनिवार्य है। | कुंजी | डिफ़ॉल्ट | अर्थ | |---|---|---| | `provider` | *(अनिवार्य)* | जारी रहने योग्य शुरुआत के लिए `ctx.subagents` प्रदाता नाम (`spawn`) | | `autoReport` | `true` | हर चाइल्ड टर्न के बाद पैरेंट में एक प्रगति पंक्ति इंजेक्ट करें | | `reportDelivery` | `quiet` | `quiet` पंक्ति को अगले मॉडल अनुरोध में जोड़ता है; `wakeup` पैरेंट निष्क्रिय होने पर पैरेंट टर्न शुरू करता है | | `reportThrottleMs` | `15000` | एक चाइल्ड की दो प्रगति इंजेक्शनों के बीच न्यूनतम अंतर | | `reportSummaryMaxChars` | `300` | इंजेक्ट की गई प्रगति पंक्ति के पाठ की कठोर सीमा (दीर्घवृत्त) | | `resultMaxChars` | `4000` | `bg_result` पाठ की कठोर सीमा (दीर्घवृत्त, `truncated` चिह्नित) | | `maxBackgroundAgents` | `4` | प्रति पैरेंट सत्र गैर-संग्रहीत बैकग्राउंड एजेंटों की कठोर सीमा | | `autoArchive` | `true` | निष्क्रिय-संग्रह टॉगल; `false` पर स्वीप कभी शांत चाइल्ड संग्रहीत नहीं करता | | `idleTimeoutMinutes` | `120` | वह निष्क्रियता विंडो जिसके बाद शांत चाइल्ड संग्रहीत होता है (`>= 1`) | | `idleSweepIntervalMs` | `60000` | संग्रह स्वीप अवधि | | `maxLabelChars` | `120` | प्रदर्शन-लेबल सीमा (दीर्घवृत्त) | | `childProvider` | *(विरासत)* | चाइल्ड मॉडल अनुरोधों का प्रदाता मार्ग | | `childModel` | *(विरासत)* | चाइल्ड मॉडल अनुरोधों का मॉडल id | | `maxChildDepth` | *(कोई नहीं)* | किसी शुरुआत के `max_depth` तर्क की कॉन्फ़िग सीमा | | `allowedChildTools` | *(कोई नहीं)* | `tool_filter` नामों की अनुमति-सूची; खाली/अनुपस्थित = कोई सीमा नहीं | | `maxRooms` | `16` | प्रोफ़ाइल में टीम रूम की कठोर सीमा | | `maxMembersPerRoom` | `8` | प्रति रूम सदस्यों की कठोर सीमा | | `maxRoomsPerMember` | `4` | एक सदस्य सत्र कितने रूम जॉइन कर सकता है इसकी कठोर सीमा | | `busRetention` | `200` | प्रति रूम रखे गए बस संदेश | | `timelineRetention` | `500` | प्रति रूम रखे गए टाइमलाइन ईवेंट | | `taskRetention` | `50` | प्रति रूम रखे गए पूर्ण कार्य | | `maxMessageChars` | `4000` | एक रूम संदेश के पाठ की कठोर सीमा (ऊपर अस्वीकार, कभी काटा नहीं) | | `injectRoomBrief` | `true` | सदस्य सत्रों में संक्षिप्त रूम परिचय इंजेक्ट करें (जॉइन + रिज़्यूम) | | `roomOpenTimeoutMs` | `15000` | `team_rooms` स्टोरेज डोमेन खुलने की अधिकतम प्रतीक्षा; समय समाप्ति पर हर रूम ऑपरेशन लटकने के बजाय `store-unavailable` से स्पष्ट विफल होता है | | `allowUnmarkedFacts` | `false` | `ignorable` मार्कर छोड़ने वाले होस्ट पर तथ्य ईवेंट बलपूर्वक लिखें (खतरनाक: बिना मार्कर वाले तथ्य अन्य होस्ट पर सत्र अप्राप्य बनाते हैं); डिफ़ॉल्ट पहचान-और-छोड़ है | | `observability` | `true` | प्रति-एजेंट लागत/स्थिति निरीक्षण स्विच: प्रत्येक चाइल्ड टर्न पर एक `metrics` तथ्य (टोकन, टर्न वॉल टाइम, त्रुटि फ़्लैग) कैप्चर करें और लागत पैनल के लिए हर पंक्ति के `metrics` योग में जोड़ें; `false` कैप्चर बंद कर देता है (पैनल मेट्रिक्स को अनुपलब्ध दिखाता है) | | `inbound.enabled` | `false` | बाहरी एजेंट रनटाइम (OpenAI Agents SDK / CrewAI) के लिए stdio JSON-RPC इनबाउंड ब्रिज सक्षम करें; डिफ़ॉल्ट रूप से अक्षम (fail-closed) | | `inbound.command` | *(कोई नहीं)* | बाहरी रनटाइम लॉन्च कमांड; सक्षम और मौजूद होने पर प्लगइन उसे spawn करता है और न्यूलाइन-डिलिमिटेड JSON-RPC सूचनाएँ सुनता है। अनुपस्थित/अस्पॉनेबल = ब्रिज निष्क्रिय रहता है (लॉग किया गया) | ## उपकरण और सतहें | सतह | प्रकार | नोट्स | |---|---|---| | `background_agent` | टूल | टिकाऊ, जारी रहने योग्य चाइल्ड शुरू करें (label, `tool_filter`, `persona`, `max_depth`) | | `bg_message` | टूल | agent id से चाइल्ड को बाद का टर्न पहुँचाएँ | | `bg_list` | टूल | आपके एजेंटों की स्थिति (या `recursive: true` से वंशज ट्री) | | `bg_result` | टूल | चाइल्ड का नवीनतम असिस्टेंट आउटपुट पाठ लें | | `bg_stop` | टूल | वर्तमान टर्न की रुकावट का अनुरोध करें | | `/room` | कमांड | `create\|join\|leave\|list\|send\|tasks\|task add\|assign\|claim\|done\|delete` | | `room_list_rooms` / `room_post` / `room_read` | टूल | संदेश बस: सूची, पोस्ट (प्रसारण/निर्देशित), इतिहास पढ़ें | | `room_list_tasks` / `room_create_task` / `room_claim_task` | टूल | साझा टास्क बोर्ड | | `room_transfer_task` / `room_complete_task` | टूल | हैंडऑफ़ (अनुमोदन-गेटेड) और पूर्णता | | `backgroundAgents` प्रोजेक्शन | सत्र प्रोजेक्शन | पैरेंट लॉग से मोड़ी गई डैशबोर्ड पंक्तियाँ | | `teamRoom` प्रोजेक्शन | सत्र प्रोजेक्शन | `team-room/fact` ईवेंट से मोड़ी गई साझा टाइमलाइन | | वेब साइडबार पैनल | क्लाइंट | लाइव स्थिति, जंप, संदेश, रोक, परिणाम झलक | ## यह कैसे काम करता है — और रीस्टार्ट के बाद क्यों बचा रहता है सब कुछ आधिकारिक उप-एजेंट सीम पर चलता है: `startContinuable`, `followup`, `interrupt`, `listChildren` — प्लगइन अपना कोई लाइफ़साइकल रूटिंग नहीं करता, कभी किसी दूसरे सत्र के `Agent` को नहीं छूता, और कभी किसी प्रोसेस ट्री को नहीं मारता (रोक = *रुकावट का अनुरोध*; टियरडाउन कंटिन्यूएशन मैनेजर का काम है)। प्लगइन हर तथ्य को **एक संरचित चैनल और एक मॉडल-दृश्य चैनल** के ज़रिए लिखता है: - **`background-agents/fact` संरचित तथ्य ईवेंट** — पंजीकृत / संदेश / रोक / प्रगति / संग्रहीत तथ्य, पैरेंट लॉग में केवल-लॉग रिकॉर्ड के रूप में जोड़े जाते हैं और लिफ़ाफ़े का `ignorable: true` मार्कर रखते हैं; जो पाठक उस प्रकार को नहीं जानते वे लॉग को अस्वीकार करने के बजाय रिकॉर्ड छोड़ देते हैं। जिन होस्ट का `Session.append` मार्कर से पुराना है (`0.1.0-rc.8` तक की हर रिलीज़ rc लाइन और `0.1.1-rc` लाइन rc.2 तक, और `0.1.2-rc` लाइन (जो लिफ़ाफ़ा फ़ील्ड केवल संग्रहीत-लॉग पठन संगतता के लिए रखती है और अभी भी मार्कर नहीं लगा सकती) उसे चुपचाप छोड़ देती हैं — मार्कर सुधार केवल master पर है — जिससे बिना मार्कर वाले सत्र सख्त बिल्ड पर अप्राप्य हो जाते हैं) उन्हें पहले append से पहले ही पहचान लिया जाता है (peer संस्करण पूर्व-जाँच + लौटे लिफ़ाफ़े की जाँच) और तथ्य append एक बार की चेतावनी के साथ छोड़ दिए जाते हैं — टिकाऊ स्टोर, सूचनाएँ और उपकरण चालू रहते हैं, प्रोजेक्शन खाली फोल्ड में डिग्रेड होते हैं। - **`tool/result` रीप्ले मेटाडेटा** — संरचित चैनल से पहले लिखे गए लॉग में वही तथ्य (केवल तभी मोड़े जाते हैं जब किसी पंक्ति के पास कोई संरचित प्रोवेनेंस न हो)। - **इंजेक्ट किए गए `user/message` नोटिस** (मॉडल-दृश्य), स्रोत `{ kind: 'plugin', plugin: 'dsh-background-agents' }` — थ्रॉटल्ड प्रगति पंक्तियाँ और संग्रह नोटिस (कैनोनिकल उपसर्ग `[background-agent ] …`)। - **आधिकारिक `subagent-settled` नोटिस** — चाइल्ड का टिकाऊ "settled" तथ्य। - टीम रूम वही अनुशासन दर्शाते हैं: हर डिलीवर किया गया रूम संदेश सदस्य के अपने लॉग में एक टिकाऊ `user/message` होता है, और साझा टाइमलाइन `team_rooms` स्टोरेज डोमेन में केवल-लॉग `team-room/fact` ईवेंट के रूप में प्रतिबिम्बित होती है। `backgroundAgents` प्रोजेक्शन संरचित चैनल को मोड़ता है और पुराने फ़ोल्ड को बनाए रखता है; डैशबोर्ड मान और `bg_list` तथ्य हर बार खोलने पर मानव-पठनीय नोटिस पाठ को पार्स किए बिना फिर से बनते हैं। जब कैटलॉग स्वयं उपलब्ध न हो, तो `bg_list` एक स्पष्ट **`unrecoverable`** मार्कर लौटाता है — यह कभी खाली सूची नहीं गढ़ता। ## बिल्ट-इन उप-एजेंट टूल से इसका संबंध harness कोर अपने स्वयं के उप-एजेंट टूल रखता है (`subagent`, `send_message`, `interrupt_agent` और चाइल्ड-साइड `report` टूल)। इस प्लगइन के `bg_*` टूल उनके **सत्र-स्कोप्ड साथी** हैं; दोनों को एक साथ माउंट किया जा सकता है: | बिल्ट-इन टूल | यह प्लगइन | अंतर | |---|---|---| | `subagent` (`backgroundMode: 'continuable'`) | `background_agent` | वही `startContinuable` सीम; यह प्लगइन प्रति-चाइल्ड tool_filter/persona/max_depth सत्यापन और प्रति-सत्र सीमा जोड़ता है | | `send_message` | `bg_message` | वही डिलीवरी सिमेंटिक्स; `bg_message` इस वार्तालाप के बैकग्राउंड एजेंटों को संबोधित करता है और प्रोजेक्शन तथ्य बनाए रखता है | | `interrupt_agent` | `bg_stop` | वही रुकावट सिमेंटिक्स; `bg_stop` एक संरचित रोक तथ्य भी रिकॉर्ड करता है | | चाइल्ड-साइड `report` टूल | autoReport | बिल्ट-इन को चाइल्ड मॉडल स्वयं कॉल करता है; यह प्लगइन **हर चाइल्ड टर्न के बाद स्वचालित रूप से** थ्रॉटल्ड प्रगति इंजेक्ट करता है | कोर टूल में जो नहीं है: `bg_list`, `bg_result`, निष्क्रिय संग्रह, और प्रति-पैरेंट मोड़ा गया पैनल प्रोजेक्शन। दायरे में नहीं: शेड्यूल्ड ट्रिगरिंग (शेड्यूल सीम मौजूद है), क्रॉस-मशीन/रिमोट एजेंट, और आधिकारिक उप-एजेंट एक्टिवेशन कॉन्ट्रैक्ट में कोई बदलाव। ## यह प्लगइन नहीं है | प्रोजेक्ट | यह क्या करता है | सीमा | |---|---|---| | [titanwings/dsh-automation](https://github.com/titanwings/dsh-automation) | नए एजेंट सत्रों में शेड्यूल्ड कोडिंग कार्य | यह **कब** कार्य चलते हैं इसका मालिक है (शेड्यूलिंग)। यह प्लगइन एक लंबी वार्तालाप की **इंटरैक्टिव स्टीयरिंग** का मालिक है — कोई शेड्यूलर सीम नहीं, कोई cron नहीं। | | [vlln/dsh-task-status](https://github.com/vlln/dsh-task-status) | बैकग्राउंड *जॉब* के लिए स्टेटस बार (प्रगति + आउटपुट टेल) | यह टूल-स्तर के जॉब **दिखाता** है। यह प्लगइन **एजेंट सत्र** बनाता और चलाता है; इसका डैशबोर्ड उसका एक पैनल है, उत्पाद नहीं। | | [YYTbit/dsh-plugin-agent-dashboard](https://github.com/YYTbit/dsh-plugin-agent-dashboard) | मल्टी-एजेंट डैशबोर्ड स्किल | प्रदर्शन-उन्मुख। इस प्लगइन की पंक्तियाँ **कार्रवाई योग्य** हैं: चाइल्ड सत्र में जाएँ, संदेश भेजें, रोकें — आधिकारिक कंट्रोल प्लेन के ज़रिए। | ## अनुमतियाँ और डेटा - **अनुमतियाँ**: workshop मेनिफ़ेस्ट `session:append`, `subagent:spawn` और `tools:register` घोषित करता है। - **डेटा**: टीम रूम `team_rooms` स्टोरेज डोमेन (SQLite या JSONL — कोई अतिरिक्त सेवा नहीं) में रहते हैं; बैकग्राउंड-एजेंट तथ्य पैरेंट सत्र लॉग में रहते हैं। कोई अलग डेटाबेस नहीं, कोई नेटवर्क नहीं। - **सत्र लॉग**: मार्कर का सम्मान करने वाले होस्ट पर `background-agents/fact` और `team-room/fact` ईवेंट लिफ़ाफ़े के `ignorable: true` मार्कर के साथ जोड़े जाते हैं (मार्कर से पहले के होस्ट पहचाने जाते हैं और append छोड़ दिए जाते हैं — देखें `allowUnmarkedFacts`); मॉडल-दृश्य प्रगति पंक्तियाँ और रूम डिलीवरी वास्तविक `user/message` रिकॉर्ड हैं। ## सुरक्षा सीमाएँ - **केवल आधिकारिक सीम।** शुरुआत, संदेश और रोक `startContinuable` / `followup` / `interrupt` पर पतले एडाप्टर हैं; रोक रुकावट का अनुरोध करता है और कभी प्रक्रिया नहीं मारता। - **`tool_filter` केवल सीमित करता है।** यह चाइल्ड की दृष्टि से टूल हटाता है — कभी नए नहीं देता; नाम `allowedChildTools` से सत्यापित होते हैं। - **अनुमोदन-गेटेड हैंडऑफ़।** `room_transfer_task` आधिकारिक अनुमोदन सीम से गुजरता है और कोई answerer स्वीकृति न देने पर विफल-बंद होता है। - **मॉडल-दृश्य ⟺ रिकॉर्डेड।** हर डिलीवर किया गया रूम संदेश सदस्य के अपने लॉग में एक टिकाऊ `user/message` है; साझा टाइमलाइन केवल-लॉग `team-room/fact` ईवेंट के रूप में प्रतिबिम्बित होती है। - **कोई शेड्यूलिंग नहीं, कोई क्रॉस-मशीन एजेंट नहीं।** चाइल्ड डिप्लॉयमेंट के प्रोसेस-लोकल जारी सत्र हैं। ## क्रॉस-इकोसिस्टम इनबाउंड (P2) बाहरी एजेंट रनटाइम — OpenAI Agents SDK, CrewAI और समान — एक **stdio पर न्यूलाइन-डिलिमिटेड JSON-RPC 2.0 ब्रिज** के ज़रिए टीम रूम में प्रकाशित कर सकते हैं (डायरेक्ट-कनेक्ट न्यूनतम सेट; पूर्ण ACP प्रोटोकॉल संगतता upstream सीम की प्रतीक्षा करती है)। `inbound.enabled` और `inbound.command` से सक्षम करें; रनटाइम प्रति पंक्ति एक JSON सूचना भेजता है जहाँ `method` ईवेंट है (`agent_started` बोर्ड पर कार्ड खोलता है, `agent_message` बस पर पोस्ट करता है, `agent_finished` कार्ड पूरा करता है)। अमान्य संदेश छोड़ दिए जाते हैं और JSON-RPC त्रुटि लौटाई जाती है; शुरुआत और रोक disposer से होती है। ## ज्ञात सीमाएँ - टीम रूम को स्टोरेज डोमेन बने होने की आवश्यकता है; `@deepseek-ai/dsh-storage-domain` के बिना `/room` कमांड और `room_*` टूल अक्षम रहते हैं (पाँच `bg_*` टूल फिर भी लोड होते हैं)। - `provider` को जारी-क्षम प्रदाता (`prepareContinuable`) नाम देना होगा; अनुपस्थित प्रदाता से `background_agent` तब तक विफल रहता है जब तक वह न आ जाए। - `maxBackgroundAgents` सत्र के **हर** जारी प्रत्यक्ष चाइल्ड का साझा बजट है, जिसमें बिल्ट-इन `subagent` टूल से शुरू किए गए भी शामिल हैं। - एक-बार के चाइल्ड कभी सूचीबद्ध या संदेशित नहीं होते — `bg_list` केवल जारी पंक्तियाँ रखता है। - चाइल्ड प्रोसेस-लोकल होते हैं: शेड्यूल सीम "कब" का मालिक है, यह प्लगइन एक सक्रिय बातचीत चलाने का मालिक है। ## विकास ```sh pnpm install # केवल tooling; harness पैकेज किसी सह-चेकआउट के विरुद्ध हल होते हैं pnpm run typecheck # सख्त TS, node + client प्रोग्राम pnpm test # vitest: यूनिट + एंड-टू-एंड परीक्षण (वास्तविक उप-एजेंट सीम, स्क्रिप्टेड LLM, jsdom पैनल) pnpm run build # lib/index.js (node आधा) + lib/client.js (वेब क्लाइंट बंडल) pnpm run gen-aliases # चेकआउट हिलने के बाद harness पैकेज पथ फिर मैप करें ``` एक बिना-कुंजी एंड-टू-एंड डेमो एक वास्तविक पैरेंट सत्र और एक बैकग्राउंड चाइल्ड को एक नियतात्मक स्क्रिप्टेड LLM के ज़रिए चलाता है (कोई API key नहीं; `dev/` gitignore में है — पथों को अपने checkout के अनुसार बदलें): ```powershell $env:DSH_HOME = 'D:/deepseek-harness/Project/Plugins/dsh-background-agents/dev/dsh-home' pnpm dsh --profile headless --patch dev/cordis.yml "【父会话】驱动后台 agent 演示" ``` ## विषय `dsh`, `dsh-plugin`, `deepseek-harness`, `subagent`, `background-agent`, `background-agents`, `agent-dashboard`, `conversation-steering`, `team-rooms`, `multi-agent`, `message-bus`, `task-board`, `collaboration` ## योगदानकर्ता - [@PerryLink](https://github.com/PerryLink) — निर्माता और अनुरक्षक: आधिकारिक उप-एजेंट सीम पर बैकग्राउंड-एजेंट रनटाइम, टीम-रूम हब, वेब UI साइडबार पैनल, सत्र प्रोजेक्शन, दस्तावेज़, CI/CD और रिलीज़। ## PerryLink DSH प्लगइन परिवार यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) द्वारा अनुरक्षित [42 DeepSeek Harness प्लगइनों](https://github.com/PerryLink) में से एक है। अगर यह आपकी मदद करता है, तो बाकी भी करेंगे: | Plugin | One-liner | |---|---| | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | अनुमोदन श्रृंखला पर द्वितीय-मॉडल स्वतः-समीक्षा, डिफ़ॉल्ट रूप से विफल-बंद | | | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | DeepSeek Harness के लिए लागत प्रशासन: बजट, कार्बन और विलंबता एक पैनल में। | | | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | Claude Code /rewind-समतुल्य: स्नैपशॉट, सत्र फ़ॉर्क, एक-बार पुनर्स्थापना | | | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | Claude Code सत्र, मेमोरी, कौशल और CLAUDE.md को DSH में स्थानांतरित करें | | | **[dsh-click](https://github.com/PerryLink/dsh-click)** | DeepSeek Harness के लिए क्रॉस-प्लेटफ़ॉर्म नेटिव डेस्कटॉप नियंत्रण — Windows पहले। | | | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | वेब कंपोज़र के लिए टर्मिनल-शैली इनपुट इतिहास: तीर, Ctrl+R खोज | | | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | डेटासेट गुणवत्ता जाँच व उद्धरण सत्यापन (यहाँ उपभोग किया गया वैकल्पिक संख्या-सेतु) | | | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | DeepSeek Harness के लिए प्रॉम्प्ट-इंजेक्शन, जेलब्रेक और सीक्रेट-लीक रक्षा। | | | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | इंजीनियरिंग-अनुशासन रक्षक: आवश्यकताओं की पूछताछ, परीक्षण द्वार, प्रतिद्वंद्वी समीक्षा | | | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | DeepSeek Harness के लिए एकीकृत स्थैतिक-छवि निर्माण रूटिंग। | | | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | DeepSeek Harness के लिए रीड-ओनली प्रदर्शन डायग्नोस्टिक्स। | | | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | चीनी सार्वजनिक म्यूचुअल फंड के लिए नियतात्मक अनुसंधान रिपोर्ट | | | **[dsh-github](https://github.com/PerryLink/dsh-github)** | DSH के लिए GitHub PR/issues एकीकरण, हर लेखन अनुमोदन-द्वारित | | | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | उद्योग-अनुसंधान ऑर्केस्ट्रेशन जो इस प्लगिन के `ctx.researchReport.assemble` से डिलीवरेबल सील करता है | | | **[dsh-library](https://github.com/PerryLink/dsh-library)** | DeepSeek Harness के लिए स्थानीय दस्तावेज़ ज्ञानकोश। | | | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | DeepSeek Harness के लिए स्थानीय-मॉडल (Ollama) एकीकरण। | | | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | भाषा सर्वरों पर LSP निदान, फ़ॉर्मेटिंग, पूर्णता, कोड क्रियाएँ और नाम बदलना | | | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | PII मास्किंग मिडलवेयर: मॉडल सीमा पर अनाम करें, डिस्प्ले लेयर पर पुनर्स्थापित करें | | | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | केवल-पढ़ने वाला MCP रनटाइम पैनल: /mcp कमांड + स्थिति, टूल और त्रुटियों वाला Settings टैब | | | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | अनुमोदन-द्वारित क्रॉस-सत्र मेमोरी: ctx.memory सीम + SQLite + मेमोरी टूल | | | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | DeepSeek Harness के लिए OpenTelemetry और Langfuse अवलोकनीयता निर्यातक। | | | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | Claude Code outputStyles-समतुल्य रनटाइम शैली बदलाव | | | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | ऑडिट के साथ Claude Code-शैली घोषणात्मक allow/deny/ask अनुमति नियम | | | **[dsh-personal-directive](https://github.com/PerryLink/dsh-personal-directive)** | शीर्ष-बार टॉगल के साथ व्यक्तिगत निर्देश इंजेक्टर (फ्रेमवर्क संस्करण) | | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | माँग पर एजेंट कौशल के रूप में प्लगइन-विकास ज्ञान आधार | | | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | मल्टी-चैनल अनुमोदन/प्रश्न ब्रिज: WeChat/Telegram/Feishu, सत्र कंसोल | | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | सामग्री-पता साक्ष्य और सीलबंद संस्करणों वाला सत्यापन-योग्य अनुसंधान-रिपोर्ट इंजन | | | **[dsh-score](https://github.com/PerryLink/dsh-score)** | DeepSeek Harness प्लगिनों की बहु-आयामी गुणवत्ता स्कोरिंग। | | | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | टिकाऊ क्रम के साथ वेब साइडबार में सत्र पिन करें | | | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | DeepSeek Harness के लिए क्रॉस-डिवाइस सत्र सिंक — आपके सत्र स्टोर का एक समर्पित git मिरर। | | | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | सुरक्षा-ऑडिट कौशल पैक: गुप्त स्कैन, निर्भरता और आपूर्ति-श्रृंखला समीक्षा | | | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | DeepSeek Harness के लिए आवाज़-प्रथम सत्र लूप: बोलें और उत्तर सुनें। | | | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | DeepSeek Harness प्लगिनों के लिए पृथक इंस्टॉल-एंड-स्मोक टेस्ट ड्राइव। | | | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | TickTick/Dida365 कार्य ब्रिज: सत्र-हेडर पैनल + 11 टूल | | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | DeepSeek Harness के लिए वेंडर पैरामीटर अनुवाद और नियतात्मक JSON मरम्मत। | | | **[dsh-wechat](https://github.com/pan17/dsh-wechat)** | WeChat ↔ DSH ब्रिज (Tencent iLink bot): टेक्स्ट/इमेज/फ़ाइल/आवाज़, चैट में अनुमोदन | | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | Automatic strong/cheap model-tier routing with deterministic risk guards and a `/tier` command | | | **[dsh-catalog](https://github.com/PerryLink/dsh-catalog)** | DSH Desktop Market standard catalog source for the PerryLink family | | | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence | | | **[dsh-kit](https://github.com/PerryLink/dsh-kit)** | One-command starter pack that installs the core family | | | **[dsh-plugin-certification](https://github.com/PerryLink/dsh-plugin-certification)** | Community certification registry with repro-checkable grades and badges | | | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins | | | **[dsh-plugin-portal](https://github.com/PerryLink/dsh-plugin-portal)** | Zero-dependency static portal rendering the whole plugin family as one page | | | **[dsh-plugin-upgrade-015](https://github.com/PerryLink/dsh-plugin-upgrade-015)** | Merged `0.1.3-alpha.1` → `0.1.5-rc.1` upgrade corridor card plus a zero-dependency seam scanner | | | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | Cross-session team rooms: shared message bus, task board and timeline | | | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | Zero-dependency static + sandbox smoke detector for DSH plugins | | | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | Laya typed decisions (`noul`/`choice`/`score`) as a first-class Cordis service and model-visible tools | | ### DSH Desktop मार्केट से इंस्टॉल करें सभी PerryLink प्लगइन DSH Desktop के बिल्ट-इन मार्केट में देखे जा सकते हैं: **Market → Sources → add source → पेस्ट करें** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ चुनें**। इंस्टॉलेशन मार्केट के npm-identity सत्यापन और आपकी पुष्टि से ही होता है। ## लाइसेंस [Apache License 2.0](LICENSE) © 2026 dsh-background-agents contributors