SuperGrok 订阅接入Kaizin0226/dsh-supergrok

dsh-supergrok

English

SuperGrok 订阅访问以及面向 DeepSeek Harness (DSH) 的 Grok 专用工程工作流。

dsh-supergrok 通过 OAuth 将你的 SuperGrok 账户连接到 DSH，并添加一个
针对 Grok 优化的模式，用于代码调查、实现和多步骤工作。
它将基于账户的模型选择、图像回忆和当前任务上下文
与 DSH 的原生工具、权限、会话和子代理相结合。

开发者预览 · Windows + Node.js 24 · 非官方实验性集成

核心功能

| 功能 | 提供内容 |
| --- | --- |
| DSH 中的 SuperGrok | 在 DSH 内使用你自己的账户登录，无需单独的 xAI API 密钥。从账户的实时目录中选择模型和推理选项。 |
| Grok 优化模式 | 一个面向工程的预设，包含用于理解意图、执行已授权工作、检查证据和沟通结果的明确规则。 |
| 跨对话的图像 | 为支持的模型准备图像附件，并在后续轮次中显式回忆已授权的历史图像。准备通知会保留在会话历史中。 |
| 当前工作状态上下文 | 从 DSH 的原生状态向 Grok 模式提供当前待办事项、活动后台作业和可继续的子代理工作。 |
| 配额和请求控制 | 查看只读的账户配额和缓存新鲜度。在发送推理请求之前检查取消、扩展策略和完整请求大小。 |

模型和图像的可用性取决于已认证账户的目录。
已实现的能力和已完成的验证在下方加以区分。

Grok 优化模式改变了什么

对于相同的 Grok 模型、提供商和推理强度，从本套件的本地 standard
切换到 grok-optimized 会改变角色指令，并
添加当前工作状态上下文。所有其他能力配置保持不变。
该模式适用于受益于明确执行纪律和未完成工作当前摘要的工程工作。

| 领域 | 本地 standard | grok-optimized |
| --- | --- | --- |
| 行为指令 | 标准编码代理角色 | 下文所述的专用工程规则 |
| 当前工作状态摘要 | 无套件工作状态上下文扩展 | 添加 dsh-grok-work-state-context |
| 原生工具、Skills、Plan、Goals 和子代理 | 通过 DSH 组合可用 | 相同的能力配置 |
| 图像输入/准备和历史回忆 | 共享套件支持 | 相同支持；并非 Grok 模式专属 |
| SuperGrok 目录、配额和请求预算 | 共享提供商支持 | 相同的提供商支持 |

角色规则明确要求：

- 意图和授权： 区分解释、诊断和实现；
在不扩大用户范围的情况下，将已授权的更改推进到验证阶段。
- 工具与证据： 优先使用可用的专用工具，在重试前先诊断失败原因，并且只有在 DSH 已将附件投递到支持其模态的路由时，才声称检查了附件。用证据验证完成情况，并重新核查可变事实，而不是将历史记忆当作当前状态。
- 长任务与委派： 保留真实的后台句柄，使用有界等待，并让父代理审查和协调子代理的结果。
- 交互与沟通： 当浏览器工具可用时，验证实际的 UI 交互；在受影响时检查桌面/移动端布局；披露缺失的检查；并以所要求的风格提供自包含的最终答案。

工作状态扩展会汇总当前会话中未完成的待办事项、正在运行或正在停止的作业，以及直接拥有的、活跃的、可继续的子代理，形成一份全新的摘要。完整贡献上限为 4096 UTF-8 字节，当没有活跃工作时为空。它为长时间运行的工作提供当前任务上下文，并在上下文压缩后支持继续；它不是新的长期记忆系统，也不会恢复不可用的历史状态。

该预设不会提高底层模型的智能，也不绑定某个 Grok 版本。不存在经过 A/B 验证的关于更高准确率或任务成功率、更快速度或更低成本的说法。DSH 继续执行权限并操作工具；行为指令并不保证模型会遵从。

全局默认值仍为 standard。此套件为本地 standard 和 grok-optimized 都添加了图像召回，每种模式挂载一次；工作状态上下文为 Grok 模式独有。上游 standard 两者皆无本地扩展。除非显式启用并配置了原生跨模型选择，否则子代理继承父模型。没有硬编码任何 Grok 模型。

Grok Build 设计参考

