Mwongozo wa usakinishaji na matumizi wa Fujiang Po Jia: Kusanidi ujuzi wa usalama, hifadhidata ya maarifa na mnyororo wa kazi kwa DeepSeek Harness

Muhtasari wa mradi

Fujiang Pojia ni programu-jalizi maalum ya vidokezo na msaidizi wa tathmini ya usalama kwa DeepSeek Harness. Toleo lililoonyeshwa kwenye README ya sasa ni 0.20.12. Mradi husakinisha @deepseek-ai/dsh-prompt-custom kwenye saraka ya usanidi ya Harness, huku programu-jalizi na usanidi wa vidokezo wa prompt-custom.json vikihifadhiwa kando.

Programu-jalizi hutoa vidokezo maalum, maktaba ya ujuzi, hifadhidata iliyojengewa ndani ya CVE/PoC, ripoti za udhaifu na mnyororo wa kazi za majaribio ya kupenya. Inafaa kwa kupanga mali, kulinganisha udhaifu unaowezekana, kurekodi hatua za uthibitishaji na kuunda ripoti katika mazingira yenye idhini iliyo wazi. Chaguo kutoka kwenye hifadhidata au maendeleo ya kiotomatiki hayapaswi kuchukuliwa moja kwa moja kuwa udhaifu uliothibitishwa.

Jina la mradi na kutajwa kwa DeepSeek hakumaanishi kuidhinishwa rasmi. Kabla ya kuanza, soma kanusho kwenye hazina na uhakikishe kuwa lengo, upeo na mbinu za majaribio zimeidhinishwa.

Vipengele vikuu

• Uingizaji wa vidokezo: Karibu na kisanduku cha kuingiza kuna swichi ya hali ya “Fujiang Pojia” na sehemu ya mipangilio. Uingizaji ukizimwa, mwanzo rasmi hurejeshwa huku maandishi yako mwenyewe ya vidokezo yakibaki.
• Ripoti za udhaifu: Huhifadhi kwa kudumu rekodi za udhaifu zilizoandikwa na akili bandia, zinazoweza kuangaliwa kwa viwango vya muhimu, hatari kubwa, hatari ya kati, hatari ndogo na taarifa.
• Maktaba ya ujuzi: Huwezesha kupakua, kuwasha au kuzima REA na AboutSecurity inapohitajika, na kuifanya akili bandia itambue ujuzi uliosajiliwa.
• Hifadhidata iliyojengewa ndani: Programu-jalizi huja na aina tisa za maarifa ya CVE/PoC; kuiwasha hakuhitaji upakuaji wa ziada.
• Mnyororo wa kazi za kupenya: Hudhibiti kazi, mali, hatua za uthibitishaji, rekodi za majaribio, hatua na mapendekezo yanayofuata.
• Kulinganisha alama za ndani: Hupanga vipengele vinavyoweza kuhusika kwenye hifadhidata kwa kuzingatia bandari, kitambulisho cha huduma au jina la bidhaa, na kutoa sababu za ulinganifu.

Kiolesura cha vidokezo maalum

Usanidi wa vidokezo maalum huhifadhiwa kando katika prompt-custom.json, ambao unaweza kuwa na usanidi wa kibinafsi. Kabla ya kusakinisha tena, kuweka nakala rudufu au kusambaza, hakikisha kuwa maudhui ya faili yanafaa kushirikiwa.

Maktaba ya ujuzi na hifadhidata ya maarifa

Maktaba ya ujuzi inasaidia miradi miwili ya juu: zana ya uchanganuzi wa nyuma ya REA na maktaba ya ujuzi wa tathmini ya usalama ya AboutSecurity. Kila mradi wa mtu wa tatu una masharti yake ya leseni.

Hifadhidata iliyojengewa ndani inashughulikia urekebishaji wa Java, Java Web, vifaa vya mipakani, Exchange na mazingira ya kikoa, Web na CMS, kupata mamlaka ya juu kwenye Linux, wingu na kontena, hatari za miingiliano ya biashara, pamoja na upangaji wa udhaifu. Vipengele hurekodi bidhaa, toleo, bandari, maneno muhimu, ukali, masharti ya awali, mapendekezo ya kurekebisha na vyanzo vya marejeo.

