treg

ทางการ

เซิร์ฟเวอร์ MCP หนึ่งตัวและคีย์หนึ่งชุดสำหรับ API แบบจ่ายต่อการเรียกใช้มากกว่า 3,700 รายการ: SEO และแบ็กลิงก์ การเพิ่มข้อมูลบุคคลและบริษัท โซเชียล โฆษณา การสแครป การสร้างภาพและวิดีโอ ใช้งานระยะไกลที่ https://treg.to/mcp/v2/ (OAuth) หรือโฮสต์เอง

คุณทำอะไรได้บ้างด้วย Treg MCP?

  • ค้นหาแค็ตตาล็อกเครื่องมือตามงาน — ขอให้ผู้ช่วยค้นหา endpoint ตามสิ่งที่ทำได้ เช่น "ค้นหาอีเมลที่ทำงาน" และอ่านพารามิเตอร์กับราคาก่อนเรียกใช้
  • เรียกใช้ endpoint ในแค็ตตาล็อกโดยไม่ต้องใช้คีย์ของผู้ให้บริการ — เรียกใช้ endpoint ในแค็ตตาล็อกผ่านคีย์ของ treg เองหรือเส้นทางสาธารณะที่ยืนยันแล้ว โดยคิดค่าบริการต่อครั้งจากยอดคงเหลือของทีมหรือใช้ฟรีเมื่อไม่ระบุตัวตน
  • ลงทะเบียนและเรียกใช้เครื่องมือของคุณเอง — แชร์ base_url ต้นทางพร้อมข้อมูลลับที่จัดเก็บไว้ หรือ CLI ของผู้ให้บริการ เช่น stripe, gh หรือ vercel แล้วเรียกใช้โดยให้ระบบแทรกข้อมูลรับรองฝั่งเซิร์ฟเวอร์
  • ติดตั้งและแชร์สกิล — ลงทะเบียนสูตร SKILL.md พร้อมข้อมูลลับและเครื่องมือ จากนั้นติดตั้งสกิลที่แชร์ไว้ในเอเจนต์ เพื่อให้การเรียกใช้ผ่าน treg
  • ตรวจสอบยอดคงเหลือและสถานะข้อมูลรับรอง — สอบถามเครดิตคงเหลือและยอดใช้จ่ายล่าสุด หรือตรวจสอบว่าข้อมูลรับรองที่ลงทะเบียนไว้ยังใช้งานได้ตามปกติหรือไม่

เซิร์ฟเวอร์ MCP แบบโฮสต์

npx add-mcp 'https://treg.to/mcp/v2/'

ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ

เอกสาร

Treg (OpenRouter สำหรับเครื่องมือเอเจนต์)

treg — the tool catalog for your agent

OpenRouter แต่สำหรับเครื่องมือเอเจนต์แทนโมเดล ชี้เอเจนต์ไปที่ URL ฐานเดียวด้วยโทเค็นเดียว แล้วก็ทำงานได้เลย: แค็ตตาล็อกที่คัดสรรแล้วซึ่งมีปลายทางนับพันจากผู้ให้บริการหลายราย — SEO และแบ็กลิงก์ โซเชียลและเทรนด์ ข้อมูลเสริมบุคคลและบริษัท โฆษณา การดึงข้อมูล การสร้างภาพและวิดีโอ — คิดราคาต่อการเรียก เริ่มต้นเพียงหนึ่งเซนต์ โดยไม่ต้องสมัครบัญชีกับผู้ให้บริการ และยังใช้คีย์ ทักษะ และ CLI ของทีมคุณเองได้ ซึ่งเอเจนต์ของเพื่อนร่วมทีมทุกคนเรียกใช้ได้โดยที่ข้อมูลรับรองไม่เคยออกจากเซิร์ฟเวอร์

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

สร้างขึ้นสำหรับทีม Superdesign เปิดให้ใช้งานแล้วที่ treg.to — ทุกคนโฮสต์เองได้

เหตุผลที่สร้างขึ้น

เครื่องมือที่เอเจนต์ต้องใช้ทำงานจริงมักอยู่หลังบริการแบบสมัครสมาชิกที่ไม่มีใครซื้อเพื่อใช้งานเพียงครั้งเดียว — Semrush $139/เดือน, Moz $99/เดือน, Crunchbase $99/เดือน, Apollo $59/ที่นั่ง — อยู่หลังกำแพงการสมัคร หรือไม่มี API สาธารณะเลย (ต้องได้รับคำเชิญ เป็นพาร์ตเนอร์เท่านั้น หรือต้องผ่านการตรวจสอบแอป) treg มีบัญชีเหล่านั้นให้ และคิดค่าบริการเพียงเศษเสี้ยวของเซนต์ต่อการเรียก

เครื่องมือสองประเภท ใช้โทเค็นเดียว

  • แค็ตตาล็อก — ปลายทางภายนอกที่ treg ให้บริการได้ด้วยคีย์ของตนเอง หรือผ่าน เส้นทางสาธารณะที่ผ่านการยืนยันแล้วและไม่ต้องใช้คีย์ผู้ให้บริการ การเรียกด้วยคีย์ของ treg ใช้ยอดเงินเติมล่วงหน้าของทีม ส่วนการเรียกแบบไม่ระบุตัวตนใช้ฟรี ไม่ต้องมีบัญชีกับผู้ให้บริการ ทีมที่ยืนยันบัญชีใหม่จะได้รับ $1.00 ฟรี หนึ่งครั้ง เมื่อสร้างทีมที่มีสิทธิ์
  • เครื่องมือของคุณเอง — สิ่งใดก็ตามที่เพื่อนร่วมทีมลงทะเบียนไว้: บัญชี API แบบชำระเงิน การเชื่อมต่อ OAuth CLI ของผู้ขาย หรือ SKILL.md คีย์ของคุณเองมีสิทธิ์เหนือคีย์ของ treg เสมอ และจะไม่มีการคิดค่าบริการสำหรับการเรียกเหล่านั้น

คำศัพท์สำหรับส่วนที่สอง:

  • เครื่องมือ = สิ่งที่รีจิสทรีเรียกใช้แทนคุณด้วยข้อมูลรับรองขององค์กร มีสองประเภท:
    • ปลายทาง — base_url ต้นทาง + การผูกข้อมูลรับรอง (แต่ละการผูกจะแทรกข้อมูลลับหนึ่งรายการลงในคำขอ คำขอหนึ่งรายการอาจมีหลายรายการ เช่น bearer ของ OAuth และ ส่วนหัว developer-token)
    • CLI — ไบนารีของผู้ขาย (stripe, gh, vercel, ...) ที่เรียกใช้โดยแทรกข้อมูลรับรองเข้าไป
  • ทักษะ / บันเดิล = สูตร (SKILL.md) + ข้อมูลลับ + เครื่องมือของทักษะ ซึ่งลงทะเบียนพร้อมกัน

