有没有教程？不会使用....

[ak-2019]

进到这个页面都不知道干嘛

[lefarcen]

Hi @ak-2019! I can see why this first screen is confusing — it is asking you to pick a local coding-agent CLI before entering the editor.

Quick path:

1. Make sure you have at least one supported CLI installed and logged in, such as Claude Code / Codex / Gemini CLI / Cursor Agent.
2. On that first screen, click ↻ 重新检测, choose one item under 已安装, then click 进入编辑器 →.
3. In the editor, paste or upload your content on the left, then click 生成 HTML or press ⌘/Ctrl + Enter.
4. If you only want to try it locally from source, the README quickstart is:

   git clone https://github.com/nexu-io/html-anything
   cd html-anything
   pnpm install
   pnpm dev
   # open http://localhost:3000

The Chinese README has the current quickstart here too: https://github.com/nexu-io/html-anything/blob/main/README.zh-CN.md#-30-%E7%A7%92%E4%B8%8A%E6%89%8B

If your screen shows 没有检测到任何本地 agent, the missing step is installing/logging in to one of those CLIs first, then rescanning. If you already selected an agent but still do not know what to type next, tell us which agent you selected and we can add a clearer in-app tutorial for that flow.

[lefarcen]

@ak-2019 上面那几个步骤能帮你进入编辑器吗？

如果还是卡在截图里的第一页，最常见的原因是本机还没有可用的 agent：先安装并登录 Claude Code / Codex / Gemini CLI / Cursor Agent 其中一个，然后点 ↻ 重新检测，看到 已安装 后选中它，再点 进入编辑器 →。

如果你已经进到编辑器但不知道下一步做什么：在左侧粘贴一段 Markdown / 文本 / CSV，点中间的 生成 HTML（或按 ⌘/Ctrl + Enter）就会生成右侧预览。

你方便回一下现在卡在哪一步吗？比如：

1. 没有检测到任何本地 agent
2. 已经选中 agent，但不知道输入什么
3. 点了 生成 HTML 后没有结果

我再按你的具体卡点补一段更清楚的教程。

[leiz56638111-create]

我用openclaw之后，选择生成html，一直卡不出来。一直显示正在思考，这个怎么破？

[lefarcen]

@leiz56638111-create 这个更像是 OpenClaw 调用链卡住了，不是教程问题本身。我先按现在代码和历史 issue 对了一下：OpenClaw 这条链路不是逐字流式返回，它会等 openclaw agent --local --json ... 进程结束后再把最终 JSON 解析出来，所以短时间显示“正在思考”是正常的；但如果一直不结束，就需要看日志判断是 OpenClaw CLI 没返回，还是前端没有拿到结果。

你先试这几步：

1. 确认已经拉到最新 main，因为之前类似“生成了但界面还在生成中”的问题在 文档已经实际生成，但是界面显示还在生成中，结果没有返回来在预览界面。换了 openclaw 和 claude code, claude code更换过模型，都一样。 #8 / fix(convert): rescue HTML when agent uses Write tool (#7) #9 修过，Windows 下 OpenClaw 启动问题也在 在 Windows 上使用 html-anything 生成 HTML 时，agent 调用立即失败，报错 spawn EINVAL，耗时 0.0s，输出 0.0 KB。 #16 / fix(ux): consolidate Convert into a single coral chip + restore agent on reload + #16 follow-up #22 修过。
2. 在 HTML Anything 里点一次停止，然后用很短的输入重试，比如 写一个 3 行个人主页。
3. 如果还是卡住，请把左侧任务的日志贴出来，尤其是这几行：
   • spawn ...
   • stderr ...
   • error ...
   • 有没有 agent 进程退出
4. 也麻烦说一下你的系统是 Windows / macOS / Linux，以及终端里 openclaw agents list 能不能正常返回。

有了第 3/4 步的信息，就能判断是 OpenClaw 本身没结束、agent id 解析失败，还是输出 JSON 没被解析出来。

[leiz56638111-create]

@leiz56638111-create 这个更像是 OpenClaw 调用链卡住了，不是教程问题本身。我先按现在代码和历史 issue 对了一下：OpenClaw 这条链路不是逐字流式返回，它会等 openclaw agent --local --json ... 进程结束后再把最终 JSON 解析出来，所以短时间显示“正在思考”是正常的；但如果一直不结束，就需要看日志判断是 OpenClaw CLI 没返回，还是前端没有拿到结果。

你先试这几步：

1. 确认已经拉到最新 main，因为之前类似“生成了但界面还在生成中”的问题在 文档已经实际生成，但是界面显示还在生成中，结果没有返回来在预览界面。换了 openclaw 和 claude code, claude code更换过模型，都一样。 #8 / fix(convert): rescue HTML when agent uses Write tool (#7) #9 修过，Windows 下 OpenClaw 启动问题也在 在 Windows 上使用 html-anything 生成 HTML 时，agent 调用立即失败，报错 spawn EINVAL，耗时 0.0s，输出 0.0 KB。 #16 / fix(ux): consolidate Convert into a single coral chip + restore agent on reload + #16 follow-up #22 修过。

2. 在 HTML Anything 里点一次停止，然后用很短的输入重试，比如 写一个 3 行个人主页。

3. 如果还是卡住，请把左侧任务的日志贴出来，尤其是这几行：

   • spawn ...
   • stderr ...
   • error ...
   • 有没有 agent 进程退出

