# Dukou

> 渡口——终端AI agent与渡口Chrome插件的稿件互通。能力：(1)把md文章（含图片）渡到 X Articles / B站专栏 / 公众号排版器(editor.huasheng.ai)，自动打开编辑页并填充图文；(2)让插件抓取微信公众号文章（带登录态、防盗链图片可下载），落盘为本地md+图片；(3)导出插件文章库任意一篇为md+图片。

- **Type:** Skill
- **Install:** `agentstack add skill-alchaincyf-dukou-dukou`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [alchaincyf](https://agentstack.voostack.com/s/alchaincyf)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [alchaincyf](https://github.com/alchaincyf)
- **Source:** https://github.com/alchaincyf/dukou/tree/master/skill/dukou

## Install

```sh
agentstack add skill-alchaincyf-dukou-dukou
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 渡口 · 稿件分发

Chrome插件负责浏览器侧（抓取、填充、文章库），本skill负责终端侧（md进出、任务下发）。两侧通过本地桥（127.0.0.1:8787）互通。

**核心原则：所有命令由你执行，用户零终端操作。** 桥服务由CLI自动拉起（探活失败就后台启动，日志 `/tmp/dukou-bridge.log`），永远不要让用户手动跑任何命令。用户只需要：Chrome开着、渡口插件加载着。

## 命令

CLI在本skill目录的 `scripts/dukou.js`（自包含零依赖，下文以 `~/.claude/skills/dukou` 为例，按实际安装路径调整）：

```bash
# 投稿：md → 插件文章库 → 自动打开平台编辑页并填充
node ~/.claude/skills/dukou/scripts/dukou.js send 文章.md --dest x --autofill
node ~/.claude/skills/dukou/scripts/dukou.js send 文章.md --dest bili --autofill
node ~/.claude/skills/dukou/scripts/dukou.js send 文章.md --dest editor --autofill   # 公众号排版器
node ~/.claude/skills/dukou/scripts/dukou.js send 文章.md              # 只入库

# 取稿：微信公众号文章 → 本地 //.md + images/
node ~/.claude/skills/dukou/scripts/dukou.js fetch "https://mp.weixin.qq.com/s/xxx" --save-to ./素材

# 导出插件文章库（缺省最新一篇）
node ~/.claude/skills/dukou/scripts/dukou.js export --save-to ./素材

node ~/.claude/skills/dukou/scripts/dukou.js ping   # 探活（顺带自动启动桥）
```

时效：插件每30秒轮询桥，CLI阻塞到任务完成（`--wait 秒数`可调，import默认90/fetch默认240）。告诉用户点一下Chrome工具栏的渡口图标可立即同步。

## send 的 md 约定

- 首个 `# 一级标题` 作为文章标题（不进正文）；其余各级标题都渡成H2
- 图片 `` 必须独占一行；支持 jpg/png/gif/webp；路径相对md所在目录
- 行内支持 `**粗**` `*斜*` `` `code` `` `[链接](url)`；分割线会被丢弃（X不支持）
- 可选frontmatter：`title:` `author:` `cover:`（头图路径）
- X单图约5MB限制：插件填充时自动压缩超限图（先降质量后缩尺寸），无需预处理
- **图片用远程URL（http）时**：X/B站只吃本地图，会跳过远程图；但 `--dest editor` 排版器走原始markdown，远程图URL原样保留、预览直接显示——所以图全是ImgBB等远程链接的稿子，优先渡到 editor

## 平台差异

- `--dest x --autofill`：自动打开 X Articles，**用户需点一下 Write 新建草稿**，之后自动填入标题/正文/图片/头图（头图弹裁剪框需用户点Apply确认）
- `--dest bili --autofill`：自动打开B站专栏编辑页，全自动填入
- `--dest editor --autofill`：自动打开公众号排版器(editor.huasheng.ai)，把整篇raw markdown灌进左侧输入区，右侧实时预览。图片走markdown里的URL（远程图直接显示；本地图做不进来，让用户在排版器里重传）。填完用户自己点排版器的「复制到公众号」
- 填充完成后发布/复制动作永远留给用户，不要尝试代替用户发布
- 插件文库里每篇都有「渡到X / B站 / 排版器」按钮，用户也可不经终端、直接在插件里把任意存稿渡往各平台

## 排错与引导安装

1. CLI报「连不上渡口桥/自动启动失败」→ 看 `/tmp/dukou-bridge.log`
2. ping通但任务等待超时（插件一直没来取）→ 依次确认：
   - Chrome是否开着？
   - 渡口插件是否已安装加载？**未安装时引导用户**：clone https://github.com/alchaincyf/dukou ，打开 `chrome://extensions` → 开发者模式 → 「加载已解压的扩展程序」→ 选仓库里的 `extension/` 目录。装好后队列里的任务会被自动取走，无需重发
   - 让用户点一下渡口插件图标（立即同步）
3. 改过 `extension/` 代码后必须让用户重载插件并刷新目标页；旧页面点「填入」会提示刷新

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [alchaincyf](https://github.com/alchaincyf)
- **Source:** [alchaincyf/dukou](https://github.com/alchaincyf/dukou)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-alchaincyf-dukou-dukou
- Seller: https://agentstack.voostack.com/s/alchaincyf
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.