นโยบาย
นโยบายควบคุมว่า OpenCode สามารถดำเนินการกับทรัพยากรที่ระบุชื่อได้หรือไม่ ฟีเจอร์นี้ของ OpenCode 2 ยังอยู่ในขั้นทดลอง และกำหนดค่าผ่านอาร์เรย์ experimental.policies ใน opencode.json
นโยบายแยกจาก สิทธิ์ สิทธิ์ควบคุมว่าเครื่องมือทำอะไรได้บ้างระหว่างเซสชัน ส่วนนโยบายควบคุมว่า OpenCode สามารถใช้ทรัพยากร เช่น ผู้ให้บริการ LLM ได้หรือไม่
คำสั่งนโยบายแต่ละรายการมีสามฟิลด์:
effect- เป็น"allow"หรือ"deny"action- การดำเนินการที่ถูกควบคุมresource- ID ของทรัพยากรหรือรูปแบบไวด์การ์ดที่คำสั่งนี้มีผล
ตัวอย่างเช่น ปฏิเสธการใช้ผู้ให้บริการ openai:
{
"$schema": "https://opencode.ai/config.json",
"experimental": {
"policies": [
{
"effect": "deny",
"action": "provider.use",
"resource": "openai"
}
]
}
}ผู้ให้บริการที่ถูกปฏิเสธโดยนโยบายจะไม่สามารถใช้เลือกโมเดลหรือใช้งานโมเดลได้ แม้จะมีข้อมูลประจำตัวหรือกำหนดค่าอื่นๆ ไว้อย่างถูกต้องแล้วก็ตาม
ปัจจุบัน OpenCode รองรับการดำเนินการของนโยบายหนึ่งรายการ:
| การดำเนินการ | ทรัพยากร | คำอธิบาย |
|---|---|---|
provider.use | ID ผู้ให้บริการ เช่น openai | อนุญาตหรือปฏิเสธการใช้ผู้ให้บริการ LLM |
อาจมีการเพิ่มการดำเนินการของนโยบายอื่นๆ ในอนาคต
ฟิลด์ resource รองรับการจับคู่ไวด์การ์ด ใช้ * เพื่อจับคู่อักขระตั้งแต่ศูนย์ตัวขึ้นไป และใช้ ? เพื่อจับคู่อักขระหนึ่งตัว
{
"$schema": "https://opencode.ai/config.json",
"experimental": {
"policies": [
{
"effect": "deny",
"action": "provider.use",
"resource": "company-*"
}
]
}
}ตัวอย่างนี้ปฏิเสธผู้ให้บริการอย่าง company-us และ company-eu
เมื่อมีหลายคำสั่งที่ตรงกัน คำสั่งสุดท้ายที่ตรงกันจะมีผล ให้ใส่กฎแบบกว้างไว้ก่อน แล้วจึงใส่ข้อยกเว้นที่เฉพาะเจาะจงกว่าไว้หลังจากนั้น
ตัวอย่างเช่น อนุญาตเฉพาะ Anthropic:
{
"$schema": "https://opencode.ai/config.json",
"experimental": {
"policies": [
{
"effect": "deny",
"action": "provider.use",
"resource": "*"
},
{
"effect": "allow",
"action": "provider.use",
"resource": "anthropic"
}
]
}
}หากไม่มีนโยบายใดตรงกับผู้ให้บริการ ค่าเริ่มต้นคืออนุญาตให้ใช้ผู้ให้บริการนั้น
คุณสามารถตั้งนโยบายได้ทั้งในการกำหนดค่าส่วนกลางและการกำหนดค่าโครงการ หากนโยบายจากทั้งสองแห่งตรงกับผู้ให้บริการเดียวกัน นโยบายส่วนกลางของคุณจะมีลำดับความสำคัญเหนือนโยบายของโครงการ วิธีนี้ป้องกันไม่ให้ที่เก็บโค้ดเปิดใช้ผู้ให้บริการที่คุณปฏิเสธไว้ในระดับส่วนกลางขึ้นมาใหม่
ใน OpenCode 2 ให้ใช้นโยบายแทนการตั้งค่า disabled_providers และ enabled_providers แบบเดิมเมื่อควบคุมการเข้าถึงผู้ให้บริการ ใน OpenCode 1 ให้ใช้รายการผู้ให้บริการเหล่านั้นต่อไป
เพื่อแทนที่ disabled_providers:
{
"experimental": {
"policies": [
{ "effect": "deny", "action": "provider.use", "resource": "openai" },
{ "effect": "deny", "action": "provider.use", "resource": "google" }
]
}
}เพื่อแทนที่ enabled_providers ให้ปฏิเสธผู้ให้บริการทั้งหมดก่อน แล้วจึงอนุญาตผู้ให้บริการที่เลือกไว้หลังจากนั้น:
{
"experimental": {
"policies": [
{ "effect": "deny", "action": "provider.use", "resource": "*" },
{ "effect": "allow", "action": "provider.use", "resource": "anthropic" },
{ "effect": "allow", "action": "provider.use", "resource": "openai" }
]
}
}