dsh-offhours 0.1.2 → 0.1.4

package/README.md

@@ -26,9 +26,12 @@ npx dsh-offhours init --repo . --name myapp
 # 2) 体检（依赖、路径、worker 权限）
 npx dsh-offhours doctor
 
-# 3) 建一张卡（自动盖当前会话；没有 session 的卡跑批不会捡）
+# 3) 建一张卡（必须在 dsh 会话里，或显式传当前会话 id）
+#    最省事：在 dsh 里对 agent 说「用 offhours 技能建一张卡：给登录页补错误提示」。
+#    终端命令需要带 --session；没有 sourceSessionId 的卡跑批永远不会捡。
 npx dsh-offhours card add "给登录页补错误提示" \
-  --summary "目标：登录失败有提示。判据：npm test 通过。不做什么：不改后端。"
+  --summary "目标：登录失败有提示。判据：npm test 通过。不做什么：不改后端。" \
+  --session <当前 dsh 会话 id>
 ```
 
 之后低谷时段自动跑；也可以用面板「立即跑」或 `npx dsh-offhours run --once`。
@@ -70,7 +73,7 @@ npx dsh-offhours card add "给登录页补错误提示" \
 |---|---|
 | `npx dsh-offhours init --repo .` | 初始化配置/看板/特性 |
 | `npx dsh-offhours doctor` | 依赖与权限体检（失败退出非 0） |
-| `npx dsh-offhours card add "<标题>" --summary "<目标/判据/边界>"` | 建卡并盖章当前会话 |
+| `npx dsh-offhours card add "<标题>" --summary "<目标/判据/边界>" [--session <id>]` | 建卡并盖章会话（无 session 不会跑） |
 | `npx dsh-offhours card list` | 列卡 |
 | `npx dsh-offhours run --once` / `--dry-run` | 手动跑一轮 / 只看会挑哪张 |
 | `npx dsh-offhours status` | 看板计数、心跳、最近状态（JSON） |
@@ -89,6 +92,15 @@ macOS 暂不支持（引擎用到 `flock`、`/proc`、GNU `readlink -f` 等）
 - 送审只留 5 类：选型不确定 / 影响演进 / 实施成本 / 条件做不成 / 政策风险。
 - 卡里必须有可机械核对的判据（命令），否则 worker 不得报 done。
 
+## 社区 / Community
+
+- **源码**：https://github.com/shuke52tt/dsh-offhours
+- **npm**：https://www.npmjs.com/package/dsh-offhours（`npx dsh-offhours ...`）
+- **dshmarket 索引 PR**：https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/13017
+- **官方 Show Your Plugins**：https://github.com/deepseek-ai/deepseek-harness/discussions/12568
+
+欢迎在官方帖或 issue 里反馈；插件按 MIT 发布。
+
 ## 开发
 
 ```bash

package/bin/offhours.mjs

