@marsken/dsh-studio 0.1.19 → 0.1.21

package/docs/compatibility.md

@@ -6,7 +6,7 @@
 
 | 项 | 值 |
 | --- | --- |
-| dsh-studio | `package.json` `version: 0.1.19` |
+| dsh-studio | `package.json` `version: 0.1.21` |
 | DeepSeek Harness | `0.2.2-rc.1`（`dsh --version`） |
 | Node | `v24.22.2`（Linux 目标机）；本机 Windows `v24.19.0` |
 | 目标系统 | Ubuntu 24.04，`dsh web` 监听 `18080`，nginx `:80` 反代并注入 `dsh-auth-*` cookie |

package/docs/publish.md

@@ -127,6 +127,9 @@ token 只写进临时 npmrc（放在仓库外或 `tmp/` 且不提交），发完
 | --- | --- | --- |
 | `0.1.0` | 2026-11-13 | 首个公开版：看板 / 需求 / 用例回归 / 效能 / 设计评审四期 |
 | `0.1.1` | 2026-11-13 | 补三张 README 截图（npm 页可看图）；默认值与文档去掉公司内网信息 |
+| `0.1.21` | 2026-11-15 | 需求基线可回滚（版本 +1、签字作废、留痕） |
+| `0.1.20` | 2026-11-15 | 拆卡时提示「有后端但功能点没覆盖后端」 |
+| `0.1.19` | 2026-11-15 | 需求澄清三问 + 拆卡门禁；修补答保存不上的白名单漏字段 |
 | `0.1.17` | 2026-11-15 | 截图补到 10 张，且有脚本可重跑 |
 | `0.1.16` | 2026-11-15 | quickstart 命令修正 + GitLab 打桩验证配方 |
 | `0.1.15` | 2026-11-15 | 清掉三处过期的「已知限制」 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marsken/dsh-studio",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "type": "module",
   "description": "DSH Studio: role-based multi-agent workspace (product / architect / developer / QA) with a live work board, GitLab + Feishu connection settings, all configurable from the web GUI.",
   "main": "index.js",

package/src/host/discovery.js

@@ -16,6 +16,22 @@ export function sanitizeDiscovery(raw) {
   }
 }
 
+const BACKEND_HINT = /接口|api|数据库|数据表|建表|后端|服务端|鉴权|sqlite|postgres|持久化|存储/i
+const BACKEND_YES = /^(有|yes|是|需要|要)/i
+
+/**
+ * 说了「有服务端」，功能点里却没有一条跟后端有关 —— 大概率又要只交付一半。
+ * 只提示、不拦：有的需求后端在别的仓库或别的需求里，硬拦会误伤。
+ */
+export function backendCoverageWarning(requirement) {
+  const answer = String(requirement?.discovery?.server ?? '').trim()
+  if (answer === '' || BACKEND_YES.test(answer) !== true) return null
+  const points = Array.isArray(requirement?.points) ? requirement.points : []
+  const hit = points.some(point => BACKEND_HINT.test(String(point?.title ?? '') + ' ' + String(point?.description ?? '')))
+  if (hit) return null
+  return '澄清里说有服务端，但功能点没有一条讲接口 / 数据表 / 鉴权：后端在哪一块交付？'
+}
+
 /** 还缺哪几项澄清；空了才允许拆卡。 */
 export function discoveryGaps(requirement) {
   const discovery = requirement?.discovery ?? {}

package/src/host/executor.js

@@ -1245,6 +1245,16 @@ export async function syncRequirementArtifacts(store, requirementId) {
   return report
 }
 
+/** 回滚时给文档版本号 +1：v1.0 → v1.1；已经是 -rN 的就继续 +1。 */
+function bumpDocVersion(version) {
+  const text = String(version ?? '').trim()
+  const plain = /^v(\d+)\.(\d+)$/.exec(text)
+  if (plain !== null) return 'v' + plain[1] + '.' + (Number(plain[2]) + 1)
+  const rolled = /-r(\d+)$/.exec(text)
+  if (rolled !== null) return text.replace(/-r\d+$/, '-r' + (Number(rolled[1]) + 1))
+  return (text === '' ? 'v1.0' : text) + '-r1'
+}
+
 /** 需求文档的增删改与「评审通过、冻结为基线」。 */
 export async function mutateReqDoc(store, body) {
   const requirementId = String(body.id ?? '')
@@ -1281,6 +1291,30 @@ export async function mutateReqDoc(store, body) {
         by: String(body.by ?? '人').slice(0, 40),
       })
       if (requirement.status === 'draft') requirement.status = 'active'
+    } else if (action === 'rollback') {
+      // 回到基线正文：版本号 +1、签字作废、留一条历史——回滚是实质变更，不能悄悄改。
+      const baseline = requirement.baseline
+      if (baseline === null || baseline === undefined) throw new Error('这条需求还没有基线，先挑一份文档「设为基线」再回滚')
+      const target = requirement.docs.find(item => item.id === baseline.docId) ?? requirement.docs[0]
+      if (target === undefined) throw new Error('基线对应的文档已经删了，没法回滚')
+      const by = String(body.by ?? '人').trim().slice(0, 40) || '人'
+      const previousVersion = String(target.version ?? '')
+      target.content = baseline.content
+      target.version = bumpDocVersion(target.version)
+      target.status = 'baseline'
+      target.at = Date.now()
+      for (const doc of requirement.docs) if (doc.id !== target.id && doc.status === 'baseline') doc.status = 'draft'
+      requirement.baseline = sanitizeBaseline({ ...baseline, version: target.version, content: target.content, at: Date.now(), by })
+      const hadSignoff = requirement.signoff !== null && requirement.signoff !== undefined
+      requirement.signoff = null
+      requirement.history = [...(requirement.history ?? []), {
+        at: Date.now(),
+        by,
+        field: 'PRD 回滚',
+        from: previousVersion,
+        to: baseline.version,
+        note: hadSignoff ? '回滚到基线，原验收签字作废' : '回滚到基线',
+      }]
     } else if (action === 'clear-baseline') {
       requirement.baseline = null
       for (const doc of requirement.docs) if (doc.status === 'baseline') doc.status = 'review'

package/src/host/routes/requirements.js

@@ -7,7 +7,7 @@ import {
   sanitizeRequirementPool,
   text,
 } from '../domain.js'
-import { discoveryGaps } from '../discovery.js'
+import { backendCoverageWarning, discoveryGaps } from '../discovery.js'
 import { casesOfTasks, impactSummary } from '../impact.js'
 import {
   ensureReqFolder,
@@ -219,7 +219,9 @@ export async function handleRequirementRoute({ method, route, req, res, store, u
       })
       created.push(task)
     }
-    host.sendJson(res, 200, { ok: true, created, state: host.publicState(store) })
+    // 说了有后端却没有后端功能点：给个提示，不拦（后端可能确实在别的需求里）
+    const warning = backendCoverageWarning(requirement)
+    host.sendJson(res, 200, { ok: true, created, warnings: warning === null ? [] : [warning], state: host.publicState(store) })
     return true
   }
   if (method === 'POST' && route === '/requirement/pool') {