กฎข้อเดียว: พร็อกซี ส่งต่อคำขอ ไม่จำลองการทำงานของ ต้นทาง และ แทรกการยืนยันตัวตนฝั่งเซิร์ฟเวอร์ — จึงยังใช้งานได้แม้ API ต้นทางเปลี่ยน และผู้เรียกไม่ต้องถือคีย์ไว้เอง


ส่วนที่ 1 · การใช้รีจิสทรี

ไปที่ treg.to (โฮสต์บน Render) — แดชบอร์ด การลงชื่อเข้าใช้ และ URL ทั้งหมดด้านล่างอยู่ที่นั่น

เริ่มต้นอย่างรวดเร็ว

ขั้นตอนเดียวกับคู่มือ เริ่มต้นใช้งาน ในแดชบอร์ด:

# 1. install the CLI — also points it at the registry
curl -fsSL https://treg.to/install.sh | sh

# 2. sign in (GitHub default · --email for a one-time code · --token for agents/CI)
treg login

# 3. do something useful immediately — no key, nothing registered
treg catalog search "backlinks for a domain"     # find a tool by what it DOES
treg call tikhub.tiktok.user.profile --query uniqueId=tiktok
treg balance                                     # exactly what that cost

# (or `treg onboard` for the guided walkthrough)

Fish Audio ให้บริการเสียงพูด S2.1 Pro การค้นหาเสียงสาธารณะ และการโคลนเสียงส่วนตัว เสียงพูดเป็นข้อมูลไบนารีที่ส่งออกทาง stdout จึงควรเปลี่ยนเส้นทางไปยังไฟล์ _id ของเสียงที่ค้นพบ หรือ ID เสียงของทีม คือ reference_id สำหรับ TTS; เสียงที่สร้างด้วยบัญชี Fish ของ treg จะเป็นทรัพยากรของทีมที่ใช้งานได้ต่อเนื่อง:

treg call fishaudio.tts.s2-1-pro --method POST --header model=s2.1-pro \
  --data '{"text":"Hello from treg","format":"mp3"}' > speech.mp3
treg call fishaudio.voices.discover --query self=false --query licensed=false --query language=en
treg resources list --provider fishaudio --kind voice

เมื่อใช้คีย์ Fish ของคุณเอง คำขอจะยังคงเป็นการส่งต่อไปยังต้นทางแบบไม่จำกัดและไม่คิดค่าบริการ โดย Fish เป็นผู้ดูแลขอบเขตบัญชี

อินพุตของเครื่องมือในแค็ตตาล็อกอธิบายไว้ใน treg catalog get <id> เครื่องมือที่ระบุว่า strict_query จะปฏิเสธพารามิเตอร์ query ที่ไม่ได้ประกาศหรือซ้ำกัน ค่าที่ไม่รองรับ และเนื้อหาคำขอที่ไม่รองรับ ส่งพารามิเตอร์ที่ประกาศไว้ซึ่งรับค่าเดียวเพียงครั้งเดียว และส่งจำนวนแถว เช่น limit เป็นจำนวนเต็มที่ไม่เกินค่าสูงสุดที่ระบุ เครื่องมือที่บังคับใช้กฎนี้จะตอบกลับด้วย 400 catalog_parameter_invalid ซึ่งระบุชื่อพารามิเตอร์ และจะไม่มีการเรียกเก็บเงิน

โทเค็นของคุณใช้ระบุตัวตนในการเรียกทุกครั้ง (ส่วนหัว X-Treg-Token) และใช้ร่วมกันกับเครื่องมือทั้งหมด ดูสิ่งที่ทีมแชร์ไว้: treg tool ls · ตรวจสอบสถานะข้อมูลรับรอง: treg health

หรือติดตั้งเป็นปลั๊กอิน Claude Code

/plugin marketplace add superdesigndev/treg
/plugin install treg@treg

ติดตั้งทักษะ treg และเครื่องมือของ treg โดยไม่ต้องใช้โทเค็นหรือกำหนดค่าใด ๆ เรียกใช้ /mcp แล้วเลือก treg และลงชื่อเข้าใช้ เครื่องมือจะปรากฏขึ้นหลังจากนั้น สำหรับเอเจนต์อื่น: npx skills add superdesigndev/treg -s treg (หรือดู ทักษะเวิร์กโฟลว์ สำหรับรายการอื่น ๆ) ดู docs/CLAUDE-PLUGIN.md ผู้ใช้ MiniMax Code / MiniMax Agent: มีทักษะเดียวกัน ผ่าน MiniMax Plugin Marketplace (docs/MINIMAX-PLUGIN.md)

ทักษะเวิร์กโฟลว์

สูตรสำเร็จที่เอเจนต์ของคุณทำงานตั้งแต่ต้นจนจบ โดยทุกการเรียกผ่าน treg:

ทักษะสิ่งที่เอเจนต์ของคุณทำได้
tregค้นหาและเรียกใช้เครื่องมือใดก็ได้ในแค็ตตาล็อก รวมถึงเครื่องมือของคุณเอง
web-accessเมื่อเครื่องมือเว็บของเอเจนต์ทำงานได้ไม่ครบ ให้อ่านเว็บแบบเรียลไทม์โดยไม่ใช้ตัวดึงข้อมูลในเครื่อง: เริ่มจากการค้นหาและอ่านหน้าเว็บฟรี จากนั้นเลือกงานบนแพลตฟอร์มที่เหมาะกับโซเชียล ร้านค้า รีวิว แผนที่ และบทความวิชาการ โดย treg จะเปลี่ยนไปใช้ผู้ขายรายถัดไปหากรายหนึ่งล้มเหลว
lead-signalsค้นหาผู้ซื้อที่กำลังมองหาสินค้าจากสัญญาณสาธารณะ (ข้อร้องเรียน การเปลี่ยนงาน การจ้างงาน เงินทุน การนำเครื่องมือมาใช้) และติดตามหัวข้อ คู่แข่ง หรือรายชื่อบัญชีเพื่อค้นหาผู้ซื้อเหล่านั้น (treg.to/leads-signals)
recruitเปลี่ยนประกาศรับสมัครงานบน LinkedIn ให้เป็นรายชื่อผู้สมัครที่จัดอันดับแล้ว: กำหนดเกณฑ์จากประกาศ ค้นหาบุคคล กรองพร้อมเหตุผล อธิบายสั้น ๆ ว่าแต่ละคนเหมาะอย่างไร พร้อมหลักฐานอ้างอิง (โพสต์ GitHub การบรรยาย อายุงาน การเปลี่ยนงาน) ภายใต้งบต่อผู้สมัคร จากนั้นตรวจสอบอีเมลส่วนตัวและหมายเลขโทรศัพท์ พร้อมไฟล์ผลการทำงานที่ระบุจำนวน หลักฐาน และประวัติผู้ขายของผู้สมัครแต่ละคน
make-ugcสร้างวิดีโอ UGC ด้วย AI: ฮุกที่กำลังเป็นกระแส พรีเซนเตอร์ คลิปพูดหน้ากล้อง และคำบรรยาย (treg.to/ugc)
jev-memoryเพิ่มความจำให้ Claude Code: ม็อด Claude Code ที่ Jev ประเมินแต่ละพรอมป์ต์หลังจบเทิร์น และจดจำความชอบที่คงอยู่ของคุณ ติดตั้งแบบสำเร็จรูปหรือสร้างจากพรอมป์ต์เดียว (ม็อด)

