# snp

**Repository Path**: iiangs/snp

## Basic Information

- **Project Name**: snp
- **Description**: SNP - Style Negotiation Protocol V0.1 - 通用样式协商协议
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-23
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# README\.md

# Style Negotiation Protocol \(SNP\) V2\.0

**样式协商协议 \| 让全网所有软件，支持统一用户样式调度**

SNP 是一套**社区开源、跨平台、无侵入**的样式协商标准。打破「各软件样式孤岛」，允许网站、桌面应用、移动端、命令行工具主动声明样式托管能力，由浏览器、系统、插件统一调度配色，实现**一次设置、全网统一样式**。

## ✨ 核心哲学

- **结构归开发者，样式归用户**：业务系统保留布局、交互、逻辑主权，出让配色调度权

- **协商而非强制**：网站主动声明授权，无暴力覆盖、无样式错乱

- **跨平台通用**：不绑定 HTML、不绑定浏览器，适配所有可渲染样式的软件

- **静默降级**：不支持协议的系统自动兜底，不破坏原有功能

- **核心极简，生态共建**：基础协议永久稳定，细化规范由社区迭代完善

## 🚫 行业现存痛点

- 传统夜间模式/样式插件：暴力反色、篡改原生主题、图片错乱、布局崩坏

- 各网站主题独立：无统一标准，用户无法全网统一配色、字体、护眼样式

- 平台割裂：网页、APP、桌面软件样式体系互不通用

- 原生主题优先级混乱：系统、浏览器、插件多层冲突

## ✅ SNP 核心优势

- **智能识别原生主题**：已自带夜间模式的网站，插件绝不重复篡改

- **精准无侵入改色**：仅替换标准语义化配色参数，不改布局、不改结构

- **三级声明兜底**：网页 Meta \> DNS TXT \> 公共域名查询接口

- **统一交互范式**：全平台通用的「查询能力\-下发参数\-返回结果」流程

- **极简接入**：一行代码即可完成基础适配

## 🔁 标准工作流程（全平台统一）

1. 控制方发现目标系统

2. 控制方查询系统 SNP 声明，获取协议支持状态、可调度参数集

3. 控制方通过标准通道下发样式参数

4. 系统应用样式，返回 `true/false` 标识成功/失败

## 📦 快速接入示例（domain\.com）

### 1\. HTML 网页声明（最高优先级）

最简接入（默认支持全部标准配色参数）

```html
<meta name="snp" content="V0.1">
```

完整精细化配置

```html
<meta name="snp-config" content='{
  "version": "0.1",
  "supported": true,
  "delegateMode": "accept",
  "presets": [{"id":"light","name":"浅色"},{"id":"dark","name":"深色"}],
  "exposedParams": ["background","text","primary","border","hover"]
}'>
```

### 2\. DNS TXT 域名声明

主机：`@` \| 类型：`TXT` \| TTL：`3600`

```Plain Text
snp=V0.1;supported=true;delegateMode=accept;presets=light,dark;exposedParams=background,text,primary
```

### 3\. 公共接口查询

控制方可通过公共接口预查询任意域名适配能力

GET `https://snp.iiang.cn/query?domain=domain\.com`

## 🎯 核心落地场景（浏览器夜间模式）

SNP 彻底重构浏览器夜间模式体验，实现三级智能适配：

- **已支持SNP \+ 自带夜间模式**：插件不篡改、不覆盖，保留网站原生优质暗色样式

- **已支持SNP \+ 无夜间模式**：精准变量改色，原生级顺滑暗色体验，无错乱

- **未支持SNP普通网站**：插件轻量化智能兜底优化，大幅提升护眼体验

## 📌 核心强制规则

- 多声明优先级：**网页完整配置 \&gt; 网页最简声明 \&gt; DNS 声明 \&gt; 公共接口**

- 多声明冲突：**后者覆盖前者**

- 控制方优先级：系统主题 \&gt; 平台原生设置 \&gt; 第三方控制方 \&gt; 默认样式

- 仅返回布尔结果，详细错误机制预留后续版本迭代

- 局部样式隔离由业务开发者自行实现，协议不强制约束

## 🤝 社区共建说明

- 本协议核心框架永久稳定，开源托管迭代

- 各平台落地细则、参数语义规范、通道标准由社区专家组共建完善

- 样式持久化、权限校验、特殊场景适配等，由各终端自行实现，不属于协议核心范畴

## 📄 项目文件说明

- `snp\-protocol\-v2\.0`：SNP V2\.0 正式协议规范（核心标准）

- `snp\-full\-declare\-example`：全套网页/DNS/接口落地示例

- `snp\-night\-mode\-application`：浏览器夜间模式落地应用方案

> （注：文档部分内容可能由 AI 生成）