TLS Observer OpenCode Installer

一键安装 @volcengine/tls-observer-opencode 到 OpenCode 全局插件目录。

安装

npm exec -y \
  --package=@volcengine/tls-observer-opencode-install -- \
  tls-observer-opencode-install

安装器默认从 registry 下载插件 @latest。使用 beta：

npm exec -y \
  --package=@volcengine/tls-observer-opencode-install -- \
  tls-observer-opencode-install --beta

--plugin-version <version> 可以指定精确版本或 dist-tag，并覆盖 --beta。

安装结果

• 插件入口：~/.config/opencode/plugins/tls-observer-opencode.js
• 插件运行时：~/.config/opencode/plugins/tls-observer-opencode
• TLS env：~/.config/opencode/tls-observer-opencode.env
• 运行数据：~/.config/opencode/plugins/data/tls-observer-opencode

OpenCode 会自动加载 ~/.config/opencode/plugins/ 下的本地插件文件。安装器不会修改 ~/.config/opencode/config.json，也不会写入 OPENCODE_TLS_ENV_FILE；运行时默认读取 ~/.config/opencode/tls-observer-opencode.env。

如果旧版本安装器曾在 ~/.config/opencode/config.json 中写入非法的 plugins / env 键，新安装器会在安装时移除这两个键，保留其他配置。

非交互安装

npm exec -y \
  --package=@volcengine/tls-observer-opencode-install -- \
  tls-observer-opencode-install \
  --non-interactive \
  --force \
  --trace-topic-id <trace-topic-id> \
  --api-key <api-key>

TLS Region 默认是 cn-beijing，TLS Producer endpoint 会自动生成为 tls-cn-beijing.volces.com。如需切换 Region，使用 --region <region>；如需单独覆盖 endpoint，使用 --tls-endpoint <host>。旧的 --otel-endpoint 仅保留兼容。

自定义 span attributes 可通过 --span-attributes 'session.name:${AIPAAS_SESSION_ID},tenant.id:${TENANT_ID}' 写入 env。

AK/SK 模式将 --api-key 替换为 --ak、--sk，并可提供 --project-name、--app-name 自动准备 TLS LogApp。若未传 --trace-topic-id，安装器会从 LogApp 关联资源中发现 trace topic，并写入 OPENCODE_TLS_TRACE_TOPIC_ID。

本地开发

emo run build --filter @volcengine/tls-observer-opencode
emo run check --filter @volcengine/tls-observer-opencode-install
emo run build --filter @volcengine/tls-observer-opencode-install

OPENCODE_PLUGIN_SOURCE="$PWD/packages/opencode" \
node packages/opencode-install/bin/tls-observer-opencode-install.mjs --force

安装器会读取源码包的 publishConfig.directory，因此本地开发与正式发布都会使用构建生成的 dist-package。