install.sh ติดตั้งเฉพาะ treg และระบุชื่อรายการอื่น ๆ ไว้ในบรรทัดเดียว เอเจนต์ของคุณจะแนะนำรายการเหล่านั้นหลังลงชื่อเข้าใช้และเรียกใช้ครั้งแรก ระบุชื่อรายการที่ต้องการด้วย sh -s -- --skills lead-signals,recruit (หรือ --skills all; รายการที่เลือกเข้าร่วมได้อย่าง jev-memory และ rea-growth จะไม่อยู่ในชุดนั้น) ใน Claude Code แต่ละรายการยังเป็นปลั๊กอินแยกต่างหากในมาร์เก็ตเพลสของ treg ด้วย: /plugin install recruit@treg หรือเลือกจาก /plugin หากต้องการเพิ่มรายการเหล่านี้ลงในเอเจนต์ที่มีอยู่ (skills.sh CLI):

npx skills add superdesigndev/treg                        # every public skill
npx skills add superdesigndev/treg --skill lead-signals   # just one
treg skill bootstrap --skills all                         # the installer's set, with the treg CLI you already have

ทักษะเวิร์กโฟลว์ทำงานบน treg จึงต้องตั้งค่าก่อน (ทำตาม Quickstart ด้านบน หรือชี้เอเจนต์ไปที่ treg.to/llms.txt)

ตัวเชื่อมต่อ Claude.ai

ส่วนที่แสดงใน Claude Connectors Directory คือ https://treg.to/mcp/v2/ โดยเปิดให้ใช้เฉพาะ ปลายทางแค็ตตาล็อกที่คัดสรรแล้ว ไม่รวมการสร้างภาพ วิดีโอ หรือเสียง และแยกการเรียกอ่านออกจากการเรียกเขียน เพื่อให้ Claude ได้รับสัญญาณความปลอดภัยที่ถูกต้อง ส่วน /mcp/ ที่มีอยู่เดิมยังคงใช้ได้กับปลายทางแค็ตตาล็อก เครื่องมือที่ทีมเป็นเจ้าของ และทักษะที่นำเข้า ดู สถาปัตยกรรม MCP และ OAuth เพื่อทำความเข้าใจขอบเขตและการนำไปใช้ และดู คู่มือการส่งเผยแพร่ สำหรับเกณฑ์ก่อนเผยแพร่

เรียกใช้เครื่องมือที่คุณไม่มีคีย์

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

treg catalog                                    # every platform, busiest first
treg catalog search "find a work email"         # by the job, not the vendor
treg catalog search --new                       # tools added in the last 30 days, newest first
treg catalog get hunter.people.email.find       # params, PRICE, example response
treg call hunter.people.email.find --query domain=reddit.com --query full_name="Alexis Ohanian"

วิธีให้บริการการเรียกจากแค็ตตาล็อก — ลำดับการเลือกข้อมูลรับรอง:

  1. ทีมของคุณลงทะเบียนเครื่องมือของตนเองสำหรับผู้ให้บริการรายนั้น → ใช้เครื่องมือนั้นและคีย์นั้น
  2. ทีมของคุณจัดเก็บข้อมูลลับของผู้ให้บริการรายนั้นไว้ → แทรกผ่านเครื่องมือเสมือน
  3. ไม่มีทั้งสองอย่าง และปลายทางมีเส้นทางสาธารณะที่ผ่านการยืนยันแล้ว → ไม่ต้องใช้คีย์ผู้ให้บริการ ฟรี
  4. กรณีอื่น ๆ → ใช้ คีย์ของ treg เอง และเรียกเก็บจากยอดเงินเติมล่วงหน้าของทีม

ราคาสำหรับการเรียกแบบไม่ระบุตัวตนตั้งอยู่บนสมมติฐานว่าผู้เรียกไม่ได้ส่งส่วนหัวข้อมูลรับรองของผู้ให้บริการมา การส่งต่อแบบตรงตามต้นฉบับจะคงส่วนหัวของผู้เรียกไว้ ดังนั้นคีย์ผู้ให้บริการที่ผู้เรียกส่งมาจึงใช้เครดิตของคีย์นั้นได้ ข้อมูลรับรองของคุณเองมีสิทธิ์เหนือคีย์ของ treg เสมอ ดังนั้นการเชื่อมต่อคีย์ที่คุณจ่ายเงินอยู่แล้วจะทำให้การเรียกเหล่านั้นไม่ใช้ยอดเงิน แทนที่จะคิดซ้ำ ปลายทางที่ treg ไม่มีราคาประกาศไว้จะถูก ปฏิเสธ ไม่ใช่ให้ใช้ฟรี — ระบบจะแจ้งให้เชื่อมต่อคีย์ของคุณเอง หากมีผู้ให้บริการหลายรายรองรับความสามารถเดียวกัน treg catalog search จะแสดงราคาเทียบกัน คุณเป็นผู้เลือก — treg จะไม่เลือกหรือเปลี่ยนผู้ให้บริการให้โดยไม่แจ้งให้ทราบ (เมื่อบัญชีของ treg กับผู้ให้บริการรายหนึ่งใช้การไม่ได้ treg อาจให้บริการปลายทาง เดียวกัน ผ่านบัญชีรีเลย์ที่ treg เป็นเจ้าของ โดยแจ้งไว้ในคำตอบ และทีมสามารถเลือกไม่ใช้ได้) ข้อยกเว้นที่คุณเลือกใช้ได้คือปลายทางแบบกำหนดเส้นทาง treg.<capability> ซึ่ง treg จะเลือกผู้ให้บริการให้และระบุชื่อ สำหรับงานทั่วไป (ดึงข้อมูลหน้าเว็บ ค้นหาเว็บ ผลการค้นหา Google ค้นหาอีเมล) ให้เริ่มจากปลายทางแบบกำหนดเส้นทาง เช่น treg.web.extract หรือ treg.web.search แทนการเลือกผู้ให้บริการจากชื่อที่จำได้ สำหรับ treg.people.email.find และ treg.people.phone.find X-Treg-Route-Verify: true จะตรวจสอบที่อยู่หรือหมายเลขที่พบในการเรียกเดียวกันด้วย โดยคิดค่าบริการแยกต่างหาก และแจ้งผลการตรวจสอบ

