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 สำหรับเครื่องมือเอเจนต์)

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"
วิธีให้บริการการเรียกจากแค็ตตาล็อก — ลำดับการเลือกข้อมูลรับรอง:
- ทีมของคุณลงทะเบียนเครื่องมือของตนเองสำหรับผู้ให้บริการรายนั้น → ใช้เครื่องมือนั้นและคีย์นั้น
- ทีมของคุณจัดเก็บข้อมูลลับของผู้ให้บริการรายนั้นไว้ → แทรกผ่านเครื่องมือเสมือน
- ไม่มีทั้งสองอย่าง และปลายทางมีเส้นทางสาธารณะที่ผ่านการยืนยันแล้ว → ไม่ต้องใช้คีย์ผู้ให้บริการ ฟรี
- กรณีอื่น ๆ → ใช้ คีย์ของ 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):
| Var | Default | Purpose |
|---|---|---|
TREG_DATABASE_URL | sqlite+aiosqlite:///./treg.db | URL ของ DB (SQLite สำหรับการพัฒนา, Postgres สำหรับระบบจริง) |
TREG_READ_DATABASE_URL | (empty) | แหล่งข้อมูลสำหรับอ่าน SQLite / PostgreSQL ที่ไม่บังคับ; หากว่างจะใช้แหล่งข้อมูลหลัก ผู้เรียกต้องเลือกใช้เอง; คิวรีที่มีอยู่จะไม่เปลี่ยนแปลง ดู การตั้งค่าแหล่งข้อมูลสำหรับอ่าน. |
TREG_SECRET_KEY | (empty) | คีย์ Fernet สำหรับข้อมูลลับที่จัดเก็บไว้; หากว่างจะสร้างคีย์ชั่วคราว (ข้อมูลลับจะไม่คงอยู่หลังรีสตาร์ต) |
TREG_PUBLIC_URL | https://treg.to | URL ฐานสาธารณะของ 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_ONLY | true | แสดงเฉพาะแผน 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_USD | 0 | จำนวนเงินขั้นต่ำเต็มดอลลาร์ที่ไม่บังคับสำหรับ 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_PENDING | instagram-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_HOPS | 1 | หากไม่มีส่วนหัวดังกล่าว: ใช้รายการ 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_MODE | observe | observe จะบันทึกผลลัพธ์แต่ไม่เปลี่ยนแปลงอะไร; enforce จะปฏิเสธการส่งรหัสให้โทเค็นที่ไม่มีหรือไม่ถูกต้อง ไม่ให้สิทธิ์ลงทะเบียนเมื่อ Cloudflare ไม่ตอบกลับ และให้สิทธิ์ลงทะเบียนแก่ผู้ใช้ GitHub/Google รายใหม่เฉพาะเมื่อผ่านการตรวจสอบ |
TREG_TURNSTILE_SOCIAL | true | false ข้ามการตรวจสอบเมื่อที่อยู่ใหม่ลงชื่อเข้าใช้ 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_MODE | false | เมื่อเป็น 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.py | relay() — ผลิตภัณฑ์ทั้งหมดในฟังก์ชันเดียว: พร็อกซีสตรีมมิงที่ทำงานได้ตรงตามต้นฉบับ |
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.py | API — สมองเพียงหนึ่งเดียว; CLI + skill เป็นไคลเอนต์แบบบางที่ทำงานผ่าน API |
cli.py | CLI ของ 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: พร็อกซีเปลี่ยนแปลง เพียง สามสิ่งเท่านั้น ส่วนอื่นคงเดิมทุกประการ:
- header การขนส่งแบบ hop-by-hop (สร้างใหม่ในแต่ละ hop),
- header ควบคุมและส่งต่อไปยัง edge ของ treg เอง (
x-treg-token,x-treg-org,ngrok-skip-browser-warning,x-forwarded-*,via, …) และ session cookie ของ treg — ลบออกทั้งหมด และไม่ส่งต่อไปยัง upstream, - ข้อมูลรับรองที่แทรกเข้าไป
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