更新密码找回uniapp

This commit is contained in:
hero920103 committed 2026-11-16 17:22:50 +08:00
1 parent 7f9a66da0f
commit 3fdda89833
1304 files changed
+3503 -26132

No files matched your search

-23
View File
@@ -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 {
-55
View File
@@ -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
+2 -44
View File
@@ -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
-23
View File
@@ -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()
-4
View File
@@ -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)
+5 -46
View File
@@ -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) ||
-6
View File
@@ -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
View File
@@ -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
+1 -6
View File
@@ -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 密钥对")
+2 -26
View File
@@ -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[:])
-4
View File
@@ -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("空密码应返回错误")
+5 -34
View File
@@ -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 {
+7 -10
View File
@@ -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{
{
-29
View File
@@ -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 {
+2 -12
View File
@@ -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)"
-35
View File
@@ -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 {
+9 -16
View File
@@ -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
-2
View File
@@ -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)