Logseq 数据库迁移规划 Skill 技能

技能简介

c0ntr0lledcha0s-migrating-to-db（Logseq 数据库迁移规划） 面向 Logseq 从 Markdown 图谱迁移到数据库（DB）图谱的场景。迁移最容易翻车的地方是结构、类型、链接和查询行为在转换中悄悄丢失——这个 Skill 不替你执行迁移，而是给出一套分阶段的规划方法：备份、功能盘点、导入决策、并行切换与迁移后验证，把"直接导进去试试"变成有回滚点的受控过程。技能在 Skillstore 质量评分 81 分（silver 档），riskLevel 为 safe，已完成安全审计（25 项静态发现全部确认为 Markdown 格式与常规迁移指导造成的误报，无提示注入、无自动命令执行、无可疑网络行为），支持 Claude、Codex、Claude Code，采用 MIT 许可。

核心能力

• 双形态对比：逐项对比 Markdown 图谱与数据库图谱在存储、标签、属性、查询、同步五个维度的差异。
• 预迁移清单：覆盖备份、命名空间、标签、属性、模板、链接六大检查项。
• 全流程引导：从 EDN 导出、DB 图谱创建、导入配置到迁移后复核，一步步带过。
• 转换决策说明：解释标签转 class（类）、命名空间处理方式、属性类型选择等关键决策。
• 验证与排障：提供验证查询示例，覆盖计数、孤儿块、属性类型、引用、命名空间等常见问题。

安装配置

1. 在项目目录执行 npx skillstore add c0ntr0lledcha0s/migrating-to-db 完成安装。
2. 这是纯文档型技能：不执行迁移、不导入文件、不修改你的 Logseq 图谱，所有操作由你手动完成。
3. 文档描述的是 2024–2025 年 Logseq DB 版 alpha 阶段的行为，实际使用时要对照当前版本核对。
4. 技能标注的风险因素为外部命令与网络，建议仅在自己授权的仓库中使用；验证查询示例需按已安装的 Logseq 版本与图谱结构调整。

使用步骤

1. 新手检查清单：让 Agent 生成面向小型 Markdown 图谱的入门迁移清单，包含备份、导出、导入、验证四段。
2. 迁移前审计：把实际用到的标签、命名空间、属性、模板、查询告诉它，逐项识别决策点与风险。
3. 设计并行迁移：为大型活跃图谱制定分阶段方案，明确各阶段的回滚点、验证检查与切换到 DB 的判据。
4. 制定验证策略：产出覆盖计数、孤儿块、属性类型、引用、命名空间与重写查询的高级验证方案。
5. 执行与复核：按方案手动操作，DB 图谱通过全部验证前，原 Markdown 图谱保持不动。

适用场景

• 个人知识库迁移：小图谱先备份、盘点功能特性，再按清单选好导入设置。
• 团队工作区迁移：共享内容用并行迁移 + 验证检查点，随时可回退。
• Logseq 集成适配：迁移前映射变更的属性，评估查询、插件、自动化流程的兼容风险。
• 查询与插件排查：迁移后用验证查询定位失效的查询语句、模板与插件行为。

适用人群

Logseq 重度用户、个人知识库（PKM）管理者、团队知识库管理员、维护 Logseq 插件与自动化流程的工具链维护者，以及任何准备把 Markdown 图谱切到 DB 图谱的探索型用户。

工作原理

技能的核心是"先对比、再规划、后验证"：第一步对比两种图谱在存储结构、标签、属性、查询与同步上的行为差异，列出会受影响的功能；第二步生成预迁移清单并指导 EDN 导出、DB 图谱创建与导入配置；第三步围绕标签转 class、命名空间保留、属性类型推断给出决策说明；第四步用验证查询比对块计数、孤儿块、引用完整性与重写后的查询结果，发现问题按排障指引回溯。官方给出的底线策略是：原图谱在 DB 图谱通过验证前绝不删除，导入后不接受未经核对的自动推断属性类型，也不默认旧查询、插件、模板可以原样工作。

官方链接

• 技能主页：https://skillstore.io/skills/c0ntr0lledcha0s-migrating-to-db
• 源码仓库：https://github.com/C0ntr0lledCha0s/claude-code-plugin-automations/tree/main/logseq-expert/skills/migrating-to-db
• 技能清单：https://skillstore.io/api/skills/c0ntr0lledcha0s-migrating-to-db/manifest