opencode-bridge 2.9.0 → 2.9.1

package/.env.example

@@ -1,131 +1,137 @@
-# 飞书应用配置（从开发者后台获取）
-FEISHU_APP_ID=cli_xxxxxxxxxxxxx
-FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx
-
-# npm CLI 默认优先读取当前工作目录下的 .env；若不存在，则读取 ~/.config/opencode-bridge/.env
-# 也可以通过命令行覆盖：opencode-bridge --config-dir /path/to/config
-
-# 用户白名单（你的飞书 open_id）
-# ALLOWED_USERS=ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-
-# 平台启用过滤（可选，逗号分隔）
-# ENABLED_PLATFORMS=feishu,discord
-
-# Discord 适配器（可选）
-# DISCORD_ENABLED=true
-# 兼容两种 token 命名：DISCORD_TOKEN / DISCORD_BOT_TOKEN
-# DISCORD_TOKEN=your-discord-bot-token
-# DISCORD_BOT_TOKEN=your-discord-bot-token
-# DISCORD_CLIENT_ID=your-discord-client-id
-# 需要在 Discord Developer Portal 开启 Message Content Intent
-# 并给机器人授予发送/读取频道消息权限
-
-# OpenCode 服务地址
-# OPENCODE_HOST=localhost
-# OPENCODE_PORT=4096
-
-# OpenCode Server Basic Auth（可选）
-# 当 OpenCode 设置 OPENCODE_SERVER_PASSWORD 后，桥接端需要配置同一组凭据
-# OPENCODE_SERVER_USERNAME 默认为 opencode
-# OPENCODE_SERVER_USERNAME=opencode
-# OPENCODE_SERVER_PASSWORD=your-strong-password
-
-# 可靠性（心跳 + Cron + 宕机救援）
-# 是否启用可靠性 Cron 调度
-# RELIABILITY_CRON_ENABLED=true
-# 是否启用运行时 Cron API（支持 /cron/add|remove|update|list）
-# RELIABILITY_CRON_API_ENABLED=false
-# Cron API 监听地址和端口
-# RELIABILITY_CRON_API_HOST=127.0.0.1
-# RELIABILITY_CRON_API_PORT=4097
-# Cron API Bearer Token（可选）
-# RELIABILITY_CRON_API_TOKEN=your-token
-# Cron 动态任务持久化文件（默认 ~/cron/jobs.json）
-# RELIABILITY_CRON_JOBS_FILE=/absolute/path/jobs.json
-# 是否自动清理僵尸 Cron（启动扫描 / 群解散或频道删除联动 / stale cleanup）
-# RELIABILITY_CRON_ORPHAN_AUTO_CLEANUP=false
-# 原聊天窗口失效时，是否允许转发到私聊/备用窗口
-# RELIABILITY_CRON_FORWARD_TO_PRIVATE=false
-# Feishu 备用接收 chat_id（可选）
-# RELIABILITY_CRON_FALLBACK_FEISHU_CHAT_ID=oc_xxx
-# Discord 备用接收频道/私聊 conversationId（可选）
-# RELIABILITY_CRON_FALLBACK_DISCORD_CONVERSATION_ID=1234567890
-# 主动心跳开关（Bridge 定时器，默认关闭）
-# RELIABILITY_PROACTIVE_HEARTBEAT_ENABLED=false
-# 入站消息触发心跳开关（兼容模式，默认关闭）
-# RELIABILITY_INBOUND_HEARTBEAT_ENABLED=false
-# 主动心跳轮询间隔（毫秒）
-# RELIABILITY_HEARTBEAT_INTERVAL_MS=1800000
-# 主动心跳使用的 Agent（可选）
-# RELIABILITY_HEARTBEAT_AGENT=companion
-# 主动心跳提示词（可选，建议包含 HEARTBEAT_OK）
-# RELIABILITY_HEARTBEAT_PROMPT=Read HEARTBEAT.md if it exists... reply HEARTBEAT_OK
-# 心跳告警推送目标飞书 chat_id（逗号分隔，可选）
-# RELIABILITY_HEARTBEAT_ALERT_CHATS=oc_xxx,oc_yyy
-# 无限重连场景：连续失败阈值与时间窗口
-# RELIABILITY_FAILURE_THRESHOLD=3
-# RELIABILITY_WINDOW_MS=90000
-# 两次自动救援之间的冷却时间（毫秒）
-# RELIABILITY_COOLDOWN_MS=300000
-# 自动救援预算（耗尽后转人工介入）
-# RELIABILITY_REPAIR_BUDGET=3
-# 可靠性模式预留字段：observe | shadow | active
-# RELIABILITY_MODE=observe
-# 仅允许本地 loopback（localhost/127.0.0.1/::1）自动救援
-# RELIABILITY_LOOPBACK_ONLY=true
-# 宕机救援用于备份/回退的 OpenCode 配置文件路径
-# OPENCODE_CONFIG_FILE=./opencode.json
-
-# 群聊是否仅在明确 @ 机器人时才响应（true/false）
-# false: 兼容旧行为，群聊普通消息也会响应
-# true: 仅在群聊中被 @ 才响应
-# GROUP_REQUIRE_MENTION=false
-
-# 输出显示配置（可选）
-# 思维链和工具链显示控制
-# 全局开关：默认 true，设为 false 可隐藏对应内容
-# SHOW_THINKING_CHAIN=true
-# SHOW_TOOL_CHAIN=true
-
-# 飞书特定开关（优先级高于全局：平台键覆盖全局键）
-# FEISHU_SHOW_THINKING_CHAIN=true
-# FEISHU_SHOW_TOOL_CHAIN=true
-#
-# Discord 特定开关（优先级高于全局：平台键覆盖全局键）
-# DISCORD_SHOW_THINKING_CHAIN=true
-# DISCORD_SHOW_TOOL_CHAIN=true
-
-# 工作目录配置（可选）
-# 允许的工作目录根列表（逗号分隔绝对路径）
-# 未配置时用户不能自定义路径，只能使用默认目录或从已知项目选择
-# ALLOWED_DIRECTORIES=/home/user/projects,/opt/repos
-# 全局默认工作目录（最低优先级兜底，不配置则跟随 OpenCode 服务端）
-# DEFAULT_WORK_DIRECTORY=/home/user/projects/main-project
-# 项目别名映射（JSON 格式，短名 → 绝对路径）
-# PROJECT_ALIASES={"frontend":"/home/user/frontend","backend":"/home/user/backend"}
-# 是否自动将目录归一到 Git 仓库根目录（默认 true）
-# GIT_ROOT_NORMALIZATION=true
-
-# 自动允许的工具（不需要确认）
-TOOL_WHITELIST=Read,Glob,Grep,Task,Write
-
-# 权限请求在桥接侧的保留时长（毫秒）
-# <= 0 表示不超时（默认），会一直等待用户回复
-# PERMISSION_REQUEST_TIMEOUT_MS=0
-
-# 输出配置
-OUTPUT_UPDATE_INTERVAL=3000
-
-# 延迟响应最大等待时间（毫秒）
-MAX_DELAYED_RESPONSE_WAIT_MS=120000
-
-# 是否允许手动绑定已有 OpenCode 会话（true/false）
-# true: 开启 /session <sessionId> 与建群下拉中的“绑定已有会话”
-# false: 仅允许新建会话，不展示/不允许绑定已有会话
-ENABLE_MANUAL_SESSION_BIND=true
-
-# 路由模式（legacy | dual | router）
-# legacy: 默认稳定模式
-# dual: 双轨对比日志模式
-# router: 新路由模式
-# ROUTER_MODE=legacy
+# 飞书应用配置（从开发者后台获取）
+FEISHU_APP_ID=cli_xxxxxxxxxxxxx
+FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx
+
+# npm CLI 默认优先读取当前工作目录下的 .env；若不存在，则读取 ~/.config/opencode-bridge/.env
+# 也可以通过命令行覆盖：opencode-bridge --config-dir /path/to/config
+
+# 用户白名单（你的飞书 open_id）
+# ALLOWED_USERS=ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+# 平台启用过滤（可选，逗号分隔）
+# ENABLED_PLATFORMS=feishu,discord
+
+# Discord 适配器（可选）
+# DISCORD_ENABLED=true
+# 兼容两种 token 命名：DISCORD_TOKEN / DISCORD_BOT_TOKEN
+# DISCORD_TOKEN=your-discord-bot-token
+# DISCORD_BOT_TOKEN=your-discord-bot-token
+# DISCORD_CLIENT_ID=your-discord-client-id
+# 需要在 Discord Developer Portal 开启 Message Content Intent
+# 并给机器人授予发送/读取频道消息权限
+
+# OpenCode 服务地址
+# OPENCODE_HOST=localhost
+# OPENCODE_PORT=4096
+
+# OpenCode 自动启动（可选）
+# 设置为 true 时，Bridge 启动时会自动启动 OpenCode 后台进程
+# OPENCODE_AUTO_START=false
+# 可自定义启动命令（默认为 opencode serve，headless 后台模式）
+# OPENCODE_AUTO_START_CMD=opencode serve
+
+# OpenCode Server Basic Auth（可选）
+# 当 OpenCode 设置 OPENCODE_SERVER_PASSWORD 后，桥接端需要配置同一组凭据
+# OPENCODE_SERVER_USERNAME 默认为 opencode
+# OPENCODE_SERVER_USERNAME=opencode
+# OPENCODE_SERVER_PASSWORD=your-strong-password
+
+# 可靠性（心跳 + Cron + 宕机救援）
+# 是否启用可靠性 Cron 调度
+# RELIABILITY_CRON_ENABLED=true
+# 是否启用运行时 Cron API（支持 /cron/add|remove|update|list）
+# RELIABILITY_CRON_API_ENABLED=false
+# Cron API 监听地址和端口
+# RELIABILITY_CRON_API_HOST=127.0.0.1
+# RELIABILITY_CRON_API_PORT=4097
+# Cron API Bearer Token（可选）
+# RELIABILITY_CRON_API_TOKEN=your-token
+# Cron 动态任务持久化文件（默认 ~/cron/jobs.json）
+# RELIABILITY_CRON_JOBS_FILE=/absolute/path/jobs.json
+# 是否自动清理僵尸 Cron（启动扫描 / 群解散或频道删除联动 / stale cleanup）
+# RELIABILITY_CRON_ORPHAN_AUTO_CLEANUP=false
+# 原聊天窗口失效时，是否允许转发到私聊/备用窗口
+# RELIABILITY_CRON_FORWARD_TO_PRIVATE=false
+# Feishu 备用接收 chat_id（可选）
+# RELIABILITY_CRON_FALLBACK_FEISHU_CHAT_ID=oc_xxx
+# Discord 备用接收频道/私聊 conversationId（可选）
+# RELIABILITY_CRON_FALLBACK_DISCORD_CONVERSATION_ID=1234567890
+# 主动心跳开关（Bridge 定时器，默认关闭）
+# RELIABILITY_PROACTIVE_HEARTBEAT_ENABLED=false
+# 入站消息触发心跳开关（兼容模式，默认关闭）
+# RELIABILITY_INBOUND_HEARTBEAT_ENABLED=false
+# 主动心跳轮询间隔（毫秒）
+# RELIABILITY_HEARTBEAT_INTERVAL_MS=1800000
+# 主动心跳使用的 Agent（可选）
+# RELIABILITY_HEARTBEAT_AGENT=companion
+# 主动心跳提示词（可选，建议包含 HEARTBEAT_OK）
+# RELIABILITY_HEARTBEAT_PROMPT=Read HEARTBEAT.md if it exists... reply HEARTBEAT_OK
+# 心跳告警推送目标飞书 chat_id（逗号分隔，可选）
+# RELIABILITY_HEARTBEAT_ALERT_CHATS=oc_xxx,oc_yyy
+# 无限重连场景：连续失败阈值与时间窗口
+# RELIABILITY_FAILURE_THRESHOLD=3
+# RELIABILITY_WINDOW_MS=90000
+# 两次自动救援之间的冷却时间（毫秒）
+# RELIABILITY_COOLDOWN_MS=300000
+# 自动救援预算（耗尽后转人工介入）
+# RELIABILITY_REPAIR_BUDGET=3
+# 可靠性模式预留字段：observe | shadow | active
+# RELIABILITY_MODE=observe
+# 仅允许本地 loopback（localhost/127.0.0.1/::1）自动救援
+# RELIABILITY_LOOPBACK_ONLY=true
+# 宕机救援用于备份/回退的 OpenCode 配置文件路径
+# OPENCODE_CONFIG_FILE=./opencode.json
+
+# 群聊是否仅在明确 @ 机器人时才响应（true/false）
+# false: 兼容旧行为，群聊普通消息也会响应
+# true: 仅在群聊中被 @ 才响应
+# GROUP_REQUIRE_MENTION=false
+
+# 输出显示配置（可选）
+# 思维链和工具链显示控制
+# 全局开关：默认 true，设为 false 可隐藏对应内容
+# SHOW_THINKING_CHAIN=true
+# SHOW_TOOL_CHAIN=true
+
+# 飞书特定开关（优先级高于全局：平台键覆盖全局键）
+# FEISHU_SHOW_THINKING_CHAIN=true
+# FEISHU_SHOW_TOOL_CHAIN=true
+#
+# Discord 特定开关（优先级高于全局：平台键覆盖全局键）
+# DISCORD_SHOW_THINKING_CHAIN=true
+# DISCORD_SHOW_TOOL_CHAIN=true
+
+# 工作目录配置（可选）
+# 允许的工作目录根列表（逗号分隔绝对路径）
+# 未配置时用户不能自定义路径，只能使用默认目录或从已知项目选择
+# ALLOWED_DIRECTORIES=/home/user/projects,/opt/repos
+# 全局默认工作目录（最低优先级兜底，不配置则跟随 OpenCode 服务端）
+# DEFAULT_WORK_DIRECTORY=/home/user/projects/main-project
+# 项目别名映射（JSON 格式，短名 → 绝对路径）
+# PROJECT_ALIASES={"frontend":"/home/user/frontend","backend":"/home/user/backend"}
+# 是否自动将目录归一到 Git 仓库根目录（默认 true）
+# GIT_ROOT_NORMALIZATION=true
+
+# 自动允许的工具（不需要确认）
+TOOL_WHITELIST=Read,Glob,Grep,Task,Write
+
+# 权限请求在桥接侧的保留时长（毫秒）
+# <= 0 表示不超时（默认），会一直等待用户回复
+# PERMISSION_REQUEST_TIMEOUT_MS=0
+
+# 输出配置
+OUTPUT_UPDATE_INTERVAL=3000
+
+# 延迟响应最大等待时间（毫秒）
+MAX_DELAYED_RESPONSE_WAIT_MS=120000
+
+# 是否允许手动绑定已有 OpenCode 会话（true/false）
+# true: 开启 /session <sessionId> 与建群下拉中的“绑定已有会话”
+# false: 仅允许新建会话，不展示/不允许绑定已有会话
+ENABLE_MANUAL_SESSION_BIND=true
+
+# 路由模式（legacy | dual | router）
+# legacy: 默认稳定模式
+# dual: 双轨对比日志模式
+# router: 新路由模式
+# ROUTER_MODE=legacy