Repository navigation
Releases: ai68298100/siyuan-quickgate
Release list
v0.9.2 生态适配收尾 35→39 op · 小驴常用接入
v0.9.2 · 生态适配收尾 35→39 op · 小驴常用接入
Added
- 数据透传扩容(35→39 op):小驴常用
window.xiaolvCommonv1 接入(上游 0.4.0 · ADR-0013 只读子集)——common.search(元数据检索)/common.get(完整条目)/common.recent/common.favorites,全部只读;上游 ActionResult 信封透传(not-found/invalid-input → rejected 透出 reason);MCP 只读工具 18→22,面板能力目录 17→21 - workflow 白名单收编
common.*四 op(只读步骤无确认标记)
Changed
- 生态清单:xiaolv-common design→stable(0.4.0,windowBridge=xiaolvCommon · minProtocol v1)——8 款清单 stable/design 双轨齐整(6 stable + 2 design)
协作
- 上游桥由本轮在上游仓库落地并同步发布:xiaolv-common v0.4.0(T-0031 · ADR-0013 · 251 测试)
验收
- vitest 40 文件 277 用例全绿;check 链全过;MCP 冒烟 7/7(22 只读/39 全量);靶场双插件端到端 5/5(真实 ActionResult 回执,含未命中 reason 透出);在用工作区 live 验证(v0.9.2 + 常用 0.4.0 双部署,common.* recorded)
安装:下载 package.zip → 思源 → 设置 → 集市 → 下载页右上角菜单 → 导入安装包 → 启用插件。更新版本后需完全退出思源(托盘右键退出)再启动。
SHA-256:de8241dd565171f7dc0f169e521d6850076747c8e0b135d9680da370c001fb0a
v0.9.1 生态适配扩展 27→35 op · AI 客户端矩阵
v0.9.1 · 生态适配扩展 27→35 op · manifest 校准 · AI 客户端矩阵
Added
- 数据透传扩容(27→35 op):三家上游公开桥接入(契约=各上游仓库 BRIDGE/生态契约文档):
glean.list/glean.get/glean.status——拾遗window.siyuanGleanv1(五态筛选分页/单篇读取/改状态;写面受拾遗侧 integration.bridgeWriteEnabled 门控;done 自动记 doneTime)home.summary/home.memo/home.open——管家window.LvHomev1(提醒有界计数;快速备忘为运行态无幂等键;总览/提醒中枢受控导航)exam.stats/exam.open——考试window.siyuanExam(statsRead 按需重算脱敏快照;practice/wrongbook/mock/report 稳定入口)- 三家均进 workflow 白名单(写步骤带 confirm);MCP 只读工具 14→18
- AI 客户端接入矩阵(docs/ai-clients.md):MCP stdio / 思源内置 Agent / 自定义工具三条路径,覆盖 Codex、Claude、ZCode、反重力、千问、豆包、DeepSeek、WorkBuddy 等
- 工具 schema 导出器(
node tools/export-toolschema.mjs):function-calling JSON + OpenAPI 3.1 两种形态,供无 MCP 平台以「自定义工具」接入 - 工作区内核端口自动发现(
src/mcp/discover.ts):思源 ≥3.8.7-alpha 双内核架构下,MCP 服务器/lv-cli/verify-restart 未设SIYUAN_URL时自动定位工作区内核(Token 鉴权判定,实测 <1s) - 拾遗适配器参数预校验与文档 id 形状守卫
- 命令面板「能力动作」目录补 8 个新 op(9→17;资产与 tag 同步重建于 e92bf33)
Changed
- 生态清单校准:管家 0.4.2 / 拾遗 1.3.3 / 考试 0.9.6 design→stable;雷切 0.46.8 / 打卡 18.17.2 / 人脉 0.5.5 版本刷新;补录 xiaolv-common(design)——清单 8 款;三处校验器 pluginId 正则放宽
siyuan-*|xiaolv-* tools/restart-siyuan.bat安装目录自动探测;verify-restart 接入端口自动发现
Fixed
- 适配器守卫与
strict:false口径对齐(判别联合不窄化——桥实例直返+常量文案);mcp-smoke 只读计数改单一来源推导
验收
- vitest 39 文件 273 用例全绿;check 链全过;MCP 冒烟 7/7(bundle 态 live recorded);靶场 e2e 11/11;新 op 真机定向验证 14/14;在用工作区 verify-restart full 10/10
安装:下载 package.zip → 思源 → 设置 → 集市 → 下载页右上角菜单 → 导入安装包 → 启用插件。更新版本后需完全退出思源(托盘右键退出)再启动。
SHA-256:49d83e4f9c2dce1e0ce81f0577ff320045d620e18e2189fc3641c90995a74f09
v0.9.0 · UI 全面打磨与真机交互回归
小驴快门(Lv QuickGate)v0.9.0 · UI 全面打磨与真机交互回归
思源生态联动中枢 + 外部网关:Quicker / 快捷指令 / CLI / AI 助手共用 27-op 公开契约。本版本起为正式版(非 prerelease)。集市仍暂缓上架,GitHub Releases 为唯一分发渠道。
安装
- 下载下方附件
package.zip(资产详情页可见 SHA-256 digest)。 - 思源 → 设置 → 集市 → 右上角菜单 → 使用本地安装包安装(或解压到
data/plugins/siyuan-quickgate/)。 - 更新版本后需完全退出思源(托盘右键)再启动——窗口重开不会刷新插件前端代码。
本版亮点
- UI 全面打磨:分层设置面板 / 命令面板 / 四中心对齐高保真原型;配色经对比度求解器证据化(两主题文字 ≥4.5:1);窄屏与触屏适配修复
- 真机交互回归:新增隔离靶场交互 e2e(13 项硬断言),面板核心交互全部真机断言通过
- 修复三处真实缺陷:回执中心「导出 JSON」死按钮 · 设置对话框关闭后轮询定时器泄漏 · 捕获撤销内核成功仍误报失败
- 新品牌视觉:新图标 + 社交预览图 + 双语 README 改版
全部变更
Fixed
- 捕获撤销写入在内核删除成功后仍误报「撤销失败」(靶场 E4 实测抓出):撤销处理器把 kernelApi.post 的返回(成功时为解包 data)误当
{code}信封判定,undefined!==0恒判失败——用户会以为撤销没生效而手动残留测试块。修复为按 then/catch 判定成败;网络拦截断言 deleteBlock code=0 且块真删,交互 e2e I6b 转绿。 - 窄屏(≤520px)走查(R131 清单 320/375px 项首次实测)发现并修复四处破损:①状态概览通道卡在两列网格下卡名/徽章竖排断字——窄屏改单列;②通知中心动作按钮溢出右缘裁切——卡片改类承载并窄屏两行化(首行徽章+按钮、次行正文;body 自我压缩不触发换行的坑一并处理);③恢复中心按钮组溢出——按钮组可换行右对齐;④恢复中心/桥恢复向导内容
min-width:min(560px,92vw)在窄屏等于视口宽,叠加宿主 padding 直接顶出容器(右缘裁切根因)——移除(桌面端 dialog width 本就 ≥560,行为不变)。另:设置面板窄屏回执/载体明细表改横向滚动替代 mono 文件名 mid-word 破字;向导步骤标签窄屏缩一档。 - 设置对话框直接关闭时,状态页的 3 秒轮询定时器不随销毁清理(只在切页路径清理)——留下每 3 秒空转的泄漏定时器;destroyCallback 现在统一停表。
- 设置搜索结果补命中高亮(与命令面板同语言):行标签内命中片段主题色加粗,用户能看出每条结果为何命中;只拆分标签首个文本节点,chips 与读屏绑定不受影响。
- 对比度证据化巡检(新工具 tmp/ui-preview/contrast.mjs:解析亮/暗主题真实变量,按 SCSS color-mix 配方合成后算 WCAG 比值):5 项文字/背景配对不达标已修——chip 三色文字/底配方重定(60/56/70%,底降至 10/10/9%)、主色强调文字(面板活动行/命中高亮/导航活动项/chip.info)收敛为 --qg-accent-text(primary 62%→on-background)、错误文字收敛为 --qg-error-text(error 76%→on-background)。修正后两主题全部文字配对 ≥4.5:1;主按钮 4.24:1 为宿主全局样式(保持全生态一致,记录为平台继承项)。
- 对比度巡检补漏(第二轮):primary 作为文字色的残留用法全部收敛到 --qg-accent-text——向导当前步文字与球内数字、步骤球 hover、页脚链接、面板活动行收藏星、qg 根内宿主 b3-link 链接(向导/生态/审计等处的内联链接)、向导「全部设置」跳转(暗色 primary 文字 3.57:1 不达 4.5);边框/焦点环/色点等非文字用法保留原生 token(≥3:1 达标)。
- 命令面板与参数表单:中文输入法组字中的 Enter/Esc 不再误触发执行/关闭(isComposing 守卫)——此前用输入法确认候选词会连带执行命令或提交表单。
- 回执中心「导出 JSON」按钮未绑定处理器(点击无响应的死按钮)——补齐:按当前筛选导出 JSON 文件,与 CSV 同源。
Changed
- 交互 e2e 补全覆盖:I7 能力动作二段式真机执行(接管消费权 → daily.status → recorded,并实证只读 op 无确认门控)与 I8 inbox 路径捕获+撤销闭环——至此面板全部核心交互(键盘/两段 Esc/二段式/捕获双路径/撤销)均有真机断言。
- 新增 e2e/ui-interactions.mjs(隔离靶场专用写型 e2e,guardScratch 拒共享内核):真机行为验证近几轮交互改动——两段式 Esc(真机确认 stopPropagation 拦截成立)、面板键盘导航 + aria 同步、设置搜索命中高亮、「已自定义」边标实时刷新(同节点探针证明无整页重渲染)、通道卡下钻、捕获全链。首轮真机 10/10 硬断言通过;并据此发现既有缺陷「捕获撤销 daily 路径失效」已登记 design/TODO.md(非本轮引入)。
- 术语统一(用户可见口径):「结果中心」按钮与提示文字统一为「回执中心」——原型 ⑧ 定名即回执中心,此前同一界面两个名字(点「结果中心」进去标题却是「回执中心」);代码内标识符(results-center 等)不变。
- 设置行「已自定义」标记实时刷新:改动保存后该行边标当次立现/消退,不再需要重进页面(经确认框放行的危险开关除外)。
- 捕获成功卡去除维护者台账行号泄漏(「L566:」)——与 docs/33 同类的文案口径治理;全仓扫描确认其余台账引用均在代码注释内。
- 上手指南(GETTING-STARTED)顶部嵌入当前 UI 预览图(../preview.png,GitHub 与发行包路径均可达),并修正文档漂移:入口「设置 → 小驴快门 → 基础连接」实为「连接与通道」。
- 无障碍基线自动巡检落地(预览 harness 新增 a11y.mjs:15 个屏静态扫无名按钮/无标签输入件),修掉巡检发现:审计日期输入补 aria-label、隐藏备份文件输入件命名。
- 首跑向导已完成步骤球补键盘可达(role=button + tabindex + Enter/Space 回跳);状态概览回执表补视觉隐藏表头(读屏可读列语义);清理导航品牌块死 CSS。
- 状态概览通道卡可点击下钻(外部命令桥/广播→连接与通道,事件物化→队列与数据,内核路由→诊断与生态):hover 显形 → 箭头,role=button + Enter/Space 键盘同效(Raycast「万物可导航」)。
- 市场预览图 preview.png 更新为当前 UI 真实渲染(2200×1640 @2x,脱敏样例数据)——此前为旧版界面截图。
- 设置行「已自定义」指示(VS Code Modified 范式):与默认不同的行左侧主色细杆 + 悬停说明,覆盖连接/安全页全部 9 个设置项;关于页恢复默认卡动态显示「N 项设置与默认不同」,重置前知道会丢什么。
- 队列页 KPI 与载体明细卡骨架先行,数据就绪原位填充——消除异步两段内容突然下移;明细统计失败给原因与出路而非永远转骨架。
- 设置搜索「进入分组 →」跳转后回焦搜索框(键盘流不中断);审计筛选行窄屏换行;环境预检结果补 aria-live。
- 命令面板融合启动器范式(依 10-生态调研-R6 的 Raycast/Alfred 锚点补表面质感):搜索命中片段主题色高亮(DOM 分段构建免注入,最长关键词优先);底部上下文键位提示条随列表/空态/参数三阶段联动(同时让 ☆ 收藏与 {} 复制信封有恒定可发现的入口);键帽加下缘一档厚度;截断标题/副标题补原生 tooltip。
- 命令面板:匹配高亮扩展到副标题(op/插件名)——英文搜索词只命中 op 或插件名时同样可见匹配原因;两段式 Esc(有词先清词并拦住宿主关闭,空词才关面板,Raycast 同款)。
- 首跑向导补后退路径:步骤 2~6 常驻「上一步」,已完成步骤的圆球可点击回跳(未到步骤不可跳,保持步骤依赖)。
- 设置侧导航支持 ↑↓/Home/End 方向键漫游(Tab 到导航后无需连打 Tab 扫分组)。
- 首跑向导步骤 6「写入测试块」补 pending 态防连点(真实写入,双击会双写)。
- 命令面板参数表单:校验失败时聚焦并滚动到问题字段(长表单下错误信息在底部不可见);字段 label 改 label/for 关联,点标签即聚焦;执行中字段内 Enter 不再重复派发(防重入)。
- 防连点:恢复中心重试/放弃(写动作)处理中按钮失效;面板收藏星簿记在途忽略重复点击。
- 按实际行为命名:剪贴板类按钮由「导出审计 JSON/导出筛选」更名「复制审计 JSON/复制筛选 JSON」,消除「导出=下载」预期落差(回执中心 JSON/CSV 为真文件导出,维持「导出」)。
- 加载语言补齐:回执中心与通知中心初次载入补骨架屏(与状态概览/恢复中心一致)。
- 命令面板对齐原型行语言:宿主命令行快捷键移到插件名之前;列表区加水平内边距,行高亮块不再贴容器边缘。
- 设置面板:回执表数字/时间列右对齐(含载体明细);开关两态旋钮统一白色+微阴影;状态概览「下一步」中 op 标识改等宽字体;首跑向导副标题去除维护者行话。
- 命令面板参数二段式:表单阶段搜索框转为只读降透明并改占位文案,明示「返回后可重新搜索」。
- 子对话框头部统一 logo 语言:审计日志(附条数胶囊)/ 收藏与最近使用 / 生态能力目录;内边距统一 14/16;生态目录状态行由彩色圆点文本改为状态徽章。
- 桥恢复向导去除双标题(原生头留空随宿主隐藏,保留内容区单一头部)。
- 裸复选框统一 15px + 主色 accent(R305 从恢复中心扩展到向导能力勾选与备份导入分组)。
- 触屏(pointer: coarse)无 hover:悬停显形的复制/信封按钮改为常显,功能可发现。
- 通知中心新增全空态文案(一切正常时不再显示空白面板);队列页最近回执表补载入骨架屏。
- 原型 mvp1.html 补录 ⑨ v0.8.x 新增件(载体明细 / 回执状态图例 / 环境预检 / 桥恢复向导),spec-note 同步 v0.8.x 口径。
SHA-256:见资产详情页(GitHub 自动计算)· 集市状态:暂缓上架 · 许可证 MIT
v0.8.8 · serialized bridge lifecycle transitions
Highlights
- Serialize bridge start, stop, restart, and takeover transitions so rapid setting changes cannot claim the old Web Lock before shutdown completes.
- Release a Web Lock granted after a takeover timeout; late grants no longer permanently occupy the bridge.
- Invalidate queued event materialization after the event bridge stops.
- Add accessible names to the settings search and row controls for screen readers.
Validation
- 39 test files, 254 tests passed.
pnpm check, production build, release scan, package assertions, and MCP smoke 6/6 passed.- GitHub Actions CI passed for commit
80e3293.
This is a GitHub prerelease. It is not published to the SiYuan marketplace.
v0.8.7 · palette navigation and build hygiene
Highlights
- Fix command palette keyboard execution when more than 100 commands match: capability actions and empty-state fallbacks now use the number of commands actually rendered.
- Remove ineffective self-referential dynamic imports from diagnostics paths; production app builds are warning-free.
- Add regression coverage for truncated command lists and build import hygiene.
Validation
- 38 test files, 250 tests passed.
pnpm check, production build, release scan, package assertions, and MCP smoke 6/6 passed.- GitHub Actions CI passed for commit
0712f20.
This is a GitHub prerelease. It is not published to the SiYuan marketplace.
v0.8.6 · lifecycle shutdown consistency
Highlights
SingleFlightPoller.stop()now waits for an in-flight bridge tick before the Web Lock is released, preventing an old hot-reloaded instance from writing after handoff.- Unload now waits for bridge shutdown and audit flush before saving runtime statistics; failed ticks and shutdown errors no longer create unhandled rejections.
- Hot reload retries bridge startup after the old instance releases its claim, with a
tornDownguard to prevent a disabled instance from reviving. - Package and repository README version badges are checked and updated together.
Validation
- 37 test files, 248 tests passed.
pnpm check, production build, release scan, package assertions, and MCP smoke 6/6 passed.- GitHub Actions CI passed for commit
8dbc656.
This is a GitHub prerelease. It is not published to the SiYuan marketplace.
v0.8.5 SSE 断流边界与空态无障碍
v0.8.5:SSE 断流边界与空态无障碍
- 修复 SSE 在 EOF 前没有换行时最后一条 data 命令被丢弃的问题。
- 显式停止时不误消费残留尾帧;连接指标只统计成功取得可读 SSE body 的连接。
- 命令面板空态 fallback 补齐 option/group 语义、稳定 id、aria-selected 与 aria-activedescendant。
验证:246 个测试、check、生产构建、发布扫描、MCP 冒烟 6/6 通过。
本版本为 GitHub prerelease,未推送思源集市。
v0.8.4 广播可观测性与 E2E 隔离
v0.8.4:广播可观测性与 E2E 隔离
- 广播快路径新增连接、重连、帧、丢弃、错误和最近时间指标;消费回调异常不会中断后续 SSE 帧。
- 健康快照按当前会话过滤旧审计,新增 SSE 丢帧统计;设置页支持一键复制健康快照。
- 命令面板空态按钮支持 ↑/↓ 与 Enter 导航执行。
- 容器 E2E 使用每次运行独立 Docker volume,诊断上传后自动清理。
验证:245 个测试、check、生产构建、发布扫描、MCP 冒烟 6/6 通过。
本版本为 GitHub prerelease,未推送思源集市。
v0.8.3 - 健康快照与面板可访问性
v0.8.3
- 诊断包新增本会话 health snapshot:会话 ID、启动/采样时间、uptime、最近成功/失败、队列深度、最老命令年龄和坏 JSON 行统计;不输出命令参数或正文。
- 命令面板空结果清空旧活动项,修复无匹配后 Enter 误执行上一条结果;补齐 combobox/listbox/option ARIA 关联并修正大列表导航边界。
- E2E 容器流程兼容带 Token 的 401/403 健康响应,并等待 QuickGate 私有路由注册完成后再验收。
验证:37 个测试文件 / 242 项通过;pnpm run check、应用与内核构建、MCP bundle 冒烟、发布自查均通过。
本版本继续不上思源集市,GitHub Releases 为分发渠道。
SHA-256
fbac9ef67a7cdd93b9fb9d44f3daa4da8990e7ee84a204b36bf1deee0441f00c package.zip
v0.8.2 - 版本一致性与 E2E 门禁
v0.8.2
- 统一插件入口、设置页和诊断包的运行时版本来源,修复设置页仍显示 v0.7.5 的漂移。
- 收紧 SiYuan 容器 E2E:健康探测、重启后复测、Token 脱敏、部署/JWT/MCP 硬门禁和失败诊断资产。
- 同步路线图、双语 README、CHANGELOG 与当前状态快照。
验证:36 个测试文件 / 237 项通过;pnpm run check、应用与内核构建、MCP bundle 冒烟、发布自查均通过。
本版本继续不上思源集市,GitHub Releases 为分发渠道。
SHA-256
db23751eb2fb3b3b21d3bf5820cad581a1d7e460d9fddde3032ad1c7e5555525 package.zip