dsh-article-publish

Readme

# dsh-article-publish

DeepSeek Harness 文章发布插件：agent 在会话里写完文章，直接调用工具发布到 **CSDN / 掘金 / 博客园**，还能拉取科技资讯当素材。**无外部依赖**——发布逻辑直接实现（API 参考 [mcp-server-article](https://gitcode.com/qq8864/article-publish-mcp)），不需要 MCP server、不需要额外进程。

## 功能

| dsh 工具 | 说明 |
|---|---|
| `publish_article` | 发布/更新文章到 CSDN / 掘金 / 博客园，返回文章链接 |
| `fetch_news` | 获取一条科技资讯（博客园 RSS 随机一篇），当素材 |

`publish_article` 参数：`platform`（csdn|juejin|cnblog）、`title`、`content`（Markdown）、可选 `description`（csdn/juejin，为空自动截取前 100 字）、可选 `articleId`（csdn，传入则原地更新）。

平台实现要点（已内置，无需额外服务）：
- **CSDN**：阿里云网关 HMAC-SHA256 签名请求（x-ca-* headers），外链图片自动转存到 CSDN 图床（csdnimg.cn），转存失败的 gitcode 图片回退 wsrv.nl 代理
- **掘金**：创建草稿 → 发布（两步）
- **博客园**：cookie + x-xsrf-token

## 安装

```sh
dsh plugin --profile <web|tui|headless> add file:/path/to/dsh-article-publish
# 或
dsh plugin --profile <web|tui|headless> add https://gitcode.com/qq8864/dsh-article-publish.git
```

## 配置（登录凭据）

发布需要各平台登录 Cookie。三种配置方式，优先级从高到低：

### 1. profile 配置（`cordis.patch.yml`）

```yaml
- id: article-publish
  config:
    enabled: true
    csdnCookie: ''          # CSDN 登录 Cookie
    juejinCookie: ''        # 掘金登录 Cookie
    cnblogCookie: ''        # 博客园 Cookie
    cnblogToken: ''         # 博客园 x-xsrf-token
    cnblogUsername: ''      # 博客园用户名（拼文章链接用）
```

### 2. 环境变量（推荐，不进仓库）

```sh
export CSDN_COOKIE='...'
export JUEJIN_COOKIE='...'
export CNBLOG_COOKIE='...'
export CNBLOG_TOKEN='...'
export CNBLOG_USERNAME='...'
```

### 3. 缺省时报错提示

Cookie 为空时工具返回友好错误，明确告诉你要配哪个。

**怎么拿 Cookie**：浏览器登录平台后，DevTools → Application → Cookies 复制对应域名的 Cookie；或复用 `mcp-server-article get-cookies`（Rust 工具，可从调试端口 Chrome 导出）作为辅助获取手段。

## 使用示例

> 调用 fetch_news 获取一条科技资讯，写一篇 300 字短文，然后调用 publish_article 发布到 CSDN。

## 开发与验证

```sh
pnpm install
pnpm run build        # tsc -> lib/
node test/publish.test.mjs   # fetch 拦截单测：验证三平台请求构造（签名/body/两步顺序/xsrf），不发真实请求
```

端到端（headless，无 Cookie 时验证工具链路与错误传播）：

```sh
dsh plugin --profile headless add file:./
dsh --profile headless --patch ./test/test-patch.yml \
  "调用 publish_article 工具把《测试文章》发布到掘金"
```

## 已知说明

- `@deepseek-ai/dsh-tools` 声明为 peerDependency：运行时从 dsh 闭包解析，避免双副本导致的 symbol 不匹配（agent-loop 调度器崩溃）。安装若提示 peer 缺失警告可忽略。
- CSDN 标签固定为"后端"、掘金分类/标签固定为"后端"（与 mcp-server-article 行为一致），后续可加配置。