# @adaptiqai/deepseek-harness 中文文档

规范地址：https://npmcn.com/package/%40adaptiqai/deepseek-harness/

版本：0\.2\.19
npm 元数据更新时间：2026-11-07T00:21:14.541Z
中文译文更新时间：2026-11-07T00:22:38.575Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adaptiqai/deepseek-harness
原文对照：https://npmcn.com/package/%40adaptiqai/deepseek-harness/?lang=original
项目主页：https://adaptiqai.com/
源码仓库：https://github.com/MrRopke/adaptiq-harness-plugins

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：701 kB，48 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：0 个
- peer 依赖：@deepseek-ai/cordis ~4\.0\.4，@deepseek-ai/dsh-llm \>=0\.2\.0-rc\.2 \<0\.3\.0，@deepseek-ai/dsh-tools \>=0\.2\.0-rc\.2 \<0\.3\.0，@deepseek-ai/schemastery \*，@deepseek-ai/dsh-home-paths \>=0\.2\.0-rc\.2 \<0\.3\.0，@deepseek-ai/dsh-credentials \>=0\.2\.0-rc\.2 \<0\.3\.0，@deepseek-ai/dsh-typert-protocol \>=0\.2\.0-rc\.2 \<0\.3\.0
- 首次发布：2026-10-09T19:38:07.589Z
- 最新版本发布：2026-11-07T00:21:14.387Z
- 近 30 天下载量：2312（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

AdaptiqAI for DeepSeek Harness:有5M-token本土记忆和知识的模型. 签个名,找个模特儿去工作,不要离开吊带

## 安装

```sh
npm install @adaptiqai/deepseek-harness
```

也可以使用：`pnpm add @adaptiqai/deepseek-harness`、`yarn add @adaptiqai/deepseek-harness`、`bun add @adaptiqai/deepseek-harness`

## README

# DeepSeek 策略的适应性

在DeepSeek Harness中使用您的 AdaptiqAI 工作空间:您工作空间的每一个模型,拥有保持整个对话的本土记忆——最多500万个符号——以及您在任何对话中的知识收藏. 您在浏览器中签名一次,或者创建您的账户;然后选择一个模型并开始,全部从管子内部开始。 没有要复制的密钥 .

![Welcome](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/welcome.jpg)

## 安装

需要DeepSeek Harness 02.0-rc.2或后0.2发布.

1.  打开 **插件** 在边栏中选择 **添加插件**。 。 。 .
2.  输入软件包—— `@adaptiqai/deepseek-harness`,或下载的完整路径 `adaptiqai-deepseek-harness-<version>.tgz` - 安装它.
3.  一张欢迎卡请您 **连接适配器**。您的浏览器打开;您在(或用 GitHub 、 Google 或电子邮件创建账户) 中签名并批准, 并使用它.
4.  新账号还没有模型:同一张卡片显示报价中的模型,有价格,速度和内存. 选择一个和可以同时运行多少个对话 **获取权限** 并在浏览器中确认。 该模型在活动后立即出现在取取器中.

在DeepSeek Harness桌面应用程序中,使用插件页面;它保留自己的配置,即 `dsh` 命令不能改变。 如果你运行 `dsh web` 从一个终端,同样的安装是:

```bash
dsh plugin --profile web add @adaptiqai/deepseek-harness
```

## 你得到的东西

**你的模特们,设置正确.** 模特儿会得到一个 **适应委员会** 组合,包含您工作空间中的模型。 每个都带有其真实上下文窗口,输出限制和自身思维水平,都从服务器上读取——插件中没有任何名称取出一个模型.

![Model picker](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/model-picker.jpg) ![Thinking levels](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/thinking-levels.jpg)

**记忆你可以看到.** 发送按钮旁边的一粒小药丸显示了模型现在所看到的: 对话的内存与模型的窗口相对 (`Memory · 25k / 5M`) (中文(简体) ). 它从来没有增加一个转弯。 每一次回答后,都显示记忆中有多少直接来自(`24.6k from memory`) (中文(简体) ). 点击它来切换对话 **记住** 财务报告和审定财务报表 **私营**,添加或删除知识,并查看 **已处理**:新的输入,从内存读取,被保存到内存和输出,带有成本,用于上回转折和整个对话. 每个代理步骤都再次读取了整个内存,因此这些都远远超过了内存的大小;它们是同4个数字DeepSeek Harness自己的用法面板计数(它的未标记输入,缓存输入,缓存写入和输出). 插件从每个答题的用法中计算出它们, 并把它们保存在重新启动的整个过程中 .

