dsh-quiet-hours

给微信机器人加一个「静音时段（quiet hours）」：到点闭嘴，有人来找只回一句话。

插件 ID dsh-quiet-hours，名字取自手机系统的「quiet hours / 免打扰时段」—— 在设定好的时段里，这个微信机器人只负责一句固定回复，其余交给时间。

DeepSeek Harness 插件。挂在 WeChatAgent 的微信会话上， 在工作日的指定时段里一次模型都不调用，来消息时用固定文案自动应答；时段外自动恢复成人格对话， 不改人格、不清会话、不动聊天记录。

工作日 09:00 ─────────── 12:00     14:00 ─────────── 18:00
        免打扰：只回固定文案              免打扰：只回固定文案
        （不调用模型）                     （不调用模型）

特性

• 时段可配：默认工作日 09:00–12:00、14:00–18:00（Asia/Shanghai），支持节假日、调休、任意时区；
• 真·AI 停答：在 agent/pre-step 直接拒绝这一步，模型不参与，不产生 token；
• 固定文案直发：通过 WeChatAgent 原生 hook 的 POST /SendTextMsg 发出，不经模型；
• 私聊全回，群里只在被 @/点名时回（可按群改为 always / never）；
• 限流兜底：每会话冷却（默认 180 秒）+ 每小时上限（默认 12 条），防刷屏、防重试重复发；
• 手动控制：quiet_hours_status / quiet_hours_control 两个工具，可临时强制开关；
• 失败安全：插件内部任何异常都会放行原流程；固定文案发不出去时默认仍然拦住 AI（可切回 fallbackToAgent）。

为什么不是「到点停掉 WeChatAgent」

做法	结果
停掉 WeChatAgent 后台服务（reader / bridge / adapter）	消息没人读，插件也不知道“有人发消息”，固定回复无从触发；还会连带停掉表情、记忆、上下文维护
保留消息链路，只让 AI 不上场（本插件）	消息照常接收、会话照常落库；模型这一步被跳过，固定文案由插件直发

工作原理

微信 ──► WeChatAgent reader ──► adapter ──► bridge ──► DSH plugin (11230)
                                                          │
                                              agent/pre-step（本插件在这里）
                                                          │
                              ┌───────────────────────────┴───────────────┐
                              │ 时段外 / 非微信会话：next()，一切照旧        │
                              │ 时段内：发固定文案 + return {kind:'reject'} │
                              └───────────────────────────┬───────────────┘
                                                          │
                                        hook /SendTextMsg ─┴─► 微信