treg balance          # credit left, calls in flight, recent spend
treg topup            # add funds, or set up automatic top-ups

เมื่อยอดเงินไม่พอ ระบบจะตอบกลับ HTTP 402 error: insufficient_balance พร้อม balance_micro, estimated_cost_micro และ topup_url เพื่อให้เอเจนต์ดำเนินการต่อได้โดยไม่ต้องอ่านข้อความอธิบาย

Enrich Arena อยู่ที่ /enrich-arena นอกแดชบอร์ด เปรียบเทียบคำตอบจากการเสริมข้อมูลพร้อมราคาและความเร็วของผู้ขายแต่ละราย โหวตคำตอบที่ดีที่สุดได้ในคลิกเดียว หรือดูการทำงานแบบเรียงลำดับ ผู้ให้บริการแบบ async ที่รองรับความสามารถเดียวกันก็เข้าร่วมได้ โดย Arena จัดการการส่งคำขอและการตรวจสอบสถานะให้ภายใน การเข้าชมดูได้แบบสาธารณะ แต่การส่งคำขอต้องลงชื่อเข้าใช้ และความพยายามที่มีค่าใช้จ่ายจะใช้เครดิตของทีม ดู คู่มือ Arena

Web Arena ใช้เปรียบเทียบผู้ให้บริการ Web Search, Web Fetch และ Sitemap ที่ /web-arena การต่อสู้จะเรียกผู้ให้บริการที่เลือกด้วยอินพุตเดียวกัน ส่วน Waterfall จะลองตามลำดับ กระดานผู้นำแบบเรียลไทม์รวมอัตราความสำเร็จและเวลาตอบสนองจากการเรียกผู้ให้บริการโดยตรง เข้ากับผลคุณภาพที่ตรวจสอบแล้วจาก Web Arena ในช่วง 30 วันย้อนหลัง หน้าเหล่านี้จะเปิดให้ใช้งานเมื่อเปิดใช้ฟีเจอร์ ดู คู่มือ Web Arena

แชร์และใช้เครื่องมือของคุณเอง

วิธีที่ไม่ต้องคิดมาก — ชี้ treg ไปที่โปรเจกต์ แล้วระบบจะค้นหาสิ่งที่แชร์ได้ให้เอง:

treg scan     # read-only preview: the keys, skills & CLIs upload would register
treg upload   # register them (encrypted server-side); idempotent, --replace to update

treg upload สแกน .env (จับคู่คีย์กับผู้ให้บริการที่รู้จักประมาณ 80 ราย) ทุกไดเรกทอรีย่อยของทักษะ และ CLI ของแค็ตตาล็อกที่ติดตั้งไว้ สิ่งที่ลงทะเบียนในรีจิสทรีมีสามประเภท — วิธีแชร์และใช้แต่ละประเภทมีดังนี้:

1. ปลายทาง (HTTP APIs)

แชร์ — URL ต้นทางหนึ่งรายการที่เรียกใช้ได้ด้วยคีย์ที่จัดเก็บไว้ หรือนำเข้าจำนวนมากจาก .env:

treg secret add STRIPE_KEY --value sk_live_123
treg add stripe --base-url https://api.stripe.com --secret STRIPE_KEY

treg upload env --select openai,stripe,resend     # or straight from the .env

ใช้ — วิธีที่เหมาะกับเอเจนต์: สร้างคำขอไปยังต้นทาง จริง แล้วเติมพร็อกซีไว้ข้างหน้า treg จะค้นหาเครื่องมือจากโฮสต์ แทรกข้อมูลรับรอง และส่งต่อส่วนอื่นทั้งหมดตามเดิม (X-Treg-Token ของคุณจะถูกตัดออกก่อนที่ต้นทางจะได้รับคำขอ):

Real request:   GET https://api.intercom.io/conversations?per_page=5
Through treg:   GET https://treg.to/call/https://api.intercom.io/conversations?per_page=5
                    header:  X-Treg-Token: <your token>

หรือใช้คำสั่งย่อของ CLI — และ treg calls สำหรับบันทึกการตรวจสอบ:

treg call intercom conversations --query per_page=5
treg call stripe v1/balance

2. CLI

แชร์ — ทำโดยอัตโนมัติ: treg upload ตรวจหา CLI ของแค็ตตาล็อกที่ติดตั้งไว้ (stripe, gh, vercel, …) แล้วลงทะเบียนให้ ทักษะ CLI ของแค็ตตาล็อกที่มีเฉพาะสูตร (เช่น stripe-cli) ก็จะพร้อมเรียกใช้โดยอัตโนมัติเช่นกัน

ใช้ — treg run เรียกใช้ CLI ของผู้ขาย โดยแทรกข้อมูลรับรองขององค์กร ให้ คุณจึงไม่ต้องถือคีย์หรือเข้าสู่ระบบเอง:

treg run stripe -- get /v1/balance
treg run gh -- pr list

--local (ค่าเริ่มต้น) ทำงานบนเครื่องของคุณ การเรียกใช้ CLI ฝั่งเซิร์ฟเวอร์ (--server) ถูกปิดใช้งานทั่วทั้งระบบ treg runs คือบันทึกการตรวจสอบ

3. ทักษะ

แชร์ — ทักษะคือความสามารถครบชุด (SKILL.md สูตร + ข้อมูลลับ + เครื่องมือของทักษะ) ที่ลงทะเบียนพร้อมกัน เพื่อให้ทั้งทีมใช้ทักษะเดียวกันและดูแลจากที่เดียว:

treg upload skills --dir ~/.claude/skills --all   # register a folder of skills in one pass

ใช้ — ดึงทักษะที่แชร์ไว้มาใช้กับเอเจนต์ของคุณได้ทุกทักษะ การเรียก API จะผ่าน treg ด้วยโทเค็นของคุณ คีย์จึงอยู่บนเซิร์ฟเวอร์ ไม่อยู่ในทักษะ:

treg skill install seo-blog-writer      # writes into ./.claude/skills/  (--all for the library)

ลงทะเบียนด้วยตนเอง — เมื่อระบบคาดเดาเครื่องมือไม่ถูก

# multi-credential tool (e.g. google-ads: OAuth bearer + a developer-token header)
treg tool add google-ads --base-url https://googleads.googleapis.com \
  --bind "secret=<oauth-id>,injector=oauth" \
  --bind "secret=<dev-id>,name=developer-token,format={secret}"

# one skill, step by step
treg skill init --dir ./my-skill          # drafts treg.json (guesses base_url, finds secrets)
treg skill add  --dir ./my-skill          # registers recipe + secrets + tool, atomically

