@marsken/dsh-studio 0.1.21 → 0.1.23

package/docs/compatibility.md

@@ -6,7 +6,7 @@
 
 | 项 | 值 |
 | --- | --- |
-| dsh-studio | `package.json` `version: 0.1.21` |
+| dsh-studio | `package.json` `version: 0.1.23` |
 | 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,8 @@ token 只写进临时 npmrc（放在仓库外或 `tmp/` 且不提交），发完
 | --- | --- | --- |
 | `0.1.0` | 2026-11-13 | 首个公开版：看板 / 需求 / 用例回归 / 效能 / 设计评审四期 |
 | `0.1.1` | 2026-11-13 | 补三张 README 截图（npm 页可看图）；默认值与文档去掉公司内网信息 |
+| `0.1.23` | 2026-11-15 | 卡片镜像到飞书多维表格（手动触发，失败不谎报） |
+| `0.1.22` | 2026-11-15 | 缺陷严重级按用例优先级（回归升级）+ 角色模板编辑界面 |
 | `0.1.21` | 2026-11-15 | 需求基线可回滚（版本 +1、签字作废、留痕） |
 | `0.1.20` | 2026-11-15 | 拆卡时提示「有后端但功能点没覆盖后端」 |
 | `0.1.19` | 2026-11-15 | 需求澄清三问 + 拆卡门禁；修补答保存不上的白名单漏字段 |

package/index.js

@@ -29,6 +29,8 @@ export const inject = ['tools', 'systemPrompt']
 
 import { ACCESS_ROLE_LABEL, ACCESS_ROLES, ADMIN_ROUTES, ARTIFACT_KINDS, ARTIFACT_STATUS, CASE_HTTP_METHODS, CASE_PRIORITIES, CASE_RESULTS, CASE_TYPE_LABEL, CASE_TYPES, cleanId, CODE_PREFIX, CODING_FILE_CHANGES, CODING_REVIEW_STATUS, codingSummary, COLUMN_STRATEGIES, DEFAULT_ROLES, defaultColumns, defaultConfig, defaultDeployEnvs, defaultTemplates, DEPLOY_ENV_KINDS, FALLBACK_AGENT_MODEL, hashLocalPassword, INTAKE_HTML, ISOLATION_MODES, LEGACY_BLOCKED_STATUS, LEVEL_RANK, LOCAL_DEFAULT_PASSWORD, mergeCoding, mergeConfig, mergeSection, MINE_HTML, nextRequirementCode, nextTaskCode, normalizePatch, normalizeStrategy, publicArtifact, publicCases, publicChecklist, publicComments, PRIORITIES, ROLE_LABELS, canonicalAuthor, RELEASE_STATUSES, RELEASE_STATUS_LABEL, REQ_DOC_KIND_LABEL, REQ_DOC_KINDS, REQ_DOC_STATUS, REQ_REVIEW_LABEL, REQ_REVIEW_STATUS, REQ_STATUS_LABEL, REQ_STATUSES, ROLE_IDS, ROLE_LEVEL, SANDBOX_MODES, sanitizeAcceptanceItem, sanitizeAccess, sanitizeAllowHosts, sanitizeArtifact, sanitizeArtifacts, sanitizeBaseline, sanitizeBots, sanitizeBugSource, sanitizeCase, sanitizeCaseHttp, sanitizeCaseRun, sanitizeCases, sanitizeChangedFile, sanitizeChangedFiles, sanitizeChecklist, sanitizeChecklistItem, sanitizeCoding, sanitizeColumns, sanitizeCommit, sanitizeCommits, sanitizeCosts, sanitizeDeployEnvs, sanitizeEnvs, sanitizeExperts, sanitizeIterations, sanitizeLdap, sanitizeLocalAuth, sanitizeProjects, sanitizeReqDoc, sanitizeReqDocs, sanitizeRelease, sanitizeRequirement, sanitizeRequirementChange, sanitizeRequirementHistory, sanitizeRequirementPoint, sanitizeRequirementPoints, sanitizeRequirementPool, sanitizeRequirementQuestions, sanitizeRequirementReview, sanitizeRequirements, sanitizeServices, sanitizeSla, sanitizeTeams, sanitizeTemplates, sanitizeTesting, sanitizeTestRun, sanitizeTestRuns, sanitizeUsers, sanitizeWorkProjects, seedExperts, SEVERITIES, STATUS_HTML, STATUS_IDS, STATUS_SET, STATUSES, TASK_TYPES, text, verifyLocalPassword, worktreeRoot } from './src/host/domain.js'
 import { Dispatcher, RUN_LOG, attachRunLog, claimDispatchLock, clearAgentFailure, configureDispatcher, noteAgentFailure, parseMentions, runSummary } from './src/host/dispatcher.js'
