jianf/HomeDash
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
52 Commits 2 Branches 0 Tags
a78c5180ca10da0814872425cdfe6cf7c163880c
Commit Graph

16 Commits

Author SHA1 Message Date
HomeDash Bot
817a5991b3 fix(theme): 基于真实浏览器渲染修复深色文字与右侧方块 
此前只检查 CSS 规则存在，没有检查真实页面 computed style，导致标题、分组标题、
卡片正文仍被前面的亮色 !important 规则覆盖；右侧 dock/view-switch 布局容器也被
错误涂上背景，形成灰色方块。

这次通过共享 Chromium 实际登录并强制深色模式，逐项读取 computed style：
- 顶部标题 #f1f5f9
- 分组标题 #dce6f5
- 卡片主文字 #f1f5f9、说明 #a9b8cd
- 分组/卡片使用协调的深色玻璃层级
- dock 与 view-switch 布局容器完全透明，仅两个圆形按钮着色
- 备案号为完整深色胶囊，子元素透明
- 工作空间/极简视图同步补齐深色侧栏、工具条和弹窗

自动验证同时断言：文字亮度、深色面板、透明容器、圆形按钮、零运行时异常。
新增 deploy/zd-host.sh，供单容器正式接管入口后的 host 网络部署使用；失败自动回滚。
 2026-09-12 07:30:00 +08:00
HomeDash Bot
44e2792f0e fix(theme): 深色下主页底色与右下悬浮件仍不生效 
现象：主页大面积没变深；右下角仍有一块灰色方块。

根因：
1. conf.yml 的玻璃主题用 html[data-theme] body 设了亮色背景，特异度与
   html.navi-dark body 相同(0,1,1)，而 customCss 由 Dashy 运行时注入、排在
   navi.css 之后 —— 平局时后者胜出，所以页面底色没被改掉。
2. 右下那块是我们自己的悬浮件，但此前只逐个类名列举，漏掉的类名就保持原样。

改法：
- navi.js 把 navi-dark 同时打到 <html> 与 <body>（并在 DOMContentLoaded 再应用一次）
- navi.css 用 html.navi-dark body.navi-dark 提高特异度到 (0,2,1)，压过 customCss，
  与注入顺序无关
- 兜住 Dashy 外层容器（#dashy/.home/.workspace/.minimal-home）与原生页脚
- 用 [class^="navi-"]/[class*=" navi-"] 整体兜住我们注入的悬浮件，避免再漏类名
 2026-09-11 23:38:56 +08:00
HomeDash Bot
b1e4367937 fix(theme): 深色改为整套主题变量覆盖，不再改写 data-theme 
用户反馈"深色区域有的方形、有的根本没变深"。根因有两层，都是我的做法错了：

1. navi.js 会把 <html data-theme> 改成 "dark"。Dashy 的配色变量是按主题名
   作用域输出的（本站主题 jianf-glass），改掉它 → 整套主题变量失配 →
   有的区域完全没变深。
2. navi.css 之前只覆盖"页面底色 + 我们自己的悬浮件"，Dashy 自己的卡片/侧栏/
   头部仍走原主题 → 与深底色拼在一起，就成了直角圆角混杂。

改法：
- navi.js 只切 <html class="navi-dark">（并设 color-scheme），绝不碰 data-theme
- navi.css 用 html.navi-dark 一次性覆盖 jianf-glass 的全部配色变量（47 个：
  背景/卡片分组/条目文字/侧栏/头部导航/搜索框/设置面板/弹层/滚动条/语义色），
  Dashy 自身界面随之整体一致变深；形状由元素自身样式决定，不再混杂
- 选择器 html.navi-dark 特异度(0,1,1) 高于 [data-theme=…](0,1,0)，与注入顺序无关

需要目视确认配色层次（变量值只能看着调）。
 2026-09-11 23:31:27 +08:00
HomeDash Bot
a8ce6ad759 feat(theme): 导航页恢复自动深浅色（跟随系统），保留隐藏原生设置入口 
用户反馈：现在没有自动深/浅色。实测原因有两层：
1. Dashy 原生的日/夜切换按钮在设置面板里，而该面板按要求被隐藏；
2. navi.css 没有任何 prefers-color-scheme 分支，且多处写死亮色。