1. DSH 为每个微信会话建一个 session，桥接插件把新消息送进 agent/pre-step；
2. 插件用 state/accounts/*/dsh-sessions.json 把 session id 反查回 wechat:private|group:<id>， 再用会话标题（微信私聊｜… / 微信群聊｜…）兜底；
3. 会话必须在 WeChatAgent 的 whitelist 里，否则不拦；
4. 时段内：解析正文判断要不要回（群聊看有没有 @/唤醒词）→ 冷却检查 → 解析真实 wxid → POST /SendTextMsg → 返回 { kind: 'reject' }，这一轮不会进模型；
5. 时段外完全没有副作用。

已知边界：被拒绝的消息不会进入 AI 的会话历史；固定文案也不写进 AI 的对话记录。 时段恢复后，AI 不知道自己在免打扰期间回过这句话。

兼容性

组件	版本
DeepSeek Harness	0.2.0-rc.2（实测）
WeChatAgent	0.3.9（实测）
微信 + 原生 hook	4.1.10.27
Node.js	>= 20（用到 AbortSignal.any、原生 fetch）

• WeChatAgent 是第三方 Windows 程序，本插件只读它的配置/状态，并且只调用它本机的 hook 接口，不修改它的任何文件；
• 插件本身零依赖，只用 Node 内置模块；
• 没有 WeChatAgent 的环境也能安装和跑单测，只是没有实际效果。

安装

一键安装（已收录市场后）

• DSH Desktop：设置 → 插件市场 → 搜 quiet hours → 安装；
• 命令行 / web profile：dsh plugin --profile web add github:rnfmabjE/dsh-quiet-hours （安装成功后会自动把包名写进 dsh.profile.bundles）。

桌面版的 desktop profile 由应用独占，命令行执行 dsh plugin --profile desktop … 会报 profile "desktop" is managed exclusively by the Electron application，请用应用内安装。

收录状态与提交方法见 docs/marketplace.md。

手动安装

完整步骤（含前置检查、profile 覆盖层配置、真机验收、升级/卸载）见 docs/deploy.md。最短路径：

# 1) 取代码，放到长期不变的目录
git clone https://github.com/rnfmabjE/dsh-quiet-hours.git D:\tools\dsh-quiet-hours

# 2) 链接进 DSH profile（也可以改用 plugin_manager 的 install_bundle）
New-Item -ItemType Junction `
  -Path  "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-quiet-hours" `
  -Target "D:\tools\dsh-quiet-hours"

1. 把 "dsh-quiet-hours" 加进 profile package.json 的 dsh.profile.bundles；
2. 改 cordis.patch.yml 里的 reply（文案）、accountNames（群里昵称）、windows（作息）；
3. 从托盘完全退出 DSH 再打开（宿主插件只在启动时加载）。

前置要求：Node.js ≥ 20；DSH 0.2.0-rc.2；WeChatAgent 0.3.9 已跑通收发 （reader 5031、hook 30001、bridge 11229、DSH 桥接插件 11230）。

验证安装

在桌面 DSH 会话里问一句「静音时段现在什么状态」，会调用 quiet_hours_status， 返回里应看到 probe.reader=true、probe.hook=true。

不依赖 DSH 的自检：

node check.mjs               # reader / hook / 会话映射
node check.mjs --send-test   # 额外给「文件传输助手」发一条测试文字（发给自己）

配置

配置写在仓库的 cordis.patch.yml 里（安装后位于 profile 的 node_modules/dsh-quiet-hours/）。 改完重启 DSH 生效。

字段	类型	默认	说明
projectRoot	string	$WECHAT_AGENT_ROOT 或 D:/WeChat Agent/data/workspace	WeChatAgent 数据目录
enabled	boolean	true	总开关；false 时插件完全不动作
timeZone	string	Asia/Shanghai	作息使用的 IANA 时区
windows	array	工作日 09–12、14–18	每项 { days, start, end }，days 用 1=周一 … 7=周日；左闭右开
reply	string	见下方「改固定文案」	固定文案，≤300 字，换行会被压成空格
replyByChat	object	{}	按会话覆盖文案，如 {"wechat:private:123": "…"}
groupReply	wake/always/never	wake	群聊策略：被 @ 才回 / 都回 / 不回
accountNames	string[]	[]	本账号在群里的昵称，用于判断是否被 @
groupWakeAnyMention	boolean	false	没配昵称时，是否把“任意 @”都当成叫自己
replyCooldownSeconds	number	180	同一会话两次固定回复的最小间隔
maxRepliesPerChatPerHour	number	12	同一会话每小时最多几条
holidays	string[]	[]	不上班的日期，如 ['2026-10-01']
extraWorkdays	string[]	[]	调休上班的周末，如 ['2026-10-11']
fallbackToAgent	boolean	false	固定文案发不出去时，是否放行让 AI 回
log	boolean	true	是否往 DSH 日志写诊断信息

完整示例见 examples/cordis.patch.yml。

改固定文案

仓库默认文案就是：

梁文峰不是我兄弟，梁文谷才是

它在 cordis.patch.yml 的 reply 字段里，改这一行就能换：

- insert:
    - id: quiet-hours
      name: dsh-quiet-hours
      config:
        reply: '梁文峰不是我兄弟，梁文谷才是'

改完：

1. 保存 cordis.patch.yml；
2. 从托盘完全退出 DSH 再打开（宿主插件与配置在启动时读取）；
3. 用 quiet_hours_status 确认 config.reply 已经是新文案。

补充说明：

• 只想改某一个会话：不动 reply，加 replyByChat，键是会话 key，值是文案：

  replyByChat:
    wechat:private:1000000001: '在忙，晚点回你。'
    wechat:group:2000000002: '上班中，被 @ 才回。'
  

• 代码里的兜底在 index.js 的 DEFAULTS.reply（和仓库默认一致），只有配置里完全没写 reply 时才生效； 改它不如改 cordis.patch.yml，因为配置里的值优先。

• 文案会被压成单行（连续空白合成一个空格）并截断到 300 字，不支持多行/分段。

• 文案里不要放 RESPOND:、SILENT、[STICKER:x] 这类协议标记——它不经过模型，但会被 WeChatAgent 当成回复正文。

群聊怎么算“叫我”

默认 groupReply: wake，命中任意一条才回：

• 正文里出现 accountNames / wake_words / account.nicknames 中的任意一个名字（微信的 @ 会以 @昵称 出现在正文里）；
• 或者 groupWakeAnyMention: true 时，任意 @某人 都算。

名字都没配时，群里默认不会自动回复。建议先在 WeChatAgent 的 config/wechatagent.json 里确认本账号在群里的昵称，填进 accountNames。

手动控制

桌面 DSH 会话里可以直接让模型调用：

调用	作用
quiet_hours_status()	当前模式、下一段作息、固定文案、最近拦截/发送记录、reader/hook 是否在线
quiet_hours_control({action:'on', minutes:60})	强制进入免打扰（临时测试用）
quiet_hours_control({action:'off', minutes:60})	强制恢复 AI
quiet_hours_control({action:'auto'})	清除强制，回到作息表

等价的状态文件是 state/away/override.json：

{ "mode": "away", "until": 1792730400000 }

mode 只认 away / open / auto，until 是毫秒时间戳（省略或过期即失效）。

这两个工具不会出现在微信会话里（WeChatAgent 的 dshAccess 没有授权它们），只有在桌面端才能调用。

排错

现象	先看哪
状态显示 mode=away，但没人收到固定文案	state/away/audit.jsonl 里 action=failed 的 error；再确认 hook 的 /SendTextMsg 返回 ret=0
群里被 @ 也不回	accountNames 是否包含群昵称；或临时打开 groupWakeAnyMention
一条消息回了好几条	replyCooldownSeconds 是否被改成 0；同一会话是否真的连发
到点没切过去	quiet_hours_status 的 nextChangeAt；DSH 进程时区/timeZone 配置
想立刻停掉	enabled: false 后重启 DSH，或 quiet_hours_control({action:'off'})

更多见 docs/troubleshooting.md。

开发

npm test     # 作息 / 闸门 / 限流 / 接线，35 项
npm run check

• test/smoke.mjs：纯逻辑单测（时区、窗口边界、群聊唤醒、限流）；
• test/wiring.mjs：假 ctx 直接触发 agent/pre-step，验证拦截/放行分支，不连微信、不发消息；
• CI：.github/workflows/ci.yml，Node 20 / 22 跑 npm test；
• 发版：推 v* tag 会先跑测试，再打包 zip 并上传到 GitHub Release（.github/workflows/release.yml）。

代码结构：

index.js            插件入口：配置、agent/pre-step 闸门、两个工具、状态心跳
lib/schedule.mjs    作息与“下次切换”计算
lib/gate.mjs        纯判定：open / silent / reply
lib/wechat.mjs      reader / hook / 会话映射 / 发送
lib/state.mjs       审计、限流、override 文件

隐私与安全

• 插件只访问 127.0.0.1 上的 reader（5031）和 hook（30001），不向任何外部地址发请求；
• 读取的都是本机 WeChatAgent 自己的配置与令牌（state/wechat-io-config.json、state/hook/native-token.txt）；
• 固定文案由本机直接发出，不经过模型服务；
• 仓库不含任何账号、会话、聊天记录或密钥；运行时状态写在 WeChatAgent 的 state/away/，已被 .gitignore 排除。

第三方依赖与声明

本仓库以 MIT 发布，只覆盖本仓库的代码与文档：

• 需要本机已安装并运行 WeChatAgent（第三方 Windows 项目，作者 Derpyu520， 来源 https://github.com/sourcepro5/WeChatAgent，其分发自带 MIT 许可）。 本仓库不包含、也不重新分发它的源码、安装包、原生 DLL 或运行环境；两者无隶属或背书关系；
• 不包含微信客户端或原生 hook；非官方自动化可能违反平台条款并带来账号风险；
• 本插件运行在 DeepSeek Harness 之上，DSH 与模型服务受其自身许可与条款约束；
• 运行时只用 Node.js 内置模块，没有 npm 依赖。

完整说明（含 WeChatAgent 许可与版权行、微信平台提示、商标与致谢）见 THIRD-PARTY-NOTICES.md。

目录

.
├─ .github/workflows/ci.yml
├─ cordis.patch.yml         bundle patch（配置入口）
├─ index.js
├─ lib/
├─ locale/                  插件标题/说明（中英）
├─ icon.svg
├─ check.mjs                现场自检
├─ test/
├─ docs/
├─ examples/
├─ CHANGELOG.md
├─ CONTRIBUTING.md
├─ SECURITY.md
├─ THIRD-PARTY-NOTICES.md   第三方依赖与许可
└─ LICENSE

License

MIT