Changelog · v20260504.14

v20260504.14 新功能 LATEST 2026-05-04

#12 VIP skill pack endpoint minimal v0.1 (closes #12)

/api/skills-pack?domain=xxx&tier=vip 動態回傳 marketplace.json
Free tier 403 / VIP tier 含隨機 API key + Apache 2.0 署名 aaron-he-zhu/seo-geo-claude-skills
20 skills + 17 commands 由 plugins 區段引用 upstream GitHub URL（v0.2 才做 R2 客製 zip 託管）
src/pages/docs.astro 加 VIP skill pack API 文件段落

v20260504.13 新功能 2026-05-04

#13 CORE-EEAT 80 項評分 minimal v0.1 (10 item, closes #13)

src/lib/eeat/{checks,scorer}.ts — 10 item 跨 8 dimension（從 80 抽精華），用 #17 LLM router eeat-quality chain 跑 LLM 評分
POST /api/audit/[id]/eeat 並行 10 LLM call (~5-10s)，寫入 D1 audit_runs.eeat_total + eeat_json
src/db/schema.ts +eeat_total/eeat_json + ALTER TABLE prod + dev D1
/report/[id] 加 EEAT 區塊（score 卡片 + 8 dimension breakdown + Apache 2.0 署名 aaron-he-zhu/core-eeat-content-benchmark）
PDF 自動同步顯示 EEAT (browser rendering 走同一 /report)
實測 ciphlens.com EEAT 48/100（expertise/auth 0 — 沒標作者背景；clarity/currency 100 — 清楚且時效新）
未做（v0.2+）：完整 80 item / 詳細 reasoning 顯示 / VIP-only 條件渲染

v20260504.12 新功能 2026-05-04

#15 admin LLM stats 完整版 + telemetry hook (closes #15)

src/lib/llm/router.ts 加 D1 telemetry write hook（每次 LLM call 寫一筆 llm_calls）
src/lib/llm/cost-table.ts 估算 9 個 model in/out cost per M tokens
D1 llm_calls 表 (CREATE TABLE IF NOT EXISTS 套用 prod + dev)
/admin/llm-stats 後台儀表板：今日/週/月 call/cost、依 model 分組、依 tier 分組、最近 50 筆細節
Drizzle SQL bug fix：CASE...END as bucket 用 expression 共用而非字串 alias
實測：6 calls /bin/zsh.0001 total，1 個 503 自動 fallback gemini-pro→flash 成功

v20260504.11 新功能 2026-05-04

#16 真實 GEO probing v0.1 — Gemini 5 條 query 量測 (closes #16)