本提交按"我们自己接管"实现（不去赌 Dashy 压缩后的主题存储键）：
- navi.js：默认跟 prefers-color-scheme；手动切换过以 localStorage.navi-theme 为准；
  系统偏好变化实时跟随；给 <html> 设 data-theme 与 .navi-dark，并设 color-scheme。
  Dashy 挂载后可能覆写 data-theme，用短暂定时对齐 + 属性观察器收口
  （仅在"与期望不一致"时回写，避免自激循环）。
- navi.css：深色下覆盖页面底色与文字，以及我们自己注入的悬浮控件
  （搜索条/收边控件/页脚/工作空间工具条与弹窗/迷你视图标签条）。
  选择器带 body 以压过主题注入的 customCss。

需要人工目视确认观感（深色下的玻璃层次只能靠眼睛调）。
 2026-09-11 23:18:54 +08:00
HomeDash Bot
26a0b15014 perf(web)+fix(admin): 撤掉卡片层模糊、补隐藏动画、后台窄屏适配、收边两段式 
1) 卡顿：撤掉"重复且参与动画"的卡片层 backdrop-filter
   实测首页 37 个元素带模糊（24 张卡片 + 6 个分组容器 + 顶栏 + 悬浮件）。
   模糊要对背景逐帧重采样，而卡片又参与逐张淡入与悬停位移，叠加就是卡顿。
   现在只保留分组容器的玻璃感与悬浮件（搜索栏因宽/圆角/内边距一直在变也去掉）。
   实测：/ 从 37 → 12，/minimal 从 15 → 4。
   注意：选择器必须写成 html[data-theme] body a.item —— 主题的 customCss 由
   Dashy 运行时注入，同权重 + 同为 !important 时靠文档顺序决胜，写在 navi.css
   里的规则会输，必须提高特异性。

2) 隐藏/出现补动画
   ≤380px 让位隐藏按钮组：加上 opacity+位移过渡，并把 visibility 延迟到淡出
   结束再切（否则瞬间消失、看不到过渡）。弹层关闭先加 .closing 淡出再摘节点。
   降动效模式下不再用 transform:none 抹掉"收边"的位移，避免隐藏失效。

3) 工作空间收边改为"第一次交互只滑出"
   收起态点一下只滑出、不触发（否则贴边的按钮会被直接点中，比如想看搜索框
   结果把管理后台打开了）；第二次点击才生效。判据是"元素是否真的露在视口内"，
   所以鼠标悬停已展开时一次点击即生效。6 秒无操作或 Esc 自动收回。

4) 后台窄屏：分组行原本是内联 flex + 固定 max-width，窄屏既不能换行也不能
   收缩，输入框顶破卡片。改用类 + ≤560px 适配（竖排、整行占满、按钮右对齐、
   字号 16px 防 iOS 聚焦缩放）。实测 390px：scrollWidth == innerWidth、
   零横向溢出。
 2026-09-11 20:13:44 +08:00
HomeDash Bot
76a6a83e7d feat(web): 不支持内嵌时明确弹层；修掉被 promise 吞掉的 ReferenceError 
1) 点不支持在工作区显示的应用 → 弹出提示卡片
   标题「该应用不支持在工作区显示」+ 域名 + 服务器返回的原因 +
   「在新标签页打开 / 知道了」两个按钮；面板里同时保留同样的说明。
   之前只在面板里显示一行字，用户点了之后缺少明确反馈。

2) 修 ReferenceError: openUrl is not defined（线上真实故障）
   setWorkspaceState 第 4 个参数早先从 openUrl 改名为 note 时，blocked
   分支漏改，于是每次被拒内嵌都在函数内部抛异常，异常沿 promise 链被吞，
   导致后面的弹层根本没有执行、面板提示也只渲染到一半（URL 行和按钮缺失）。
   教训：验收必须采集 Runtime.exceptionThrown，并且断言交互元素真的存在；
   只断言"状态=blocked + 提示文字前缀"会恰好掩盖这类错误。
 2026-09-11 19:52:19 +08:00
HomeDash Bot
f40e54287b fix(web): 极窄屏备案号不再顶到按钮；mini 叶签两端改为渐变淡出 
1) 备案号与自定义按钮只剩 1px
   实测 320x640：备案号换行成两行、高 66px，占据距底 11..77；而搜索球/
   按钮组固定在 bottom:76px → 两者实测只剩 1px（视觉上已贴上）。
   修法：≤380px 时把按钮上移到 bottom:88px，并收紧页脚 gap/padding
   （两行高度仍 66px）→ 实测净间隙 11px。≥390px 时备案号是单行 39px，
   间隙本就充足，保持不变。

