dsh-offhours 0.1.3 → 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） |

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/package.json

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

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，只适合人工看板，不适合跑批。
 - 判据必须是命令，不是形容词；一张卡 = 一个可独立合并的成果。