该设计借鉴了 Grok Build 的任务纪律、压缩后工作上下文的恢复以及图像流水线思路，并针对 DSH 进行了调整。DSH 自始至终掌控控制平面、会话、权限和工具循环。此套件不运行 Grok Build 或 ACP worker，也不采用 Grok Build 的身份或工具 schema。

来源出处和参考锁定将位于 37949780c144e37df692e3d669051a21fec24f20 的行为与图像设计评审，与位于 bc7f02eddd3d84085849dc19ed216f11c23b0571 的未更改协议参考区分开来。设计参考的更新并不构成对更新协议或实时服务的验证。适用的许可证和署名均予以保留。

预期工作流

- 调查并实现代码更改： 使用 DSH 的工具检查项目，厘清原因，并在相关检查的证据支持下完成所请求的更改。
- 继续涉及图像的工作： 讨论附加的截图或图表，
然后当早先的图像再次变得相关时，将其召回。
- 管理多步骤任务： 在继续任务的同时，使当前待办事项、活动作业和子代理工作可作为上下文使用。

这些示例描述的是受支持的机制和预期用途，而非实时服务验收结果。

开始使用

1. 使用 Windows，并配备 Node.js 24、Git 和 PowerShell。此预览版分发源代码以及构建/安装工具；它没有预编译下载或 npm 发布版本。
2. 按照 Windows 构建和安装指南 构建所需的 DSH 补丁，并将完整套件安装到单独的运行时目录中。安装默认为试运行。
3. 使用你的本地 HTTP 代理端点初始化一个新的数据目录。在登录前阅读服务访问要求。
4. 启动 DSH 并完成你自己的 SuperGrok OAuth 授权。从实时目录中选择模型和推理选项，然后在你需要专用工作流时选择 grok-optimized。

proxyUrl 是必需的。OAuth、目录、配额和推理使用同一个显式代理连接，没有系统代理查找或直接回退。支持的端点是位于数字 127.0.0.1 或 [::1] 上的未认证 HTTP 代理；缺失或无效的配置会在联网前失败。更改后重新加载提供程序。有关完整的配置规则，请参阅安装指南。

支持的组件

| 组件 | 版本 |
| --- | --- |
| DSH 上游 | 0.1.5-rc.2 |
| 四个从源代码构建的 DSH 核心包 | 0.1.5-rc.2.grok.1 |
| SuperGrok 提供程序 | 0.8.0-hardened.1 |
| Grok 预设 | 0.9.1 |
| 图像历史、召回和工作状态扩展 | 各为 1.2.0 |

使用完整组合：仅将提供程序安装到未打补丁的 DSH 中，并不能提供该套件的核心集成。确切的源代码提交、包版本和派生引用记录在组件锁和源代码来源中。

验证和限制

- 使用合成服务，干净构建、提供程序和扩展回归、预设派生、实际 Web/无头加载、TypeScript SDK 图像通知重放场景，以及可恢复的安装/回滚均已通过。请参阅验证范围和发布说明。
- 真实 OAuth、实时模型/图像推理和生产配额面板 UI 尚未在此预览版中验收。完整 SDK 覆盖、Python SDK 执行以及 macOS/Linux 支持不在已验证范围内。
- 使用新的运行时和数据目录。现有聊天不会自动迁移；还原运行时文件不会降级会话数据格式。
- 完整的序列化推理请求默认具有 40,000,000 字节的预算。过大的请求会在发送前被拒绝。图像召回使用
{attachmentId, occurrence?} 并遵循 DSH 的附件权限。
可选的请求边界事件允许扩展
拒绝请求或禁用其自动认证重放。
- 在 2026-09-13，provider、套件构建工具包和已安装运行时的 npm 审计
报告零已知漏洞。冻结的上游构建工作区
单独报告了 60 条咨询记录，其中包括 29 条高危记录。
在构建之前，请查阅依赖发现与构建约束，
包括保留的 pnpm 11.7.0 工具链。

本项目是独立且实验性的。源代码许可和成功
登录并不构成对第三方 OAuth 客户端的授权。服务
协议和账户资格可能会发生变化；请阅读服务访问审查。
预览版不附带任何可用性或生产支持承诺。

开发、许可与支持

参见贡献指南、发布政策和
私密安全报告。问题请使用最小化的合成复现；
请勿分享凭据、真实对话或账户截图。
维护为尽力而为。