2) mini 顶部叶签被两侧按钮硬切
   结构是 [‹按钮 34px][滚动行][›按钮 34px]，滚动行 overflow-x:auto
   （内容 858px / 可视 294px），卡片直接在滚动行边缘被切断，没有任何过渡。
   修法：给滚动行加 mask-image 两端各 24px 渐变淡出，并用 :has() 关联
   翻页按钮的 disabled 状态 —— 已经在尽头的一侧不再淡出（两端都到头则
   完全不遮罩），避免"到头了还在渐隐"的错觉。
   实测：最左时 mask 为「左侧实心 + 右侧渐隐」，滚到最右变为
   「左侧渐隐 + 右侧实心」。
 2026-09-11 19:18:00 +08:00
HomeDash Bot
8ba5e5117b feat(web): 工作空间内嵌网页 + 控件收边 + 页脚去重 + 窄屏不再重叠 
1) 工作空间真的在中间打开网页
   Dashy 的面板就是 iframe，但它的 launchApp() 只在 target 不是 newtab 时
   才把 URL 灌进 iframe；而且侧栏项目大多没有 per-item target，Dashy 走的是
   Vue 直接改 iframe.src 的路径 —— 根本不经过 window.open，导致判定逻辑被
   绕过（实测：Gitea 仍被内嵌、空白）。现在两条路径统一进 verifyAndShow()：
   先探测再决定内嵌还是明确提示；被拒时还会清空 iframe 的 src。

2) 控件在工作空间收边
   中间嵌的是别人的应用，常驻控件会遮挡。搜索球收左边缘、右下角两个按钮
   组成 dock 整组收右边缘、备案号收下边缘，各露 14px（备案号 13px），
   鼠标移入或点击、聚焦时滑出展开。只在工作空间生效。

3) 修 iframe 撑高页面 77px
   Dashy 的 .web-content iframe 是 position:absolute，包含块是 #dashy 而非
   .web-content，外层 overflow:hidden 拦不住它，它按 #dashy 高度撑到 814px
   （164+814=977 正好等于页面 scrollHeight）。补 position:static 后归零。

4) 首页不再出现两个备案号
   Vue 异步挂载，navi.js 可能先补了一份页脚，之后 Dashy 的页脚才出现；
   原来的守卫只判断 .navi-footer 是否存在，不会回收自己早先注入的那份。
   新增 dashyFooterNode() 区分两者，发现 Dashy 的就把我们补的移除。

5) 窄屏展开搜索框不再压住右下按钮组
   手机端展开宽度是 calc(100% - 86px)，而按钮组占最后 114px → 重叠 38px。
   改为按按钮组真实占位预留（≥600px: min(560px, 100% - 158px)；
   ≤599px: calc(100% - 132px)）；≤380px 时输入框会窄到不可用，改为
   临时隐藏按钮组（用 visibility 而非 transform，因为 prefers-reduced-motion
   会强制 transform:none）。
 2026-09-11 19:04:38 +08:00
HomeDash Bot
da196abcb5 feat(web): 隐藏原生设置、圆形视图切换、工作空间改列表、三视图标题统一 
用户提出的四条，都基于实测数据而不是猜测：

1) 隐藏 Dashy 原生设置入口
   顶栏的 .config-launcher（齿轮+铅笔+调色板）与我们的 /admin/ 重复，
   连同 .options-trigger/.settings-outer 一起隐藏。

2) 视图切换图标改成圆形，紧贴自定义入口左侧
   原生切换按钮是侧栏底部的方形图标（.switch-view-buttons），已隐藏；
   改为右下角圆形悬浮按钮 .navi-view-switch，点开是「首页/极简/工作空间」
   菜单并标出当前视图。
   顺带修掉 2px 错位：管理入口是内容盒（48+2px 边框=50），视图按钮是
   边框盒（48），并排时差 2px；给管理入口补 box-sizing: border-box。

