Files
mnote/design
lix-2026 627213dc01 feat: add evidence search and stabilize pdf previews
- add document evidence parsing/search/open routes, Hermes tool wiring, local index settings/status, and the document-evidence skill plus design notes
- fix PDF resource tabs by rendering PDFs inline with pdf.js canvases instead of iframe preview pages, release PDF documents on close, and document the fourth-PDF stall bug
- keep PDF preview at 2x rendering while removing the previous lazy-load/placeholder direction, and make dev:hot bind loopback defaults externally reachable

Verification:
- node --check rust/crates/mnote-web/browser/document-resource-tab-runtime.js
- node scripts/task-dev-hot-plan-test.js
- cargo test -p mnote-web --manifest-path rust/Cargo.toml pdf_preview_page_does_not_render_visible_toolbar
- cargo test -p mnote-web --manifest-path rust/Cargo.toml document_shell_returns_page_aggregate_snapshot
- cargo build -p mnote-web --manifest-path rust/Cargo.toml
- browser smoke: sequentially opened the four tea_seed_oil_cosmetic PDFs; fourth PDF rendered 15/15 canvases, iframeCount=0, browser errors=0
2026-06-04 18:51:16 +08:00
..
2026-05-02 06:25:26 +08:00
2026-06-01 09:29:12 +08:00

design 设计稿索引

更新时间:2026-05-26

当前产品口径:VSCode 简化版工作区 + tiptap 的 Markdown 前端编辑器 + Hermes/Reasonix agent + simplemindmap/office 插件 + Wolai 主题 Web 壳 + 鉴权控制面

当前上位主线:local-first MVP 已初步完成;local-first workspace 是默认数据形态,本地 .md 是页面正文真相,Rust kernel / projection / command 持有语义,Rust SQLite control-plane 持有默认 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 控制面;Convex / 服务端只作为历史迁移源、显式 cloud source、compat 和 sync replica。入口设计见: /mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-2-local-first-workspace-convex-control-plane-v1.md /mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-8-convex-replace-with-rust-sqlite-control-plane-v1.md

后续新增设计默认以 MVP 后阶段为基线:优先推进 WorkspacePath/ObjectIdentityDocumentBuffer/BufferStore、Page Aggregate compat 瘦身、tree command context、live cache 统一、agent diff / 冲突合并 / 本地索引 / 分享同步产品化;不要再把旧 Convex / Next / BlockNote 主链、根 convex/ functions 源码或 Convex Auth 默认控制面当作新增能力默认方向。

Runtime 可维护口径:3-193-203-213-225-285-2910-review/done/16 已完成第一轮前端 runtime 模块级拆分。layout.rs / tree.rs / web_shell.rs 大型 raw string 问题不再是当前主问题;浏览器 JS 默认从 rust/crates/mnote-web/browser/*.js 定位,tiptap island 默认从 rust/spikes/leptos-tiptap-spike/src/editor_runtime/*.rs 定位。剩余 runtime 专项按 owner 分流:local folder/resource 编排看 03-rust-web/process/3-23Page AI sidebar owner 看 07-ai/process/7-38

Smoke 口径:当前分类与默认基线以 /mnt/Data1T/mnote/scripts/TESTING_REFERENCE.md 为准;退役 Convex / Next / 3104 / BlockNote 脚本不再占用默认 smoke 基线。

状态口径以当前仓库真实代码为准:

  • [done]:对应阶段或收口目标已经在当前主线代码中成立
  • [process]:方向已进入主线,且当前可以直接拆 checklist / owner / 验收继续执行
  • [draft]:方向尚未成形,不能直接派发实现
  • [reference]:参考流程、候选合同、对照证据、review 原始材料或长期设计边界;不代表当前可直接执行的 checklist
  • [recycle]:已废弃、已被后续稿件替代,统一归档到 old/

当前优先级入口

  • 当前有效架构口径,请先看: /mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md
  • MVP 后阶段剩余 process/ 的执行顺序,请看: /mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md
  • Runtime 模块级拆分完成态,请看: /mnt/Data1T/mnote/design/10-review/done/16-mnote-web-runtime-module-maintainability-checklist-v1.md
  • 历史 01-05-current-priority-overview 已迁入 design/old/,只能作为归档快照,不再作为当前入口。

主线顺序

  1. 01-tree-first-graph-kernel/
    • process/ 放推进中的主线稿
    • done/ 放已在真实代码中成立的主线稿
    • reference/ 放参考材料;draft/ 放未成形草稿
  2. 02-convex-rust-long-term-architecture/
    • process/ 放推进中的主线稿
    • done/ 放已在真实代码中成立的主线稿
    • reference/ 放参考材料;draft/ 放未成形草稿
  3. 03-rust-web/
    • process/ 放推进中的主线稿
    • done/ 放已在真实代码中成立的主线稿
    • reference/ 放参考材料;draft/ 放未成形草稿
  4. 04-tree-domain/
    • process/ 放推进中的主线稿
    • done/ 放已在真实代码中成立的主线稿
    • reference/ 放参考材料;draft/ 放未成形草稿
  5. 05-editor-mainline/
    • process/ 放推进中的主线稿
    • done/ 放已在真实代码中成立的主线稿
    • reference/ 放参考材料;draft/ 放未成形草稿
    • reference-code/ 放编辑器参考代码
  6. 06-mindmap/
    • process/ 放推进中的主线稿
    • done/ 放已在真实代码中成立的主线稿
    • reference/ 放参考材料;draft/ 放未成形草稿
  7. 07-ai/
    • process/ 放推进中的主线稿
    • done/ 放已在真实代码中成立的主线稿
    • reference/ 放参考材料;draft/ 放未成形草稿
  8. 08-wolai-aline-test-flow/
    • reference/ 放 Wolai 对标流程基线;具体执行任务应拆到对应主线 process/
  9. 09-siyuan-reference/
    • reference/ 放思源参考、借鉴边界与能力盘点稿
  10. 10-review/
  • done/ 放阶段性代码 / 架构审查证据和结论
  • reference/ 放对照审查原始证据、参考矩阵和后续候选项
  • 只作为当前实现状态证据和历史审查归档,不作为新的主线优先级入口

迁移规则

  • 主线设计稿完成后,必须从对应大类的 process/ 移动到 done/
  • 仅以当前真实代码为准判断是否完成,不能只按稿件自述判断。
  • 对于未完成但当前不排期的候选设计、参考矩阵、对标流程和 review 原始证据,不移动到 done/,必须移动到对应大类的 reference/ 并在文件头部标记 [reference]
  • 只有能直接执行的 checklist 才允许留在 process/;如果只是想法但还没形成 owner / 验收 / 归档条件,先放 draft/
  • 废弃稿统一移动到 old/ 对应大类下,再按历史成熟度放入 process/done/

辅助目录

  • 90-reference/
    • 跨域生态参考资料,不参与 [done]/[process]/[draft]/[reference]/[recycle] 状态判断
    • 引用时只能作为生态资料或背景材料,不能覆盖 CURRENT_ARCHITECTURE.mdARCHITECTURE.mdAGENTS.md1-8 当前执行顺序或对应主线 process/ / done/ 设计稿
  • old/
    • 已废弃或被替代的历史稿件,标题统一标记 [recycle]
    • 每个大类继续按 process/done/ 分层
  • design/design/
    • Wolai / Stitch / icon 等取证素材与静态参考资产;这是当前 design/ 目录下的素材子目录,不是主线设计稿根目录
    • 不参与 [done]/[process]/[recycle] 主线状态判断