更新密码找回uniapp
This commit is contained in:
1 parent
7f9a66da0f
commit
3fdda89833
1304 files changed
+3503
-26132
No files matched your search
@@ -1,26 +1,10 @@
|
||||
package holiday
|
||||
|
||||
// fallbackData 内置的 2024-2026 年中国法定节假日/调休数据,
|
||||
// 数据严格来自国务院办公厅历年《关于部分节假日安排的通知》原文。
|
||||
//
|
||||
// 用途:当外网接口不可达(内网部署、机房无外网出口、接口临时故障)且数据库
|
||||
// 中也没有对应年份数据时,用本表兜底,保证日历控件always能显示休/班标记。
|
||||
//
|
||||
// 维护约定:每年 11 月国务院办公厅发布次年通知后,按下述格式补齐新一年数据
|
||||
// (只补休假日与调休上班日两类,普通周末由前端按星期判定,不入表):
|
||||
//
|
||||
// notices = append(notices, yearNotice{Year: 2027, ...})
|
||||
//
|
||||
// 注意:这里只存"放假"与"补班"两类特殊日期;普通周六日不记录。
|
||||
var fallbackData = buildFallback()
|
||||
|
||||
// yearNotice 单一年度的放假安排,按通知原文逐条录入。
|
||||
type yearNotice struct {
|
||||
Year int
|
||||
// Holidays 放假日期区间:[开始日, 结束日],闭区间。
|
||||
// 结束日与开始日相同表示只放一天;空串表示结束日等于开始日。
|
||||
Holidays []dayRange
|
||||
// Workdays 调休上班日(周末补班)。
|
||||
Workdays []string
|
||||
}
|
||||
|
||||
@@ -30,12 +14,6 @@ type dayRange struct {
|
||||
Name string
|
||||
}
|
||||
|
||||
// yearNotices 各界各类节日的原始安排。
|
||||
//
|
||||
// 数据来源:
|
||||
// - 2024:国办发明电〔2023〕7号
|
||||
// - 2025:国办发明电〔2024〕12号
|
||||
// - 2026:2025年11月4日国办通知
|
||||
var yearNotices = []yearNotice{
|
||||
{
|
||||
Year: 2024,
|
||||
@@ -92,7 +70,6 @@ var yearNotices = []yearNotice{
|
||||
},
|
||||
}
|
||||
|
||||
// buildFallback 把 yearNotices 展开成按日期索引的 Day 列表。
|
||||
func buildFallback() []Day {
|
||||
out := make([]Day, 0, 256)
|
||||
for _, n := range yearNotices {
|
||||
|
||||
@@ -9,35 +9,13 @@ import (
|
||||
"time"
|
||||
)
|
||||
|
||||
// =============================================================
|
||||
// 外网数据源拉取(仅在"内置数据未覆盖该年份"时才会走到这里)
|
||||
//
|
||||
// 数据源是 holiday-cn(NateScarlet/holiday-cn):其数据由脚本从国务院办公厅
|
||||
// 通知原文生成,JSON 内的 papers 字段直接给出对应的 gov.cn 通知链接,
|
||||
// 字段精简(date/name/isOffDay),每年 11 月通知发布后由维护者及时更新。
|
||||
//
|
||||
// 实测延迟(2026-09,本机):
|
||||
// - fastly.jsdelivr.net 0.43s ← 采用,TLS 握手最快
|
||||
// - cdn.jsdelivr.net 0.85s
|
||||
// - raw.githubusercontent 0.65s
|
||||
// - timor.tech 已被 Cloudflare 拦截(403 + HTML 挑战页),已移除
|
||||
//
|
||||
// 注意:不要用 apihubs.cn 之类的国内接口做主力——实测它有严格频率限制,
|
||||
// 连续请求会直接返回「请求过于频繁」,前端每次翻月都会打,很容易被限流。
|
||||
// 对已收录的年份,我们根本不走网络(见 FetchYear),因此无需冒这个风险。
|
||||
// =============================================================
|
||||
|
||||
const (
|
||||
// sourceHolidayCNURL holiday-cn 按年份提供的 JSON,{year} 为年份占位符。
|
||||
// 用 fastly 节点的 jsDelivr,实测 TLS 握手比默认 cdn 节点快一倍。
|
||||
sourceHolidayCNURL = "https://fastly.jsdelivr.net/gh/NateScarlet/holiday-cn@master/%d.json"
|
||||
// sourceHolidayCNMirrorURL 备用地址(同一内容,走 GitHub 原始域名)。
|
||||
sourceHolidayCNMirrorURL = "https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/%d.json"
|
||||
)
|
||||
|
||||
var httpClient = &http.Client{Timeout: 6 * time.Second}
|
||||
|
||||
// holidayCNPayload holiday-cn 的 JSON 结构。
|
||||
type holidayCNPayload struct {
|
||||
Year int `json:"year"`
|
||||
Days []struct {
|
||||
@@ -47,8 +25,6 @@ type holidayCNPayload struct {
|
||||
} `json:"days"`
|
||||
}
|
||||
|
||||
// fetchYearFrom 从某个数据源拉取一整年的节假日数据。
|
||||
// 返回的 src 为该数据源的来源标记,便于写入缓存时记录出处。
|
||||
func fetchYearFrom(year int, url string, src string) ([]Day, error) {
|
||||
body, err := httpGet(fmt.Sprintf(url, year))
|
||||
if err != nil {
|
||||
@@ -83,10 +59,6 @@ func fetchYearFrom(year int, url string, src string) ([]Day, error) {
|
||||
return finalize(out), nil
|
||||
}
|
||||
|
||||
// httpGet 带基本校验的 GET:拒绝非 JSON 响应。
|
||||
// 校验响应体而不只看状态码,是因为 CDN/网关在异常时可能返回 HTTP 200 +
|
||||
// 一页 HTML 错误页(timor.tech 被 Cloudflare 拦截时就是这种表现),
|
||||
// 若只判状态码会误认为成功,进而把 HTML 当 JSON 解析失败或写入脏数据。
|
||||
func httpGet(url string) ([]byte, error) {
|
||||
req, err := http.NewRequest(http.MethodGet, url, nil)
|
||||
if err != nil {
|
||||
@@ -103,7 +75,6 @@ func httpGet(url string) ([]byte, error) {
|
||||
if resp.StatusCode != http.StatusOK {
|
||||
return nil, fmt.Errorf("HTTP %d", resp.StatusCode)
|
||||
}
|
||||
// 限制读取上限,避免异常响应把内存打满
|
||||
body, err := io.ReadAll(io.LimitReader(resp.Body, 1<<20))
|
||||
if err != nil {
|
||||
return nil, err
|
||||
@@ -127,24 +98,16 @@ func trimSpaceBytes(b []byte) []byte {
|
||||
return b[start:end]
|
||||
}
|
||||
|
||||
// finalize 归一化一份数据:去重、排序、补薪资倍数。
|
||||
func finalize(list []Day) []Day {
|
||||
out := dedupSort(list)
|
||||
return annotateWage(out)
|
||||
}
|
||||
|
||||
// ============================ 进程内缓存 ============================
|
||||
|
||||
// 说明:进程内缓存只用于避免同一次页面请求里对同一年的重复拉取,
|
||||
// 真正的持久化缓存在数据库(由控制器负责读写)。两者职责不同:
|
||||
// - 内存缓存:短期、防抖,进程重启即失效;
|
||||
// - 数据库缓存:长期、可复用,外网不可达时的第一顺位数据源。
|
||||
var (
|
||||
memMu sync.RWMutex
|
||||
memCache = map[int][]Day{}
|
||||
)
|
||||
|
||||
// getMemYear 读内存缓存;命中的年份直接返回,不再走网络。
|
||||
func getMemYear(year int) ([]Day, bool) {
|
||||
memMu.RLock()
|
||||
defer memMu.RUnlock()
|
||||
@@ -158,16 +121,6 @@ func setMemYear(year int, list []Day) {
|
||||
memCache[year] = list
|
||||
}
|
||||
|
||||
// FetchYear 获取某一年的节假日数据。调用方(控制器)拿到结果后负责写入数据库缓存。
|
||||
//
|
||||
// 优先级(关键:已收录的年份完全不联网):
|
||||
// 1. 内存缓存;
|
||||
// 2. 内置数据(2024-2026 已收录)——直接返回,零网络请求、零延迟;
|
||||
// 3. 外网拉取(仅年份未收录时)——fastly.jsdelivr → GitHub raw。
|
||||
//
|
||||
// 之所以把内置数据排在联网之前,是因为它本身就是官方通知的抄录、与网络数据
|
||||
// 等价,却省掉了 0.4~0.9 秒的跨境 TLS 握手。日历每次翻月都会调用本函数,
|
||||
// 若每次都联网会造成明显的卡顿。
|
||||
func FetchYear(year int) (list []Day, src string, err error) {
|
||||
if year < 2000 || year > 2100 {
|
||||
return nil, "", fmt.Errorf("年份超出合理范围: %d", year)
|
||||
@@ -176,14 +129,12 @@ func FetchYear(year int) (list []Day, src string, err error) {
|
||||
return cached, sourceOf(cached), nil
|
||||
}
|
||||
|
||||
// 优先用内置数据:命中即返回,不发起任何网络请求。
|
||||
if builtin := builtinByYear(year); len(builtin) > 0 {
|
||||
finalized := finalize(builtin)
|
||||
setMemYear(year, finalized)
|
||||
return finalized, SourceBuiltin, nil
|
||||
}
|
||||
|
||||
// 内置未收录该年份(通常是次年通知尚未发布或需更早年份),才走网络。
|
||||
attempts := []struct {
|
||||
url string
|
||||
src string
|
||||
@@ -195,7 +146,6 @@ func FetchYear(year int) (list []Day, src string, err error) {
|
||||
for _, a := range attempts {
|
||||
got, ferr := fetchYearFrom(year, a.url, a.src)
|
||||
if ferr != nil {
|
||||
// 真正的失败(网络错误 / 响应非法)才换下一个源重试。
|
||||
lastErr = ferr
|
||||
continue
|
||||
}
|
||||
@@ -210,7 +160,6 @@ func FetchYear(year int) (list []Day, src string, err error) {
|
||||
return nil, "", fmt.Errorf("获取 %d 年节假日数据失败: %v", year, lastErr)
|
||||
}
|
||||
|
||||
// sourceOf 取一组数据的来源标记(同批数据来源一致,取首条即可)。
|
||||
func sourceOf(list []Day) string {
|
||||
if len(list) == 0 {
|
||||
return ""
|
||||
@@ -218,8 +167,6 @@ func sourceOf(list []Day) string {
|
||||
return list[0].Source
|
||||
}
|
||||
|
||||
// EnsureRanges 确保给定日期区间涉及的每个年份都有数据可用,
|
||||
// 返回区间内(含)的完整数据(已按日期升序)。数据缺失的年份静默跳过。
|
||||
func EnsureRanges(start, end string) []Day {
|
||||
startYear, okS := yearOf(start)
|
||||
endYear, okE := yearOf(end)
|
||||
@@ -230,7 +177,6 @@ func EnsureRanges(start, end string) []Day {
|
||||
for y := startYear; y <= endYear; y++ {
|
||||
list, _, err := FetchYear(y)
|
||||
if err != nil {
|
||||
// 该年份不可用(外网失败且无内置数据),跳过但不阻断其他年份
|
||||
continue
|
||||
}
|
||||
out = append(out, list...)
|
||||
@@ -244,7 +190,6 @@ func EnsureRanges(start, end string) []Day {
|
||||
return finalize(filtered)
|
||||
}
|
||||
|
||||
// yearOf 从 "YYYY-MM-DD" 解析年份。
|
||||
func yearOf(date string) (int, bool) {
|
||||
if len(date) < 4 {
|
||||
return 0, false
|
||||
|
||||
@@ -1,66 +1,38 @@
|
||||
// Package holiday 提供中国法定节假日/调休日数据。
|
||||
//
|
||||
// 数据获取优先级(从高到低):
|
||||
// 1. 内存缓存;
|
||||
// 2. 代码内置的 2024-2026 年数据(fallback.go,抄自国务院办公厅通知原文)——
|
||||
// 命中即返回,不发起任何网络请求;
|
||||
// 3. 数据库缓存(yz_backend_oa_holiday,由控制器读写);
|
||||
// 4. 外网开源接口(holiday-cn,仅内置未收录的年份才会走到)。
|
||||
//
|
||||
// 把内置数据放在联网之前是刻意的性能设计:日历每次翻月都会请求,而跨境
|
||||
// 请求的 TLS 握手就要 0.4~0.9 秒;内置数据与网络数据同源等价,直接用即可。
|
||||
// 本包只处理"休假日"与"调休上班日"两类特殊日期,普通周末由前端按星期判定。
|
||||
package holiday
|
||||
|
||||
import (
|
||||
"time"
|
||||
)
|
||||
|
||||
// 日期类型。只有"休假日"与"调休上班日"两类需要落库——
|
||||
// 普通周末可以直接由星期几推算(周六日即周末),无需存储。
|
||||
const (
|
||||
// TypeWorkday 调休上班日(周末补班),前端显示「班」角标
|
||||
TypeWorkday int8 = 0
|
||||
// TypeHoliday 法定节假日放假,前端显示「休」角标
|
||||
TypeHoliday int8 = 1
|
||||
)
|
||||
|
||||
// 数据来源标记,写入数据库 source 列,便于排查某年份数据是哪来的。
|
||||
const (
|
||||
SourceHolidayCN = "holiday-cn" // 外网源:cdn(fastly).jsdelivr.net/gh/NateScarlet/holiday-cn
|
||||
SourceBuiltin = "builtin" // 代码内置数据(2024-2026,官方通知抄录)
|
||||
SourceHolidayCN = "holiday-cn"
|
||||
SourceBuiltin = "builtin"
|
||||
)
|
||||
|
||||
// Day 某一天节假日信息的统一内部表示,也是写入缓存与返回前端的结构。
|
||||
type Day struct {
|
||||
// Date "YYYY-MM-DD"
|
||||
Date string `json:"date"`
|
||||
// Name 节日名称,如「国庆节」「春节」;调休上班日固定为「调休上班」
|
||||
Name string `json:"name"`
|
||||
// Type 0 调休上班 / 1 法定放假;普通周末不入库、不返回
|
||||
Type int8 `json:"type"`
|
||||
// Year 所属年份
|
||||
Year int `json:"year"`
|
||||
// Wage 薪资倍数:1 普通,2 双倍,3 三倍(仅法定节假日当天为 3)
|
||||
Wage int8 `json:"wage"`
|
||||
// Source 数据来源标记
|
||||
Source string `json:"source"`
|
||||
}
|
||||
|
||||
// IsOffDay 是否休假日(法定放假)。注意普通周末不在本结构范围内,
|
||||
// 调用方判断"这天是否休息"时必须把周末一起算上。
|
||||
func (d Day) IsOffDay() bool {
|
||||
return d.Type == TypeHoliday
|
||||
}
|
||||
|
||||
// dateLayout 统一的日期字符串格式。
|
||||
const dateLayout = "2006-01-02"
|
||||
|
||||
func parseDate(s string) (time.Time, error) {
|
||||
return time.ParseInLocation(dateLayout, s, time.Local)
|
||||
}
|
||||
|
||||
// normalizeDate 把可能带时分秒的时间串统一裁剪成 "YYYY-MM-DD"。
|
||||
func normalizeDate(s string) string {
|
||||
if len(s) > 10 {
|
||||
return s[:10]
|
||||
@@ -68,7 +40,6 @@ func normalizeDate(s string) string {
|
||||
return s
|
||||
}
|
||||
|
||||
// expandRange 展开 [start, end] 闭区间为逐日列表;end 为空时视为仅 start 一天。
|
||||
func expandRange(start, end string) []string {
|
||||
if end == "" {
|
||||
end = start
|
||||
@@ -82,7 +53,6 @@ func expandRange(start, end string) []string {
|
||||
return nil
|
||||
}
|
||||
out := make([]string, 0, 16)
|
||||
// 防御:区间异常(结束早于开始)或跨度过大时直接放弃,避免死循环
|
||||
if et.Before(st) {
|
||||
return nil
|
||||
}
|
||||
@@ -95,8 +65,6 @@ func expandRange(start, end string) []string {
|
||||
return out
|
||||
}
|
||||
|
||||
// wageOfHolidayName 依据节日名与日期在假期中的位置推断倍数。
|
||||
// 春节、国庆按"第几天"判断:前 3 天为三薪;其余节日首日为三薪。
|
||||
func wageOfHolidayName(name string, indexInRange int) int8 {
|
||||
switch name {
|
||||
case "春节", "国庆节", "国庆节、中秋节":
|
||||
@@ -112,8 +80,6 @@ func wageOfHolidayName(name string, indexInRange int) int8 {
|
||||
}
|
||||
}
|
||||
|
||||
// Years 返回内置兜底数据覆盖的年份,用于告知调用方"网络与缓存都没有时
|
||||
// 还能覆盖到哪一年",便于在接口响应里给出提示。
|
||||
func Years() []int {
|
||||
seen := make(map[int]bool, len(yearNotices))
|
||||
out := make([]int, 0, len(yearNotices))
|
||||
@@ -126,7 +92,6 @@ func Years() []int {
|
||||
return out
|
||||
}
|
||||
|
||||
// builtinByYear 取某年份的内置数据;年份未收录时返回空切片。
|
||||
func builtinByYear(year int) []Day {
|
||||
out := make([]Day, 0, 32)
|
||||
for _, d := range fallbackData {
|
||||
@@ -137,8 +102,6 @@ func builtinByYear(year int) []Day {
|
||||
return out
|
||||
}
|
||||
|
||||
// annotateWage 依据同一节日的连续区间,为每天补上正确的薪资倍数。
|
||||
// 输入需按日期升序排列;同名的连续日期视为同一次放假。
|
||||
func annotateWage(list []Day) []Day {
|
||||
if len(list) == 0 {
|
||||
return list
|
||||
@@ -147,7 +110,6 @@ func annotateWage(list []Day) []Day {
|
||||
indexInRange := 0
|
||||
for i := range list {
|
||||
if list[i].Type != TypeHoliday {
|
||||
// 调休上班日与普通日期不参与倍数计算,同时打断连续区间
|
||||
prevName = ""
|
||||
indexInRange = 0
|
||||
list[i].Wage = 1
|
||||
@@ -164,7 +126,6 @@ func annotateWage(list []Day) []Day {
|
||||
return list
|
||||
}
|
||||
|
||||
// dedupSort 按日期去重并升序排列;同日重复时保留先出现的记录。
|
||||
func dedupSort(list []Day) []Day {
|
||||
seen := make(map[string]int, len(list))
|
||||
out := make([]Day, 0, len(list))
|
||||
@@ -173,8 +134,6 @@ func dedupSort(list []Day) []Day {
|
||||
continue
|
||||
}
|
||||
if idx, ok := seen[d.Date]; ok {
|
||||
// 已有同日记录:休假日优先于调休上班日(同一日期不会既休又班,
|
||||
// 但外网源偶有脏数据,这里做防御性取舍)
|
||||
if d.Type == TypeHoliday && out[idx].Type == TypeWorkday {
|
||||
out[idx] = d
|
||||
}
|
||||
@@ -188,7 +147,6 @@ func dedupSort(list []Day) []Day {
|
||||
}
|
||||
|
||||
func sortByDate(list []Day) {
|
||||
// 数据量极小(单年最多几十条),直接插入排序,避免引入 sort 包的比较器开销
|
||||
for i := 1; i < len(list); i++ {
|
||||
cur := list[i]
|
||||
j := i - 1
|
||||
|
||||
@@ -5,8 +5,6 @@ import (
|
||||
"time"
|
||||
)
|
||||
|
||||
// TestFallbackCovers2026 校验内置兜底数据与国务院办公厅 2026 年通知一致。
|
||||
// 这里的期望值直接抄自官方通知,属于"事实断言":一旦有人改错数据即失败。
|
||||
func TestFallbackCovers2026(t *testing.T) {
|
||||
got := builtinByYear(2026)
|
||||
if len(got) == 0 {
|
||||
@@ -18,7 +16,6 @@ func TestFallbackCovers2026(t *testing.T) {
|
||||
byDate[d.Date] = d
|
||||
}
|
||||
|
||||
// 元旦 1/1-1/3 放假;1/4 上班
|
||||
for _, d := range []string{"2026-01-01", "2026-01-02", "2026-01-03"} {
|
||||
if v, ok := byDate[d]; !ok || v.Type != TypeHoliday {
|
||||
t.Errorf("%s 应为放假日,实际 %+v", d, v)
|
||||
@@ -28,7 +25,6 @@ func TestFallbackCovers2026(t *testing.T) {
|
||||
t.Errorf("2026-01-04 应为调休上班日,实际 %+v", v)
|
||||
}
|
||||
|
||||
// 春节 2/15-2/23 放假,共 9 天;2/14、2/28 上班
|
||||
springCount := 0
|
||||
for _, d := range got {
|
||||
if d.Type == TypeHoliday && d.Name == "春节" {
|
||||
@@ -44,7 +40,6 @@ func TestFallbackCovers2026(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// 国庆 10/1-10/7 放假;9/20、10/10 上班
|
||||
nationalCount := 0
|
||||
for _, d := range got {
|
||||
if d.Type == TypeHoliday && d.Name == "国庆节" {
|
||||
@@ -60,7 +55,6 @@ func TestFallbackCovers2026(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// 中秋 9/25-9/27、端午 6/19-6/21、清明 4/4-4/6、劳动节 5/1-5/5
|
||||
cases := []struct {
|
||||
name string
|
||||
start string
|
||||
@@ -87,7 +81,6 @@ func TestFallbackCovers2026(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestFallbackAllYears 校验三年内置数据都能被索引到,且每年都有调休上班日。
|
||||
func TestFallbackAllYears(t *testing.T) {
|
||||
for _, y := range Years() {
|
||||
list := builtinByYear(y)
|
||||
@@ -108,7 +101,6 @@ func TestFallbackAllYears(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestAnnotateWage 校验薪资倍数标注:春节前 3 天三薪,其余两薪。
|
||||
func TestAnnotateWage(t *testing.T) {
|
||||
list := []Day{
|
||||
{Date: "2026-02-15", Name: "春节", Type: TypeHoliday},
|
||||
@@ -126,7 +118,6 @@ func TestAnnotateWage(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestExpandRange 校验日期区间展开。
|
||||
func TestExpandRange(t *testing.T) {
|
||||
got := expandRange("2026-02-15", "2026-02-23")
|
||||
if len(got) != 9 {
|
||||
@@ -135,21 +126,17 @@ func TestExpandRange(t *testing.T) {
|
||||
if got[0] != "2026-02-15" || got[8] != "2026-02-23" {
|
||||
t.Errorf("区间首尾错误: %v", got)
|
||||
}
|
||||
// 单日
|
||||
if one := expandRange("2026-01-01", ""); len(one) != 1 || one[0] != "2026-01-01" {
|
||||
t.Errorf("单日区间展开错误: %v", one)
|
||||
}
|
||||
// 跨月
|
||||
if cross := expandRange("2026-02-28", "2026-03-02"); len(cross) != 3 {
|
||||
t.Errorf("跨月区间展开错误: %v", cross)
|
||||
}
|
||||
// 异常区间不 panic 且返回空
|
||||
if bad := expandRange("2026-03-01", "2026-02-01"); len(bad) != 0 {
|
||||
t.Errorf("结束早于开始应返回空,实际 %v", bad)
|
||||
}
|
||||
}
|
||||
|
||||
// TestDedupSort 校验同日去重时休假日优先于调休上班日。
|
||||
func TestDedupSort(t *testing.T) {
|
||||
list := []Day{
|
||||
{Date: "2026-05-09", Name: "调休上班", Type: TypeWorkday},
|
||||
@@ -168,14 +155,10 @@ func TestDedupSort(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestFetchYearLive 联网校验真实数据源可用性(仅测"未收录年份"的联网分支)。
|
||||
// 2024-2026 走内置数据不联网,因此这里用 2023 年验证外网拉取能力;
|
||||
// 若外网不可用则跳过,不把 CI 绑死在第三方接口可用性上。
|
||||
func TestFetchYearLive(t *testing.T) {
|
||||
if testing.Short() {
|
||||
t.Skip("跳过联网测试")
|
||||
}
|
||||
// 2023 未被内置数据收录,必须联网
|
||||
list, src, err := FetchYear(2023)
|
||||
if err != nil {
|
||||
t.Skipf("外网不可用,跳过联网测试: %v", err)
|
||||
@@ -189,9 +172,6 @@ func TestFetchYearLive(t *testing.T) {
|
||||
t.Logf("2023 年数据来源: %s,共 %d 条", src, len(list))
|
||||
}
|
||||
|
||||
// TestBuiltinTakesPriority 校验已收录年份走内置数据、完全不联网。
|
||||
// 这是"日历翻月不卡顿"的核心保证:若哪天有人把网络查询挪到内置判断之前,
|
||||
// 本测试会立即失败。
|
||||
func TestBuiltinTakesPriority(t *testing.T) {
|
||||
for _, y := range []int{2024, 2025, 2026} {
|
||||
list, src, err := FetchYear(y)
|
||||
@@ -207,10 +187,7 @@ func TestBuiltinTakesPriority(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestFetchYearFastForBuiltin 量化验证内置路径的耗时:
|
||||
// 已收录年份必须是纯内存操作(远低于 50ms),而跨境网络请求至少要 300ms。
|
||||
func TestFetchYearFastForBuiltin(t *testing.T) {
|
||||
// 预热,排除首次调用的初始化开销
|
||||
_, _, _ = FetchYear(2026)
|
||||
|
||||
start := time.Now()
|
||||
|
||||
@@ -5,10 +5,7 @@ import (
|
||||
"time"
|
||||
)
|
||||
|
||||
// 验证 2027 年(国务院通知尚未发布,各数据源为空数组)不会再被误判为失败
|
||||
// 而继续请求被墙的备用源。修复前实测单次约 6 秒,修复后应接近一次 CDN 往返。
|
||||
func TestFetchYear2027NoWasteRetry(t *testing.T) {
|
||||
// 清空内存缓存,确保走完整路径
|
||||
memMu.Lock()
|
||||
memCache = map[int][]Day{}
|
||||
memMu.Unlock()
|
||||
@@ -29,7 +26,6 @@ func TestFetchYear2027NoWasteRetry(t *testing.T) {
|
||||
t.Fatalf("2027 拉取耗时 %v,疑似仍在重试备用源", elapsed)
|
||||
}
|
||||
|
||||
// 第二次必须命中内存缓存,几乎零耗时
|
||||
start2 := time.Now()
|
||||
list2, _, err2 := FetchYear(2027)
|
||||
elapsed2 := time.Since(start2)
|
||||
|
||||
@@ -1,10 +1,3 @@
|
||||
// Package identity 是所有接入端唯一的"当前请求是谁、能不能用这个端"入口。
|
||||
//
|
||||
// 背景:此前 88 个控制器各自从 Authorization 头解令牌、各自拼 user_type 白名单,
|
||||
// 一共 6 种写法,签发方与消费方一旦口径不一致就会出现"令牌有效却全判无权访问"
|
||||
// 这类故障(认证中心换码路径曾硬编码 user_type=tenant 即为一例)。
|
||||
// 新代码一律用 Require,存量控制器把自行解析的那段换成 Claims,
|
||||
// 全仓不再有任何一处自己拼「SplitN Authorization + ParseToken + 比 user_type」。
|
||||
package identity
|
||||
|
||||
import (
|
||||
@@ -17,21 +10,15 @@ import (
|
||||
"github.com/golang-jwt/jwt/v5"
|
||||
)
|
||||
|
||||
// End 接入端。令牌中的 user_type 必须属于所放行端之一,才能调用该端接口。
|
||||
type End string
|
||||
|
||||
const (
|
||||
EndPlatform End = "platform" // 平台端 /platform/**
|
||||
EndBackend End = "backend" // 租户(用户)端 /backend/**
|
||||
EndApp End = "app" // 移动端与小程序 /api/**
|
||||
// EndGuest 游客轻身份:小程序手机号授权签发的临时令牌(user_type=guest),
|
||||
// 仅免登录业务控制器显式放行,数据落在 yz_guest_data,转正后按手机号合并。
|
||||
EndPlatform End = "platform"
|
||||
EndBackend End = "backend"
|
||||
EndApp End = "app"
|
||||
EndGuest End = "guest"
|
||||
)
|
||||
|
||||
// 错误分类直接决定 HTTP 状态码,因此必须与前端拦截器行为对齐:
|
||||
// 令牌类问题返 401,request.js 会静默续期后用新令牌重放;
|
||||
// 端不匹配返 403,续期救不回来,若也返 401 只会白跑一轮刷新再失败。
|
||||
var (
|
||||
ErrNoToken = errors.New("未提供认证信息")
|
||||
ErrBadFormat = errors.New("认证信息格式错误")
|
||||
@@ -40,20 +27,15 @@ var (
|
||||
ErrWrongEnd = errors.New("无权访问")
|
||||
)
|
||||
|
||||
// Identity 一次请求解析出的调用者身份。
|
||||
// TenantID 只来自令牌,不接受任何请求参数覆盖,这是租户间隔离的唯一依据。
|
||||
type Identity struct {
|
||||
UserID int // 认证中心 identity_id
|
||||
UserID int
|
||||
Username string
|
||||
TenantID uint64 // 平台端账号为 0
|
||||
TenantID uint64
|
||||
End End
|
||||
ClientID string
|
||||
Sid string
|
||||
}
|
||||
|
||||
// normalizeEnd 把令牌里的 user_type 归一到端。
|
||||
// "tenant" 是认证中心换码路径早期硬编码签发的历史值,只可能来自 backend 登录流程,
|
||||
// 按 backend 放行;否则存量会话会在收口后集体变 403,而重新登录才能救回来。
|
||||
func normalizeEnd(userType string) End {
|
||||
if userType == "tenant" {
|
||||
return EndBackend
|
||||
@@ -61,18 +43,12 @@ func normalizeEnd(userType string) End {
|
||||
return End(userType)
|
||||
}
|
||||
|
||||
// Claims 解析 Authorization 头(含 "Bearer " 前缀)并校验其所属端在 allowed 之内,
|
||||
// 返回原始 claims。
|
||||
//
|
||||
// 存量控制器普遍按 claims.TenantId / claims.UserID 取值,逐一改成 Identity 既无收益也易出错;
|
||||
// 收口的目标是「解析与判端只有这一处」,取值方式可以沿用旧的。新代码请用 Require。
|
||||
func Claims(auth string, allowed ...End) (*jwtutil.Claims, error) {
|
||||
auth = strings.TrimSpace(auth)
|
||||
if auth == "" {
|
||||
return nil, ErrNoToken
|
||||
}
|
||||
parts := strings.SplitN(auth, " ", 2)
|
||||
// 认证方案名按 RFC 7235 大小写不敏感,个别控制器一直用 EqualFold,这里统一放宽。
|
||||
if len(parts) != 2 || !strings.EqualFold(parts[0], "Bearer") {
|
||||
return nil, ErrBadFormat
|
||||
}
|
||||
@@ -96,13 +72,10 @@ func Claims(auth string, allowed ...End) (*jwtutil.Claims, error) {
|
||||
return claims, nil
|
||||
}
|
||||
|
||||
// IsGuest 判断解析结果是否为游客令牌(user_type=guest)。
|
||||
// 控制器据此分流:游客请求不进业务表,走 gueststore 通用存储。
|
||||
func IsGuest(claims *jwtutil.Claims) bool {
|
||||
return claims != nil && claims.UserType == string(EndGuest)
|
||||
}
|
||||
|
||||
// PathEnd 按路由前缀判定接口属于哪个端;前缀不属于任何端时 ok=false。
|
||||
func PathEnd(path string) (End, bool) {
|
||||
p := strings.ToLower(path)
|
||||
switch {
|
||||
@@ -116,9 +89,6 @@ func PathEnd(path string) (End, bool) {
|
||||
return "", false
|
||||
}
|
||||
|
||||
// ClaimsByPath 给「同一个控制器同时挂在平台端和租户端前缀下」的接口用
|
||||
// (站点设置、功能模块清单就是这种)。放行哪个端由请求路径决定,
|
||||
// 而不是拿任意一端的合法令牌都能读写另一端的数据。
|
||||
func ClaimsByPath(auth, path string) (*jwtutil.Claims, error) {
|
||||
if end, ok := PathEnd(path); ok {
|
||||
return Claims(auth, end)
|
||||
@@ -126,9 +96,6 @@ func ClaimsByPath(auth, path string) (*jwtutil.Claims, error) {
|
||||
return Claims(auth, EndPlatform, EndBackend, EndApp)
|
||||
}
|
||||
|
||||
// Require 解析请求的 Bearer 令牌,并校验其所属端在 allowed 之内。
|
||||
// 用法:identity.Require(c.Ctx.Request, identity.EndBackend),
|
||||
// 确实需要跨端的接口再传多个,如 (..., identity.EndBackend, identity.EndApp)。
|
||||
func Require(r *http.Request, allowed ...End) (*Identity, error) {
|
||||
if r == nil {
|
||||
return nil, ErrNoToken
|
||||
@@ -152,9 +119,6 @@ func Require(r *http.Request, allowed ...End) (*Identity, error) {
|
||||
}, nil
|
||||
}
|
||||
|
||||
// classify 把令牌解析错误归一成"过期"或"无效"两类,二者都属令牌问题、都返 401,
|
||||
// 区分开是为了让前端与日志能看出是该续期还是该重新登录。
|
||||
// golang-jwt 的过期错误可能被包装,历史代码也用过裸字符串判断,两者都保留。
|
||||
func classify(err error) error {
|
||||
if errors.Is(err, jwt.ErrTokenExpired) || strings.Contains(err.Error(), "expired") {
|
||||
return ErrExpired
|
||||
@@ -162,7 +126,6 @@ func classify(err error) error {
|
||||
return ErrInvalid
|
||||
}
|
||||
|
||||
// Status 返回该错误应使用的 HTTP 状态码。
|
||||
func Status(err error) int {
|
||||
if errors.Is(err, ErrWrongEnd) {
|
||||
return http.StatusForbidden
|
||||
@@ -170,10 +133,6 @@ func Status(err error) int {
|
||||
return http.StatusUnauthorized
|
||||
}
|
||||
|
||||
// IsAuth 判断错误是否出自本包的鉴权分类。
|
||||
// 供「一个 fail(err) 同时兜业务错误与鉴权错误」的控制器使用:
|
||||
// 业务错误要按自己的语义给状态码,鉴权错误则必须走 Status,
|
||||
// 否则坏令牌会被当成 400 参数错误返回,前端既不会续期也不会跳登录。
|
||||
func IsAuth(err error) bool {
|
||||
return errors.Is(err, ErrNoToken) || errors.Is(err, ErrBadFormat) ||
|
||||
errors.Is(err, ErrExpired) || errors.Is(err, ErrInvalid) ||
|
||||
|
||||
@@ -12,8 +12,6 @@ import (
|
||||
"github.com/golang-jwt/jwt/v5"
|
||||
)
|
||||
|
||||
// 这些用例只覆盖不依赖数据库的身份判定:端归属、令牌错误分类、状态码映射。
|
||||
|
||||
func mint(t *testing.T, userType string) string {
|
||||
t.Helper()
|
||||
tok, err := jwtutil.GenerateToken(4, "hero920103", 2, userType)
|
||||
@@ -42,8 +40,6 @@ func TestRequireAcceptsMatchingEnd(t *testing.T) {
|
||||
}
|
||||
|
||||
func TestRequireRejectsForeignEnd(t *testing.T) {
|
||||
// 认证中心换码路径曾签发 user_type=tenant,落到这里就是「令牌有效但端不匹配」。
|
||||
// 这类失败续期救不回来,必须是 403,不能触发前端静默续期重放。
|
||||
for _, userType := range []string{"tenant", "user", "employee", "platform", ""} {
|
||||
_, err := Require(requestWith("Bearer "+mint(t, userType)), EndBackend)
|
||||
if !errors.Is(err, ErrWrongEnd) {
|
||||
@@ -90,8 +86,6 @@ func TestRequireTokenErrorsAreUnauthorized(t *testing.T) {
|
||||
}
|
||||
|
||||
func TestClassifyExpired(t *testing.T) {
|
||||
// SignToken/GenerateToken 都把非正数 TTL 钳成默认值,造不出真实过期令牌,
|
||||
// 因此这里直接验证错误分类:被包装的过期错误也要认出来。
|
||||
wrapped := fmt.Errorf("parse token: %w", jwt.ErrTokenExpired)
|
||||
if got := classify(wrapped); !errors.Is(got, ErrExpired) {
|
||||
t.Fatalf("包装后的过期错误应归类为 ErrExpired,实际 %v", got)
|
||||
|
||||
+14
-44
@@ -15,59 +15,48 @@ import (
|
||||
"github.com/golang-jwt/jwt/v5"
|
||||
)
|
||||
|
||||
// 算法常量
|
||||
const (
|
||||
AlgHS256 = "HS256"
|
||||
AlgRS256 = "RS256"
|
||||
)
|
||||
|
||||
// DefaultKid 默认密钥 ID。历史 token 未携带 kid,统一按此 ID 处理。
|
||||
const DefaultKid = "default"
|
||||
|
||||
// legacySecret 兼容用的内置密钥:仅用于解析历史已签发的 token。
|
||||
// 生产环境必须在 app.conf 中配置 jwt_secret,否则会一直使用该固定值。
|
||||
const legacySecret = "yunzer_jwt_secret_key"
|
||||
|
||||
// Claims JWT 载荷。旧字段保持不变,新增字段均为 omitempty,
|
||||
// 历史 token 解析后为零值,不影响现有 78 处解析点。
|
||||
type Claims struct {
|
||||
UserID int `json:"user_id"`
|
||||
Username string `json:"username"`
|
||||
TenantId int `json:"tenant_id"` // 租户ID
|
||||
UserType string `json:"user_type"` // 用户类型:"user" / "employee" / "platform" 等
|
||||
TenantId int `json:"tenant_id"`
|
||||
UserType string `json:"user_type"`
|
||||
|
||||
// ---- 统一认证中心(OIDC)扩展字段 ----
|
||||
ClientID string `json:"client_id,omitempty"` // 接入应用 client_id,即 aud 的业务标识
|
||||
Sid string `json:"sid,omitempty"` // 会话ID,用于单点登出/踢下线
|
||||
ClientID string `json:"client_id,omitempty"`
|
||||
Sid string `json:"sid,omitempty"`
|
||||
Scope string `json:"scope,omitempty"`
|
||||
Amr string `json:"amr,omitempty"` // 认证方式:pwd/sms/otp/wx/...
|
||||
Amr string `json:"amr,omitempty"`
|
||||
|
||||
// Events OIDC 事件声明,用于 Back-Channel Logout:
|
||||
// {"http://schemas.openid.net/event/backchannel-logout": {}}
|
||||
Events map[string]interface{} `json:"events,omitempty"`
|
||||
|
||||
jwt.RegisteredClaims
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 密钥管理
|
||||
|
||||
var (
|
||||
keyOnce sync.Once
|
||||
hsKeys map[string][]byte // kid -> HMAC 密钥
|
||||
rsaPriv *rsa.PrivateKey // RS256 签名
|
||||
rsaPub *rsa.PublicKey // RS256 验签
|
||||
rsaKid string // RS256 密钥 ID
|
||||
hsKeys map[string][]byte
|
||||
rsaPriv *rsa.PrivateKey
|
||||
rsaPub *rsa.PublicKey
|
||||
rsaKid string
|
||||
issuerVal string
|
||||
)
|
||||
|
||||
func loadKeys() {
|
||||
hsKeys = map[string][]byte{DefaultKid: []byte(legacySecret)}
|
||||
|
||||
// 主密钥(覆盖内置默认值)
|
||||
if s, _ := beego.AppConfig.String("jwt_secret"); strings.TrimSpace(s) != "" {
|
||||
hsKeys[DefaultKid] = []byte(strings.TrimSpace(s))
|
||||
}
|
||||
// 轮换密钥:jwt_secrets = kid1:secret1,kid2:secret2
|
||||
if s, _ := beego.AppConfig.String("jwt_secrets"); strings.TrimSpace(s) != "" {
|
||||
for _, item := range strings.Split(s, ",") {
|
||||
kv := strings.SplitN(strings.TrimSpace(item), ":", 2)
|
||||
@@ -77,7 +66,6 @@ func loadKeys() {
|
||||
}
|
||||
}
|
||||
|
||||
// RS256 密钥对:优先读文件路径,其次读内联 PEM
|
||||
privPEM := readKeyConf("jwt_rsa_private_key", "jwt_rsa_private_key_file")
|
||||
pubPEM := readKeyConf("jwt_rsa_public_key", "jwt_rsa_public_key_file")
|
||||
if privPEM != "" {
|
||||
@@ -116,8 +104,6 @@ func ensureKeys() {
|
||||
keyOnce.Do(loadKeys)
|
||||
}
|
||||
|
||||
// keyFunc 按 token header 的 alg + kid 选择验签密钥。
|
||||
// 未携带 kid 或 kid 未注册时回落到默认密钥,保证历史 token 仍可解析。
|
||||
func keyFunc(token *jwt.Token) (interface{}, error) {
|
||||
ensureKeys()
|
||||
kid, _ := token.Header["kid"].(string)
|
||||
@@ -136,12 +122,9 @@ func keyFunc(token *jwt.Token) (interface{}, error) {
|
||||
return nil, fmt.Errorf("unsupported signing method: %v", token.Header["alg"])
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 签发
|
||||
|
||||
// TokenOptions 认证中心签发参数
|
||||
type TokenOptions struct {
|
||||
Alg string // HS256 / RS256;留空时优先 RS256,未配置 RSA 则回落 HS256
|
||||
UserID int // 身份 ID(OIDC sub 用字符串形式)
|
||||
Alg string
|
||||
UserID int
|
||||
Username string
|
||||
TenantID int
|
||||
UserType string
|
||||
@@ -151,13 +134,12 @@ type TokenOptions struct {
|
||||
Amr string
|
||||
Subject string
|
||||
Audience []string
|
||||
Jti string // JWT ID,用于吊销(登出/踢下线)
|
||||
Events map[string]interface{} // OIDC 事件声明(Back-Channel Logout 用)
|
||||
TTL time.Duration // 留空默认 30 分钟
|
||||
Jti string
|
||||
Events map[string]interface{}
|
||||
TTL time.Duration
|
||||
Kid string
|
||||
}
|
||||
|
||||
// SignToken 签发 token。RSA 未配置时自动回落 HS256,保证服务可启动。
|
||||
func SignToken(opt TokenOptions) (string, error) {
|
||||
ensureKeys()
|
||||
|
||||
@@ -234,8 +216,6 @@ func SignToken(opt TokenOptions) (string, error) {
|
||||
return token.SignedString(key)
|
||||
}
|
||||
|
||||
// GenerateToken 生成 JWT token(兼容旧签名与行为)。
|
||||
// 默认 HS256;若 app.conf 配置了 jwt_issuer 则带上 iss。
|
||||
func GenerateToken(userID int, username string, tenantId int, userType string) (string, error) {
|
||||
ttl := 24 * time.Hour
|
||||
ensureKeys()
|
||||
@@ -258,9 +238,6 @@ func GenerateToken(userID int, username string, tenantId int, userType string) (
|
||||
return token.SignedString(hsKeys[DefaultKid])
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 解析
|
||||
|
||||
// ParseToken 解析并校验 JWT。自动识别 HS256 / RS256,函数签名与旧版一致。
|
||||
func ParseToken(tokenString string) (*Claims, error) {
|
||||
claims := &Claims{}
|
||||
_, err := jwt.ParseWithClaims(tokenString, claims, keyFunc,
|
||||
@@ -271,7 +248,6 @@ func ParseToken(tokenString string) (*Claims, error) {
|
||||
return claims, nil
|
||||
}
|
||||
|
||||
// ParseTokenRaw 解析 token 但不校验有效期,用于登出/吊销场景获取 jti。
|
||||
func ParseTokenRaw(tokenString string) (*Claims, error) {
|
||||
claims := &Claims{}
|
||||
parser := jwt.NewParser(jwt.WithValidMethods([]string{AlgHS256, AlgRS256}), jwt.WithoutClaimsValidation())
|
||||
@@ -281,13 +257,11 @@ func ParseTokenRaw(tokenString string) (*Claims, error) {
|
||||
return claims, nil
|
||||
}
|
||||
|
||||
// Issuer 返回配置的签发者(未配置时为空)
|
||||
func Issuer() string {
|
||||
ensureKeys()
|
||||
return issuerVal
|
||||
}
|
||||
|
||||
// JWK JSON Web Key(RS256 公钥)
|
||||
type JWK struct {
|
||||
Kty string `json:"kty"`
|
||||
Use string `json:"use"`
|
||||
@@ -297,8 +271,6 @@ type JWK struct {
|
||||
E string `json:"e"`
|
||||
}
|
||||
|
||||
// JWKS 返回 RSA 公钥集合(供 /auth/jwks.json 暴露)。
|
||||
// 各应用本地用公钥验签即可,无需每次回调认证中心的 introspect 接口。
|
||||
func JWKS() []JWK {
|
||||
ensureKeys()
|
||||
if rsaPub == nil || rsaPub.N == nil {
|
||||
@@ -314,13 +286,11 @@ func JWKS() []JWK {
|
||||
}}
|
||||
}
|
||||
|
||||
// HasRSA 是否已配置 RS256 密钥对(决定认证中心能否签发非对称 token)
|
||||
func HasRSA() bool {
|
||||
ensureKeys()
|
||||
return rsaPriv != nil && rsaPub != nil
|
||||
}
|
||||
|
||||
// Kid 返回当前 RS256 密钥 ID
|
||||
func Kid() string {
|
||||
ensureKeys()
|
||||
return rsaKid
|
||||
|
||||
@@ -5,7 +5,6 @@ import (
|
||||
"time"
|
||||
)
|
||||
|
||||
// TestGenerateParseBackwardCompat 旧签发方式产生的 token 必须仍能被解析(向后兼容)
|
||||
func TestGenerateParseBackwardCompat(t *testing.T) {
|
||||
token, err := GenerateToken(1001, "zhangsan", 7, "backend")
|
||||
if err != nil {
|
||||
@@ -18,16 +17,14 @@ func TestGenerateParseBackwardCompat(t *testing.T) {
|
||||
if claims.UserID != 1001 || claims.Username != "zhangsan" || claims.TenantId != 7 || claims.UserType != "backend" {
|
||||
t.Fatalf("claims 解析不符: %+v", claims)
|
||||
}
|
||||
// 旧 token 无认证中心扩展字段
|
||||
if claims.Sid != "" || claims.ClientID != "" {
|
||||
t.Fatal("旧 token 不应携带 sid/client_id")
|
||||
}
|
||||
}
|
||||
|
||||
// TestSignTokenFallback 未配置 RSA 时自动回落 HS256,且可解析
|
||||
func TestSignTokenFallback(t *testing.T) {
|
||||
token, err := SignToken(TokenOptions{
|
||||
Alg: AlgRS256, // 期望回落到 HS256
|
||||
Alg: AlgRS256,
|
||||
UserID: 42,
|
||||
Username: "u",
|
||||
TenantID: 3,
|
||||
@@ -49,7 +46,6 @@ func TestSignTokenFallback(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestParseInvalid 非法 token 必须报错
|
||||
func TestParseInvalid(t *testing.T) {
|
||||
if _, err := ParseToken("not-a-token"); err == nil {
|
||||
t.Fatal("非法 token 应返回错误")
|
||||
@@ -59,7 +55,6 @@ func TestParseInvalid(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestHasRSA 无配置时不应 panic
|
||||
func TestHasRSA(t *testing.T) {
|
||||
if HasRSA() {
|
||||
t.Log("已配置 RSA 密钥对")
|
||||
|
||||
@@ -13,37 +13,25 @@ import (
|
||||
"golang.org/x/crypto/argon2"
|
||||
)
|
||||
|
||||
// 算法标识。
|
||||
// 历史数据用 legacy(sha256 单轮,无迭代拉伸,抗 GPU 爆破能力弱);
|
||||
// 新密码统一用 argon2id,登录成功检测到 legacy 时应重新哈希升级。
|
||||
const (
|
||||
AlgoArgon2id = "argon2id"
|
||||
AlgoLegacy = "legacy"
|
||||
)
|
||||
|
||||
// argon2id 参数(OWASP 推荐起步配置:64MB / 3 轮 / 并行 2)
|
||||
const (
|
||||
argonTime = 3
|
||||
argonMemory = 64 * 1024 // 单位 KB,即 64MB
|
||||
argonMemory = 64 * 1024
|
||||
argonThreads = 2
|
||||
argonKeyLen = 32
|
||||
argonSaltLen = 16
|
||||
)
|
||||
|
||||
// legacy 兼容参数
|
||||
const (
|
||||
saltBytes = 16
|
||||
separator = "$"
|
||||
hashLength = 64 // sha256 hex length
|
||||
hashLength = 64
|
||||
)
|
||||
|
||||
// Hash 使用当前默认算法(argon2id)生成密码存储串。
|
||||
//
|
||||
// 返回 PHC 标准格式(盐与参数内联,无需独立 salt 列):
|
||||
//
|
||||
// $argon2id$v=19$m=65536,t=3,p=2$<base64(salt)>$<base64(hash)>
|
||||
//
|
||||
// 注意:函数签名与旧版一致,全部调用点无需改动即可切换到新算法。
|
||||
func Hash(plain string) (string, error) {
|
||||
plain = strings.TrimSpace(plain)
|
||||
if plain == "" {
|
||||
@@ -62,9 +50,6 @@ func Hash(plain string) (string, error) {
|
||||
), nil
|
||||
}
|
||||
|
||||
// Verify 校验明文密码是否匹配存储串,自动识别算法:
|
||||
// - $argon2id$... → argon2id(新)
|
||||
// - <salt>$<hash> → legacy sha256(旧,兼容)
|
||||
func Verify(stored, plain string) bool {
|
||||
stored = strings.TrimSpace(stored)
|
||||
plain = strings.TrimSpace(plain)
|
||||
@@ -77,14 +62,10 @@ func Verify(stored, plain string) bool {
|
||||
return verifyLegacy(stored, plain)
|
||||
}
|
||||
|
||||
// NeedsRehash 判断已存储的密码是否需要用当前算法重新哈希。
|
||||
// 登录成功后调用:返回 true 时应拿当次登录的明文重新 Hash 并落库,
|
||||
// 实现旧算法用户「首次登录自动升级」,无需强制全员重置密码。
|
||||
func NeedsRehash(stored string) bool {
|
||||
return !strings.HasPrefix(strings.TrimSpace(stored), "$argon2id$")
|
||||
}
|
||||
|
||||
// AlgoOf 返回存储串使用的算法标识,用于审计/统计旧算法存量。
|
||||
func AlgoOf(stored string) string {
|
||||
if strings.HasPrefix(strings.TrimSpace(stored), "$argon2id$") {
|
||||
return AlgoArgon2id
|
||||
@@ -92,10 +73,8 @@ func AlgoOf(stored string) string {
|
||||
return AlgoLegacy
|
||||
}
|
||||
|
||||
// verifyArgon2id 解析 PHC 串并用相同参数重算比对(恒定时间比较)。
|
||||
func verifyArgon2id(stored, plain string) bool {
|
||||
parts := strings.Split(stored, "$")
|
||||
// ["", "argon2id", "v=19", "m=...,t=...,p=...", salt, hash]
|
||||
if len(parts) != 6 {
|
||||
return false
|
||||
}
|
||||
@@ -119,8 +98,6 @@ func verifyArgon2id(stored, plain string) bool {
|
||||
return subtle.ConstantTimeCompare(got, want) == 1
|
||||
}
|
||||
|
||||
// verifyLegacy 校验旧格式:salt$hash(均为 hex),sha256(salt+plain)。
|
||||
// 仅用于兼容历史数据,不再用于新密码。
|
||||
func verifyLegacy(stored, plain string) bool {
|
||||
stored = strings.TrimSpace(stored)
|
||||
plain = strings.TrimSpace(plain)
|
||||
@@ -142,7 +119,6 @@ func verifyLegacy(stored, plain string) bool {
|
||||
return hashHex(saltHex, plain) == strings.ToLower(hashHexStored)
|
||||
}
|
||||
|
||||
// hashHex 旧算法:sha256(saltHex + plain),供 verifyLegacy 使用。
|
||||
func hashHex(saltHex, plain string) string {
|
||||
sum := sha256.Sum256([]byte(saltHex + plain))
|
||||
return hex.EncodeToString(sum[:])
|
||||
|
||||
@@ -6,7 +6,6 @@ import (
|
||||
"testing"
|
||||
)
|
||||
|
||||
// TestHashVerifyArgon2id 新算法:哈希后可校验,错误密码拒绝
|
||||
func TestHashVerifyArgon2id(t *testing.T) {
|
||||
stored, err := Hash("Passw0rd@2026")
|
||||
if err != nil {
|
||||
@@ -26,7 +25,6 @@ func TestHashVerifyArgon2id(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestLegacyCompat 旧算法兼容:历史 salt$sha256 串仍可登录,且被标记为需要升级
|
||||
func TestLegacyCompat(t *testing.T) {
|
||||
saltHex := "0123456789abcdef0123456789abcdef"
|
||||
sum := sha256.Sum256([]byte(saltHex + "oldpass"))
|
||||
@@ -46,7 +44,6 @@ func TestLegacyCompat(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestDifferentSaltSamePassword 相同明文两次哈希结果必须不同(盐随机)
|
||||
func TestDifferentSaltSamePassword(t *testing.T) {
|
||||
a, _ := Hash("same-password")
|
||||
b, _ := Hash("same-password")
|
||||
@@ -58,7 +55,6 @@ func TestDifferentSaltSamePassword(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestEmptyPassword 空密码边界
|
||||
func TestEmptyPassword(t *testing.T) {
|
||||
if _, err := Hash(" "); err == nil {
|
||||
t.Fatal("空密码应返回错误")
|
||||
|
||||
@@ -8,25 +8,20 @@ import (
|
||||
"strings"
|
||||
)
|
||||
|
||||
// RenderCtx 渲染上下文,携带租户与当前路由信息
|
||||
type RenderCtx struct {
|
||||
Tid uint64 // 租户 ID
|
||||
ArticleID uint64 // 文章详情页的文章 ID
|
||||
PagePath string // 单页路由的 path
|
||||
Page int // 列表分页页码
|
||||
PageSize int // 列表分页大小(pagelist 与列表标签保持一致)
|
||||
Tid uint64
|
||||
ArticleID uint64
|
||||
PagePath string
|
||||
Page int
|
||||
PageSize int
|
||||
}
|
||||
|
||||
// Provider 循环标签数据提供器:返回若干行数据,每行为 字段名->值
|
||||
type Provider func(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error)
|
||||
|
||||
// SelfCloseHandler 自闭合标签处理器:直接输出 HTML 片段
|
||||
type SelfCloseHandler func(tid uint64, params map[string]string, ctx *RenderCtx) (string, error)
|
||||
|
||||
// GlobalProvider 全局标签提供器:返回 标签名->值 映射
|
||||
type GlobalProvider func(tid uint64, ctx *RenderCtx) (map[string]string, error)
|
||||
|
||||
// BodyProvider 带循环体的块标签:自行组装 HTML(如带 Tab 的新闻中心)
|
||||
type BodyProvider func(tid uint64, params map[string]string, ctx *RenderCtx, body string) (string, error)
|
||||
|
||||
var (
|
||||
@@ -36,36 +31,24 @@ var (
|
||||
globalProvider GlobalProvider
|
||||
)
|
||||
|
||||
// RegisterBlock 注册循环标签({yz:name}...{/yz:name})
|
||||
func RegisterBlock(name string, p Provider) { blockProviders[name] = p }
|
||||
|
||||
// RegisterBodyBlock 注册自行组装循环体的块标签
|
||||
func RegisterBodyBlock(name string, p BodyProvider) { bodyProviders[name] = p }
|
||||
|
||||
// RegisterSelfClose 注册自闭合标签({yz:name ... /})
|
||||
func RegisterSelfClose(name string, h SelfCloseHandler) { selfCloseHandlers[name] = h }
|
||||
|
||||
// RegisterGlobal 注册全局标签提供器({yz:xxx} 直接替换)
|
||||
func RegisterGlobal(p GlobalProvider) { globalProvider = p }
|
||||
|
||||
var (
|
||||
// 块标签开标签(带属性);自闭合标签因 "/" 不会被匹配
|
||||
reBlockOpen = regexp.MustCompile(`\{yz:([a-zA-Z]+)((?:\s+[a-zA-Z_][\w-]*\s*=\s*"[^"]*")*)\s*\}`)
|
||||
// 块标签闭标签
|
||||
reBlockClose = regexp.MustCompile(`\{/yz:([a-zA-Z]+)\}`)
|
||||
// 自闭合标签 {yz:name attr="v" /}
|
||||
reSelfClose = regexp.MustCompile(`\{yz:([a-zA-Z]+)((?:\s+[a-zA-Z_][\w-]*\s*=\s*"[^"]*")*)\s*/\}`)
|
||||
// 全局标签 {yz:word}
|
||||
reGlobal = regexp.MustCompile(`\{yz:([a-zA-Z_]\w*)\}`)
|
||||
// 属性解析 key="value"
|
||||
reAttr = regexp.MustCompile(`([a-zA-Z_][\w-]*)\s*=\s*"([^"]*)"`)
|
||||
// 循环体内字段占位 [field:name/]
|
||||
reField = regexp.MustCompile(`\[field:([a-zA-Z_]\w*)/\]`)
|
||||
// include 文件名校验,仅允许简单文件名
|
||||
reIncludeFile = regexp.MustCompile(`^[a-zA-Z0-9_\-\.]+$`)
|
||||
)
|
||||
|
||||
// parseAttrs 解析标签属性串为 map
|
||||
func parseAttrs(attrStr string) map[string]string {
|
||||
out := map[string]string{}
|
||||
for _, m := range reAttr.FindAllStringSubmatch(attrStr, -1) {
|
||||
@@ -81,8 +64,6 @@ func applyFields(body string, row map[string]string) string {
|
||||
})
|
||||
}
|
||||
|
||||
// Render 渲染模板目录下的指定文件
|
||||
// 流水线:include 展开 → 块标签 → 自闭合标签 → 全局标签
|
||||
func Render(templateDir, file string, ctx *RenderCtx) (string, error) {
|
||||
content, err := os.ReadFile(filepath.Join(templateDir, file))
|
||||
if err != nil {
|
||||
@@ -106,7 +87,6 @@ func Render(templateDir, file string, ctx *RenderCtx) (string, error) {
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// expandIncludes 递归展开 {yz:include file="xxx"/},限制嵌套深度防止死循环
|
||||
func expandIncludes(dir, content string, depth int) (string, error) {
|
||||
if depth > 5 {
|
||||
return content, fmt.Errorf("include 嵌套层级过深")
|
||||
@@ -138,8 +118,6 @@ func expandIncludes(dir, content string, depth int) (string, error) {
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// renderBlocks 逐个解析块标签:每次取全文第一个闭标签(必属最内层块),
|
||||
// 向前回溯同名开标签,按行展开后回填,重复至无块标签(Go RE2 不支持负向先行断言,故手工配对)
|
||||
func renderBlocks(content string, ctx *RenderCtx) (string, error) {
|
||||
out := content
|
||||
for i := 0; i < 100; i++ {
|
||||
@@ -149,7 +127,6 @@ func renderBlocks(content string, ctx *RenderCtx) (string, error) {
|
||||
}
|
||||
closeName := strings.ToLower(reBlockClose.FindStringSubmatch(out[c[0]:c[1]])[1])
|
||||
|
||||
// 在闭标签之前找最后一个同名开标签
|
||||
openIdx, openEnd := -1, -1
|
||||
attrs := ""
|
||||
for _, om := range reBlockOpen.FindAllStringSubmatchIndex(out[:c[0]], -1) {
|
||||
@@ -160,7 +137,6 @@ func renderBlocks(content string, ctx *RenderCtx) (string, error) {
|
||||
attrs = out[om[4]:om[5]]
|
||||
}
|
||||
if openIdx < 0 {
|
||||
// 孤立的闭标签:移除后继续,避免死循环
|
||||
out = out[:c[0]] + out[c[1]:]
|
||||
continue
|
||||
}
|
||||
@@ -184,13 +160,11 @@ func renderBlocks(content string, ctx *RenderCtx) (string, error) {
|
||||
}
|
||||
rendered = sb.String()
|
||||
}
|
||||
// 未注册的块标签置空,避免标签泄漏到前台
|
||||
out = out[:openIdx] + rendered + out[c[1]:]
|
||||
}
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// renderSelfClose 处理剩余自闭合标签(onepage/pagelist 等,include 已先行展开)
|
||||
func renderSelfClose(content string, ctx *RenderCtx) (string, error) {
|
||||
var ferr error
|
||||
out := reSelfClose.ReplaceAllStringFunc(content, func(m string) string {
|
||||
@@ -213,8 +187,6 @@ func renderSelfClose(content string, ctx *RenderCtx) (string, error) {
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// SiteGlobals 返回站点级全局标签值(key 即标签名),与模板内 {yz:xxx} 完全同源。
|
||||
// 供前台公开接口(GET /site/setting)输出给 SPA 官网使用,保证 SPA 与 themes 直出模板展示一致。
|
||||
func SiteGlobals(tid uint64) map[string]string {
|
||||
if globalProvider == nil {
|
||||
return map[string]string{}
|
||||
@@ -226,7 +198,6 @@ func SiteGlobals(tid uint64) map[string]string {
|
||||
return vals
|
||||
}
|
||||
|
||||
// renderGlobals 替换全局标签;未提供的标签置空
|
||||
func renderGlobals(content string, ctx *RenderCtx) string {
|
||||
var vals map[string]string
|
||||
if globalProvider != nil {
|
||||
|
||||
@@ -1,18 +1,15 @@
|
||||
package tagengine
|
||||
|
||||
// TagMeta 标签元信息:由注册表统一维护,供 platform 端"标签调用说明"页输出。
|
||||
// 新增标签时在此登记一条,文档页自动同步,避免文档与实现脱节。
|
||||
type TagMeta struct {
|
||||
Name string `json:"name"` // 标签名
|
||||
Category string `json:"category"` // 分类:guide 入门 / global 全局 / loop 循环 / single 单页 / other 其他
|
||||
Syntax string `json:"syntax"` // 语法示例
|
||||
Desc string `json:"desc"` // 用途说明
|
||||
Params []string `json:"params"` // 可用参数(key=说明)
|
||||
Fields []string `json:"fields"` // 循环体内可用 [field:xxx/] 字段;global 分类下为标签清单(名称 说明 数据来源)
|
||||
Example string `json:"example"` // 模板内示例代码
|
||||
Name string `json:"name"`
|
||||
Category string `json:"category"`
|
||||
Syntax string `json:"syntax"`
|
||||
Desc string `json:"desc"`
|
||||
Params []string `json:"params"`
|
||||
Fields []string `json:"fields"`
|
||||
Example string `json:"example"`
|
||||
}
|
||||
|
||||
// TagDocs 返回全部已登记标签的说明数据
|
||||
func TagDocs() []TagMeta {
|
||||
return []TagMeta{
|
||||
{
|
||||
|
||||
@@ -43,7 +43,6 @@ func atoiDefault(s string, def int) int {
|
||||
return def
|
||||
}
|
||||
|
||||
// truncateTitle 按字符数(而非字节)安全截断标题
|
||||
func truncateTitle(s string, n int) string {
|
||||
if n <= 0 {
|
||||
return s
|
||||
@@ -55,12 +54,10 @@ func truncateTitle(s string, n int) string {
|
||||
return string(rs[:n]) + "..."
|
||||
}
|
||||
|
||||
// publishedCond 已发布状态条件:兼容历史 status=1 与现行 status=2(已发布)
|
||||
func publishedCond(qs orm.QuerySeter) orm.QuerySeter {
|
||||
return qs.Filter("status__in", []int8{1, 2})
|
||||
}
|
||||
|
||||
// globalSiteInfo 全局标签:站点设置各字段 + 租户表联系信息(电话/邮箱/地址等)
|
||||
func globalSiteInfo(tid uint64, ctx *RenderCtx) (map[string]string, error) {
|
||||
out := map[string]string{
|
||||
"sitename": "", "logo": "", "logow": "", "ico": "", "icp": "",
|
||||
@@ -88,7 +85,6 @@ func globalSiteInfo(tid uint64, ctx *RenderCtx) (map[string]string, error) {
|
||||
out["companyintroduction"] = row.Companyintroduction
|
||||
}
|
||||
|
||||
// 联系方式取自租户表(backend 端 - 站点设置 - 公司信息)
|
||||
var tenant models.SystemTenant
|
||||
if err := models.Orm.QueryTable(new(models.SystemTenant)).
|
||||
Filter("id", tid).
|
||||
@@ -110,16 +106,12 @@ func globalSiteInfo(tid uint64, ctx *RenderCtx) (map[string]string, error) {
|
||||
}
|
||||
}
|
||||
|
||||
// SEO 三项取自租户扩展设置表(backend 端 - 站点设置 - SEO 设置)
|
||||
if vals, err := queryTenantSettingItems(tid, "seoKeywords", "seoTitle", "seoDescription"); err == nil {
|
||||
out["keywords"] = vals["seoKeywords"]
|
||||
out["seotitle"] = vals["seoTitle"]
|
||||
out["seodescription"] = vals["seoDescription"]
|
||||
}
|
||||
|
||||
// 平台官网(tid 1)额外读取 platform 端「官网管理 - 站点设置」
|
||||
// (yz_platform_site_setting,通用键值结构:tag 即标签名)。
|
||||
// 值非空时覆盖同名全局标签,为空时保证标签存在(输出空串);租户站点不受影响。
|
||||
if tid == 1 {
|
||||
for k, v := range models.GetPlatformSiteTagMap() {
|
||||
if v == "" {
|
||||
@@ -134,8 +126,6 @@ func globalSiteInfo(tid uint64, ctx *RenderCtx) (map[string]string, error) {
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// queryTenantSettingItems 查询租户扩展设置表 yz_system_tenant_setting_items;
|
||||
// 表不存在等异常不阻断渲染,返回错误由调用方忽略
|
||||
func queryTenantSettingItems(tid uint64, keys ...string) (map[string]string, error) {
|
||||
out := make(map[string]string, len(keys))
|
||||
for _, k := range keys {
|
||||
@@ -159,8 +149,6 @@ func queryTenantSettingItems(tid uint64, keys ...string) (map[string]string, err
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// navProvider 导航菜单:一级菜单循环,[field:children/] 输出子菜单 HTML。
|
||||
// 一级菜单含全局默认(tenant_id=0,不可删)与租户自定义;子菜单仅租户自有。
|
||||
func navProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error) {
|
||||
var rows []models.BackendMenuFront
|
||||
_, err := models.Orm.QueryTable(new(models.BackendMenuFront)).
|
||||
@@ -210,7 +198,6 @@ func navProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[st
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// bannerProvider 首页 Banner 循环
|
||||
func bannerProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error) {
|
||||
row := atoiDefault(params["row"], 10)
|
||||
var rows []models.CmsFrontendBanner
|
||||
@@ -237,7 +224,6 @@ func bannerProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// friendlinkProvider 友情链接循环
|
||||
func friendlinkProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error) {
|
||||
row := atoiDefault(params["row"], 20)
|
||||
var rows []models.CmsFrontendFriendlink
|
||||
@@ -264,7 +250,6 @@ func friendlinkProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// productlistProvider 产品列表循环,支持 row/titlelen 参数
|
||||
func productlistProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error) {
|
||||
row := atoiDefault(params["row"], 10)
|
||||
if row <= 0 || row > 50 {
|
||||
@@ -302,7 +287,6 @@ func productlistProvider(tid uint64, params map[string]string, ctx *RenderCtx) (
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// producttypeProvider 产品分类循环,支持 row 参数
|
||||
func producttypeProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error) {
|
||||
row := atoiDefault(params["row"], 20)
|
||||
if row <= 0 || row > 50 {
|
||||
@@ -332,7 +316,6 @@ func producttypeProvider(tid uint64, params map[string]string, ctx *RenderCtx) (
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// solutionlistProvider 解决方案列表循环,支持 row/titlelen 参数
|
||||
func solutionlistProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error) {
|
||||
row := atoiDefault(params["row"], 10)
|
||||
if row <= 0 || row > 50 {
|
||||
@@ -369,7 +352,6 @@ func solutionlistProvider(tid uint64, params map[string]string, ctx *RenderCtx)
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// solutiontypeProvider 解决方案分类循环,支持 row 参数
|
||||
func solutiontypeProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error) {
|
||||
row := atoiDefault(params["row"], 20)
|
||||
if row <= 0 || row > 50 {
|
||||
@@ -399,7 +381,6 @@ func solutiontypeProvider(tid uint64, params map[string]string, ctx *RenderCtx)
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// arclistProvider 文章列表循环,支持 row/cateid/titlelen/flag 参数
|
||||
func arclistProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error) {
|
||||
row := atoiDefault(params["row"], 10)
|
||||
if row <= 0 || row > 50 {
|
||||
@@ -427,7 +408,6 @@ func arclistProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]ma
|
||||
if strings.ToLower(strings.TrimSpace(params["flag"])) == "hot" {
|
||||
order = []string{"-views", "-id"}
|
||||
}
|
||||
// 列表页携带页码时按页偏移,配合 {yz:pagelist/} 分页
|
||||
offset := 0
|
||||
if ctx.Page > 1 {
|
||||
offset = (ctx.Page - 1) * row
|
||||
@@ -440,7 +420,6 @@ func arclistProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]ma
|
||||
return articleRows(rows, titleLen, cateImgMap), nil
|
||||
}
|
||||
|
||||
// articleRows 文章行转标签字段
|
||||
func articleRows(rows []models.CmsArticle, titleLen int, cateImgMap map[uint64]string) []map[string]string {
|
||||
out := make([]map[string]string, 0, len(rows))
|
||||
for _, a := range rows {
|
||||
@@ -473,7 +452,6 @@ func articleRows(rows []models.CmsArticle, titleLen int, cateImgMap map[uint64]s
|
||||
return out
|
||||
}
|
||||
|
||||
// collectCateIDs 从文章列表中收集不重复的分类 ID
|
||||
func collectCateIDs(rows []models.CmsArticle) []uint64 {
|
||||
seen := make(map[uint64]bool)
|
||||
var ids []uint64
|
||||
@@ -486,7 +464,6 @@ func collectCateIDs(rows []models.CmsArticle) []uint64 {
|
||||
return ids
|
||||
}
|
||||
|
||||
// arcviewProvider 文章详情(详情页模板内),取当前路由文章
|
||||
func arcviewProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]map[string]string, error) {
|
||||
if ctx.ArticleID == 0 {
|
||||
return nil, nil
|
||||
@@ -523,7 +500,6 @@ func arcviewProvider(tid uint64, params map[string]string, ctx *RenderCtx) ([]ma
|
||||
}}, nil
|
||||
}
|
||||
|
||||
// onepageHandler 单页内容 {yz:onepage path="about" field="content"/}
|
||||
func onepageHandler(tid uint64, params map[string]string, ctx *RenderCtx) (string, error) {
|
||||
path := strings.TrimSpace(params["path"])
|
||||
if path == "" {
|
||||
@@ -555,8 +531,6 @@ func onepageHandler(tid uint64, params map[string]string, ctx *RenderCtx) (strin
|
||||
}
|
||||
}
|
||||
|
||||
// newscenterHandler 首页新闻中心:循环体为单条新闻卡片。
|
||||
// 有「新闻中心」子分类时输出 Bootstrap Tab,每个 Tab 8 条;无子分类则不输出 Tab,直接列出 8 条。
|
||||
func newscenterHandler(tid uint64, params map[string]string, ctx *RenderCtx, body string) (string, error) {
|
||||
row := atoiDefault(params["row"], 8)
|
||||
if row <= 0 || row > 50 {
|
||||
@@ -580,7 +554,6 @@ func newscenterHandler(tid uint64, params map[string]string, ctx *RenderCtx, bod
|
||||
All(&children)
|
||||
}
|
||||
|
||||
// collectDescendantIDs 递归收集分类及其所有子孙分类 ID
|
||||
collectDescendantIDs := func(rootID uint64) []uint64 {
|
||||
ids := []uint64{rootID}
|
||||
queue := []uint64{rootID}
|
||||
@@ -674,14 +647,12 @@ func findNewsCenterCategory(tid uint64) (*models.CmsArticleCategory, error) {
|
||||
return &row, nil
|
||||
}
|
||||
|
||||
// newsQueryBase 新闻列表统一查询条件(pagelist 与 news.html 保持一致)
|
||||
func newsQueryBase(tid uint64) orm.QuerySeter {
|
||||
return publishedCond(models.Orm.QueryTable(new(models.CmsArticle)).
|
||||
Filter("tid", tid).
|
||||
Filter("delete_time__isnull", true))
|
||||
}
|
||||
|
||||
// pagelistHandler 分页链接 {yz:pagelist/},配合 /news?page=N
|
||||
func pagelistHandler(tid uint64, params map[string]string, ctx *RenderCtx) (string, error) {
|
||||
pageSize := ctx.PageSize
|
||||
if pageSize <= 0 {
|
||||
|
||||
@@ -24,7 +24,6 @@ const (
|
||||
cursorAgentPath = "/aiserver.v1.ChatService/StreamUnifiedChatWithTools"
|
||||
cursorClientVersion = "2.6.22"
|
||||
cursorHiMaxRead = 512 * 1024
|
||||
// probeHiText 发往官方 Agent 的探测内容(与前端展示 probeMessage 一致)
|
||||
probeHiText = "hi"
|
||||
)
|
||||
|
||||
@@ -34,7 +33,6 @@ func newCursorHTTP2Client() *http.Client {
|
||||
tr := &http.Transport{
|
||||
TLSClientConfig: &tls.Config{MinVersion: tls.VersionTLS12},
|
||||
}
|
||||
// 与 Cursor 官方一致走 HTTP/2
|
||||
if err := http2.ConfigureTransport(tr); err != nil {
|
||||
return &http.Client{Timeout: 40 * time.Second}
|
||||
}
|
||||
@@ -70,8 +68,6 @@ func cursorEnvVersion() string {
|
||||
return cursorClientVersion
|
||||
}
|
||||
|
||||
// --- protobuf wire (与 cursor_api_demo 对齐) ---
|
||||
|
||||
func pbVarint(v uint64) []byte {
|
||||
var out []byte
|
||||
for v >= 0x80 {
|
||||
@@ -159,12 +155,11 @@ func encodeCursorMessageID(messageID string, role int) []byte {
|
||||
return msg
|
||||
}
|
||||
|
||||
// defaultAgentTools 与 cursor_agent_client.DEFAULT_TOOLS 一致
|
||||
var defaultAgentTools = []int{5, 6, 3, 15, 7, 8, 42}
|
||||
|
||||
func encodeCursorAgentRequest(userContent, modelName string) []byte {
|
||||
msgID := uuid.NewString()
|
||||
cm := 2 // Agent
|
||||
cm := 2
|
||||
userMsg := encodeCursorMessage(userContent, 1, msgID, &cm)
|
||||
|
||||
var msg []byte
|
||||
@@ -261,8 +256,6 @@ func asciiLowerInPlace(b []byte) {
|
||||
}
|
||||
}
|
||||
|
||||
// 社区脚本中的「额度用尽」ASCII 前缀(与明文一致,便于在二进制流中 bytes.Contains,无需整句)
|
||||
// 对应明文前缀:Get Cursor Pro for more Agent usage
|
||||
var cursorQuotaExhaustedSigCommunity = []byte{
|
||||
0x47, 0x65, 0x74, 0x20, 0x43, 0x75, 0x72, 0x73,
|
||||
0x6f, 0x72, 0x20, 0x50, 0x72, 0x6f, 0x20, 0x66,
|
||||
@@ -271,12 +264,10 @@ var cursorQuotaExhaustedSigCommunity = []byte{
|
||||
0x61, 0x67, 0x65,
|
||||
}
|
||||
|
||||
// cursorQuotaTipSig 与常见示例一致:raw 全字节里 bytes.Contains(raw, tipSig) → 额度用尽
|
||||
var cursorQuotaTipSig = []byte("Get Cursor Pro for more Agent usage, unlimited Tab, and more.")
|
||||
|
||||
const cursorLimitTipPrefix = "Get Cursor Pro for more Agent usage, unlimited Tab"
|
||||
|
||||
// classifyCursorRawStream 在官方流式二进制/文本中匹配用量与升级提示(ASCII 区不区分大小写 + UTF-8 短语)
|
||||
func classifyCursorRawStream(raw []byte) (blocked bool, reason string) {
|
||||
if len(raw) == 0 {
|
||||
return false, ""
|
||||
@@ -289,7 +280,6 @@ func classifyCursorRawStream(raw []byte) (blocked bool, reason string) {
|
||||
if bytes.Contains(raw, cursorQuotaTipSig) {
|
||||
return true, "流中匹配:" + string(cursorQuotaTipSig)
|
||||
}
|
||||
// 社区脚本:仅到「…Agent usage」的 ASCII 前缀(流里可能只有前半段)
|
||||
if bytes.Contains(raw, cursorQuotaExhaustedSigCommunity) {
|
||||
return true, "流中匹配:Get Cursor Pro for more Agent usage…(社区 QuotaExhaustedSignature 前缀)"
|
||||
}
|
||||
@@ -320,7 +310,7 @@ func classifyCursorRawStream(raw []byte) (blocked bool, reason string) {
|
||||
}
|
||||
|
||||
flat := strings.ToLower(strings.ToValidUTF8(string(raw), "\uFFFD"))
|
||||
flat = strings.ReplaceAll(flat, "\u2019", "'") // 右单引号
|
||||
flat = strings.ReplaceAll(flat, "\u2019", "'")
|
||||
flat = strings.ReplaceAll(flat, "`", "'")
|
||||
if strings.Contains(flat, "you've hit your usage limit") {
|
||||
return true, "流中匹配:you've hit your usage limit(UTF-8)"
|
||||
|
||||
@@ -1,17 +1,3 @@
|
||||
// Package verifyfiles 解析「根路径站点验证文件」的请求。
|
||||
//
|
||||
// 背景:nginx 对所有域名都是「全量反代给 Go」,Go 不认识的路径一律回 beego 404,
|
||||
// 于是备案 / 搜索引擎 / 第三方平台的域名所有权验证文件
|
||||
// (如 1XXl8fPHr9.txt、baidu_verify_xxx.html)根本访问不到。
|
||||
// 而这类文件名每次都不同(随机串),不可能逐个注册路由。
|
||||
//
|
||||
// 这里只做纯逻辑:URL 路径 → 磁盘文件 的安全映射。
|
||||
// beego 过滤器胶水放在 routers 包(见 routers/verifyfiles.go)。
|
||||
//
|
||||
// 安全性:
|
||||
// - 只认「根路径下的单段文件名」,不做目录拼接,杜绝 ../ 穿越;
|
||||
// - 文件名走白名单正则,扩展名走允许列表(不放行 .go/.conf/.env 等敏感后缀);
|
||||
// - 目标文件必须真实存在于验证目录内,否则一律放行给正常路由。
|
||||
package verifyfiles
|
||||
|
||||
import (
|
||||
@@ -23,35 +9,25 @@ import (
|
||||
)
|
||||
|
||||
const (
|
||||
// DefaultDir 默认验证文件目录(相对进程工作目录,即服务目录)。
|
||||
DefaultDir = "verify"
|
||||
|
||||
// DefaultExts 默认允许的扩展名。
|
||||
DefaultExts = ".txt,.html,.htm"
|
||||
)
|
||||
|
||||
// fileNameRe 文件名白名单:字母或数字开头,只允许字母数字与 . _ -
|
||||
var fileNameRe = regexp.MustCompile(`^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$`)
|
||||
|
||||
// Config 验证文件托管配置。
|
||||
type Config struct {
|
||||
// Dir 验证文件目录。留空用 DefaultDir;填 "-" 表示关闭该功能。
|
||||
Dir string
|
||||
// Exts 允许的扩展名,逗号分隔(如 ".txt,.html")。留空用 DefaultExts。
|
||||
Exts string
|
||||
// Hosts 限定生效的 Host(不含端口),逗号分隔。留空表示不限制。
|
||||
Hosts string
|
||||
}
|
||||
|
||||
// Resolver 把 URL 路径解析成验证文件的磁盘路径。
|
||||
type Resolver struct {
|
||||
dir string
|
||||
exts map[string]bool
|
||||
hosts map[string]bool
|
||||
}
|
||||
|
||||
// New 按配置创建 Resolver。
|
||||
// Dir 为 "-" 时表示关闭该功能,返回 (nil, nil)。
|
||||
func New(cfg Config) (*Resolver, error) {
|
||||
dir := strings.TrimSpace(cfg.Dir)
|
||||
if dir == "-" {
|
||||
@@ -98,7 +74,6 @@ func New(cfg Config) (*Resolver, error) {
|
||||
return r, nil
|
||||
}
|
||||
|
||||
// Dir 返回验证文件目录的绝对路径。
|
||||
func (r *Resolver) Dir() string {
|
||||
if r == nil {
|
||||
return ""
|
||||
@@ -106,7 +81,6 @@ func (r *Resolver) Dir() string {
|
||||
return r.dir
|
||||
}
|
||||
|
||||
// Exts 返回允许的扩展名列表(用于启动日志,便于确认配置是否生效)。
|
||||
func (r *Resolver) Exts() []string {
|
||||
if r == nil {
|
||||
return nil
|
||||
@@ -118,7 +92,6 @@ func (r *Resolver) Exts() []string {
|
||||
return out
|
||||
}
|
||||
|
||||
// AllowHost 判断该 Host 是否允许取验证文件(未配置 hosts 时一律允许)。
|
||||
func (r *Resolver) AllowHost(host string) bool {
|
||||
if r == nil {
|
||||
return false
|
||||
@@ -130,8 +103,6 @@ func (r *Resolver) AllowHost(host string) bool {
|
||||
return ok
|
||||
}
|
||||
|
||||
// Resolve 把请求路径解析成磁盘文件路径。
|
||||
// 只接受根路径下的单段文件名(如 /1XXl8fPHr9.txt);文件必须真实存在。
|
||||
func (r *Resolver) Resolve(urlPath string) (string, bool) {
|
||||
if r == nil {
|
||||
return "", false
|
||||
@@ -141,7 +112,6 @@ func (r *Resolver) Resolve(urlPath string) (string, bool) {
|
||||
return "", false
|
||||
}
|
||||
full := filepath.Join(r.dir, name)
|
||||
// 兜底:拼出来的路径必须仍在验证目录内
|
||||
if !strings.HasPrefix(full, r.dir+string(os.PathSeparator)) {
|
||||
return "", false
|
||||
}
|
||||
@@ -152,7 +122,6 @@ func (r *Resolver) Resolve(urlPath string) (string, bool) {
|
||||
return full, true
|
||||
}
|
||||
|
||||
// fileName 从 URL 路径里取出合法的验证文件名。
|
||||
func (r *Resolver) fileName(urlPath string) (string, bool) {
|
||||
p := strings.TrimSpace(urlPath)
|
||||
if p == "" || p == "/" {
|
||||
@@ -162,18 +131,15 @@ func (r *Resolver) fileName(urlPath string) (string, bool) {
|
||||
if name == "" {
|
||||
return "", false
|
||||
}
|
||||
// 只允许根目录下的单段文件名,禁止子目录
|
||||
if strings.ContainsAny(name, "/\\") {
|
||||
return "", false
|
||||
}
|
||||
// 禁止路径穿越
|
||||
if strings.Contains(name, "..") {
|
||||
return "", false
|
||||
}
|
||||
if !fileNameRe.MatchString(name) {
|
||||
return "", false
|
||||
}
|
||||
// index.html 会被 http.ServeFile 重定向到 "./",排除
|
||||
if strings.EqualFold(name, "index.html") {
|
||||
return "", false
|
||||
}
|
||||
@@ -184,7 +150,6 @@ func (r *Resolver) fileName(urlPath string) (string, bool) {
|
||||
return name, true
|
||||
}
|
||||
|
||||
// normalizeHost 去掉端口并转小写。
|
||||
func normalizeHost(h string) string {
|
||||
h = strings.ToLower(strings.TrimSpace(h))
|
||||
if i := strings.IndexByte(h, ':'); i > 0 {
|
||||
|
||||
@@ -6,7 +6,6 @@ import (
|
||||
"testing"
|
||||
)
|
||||
|
||||
// newTestResolver 造一个临时验证目录,返回 resolver。
|
||||
func newTestResolver(t *testing.T, cfg Config) *Resolver {
|
||||
t.Helper()
|
||||
r, err := New(cfg)
|
||||
@@ -19,7 +18,6 @@ func newTestResolver(t *testing.T, cfg Config) *Resolver {
|
||||
return r
|
||||
}
|
||||
|
||||
// TestResolveAllowed 确认合法验证文件能被解析到磁盘路径。
|
||||
func TestResolveAllowed(t *testing.T) {
|
||||
dir := t.TempDir()
|
||||
if err := os.WriteFile(filepath.Join(dir, "1XXl8fPHr9.txt"), []byte("1XXl8fPHr9"), 0o644); err != nil {
|
||||
@@ -43,7 +41,6 @@ func TestResolveAllowed(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestResolveRejected 确认非法/敏感/不存在的路径一律不放行。
|
||||
func TestResolveRejected(t *testing.T) {
|
||||
dir := t.TempDir()
|
||||
for _, name := range []string{"secret.env", "notes.md", "index.html", "app.conf"} {
|
||||
@@ -60,15 +57,15 @@ func TestResolveRejected(t *testing.T) {
|
||||
cases := []string{
|
||||
"/",
|
||||
"",
|
||||
"/secret.env", // 敏感后缀不在白名单
|
||||
"/notes.md", // 后缀不在白名单
|
||||
"/app.conf", // 配置文件不得外泄
|
||||
"/index.html", // 会被 ServeFile 重定向
|
||||
"/sub/dir.txt", // 只允许根路径单段文件名
|
||||
"/../secret.env", // 路径穿越
|
||||
"/1XXl8fPHr9.txt/../..", // 路径穿越
|
||||
"/missing.txt", // 文件不存在
|
||||
"/sub.txt", // 目录不是文件
|
||||
"/secret.env",
|
||||
"/notes.md",
|
||||
"/app.conf",
|
||||
"/index.html",
|
||||
"/sub/dir.txt",
|
||||
"/../secret.env",
|
||||
"/1XXl8fPHr9.txt/../..",
|
||||
"/missing.txt",
|
||||
"/sub.txt",
|
||||
}
|
||||
for _, c := range cases {
|
||||
if got, ok := r.Resolve(c); ok {
|
||||
@@ -77,7 +74,6 @@ func TestResolveRejected(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestAllowHost 确认域名白名单按「忽略端口 + 忽略大小写」匹配。
|
||||
func TestAllowHost(t *testing.T) {
|
||||
r := newTestResolver(t, Config{Dir: t.TempDir(), Hosts: "api.yunzer.cn"})
|
||||
|
||||
@@ -91,14 +87,12 @@ func TestAllowHost(t *testing.T) {
|
||||
t.Fatal("未在白名单里的域名不应被允许")
|
||||
}
|
||||
|
||||
// 未配置 hosts 时,所有走本服务的域名都生效
|
||||
all := newTestResolver(t, Config{Dir: t.TempDir()})
|
||||
if !all.AllowHost("api.yunzer.cn") || !all.AllowHost("dh2.fun") {
|
||||
t.Fatal("未配置 verify_hosts 时应允许所有域名")
|
||||
}
|
||||
}
|
||||
|
||||
// TestNewDisabled 确认 dir = "-" 表示关闭该功能。
|
||||
func TestNewDisabled(t *testing.T) {
|
||||
r, err := New(Config{Dir: "-"})
|
||||
if err != nil {
|
||||
@@ -109,7 +103,6 @@ func TestNewDisabled(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestDefaultExts 确认默认扩展名包含 .txt。
|
||||
func TestDefaultExts(t *testing.T) {
|
||||
r := newTestResolver(t, Config{Dir: t.TempDir()})
|
||||
found := false
|
||||
|
||||
@@ -5,8 +5,6 @@ import (
|
||||
"strings"
|
||||
)
|
||||
|
||||
// Compare 比较语义化版本号(按段数字比较,如 1.10.0 > 1.9.0)。不支持复杂 pre-release 规则。
|
||||
// 返回 -1 表示 a < b,0 表示相等,1 表示 a > b。
|
||||
func Compare(a, b string) int {
|
||||
pa := parseParts(a)
|
||||
pb := parseParts(b)
|
||||
|
||||
Reference in new issue
Block a user