@v587d/capital-generation 2.13.0 → 2.13.1

package/automation/defaults.js

@@ -69,3 +69,7 @@ export const RUN_STATUSES = [
 
 export const ACTIVE_RUN_STATUSES = ['queued', 'starting', 'running']
 export const TERMINAL_RUN_STATUSES = RUN_STATUSES.filter((status) => !ACTIVE_RUN_STATUSES.includes(status))
+
+// A finished turn can be settled from its durable checkpoint; `unknown_after_restart`
+// stays the fallback for runs with no provable turn boundary.
+export const SETTLED_RUN_STATUSES = ['succeeded', 'failed', 'canceled', 'timed_out', 'blocked_requires_user']

package/automation/index.js

@@ -13,7 +13,7 @@ import { createAutomationStore, domainSpec, ROUTE_PATH } from './store.js'
 import { createAutomationRouteHandler } from './route.js'
 import { resolveAutomationSettings } from './settings.js'
 import { installAutomationPolicy } from './policy.js'
-import { createTradingCalendar } from './calendar.js'
+import { createCalendarSource } from './calendar-source.js'
 import { createWorkspaceCatalog } from './workspaces.js'
 import { sanitizeMessage } from './redact.js'
 
@@ -38,13 +38,17 @@ function safeSegment(value) {
  */
 export function createAutomationRuntime(options) {
   const { ctx, profile, storageDomain, settings, now = () => Date.now(), logger, version = versionOf() } = options
-  const calendar = options.calendar ?? createTradingCalendar()
   const getSettings = typeof settings === 'function' ? settings : () => resolveAutomationSettings(ctx, settings)
   const rawProfileName = String(profile.name)
   const displayName = rawProfileName.slice(0, 200)
   const home = profile.home ?? profile.dir ?? process.cwd()
   const runDir = profile.runDir ?? join(home, 'automation-workspace', safeSegment(displayName))
   const ownerDir = profile.ownerDir ?? join(home, 'storages', 'capital-automation-locks')
+  const calendar = options.calendar ?? createCalendarSource({
+    cacheDir: join(home, 'storages', 'capital-automation-calendar'),
+    logger,
+    now,
+  })
   const policyContext = options.policyContext ?? ctx
   const workspaces = createWorkspaceCatalog({ ctx, displayName, runDir, logger })
   const store = createAutomationStore({
@@ -156,6 +160,7 @@ export function apply(ctx) {
           activeService = undefined
         }
         await created.scheduler.stop().catch(() => {})
+        created.calendar.dispose?.()
         await created.runner.dispose?.()
         await created.store.close().catch(() => {})
       }, 'capital-automation: runtime')

package/automation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-automation",
-  "version": "2.13.0",
+  "version": "2.13.1",
   "description": "CapGen 投研自动化：独立 host bundle（固定 capital_automation 域、单 scheduler owner、/capital-automation 路由与浏览器页面）。",
   "license": "MIT",
   "type": "module",
@@ -34,6 +34,7 @@
     "builtins.js",
     "time.js",
     "calendar.js",
+    "calendar-source.js",
     "owner.js",
     "store.js",
     "service.js",

package/automation/runner.js

@@ -4,7 +4,7 @@
  * Dataset. Session creation failing still leaves a visible synthetic failed run.
  */
 import { mkdir } from 'node:fs/promises'
-import { CANCEL_GRACE_MS, MAX_ERRORS_PER_RUN, QUIET_SETTLE_MS } from './defaults.js'
+import { CANCEL_GRACE_MS, MAX_ERRORS_PER_RUN, QUIET_SETTLE_MS, SETTLED_RUN_STATUSES } from './defaults.js'
 import { sanitizeMessage } from './redact.js'
 
 const PRESET_ID = 'capital-generation'
@@ -210,6 +210,38 @@ export function createRunRunner(options) {
     return updated
   }
 
+  // The 750ms settle window is not durable. Persist the turn boundary before waiting so a
+  // restart cannot turn a finished turn into unknown_after_restart.
+  function checkpointTurn(entry, phase, turn, at) {
+    const turnState = {
+      phase,
+      turn: Number.isSafeInteger(turn) ? turn : 0,
+      at: iso(Number.isFinite(at) ? at : now()),
+    }
+    const patch = { turnState }
+    if (phase === 'ended') {
+      turnState.status = outcomeOf(entry)
+      patch.steps = entry.steps
+      patch.toolCalls = entry.toolCalls
+      patch.blockedRequiresUser = entry.blocked === true
+      if (entry.summary !== undefined) patch.summary = entry.summary
+    }
+    void store.updateRun(entry.run.id, patch)
+      .then((updated) => { if (updated !== undefined) entry.run = updated })
+      .catch((error) => logger?.warn?.(`capital-automation: turn checkpoint failed: ${String(error)}`))
+  }
+
+  function settledStatusOf(entry) {
+    if (entry.turnActive === true) return undefined
+    if (entry.lastTurnEnd !== undefined) {
+      const status = outcomeOf(entry)
+      if (status !== 'unknown_after_restart') return status
+    }
+    const turn = entry.run.turnState
+    if (turn?.phase === 'ended' && SETTLED_RUN_STATUSES.includes(turn.status)) return turn.status
+    return undefined
+  }
+
   async function flushSessionBounded(agent) {
     const sessions = service(ctx, 'sessions')
     const flush = sessions?.flush
@@ -401,12 +433,13 @@ export function createRunRunner(options) {
 
   function countedEventKey(session, event) {
     const sessionId = typeof session?.id === 'string' ? session.id : ''
+    const data = event.data ?? event
     if (Number.isSafeInteger(event.seq)) return `${sessionId}:seq:${event.seq}`
-    if ((event.type === 'tool/call' || event.type === 'tool/ptc-dispatch') && typeof event.callId === 'string') {
-      return `${sessionId}:${event.type}:${event.callId}`
+    if ((event.type === 'tool/call' || event.type === 'tool/ptc-dispatch') && typeof data.callId === 'string') {
+      return `${sessionId}:${event.type}:${data.callId}`
     }
-    if (event.type === 'step/start' && Number.isSafeInteger(event.turn) && Number.isSafeInteger(event.step)) {
-      return `${sessionId}:step:${event.turn}:${event.step}`
+    if (event.type === 'step/start' && Number.isSafeInteger(data.turn) && Number.isSafeInteger(data.step)) {
+      return `${sessionId}:step:${data.turn}:${data.step}`
     }
     return undefined
   }
@@ -426,7 +459,16 @@ export function createRunRunner(options) {
     if (event === undefined || typeof event.type !== 'string') return
     const entry = entryForSession(session)
     if (entry === undefined || entry.finished) return
+    const data = event.data ?? event
     const rootEvent = session?.id === entry.sessionId
+    if (event.type === 'turn/start') {
+      armIdle(entry)
+      if (!rootEvent) return
+      entry.lastTurnEnd = undefined
+      entry.turnActive = true
+      checkpointTurn(entry, 'running', data.turn, event.time)
+      return
+    }
     if (event.type === 'step/start') {
       if (!countEventOnce(entry, session, event)) return
       armIdle(entry)
@@ -444,7 +486,7 @@ export function createRunRunner(options) {
       if (!countEventOnce(entry, session, event)) return
       armIdle(entry)
       entry.toolCalls += 1
-      if (typeof event.callId === 'string' && typeof event.name === 'string') entry.toolNames.set(event.callId, event.name)
+      if (typeof data.callId === 'string' && typeof data.name === 'string') entry.toolNames.set(data.callId, data.name)
       if (entry.toolCalls > entry.task.limits.maxToolCalls) {
         void cancelEntry(entry, 'automation_tool_limit', 'failed', {
           phase: 'timeout',
@@ -456,28 +498,30 @@ export function createRunRunner(options) {
     }
     if (event.type === 'tool/result') {
       armIdle(entry)
-      if (event.message?.isError !== true) return
-      const tool = entry.toolNames.get(event.callId)
+      if (data.message?.isError !== true) return
+      const tool = entry.toolNames.get(data.callId)
       pushError(entry, {
         phase: 'tool',
-        code: event.error?.code ?? 'tool_error',
-        message: event.error?.reason ?? '工具调用失败。',
+        code: data.error?.code ?? 'tool_error',
+        message: textOfMessage(data.message) || '工具调用失败。',
         ...(tool === undefined ? {} : { tool }),
-        ...(typeof event.callId === 'string' ? { callId: event.callId } : {}),
+        ...(typeof data.callId === 'string' ? { callId: data.callId } : {}),
       })
       return
     }
     if (event.type === 'assistant/message') {
       armIdle(entry)
       if (!rootEvent) return
-      const text = textOfMessage(event.message)
+      const text = textOfMessage(data.message)
       if (text.length > 0) entry.summary = sanitizeMessage(text).slice(0, MAX_SUMMARY_CHARS)
       return
     }
     if (event.type === 'turn/end') {
       armIdle(entry)
       if (!rootEvent) return
-      entry.lastTurnEnd = { turn: event.turn, reason: event.reason }
+      entry.lastTurnEnd = { turn: data.turn, reason: data.reason }
+      entry.turnActive = false
+      checkpointTurn(entry, 'ended', data.turn, event.time)
       void maybeComplete(entry)
     }
   }
@@ -584,6 +628,15 @@ export function createRunRunner(options) {
 
   async function abandonEntry(entry, controller) {
     if (entry.abandonPromise !== undefined) return entry.abandonPromise
+    const settled = entry.finished ? undefined : settledStatusOf(entry)
+    if (settled !== undefined) {
+      entry.abandoned = true
+      entry.abandonPromise = (async () => {
+        await finalize(entry, settled)
+        await stopEntryAgent(entry, controller)
+      })()
+      return entry.abandonPromise
+    }
     entry.abandoned = true
     entry.finished = true
     clearTimers(entry)
@@ -603,7 +656,7 @@ export function createRunRunner(options) {
             phase: 'session',
             severity: 'warning',
             code: 'unknown_after_restart',
-            message: '自动化 runtime 结束时无法证明本轮运行已经结束；未自动重试。',
+            message: '自动化 runtime 结束时无法证明本轮运行已经结束，结果未知；为避免重复执行，未自动重试。',
           }].slice(-MAX_ERRORS_PER_RUN),
         }).catch(() => {})
       }
@@ -662,6 +715,7 @@ export function createRunRunner(options) {
       promptController: undefined,
       summary: undefined,
       lastTurnEnd: undefined,
+      turnActive: false,
       promptAccepted: false,
       finished: false,
       completing: false,

package/automation/scheduler.js

@@ -140,7 +140,7 @@ export function createScheduler(options) {
       recovered = true
       try {
         state.recoveredRuns = await store.recoverNonTerminalRuns()
-        if (state.recoveredRuns > 0) logger?.warn?.(`capital-automation: ${state.recoveredRuns} 个上次进程的运行已标记 unknown_after_restart`)
+        if (state.recoveredRuns > 0) logger?.warn?.(`capital-automation: ${state.recoveredRuns} 个上次进程的运行已恢复收口；无回合边界的记 unknown_after_restart`)
       } catch (error) {
         state.lastError = String(error)
       }
@@ -168,7 +168,7 @@ export function createScheduler(options) {
       await store.addNotification({
         kind: 'calendar_unavailable',
         title: `交易日历不可用：${task.title}`.slice(0, 120),
-        message: '任务已按 fail-closed 跳过；请更新交易日历表后再启用。',
+        message: '任务已按 fail-closed 跳过；日历更新后会自动恢复，持续出现请检查网络或交易所公告。',
         runId: run.id,
         taskId: task.id,
       }).catch(() => {})
@@ -181,6 +181,9 @@ export function createScheduler(options) {
     const latest = previousOccurrenceAtOrBefore(task.trigger, now(), { calendar })
     if (latest.kind === 'none') return
     if (latest.kind === 'calendar_unavailable') {
+      // A refresh already in flight can still answer today; burning the occurrence on a
+      // transient unknown would turn a slow fetch into a skipped run.
+      if (calendar?.pendingRefresh?.() === true) return
       const key = `${store.profileKey}:calendar:${latest.localDate}`
       if (task.lastHandledOccurrenceKey === key) return
       await createSkipped(task, key, 'skipped_calendar_unavailable', undefined, {
@@ -292,6 +295,13 @@ export function createScheduler(options) {
     tickInFlight = (async () => {
       try {
         if (!(await tryAcquire())) return
+        // Calendar refresh rides the tick but never blocks it; occurrence math reads the
+        // last good snapshot and keeps failing closed while a fetch is in flight.
+        try {
+          calendar?.refreshIfStale?.()
+        } catch (error) {
+          state.lastError = String(error)
+        }
         if (timer !== undefined && currentTickMs !== Math.max(30_000, settings().tickMs)) armTick()
         state.lastTickAt = iso(now())
         const tasks = await store.listTasks()
@@ -318,6 +328,14 @@ export function createScheduler(options) {
   }
 
   async function start() {
+    if (stopped) return
+    if (typeof calendar?.ready === 'function') {
+      // Never start the first tick on a calendar that cannot answer today: a network fetch
+      // gets one bounded chance before fail-closed would claim the day's occurrence.
+      await calendar.ready().catch((error) => {
+        logger?.warn?.(`capital-automation: 交易日历初始化失败：${sanitizeMessage(String(error))}`)
+      })
+    }
     if (stopped) return
     await tick()
     if (stopped) return

package/automation/schema.js

@@ -167,6 +167,21 @@ export const RunErrorSchema = z.strictObject({
   callId: z.string().max(120).optional(),
 })
 
+/** Durable turn boundary: recovery must distinguish an interrupted turn from a finished one. */
+export const TurnStateSchema = z.strictObject({
+  phase: z.enum(['running', 'ended']),
+  turn: z.number().int().min(0),
+  status: z.enum(RUN_STATUSES).optional(),
+  at: isoInstant,
+}).superRefine((state, ctx) => {
+  if (state.phase === 'ended' && state.status === undefined) {
+    ctx.addIssue({ code: 'custom', message: 'ended turn state requires status' })
+  }
+  if (state.phase === 'running' && state.status !== undefined) {
+    ctx.addIssue({ code: 'custom', message: 'running turn state must not carry status' })
+  }
+})
+
 export const RunRecordSchema = z.strictObject({
   schemaVersion: z.literal(1),
   id: z.string().min(1).max(80),
@@ -180,6 +195,7 @@ export const RunRecordSchema = z.strictObject({
   status: z.enum(RUN_STATUSES),
   sessionId: z.string().min(1).max(120).optional(),
   sessionTitle: z.string().min(1).max(200).optional(),
+  turnState: TurnStateSchema.optional(),
   queuedAt: isoInstant,
   startedAt: isoInstant.optional(),
   finishedAt: isoInstant.optional(),

package/automation/store.js

@@ -23,9 +23,11 @@ import {
   DEFAULT_MAX_STEPS,
   DEFAULT_MAX_TOOL_CALLS,
   DEFAULT_RUN_TIMEOUT_MINUTES,
+  MAX_ERRORS_PER_RUN,
   MAX_NOTIFICATIONS_PER_PROFILE,
   MAX_RUNS_PER_PROFILE,
   MAX_RUNS_PER_TASK,
+  SETTLED_RUN_STATUSES,
 } from './defaults.js'
 import { canonicalTrigger, formatInZone, nextOccurrence } from './time.js'
 
@@ -591,33 +593,56 @@ export function createAutomationStore(options) {
     return record?.profileKey === profileKey ? record : undefined
   }
 
-  /** Startup recovery: no live Agent owns a previous-process run, so never retry it silently. */
+  /**
+   * Startup recovery: a durable turn boundary proves how the run ended. Only runs with no
+   * finished turn are left unknown (and never retried silently).
+   */
   async function recoverNonTerminalRuns() {
     const tables = await ensure()
     const at = iso(now())
+    const outcomes = new Map()
     let recovered = 0
     for (const [id, run] of [...tables.runs.entries()]) {
       if (!ownRun(run) || !isActiveRun(run.status)) continue
+      const turn = run.turnState
+      const settled = turn?.phase === 'ended' && SETTLED_RUN_STATUSES.includes(turn.status) ? turn.status : undefined
+      const status = settled ?? 'unknown_after_restart'
+      const finishedAt = settled === undefined ? at : turn.at
+      const errors = settled === undefined
+        ? [...run.errors, {
+            at: finishedAt,
+            phase: 'session',
+            severity: 'warning',
+            code: 'unknown_after_restart',
+            message: '进程重启时无法证明本轮运行已经结束，结果未知；为避免重复执行，未自动重试。',
+          }].slice(-MAX_ERRORS_PER_RUN)
+        : status === 'succeeded'
+          ? run.errors
+          : [...run.errors, {
+              at: finishedAt,
+              phase: 'session',
+              severity: 'warning',
+              code: 'recovered_after_restart',
+              message: `进程重启前回合已结束（${status}）；按该终态收口。`,
+            }].slice(-MAX_ERRORS_PER_RUN)
       const next = parseStrict(RunRecordSchema, {
         ...run,
-        status: 'unknown_after_restart',
-        finishedAt: at,
-        durationMs: Math.max(0, Date.parse(at) - Date.parse(run.queuedAt)),
-        errors: [...run.errors, {
-          at,
-          phase: 'session',
-          severity: 'warning',
-          code: 'unknown_after_restart',
-          message: '进程重启时无法证明本轮运行已经结束；未自动重试。',
-        }].slice(-20),
+        status,
+        finishedAt,
+        durationMs: Math.max(0, Date.parse(finishedAt) - Date.parse(run.startedAt ?? run.queuedAt)),
+        ...(status === 'blocked_requires_user' ? { blockedRequiresUser: true } : {}),
+        errors,
       }, 'run')
       await tables.runs.put(id, next)
+      if (settled !== undefined) outcomes.set(id, status)
       recovered += 1
     }
     for (const [id, attempt] of [...tables.attempts.entries()]) {
       if (attempt.profileKey !== profileKey) continue
       if (!['claimed', 'session_created', 'prompt_submitted'].includes(attempt.state)) continue
-      const next = parseStrict(AttemptRecordSchema, { ...attempt, state: 'unknown', updatedAt: at }, 'attempt')
+      const status = outcomes.get(attempt.runId)
+      const state = status === undefined ? 'unknown' : status === 'failed' ? 'failed' : 'accepted'
+      const next = parseStrict(AttemptRecordSchema, { ...attempt, state, updatedAt: at }, 'attempt')
       await tables.attempts.put(id, next)
     }
     return recovered

package/chart-ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-charts",
-  "version": "2.13.0",
+  "version": "2.13.1",
   "description": "自动模式的图表前端组件（浏览器半边 + 序列旁路路由）：由 @v587d/capital-generation 随包携带并作为 host 平面行挂载。",
   "license": "MIT",
   "type": "module",

package/config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/config",
-  "version": "2.13.0",
+  "version": "2.13.1",
   "description": "自动模式的取数凭据与偏好配置行：卡片坐在 @v587d/capital-generation 插件主页的「配置」段，点这一行本身没有表单。",
   "license": "MIT",
   "type": "module",

package/lib/sources/wind-mcp.js

@@ -462,8 +462,8 @@ function createWindSource(options) {
         execute: (request, signal) => options.execute(client, normalize(request.params), signal),
     };
 }
-const EDB_SEARCH_DESCRIPTION = 'Wind EDB（经济数据库）指标**检索**：只找指标不取数，一行一个候选指标（code/name/unit/freq/source + 该序列的起止与更新日期）。这是 fuyao 与东财都没有的面：宏观、行业、汇率、全球序列。⛔ question 走后端 NER，字面请求不等于字面结果——实测「人民币兑美元汇率 指标」回的是**美元兑人民币**（source 为 美联储 / 台湾统计局），先核对 name 与 source 再取数。键集随指标族变化：实测汇率类没有 unit/magnitude/currency 三个键，缺的一律 null，不猜单位。取数走 wind_edb_query：确定性靠"先 search 拿 code、再按 code 取数"这两步拿到，不是靠 NL 稳定。没有匹配时返回 0 行，是合法空结果不是失败。';
-const EDB_QUERY_DESCRIPTION = 'Wind EDB 时间序列**取数**：上游回 {meta, date[], value[]} 并行数组，本能力转置成**一行一个观测期**（meta 逐行拼接，多指标可分次取后按 code 拼对比）。⛔ indicator 一次只填**一个**指标代码或一条中文问句：2026-10-06 实测逗号分隔的多码挂满 60 秒无应答，上游"多个代码用英文逗号分隔"的说法不成立，要多个就分次调用。start_date/end_date 必填——上游在日期区间与 observation 之间二选一，而 observation 实测"给 3 期只回 2 期"、期数不可信，本能力直接拒绝它。report_date 由上游紧凑串 20260731 归一而来，report_date_ms 按 Asia/Shanghai 零点（EDB 的日期本身没有时区）。unit 是上游单位原文；后端 INVALID 一律 null，**不得当 0 参与计算**。已实测指标代码直接当 indicator 与同义中文问句回同一份序列（M0000612 = 中国 CPI 当月同比）：先 wind_edb_search 拿码再回来，确定性就在这两步。';
+const EDB_SEARCH_DESCRIPTION = 'Wind EDB（经济数据库）指标**检索**：只找指标不取数，一行一个候选指标（code/name/unit/freq/source + 该序列的起止与更新日期）。这是 fuyao 与东财都没有的面：宏观、行业、汇率、全球序列。⛔ question 走后端 NER，字面请求不等于字面结果——实测「人民币兑美元汇率 指标」回的是**美元兑人民币**（source 为 美联储 / 台湾统计局），先核对 name 与 source 再取数。键集随指标族变化：实测汇率类没有 unit/magnitude/currency 三个键，缺的一律 null，不猜单位。⛔ 只在不确定指标叫什么、或需要候选清单时用：已知指标（美元指数、WTI 原油价格…）直接走 wind_edb_query 的中文问句，取数结果每行本来就带 code/name/source，不必先检索——两个能力都按次消耗上游积分，为已知指标多打一次 search 是纯浪费。没有匹配时返回 0 行，是合法空结果不是失败。';
+const EDB_QUERY_DESCRIPTION = 'Wind EDB 时间序列**取数**：上游回 {meta, date[], value[]} 并行数组，本能力转置成**一行一个观测期**（meta 逐行拼接，多指标可分次取后按 code 拼对比）。⛔ indicator 一次只填**一个**指标代码或一条中文问句：2026-10-06 实测逗号分隔的多码挂满 60 秒无应答，上游"多个代码用英文逗号分隔"的说法不成立，要多个就分次调用。start_date/end_date 必填——上游在日期区间与 observation 之间二选一，而 observation 实测"给 3 期只回 2 期"、期数不可信，本能力直接拒绝它。report_date 由上游紧凑串 20260731 归一而来，report_date_ms 按 Asia/Shanghai 零点（EDB 的日期本身没有时区）。unit 是上游单位原文；后端 INVALID 一律 null，**不得当 0 参与计算**。已实测指标代码与同义中文问句回同一份序列（M0000612 = 中国 CPI 当月同比）：indicator 直接填中文问句即可（官方口径就是自然语言取数），本能力按次消耗上游积分，已知指标不要先检索。中文问句可能命中同族多个指标（实测「黄金价格」回伦敦定盘 / COMEX / SGE 等 7 条），返回行自带 code/name/unit/source，按 name 与 source 取舍后再引用；只有不知道指标叫什么、需要候选清单时才用 wind_edb_search。';
 const KLINE_DESCRIPTION = 'Wind K 线：单只标的按**日期区间**取 日/周/月 与 1/5/15/30 分钟。相对腾讯的增量（§6.6.1）：按日期区间取 640 根之前的历史、每根带成交额/成交量/换手/均价的美股 K 线、以及分钟档；⚠️ **分钟档只有 A 股取到过行**，港股与美股的分钟到 2026-10-06 为止四次全挂、仍未证实，要港美股分时先小范围试一次。港美股日线与快照请走 tencent_*。⛔ code 必须自带交易所后缀（600519.SH / 00700.HK / AAPL.O），本能力不猜后缀——实测 AAPL.O 与 AAPL.N 回完全相同的行（后缀不参与解析），所以 BRK.B 一类双市场代码有认错标的的风险；每行的 code 只是请求写法回显，上游 K 线表里没有代码列。⛔ period 只放逐档打过真报文的七档，60 分钟实测两次都挂满超时、不提供。adjust 只有 none 与 qfq：后复权以 afdate 为锚向未来放大，锚默认成今天会得到一个逐位等于不复权却叫 hfq 的序列，所以宁可不给；qfq 的 afdate 由本能力锁成当日，因此 end_date 不得晚于当日；分钟档只允许 none。close 来自上游 MATCH 列（Wind 没有 CLOSE 列）；上游多给的列不收录，行里以 output_fields 为准。数值列上游全是字符串（columns[].type 却一律写 string），解析不了即失败。time_ms 按**该行自带偏移**换算（A股/港股 +08:00、美股 -04:00 是交易所当地时间），整段按北京时间处理会让美股错位 12 小时。⚠️ volume 实测 A 股是**股**（腾讯 A 股 K 线是手，跨源先换）；turnover_rate_pct 是百分数原值（0.2892 = 0.2892%），上游不给它的单位与分母口径。非交易日快回 0 行、是合法成功（实测 A 股国庆休市日 653ms 回空表）；而"该日该市场分钟尚未落地"与上游故障都表现为挂到 12 秒超时（wind_upstream_timeout）——不要盲目重试同一区间，改更早日期或改走日线。积分计费：AUTH/RATE_LIMIT/后端错误一律不自动重试。';
 export function createWindSources(resolveApiKey) {
     return [
@@ -496,7 +496,7 @@ export function createWindSources(resolveApiKey) {
             inputSchema: {
                 type: 'object',
                 properties: {
-                    indicator: { type: 'string', maxLength: 200, description: '一个 EDB 指标代码（如 M0000612，先走 wind_edb_search 拿码）或一条中文指标问句；不接受逗号分隔的多个' },
+                    indicator: { type: 'string', maxLength: 200, description: '一条中文指标问句（推荐，写清实体与口径，如「美元指数」「WTI 原油价格」），或一个已知的 EDB 指标代码（如 M0000612）；一次只填一个，不接受逗号分隔的多个' },
                     start_date: { type: 'string', description: '起始日期 YYYY-MM-DD（含）' },
                     end_date: { type: 'string', description: '结束日期 YYYY-MM-DD（含）' },
                 },

package/lib/web-retriever/local-fetch.d.ts

@@ -3,7 +3,7 @@
  * Known limit: DNS resolves per request but the IP is not pinned to the connection,
  * so a rebinding window remains (same trade-off as dsh-search-first).
  */
-export declare const LOCAL_FETCH_CLIENT_VERSION = "2.13.0";
+export declare const LOCAL_FETCH_CLIENT_VERSION = "2.13.1";
 export declare const LOCAL_FETCH_MAX_URL_LENGTH = 2048;
 export type LocalFetchErrorCode = 'ABORTED' | 'TIMEOUT' | 'INVALID_URL' | 'BLOCKED_URL' | 'DNS' | 'REDIRECT' | 'HTTP' | 'TOO_LARGE' | 'UNSUPPORTED_CONTENT_TYPE';
 export declare class LocalFetchError extends Error {

package/lib/web-retriever/local-fetch.js

@@ -4,7 +4,7 @@
  * so a rebinding window remains (same trade-off as dsh-search-first).
  */
 import { htmlToMarkdown, stripInvisibleText } from './html-markdown.js';
-export const LOCAL_FETCH_CLIENT_VERSION = '2.13.0';
+export const LOCAL_FETCH_CLIENT_VERSION = '2.13.1';
 export const LOCAL_FETCH_MAX_URL_LENGTH = 2048;
 export class LocalFetchError extends Error {
     code;

package/lib/web-retriever/wind-client.d.ts

@@ -35,7 +35,7 @@ export interface WindCallResult {
     code?: WindErrorCode;
 }
 /** Must match `package.json` version; a test pins the two together. */
-export declare const WIND_CLIENT_VERSION = "2.13.0";
+export declare const WIND_CLIENT_VERSION = "2.13.1";
 export interface WindClient {
     callTool(toolName: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<WindCallResult>;
 }

package/lib/web-retriever/wind-client.js

@@ -19,7 +19,7 @@ export const WIND_SERVER_ENDPOINTS = {
     analytics_data: 'https://mcp.wind.com.cn/vserver_analytics_data/mcp/',
 };
 /** Must match `package.json` version; a test pins the two together. */
-export const WIND_CLIENT_VERSION = '2.13.0';
+export const WIND_CLIENT_VERSION = '2.13.1';
 function errorText(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-generation",
-  "version": "2.13.0",
+  "version": "2.13.1",
   "description": "Capital Generation：面向中国散户的 AI 投资助手插件（自动模式 Agent Preset）",
   "icon": "assets/cg-icon.png",
   "author": "v587d",
@@ -152,6 +152,7 @@
     "smoke:fuyao": "node scripts/smoke-fuyao.mjs",
     "smoke:wind": "node scripts/smoke-wind.mjs",
     "smoke:local-fetch": "node scripts/smoke-local-fetch.mjs",
+    "smoke:calendar": "node scripts/smoke-calendar.mjs",
     "contract:probe": "node scripts/contract-probe.mjs",
     "docs:capabilities": "npm run build && node scripts/gen-capability-table.mjs",
     "verify:sessions": "node scripts/verify-sessions.mjs",

package/watchlist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/watchlist",
-  "version": "2.13.0",
+  "version": "2.13.1",
   "description": "自动模式的用户自选股（宿主级清单 + Fuyao 报价快照 + /capital-watchlist 路由 + 输入框菜单弹窗）：由 @v587d/capital-generation 随包携带并作为 host 平面行挂载。",
   "license": "MIT",
   "type": "module",