碎片时间提醒zhaozixi/dsh-attention

dsh-attention

简体中文 · English

在 DeepSeek Harness 执行长时间任务（目标循环、后台任务、Agent 推理、任务看板执行）期间，主动提醒你利用碎片时间进行微活动，解决「任务进行中只能干等」的低效问题。

它解决什么问题

DSH 跑任务时你通常只能盯着进度条。dsh-attention 把这段等待变成有产出的碎片时间：任务一运行，5 秒后浮窗弹出，给你一条 30 秒–3 分钟的微活动建议；点「已完成」立即出下一条，任务结束自动收起并生成碎片利用报告。

功能

- 多信号源任务监控 — agent/status（主会话对话、子代理、task-board 执行会话全覆盖）、goal 轮次、后台任务（jobs）、任务看板状态轮询，统一检测任务开始/结束。
- 重启恢复 — host 重启后自动补种恢复运行中的任务窗口，重启前在跑的任务重启后继续提醒。
- 提醒引擎 — 按可配置节奏推送活动建议（默认 5 分钟）；「已完成」立即推进下一条；任务结束生成碎片利用报告。
- 内置活动库 — 43 条预设微活动，四大类随机分配（每个新任务会话重新洗牌），同一会话内不重复。
- 活动池编辑器 — 左侧栏「注意力」入口弹出编辑面板，四个分类可增删改活动，右下角保存/取消，持久化到 profile。
- 全局置顶浮窗 — z-index 最大 + React Portal 挂 body，盖过一切弹窗；显示运行时长、建议数、下次提醒倒计时。

它是怎么工作的

任务信号（agent 状态 / goal / 后台任务 / 任务看板）→ TaskMonitor 归一化为 task-start/task-end → ReminderEngine 按节奏发建议（可配自定义活动表）→ 浏览器浮动面板 3 秒轮询展示；点「已完成」走 POST /api/attention/advance 立即出下一条。

快速开始

安装（npm）

dsh plugin --profile web add @zhaozixi/dsh-attention@latest

首次安装如遇 pnpm 拦截构建脚本，在 profile 目录执行 pnpm approve-builds --all 后重试。

安装后重启 DSH（host 半加载）并硬刷新浏览器（client 半生效）。左侧栏「新会话」下方出现 ⭐「注意力」入口。

本地源码开发（link）

dsh plugin --profile web add link:../packages/dsh-attention

配置

在 profile 的 cordis.patch.yml 中覆盖 attention 行：

- id: attention
config:
enabled: true
remindIntervalMs: 300000      # 提醒间隔（点「已完成」可立即推进，不等此间隔）
firstReminderDelayMs: 5000    # 任务开始后首条提醒延迟
categories:                   # 活动类别池
- micro-movement
- mind-refresh
- micro-learning
- quick-organize
maxActivitiesPerSession: 6    # 每会话建议上限

卸载

dsh plugin --profile web remove @zhaozixi/dsh-attention

卸载后：

1. 重启 DSH（host 半卸载，侧边栏「注意力」入口与浮动面板消失）。
2. 硬刷新浏览器（client 半清理）。
3. 可选清理：删除自定义活动池持久化文件 ~/.dsh/profiles/web/attention-activities.json（不删则残留一份 JSON，无副作用；删则恢复默认 43 条预设活动）。

注意：如果当初是用 link: 本地路径安装的，请用对应路径卸载：dsh plugin --profile web remove link:。

自定义活动池

1. 点击左侧栏「注意力」入口（新会话下方）。
2. 面板按四个分类列出活动，每行可编辑标题、指引文案，可删除；每区底部「+ 添加活动」。
3. 右下角「保存」持久化到 ~/.dsh/profiles/web/attention-activities.json（随 profile 携带），引擎立即按新表轮询；「取消」丢弃改动。

HTTP API

| 端点 | 方法 | 用途 |
|---|---|---|
| /api/attention/state | GET | 面板状态快照（busy / 运行时长 / 下次提醒 / 最后建议） |
| /api/attention/snooze | POST | 暂停当前提醒节奏 |
| /api/attention/resume | POST | 恢复提醒节奏 |
| /api/attention/advance | POST | 立即推进到下一个活动（「已完成」） |
| /api/attention/activities | GET / POST | 读取 / 保存活动池（含自定义） |

目录结构

dsh-attention/
├── package.json            # dsh.bundle + dsh.client 声明
├── cordis.patch.yml        # profile 补丁：注册 attention 行
├── assets/readme/          # README 视觉资源（hero / workflow SVG）
└── lib/
├── index.js            # Host Service 入口（监控 + 引擎 + HTTP + 活动池持久化）
├── monitor.js          # 任务状态监控（agent/status + goal + jobs + task-board + 重启 seed）
├── reminder-engine.js  # 提醒引擎（调度 + 随机活动池 + 自定义活动表）
├── activities.js       # 内置活动库（43 条预设）
├── client.js           # 浏览器端：浮动面板 + 侧边栏入口 + 活动池编辑器
└── invariant.js        # 断言辅助

常见问题

| 现象 | 原因与解决 |
|---|---|
| 任务运行但无提醒 | 确认已重启 DSH（host 半改动需重启）+ 硬刷新浏览器；检查 /api/attention/state 的 busy 是否为 true |
| 无任务但提醒仍显示 | 运行中会话被关闭/删除时旧窗口残留——已通过 agent/disposed 监听修复；如仍出现请升级到最新版本 |
| 重启后不提醒进行中的任务 | 旧版本无 seed 恢复；升级后 agent/status 与 goal 均支持重启补种 |
| 活动池编辑不生效 | 保存走 POST /api/attention/activities 持久化；确认保存后引擎 poolSize 变化 |

安全说明

- 权限最小化：插件只读 DSH 的事件总线与任务状态（agent/status、goal、jobs、task-board），仅在有任务运行时调度本地定时器；不访问网络，不读取工作区文件内容，不执行任意命令。
- HTTP 面：/api/attention/* 接口仅供本机 DSH Web 界面调用（监听 127.0.0.1），不对外开放端口；它们只改变提醒节奏与活动池数据，不触碰会话内容。
- 本地持久化：自定义活动池写入 ~/.dsh/profiles/web/attention-activities.json（随 profile），不含任何凭据或会话数据；插件不会上传任何信息。
- 无隐藏行为：所有代码均为可读的普通 JavaScript（无混淆）；安装只注册 cordis 插件行，不执行额外的安装脚本。
- node-pty 说明：插件依赖链中的 node-pty 由 DSH 核心共用，构建脚本放行（pnpm approve-builds --all）是标准操作，插件自身不引入额外原生模块。
- 降级行为：task-board 未安装时，其信号轮询静默跳过；goal / jobs 服务缺失时对应信号源自动跳过——插件在最小配置下仍可工作，不会因依赖缺失而报错。

贡献

本项目是开源软件（MIT License），欢迎任何人参与：

1. Fork 本仓库到你的账号
2. 基于 main 分支创建你的特性分支（git checkout -b feat/xxx）
3. 提交改动后发起 Pull Request 到 main

改动建议附带说明（修复的问题 / 新增功能 / 影响范围）。涉及活动池或提醒节奏的改动，请同步更新 README 与测试说明。

License

MIT