Skip to content

Latest commit

 

History

History
190 lines (130 loc) · 35 KB

README.th.md

File metadata and controls

190 lines (130 loc) · 35 KB
Bernstein
Bernstein - deterministic multi-agent CLI orchestration

"To achieve great things, two things are needed: a plan and not quite enough time." - attributed to Leonard Bernstein

การประสานงาน CLI หลายเอเจนต์แบบกำหนดผลลัพธ์แน่นอน

CI PyPI GHCR Python 3.12+ License OpenSSF Scorecard CodeQL Open in Codespaces MCP Toplist Ask DeepWiki

website · docs · install · first run · glossary · limitations · name policy · sponsor

简体中文 · 繁體中文 · 日本語 · 한국어 · हिन्दी · বাংলা · Русский · Español · Português · Deutsch · Français · Italiano · Nederlands · Polski · Svenska · Suomi · Українська · Türkçe · العربية · עברית · Bahasa Indonesia · Tiếng Việt · ไทย


สถานะ: เบต้า ดูแลรักษาโดยผู้พัฒนาคนเดียว และอยู่ระหว่างการพัฒนาอย่างต่อเนื่อง หมายเลขเวอร์ชันนับตามรอบการเปิดตัว ไม่ใช่ระดับความสมบูรณ์ — เวอร์ชันย่อย (minor) อาจมีการเปลี่ยนแปลงอินเทอร์เฟซ โปรดตรึงเวอร์ชันสำหรับงานที่ต้องพึ่งพาอย่างยิ่งยวด โดยข้อผิดพลาดที่เกิดขึ้นซ้ำจะได้รับการแก้ไขอย่างรวดเร็ว แจ้งปัญหาได้ที่นี่

Bernstein เป็นระบบประสานงานแบบกำหนดผลลัพธ์แน่นอน (deterministic orchestrator) สำหรับเอเจนต์เขียนโค้ดบน CLI (Claude Code, Codex, Gemini CLI และอีกกว่า 40 รายการ) โดยสั่งงานเอเจนต์คู่ขนาน ควบคุมผลลัพธ์ผ่านเกตตรวจสอบ (gates) และบันทึกข้อมูลการทำงานอย่างละเอียดเพื่อให้คุณตรวจสอบย้อนหลังได้ มีโปรไฟล์การติดตั้งสำหรับระบบแยกเครือข่าย (air-gap) ในตัว ลิขสิทธิ์ Apache-2.0

สรุปภาพรวม

สี่จุดเด่นที่สร้างความแตกต่าง ส่วนที่เหลือคือรายละเอียด

  • ไม่มี LLM ในลูปการประสานงาน การจัดตารางงานเขียนด้วย Python ล้วน ทำให้การทำงานสามารถทำซ้ำได้แบบครบวงจรตั้งแต่ต้นจนจบ รันแผนของเมื่อวานซ้ำแล้วได้กราฟงานเดิมของเมื่อวานอย่างแม่นยำ
  • ตรวจสอบย้อนหลังได้จริง เจอร์นัลการเล่นซ้ำ (replay journal) บันทึกทุกรอบการทำงาน และแกนสืบสายประวัติ (lineage spine) ที่เปิดทำงานตลอดเวลาจะบันทึกทุกขั้นตอนที่สร้างประวัติ ส่วนบันทึกการตรวจสอบแบบผูกโยง HMAC ทางเลือก (BERNSTEIN_AUDIT=1) จะเพิ่มใบเสร็จ (receipts) ที่คุณสามารถตรวจสอบแบบออฟไลน์ได้ ความไม่แน่นอนจะปรากฏเป็นค่าแฮชไม่ตรงกันในขั้นตอนที่แน่นอน แทนที่จะเป็นข้อผิดพลาดแบบสุ่มเมื่อรันใหม่ ผลงานที่ไม่ใช่โค้ดก็ได้รับการจัดการเช่นเดียวกัน: งานสามารถประกาศสัญญาอาร์ติแฟกต์ (รายงาน, ชุดข้อมูล, บันทึกการดำเนินการ, ผลการทำงานฝ่ายปฏิบัติการ) และเสร็จสิ้นด้วยใบเสร็จสายประวัติที่มีลายเซ็นกำกับแทนการทำ git commit
  • แยกส่วนอย่างเคร่งครัดตามโครงสร้าง แต่ละงานเขียนโค้ดจะได้ git worktree ของตนเองหลังเกตการรวมโค้ด ส่วนงานโหมดอาร์ติแฟกต์จะได้ไดเรกทอรีทำงานใต้ .sdd/workspaces/ เอเจนต์จะไม่แชร์พื้นที่ทำงานที่แก้ไขได้โดยค่าเริ่มต้น สถานะเดียวที่ใช้ร่วมกันคือรายการงานค้าง (backlog) ซึ่งถูกจองแบบอะตอมิก การบังคับใช้ระบบไฟล์ที่เข้มงวดยิ่งขึ้นเป็นตัวเลือกเสริมผ่าน แบ็กเอนด์แซนด์บ็อกซ์ หากปิดการใช้งาน worktree แต่ละงานจะทำงานในไดเรกทอรีร่วมกัน
  • ครอบคลุมและทำงานในเครื่อง มีอะแดปเตอร์เอเจนต์ CLI มากกว่า 40 รายการ พร้อมตัวครอบ --prompt ทั่วไป สถานะอิงตามไฟล์ ไม่ต้องพึ่งพา SaaS และไม่มีระนาบข้อมูลภายนอก

