dsh-opencode-go 0.1.24 → 0.2.1

package/docs/independent-package.md

@@ -6,10 +6,12 @@ The Host depends on DSH services through peer dependencies so Cordis service cla
 
 The package's bundle keeps the configuration entry `id: opencode-go` so existing settings remain attached. Its LLM provider route is independently named `dsh-opencode-go`, shown as `DSH OpenCode Go`, and can coexist with the generic adapter's `opencode-go` route. The SDK retains its native `opencode-go` identity for transport behavior; replay metadata records the DSH route and an optional `sdkProvider` to restore the native identity. The original fork's `llm-opencode-go` row can be disabled by a profile patch. Plugin registration does not select the user's default model or replace another provider automatically. Saved session/preset provider selections must be updated explicitly.
 
-Published `@deepseek-ai/dsh-llm-pi-ai` versions `0.1.5-rc.2` and `0.1.6-alpha.1` do not export `./conversion`. This package therefore carries the request-history, stream, and replay conversion modules under `src/conversion`, with the upstream MIT license. It does not import unpublished files or bundle the whole adapter. Protocol transport remains implemented by pi-ai. Conversion maintenance is now this project's responsibility; a future public conversion library can replace these modules once published and tested.
+The plugin owns request-history, stream and replay conversion in `src/conversion.ts`, with the upstream MIT license. It consumes only published host APIs from DSH `0.2.1-rc.5` and later. Protocol transport remains implemented by the pinned private pi-ai SDK, with Google adapter wrappers in `src/google.ts` and the request-local fetch binding in `src/transport.ts`.
 
 The build uses esbuild and lightningcss, with Rollup to flatten the exported SDK declarations. The host bundles the required pi-ai implementation and only the OpenCode Go model catalog. DSH services, Undici, OpenAI and Anthropic SDKs stay external; DSH class identities remain shared. The browser factory follows DSH's `window.__ModuleLoader__.load` format, embeds CSS Modules, and allows only the declared platform module imports. A package-level builder is sufficient for this single external plugin; extracting a general DSH build-tool package would require a separate release and is not a prerequisite for installation.
 
-Multi-version host fixtures have independent manifests and lockfiles, outside the root npm dependency graph. Consumer installation uses prebuilt artifacts and does not run a plugin build. Compatibility verification installs one generated tarball into isolated consumers and uses their ordinary module resolution; it does not substitute selected host modules into the root process. See [development and verification](development.md).
+The minimum supported Host is DSH `0.2.1-rc.5`, with Cordis `~4.0.5`. Development dependencies and the lockfile pin that DSH release, Cordis `4.0.5` and Schemastery `3.18.5`. Consumer installation uses the prebuilt artifacts and does not run a plugin build.
+
+Verification uses 12 domain-focused Vitest files against published rc.5 APIs, separate host/client type checks, a byte-for-byte independent rebuild and Cordis's ordinary package resolver. Tests import the 17 current implementation modules directly. `npm run verify:installed -- /path/to/consumer` exercises a consumer's resolved package; `npm run verify:headless -- /path/to/consumer` additionally exercises the official CLI with a temporary profile and loopback gateway. The default `verify` includes the complete test suite. See [development](development.md) and [verification](verification.md) for commands and scope.
 
 The initial source derives from the user's working copy of DeepSeek Harness on branch `oh-my-dsh`, whose HEAD was `2c8555b323f3b49eac743bafd527f9f3238bf548`, including the uncommitted OpenCode Go settings changes present when this project was created. Runtime conversion modules retain their published behavior. The original checkout is unchanged by this extraction.

package/docs/usage-analytics.en.md

