Практычныя нататкі: бывай, Claude Code — абвязка агента DeepSeek цалкам лакальна
Практычны разбор тэмы «абвязка агента DeepSeek, запушчаная цалкам лакальна замест Claude Code»: кантракты, праверкі і гатовыя фрагменты кода для каманд, якія ўкараняюць гэты падыход.
Крыніцы: Goodbye Claude Code: How to Run DeepSeek Agent Harness 100% Locally
Наступныя прытамкі паказваюць практычны шлях адпрацоўкі матэрыялу «Goodbye Claude Code: How to Run DeepSeek Agent Harness 100% Locally». Акцэнт ставіцца на контракты, перакананняя і месцы для коду, які можна легка заменіць, а не на мотывацыйныя аспекты. Калі працуеце на этапы аглявання, спачатку запісайце контракт: неабяжныя даны, сігнал успеху і тое, што выходзіць у разе частковага невыпання. Такі спіс контроля дапамагае залішыцца чыстасна ў пазнейшых змяненах коду. Запісвайце час выканання і кост токенав або запытаў разам з функцыйнальнымі рэзултатамі. Відразувыя даны пра косцы запобегаюць неспакойным рахункам, калі праця пераходзіць з дэмавайшнага рэжыма ў спакульнае сераўерное сэрвіса.
Змена парадыгмы ў автонамнай разработцы програмнага забавства
Парадыгмальныя змены ў стадэй-працах даюць найлепшыя рэзультаты, калі іх розглядаць як вімерную плошчу. Запісаўце адна «золатая» транскрыпцыя, адын прыклад неудачы і прыметку пра вярнэнне да поперадньего стану перш чым расшырваць масштабы. Зберагаюце настройкі паза кодам прыемліка. Файлы сераўіса, хранільнікі секрэтных дадзеных і пазначкі функцый должны знаходзіцца ў аднам месцы, куда аператары можуць аўдытуваць іх, не чытаючы весь граф. Адкрывайце інструменты з вузкімі схемамі і чытальнымі пазначкамі побачных эфектаў. Хостам неабходна знаты, якія вызовы мутуюць стан, перш чым яны автаматычна схваляюць іх.
DeepSeek Agent Harness проты комерчыяных агентаў: Аналіз архітэктурных можацяй
The DeepSeek Agent Harness vs stage работае наяўней, калі яго спрыяваць як мерыемую паверхню. Запісаце адна ідэальная транскрыпцыя, адзін прыклад неудачы і прыметку па абратанні стану да таго, калкі будзе расшырвацца сфера дзейнасці. Дакументаваце як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія перакрыцчы і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не наступным этапам дорабачання. Адкрывайце інструменты з вузкімі схемамі і чысткімі пазначэннямі побачных эфектаў. Хостам неабходна знаты, якія вызовы мутуюць стан, перш чым яны будуць автаматычна затверджаны.
1. Адкрыты код і модулярнасць
Этап «1 Open Source Modularity» працюе найкрашча, калі яго розглядаць як меркавыя парадакты. Зберагчыце адны ідэальны прыклад працы, адны прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расшырваць сферу дзеяння. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына неудачы павінна вказываць на адную адпаведальнасць, а не на заплутаны ланцюг дзеяння. Аб’екты, якія вікорыстоўваюцца, павінны маты часткавыя схемы і чысткія пазначэнні пра побачныя эфекты. Адпаведальныя за хоставанне павінны знаты, якія вызовы моцна зменіць стан сістэмы, перш чым автаматычна схваліць іх. Этап «1 Open Source Modularity» працюе найкрашча, калі яго розглядаць як меркавыя парадакты. Зберагчыце адны ідэальны прыклад працы, адны прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расшырваць сферу дзеяння. Запісвайце час выканання і косты токеноў або запытав, падаючы іх разам з функцыйнальнымі рэзультатамі. Відразувыя даныя пра косты запобегаюць неспакойным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спакульную.
2. Аберага чыстоты дадзэнняў і безпека з аір-гэпам
Для этапы 2 «Айр-гэп» парадоксу прыватнасці дадзейнай інфармацыі неабходна ўскладніць вхідныя даны, апрацоўвальніка крока і крэтырыя завершэння перад змінайом коду. Апрацоўнікі должны магчыма было перзапускаць крок з вядомай точкі контролю, не спрабоўваючы з’ясаваць схованы стан. Конфігурацыю трэба залічыць парадзельной ад коду прыемліка. Файлы сераўнавальнага сяродавішча, хранілішчы секрэтных дадзеных і флагі функцый должны знаходзіцца ў аднам месцы, якое апрацоўнікі можаць пераглядаць, не чытачы ўсю структуру. Аўтэнтыфікацыя павінна выканацца на воратах, а пераправерка — на роўні дадзейнаў. Сам токен-носіцель не ёсць межай арэндаванага рэсурсу.
3. Эфектыўнасць за выкарыстоўванне (нулявыя зборы за API)
Для этапы «3. Эфектыўнасць за вымяром костоў – 0» неабходна пазначыць вхідныя даны, адпаведальнага за выкананне крока і крытэрыя завершэння пры перадзмене коду. Аператары должны магчыма было перзапускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Неабходна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія перакрыцця і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не элементамі пазнейшай дапрацоўкі. Автэнтыфікацыя павінна выкананае на воратах, а пераправаленне прав на выкарыстоўвання – на рэверсе дадзеных. Толькі токен-носіцель не ёсць межай арэндаванага рэсурсу.
4. Гнеккісць модэлю
Для этапы 4 «Гнучкасць модэлі» неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтырыя завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымае перайсці на выкананне кроку з вядомага пункта контролю, не спрабоўваючы здагадвацца пра захаваны стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выканаецца, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Калі наступны крок — гэта код або вызов інструмента, лепш выкарыстоўваць структураваныя выходныя даны з перакананнем схэмы, чым вольныя тэкстовыя апісанні. Для этапы 4 «Гнучкасць модэлі» неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтырыя завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымае перайсці на выкананне кроку з вядомага пункта контролю, не спрабоўваючы здагадвацца пра захаваны стан. Запісвайце час выканання і кост токеноў або запытаў разам з функцыйнальнымі рэзультатамі. Відразувыя даны пра косцы запобегаюць неспакойным рахункам, калі працэс пераходзіць з дэмавайшага рэжыма ў спяльныя сераўеры.
5. Адміністрацыя парадоксу станоў і розгалужэння
Калі працуеце над стадзіяй 5 «Адміністрацыя парадоксу станоў і розгалужэння», спачатку запісайце умовы: неабходныя даныя, сігнал успеху і тое, што выходзіць на частым невялікім браке. Такі спіс дапамагае заліцварыць пазнейшыя змены ў кодзе. Зберагаюце настройкі праза код аплікацыі. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць пераглядаць іх без неабходнасці чытання всей структуры. Зявляйце логі з назвай інструмента, хэшам аргументаў, часам затрымкі і рэзультатам кожнага вызову. Без такога следу дэбагаванне агента займае гадзіны.
Архітэктура выкарыстоўвання проты інтэлігенціі мадэлі
Калі працюеце над стадзіяй «Архітэктура Harness проты Model», спачатку запісайце умовы вярбунка: неабяжлівыя даныя, сігнал успеху і тое, што выканаецца у разе частковага нявыполнення. Такі спіс контроля дапамагае заліцьварыць чыстасцю пазнейшых змян у кодзе. Документавайце як шлях успеху, так і шлях вяселення. Перапрыбуткі, людзкіе перакрыцця і апрацоўка некорэктных паведамленняў ёсць частынай продукту, а не пазнейшым дапрацоўкам. Зберагайце у кэшы стабільныя інструкцыі сістэмы і схемы інструментаў. Перасылка ідэнтычных паведамленняў ёсць частым выклікам зношэння рэсурсаў.
Унутры DeepSeek Harness: Архітэктура, якая прыорытэтавае плагіны, і двыгун Cordis
Калі працуеце над першым этапам Inside DeepSeek Harness Plugin-First, спачатку запісайце умовы вікорыстання: неабяжлівыя даныя, сігнал успеху і тое, што выходзіць у разе частковага невыпання. Такі спіс дапамагае заліцьваты пазнейшыя змены ў кодзе. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, невыпанне должна паказваць на адну конкрэтную відпаведальнасць, а не на заплутаны ланцюг задач. Запісвайце назву інструмента, хэш параметраў, час адпаведзі і рынак кожнага вызову. Без такога следу дэбагаванне агента займае гадзіны. Калі працуеце над першым этапам Inside DeepSeek Harness Plugin-First, спачатку запісайце умовы вікорыстання: неабяжлівыя даныя, сігнал успеху і тое, што выходзіць у разе частковага невыпання. Такі спіс дапамагае заліцьваты пазнейшыя змены ў кодзе. Запісвайце часы выканання і кост токеноў або запытаў разам з функцыйнальнымі рынакамі. Відразувая візуабілізацыя костаў запобегае неспакойным рахункам, калі праця пераходзіць з дэмаверсіі ў спакульнаныя сераўысы.
DeepSeek Agent Harness (DSH): Рэжымы выканання і профілі
Этап DeepSeek Agent Harness DSH працюе найэфектывней, калі яго розглядаць як вімерную паверхню. Запісаўце адна ідэальная транскрыпцыя, адзін прыклад неудачы і прыметку па аброшчанні працы перад расшырэнням масштаба. Храніце настройкі паза кодам прыемліка. Файлы сяродавішча, базы секрэтных даных і флагі функцый должны знаходзіцца ў аднам месцы, куда аператары можуць пераглядаць іх без неабяжнага чытання всіх дадзеных. Адкройце інструменты з вузкімі схемамі і чытальнымі пазначэннямі побачных эфектаў. Хостам неабходна знаты, якія вызовы мутуюць стан, перш чым яны автаматычна схваляюць іх.
1. Стандартны рэжым (dsh/dsh --profile standard)
Этап 1 Standard Mode dsh работае наяўней, калі яго спрыяваць як мерыемую паверхню. Зафіксавайце адна «золатая» транскрыпцыю, адын прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць масштабы. Дакументавайце як шлях успеху, так і шлях вяснавання. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не наступным этапам дорабачання. Адкройце інструменты з вузкімі схемамі і чысткімі пазначэннямі побачных эфектаў. Хостам неабходна знаты, якія вызовы мутуюць стан, перш чым яны автаматычна схваляюць ўпраўленні.
Архітэктура і механізмы
Этап «Архітэктура і механізмы» працюе найэфектывней, калі яго спрыяваць як до меры можна. Зберагачыце адны ідэальны прыклад працы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць сферу дзеяння. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына неудачы павінна вказываць на адную адпаведальнасць, а не на заплутаны ланцюг дзеяння. Аб’екты, якія вікорыстоўваюцца, павінны маты часткавыя схемы і чысткія пазначэнні пра побачныя наследкі. Адпаведальныя за эксплуатацыю павінны знаты, якія вызовы моцна зменіць стан сістэмы, перш чым автаматычна схваліць іх. Этап «Архітэктура і механізмы» працюе найэфектывней, калі яго спрыяваць як до меры можна. Зберагачыце адны ідэальны прыклад працы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць сферу дзеяння. Запісвайце час выканання і вартасць токеноў або запытав, падаючы іх радом з функцыйнальнымі рэзультатамі. Відразувыя даны пра вартасці запобегаюць неспакоўным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спакульную.
Алгорытм выканання
Для этапы адміністрацыі практыкі неабяжна з’явіць вхідныя даны, адміністратара шагу і крэтыяры завершэння прычыны змены коду. Аперацыйныя працавнікі павінны магчымае перадзванаць шаг з вядомай точкі контролю, не падозрываючы схованы стан. Конфігурацыю трэба зберагчы за межамі коду прыкладнення. Файлы сераўіса, хранільнікі секрэтных даных і флагі функцый належаць у аднам месца, якое працавнікі можуць пераглядаць, не чытаючы весь лянцуг практыкі. Автэнтыфікуйцеся на воратах і паўторна автарызуйцеся на роўні дадзенняў. Сам токен-носіцель не ёсць межай арэндаванага рэсурсу.
Калі выкорыстоўваць
У стадыі «Календар змаўкання» неабходна прадзефінавацыя вхідных дадзеных, адпаведальнага за крок і крэтарыяў завершэння працы перад змінайом коду. Аператары должны магчымае перзапускіць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Неабходна задокументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе перакрыцця і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не элементамі пазнейшага доўрабкі. Аўтэнтыфікацыя выканаўцаяся на воратах, а прабачэнне праваў — на роўні дадзеных. Толькі токэн-носіцель не ёсць межай арэндаванага рэсурсу.
2. Рэжым коду (dsh code / dsh --profile code)
Для 2-го ўзлока Code Mode dsh неабходна пазначыць вхідныя даны, адпаведальнага за выкананне крока і крытэрыя завершэння пры зміне коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не прабуючы спадарожваць схованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выканаўся, прычына нехасабносты должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Автэнтыфікуйцеся на входзе і паўторна автарызуйцеся на роўні дадзенняў. Толькі токэн-носіцель не ёсць межай адпаведальнасцяў.
Архітэктура і механізмы
Для этапы «Архітэктура механік» неабяцо пазначыць вхідныя даны, адпаведальнага за крок і крэтырыя для завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозрываючы схованы стан. Спрыяйце гэтай этапы як даговору межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, пазначыць крэтырыя успеху і адмовіцеся ад тыхняга частковага завершэння без паведамлення. Автэнтыфікуйцеся на в’язку і парадзельна автарызавайцеся на роўні дадзенняў. Толькі токэн-носіцель не ёсцца межай арэндаванага рэсурсу.
Ключовыя прынады
У стадыі «Ключовыя прынтэсы» неабходна ясная ваказка ўсіх параметраў, адпаведальнага за выкананне крока і крэатарыяў для завершэння працы перад праверкай коду. Аператары должны магчымае перзапускаць крок з вядомай точкі контролю, не прабуючы спадарожваць схованы стан сістэмы. Неабходна фіксацыя часу выканання і вартасці токена або запыту разам з функцыйнальнымі рэзультатамі. Відразліва візуалізацыя вартасцей запобегае неспакоўным рашчыткам, калі працэс пераходзіць з дэмовай асяроддзя ў спакульную. Аўтэнтыфікацыя павінна выканана ў шлюзе, а пераправерка — у плоскасці дадзеных. Толькі токен-несучы не ёсць межай адпаведнага тэнантства.
Калі выкарыстоўваць
У стадыі «Календар змаўкання» неабходна прадзефінавацыя вхідных дадзеных, адпаведальнага за крок і крэтарыяў завершэння працы перад змінайом коду. Аператары должны магчымае перзапускаты крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Конфігурацыю трэба захаваць паза кодам прыемліка. Файлы сераўнавання, хранальнікі секрэтных дадзеных і флагі функцый належаць у аднам месца, якое аператары можаць пераглядаць без неабяжнага чытання всіх элементаў сістэмы. Автэнтыфікацыя выканаліваецца на воратах, а паўторная автарызацыя — на роўні дадзеных. Сам токен-носіцель не ёсць межай аб’екта выкарыстоўвання.
3. Мінімальны рэжым (dsh minimal / dsh --profile minimal)
Для 3-й этапы Minimal Mode dsh неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыры завершэння пры змяне коду. Аперацыйныя працавнікі должны магчымае запускаць крок з вядомай точкі контролю, не падозрываючы схованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе перакрыцця і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не чымсь, што дадаецца пазней. Автэнтыфікуйцеся на воратах і паўторна автарызуйцеся на роўні дадзенняў. Толькі токэн-носіцель не ёсць межай арэндавання.
Архітэктура і механізмы
Для этапы «Архітэктура і механіка» неабяцо практычная вялікасць інпутаў, адпаведальнага за крок і крэтарыяў завершэння працы перад зменым коду. Аперацыйныя працавнікі павінны магчыма было перзапусціць крок з вядомага пункту контролю, не спадзяючыся на заштынены стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптаў. Калі крок не выйшоў, прычына нехарактэрыстыкі павінна вказваць на адзіну адпаведальнасць, а не на заплутаны ланцоўкі задач. Автэнтыфікуйцеся на входзе і практычна автарызуйцеся на роўні дадзенняў. Толькі токэн-носіцель не ёсцца межай адпаведальнасцяў. Для этапы «Архітэктура і механіка» неабяцо практычная вялікасць інпутаў, адпаведальнага за крок і крэтарыяў завершэння працы перад зменым коду. Аперацыйныя працавнікі павінны магчыма было перзапусціць крок з вядомага пункту контролю, не спадзяючыся на заштынены стан. Запісвайце час выканання і косць токэнаў або запытак праза функцыйнае рэзультат. Відкрытыя даныя пра косцы з’являюцца рана, таму не будзе неспадзянанных счытанняў, калі працэс пераходзіць з дэмавайнага рэжыма ў спадзеленыя сераўеры.
Ключовыя прынтэсы
Калі вы працуеце на стадзіі ключовых прынтэсоў, спачатку запішыце контракт: неабходныя даны, сігнал успеху і тое, што выходзіць па частым неяксамоце. Такі спіс дапамагае залічыць пазнейшыя змены ў кодзе. Зберагаюце настройкі за межамі коду прыемліка. Файлы сераўіса, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аўдыт без неабяжнага чытання всіх элементаў. Запішыце назву інструмента, хэш аргументаў, час адклікання і рэзультат кожнага вызову. Без такога лёгкага следу дэбагаванне агента займае гадзіны.
Калі выкорыстоўваць
Калі працюеце над этапам «Калі вжываць», спачатку запісайце угоду: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс перакладзець пазнейшыя змены коду ў правільны направленні. Документавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пазнейшым дапрацоўкам. Зявляйце логі з назвай інструмента, хэшам аргументаў, часам затрымкі і рэзультатам кожнага вызову. Без такога следу дэбаггінг агента губіць гадзіны.
4. Рэжым стваральніка (dsh creator / dsh --profile creator)
Калі працуеце з 4 стадзіямі рэжыма Creator Mode dsh, спачатку запісайце угоду: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс контроля дапамагае заліцьварыць пазнейшыя змены ў кодзе. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына нявыпання павінна вказываць на адзіну адпаведальнасць, а не на заплутаны ланцужок задач. Запісвайце назву інструмента, хэш аргументаў, час адклікання і рэзультат кожнага вызову. Без такога следу дэбагаванне агента займае гадзіны.
Архітэктура і механізмы
Калі працюеце над стадзіяй «Механіка архітэктуры», спачатку запісайце контракт: неабяжлівыя даныя, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс контроля дапамагае заліцьварыць пасляэйшныя змены коду. Спрыводзіце гэтую стадзію як контракт межа данымі і перакананымі выходамі. Дайце назву рэзультатам, задаце крытэрыі успеху і не падзеляйцеся на частковыя завершэння без паведамлення. Запісвайце назву інструмента, хэш аргументаў, час затрымкі і рэзультат кожнага вызову. Без такога лёгкага следу дэбагаванне губіць гадзіны.
Вялікі паўнайшы кансультатар па локальной установцы
Калі працуеце з «Вялікім кансэптам для локальнага етапу», спачатку запісайце контракт: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Запісвайце час выканання і кост токена або запыту праза функцыйнальнымі рэзултатамі. Відразы відомасці коста запобегае неспакоўным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя асяроддзя. Запішвайце назву інструмента, хэш аргументаў, час затрымкі і рэзултат кожнага вызову. Без такога лёгкага следу дэбагаванне агента займае гадзіны.
Варыянт А: Швайны старт за адной командай праз npx
Калі вы працуеце над стадзіяй «Швырак-старт з адной командай» для варыянта А, спачатку запісаце кантракт: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Зберагаеце настройкі паза кодам прыемлі. Файлы сераўнавання, хранільнікі секрэтных даных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куда аператары можуць адбавіць аўдыт без неабяжлівага чытання всей структуры. Запісваеце назву інструмента, хэш аргументаў, час затрымкі і рынак кожнага вызову. Без такога лёгкага следу час на дэбагаванне губіцца за гадзіны.
npx @deepseek-ai/dsh web
Варыянт Б: Створэнне на адной базе для развіцця расшырэнняў
Калі працуеце над будовай Варыянта B паэтапна, спачатку запісайце контракт: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс перакладоў заходзіць на тое, каб пазнейшыя змены коду былі чыстымі. Дакументавайце як шлях успеху, так і шлях вяснавання. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пазнейшым дапрацоўкам. Зявляйце логі з назвай інструмента, хэшам аргументаў, часам затрымкі і рэзультатам кожнага вызову. Без такога следу дэбаггінгавы агент траціць гадзіны на безрэзультатныя цыклы.
# Clone the official repository
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
# Install workspace dependencies
pnpm install# Compile TypeScript monorepo packages
pnpm run build# Launch the Web interface profile
pnpm dsh web
```
dsh --profile headless "Run project test suites, identify root causes of failures, and propose targeted code fixes."
```
Праўяжанне DeepSeek Harness да локальных модэляў Ollama
Калі працуеце над практыкам Connecting DeepSeek Harness для перавода ў стадыю, спачатку запісайце умовы вікорыстання: неабяжныя даны, сігнал успеху і тое, што выканаецца у разе частковага невыполнення. Такі спіс дапамагае заліцвачваць пазнейшыя змены ў кодзе. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, невыполнення должна паказваць на адну конкрэтную відпаведальнасць, а не на заплутаны ланцюг задач. Запісвайце ідэнтыфікатор запіту, ідэнтыфікатор мадэлі і час адпаведзь на кожны вызов. Без такога лісту пры перыодычных кантэкстных адміністратывальных памылках можна спачатку прыйняць іх за багі ў самай аплікацыі. Калі працуеце над практыкам Connecting DeepSeek Harness для перавода ў стадыю, спачатку запісайце умовы вікорыстання: неабяжныя даны, сігнал успеху і тое, што выканаецца у разе частковага невыполнення. Такі спіс дапамагае заліцвачваць пазнейшыя змены ў кодзе. Запісвайце часы выканання, а таксу токеноў чы запітаў разам з функцыйнальнымі рэзултатамі. Відразувыя даны пра вартасць запобегаюць неспакойным рахункам, калі працэс пераходзіць з дэмовай версіі ў спяльныя сераўы.
Выбір мадэлі і вімогі до памяці
Этап выбору мадэлі і вімог до памяці працюе найкрашча, калі яго розглядаць як віміроўваную плошчу. Запісаце адна ідэальная транскрыпцыя, адзін прыклад неудачы і прыметку про відкат перш чым расшырваць масштаб. Зберагачыце настройкі паза кодам прыемлена. Файлы серавіса, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць пераглядаць іх без неабяжнага чытання всіх дадзеных. Встановіце ліміт токенаў на кожны раунд і на кожную сесію. Інструменты з агентным рэжымам актыўна расшырваюць кантэкст; жорсткія ліміты запобегаюць таму, каб дэманстрацыі ператварыліся на неспакоючыя рахункі.
ollama pull qwen3:14b
Настройка адзінаковых параметраў прадаўця ў DSH
Этап налагоджэння настаўкіх спецыяльных прадастальнікаў работае найэфектывней, калі яго розглядаць як параметр, які можна вымерыць. Зафіксавайце адну ідэальную транскрыпцыю, адзін прыклад неудачы і прыметку па адвярненню перад расшырэнням масштаба. Дакументавайце як успішны, так і вярнучы паты. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не наступным этапам дорабачання. Адкройце інструменты з вузкімі схемамі і чысткімі пазначэннямі побачных эфектаў. Хостам неабходна знаты, якія вызовы меняюць стан, перш чым яны будуць автаматычна затверджаны.
Налагоджэнне інтарфейсу
Этап наладкі інтэрфейса працюе найэфектывней, калі яго розглядаць як параметр, які можна змерыць. Зберагчыце адны ідэальны прыклад працы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расшырваць сферу дзеяння. Валітэ маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына неудачы павінна вказываць на адную адпаведальнасць, а не на заплутаны ланцюг дзеяння. Аб’екты, якія вікорыстоўваюцца, павінны маты часткавыя схемы і чысткія пазначэнні парадоксальных наследкав. Адпаведальныя за эксплуатацыю павінны знаты, якія вызовы моцу зменіць стан сістэмы, перш чым автаматычна схваліць іх. Этап наладкі інтэрфейса працюе найэфектывней, калі яго розглядаць як параметр, які можна змерыць. Зберагчыце адны ідэальны прыклад працы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расшырваць сферу дзеяння. Запісвайце час выканання і вартасць токена або запыту разам з функцыйнальнымі рэзултатамі. Відразувыя даны пра вартасці запобегаюць неспакоўным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спакульную.
Настройка змэнных асяроддзя
У стадыі налаштоввання змянных сераўышча неабходна прадзефінаваць вхідныя даны, адпаведальную особу за выкананне крока і крытэрыя завершэння пры перадзмене коду. Аператары должны магчымаць перывыканне крока з вядомай точкі контролю без неабясненняя схованага стану. Налаштаванні трэба залічыць паза кодам прыкладнення. Файлы сераўышча, хранільнікі секрэтных даных і флагі функцый належаць у аднам месца, якое аператары можаць пераглядаць без чытання всей структуры. Автэнтыфікацыя павінна выканана ў шлюзе, а пераправерка — у роўні дадзеных. Сам токен-носіцель не ёсць межай аб’екта выкарыстоўвання.
export DEEPSEEK_BASE_URL="http://127.0.0.1:11434/v1"
export DEEPSEEK_API_KEY="ollama-local-key"
export DEEPSEEK_MODEL="qwen2.5-coder:14b"
pnpm dsh web
Налаштаванне правіл безпекі рабочага прастору
У стадыі налаштавання правіл безпекі спакета працы неабяжна практычна вказаць інпутаў, адпаведальнага за выкананне крока і крэтарыяў завершэння працы перад змінайом коду. Аператары должны магчымаць перывыканне крока з вядомай точкі контролю без неабяжнага вычыслення схованага стану. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія перакрыцця і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не элементамі пазнейшага доўрабкі. Автэнтыфікацыя выкананае ў шлюзе, а прабава даўальнага доступу — у роўні дадзеных. Сам токен-носіцель не ёсць межай аб’екта выкарыстоўвання.
Выкананне локальнага рабочага працэсу з початку да канца
Для адміністрування етапа «Канцэн-до-канцэн локальна» неабяжна яшчэ перад змінайом код адзначыць вхідныя даны, адпаведальнага за шаг і крэтырыя для завершэння. Аператары должны магчымаць перзапуск шага з вядомай точкі контролю, не падозрываючы прыхованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі шаг не выконваецца, прычына нехарактэрства павінна вказываць на адзіну адпаведальнасць, а не на заплутаны ланцоўкі задач. Автэнтыфікуйцеся на входзе і паўторна автарызуйцеся на роўні дадзенняў. Толькі токэн-носіцель не ёсцца межай адпаведальнасцяў. Для адміністрування етапа «Канцэн-до-канцэн локальна» неабяжна яшчэ перад змінайом код адзначыць вхідныя даны, адпаведальнага за шаг і крэтырыя для завершэння. Аператары должны магчымаць перзапуск шага з вядомай точкі контролю, не падозрываючы прыхованы стан. Запісвайце час выканання і кост токэна або запыту разам з функцыйнымі рэзультатамі. Відразувыя даны пра косцы запобегаюць неспакоўным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спакульнаваныя сераўеры.
Цель задання
Калі працюеце над стадзіяй цэлі задання, спачатку запісайце кантракт: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс пераконтроўвае чыстасць пазнейшых змян у кодзе. Зберагаюце канфігурацыю паза кодам прыемленае. Файлы серавэсу, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аўдыт без неабяжлівага чытання всей структуры. Запісвайце назву інструмента, хэш аргументаў, час затрымкі і рынак кожнага вызову. Без такога лёгкага следу дэбагаванне агента займае гадзіны.
Эканацыя рабочага працэсу па кроках
Калі працуеце над этапам выканання працы па кроках, спачатку запісайце умовы контракту: неабяжлівыя даны, сігнал успеху і тое, што выканаецца у разе частковага нявыпання. Такі спіс пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Документавайце як шлях успеху, так і шлях вярнення да стану нормы. Перапрыбуткі, людзкія контрольныя пункты і обработка некорэктных паведамленняў ёсць часткай продукту, а не пазнейшым дапрацоўкам. Зявляйце логі з назвай інструмента, хэшам аргументаў, часам затрымкі і рэзультатам кожнага вызову. Без такога следу дэбаггінгавы агент траціць гадзіны на безрэзультатныя прабавы.
ollama run qwen2.5-coder:14b
npx @deepseek-ai/dsh web
Развіваючаяся экасістэма агентаў на відкрытым кодзе
Калі працуеце над стадзіяй «The Growing Open-Source Agent», спачатку запісайце умовы вярбунка: неабяжлівыя даныя, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс дапамагае заліцьваты пазнейшыя змены коду. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок нявыпанае, прычына нявыпання павінна вказваць на адзіну абясност, а не на заплутаны ланцюг задач. Запісвайце назву інструмента, хэш параметраў, час адпаведзення і рынак кожнага вызову. Без такіх задапісаў дэбаггаванне цыклаў агента губіць гадзіны. Калі працуеце над стадзіяй «The Growing Open-Source Agent», спачатку запісайце умовы вярбунка: неабяжлівыя даныя, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс дапамагае заліцьваты пазнейшыя змены коду. Запісвайце час выканання і кост токенаў або запытаў разам з функцыйнальнымі рынакамі. Відразувая візуабілізацыя костаў запобегае неспакойным рахункам, калі праця пераходзіць з дэмавайнага рэжыма ў спакульнаныя сераўысы.
Стратэгічныя выводы
Этап стратэгічнага аптыварання працюе наяўней, калі яго спрыяваць як мерыемую плошчу. Зафіксавайце адны ідэальны прыклад, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць масштабы. Зберагаюце настройкі пазначэнныя ад коду прыемлі. Файлы сераўіснага сераўісу, хранілішчы секрэтных дадзеных і пазнакі функцый канаецься ў адным месца, дзе аператары можаць аўдытаваць іх без неабяжнага чытання всіх дадзеных. Адкройце інструменты з вузкімі схемамі і чытальнымі пазначэннямі побачных эфектаў. Хостам неабходна знаты, якія вызовы мутуюць стан, перш чым яны автаматычна схваляюць іх.
Чэк-ліст для аператыўнай працы
Для этапу чэк-ліста для аператыўнай працы неабходна з’явіць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння перш чым зменіць код. Аператары должны магчымае перзапускаць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан.
Спрытваце гэты ўражак як кантракт межа вхіднымі дадзеннямі і пасвярджанымі выходнымі рэзультатамі. Дайце назвы артыфактам, задаце крытэрыя успеху і не прымайце часткова завершэння без паведамлення.
Автэнтыфікуйцеся на в’язку і параправерыце правы пры доступе да дадзенняў. Толькі токэн-носіцель не ёсць межай аб’екта.
Зробіце перапытку пасля дорогіх крокаў. Сістэма вярнення не павінна знову ставіць плату за той самы вызов LLM, калі аператар прабуе зноў запрацаваць пазнейшы вузел.
Фіксуйце версіі залежнасцяў і запісвуйце хэш адобраза, які выканаў дэманстрацыю. Возможнасць павторнага стварэння рэзультата лепшая за традыцыйныя методы.
Документавайце як шлях успеху, так і шлях вярнення да нормальнага стану. Прабыткі, людзкія контрольныя пункты і обработка некорэктных паведамленняў ёсць часткай продукту, а не дадатковым удосконаленнем.
Перш чым запускаць стак, заморозьце версіі, зафіксавце «золаты» транскрыпты для крытычных шляхоў і паказваце крокі для вярнення да пачатковага стану. У спільных серэдавішчах неабходны ліміты частоты запытанняў, пераказкі наявнасці праваў і чысткае апанавальнік для змены секрэтных даных. Валіце простую надзяйнасць працы над крэатывнымі, адзінразовымі дамах.
Прыметка для bd2b3936aecf: не кладзіце ключы прадаўцаў у рэпазітарый, задаце верхнюю межу токенаў на кожную сесію і зберагачыце транскрыпты празаўседы ў фікстурах eval, каб пазнейшыя замены модэляў заставаліся пораўнанымі.