# OAuth via the browser (mints the first token, treg holds it and auto-refreshes)
treg oauth connect gsc --client-secret client_secret.json \
  --scopes https://www.googleapis.com/auth/webmasters.readonly

ดูตัวเลือกทั้งหมดของทุกคำสั่งได้ที่ USAGE.md CLI และตัวติดตั้งจะส่งข้อมูลการใช้งานแบบไม่ระบุตัวตนไปยัง PostHog เมื่อใช้ treg.to (ไม่มีอาร์กิวเมนต์หรือข้อมูลรับรอง) ปิดใช้ได้ด้วย TREG_TELEMETRY=0 หรือ DO_NOT_TRACK=1. ดู รายละเอียดการวิเคราะห์.

ทีม

บัญชีหนึ่งสามารถเป็นเจ้าของทีมได้สูงสุด 10 ทีม การเข้าร่วมทีมอื่นในฐานะสมาชิกจะไม่นับรวมในขีดจำกัดนี้

ทุกอย่างอยู่ภายใต้ขอบเขตของ org: โทเค็น = การเป็นสมาชิก (user, org) และข้อมูลลับ เครื่องมือ และทักษะทุกอย่างจะเป็นของ org ที่ใช้งานอยู่ บทบาท: owner / admin / member / viewer.

treg org create "Acme"                        # make a team, become owner
treg org invite teammate@acme.com             # invite by email (pick role + tool access)
treg org join <code>                          # accept an invite (sign in as the invited email first)
treg org ls | use <slug> | members            # switch orgs, see the roster
treg org access <member> --tools a,b          # per-member tool access (admin+)

เจ้าของทีมสามารถเปิดใช้ SSO ระดับองค์กรได้จากแท็บ Team → SSO ในแดชบอร์ด WorkOS เชื่อมต่อกับ ผู้ให้บริการข้อมูลระบุตัวตนของบริษัท เจ้าของสามารถเชิญผู้ดูแลระบบ IT มาดำเนินการตั้งค่าให้เสร็จได้ พนักงานสามารถกรอกอีเมลงานในกล่องโต้ตอบลงชื่อเข้าใช้ใดก็ได้ หรือใช้ลิงก์ลงชื่อเข้าใช้โดยตรงของทีม treg จะคงบทบาททีมและคีย์ API ไว้ แผน Directory Sync จะนำสิทธิ์เข้าถึงทีมของพนักงานที่ถูกปิดใช้งานออก ดู การตั้งค่า SSO ระดับองค์กร.

เจาะลึกเพิ่มเติม

  • ข้อเสนอแนะ: treg feedback submit friction "The pagination example is unclear." แจ้งปัญหาหรือข้อเสนอแนะโดยไม่ใส่ข้อมูลส่วนตัว ดู คำแนะนำในการส่งข้อเสนอแนะ.

  • รีวิว: treg review CALL_ID useful ให้คะแนนการเรียกใช้แค็ตตาล็อกที่ได้รับเชิญหลังจากใช้ผลลัพธ์แล้ว not_sure ก็ใช้ได้ อย่าใส่ข้อมูลส่วนตัวและทำงานต่อไป

  • USAGE.md — เอกสารอ้างอิง CLI ฉบับเต็มของ treg.

  • /llms.txt: จุดเริ่มต้นสำหรับเอเจนต์ ในรูปแบบ llms.txt อธิบายว่า treg คืออะไร วิธีตั้งค่าสำหรับเอเจนต์แต่ละประเภท วงจรค้นหา-อ่าน-เรียกใช้ และกฎต่าง ๆ พร้อม ลิงก์ไปยัง /skill.md ซึ่งเป็นคู่มือการใช้งานสำหรับเรื่องอื่น ๆ

  • แดชบอร์ด ที่ treg.to — CRUD ครบถ้วน บทแนะนำแบบมีขั้นตอน (Help → Tutorial) และคำแนะนำการตั้งค่าที่คัดลอกไปใช้กับเอเจนต์ได้

  • API — ทุกอย่างที่ CLI ทำเป็น HTTP ธรรมดา เอกสาร OpenAPI แบบโต้ตอบอยู่ที่ /docs. ปลายทางพร็อกซีคือ /call/{...}; ทุกปลายทางต้องใช้ส่วนหัว X-Treg-Token.


ส่วนที่ 2 · โฮสต์เองและการพัฒนา

เรียกใช้ในเครื่อง

คำสั่งเดียว (ต้องมี tmux + uv; คำสั่งนี้จะซิงก์ venv เอง):

scripts/dev-local.sh up        # server on http://localhost:18790, dev-safe settings

คำสั่งนี้จะเรียกใช้เซิร์ฟเวอร์ใน tmux พร้อม hot-reload, ฐานข้อมูล sqlite ของตัวเอง (treg-dev.db) และโหมดพัฒนาอีเมล OTP (รหัสลงชื่อเข้าใช้จะแสดงบนหน้าเว็บ — ไม่ต้องใช้ตัวส่งอีเมล) การใช้งานประจำวัน:

scripts/dev-local.sh cli login   # sandboxed CLI: never touches your real ~/.treg/config.json
scripts/dev-local.sh logs        # server output          · status / restart / down
scripts/dev-local.sh reset       # wipe the dev DB + CLI sandbox for a fresh start

หรือเรียกใช้เซิร์ฟเวอร์โดยตรงโดยไม่ใช้ tmux:

bash scripts/build-dashboard.sh # Node 22.12+ and npm; build the Dashboard
uv sync                        # create the venv from uv.lock (pulls the server deps for dev)
uv run python -m treg upgrade  # prepare schema + run idempotent release tasks without serving
uv run python -m treg          # serve on 0.0.0.0:18790 (add --reload for dev)
uv run python -m treg keygen   # print a fresh Fernet key for TREG_SECRET_KEY

ติดตั้งเพื่อเรียกใช้เซิร์ฟเวอร์ (ไม่ใช่จากซอร์ส): แพ็กเกจพื้นฐานมีเฉพาะ CLI หากต้องการเรียกใช้ registry ให้ติดตั้งส่วนเสริมของเซิร์ฟเวอร์ — pip install "tools-registry[server]" — ซึ่งเพิ่ม FastAPI ไดรเวอร์ฐานข้อมูล และการเข้ารหัส ส่วน pip install tools-registry เพียงอย่างเดียวจะมีแค่คำสั่ง treg สำหรับ ติดต่อกับ registry ที่มีอยู่

บริการโฮสต์อย่างเป็นทางการพร้อมใช้งานที่ treg.to โครงสร้างระบบจริงและการตั้งค่าที่ใช้งานอยู่ ดูแลไว้ใน คู่มือปฏิบัติการสำหรับผู้ดูแลระบบ แบบส่วนตัว

