影迁 Shadow Shift —— 一键将 WizNote 笔记迁移到 Obsidian，保留笔记、图片、附件与 WikiLinks 内部链接。
- 一键迁移：两条命令完成 WizNote → Obsidian，99% 用户只需默认流程。
- 格式完整：自动执行 5 步格式化 —— 语法检查 → 格式修复 → 链接转换（WikiLinks）→ 图片修复 → 生成报告。
- 数据无损：原始
wiznote_download/只读不变，格式化结果写入独立的wiznote_obsidian/。 - 零额外依赖（离线）：格式化工具纯 Python 3.6+ 实现；仅在线下载需
requests/markdownify/websocket-client。 - 实测规模：单次迁移 449 篇笔记、7198 张图片、30 个附件。
# 1. 克隆
git clone https://github.com/WardLu/shadow-shift.git
cd shadow-shift
pip3 install -r requirements.txt # 仅在线下载需要
# 2. 下载笔记（输入 WizNote 账号密码）
python3 tools/wiznote_downloader.py
# 3. 格式化（基础 5 步）
python3 tools/obsidian_formatter.py
# 4. 在 Obsidian 中打开 wiznote_obsidian 目录就这么简单。需要附件集中管理时，把第 3 步换成 python3 tools/obsidian_formatter.py --all（7 步）。
| 目录 | 说明 | 是否修改 |
|---|---|---|
wiznote_download/ |
原始下载笔记 | 只读，保持不变 |
wiznote_obsidian/ |
格式化后笔记 | 在 Obsidian 中打开此目录 |
| 命令 | 作用 | 步骤 |
|---|---|---|
python3 tools/wiznote_downloader.py |
在线下载 WizNote 笔记 | 登录 · 扫描 · 下载 · 转 Markdown |
python3 tools/obsidian_formatter.py |
离线格式化（默认） | 5 步：语法 / 格式 / 链接 / 图片 / 报告 |
python3 tools/obsidian_formatter.py --all |
完整迁移 | 7 步：5 步 + 附件迁移 + 附件链接 |
单步命令（只执行某一阶段）：
python3 tools/obsidian_formatter.py --check # 只检查语法（不修改）
python3 tools/obsidian_formatter.py --fix # 只修复格式
python3 tools/obsidian_formatter.py --links # 只转换链接为 WikiLinks
python3 tools/obsidian_formatter.py --images # 只修复图片路径
python3 tools/obsidian_formatter.py --report # 只生成报告
python3 tools/obsidian_formatter.py --fix --dry-run # 干运行预览下载参数（网络环境调节）：
python3 tools/wiznote_downloader.py --workers 10 --timeout 20 # 极速模式
python3 tools/wiznote_downloader.py --workers 3 --timeout 10 --retries 1 # 安全模式| 工具 | 用途 | 依赖 |
|---|---|---|
tools/wiznote_downloader.py |
从 WizNote 云端下载笔记 | 需在线依赖 |
tools/obsidian_formatter.py |
离线格式化为 Obsidian 规范 | 纯 Python，无依赖 |
tools/sync_deletions.py |
安全同步两目录删除（含干运行、备份、日志） | 无 |
tools/config_helper.py |
配置管理（环境变量 / JSON），供其他工具调用 | 无 |
五步格式化详解
- 语法检查 — 标题空格、层级跳跃、列表格式、代码块语言标识
- 格式修复 — 标题空格、统一列表标记（
-）、空行、多余空格 - 链接转换 —
[文本](URL)→[[笔记名]]，转换 WizNote 内部链接与附件链接 - 图片修复 — 统一路径格式、修复相对路径
- 生成报告 — 统计 Markdown 文件数、WikiLinks 数
sync_deletions.py 使用流程
# 1. 扫描差异（只查看，不删除）
python3 tools/sync_deletions.py --scan --source ~/wiznote_export --target ~/ObsidianVault
# 2. 查看报告确认
# 3. 确认删除（备份到 .sync_delete_trash/）
python3 tools/sync_deletions.py --confirm --source ~/wiznote_export --target ~/ObsidianVaultQ1：登录后出现 None/ks/... 或无法获取目录？
通常表示登录未真正成功。若账号启用二次登录验证，请先在 WizNote X 或网页版关闭二次验证后重试（经典版客户端无关闭选项）。
Q2：默认命令和 --all 的区别？
- 默认（5 步）：图片保持在
*_files/目录，大多数用户足够。 --all（7 步）：额外把附件迁移到attachments/并添加链接，适合长期使用 Obsidian、想集中管理附件的用户。
Q3：源目录不在项目根目录怎么办？
python3 tools/obsidian_formatter.py --source /path/to/wiznote_export --target /path/to/wiznote_obsidian
# 或用环境变量
export WIZNOTE_SOURCE_DIR=~/wiznote_export- API 速率限制：WizNote API 可能限流，默认 5 线程；网络差用安全模式参数。
- 加密笔记：RSA + AES 混合加密，需在 WizNote 客户端批量解密后再运行。
- HTML → Markdown：复杂表格、嵌套列表、
<iframe>等转换可能不完美，建议下载后用格式化工具优化。 - 服务可用性：WizNote 服务器维护时无法下载，建议错峰。
完整局限与最佳实践见 QUICK_REFERENCE.md。
本项目采用 开源工具 + 商业应用 双轨架构：
- 开源部分：本仓库
tools/目录，命令行工具，完全免费（MIT）。 - 商业部分：
app/目录（Git Submoduleshadow-shift-app），图形界面桌面应用。
| 你的身份 | 推荐 |
|---|---|
| 技术用户 | 本仓库命令行工具 |
| 非技术用户 | 商业桌面应用（图形界面） |
欢迎贡献代码、报告问题或提出建议 —— 提交 GitHub Issue。
- X (Twitter)：@Gollumgulu
- 微信公众号：Ward的AI产品实战
- 小红书 / 微博 / 抖音：全网同名
Ward的AI产品实战· 小红书 · 微博 · 抖音 - 个人主页：全力开发中...
- 产品主页：Shadow Nexus
- Email：wardlu@126.com
可接 1v1 咨询和项目陪跑，欢迎联系。
产品诊断 · AI 实施 · 工作流 / Skill / 系统定制
如果这个项目对你有帮助，请给一个 ⭐ Star！