ดูรายการทั้งหมดได้ที่ หน้ารวมความสามารถ และ ตารางเปรียบเทียบฟีเจอร์ ซึ่งเป็นดัชนีอย่างละเอียด

ติดตั้งใน 30 วินาที

uv tool install bernstein    # or: pipx install bernstein
bernstein init
bernstein doctor             # checks a CLI agent is installed and authenticated
bernstein -g "fix the failing test in tests/test_foo.py"

pipx, pip, brew, dnf, npm และ Docker มีเนื้อหาอยู่ใน คู่มือการติดตั้ง ส่วนแพ็กเกจสำหรับระบบแยกเครือข่ายมี คู่มือ air-gap โดยเฉพาะ

A real bernstein demo run: mock agents fix four seeded bugs, ending on the run's signed receipt verifying offline

วิดีโอบันทึกด้านบนเป็นการทำงานจริงและมาพร้อมหลักฐานในตัว ไฟล์บันทึกเซสชัน ใบเสร็จการทำงานที่มีลายเซ็นกำกับซึ่งสร้างขึ้นจากเจอร์นัลของรอบนั้น และคีย์สาธารณะที่ตรึงข้อมูลทั้งหมดไว้ อยู่ใน docs/assets/demo-run/ ตรวจสอบรอบการทำงานที่คุณเพิ่งชมแบบออฟไลน์:

bernstein verify receipt docs/assets/demo-run/run-receipt.json \
    --public-key docs/assets/demo-run/run-receipt.pub.pem

ระบบ CI จะตรวจสอบใบเสร็จที่คอมมิตไว้อีกครั้งในทุกการ push ไปยัง main — และพิสูจน์ว่าสำเนาที่ถูกดัดแปลงจะล้มเหลว — เพื่อให้หลักฐานที่เผยแพร่ไม่กลายเป็นไฟล์ประดับ scripts/record_demo.sh สร้างวิดีโอบันทึก ใบเสร็จ และคีย์ขึ้นใหม่จากการรันจริงรอบใหม่ โดยไม่มีสิ่งใดในเทอร์มินัลที่เป็นการจำลองขึ้น

สามารถติดตามรอบการทำงานที่กำลังดำเนินอยู่ได้จากหน้าจอผู้ปฏิบัติงานทั้งสองแบบ ทั้งคู่ดึงข้อมูลจาก API งานเดียวกัน จึงไม่มีหน้าจอใดที่แสดงผลล่าช้ากว่า ใน bernstein live คอลัมน์ซ้ายและขวาจะเลื่อนอย่างอิสระเป็นแผงเต็ม ทำให้เข้าถึงวิดเจ็ตด้านล่างได้แม้ในหน้าต่างเทอร์มินัลขนาดสั้น

A two-column terminal dashboard - agents with their live logs on the left, the task board on the right - with a full-width activity feed and a cost line underneath A browser dashboard listing sixty-two tasks with eleven running, one of them opened to its working-tree diff
bernstein live — แดชบอร์ดในเทอร์มินัล bernstein gui serve — แดชบอร์ดในเบราว์เซอร์

พิสูจน์รอบการทำงาน

การกำหนดผลลัพธ์แน่นอนในที่นี้คือสิ่งที่คุณตรวจสอบได้จริง ไม่ใช่สิ่งที่ต้องยอมรับด้วยความเชื่อ รันหนึ่งครั้งโดยเปิดใช้งานการตรวจสอบ แล้วตรวจดูสิ่งที่บันทึกไว้:

