AI/人工智能 on Svtter's Blog

sth：一个给 AI Agent 用的 HTML 预览服务器

Sat, 09 May 2026 12:00:00 +0800

我开源了一个小工具：static-html，命令行叫 sth。

它做的事情很简单：提供一个 HTTP 服务，让你把本地生成的 HTML 文件注册上去，然后在浏览器里预览。

为什么需要这个东西

问题出在 AI Agent 的输出上。

现在我用 Claude Code、OpenCode 这些 agent 干活，它们经常需要输出一些复杂的内容——代码评审汇总、对比分析、报价单、架构设计文档。这些内容用纯文本发到 Telegram 里，格式全乱了，表格看不了，代码高亮也没了。

总而言之就是一大坨。

最开始的做法是让 agent 直接在本地生成 HTML 文件，然后用浏览器打开。但问题在于：

agent 跑在服务器上，没有图形界面
本地生成的文件路径不确定，管理混乱
没有历史记录，发过的东西找不到

所以我需要一个服务：agent 把 HTML 文件"发"上去，然后给一个 URL，在任何设备的浏览器里打开就能看。手机和 PC 兼容性直接让 agent 来搞定就行。

sth 做了什么

sth 是一个 Go 写的轻量 HTTP 服务，核心就两个命令：

1
2
3
4
5


# 启动服务
sth start

# 发送 HTML 文件
sth send ./report.html

sth send 会把目标 HTML 文件和同目录下的资源文件（CSS、JS、图片等）打包上传，然后返回一个 URL。打开这个 URL 就能看到完整的页面效果。

实际跑在我的内网开发机上，agent 通过 --server 参数指定远程地址：

1

sth send ./report.html --server http://dev-1:3939

我的实际用法

目前 sth 主要跑在我的开发服务器上，和 Hermes Agent 配合使用。

Hermes 是我的日常 AI assistant，跑在 Telegram 上。当它需要输出复杂内容时——比如代码评审结论、技术方案对比、项目报价——会调用 html-report skill 生成一个格式精美的 HTML 文件，然后通过 sth send 发到预览服务器，最后把 URL 发给我。

整个流程是：

1
2
3
4


用户提问 -> Hermes Agent 分析
 -> 生成 HTML 报告（html-report skill）
 -> sth send 发到预览服务器
 -> 返回 URL -> 发到 Telegram

这样我在手机上点开链接就能看到排版良好的报告，而不是一坨纯文本。

元数据管理

除了基本的发送和预览，sth 还支持给 session 打标签、分类、关联项目：

1
2
3
4
5


sth tag <session-id> code-review pricing
sth categorize <session-id> "技术评审"
sth project <session-id> hydrogen-permeation
sth list --project hydrogen-permeation
sth search "报价" --tag pricing

这个功能解决了一个实际问题：时间一长，发过的报告会积攒很多。通过标签和项目分类，可以快速找到之前的输出。

list 和 search 的区别在于：list 是精确匹配元数据字段，search 是全文搜索。两者可以组合使用。

技术细节

语言：Go 1.24+
存储：SQLite（github.com/mattn/go-sqlite3，需要 CGO）
部署：单二进制文件，systemd 管理就行
构建：go build -o dist/sth ./cmd/html-server

就这么简单，没有多余的依赖。

开源

这个工具之前是 private repo，今天刚改成 public：sun-praise/static-html。

如果你也在用 AI Agent 做日常开发工作，并且遇到过"agent 输出的复杂内容在聊天工具里没法看"的问题，可以试试 sth。它足够轻量，够用就行。

DeepSeek + Claude Code: Thinking Block 兼容性问题分析

Thu, 30 Apr 2026 15:00:00 +0800

问题描述

在 Claude Code 中直接使用 DeepSeek 模型（如 deepseek-v4-flash）时，开启 extended thinking 后，多轮对话会触发 400 错误：

1

