dsh-doc-present

Usage

For the agent (model tool)

doc_present — one tool for the whole lifecycle:

action	What it does
new	Create //index.html from the template (needs slug, optional title), ensure the LAN server, return the file path and all URLs. The agent then writes the content with its normal write/edit tools.
status	Server state, root, port, doc counts, URLs.
ensure	Start (or reuse/adopt) the LAN server; prints share URLs.
list	List published docs (all: true includes withdrawn).
unpublish	Take a doc offline (visitors see a 410 page); files kept, restorable.
republish	Re-publish a withdrawn doc.
delete	Move a doc to the trash (hard: true deletes permanently).
trash	List the trash (empty: true empties it).

Authoring rules the agent follows (enforced by the prompt section): a doc is one self-contained HTML file — inline CSS/JS, no CDN / web fonts / external images (LAN readers may not reach the public internet), demos paused by default with a static caption each, semantic colors (blue = active, green = done, yellow = attention, red = risk, purple = self-call). The two guides in references/ teach the FX framework and the writing structure; the prompt section points the agent at their absolute paths.

For the user

• 📄 方案预览 button (session header, top right) — toggle the preview drawer: doc chips on top, live preview below; 浏览器打开 / 复制链接 / ↔ 全宽 / ⟳ / ✕ in the drawer header; Esc closes.
• Tool cards — after the agent publishes, its doc_present result renders a card with 在面板中打开 (opens the drawer straight at that doc), 浏览器打开, and 复制内网链接.
• /doc-present status|start|stop|list — the service as a command. (/doc-present json is the machine-readable state the panel uses.)

Configuration

• Doc root: DOC_PRESENT_ROOT env var, default ~/.dsh/doc-present (docs + .server/ metadata: config.json, state.json, trash/).
• Port: DOC_PRESENT_PORT env var > /.server/config.json > 8899.
• Template and guides resolve relative to the installed package, so keep assets/ and references/ next to lib/.