dsh-deepmoyu 2.7.2 → 2.8.1

package/lib/background-tools.mjs

@@ -1,6 +1,6 @@
 /** Adapt the host fish tools for a per-run MCP capability, not a general tool executor. */
 export function backgroundToolNames(cfg = {}) {
-  const names = ['bili_whoami', 'bili_search', 'bili_subtitle', 'bili_comments', 'bili_video_info', 'bili_danmaku', 'bili_buzzwords', 'bili_rank', 'bili_hot_videos', 'bili_user_videos', 'bili_seen', 'bili_say', 'bili_pace', 'bili_my_notices', 'bili_my_dynamics', 'bili_opus_comments', 'bili_my_video_comments', 'bili_learn', 'bili_soul', 'bili_taste', 'bili_records', 'bili_sticker']
+  const names = ['bili_whoami', 'bili_search', 'bili_subtitle', 'bili_comments', 'bili_video_info', 'bili_danmaku', 'bili_buzzwords', 'bili_rank', 'bili_hot_videos', 'bili_user_videos', 'bili_seen', 'bili_say', 'bili_pace', 'bili_my_notices', 'bili_my_dynamics', 'bili_opus_comments', 'bili_my_video_comments', 'bili_learn', 'bili_soul', 'bili_taste', 'bili_records', 'bili_sticker', 'bili_curiosity']
   if (cfg.autoComment || cfg.replyToComments) names.push('bili_reply', 'bili_reply_opus')
   // 「自动评论视频」开着才给发新评论的通道；回复另算（replyToComments）
   if (cfg.autoComment) names.push('bili_comment')

package/lib/browse-preferences.mjs

@@ -0,0 +1,154 @@
+/** Explicit viewing preferences. Topics guide discovery; exclusions never grant tool permissions. */
+export const BROWSE_TOPICS = Object.freeze(['科技', '知识', '生活', '美食', '游戏', '动画', '音乐', '影视', '动物', '运动', '旅行'])
+export const BROWSE_DEFAULTS = Object.freeze({
+  browseTopics: Object.freeze([]), browseAvoidKeywords: Object.freeze([]), browseExplorePercent: 25,
+  browseMinMinutes: 0, browseMaxMinutes: 0, browseRecentDays: 7, browseSort: 'click', browseMinViews: 50_000,
+})
+export const BROWSE_LIMITS = Object.freeze({
+  browseExplorePercent: [0, 100], browseMinMinutes: [0, 1440], browseMaxMinutes: [0, 1440], browseRecentDays: [0, 365], browseMinViews: [0, 2_000_000_000],
+})
+const SORTS = ['mixed', 'pubdate', 'click', 'totalrank']
+const own = (object, key) => Object.hasOwn(object || {}, key)
+const phrases = value => Array.isArray(value) ? [...new Set(value.filter(item => typeof item === 'string').map(item => item.trim()).filter(Boolean))].slice(0, 30).map(item => item.slice(0, 80)) : []
+const invalid = message => Object.assign(new Error(message), { status: 400, code: 'CONFIG_INPUT' })
+
+/** Tolerate old persisted values on read; explicit writes go through validateBrowsePatch first. */
+export function clampBrowseSettings(patch = {}) {
+  const out = { ...patch }
+  if (own(out, 'browseTopics')) out.browseTopics = phrases(out.browseTopics).filter(topic => BROWSE_TOPICS.includes(topic))
+  if (own(out, 'browseAvoidKeywords')) out.browseAvoidKeywords = phrases(out.browseAvoidKeywords)
+  if (own(out, 'browseSort')) out.browseSort = SORTS.includes(out.browseSort) ? out.browseSort : BROWSE_DEFAULTS.browseSort
+  for (const [key, [lo, hi]] of Object.entries(BROWSE_LIMITS)) if (own(out, key)) {
+    const n = Number(out[key])
+    out[key] = Number.isFinite(n) ? Math.max(lo, Math.min(hi, Math.floor(n))) : BROWSE_DEFAULTS[key]
+  }
+  return out
+}
+
+/** Validate against the current durable config inside its write lock as well as at the API boundary. */
+export function validateBrowsePatch(patch = {}, current = {}) {
+  for (const key of ['browseTopics', 'browseAvoidKeywords']) if (own(patch, key)) {
+    if (!Array.isArray(patch[key]) || patch[key].length > 30 || patch[key].some(item => typeof item !== 'string' || !item.trim() || item.length > 80 || /[\r\n\x00-\x1f]/.test(item))) {
+      throw invalid(key + ' 需要最多 30 个非空短词，每个不超过 80 字')
+    }
+    if (key === 'browseTopics' && patch[key].some(topic => !BROWSE_TOPICS.includes(topic.trim()))) throw invalid('视频类别包含未知选项')
+  }
+  if (own(patch, 'browseSort') && !SORTS.includes(patch.browseSort)) throw invalid('视频排序需要选择综合探索、最新、播放量或平台综合')
+  for (const [key, [lo, hi]] of Object.entries(BROWSE_LIMITS)) if (own(patch, key)) {
+    if (typeof patch[key] !== 'number' || !Number.isSafeInteger(patch[key]) || patch[key] < lo || patch[key] > hi) throw invalid(`${key} 需要 ${lo} 至 ${hi} 之间的整数`)
+  }
+  if (own(patch, 'browseMinMinutes') || own(patch, 'browseMaxMinutes')) {
+    const cfg = { ...BROWSE_DEFAULTS, ...clampBrowseSettings(current), ...patch }
+    if (cfg.browseMaxMinutes > 0 && cfg.browseMinMinutes > cfg.browseMaxMinutes) throw invalid('视频最短时长不能大于最长时长；最长填 0 表示不限')
+  }
+  return patch
+}
+
+export function browseSettings(source = {}) {
+  const cfg = { ...BROWSE_DEFAULTS, ...clampBrowseSettings(source) }
+  // Historical hand-edited config can have reversed bounds; do not silently exclude every candidate.
+  if (cfg.browseMaxMinutes > 0 && cfg.browseMinMinutes > cfg.browseMaxMinutes) cfg.browseMaxMinutes = cfg.browseMinMinutes
+  return Object.fromEntries(Object.keys(BROWSE_DEFAULTS).map(key => [key, Array.isArray(cfg[key]) ? [...cfg[key]] : cfg[key]]))
+}
+
+/** A fresh snapshot has no shared arrays with a later settings edit. */
+export function snapshotBrowseSettings(source = {}) {
+  const snapshot = { ...browseSettings(source), keywords: phrases(source.keywords) }
+  Object.freeze(snapshot.browseTopics); Object.freeze(snapshot.browseAvoidKeywords); Object.freeze(snapshot.keywords)
+  return Object.freeze(snapshot)
+}
+
+export function browsePreferenceBrief(source = {}) {
+  const cfg = browseSettings(source), keywords = phrases(source.keywords)
+  return [
+    `【刷片偏好】类别：${cfg.browseTopics.join('、') || '随兴趣'}；喜欢的词：${keywords.join('、') || '随兴趣'}。`,
+    `发布时间：${cfg.browseRecentDays ? `最近 ${cfg.browseRecentDays} 天` : '不限，旧片也可以'}；时长：${cfg.browseMinMinutes ? `至少 ${cfg.browseMinMinutes} 分钟` : '无下限'}，${cfg.browseMaxMinutes ? `最多 ${cfg.browseMaxMinutes} 分钟` : '无上限'}。`,
+    `排序：${({ mixed: '兼顾兴趣与新鲜感', pubdate: '最新优先', click: '播放量优先', totalrank: '保持平台综合顺序' })[cfg.browseSort]}；约 ${cfg.browseExplorePercent}% 的探索机会留给平时少看的内容，这是倾向，不是逐条打卡配额。`,
+    `热度：${cfg.browseMinViews ? `播放量至少 ${cfg.browseMinViews.toLocaleString('en-US')}；优先热门榜与高播放的新候选` : '不设最低播放量'}。播放量未知先用 bili_video_info 核对，不能把未知当热门；低于门槛就换片，不为凑候选降低门槛。`,
+    `避开关键词：${cfg.browseAvoidKeywords.join('、') || '未设置'}。类别和喜欢词用来挑方向，不要求条条命中；日期、时长或热度缺失先读视频详情核对，不把未知当不合格。候选不足先换来源或关键词，不擅自放宽本人设定。`,
+  ].join('\n')
+}
+
+export function videoDurationSeconds(value) {
+  if (typeof value === 'number') return Number.isFinite(value) && value > 0 ? value : null
+  if (typeof value !== 'string' || !value.trim()) return null
+  const text = value.trim()
+  if (/^\d+(?:\.\d+)?$/.test(text)) return Number(text) > 0 ? Number(text) : null
+  if (!/^\d+:\d{2}(?::\d{2})?$/.test(text)) return null
+  const parts = text.split(':').map(Number)
+  if (parts.slice(1).some(part => part >= 60)) return null
+  const seconds = parts.reduce((total, part) => total * 60 + part, 0)
+  return seconds > 0 ? seconds : null
+}
+const publication = row => {
+  const value = Number(row?.pubdate ?? row?.created)
+  if (Number.isFinite(value) && value > 0) return value < 100_000_000_000 ? value * 1000 : value
+  if (typeof row?.pubdate_str === 'string' && /^\d{4}-\d{2}-\d{2}/.test(row.pubdate_str)) {
+    const date = Date.parse(row.pubdate_str)
+    if (Number.isFinite(date)) return date
+  }
+  return null
+}
+const topicAliases = {
+  科技: ['科技', '数码', '计算机', '人工智能', 'deepseek', 'ai'], 知识: ['知识', '科普', '历史', '科学', '人文', '社科'],
+  生活: ['生活', '日常', '家居', '手工'], 美食: ['美食', '做饭', '料理', '烹饪', '吃播'], 游戏: ['游戏', '电竞', '单机', '手游'],
+  动画: ['动画', '动漫', '番剧', '二次元'], 音乐: ['音乐', '歌曲', '演奏', '翻唱'], 影视: ['影视', '电影', '电视剧', '影评'],
+  动物: ['动物', '宠物', '猫', '狗', '萌宠'], 运动: ['运动', '健身', '体育', '篮球', '足球'], 旅行: ['旅行', '旅游', '风景', '探店'],
+}
+const readable = value => String(value ?? '').replace(/<[^>]*>/g, '').toLowerCase()
+const textOf = row => [row.title, row.description, row.tname, row.category, row.author].map(readable).join(' ')
+/** Public APIs use both exact numbers and abbreviated display counts. Zero is known, not missing. */
+export function videoViewCount(row) {
+  for (const raw of [row?.play, row?.stat?.view, row?.view, row?.views]) {
+    if (typeof raw === 'number' && Number.isFinite(raw) && raw >= 0) return Math.floor(raw)
+    if (typeof raw !== 'string') continue
+    const text = raw.trim().replace(/[,，\s]/g, '')
+    const match = /^(\d+(?:\.\d+)?)(万|亿|[wWkKmM])?(?:次(?:播放)?|播放)?$/.exec(text)
+    if (!match) continue
+    const multiplier = ({ 万: 1e4, 亿: 1e8, w: 1e4, W: 1e4, k: 1e3, K: 1e3, m: 1e6, M: 1e6 })[match[2]] || 1
+    const count = Number(match[1]) * multiplier
+    if (Number.isFinite(count)) return Math.floor(count)
+  }
+  return null
+}
+
+/** All discovery sources share the same filters. Unknown metadata remains visible with a verification hint. */
+export function filterBrowseCandidates(rows = [], source = {}, { now = Date.now() } = {}) {
+  const cfg = browseSettings(source), keywords = phrases(source.keywords).map(readable)
+  const excluded = [], unknown = [], candidates = []
+  const cutoff = now - cfg.browseRecentDays * 86400_000
+  for (const [index, row] of rows.entries()) {
+    if (!row || typeof row !== 'object') continue
+    const text = textOf(row), seconds = videoDurationSeconds(row.duration ?? row.length), published = publication(row), viewCount = videoViewCount(row)
+    const avoid = cfg.browseAvoidKeywords.find(word => text.includes(readable(word)))
+    const reason = avoid ? `避开关键词：${avoid}`
+      : seconds !== null && cfg.browseMinMinutes > 0 && seconds < cfg.browseMinMinutes * 60 ? '短于设置的最短时长'
+        : seconds !== null && cfg.browseMaxMinutes > 0 && seconds > cfg.browseMaxMinutes * 60 ? '长于设置的最长时长'
+          : published !== null && cfg.browseRecentDays > 0 && published < cutoff ? '超出设置的发布时间范围'
+            : viewCount !== null && viewCount < cfg.browseMinViews ? '低于设置的最低播放量' : ''
+    if (reason) { excluded.push({ bvid: row.bvid || '', reason }); continue }
+    const check = []
+    if (seconds === null && (cfg.browseMinMinutes || cfg.browseMaxMinutes)) check.push('duration')
+    if (published === null && cfg.browseRecentDays) check.push('pubdate')
+    if (viewCount === null && cfg.browseMinViews) check.push('views')
+    if (check.length) unknown.push({ bvid: row.bvid || '', fields: check })
+    const topicHits = cfg.browseTopics.filter(topic => topicAliases[topic].some(word => text.includes(word.toLowerCase())))
+    const keywordHits = keywords.filter(word => text.includes(word))
+    candidates.push({ row: { ...row, ...(viewCount !== null ? { view_count: viewCount } : {}), ...(check.length ? { preference_check: check, preference_hint: '日期、时长或播放量缺失，挑选前先读 bili_video_info 核对' } : {}) }, index, published, affinity: topicHits.length + keywordHits.length * 2 })
+  }
+  const compare = cfg.browseSort === 'pubdate' ? (a, b) => (b.published || 0) - (a.published || 0) || a.index - b.index
+    : cfg.browseSort === 'click' ? (a, b) => (videoViewCount(b.row) ?? -1) - (videoViewCount(a.row) ?? -1) || a.index - b.index
+      : (a, b) => a.index - b.index
+  let ordered = candidates.slice().sort(compare)
+  if (cfg.browseSort === 'mixed' && (cfg.browseTopics.length || keywords.length)) {
+    const preferred = ordered.filter(item => item.affinity > 0).sort((a, b) => b.affinity - a.affinity || a.index - b.index)
+    const exploring = ordered.filter(item => item.affinity === 0)
+    ordered = []
+    let p = 0, e = 0
+    for (let index = 0; index < candidates.length; index++) {
+      const explorationSlot = Math.floor((index + 1) * cfg.browseExplorePercent / 100) > Math.floor(index * cfg.browseExplorePercent / 100)
+      ordered.push(explorationSlot && e < exploring.length || p >= preferred.length ? exploring[e++] : preferred[p++])
+    }
+  }
+  return { items: ordered.map(item => item.row), excluded, unknown, settings: cfg }
+}

package/lib/browse-progress.mjs

@@ -0,0 +1,165 @@
+/** Small per-run working memory. Callers own storage and scope; no private text is retained. */
+import { bvidOf } from './ledger.mjs'
+
+const LIMIT = 24
+const READ_RETRY_LIMIT = 3 // initial failure + at most two suggested retries
+const DISCOVERY = new Set(['bili_search', 'bili_rank', 'bili_hot_videos', 'bili_user_videos'])
+const millis = (value) => typeof value === 'number' && Number.isFinite(value) ? value : Date.parse(value) || 0
+const unique = (list, newest = true) => {
+  const ids = [...new Set(list.map(bvidOf).filter(Boolean))]
+  return newest ? ids.slice(-LIMIT) : ids.slice(0, LIMIT)
+}
+const SEND_KINDS = ['comment', 'reply', 'opusReply', 'dm', 'moment']
+const fingerprint = (value) => {
+  let code = 2166136261
+  for (const char of String(value)) code = Math.imul(code ^ char.charCodeAt(0), 16777619)
+  return (code >>> 0).toString(16)
+}
+const sourceOf = (tool, args, result) => ({ tool,
+  key: fingerprint(JSON.stringify([tool, args.keyword || '', args.uid || '', args.rid || '', args.order || '', args.days ?? ''])),
+  page: Number.isSafeInteger(Number(result.page ?? args.page)) ? Math.max(1, Number(result.page ?? args.page)) : 1,
+  hasMore: typeof result.has_more === 'boolean' ? result.has_more : null })
+const dueReads = (state, now) => (state.deferredReads || [])
+  .filter(row => row.retryAt > 0 && row.retryAt <= millis(now) && row.attempts < READ_RETRY_LIMIT).map(row => row.bvid)
+const semantic = ({ updatedAt, revision, ...rest }) => JSON.stringify(rest)
+const sendKind = (tool, args) => tool === 'bili_comment' ? 'comment'
+  : tool === 'bili_reply' ? (args?.rpid && String(args.rpid) !== '0' ? 'reply' : 'comment')
+    : tool === 'bili_reply_opus' ? 'opusReply' : tool === 'bili_dm_reply' || tool === 'bili_deliver' ? 'dm'
+      : tool === 'bili_moment' ? 'moment' : ''
+const blockedReason = (result) => result?.unknown || result?.guard_status === 'unknown' ? 'unknown-result'
+  : result?.quotaReached || result?.limit_reached ? 'quota'
+    : result?.pace || result?.riskCooldown ? (['cooldown', 'quota', 'burst', 'hour', 'gap'].includes(result?.reason) ? result.reason : 'pace')
+      : result?.already_replied ? 'already-sent' : 'unavailable'
+const blockScope = reason => ['cooldown', 'burst'].includes(reason) ? 'all'
+  : ['unknown-result', 'already-sent'].includes(reason) ? 'target' : 'channel'
+
+export function createBrowseProgress(now = Date.now()) {
+  return { phase: 'discover', startedAt: millis(now), updatedAt: millis(now), pendingBvids: [],
+    version: 2, revision: 0, readBvids: [], skippedBvids: [], deferredReads: [], lastBvid: '',
+    emptySources: 0, blockedAttempts: 0, blockedSendKinds: [], lastDiscovery: null }
+}
+
+export function observeBrowseProgress(state, { tool, args = {}, result, now = Date.now() } = {}) {
+  const src = state && typeof state === 'object' ? state : createBrowseProgress(now)
+  const next = { ...createBrowseProgress(now), ...src, version: 2, updatedAt: millis(now),
+    pendingBvids: unique(Array.isArray(src.pendingBvids) ? src.pendingBvids : [], false),
+    readBvids: unique(Array.isArray(src.readBvids) ? src.readBvids : []),
+    skippedBvids: unique(Array.isArray(src.skippedBvids) ? src.skippedBvids : []),
+    deferredReads: (Array.isArray(src.deferredReads) ? src.deferredReads : []).slice(-LIMIT).map(row => ({ ...row })),
+    blockedSendKinds: (Array.isArray(src.blockedSendKinds) ? src.blockedSendKinds : []).map(row => ({ ...row })) }
+  const out = result && typeof result === 'object' ? result : {}
+  if (DISCOVERY.has(tool)) {
+    const rows = Array.isArray(out.fresh) ? out.fresh : out.videos || out.items || out.list || []
+    const known = new Set([...next.readBvids, ...next.skippedBvids, ...next.deferredReads.map(row => row.bvid)])
+    const candidates = (Array.isArray(rows) ? rows : [])
+      .filter(row => !row?.already_seen).map(bvidOf).filter(id => id && !known.has(id))
+    next.pendingBvids = unique([...next.pendingBvids, ...candidates], false)
+    const failed = Boolean(out.error || out.ok === false || out.success === false)
+    next.lastDiscovery = { ...sourceOf(tool, args, out), outcome: candidates.length ? 'found' : failed ? 'error' : 'empty' }
+    if (!failed) next.emptySources = candidates.length ? 0 : Math.min(3, (Number(next.emptySources) || 0) + 1)
+    next.phase = next.pendingBvids.length ? 'read' : 'discover'
+  } else if (tool === 'bili_subtitle') {
+    const bvid = bvidOf(args.bvid)
+    const content = !out.error && out.ok !== false && out.success !== false && Boolean(
+      String(out.text || out.full_text || out.content || '').trim())
+    if (bvid) {
+      next.pendingBvids = next.pendingBvids.filter(id => id !== bvid)
+      next.lastBvid = bvid
+      if (content) {
+        next.deferredReads = next.deferredReads.filter(row => row.bvid !== bvid)
+        next.skippedBvids = next.skippedBvids.filter(id => id !== bvid)
+        next.readBvids = unique([...next.readBvids, bvid])
+        next.phase = 'reflect'
+      } else {
+        const absent = out.preference_skipped === true || (!out.error && out.ok !== false && out.success !== false &&
+          (/没有字幕|无字幕|no (?:available )?subtitles?/i.test(String(out.message || ''))
+            || (Number(out.segments) === 0 && typeof out.text === 'string' && !out.text.trim())))
+        if (absent) {
+          next.deferredReads = next.deferredReads.filter(row => row.bvid !== bvid)
+          next.skippedBvids = unique([...next.skippedBvids, bvid])
+        } else {
+          const previous = next.deferredReads.find(row => row.bvid === bvid)
+          const attempts = Math.min(READ_RETRY_LIMIT, (Number(previous?.attempts) || 0) + 1)
+          const reason = out.guard_status === 'pending' ? 'lease' : 'transport'
+          const waitMs = attempts === 1 ? 30_000 : 120_000
+          const retryAt = attempts < READ_RETRY_LIMIT ? Math.max(millis(now) + waitMs, millis(out.retryAt || out.retry_at)) : 0
+          next.deferredReads = [...next.deferredReads.filter(row => row.bvid !== bvid), { bvid, attempts, retryAt, reason }].slice(-LIMIT)
+        }
+        next.phase = next.pendingBvids.length ? 'read' : 'discover'
+      }
+    }
+  }
+  if (tool === 'bili_pace' && out.kinds && typeof out.kinds === 'object') {
+    const rows = Object.entries(out.kinds).filter(([kind, row]) => SEND_KINDS.includes(kind) && row && typeof row === 'object')
+    for (const [kind, row] of rows) {
+      const previous = next.blockedSendKinds.find(block => block.kind === kind)
+      // An open rate limit does not resolve an uncertain prior send.
+      if (previous?.reason === 'unknown-result') continue
+      next.blockedSendKinds = next.blockedSendKinds.filter(block => block.kind !== kind)
+      if (Number(row.waitSec) > 0) next.blockedSendKinds.push({ kind, scope: blockScope(row.blockedBy),
+        reason: ['cooldown', 'quota', 'burst', 'hour', 'gap'].includes(row.blockedBy) ? row.blockedBy : 'pace',
+        retryAt: millis(row.nextAt) || millis(now) + Math.ceil(Number(row.waitSec)) * 1000 })
+    }
+    // A pace query describes sending availability; it must not discard a fresh reading reaction.
+    if (rows.length && rows.every(([, row]) => Number(row.waitSec) > 0)) {
+      next.blockedAttempts = Math.max(1, Number(next.blockedAttempts) || 0)
+    }
+  }
+  if (tool === 'bili_seen' && args.action === 'mark' && out.ok === true) {
+    const marked = String(args.bvid || '').split(/[,，\s]+/).map(bvidOf).filter(Boolean)
+    next.pendingBvids = next.pendingBvids.filter(id => !marked.includes(id))
+    next.skippedBvids = unique([...next.skippedBvids, ...marked.filter(id => !next.readBvids.includes(id))])
+    next.deferredReads = next.deferredReads.filter(row => !marked.includes(row.bvid))
+    next.phase = next.pendingBvids.length ? 'read' : 'discover'
+  }
+  const kind = sendKind(tool, args)
+  if (kind) {
+    if (out.blocked || out.pace || out.unknown || out.retry_blocked || out.already_replied
+      || out.ok === false || out.success === false || out.error) {
+      next.blockedAttempts = Math.min(999, (Number(next.blockedAttempts) || 0) + 1)
+      const reason = blockedReason(out)
+      const retryAt = millis(out.retryAt || out.retry_at) || (reason === 'unknown-result' ? 0 : millis(now) + 60_000)
+      next.blockedSendKinds = next.blockedSendKinds.filter(row => row.kind !== kind)
+      next.blockedSendKinds.push({ kind, reason, retryAt, scope: out.riskCooldown ? 'all' : blockScope(reason) })
+      next.phase = next.pendingBvids.length ? 'read' : 'discover'
+    } else if (out.ok === true || out.success === true || out.guard_status === 'sent') {
+      next.blockedAttempts = 0
+      next.phase = next.pendingBvids.length ? 'read' : 'discover'
+    }
+  }
+  if (semantic(next) === semantic(src)) return src
+  return { ...next, revision: (Number(src.revision) || 0) + 1 }
+}
+
+export function browseProgressBrief(state, now = Date.now(), { compact = false } = {}) {
+  const src = state || createBrowseProgress(now)
+  const pending = unique([...(Array.isArray(src.pendingBvids) ? src.pendingBvids : []), ...dueReads(src, now)], false)
+  const deferred = (src.deferredReads || []).filter(row => !pending.includes(row.bvid))
+  const blocked = (Array.isArray(src.blockedSendKinds) ? src.blockedSendKinds : [])
+    .filter(row => row.reason === 'unknown-result' || !row.retryAt || row.retryAt > millis(now))
+    .map(row => ({ ...row, scope: blockScope(row.reason) === 'all' ? 'all' : row.scope || blockScope(row.reason) }))
+  let next
+  if (src.phase === 'reflect' && src.lastBvid) next = {
+    action: 'reflect-or-move-on', bvid: src.lastBvid,
+    hint: '刚读完这条。挑一个真实反应，也可以略过。按 blockedSendKinds 避让：scope=all 的整体风控冷却或连发暂停期间只读，停所有发送；只有局部通道或目标受限时，仍可处理原本独立且已授权的互动。不换措辞、接口或通道重试同一次被拦发送，未知结果的同一目标不重试。值得学的记成有适用场景的待审经验，再处理下一个候选。' }
+  else if (pending.length && Number(src.blockedAttempts) >= 1 && blocked.length) next = {
+    action: 'continue-reading', tool: 'bili_subtitle', args: { bvid: pending[0] },
+    hint: '先读这个候选。scope=all 的整体风控冷却或连发暂停期间只读，停所有发送；只有局部通道或目标受限时，才可继续新的阅读与独立且已授权的接话。不换措辞、接口或通道重试同一次被拦发送，未知结果的同一目标不重试。' }
+  else if (pending.length) next = { action: 'read-next', tool: 'bili_subtitle', args: { bvid: pending[0] }, hint: '继续处理剩余候选，无需重新搜索同一批。' }
+  else if (Number(src.emptySources) >= 3) next = { action: 'rest-or-change-source', hint: '连续三个发现请求没有新候选。先整理已看内容或休息；继续探索时换关键词或来源，不重复空查询。' }
+  else if (src.lastDiscovery?.tool === 'bili_search' && src.lastDiscovery.hasMore === true && src.lastDiscovery.page < 50) next = {
+    action: 'search-next-page', tool: 'bili_search', page: src.lastDiscovery.page + 1,
+    hint: `这页候选已经处理完。沿用刚才的关键词和筛选，翻到第 ${src.lastDiscovery.page + 1} 页，不重复第一页。` }
+  else if (src.lastDiscovery?.outcome === 'error') next = { action: 'change-source', hint: '刚才发现请求失败，不能据此说没有视频。先处理别的来源，不重复请求同一个失败入口。' }
+  else if (deferred.length && !Number(src.emptySources)) next = { action: 'discover-or-wait',
+    hint: '还有暂时读不到的候选。先找其他视频；达到建议重试时间后可补查，重试已用完的留给后续人工决定，不连续轮询。' }
+  else next = { action: Number(src.emptySources) ? 'change-source' : 'discover',
+    hint: Number(src.emptySources) ? '这个入口没有新候选。换关键词、分区或发现入口；连续空结果时整理后休息，不要重复同一查询。'
+      : '按这次兴趣找一小批候选。已完成的片翻篇，不为发言数凑任务。' }
+  if (compact) { const { hint, ...briefNext } = next; next = briefNext }
+  const retryTimes = deferred.map(row => row.retryAt).filter(at => at > millis(now))
+  return { phase: src.phase || 'discover', pendingBvids: compact ? pending.slice(0, 3) : pending, pendingCount: pending.length,
+    recentReadCount: (src.readBvids || []).length, recentSkippedCount: (src.skippedBvids || []).length,
+    deferredReadCount: deferred.length, nextReadRetryAt: retryTimes.length ? Math.min(...retryTimes) : 0,
+    blockedAttempts: Number(src.blockedAttempts) || 0, blockedSendKinds: blocked, next }
+}

package/lib/comment.mjs

@@ -1,7 +1,9 @@
 /**
  * Conservative offline checks for empty, excessively long or clearly boilerplate comments.
+ * Short conversational reactions do not need to prove substantive length.
  * Signature words are optional. Flavor scoring is diagnostic unless strictFlavor is explicit.
- * Self-reference streaks and stacked marks are advisories; only repeated actual bodies block.
+ * Quotes, timestamps, signature words and formal vocabulary are style advisories.
+ * Self-reference streaks and stacked marks are advisories; repeated actual bodies block.
  * No network or storage access; the caller supplies recent texts.
  */
 
@@ -17,6 +19,9 @@ const COMMENT_MAX_LEN = 150
 /** 回复正文上限：回复更该短 */
 const REPLY_MAX_LEN = 100
 
+/** A short reaction can be a word, laugh or meme; do not require extra explanatory prose. */
+const SHORT_REACTION_MAX_LEN = 12
+
 /** 鱼味分到这就算"有鱼味"（一个强标记就够） */
 const FLAVOR_MIN = 2
 
@@ -320,8 +325,7 @@ export const templateCheck = (text, history = []) => {
  * @param {{kind?:'comment'|'reply', strictFlavor?:boolean}} [opts]
  * @returns {{ok:true} | {ok:false, reason:string, hint:string, substantive:number, threshold:number}}
  *
- * 放行时**只回 {ok:true}**（不带 reason）—— 宿主是 `if (!q.ok) return {...q}`，
- * 多塞字段会让成功路径也拖一堆噪音。
+ * 放行时可带 warnings，供写作回顾使用；风格建议不要求重写或补口头禅。
  */
 export const commentQuality = (text, opts = {}) => {
   // 只认两种：回复（rpid≠0）门槛更低，新评论按评论级
@@ -336,12 +340,16 @@ export const commentQuality = (text, opts = {}) => {
   const threshold = kind === 'reply' ? REPLY_MIN_SUBSTANTIVE : COMMENT_MIN_SUBSTANTIVE
   const maxLen = kind === 'reply' ? REPLY_MAX_LEN : COMMENT_MAX_LEN
   const len = Array.from(body).length
+  const conversationalText = body.replace(URL_RE, '')
+    .replace(/([)）])[وノﾉงづっつ][✧♪♡♥]*$/u, '$1')
+    .replace(KAOMOJI_RE, '').replace(EMOJI_RE, '').replace(PUNCT_RE, '')
+  const hasText = /[\p{L}\p{N}]/u.test(conversationalText)
 
   // 一、空的：只有标点 / 表情 / 空格
-  if (!body) {
+  if (!body || !hasText) {
     return fail(
       '这条是空的（或者只剩标点、表情）',
-      '至少写一句完整的话，或接住对方刚说的意思。',
+      '想接话就用自己的话说，几个字也可以；没什么想说的就不发。',
       n, threshold,
     )
   }
@@ -350,66 +358,42 @@ export const commentQuality = (text, opts = {}) => {
   if (len > maxLen) {
     return fail(
       `这条 ${len} 个字，超过 ${maxLen} 字上限`,
-      '挑最想说的那一下，砍到一两句。想说的多就拆成回复别人，别攒成一段小作文。',
+      '挑最想说的那一下，砍到一两句。更多内容可以留在笔记里，不用拆成多条发送。',
       n, threshold,
     )
   }
 
-  // 三、剔完口号没剩几个字：纯口号 / 纯打卡 / 纯笑
-  if (n < threshold) {
+  // Short contextual reactions need no filler. Only a longer low-content string still asks to be shortened.
+  if (n < threshold && len > SHORT_REACTION_MAX_LEN) {
     return fail(
-      `剔掉「awsl / 太强了 / 哈哈哈」这类口号以后只剩 ${n} 个字，够不上 ${threshold} 个`,
-      '补一句你自己真看见的东西就行：哪个镜头、哪句台词、你当时什么反应。'
-        + '随口的反应也可以，比如「这个转场我盯了三遍」，不必归纳或打分。',
+      '这条主要是较长的一串重复语气或口号',
+      '收短成你想接的那一句就好，短梗、笑一下都可以；不用补细节、解释笑点或讲道理，也可以不发。',
       n, threshold,
     )
   }
 
   const lower = raw.toLowerCase()
   const strong = strongMarksOf(lower)
+  const warnings = []
 
-  // 三点五、热评解说员：拿别人的赞数起手（v27 真机取证的头号病）
-  //   「684 赞那条才是重点」「13 赞那条长评被埋太深了」—— 这是解说员，不是来冲浪的鱼。
-  //   真人翻到这句只会划走：既没有自己的反应，也没有可接的话。
+  // Opening with somebody else's like count is often repetitive, but can be a valid response.
   if (LIKE_BRAG_RE.test(body)) {
-    return {
-      ok: false,
-      reason: '这条只是在复述别人的赞数（「NNN 赞那条…」）',
-      hint: '把「NNN 赞那条」整段删掉，直接说**你自己**看见的那一下：'
-        + '「这句我念给室友听了」「原来是这样啊，我白看三遍了呜」。'
-        + '想说别人的评论就直接回他，别在自己的评论里点评赞数。',
-      substantive: n,
-      threshold,
-    }
+    warnings.push('like-count-opening')
   }
 
-  // 三点六、原文引用解说员（2026-10-24 m11704 ①）——
-  //   「[01:47]那句才是这段的骨头：『以前就是一勺半』」「UP 那句『求上得中』比骂人狠」——
-  //   使用者点名：评论别引用原视频文字片段，观感不好；自己组织语言，像鲸鱼摸鱼，不像普通路人。
+  // Avoid making every reaction a quoted transcript. A regex cannot judge originality.
   const quoteHit = QUOTE_VIDEO_RE.test(body) || QUOTE_SAY_RE.test(body)
   if (quoteHit) {
-    return {
-      ok: false,
-      reason: '这条在引用原视频的文字片段（时间戳/「UP 那句」+ 引号原话）',
-      hint: '把引号里那段原话删掉，用你自己的话说那一下：'
-        + '「凌晨四点人吵架狗赔命这段看得本鱼呆毛都竖不起来呜」比引用原文更有鱼味。'
-        + '想夸哪一秒，就说那一秒你什么反应，别当字幕搬运工。',
-      substantive: n,
-      threshold,
-    }
+    warnings.push('source-quote')
   }
 
   // An @ mention is not a reason to demand signature vocabulary.
-  // Block clear boilerplate independently of optional flavor scoring.
+  // A few words cannot determine whether a specific response is boilerplate.
   const official = countWords(lower, OFFICIAL_TALK)
   if (official >= OFFICIAL_MAX_TOLERATED && strong === 0) {
-      return fail(
-        '这条堆了多句通用推荐套话，看不出自己的回应',
-        '别写「内容扎实、值得一看」，写你自己：'
-          + '「这个转场我看了三遍」「原来是这个参数啊，我卡了一晚上」。',
-        n, threshold,
-      )
-    }
+    warnings.push('formal-wording')
+  }
+  if (body.includes('——')) warnings.push('em-dash')
 
   if (needFlavor) {
     // Only explicitly requested strict flavor mode requires signature vocabulary.
@@ -417,13 +401,12 @@ export const commentQuality = (text, opts = {}) => {
       return {
         ok: false,
         reason: '这条里没有一点鲸鱼摸鱼的鱼味（太正经了，像通用 AI 在写影评）',
-        hint: '加一样招牌就算过：自称「本鱼 / 本鲸」、颜文字、叠字语气（呜呜 / 嘿嘿 / 诶诶）。'
-          + '注意是用自己的话说那一下（2026-10-24 起引用视频原话会被上面那道闸拦），不用深刻，可爱就够了。',
+        hint: '当前显式启用了 strictFlavor。自然表达不需要固定自称或颜文字；自动浏览应使用默认宽松质量检查。',
         substantive: n,
         threshold,
       }
     }
   }
 
-  return { ok: true }
+  return warnings.length ? { ok: true, warnings } : { ok: true }
 }

package/lib/config-policy.mjs

@@ -1,12 +1,13 @@
 /** Model-authored arguments are preferences, never evidence of human authorization. */
 export const MODEL_CONFIG_KEYS = Object.freeze([
-  'persona', 'focus', 'keywords', 'reportLevel', 'perDay', 'momentStyle', 'interactionStyle',
+  'focus', 'keywords', 'reportLevel', 'perDay', 'momentStyle', 'interactionStyle',
   'idleChatter', 'chatterFrequency', 'notificationLevel', 'focusMode',
   'quietHoursEnabled', 'quietHoursStart', 'quietHoursEnd', 'petReducedMotion', 'petShow',
 ])
 const permitted = new Set(MODEL_CONFIG_KEYS)
 export function modelConfigDecision(patch) {
   const keys = Object.keys(patch || {})
+  if (keys.includes('persona')) return { ok: false, code: 'PERSONA_MANUAL_ONLY', error: '全局人格只能由本人在工作台保存；角色工具不能改写或清空本人的人格设置。' }
   if (keys.includes('sendReview')) return { ok: false, code: 'SEND_REVIEW_MANUAL_ONLY', error: '发送预览开关只能由本人在工作台 → 互动与投递中修改。' }
   if (keys.includes('stickerReview')) return { ok: false, code: 'STICKER_REVIEW_MANUAL_ONLY', error: '表情人工审核开关只能由本人在工作台 → 记忆与素材中修改。' }
   const blockedKeys = keys.filter(key => !permitted.has(key))