3) 工作空间「点了没反应」
   读 Dashy 自己的 Workspace 组件（assets/Workspace-*.js）得到结论：
   右侧面板就是一个 iframe，launchApp() 只有 target 不是 newtab 才把 URL
   灌进面板；我们全局 openingMethod: newtab，所以每次点击都走 window.open
   分支，this.url 恒为空 → 面板永远空白。
   就算灌进去也没用：Gitea 实测 X-Frame-Options: sameorigin 拒绝被嵌
   （Refused to display … in a frame）。
   所以改成：点左侧分组 → 右侧列出该分组应用卡片（数据取自
   /admin/api/sections），不依赖目标站点是否允许 iframe，首页仍保持新标签页。

4) 三视图标题割裂
   实测 /minimal 是 48px 居中 -1.92px，而 / 与 /workspace 是顶栏里 40px
   左对齐、无字距。现在三个视图共用同一条规则（clamp(1.75rem,4vw,2.75rem)、
   700、-0.035em、居中；移动端 clamp(1.6rem,8vw,2.2rem)），副标题也居中置灰。

另外：工作空间面板原本用 position: fixed 钉在视口中间（1364×654，上距顶栏
7px、下距搜索栏 8px），把页面切成「顶栏/大方块/底部」三段；改为正常文档流，
内容多时页面自然滚动。
 2026-09-11 18:17:23 +08:00
HomeDash Bot
80b0e5f51e feat(web): 搜索框收起态 + admin 入口 + 修正多余滚动 
- 搜索栏默认收起为左下角放大镜悬浮球（52/56px），点它展开成输入框，
  输入框内左侧仍是同一个放大镜，点它收起；Esc 也可收起
- Dashy 页面补右下角 /admin/ 悬浮入口（原先没有任何管理入口）
- 短页面不再凭空可滚动：body 留白 104->84px，并给 #dashy 扣掉同样高度
  （Dashy 的 #dashy 本已撑满 100vh，叠加留白就多出约 134px 滚动）
- 补的备案号页脚改为固定在搜索栏正上方，不再参与文档流撑高页面
- 弹层打开时搜索栏与管理入口一并让位
 2026-09-11 17:03:33 +08:00
JianFeeeee
9eb8214fab fix(web): 搜索栏改为底部悬浮，补极简视图页脚与整体动效 
- 搜索栏 position:fixed 悬浮在视口下侧，任何视图/滚动位置都可见；
  原先是流式跟在页脚之后，手机上要滚到底才看得到
- 极简视图(/minimal)与工作空间不渲染 Dashy 页脚，备案号整段消失；
  navi.js 从只读 pageinfo 取回页脚补一份（DOMParser，不用 innerHTML）
- 空分组不再渲染成空玻璃条（:not(:has(a.item))），修掉 mini 页底部一排空框
- 图标统一 56/48px 容器 + object-fit:contain，修 24px 与 56px 混排
- 备案号页脚改为胶囊样式
- 新增动效层：视图/卡片淡入、搜索栏滑入、悬停位移，全部只动
  transform/opacity 并遵循 prefers-reduced-motion
 2026-09-11 16:25:26 +08:00
JianFeeeee
c4b0b8abdf build: 用 patch-index.py 幂等注入 navi.css/navi.js 
Dashy 的 index.html 不保证有 </body>，原来 sed 替换 </body> 会静默丢掉注入的
<script>（旧镜像里 script 与 </body> 同行，被整行删除后就没有锚点了），
结果新访客加载不到 navi.js。改为 Python 脚本：先清理旧标签，再在
</head>/</body> 前插入，缺 </body> 时在 </html> 前补回来，可重复执行。

同时 .gitignore 忽略 __pycache__。
 2026-09-11 16:25:26 +08:00
JianFeeeee
de795de0fb feat(install): show the sync token on the install page 
插件必须填 NAVI_SYNC_TOKEN，但页面上没有任何地方能看到它 —— 用户只能去翻
.env，实际就是配不起来。

- admin-server 新增 GET /admin/api/sync-info，返回 syncToken / hasToken。
  放在 /admin/ 下而不是 /api/ 下是必须的：插件上报用的 /api/history/sync
  被门户 auth_request 放行，若令牌挂在同一前缀下就等于公开。
  实测 /api/history/sync-info 返回 401，只有 /admin/api/sync-info 能取到。
- 安装引导页把「第一步」改为填写两项（服务地址 + 同步令牌），各自可复制；
  服务端未设令牌时提示留空即可；未登录时提示需先登录门户。
- README 补充对应说明。
 2026-09-11 11:49:31 +08:00
