fix(session-policy): 修复 Dashboard XSS 风险并标注 client_category 为预留字段;

- 新增 escapeHtml() 工具函数，对所有用户可控数据（session_key、models、vendors、categories）插入 innerHTML 前进行 HTML 实体转义
- title 属性中的 session_key 同样使用转义后的值
- 在 SessionPolicyMatch.client_category 字段描述和 config.default.yaml 中明确标注该条件为预留功能，当前版本暂未生效

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>

Author: ThreeFish-AI

src/coding/proxy/config/config.default.yaml

@@ -652,7 +652,7 @@ native_api:
 #
 # 支持的匹配条件（OR 语义，满足任一即匹配）：
 #   session_keys:    精确匹配的 session key 列表
-#   client_category: 按客户端类别匹配（"cc" = Claude Code，"api" = 原生 API 透传）
+#   client_category: 按客户端类别匹配（⚠️ 预留字段，当前版本暂未生效，后续版本支持）
 #
 # tiers: 覆盖全局 tier 顺序的供应商优先级列表（未提及的 vendor 保持在末尾）
 #

src/coding/proxy/config/session_policy.py

@@ -14,7 +14,11 @@ class SessionPolicyMatch(BaseModel):
     )
     client_category: str | None = Field(
         default=None,
-        description="按客户端类别匹配（'cc' 或 'api'）",
+        description=(
+            "按客户端类别匹配（'cc' 或 'api'）。"
+            "⚠️ 预留字段，当前路由执行链路未传入 client_category，"
+            "配置此条件不会生效。后续版本将支持。"
+        ),
     )
 
 

src/coding/proxy/server/dashboard.py

@@ -1323,9 +1323,13 @@ def _build_favicon() -> bytes:
   if (diff < 86400) return Math.floor(diff / 3600) + 'h ago';
   return Math.floor(diff / 86400) + 'd ago';
 }
+function escapeHtml(s) {
+  if (!s) return '';
+  return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;').replace(/'/g,'&#39;');
+}
 function truncateKey(key, maxLen) {
-  if (!key || key.length <= maxLen) return key || '–';
-  return key.slice(0, maxLen - 3) + '…';
+  if (!key || key.length <= maxLen) return escapeHtml(key) || '–';
+  return escapeHtml(key.slice(0, maxLen - 3)) + '…';
 }
 function successBarHtml(pct) {
   if (pct == null) return '–';
@@ -1338,7 +1342,7 @@ def _build_favicon() -> bytes:
   if (!str) return '–';
   var list = str.split(',');
   var html = list.slice(0, max).map(function(c) {
-    return '<span class="session-tag">' + c.trim() + '</span>';
+    return '<span class="session-tag">' + escapeHtml(c.trim()) + '</span>';
   }).join('');
   if (list.length > max) html += '<span class="session-tag">+' + (list.length - max) + '</span>';
   return html;
@@ -1347,7 +1351,7 @@ def _build_favicon() -> bytes:
   if (!cats) return '–';
   return cats.split(',').map(function(c) {
     var t = c.trim();
-    var label = t === 'cc' ? 'Claude Code' : (t === 'api' ? 'API' : t);
+    var label = t === 'cc' ? 'Claude Code' : (t === 'api' ? 'API' : escapeHtml(t));
     return '<span class="session-tag">' + label + '</span>';
   }).join('');
 }
@@ -1370,7 +1374,7 @@ def _build_favicon() -> bytes:
     }
     tbody.innerHTML = sessions.map(function(s) {
       return '<tr>' +
-        '<td class="session-key" title="' + (s.session_key || '') + '">' + truncateKey(s.session_key, 22) + '</td>' +
+        '<td class="session-key" title="' + escapeHtml(s.session_key) + '">' + truncateKey(s.session_key, 22) + '</td>' +
         '<td>' + relativeTime(s.last_active_ts) + '</td>' +
         '<td style="font-family:JetBrains Mono,monospace">' + fmtNum(s.total_requests) + '</td>' +
         '<td style="font-family:JetBrains Mono,monospace">' + fmtTokens(s.total_tokens) + '</td>' +