![Composer](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/composer-from-memory.jpg) ![Memory popover](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/memory-popover.jpg)

**设置 – 适应性qAI.** 您的工作空间,有活运行/等待计数的模型,内存的使用被分割成对话与知识,是否保存了新的对话,以及与控制台的链接.

![Settings](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/settings.jpg)

**知识.** 侧边栏中的知识面板列出您的收藏. 在开放对话中使用一个并点击一次,或者丢弃文件来创建新的集合;在准备就绪时自动被附加.

![Knowledge](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/knowledge.jpg) ![New collection](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/create-knowledge.jpg)

**一个模型每个记忆.** AdaptiqAI为一个模型构建了对话的记忆和每个集合,他们只与该模型合作. Knowledge 面板列出首先使用模型的收藏。 用于其他模型的收藏如下: **备供** 。在错误的模型上的对话中永远不能添加一个集合。 如果你在另一个模型上的记忆的对话中切换模型, 作曲家上面的一个简短的提示 **回转** 或者说 **开始新的** 。 。 。 .

![Other models' collections](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/knowledge-by-model.jpg) ![Model notice](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/model-notice.jpg)

**通知说该做什么.** 如果一个模特儿很忙, 绳子会自己等待和重复,告诉你。 如果一个模型还没有在工作空间,你得到一个 **获取权限** 按钮。 如果余额用光了,你会得到一个 **添加资金** 按钮。 如果记忆几乎满了,在它填满之前会告诉你,有办法可以清理或私下继续. AdaptiqAI把闲话放入睡觉的地方, 只有在没有闲事可睡或者你的图书馆满了的时候, 才会告诉你, 给控制台按个按钮。 如果您的签注过期, 请再次签名 .

![Notices](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/notices.jpg)

**一次更新.** 当AdaptiqAI新版发布完毕时,通知提供 **更新**:插件通过插件页自己的安装器来安装,并切换到它,而不需要在拉带允许的情况下重启. pnpm 通常要等一天才能安装新版本;这样更新就可以同时安装,插件首先要准确列出该版本的 `@adaptiqai/deepseek-harness` 下级 `minimumReleaseAgeExclude` 在简介中 `pnpm-workspace.yaml`,替换它之前列出的版本。 其他的包裹保持pnpm的等待。 如果该文件以插件无法安全编辑的方式被设置出来,则会像前作一样被单独放出,并在发布后一天提供更新.

**`/adaptiq`** 在作曲中: `status`, (中文(简体) ), `signin`, (中文(简体) ), `private`, (中文(简体) ), `remember`, (中文(简体) ), `knowledge`, (中文(简体) ), `open`, (中文(简体) ), `diagnostics`, (中文(简体) ), `signout`。 。 。 .

**找到一个模型而不离开绳子.** 设置 • 适应 Q **找个模特儿** (或 **获取权限** 任何通知中都列出所要提供的内容。 你从平衡中支付每个符号, 从记忆中读取是免费的。 您在浏览器中确认; 插件遵循请求, 并在模型准备好时显示 .

![Get a model](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/get-a-model.jpg) ![Ready](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/model-ready.jpg)

**相会为知识.** 类型 `@` 在一个消息中选择另一个对话:如果它是在同一模式上,它会被从内存中添加到这个对话中(该模式不会再次将它读作文本),它会保留为后期消息所添加. 记忆药丸上写着所加之物. 或者打开记忆药丸 选择 **添加**: 两个标签, **知识** (你的收藏, 最新的第一, 在最后几天制作的标记) _新设_给另一个模型做的 灰了 _提供这里_和 **对话** (此模型上最近出现的,在侧边栏中取名;没有打字的所有显示,一击就添加或去除. 谈话用什么来显示在消息框上方的芯片,x停止使用一个,同样在第一个消息之前. 私人对话不会增加任何内容;您提到的谈话会被读作文本.

![Conversations](https://npmcn.com/package/%40adaptiqai/deepseek-harness/docs/screenshots/conversations.jpg)

**探员工具.** 代理可以找到并附加知识,在所收的语句中找到一个对话所使用的单词,代号或名称,确切行为文档:行(`adaptiq_knowledge`) (中文(简体) ). 转弯的第一步是告诉哪些已经准备好的集合,当它们改变时,它的对话会一次又一次地被读取,作为对话中的背景一行,所以代理在上面查看一些东西. 代理商还可以检查共享内存,并提供清理选项(`adaptiq_memory`并保存他们所学的东西`adaptiq_create_knowledge`) (中文(简体) ). 在阅读了相当多文件后,或者当你说 _记住_, (中文(简体) ), _保存_, (中文(简体) ), _收藏_ 或者说 _NCM 数字化_,代理搜索你的知识和提议 保存材料作为收藏; 在你的是,它创建它,并用一句话,用你的语言确认。 它的芯片在编译时会显示一个安静的进度行,并且在准备时会发出简短的通知. 代理人从未显示身份或技术状态. 如果它用错误来保存某事,那么再次保存会更正同一份收藏而不是制作第二本,它可以收回它在过去15分钟里在本次谈话中制作的一本;它永远不会删除其他任何内容. 整个旅程,还有需要的服务器,是在 [文献/资料](https://npmcn.com/package/docs/CONTEXT_MANAGEMENT.md)。 。 。 .

## 如何运作

-   **请求** 转到 AdaptiqAI OpenAI 兼容的 API。 每一份请求都带有带带式对话id(`X-Adaptiq-Session-Id`),所以服务器每次对话都会保留一个内存. 标题请求没有身份证明,所以从未对已保存的谈话进行分叉.
-   **子代理人和队友** 并点出启动这些对话的话题(`X-Adaptiq-Parent-Session-Id`),所以控制台显示在它下面. 副剂是 `helper` 团队成员是 `track`,它自己的一行工作(`X-Adaptiq-Session-Role`) (中文(简体) ). 一次对话,你叉了自己的名字 没有父母.
-   **没有收缩.** AdaptiqAI保持了完整的对话,因此插件报告模型的真实上下文窗口,并用一个简单的解释来表示,而不是在每一个步骤上都表示,并拒绝了被拉带的收缩请求——在Remember和private中. 没有任何东西被总结出来, 没有任何东西被发送到服务器上.
-   **思考层面** 来自于每个型号的能力卡(`adaptiq-model-capabilities-v1`:关卡,关闭思维的值,默认和请求字段. 没有卡片的模型只有在其id命名一个推理模型时才会回落到Low/High/Extra high/Max.
-   **图像** 到达其能力卡列表的模型 `image` 内 `input`: 每人内入(`image_url` 带有 `data:` URL),您将其放入消息中,在一个简短的注释命名之后. 字节来自自带所储存的复制件(您附上时的内容地址),从来不来自原始文件,所以即使文件有变化,后一转会重新发送完全相同的图像. 大于16 MP的图像被先缩放;格式从字节(PNG,JPEG,WebP,GIF)中检查出,超过20 MB的图像被用一通通消息拒绝. 在一个请求中超过8个图像, 绳子把最古老的变成了音符。 一个读取文本的模型只得到一个注释来代替每个图像,一个通知说图像没有发送. 图像工具在下一个消息中随其结果返回.
-   **使用量** 被报告为被绑的方式: 从内存计数中读取的符号作为缓存读取,所以被绑自己的计数器(成本,缓存被击中)是正确的.
-   **忙于准备答案** 重覆的被绳子, 尊重服务器的 `Retry-After`。 。 。 .

## 隐私和安全

-   签入使用设备流:插件显示一个短代码,您在浏览器中批准,而插件接收一个工作空间证书. 它存放在吊带证书商店(`$DSH_HOME/.credentials.yaml`只有你才能读取它,并更新它。 Tokens 从未到达浏览器页面 .
-   连接在 AdaptiqAI 控制台下 **API 密钥** 作为“Deep Seek Harness on” ; 在那里撤销它只会断开这个计算机.
-   **私营** 对话仍然可以读取记忆和知识,但没有任何新的东西可以保存.
-   `/adaptiq diagnostics` 生成一个不包含任何秘密的报告,您可以发送到支持.

## 无头CI

没有浏览器, 请将控制台的 API 密钥保存在证书引用下 `ADAPTIQAI_API_KEY` (例如作为环境变量). 插件在没有签名的情况下使用 .

## 配置

一切有生产缺省. 为了改变一些东西, 在您的档案中添加一行 `cordis.patch.yml`数字 :

```yaml
- id: adaptiq
  name: '@adaptiqai/deepseek-harness'
  config:
    route: adaptiqai              # provider id in the model picker
    apiBase: https://api.adaptiqai.com
    consoleUrl: https://memory.adaptiqai.com/memory
    apiKeyEnv: ADAPTIQAI_API_KEY  # headless credential reference
    tools: true                   # agent tools
    progressEvents: true          # streamed "preparing" progress
    streamIdleTimeoutSeconds: 900
```

## 解决问题

-   **"AdaptiqAI模型被隐藏——另一个提供商已经使用路线".** 一个更古老的手工制作 `adaptiqai` 提供者存在于您的配置文件( 通常是 `llm-pi-ai` 输入 `cordis.patch.yml`) (中文(简体) ). 移除该条目并重新启动控制带.
-   **模型不见了.** Open Sets – AdaptiqAI并按刷新;列表准确地显示了工作空间中的模型.
-   其他东西: 运行 `/adaptiq diagnostics` 并发送报告支持.

## 发展

```bash
pnpm install
npm install -g @deepseek-ai/dsh@0.2.0-rc.2   # the harness release the plugin targets (as CI does)
npm run link-dsh      # link the installed DeepSeek Harness packages for types and tests
npm run build         # lib/index.js (Host), lib/client.js (browser), Typert artifacts
npm test              # unit tests
ADAPTIQ_LIVE=1 ADAPTIQAI_API_KEY=ak_live_… npx vitest run test/live.test.ts   # one short live request
npm run pack:local    # dist/adaptiqai-deepseek-harness-<version>.tgz
```

布局 : `src/host` (适应器、登录、工作空间服务、遥控器、命令、工具), `src/client` (React UI in the AdaptiqAI design),(在AdaptiqAI 设计中反应UI),,(AdaptiqAI 中反应UI), `scripts/remote-spec.mjs` (远程命名空间; `scripts/gen-typert.mjs` 把它变成Typert的文物 装上绳子.

在计算机上安装时,UI使用PP Frama. 软件包不运送PP Frama(其许可证不允许);否则它会掉回Manrope,一个嵌入于浏览器捆绑中的SIL Open Font License grotesk(许可证载于 `assets/fonts/Manrope-OFL.txt`) (中文(简体) ).

## 常见问题

### @adaptiqai/deepseek-harness 是什么？

AdaptiqAI for DeepSeek Harness:有5M-token本土记忆和知识的模型\. 签个名,找个模特儿去工作,不要离开吊带

### 如何安装 @adaptiqai/deepseek-harness？

在项目目录运行 npm install @adaptiqai/deepseek-harness，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.4）、@deepseek-ai/dsh-llm（\>=0\.2\.0-rc\.2 \<0\.3\.0）、@deepseek-ai/dsh-tools（\>=0\.2\.0-rc\.2 \<0\.3\.0）、@deepseek-ai/schemastery（\*）、@deepseek-ai/dsh-home-paths（\>=0\.2\.0-rc\.2 \<0\.3\.0）、@deepseek-ai/dsh-credentials（\>=0\.2\.0-rc\.2 \<0\.3\.0）、@deepseek-ai/dsh-typert-protocol（\>=0\.2\.0-rc\.2 \<0\.3\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @adaptiqai/deepseek-harness 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @adaptiqai/deepseek-harness 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @adaptiqai/deepseek-harness 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @adaptiqai/deepseek-harness 可以商用吗？

@adaptiqai/deepseek-harness 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @adaptiqai/deepseek-harness 的下载量有多少？

根据 npm 官方下载统计，@adaptiqai/deepseek-harness 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,312 次，日均约 77 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adaptiqai/deepseek-harness 还在维护吗？

最新版本 0\.2\.19 发布于 2026/11/07（今天）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/10/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。