peikuo/dayreel

dayreel

DeepSeek Harness (dsh) 社区插件：把你一天流经 dsh 的工作轨迹，做成一份设计感日报 + 一段带旁白的总结视频。全 TypeScript/Node 栈，无 Python 依赖。

dsh plugin add github:peikuo/dayreel

装好后在 Web UI 里说「生成今天的日报」即可，详细步骤见安装。按 Harness 的组合包(bundle)规范分发（dsh plugin add github:peikuo/dayreel# 可锁定版本）。

组成

- 两个 runtime skill：
- dayreel-content：调工具收集跨会话事实，写内容文档（工作主线 IR + 当日元数据），并从中确定性渲染出 HTML/Markdown 日报
- dayreel-render：把内容文档确定性投影成 typed 场景，渲染成 mp4，并持续播报进度
- 模型工具：
- 读日志：fetch_today_recap（跨 workspace 当日会话摘要，含按各会话实际模型的费用估算）、fetch_session_detail（单会话按日钻取）
- 产出：dayreel_report（日报 HTML+MD，支持 force 修订重生成）、dayreel_render（异步启动视频渲染）、dayreel_status（轮询进度，完成后返回可播放 URL）

数据来源分两层：默认读折叠表层（compaction 后的会话摘要，便宜）；当摘要缺细节时按需钻取单会话。会话摘要方案只覆盖今天与昨天——更早的日期属于日志深挖（Tier 2：时间切片→子代理生成 IR→汇总），数据量和成本都很大，未实现；请求更早的日期会被工具直接拒绝。渲染产物通过同一 webServer 以 /dayreel/ 路由提供（Range 支持，可拖动进度条）。

GUI 内嵌播放器：客户端半区（随本 bundle 一起加载）为 dayreel_status 工具注册了内嵌  播放器卡片，渲染完成后视频直接出现在工具调用行里，无需复制 URL。

安装(bundle 方式)

本地路径安装(add 时 pnpm 会运行 prepare，构建 lib/)
dsh plugin --profile demo add ./dayreel

从 GitHub 安装(需要构建授权，见下)
dsh plugin --profile demo add github:peikuo/dayreel

首次使用会初始化 profile（@deepseek-ai/dsh-base 作为第一个组合包）。验证层再启动：

dsh --profile demo --dump-config   # 应看到 "# == dayreel" 层
dsh --profile demo

从 GitHub 安装的构建授权

git 安装拉取的是源码，pnpm ≥10 默认拒绝运行 prepare。第一次 add 失败时，把 pnpm 打印的包键加进该 profile 的 pnpm-workspace.yaml：

allowBuilds:
dayreel: true

然后重新 add。只对源码可信的包授权，并锁定 commit（github:peikuo/dayreel#）。

省成本：生成模型选路与记忆

日报的撰写/渲染不需要旗舰模型。dayreel_author 工具由插件执行选路（不依赖模型自觉），菜单就是你环境里配置的 LLM 目录——运行时经 ctx.llm 枚举（listProviders × listModels，与 Web 模型选择器同源），dayreel 不维护任何路由副本，你增删模型无需改插件配置。插件侧只有两个引用型可选项：

- id: dayreel
name: dayreel
config:
fork: true                       # 可选：用 fork 后端(继承当前对话上下文)；默认 spawn
defaultModel: deepseek-v4-flash  # 可选：model id 或 provider/model，排菜单首位+无交互时兜底

选路规则：用户口头点名 → agent 参数（模型 id 或 provider/model，支持唯一前缀）直接路由；有记住的偏好 → 直接用，零打断；目录里只有一个模型 → 直接用，零打断；否则弹窗两问（选哪个模型 + 是否记住）。选"记住"后偏好写在插件输出目录的 preferences.json（存 {provider, model} 对；删掉该文件即遗忘）。headless/无交互服务时不弹窗，直接用 defaultModel（缺省用目录第一项）并在结果里注明。目录里已不存在的过期偏好会被忽略并重新询问。

fork: true 时子代理继承当前对话的完整历史（截至上一个完整 turn）；spawn 则靠任务内嵌指引 + 自己调 fetch_today_recap 收集。两种 in-process 子代理共享本进程组合，都能调用 dayreel 的读取工具。注意：跨模型前缀缓存不会命中，fork 重放历史按目标模型空闲价计费；外部 CLI 子代理（codex 等）调不了这些工具，不做生成后端。GLM 等 OpenAI 兼容路由按 llm-pi-ai 的接法配好后会自动出现在菜单里。

使用

在 GUI 里对模型说：「生成今天的总结视频」。预期流程：

1. 模型加载 dayreel-content skill → 调 fetch_today_recap 拿跨会话当日摘要（当前对话自动排除）→ 需要细节时按需 fetch_session_detail → 写内容文档 → dayreel_report 出日报（修订/换风格传 force: true）
2. 用户要看视频 → 模型加载 dayreel-render skill → dayreel_render（插件把内容文档确定性投影成场景）
3. 模型循环调用 dayreel_status 播报进度(旁白 i/n → Remotion %),直到完成
4. 完成后模型给出可播放 URL(http://127.0.0.1:/dayreel///recap.mp4)和本地路径
5. 用户看完后的反馈(对话中回复)会被插件被动记录到 output/feedback/.jsonl,并据此进入修订模式(force: true 重生成)

依赖

| 依赖 | 用途 | 说明 |
|---|---|---|
| msedge-tts | 旁白 TTS(纯 Node,微软 Edge 语音,免费免 key) | 包自带依赖,pnpm install |
| Remotion + ffmpeg | 渲染视频 | cd remotion && pnpm install(ffmpeg 需在 PATH) |

assets/bgm/ 的背景音乐由 AI(Gemini)生成,项目持有使用与分发权利,随 bundle 一并提供。

remotion/ 渲染子项目的依赖不会随 bundle 安装;在已安装的 checkout 里首次渲染前,需手动 cd remotion && pnpm install。

开发

pnpm install        # 安装构建依赖(esbuild)
pnpm run build      # esbuild 打包 src/ → lib/index.js(prepare 也会做)

快速迭代可直接用 --patch 加载 TS 入口(harness 源码环境支持):

pnpm dsh web --patch /abs/path/to/dayreel/src/index.ts

演示(占位数据)

不读任何真实会话,用一份显式标注「演示占位」的示例内容文档走完渲染链路(铁律 1/1.5:演示数据必须标注,不得冒充真实日报):

pnpm run build
pnpm demo                 # 三套版式日报各出一份,打印路径
pnpm demo report newspaper # 单出指定版式
pnpm demo video            # 渲染演示视频(需 cd remotion && pnpm install,ffmpeg 在 PATH;TTS 走网络)

示例文档在 src/demo-doc.ts:标题与摘要带【演示占位】标注,日期固定 2000-01-01(产物与真实日报天然分目录),test/demo-doc.spec.ts 守卫标注不被移除。

输出示例

产物根目录:已安装进 DSH profile 时为 $DSH_HOME/dayreel/(dsh 启动时设置该环境变量);源码 checkout / 演示运行为包内 output/(gitignored,已设 DSH_HOME 时除外):

output/
2026-08-17/
01/
progress.json         ← dayreel_status 轮询的进度文件
audio/scene-0.mp3     ← 每段旁白的 TTS 音频
props.json            ← Remotion 渲染参数
recap.mp4             ← 成品视频(经 /dayreel/ 提供)