src/lib/geo/probe.ts 用 LLM router (#17) 對 Gemini 發 5 條 hardcoded query，偵測回應是否含 domain
POST /api/audit/[id]/geo endpoint — 跑 probe 寫 D1 audit_runs.geo_score
src/db/schema.ts 加 geoScore col + ALTER TABLE 已套用 prod + dev D1
src/pages/report/[id].astro 真實 geo_score 優先，fallback 才用 mock；UI 標註資料來源
實測 ciphlens.com: 5/5 cited=false → GEO 0（網站太新沒進 Gemini 訓練集，真實情況）
PDF 同步顯示真實 GEO，列印場景白底版本完整一致

v20260504.10 新功能 2026-05-04

#17 LLM router minimal v0.1 — gemini + openrouter + workers-ai 三 provider 三 chain

src/lib/llm/{router,types,index}.ts + providers/{gemini,openrouter,workers-ai}.ts
Chains: eeat-quality (claude-sonnet-4-6 → gemini-2.5-pro → gpt-5 → qwen-72b) / eeat-default / geo-gemini
wrangler.json 加 ai binding（prod + dev）
env.d.ts 加 GEMINI_API_KEY / OPENROUTER_API_KEY / AI 型別
尚未接 audit 流程；#16 真實 GEO 接續
minimal 範圍：無 cache / 無 cost cap / 無 D1 telemetry（#15 一起做）

v20260504.9 新功能 2026-05-04

共用 Nav 元件 + dogfood weekly cron + Phase 1 dogfood report

src/components/Nav.astro 抽出共用 nav (variant default/right + active prop)；10 個 .astro 散修 → 1 處改動 (closes #11)
src/pages/api/cron/dogfood.ts 受 X-Cron-Secret 保護的 endpoint，內部跑 ciphlens.com self-audit 寫 D1 (closes #9)
src/cron/dogfood.ts 加 Cloudflare Cron Trigger（每週日 16:00 UTC = 台北一早）+ scripts/patch-cron.mjs 解 adapter 不支援 scheduled 限制
src/pages/insights/dogfood.astro 公開頁 — 顯示自家 AEO 時序
wrangler.json crons 用 SUN 而非 0（wrangler 4.87 cron parser 偏好）
docs/research/17-aaron-skills-dogfood.md (closes #14) — 評估 aaron-he-zhu/seo-geo-claude-skills；結論：抽精華移植 #13、整套作 VIP pack #12

v20260504.8 新功能 2026-05-04

PDF 列印模式：白底黑字 (?print=1)

/report/[id].astro 偵測 ?print=1 加 body.print-mode + 反轉 CSS vars (白底深字)
/api/audit/[id]/pdf 改打 /report/{id}?print=1 + cache key 改為 pdfs/{id}-light.pdf 自動 bust 舊深色 PDF
@media print 兜底列印場景；PDF 大小從 ~1.1MB → 918KB（背景留白省墨）

v20260504.7 新功能 2026-05-04

audit + demo 頁面加 <main> wrapper（語意 HTML 一致性）

/audit 與 /demo 兩個高訪入口頁加 <main> 包覆 nav 後的內容
與 / 首頁的 semantic-html 提升一致
派工：cc-zai (GLM-5.1) → diff +4 行，無其他改動

v20260504.6 新功能 2026-05-04

GA4 全站化（middleware 注入），/admin 隔離不追蹤

從 src/components/GA4.astro 散修，改為 middleware 統一注入到所有 HTML <head>
/admin/* 路徑不注入 GA4（避免追蹤後台 admin 操作）
dev 環境若有 PUBLIC_GA4_ID 會傳 debug_mode: true（目前 dev 無 ID 故不渲染）
驗證：6 個入口頁全有 G-2YGQ5746DK，/admin/cost 0 個 GA4 出現

v20260504.5 新功能 2026-05-04

AEO 84→95：security headers + main 元素 (closes #23 better)

中介層加 5 個 security headers（HSTS/CSP/X-Frame/X-Content/Referrer-Policy）— security-headers 0/5 → 5/5
首頁 index.astro 加 <main> wrapper — semantic-html 6/12 → 12/12
PRD AEO 自評目標 ≥75 大超越（達 95，剩 1 項 warn=content-ratio 受限結構難改）

v20260504.4 修正 2026-05-04

self-audit AEO 26→84 + GA4 ID 上線 (closes #23)

根因：CF Workers self-fetch loop — fetch 自家 zone 被擋回 16 byte error
解法：wrangler service binding env.SELF，audit 對自家 hostnames 走 SELF.fetch（CF 唯一允許 self-fetch 路徑）
ciphlens.com 自家 AEO 從 26 → 84（6 ok / 2 warn / 1 fail，超過 PRD ≥75 目標）
順便上 GA4 measurement ID G-2YGQ5746DK 進 wrangler.vars.PUBLIC_GA4_ID

v20260504.3 新功能 2026-05-04

ciphlens-cdn / ciphlens-cdn-dev R2 buckets + binding (closes #19 部分)

wrangler r2 bucket create ciphlens-cdn (prod) + ciphlens-cdn-dev (dev) — buckets 已建
wrangler.json 加 env.CDN binding (prod 與 env.dev 各一)
src/env.d.ts 加 CDN?: R2Bucket 型別
scripts/setup-cdn-domain.md 留給 user 手動完成 dashboard 綁 cdn.ciphlens.com / cdn-dev.ciphlens.com（OAuth token 無 zone 權限）

v20260504.2 新功能 2026-05-04

Wave 1 收網：#18 + #10 + #21 + #22 全綠

#18 typescript + @astrojs/check 裝完，typecheck 可跑（暴露 19 既有錯，CI 暫容錯）
#10 GitHub Actions build.yml — push 自動 build + typecheck
#21 GA4 component scaffold（PUBLIC_GA4_ID env）
#22 /admin/cost MVP — Basic Auth + R2/D1 用量收集 + 月費估算
派工：cc-zai + kimi-cc + mini-cc QA 全 PASS

v20260504.1 雜項 2026-05-04

LLM strategy 對齊實際 key 狀況 + zshrc 同步腳本

llm-strategy.md：更新 chains 反映 OpenRouter 代打 OpenAI/Anthropic/Perplexity 的真實狀況
.env.example：標記必備 vs 選配 keys
新增 scripts/sync-zshrc-keys.sh 從 ~/.zshrc 自動抽 GLM/MiniMax/Kimi tokens 寫入 .env

v20260503.10 文件 2026-05-03

新增 infra.md + llm-strategy.md + 重整 .env.example

infra.md：完整軟硬體架構、第三方依賴、6 大資料流、12 把 LLM key 規劃
llm-strategy.md：12 provider 矩陣 + 8 條 fallback chain + telemetry + cost cap
.env.example：清掉舊 PG/Redis，加 12 把 LLM key + ADMIN_PASSWORD 範本（生產走 wrangler secret）

v20260503.9 文件 2026-05-03

從現有產品反推 PRD

填入 Problem / User / Success / Non-Goals / Journeys / Risks / Scope / 決策歷史
標出 5 項待 operator 決策的事項（學界用戶、商業 KPI、法務 audit、dogfood、Post-MVP 優先序）
對齊 spec / systemdesign / roadmap / cc-orchestra 文件指針

v20260503.8 雜項 2026-05-03

啟用 superpowers plugin (移除重複)

保留 superpowers@superpowers-marketplace（obra 官方 5.0.7）
停用 superpowers@claude-plugins-official（社群鏡像 5.0.5，避免 14 skills 重複註冊）
新增 14 個 skills + /brainstorm /write-plan /execute-plan 三個 slash commands

v20260503.7 文件 2026-05-03

新增 cc-orchestra workflow 文件

全域 skill 在 ~/.claude/skills/cc-orchestra/（SKILL.md + PATTERN.md + 3 個 template）
專案內快速索引在 docs/cc-orchestra.md，含本次 case study + 專案特化注意事項
下次 Claude 看到「派工」「dispatch」「用 cc-zai/kimi-cc/mini-cc」會自動觸發此 skill

v20260503.6 重構 2026-05-03

/admin/crawlers → /insights/crawlers 改名為公開透明度頁 (closes #2)

頁面從「儀表板」內部工具改為「透明度」公開報告
全 src/ 9 處 nav ref 同步改為 /insights/crawlers + 文字改為「透明度」
順便修 lang="en" → "zh-TW"
派工：kimi-cc (Kimi K2) 跨檔重構 → mini-cc QA PASS

v20260503.5 新功能 2026-05-03

首頁加 FAQPage schema (closes #1)

首頁新增第三個 JSON-LD：FAQPage（5 組 Q&A）
5 組問答抽自 /faq 頁，涵蓋 AEO 定義、ChatGPT 引用率、GEO 計算、Schema.org、Free vs VIP
派工：kimi-cc (Kimi K2) 跨檔抽 FAQ + 寫 JSX schema → mini-cc PASS

v20260503.4 新功能 2026-05-03

全站 nav 加上 Changelog 連結 (closes #4)

9 個 .astro 檔案的 nav 都新增 /changelog 連結（about/faq 各含 mobile + desktop）
demo.astro 用 div.nav-right 結構，比照鄰近 anchor 風格
派工：cc-zai (GLM-5.1) 散修 11 處 → mini-cc QA PASS

v20260503.3 修正 2026-05-03

三大入口頁 lang 改為 zh-TW (closes #3)

首頁 / /audit / /demo 三大入口頁原本標 lang="en" 但內容是繁中
修正後解決 SEO/AEO 語言一致性問題（CiphLens 自家稽核也會 fail 此項）
派工流程：cc-zai (GLM-5.1) 改 → mini-cc (MiniMax-M2.7) QA PASS

v20260503.2 新功能 2026-05-03

建立 /changelog + 版本管理系統

新增 src/lib/version.ts 作為版本與變更記錄唯一資料源
新增 /changelog 頁面（navy 主題、LATEST 標記、kind 分色）
新增 scripts/bump-version.mjs + bun run bump 一鍵升版
Watermark / curl 範例 URL 從 ciphlens.ifangdar.workers.dev 全面改為 ciphlens.com
test:e2e:prod 改打 ciphlens.com

v20260503.1 新功能 2026-05-03

建立 /changelog 頁面與版本管理機制

新增 src/lib/version.ts — 版本與變更記錄唯一資料來源
新增 /changelog 頁面，自動依版本由新到舊渲染
Watermark / curl 範例 URL 從 ciphlens.ifangdar.workers.dev 改為 ciphlens.com（badge SVG、demo PDF footer 同步修正）
導覽列加入 changelog 連結

每次 commit，都留下痕跡