BERNSTEIN_AUDIT=1 bernstein -g "fix the failing test in tests/test_foo.py"
bernstein replay list                 # run ids recorded on disk
bernstein replay latest --verify      # recompute the journal head, name the first divergent step
bernstein lineage verify <run_id>     # recompute the always-on lineage spine
bernstein audit verify                # HMAC chain + Merkle seal (written because audit was enabled)
bernstein audit diagnose <run_id> --signal gate --sign-key KEY
                                      # name the exact step a failure entered the run, as a signed receipt
bernstein verify run <run_id> --signing-key-path key.pem   # sign one portable run receipt
bernstein verify receipt .sdd/runs/<run_id>/run-receipt.json  # verify it offline: file only

เจอร์นัลจะถูกบันทึกในทุกรอบการทำงาน แกนสืบสายประวัติจะเปิดทำงานตลอดเวลาและเพิ่มรายการสำหรับแต่ละขั้นตอนที่มีประวัติ ดังนั้นการรันระยะสั้นสามารถสิ้นสุดด้วยแกนที่ถูกต้องและว่างเปล่าได้ bernstein audit verify จะมีสายการตรวจสอบเมื่อเริ่มการรันด้วย BERNSTEIN_AUDIT=1, โปรไฟล์การปฏิบัติตามข้อกำหนด หรือ bernstein run --audit แฟล็ก --audit เป็นของคำสั่ง bernstein run ส่วนในรูปแบบ bernstein -g ด้านบน ให้ตั้งค่าผ่านตัวแปรสภาพแวดล้อม

ใบเสร็จรอบการทำงานจะผูกส่วนหัวของเจอร์นัล ส่วนหัวของแกนสืบสายประวัติ (เมื่อมีการบันทึกรายการ) และช่วงสายการตรวจสอบทางเลือก ภายใต้วัตถุเดียวที่ลงลายเซ็น Ed25519 พร้อมคีย์สาธารณะฝังในตัว ผู้ตรวจสอบที่มีไฟล์นั้นและคีย์สาธารณะของผู้ปฏิบัติงานสามารถยืนยันได้ว่าการดำเนินการและสายข้อมูลที่ฝังไว้ไม่ถูกแก้ไข: ไม่ต้องใช้คีย์ HMAC ไม่ต้องมีโฟลเดอร์ .sdd/ ที่กำลังทำงาน และรหัสออก 2 จะระบุขั้นตอนแรกที่เบี่ยงเบนหากมีการดัดแปลง ใบเสร็จนี้ระบุสถานะเจอร์นัลที่ฝังอยู่ การพิสูจน์ว่าสถานะนั้นคือเจอร์นัลฉบับสมบูรณ์ที่เสร็จสิ้นแล้วจำเป็นต้องมีตราประทับส่วนหัว/จำนวนที่เป็นอิสระเพิ่มเติม หากใช้ไฟล์เพียงอย่างเดียวโดยไม่ระบุ --public-key จะเป็นการตรวจสอบความสมบูรณ์ภายในเท่านั้น รายละเอียดใน การเล่นซ้ำแบบกำหนดผลลัพธ์แน่นอน

ความสามารถในการตรวจสอบแบบเดียวกันนี้ใช้กับตัวเลขการประเมินผล bernstein bench run <suite> --reliability k (เขียนว่า bernstein eval --reliability k ได้เช่นกัน) จะรันแต่ละงาน k ครั้งภายใต้การประสานงานคงที่ จากนั้นรายงานขอบเขตล่าง pass^k (การทดสอบทั้ง k ครั้งต้องผ่านทั้งหมด) ควบคู่กับขอบเขตบน pass@1 ผลลัพธ์นี้จะถูกประทับตราในใบเสร็จที่มีลายเซ็นกำกับซึ่ง bernstein bench reliability-verify คำนวณใหม่แบบออฟไลน์ ทำให้ขอบเขตล่างที่สร้างขึ้นปลอมๆ ไม่ผ่านการตรวจสอบ รายละเอียด: ขอบเขตล่างความน่าเชื่อถือ pass^k

การทำงานของระบบ

