dsh-grok-provider 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.1.2 - 2026-08-26
+
+- Fix Windows browser sign-in for official Grok Build CLI `0.2.82`, which `0.1.1` rejected before invoking `login --oauth`.
+- Replace the complete CLI-version allowlist with bounded version diagnostics plus a `login --help` capability probe for the independent `--oauth` option.
+- Keep the security boundary closed: official default path and executable checks, fixed argv, scrubbed environment, no plugin shell, post-login production OIDC credential validation, and pinned Grok Build endpoints remain mandatory.
+- Add regression coverage for the real Windows `0.2.82` output shape, compatible unknown versions, missing OAuth capability, and malformed version output.
+- Document Windows x64 as code- and CI-supported without claiming independent real-device acceptance; publish later stable fixes for any discovered defect.
+- Adopt stable-only releases: future defects are resolved by incrementing the stable version instead of publishing prereleases.
+
 ## 0.1.1 - 2026-08-26
 
 - Correct post-release status across the Simplified Chinese and English READMEs, security policy, and maintainer documentation.

package/README.en.md

@@ -4,7 +4,7 @@
 
 Use an already authenticated official Grok Build account from DeepSeek Harness, with dynamic model discovery, streaming reasoning, tool calls, and an account quota/model capability dashboard.
 
-> Unofficial community project; not affiliated with xAI or DeepSeek Harness. The current version is `0.1.1`. Windows x64 has code and CI support; its first Registry real-device validation remains a post-release follow-up.
+> Unofficial community project; not affiliated with xAI or DeepSeek Harness. The current stable version is `0.1.2`. The project no longer publishes prereleases; stable defects are fixed in a new incremented stable version.
 
 ## What it provides
 
@@ -25,7 +25,7 @@ Use an already authenticated official Grok Build account from DeepSeek Harness,
 - DeepSeek Harness `0.1.1-rc.2`
 - Node.js `24.19.0` or newer
 - macOS arm64 or Windows x64