Maandalizi kabla ya kusakinisha

1. Thibitisha kuwa unatumia toleo linaloungwa mkono la DeepSeek Harness. Programu-jalizi inatangaza uoanifu na DeepSeek Harness na dsh-system-prompt ya toleo >=0.2.1-rc.5 <0.3.0.
2. Thibitisha kuwa toleo la Cordis liko ndani ya >=4.0.5 <5.
3. Anzisha DeepSeek Harness Desktop rasmi angalau mara moja ili programu ikamilishe uanzishaji wa usanidi wa desktop.
4. Funga kabisa Harness kabla ya kusakinisha, ikiwemo kuchagua “Toka” kwenye ikoni ya trei ya Windows iliyo chini kulia.
5. Pakua hazina kutoka chanzo kinachoaminika na kagua maudhui ya faili kabla ya kutekeleza hati.

Kutumia hati ya usakinishaji

Kwenye ukurasa wa hazina, chagua Code → Download ZIP na fungua faili, au tumia Git kuiga hazina. Baada ya kufunga Harness kabisa, bofya mara mbili 点我执行脚本.cmd kwenye saraka iliyofunguliwa.

# Tekeleza baada ya kufunga Harness kabisa
.\点我执行脚本.cmd

# Tazama tu mpango wa usakinishaji bila kubadilisha faili
.\install.ps1 -DryRun

-DryRun inafaa kwa kukagua shughuli ambazo hati itatekeleza kabla ya usakinishaji rasmi. Kisakinishaji hutumia usanidi wa desktop kwa chaguo-msingi na hutanguliza zana ya mstari wa amri ya DSH inayokuja na Desktop. Ili kubinafsisha mazingira, tumia -Profile, -DshCommand na -DshHome kubainisha jina la usanidi, zana ya mstari wa amri na saraka ya data.

Ikiwa DSH_HOME haijawekwa, saraka chaguo-msingi ya data ni $env:USERPROFILE\.dsh. Hati ya usakinishaji hunakili programu-jalizi kwenye $DSH_HOME\local-plugins\dsh-prompt-custom, huisajili kwa kutumia kidhibiti cha programu-jalizi cha DSH, kisha hunakili prompt-custom.json iliyoambatanishwa.

Ikiwa usanidi wa vidokezo uliopo unatofautiana na mpya, kisakinishaji kwanza huunda nakala rudufu karibu na faili asili. Usajili ukishindikana na nakala rudufu ipo, hati hurejesha usanidi asili wa vidokezo. Baada ya usakinishaji kufanikiwa, hati pia hujaribu kuandika install.log katika eneo la karibu, lakini faili hiyo si kumbukumbu kamili ya utekelezaji.

Kisakinishaji kikigundua kuwa Harness bado inaendeshwa, kitaomba ifungwe na kusitisha; hakitabadilisha faili katika jaribio hilo. Kisakinishaji hakifungi wala kuwasha upya Harness kiotomatiki, na hakiungi mkono kigezo cha -NoRestart.

Windows ikizuia hati

Kisakinishaji ni hati ya PowerShell inayoweza kusomwa, na hufanya hasa kunakili faili na kuita amri za DSH. README inaeleza kuwa haina tabia ya kuanzisha madirisha yaliyofichwa, kulazimisha kusitisha michakato, kuunda kazi zilizopangwa au kuunda michakato kupitia WMI, lakini hilo si sawa na hitimisho la ugunduzi wa programu yoyote ya usalama.

Windows ikizuia hati kwa sababu ya alama ya chanzo cha upakuaji, kwanza hakiki chanzo cha upakuaji na kagua maudhui ya hati. Unaweza pia kukokotoa thamani ya ukaguzi ya SHA256 na kuilinganisha na thamani iliyotolewa na mchapishaji:

Get-FileHash .\install.ps1 -Algorithm SHA256

Baada ya kuthibitisha kuwa faili linaaminika, tumia “Ondoa kizuizi” kwenye “Sifa” za faili la Windows ili kushughulikia alama ya chanzo cha upakuaji.