JianFeeeee
f8c4771828 fix(admin,theme): make admin actually work; glass theme targets real DOM 
后台之前有两处让它完全不可用的问题（都属于「看着有、实际不工作」）：
1. 写操作 401 —— admin UI 从未带 Authorization 头，而 admin-server 强制校验
   NAVI_ADMIN_TOKEN。于是添加/删除一直静默失败。
2. JSON 键名不匹配 —— Section/NavItem 只有 yaml tag，没有 json tag，
   接口返回 {"Name":..,"Items":[{"Title":..}]}，而前端读 s.name / it.title，
   渲染直接抛异常（菜单区永远停在「加载中…」）。

修法：
- admin-server：token 改为**默认不校验**（/admin/ 已在外层门户登录墙内，
  用户确认无需叠加），仅当显式设 NAVI_ADMIN_REQUIRE_TOKEN=1 时才校验；
  历史 DELETE 不受影响（那条路径被门户放行，仍必须自带 token）。
- 补 json tag；Config/Section/NavItem 加 yaml ",inline" 保留未知键，
  避免保存 conf.yml 时把不认识的配置（layout/pages/item 的 target 等）丢掉。
- 新增 /api/pageinfo（标题/副标题/页脚/顶部导航可在后台编辑）与
  /api/icon（图标上传，限 png/svg/jpg，512KB）。
- 重写 admin UI：站点信息 + 顶部导航编辑、图标上传（.ico 用 canvas 转 PNG，
  因为 Dashy 的 isImage() 只认 svg/png/jpg）、可选令牌。

主题：旧 customCss 大部分是死代码 —— .tile / .item-group / .item-group-outer
在页面里根本不存在（querySelectorAll 计数为 0），卡片灰底其实来自 a.item，
而 .home 的不透明背景盖住了 body 渐变，所以玻璃效果一直看不出来。
现按真实类名（a.item / .item-wrapper / .collapsable / .collapsible-content /
.home / header）重写，并加入工作空间侧边栏的溢出修复。

安装页：.btn 自带 display 会盖掉浏览器默认的 [hidden]{display:none}，
未配置商店时「一键安装」按钮仍然可见且 href 为空（点了没反应）。
现显式兜住 [hidden]，并把浏览器识别补全（iOS/Android 单独提示为不可安装、
Edge/Brave/Vivaldi/Opera 给出各自的 extensions 地址、优先用 userAgentData）。
 2026-09-11 11:43:44 +08:00
JianFeeeee
ff0e6418f8 feat(nav): auto-detect browser extension and offer one-click install 
导航页现在会自动检测浏览历史插件是否已安装：

- 扩展在用户配置的服务地址上动态注册 content script
  （Chrome: chrome.scripting.registerContentScripts，
   Firefox: browser.contentScripts.register），
  于 document_start 给 <html> 打上 data-navi-ext 标记，
  不在其他站点运行。
- history-server 始终把「安装浏览历史插件」放在「历史访问」第一条
  （入口 url=/extension/install.html），启动时也会重建一次，
  不再需要等下一次同步。
- web/navi.js 读到标记后隐藏该入口（连 .item-wrapper 一起隐藏，
  避免留下空网格位）。
- 新增 /extension/install.html：自动识别浏览器，给出对应安装包与步骤；
  支持在 data 卷放 extension-store.json 配置商店链接，
  有商店链接时显示真正的「一键安装」。
- 段落名匹配同时兼容中英文（常用服务/Favorites、历史访问/History），
  修掉了公开示例 conf.yml 用英文名时重建逻辑完全失效的问题。
- 扩展升到 1.1.0（新增 scripting 权限与 detect.js）。

Note: Chrome/Edge 不允许从网站直接安装非商店扩展，
因此自托管场景下只能下载后手动加载；发布到商店后才会出现一键安装。
 2026-09-11 10:41:10 +08:00
JianFeeeee
7e49d2b51c feat: HomeDash - unified self-hosted navigation portal 
Single-container navigation service combining:
- Dashy dashboard + SearXNG metasearch + history sync API + admin WebUI
- Go services for history/admin APIs, nginx as unified entry
- Browser extensions (Chrome MV3 / Firefox MV2) with 30s batched sync
- Production guide: portal-nginx unified auth reverse proxy + webui4frpc/frp tunnel
- Fully sanitized (no internal IPs/domains/credentials)
 2026-09-08 22:25:00 +08:00