Roland0511/dsh-marktext

dsh-marktext

写 Markdown，所见即成品。
把 MarkText 的编辑器内核搬进 DeepSeek Harness 右侧栏。

English · 简体中文

点开侧栏里的 .md，它就是排版好的成品——标题、表格、公式、图表、图片，全都能就地编辑。没有左右分屏，没有「源码 ↔ 预览」来回切。⌘S 保存，文件经版本校验写回磁盘，不会盖掉别人的修改。

MarkText 是 Electron 桌面应用，本插件没有搬运它的桌面壳，只用它拆出来的编辑器内核（@muyajs/core / muya，MIT），外面套一层 DSH 集成。全部本地运行。

为什么它手感不一样

• ✍️ 你编辑的是文档，不是源码。 Markdown 标记全程隐藏，标题、列表、表格、引用都是真实元素——想改表格就点单元格，不用去数那一排竖线。
• 📊 公式和图表直接渲染。 KaTeX、Mermaid、Vega、PlantUML 随插件一起发，按需加载，离线可用，不依赖 CDN，也不用登录。
• 🖼️ 图片落在该在的位置。 ![](assets/diagram.png) 按文档所在目录解析，在别处写的文档搬进来照样显示正常。
• 💾 保存这件事很无聊，但这正是它该有的样子。 停手 2.5 秒自动保存，⌘S 立即保存；磁盘上的文件被别人改过就弹冲突，绝不静默覆盖。
• 🌗 长得就像 DSH。 明暗跟随宿主，不会突然变成另一套皮肤。
• ⌨️ 手指不用重新学。 ⌘Z / ⇧⌘Z 撤销重做、⌘S 保存、⌘F 查找。

一行装好

dsh plugin --profile web add dsh-marktext

用桌面 app？ 打开 Plugins → Add plugin → Install a third-party plugin，输入 dsh-marktext，点 Enable now，重启一次 app。（桌面 profile 由 app 自己管理，上面那行命令是给 dsh web 用的。）

{
  "dsh": { "profile": { "bundles": [..., "dsh-marktext"] } },
  "dependencies": { ..., "dsh-marktext": "^0.1.11" }
}

cd ~/.dsh/profiles/desktop && pnpm install

它给你什么

实现方式

DSH Web（React）
  lib/client.js  ── 侧栏标签类型 `marktext`（patterns: *.md）
      │            标签体 = <iframe src="/dsh-marktext/renderer/<token>/index.html">
      │ postMessage（统一信封 __dshmkt）
      ▼
renderer/（独立 Vite 构建，内含 muya + mermaid）
      │ fetch
      ▼
lib/index.js（宿主插件）
  · /dsh-marktext/renderer/<token>/*   静态资源；miss 时回落到文档目录
  · /dsh-marktext/api/open|save|stat   走 ctx.fs；save 必须带 baseVersion

编辑器放在 iframe 里是刻意的：muya 的 CSS 变量定义在 :root、浮层直接挂到 document.body，内联会把样式泄漏到宿主。iframe 把这些一次性隔离，只让「文档、主题、保存」三件事跨界。

排查

如果 .md 打开了但标签页提示类似「没有可用的查看方式」，说明客户端没注册上标签体。看注册回执：

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

typeRegistered、bodyRegistered 和 errors 会指出是哪一步失败。

常见问题

这是 MarkText 那个 app 吗？ 不是。这是它的编辑器内核（muya）包成的 DSH 插件——没有 Electron、没有桌面壳、不用再装第二个应用。

会不会改我的排版？ 它保存的是编辑器序列化出的标准 CommonMark/GFM。真正保护你的是版本守卫：文件在底下被改过，会提示冲突而不是悄悄重写。

能离线用吗？ 能。所有资源、字体、图表引擎、语法高亮都随插件一起发。

会和别的 Markdown 插件打架吗？ 它和 dsh-markdown-typora 都在 extension band 抢 *.md，装一个就好。

已知限制： 绝对路径图片（/abs/a.png、file://）暂不支持；没有「选中片段插入对话」；没有导出 PDF。包体积约 4 MB，首屏约 1.6 MB。

开发

npm install
npm run build:renderer            # 产出 renderer/（已入库；只有改 src/renderer 时才需要）
npm test                          # 宿主路由、版本守卫、路径穿越、Origin 栅栏、客户端注册
node scripts/verify-renderer.mjs  # headless Chrome：打开 → 渲染 → 保存 → 落盘

发布

使用 npm Trusted Publishing（OIDC），仓库里不存 token 或 secret。每次推送到 main：跑测试 → 校验 renderer/ 与源码一致 → 版本是新的才发布 → 自动打 tag 建 GitHub Release（自动生成 release notes）。

npm version patch --no-git-tag-version
git commit -am "chore: release x.y.z"
git push

Star 趋势

许可

MIT —— 见 LICENSE。第三方组件与 MarkText 署名：NOTICE.md。