2026-02-10 01:34:35 +08:00
---
title: Eklentiler
2026-02-10 08:11:44 +08:00
description: opencode'u genişletmek için kendi eklentilerinizi yazı
2026-02-10 01:34:35 +08:00
---
2026-02-10 08:11:44 +08:00
Eklentiler, çeşitli olaylara bağlanarak ve davranı ı ı ı ı ı ı
2026-02-10 01:34:35 +08:00
Örnekler için topluluk tarafı ı
---
## Bir eklenti kullanı
There are two ways to load plugins.
---
### Yerel dosyalardan
JavaScript veya TypeScript dosyaları ı
- `.opencode/plugins/` - Proje düzeyinde eklentiler
- `~/.config/opencode/plugins/` - Genel eklentiler
Bu dizinlerdeki dosyalar başlangı
---
### npm'den
Yapı ı ı
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-helicone-session", "opencode-wakatime", "@my-org/custom-plugin"]
}
```
Hem normal hem de kapsamlı
[ecosystem](/docs/ecosystem#plugins)'daki mevcut eklentilere göz atı
---
### Eklentiler nası
**npm eklentileri** başlangı ı ı ı ı ı ı ı
**Yerel eklentiler** doğrudan eklenti dizininden yüklenir. Harici paketleri kullanmak için, sisteminizin dizininde bir `package.json` oluşturmanı ı ı
---
### Load order
Eklentiler tüm kaynaklardan yüklenir ve tüm kancalar sı ı ı ı ı
1. Global config (`~/.config/opencode/opencode.json`)
2. Project config (`opencode.json`)
3. Global eklenti dizini (`~/.config/opencode/plugins/`)
4. Proje eklenti dizini (`.opencode/plugins/`)
Aynı ı ı
---
## Eklenti oluştur
Eklenti, bir veya daha fazla eklentiyi dı
işlevler. Her işlev bir bağlam nesnesi alı
---
### Dependencies
Yerel eklentiler ve özel araçlar harici npm paketlerini kullanabilir. İhtiyacı ı ı ı ı ı
```json title=".opencode/package.json"
{
"dependencies": {
"shescape": "^2.1.0"
}
}
```
2026-02-10 08:11:44 +08:00
opencode bunları ı ı ı ı ı ı ı
2026-02-10 01:34:35 +08:00
```ts title=".opencode/plugins/my-plugin.ts"
import { escape } from "shescape"
export const MyPlugin = async (ctx) => {
return {
"tool.execute.before": async (input, output) => {
if (input.tool === "bash") {
output.args.command = escape(output.args.command)
}
},
}
}
```
---
### Temel yapı
```js title=".opencode/plugins/example.js"
export const MyPlugin = async ({ project, client, $, directory, worktree }) => {
console.log("Plugin initialized!")
return {
// Hook implementations go here
}
}
```
Eklenti işlevi şunları ı
- `project`: Mevcut proje bilgisi.
- `directory`: güncel çalı
- `worktree`: Git çalı ı
2026-02-10 08:11:44 +08:00
- `client`: Yapay zeka ile etkileşime geçmek için opencode'lu bir SDK istemcisi.
2026-02-10 01:34:35 +08:00
- `$`: Bun'un komutları ı ı
---
### TypeScript desteği
TypeScript eklentileri için türleri eklenti paketinden içe aktarabilirsiniz:
```ts title="my-plugin.ts" {1}
import type { Plugin } from "@opencode-ai/plugin"
export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree }) => {
return {
// Type-safe hook implementations
}
}
```
---
### Olaylar
Eklentiler aşağı ı ı
#### Komut Olayları
- `command.executed`
#### Dosya Olayları
- `file.edited`
- `file.watcher.updated`
#### Kurulum Etkinlikleri
- `installation.updated`
#### LSP Etkinlikler
- `lsp.client.diagnostics`
- `lsp.updated`
#### Mesaj Etkinlikleri
- `message.part.removed`
- `message.part.updated`
- `message.removed`
- `message.updated`
#### İzin Etkinlikleri
- `permission.asked`
- `permission.replied`
#### Sunucu Etkinlikleri
- `server.connected`
#### Oturum Etkinlikleri
- `session.created`
- `session.compacted`
- `session.deleted`
- `session.diff`
- `session.error`
- `session.idle`
- `session.status`
- `session.updated`
#### Yapı
- `todo.updated`
#### Kabuk Etkinlikleri
- `shell.env`
#### Araç Olayları
- `tool.execute.after`
- `tool.execute.before`
#### TUI Etkinlikler
- `tui.prompt.append`
- `tui.command.execute`
- `tui.toast.show`
---
## Examples
2026-02-10 08:11:44 +08:00
opencode'u genişletmek için kullanabileceğiniz bazı
2026-02-10 01:34:35 +08:00
---
### Bildirim gönder
Belirli olaylar meydana geldiğinde bildirim gönderin:
```js title=".opencode/plugins/notification.js"
export const NotificationPlugin = async ({ project, client, $, directory, worktree }) => {
return {
event: async ({ event }) => {
// Send notification on session completion
if (event.type === "session.idle") {
await $`osascript -e 'display notification "Session completed!" with title "opencode"'`
}
},
}
}
```
MacOS'ta AppleScript'i çalı ı ı ı
:::note
2026-02-10 08:11:44 +08:00
opencode masaüstü uygulaması ı ı ı ı ı ı
2026-02-10 01:34:35 +08:00
:::
---
### .env protection
2026-02-10 08:11:44 +08:00
opencode'un `.env` dosyaları ı ı ı
2026-02-10 01:34:35 +08:00
```javascript title=".opencode/plugins/env-protection.js"
export const EnvProtection = async ({ project, client, $, directory, worktree }) => {
return {
"tool.execute.before": async (input, output) => {
if (input.tool === "read" && output.args.filePath.includes(".env")) {
throw new Error("Do not read .env files")
}
},
}
}
```
---
### Ortam değişkenlerini enjekte etme
Ortam değişkenlerini tüm kabuk yürütmeye (AI araçları ı ı
```javascript title=".opencode/plugins/inject-env.js"
export const InjectEnvPlugin = async () => {
return {
"shell.env": async (input, output) => {
output.env.MY_API_KEY = "secret"
output.env.PROJECT_ROOT = input.cwd
},
}
}
```
---
### Custom tools
Eklentiler ayrı
```ts title=".opencode/plugins/custom-tools.ts"
import { type Plugin, tool } from "@opencode-ai/plugin"
export const CustomToolsPlugin: Plugin = async (ctx) => {
return {
tool: {
mytool: tool({
description: "This is a custom tool",
args: {
foo: tool.schema.string(),
},
async execute(args, context) {
const { directory, worktree } = context
return `Hello ${args.foo} from ${directory} (worktree: ${worktree})`
},
}),
},
}
}
```
`tool` yardı ı ı ı ı ı ı ı ı
- `description`: Araç ne yapar?
- `args`: Aracı ı ı
- `execute`: Araç çağrı ı ı ı
Özel araçları ı ı ı ı ı ı
---
### Günlüğe kaydetme
Yapı ı ı ı ı ı
```ts title=".opencode/plugins/my-plugin.ts"
export const MyPlugin = async ({ client }) => {
await client.app.log({
body: {
service: "my-plugin",
level: "info",
message: "Plugin initialized",
extra: { foo: "bar" },
},
})
}
```
Seviyeler: `debug`, `info`, `warn`, `error`. Ayrı ı ı
---
### Compaction hooks
Bir oturum sı ı ı ı ı ı ı
```ts title=".opencode/plugins/compaction.ts"
import type { Plugin } from "@opencode-ai/plugin"
export const CompactionPlugin: Plugin = async (ctx) => {
return {
"experimental.session.compacting": async (input, output) => {
// Inject additional context into the compaction prompt
output.context.push(`
## Custom Context
Include any state that should persist across compaction:
- Current task status
- Important decisions made
- Files being actively worked on
`)
},
}
}
```
`experimental.session.compacting` kancası ı ı ı ı ı ı ı ı ı
Ayrı ı ı ı ı ı
```ts title=".opencode/plugins/custom-compaction.ts"
import type { Plugin } from "@opencode-ai/plugin"
export const CustomCompactionPlugin: Plugin = async (ctx) => {
return {
"experimental.session.compacting": async (input, output) => {
// Replace the entire compaction prompt
output.prompt = `
You are generating a continuation prompt for a multi-agent swarm session.
Summarize:
1. The current task and its status
2. Which files are being modified and by whom
3. Any blockers or dependencies between agents
4. The next steps to complete the work
Format as a structured prompt that a new agent can use to resume work.
`
},
}
}
```
`output.prompt` ayarlandı ı ı ı ı ı ı ı