Mbinu ya usakinishaji wa mkono

Ikiwa hutaki kuendesha hati ya usakinishaji kiotomatiki, unaweza kunakili na kusajili programu-jalizi mwenyewe baada ya kufunga Harness kabisa. Amri zifuatazo hutumia saraka chaguo-msingi ya data na zana ya mstari wa amri ya DSH inayokuja na Desktop:

$pluginTarget = Join-Path $env:USERPROFILE '.dsh\local-plugins\dsh-prompt-custom'
New-Item -ItemType Directory -Force -Path $pluginTarget | Out-Null
Get-ChildItem -LiteralPath .\plugin -Force | ForEach-Object {
  Copy-Item -LiteralPath $_.FullName -Destination $pluginTarget -Recurse -Force
}

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add $pluginTarget

Ikiwa pia unataka kutumia usanidi wa vidokezo ulioambatanishwa kwenye hazina, kwanza hifadhi nakala ya $env:USERPROFILE\.dsh\prompt-custom.json iliyopo, kisha nakili faili mpya. Baada ya usakinishaji kukamilika, unahitaji kuwasha upya Harness mwenyewe.

Mchakato wa msingi wa matumizi

Hatua ya kwanza: Washa uingizaji wa vidokezo

Baada ya kuwasha upya Harness, tafuta sehemu ya hali ya “Fujiang Pojia” karibu na kisanduku cha kuingiza. Inapowashwa, programu-jalizi hubadilisha mwanzo rasmi wa harness:identity kwa sehemu tupu; ikizimwa, mwanzo rasmi hurejeshwa. Maandishi yako maalum ya vidokezo hayafutwi.

Hatua ya pili: Sanidi maktaba ya ujuzi

Fungua “Maktaba ya ujuzi” kwenye paneli ya mipangilio, kisha pakua na uwashe REA au AboutSecurity inapohitajika. AboutSecurity hupakua kumbukumbu iliyobanwa ya tawi la sasa la master kutoka GitHub na kutoa tu saraka ya skills/. Mchakato wa upakuaji unaonyesha maendeleo na unaweza kughairiwa.

REA inahitaji toleo linalooana la Node.js la ^22.23.4 || ^24.22.1 || >=26.12.1. Programu-jalizi inapoweka REA kupitia npm, huzima hati za mzunguko wa maisha, hivyo haijengi kwa njia hii vifungo asilia vya hiari vya Frida. Uwezo wa zana maalum kuendeshwa bado unategemea mazingira ya ndani ya utekelezaji na injini ya uchanganuzi.

AboutSecurity inaundwa hasa na nyaraka za ujuzi za Markdown na haihitaji vipengele asilia vya ziada vya utekelezaji. Upakuaji wa ujuzi ukifanikiwa humaanisha tu kuwa faili zimepatikana na kusajiliwa; haimaanishi kuwa kila zana imehakikiwa kuwa inaendeshwa.

Hatua ya tatu: Tumia hifadhidata kusaidia ulinganifu

Hifadhidata ya maarifa huwashwa kwa chaguo-msingi, na hali yake huhifadhiwa katika $DSH_HOME/fujiang-skills/knowledge-state.json. Ikizimwa, programu-jalizi haitoi tena maudhui husika ya maarifa kwa akili bandia, lakini faili asili hubaki kwenye kompyuta ya ndani.

Katika jaribio lililoidhinishwa, unaweza kwanza kuieleza akili bandia bidhaa lengwa, toleo, bandari, kitambulisho cha huduma na upeo wa jaribio, kisha kuiomba itafute vipengele husika vya maarifa. Kwa mfano:

Haya ni mazingira ya majaribio yaliyoidhinishwa. Tafuta vipengele vinavyoweza kuhusika kwenye hifadhidata kulingana na jina la bidhaa, toleo na bandari zilizo wazi zilizothibitishwa, kisha orodhesha sababu za ulinganifu, masharti ya awali, ushahidi ambao bado unahitaji kuthibitishwa na mapendekezo ya kurekebisha. Usieleze chaguo hizi kama udhaifu uliothibitishwa.