@@ -198,14 +198,17 @@ function cmdCard(args, flags) {
   if (sub !== 'add') die('用法：offhours card add "<标题>" --summary "..."')
   const title = args.slice(1).join(' ').trim()
   if (!title) die('card add 需要一个标题')
-  const pyArgs = [nsPy(cfg), 'card-add', board.file, title,
-    '--session', String(flags.session || process.env.DSH_SESSION_ID || ''),
-  ]
+  const sessionId = String(flags.session || process.env.DSH_SESSION_ID || '')
+  if (!sessionId && !flags['allow-no-session']) {
+    die('缺少会话 id：在 dsh 会话里运行，或显式加 --session <sessionId>。\n' +
+      '没有 sourceSessionId 的卡不会被跑批捡起；确需建无主卡（只人工看）时加 --allow-no-session。')
+  }
+  const pyArgs = [nsPy(cfg), 'card-add', board.file, title, '--session', sessionId]
   for (const k of ['summary', 'description', 'rationale', 'rejected', 'tags', 'status', 'run-timeout']) {
     if (flags[k] !== undefined) pyArgs.push(`--${k}`, String(flags[k]))
   }
   if (flags['no-explain']) pyArgs.push('--no-explain')
-  const env = { ...process.env, DSH_SESSION_ID: String(flags.session || process.env.DSH_SESSION_ID || '') }
+  const env = { ...process.env, DSH_SESSION_ID: sessionId }
   const r = spawnSync('python3', pyArgs, { env, encoding: 'utf8' })
   process.stdout.write(r.stdout || '')
   process.stderr.write(r.stderr || '')

package/lib/runtime.js

@@ -69,6 +69,10 @@ export function startScheduler(ctx, cfg, log = () => {}) {
   let stopped = false
   let inFlight = false
 
+  // 首帧心跳：面板/CLI 在启动后的第一秒就能看到“调度器在跑”，
+  // 而不是等第一个 interval/抖动（默认最多 30s）才出现，避免新用户一打开面板就看到假故障。
+  try { writeJsonAtomic(heartbeatPath(cfg), { at: Date.now(), startedAt: Date.now(), fired: [], initial: true }) } catch { /* 忽略 */ }
+
   const tick = async () => {
     if (stopped || inFlight) return
     inFlight = true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-offhours",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "DSH 社区插件：把看板待办在低谷/夜间自动做掉（挑卡 → 独占 worktree → worker → 证据 → 合并回收），只依赖配置里的 git 仓库。",
   "type": "module",
   "license": "MIT",

package/panel/index.js

@@ -387,7 +387,11 @@ async function buildStatus(boardArg) {
       }
     } catch { out.problems.push('systemctl 查询失败（定时器状态未知）') }
   }
-  if (configured && CFG.scheduler === 'plugin' && out.timer.active === 'unknown') {
+  if (CFG.scheduler === 'plugin' && !CFG.schedule.enabled) {
+    out.timer.active = 'disabled'
+    out.timer.raw = 'plugin schedule disabled'
+  }
+  if (configured && CFG.scheduler === 'plugin' && CFG.schedule.enabled && out.timer.active === 'unknown') {
     out.problems.push('插件内调度器没有心跳（确认 dsh 进程在跑，或 schedule.enabled=false）')
   }
 
@@ -536,11 +540,14 @@ async function buildStatus(boardArg) {
 
   // 最近日志（只取本板的行；我的日志格式是 `<时间> [<板>] ...`）
   try {
-    const lines = readText(LOG).split('\n').filter((l) => l.includes(`[${board.key}]`))
-    out.recent.log = tailLines(lines.length ? lines.join('\n') : readText(LOG), LOG_TAIL)
-  } catch {
-    out.problems.push('读不到 nightshift.log')
-  }
+    const raw = readText(LOG)
+    if (raw) {
+      const lines = raw.split('\n').filter((l) => l.includes(`[${board.key}]`))
+      out.recent.log = tailLines(lines.length ? lines.join('\n') : raw, LOG_TAIL)
+    } else {
+      out.recent.log = []
+    }
+  } catch { /* 没有日志=还没跑过，不是故障 */ }
   try {
     out.recent.runs = readdirSync(RUNS)
       .filter((f) => f.endsWith('.out') || f.endsWith('.err'))

package/skills/offhours/SKILL.md

@@ -22,6 +22,7 @@ npx dsh-offhours card add "<标题>" --summary "<目标 + 判据(命令) + 涉
 
 - 必须在 dsh 会话里执行：它会用 `DSH_SESSION_ID` 盖章 `sourceSessionId`；
 - CLI 没进全局 PATH：统一用 `npx dsh-offhours ...`（或 profile 里的 `node_modules/.bin/offhours`）。
+- 不在 dsh 会话里时，`card add` 必须加 `--session <id>`；无 session 的卡不会被跑批捡。
   **没有 sourceSessionId 的卡跑批永远不会捡**（不是 bug，是隔离要求）。
 - 用 dsh-kanban 的 `board_add` 建的卡不带 session，只适合人工看板，不适合跑批。
 - 判据必须是命令，不是形容词；一张卡 = 一个可独立合并的成果。