iwker/dsh-htmlrun

README 摘要

dsh-htmlrun 把 html.run 的 HTML 发布能力从 agent skill 封装成 DeepSeek Harness（DSH）插件 ，让 DSH 会话内的模型可以直接把本地 HTML 发布成可分享链接。 GitHub 仓库名与 npm 包名均为 dsh-htmlrun ；harness 插件列表显示时会剥离 dsh- 前缀 → htmlrun ；工具名、插件 name 均为 htmlrun 。 目录结构 两种形态共享同一套执行逻辑（子进程调 CLI、token 存 /.htmlrun/config ）： - 动态插件 （ plugin/htmlrun-publish/host.js ）：会话内 cordis define 加载，免安装、进程内临时； - 组合包 （仓库根： package.json + cordis.patch.yml + lib/index.js ）：可安装进 profile 的正式形态，用于发布到社区。 原理 - 不重写 HTTP 层 ：插件的 execute 用 ctx.subprocess 把 node scripts/htmlrun.cjs 作为子进程跑起来，输出原样透传给模型转达——行为与 skill 里 CLI 逐字节一致，包括激活二维码、敏感词、 ⚠ 已被限制访问 、 说明: / 指引: 等字段。 - 凭据互通 ：CLI 的 token 存在 /.htmlrun/config ，插件与终端里手工使用 CLI 是同一份凭据，无需重复激活。 - 为什么不直接用网络服务 ：DSH 动态插件沙箱禁用了 fetch / require ，而 ctx.web.fetch 只支持无头 GET（无法发 POST + Authorization），调不了 html.run 的发布接口； ctx.fs 写 会被 workspace-write 沙箱拒绝。 ctx.subprocess 是本地未加沙箱的子进程服务（ dsh-bash-local 同样用它），是唯一能完整跑 CLI 的路径。 快速开始（动态插件，会话级） 1. 确认本机有 Node（ node --version ，需 = 16），并保证 skill/scripts/htmlrun.cjs 可用（本仓库自带）。 2. 在 DSH 会话中加载插件（把 plugin/htmlrun-publish/host.js 的内容作为 code.host ）： - cordis define （新插件）： plugin.kind = "new" 、 idPrefix = "hpub" 、 code.host = host.js 全文 ； - cordis run ：激活后即向当前会话注册模型工具 htmlrun 。 3. 之后直接对模型说"发布 xx.html / 更新一下链接…

分类