4. 也麻烦说一下你的系统是 Windows / macOS / Linux，以及终端里 openclaw agents list 能不能正常返回。

有了第 3/4 步的信息，就能判断是 OpenClaw 本身没结束、agent id 解析失败，还是输出 JSON 没被解析出来。

我调用cc解决了一开始的报错了，当时因为memory.md过大 导致了这样的情况发生 后来就正常了 但好像不能即时预览每一个的效果 另外，想问一下，以小红书格式生成后，选择导出png的话，图片是不完整的。想问，如果用小红书格式生成的话，应该怎么来解决图片分割的问题？

[lefarcen]

This is open for community help.

If you'd like to work on it, comment /claim below. The first /claim after the latest release gets it. Any comment, linked PR, or progress note keeps the claim active.

[lefarcen]

@leiz56638111-create 明白，memory.md 过大这个反馈很有用，说明前面那次卡住更像是 OpenClaw/上下文体积导致的；这块你已经绕过去了就好。

关于你后面两个点：

1. OpenClaw 不能即时预览每一步效果：这个目前是符合现在适配器实现的。OpenClaw 在本项目里走的是“等进程结束后返回一个完整 JSON”的模式，不像 Claude Code / Codex 这类能持续吐 text delta 的 agent，所以它通常只能在最终结果出来后更新预览。如果你想看边生成边预览，建议先用支持流式输出的 agent。

2. 小红书格式导出 PNG 不完整：这个很可能是当前导出能力的限制。现在普通“下载 PNG”是把整个 iframe 截成一张长图；小红书图文卡片模板会生成多张 1080×1440 卡片纵向堆叠，卡片多了以后会超过浏览器/截图库对单张长图的安全高度，底部就容易被截掉。

现在可用的绕法：

• 如果你用的是 deck-xhs-* 这类 Deck 模板，并且导出菜单里出现了 Deck PNG ZIP / 每页 PNG，优先用这个，它会按页拆图。
• 如果你用的是 card-xiaohongshu 这种多卡片纵向堆叠模板，目前先让 agent “一次只生成 1 张/少量卡片”，分别导出；或者让它输出每张卡片为独立 HTML 后逐张导出。
• 我也给这个 issue 加了 help wanted：更理想的修法是新增“小红书卡片按张拆分导出 ZIP”，自动识别每张 1080×1440 卡片并逐张截图，而不是截一张超长图。

如果你方便的话，贴一下你生成出来的 HTML 或者截图里卡片的结构（是 deck-xhs-* 还是 card-xiaohongshu），我可以再帮你判断当前应该走“Deck PNG ZIP”还是“需要拆卡导出”的路径。

[leiz56638111-create]

我看了一下日志，用的是 card-xiaohongshu ，看看那种方便呢？
或者能不能在调用模板的时候增加一步选项呢？

[lefarcen]

@leiz56638111-create 如果确认是 card-xiaohongshu，我建议这样分：

现在最方便的用法：如果你要“一套小红书多图直接导出多张 PNG”，先用 deck-xhs-post / deck-xhs-* 这类模板会更顺手，因为它能走现有的 Deck PNG ZIP，按页导出。

card-xiaohongshu 的更合理修法：我觉得不只是“调用模板时多一个选项”，更应该在导出侧加一个专门动作：

• 模板继续生成多张 1080×1440 卡片；
• 每张卡片外层固定加一个可识别的 wrapper，比如 class="xhs-card" / data-card-id；
• 导出菜单检测到这些卡片后，出现 小红书分张 PNG ZIP；
• 点击后逐张截图并打包，而不是截一张超长图。

调用模板时加选项也有用，但更适合作为补充，比如：

• 卡片数量：3 / 6 / 9 张
• 输出方式：长图预览 / 分卡导出友好

所以我的判断是：短期你用 deck-xhs-* 最省事；长期产品上应该给 card-xiaohongshu 加“按卡片拆分导出”的导出能力，模板选项再配合控制卡片数量。

这个 issue 已经有 help wanted 了，如果有人想做 PR，我建议就按上面这个“小红书分张 PNG ZIP”范围切，比较清楚也不会影响普通 PNG 导出。

[leiz56638111-create]

我换用一下deck 试试看 btw 现在的任务上限是9对吧？

[lefarcen]

@leiz56638111-create 可以，先换 deck-xhs-* 试是对的。

“上限 9”这里分两种：

• 如果你说的是左侧任务数量：代码里目前没有看到硬性的 9 个任务上限，左侧任务是可以继续新增的。
• 如果你说的是小红书卡片/页数：9 更像是推荐值，不是硬上限。card-xiaohongshu 这边模板写的是短内容 3–6 张起步，长内容可以更多；但小红书单帖平台层面通常建议控制在 9 张以内，最多大概 18 张。deck-xhs-post 这类模板也是建议总页数 ≤18。

所以实操上我建议：

• 普通图文：先控制在 6–9 张，更稳；
• 内容很多：可以到 12–18 张，但更需要分张导出 ZIP；
• 如果只是测试导出链路，先用 3 张最容易判断问题。

[leiz56638111-create]

任务是可以新增 但超过9个的历史任务 好像找不到了
另外，用deck-xhs-post这样的模板 我发现导出选项里并没有 Deck PNG ZIP / 每页 PNG 这个选项