前言¶
在 DSH 里开过很多会话之后，「今天做了什么、归属哪个目标、还有哪些没做完」往往要靠人翻历史或凭记忆拼凑。人工写日报、周报也费时，还容易漏掉待办或交付物链接。dsh-ai-journal 面向在 DSH Web 里日常工作的开发者：它只读取本机 DSH 会话日志，在左侧栏提供「AI 日报」面板，按目标分块汇总行动、结果与未完成事项，并附带图形化摘要；数据不联网、不上传。
这是什么¶
dsh-ai-journal 是维护者 vc1235-ui 发布的 DSH Web 客户端插件（分类：客户端）。npm 包名 dsh-ai-journal，当前资料中版本为 0.1.2，许可证 MIT。它依赖 DSH >=0.2.1-rc.5，使用核心服务 sessionController / sessionQuery 等，不依赖其它第三方插件。
目录页：https://www.skillhub.cn/plugins/vc1235-ui/dsh-ai-journal
源码：https://github.com/vc1235-ui/dsh-ai-journal
核心功能¶
下面介绍面板里已文档化的能力，数字与条目均由程序从会话事件统计，结果为空时不编造内容。
概览与图表¶
- 概览：KPI 包括会话、轮次、我的输入、工具调用、交付物、完成待办，并显示范围、时区、更新时间。
- 图形化摘要：待办完成率环、目标/项目分布堆叠条；周报另有 7 天轮次柱状图（hover 显示数值）。
- 日报 / 周报切换，日期前后翻页，支持手动刷新。
按目标分块¶
没有目标的会话按项目（工作目录）归组。每块包含：
- 行动：窗口内人类输入摘要，按时间排序。
- 结果：完成项、交付物（可点击，经宿主
POST /api/present.open在桌面打开原文件）、已完成的待办。 - 待办：该块内
pending与in_progress的待办，以及进行中/受阻的目标；每条可「新开对话」，预填针对性提示词。
待跟进（启发式，可选）¶
从窗口内人类输入中，按固定措辞（如「后续再聊」「待回复」「待确认」等）识别可能被口头遗留的事项，单独成区并标注可能不准确。每条可「新开对话」，或点「这不是待办」忽略（可撤销）；忽略记录是唯一会落盘的数据。
统计口径（摘录）¶
- 窗口：日报 = 请求时区当天
00:00起；周报 = 当周周一00:00起，共 7 天。 - 归属目标：会话最新
goal/change的 objective；无目标则按项目归组。 - 未完成：会话最新
todo/write里的pending/in_progress，以及active/blocked的目标。 - 交付物：来自事件
deliverables/presented。 - 自动触发会话（标题/输入带自动触发标记，或 cwd 在
~/.dsh/migrated-cron/、~/.dsh/bot/）整体不计入，含「待跟进」。
安装与启用¶
需要 DSH Web（README 中验证版本为 0.2.1-rc.5）与可用的会话查询服务。插件以当前 DSH 进程权限运行，安装前建议通读仓库源码与 MIT 许可证。
# 从 npm（推荐，发布后可用）
dsh plugin --profile web add dsh-ai-journal
# 或直接从 GitHub 安装
dsh plugin --profile web add https://github.com/vc1235-ui/dsh-ai-journal
# 或本地路径
dsh plugin --profile web add /path/to/dsh-ai-journal
安装后在 DSH 中启用插件并重启（或等待 HMR 生效），左侧栏会出现「AI 日报」入口。缺会话服务时接口返回 503，面板显示中文提示，不会崩溃。
典型用法¶
- 在 DSH Web 中启用
dsh-ai-journal后，从左侧栏打开「AI 日报」。 - 在面板顶部选择 日报 或 周报，用日期控件前后翻页，必要时点刷新。
- 在「按目标分块」中查看行动与结果；对待办或受阻目标使用「新开对话」继续推进。
- 在「待跟进」中核对启发式条目；误报可点「这不是待办」，记录写入
$DSH_HOME/ai-journal/followups-dismissed.json（最多 5000 条）。 - 点击结果中的交付物链接，在桌面打开对应文件（依赖 DSH Web 内置的
/api/present.open）。
隐私、安全与适用场景¶
- 会话内容仅在内存聚合，不落盘、不联网、不上传；Host 接口经宿主认证（未登录 401、跨站 403），会话查询失败时 fail closed。
- 适合需要本机闭环复盘日/周工作的 DSH 用户；不适合需要把日志上传到云端再汇总的场景。
- 待跟进为启发式识别，界面已说明可能不准确；定时任务 / 机器人会话按规则排除，避免污染统计。
经过上面的步骤，你可以在不上传任何会话的前提下，用同一套 DSH 日志驱动日报面板与桌面交付物打开。
延伸阅读¶
- 插件目录：https://www.skillhub.cn/plugins/vc1235-ui/dsh-ai-journal
- GitHub：https://github.com/vc1235-ui/dsh-ai-journal
- npm：https://www.npmjs.com/package/dsh-ai-journal
- 开放插件市场（dshopen.org）：https://dshopen.org/plugins/dsh-ai-journal
社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，本文事实均来自上述仓库 README 与 package.json。
