"To achieve great things, two things are needed: a plan and not quite enough time." - attributed to Leonard Bernstein
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 และไม่มีระนาบข้อมูลภายนอก
ดูรายการทั้งหมดได้ที่ หน้ารวมความสามารถ และ ตารางเปรียบเทียบฟีเจอร์ ซึ่งเป็นดัชนีอย่างละเอียด
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 โดยเฉพาะ
วิดีโอบันทึกด้านบนเป็นการทำงานจริงและมาพร้อมหลักฐานในตัว ไฟล์บันทึกเซสชัน ใบเสร็จการทำงานที่มีลายเซ็นกำกับซึ่งสร้างขึ้นจากเจอร์นัลของรอบนั้น และคีย์สาธารณะที่ตรึงข้อมูลทั้งหมดไว้ อยู่ใน 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 คอลัมน์ซ้ายและขวาจะเลื่อนอย่างอิสระเป็นแผงเต็ม ทำให้เข้าถึงวิดเจ็ตด้านล่างได้แม้ในหน้าต่างเทอร์มินัลขนาดสั้น
![]() |
![]() |
|---|---|
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
แต่ละเป้าหมายจะดำเนินผ่านสี่ขั้นตอน:
- แยกย่อยงาน (Decompose) ผู้จัดการจะแบ่งเป้าหมายของคุณออกเป็นงานย่อยพร้อมบทบาท ไฟล์ที่รับผิดชอบ และสัญญาณการเสร็จสิ้น เรียกใช้ LLM หนึ่งครั้ง จากนั้นเป็น Python ล้วนๆ
- เริ่มกระบวนการ (Spawn) เอเจนต์จะเริ่มต้นใน git worktrees ที่แยกส่วนกัน หนึ่งงานเขียนโค้ดต่อหนึ่ง worktree ส่วนงานโหมดอาร์ติแฟกต์จะได้ไดเรกทอรีทำงานทั่วไป สาขาหลักจะสะอาดอยู่เสมอ
- ตรวจสอบความถูกต้อง (Verify) ผู้ดูแล (janitor) ตรวจสอบสัญญาณที่เป็นรูปธรรม: การทดสอบผ่าน ไฟล์มีอยู่จริง การตรวจ lint ผ่าน ชนิดข้อมูลถูกต้อง
- รวมโค้ด (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


