From 74e785c91ea83a6ce19222fc2acc7d7ea9ad6305 Mon Sep 17 00:00:00 2001 From: Tory Date: Tue, 17 Nov 2026 13:12:10 +0800 Subject: [PATCH] =?UTF-8?q?memory-bank:=20B2=20=E6=94=B6=E5=AE=98=E5=9B=9E?= =?UTF-8?q?=E5=A1=AB(activeContext=20=E9=87=8D=E5=86=99=E4=B8=BA=20B3=20?= =?UTF-8?q?=E5=BC=80=E5=B7=A5=E6=80=81/B2=20=E5=9D=91=E7=95=99=E7=97=95?= =?UTF-8?q?=E4=BA=94=E6=9D=A1/progress=20=E8=A1=A5=20B2=20=E8=A1=8C)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- memory-bank/activeContext.md | 41 ++++++++++++++++++------------------ memory-bank/progress.md | 2 ++ 2 files changed, 23 insertions(+), 20 deletions(-) diff --git a/memory-bank/activeContext.md b/memory-bank/activeContext.md index cb22ca56..7caf9be4 100644 --- a/memory-bank/activeContext.md +++ b/memory-bank/activeContext.md @@ -1,32 +1,33 @@ -# 当前工作上下文(最近更新:2026-11-17 B1 收官,新会话从 B2 开工) +# 当前工作上下文(最近更新:2026-11-17 B2 收官,新会话从 B3 开工) -## ⭐ Issue#6 · B 方案执行中:B1 契约基座已收官(commit 96ab7b87),下一步 B2 三契约页 1:1 +## ⭐ Issue#6 · B 方案执行中:B2 三契约页已收官,下一步 B3 33 视图分批实装 -- **B1 已交付(web-next/ 新工程,零 EP/零旧影子)**:脚手架 7 件(:5174+proxy→8080/tsconfig ES2021)/styles/tailwind.css(=sub2api style.css 775 行直拷+契约补充段 stat-card 族+body.folded 折叠态)/IconSprite(契约 24 symbol 直挂)/逻辑层复制 27 文件(api 15/stores 3/router 2/data releases/utils 3,EP 引用全域归零)/壳层 5 件(BasicLayout mainWrap+keep-alive include=cachedNames/AppSidebar 256 折叠 72+RBAC 分组菜单与守卫 accessibleRoutes 同源/AppHeader glass blur 顶栏+主题+用户菜单/TagsBar Issue#2 语义 fullPath 身份+中键+关闭其他+全部+home 固定/VersionBadge Issue#4 红点 markSeen)/LoginView(sub2api AuthLayout 范式)/36 视图路由契约占位(name/title/group/roles/subtitle 对齐旧 routes,icon=契约 #i-*,component=ComingSoon)。 -- **B1 验收全绿**:vue-tsc 0/build ✓(主包 gzip 68KB)/chrome 冒烟 10/10(登录 s2demo→壳→RBAC 34 链接 7 组→标签条→版本徽章 markSeen 红点灭→主题/折叠)/契约 style 断言 8/8(teal 渐变/256/72/glass blur24/亮 gray-50/暗 slate-950)。冒烟脚本=/tmp/smoke-webnext.mjs、/tmp/style-webnext.mjs(临时不入库,B2 对拍可复用改写)。 +- **B2 已交付(commit 见 git log)**:三契约页 1:1 逐行直抄 v3-2-tailwind.html——#p-dash 运营总览(895-1005:横幅+stat 6+4+chart.js 趋势+donut+监控表+系统健康+动态+快捷+快照)/#p-acct 帐号管理(1006-1034:单卡一体筛选+8 列表+分页)/#p-chan 通道编辑(1035-1059:双卡表单+switch+操作条);全部真实数据,缺数据项显式 —。 +- **B2 连带根修**:①stats_handler.go 两处 `AS key` 撞 MySQL 8.0 保留字 → /stats/biz 500(P2 遗留 bug,反引号转义已修,单测绿);②网关旧二进制已重建重启(bin/gateway 现含 P2 三端点)。 +- **B2 验收**:vue-tsc 0/build ✓(dash chunk gzip 65KB)/冒烟 12/12/stat-card computed style 与 17890 双会话对拍一致(radius16/pad20/flex/gap16)。截图:/tmp/b2-dash|acct|chan|contract-dash.png。 -## B2 任务清单(新会话直接执行;对拍基线=http://192.168.5.18:17890/ v3-2-tailwind.html) +## B3 任务清单(新会话直接执行) -1. 三契约页 1:1 实装(routes.ts 换 component):#p-dash 运营总览(home;stat-card×4+chart.js 趋势图+动态流;消费 P2 已合 main 的 3 端点 /ops/system/overview+/stats/biz+/stats/realtime)/#p-acct 账号管理(account-list;筛选区 border-b+原生 table+分页条单卡一体)/#p-chan 通道编辑(channel-edit;表单范式)。 -2. 与 17890 computed style 逐页对拍(断言脚本口径同 /tmp/style-webnext.mjs)。 -3. 三页必须 defineOptions({name:路由名})(home/account-list/channel-edit),否则 keep-alive 不命中。 -4. 契约源段:#p-dash≈895-1005 行/#p-acct≈1006-1060 行/#p-chan≈1060-1066 行(v3-2-tailwind.html 全文件已通读)。 -5. 后续:B3 33 视图范式族分批→B4 收口(切部署/旧 web 归档/测试 verify 重建/统一人工验收单/CHANGELOG/Gitea#6)。 +1. 33 视图分批实装(占位 ComingSoon 逐个替换;routes.ts component 已就位待换):范式族=表格页(ProTable 语义+契约表格 class)/表单页(契约 chan 范式)/详情页;**每页 defineOptions({name:路由名})**。 +2. 范式族映射:审核中心/记录中心/统计结算=表格族;开户/充值=表单族;账号详情=详情族。 +3. 每批完成后冒烟+commit;B4 收口(切部署/旧 web 归档/verify 重建/统一验收单/CHANGELOG/Gitea#6)。 ## B 方案决议留痕(2026-11-17 拍板) -- **决议(用户原话)**:执行 B 方案;**必须不要有旧前端的影子**;**新增前端工程目录**,不要混乱;A 方案(EP 换肤模拟)彻底废弃。 -- **根因留痕(P3 被否决)**:① 契约 v3-2-tailwind.html(1097 行)内含 **3 页蓝本**——#p-dash 运营总览/#p-acct 账号管理(单卡一体:筛选区 border-b+原生 table+分页条)/#p-chan 通道编辑(表单范式),P1 验收只认知 Dashboard 页,"统一范围"被窄化为壳层;② **sub2api 前端无 Element Plus**(package.json 实证:Vue3+Tailwind+自研 class 件+chart.js),用 EP 模拟非 EP 生态转译损耗是结构性的。P3 六 commits(31815cf9→2bf43d33)留档不回滚。 -- **零影子复用边界**:✅ 仅**复制**纯逻辑层进新目录(不跨目录 import 旧 web/);❌ 零复用:全部样式/36 视图/全部组件/EP 依赖(不装)。 -- **技术栈(契约同款实证)**:Vue3.5+TS5.6+Vite5+Tailwind 3.4+PostCSS8+autoprefixer+SVG sprite 图标(,契约 defs 直挂)+chart.js/vue-chartjs(Dashboard)。 +- **决议(用户原话)**:执行 B 方案;**必须不要有旧前端的影子**;**新增前端工程目录**;A 方案(EP 换肤模拟)彻底废弃。 +- **开发蓝本(用户重申)**:**v3-2-tailwind.html 按这个来开发前端**——文件里有什么,页面就做成什么样,不自由发挥;class 串 1:1 直抄。 +- **根因留痕(P3 被否决)**:① 契约 v3-2-tailwind.html 内含 3 页蓝本,P1 只认知 Dashboard 页;② sub2api 无 EP,EP 模拟转译损耗结构性不可救。P3 六 commits 留档不回滚。 +- **零影子复用边界**:✅ 仅复制纯逻辑层;❌ 零复用:样式/视图/组件/EP。 -## 环境要点(B2 沿用) +## 环境要点(B3 沿用) + +- web-next dev:`cd web-next && npx vite --host 0.0.0.0 --port 5174 --strictPort`(nohup);依赖已装齐;:5173 旧 web 并行不动。 +- 网关 :8080 已重建(含 P2 三端点);/stats/biz 保留字 bug 已修;**后端改动仅 stats_handler.go 一处**。 +- chrome 铁律:channel:'chrome'+独立 launch+单 page;**同 browser 二次跨域导航会 ERR_ABORTED(CPU 缺陷),对拍用双会话**(/tmp/duel-style.mjs 模式);playwright 用 web/node_modules。 +- 冒烟账号 s2demo/S2demo@2026;dev 库:账号 3+/通道 1(Hw测试专用)/近 7 日 206 万条。 +- 坑留痕(B2 实录):①editor 大文件必须分段 insert,数好 template/script 闭合(根 div 缺闭合=plugin-vue 报 missing end tag,vue-tsc 不查模板结构);②MySQL 8.0 `key` 是保留字,SQL 别名必须反引号;③网关二进制日期要核对(bin/gateway 可能落后 main);④curl 循环带 TOKEN 必须同一命令字符串(多条命令=独立 shell 变量丢);⑤17890 契约预览 python http.server 对 HEAD/快速二连可能 abort。 +- **Gitea API 已通**(账号 Tory):token 存 `/tmp/gitea_token`;写评论=POST /api/v1/repos/Tory/go-sms-V2/issues/{n}/comments。 -- web-next dev 口径:`cd web-next && npx vite --host 0.0.0.0 --port 5174 --strictPort`(nohup 后台;:5173 是旧 web 的,两者并行);npm 依赖已装齐(154 包,registry 直连可用)。 -- 后端网关 :8080 在跑;/channels/monitor/ws 现成;后端零改动。 -- chrome 铁律:channel:'chrome'+独立 launch+单 page;playwright 用 web/node_modules 的(web-next 未装);dev admin 冒烟账号 s2demo/S2demo@2026。 -- 坑留痕(B1 实录):①pgrep -f 'vue-tsc' 匹配自身 bash 壳误判 RUNNING(排查用 pgrep -af 看 cmdline);②契约 .btn-primary 是 bg-gradient(backgroundColor=transparent),断言主色须查 backgroundImage;③暗色态断言按 dark: 变体口径(sidebar-link-active 暗=primary-900/20,hover=/30);④30s 命令超时:npm install/vue-tsc/冒烟一律 nohup 后台+轮询 log;⑤旧 web「帐号管理」用「帐」字,:has-text 选择器注意;⑥5174 曾被旧 web 遗留 vite dev 占用已杀,:5173 旧 dev(pid 2502998)保留不动。 -- **Gitea API 已通**(账号 Tory):token 存 `/tmp/gitea_token`(600,勿入 git;失效则请用户在 192.168.5.27:24400 Settings→Applications 重生成);**#6 B 方案决议评论已发布(201)+#4 完成评论历史欠账已补发(201)**;写评论口径=POST /api/v1/repos/Tory/go-sms-V2/issues/{n}/comments diff --git a/memory-bank/progress.md b/memory-bank/progress.md index b1ebe047..ebe9da7f 100644 --- a/memory-bank/progress.md +++ b/memory-bank/progress.md @@ -27,6 +27,8 @@ | Issue#6·P3 壳层契约化 | tokens(teal16 阶+slate/gray+字阶 10~24+lh1.65+旧名兼容)+shell(侧栏 256/折叠 72 品牌区/顶栏 64 glass/card r16 实底/td14·py16px20/aurora 退役)+MainLayout 重排(brand→侧栏+版本徽章迁位+icon20)+TagsBar 契约化+ep-theme(teal/emerald 分离/表格密度桥/渐变桥退役)+全站旧值清零;verify-layout 31/31(类名锚点策略兑现,仅续 2 值断言)+verify-p3-contract.mjs 30/30 双主题 DOM 断言+vitest 182 全绿(Issue#2/#4 资产无伤);6 commits | ✅ 2026-11-17 | | Issue#6·P3 壳层改造(EP 路线) | **用户验收否决→B 方案(0 重构 web-next)拍板**:契约实含 3 页蓝本(dash/acct/chan)P1 只认知 1 页;sub2api 无 EP(实证),EP 模拟非 EP 转译损耗结构性不可救;P3 六 commits 留档不回滚;决议=新工程 web-next(Tailwind3.4+契约 CSS 直拼+零 EP+零旧影子,仅复制逻辑层清 EP 引用);B1 契约基座→B2 三契约页对拍→B3 33 视图→B4 收口 | ❌ 2026-11-17(教训:机器断言全绿≠用户感知范围,契约类文档必须全文件通读) | | Issue#6·B1 web-next 契约基座 | 新工程 web-next 落地(commit 96ab7b87):脚手架 7 件(:5174+proxy→8080,无 EP)+tailwind.css(sub2api 775 行直拷+契约 stat-card/folded 补充)+IconSprite(契约 24 symbol)+逻辑层复制 27 文件(EP 归零)+壳层 5 件(BasicLayout/AppSidebar/AppHeader/TagsBar/VersionBadge,Issue#2/#4 语义保留)+LoginView(sub2api 范式)+36 视图路由契约占位;**验收=vue-tsc 0/build ✓ gzip 68KB/冒烟 10/10/style 断言 8/8** | ✅ 2026-11-17(B2 三契约页 1:1 对拍为下一步) | +| Issue#6·B2 三契约页实装 | **v3-2-tailwind.html 按页 1:1 直抄落地**:#p-dash 运营总览(横幅+stat 6+4+chart.js 双线趋势+动态 donut+监控表 5s 轮询+系统健康 10s 轮询+快捷+快照)/#p-acct 帐号管理(单卡一体筛选+8 列表+分页,真实账号)/#p-chan 通道编辑(双卡表单+switch,协议↔版本映射);api 层补 P2 三端点封装;**连带根修:/stats/biz 撞 MySQL 保留字 `key` 500(反引号已修)+网关旧二进制重建**;验收=冒烟 12/12+stat-card style 与 17890 对拍一致 | ✅ 2026-11-17(B3 33 视图分批为下一步) | + | 观察项 | 24h 稳定性门槛(11-13 17:55 起计;期内 21:33 宿主主动重启=已知事件不判失败)期满核验 11-14 17:55 | ✅ 2026-11-14 18:02 终判通过(dmesg 0/零重启/驻留+md5 一致;S5 压测前置确认,S1 完全闭环) | | S2~S5 | 结算域/前端收尾/C1C2+冷热/基线与灰度 | 🔄 S2✅S3✅**S4✅收官**(S5 见《Go-sms-重建计划.md》) |