峰谷轻示 linglanxin/dsh-feng-gu-lite

dsh-feng-gu-lite

极简、离线的 DeepSeek Harness 会话输入框下方指示器。正常仅显示 梁文峰（警示图标、暖色）或 梁文谷（弱化色），日历歧义/缺口在可能峰窗口显示 时段待确认（不提醒）；高峰进入和高峰中打开/切换会话时，在窗口顶部显示同名、非阻塞短暂提醒。无声音，无点击，无输入/发送拦截；定时刷新不重复提醒。呼吸仅约 2.7 秒，prefers-reduced-motion: reduce 完全关闭动画，静态提醒仍短暂显示。

状态与日历

规则来源：DeepSeek 官方定价页。北京时间周一至周五（不含中国法定节假日）09:00–12:00、14:00–18:00为高峰，其余含周末全天空闲。显示计算使用 09:00,12:00) 与 [14:00,18:00) 半开区间；这是本插件边界约定，不是实际账单保证。调休上班周末仍依据官方“周一至周五”判为空闲。

src/calendar.js 提供离线注入数据：years 明确声明完整覆盖年份，holidays 日期字符串集合，uncertain 为已知歧义日期，source 记录证据。createCalendar(data) 将输入复制成独立集合；periodAt(timestamp, calendar) 接受此接口。不得把未覆盖年份当成无节假日。未覆盖年份/歧义日如果处于工作日可能峰窗口，返回 unknown，仅显示“时段待确认”，不显示误导性的峰或谷，也不提醒；周末和非峰窗口仍可确定为空闲。没有联网回退，也不在用户 UI 显示日历/规则/来源。

当前离线数据仅覆盖 2026。法定本日13天依据[国务院令第795号《全国年节及纪念日放假办法》，完整放假安排依据国务院办公厅2026年通知。春节本日为除夕与正月初一至初三（2026-02-16至19），端午五月初五为06-19，中秋八月十五为09-25；已用 Node Intl 中国农历独立检查映射。放假区间中非法定本日的平日（01-02、02-20、02-23、04-06、05-04、05-05、10-05至07）按用户确认视为歧义：高峰窗口显示“时段待确认”，并非自行认定谷。法定本日为谷，周末不论调休均谷。DeepSeek定价页未定义调休放假与法定本日的细分，故保留不确定性而非承诺账单。未来年份必须人工核实后添加。

构建与自检

无需安装依赖。Node.js 18+（本机执行 Node.js v24.19.0）：

node scripts/build.mjs
node --check lib/client.js
node --test

src/ 为源码，scripts/build.mjs 将纯逻辑与客户端合成无外部本地 import 的 lib/client.js；React 由宿主模块系统提供。lib/index.js 为无操作服务端入口，cordis.patch.yml 为最小 bundle 补丁。node --test 覆盖北京时间/UTC跨日跨年、周末、节假日、四个半开边界、未知覆盖、日历注入、提醒去重与会话切换、定时器/监听清理，以及客户端 factory/slot 注册/基本渲染的 VM smoke test。

VM smoke test 不是浏览器或桌面视觉验证：没有验证真实 React reconciler、DOM布局、桌面路由切换、系统 reduced-motion、动画观感或窗口前后台节流后的端到端效果。需要后续获准安装后在真实 desktop 实测，尤其窄窗口布局和 useSession hook 稳定性。

安装边界

目标运行时：desktopVersion 0.2.0-rc.2。已只读检查本机 app.asar 中 @deepseek-ai/dsh-client-ui-conversation/lib/client.js：conversation.composer.dock 是 kind=list, scope=session；@deepseek-ai/dsh-client-ui-renderer/lib/client.js 的标准组件 props 中 useSession 按 source 缓存，用其稳定引用识别会话，不读取会话正文。客户端用 ctx.slots.inject + ctx.slots.register 注册，slot disposer 交宿主管理；组件卸载清理间隔、可见性监听和提醒 timeout。

Windows 手动安装本地包

先保存工作并完全退出 DeepSeek Harness 桌面版（包括托盘进程）。将 dsh-feng-gu-lite-0.1.0.tgz 下载或复制到当前目录，再在 PowerShell 中执行：

$desktop = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness'
$cli = Join-Path $desktop 'resources\runtime\cli\bin\dsh.cmd'
$package = (Resolve-Path -LiteralPath '.\dsh-feng-gu-lite-0.1.0.tgz').Path
if (-not (Test-Path -LiteralPath $cli)) {
throw '未找到桌面自带 CLI；请将 $desktop 改为实际桌面安装目录。'
}
& $cli plugin --profile desktop add $package
if ($LASTEXITCODE -ne 0) { throw '插件安装失败，请检查 CLI 输出。' }

以上使用桌面自带运行时；默认 Windows 安装位置已在本机核对，非默认安装需要调整 $desktop。不要对 desktop profile 使用 npm 版 CLI，不要手改运行中的 profile。安装命令会修改 desktop profile，须由用户主动执行；本次发布准备不会执行它。安装后重新打开桌面，在会话输入框下方检查指示器，并切换会话、调整窗口宽度、开启系统减少动态效果设置进行人工检查。
已有用户反馈安装操作完成，但本次自动验收没有复查 desktop profile，也没有完成真实桌面的视觉/交互验收。安装反馈不等同于装载兼容或视觉通过；上面的 VM smoke test 局限仍然适用。

公开发布（v0.1.0）

许可证为 MIT，版权标注为 dsh-feng-gu-lite contributors。源码仓库：linglanxin/dsh-feng-gu-lite；v0.1.0 Release 提供源码及 tgz 安装包，SHA-256 见 Release 说明。问题反馈：Issues。未执行 npm 发布，未提交插件市场申请，也不表示市场已收录。

在项目根目录重新验证并打包（无依赖，无需 npm install）：

node scripts/build.mjs
node --check lib/client.js
node --test
npm pack --ignore-scripts --cache .\.npm-cache
检查发布附件内容及 SHA-256，保存哈希用于下载校验
tar -tzf .\dsh-feng-gu-lite-0.1.0.tgz
Get-FileHash .\dsh-feng-gu-lite-0.1.0.tgz -Algorithm SHA256

package.json 的 files 白名单只包含 lib/、src/、scripts/、test/、cordis.patch.yml、README.md、LICENSE；npm 另自动包含 package.json。缓存与本地 tgz 不进入安装包。.gitignore 排除本地 npm 缓存、账户配置、环境文件、依赖和临时输出；它不会删除已有文件，也不能替代公开前的暂存区检查。

发布源码时应检查暂存清单，避免提交 .npm-cache/、.npmrc、.env*、日志、账户资料或其他本地文件。本项目的 GitHub Release 不等同于 npm 或插件市场发布；若以后申报插件市场，需等待仓库创建满 24 小时，再单独按市场流程提交并核实收录结果。

复用检索与最小权限

已加载 dsh-reuse-first，用附带 search-catalog.mjs pricing --limit 4 查询 awesome-dsh-plugin 目录，并只读取得 GitHub ZhangBo-cmd/dsh-pricing-badge 的 package.json、lib/client.js、cordis.patch.yml 参考接口。目录候选 dsh-pricing-badge 0.1.3 标注 network, credentials, env，还显示价格、规则、余额，不符合需求；dsh-peak-pricing-warning 也有 network/倒计时/费用。采用独立实现，仅参考模块工厂与 slot 接口，没有复制整份插件。

运行时代码不请求网络、不读取密钥/环境变量/账户、不声明 network 或 credentials 权限、不持久化任何数据，不调用模型。无 npm dependencies；没有构建期网络请求。检索阶段的网络访问不属于插件运行时能力。