การกำหนดค่า

ตัวแปรสภาพแวดล้อม (คำนำหน้า TREG_, อ่านจาก .env):

VarDefaultPurpose
TREG_DATABASE_URLsqlite+aiosqlite:///./treg.dbURL ของ DB (SQLite สำหรับการพัฒนา, Postgres สำหรับระบบจริง)
TREG_READ_DATABASE_URL(empty)แหล่งข้อมูลสำหรับอ่าน SQLite / PostgreSQL ที่ไม่บังคับ; หากว่างจะใช้แหล่งข้อมูลหลัก ผู้เรียกต้องเลือกใช้เอง; คิวรีที่มีอยู่จะไม่เปลี่ยนแปลง ดู การตั้งค่าแหล่งข้อมูลสำหรับอ่าน.
TREG_SECRET_KEY(empty)คีย์ Fernet สำหรับข้อมูลลับที่จัดเก็บไว้; หากว่างจะสร้างคีย์ชั่วคราว (ข้อมูลลับจะไม่คงอยู่หลังรีสตาร์ต)
TREG_PUBLIC_URLhttps://treg.toURL ฐานสาธารณะของ treg ใช้สร้าง URI สำหรับเรียกกลับ OAuth
TREG_SESSION_SECRET(empty)ใช้ลงนามคุกกี้เซสชันของแดชบอร์ด; หากไม่มีจะใช้ TREG_SECRET_KEY ตั้งค่าเป็นค่าจริงในระบบจริง
TREG_GITHUB_CLIENT_ID / _SECRET(empty)การลงชื่อเข้าใช้ด้วย GitHub OAuth (เรียกกลับที่ <public_url>/auth/github/callback); หากว่าง ปุ่มจะถูกซ่อน
TREG_GOOGLE_CLIENT_ID / _SECRET(empty)การลงชื่อเข้าใช้ด้วย Google OAuth (เปลี่ยนเส้นทางไปที่ <public_url>/auth/google/callback); หากว่าง ปุ่มจะถูกซ่อน
TREG_WORKOS_API_KEY / _CLIENT_ID / _WEBHOOK_SECRET(empty)SSO ระดับองค์กรของ WorkOS; กำหนดค่าการเรียกกลับและ webhook ไดเรกทอรีที่ลงนามแล้วตามที่อธิบายไว้ใน การตั้งค่า SSO ระดับองค์กร
TREG_ENTERPRISE_SSO_BUNDLE_ONLYtrueแสดงเฉพาะแผน SSO + Directory Sync เป็นค่าเริ่มต้น; ตั้งเป็น false เพื่อเสนอแผนรายเดือนทั้งสองแบบ
TREG_ENTERPRISE_SSO_BUNDLE_PRICE_ID / TREG_ENTERPRISE_SSO_ONLY_PRICE_ID(empty)Stripe Price ID รายเดือนที่นำกลับมาใช้ซ้ำได้ในบัญชีเดียวกับ TREG_STRIPE_SECRET_KEY; หากไม่ได้ตั้งค่า Price หรือใช้ไม่ได้ แผนนั้นจะถูกซ่อน Price ของ Stripe เป็นตัวกำหนดจำนวนเงินที่แสดงและยอดเรียกเก็บผ่าน Checkout
TREG_ENTERPRISE_SSO_BUNDLE_MIN_PRICE_USD / TREG_ENTERPRISE_SSO_ONLY_MIN_PRICE_USD0จำนวนเงินขั้นต่ำเต็มดอลลาร์ที่ไม่บังคับสำหรับ Stripe Price รายเดือนแต่ละรายการ; Price ที่ต่ำกว่านี้จะถูกซ่อนและปฏิเสธที่ Checkout
TREG_INSTAGRAM_CLIENT_ID / _SECRET(empty)Instagram App ID และ secret สำหรับ Instagram Login โดยตรง (เปลี่ยนเส้นทางไปที่ <public_url>/oauth/callback)
TREG_META_CLIENT_ID / _SECRET(empty)ข้อมูลรับรองแอป Meta สำหรับ Facebook Pages, Meta Ads และ Instagram page-tools ที่ไม่บังคับ
TREG_OAUTH_REVIEW_PENDINGinstagram-login,page-messagesคีย์รีวิว registry ที่คั่นด้วยจุลภาค ซึ่งความสามารถต้องยังถูกจำกัดไว้; สถานะรีวิวของบริการโฮสต์จะดูแลเป็นการส่วนตัว
TREG_RESEND_API_KEY / TREG_EMAIL_FROM(empty)อีเมลธุรกรรมผ่าน Resend (รหัส OTP + คำเชิญ); ผู้ส่งต้องเป็นผู้ส่งที่ Resend ยืนยันแล้ว
TREG_BLOCKED_EMAIL_DOMAINS(empty)โดเมนอีเมลที่คั่นด้วยจุลภาคซึ่งจะถูกปฏิเสธในทุกช่องทางลงทะเบียน/ลงชื่อเข้าใช้และตอนสร้างทีม (รวมโดเมนย่อย ไม่แยกตัวพิมพ์เล็กใหญ่) หากว่างจะไม่บล็อกอะไร — ไม่มีรายการใดรวมอยู่ในโค้ด
TREG_CLIENT_IP_HEADER(empty)ส่วนหัวที่มีเพียง edge ของคุณเท่านั้นที่ตั้งค่าได้ ใช้เป็นที่อยู่ไคลเอ็นต์สำหรับขีดจำกัดต่อ IP ทุกประเภท (cf-connecting-ip หลัง Cloudflare)
TREG_TRUSTED_PROXY_HOPS1หากไม่มีส่วนหัวดังกล่าว: ใช้รายการ X-Forwarded-For ที่อยู่ห่างจากด้านขวาตามจำนวนฮอปนี้ (รายการที่พร็อกซีใกล้ที่สุดของคุณเพิ่มเข้ามา); ใช้ 0 เมื่อไคลเอ็นต์เชื่อมต่อโดยตรง รายการแรกมาจากไคลเอ็นต์และจะไม่เชื่อถือ
TREG_RATE_LIMIT_EXEMPT_IPS(empty)ที่อยู่หรือบล็อก CIDR ที่คั่นด้วยจุลภาคซึ่งได้รับการยกเว้นจากขีดจำกัดต่อ IP ทุกประเภท (เช่น การทดสอบความปลอดภัยที่ได้รับอนุญาต หรือโพรบตรวจสอบระบบ); ขีดจำกัดต่ออีเมล ต่อผู้ใช้ และทั่วทั้งการติดตั้งยังคงมีผล หากมีรายการผิดรูปแบบ ระบบจะปฏิเสธการเริ่มทำงาน
TREG_REQUIRED_EXTENSIONS(empty)ส่วนขยายของนโยบายที่คั่นด้วยจุลภาค (treg.extensions entry points) ซึ่งต้องติดตั้ง มิฉะนั้นการเริ่มทำงานจะล้มเหลว treg.to ใช้ส่วนขยาย abuse-policy แบบส่วนตัวด้วยวิธีนี้; ส่วนขยายทำได้เพียงจำกัดการใช้งาน (ส่วนขยายของนโยบาย)
TREG_TURNSTILE_SITE_KEY / _SECRET(empty)Cloudflare Turnstile ในแบบฟอร์มลงชื่อเข้าใช้ด้วยอีเมลทุกแบบ และในการลงชื่อเข้าใช้ GitHub/Google ครั้งแรกของที่อยู่ใหม่; หากค่าใดค่าว่าง = ปิด คีย์ไซต์จะแสดงใน /captcha.js ส่วน secret จะส่งไปยัง siteverify เท่านั้น
TREG_TURNSTILE_MODEobserveobserve จะบันทึกผลลัพธ์แต่ไม่เปลี่ยนแปลงอะไร; enforce จะปฏิเสธการส่งรหัสให้โทเค็นที่ไม่มีหรือไม่ถูกต้อง ไม่ให้สิทธิ์ลงทะเบียนเมื่อ Cloudflare ไม่ตอบกลับ และให้สิทธิ์ลงทะเบียนแก่ผู้ใช้ GitHub/Google รายใหม่เฉพาะเมื่อผ่านการตรวจสอบ
TREG_TURNSTILE_SOCIALtruefalse ข้ามการตรวจสอบเมื่อที่อยู่ใหม่ลงชื่อเข้าใช้ GitHub/Google เป็นครั้งแรก ซึ่งจะได้รับสิทธิ์ลงทะเบียนเช่นเดียวกับกรณีไม่มีวิดเจ็ต; ช่องทางอีเมลยังคงเหมือนเดิม
TREG_TURNSTILE_HOSTNAMES(empty)โฮสต์ที่ต้องแก้โจทย์โทเค็น โดยคั่นด้วยจุลภาค; หากว่าง = โฮสต์ TREG_PUBLIC_URL (และชื่อแทนที่รู้จัก)
TREG_ADMIN_TOKEN(empty)bearer super-admin ข้าม tenant; อนุญาตให้เข้าถึงทุกปลายทาง /admin/* หากว่างจะปิดใช้เส้นทาง env (มีเพียงผู้ใช้ is_superadmin เท่านั้นที่เข้าถึง /admin ได้) ตั้งให้ยาวและเป็นความลับ
TREG_EMAIL_DEV_MODEfalseเมื่อเป็น true, /auth/email/start จะส่ง OTP กลับมาในคำตอบ (ไม่ต้องใช้ตัวส่งอีเมล) — ใช้เฉพาะ dev/local เท่านั้น ห้ามใช้ในระบบจริง
TREG_KV_URL(empty)ที่เก็บ key-value ที่ใช้ร่วมกัน (โปรโตคอล Redis) สำหรับตัวนับที่ทุก worker ต้องเห็นตรงกัน ปัจจุบันใช้กับงบประมาณคำเชิญรีวิวต่อทีม หากว่างจะใช้ทางเลือกสำรองในโปรเซส ซึ่งเหมาะกับ worker เดียว

ไม่จำเป็นต้องมี .env สำหรับการพัฒนาในเครื่อง — ทุกการตั้งค่ามีค่าเริ่มต้นที่ใช้งานได้ (คีย์ชั่วคราว, sqlite)

⚠️ สำรองข้อมูลเหล่านี้ก่อนย้ายหรือปรับใช้ใหม่: คีย์ Fernet (TREG_SECRET_KEY) และ ฐานข้อมูล (Postgres ในระบบจริง; treg.db สำหรับการเรียกใช้ sqlite ในเครื่อง) หากทำคีย์ Fernet หาย ข้อมูลลับที่จัดเก็บไว้ทั้งหมดจะกู้คืนไม่ได้

สถาปัตยกรรม

ลำดับการทำงานของคำขอสำหรับ /call: ค้นหาเครื่องมือ (จากโฮสต์ URL + คำนำหน้า base_url ที่ยาวที่สุด หรือจากชื่อ) → ถอดรหัสข้อมูลลับของเครื่องมือ → ใช้ injector ของแต่ละ binding → ส่งต่อไปยัง upstream แบบสตรีม → บันทึก audit แบบไม่รอผล infra relay ส่งต่อไบต์แบบสตรีมโดยไม่มีตรรกะทางธุรกิจ แอปพลิเคชันการเรียกใช้จะบัฟเฟอร์คำตอบที่ต้องใช้ข้อมูลการชำระยอดหรือหลักฐานความเป็นเจ้าของ โดยจำกัดที่ 8 MiB; คำตอบที่ใหญ่กว่านั้นจะส่งกลับ 502 โดยไม่เรียกเก็บเงิน แทนที่จะส่งผลลัพธ์ที่ถูกตัดทอน ปลายทางที่แทรกสื่อไว้ในคำตอบ (รูปภาพ Gemini) จะประกาศ spooled_response: ระบบจะอ่านคำตอบที่คิดค่าบริการลงในไฟล์ชั่วคราวแทน ชำระยอดจากข้อมูลการใช้งานที่รายงาน และส่งต่อคำตอบทั้งหมด การดาวน์โหลดฟรีขั้นสุดท้ายที่ได้รับอนุญาตและไม่ต้องใช้หลักฐานจากเนื้อหาจะสตรีมทั้งหมด เช่นเดียวกับคำตอบที่ใช้คีย์ของตนเองและเครื่องมือของตนเอง

แผนผังโมดูล (src/treg/):

โมดูลบทบาท
proxy.pyrelay() — ผลิตภัณฑ์ทั้งหมดในฟังก์ชันเดียว: พร็อกซีสตรีมมิงที่ทำงานได้ตรงตามต้นฉบับ
injectors.pyจุดเชื่อมต่อรูปแบบการยืนยันตัวตน: env, cli_auth, secret_file, oauth ใส่ secret ลงใน header/query
oauth.pyความใหม่ของโทเค็น (การรีเฟรชแบบ single-flight) + ขั้นตอนการเชื่อมต่อ (URL ขอความยินยอม, แลกเปลี่ยนโค้ด)
health.pyสถานะข้อมูลรับรอง: รีเฟรช oauth, ตรวจสอบ tools, ส่ง webhook แจ้งเจ้าของเมื่อมีสิ่งใดขัดข้อง
convert.pyสร้างโครงไดเรกทอรี skill ให้เป็น manifest bundle ที่ลงทะเบียนได้
api.pyAPI — สมองเพียงหนึ่งเดียว; CLI + skill เป็นไคลเอนต์แบบบางที่ทำงานผ่าน API
cli.pyCLI ของ treg
models.pyตาราง SQLModel: Org, User, Membership, Invite, Secret, Tool, Bundle, PendingOAuth, CallRecord
crypto.py config.py db.py audit.pyการเข้ารหัส Fernet + โทเค็น · การตั้งค่า · DB แบบ async · ตัวเขียน audit แบบเลื่อนเวลา

รูปแบบการยืนยันตัวตน 4 แบบ (ต่อ binding injector): env (สตริงธรรมดา / API key) · secret_file (ไฟล์โทเค็น JSON, ดึงค่าจากฟิลด์หนึ่ง) · oauth (โทเค็น OAuth แบบ JSON ซึ่งรีเฟรชอัตโนมัติหากรีเฟรชได้) · cli_auth (ข้อมูลที่ดึงมาจาก keychain ของ CLI)

สัญญา faithful-relay: พร็อกซีเปลี่ยนแปลง เพียง สามสิ่งเท่านั้น ส่วนอื่นคงเดิมทุกประการ:

  1. header การขนส่งแบบ hop-by-hop (สร้างใหม่ในแต่ละ hop),
  2. header ควบคุมและส่งต่อไปยัง edge ของ treg เอง (x-treg-token, x-treg-org, ngrok-skip-browser-warning, x-forwarded-*, via, …) และ session cookie ของ treg — ลบออกทั้งหมด และไม่ส่งต่อไปยัง upstream,
  3. ข้อมูลรับรองที่แทรกเข้าไป

OAuth มีสามวิธีในการรับโทเค็นแรก: อัปโหลดด้วยตนเอง (วาง token.json ไว้) · รีเฟรชอัตโนมัติ (หากโทเค็นมี refresh_token + ข้อมูลรับรองไคลเอนต์ treg จะคอยรักษาความใหม่ให้ คุณไม่ต้อง อัปโหลดซ้ำ) · ขั้นตอนการเชื่อมต่อแบบโฮสต์ (treg oauth connect → ขอความยินยอมผ่านเบราว์เซอร์ → treg บันทึก โทเค็นด้วยตัวเอง)

การตรวจสอบสถานะ: กำหนด probe ให้ tool ได้โดยไม่บังคับ ({method, path, expect_status}); การทำงานเป็นระยะ (สั่งเองหรือผ่าน cron) จะตรวจสอบข้อมูลรับรองทุกชุด รีเฟรช OAuth และส่ง webhook แจ้งเจ้าของเมื่อมีรายการใด ขัดข้อง

รายละเอียดการออกแบบอยู่ใน docs/context/ (ส่วนย่อยแยกตามระบบย่อย)

การทดสอบ

uv run --with pytest-xdist pytest -n auto -q   # daily local default (same shape as CI)
uv run --frozen python -m pytest -q            # serial: debugging one test, or order

ความครอบคลุม: โครงกระดูกการทำงานของพร็อกซี, รูปแบบ injector ทั้งหมด, การยืนยันตัวตนต่อผู้ใช้ + CRUD + audit, ตัวประกอบ skill, URL-passthrough + faithful relay, การรีเฟรช OAuth + ขั้นตอนการเชื่อมต่อ, การตรวจสอบสถานะ, treg run/shell, การอัปโหลด/สแกน, องค์กร + คำเชิญ, API ของแดชบอร์ด, CLI

การมีส่วนร่วมและเอกสาร

treg/
├── src/treg/            # the package (api, cli, proxy, injectors, oauth, health, convert, models, …)
│   └── web/             # dashboard, landing, tutorial, llms.txt, skill.md, install.sh
├── tests/               # pytest suite (CI + local default: pytest-xdist -n auto)
├── docs/
│   └── context/         # design fragments (codemap system) + generated index
├── USAGE.md             # full treg CLI reference
└── pyproject.toml

เอกสารการออกแบบแยกตามระบบย่อยเป็น ส่วนย่อย ใน docs/context/ โดยแต่ละส่วนอ้างอิง แหล่งข้อมูล src/treg/* ของตน กำลังทำงานใน repo นี้ร่วมกับ AI agent อยู่หรือไม่? skill /tools-registry-context จะโหลด ส่วนย่อยที่เหมาะกับสิ่งที่คุณกำลังแก้ไขและช่วยให้เอกสารสอดคล้องกัน — เรียกใช้ /tools-registry-context sync ก่อน push

แผนงาน: รองรับ MCP · ระดับสิทธิ์ที่ละเอียดขึ้น · เสริมความแข็งแกร่งในการจัดการคีย์ขณะจัดเก็บ · อาจรวม Loopni

ใบอนุญาต

Apache 2.0 พร้อมข้อกำหนดเพิ่มเติม (LICENSE): ใช้งานได้อย่างอิสระ — รวมถึงเชิงพาณิชย์ และภายในองค์กรของคุณเอง (สนับสนุนให้โฮสต์ registry ของคุณเอง) ข้อจำกัดคือ ห้าม แจกจ่ายโค้ดต่อให้บุคคลภายนอกในรูปแบบบริการ registry แบบโฮสต์/จัดการที่แข่งขันกันโดยไม่ได้รับ อนุญาตเป็นลายลักษณ์อักษร (jason@superdesign.dev) การใช้ API ของ treg.to ที่โฮสต์ไว้ ภายในผลิตภัณฑ์ของคุณเอง — โดยเรียกเก็บเงินแบบ pass-through ผ่าน X-Treg-Meta และ usage/by-tag — ทำได้โดยไม่ต้องขออนุญาต; นั่นคือการเรียกใช้ API ของเรา ไม่ใช่การแจกจ่ายซอฟต์แวร์ของเรา

ขอบเขตการอ่านของลูกค้าที่ปักหมุดไว้

สำหรับ agent ของลูกค้าที่ถูกจำกัด treg org agent-new bot --pin customer=cust_A จะบังคับใช้การระบุแหล่งที่มา และจำกัดประวัติการเรียกใช้/รัน ผลลัพธ์ที่เก็บถาวร และการเป็นเจ้าของงาน async ของผู้ให้บริการที่แชร์ร่วมกันให้เป็นไปตาม pin นั้น id ที่เป็นของผู้อื่นหรือไม่มีการระบุแหล่งที่มาจะส่งกลับ 404; operator ที่ไม่ได้ปักหมุดยังคงเห็นข้อมูลทั่วทั้ง org และยอดคงเหลือที่แชร์ร่วมกัน การเข้าถึงบัญชี BYOK และ URL สื่อสาธารณะยังคงใช้สิทธิ์เดิม ดู สัญญาการรองรับหลายผู้เช่า สำหรับหลาย pin การย้ายข้อมูล และลักษณะการทำงานของ replay