类型: Token优化插件

1. 这是什么插件？

Slim System 是一个通过替换 OpenCode 内置的系统提示词和工具描述为精简版本，来自动减少每次请求的token开销的插件。核心思想是在每次向LLM发送请求时，使用更短但等效的描述文本，从而减少固定的token消耗。

⚠️ 重要: 原始工具功能不会改变——Slim System只是替换了描述文本，工具行为完全一致。用户编辑的配置文件在npm更新后保留。

主要组件:

1. Slim Tool Descriptions — 17个OpenCode内置工具的精简描述文件（从 ~16,395 字符压缩到更短版本，节省约 8,300 tokens/请求）。
2. Slim System Prompt — 精简的系统提示词（身份 + 语气规范，约 240 tokens，节省约 1,400 tokens/请求）。
3. Per-Model Customization — 支持为不同模型配置独立的工具描述（{toolID}.{model}.txt）和系统提示词（prompt/{model}.txt）。
4. TUI Sidebar Panel — 侧边栏面板显示精简工具数、版本、更新指示器和预估token节省量。

2. 有什么用？

在以下场景中使用它：

• ✅ 节省 ~9,700 tokens/请求（系统提示词 ~1,400 + 工具描述 ~8,300）
• ✅ 减少每次请求的固定token开销
• ✅ 按token付费的API节省成本（Anthropic、OpenAI）
• ✅ 长会话中累积节省显著
• ✅ 通过 exclude 选项保护特定工具不被精简
• ✅ 通过 inline tools 选项自定义任意工具描述
• ✅ Per-Model 定制 — 为不同模型使用不同的描述

技术特性:

• 工具描述替换 — 通过 tool.definition hook 替换内置工具描述
• 系统提示词替换 — 通过 experimental.chat.system.transform hook 替换系统提示词
• 自动种子 — 首次运行时自动创建 ~/.config/opencode/slim-system/ 配置目录
• 配置优先级链 — inline > per-model文件 > 通用文件 > 配置目录 > 嵌入默认值 > 原始描述
• 状态文件 — 运行时状态写入 /tmp/opencode-slim-system.json，TUI每5秒轮询
• 自动更新通知 — 启动时检查npm最新版本，TUI显示更新指示器和对话框
• 占位符解析 — 自动解析 ${os}, ${shell}, {{year}} 等动态占位符
• 升级自动播种 — 新版本添加新工具时自动补充缺失的配置文件

3. 怎么用？

简单安装

npm install -g opencode-slim-system

这会将插件安装到全局。

添加到 ~/.config/opencode/opencode.jsonc:

{
  "plugin": ["opencode-slim-system"]
}

TUI 侧边栏配置（可选）

在 ~/.opencode/tui.json 和/或 ~/.config/opencode/tui.json:

{
  "plugin": ["opencode-slim-system"]
}

重启 OpenCode 即可生效。

配置选项

在 opencode.jsonc 中配置:

{
  "plugin": [
    ["opencode-slim-system", {
      "exclude": ["websearch"],
      "toolsDir": "/home/user/.config/opencode/slim-tools/",
      "tools": {
        "bash": "自定义bash工具描述"
      },
      "reset": false
    }]
  ]
}

配置选项说明

优先级链

工具描述优先级:

options.tools[toolID] → toolsDir/{id}.{model}.txt → toolsDir/{id}.txt → 配置目录 → 嵌入默认值 → 原始描述

系统提示词优先级:

配置目录 prompt/{model}.txt → 配置目录 prompt/default.txt → 嵌入默认值

Per-Model 定制

插件在启动时从 opencode.jsonc 的 model 字段读取当前模型（例如 opencode/deepseek-v4-flash-free），并提取 model key（最后一个 / 后的短名称）：

Per-Model 工具描述: 创建 {toolID}.{model}.txt 文件在工具目录中。例如 bash.claude-sonnet-4.txt 仅在 opencode/claude-sonnet-4 为当前模型时激活，其他模型回退到通用 bash.txt。

Per-Model 系统提示词: 创建 prompt/{model}.txt 文件（与 prompt/default.txt 同级）。例如 prompt/deepseek-v4-flash-free.txt 仅在该模型运行时替换默认提示词。

只有明确定制的模型受影响——不会污染其他模型，无需覆盖所有模型。

自定义

系统提示词: 编辑 ~/.config/opencode/slim-system/prompt/default.txt 并重启 OpenCode。更改在npm更新后保留。

工具描述: 编辑 ~/.config/opencode/slim-system/tool/ 中的任何 *.txt 文件。每个文件对应OpenCode注册表中的工具ID。重启OpenCode应用更改。占位符（${os}, ${shell}, ${directory} 等）会在运行时自动解析。

重置单个文件: 删除配置文件并重启，插件会从嵌入默认值重新创建。

可用的CLI命令

备份和恢复

# 备份当前配置
npx opencode-slim-export > slim-backup.json

# 恢复配置
npx opencode-slim-import slim-backup.json

4. 什么时候用？

在以下场景使用：

• ✅ 使用按token付费的API（Anthropic、OpenAI）
• ✅ 长会话中减少固定token开销
• ✅ 处理大型代码库，需要最大化上下文窗口
• ✅ 多个会话并行运行
• ✅ 注意到模型在长对话中"失去焦点"（上下文窗口被描述占用）

不要使用的场景：

• ❌ 使用按请求统一收费的提供商（如GitHub Copilot per-request）
• ❌ 使用统一定价的提供商（如Cerebras）
• ❌ 短会话中开销差异不大

⚠️ 重要注意事项

覆盖的工具

插件覆盖17个OpenCode内置工具（v1.15.x），部分工具依赖实验性标志：

实际精简的工具数取决于启用的实验性标志（约14-15个）。

缓存的权衡：

• 没有Slim System: 缓存命中率约 90%
• 有Slim System: 缓存命中率约 85%

这意味着会损失一些缓存读取，但在长会话中会获得更大的token节省。

系统提示词检测：

系统提示词替换使用标记启发式——查找如 “best coding agent on the planet” 的字符串来识别默认提示词。自定义提示词（带有自定义 .md 文件的代理）不会被触及。

限制：

• slimmed** 计数是配置目录文件数，不是运行时覆盖率** — TUI侧边栏显示所有17个文件。实际精简的工具数取决于实验性标志。
• 漂移检测是维护者工具 — npx opencode-slim-check 面向仓库维护者，而非最终用户。
• 非内置工具不受影响 — 来自其他插件（如Magic Context、PTY、AFT）的工具描述保持不变。

OpenCode 官方提示词示例

OpenCode 官方系统提示词变体

根据 Slim System 插件的检测标记，OpenCode 官方有以下系统提示词变体（编译在二进制文件中）：

提示词文件位于 OpenCode 源码的 packages/opencode/src/session/ 目录下。

Slim System 精简提示词

Slim System 提供的精简提示词（prompt/default.txt）：

You are opencode, an interactive CLI tool that helps users with software engineering tasks.

IMPORTANT: Never generate or guess URLs. Use provided URLs or local files only.

When the user asks about opencode itself, use WebFetch to answer from https://opencode.ai

Tool results and user messages may include <system-reminder> tags with useful instructions.

Instructions from AGENTS.md and other instruction files are authoritative.

# Tone
- Be concise, direct, to the point.
- No preamble, postamble, or explanations of your code.
- Reference code with `file:line` notation.