保留原始 MIT 许可证、NOTICE 及适用的
Apache-2.0 署名。源代码许可不授予
订阅访问权。旧的 xAI API 合约
为历史参考，已从默认构建/安装路径中排除。

简体中文

将 SuperGrok 订阅接入 DeepSeek Harness（DSH），并提供面向工程任务的 Grok 优化模式。

dsh-supergrok 通过 OAuth 将你的 SuperGrok 账户接入 DSH，并为代码排查、功能实现和多步骤任务
提供专属 Grok 工作模式。项目将账户模型选择、历史图片召回和当前任务上下文，与 DSH 原生的工具、
权限、会话及子 Agent 协作机制结合。

开发者预览版 · Windows + Node.js 24 · 非官方实验性集成

核心功能

| 功能 | 提供的能力 |
| --- | --- |
| 在 DSH 中使用 SuperGrok | 在 DSH 内完成自己的账户授权，无需另配 xAI API key；从账户实时目录选择可用模型与推理档位。 |
| Grok 优化模式 | 提供面向工程任务的预设，明确理解意图、执行已授权工作、核实证据和说明结果的行为要求。 |
| 跨轮次图片使用 | 为支持图片的模型准备附件，并在后续对话中显式召回有权访问的历史图片；准备提示保留在会话历史中。 |
| 当前工作状态上下文 | 从 DSH 原生状态向 Grok 模式补充当前待办、活动后台任务和可继续的子 Agent 工作。 |
| 额度与请求控制 | 只读查看账户额度及缓存新鲜度；在发送推理前检查取消状态、扩展规则和完整请求大小。 |

模型与图片能力以账户认证后的实时目录为准。已实现功能与已完成验证的范围在下文分别说明。

Grok 优化模式改变了什么

在使用同一 Grok 模型、同一 provider 和推理档位时，从本套件的本地 standard 切换到
grok-optimized，实际改变的是 persona 行为规则，并增加当前工作状态上下文；其余能力配置保持一致。
该模式面向需要明确执行纪律、持续掌握未完成工作的工程任务。

| 对比项 | 本地 standard | grok-optimized |
| --- | --- | --- |
| 行为指令 | standard 编程 Agent persona | 下述专属工程任务规则 |
| 当前工作状态摘要 | 不含套件的工作状态上下文扩展 | 增加 dsh-grok-work-state-context |
| 原生工具、Skills、Plan、Goals 和子 Agent | 由 DSH 组合提供 | 能力配置相同 |
| 图片输入／准备与历史召回 | 套件共享支持 | 同样支持，不属于 Grok 模式独享 |
| SuperGrok 目录、额度和请求预算 | provider 共享支持 | 使用相同 provider 能力 |

Persona 规则显式要求：

- 意图与授权： 区分解释、诊断和实施；将已授权改动推进到验证完成，不扩大用户要求的范围。
- 工具与证据： 优先使用实际可用的专用工具，失败后先诊断再决定是否重试；仅在 DSH 已交付附件且
当前路由支持其模态时声称查看。以证据确认完成，核实易变事实，不将历史记忆当作当前状态。
- 长任务与委派： 保留真实后台任务句柄，采用有限等待，由父 Agent 复核子任务结果并整合分歧。
- 交互与沟通： 浏览器工具可用时验证真实 UI 交互，布局受影响时检查桌面和移动视口；
说明未完成的检查，按用户要求提供可独立理解的最终答复。

工作状态扩展每次重新汇总当前会话的未完成待办、运行或停止中的所属任务，以及直接拥有的、
仍活跃的可继续子 Agent。完整上下文最多 4096 个 UTF-8 字节，没有活跃工作时为空。
它为长任务和上下文压缩后的续接提供当前任务摘要，不是新增的长期记忆系统，也不恢复不可用的历史状态。

预设不提高底层模型本身的智力，也不绑定某个 Grok 版本；尚无 A/B 验证支持准确率、任务成功率、
速度或成本改善的承诺。权限执行和工具运行继续由 DSH 负责，行为指令不保证模型始终遵循。

全局默认仍为 standard。本套件为本地 standard 和 grok-optimized 各挂载一次图片召回，
工作状态上下文仅用于 Grok 模式；上游 standard 不含这两项本地扩展。
子 Agent 默认继承父模型，只有显式开放并配置原生跨模型选择后才允许另选模型，不写死 Grok 型号。

Grok Build 的设计参考范围

