deepseek-paperclip-adapter

中文文档
1.0.1发布于 2026/11/03Apache-2.0ES Module零依赖

DeepSeek external adapter plugin for Paperclip with DeepSeek Flash, V4 Pro, and free coding models support

原始使用文档
文档目录6 节
  1. Features
  2. Installation in Paperclip
  3. Option A: From NPM (Recommended)
  4. Option B: From Local Path
  5. Configuration
  6. License

DeepSeek Adapter for Paperclip

External adapter plugin for Paperclip adding first-class support for DeepSeek AI models.

Features

  • Models Supported:
    • deepseek/deepseek-flash (Default, high-speed, cost-efficient)
    • deepseek/deepseek-v4-pro (High intelligence, advanced reasoning)
    • opencode/deepseek-v4.1-flash-free (Free tier flash model)
  • Seamless Key Management: Works with DEEPSEEK_API_KEY set in the environment or configured manually by the user via Paperclip's Connectors menu (/apps).
  • Interactive UI Transcript Parser: Live streaming tool calls, reasoning/thinking traces, and token usage metrics directly in Paperclip's execution view.
  • Full Coding Agent Capabilities: File operations, bash command execution, skills sync, and session persistence across heartbeat runs.

Installation in Paperclip

  1. In Paperclip, go to Settings > Adapters (/company/settings/adapters).
  2. Click + Install Adapter.
  3. Under the npm package tab, enter:
    deepseek-paperclip-adapter
    
  4. Click Install.

Option B: From Local Path

  1. Clone this repository locally on your Paperclip server:
    git clone https://github.com/jefrimustapa/deepseek-paperclip-adapter.git /path/to/deepseek-paperclip-adapter
    
  2. In Paperclip, go to Settings > Adapters -> + Install Adapter.
  3. Under the Local path tab, enter /path/to/deepseek-paperclip-adapter.
  4. Click Install.

Configuration

Set your DeepSeek API key using either:

  1. Paperclip Connectors Menu: Navigate to /apps, click DeepSeek, and enter your API key (sk-...).
  2. Environment Variable: Set DEEPSEEK_API_KEY=sk-... in your server environment or agent's adapter environment settings.

License

Apache-2.0

版本与发布记录

deepseek-paperclip-adapter 共发布 3 个版本,首次发布于 2026/11/03;过去 12 个月发布了 3 个版本。

版本发布日期距今
1.0.1latest2026/11/03今天
1.0.02026/11/03今天
0.0.0-stage2026/11/03今天

关于 deepseek-paperclip-adapter 的常见问题

deepseek-paperclip-adapter 是什么?

DeepSeek外部适配器插件与DeepSeek Flash, V4 Pro和免费编码模型支持的回形针

如何安装 deepseek-paperclip-adapter?

在项目目录运行 npm install deepseek-paperclip-adapter,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@paperclipai/adapter-opencode-local(>=0.3.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

deepseek-paperclip-adapter 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/deepseek-paperclip-adapter 是否存在。

deepseek-paperclip-adapter 支持 ESM 还是 CommonJS?

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

deepseek-paperclip-adapter 可以商用吗?

deepseek-paperclip-adapter 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

deepseek-paperclip-adapter 还在维护吗?

最新版本 1.0.1 发布于 2026/11/03(今天);至今共发布 3 个版本,其中过去 12 个月发布了 3 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。