dsh-report-studio

  

When your agent finishes work, have it write up what happened — into something you can actually hand over.

The first "session → work deliverable" plugin in the DeepSeek Harness ecosystem: turn one session into a daily report / weekly report / handoff document / WeChat-article draft, each sealed with a verifiable receipt block (report hash + artifact hashes), so reports cannot be embellished.

> Status: 0.1.0, usable. Tracks the Harness developer preview; interfaces may change.

Features

• 4 ready templates: daily, weekly, handoff, article
• Deterministic session extraction: user asks, todo snapshots, turn/step stats,

token ledger, tool calls, produced files, shell commands, errors and blocks — all read from the durable session event log, never from the model's memory

• Verifiable receipt block: session id, workspace, generation time, report

SHA-256 and artifact SHA-256 appended to every saved report

• Safe persistence: target paths are confined to the session workspace;

absolute-path escapes and .. traversal are rejected

• Customizable templates: override built-in templates wholesale (placeholders below)
• No build step: plain ESM; install via dsh plugin or load with a --patch overlay

Install

Requires Node.js ≥ 18 and DeepSeek Harness.

Option 1: plugin install (needs pnpm)

dsh plugin --profile web add github:ciceroyang/dsh-report-studio

Option 2: local source overlay (no pnpm)

git clone https://github.com/ciceroyang/dsh-report-studio.git

# my-report.yml (the plugin path MUST be absolute): # - insert: # - id: report-studio # name: '/absolute/path/to/dsh-report-studio/index.js'

dsh web --patch ./my-report.yml

Usage

Tell the agent either of:

• "Write today's work report."
• "Turn this session into a handoff document for the next person."

The bundled work-report skill teaches the agent the full workflow:

1. report_generate produces a draft with hard data plus [[待写:…]] prose slots; 2. the agent fills the slots from session facts only; 3. report_save writes the file and appends the receipt; 4. the agent replies with the saved path and the report hash.

Default save location: reports/<kind>-<date>.md inside the workspace.

For an instant draft preview without a model round trip, type the slash command:

/report daily # weekly / handoff / article also work

Tools

report_generate

Returns the full Markdown draft; prose sections are [[待写:…]] markers.

report_save

| format | no | md (default) / html — standalone forwardable document; the original Markdown is embedded in a hidden source block so report_verify still verifies it |

Returns the absolute path, report SHA-256, and verified artifact hashes.

report_week

Aggregates every persisted session of the current workspace (logs under $DSH_HOME/sessions) plus the live session into a weekly draft with a per-session table. Reading historical logs needs Node ≥ 22.15 (built-in zstd); older Node degrades gracefully to the current session only.

report_verify

Independently re-checks a saved report's receipt: recomputes the report SHA-256 and every artifact hash, reporting match/missing per item.

report_publish

Publish a report to Feishu (custom bot webhook) or Notion (page); target=dry previews the payload without sending anything.

Configuration: plugin config publish.feishuWebhook / publish.notionToken + publish.notionParentPageId, or env vars FEISHU_WEBHOOK / NOTION_TOKEN / NOTION_PARENT_PAGE_ID. Real publishing fails loudly without them; dry mode always works.

Custom templates

Templates are plain Markdown with stable placeholders (data sections are filled deterministically by the plugin):

{{TITLE}} {{DATE}} {{PERIOD}} {{META}} session id / workspace / time range / title {{TASKS}} user asks + latest todo snapshot {{STATS}} turns / steps / tool calls / token ledger / end reasons {{TOOLS}} tool call table {{FILES}} produced and read files {{COMMANDS}} shell commands run {{ERRORS}} tool errors and blocks {{TIMELINE}} per-turn timeline {{SESSIONS}} weekly session table (report_week aggregation)

Prose sections are written as [[待写:…]] and must be filled before saving.

Point the plugin at a custom directory:

- insert: - id: report-studio name: dsh-report-studio config: templatesDirs: - '/absolute/path/to/my-templates'

Copy any file from this repo's templates/ directory as a starting point.

Receipt example

## 报告凭据 Report Receipt

Scheduled weekly reports

Two paths (the work-report skill picks per the session's actual capability):

1. In-harness (official tools): with dsh-schedule mounted, say "generate my weekly report every Friday 18:00" and the agent implements it via schedule_create (time zone must be explicit). 2. System-level (zero deps, all data sections automatic): scripts/auto-weekly.mjs needs no model — it aggregates the week's sessions, fills every data section and saves a draft with [[待写:…]] prose slots. Point launchd/cron at it for Friday 18:00, then open a session and say "fill and save".

node scripts/auto-weekly.mjs <workspace> --out reports/weekly-auto.md

Known limitations (0.1.0)

• report_week cross-session aggregation reads historical logs under $DSH_HOME/sessions (multi-frame zstd); historical reading needs Node ≥ 22.15.
• Persistence uses Node's fs directly, outside the Harness fs policy layer;

path-escape protection lives inside the plugin.

• Report tools require an agent-bound session (web and headless both qualify).

Docs & examples

• [中文实战教程:从零到发布](docs/tutorial-zh.md) — 完整开发复盘,含 6 个实测坑
• Plugin scaffold — generate the same project layout in one command
• Environment doctor — one-command local diagnostics (port/deps/profiles/logs)
• [Example daily report](demo/report-daily.example.md) — 真实会话产出的日报样例(凭据块)

Contributing

Issues and PRs welcome (typos, new templates, translations, tests). Before pushing:

npm test

License & funding

[MIT](./LICENSE). If this saves you from writing another daily report:

• Mainland China: Afdian (pays out to Alipay; GitHub Sponsors cannot pay out there)
• Elsewhere: GitHub Sponsors

---

Built for the open-source community, in the spirit of DeepSeek Harness: everything is a plugin.