Roland0511/dsh-marktext

项目介绍

dsh-marktext 是 DeepSeek Harness（DSH）的插件，把 MarkText 的编辑器内核 muya 搬进 DSH 右侧栏。在侧栏点击 .md、.markdown、.mdown 或 .mkd 文件，它就会以渲染后的文档形式打开：标题、表格、数学公式、图表和图片都能直接在原位置编辑，不需要源码与预览分栏。项目基于 MIT 许可的 @muyajs/core，只补上 DSH 集成，不附带 Electron 外壳，也不需要另装桌面应用。

它面向已经使用 DSH、希望就地阅读和编辑 Markdown 的用户。KaTeX、Mermaid、Vega-Lite、PlantUML 和 Prism 高亮随插件分发，离线按需加载。

编辑器运行在 iframe 中，避免 muya 的 :root CSS 变量和浮动工具栏污染宿主界面；只有文档、主题和保存消息通过统一的 __dshmkt 信封跨越边界。

快速使用

通过 DSH 的插件命令行从 npm 安装（命令面向 web profile）：

dsh plugin --profile web add dsh-marktext

桌面应用用户应改用 Plugins → Add plugin → Install a third-party plugin，输入 dsh-marktext，点击 Enable now，然后重启一次应用。桌面 profile 由应用管理，上面的命令行只适用于 dsh web。

手动安装桌面版时，在 ~/.dsh/profiles/desktop/package.json 的 bundles 和 dependencies 中加入 dsh-marktext，在该目录执行 pnpm install 并重启。也可以在任何接受包名的位置用 github:Roland0511/dsh-marktext 从 GitHub 安装；构建好的渲染器已提交到仓库，无需构建步骤。

安装后从侧栏打开一个 Markdown 文件，它应作为编辑标签页出现。

保存与冲突处理

保存带版本守卫：插件调用 ctx.fs.writeText 并传入 replaceIfVersion 和基准版本，版本过期会返回 FS_STALE_VERSION，界面显示冲突提示。若宿主策略拒绝写入（FS_SANDBOX_DENIED，例如在 workspace-write 或 read-only 下），保存会退回到 Node 的 fs.writeFile，但仍在写入前后校验版本。EACCES、EPERM 等真实系统错误会原样暴露。停止输入 2.5 秒后自动保存，⌘S 立即保存。

使用约束

• 需要 DeepSeek Harness 0.2.1+，并提供 ctx.sidebarRightTabs、ctx.slots、ctx.fs 和 ctx.webServer。
• 只有从源码构建时才需要 Node 20+。
• 不要与 dsh-markdown-typora 同时安装，两者都在 extension 段声明 *.md。
• 绝对图片路径（/abs/a.png、file://）尚不能解析；没有「把选中内容插入对话」功能，也没有 PDF 导出。
• 保存的是编辑器序列化出的标准 CommonMark/GFM，即使内容冲突有守卫，格式也可能变化。
• 安装包约 4 MB，首屏约 1.6 MB。
• 项目采用 MIT 许可，第三方组件和 MarkText 署名见 NOTICE.md。

排查问题

如果 .md 能打开但标签页提示没有可用查看器，可能是客户端未注册标签页主体。查看诊断报告：

curl -s http://127.0.0.1:<DSH-port>/dsh-marktext/api/diag | python3 -m json.tool

typeRegistered、bodyRegistered 和 errors 字段能指出出错的步骤。

HotRepo 点评

该仓库进入 HotRepo 2026 年 11 月 6 日新项目榜的 JavaScript 语言视图，记录显示在 01:45 至 19:45 UTC 的统计窗口内新增 58 Star，期末为 203 Star、13 Fork。采样 Star 在当天大部分时间停留在 146，最后一次观测才升到 203，说明窗口内主要是尾声的一次跳升，而不是持续爬升。这足以说明项目当天获得了关注，但不足以判断趋势。更有技术含义的信号在范围界定：它没有重造编辑器，而是把 MarkText 现有的 muya 内核包装成 DSH 侧栏插件，集成工作集中在版本守卫保存和 iframe 隔离上。

项目源码与说明