@@ -0,0 +1,57 @@
+# Usage analytics notes
+
+[Back to README](../README.en.md) · [简体中文](usage-analytics.md)
+
+The dashboard shows official history for the workspace belonging to the selected OpenCode key. It can include calls from other clients and does not attribute calls to this plugin. Coverage of anonymous Free calls is not guaranteed.
+
+## Entry points and accounts
+
+Open it from the conversation's expanded usage pill or the sidebar dashboard button. Settings no longer include a usage analytics card or theme picker.
+
+The dashboard has an independent viewing-account selector, defaulting to the account currently used for inference. Changing it only changes the dashboard scope; it does not switch the account for subsequent conversations or combine all saved accounts. The dashboard's five-hour, weekly and monthly quota windows follow the selected account and use official quota percentages.
+
+## Official data source
+
+The Host uses the selected account's key to request the official daily CSV:
+
+```text
+https://opencode.ai/console/api/v2/usage/export?range=7d|30d|90d
+```
+
+Totals, daily charts and model detail all come from one CSV snapshot, avoiding differences between endpoints queried at different times. Ranges are today, 7 days, 30 days and 90 days; today filters the 7-day CSV to the current UTC date. All dates use UTC, with missing dates filled with zero to keep the daily series continuous. Official daily aggregates may be delayed, so refreshing may not immediately include a recently completed call.
+
+The Host stores and uses keys. Normal reports send the browser only aggregate numbers and grouping fields such as provider, model and day, without conversation content, member fields or keys. An official CSV explicitly downloaded by the user may contain official member fields.
+
+History queries require an official model gateway configuration before the Host sends a key to the `opencode.ai` Console. Third-party gateways show an unsupported state and their keys are not sent to Console. Queries retain the configured proxy path, cancellation, timeouts and response-size limits.
+
+## Accounting
+
+| Metric | Source |
+| --- | --- |
+| Requests | Sum of official CSV request counts |
+| Input / output tokens | Official input and output fields, summed separately |
+| Cache-read tokens | Sum of the official cache-read field |
+| Cache-write tokens | Sum of official 5-minute and 1-hour cache-write fields |
+| Total tokens | Input + output + cache read + both cache-write fields |
+| Official usage amount | Exact sum of `cost_micro_cents`; `1 USD = 100,000,000 cost_micro_cents` |
+| Model grouping | Provider + model; identical model names from different providers stay separate |
+
+The amount comes directly from official records and is labeled **official usage amount**. It does not mean an additional charge beyond the Go subscription. The dashboard does not reprice history using the current model catalog or derive quota percentages from amounts.
+
+Only source-supported metrics are shown. Local session coverage, summary-call counts, unsettled attempts and unattributed activity are not reported or filled with misleading zeros. UTC zero-filling only means the official CSV contains no records for that day.
+
+## Presentation and refresh
+
+- A wide-screen dialog becomes full-screen on narrow screens, with stacked daily token bars or daily request bars, model rankings and detail.
+- Settings, the pill, expanded sidebar and dashboard share warm paper / charcoal surfaces and terracotta accents, following the Host's light/dark mode. There is no theme picker. Locally installed Anthropic Serif / Sans / Mono fonts are preferred, with system and CJK serif fallbacks. Settings recolor the Host's existing controls only within the plugin section.
+- History queries run only when opening the dashboard, changing the viewing account or range, or refreshing manually. There is no background history polling; closing the dashboard cancels its active query.
+- The Host caches official reports and CSVs for 30 seconds, isolated by credential, account, network configuration, range and UTC date. A forced manual refresh bypasses the cache.
+- Authentication, permission, network and data-format errors show an explicit failure, without falling back to local session scans or fabricated zero usage.
+
+The usage pill's existing quota refresh is independent of history queries.
+
+## Verification
+
+An existing manual check on 2026-11-06 used the current desktop key without Cookie or organization headers. All four official Console history endpoints returned HTTP 200, with matching 30-day totals of **7,064 requests, 1,105,009,939 tokens and 3,152,640,453 cost_micro_cents**. This established that the daily CSV supplies the dashboard data; it does not establish identical permissions for every account or complete anonymous Free coverage.
+
+See [verification notes](verification.md) for this implementation's automated tests, build and UI checks. Unfinished checks are marked separately.

package/docs/usage-analytics.md