แต่ละเป้าหมายจะดำเนินผ่านสี่ขั้นตอน:

  1. แยกย่อยงาน (Decompose) ผู้จัดการจะแบ่งเป้าหมายของคุณออกเป็นงานย่อยพร้อมบทบาท ไฟล์ที่รับผิดชอบ และสัญญาณการเสร็จสิ้น เรียกใช้ LLM หนึ่งครั้ง จากนั้นเป็น Python ล้วนๆ
  2. เริ่มกระบวนการ (Spawn) เอเจนต์จะเริ่มต้นใน git worktrees ที่แยกส่วนกัน หนึ่งงานเขียนโค้ดต่อหนึ่ง worktree ส่วนงานโหมดอาร์ติแฟกต์จะได้ไดเรกทอรีทำงานทั่วไป สาขาหลักจะสะอาดอยู่เสมอ
  3. ตรวจสอบความถูกต้อง (Verify) ผู้ดูแล (janitor) ตรวจสอบสัญญาณที่เป็นรูปธรรม: การทดสอบผ่าน ไฟล์มีอยู่จริง การตรวจ lint ผ่าน ชนิดข้อมูลถูกต้อง
  4. รวมโค้ด (Merge) งานที่ผ่านการตรวจสอบแล้วจะถูกรวมเข้าสู่ main งานที่ไม่ผ่านจะได้รับการลองใหม่หรือส่งต่อไปยังโมเดลอื่น

เหตุใดตัวจัดตารางงานจึงเป็น Python ล้วน และสิ่งที่ต้องแลกเปลี่ยน: ทำไมต้องกำหนดผลลัพธ์แน่นอน

คำสั่งที่ใช้ประจำวัน

cd your-project
bernstein init                    # creates .sdd/ workspace, bernstein.yaml + templates/
bernstein -g "Add rate limiting"  # agents spawn, work in parallel, verify, exit
bernstein live                    # watch progress in the TUI dashboard
bernstein run plan.yaml           # multi-stage plan: skip LLM planning, execute directly
bernstein stop                    # graceful shutdown with drain

ชุดคำสั่งผู้ปฏิบัติงานทั้งหมด (การจัดการ PR อัตโนมัติ, ตารางเวลา, ตัวเชื่อมต่อแชท, เดมอน autofix) อยู่ใน คำสั่งผู้ปฏิบัติงาน

เกตสุขอนามัยของที่เก็บโค้ด: bernstein readme-l10n verify จะทำให้ PR ที่ไฟล์ README ฉบับแปลคลาดเคลื่อนจากต้นฉบับภาษาอังกฤษล้มเหลว (พร้อมระบุส่วนที่ล้าสมัย) ส่วน bernstein readme-l10n sync จะผูกการเชื่อมโยงใหม่หลังจากการแก้ไขภาษาอังกฤษ ดูที่ readme-l10n

เอเจนต์ที่รองรับ

Claude Code, Codex CLI, Gemini CLI, GitHub Copilot CLI, Cursor, Aider, Goose, Muse Code, OpenAI Agents SDK, Amp, Cody, Continue, Devin Terminal, Junie, Kilo, Kiro, AWS Q Developer, Ollama, OpenCode, OpenHands, Open Interpreter, gptme, Plandex, AIChat, Letta Code, Qwen และอื่นๆ ดัชนีอะแดปเตอร์ มีคำสั่งติดตั้งสำหรับ 30 รายการในจำนวนนี้ คำสั่ง bernstein integrations list แสดงรายการการเชื่อมต่อทั้งหมด 51 รายการจาก src/bernstein/adapters/registry.py ซึ่งเป็นแหล่งความจริงเพียงแห่งเดียว โดย 49 รายการเป็นอะแดปเตอร์เอเจนต์ที่เลือกใช้งานได้ ส่วนอีกสองแถวคือตัวทดสอบ mock และโปรไฟล์ปลายทาง self-hosted-endpoints เครื่องมืออื่นๆ ที่มีแฟล็ก --prompt สามารถทำงานผ่านตัวครอบทั่วไปได้

ผสมผสานเอเจนต์ในการรันรอบเดียวกัน: ใช้โมเดลในเครื่องราคาประหยัดสำหรับโค้ดโครงสร้างพื้นฐาน และใช้โมเดลบนคลาวด์ที่ทรงพลังกว่าสำหรับสถาปัตยกรรม คำสั่ง bernstein integrations list --installed จะแสดงรายการที่มีอยู่ในเครื่องของคุณ

เนื้อหาเชิงลึกนอกเหนือจากหน้าแรก

เนื้อหาเชิงลึกทั้งหมดอยู่ใน เว็บไซต์เอกสารคู่มือ:

หน้า สิ่งที่ครอบคลุม
capabilities รายการความสามารถทั้งหมด: โหมดเซิร์ฟเวอร์ MCP, การ์ดเอเจนต์ที่มีลายเซ็นกำกับ, แบ็กเอนด์แซนด์บ็อกซ์, ปลายทางบันทึกอาร์ติแฟกต์, การแมปตามข้อกำหนดกำกับดูแล
who this is for จุดที่สร้างคุณค่า และกรณีที่ Bernstein ไม่ใช่เครื่องมือที่เหมาะสม
workflows YAML DAG แบบประกาศโครงสร้างของโหนด agent / command / loop
web UI แดชบอร์ดบนเบราว์เซอร์ที่ทำงานบน API เดียวกับที่ TUI ใช้งาน
cloud execution ขั้นทดลอง: รันเอเจนต์บน Cloudflare Workers พร้อมการซิงค์พื้นที่ทำงาน R2 บนบัญชีของคุณเอง บริการโฮสต์ api.bernstein.run ยังไม่เปิดให้บริการ
datasources ใบเสร็จการสืบค้นแบบอ่านอย่างเดียว พร้อมไดรเวอร์การสืบค้นที่ผูกแต่ละผลลัพธ์กับสแนปช็อตสกีมาที่ใช้สร้างผลลัพธ์
agent catalogs กำหนดบทบาทไปยังคำจำกัดความเอเจนต์ภายนอกเทมเพลตในตัว — ไดเรกทอรี YAML/SKILL.md ทั่วไป หรือโครงสร้างปลั๊กอิน Claude Code
security ตารางคะแนนความปลอดภัย, การทดสอบฟัซซิ่ง (fuzzing), การเสริมความปลอดภัย
architecture การทำงานเชิงลึกภายในระบบ

ที่มาของชื่อ?

Bernstein ตั้งชื่อตาม Leonard Bernstein วาทยกรและคีตกวีชาวอเมริกัน โครงการนี้ประสานงานทีมเอเจนต์เขียนโค้ดบน CLI เหมือนที่ Bernstein อำนวยเพลงวง New York Philharmonic: ผู้เล่นทุกคนเข้าตรงจังหวะ โน้ตเพลงกำหนดผลลัพธ์แน่นอน และวาทยกรรับผิดชอบต่อผลงานในภาพรวม

ผมเขียน bernstein ขึ้นมาเพราะต้องจ่ายค่าบริการ claude เดือนละ $400 จากการรันเอเจนต์เขียนโค้ดสามตัวพร้อมกันแล้วได้ผลลัพธ์การรวมโค้ดที่ไม่แน่นอน ลิขสิทธิ์ Apache 2.0 ดูแลโดยผู้พัฒนาคนเดียว ดูสถิติสดได้ที่: bernstein.run

ได้รับการกล่าวถึงใน

มีรายชื่ออยู่ใน vinta/awesome-python, ได้รับการนำเสนอในบทความรวม ตัวประสานงานเอเจนต์โอเพนซอร์ส ของ Augment Code และมีรายชื่อใน Python Weekly #742 นอกจากนี้เรายังได้บันทึกแนวทางนี้เป็นรูปแบบ การประสานงานแบบกำหนดผลลัพธ์แน่นอนโดยไม่ใช้ LLM ใน awesome-agentic-patterns

การกล่าวถึงทั้งหมด: กว่า 20 รายการ awesome list, ไดเรกทอรี, จดหมายข่าว และการอ้างอิงทางวิชาการ

รายการติดตามฉบับเต็ม รวมถึงทุกรายการใน awesome-list, แคตตาล็อก, การอ้างอิงผลงานก่อนหน้า และจดหมายข่าว อยู่ใน docs/mentions.md โดยจะเพิ่มรายการใหม่เมื่อปรากฏขึ้น และยินดีรับการแก้ไขผ่าน issue หรือ PR

การมีส่วนร่วม, การสนับสนุน, ลิขสิทธิ์

ยินดีรับ PR เสมอ CONTRIBUTING.md มีคำแนะนำการตั้งค่าและสไตล์โค้ด การรายงานด้านความปลอดภัยแจ้งผ่าน SECURITY.md หาก Bernstein ช่วยประหยัดเวลาของคุณ: GitHub Sponsors ติดต่อ: forte@bernstein.run

ข้อมูลเมทาดาทาสำหรับการอ้างอิงอยู่ใน CITATION.cff ลิขสิทธิ์: Apache-2.0 ส่วนชื่อโครงการได้รับการคุ้มครองแยกต่างหากใน TRADEMARKS.md


Alex Chernysh · GitHub · X · bernstein.run