Bad Request: {"error":{"message":"The content[].thinking in the thinking mode must be passed back to the API.","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}

根因分析

调用链

1

Claude Code → DeepSeek Anthropic 兼容端点 (https://api.deepseek.com/anthropic)

协议不兼容

根据 DeepSeek Anthropic API 兼容文档，兼容情况如下：

Message 字段	支持状态
`content[].thinking`	✅ Supported
`content[].redacted_thinking`	❌ Not Supported

Claude Code 在 extended thinking 模式下的多轮对话中，会忠实地将上一轮返回的所有 thinking blocks（包括 redacted_thinking 类型）原样回传给 API。DeepSeek 不识别 redacted_thinking，因此报 400。

此外，DeepSeek 的 thinking block 格式与 Anthropic 原生协议存在差异，在 tool_use 场景下的回传逻辑也不完全兼容。

核心矛盾

Anthropic API 要求：extended thinking 模式下，content[].thinking 和 content[].redacted_thinking 必须原封不动回传
DeepSeek 兼容层：只支持 thinking，不支持 redacted_thinking
Claude Code 行为：按 Anthropic 协议硬编码，不区分目标端点类型

社区反馈

这是一个广泛存在的社区问题，几乎所有 CC 代理/路由项目都遇到了：

Issue	项目	标题
#1	cc-use	DeepSeek Thinking Mode Error: `content[].thinking` Must Be Passed Back
#878	openclaude	DeepSeek V4: reasoning_content must be passed back (400) on tool_calls
#1355	claude-code-router	CCR 代理 deepseek V4 思考时返回 400
#4543	new-api	ClaudeCode 接入 DeepSeek V4 遇到 400 reasoning_content 报错
#355	9router	DeepSeek API Error 400 – Missing reasoning_content
#16748	hermes-agent	DeepSeek /anthropic: stripped thinking blocks cause HTTP 400 on replay
#2414	cc-switch	Claude 使用 cc-switch 配置 deepseek-v4-pro，无法识别字段
#174	cc-haha	/compact 命令在使用 DeepSeek API 时无法工作

DeepSeek 官方回应

零回应。 也没必要回应。

首先，DeepSeek 没有公开的 API issue 仓库，所有反馈均发生在第三方项目中，无 DeepSeek 官方人员参与任何讨论。
其次，是否将 Anthropic 作为标准来兼容，我想 DeepSeek 应该是犹豫的。

临时解决方案

关闭 extended thinking — 用 DeepSeek 时在 CC 中关闭 thinking 模式
使用代理过滤 — 在 CC 和 DeepSeek 之间加一层代理，过滤掉 redacted_thinking blocks
换模型 — 非 thinking 场景使用 DeepSeek，thinking 场景使用 Anthropic 原生模型

OpenCode 为什么没有这个问题？

OpenCode (opencode-ai/opencode) 在架构上天然规避了这个问题，并非专门"修复"。

关键在 internal/llm/provider/anthropic.go 的 convertMessages 方法（第 60-119 行）：

构建 assistant 消息时，只回传 TextContent（文本）和 ToolCall（工具调用）
完全忽略 ReasoningContent（thinking 内容），不放入 messages
thinking 内容仅通过 stream 的 thinking_delta 事件在 UI 展示，不会回传给 API

对比 Claude Code 的行为：

	Claude Code	OpenCode
thinking 回传	✅ 忠实回传所有 thinking blocks（含 redacted_thinking）	❌ 不回传 thinking blocks
架构原因	遵循 Anthropic API 规范，要求原样回传	自行管理对话状态，thinking 仅用于 UI 展示
DeepSeek 兼容性	❌ 触发 400（redacted_thinking 不被识别）	✅ 不受影响（根本不传 thinking）

结论：OpenCode 避开问题的方式是以不遵循 Anthropic extended thinking 规范为代价的。 这种做法对 DeepSeek 等第三方兼容端点友好，但如果未来需要 Anthropic 原生的 thinking 上下文保持能力，可能需要重新实现。

不回传 thinking blocks 是否会影响 DeepSeek 性能？

基本不会，原因：

thinking blocks 是模型的内部 scratchpad，不是最终输出。对话历史里的文本回复和工具调用已经保留了关键决策和结论
DeepSeek 的 reasoning 更接近 OpenAI 的模式——每轮独立生成，不像 Anthropic 那样强依赖跨轮回传来保持推理连贯性
OpenCode 的大量实际使用也印证了这一点——社区用户在 OpenCode 中用 DeepSeek thinking 模式跑多轮对话，没有反馈过推理质量下降的问题

真正可能受影响的极端场景：超长多轮任务中，模型可能重复之前已经推理过的结论。但在大多数实际使用中影响可忽略。

Issue	标题	状态
#10199	API Error 400 - Thinking Block Modification Error	Open (oncall)
#51985	thinking block missing in multi-turn conversations	Open
#20692	thinking blocks order error on first tool use	Open (oncall)
#54482	Thinking blocks stripped from context every turn (Opus 4.7)	Open

如何解决 opencode 中 deepseek 模型的 reasoning 问题

Fri, 24 Apr 2026 12:23:58 +0800

当我们使用 deepseek-reasoner 的时候，往往会遇到这个问题：

1

The reasoning_content' in the thinking mode must be passed back to the API.

更新

现在两个问题都已经被 opencode 官方解决。用户只需要安装最新的 opencode，通过 deepseek provider 即可使用，无需额外配置。

1
2
3
4
5
6


问题1
The reasoning_content' in the thinking mode must be passed back to the API.

问题2
Bad Request: {"error":{"message":"The content[].thinking in the thinking mode must be passed back to the
API.","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}

这两个问题已经被官方解决。安装 1.14.29 以及以上版本即可。

以下旧的解决方法：

怎么解决呢？也容易。

如何配置

添加 provider 信息到配置中：

.config/opencode/opencode.json 或者 .config/opencode/opencode.jsonc

修改 provider 部分为：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40


{
 "provider": {
 "deepseek": {
 "npm": "@ai-sdk/anthropic",
 "name": "DeepSeek",
 "options": {
 "baseURL": "https://api.deepseek.com/anthropic",
 "apiKey": "<apikey>"
 },
 "models": {
 "deepseek-v4-pro": {
 "name": "DeepSeek-V4-Pro",
 "limit": {
 "context": 1048576,
 "output": 262144
 },
 "options": {
 "thinking": {
 "type": "enabled",
 "budgetTokens": 8192
 }
 }
 },
 "deepseek-v4-flash": {
 "name": "DeepSeek-V4-Flash",
 "limit": {
 "context": 1048576,
 "output": 262144
 },
 "options": {
 "thinking": {
 "type": "enabled",
 "budgetTokens": 8192
 }
 }
 }
 }
 }
 }
}

如何使用

选择 deepseek 模型。

效果。

补充

这个方式无法解决问题

Bad Request: {"error":{"message":"The content[].thinking in the thinking mode must be passed back to the API.","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}

如果你遇到这个问题，还需要等待 opencode 去修复。

相关文章：DeepSeek + Claude Code: Thinking Block 兼容性问题分析 — 分析了 Claude Code 使用 DeepSeek 时 extended thinking 模式下多轮对话触发 400 错误的根因，以及社区解决方案。