Vipengele vya maarifa ni mkusanyo wa taarifa za umma, na kwa kawaida hutumia metadata kama verified: false na sources: kuashiria hali ya uthibitishaji na chanzo. Katika matumizi halisi, lazima vikaguliwe tena kwa kuzingatia toleo la lengo, usanidi na masharti ya awali.

Hatua ya nne: Unda mnyororo wa kazi za kupenya

Utekelezaji wa sasa unamtaka mtumiaji kwanza kuunda kazi kwenye paneli ya programu-jalizi, ndipo akili bandia iweze kutumia rekodi zilizopo za kazi kurekodi mali, hatua na matokeo. Mnyororo wa kazi hupangwa katika hatua zifuatazo:

1. Ukusanyaji wa taarifa
2. Utambuzi wa alama
3. Ulinganifu wa udhaifu
4. Uthibitishaji wa uwezekano
5. Utumiaji wa udhaifu
6. Usogezaji wa pembeni
7. Utoaji wa ripoti

Kila kazi inaweza kuhusishwa na kipindi kimoja, na kipindi kimoja kinaweza kuhusishwa na kazi isiyozidi moja. Programu-jalizi hutumia campaign:context kuipa akili bandia inayohusishwa taarifa za kazi, hatua, idadi ya mali na mapendekezo yanayofuata.

Inapendekezwa kuweka wazi wakati wa kuunda kazi malengo yaliyoidhinishwa, upeo wa shughuli zinazoruhusiwa, vitendo vilivyokatazwa, muda wa majaribio na masharti ya kusitisha. Maendeleo ya kazi na hatua ni kwa ajili ya kupanga taarifa tu, na hayawezi kuchukua nafasi ya ushahidi wa uthibitishaji wa udhaifu.

Hatua ya tano: Rekodi ripoti za udhaifu

Baada ya matokeo ya uthibitishaji kutosha kuunga mkono hitimisho, ndipo uombe akili bandia iandike rekodi ya udhaifu. Ripoti inapaswa kuwa na mali zilizoathiriwa, masharti ya kuzalisha tena, ushahidi, tathmini ya athari, ukali, mapendekezo ya kurekebisha na vyanzo vya marejeo. Chaguo ambazo hazijathibitishwa zinapaswa kubaki katika hali ya “inasubiri uthibitishaji”, badala ya kuwekewa alama moja kwa moja kuwa udhaifu.

Miingiliano ya ndani na zana asilia

Programu-jalizi hutoa miingiliano ya ndani ya kulinganisha alama na kuweka daftari la kazi. Ukokotoaji wa ulinganifu na uandishi wa daftari hufanyika kwenye kompyuta ya ndani, lakini upakuaji wa ujuzi, miito ya modeli za mtandao na uthibitishaji wa lengo halisi bado vinaweza kutoa maombi ya mtandao.

• POST /api/dsh-prompt-custom/match: Hurejesha vipengele vya maarifa vilivyopangwa pamoja na sababu za ulinganifu kulingana na bandari, kitambulisho cha huduma au jina la bidhaa. Uzito ni bandari 40, bidhaa 30, CVE 20, maneno muhimu 20 na kiwango cha ukali 5.
• /api/dsh-prompt-custom/campaigns: Hudhibiti upeo wa majaribio, alama za mali, hatua za utekelezaji, rekodi za majaribio na hatua za kazi. Daftari huhifadhiwa katika $DSH_HOME/vuln-report/campaigns.json.
• GET ?id=: Husoma kazi iliyobainishwa na mapendekezo ya hatua inayofuata.

Kiolesura cha kazi pia hutoa vitendo kama bind, unbind na kick. Zana asilia zinajumuisha kb_match, campaign_upsert, finding_upsert na pipeline_next; sehemu za kuingia za kutafuta ujuzi ni pamoja na skill_search na skill_read. Usajili wa zana asilia unategemea huduma ya zana ya DSH inayoweza kutatuliwa.

Mapendekezo ya Matumizi ya Juu

Tumia DryRun Kwanza Kukagua Mpango wa Usakinishaji

