opencode-metrics-plugin 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 
-## 0.3.0（未发布）
+## 0.3.1（2026-09-10）
+
+- 上传总开关 `upload.enabled` 缺省改为 true：插件装上即上传（包内 AGC 凭证），`false` 显式关闭。
+
+## 0.3.0（2026-09-10）
 
 - 新增会话产物上传：`git commit` / 会话结束自动打包（快照 + 事件日志 + 工作区产物）上传 AGC 云存储，安卓工程自动剔除，失败指数退避重试。
 - 新增 checkpoint 实时落盘（默认 2s 冷却），会话中途退出不再丢指标。

package/README.md

@@ -4,9 +4,9 @@
 
 - **开箱即用**：宿主只需在 `opencode.json` 加一行，无需任何配置
 - **实时落盘**：会话进行中每 2s 增量写盘，中途退出不丢数据
-- **产物上传**（可选）：`git commit` 或会话结束时自动打包上传，安卓源码工程自动剔除
+- **开箱即传**：上传默认开启（包内 AGC 凭证），`git commit` / 会话结束自动打包上传，安卓源码工程自动剔除，`upload.enabled: false` 可关
 - **独立配置文件**：`.opencode/opencode-metrics.json(.jsonc)` 支持注释，存在即完全接管内联配置
-- **零打扰**：不修改工作区、不执行 clean；上传默认关闭，不配置零开销
+- **零打扰**：不修改工作区、不执行 clean
 
 ## 快速开始
 
@@ -18,23 +18,19 @@
 { "plugin": ["opencode-metrics-plugin"] }
 ```
 
-仅此一步即完成指标采集，无需其他配置。
+仅此一步即完成指标采集与产物上传——上传默认开启，使用包内 AGC 凭证，无需其他配置。
 
 ### 第 2 步（可选）：独立配置文件
 
-在项目 `.opencode/` 目录下创建 `opencode-metrics.json` 或 `opencode-metrics.jsonc`（支持注释与尾逗号）。文件存在时**完全接管**内联第二参，推荐用这种方式配置：
+需要自定义上传行为或关闭上传时，在项目 `.opencode/` 目录下创建 `opencode-metrics.json` 或 `opencode-metrics.jsonc`（支持注释与尾逗号）。文件存在时**完全接管**内联第二参：
 
 ```jsonc
-// .opencode/opencode-metrics.jsonc —— 最小上传配置
+// .opencode/opencode-metrics.jsonc —— 关闭上传示例
 {
-  "upload": {
-    "enabled": true
-  }
+  "upload": { "enabled": false }
 }
 ```
 
-上传开启后默认使用包内 AGC 凭证，无需额外配置。
-
 ### 第 3 步（可选）：验证
 
 - 指标：会话进行几轮后，查看输出目录（见下）出现 `<sessionId>.json` 与 `events/<sessionId>.log`
@@ -58,7 +54,7 @@
 
 ## 产物上传
 
-开启 `upload.enabled` 后：
+默认开启（`upload.enabled: false` 可关）：
 
 - **触发场景**：bash 执行 `git commit`（label=`git`）、会话结束/插件退出（label=`session-end`）；可自定义场景（命令正则或事件名）
 - **打包内容**：时点快照 JSON + 事件日志（恒含）+ 会话动过的工作区产物根（鸿蒙工程标记探测，≤3 个）
@@ -93,7 +89,7 @@
 
 | 选项 | 类型 | 默认 | 说明 |
 |---|---|---|---|
-| `upload.enabled` | boolean | `false` | 上传总开关；不配置本块零开销 |
+| `upload.enabled` | boolean | `true` | 上传总开关；`false` 显式关闭 |
 | `upload.uploader.agcConfigPath` | string | 包内凭证 | `agc-apiclient.json` 绝对路径（client_id/secret/project_id/region/bucket） |
 | `upload.scenarios` | object | 内置两场景 | 按 key 合并：`enabled:false` 禁用内置；自定义场景提供 `commands`（正则）或 `events`（事件名）与 `label`（进文件名） |
 | `upload.appendArtifacts` | array | — | 追加产物规则：`path`（绝对或相对会话工作目录）+ `matchBy`（`session-activity` 会话动过才纳入 / `existence` 存在即纳入）+ `dirMarkers`/`fileMarkers` |

package/dist/metrics/upload/types.d.ts

@@ -39,7 +39,7 @@ export interface UploadRetryConfig {
 }
 /** opencode.json 的 upload 配置整块（§13.8） */
 export interface UploadConfig {
-    /** 上传总开关，缺省 false（行为与 0.2.x 零差异） */
+    /** 上传总开关，缺省 true（装上即上传）；false 显式关闭 */
     enabled?: boolean;
     uploader?: UploaderConfig;
     scenarios?: Record<string, ScenarioConfig>;

package/dist/metrics/upload/uploadManager.js

@@ -15,7 +15,7 @@ import { MAX_ROOTS } from "./types.js";
  */
 export function createUploadManager(options) {
     const config = options.config ?? {};
-    if (config.enabled !== true)
+    if (config.enabled === false)
         return null;
     const credentialsResult = loadAgcCredentials(config.uploader?.agcConfigPath ?? defaultAgcConfigPath());
     if (!credentialsResult.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-metrics-plugin",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "opencode plugin: auto-records every session's metrics (tokens/rounds/steps/sub-agents/hvigor builds) to snapshot JSON. Zero DB, zero config. Pair with session-viewer for visualization.",
   "type": "module",
   "license": "MIT",