dsh-report-studio
将 DeepSeek Harness 会话转化为带有可核验凭证的可交付工作报告（日报/周报/交接报告/文章）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ciceroyang/dsh-report-studio#10cfd0c584b3978687b2e089f17a9d6a9283af38Report Studio 以 dsh-report-studio 发布，当前版本为 0.4.7。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
When your agent finishes work, have it write up what happened — into something you can actually hand over.
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 later changes to the saved report or referenced artifacts are detectable.
Status: usable. See Releases for current versions. Tracks the Harness developer preview; interfaces may change.
daily, weekly, handoff, article.. traversal are rejectedreport_index lists every saved report with kind, date, session and verification status, and can write the index as Markdown or HTMLdsh plugin or load with a --patch overlayRequires Node.js ≥ 18 and DeepSeek Harness.
dsh plugin --profile web add github:ciceroyang/dsh-report-studio#v0.4.4
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
Tell the agent either of:
The bundled work-report skill teaches the agent the full workflow:
report_generate produces a draft with hard data plus [[待写:…]] prose slots;report_save writes the file and appends the receipt;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
| Argument | Required | Meaning |
|---|---|---|
kind | yes | daily / weekly / handoff / article |
title | no | custom title; falls back to the session title |
period | no | period label (e.g. "2026-08-11 ~ 2026-08-17") for weekly |
Returns the full Markdown draft; prose sections are [[待写:…]] markers.
| Argument | Required | Meaning |
|---|---|---|
content | yes | final Markdown (receipt is appended automatically) |
path | no | target path; defaults to reports/<kind>-<date>.md |
kind | no | used for the default filename |
artifacts | no | produced file paths; existing files get hashed into the receipt |
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.
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.
Independently re-checks a saved report's receipt: recomputes the report SHA-256 and every artifact hash, reporting match/missing per item.
| Argument | Required | Meaning |
|---|---|---|
path | yes | saved report file (inside the workspace) |
dir | no | batch mode: verify every .md and .html report under this workspace-relative directory; returns matched/mismatched/no-receipt summary |
Lists every saved report under a directory (default reports/, recursive, .md and .html) as an index: kind, date, session, verification status and artifact count. Verification reuses report_verify's logic, so the index shows at a glance which reports are still intact.
| Argument | Required | Meaning |
|---|---|---|
dir | no | directory to index (workspace-relative); default reports |
format | no | md (default) or html |
save | no | optional path to write the index to; without it the tool returns text only and writes nothing |
Publish a report to Feishu (custom bot webhook) or Notion (page); target=dry previews the payload without sending anything.
| Argument | Required | Meaning |
|---|---|---|
target | yes | feishu / notion / dry |
content | no | report text; otherwise read from path |
path | no | saved report file (inside the workspace) |
title | no | Feishu prefix / Notion page title |
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.
| Argument | Required | Meaning |
|---|---|---|
title | no | custom title |
period | no | period label, e.g. "2026-08-11 ~ 2026-08-17" |
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.
## 报告凭据 Report Receipt
| 项 | 值 |
|---|---|
| 会话 Session | session-1c1e5d0c-… |
| 工作区 Workspace | /Users/you/project |
| 生成时间 Generated | 2026-08-14T08:00:00.000Z |
| 报告哈希 Report SHA-256 | 9f2c… |
| 产物 Artifacts | README.md → 3a1b… |
Two paths (the work-report skill picks per the session's actual capability):
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).
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
fs directly, outside the Harness fs policy layer;
path-escape protection lives inside the plugin.Issues and PRs welcome (typos, new templates, translations, tests). Before pushing:
npm test
MIT. If this saves you from writing another daily report:
Built for the open-source community, in the spirit of DeepSeek Harness: everything is a plugin.