dsh-opendesign-corouter 0.1.2 → 0.1.4

package/README.md

@@ -32,7 +32,7 @@ dsh plugin --profile web add dsh-opendesign-corouter
 也可打开 [Actions → CI](https://github.com/KouzakiUmi/dsh-opendesign-corouter/actions/workflows/ci.yml)，从成功构建下载 **`dsh-opendesign-corouter-build`** artifact。登录 GitHub 后解压 ZIP，取得 `.tgz` 与 `.sha256`，再安装本地包：
 
 ```console
-dsh plugin --profile web add /absolute/path/to/dsh-opendesign-corouter-0.1.2.tgz
+dsh plugin --profile web add /absolute/path/to/dsh-opendesign-corouter-0.1.4.tgz
 ```
 
 `web` 只是示例，请替换为目标 Profile。Desktop 使用桌面安装器提供的 `dsh` 入口；独立公共 CLI 不能代管保留的 `desktop` Profile。安装后的启用与重载按目标 DSH 的管理流程进行。
@@ -40,11 +40,11 @@ dsh plugin --profile web add /absolute/path/to/dsh-opendesign-corouter-0.1.2.tgz
 ### 2. 配置连接
 
 1. 打开 **设置 → OpenDesign CoRouter → 连接与登录**。
-2. 为推理配置 CoRouter 工作空间 **API Key**，或沿用启动环境中的 `COROUTER_API_KEY`。
-3. 额度默认读取桌面登录态；没有桌面端时，点击 **登录并保存会话**，在官方页面自行完成登录。
+2. 点击 **开始设备授权**，再用常用浏览器 **打开授权页**，核对授权码并确认；也可单独配置工作空间 API Key 或沿用 `COROUTER_API_KEY`。
+3. 返回设置页等待保存成功。额度默认优先读取桌面登录态；要明确使用设备授权的账号，可关闭桌面优先。
 4. 回到模型选择器，选择 **OpenDesign CoRouter · 套餐赠送** 或 **OpenDesign CoRouter · 付费模型**。
 
-**API Key 用于推理，桌面 / 控制台会话用于查额度。两者不能互相代替。** [完整连接说明](docs/usage.md)
+**设备授权同时取得查额度和官方网关推理的两类令牌；显式配置的 API Key 仍优先。** [完整连接说明](docs/usage.md)
 
 ## 功能预览
 
@@ -72,7 +72,7 @@ dsh plugin --profile web add /absolute/path/to/dsh-opendesign-corouter-0.1.2.tgz
 
 ### 桌面优先，也能独立登录
 
-不复制或修改桌面配置。独立登录使用临时 Chrome 窗口，用户亲自完成官方登录与人机验证；验证通过才保存到 DSH 凭据服务。支持取消、超时和卸载清理，不触碰日常浏览器。
+独立登录采用设备授权，在常用浏览器打开普通官方授权页，沿用现有配置、密码管理器和自动填充。确认后设备令牌保存到 DSH 凭据服务；取消、超时和卸载停止轮询，不关闭用户浏览器，也不修改桌面配置。
 
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="docs/previews/theme-dark.png">
@@ -98,7 +98,7 @@ dsh plugin --profile web add /absolute/path/to/dsh-opendesign-corouter-0.1.2.tgz
 | 目标 DSH Core | `0.2.1-rc.3`，以官方同版本发布包验证 |
 | Core 声明范围 | `>=0.2.1-rc.3 <0.3.0-0`，范围内其他版本不代表已实测 |
 | Node.js | `>=24.9.0` |
-| 独立登录 | 本机 Google Chrome；插件不会自动下载 |
+| 独立登录 | 能访问官方授权页的常用浏览器；无需浏览器自动化或扩展 |
 | 默认推理接口 | `https://amr-link.open-design.ai/v1/chat/completions` |
 
 CI 在 Windows 与 Ubuntu 执行构建、类型检查及隔离测试；Ubuntu 另执行四页签浏览器和亮暗主题检查。通过 CI 不等于已安装或已通过真实账号验收。[开发与验证范围](docs/development.md)

package/SECURITY.md

@@ -1,11 +1,12 @@
 # 安全边界
 
 - 推理、桌面控制面和控制台 Cookie 分属独立通道，不互相替代鉴权材料。
-- API Key 与独立登录 Cookie 仅经 DSH 凭据服务写入插件专属记录；设置页只读取存在性和状态，不回填秘密。
+- API Key 与设备授权的 controlKey / runtimeKey 仅经 DSH 凭据服务写入插件专属记录；设置页只读取存在性和状态，不回填秘密。
 - 桌面配置只读。仅支持已核实的生产环境，控制令牌只能发送到 `https://amr-api.open-design.ai`。控制台和推理请求禁止自动跟随重定向。
+- 设备授权双令牌原子保存；runtimeKey 只自动提供给请求快照中的官方推理 origin，controlKey 只发往官方控制面。旧 Cookie grant 保留只读兼容。
 - 推理自定义地址由用户显式配置；除本机回环外要求 HTTPS，拒绝 URL 内嵌凭据、查询串与片段。
 - 额度分池不跨身份混合。桌面认证失效时，可回退到单独保存的控制台登录；权限不足和未知额度不伪装成 0。
-- 独立登录使用临时浏览器上下文。用户自行完成登录和验证；取消、超时和卸载关闭插件拥有的窗口。持久化成功是不可撤回的提交边界，之后取消不会假称已撤回。
+- 独立登录使用设备授权，普通浏览器仅打开官方激活页；插件不启动浏览器自动化、不读取浏览器配置或 Cookie。deviceSecret 只在 Host 内存用于轮询；授权码、激活链接和到期时间仅在等待期提供给 UI。取消、超时和卸载中止请求，不关闭用户浏览器。持久化成功是不可撤回的提交边界，之后取消不会假称已撤回。
 - `OPENDESIGN_VELA_PATH` 是用户信任的本地程序路径。插件仅以固定 argv 执行只读查询，不通过 shell；不校验该程序的签名或下载它。不要将此变量指向来源不明的程序。
 - RPC 使用严格白名单解析；原始错误正文、Cookie、请求头、Key 和桌面本地路径不进入状态返回。并发保存有版本冲突检测。
 - 请求、流空闲、额度接口、CLI、登录和 RPC 均有有界超时。停用插件会撤销 Provider / RPC 并中止自身请求。

package/THIRD_PARTY_NOTICES.md

@@ -1,6 +1,6 @@
 # 第三方代码与资料
 
-本项目的消息/图片兼容处理、套餐模型元数据参考 [dsh-opendesign-go 0.1.9](https://github.com/EliteOtaku/dsh-opendesign-go)。额度归一化和临时浏览器登录流程改编自 [dsh-subusage 0.16.2](https://github.com/KouzakiUmi/dsh-subusage)。空轮判定参考 [dsh-empty-turn-guard 0.4.0](https://github.com/FYTXY/dsh-empty-turn-guard)。设置布局参考 [dsh-code-pill](https://github.com/KouzakiUmi/dsh-code-pill)。
+本项目的消息/图片兼容处理、套餐模型元数据参考 [dsh-opendesign-go 0.1.9](https://github.com/EliteOtaku/dsh-opendesign-go)。额度归一化及登录生命周期的基础处理改编自 [dsh-subusage 0.16.2](https://github.com/KouzakiUmi/dsh-subusage)。空轮判定参考 [dsh-empty-turn-guard 0.4.0](https://github.com/FYTXY/dsh-empty-turn-guard)。设置布局参考 [dsh-code-pill](https://github.com/KouzakiUmi/dsh-code-pill)。
 
 离线主题夹具使用 [DeepSeek Harness 官方主题令牌](https://github.com/deepseek-ai/deepseek-harness/blob/22ddee3792402c3e70ec5f86a63c3e3e895a2f60/packages/client/ui-theme/src/styles/design-platform.css)，仅供测试，不随插件安装包分发。
 

package/lib/adapter.d.ts

@@ -5,7 +5,7 @@ import { type RuntimeConfig } from './config.js';
 export interface AdapterOptions {
     config(): RuntimeConfig;
     models?(): readonly CatalogModel[];
-    apiKey(ref: string): Promise<string | undefined>;
+    apiKey(ref: string, baseURL?: string): Promise<string | undefined>;
     imageDataUrl?(image: ImageAttachmentRef, signal: AbortSignal): Promise<string | undefined>;
     onEmptyTurn?(): void;
     fetch?: typeof fetch;

package/lib/auth.d.ts

@@ -77,11 +77,22 @@ export interface DesktopDeps {
  */
 export declare function readDesktopCredential(deps?: DesktopDeps): Promise<DesktopRead>;
 /** Cookie payload persisted through the credential seam as a `grant` record. */
-export interface LoginGrant {
+export interface CookieLoginGrant {
     cookie: string;
-    /** Epoch ms; `0`/absent means the console declared no expiry. */
+    /** Legacy cookie expiry only; never applied to device tokens. */
     expiresAt?: number;
 }
+export interface DeviceLoginGrant {
+    kind: 'device';
+    controlKey: string;
+    runtimeKey: string;
+    savedAt?: string;
+}
+export type LoginGrant = CookieLoginGrant | DeviceLoginGrant;
+/** Validate both keys as one snapshot; never combine an incomplete grant with another source. */
+export declare function deviceGrant(value: unknown): DeviceLoginGrant | undefined;
+/** Device runtime credentials may only reach this exact HTTPS origin, never a custom gateway. */
+export declare function isOfficialRuntimeUrl(raw: string): boolean;
 export type AuthSource = 'desktop' | 'login' | 'environment';
 export interface AuthSession extends Session {
     source: SessionSource;
@@ -112,11 +123,15 @@ export interface AuthDeps extends DesktopDeps {
 }
 /** Desktop `controlKey` as a Bearer header (daemon evidence: `/api/v1/wallet/balance`). */
 export declare function desktopSession(credential: DesktopCredential, apiUrl?: string): AuthSession;
+/** Device control token: Bearer on the official control plane only. No inferred token expiry. */
+export declare function deviceSession(tokens: {
+    controlKey: string;
+} | string): AuthSession;
 /** A persisted or environment-supplied console cookie as a `cookie` header. */
 export declare function cookieSession(cookie: string, source: SessionSource, apiUrl?: string): AuthSession | undefined;
 /**
  * Resolve the session in the order the user asked for: **desktop first**, then the
- * cookie saved by this plugin's own login, then environment references.
+ * device grant saved by this plugin, then legacy cookies and environment references.
  *
  * A desktop config whose `apiUrl` is not an official origin is *skipped*, not used: the
  * token must not travel to a host the plugin cannot vouch for. The skip is reported as a

package/lib/client.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import openDesignCoRouterRemote, { type CoRouterRemote } from './generated/typert.remote-client.js';
 import type { TypertClientRemote } from '@deepseek-ai/dsh-typert-protocol';
-import { type Status, type StatusModel } from './remote.js';
+import { type LoginState, type Status, type StatusModel } from './remote.js';
 import type { QuotaSnapshot, QuotaWindow } from './quota.js';
 import { type ApiProtocol } from './protocol-options.js';
 import type { ModelSettings, ModelSettingsMap } from './model-settings.js';
@@ -145,8 +145,9 @@ export interface OverviewProps {
     onRefresh: () => void;
     nextAutoRefreshAt?: string | undefined;
     refreshIntervalSeconds?: number | undefined;
+    onConnection?: (() => void) | undefined;
 }
-export declare function Overview({ status, busy, onRefresh, nextAutoRefreshAt, refreshIntervalSeconds }: OverviewProps): React.FunctionComponentElement<{
+export declare function Overview({ status, busy, onRefresh, nextAutoRefreshAt, refreshIntervalSeconds, onConnection }: OverviewProps): React.FunctionComponentElement<{
     children?: React.ReactNode | undefined;
 }>;
 export interface ModelRowProps {
@@ -165,7 +166,7 @@ export interface ModelsProps {
     status: Status | undefined;
     formSnapshot: FormSnapshot;
     setFormField: (field: string, value: unknown) => Promise<boolean>;
-    pendingField: string | null;
+    pendingField: readonly string[];
     onRefreshModels: () => void;
     refreshingModels: boolean;
     notice: Notice | null;
@@ -177,11 +178,18 @@ export interface AdvancedProps {
     status: Status | undefined;
     formSnapshot: FormSnapshot;
     setFormField: (field: string, value: unknown) => Promise<boolean>;
-    pendingField: string | null;
+    pendingField: readonly string[];
 }
 export declare function Advanced({ status, formSnapshot, setFormField, pendingField }: AdvancedProps): React.FunctionComponentElement<{
     children?: React.ReactNode | undefined;
 }>;
+/** Approval opens through an ordinary link; no browser profile is created or controlled. */
+export declare function LoginApproval({ login }: {
+    login: LoginState | undefined;
+}): React.DetailedReactHTMLElement<{
+    className: string;
+    'aria-label': string;
+}, HTMLElement> | null;
 export declare function tabAfter(current: TabId, key: string): TabId | undefined;
 export declare function SettingsPage({ caller, form }: SettingsProps): React.DetailedReactHTMLElement<{
     className: string;