FolioDrop 发布器 jaxxchen003/foliodrop-dsh-publish

面向 DeepSeek Harness 的 FolioDrop 发布

连接 FolioDrop，并从 DeepSeek Harness 将用户批准的 agent 输出发布为稳定 URL。该插件注册 foliodrop_connect 和 foliodrop_publish，并将专用的 FolioDrop 连接密钥保存在 Harness 凭据接缝中。

范围

该插件以 HTML 优先：

- 完整的 HTML 会原样发布，不会重写。
- Markdown、文本、JSON、代码和 SVG 会被转换为可移植、自包含的 HTML 页面。
- 该插件不会读取任意本地路径，也不声称自己是通用的二进制文件托管服务。
- 搜索索引默认关闭，并且需要明确同意。
- 每次发布都会使用 Harness 问题 UI 进行最终确认，因为它会上传内容并创建一个外部可访问的 URL。当 Harness 权限预设为 Full access 时，这仍然有效；该预设会禁用原生工具审批，但不会抑制该插件显式提出的问题。
- 发布源固定为 https://foliodrop.app；凭据绝不会发送到由操作员配置的主机。

安装

直接从 GitHub 安装带标签的插件源码：

dsh plugin --profile web add github:jaxxchen003/foliodrop-dsh-publish#v0.2.0
dsh --profile web --dump-config

同一版本也以预打包制品的形式提供：

dsh plugin --profile web add https://github.com/jaxxchen003/foliodrop-dsh-publish/releases/download/v0.2.0/foliodrop-dsh-publish-0.2.0.tgz

如果从 FolioDrop 源码检出中使用，请改用本地包：

来自此仓库：

dsh plugin --profile web add ./integrations/deepseek-harness
dsh --profile web --dump-config

当该包也可从 npm 获取时，等效的注册表命令将是：

dsh plugin --profile web add @foliodrop/dsh-publish

该包提供纯 ESM JavaScript，因此安装不会执行 prepare 或其他生命周期构建脚本。

该插件包根据 MIT 许可证分发。此包内许可证不会改变此目录之外的 FolioDrop 应用程序的许可证。

连接 FolioDrop

让 agent 连接 FolioDrop，或在未配置密钥的情况下开始发布：

Connect my FolioDrop account.

该插件会启动一个回环回调，注册一个公共 OAuth 客户端，打开一次性 FolioDrop 登录/授权 URL，验证 state 和 PKCE S256，然后将临时 OAuth 凭据交换为专用的长期 DeepSeek Harness connection 密钥。该密钥通过 ctx.credentials.set 直接写入 FOLIODROP_API_KEY，并且绝不会出现在对话或工具输出中。作为交换的一部分，FolioDrop 会撤销临时 OAuth 访问密钥及其刷新令牌。如果 Harness 无法保存该长期密钥，该插件也会尽最大努力请求撤销该密钥。

如果浏览器无法自动打开，Harness 问题会显示确切的一次性授权链接，以便可以打开或复制。重新连接会轮换之前的 DeepSeek Harness 连接密钥。

手动个人密钥仍作为高级回退方案保留：

export FOLIODROP_API_KEY='fd_...'
dsh --profile web

由环境提供的密钥为只读。在使用自动重新连接之前，请移除或替换该环境值。

工具行为

要求智能体显式发布内容，例如：

Publish this Markdown release note to FolioDrop as a visible work. Do not allow
search indexing. Return the share URL.

该工具接受：

- content 和 content_type
- title、description 以及可选的代码 language
- visibility（默认为 visible，或 hidden）
- search_indexing_consent（默认为 false）
- 可选的 source_model

成功输出包括 FolioDrop 作品 id、slug、绝对分享 URL、可见性、转换后的格式、字节大小，以及固定的来源归属 DeepSeek Harness。

在上传之前，确认环节允许用户保留所提议的设置、将可见作品切换为隐藏、禁用搜索索引同意，或取消。
容量失败会提供 FolioDrop 升级和作品管理恢复路径，然后在用户确认完成后，对同一已批准的载荷重试一次。
付费能力失败会打开 FolioDrop 升级页面，并同样等待明确的“升级已完成”确认，然后重试一次。

错误恢复

已知失败被分为可操作的类别：连接缺失或已撤销、凭据存储只读、浏览器/回调不可用、OAuth 注册或令牌交换失败、确认不可用、套餐或作品容量已达上限、载荷过大、速率受限、FolioDrop 暂时不可用、网络故障，以及无效的服务器响应。错误信息绝不包含 API 密钥或内容正文。

兼容性契约

此版本针对 DeepSeek Harness 0.1.0-rc.6 进行了测试。Harness 处于开发者预览阶段，因此升级必须重新验证全部五个集成接缝：

- defineTool 注册和输出验证
- ctx.credentials.resolve/set('FOLIODROP_API_KEY')
- 用于连接和发布确认的 ctx.userQuestions.ask(...)
- 环回 OAuth 回调、DCR、PKCE 和令牌交换
- 在没有问题提供者时故障关闭

rc.6 配置文件安装程序可能会报告来自 @deepseek-ai/dsh-tools 的缺失对等依赖警告；因此发布门禁会同时验证使用 --dump-config 组合后的捆绑包和真实运行时启动，而不仅仅是安装退出代码。

FolioDrop 会在作品上存储 sourcePlatform: DeepSeek Harness，因此可以按发布来源聚合浏览量。

验证

pnpm --dir integrations/deepseek-harness install --frozen-lockfile
pnpm --dir integrations/deepseek-harness test
npm pack --dry-run ./integrations/deepseek-harness