+import { mirrorCards } from './src/host/bitable.js'
+import { bugSeverityFor } from './src/host/bugs.js'
 import { sanitizeLimits } from './src/host/limits.js'
 import { attachWebhooks, sanitizeWebhooks } from './src/host/webhooks.js'
 import { buildDashboard, codingVerifyLine, commentTask, configureExecutor, ensureReqFolder, larkCliReady, invalidateLarkProbe, larkProbeCache, mutateReqDoc, probeEnv, pullFeishuDoc, requirementGate, requirementMatrix, requirementProgress, requirementRollup, runCommand, runSuite, runTaskCases, saveRequirement, syncArtifact, syncRequirementArtifacts, taskExitGate, updateTask, verifyCodingRecord } from './src/host/executor.js'
@@ -1401,6 +1403,8 @@ function isEnvFailure(text) {
  * 用例失败 → 自动开一张缺陷卡，挂同一个需求、同一个项目/迭代，父任务是这张测试卡。
  * 同一张卡的同一用例只会开一次；重新标失败只是更新证据。
  */
+const mirrorCardsToBitable = (store, options) => mirrorCards(store, store.snapshot().config, options, { runCommand, markHealth })
+
 async function autoBugFromCase(store, task, item, by) {
   const snapshot = store.snapshot()
   const existing = snapshot.tasks.find(entry => entry.bugSource != null
@@ -1425,9 +1429,9 @@ async function autoBugFromCase(store, task, item, by) {
   const bug = await createTask(store, {
     title: `[用例失败] ${item.title}`,
     type: 'bug',
-    severity: 'p2',
+    // 严重级别跟着用例优先级走：p0 → p0，p3 → p3；已完成/待验收的卡上失败算回归，升一级
+    ...bugSeverityFor(item.priority, task.status),
     status: 'dev_ready',
-    priority: 'normal',
     requirement: [
       `来源：${task.code === '' ? task.id : task.code}「${task.title}」的测试用例`,
       `用例：${item.title}`,
@@ -1555,8 +1559,7 @@ function serviceConflicts(state, task) {
 
 /** 一卡一分支名：优先用卡号（DEV-001），没编号就用 id。 */
 function worktreeBranch(task) {
-  // 卡号只在一条需求内唯一（两条需求都会拆出 REQ-001）：带上 id 后半段，否则 git 不让同一分支挂两个 worktree
-  const code = String(task?.code ?? '').trim(), id = String(task?.id ?? '').trim()
+  const code = String(task?.code ?? '').trim(), id = String(task?.id ?? '').trim() // 卡号只在需求内唯一，分支要带 id 后缀
   const tail = id.replace(/[^a-z0-9]/gi, '').slice(-8)
   const label = code === '' ? id : `${code}-${tail}`
   return `task/${label}`.slice(0, 120)
@@ -2625,6 +2628,7 @@ export function apply(ctx) {
 
   configureExecutor({
     autoBugFromCase,
+  mirrorCardsToBitable,
     probeEnv,
     publicState,
     serviceDependencies,
@@ -2655,7 +2659,7 @@ export function apply(ctx) {
   gitlabRequest,
   gitlabMergeRequestDetail, applyConfig, ensureWorktree, publicState, readJsonBody, removeWorktree, sendJson, serviceOf, upsertById, workProjectOf })
     configureAgentsRoutes({ publicState, readJsonBody, sendJson, getDispatcher: () => activeDispatcher })
-    configureConnectRoutes({ applyConfig, installedPackages, publicState, readJsonBody, resolvePackageName, runPluginCli, sendJson, upsertById, getSyncTimer: () => syncTimer })
+    configureConnectRoutes({ mirrorCardsToBitable, applyConfig, installedPackages, publicState, readJsonBody, resolvePackageName, runPluginCli, sendJson, upsertById, getSyncTimer: () => syncTimer })
     configureAdminRoutes({ applyConfig, checkToolAccess, operatorFromSessionId, operatorOf, publicState, readJsonBody, sendJson })
     configureSkillsRoutes({ isSkillName, readJsonBody, sendJson, skillFromMarkdown, skillFromZip, skillsRoot, getSkills: () => activeSkills })
     configureInsightsRoutes({ getDispatcher: () => activeDispatcher, sendJson, buildMetrics, buildAnalytics, workloadReport, burndownReport })
@@ -2673,6 +2677,7 @@ export function apply(ctx) {
       applyConfig,
       getDispatcher: () => activeDispatcher,
       autoBugFromCase,
+  mirrorCardsToBitable,
       publicState,
       upsertById,
     })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marsken/dsh-studio",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "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/bitable.js

@@ -0,0 +1,74 @@
+// 把看板卡片镜像到飞书多维表格：一条 Record = 一张卡。
+// 只负责“卡片 → 记录字段”和分批；真正跑 lark-cli 在 index.js 里（要 markHealth、要复用 runCommand）。
+//
+// 表里需要有这些列（名字要对得上）：编号 / 标题 / 状态 / 负责人 / 优先级 / 需求 / 更新时间
+
+export const BITABLE_FIELDS = ['编号', '标题', '状态', '负责人', '优先级', '需求', '更新时间']
+export const BATCH_LIMIT = 200
+
+export function cardToRecord(task) {
+  return {
+    '编号': String(task?.code ?? '').trim() || String(task?.id ?? ''),
+    '标题': String(task?.title ?? '').slice(0, 200),
+    '状态': String(task?.status ?? ''),
+    '负责人': String(task?.expert ?? ''),
+    '优先级': String(task?.priority ?? ''),
+    '需求': String(task?.requirementId ?? ''),
+    '更新时间': Number(task?.updatedAt) > 0 ? new Date(Number(task.updatedAt)).toISOString() : '',
+  }
+}
+
+/** 一批最多 200 条，超过就分批（同一张表要串行写，否则会撞并发错误）。 */
+export function recordsPayload(cards) {
+  const list = (Array.isArray(cards) ? cards : []).map(cardToRecord)
+  const batches = []
+  for (let index = 0; index < list.length; index += BATCH_LIMIT) batches.push(list.slice(index, index + BATCH_LIMIT))
+  return batches
+}
+
+/**
+ * 真正镜像：按 200 条一批串行写多维表格。
+ * runCommand / markHealth 由 index.js 注入（子模块不反向依赖宿主）。
+ */
+export async function mirrorCards(store, config, options, deps) {
+  // 用别名接收注入能力：同名的 runCommand / markHealth 属于宿主模块，子模块不该 import 它们
+  const { runCommand: run, markHealth: health } = deps ?? {}
+  const gaps = mirrorConfigGaps(config)
+  if (gaps.length > 0) return { ok: false, error: '还没配多维表格：' + gaps.join('、') + '（设置 → 飞书机器人）' }
+  const requirementId = String(options?.requirementId ?? '')
+  const cards = (store.snapshot().tasks ?? []).filter(task => requirementId === '' || task.requirementId === requirementId)
+  const batches = recordsPayload(cards)
+  if (options?.dryRun === true) return { ok: true, dryRun: true, cards: cards.length, batches: batches.map(batch => batch.length) }
+  const probe = await run('lark-cli', ['--version'], 8000)
+  if (!probe.ok) {
+    health?.('feishu', 'fail', '没有可用的 lark-cli')
+    return { ok: false, error: '服务器上没有可用的 lark-cli，镜像需要它在服务器上并完成用户授权' }
+  }
+  const created = []
+  for (const batch of batches) {
+    const result = await run('lark-cli', [
+      'base', '+record-batch-create',
+      '--base-token', String(config.feishu.baseToken).trim(),
+      '--table-id', String(config.feishu.tableId).trim(),
+      '--json', JSON.stringify({ create_records: batch }),
+      '--as', 'user',
+    ], 60000)
+    if (!result.ok) {
+      health?.('feishu', 'fail', '多维表格写入失败：' + String(result.stderr || '').slice(0, 160))
+      return { ok: false, error: '多维表格写入失败：' + String(result.stderr || result.stdout || '').slice(0, 300), created }
+    }
+    let parsed = {}
+    try { parsed = JSON.parse(String(result.stdout || '{}')) } catch { parsed = {} }
+    for (const id of (parsed.record_id_list ?? [])) created.push(String(id))
+  }
+  health?.('feishu', 'ok', '多维表格镜像 ' + created.length + ' 条')
+  return { ok: true, cards: cards.length, created: created.length, batches: batches.map(batch => batch.length) }
+}
+
+/** 没配表就直说，别让调用方以为写进去了。 */
+export function mirrorConfigGaps(config) {
+  const gaps = []
+  if (String(config?.feishu?.baseToken ?? '').trim() === '') gaps.push('baseToken（多维表格 app_token）')
+  if (String(config?.feishu?.tableId ?? '').trim() === '') gaps.push('tableId（数据表 id）')
+  return gaps
+}

package/src/host/bugs.js

@@ -0,0 +1,20 @@
+// 自动建缺陷卡时的严重级别：按失败用例自己的优先级来，别再一律 p2。
+// 纯函数，方便单测；建卡在 index.js 的 autoBugFromCase。
+
+export const SEVERITY_ORDER = ['p0', 'p1', 'p2', 'p3']
+
+/**
+ * @param casePriority 用例优先级（p0-p3，缺省按 p2）
+ * @param cardStatus   卡当前所在列；已验收/已完成上失败说明是回归，严重级别升一级
+ */
+export function bugSeverityFor(casePriority, cardStatus) {
+  const raw = String(casePriority ?? '').trim().toLowerCase()
+  let index = SEVERITY_ORDER.indexOf(raw)
+  if (index < 0) index = SEVERITY_ORDER.indexOf('p2')
+  // 「已完成/待验收的卡跑失败了」比开发中的失败更要紧：往上升一级（p0 封顶）
+  const regression = cardStatus === 'done' || cardStatus === 'accept'
+  if (regression && index > 0) index -= 1
+  const severity = SEVERITY_ORDER[index]
+  const priority = severity === 'p0' ? 'urgent' : severity === 'p3' ? 'relaxed' : 'normal'
+  return { severity, priority, regression }
+}

package/src/host/routes/connect.js

@@ -1,7 +1,8 @@
 import { INTEGRATION, feishuPush, gitlabReady, gitlabRequest, gitlabSync, healthReport, projectReady } from '../integrations.js'
 import { cleanId } from '../domain.js'
-const INJECTED = ["applyConfig","installedPackages","publicState","readJsonBody","resolvePackageName","runPluginCli","sendJson","getSyncTimer","upsertById"]
+const INJECTED = ['mirrorCardsToBitable', "applyConfig","installedPackages","publicState","readJsonBody","resolvePackageName","runPluginCli","sendJson","getSyncTimer","upsertById"]
 let host = {
+  mirrorCardsToBitable: () => ({ ok: false, error: '未注入' }),
   applyConfig: () => {},
   installedPackages: () => {},
   publicState: () => {},
@@ -140,6 +141,13 @@ if (method === 'POST' && route === '/bots/delete') {
   host.sendJson(res, 200, { ok: true, state: host.publicState(store) })
   return true
 }
+if (method === 'POST' && route === '/feishu/mirror') {
+    // 把卡片镜像进飞书多维表格；dryRun 只算条数不写
+    const body = await host.readJsonBody(req)
+    const result = await host.mirrorCardsToBitable(store, { requirementId: body.requirementId ?? '', dryRun: body.dryRun === true })
+    host.sendJson(res, 200, { ok: result.ok === true, ...result, state: result.ok === true ? host.publicState(store) : undefined })
+    return true
+  }
 if (method === 'POST' && route === '/feishu/test') {
   const body = await host.readJsonBody(req).catch(() => ({}))
   const config = store.snapshot().config