dsh-agent-log
Agent 工作记录 / 任务复盘 / 自动生成项目报告：从 DSH 会话日志只读还原这次任务做了什么，并产出可读的《本次 Agent 工作报告》
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Neo65536-engineer/dsh-agent-log#50fd116d04ffcfd202ef31d4ec4d2dca203bf603Agent Log 以 dsh-agent-log 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 插件。从本机的 DSH 会话日志里只读还原一次任务做了什么，输出一份《本次 Agent 工作报告》。
报告内容包括：
数据全部来自本机会话日志。插件不联网，不需要 API key，不修改任何会话数据。
两种安装方式，二选一。不要都用，否则插件会被加载两次。
桌面版的 profile 由应用自己管理，命令行改不了，请用应用内的插件管理器：
github:Neo65536-engineer/dsh-agent-logdsh plugin --profile web add github:Neo65536-engineer/dsh-agent-log
--profile 是必填的，要写你实际在跑的那个 profile（dsh web 一般是 web）。不填会报
required option '--profile <name>' not specified。
命令会自动把插件加进 profile 的组合，几秒后生效，不需要重启。
新开一个对话，让模型执行：
用 work_report 复盘一下这次任务
能出报告就是装好了。也可以在右侧边栏的「+」里找「Agent 工作报告」页签。
安装插件不需要重启 DSH。改动插件源码之后才需要重启。
work_report({}) // 复盘当前会话
work_report({ turns: 3 }) // 只看最近 3 轮
work_report({ sessionId: "session-2e667305" }) // 指定会话（可只给前几位）
work_report({ format: "json" }) // 返回结构化数据
work_report({ out: "reports/task.md" }) // 同时写入文件
work_report({ format: "html", out: "报告.html" }) // 生成可打印的 HTML
out 用相对路径时，按这次会话的工作目录解析。
右侧边栏「+」→「Agent 工作报告」。7 个页签：总览、工具、命令、文件、测试、失败、轮次。
工具条上是刷新、自动刷新、下载 HTML、下载 Markdown、会话选择器。下载的 HTML 是自包含文件， 可以直接打开或打印成 PDF。
面板默认显示它自己所属的那个会话。
在仓库目录下执行：
node bin/worklog.mjs --list # 列出所有会话
node bin/worklog.mjs --latest # 最近一个会话的报告
node bin/worklog.mjs <sessionId> # 指定会话
node bin/worklog.mjs <sessionId> --out r.md # 写入文件
node bin/worklog.mjs <sessionId> --json # 输出 JSON
日报和周报（把多个会话按时间聚合）：
node bin/worklog.mjs --period --since today
node bin/worklog.mjs --period --since 7d
node bin/worklog.mjs --period --since week
node bin/worklog.mjs --period --since 30d --out 月报.md
node bin/worklog.mjs --period --since 2026-09-20 --until 2026-09-25
--since / --until 可以用 today、yesterday、week、7d、30d 或 YYYY-MM-DD。
CLI 按 $DSH_HOME → ~/.dsh 的顺序找会话日志，也可以用 --home <目录> 指定。
GET /plugins/dsh-agent-log/report?format=json&sessionId=...&turns=N
GET /plugins/dsh-agent-log/report?format=markdown
GET /plugins/dsh-agent-log/report?format=html
GET /plugins/dsh-agent-log/report?list=1
这条路由挂在 DSH 的 web server 上，和其它接口一样需要认证，未认证请求返回 403。
9（通过 4 / 失败 1 / 未判定 4）），不会把「未判定」吞掉让数字对不上。… | Select-Object -First N 会因为 broken pipe 非 0 退出。这类计入「疑似失败」，
单独列出，不计入失败总数。format: "json" 取，或看侧边栏面板。| 项 | 值 |
|---|---|
| 网络 | 不使用，不发任何数据 |
| API key / 凭据 | 不需要 |
| 读取 | $DSH_HOME/sessions、$DSH_HOME/storages/session_projcache |
| 写入 | 只有显式传 out 时才写你指定的那个文件；不写会话数据 |
| 索引 / 缓存文件 | 不建；只有进程内存里 12 份日志的缓存 |
会话日志里是完整的对话内容，所以导出的 HTML / Markdown 报告也包含这些内容，分享前自己确认一下。
装了，但工具和面板都没有。 确认桌面版点过「立即启用」——只安装不启用的话插件不会加载。然后刷新页面。再确认没有同时用 两种方式安装。
面板顶部有黄色提示「宿主加载的是旧版插件模块」。 这是改过插件源码之后的状态。Node 的 ESM 模块一旦加载就缓存住，HMR 只处理 Loader 条目的增删， 不会重新加载改过的宿主模块。重启 DSH 即可。只安装、不改代码的话不会出现。
面板里「工具」「命令」「文件」是空的，但「总览」正常。 同上：客户端已经是新的，宿主还是旧的。重启 DSH。
报告里的数字和预期不一样。
检查是否用了 turns 参数——用了之后总览会按截断后的轮次重算，报告开头也会写明
「本报告只统计最近 N 轮」。另外看总览下面的疑似失败说明。
复盘到的是别的会话。
只在没指定 sessionId、且插件拿不到调用方身份时发生，报告里会标注。显式传 sessionId 即可。
报告太长。
明细表默认截到 80 行。要完整数据用 format: "json"，或者看侧边栏面板（面板读的是完整数据）。
dsh web）实测可用npm install，不需要构建升级 DSH 后可以用这两条确认插件还正常：
node bin/verify-loaded.mjs # 确认 work_report 在工具列表里
node bin/verify-compose.mjs # 确认插件还在 profile 的组合树里
dsh plugin --profile <你的 profile> remove dsh-agent-lognode bin/install.mjs --rollback（回滚到安装前的状态）MIT