Unaposakinisha kwa mara ya kwanza au kubadilisha saraka ya usanidi, endesha .\install.ps1 -DryRun kwanza. Hii hukuwezesha kuthibitisha njia lengwa, jina la usanidi na vitendo vinavyotarajiwa, huku ikizuia mabadiliko ya mara moja kwenye faili.

Hifadhi Nakala Kando ya Programu-jalizi na Maagizo Binafsi

prompt-custom.json ni huru na programu-jalizi na huenda ikawa na usanidi binafsi. Kabla ya kusasisha au kusambaza tena, hifadhi nakala ya faili hii kando na uikague ili kuepuka kufuta marekebisho maalum au kushiriki taarifa nyeti bila kukusudia.

Tenganisha Ulinganifu wa Wagombea na Athari Halisi

Ulinganifu wa alama za vidole hupanga tu chaguo za kugombea kulingana na milango, bidhaa, CVE, maneno muhimu na kiwango cha ukali. Nafasi ya juu haimaanishi kuwa lengo limeathirika. Endelea kuthibitisha toleo, namna ya uwekaji, hali ya viraka, masharti ya awali na ushahidi halisi.

Tumia Uendelezaji Otomatiki kwa Tahadhari

Uendelezaji otomatiki huwa na kiwango cha juu cha raundi 8 kwa chaguo-msingi, pamoja na utambuzi wa kukwama na mapendekezo ya hatua inayofuata. Unapotumia kipengele hiki, weka mipaka wazi ya idhini na masharti ya kusitisha, na uendelee kufanya ukaguzi wa kibinadamu ili kuzuia modeli kutekeleza hatua zisizofaa kwa sababu ya muktadha usiotosha.

Elewa Jinsi Msingi wa Maarifa Unavyosasishwa

Vipengee vya maarifa viko katika plugin/knowledge/; faili husomwa upya kila kipengee kinapopakiwa, hivyo masasisho ya maudhui yanaweza kutumika katika miito inayofuata. Ufafanuzi wa kategoria uko katika lib/knowledge.js; ukibadilisha kategoria, lazima upakie upya programu-jalizi.

Chunguza Matatizo ya Vifunguo vya Njia za Mkato za Kuingiza

README inaandika hali inayojulikana: baada ya kufunga dirisha ibukizi la kanusho, kisikilizaji cha Enter au Esc huenda kikaendelea kuathiri uingizaji na vifunguo vya njia za mkato. Ukikumbana na hali isiyo ya kawaida, kwanza angalia ikiwa inahusiana na tatizo hili linalojulikana, kisha pakia upya programu-jalizi au uwashe upya Harness.

Ulinganifu na Mipaka ya Uthibitishaji

Programu-jalizi hufanya kazi kupitia systemPrompt, skills, tools, mzunguko wa maisha wa wakala na huduma ya webServer zilizo wazi, bila kusakinishwa kwa kubadilisha faili za programu ya Harness. Baada ya usakinishaji, lazima ufunge kabisa na uwashe upya Harness.

README inasema kuwa toleo la sasa limekagua muundo wa faili na mantiki ya usakinishaji, lakini halijakamilisha tena uthibitishaji wa uendeshaji wa vitendaji vyote. Kwa hiyo, haiwezi kuthibitisha kuwa ujuzi wote, vipengee vyote vya CVE au michakato yote ya otomatiki itapatikana. Kabla ya kupeleka katika mazingira ya uzalishaji, thibitisha kila kipengee katika mazingira ya majaribio yaliyotengwa na yaliyoidhinishwa.

Hitimisho

富江破甲 huunganisha usimamizi wa maagizo, ujuzi wa usalama, msingi wa maarifa uliojengewa ndani, ripoti za udhaifu na daftari la kazi katika DeepSeek Harness. Njia sahihi ya matumizi ni kukagua kwanza ulinganifu na mpango wa usakinishaji, kisha kusanidi ujuzi na msingi wa maarifa, na mwishowe kuunda kazi, kuthibitisha chaguo za kugombea na kuhifadhi ushahidi ndani ya mipaka iliyo wazi ya idhini. Daima weka ukaguzi wa kibinadamu, ruhusa za kiwango cha chini na ushahidi wa kuaminika mbele ya michakato ya otomatiki.