dsh-plugin-doc-present

Doc Present for the DeepSeek Harness (dsh): let the agent show plans and designs instead of dumping long text into the chat.

When the agent has a proposal to present — an architecture, a flow, a state machine, a message sequence, a numeric curve, a UI walkthrough — it publishes a self-contained interactive HTML page (inline CSS/JS, FX animation framework included) and you view it in an in-GUI panel or any browser, including colleagues on the LAN.

方案展示插件：agent 把方案做成自包含 HTML 动态演示页（状态机/时序/曲线/UI 四类动图配方），你在 GUI 内嵌面板或浏览器里看，替代对话框长文。

Surfaces

Surface	What you get
In-GUI panel	📄 方案预览 button in the session header opens a drawer with the doc list and a live iframe preview (same-origin route /doc-present/... on the dsh web server — no CORS, no extra port needed for local viewing).
Tool card	Each doc_present tool call renders a card in the conversation with 在面板中打开 / 浏览器打开 / 复制内网链接 buttons.
LAN server	A standalone preview server on 0.0.0.0 (default port 8899, auto-scans upward if occupied) so colleagues open `http://:
//` directly. Started lazily on first publish; survives nothing but a dsh restart (docs persist on disk; it re-ensures itself on next use).

Repository layout

package.json          plugin manifest (dsh.client declaration, exports["./client"])
lib/index.js          host half: doc_present tool, /doc-present command, prompt section, /doc-present web route
lib/server.js         document server core (pure Node, no dsh imports — standalone-testable)
lib/client.js         client half: header button + overlay drawer + doc_present tool card
assets/template.html  self-contained doc template with the FX animation framework
references/           authoring guides the agent reads before writing pages
  html-authoring.md     FX framework usage + 4 copy-paste demo recipes
  writing-guide.md      inverted-pyramid writing guide for design docs
scripts/smoke.mjs     standalone smoke test for lib/server.js

The doc template, the FX framework, and both guides are ported from the design-preview agent skill; the preview server is a Node port of its doc_server.py with the same lifecycle rules (unpublish → 410, delete → trash, etc.).

Installation

Prerequisites: a working dsh install (the dsh CLI on PATH, with a web profile). The plugin loads as a real package from the profile module fallback directory, plus one row in a composition (host profile patch or agent preset). Installing the package alone changes nothing — the row placement in step 2 decides who gets Doc Present. This repository ships no install scripts and never writes outside its own files: every mount is a manual row.