@@ -0,0 +1,57 @@
+# 用量统计说明
+
+[返回 README](../README.md) · [English](usage-analytics.en.md)
+
+用量看板展示所选 OpenCode Key 所属工作区的官方历史用量。数据可能包含其他客户端的调用，不能据此判断某次调用来自本插件；匿名 Free 调用的覆盖不作保证。
+
+## 入口与账号
+
+从对话用量胶囊展开后的看板按钮，或侧栏看板按钮打开。设置页不再提供用量统计卡片或主题选择器。
+
+看板有独立的查看账号选择器，默认选择当前调用账号。切换查看账号只改变看板范围，不会切换后续对话使用的账号，也不会合并所有已保存账号。看板内的 5 小时、每周、每月额度窗口均跟随所选账号，百分比以官方额度接口为准。
+
+## 官方数据来源
+
+Host 使用所选账号的 Key 请求官方每日 CSV：
+
+```text
+https://opencode.ai/console/api/v2/usage/export?range=7d|30d|90d
+```
+
+一份报告的总计、每日图表与模型明细都从同一个 CSV 快照生成，避免多个接口在不同时间返回数据造成差异。支持今日、7 天、30 天、90 天；「今日」从 7 天 CSV 中筛选 UTC 当日。日期统一按 UTC，区间内缺少记录的日期补零，保持日序列连续。官方每日汇总可能延迟，刷新不保证立即看到刚结束的调用。
+
+Key 由 Host 保存并使用。常规报告只向浏览器传递聚合数字，以及 provider、model、day 等分组字段，不含会话正文、成员字段或 Key。用户主动下载官方 CSV 时，文件可包含官方导出的成员字段。
+
+只有官方模型网关配置支持历史查询，Host 才会将 Key 发给 `opencode.ai` Console。第三方网关配置显示不支持，不会把其 Key 发送到 Console。查询沿用已配置的代理路径，并保留取消、超时和响应体大小限制。
+
+## 统计口径
+
+| 项目 | 口径 |
+| --- | --- |
+| 请求数 | 汇总 CSV 的官方请求数 |
+| 输入 / 输出 Token | 分别汇总官方输入、输出字段 |
+| 缓存读 Token | 汇总官方 cache-read 字段 |
+| 缓存写 Token | 合计官方 5 分钟与 1 小时 cache-write 字段 |
+| 总 Token | 输入 + 输出 + 缓存读 + 两类缓存写 |
+| 官方用量金额 | 精确累加 `cost_micro_cents`；`1 USD = 100,000,000 cost_micro_cents` |
+| 模型分组 | 使用 provider + model；不同 provider 的同名模型分别统计 |
+
+金额直接来自官方记录，称为「官方用量金额」，不等同于 Go 套餐之外的额外扣款。看板不使用当前模型价目表重算历史费用，也不根据金额反推订阅额度百分比。
+
+只有来源能够支持的数据才会显示。看板不提供本地会话覆盖、摘要调用、未结算尝试或未归属活动等指标，也不会用零值代替这些未知数据。UTC 补零仅表示官方 CSV 在该日没有记录。
+
+## 展示与刷新
+
+- 看板在宽屏使用弹窗，窄屏使用全屏；提供 Token 堆叠日柱图或请求日柱图、模型排行与明细。
+- 设置页、胶囊、展开侧栏和看板统一使用暖纸色 / 炭灰色与陶土色强调，跟随宿主明暗模式；不提供主题选择器。优先匹配本地 Anthropic Serif / Sans / Mono 字体，中文标题使用宋体等衬线回退。设置页中的宿主控件仅在插件区域内应用这套配色。
+- 历史只在打开看板、切换查看账号、切换区间或手动刷新时查询，不后台轮询。关闭看板会取消正在进行的查询。
+- Host 对官方报告与 CSV 使用 30 秒短缓存，按凭证、账号、网络配置、区间与 UTC 日期隔离；手动强制刷新绕过缓存。
+- 鉴权、权限、网络或数据格式错误明确显示失败，不回退到本地会话扫描，也不显示伪造的零用量。
+
+额度胶囊原有的额度刷新与历史查询相互独立。
+
+## 验证
+
+2026-11-06 的既有手工检查中，当前桌面 Key 在不携带 Cookie 或组织请求头的情况下可访问四个官方 Console 历史接口，均返回 HTTP 200；30 天汇总一致为 **7,064 次请求、1,105,009,939 Token、3,152,640,453 cost_micro_cents**。该检查确认每日 CSV 可提供看板所需数据，不代表所有账号均有相同权限或匿名 Free 历史一定完整。
+
+本轮实现的自动测试、构建和界面验证结果见[验证记录](verification.md)；尚未完成的项目单独标记。