徽章使用說明

DSHIO 有兩種徽章，發的人不同、意思不同、用的條件也不同。兩者互相獨立，可以只用一個，也可以自由組合。

一、兩種徽章

① 標準遵循徽章

發布方	DSHIO.ORG
意思	這個插件按 DSHIO/T 10—2026 的結構要求編寫
誰能用	任何人 —— 只要你按標準寫，不需要檢測，不需要申請
怎麼用	直接引用固定 URL，見下文

它不表示「測過」。標準遵循徽章說的是「我照這個規矩寫的」，不是「有人測過我」。

② 檢測結果徽章

發布方	各檢測機構自己（deepseekbase.com 是其中一家）
意思	某機構按 DSHIO/T 20 + T21 測過，結果如徽章所示
誰能用	被該機構檢測過、且結果為 `passed` 的插件
怎麼用	用出具報告的那家機構提供的徽章

徽章上的機構名很重要。它告訴讀者「這是誰說的」。換一家檢測機構，徽章就該跟著換。

二、自由組合

標準與檢測是兩件事，可以隨意搭配。
你可以在 A 機構測，用 DSHIO 的標準徽章；也可以不測，只掛標準徽章；還可以在兩家機構各測一次，兩個檢測徽章都掛。

幾種常見組合

你的情況	建議
按標準寫了，但還沒測	只掛標準遵循徽章
在 deepseekbase.com 測通過了	標準徽章 + deepseekbase 檢測徽章（推薦，信息最全）
在別家機構測通過了	標準徽章 + 那家機構的檢測徽章
在兩家都測了，結論一致	三個都掛 —— 兩個檢測徽章並列，可信度更高
測了但沒通過	不要掛檢測徽章。標準徽章仍可用（如果結構確實符合）

三、怎麼用標準徽章

固定 URL，不需要註冊、不需要 API key：

# 默认（flat）
https://dshio.org/badge/std.svg

# 其他样式
https://dshio.org/badge/std.svg?style=flat-square
https://dshio.org/badge/std.svg?style=plastic

Markdown

[![DSHIO/T 10](https://dshio.org/badge/std.svg)](https://dshio.org/10/)

HTML

<a href="https://dshio.org/10/">
  <img src="https://dshio.org/badge/std.svg" alt="DSHIO/T 10">
</a>

reStructuredText

.. image:: https://dshio.org/badge/std.svg
   :target: https://dshio.org/10/
   :alt: DSHIO/T 10

四、怎麼用檢測徽章

檢測徽章由出具報告的機構提供。不同機構的 URL 不同，問你的檢測機構要。

以 deepseekbase.com 為例：

https://deepseekbase.com/badge/<slug>.svg
https://deepseekbase.com/badge/<slug>.json   # shields.io endpoint

<slug> 是插件名的 URL 化形式： @scope/pkg → scope-pkg，pkg → pkg。

四種狀態

徽章	狀態碼	含義
	`passed`	按標準條件通過
	`deviated`	通過，但測試條件偏離 T21
failed	`failed`	未通過
	`untested`	無檢測記錄

五、能做的與不能做的

✓ 可以

只用標準徽章，不做檢測
在多家機構各測一次，掛多個檢測徽章
把徽章放在 README、官網、npm 頁、部落格
改徽章尺寸（用 CSS 控制高度）
把標準徽章換成自己的圖（只要保留指向標準的鏈接）

✗ 不可以

沒測過卻掛檢測徽章 —— 這是虛假陳述
把檢測徽章說成「DSHIO 認證」 —— DSHIO 不做認證
用標準徽章暗示「已通過檢測」 —— 標準遵循 ≠ 檢測通過
改檢測徽章上的機構名 —— 那等於冒用他人名義
測了沒通過卻只掛標準徽章暗示通過 —— 誤導

關於「認證」
DSHIO 目前不提供認證（DSHIO/T 32 認證規則仍在試行、未啟用）。任何聲稱獲得 DSHIO 認證的表述均為虛假。
檢測報告不是認證。檢測徽章也不是認證。

六、為什麼要分兩種

因為它們回答的是兩個不同的問題：

問題	誰回答
「你按什麼規矩做的？」	標準遵循徽章（DSHIO 定義規矩）
「有人驗過嗎？結果怎樣？」	檢測結果徽章（各機構給結論）

把這兩個混在一起，讀者就不知道該信誰了。

七、如果你是檢測機構

你不需要 DSHIO 批准，只要滿足 DSHIO/T 36 的條件：

按 DSHIO/T 20 的方法執行 T0–T4
遵守 DSHIO/T 21 的測試條件
保留全部階段原始輸出並公開
對外發布的判定執行 2 次且一致
公開利益衝突聲明

然後你可以：

用自己的品牌發檢測徽章（我們不限制樣式，只要求寫清機構名）
或用我們的開源徽章生成器（dshio-checker 倉庫）
把機構信息提交到 T36 附錄 A 的公開名單（資訊目錄，非批准）

DSHIO 對任何檢測報告不背書。
誰出的報告，誰對真假負責。讀者看到檢測徽章時應該清楚：「這是 XX 機構說的，不是 DSHIO 說的。」

八、常見問題

Q: 我按標準寫了，但沒測，能掛標準徽章嗎？

能。標準徽章只表示「按此標準編寫」。

Q: 檢測徽章一定是 deepseekbase.com 的嗎？

不是。任何符合 DSHIO/T 36 條件的機構都可以發，用哪家取決於你在哪測的。

Q: 兩家機構結論不一樣怎麼辦？

兩個徽章都掛，讓讀者看到分歧。依 DSHIO/T 36 §7，分歧應公開，不得擇優採用。

Q: 徽章可以自己改顏色/尺寸嗎？

尺寸可以（CSS）。顏色和文字不要改 —— 那會改變徽章表達的意思。

Q: 徽章背面有鏈接嗎？

你掛的時候自己加。標準徽章應指向 dshio.org/10/，檢測徽章應指向該機構的報告頁（不是機構首頁）。

Q: 為什麼 dshio.org 只發標準徽章，不發檢測徽章？

因為 DSHIO 不做檢測。讓標準機構發檢測徽章，等於既定規矩又當裁判。