→ חזרה לבלוגEnglish

DeepSeek Harness מבפנים: הכול plugin, והלוג הוא החוזה

איך DeepSeek Harness משתמש ב-Cordis, ב-capability seams וביומן סשן עמיד כדי להרכיב runtime של agent, ומה הסוד העיצובי שלו יחד עם לקח למי שבונה harness.

DeepSeek Harness (dsh) נוקט עמדה ארכיטקטונית חריגה בבירורה: זו לא “מערכת agent עם plugins”, אלא מערכת שבה לולאת ה-agent, יומן הסשן, מתאמי המודלים, הכלים והמדיניות כולם מורכבים כ-plugins. העמדה הזו נשענת על Cordis, framework שמבוסס על הקשר משותף, אירועים טיפוסיים ואפקטים הפיכים.

התוצאה גורמת ל-dsh להרגיש פחות כמו בינארי אחד של מוצר ויותר כמו runtime שמרכיבים. התמורה היא גמישות, אבל הסיפור העמוק יותר הוא משמעת: כשכל דבר ניתן להחלפה, חייבים חוזים חזקים לגבי מה נשאר נכון.

קומפוזיציה וחוזה הלוג ב-DeepSeek Harness

קומפוזיציה לפני התנהגות

מופע רץ של dsh נבנה משכבות מסודרות. profiles (כמו web, headless, SDK, גרסאות ACP) בוחרים bundles, וה-bundles מטענים שורות הגדרה וקוד של Cordis. אפשר לכוון שורות, להחליף הגדרות או להוסיף רכיבים חדשים. במילים אחרות, האפליקציה עצמה היא גרף מורכב, לא ליבה קבועה עם תוספות אופציונליות.

מודל הקומפוזיציה הזה יורד גם לתת-המערכות המרכזיות:

  • Session/log: אירועי סשן append-only ומצב בזיכרון.
  • System prompt: הרכבת prompt וסכמות כלים.
  • Tools: registry בהיקף מוגדר וצינור הרצה מבוקר.
  • Agent + agent loop: ממשק/registry של agent חי וה-driver ברירת המחדל.
  • LLM seam: אוצר מילים של הודעות/stream וממשק מתאם.

מכיוון שאלו שירותים ו-plugins עם גבולות מוכרזים, אפשר להחליף התנהגות על ידי שינוי קומפוזיציה במקום לפצל את המימושים הפנימיים.

זרימת תור כאירועים מפורשים

dsh מתאר תורים וצעדים במונחים של אירועי סשן עמידים ונקודות הרחבה חיות. תור נפתח, קלט נלקח ומורכב, הבקשה מוכנה ומוזרמת, קריאות לכלים עוברות דרך צינורות pre/execute/post, התוצאות נרשמות, והתור נסגר כשאין עוד התחייבויות פתוחות. חלק מהאירועים הם עובדות עמידות ביומן הסשן; אחרים הם hooks/waterfalls חיים שבהם plugins יכולים לצפות או להתערב.

ההפרדה הזו חשובה. אירועים עמידים עונים על השאלה “מה באמת קרה באמת של הסשן?” אירועים חיים עונים על השאלה “איפה אפשר להרחיב התנהגות כרגע?” כששני הסוגים מפורשים, המערכת יכולה להישאר גמישה בלי לאבד יכולת שחזור.

נקודת הסוד: מה שהמודל רואה חייב להיות מתועד

הסוד בלב DeepSeek Harness הוא חוזה מחמיר: אם המודל יכול לראות משהו, הסשן חייב לדעת לתת עליו דין וחשבון.

מסמכי הארכיטקטורה מדגישים שיומן הסשן הוא המקור שממנו נגזרת ההיסטוריה שהמודל רואה. התייצבויות עמידות (הודעות, ניסיונות, תוצאות כלים, אירועי system/user) הן מה שהופך fork, resume, תמלילים, טלמטריה ו-replay לאמינים. streaming חי קיים לטובת UI אינקרמנטלי, אבל הרשומה העמידה היא זו שמגדירה מציאות.

הכלל “model-visible means logged” הוא אילוץ חזק. הוא מאלץ את ה-harness להתייחס להרכבת prompt, לתוצאות כלים ולמעברי state כנתונים מדרגה ראשונה, לא כתופעות לוואי מקריות. במערכת עשירת plugins, החוזה הזה הוא מה שמונע מגמישות להפוך לכאוס.

capability seams הופכים החלפה למעשית

החצי השני של הסיפור הוא seams. dsh ממסגר יכולות מתחלפות דרך הגדרות שירות, ספקים וצרכנים. מערכת קבצים, subprocess, מתאמי LLM, ספקי subagents ושכבות מדיניות יכולים להשתנות מאחורי ממשקים, בזמן ששאר המערכת תלויה ב-seam ולא במימוש קונקרטי.

כך “הכול plugin” הופך ליותר מסיסמה. החלפת התנהגות היא אפשרית כשגבולות המערכת טיפוסיים, ניתנים לתצפית ונאכפים על ידי קומפוזיציה.

לקח למי שבונה harness

הלקח שאפשר לקחת מ-DeepSeek Harness הוא: להפוך יכולת שחזור לחוזה, ורק אז לבנות עליה הרחבה.

מערכות plugins מושכות, אבל בלי invariants חזקים הן מייצרות סיוטי דיבאג. dsh מציע סדר עדיפויות אחר:

  • להגדיר מה חייב להיות עמיד וניתן לשחזור (אירועי סשן, הקשר גלוי למודל, תוצאות כלים),
  • להפריד בין עובדות עמידות לבין hooks חיים של הרחבה,
  • לעצב capability seams כך שספקים יוכלו להשתנות בלי לשכתב צרכנים,
  • ולאפשר לקומפוזיציה לחבר את המערכת במקום להסתיר התנהגות בליבה מיוחסת.

אם רוצים harness שיכול להתפתח, לא מתחילים ב“לעשות הכול ניתן להגדרה”. מתחילים בהחלטה מה המערכת תמיד חייבת לדעת להסביר. ברגע שהלוג וה-seams אמינים, גמישות הופכת לנכס במקום לסיכון.

מקורות

סדרה שבועית

אפשר לקרוא את הפוסטים לפי הסדר:

  1. הוספתי בלוג לאתר האישי (בלי לבנות הכול מחדש) - 2026-11-11
  2. למה PostHog הוא אחד הכלים הראשונים שאני מוסיף למוצר חדש - 2026-11-18
  3. האנטומיה של coding harness: מה באמת מפעיל סוכני קידוד - 2026-11-11
  4. ניהול context ב-coding harnesses: מה באמת נשלח למודל ולמה זה חשוב - 2026-11-18
  5. Goose מבפנים: harness מבוסס MCP עם פרוטוקול במרכז - 2026-11-11
  6. Pi מבפנים: harness מינימלי שנבנה סביב עץ סשנים ופרימיטיבים - 2026-11-18
  7. OpenCode מבפנים: לולאה אחת, מודלים רבים, ומשוב אמיתי מהסביבה - 2026-11-11
  8. DeepSeek Harness מבפנים: הכול plugin, והלוג הוא החוזה (הפוסט הזה) - 2026-11-18

הקודם: OpenCode מבפנים: לולאה אחת, מודלים רבים, ומשוב אמיתי מהסביבה