dsh-provider-qoder 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mo-n
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# DSH Qoder Subscription Plugin
+
+English | [简体中文](./README_CN.md)
+
+`dsh-provider-qoder` integrates your Qoder subscription into DeepSeek Harness (DSH), supporting streaming text, reasoning content, and tool calls, with support for both Global and China Qoder services.
+
+The plugin handles authentication and model communication, while tool execution, workspace operations, and permission management are handled by DSH.
+This project is a community adapter plugin.
+
+## Features
+
+- Configure subscription access via Qoder Personal Access Token (PAT).
+- Supports both Global (`global`) and China (`china`) services.
+- Discovers available models for your account, allows selecting enabled models, and displays pricing multipliers and reasoning effort options when reported by the service.
+- Supports streaming responses, reasoning content, tool calls, and multi-turn interactions with text-based tool results.
+- View account information, personal quota, organization resource packs, and reset dates in Settings.
+
+## Installation
+
+### Prerequisites
+
+You will need a running DSH Web environment, an active Qoder subscription, and a PAT matching the selected service region. The DSH profile running the plugin must provide a managed credentials service; when configuring via the settings page, the credential storage must also be writable.
+
+This package declares peer/dependency ranges of DSH packages `>=0.1.2-rc.1 <0.2`, Cordis `>=4.0.2 <5`, and React `^18.2.0`. The settings UI also depends on the host providing remote credential endpoints and settings slots—please use a DSH version equipped with these interfaces; the ranges above do not imply that every version has been tested.
+
+### Install from npm
+
+Once published to npm, run the following in your terminal:
+
+```sh
+dsh plugin --profile web add dsh-provider-qoder
+```
+
+## Configuration & Usage
+
+### 1. Save Service Region and PAT
+
+Open DSH Web, navigate to **Settings → Models**, locate the **Qoder Credentials** card at the bottom of the page, and click **Edit**.
+
+| Service Region | Account Domain |
+| --- | --- |
+| Global (default) | `qoder.com` |
+| China (CN) | `qoder.com.cn` |
+
+Select the region matching your account, enter your Qoder PAT into the input box labeled **API Key**, and click **Save**. Note that a Qoder PAT is required here, not an API key from other model providers.
+
+### 2. Fetch and Select Models
+
+1. After saving the PAT and service region, click **Edit** again.
+2. Expand **Custom Settings** and click **Fetch Available Models**.
+3. Select the models you want to enable (keep at least one), then click **Save**.
+4. Select a Qoder model in the DSH model picker to start chatting.
+
+Fetching models uses the **saved PAT and service region**. If you switch accounts or regions, save your changes first before fetching models again. The initial model catalog is only a candidate reference; actual available models are subject to account query results. Model multipliers and reasoning effort options are provided by Qoder and may not be available for all models.
+
+### 3. View Account & Quota
+
+Open **Settings → Qoder** to view account and quota details, and click **Refresh** to query again. The absence of quota information does not mean zero quota; displayed content depends on data currently returned by Qoder.
+
+## FAQ
+
+### The plugin fails to start, or credentials cannot be saved
+
+Ensure you have restarted the profile where the plugin was installed, and that the profile provides the DSH managed credentials service. If prompted that the storage is not writable, a writable credential store needs to be configured on the host side. The plugin does not read PATs from environment variables.
+
+### PAT is saved, but model fetching or requests fail
+
+Verify that the PAT is valid and matches the saved service region. If modified, save first before fetching models. The save action itself does not validate the token. If your account quota is exhausted, you will need to resolve your subscription quota first.
+
+### Models remain unavailable after switching regions
+
+Switching regions does not automatically update your PAT or refetch models. After saving the PAT for the corresponding region, refetch available models, save your selection, and choose an available Qoder model in your conversation.
+
+### Are requests automatically retried?
+
+Automatic retries are managed by DSH. To enable retries, the running profile should include `@deepseek-ai/dsh-llm-retry`. The plugin reports empty responses, rate limits, server errors, timeouts, and transport errors using DSH's default retry policy; authentication, invalid requests, cancellations, quota issues, and protocol formatting errors are not retried by default.
+
+## Install from Source & Development
+
+Run in an environment with Git, Node.js, and pnpm installed. Node.js must support the `--experimental-strip-types` and `--test-isolation=none` flags used by the project's test scripts.
+
+```sh
+git clone https://github.com/mo-n/dsh-provider-qoder.git
+cd dsh-provider-qoder
+pnpm install --frozen-lockfile
+pnpm run build
+```
+
+Install the built repository directory into your DSH profile. The path below is a placeholder example; replace it with the actual absolute path:
+
+```sh
+dsh plugin --profile web add /absolute/path/to/dsh-provider-qoder
+```
+
+After restarting the profile, follow the configuration steps above. If running the CLI within a DSH source workspace, you can use `pnpm dsh` from that workspace.
+
+For development, run watch mode in the plugin directory:
+
+```sh
+pnpm run dev
+```
+
+Before committing changes, run:
+
+```sh
+pnpm run check
+```
+
+This command runs non-UI mocked tests, builds the ESM package and type declarations, checks build artifacts, and previews the package tarball without sending real Qoder model requests or publishing npm packages.
+
+## Feedback
+
+Please report issues via [GitHub Issues](https://github.com/mo-n/dsh-provider-qoder/issues) with the plugin and DSH versions, selected service region, reproduction steps, and sanitized error messages. Do not submit PATs, short-lived tokens, or personal account information.
+
+This project is licensed under the MIT License.

package/README_CN.md

@@ -0,0 +1,115 @@
+# DSH Qoder 订阅插件
+
+[English](./README.md) | 简体中文
+
+`dsh-provider-qoder` 将你的 Qoder 订阅接入 DeepSeek Harness（DSH），支持流式文本、推理内容和工具调用，可选择国际版或中国区 Qoder 服务。
+
+插件负责认证和模型通信，工具执行、工作区操作及权限管理由 DSH 负责。
+本项目是社区适配插件。
+
+## 功能
+
+- 通过 Qoder Personal Access Token（PAT，个人访问令牌）配置订阅访问。
+- 支持国际版（`global`）和中国区（`china`）服务。
+- 获取账号可用模型，选择启用的模型，并在服务返回相关信息时显示价格倍率和推理强度选项。
+- 支持流式回答、推理内容、工具调用及文本工具结果的多轮交互。
+- 在设置中查看账号信息、个人额度、组织资源包和重置时间。
+
+## 安装
+
+### 使用前提
+
+你需要可运行的 DSH Web 环境、可用的 Qoder 订阅，以及与所选服务区域匹配的 PAT。运行插件的 DSH profile 必须提供托管凭据服务；通过设置页面配置时，凭据存储还需可写。
+
+本包声明的依赖范围为 DSH 相关包 `>=0.1.2-rc.1 <0.2`、Cordis `>=4.0.2 <5` 和 React `^18.2.0`。设置界面还依赖宿主提供凭据远程接口和设置插槽，请使用具备这些接口的 DSH 版本；上述范围不代表每个版本都经过实测。
+
+### 从 npm 安装
+
+发布到 npm 后，在终端执行：
+
+```sh
+dsh plugin --profile web add dsh-provider-qoder
+```
+
+## 配置与使用
+
+### 1. 保存服务区域和 PAT
+
+打开 DSH Web 的 **设置 → 模型**，找到页面底部的 **Qoder 凭据** 卡片，点击 **编辑**。
+
+| 服务区域 | 对应账号 |
+| --- | --- |
+| 国际版（Global，默认） | `qoder.com` |
+| 中国区（CN） | `qoder.com.cn` |
+
+选择与账号一致的区域，将 Qoder PAT 填入界面标为 **API 密钥** 的输入框，然后点击 **保存**。这里需要的是 Qoder PAT，不是其他模型服务的 API Key。
+
+### 2. 获取并选择模型
+
+1. 保存 PAT 和服务区域后，再次点击 **编辑**。
+2. 展开 **自定义设置**，点击 **获取可用模型**。
+3. 选择需要启用的模型，至少保留一个，然后点击 **保存**。
+4. 在 DSH 的模型选择器中选择 Qoder 模型，开始对话。
+
+获取模型使用的是**已保存的 PAT 和服务区域**。更换账号或区域后，请先保存，再重新获取模型。初始模型目录仅供候选参考，实际可用模型以账号查询结果为准。模型倍率及推理强度选项由 Qoder 提供，并非所有模型都有这些信息。
+
+### 3. 查看账号与额度
+
+打开 **设置 → Qoder** 查看账号和额度，点击 **刷新** 重新查询。没有额度信息不代表额度为零；显示内容取决于 Qoder 当前返回的数据。
+
+## 常见问题
+
+### 插件无法启动，或凭据无法保存
+
+确认已重启安装插件的 profile，且该 profile 提供 DSH 托管凭据服务。如果提示存储不可写，需要在宿主侧配置可写的凭据存储。插件不会从环境变量读取 PAT。
+
+### 已保存 PAT，但获取模型或请求失败
+
+确认 PAT 有效且与已保存的服务区域匹配。修改后先保存，再获取模型。保存操作本身不会验证令牌。若账号额度已用尽，需先处理订阅额度问题。
+
+### 切换区域后，模型仍不可用
+
+切换区域不会自动替换 PAT 或重新获取模型。保存对应区域的 PAT 后，重新获取可用模型、保存选择，并在对话中选择可用的 Qoder 模型。
+
+### 请求是否会自动重试？
+
+自动重试由 DSH 管理。需要重试时，运行中的 profile 应包含 `@deepseek-ai/dsh-llm-retry`。插件使用 DSH 默认重试策略报告空响应、限流、服务端、超时和传输错误；认证、无效请求、取消、额度及协议格式错误默认不重试。
+
+## 从源码安装与开发
+
+在已安装 Git、Node.js 和 pnpm 的环境中执行。Node.js 需支持项目测试脚本使用的 `--experimental-strip-types` 和 `--test-isolation=none` 参数。
+
+```sh
+git clone https://github.com/mo-n/dsh-provider-qoder.git
+cd dsh-provider-qoder
+pnpm install --frozen-lockfile
+pnpm run build
+```
+
+将构建后的仓库目录安装到 DSH profile。以下路径为占位示例，请替换为实际绝对路径：
+
+```sh
+dsh plugin --profile web add /absolute/path/to/dsh-provider-qoder
+```
+
+重启 profile 后，按前文完成配置。若在 DSH 源码工作区中运行 CLI，可使用该工作区的 `pnpm dsh` 命令。
+
+开发时，在插件目录运行监听构建：
+
+```sh
+pnpm run dev
+```
+
+提交修改前运行：
+
+```sh
+pnpm run check
+```
+
+该命令运行模拟网络的非 UI 测试、构建 ESM 包与类型声明、检查构建产物并预览打包内容，不会发起真实 Qoder 模型请求或发布 npm 包。
+
+## 反馈
+
+请通过 [GitHub Issues](https://github.com/mo-n/dsh-provider-qoder/issues) 提交问题，附上插件和 DSH 版本、所选服务区域、复现步骤及脱敏后的错误信息。不要提交 PAT、短期令牌或个人账号信息。
+
+本项目采用 MIT 许可证。

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# Adds only the Qoder provider plugin. Model selection remains user-owned.
+- insert:
+    - id: qoder-subscription
+      name: 'dsh-provider-qoder'