session-viewer-plugin 0.1.2 → 0.1.4

package/README.md

@@ -1,9 +1,8 @@
 # session-viewer-plugin
 
-会话指标查看插件：为 Vue3 + Element Plus 宿主应用提供「本地会话浏览」与「AGC 云端文件管理」页面组件，配套可挂载的服务端路由。
+会话指标查看插件：为 Vue3 + Element Plus 宿主应用提供「本地会话浏览」页面组件，配套可挂载的服务端路由。云端文件管理能力已迁移至宿主 tnnotix。
 
 - **本地会话**：扫描本机会话快照 JSON，按会话卡片、月度分组、收藏筛选浏览，并提供步骤时间线 / Token / 工具调用等图表的详情页。
-- **云端数据**：管理 AGC（华为云存储）桶内文件：前缀浏览、全桶模糊搜索（定位 + 剪枝）、下载、重命名、删除、文件夹递归删除、复制下载令牌。
 
 完整接入说明见 **[INTEGRATION.md](./INTEGRATION.md)**。
 
@@ -14,10 +13,10 @@
 ┌───────────────────────────────┐
 │ 宿主服务进程 (:3000)           │
 │  静态页面 + 插件组件(同源fetch) │
-│  createApp() 挂载 /api 路由 ───┼──▶ 本机会话快照目录 / AGC 云存储
+│  createApp() 挂载 /api 路由 ───┼──▶ 本机会话快照目录
 └───────────────────────────────┘
 
-形态二（可选）：独立伴生服务 —— 分进程部署
+形态二（可选）：独立运行 —— 分进程部署
 宿主页面 ──baseUrl──▶ session-viewer-plugin bin (:3001) ──▶ 同上数据源
 ```
 
@@ -38,10 +37,10 @@ const svApp = createApp()   // 未监听的 Express 实例，直接挂载/转发
 ```js
 // 宿主前端（同源模式，不传 baseUrl）
 import 'session-viewer-plugin/ui.css'
-import { SessionViewer } from 'session-viewer-plugin/ui'
+import { SessionViewer, SessionDetail } from 'session-viewer-plugin/ui'
 ```
 
-**形态二（独立服务）**：
+**形态二（独立运行）**：
 
 ```bash
 npx session-viewer-plugin          # 默认 http://127.0.0.1:3001
@@ -51,7 +50,7 @@ npx session-viewer-plugin          # 默认 http://127.0.0.1:3001
 
 | 导出 | 说明 |
 | --- | --- |
-| `session-viewer-plugin/ui` | `SessionViewer` / `SessionDetail` / `CloudFileList` / `API_BASE_KEY` / `setApiBase` 等基址工具 |
+| `session-viewer-plugin/ui` | `SessionViewer` / `SessionDetail` / `API_BASE_KEY` / `setApiBase` 等基址工具 |
 | `session-viewer-plugin/ui.css` | 组件样式 |
 | `session-viewer-plugin/server` | `createApp()` 工厂（未监听的 Express 实例） |
 | `npx session-viewer-plugin` | 独立服务 bin（`PORT` / `HOST` 环境变量） |
@@ -63,18 +62,14 @@ npx session-viewer-plugin          # 默认 http://127.0.0.1:3001
 | 变量 | 默认值 | 说明 |
 | --- | --- | --- |
 | `LOG_DIR` | 内置目录集 | 会话快照扫描目录（单目录）；默认自动探测 hm-plugin-nodejs 与 opencode-metrics-plugin 的标准落盘目录（Linux 为 `~/.local/state/opencode-metrics-plugin/metrics`） |
-| `AGC_CREDENTIALS_FILE` | - | AGC 凭证 JSON 文件路径 |
-| `AGC_CREDENTIALS_JSON` | - | AGC 凭证内联 JSON 字符串 |
 | `PORT` | `3001` | 独立服务监听端口（bin 形态） |
-| `HOST` | `127.0.0.1` | 独立服务绑定地址；容器部署需 `0.0.0.0`（bin 形态） |
+| `HOST` | `127.0.0.1` | 独立服务绑定地址；容器/跨机访问需设 `0.0.0.0`（bin 形态） |
 
 **样本目录**：默认扫描目录还包含 `<opencode-metrics-plugin 日志根>/samples`（Windows `%LOCALAPPDATA%\opencode-metrics-plugin\Log\samples`，macOS `~/Library/Logs/opencode-metrics-plugin/samples`）。外部/分析样本（他人机器的会话快照）请放入该目录：仅用于可视化查看，插件孤儿补传只扫 metrics 目录本身，不会上传此处文件。服务启动时自动创建该目录。
 
-**AGC 凭证**：npm 包不含凭证文件。凭证归属 opencode-metrics-plugin（AGC 桶上传方），运行时通过 `AGC_CREDENTIALS_FILE` / `AGC_CREDENTIALS_JSON` 注入；必填字段 `client_id`、`client_secret`、`project_id`、`bucket_name`，`region` 缺省 `CN`。未配置时本地会话功能不受影响，云端功能返回 503。
-
 ## 开发
 
-仓库为前后端双包结构：
+仓库为前后端双包结构，既可作为 npm 包发布，也可独立运行：
 
 ```bash
 npm run setup         # 安装 server + frontend 依赖