-- Official Grok Build CLI `1.0.5 (5115b46bc909)`
+- Official Grok Build CLI with `login --oauth` support and the default Grok home
 
 Install the CLI from the [official Grok Build documentation](https://docs.x.ai/build/overview), then verify:
 
@@ -41,7 +41,7 @@ The official CLI opens a browser on first use. The provider supports only the of
 Install the published exact version from npm:
 
 ```sh
-dsh plugin --profile web add dsh-grok-provider@0.1.1
+dsh plugin --profile web add dsh-grok-provider@0.1.2
 dsh web
 ```
 
@@ -97,8 +97,8 @@ Uninstalling the provider does not remove the official Grok CLI or directly modi
 
 ## Sources and discovery
 
-- Exact npm version: [dsh-grok-provider@0.1.1](https://www.npmjs.com/package/dsh-grok-provider/v/0.1.1)
-- GitHub release and integrity values: [v0.1.1](https://github.com/yoshino-xiao7/dsh-grok-provider/releases/tag/v0.1.1)
+- Exact npm version: [dsh-grok-provider@0.1.2](https://www.npmjs.com/package/dsh-grok-provider/v/0.1.2)
+- GitHub release and integrity values: [v0.1.2](https://github.com/yoshino-xiao7/dsh-grok-provider/releases/tag/v0.1.2)
 - GitHub community discovery: the repository carries the DeepSeek Harness-recommended `dsh-plugin` and `dsh` topics
 - YukiRyou managed source: [deepseek-yukiryou-plugin-catalog](https://github.com/yoshino-xiao7/deepseek-yukiryou-plugin-catalog), following the exact verified stable version and currently marking only verified macOS arm64
 
@@ -106,14 +106,14 @@ Directory inclusion is not an endorsement by xAI or DeepSeek Harness. The public
 
 ## Compatibility and scope
 
-| Item | `0.1.1` status |
+| Item | `0.1.2` status |
 | --- | --- |
 | DeepSeek Harness | Exact support for `0.1.1-rc.2` |
 | Node.js | `>=24.19.0` |
 | macOS arm64 | Real-network and isolated Harness acceptance completed |
-| Windows x64 | Code-supported; real-device validation after initial release |
+| Windows x64 | Code and Windows CI supported; no independent real-device acceptance completed for this release |
 | macOS x64 / Linux | Unsupported |
-| Grok CLI | Exact support for `1.0.5 (5115b46bc909)` |
+| Grok CLI | No full-version lock; official path, `login --oauth` capability, and production OIDC credential contract are enforced |
 | Models | Every account catalog model whose backend has a strict codec in this release |
 
 The initial release excludes image input, Web/X Search, arbitrary downloads, API-key mode, multiple accounts, enterprise OIDC, ACP, and Headless agent wrapping. See the complete [product requirements](docs/01-product-requirements.md).
@@ -154,7 +154,7 @@ Confirm the official CLI is in its default location and run `grok --version`. Th
 
 ### The page asks you to sign in again
 
-Use the settings button or run `grok login --oauth` in a terminal. If the official CLI has updated to an unverified version, the provider fails closed instead of bypassing version checks.
+Use the settings button or run `grok login --oauth` in a terminal. The provider does not lock the complete CLI version, but fails closed when the path, `--oauth` capability, or production OIDC credential contract does not match.
 
 ### A model is missing
 
@@ -166,7 +166,7 @@ A protobuf-omitted zero is restored only with a complete typed period. In every
 
 ### Does Windows work?
 
-Windows x64 code and automated tests are present, but the first Registry real-device acceptance for `0.1.0` happens after release. Until then it remains “code-supported, real-device unverified.”
+Windows x64 code and CI coverage are present. The repository owner chose to publish `0.1.2` without making independent real-device acceptance a blocker. Any Windows defect found in the stable release will be fixed in a new incremented stable version.
 
 ## Development
 
@@ -195,7 +195,8 @@ Read the [contributing guide](CONTRIBUTING.md) before filing an issue or PR. Cha
 - [x] Publish `0.1.0` and verify Registry integrity/provenance
 - [x] Configure npm Trusted Publisher, revoke the initial token, and add `dsh-plugin` discovery plus the YukiRyou catalog entry
 - [x] Publish the `0.1.1` documentation and release-process correction
-- [ ] Complete the first Windows x64 real-device acceptance after release
+- [x] Publish the `0.1.2` Windows CLI compatibility correction
+- [ ] Complete independent Windows x64 acceptance and publish a later stable fix if needed
 - [ ] Evaluate additional content types and platforms only against verified Harness/xAI contracts
 
 The roadmap is not a compatibility promise; every new capability must pass the documented design and security gates.

package/README.md

@@ -4,7 +4,7 @@
 
 让 DeepSeek Harness 使用你已登录的官方 Grok Build 账号：动态模型发现、流式推理、工具调用，以及账号额度与模型能力面板。
 
-> 非官方社区项目，与 xAI 或 DeepSeek Harness 官方无隶属关系。当前版本为 `0.1.1`；Windows x64 已完成代码与 CI 支持，首次 Registry 真机验证仍在发布后跟进中。
+> 非官方社区项目，与 xAI 或 DeepSeek Harness 官方无隶属关系。当前稳定版本为 `0.1.2`。项目不再发行预发行版；正式版缺陷通过新的递增稳定版本修复。
 
 ## 它解决什么问题
 
@@ -25,7 +25,7 @@
 - DeepSeek Harness `0.1.1-rc.2`
 - Node.js `24.19.0` 或更高版本
 - macOS arm64 或 Windows x64
-- 官方 Grok Build CLI `1.0.5 (5115b46bc909)`
+- 官方 Grok Build CLI（支持 `login --oauth`，并使用官方默认 Grok home）
 
 请从 [Grok Build 官方文档](https://docs.x.ai/build/overview) 安装 CLI，并先确认：
 
@@ -41,7 +41,7 @@ grok models
 从 npm 安装已发布的精确版本：
 
 ```sh
-dsh plugin --profile web add dsh-grok-provider@0.1.1
+dsh plugin --profile web add dsh-grok-provider@0.1.2
 dsh web
 ```
 
@@ -97,8 +97,8 @@ dsh web
 
 ## 项目来源与发现
 
-- npm 精确版本：[dsh-grok-provider@0.1.1](https://www.npmjs.com/package/dsh-grok-provider/v/0.1.1)
-- GitHub 发行版与校验值：[v0.1.1](https://github.com/yoshino-xiao7/dsh-grok-provider/releases/tag/v0.1.1)
+- npm 精确版本：[dsh-grok-provider@0.1.2](https://www.npmjs.com/package/dsh-grok-provider/v/0.1.2)
+- GitHub 发行版与校验值：[v0.1.2](https://github.com/yoshino-xiao7/dsh-grok-provider/releases/tag/v0.1.2)
 - GitHub 社区发现：仓库已添加 DeepSeek Harness 官方推荐的 `dsh-plugin` 与 `dsh` Topics
 - YukiRyou 受管来源：[deepseek-yukiryou-plugin-catalog](https://github.com/yoshino-xiao7/deepseek-yukiryou-plugin-catalog)，跟随已验证的精确稳定版本，当前只标记已验证的 macOS arm64
 
@@ -106,14 +106,14 @@ dsh web
 
 ## 兼容性与范围
 
-| 项目 | `0.1.1` 状态 |
+| 项目 | `0.1.2` 状态 |
 | --- | --- |
 | DeepSeek Harness | 精确支持 `0.1.1-rc.2` |
 | Node.js | `>=24.19.0` |
 | macOS arm64 | 已完成真实网络与隔离 Harness 验收 |
-| Windows x64 | 代码支持；首版发布后真机验证 |
+| Windows x64 | 代码与 Windows CI 支持；本次正式发布未完成独立真机验收 |
 | macOS x64 / Linux | 不支持 |
-| Grok CLI | 精确支持 `1.0.5 (5115b46bc909)` |
+| Grok CLI | 不锁完整版本；严格校验官方路径、`login --oauth` 能力与生产 OIDC 凭据契约 |
 | 模型 | 当前账号目录中 backend 已被严格 codec 支持的全部模型 |
 
 首版不包含图片输入、Web/X Search、任意文件下载、API Key 模式、多账号、企业 OIDC、ACP 或 Headless agent 封装。完整范围见[产品需求](docs/01-product-requirements.md)。
@@ -154,7 +154,7 @@ dsh-grok-provider Host
 
 ### 页面要求重新登录
 
-在设置页点击登录，或先在终端运行 `grok login --oauth`。如果官方 CLI 已更新到未验证版本，插件会失败关闭，而不是跳过版本检查。
+在设置页点击登录，或先在终端运行 `grok login --oauth`。插件不锁完整 CLI 版本，但路径、`--oauth` 能力或生产 OIDC 凭据契约不匹配时会失败关闭。
 
 ### 没有看到某个模型
 
@@ -166,7 +166,7 @@ dsh-grok-provider Host
 
 ### Windows 能用吗
 
-代码和自动测试覆盖 Windows x64，但 `0.1.0` 首次 Registry 真机验收将在发布后完成；在此之前按“代码支持、真机未验证”处理。
+代码和 Windows CI 覆盖 Windows x64；仓库所有者决定直接发布 `0.1.2`，未把独立真机验收作为阻断项。如果正式版出现 Windows 问题，将通过新的递增稳定版本修复。
 
 ## 开发
 
@@ -195,7 +195,8 @@ npm run pack:check
 - [x] 发布 `0.1.0` 并完成 Registry/provenance 回读
 - [x] 配置 npm Trusted Publisher、撤销首发 Token，并加入 `dsh-plugin` Topic 与 YukiRyou catalog
 - [x] 发布 `0.1.1` 文档与发布流程修正版
-- [ ] 发布后完成 Windows x64 首次真机验收
+- [x] 发布 `0.1.2` Windows CLI 兼容性修正版
+- [ ] 完成 Windows x64 独立真机验收并按需发布后续稳定修复版
 - [ ] 根据已验证的 Harness/xAI 协议逐项评估更多内容类型和平台
 
 路线图不是兼容性承诺；新增能力必须通过文档决策与安全门禁。

package/SECURITY.md

@@ -4,7 +4,7 @@
 
 ## 支持范围
 
-当前版本为 `0.1.1`。仅维护当前发布线中明确列出的 DeepSeek Harness、Node.js、操作系统和 Grok CLI 精确版本；未经验证的版本会失败关闭。macOS arm64 已完成真实验收；Windows x64 仍是代码与 CI 支持、首次 Registry 真机尚未完成。
+当前稳定版本为 `0.1.2`。DeepSeek Harness、Node.js 与操作系统按发布线明确维护；Grok CLI 不使用完整版本字符串作为信任门禁，而是严格校验官方默认路径、命令能力、生产 OIDC 凭据契约和固定服务端协议。macOS arm64 已完成真实验收；Windows x64 有代码与 CI 覆盖，但 `0.1.2` 未完成独立真机验收。项目不再发行预发行版，安全或兼容性缺陷使用新的递增稳定版本修复。
 
 ## 私下报告漏洞
 

package/dist/client/client.js

@@ -14,7 +14,7 @@ window.__ModuleLoader__.load({
         ready: "已登录", notReady: "未登录", driverMissing: "官方 CLI 登录能力不可用",
         running: "登录进行中", succeeded: "登录成功", failed: "登录失败", cancelled: "登录已取消",
         login: "通过浏览器登录", cancel: "取消登录", logout: "退出登录", confirmLogout: "再次点击确认退出",
-        officialBody: "登录与凭据刷新由本机官方 Grok CLI 完成。退出会同时影响使用同一 Grok 凭据的其他应用。",
+        officialBody: "登录与凭据刷新由本机官方 Grok CLI 完成。重新登录会替换共享会话，退出会清除共享会话，并影响使用同一 Grok 凭据的其他应用。",
         usage: "使用额度", grokBuild: "Grok Build", refresh: "刷新", refreshing: "刷新中…",
         weekly: "每周额度", monthly: "每月额度", currentPeriod: "当前额度周期",
         remaining: "剩余", used: "已使用", resetTime: "重置时间", resetUnknown: "上游未提供重置时间",
@@ -31,7 +31,7 @@ window.__ModuleLoader__.load({
         ready: "Signed in", notReady: "Signed out", driverMissing: "Official CLI sign-in unavailable",
         running: "Sign-in in progress", succeeded: "Signed in", failed: "Sign-in failed", cancelled: "Sign-in cancelled",
         login: "Sign in with browser", cancel: "Cancel sign-in", logout: "Sign out", confirmLogout: "Click again to confirm sign-out",
-        officialBody: "The official local Grok CLI owns sign-in and credential refresh. Signing out also affects other apps sharing the same Grok credential.",
+        officialBody: "The official local Grok CLI owns sign-in and credential refresh. Signing in replaces the shared session; signing out clears it, affecting other apps that share the same Grok credential.",
         usage: "Usage quota", grokBuild: "Grok Build", refresh: "Refresh", refreshing: "Refreshing…",
         weekly: "Weekly quota", monthly: "Monthly quota", currentPeriod: "Current quota period",
         remaining: "remaining", used: "Used", resetTime: "Resets", resetUnknown: "Reset time was not provided",

package/dist/host/index.mjs

@@ -7,7 +7,7 @@ import Schema from "@deepseek-ai/schemastery"
 
 import {
   CredentialFileTooLargeError,
-  GROK_CLI_1_0_5_AUTH_CONTRACT,
+  GROK_PRODUCTION_OIDC_AUTH_CONTRACT,
   UnsupportedCredentialError,
   createCredentialSource,
 } from "../internal/credential-source.mjs"
@@ -35,13 +35,13 @@ export const Config = Schema.object({})
 export function apply(ctx) {
   const platform = process.platform
   if (platform !== "darwin" && platform !== "win32") {
-    throw new TypeError("dsh-grok-provider supports macOS and Windows in version 0.1.0")
+    throw new TypeError("dsh-grok-provider supports macOS and Windows")
   }
 
   const homeDir = os.homedir()
   let refreshOfficialCredential
   const officialSource = createCredentialSource({
-    contract: GROK_CLI_1_0_5_AUTH_CONTRACT,
+    contract: GROK_PRODUCTION_OIDC_AUTH_CONTRACT,
     load: createOfficialCredentialLoader({
       authPath: path.join(homeDir, ".grok", "auth.json"),
       platform,

package/dist/internal/credential-source.mjs

@@ -1,7 +1,7 @@
 const CLIENT_ID = "b1a00492-073a-47ea-816f-4c329264a828"
 const EXPIRY_SKEW_MS = 5 * 60 * 1000
 
-export const GROK_CLI_1_0_5_AUTH_CONTRACT = Object.freeze({
+export const GROK_PRODUCTION_OIDC_AUTH_CONTRACT = Object.freeze({
   authMode: "oidc",
   clientId: CLIENT_ID,
   issuer: "https://auth.x.ai",

package/dist/internal/official-cli-auth.mjs

@@ -1,6 +1,5 @@
 import path from "node:path"
 
-const EXPECTED_VERSION = "grok 1.0.5 (5115b46bc909)"
 const GRACE_MS = 5_000
 const DEFAULT_VERSION_TIMEOUT_MS = 10 * 1000
 const DEFAULT_LOGIN_TIMEOUT_MS = 5 * 60 * 1000
@@ -46,7 +45,7 @@ export function createOfficialCliAuth({
   const candidate = pathApi.join(grokHome, "bin", platform === "win32" ? "grok.exe" : "grok")
   const cliEnvironment = buildCliEnvironment(platform, homeDir)
 
-  const runAction = async (argvTail, callerSignal, timeoutMs) => {
+  const runAction = async (argvTail, callerSignal, timeoutMs, requiredCapability) => {
     let preparationDeadline = createDeadline(callerSignal, versionTimeoutMs)
     let actionDeadline
     let resolved
@@ -62,10 +61,23 @@ export function createOfficialCliAuth({
         signal: preparationDeadline.signal,
         env: cliEnvironment,
       })
-      if (version.stdout.trim() !== EXPECTED_VERSION || version.stderr.length !== 0) {
+      if (!isGrokVersionOutput(version.stdout) || version.stderr.length !== 0) {
         throw new OfficialCliAuthError()
       }
 
+      if (requiredCapability) {
+        const help = await runCollected(subprocess, {
+          argv: [resolved, ...requiredCapability.helpArgv],
+          cwd: grokHome,
+          maxBytes: 16 * 1024,
+          signal: preparationDeadline.signal,
+          env: cliEnvironment,
+        })
+        if (help.stderr.length !== 0 || !hasCliOption(help.stdout, requiredCapability.option)) {
+          throw new OfficialCliAuthError()
+        }
+      }
+
       preparationDeadline.dispose()
       preparationDeadline = undefined
       actionDeadline = createDeadline(callerSignal, timeoutMs)
@@ -92,7 +104,10 @@ export function createOfficialCliAuth({
 
   return Object.freeze({
     login({ signal } = {}) {
-      return runAction(["login", "--oauth"], signal, loginTimeoutMs)
+      return runAction(["login", "--oauth"], signal, loginTimeoutMs, {
+        helpArgv: ["login", "--help"],
+        option: "--oauth",
+      })
     },
     logout({ signal } = {}) {
       return runAction(["logout"], signal, logoutTimeoutMs)
@@ -103,6 +118,20 @@ export function createOfficialCliAuth({
   })
 }
 
+function isGrokVersionOutput(output) {
+  return typeof output === "string" && /^grok [^\r\n]+$/u.test(output.trim())
+}
+
+function hasCliOption(output, expectedOption) {
+  if (typeof output !== "string" || typeof expectedOption !== "string") return false
+  return output.split(/\r?\n/u).some((line) => {
+    const trimmed = line.trimStart()
+    if (!trimmed.startsWith("-")) return false
+    const optionColumn = trimmed.split(/\s{2,}/u, 1)[0]
+    return optionColumn.split(/[\s,]+/u).includes(expectedOption)
+  })
+}
+
 function createDeadline(callerSignal, timeoutMs) {
   const controller = new AbortController()
   const abortFromCaller = () => controller.abort(callerSignal.reason)

package/docs/03-security-threat-model.md

@@ -17,7 +17,7 @@ Web renderer / TUI
   ▼
 Host AuthCoordinator
   ├─ OfficialGrokLoginBridge
-  │    └─ path/version-constrained ~/.grok/bin/grok[.exe] login --oauth
+  │    └─ path/capability-constrained ~/.grok/bin/grok[.exe] login --oauth
   │         ├─ 标准配置：系统浏览器与 xAI OAuth
   │         ├─ 有效配置也可能选择 external helper / devbox / 企业 OIDC
   │         ├─ CLI 自己的代理、托管配置同步与遥测
@@ -56,7 +56,7 @@ Host AuthCoordinator
 | billing 响应或 credential metadata 越界进入 renderer | 身份、订阅或凭据泄漏 | Host 严格抽取百分比、周期与模型 capability；拒绝/忽略 identity、balance、history、headers、URL 和原始响应 | P0 |
 | token 到期被误标为额度重置 | 错误产品决策、误导用户 | 重置时间只接受 billing period end；credential `expires_at` 不进入 dashboard DTO | P0 |
 | 凭据轮换期间读到半写文件 | 认证失败或旧 token 重放 | 只接受完整 JSON；短退避重读；不写回；已发送请求不自动重放 | P1 |
-| CLI 更新改变协议或文件格式 | 静默错误 | 登录前后重查 realpath/identity/version；只允许发布时冻结的有限精确版本集合，未知更高/更低版本都失败；CLI 自身更新行为属于 vendor boundary | P1 |
+| CLI 更新改变命令或凭据格式 | 静默错误 | 登录前重查 realpath/identity；版本只作有界诊断；探测 `login --help` 的独立 `--oauth` 选项；登录后重验生产 OIDC 凭据契约与固定服务端 codec；CLI 自身更新行为属于 vendor boundary | P1 |
 | 未授权复用官方/第三方 OAuth Client ID | 客户端冒充、封禁或条款违约 | 包中不存在独立 OAuth client；只调用官方 CLI 的公开登录命令 | P0 |
 | 恶意 device-flow URI/code | 用户被引向钓鱼站或 token 被劫持 | discovery 与 device/token/revoke endpoint 全部固定；verification URI 只允许 `https://auth.x.ai` 精确路径；device_code 永不进入 renderer | P0 |
 | 凭据 generation/账号目录混用 | 把请求发到错误账号 | 每次 prepare 冻结 auth generation；catalog、lease、logout、401 都绑定同一 generation；禁止 silent fallback | P0 |
@@ -80,6 +80,7 @@ macOS 官方默认路径可能是 symlink；验证时允许 symlink，但 `realp
 | 用户动作 | 可执行参数 | 说明 |
 |---|---|---|
 | 检查版本 | `--version` | 10 秒、16 KiB 输出上限 |
+| 探测浏览器登录 | `login --help` | 只确认独立 `--oauth` 选项，不执行登录 |
 | 浏览器登录 | `login --oauth` | 标准配置下官方 CLI 打开浏览器并处理 callback |
 | 退出 | `logout` | 官方 CLI 删除自己的凭据 |
 
@@ -104,7 +105,7 @@ macOS 官方默认路径可能是 symlink；验证时允许 symlink，但 `realp
 
 官方 loopback 登录可能先清除旧 credential，取消/失败也可能使共享会话失效；成功后 CLI 还可能同步 managed config 或发送其自身已启用的遥测。插件无法撤销这些官方副作用。登录前 UI 必须提示，`logout` 必须经前台用户确认，且会影响所有共享同一 `GROK_HOME` 的应用。
 
-“插件不自动更新”只约束本插件；官方 CLI 自身的更新检查/替换仍属于 vendor boundary。登录前后必须重新解析 executable identity 与版本，若发生变化或落出已测集合，凭据状态失败关闭并要求重新验证兼容性。
+“插件不自动更新”只约束本插件；官方 CLI 自身的更新检查/替换仍属于 vendor boundary。版本输出仅用于有界诊断，不能充当信任证明。每次动作仍重新解析 executable identity；登录还必须通过命令能力探测，并在完成后重新验证生产 OIDC 凭据契约。任何检查失败都不得回退到 PATH、其他命令、shell 或非生产凭据。
 
 ### 状态机
 
@@ -144,7 +145,7 @@ type PublicAuthStatus = {
 - `1.0.5` 的真实 `auth.json` 同时包含 refresh token。Host 对文件的有界读取会短暂接触包含它的原始字节；实现不得缓存、使用、记录或写回 refresh token，解析后只保留闭合校验元数据与短期 access-token lease。该约束缩短暴露窗口但不构成进程级隔离。
 - 文件路径只由 OS home、官方 `GROK_HOME` 约定和 Host 环境解析；UI 不可选择路径。
 - 读取前后检查文件元数据，降低替换竞态；解析失败时不保留部分值。
-- 生产 OIDC schema 候选筛选必须版本化：顶层对象有界且只有一个候选；map key 等于规范化 issuer 与 client ID 组合；`auth_mode === "oidc"`；issuer 精确等于该固定 CLI 版本的 xAI 生产 issuer；scope、client ID、access token 和 `expires_at` 关系闭合。拒绝 external、api_key、web_login、legacy scope、企业 issuer、多候选和未知关键模式。最终字段和值必须在协议 spike 绑定到精确 CLI tag/commit，不能长期依赖 mutable `main`。
+- 生产 OIDC schema 候选筛选必须契约化：顶层对象有界且只有一个候选；map key 等于规范化 issuer 与 client ID 组合；`auth_mode === "oidc"`；issuer 精确等于 xAI 生产 issuer；scope、client ID、access token 和 `expires_at` 关系闭合。拒绝 external、api_key、web_login、legacy scope、企业 issuer、多候选和未知关键模式。安全关键字段的变更必须重新评审；不影响既有语义的附加字段可以忽略。
 - 上述 metadata 未签名，官方源码也只把 auth mode/issuer 当 provenance/debug hint；它不是密码学 trust assertion。插件在信任官方 CLI 与当前用户凭据目录的前提下做本地失败关闭，真实 bearer 最终由固定 xAI Proxy 服务端验证。
 - access token 只在 Host 内存使用；缓存采用短生命周期并可显式清空。Host 有界读取完整 JSON 时原始 buffer/string 可能瞬时包含 refresh token；解析器不提取、不缓存、不使用、不返回、不记录、不写回该字段，且 JavaScript 内存不承诺可靠清零。
 - 解析 `expires_at` 并使用固定 skew 在发送前拒绝过期/将过期凭据。只有 issuer、client ID、scope 与 schema 全部匹配而时间失效时，才 single-flight 启动固定 `grok models`；OAuth refresh 状态机和文件写回仍由官方 CLI 完成。刷新后必须重新读取并完整校验，只重试一次。

package/docs/05-test-plan.md

@@ -7,7 +7,7 @@
 - 所有本地模拟服务使用随机 loopback 端口，不访问真实第三方。
 - 真实账号 smoke 只在发布候选上人工执行，记录脱敏结果。
 - `0.1.0` 发布前必须通过 macOS arm64 真机与 macOS/Windows 自动化矩阵；Windows x64 首次真机验证在发布后对 Registry 精确版本执行，验证前对外标注“代码支持、真机未验证”。
-- `0.1.1` 及后续版本不要求每次重复真机验证；自动化矩阵、契约测试、干净安装和 tarball 校验是常规发版门禁。
+- `0.1.1` 及后续版本不要求每次重复真机验证；自动化矩阵、契约测试、干净安装和 tarball 校验是常规发版门禁。认证流程、平台 subprocess seam 或安全契约发生变化的版本仍须做对应平台的定向真机验证。
 
 ## 2. Gate 0：方案确认
 
@@ -22,7 +22,7 @@
 - macOS 在标准 Grok 配置下从 Harness Host 启动 `grok login --oauth`，默认浏览器成功打开。
 - Windows 在标准 Grok 配置下从 Harness Host 启动 `grok.exe login --oauth`，默认浏览器成功打开。
 - 插件到 CLI 的 `ctx.subprocess` argv 不经 shell，不需要用户另开 Terminal/PowerShell；不声称官方 CLI 及其后代端到端无 shell。
-- 锁定并记录精确 Grok CLI 版本、官方 tag/commit 与可用的 `SOURCE_REV`；auth flow/schema/Proxy 依据使用该版本永久链接，不以 mutable `main` 作为发布证据。
+- 记录验收所用 Grok CLI 版本、官方 tag/commit 与可用的 `SOURCE_REV`；版本只用于复现和诊断。兼容性由可执行文件、命令能力、生产 OIDC 凭据契约与固定服务端 codec 共同决定，不以完整版本字符串作为 allowlist。
 - 标准配置成功后凭据由官方 CLI 管理；验证“已有会话→重新登录取消/失败”可能清除旧会话、成功后的 managed-config sync，以及 logout 会影响共享 `GROK_HOME` 的其他应用。
 - 取消、5 分钟超时、CLI 非零退出和 Harness 卸载都会终止并等待 Harness seam 可观察的受管进程树；单独记录官方 CLI 主动脱离的后代和系统浏览器。
 - stdout/stderr 不进入 UI、session log 或普通日志。
@@ -54,7 +54,9 @@
 - Windows reparse point、目录、设备文件和非 `.exe` 候选失败。
 - 相对或 UI/RPC 提供的 `GROK_HOME` 失败；只接受 Host 启动时冻结的绝对值。
 - workspace/PATH 中的假 `grok` 不会被选中。
-- `--version` 超时、超限、非零退出、畸形版本，以及不在发布冻结有限精确版本集合中的更低/更高版本都失败。
+- `--version` 超时、超限、非零退出、stderr 非空或非单行 `grok ...` 输出失败；合法的未知版本输出不得仅因版本号不同而失败。
+- 登录前 `login --help` 必须成功并包含独立 `--oauth` 选项；缺失、畸形、超时、超限或非零退出时不得启动 `login --oauth`。
+- 覆盖 macOS `grok 1.0.5 (5115b46bc909)` 与 Windows `grok 0.2.82 (6d0b07d2de) [stable]` 的真实输出形状，并断言两者都能在能力存在时进入固定登录 argv。
 - 登录期间 symlink/文件 identity/version 改变，或官方 CLI 自更新到未测试版本时失败关闭；不把 vendor updater 误记成插件下载安装。
 - 路径/owner/version 检查不得在 UI 中宣称已密码学证明 publisher；从非官方安装入口取得的候选不在支持范围。
 
@@ -221,4 +223,4 @@ Web 与 TUI 分别验证：
 - Windows x64 自动化平台测试通过，且 README、release notes 和 marketplace 元数据在首次真机验证前明确披露“代码支持、真机未验证”。
 - npm 回读的 SHA-512 与本地发布 tarball 一致。
 
-`0.1.0` 发布后必须完成一次 Windows x64 Registry 精确版本的 production inspector、浏览器登录、聊天与工具调用 smoke，并记录结果。`0.1.1` 及后续版本以 CI/契约/安装/制品校验为常规门禁；认证流程、官方 CLI 版本、Harness subprocess seam 或平台安全策略发生变化时建议定向真机验证，但默认不阻断发版。
+`0.1.0` 发布后必须完成一次 Windows x64 Registry 精确版本的 production inspector、浏览器登录、聊天与工具调用 smoke，并记录结果。`0.1.1` 及后续版本以 CI/契约/安装/制品校验为常规门禁；认证流程、Harness subprocess seam 或平台安全策略发生变化时必须定向真机验证。`0.1.2` 正在修复 Windows 登录门禁，须从候选包完成 Windows 浏览器登录、凭据复验、模型刷新和最小对话后才能获得发布授权。

package/docs/06-release-plan.md

@@ -128,7 +128,7 @@ patch 路径必须为不含 `..`、绝对路径、反斜线或 NUL 的相对 `.y
 
 ## 7. Git 与版本
 
-- `0.1.0` 历史开发分支：`yukiryou/v0.1.0`；当前下一版本分支：`yukiryou/v0.1.1`。
+- `0.1.0` 历史开发分支：`yukiryou/v0.1.0`；当前版本分支：`yukiryou/v0.1.2`。
 - `package.json`、CHANGELOG、release notes、Git tag 和 tarball 必须使用同一个精确候选版本。
 - 发布提交必须干净且可复现。
 - tag 使用 `v<major>.<minor>.<patch>`，只在发布提交确定后创建。
@@ -137,6 +137,10 @@ patch 路径必须为不含 `..`、绝对路径、反斜线或 NUL 的相对 `.y
 
 `0.1.0` 发布后，后续版本从已发布基线 `yukiryou/main` 创建 `yukiryou/v<next-version>`。普通开发、文档、测试和发布准备都停留在版本分支；只有仓库所有者明确开始该版本发布时才合并回发布基线并创建不可变 tag。
 
+### 7.1 预发行版本政策
+
+`0.1.2-rc.1` 是一次历史预发行尝试。仓库所有者决定从稳定 `0.1.2` 起不再发行新的预发行版本；已发布 RC 保留为不可变历史记录，不覆盖、不删除，也不作为后续开发基线。正式版发现缺陷时直接创建下一递增稳定版本分支并按完整发布门禁修复。
+
 ## 8. 发布方式
 
 优先从公开 GitHub 仓库的 GitHub-hosted runner 使用 npm provenance 发布。
@@ -145,9 +149,9 @@ patch 路径必须为不含 `..`、绝对路径、反斜线或 NUL 的相对 `.y
 
 CI 使用的官方 GitHub Actions 必须固定到已核对的完整 commit SHA；不得依赖可移动 major tag 作为发布门禁实现。
 
-长期发布工作流接受严格稳定版 tag `v<major>.<minor>.<patch>` 和该 GitHub Release tarball 的 base64 SHA-512。工作流必须：
+长期发布工作流只接受严格稳定 tag `v<major>.<minor>.<patch>` 和对应 GitHub Release tarball 的 base64 SHA-512。工作流必须：
 
-1. 从 tag 派生版本和唯一产物名，不接受 prerelease、build metadata、路径字符或自由格式文件名。
+1. 从 tag 派生版本和唯一产物名；不接受 prerelease、build metadata、路径字符、自由格式文件名或调用者指定 dist-tag。
 2. 只下载对应 GitHub Release 的 `dsh-grok-provider-<version>.tgz`。
 3. 在发布前核对输入 SHA-512，以及 tarball 内的 name、version 和 canonical repository。
 4. 使用 Node 24、固定 npm CLI 版本、GitHub-hosted Ubuntu runner、`environment: npm` 和 `id-token: write`。
@@ -185,7 +189,7 @@ scoped 包首次公开发布必须保留 `--access public`。
 npm 发布不会自动成为受管可安装项。`0.1.0` 当前发现状态：
 
 - GitHub 仓库已添加 DeepSeek Harness 官方推荐的 `dsh-plugin` 与 `dsh` Topics，可被 Topic 驱动来源发现。
-- YukiRyou curated catalog 已加入精确 `dsh-grok-provider@0.1.0`，只标记完成真实验收的 `darwin-arm64`。
+- YukiRyou curated catalog 已加入精确 `dsh-grok-provider@0.1.0`，只标记完成真实验收的 `darwin-arm64`。`0.1.1` 是文档与发布流程修正版，按仓库所有者决定不重复真机；catalog schema 又只允许精确版本 `installed` 语义，因此条目保持 `0.1.0`，不把制品校验或模块加载冒充受管 Harness 真机安装。
 - 公共 `awesome-dsh-plugin` curated 目录要求仓库创建满 1 天且至少 10 个提交；提交数已满足，需在年龄门槛满足后提交外部 PR。
 - Windows x64 仍需对 Registry 精确 `0.1.0` 完成首次 production inspector、安装、重启、浏览器登录、聊天、工具调用和重新认证；完成前保持“代码支持、真机未验证”。
 

package/docs/09-implementation-status.md

@@ -1,14 +1,16 @@
 # 当前实现与发布状态
 
+稳定 `0.1.2` 已获得直接发布授权。仓库所有者决定不再发行预发行版，正式版缺陷通过新的递增稳定版本修复。Windows x64 有代码与 CI 覆盖，但独立真机验收不再阻断 `0.1.2`，该限制在 README 与 Release 中公开披露。
+
 状态日期：2026-08-26
-当前发布线：`dsh-grok-provider@0.1.1`
-发布分支：`yukiryou/v0.1.1`
+当前发布线：`dsh-grok-provider@0.1.2`
+下一版本分支：发布后创建 `yukiryou/v0.1.3`
 
 ## 已实现
 
 - 原创 Host provider、固定 Grok Build transport、动态账号模型目录和严格 Responses SSE codec。
 - 文本、reasoning、usage、`stop|tool-calls|max-tokens`、函数调用/结果、多轮历史和加密 reasoning replay。
-- 官方 CLI 单路径：固定默认路径、精确 `1.0.5 (5115b46bc909)`、受控 cwd/环境、固定 argv、无 shell spawn、10 秒准备期限、5 分钟登录期限、2 分钟退出期限、整棵进程树取消与异步卸载等待；`grok login --oauth` 负责打开浏览器和持久化 token，CLI 退出 0 后插件再次校验生产 OIDC credential schema。
+- 官方 CLI 单路径：固定默认路径、版本仅作有界诊断、登录能力探测、受控 cwd/环境、固定 argv、无 shell spawn、10 秒准备期限、5 分钟登录期限、2 分钟退出期限、整棵进程树取消与异步卸载等待；`grok login --oauth` 负责打开浏览器和持久化 token，CLI 退出 0 后插件再次校验生产 OIDC credential schema。
 - 包中不存在独立 OAuth client identity、device flow、插件实现的 refresh/revoke、Harness credential grant 或模式选择接口；过期 access token 只通过 single-flight、30 秒有界的官方 CLI `models` 命令续期，插件不提取 refresh token、不执行 refresh grant、不写凭据文件。ADR-0003 已由 ADR-0005 取代。
 - Web：Harness settings section、中文/英文、loopback-only RPC、登录状态轮询、陈旧 session 防护、取消和二次退出确认；新增参考 Harness 信息层级的账户卡、真实 billing 周期/重置时间和动态模型 capability 卡。完整类型化周期可恢复 proto3 省略的零使用率，其他缺失百分比仍显示未知；renderer 不接触 token 或 identity。
 - TUI：闭合 `/grok status|login|cancel|logout` grammar，`recordInput:false`，不输出 CLI 原文或 token。
@@ -16,7 +18,7 @@
 
 ## 已验证
 
-- Node 完整构建/测试通过：57 项，55 pass、0 fail、2 项 Windows-only 在 macOS 按预期跳过并由 CI matrix 承接。
+- Node 完整构建/测试通过：60 项，58 pass、0 fail、2 项 Windows-only 在 macOS 按预期跳过并由 CI matrix 承接。
 - `npm audit --omit=dev`：0 vulnerability。
 - 新认证接口的本地候选已安装到隔离的 Harness `0.1.1-rc.2` TUI/Web profile。真实 TUI 的缺失凭据 `unavailable`、`/grok login` 浏览器跳转、官方 CLI 登录成功和有效凭据 `ready` 均通过。真实 Web 的 client bundle 发现、Grok 设置页、登录启动/取消、Host 重启和临时 profile 卸载均通过；rc.2 scanner 所需的 `./package.json` 导出已加入回归测试。
 - Web/TUI 的 `available` 现在实际验证官方 credential contract，不再把 credential source 已注册误报为 ready；缺失凭据的真机 Web/TUI 双向验证通过。
@@ -50,3 +52,12 @@
 Windows x64 真机不再是 `0.1.0` 预发布阻断项。首次发布后必须从 Registry 安装精确 `0.1.0`，完成官方安装物 Authenticode/hash、浏览器登录、取消/超时/卸载、动态全部模型、聊天、reasoning replay、工具调用和 production inspector；完成前对 Windows 保持“代码支持、真机未验证”标识。`0.1.1` 及后续版本不要求重复真机验证，以两平台 CI、契约测试、干净安装和制品校验作为常规门禁。
 
 仓库所有者已于 2026-08-26 明确授权发布精确 `dsh-grok-provider@0.1.1`。该版本只修正发布事实与长期发布流程，不改变运行时协议或能力边界。
+
+## `0.1.1` 发布结果
+
+- 受保护 PR #3 合并后的 release commit 为 `a973828bcdd906836b68018f7592e73f769f9c3e`，`v0.1.1` 精确指向该 commit。
+- GitHub Release 采用中文在前、英文在后且正文不重复版本标题，只附加唯一 `dsh-grok-provider-0.1.1.tgz`。
+- 正式 tarball 为 48 个文件、93,992 bytes；SHA-256 为 `9bcd2362af369ace69763cfed11d843d9574a43b134c7e194e589750ba4081c7`，npm SRI 为 `sha512-O2Rh21NBZkqwXu7iUWKi8OwKzZaOHZ5sB0+Ny0w9VYgxXzVRXWHtsPfqmz4EpY6Cn8kSBsiJ3jVOJT/UQpEFKw==`。
+- Trusted Publisher OIDC workflow run `32936282879` 发布成功；npm `latest` 指向 `0.1.1`，provenance 绑定 canonical repository、`release.yml`、`yukiryou/main` 与上述 release commit。
+- Registry 重新下载文件与本地/GitHub Release 候选逐字节一致；9 个 Registry 签名与 1 个 provenance attestation 验证通过；npm 页面 README 已回读为 `0.1.1` 最终公开状态。
+- YukiRyou catalog 仍精确保留已完成受管 Harness 真机安装的 `0.1.0`。其 schema 不允许把仅完成完整性、provenance、Node 24 干净安装和模块加载的 `0.1.1` 标成 `installed`；遵循“不重复真机验证”决定，因此不做虚假升级。

package/docs/10-release-checklist.md

@@ -2,6 +2,8 @@
 
 本文件是每个 npm 版本的强制发布门禁。准备者必须从版本分支逐项完成并保存证据；未全部关闭前不得合并发布基线、创建最终 tag、发布 GitHub Release 或执行 `npm publish`。发布还需要仓库所有者明确授权，检查表全绿本身不构成发布授权。
 
+`0.1.2-rc.1` 是历史上唯一一次预发行尝试。从稳定 `0.1.2` 起不再发行预发行版本；正式版缺陷通过新的递增稳定版本修复。下列稳定版完整合并门禁适用于所有后续发布。
+
 ## 每版发布前
 
 - [ ] 冻结精确稳定版本，并同步 `package.json`、CHANGELOG、中英文 README、release notes 和候选文件名。
@@ -47,7 +49,27 @@
 - [x] 本地完整测试 57 项通过（55 pass、2 项 Windows-only 按预期跳过），`npm audit --omit=dev` 为 0 vulnerability，GitHub macOS/Windows CI 均通过。
 - [x] 从提交 `d35bda3402db5b16edd83d81420f1068006254a8` 生成预审 tarball；48 个文件、93,652 bytes，SHA-256 `bdaf7c32a22afd74e1c526e07c91f441942fedab3e0d34c01134fedda6e323b9`，SRI `sha512-ENpeVSsHDiByG6Cf03pl1j4eRHAsYQkrwU4sVAMct4D2aFXoZoFTivP0ZpwaM1tzD0NdXlPzlLdtlSd0F48wCw==`；同一文件在全新临时目录完成 peer 安装、manifest 回读与 Host 模块加载。
 - [x] 仓库所有者于 2026-08-26 明确授权发布精确 `dsh-grok-provider@0.1.1`；README/状态页已切换为最终公开事实，CHANGELOG 日期已冻结。
-- [ ] 从最终 release commit 生成并验收唯一发布 tarball；预审 tarball 不进入 Release。
-- [ ] 完成 GitHub Release、OIDC npm 发布和 Registry/provenance 回读。
+- [x] 从最终 release commit `a973828bcdd906836b68018f7592e73f769f9c3e` 生成并验收唯一发布 tarball；预审 tarball 未进入 Release。正式制品 48 个文件、93,992 bytes，SHA-256 `9bcd2362af369ace69763cfed11d843d9574a43b134c7e194e589750ba4081c7`，SRI `sha512-O2Rh21NBZkqwXu7iUWKi8OwKzZaOHZ5sB0+Ny0w9VYgxXzVRXWHtsPfqmz4EpY6Cn8kSBsiJ3jVOJT/UQpEFKw==`。
+- [x] GitHub Release、Trusted Publisher OIDC npm 发布、Registry 逐字节回读、签名与 provenance 验证全部完成；npm `latest` 指向 `0.1.1`。
 
 English summary: every release must close documentation, security, tests, deterministic artifact, bilingual release notes, OIDC identity, integrity, and post-publish readback gates before publication. A green checklist never replaces explicit owner approval.
+
+## `0.1.2-rc.1` 预发行记录
+
+- [x] 使用版本分支 `yukiryou/v0.1.2`，不提前合并稳定基线。
+- [x] Windows `0.2.82` 回归、macOS/Windows CI、生产依赖审计与 dry-run 打包通过。
+- [x] 仓库所有者明确授权发布精确 `dsh-grok-provider@0.1.2-rc.1` 到 npm `next`；未授权稳定 `0.1.2`。
+- [x] 从提交 `6e6201734cab1d8b7d4aa88535b3a3e7e02376ea` 冻结唯一预发行 tarball并附加到 GitHub prerelease：51 个文件、99,559 bytes，SHA-256 `b47d3de72ddb718159d0ede5d2a3e0e1c91b09900134bb48951d82cb93ac489e`，SRI `sha512-NpmuJYvsqnpaupChDfwumOZ69ikwXc8pg/CZqnbGJwpVFy/Y05/QT9q99pj33ON5u8sp1pm0uAzGmC1Db8Qg6Q==`。
+- [x] Trusted Publisher run `32956881639` 从不可变 `v0.1.2-rc.1` 标签发布成功；Registry 回读确认 `next=0.1.2-rc.1`、`latest=0.1.1`，重新下载文件逐字节一致，1 个 Registry 签名与 1 个 provenance attestation 验证通过。
+- [ ] Windows x64 从 npm 精确预发行版本完成浏览器登录、凭据复验、模型刷新与最小对话。
+
+仓库所有者随后终止预发行验收路线并授权直接发布稳定 `0.1.2`；上述未完成项保留为历史事实，不转写为已验收。
+
+## `0.1.2` 发布记录
+
+- [x] 仓库所有者明确授权直接发布精确稳定 `dsh-grok-provider@0.1.2`，Windows 独立真机验收不再作为阻断项。
+- [x] 仓库所有者决定以后不再发行预发行版；正式版缺陷使用新的递增稳定版本修复。
+- [x] 中英文 README、正式 Release 说明、安全状态和发布政策已同步，并公开披露 Windows 独立真机尚未完成。
+- [x] 稳定 manifest、稳定版专用 Trusted Publisher workflow、完整测试、审计与双平台 CI 通过；CI run `32980619235` 的 macOS 14 与 Windows 2022 job 均成功。
+- [ ] 版本分支经 PR 合并 `yukiryou/main`，从 release commit 冻结唯一稳定 tarball与不可变 `v0.1.2` tag。
+- [ ] GitHub Release、npm `latest`、Registry 逐字节回读、签名与 provenance 验证完成。

package/docs/README.md

@@ -1,8 +1,8 @@
 # Grok Build Provider 文档索引
 
-- 状态：**`0.1.1` 发布线已冻结：修正发布事实，并启用长期 npm Trusted Publisher OIDC 流程**
-- 当前版本：`0.1.1`
-- 发布分支：`yukiryou/v0.1.1`
+- 状态：**稳定版 `0.1.2`：Windows Grok CLI 兼容性修正**
+- 当前稳定版本：`0.1.2`
+- 下一版本分支：发布后创建 `yukiryou/v0.1.3`
 - 兼容基线：DeepSeek Harness `0.1.1-rc.2`
 - 目标平台：macOS arm64、Windows x64
 
@@ -13,7 +13,7 @@
 首版采用单一认证路线：插件发起官方 Grok Build CLI 浏览器登录并复用由官方 CLI 持久化的会话。插件不注册独立 OAuth client，也不持久化第二份 token。
 
 1. 用户在 Harness 设置页点击“使用 Grok 登录”，或在 TUI 输入 `/grok login`。
-2. 插件 Host 通过 Harness `ctx.subprocess` 以固定 argv 启动经路径/版本约束的 Grok CLI 候选；该启动层不经过 shell。标准配置下由官方 CLI 完成系统浏览器、OAuth、loopback callback 和凭据写入。
+2. 插件 Host 通过 Harness `ctx.subprocess` 以固定 argv 启动经路径、能力与凭据契约约束的 Grok CLI 候选；该启动层不经过 shell。标准配置下由官方 CLI 完成系统浏览器、OAuth、loopback callback 和凭据写入。
 3. 插件只读官方凭据文件并接受绑定 schema；token 不进入 renderer、settings、RPC、本插件日志或 workspace。
 4. 模型目录只请求固定 `GET /v1/models`；推理按目录中经过验证的 `api_backend` 选择闭合 endpoint。当前真实模型都走固定 `POST /v1/responses`；拒绝重定向和自定义 endpoint。
 5. 模型目录从固定 `/v1/models` 动态发现账号当前可用的全部 Grok Build 模型；本机当前快照为 `grok-4.6` 与 `grok-4.5`。
@@ -38,16 +38,19 @@
 - [当前实现与发布状态](./09-implementation-status.md)
 - [逐版发布检查表](./10-release-checklist.md)
 - [v0.1.1 中英双语发行说明](./releases/v0.1.1.md)
+- [v0.1.2 中英双语发行说明](./releases/v0.1.2.md)
+- [v0.1.2-rc.1 中英双语预发行说明](./releases/v0.1.2-rc.1.md)
 - [ADR-0001：认证与传输路线](./adr/0001-auth-and-transport-route.md)
 - [ADR-0002：首版能力边界](./adr/0002-v0.1-scope.md)
 - [ADR-0003：已被取代的双认证设计](./adr/0003-dual-authentication.md)
 - [ADR-0004：动态全模型目录](./adr/0004-dynamic-model-catalog.md)
 - [ADR-0005：官方 CLI 单一认证路径](./adr/0005-official-cli-only-authentication.md)
 - [ADR-0006：账户额度与模型能力面板](./adr/0006-account-dashboard.md)
+- [ADR-0007：以能力与凭据契约判断 CLI 兼容性](./adr/0007-capability-based-cli-compatibility.md)
 
 ## 开发门禁
 
-`0.1.0` 首发后的 Registry 完整性、provenance、Trusted Publisher 与凭据撤销均已完成。首发 tarball 内 README 与部分状态文档的预发布措辞由 `0.1.1` 递增版本纠正。后续版本必须先完成[逐版发布检查表](./10-release-checklist.md)，再由仓库所有者明确授权发布。Windows x64 首次真机验证仍按约定作为首发后跟进，完成前标注“代码支持、真机未验证”。
+`0.1.2-rc.1` 是唯一一次预发行尝试。仓库所有者决定直接发布稳定 `0.1.2`，以后不再发行预发行版；正式版缺陷通过新的递增稳定版本修复。Windows 独立真机验收不阻断本次发布，但其未完成状态必须公开披露。后续版本仍须先完成[逐版发布检查表](./10-release-checklist.md)，再由仓库所有者明确授权发布。
 
 ## 官方依据
 

package/docs/adr/0005-official-cli-only-authentication.md

@@ -3,6 +3,7 @@
 - 状态：Accepted
 - 日期：2026-08-26
 - 取代：ADR-0003 在 `0.1.0` 中关于 `managed-device`、插件持久化 OAuth grant 和双认证选择的决定
+- 修订：ADR-0007 从 `0.1.2` 起把精确版本门禁改为能力与凭据契约门禁
 
 ## 背景
 

package/docs/adr/0007-capability-based-cli-compatibility.md

@@ -0,0 +1,41 @@
+# ADR-0007：以能力与凭据契约判断 Grok CLI 兼容性
+
+- 状态：Accepted
+- 日期：2026-08-26
+- 修订：ADR-0005 中“精确版本约束”的部分；官方 CLI 单一路线保持不变
+
+## 背景
+
+`0.1.1` 在每次认证动作前把 `grok --version` 的完整输出与
+`grok 1.0.5 (5115b46bc909)` 做逐字匹配。Windows 真机安装的官方 Grok Build CLI
+`0.2.82` 能正常执行 `grok login --oauth`，但插件在版本检查阶段提前失败，浏览器因此不会打开。
+
+完整版本字符串只能说明一个构建标识，不能证明命令能力、凭据来源或服务端协议兼容性。把它作为唯一门禁还会让官方 CLI 的兼容更新无条件破坏登录。
+
+## 决定
+
+从 `0.1.2` 起，不再维护 Grok CLI 完整版本 allowlist。认证模块保留小接口
+`login`、`logout`、`refresh`，并在内部完成以下检查：
+
+1. 只解析官方默认 `~/.grok/bin/grok` 或 `%USERPROFILE%\.grok\bin\grok.exe`；继续校验绝对路径、realpath、普通文件、所有者/目录包含关系和 Windows reparse point。
+2. `grok --version` 必须在期限与输出上限内成功，并返回单行、可安全显示为诊断信息的 `grok ...` 文本；版本值不再决定兼容性。
+3. 登录前执行固定的 `grok login --help` 能力探测；只有成功返回独立的 `--oauth` 选项后，才允许执行固定 argv `grok login --oauth`。
+4. 所有命令继续通过 Harness subprocess seam、绝对 argv、固定 cwd、过滤环境、无插件显式 shell、输出上限、deadline 与进程树等待执行。插件不解析或转发 OAuth URL。
+5. CLI 退出成功不等于登录成功。认证 driver 必须重新读取官方凭据，并只接受 xAI 生产 issuer、官方 public client、`oidc` 模式、有效 access token/expiry 和无歧义候选。API key、external provider、企业 OIDC、自定义 endpoint 与不完整记录继续失败关闭。
+6. 模型、额度与推理仍由固定 HTTPS origin/path 及严格响应 codec 校验。未知 CLI 版本不能放宽这些网络约束。
+
+`logout` 与 `models` 保持固定命令；未知版本若不支持它们，会以非零退出安全失败，不回退到其他命令或 shell。未来若命令语义发生变化，新增相应能力探测和契约测试，而不是恢复完整版本硬锁。
+
+## 安全含义
+
+- “不固定版本”不等于信任 PATH 中任意 `grok`，也不等于接受任意 OAuth 凭据；可执行文件、命令能力、凭据契约和固定服务端校验缺一不可。
+- `login --help` 是兼容性探测，不是发布者或签名证明。用户仍须从 xAI 官方渠道安装 CLI。
+- 官方 `grok login` 会重新认证并替换共享缓存会话，`grok logout` 会清除该会话；这会影响共用同一 Grok home 的其他应用。UI 必须在登录和退出前披露该副作用。
+- 新字段可在不改变已验证语义时被忽略；认证模式、issuer、client、候选唯一性、token 与 expiry 等安全关键字段必须继续闭合校验。
+
+## 发布门禁
+
+- 自动化测试必须覆盖 macOS `1.0.5` 与 Windows `0.2.82` 的真实版本输出形状。
+- 必须覆盖：能力存在时进入 `login --oauth`；能力缺失、版本输出畸形、命令超时/超限/非零退出时不进入登录动作。
+- `0.1.2` 改动 Windows 登录安全路径，因此发布前需要 Windows x64 真机从候选包完成浏览器登录、凭据复验、模型刷新与一次最小对话。未经仓库所有者验收和明确发布授权，不得发布 npm 版本。
+

package/docs/releases/v0.1.2-rc.1.md

@@ -0,0 +1,41 @@
+## 中文
+
+这是 Windows 登录修复的公开验收预发行版。它发布到 npm `next`，不会替代稳定版 `0.1.1`。
+
+### 主要变化
+
+- 修复 Windows 官方 Grok Build CLI `0.2.82` 在打开浏览器前被完整版本硬锁拒绝的问题。
+- 登录前通过固定 `grok login --help` 探测独立的 `--oauth` 能力，再执行固定 `grok login --oauth`。
+- 保留官方默认路径、可执行文件身份、过滤环境、无插件显式 shell、输出/deadline 上限和进程树等待。
+- CLI 成功退出后仍严格复验 xAI 生产 OIDC 凭据；API key、external provider、企业 OIDC、自定义 endpoint 和歧义记录继续失败关闭。
+- Windows `0.2.82`、macOS 既有路径、能力缺失和畸形输出均有自动化回归覆盖。
+
+### 安装与验收
+
+```powershell
+npx --yes @deepseek-ai/dsh plugin --profile web add dsh-grok-provider@0.1.2-rc.1
+npx --yes @deepseek-ai/dsh web
+```
+
+也可以在已有桌面端插件安装入口中输入精确版本 `dsh-grok-provider@0.1.2-rc.1`。请验证浏览器登录、登录状态、模型刷新和一次最小对话。验收成功后仍会另行准备并授权稳定 `0.1.2`。
+
+## English
+
+This is the public Windows acceptance prerelease for the login fix. It is published under npm `next` and does not replace stable `0.1.1`.
+
+### Highlights
+
+- Fix the official Windows Grok Build CLI `0.2.82` being rejected by a complete-version lock before the browser could open.
+- Probe the independent `--oauth` capability with fixed `grok login --help`, then invoke fixed `grok login --oauth`.
+- Preserve official-default-path and executable-identity checks, scrubbed environment, no plugin-explicit shell, output/deadline bounds, and managed process-tree waiting.
+- After a zero exit, strictly revalidate the xAI production OIDC credential. API keys, external providers, enterprise OIDC, custom endpoints, and ambiguous records remain fail-closed.
+- Add automated regressions for Windows `0.2.82`, the existing macOS path, missing capability, and malformed output.
+
+### Install and accept
+
+```powershell
+npx --yes @deepseek-ai/dsh plugin --profile web add dsh-grok-provider@0.1.2-rc.1
+npx --yes @deepseek-ai/dsh web
+```
+
+You can also enter the exact `dsh-grok-provider@0.1.2-rc.1` version in an existing desktop plugin installer. Validate browser sign-in, authenticated status, model refresh, and one minimal chat. Stable `0.1.2` will still be prepared and authorized separately after acceptance.

package/docs/releases/v0.1.2.md

@@ -0,0 +1,55 @@
+## 中文
+
+`0.1.2` 修复 Windows 上官方 Grok Build CLI 已安装且可独立登录，但 Provider 在打开浏览器前立即显示“登录失败”的问题。
+
+### 主要变化
+
+- 删除对完整输出 `grok 1.0.5 (5115b46bc909)` 的硬编码登录门禁；Windows 官方 CLI `0.2.82` 不再仅因版本号不同被拒绝。
+- 登录前以固定 `grok login --help` 探测独立的 `--oauth` 能力，通过后才运行固定 argv `grok login --oauth`。
+- 保留官方默认路径、可执行文件身份、过滤环境、无插件显式 shell、输出与时间上限、进程树等待等安全控制。
+- CLI 返回成功后仍必须重新读取并严格验证 xAI 生产 OIDC 凭据；API key、external provider、企业 OIDC、自定义 endpoint 和歧义记录继续失败关闭。
+- 新增 Windows `0.2.82` 真实版本输出、能力缺失、畸形输出与 macOS 既有路径的回归测试。
+
+### 兼容性
+
+- DeepSeek Harness：`0.1.1-rc.2`
+- Grok Build CLI：不锁完整版本；必须来自官方默认 Grok home、提供 `login --oauth`，并产生受支持的生产 OIDC 凭据
+- macOS arm64：保留既有验收基线
+- Windows x64：代码与 Windows CI 支持；本次正式发布未完成独立真机验收，发现问题将通过新的递增稳定版本修复
+
+### 安装
+
+```sh
+dsh plugin --profile web add dsh-grok-provider@0.1.2
+dsh web
+```
+
+项目不再发行预发行版；正式版本出现缺陷时，将发布新的递增稳定版本。
+
+## English
+
+`0.1.2` fixes a Windows failure where the official Grok Build CLI was installed and could sign in directly, but the provider reported “Sign-in failed” before opening the browser.
+
+### Highlights
+
+- Remove the hardcoded login gate for the complete `grok 1.0.5 (5115b46bc909)` output. The official Windows CLI `0.2.82` is no longer rejected solely because its version differs.
+- Probe the independent `--oauth` capability with fixed `grok login --help` before invoking fixed argv `grok login --oauth`.
+- Preserve official-default-path and executable-identity checks, scrubbed environment, no plugin-explicit shell, output/deadline bounds, and managed process-tree waiting.
+- After a zero exit, reread and strictly validate the xAI production OIDC credential. API keys, external providers, enterprise OIDC, custom endpoints, and ambiguous records remain fail-closed.
+- Add regressions for the real Windows `0.2.82` version shape, missing capability, malformed output, and the existing macOS path.
+
+### Compatibility
+
+- DeepSeek Harness: `0.1.1-rc.2`
+- Grok Build CLI: no full-version lock; it must use the official default Grok home, provide `login --oauth`, and produce the supported production OIDC credential
+- macOS arm64: existing acceptance baseline retained
+- Windows x64: code and Windows CI supported; this stable release has not completed independent real-device acceptance, and any issue will be fixed in a new incremented stable version
+
+### Install
+
+```sh
+dsh plugin --profile web add dsh-grok-provider@0.1.2
+dsh web
+```
+
+The project no longer publishes prereleases. Defects in a stable version will be fixed in a new incremented stable release.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-grok-provider",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Clean-room Grok Build provider for DeepSeek Harness with official CLI browser authentication",
   "type": "module",
   "license": "MIT",