Tracked by #10. Local plan: docs/roadmap/marginnote-4.md.
Goal (中文): 先调研 MN4 Realm schema、版本兼容、锁文件和只读安全。没有合法样本和可重复测试环境时保持 BLOCKED,UI 不展示 Realm 选项。默认严格只读。
Do you need to file a feature request?
Feature Request Description
Research, then possibly implement, a read-only Realm adapter for live MarginNote 4 data.
deeptutor/capabilities/marginnote/data/realm_adapter.py is only a stub. v1 officially supports export folders only. Realm access depends on MN4 schema knowledge, version compatibility, lock files, and a legal/repeatable sample environment.
Phase 1 is research only:
- schema and MN4 version compatibility
- lock-file / live-app concurrency
- read-only safety
- packaging (
realm Python dependency) and license constraints
Default remains strictly read-only. Any write capability needs a separate design approval. Until legal samples and a repeatable test environment exist, this issue stays BLOCKED and the UI must not show a Realm option.
Related Module
Knowledge Base Management
Use Case
If live access becomes safe and testable, learners can skip the export step and let DeepTutor read the current MN4 notebook. Until then, the product must not pretend Realm sync is available.
Additional Context
Priority: P2
Phase: M3
Status: BLOCKED pending a real MN4 environment, schema, and legal sample data
Depends on: shared MarginNoteAdapter diagnostic contract from parser work
Non-goals for this issue
- Enabling Realm in Create KB UI
- Writing to the live MN4 database
- Promising
marginnote4:// live jump links
Key files
deeptutor/capabilities/marginnote/data/realm_adapter.py
deeptutor/capabilities/marginnote/data/base.py
Acceptance criteria
Success metric
Either a documented BLOCKED research result, or a testable read-only adapter that never appears in UI before it is safe.
Tracked by #10. Local plan:
docs/roadmap/marginnote-4.md.Goal (中文): 先调研 MN4 Realm schema、版本兼容、锁文件和只读安全。没有合法样本和可重复测试环境时保持 BLOCKED,UI 不展示 Realm 选项。默认严格只读。
Do you need to file a feature request?
Feature Request Description
Research, then possibly implement, a read-only Realm adapter for live MarginNote 4 data.
deeptutor/capabilities/marginnote/data/realm_adapter.pyis only a stub. v1 officially supports export folders only. Realm access depends on MN4 schema knowledge, version compatibility, lock files, and a legal/repeatable sample environment.Phase 1 is research only:
realmPython dependency) and license constraintsDefault remains strictly read-only. Any write capability needs a separate design approval. Until legal samples and a repeatable test environment exist, this issue stays
BLOCKEDand the UI must not show a Realm option.Related Module
Knowledge Base Management
Use Case
If live access becomes safe and testable, learners can skip the export step and let DeepTutor read the current MN4 notebook. Until then, the product must not pretend Realm sync is available.
Additional Context
Priority: P2
Phase: M3
Status: BLOCKED pending a real MN4 environment, schema, and legal sample data
Depends on: shared
MarginNoteAdapterdiagnostic contract from parser workNon-goals for this issue
marginnote4://live jump linksKey files
deeptutor/capabilities/marginnote/data/realm_adapter.pydeeptutor/capabilities/marginnote/data/base.pyAcceptance criteria
Success metric
Either a documented BLOCKED research result, or a testable read-only adapter that never appears in UI before it is safe.