dsh-peak-block 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 betterer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# dsh·梁文峰时间拦截插件
+
+在 DeepSeek 官方高峰时段拦截官方 provider 请求，保障安心使用梁文谷。
+
+高峰时段默认北京时间工作日 09:00–12:00、14:00–18:00，周末全天谷价。拦截到官方请求时：已配置 `targetProvider` 则切到该目标，未配置则阻止并提示；非高峰不拦截，正常走官方。官方判定默认只精确匹配 `deepseek-official`，不做名称前缀规则，因此 pi-ai 自带的三方 `deepseek` 中转不会误拦。
+
+## 效果
+
+未配置 `targetProvider` 时于高峰时段发起官方请求，请求被阻止，界面呈现「未配置拦截目标」的报错：
+
+![拦截效果](docs/拦截效果.webp)
+
+## 安装
+
+```powershell
+dsh plugin --profile web add github:better-er/dsh-peak-block
+```
+
+一条命令装完即生效，自动挂载，重启 DSH web 后启用，无需手工编辑任何文件。
+
+## 卸载
+
+```powershell
+dsh plugin --profile web remove dsh-peak-block
+```
+
+彻底移除，重启 DSH web 后不再加载。
+
+## 配置
+
+插件通过 cordis 配置注入，默认 `enabled: true`，其余键可覆盖：
+
+| 键 | 默认 | 说明 |
+|---|---|---|
+| `enabled` | `true` | 总开关 |
+| `officialProviders` | 未设（只认 `deepseek-official`） | 视为「官方」的 provider 精确名单，不设用默认判定 |
+| `targetProvider` | 空 | 拦截后切到的目标 provider；留空 = 阻止并提示 |
+| `peakWindow` | 工作日 9–12、14–18，周末谷 | 峰谷时段窗口，可整体或局部覆盖 |
+
+配置示例：
+
+```yaml
+plugins:
+  dsh-peak-block:
+    enabled: true
+    targetProvider: opencode-go
+    peakWindow:
+      days: [1, 2, 3, 4, 5]
+      hourRanges: [[9, 12], [14, 18]]
+      weekendOffPeak: true
+```
+
+## 边界
+
+- 只拦对话模型请求：`agent/request` 覆盖 agent loop 的正常对话；compaction 等走 `ctx.llm.stream()` 的路径不拦。
+- `targetProvider` 必须是 DSH 已注册适配器路由，否则切换后以 `NO_ADAPTER` 失败。
+- `days` 用 JS `getUTCDay` 序号，1..5 为周一..周五；时区判定纯 UTC+8 数学换算，与系统时区无关。
+
+## 要求与开发
+
+- 是**标准形态的 dsh 主机加客户端双半身插件**：host 在 `agent/request` waterfall 里拦截并切换/阻止，`./client` 在设置面板提供一个独立的「梁文峰拦截」标签页，内含 enabled、targetProvider、officialProviders、peakWindow 与预留转 API 端口的配置骨架。当前配置骨架不写回 host，正式生效待接线。
+- 无构建：`lib/index.js` 与 `lib/client.js` 均为源码即产物，改完即用。
+- 纯函数 `isPeakBeijing` / `isOfficial` / `decide` 在 `lib/index.js` 导出，冒烟测试：
+
+  ```powershell
+  node scripts/smoke.mjs
+  ```
+
+## License
+
+[MIT](./LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-peak-block bundle patch: inserts this plugin into a profile's layer stack.
+# Applied when a profile lists this bundle (or wired by dev_install_package).
+# targetProvider 留空即「未配置拦截目标」，梁文峰时间拦截到时走「阻止并提示」。
+- insert:
+    - id: dsh-peak-block
+      name: 'dsh-peak-block'
+      config:
+        enabled: true

package/lib/client.js

@@ -0,0 +1,191 @@
+// dsh-peak-block 浏览器半身：设置面板里的一个独立标签页。
+// host 侧（lib/index.js）完成真正的拦截与路由切换。本半身提供配置入口的 UI 骨架：
+// enabled、targetProvider、officialProviders、peakWindow 与预留的「转 API 端口」。
+// 当前仅为界面演示，字段值不写回 host；正式生效需后续接线 host 的配置读写通道。
+// 真正的「被拦截且未配置目标」提示，由 host 侧抛出的失败文案随界面失败信息呈现，本半身不重复注入，避免易碎的 UI 依赖。
+
+window.__ModuleLoader__.load({
+  id: 'dsh-peak-block',
+  factory: (require) => {
+    const module = { exports: {} }
+    const exports = module.exports
+
+    const React = require('react')
+
+    const plugin = {
+      name: 'dsh-peak-block',
+      inject: ['slots'],
+      apply(ctx) {
+        const slots = ctx.get && ctx.get('slots')
+        if (!slots) return
+
+        const DOC = typeof document !== 'undefined' ? document : null
+        let styleTag = null
+
+        function ensureStyle() {
+          if (!DOC || styleTag) return
+          const css = [
+            '.dshpb-section{display:flex;flex-direction:column;gap:12px;max-width:720px;color:var(--dsw-alias-label-primary)}',
+            '.dshpb-title{margin:0;font-size:16px;line-height:24px;font-weight:500;color:var(--dsw-alias-label-primary)}',
+            '.dshpb-intro{margin:0;font-size:14px;line-height:22px;color:var(--dsw-alias-label-tertiary)}',
+            '.dshpb-notice{margin:0;font-size:12px;line-height:18px;color:var(--dsw-alias-state-warn-label)}',
+            '.dshpb-card{border:1px solid var(--dsw-alias-border-l2);border-radius:12px;padding:14px 16px;display:flex;flex-direction:column;gap:14px}',
+            '.dshpb-field{display:flex;flex-direction:column;gap:6px}',
+            '.dshpb-fieldLabel{font-size:12px;line-height:18px;font-weight:500;color:var(--dsw-alias-label-secondary)}',
+            '.dshpb-hint{margin:0;font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary)}',
+            '.dshpb-input{box-sizing:border-box;width:100%;height:32px;padding:0 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;font:inherit;font-size:14px;line-height:22px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary)}',
+            '.dshpb-input:focus{outline:none;border-color:var(--dsw-alias-brand-primary)}',
+            '.dshpb-input::placeholder{color:var(--dsw-alias-label-dimmed)}',
+            'select.dshpb-input{max-width:320px;cursor:pointer}',
+            '.dshpb-rowInput{max-width:320px}',
+            '.dshpb-actions{display:flex;justify-content:flex-end;gap:8px}',
+            '.dshpb-button{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;gap:4px;height:36px;padding:0 14px;border:none;border-radius:18px;font:inherit;font-size:14px;line-height:22px;cursor:pointer}',
+            '.dshpb-buttonPrimary{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground)}',
+            '.dshpb-buttonPrimary:hover{background:var(--dsw-alias-button-primary-hover)}',
+            '.dshpb-switch{display:inline-flex;align-items:center;gap:8px;cursor:pointer;font-size:14px;line-height:22px}',
+          ].join('')
+          const tag = DOC.createElement('style')
+          tag.textContent = css
+          DOC.head.appendChild(tag)
+          styleTag = tag
+        }
+
+        const TARGET_TYPES = {
+          none: '未配置（高峰阻止并提示）',
+          proxy: '第三方中转路由',
+          port: '转 API 端口',
+        }
+
+        function Section() {
+          const [enabled, setEnabled] = React.useState(true)
+          const [targetType, setTargetType] = React.useState('none')
+          const [proxyRoute, setProxyRoute] = React.useState('opencode-go')
+          const [apiPort, setApiPort] = React.useState('127.0.0.1:8080')
+          const [official, setOfficial] = React.useState('deepseek-official')
+          const [savedHint, setSavedHint] = React.useState('')
+
+          function onSave() {
+            setSavedHint('已保存到界面状态，尚未写回 host，正式生效需接线后端。')
+          }
+
+          return React.createElement(
+            'div',
+            { className: 'dshpb-section', role: 'region', 'aria-label': '梁文峰拦截设置' },
+            React.createElement('h2', { className: 'dshpb-title' }, '梁文峰时间拦截'),
+            React.createElement('p', { className: 'dshpb-intro' }, '在 DeepSeek 官方高峰时段拦截官方 provider 请求，可切换到第三方中转或本机转 API 端口。'),
+            React.createElement('p', { className: 'dshpb-notice' }, '当前为配置界面骨架，改动不写回 host，正式生效需后续接线。'),
+            React.createElement(
+              'div',
+              { className: 'dshpb-card' },
+              React.createElement(
+                'label',
+                { className: 'dshpb-switch' },
+                React.createElement('input', {
+                  type: 'checkbox',
+                  checked: enabled,
+                  onChange: function (e) { setEnabled(e.target.checked) },
+                }),
+                '启用拦截'
+              ),
+              React.createElement(
+                'div',
+                { className: 'dshpb-field' },
+                React.createElement('label', { className: 'dshpb-fieldLabel', htmlFor: 'dshpb-target' }, '拦截目标 targetProvider'),
+                React.createElement(
+                  'select',
+                  {
+                    id: 'dshpb-target',
+                    className: 'dshpb-input',
+                    value: targetType,
+                    onChange: function (e) { setTargetType(e.target.value) },
+                  },
+                  React.createElement('option', { value: 'none' }, TARGET_TYPES.none),
+                  React.createElement('option', { value: 'proxy' }, TARGET_TYPES.proxy),
+                  React.createElement('option', { value: 'port' }, TARGET_TYPES.port)
+                ),
+                targetType === 'proxy' &&
+                  React.createElement('input', {
+                    className: 'dshpb-input dshpb-rowInput',
+                    value: proxyRoute,
+                    placeholder: '如 opencode-go',
+                    'aria-label': '第三方中转路由',
+                    onChange: function (e) { setProxyRoute(e.target.value) },
+                  }),
+                targetType === 'port' &&
+                  React.createElement(
+                    'div',
+                    { className: 'dshpb-field' },
+                    React.createElement('label', { className: 'dshpb-fieldLabel', htmlFor: 'dshpb-port' }, '转 API 端口'),
+                    React.createElement('input', {
+                      id: 'dshpb-port',
+                      className: 'dshpb-input dshpb-rowInput',
+                      value: apiPort,
+                      placeholder: '127.0.0.1:8080',
+                      onChange: function (e) { setApiPort(e.target.value) },
+                    }),
+                    React.createElement('p', { className: 'dshpb-hint' }, '预留：把被拦请求转发到本机 OpenAI 兼容端口。')
+                  )
+              ),
+              React.createElement(
+                'div',
+                { className: 'dshpb-field' },
+                React.createElement('label', { className: 'dshpb-fieldLabel', htmlFor: 'dshpb-official' }, '官方判定 provider 名单（逗号分隔）'),
+                React.createElement('input', {
+                  id: 'dshpb-official',
+                  className: 'dshpb-input dshpb-rowInput',
+                  value: official,
+                  onChange: function (e) { setOfficial(e.target.value) },
+                })
+              ),
+              React.createElement(
+                'div',
+                { className: 'dshpb-field' },
+                React.createElement('span', { className: 'dshpb-fieldLabel' }, '高峰时段'),
+                React.createElement('p', { className: 'dshpb-hint' }, '北京时间工作日 09:00–12:00、14:00–18:00，周末全天谷价。')
+              ),
+              React.createElement(
+                'div',
+                { className: 'dshpb-actions' },
+                React.createElement(
+                  'button',
+                  { type: 'button', className: 'dshpb-button dshpb-buttonPrimary', onClick: onSave },
+                  '保存（演示）'
+                )
+              ),
+              savedHint !== '' &&
+                React.createElement('p', { className: 'dshpb-hint' }, savedHint)
+            )
+          )
+        }
+
+        slots.inject('settings.section', function () {
+          return slots.register(
+            {
+              name: 'settings.section',
+              id: 'peak-block',
+              order: 90,
+              label: '梁文峰拦截',
+            },
+            () => React.createElement(Section)
+          )
+        })
+
+        ctx.effect(function () {
+          ensureStyle()
+          return function () {
+            if (styleTag && styleTag.parentNode) styleTag.parentNode.removeChild(styleTag)
+            styleTag = null
+          }
+        })
+      },
+    }
+
+    exports.default = plugin
+    exports.name = plugin.name
+    exports.inject = plugin.inject
+    exports.apply = plugin.apply
+
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+    return module.exports
+  },
+})

package/lib/index.js

@@ -0,0 +1,88 @@
+// dsh-peak-block host 端：梁文峰时间拦截向 DeepSeek 官方 API 的模型请求。
+//
+// 在「梁文峰时间」，即 DeepSeek 官方高峰时段——北京时间工作日 09:00–12:00、14:00–18:00、周末全天谷价——拦截原本发往官方 provider 的对话请求。
+// 已配置 targetProvider 则切换路由，未配置则阻止并抛出带文案的错误提示。非高峰时段不拦截，正常走官方。
+//
+// 拦截 seam：agent/request waterfall。它对每次对话模型请求携带冻结的调用配置种子 LlmCallConfig（provider/model/reasoningEffort/temperature/maxTokens/stop）。
+// listener 可返回替代 config 切换 provider。要判断请求是否官方必须先调用 next() 拿到 config，故实现为「先取 config 再决策」：切换时返回替代 config，阻止时抛带提示文案的错误。
+// compaction 等走 ctx.llm.stream() 直接调用的路径不经此 waterfall，本插件不拦。
+
+export const name = 'dsh-peak-block'
+export const inject = []
+
+/** 梁文峰时间默认窗口：工作日 09:00–12:00、14:00–18:00（UTC+8），周末全天谷。 */
+export const DEFAULT_PEAK = {
+  days: [1, 2, 3, 4, 5], // JS getUTCDay：0=周日 … 6=周六，1..5=周一..周五
+  hourRanges: [[9, 12], [14, 18]],
+  weekendOffPeak: true,
+}
+
+/** 默认官方 provider 判定：只精确匹配 DSH 官方注册路由 `deepseek-official`。
+ * 不用名称前缀规则——pi-ai 自带的第三方 `deepseek` 中转不应算官方，避免误拦。 */
+export function defaultIsOfficial(provider) {
+  return provider === 'deepseek-official'
+}
+
+/**
+ * 时刻是否处于梁文峰时间。纯 UTC+8 数学换算，与系统时区无关，本机时钟/时区不可信。
+ * 红线：周末全天谷价，仅工作日有峰。
+ */
+export function isPeakBeijing(timeMs, peak = DEFAULT_PEAK) {
+  const shifted = timeMs + 8 * 3600 * 1000
+  const d = new Date(shifted)
+  const day = d.getUTCDay()
+  if (peak.weekendOffPeak !== false && (day === 0 || day === 6)) return false
+  if (Array.isArray(peak.days) && peak.days.length > 0 && !peak.days.includes(day)) return false
+  const hour = d.getUTCHours()
+  for (const [a, b] of peak.hourRanges) {
+    if (hour >= a && hour < b) return true
+  }
+  return false
+}
+
+/** provider 是否视为官方。显式名单用精确匹配；未提供名单用默认判定（仅 deepseek-official）。 */
+export function isOfficial(provider, officialProviders) {
+  if (!provider) return false
+  if (Array.isArray(officialProviders)) {
+    return officialProviders.some((p) => provider === p)
+  }
+  return defaultIsOfficial(provider)
+}
+
+/** 阻止时抛出的提示文案（用户可见，随界面失败信息呈现）。 */
+export const BLOCK_MESSAGE =
+  '【梁文峰时间拦截 · dsh-peak-block】当前为 DeepSeek 官方高峰时段，且未配置拦截目标（targetProvider），请求已阻止。请为 dsh-peak-block 配置 targetProvider，或将请求留到梁文谷时段再发。'
+
+/**
+ * 纯拦截决策（可单测）：返回 { action: 'pass' | 'switch' | 'block', config? }。
+ * - 非梁文峰时间或非官方 → pass（放行）
+ * - 梁文峰时间 + 官方 + 有目标 → switch（切 provider 到目标）
+ * - 梁文峰时间 + 官方 + 无目标 → block（阻止并提示）
+ */
+export function decide(seed, opts) {
+  if (!isPeakBeijing(opts.timeMs, opts.peakWindow)) return { action: 'pass' }
+  if (!isOfficial(seed && seed.provider, opts.officialProviders)) return { action: 'pass' }
+  if (opts.targetProvider) {
+    return { action: 'switch', config: { ...(seed || {}), provider: opts.targetProvider } }
+  }
+  return { action: 'block' }
+}
+
+export function apply(ctx, config = {}) {
+  if (config.enabled === false) return
+  const peakWindow = config.peakWindow || DEFAULT_PEAK
+  const officialProviders = config.officialProviders
+  const targetProvider = config.targetProvider
+  ctx.on('agent/request', async (_payload, next) => {
+    const seed = await next()
+    const decision = decide(seed, {
+      timeMs: Date.now(),
+      peakWindow,
+      officialProviders,
+      targetProvider,
+    })
+    if (decision.action === 'pass') return seed
+    if (decision.action === 'switch') return decision.config
+    throw new Error(BLOCK_MESSAGE)
+  })
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "dsh-peak-block",
+  "version": "0.1.0",
+  "description": "梁文峰时间拦截官方 DeepSeek API 请求：北京时间工作日高峰时段 09:00-12:00、14:00-18:00 自动拦截发往官方 provider `deepseek-official` 的模型请求，可切换到第三方中转或预留的本机转 API 端口，未配置则阻止并提示；非高峰不拦、正常走官方，专治高峰掉速与刷屏。标准可安装 dsh 插件，host+client 双半身。",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "deepseek",
+    "peak-hours",
+    "rate-limit",
+    "official",
+    "provider",
+    "routing"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/better-er/dsh-peak-block.git"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-slots"
+      ]
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "cordis.patch.yml",
+    "docs/"
+  ],
+  "license": "MIT"
+}