前言¶
在 DSH 里处理图文排版，常见痛点是秀米编辑器只能靠界面点击，批量操作（多选、插入横滑图集、逐页换图、改页数）没有一键入口。系统级鼠标注入在 Chromium 系浏览器上经常完全无效，而秀米画布是 AngularJS 组件树加虚拟列表，常规”点点点”脚本很容易误判 img 数量。下面介绍的 dsh-xiumi 就是为此设计的：它以 skill 形式装进 DSH，复用你已登录的浏览器，把上述排版链路固化成一组 CLI 命令。
这是什么¶
dsh-xiumi 是一个面向 DeepSeek Harness 的插件（分类：工作流），由 oobitoooo 维护，GitHub 当前约 1 stars。它用 Playwright + CDP 操作你已登录浏览器里的秀米（XIUMI）图文编辑器，把批量多选、插入横滑图集、逐页换图、改页数、删组件、保存以及分享页审核状态核对变成脚本。
需要先说明边界：这个插件只包含秀米排版能力，不含任何 API 路由或模型代理；脚本只连本机 CDP 端口，不向外发数据。
核心功能¶
下面这些能力都来自 README，按用途分组。
1、滑动图集转换：选中一组照片，插入「滑动图片」组件，改成 N 页，逐页换回原图，再删掉旧的竖排照片。
2、页数任意改：绕过点不到的「设置滑动序列」面板，直接改 Angular 模型 cellGroupItems，保存后可持久化。
3、批量换图：按图片 URL 里的 -sz_<字节数> 指纹精确匹配图库缩略图。
4、画布快照/校验：给出组件数、每个滑动组件的页数和图片指纹，用来判断操作是否真的生效。
5、保存 + 审核：保存草稿，引导点「申请审核」，再用分享页核对是否已更新。
6、原生组件粘贴（v0.3.0）：把一篇稿子编译成秀米 paper.comp 原生组件，经 Chromium 原生剪贴板一次粘成整篇，粘完仍可编辑；思路移植自 gih10012/xiumi-native-clipboard（MIT）。
7、排版质检（v0.2.0）：打开渲染后的分享页/编辑页读 computedStyle，检查正文字号行距、小标题、图注字号与颜色一致性、图片比例，输出 Markdown + JSON 报告（借鉴 xiumi-editor-checker 的规则，但不解析私有 JSON）。
8、登录态轻量迁移（v0.2.0）：导出 cookie + localStorage 成 session.json，注入任意调试浏览器，免复制整个 profile（sid 约 3 天有效）。
9、多 harness 安装（v0.2.0）：一键装进 Claude Code / Cursor / Codex / Gemini 等本机已装的 AI 助手。
安装与启用¶
作为 DSH 插件安装（推荐），官方命令如下，安装命令来自 README 原文：
dsh plugin add https://github.com/oobitoooo/dsh-xiumi
# 本地目录也可以：
dsh plugin add /path/to/dsh-xiumi
装完重启（或新开会话），在 skill 列表里就能看到 xiumi-editor-automation。如果不想当插件用，可以把 skill/ 目录复制到 ~/.dsh/skills/xiumi-editor-automation/（或项目内 .dsh/skills/），也可以用多 harness 安装器：
node skill/scripts/install-harnesses.mjs --list # 探测本机有哪些
node skill/scripts/install-harnesses.mjs # 装到全部探测到的目录
依赖只有两项：Node.js ≥ 18，以及 playwright-core（不会下载浏览器，复用你已装的 Edge/Chrome）。
cd skill/scripts && npm i playwright-core
典型用法¶
下面是 README 给出的完整链路，先起一个带调试口（9222）的浏览器并复制登录态，再按顺序操作。
cd skill/scripts
# 1) 起带调试口（9222）的 Edge/Chrome，并把日常 profile 的登录态复制过去
node launch-browser.mjs
# 2) 在弹出来的浏览器里打开草稿编辑页
# https://xiumi.us/studio/v5#/paper/for/<草稿id>/cube/0
# 3) 看当前画布状态
node xiumi-gallery.mjs status
# 4) 上传照片到「我的图库」，拿到每张图的 -sz_ 指纹
node xiumi-gallery.mjs upload --files ./photos/a.jpg,./photos/b.jpg
# 5) 转换一组（先 dry-run 打印 PLAN，确认后加 --yes 执行）
node xiumi-gallery.mjs convert --art <原图指纹列表> --gal <图库指纹列表>
# 6) 保存（保存后到「预览 → 分享」点「申请审核」，分享页才会更新）
node xiumi-gallery.mjs save
# 7) 核对分享页
node xiumi-gallery.mjs verify --share https://v.xiumius.cn/board/v5/<x>/<id>
# 8) 排版质检（字号/行距/图注一致性/图片比例 → Markdown 报告）
node xiumi-audit.mjs --share https://v.xiumius.cn/board/v5/<x>/<id> --md report.md
# 9) 整篇原生组件一次粘贴（编译 spec → 复制 → 粘贴 → 自动核对）
node xiumi-clip.mjs build --spec spec.json --out doc.xiumi.json
node xiumi-clip.mjs push --spec spec.json --draft <草稿id>
# 10) 登录态轻量迁移（免复制整个 profile）
node xiumi-session.mjs export
node xiumi-session.mjs apply --open "https://xiumi.us/studio/v5#/paper/for/<草稿id>/cube/0"
其中 convert 的 --art 是画布上竖排照片的 -sz_ 指纹（从上到下），--gal 是图库里对应照片的 -sz_ 指纹（等于本地文件字节数，顺序一致），两者数量必须相等，也就是页数。第 5 步默认 dry-run，打印 PLAN 后确认无误再加 --yes 执行。
冒烟测试可以这样跑：
node test/smoke.mjs
适用场景与注意¶
适合已经在用 DSH、且日常要做秀米批量排版的人：把重复的”选图—插图集—换图—改页数—保存—核对”交给脚本，减少手工点击和误判。
使用前注意几点：
- 插件以当前 DSH 进程权限运行，安装前建议先检查源码与许可证（本项目为 MIT）。
- 秀米是闭源 SaaS，页面结构随时可能改版；选择器集中在
xiumi-lib.mjs与references/dom-playbook.md，改版后按手册更新。 - 只支持 Chromium 系浏览器（Edge/Chrome）的 CDP 调试口。
- 浏览器 ≥136 不允许默认 profile 开调试口，必须用复制出来的 profile（脚本已处理）；复制时若源浏览器在运行，
Cookies可能被锁定，需退出源浏览器或直接在调试窗口登录一次。 - 秀米「我的图库」有容量上限（常见 100 张）。
- 本项目不绕过任何平台限制，仅自动化你本来就能在界面上完成的操作，使用需遵守秀米服务条款。
结尾¶
dsh-xiumi 的价值在于把秀米里那条没有一键入口的排版链路固化成 CLI，并附带原生组件粘贴与排版质检两个增量能力。它不含模型代理，也不外发数据。目录页在 https://www.skillhub.cn/plugins/oobitoooo/dsh-xiumi ，源码在 https://github.com/oobitoooo/dsh-xiumi 。
