dsh-markji-bridge：让 DeepSeek Harness 的 agent 读写墨墨记忆卡

它是做什么的？

Markji Bridge 是 DeepSeek Harness（DSH）的墨墨记忆卡（Markji）插件，让 agent 在本地缓存里搜索、阅读、新建、修改和归档卡片。它解决的是 agent 直接调用云端 API 时读写慢、易冲突、断线丢进度的问题：所有修改先进入本地队列，再按「先拉取、三方合并、后推送」的顺序同步到云端。插件提供 16 个 markji_* 工具，只用 Node 内置模块实现，由 Oxmyxo 维护，采用 MIT 协议。

核心功能

• 本地 SQLite 缓存：索引、卡片正文、待推送队列、冲突和同步任务都放在单个 cache.db 里，日常搜索和阅读不请求 API。
• 纯文本搜索：每张卡另存一列去掉格式标记、图片音频标记和 base64 的纯文本，搜索只匹配纯文本，结果干净可读。
• 安全写入：修改先排队，推送前先拉取远端变更并三方合并，冲突按卡片去重、可逐条解决，不会用旧数据覆盖云端。
• 后台同步与断点续跑：同步任务立即返回句柄并可查进度，进程崩溃或插件重启后用同一句柄续跑，不重复创建云端对象。
• 归档与章节管理：把卡片移入同卡组「归档」章节并插入归档说明，重复调用幂等；还支持新建、重命名、排序章节和移动卡片。
• 多进程安全：同一台机器的多个 DSH 进程可共用一个缓存目录，写入通过文件锁串行。

怎么使用这个插件？

先在 DSH 主机进程的环境变量里设置墨墨开放平台获取的 OpenAPI token，然后重启 DSH。启用插件后，用 markji_decks 拉取卡组、markji_search 按卡组名或纯文本找卡、markji_card_get 读单张卡；新建和修改用 markji_card_create 与 markji_card_update，之后调用 markji_sync 启动后台同步，用 markji_sync_status 看进度、markji_failures 查失败与冲突，再用 markji_conflict_resolve 逐条解决。首次调用会拉取云端数据，之后读操作走本地缓存；运行需要 DSH 0.2.x 的 Host 插件环境与 Node 22.13 及以上，支持 Windows、macOS 和 Linux。

报错怎么排查？

同步后仍有卡片未生效时，先用 markji_failures 查看失败卡片、冲突与恢复建议，再按建议处理。遇到冲突时用 markji_conflict_resolve 选择保留本地、保留远端或指定内容，冲突按卡片去重，不影响其他卡片。同步中断时用 markji_sync 的 resume 参数以同一句柄续跑，避免重复创建云端对象。