设计参考了 Grok Build 的任务纪律、压缩后工作上下文恢复及图片管线思路，并适配到 DSH。
控制面、会话、权限和工具循环始终由 DSH 所有；套件不运行 Grok Build 或 ACP worker，
也不采用 Grok Build 的身份或工具 schema。

源码来源和参考锁
分别记录行为与图片设计核对提交 37949780c144e37df692e3d669051a21fec24f20，以及保持不变的
协议参考提交 bc7f02eddd3d84085849dc19ed216f11c23b0571。更新设计来源不代表新协议或真实服务
已经通过验证；适用许可与署名继续保留。

典型用法

- 排查问题并实现改动： 使用 DSH 工具检查项目、定位原因，并根据用户的实施要求完成改动与相关验证。
- 继续处理图片相关任务： 讨论已上传的截图或示意图，在后续需要时再次召回先前图片。
- 推进多步骤任务： 在持续工作时，将当前待办、活动任务和子 Agent 工作作为可用上下文。

这些示例描述支持的机制和预期用途，不作为真实服务验收结果。

快速开始

1. 准备 Windows、Node.js 24、Git 和 PowerShell。本预览版提供源码及构建安装工具，不提供预编译下载或 npm 发行包。
2. 按照 Windows 构建与安装指南构建必需的 DSH 补丁，
将完整套件安装到独立运行目录。安装默认 dry-run。
3. 为新的数据目录配置实际使用的本地 HTTP 代理；登录前阅读服务接入要求。
4. 启动 DSH，完成自己的 SuperGrok OAuth 授权，从实时目录选择模型和推理档位；
需要专属工作模式时选择 grok-optimized。

proxyUrl 为必填配置。OAuth、目录、额度和推理共用同一显式代理连接，不读取系统代理、不直连回退。
支持无认证的 HTTP 代理，主机仅限数字地址 127.0.0.1 或 [::1]；未配置或配置非法时在联网前拒绝。
修改代理后需要重新加载 provider，完整配置规则见安装指南。

支持的组件组合

| 组件 | 版本 |
| --- | --- |
| DSH 上游 | 0.1.5-rc.2 |
| 四个源码构建的 DSH 核心补丁包 | 0.1.5-rc.2.grok.1 |
| SuperGrok provider | 0.8.0-hardened.1 |
| Grok 预设 | 0.9.1 |
| 图片历史、图片召回、工作状态扩展 | 均为 1.2.0 |

请使用完整组合：仅在未打补丁的原版 DSH 中安装 provider，无法获得本套件的核心集成功能。
精确源码提交、包版本及派生来源见组件锁和源码来源。

验证与已知限制

- 已使用合成服务完成干净构建、provider 与扩展回归、预设派生、实际 Web/headless 加载、
TypeScript SDK 图片准备提示回放专项，以及可恢复安装和回滚。详见验证范围
与发行说明。
- 本预览版尚未验收真实 OAuth、模型与图片推理，以及生产额度面板；完整 SDK、Python SDK 执行和
macOS／Linux 不属于已验证范围。
- 使用新的运行和数据目录，不自动迁移旧聊天；恢复旧运行文件不等于降级会话数据格式。
- 完整序列化推理请求的默认预算为 40,000,000 字节，超限在发送前拒绝。
图片召回输入为 {attachmentId, occurrence?}，遵守 DSH 的附件权限规则。
可选的请求检查事件允许扩展拒绝请求或禁止其自动认证重试。
- 2026-09-13 的 provider、配套构建工具和安装运行环境 npm 检查均为零已知漏洞；
上游冻结构建工作区另有 60 条告警记录，其中 29 条高危。构建前请阅读
依赖检查与构建约束，包括保留的 pnpm 11.7.0 工具链问题。

本项目为独立实验性集成。源码许可和登录成功均不构成第三方 OAuth 客户端已获授权的证明；
服务协议与账户资格可能变化，详见服务接入说明。
预览版不承诺持续可用或生产支持。

开发、许可与反馈

请参阅贡献指南、发行规范和私密安全反馈。
Issue 只提供最小合成复现，不分享凭据、真实对话或账户截图；维护采取尽力而为原则。

保留原 MIT 许可证、NOTICE和适用的 Apache-2.0 署名。
源码许可不授予订阅访问权限。旧 xAI API 合约仅作历史参考，
不进入默认构建与安装流程。