@dsh-plus/actual 0.1.0

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@dsh-plus/actual",
+  "version": "0.1.0",
+  "description": "dsh-plus service + UI plugin: Actual Budget 能力发现（@actual-app/cli help 树运行时派生 × 进程内 MCP tools/list）、actual agent 预设注册与配置卡片——零手工工具清单",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/client": "2.3.0",
+    "@dsh-plus/shared": "0.1.34",
+    "@dsh-plus/actual-mcp": "0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5-alpha.1",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.2.1-alpha.1",
+    "@deepseek-ai/schemastery": "^3.18.5-alpha.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.5-alpha.1",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.1",
+    "@deepseek-ai/schemastery": "3.18.5-alpha.1",
+    "@types/react": "~18.3.31",
+    "react": "^18.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/A-G-guy/dsh-plus.git",
+    "directory": "packages/actual"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}

package/src/client/card.tsx

@@ -0,0 +1,230 @@
+/**
+ * 「Actual Budget 连接」配置卡片：经 injectPluginConfigCard 注册（插件页
+ * plugins.row.config / plugins.bundle.config，view 分发 summary/page）。
+ *
+ * 编辑范围只覆盖**非密钥**字段。密钥与高级字段没有编辑器，卡片内给出明确落点
+ * （见 i18n 的 secretsBody / advancedBody）——按《插件开发指南》，可配置项要么
+ * 有编辑器、要么写明为什么没有与改在哪里配。
+ *
+ * 字段按主题拆成两个小节组件，卡片本体只负责外壳、状态与保存动作。
+ * @module @dsh-plus/actual/client/card
+ */
+
+import {
+  CardChrome,
+  CardLoading,
+  CheckRow,
+  type NamespaceSettingsApi,
+  type PluginConfigViewProps,
+  type Scope,
+  SelectField,
+  TextField,
+  useNamespaceDraft,
+} from '@dsh-plus/shared/client'
+import type { ReactElement } from 'react'
+
+import {
+  type ConfigValue,
+  type Draft,
+  type DraftViolation,
+  draftFromValue,
+  patchFromDraft,
+  validateDraft,
+} from './draft.ts'
+import type { Translate } from './i18n.ts'
+
+export interface CardProps extends PluginConfigViewProps {
+  t: Translate
+  scope: Scope
+  api: NamespaceSettingsApi
+}
+
+/** 小节共用的 props。 */
+interface SectionProps {
+  t: Translate
+  draft: Draft
+  disabled: boolean
+  violation: DraftViolation | undefined
+  onEdit(patch: Partial<Draft>): void
+}
+
+/** 模块级稳定函数：参与 useNamespaceDraft 的依赖比较。 */
+function fromValue(value: ConfigValue): Draft {
+  return draftFromValue(value)
+}
+
+function toPatch(draft: Draft): Record<string, unknown> {
+  return patchFromDraft(draft)
+}
+
+/**
+ * 条件式 invalid 属性：`exactOptionalPropertyTypes` 下不可显式传 `invalidLabel: undefined`，
+ * 只能按「有文案才带该键」构造。
+ */
+function violationProps(
+  active: boolean,
+  label: string,
+): { invalid: boolean; invalidLabel?: string } {
+  return active ? { invalid: true, invalidLabel: label } : { invalid: false }
+}
+
+/** 说明段落（无编辑器的字段在此交代落点）。 */
+function Note(props: {
+  title: string
+  body: string
+  snippet?: string
+  tail?: string
+}): ReactElement {
+  return (
+    <div className="act-note">
+      <p className="act-noteTitle">{props.title}</p>
+      <p className="act-noteBody">{props.body}</p>
+      {props.snippet !== undefined ? <code className="act-snippet">{props.snippet}</code> : null}
+      {props.tail !== undefined ? <p className="act-noteBody">{props.tail}</p> : null}
+    </div>
+  )
+}
+
+/** 连接小节：服务器地址、预算、CLI 命令与版本策略。 */
+function ConnectionSection(props: SectionProps): ReactElement {
+  const { t, draft, disabled, violation, onEdit } = props
+  return (
+    <>
+      <TextField
+        prefix="act"
+        id="act-server-url"
+        label={t('serverUrl')}
+        hint={t('serverUrlHint')}
+        value={draft.serverUrl}
+        disabled={disabled}
+        {...violationProps(violation?.field === 'serverUrl', t('serverUrlInvalid'))}
+        onEdit={(value) => onEdit({ serverUrl: value })}
+      />
+      <TextField
+        prefix="act"
+        id="act-sync-id"
+        label={t('syncId')}
+        hint={t('syncIdHint')}
+        value={draft.syncId}
+        disabled={disabled}
+        onEdit={(value) => onEdit({ syncId: value })}
+      />
+      <TextField
+        prefix="act"
+        id="act-cli-command"
+        label={t('cliCommand')}
+        hint={t('cliCommandHint')}
+        value={draft.cliCommand}
+        disabled={disabled}
+        {...violationProps(violation?.field === 'cliCommand', t('cliCommandInvalid'))}
+        onEdit={(value) => onEdit({ cliCommand: value })}
+      />
+      <SelectField
+        prefix="act"
+        id="act-version-policy"
+        label={t('cliVersionPolicy')}
+        hint={t('cliVersionPolicyHint')}
+        value={draft.cliVersionPolicy}
+        options={[
+          { value: 'warn', label: t('policyWarn') },
+          { value: 'strict', label: t('policyStrict') },
+        ]}
+        disabled={disabled}
+        onEdit={(value) => onEdit({ cliVersionPolicy: value === 'strict' ? 'strict' : 'warn' })}
+      />
+    </>
+  )
+}
+
+/** 行为小节：写确认、辅助工具与工具名前缀。 */
+function PolicySection(props: SectionProps): ReactElement {
+  const { t, draft, disabled, violation, onEdit } = props
+  return (
+    <>
+      <CheckRow
+        prefix="act"
+        id="act-confirm-writes"
+        label={t('confirmWrites')}
+        checked={draft.confirmWrites}
+        disabled={disabled}
+        onEdit={(value) => onEdit({ confirmWrites: value })}
+      />
+      <p className="act-noteBody">{t('confirmWritesHint')}</p>
+      <CheckRow
+        prefix="act"
+        id="act-aux-tools"
+        label={t('auxTools')}
+        checked={draft.auxTools}
+        disabled={disabled}
+        onEdit={(value) => onEdit({ auxTools: value })}
+      />
+      <p className="act-noteBody">{t('auxToolsHint')}</p>
+      <TextField
+        prefix="act"
+        id="act-name-prefix"
+        label={t('namePrefix')}
+        hint={t('namePrefixHint')}
+        value={draft.namePrefix}
+        disabled={disabled}
+        {...violationProps(violation?.field === 'namePrefix', t('namePrefixInvalid'))}
+        onEdit={(value) => onEdit({ namePrefix: value })}
+      />
+    </>
+  )
+}
+
+export function ActualCard(props: CardProps): ReactElement | string | null {
+  const { t, scope, api } = props
+  const { draft, dirty, saving, status, disabled, edit, reset, save } = useNamespaceDraft<
+    ConfigValue,
+    Draft
+  >({ scope, api, from: fromValue, patch: toPatch, saveFailedLabel: t('saveFailed') })
+
+  if (props.view === 'summary') return t('summaryLine')
+  if (draft === null) return <CardLoading prefix="act" text={t('loading')} />
+
+  const violation = validateDraft(draft)
+  const section: SectionProps = { t, draft, disabled, violation, onEdit: edit }
+
+  return (
+    <CardChrome
+      prefix="act"
+      title={t('title')}
+      description={t('description')}
+      statusBadge={{ text: t(draft.enabled ? 'enabledOn' : 'enabledOff'), on: draft.enabled }}
+      dirty={dirty}
+      dirtyLabel={t('unsaved')}
+      readOnlyNotice={disabled ? t('readOnly') : undefined}
+      status={status}
+      actions={[
+        { key: 'discard', label: t('discard'), disabled: !dirty || saving, onClick: reset },
+        {
+          key: 'save',
+          label: t(saving ? 'saving' : 'save'),
+          variant: 'primary',
+          disabled: !dirty || saving || violation !== undefined || disabled,
+          onClick: save,
+        },
+      ]}
+    >
+      <CheckRow
+        prefix="act"
+        id="act-enabled"
+        label={t('enabled')}
+        checked={draft.enabled}
+        disabled={disabled}
+        onEdit={(value) => edit({ enabled: value })}
+      />
+      <p className="act-noteBody">{t('enabledHint')}</p>
+      <ConnectionSection {...section} />
+      <PolicySection {...section} />
+      <Note
+        title={t('secretsTitle')}
+        body={t('secretsBody')}
+        snippet={t('secretsSnippet')}
+        tail={t('secretsTail')}
+      />
+      <Note title={t('advancedTitle')} body={t('advancedBody')} />
+    </CardChrome>
+  )
+}

package/src/client/client.ts

@@ -0,0 +1,50 @@
+/**
+ * 浏览器半入口：注册 locale 字典 + 注册「Actual Budget 连接」卡片
+ * （injectPluginConfigCard 两槽位：插件页 plugins.row.config /
+ * plugins.bundle.config）。
+ * 构建产物为 window.__ModuleLoader__.load({id, factory}) 形式的 CJS factory
+ * （包装见 tsdown.config.ts）；样式沿用官方 data-plugin-css 约定，HMR 据此卸载。
+ * 配置读写经 ctx.remote.settings 直连（scope/api 来自 @dsh-plus/shared/client）。
+ * @module @dsh-plus/actual/client
+ */
+import type { Context } from '@deepseek-ai/cordis'
+import {
+  createNamespaceApi,
+  createSettingsScope,
+  injectPluginConfigCard,
+  type PluginClientContext,
+} from '@dsh-plus/shared/client'
+
+import { SETTINGS_NS } from '../ns.ts'
+import { ActualCard } from './card.tsx'
+import { type DictKey, en, NS, zh } from './i18n.ts'
+import { injectStyle } from './styles.ts'
+
+export const name = 'dsh-plus-actual'
+
+/** 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject 管包加载顺序）。 */
+export const inject = ['slots', 'locale', 'remote', 'remote.settings'] as const
+
+/** 宿主窄面收编在 @dsh-plus/shared/client；TKey 传入本包 DictKey 使键名受检。 */
+type ClientContext = PluginClientContext<DictKey>
+
+export function apply(ctx: Context): void {
+  const c = ctx as unknown as ClientContext
+  const tag = injectStyle()
+  c.effect(
+    () => () => {
+      tag?.remove()
+    },
+    'actual: style',
+  )
+  c.effect(() => c.locale.register(NS, { zh, en }), 'actual: locale')
+  const scope = createSettingsScope(c, SETTINGS_NS, 'actual: settings scope')
+  const api = createNamespaceApi(c.get('remote').settings, SETTINGS_NS)
+  injectPluginConfigCard(c.slots, {
+    ns: SETTINGS_NS,
+    rowId: 'dsh-plus-actual',
+    pkg: '@dsh-plus/actual',
+    component: ActualCard,
+    inject: () => ({ t: c.locale.bind(NS), scope, api }),
+  })
+}

package/src/client/draft.ts

@@ -0,0 +1,95 @@
+/**
+ * 卡片草稿的纯转换与校验（无 JSX，`node --test` 可直接测）。
+ *
+ * `cliCommand` 在配置里是 `string[]`（argv 前缀），在卡片里是空格分隔的文本——
+ * 这层转换是卡片唯一容易出错的地方，因此单独成模块并逐例钉住：**不做 shell
+ * 解析**，引号按字面字符处理并直接判非法，避免"看起来支持引号、实际把引号当
+ * 参数一部分"的静默错配。
+ * @module @dsh-plus/actual/client/draft
+ */
+
+/** CLI 与服务端版本不一致时的处置（与宿主 schema 的 union 一致）。 */
+export type CliVersionPolicy = 'warn' | 'strict'
+
+/** settings 命名空间里本卡片负责的字段（其余字段不出现在卡片中）。 */
+export interface ConfigValue {
+  enabled: boolean
+  serverUrl: string
+  syncId: string
+  cliCommand: string[]
+  cliVersionPolicy: CliVersionPolicy
+  confirmWrites: boolean
+  auxTools: boolean
+  namePrefix: string
+}
+
+/** 编辑草稿：`cliCommand` 以文本承载（空格分隔的 argv）。 */
+export interface Draft {
+  enabled: boolean
+  serverUrl: string
+  syncId: string
+  cliCommand: string
+  cliVersionPolicy: CliVersionPolicy
+  confirmWrites: boolean
+  auxTools: boolean
+  namePrefix: string
+}
+
+/** 校验失败的字段与文案键。 */
+export interface DraftViolation {
+  field: 'serverUrl' | 'cliCommand' | 'namePrefix'
+  messageKey: 'serverUrlInvalid' | 'cliCommandInvalid' | 'namePrefixInvalid'
+}
+
+/** argv → 卡片文本（空格分隔）。 */
+export function argvToText(argv: readonly string[]): string {
+  return argv.join(' ')
+}
+
+/** 卡片文本 → argv；纯空白视为「自动探测」（空数组）。 */
+export function textToArgv(text: string): string[] {
+  const trimmed = text.trim()
+  return trimmed === '' ? [] : trimmed.split(/\s+/)
+}
+
+/** 命名空间解析值 → 草稿。 */
+export function draftFromValue(value: ConfigValue): Draft {
+  return {
+    enabled: value.enabled,
+    serverUrl: value.serverUrl,
+    syncId: value.syncId,
+    cliCommand: argvToText(value.cliCommand),
+    cliVersionPolicy: value.cliVersionPolicy,
+    confirmWrites: value.confirmWrites,
+    auxTools: value.auxTools,
+    namePrefix: value.namePrefix,
+  }
+}
+
+/** 草稿 → 命名空间补丁（仅本卡片负责的字段）。 */
+export function patchFromDraft(draft: Draft): Record<string, unknown> {
+  return {
+    enabled: draft.enabled,
+    serverUrl: draft.serverUrl.trim(),
+    syncId: draft.syncId.trim(),
+    cliCommand: textToArgv(draft.cliCommand),
+    cliVersionPolicy: draft.cliVersionPolicy,
+    confirmWrites: draft.confirmWrites,
+    auxTools: draft.auxTools,
+    namePrefix: draft.namePrefix.trim(),
+  }
+}
+
+/** 首个校验问题；全部合法返回 undefined（调用方据此禁用保存）。 */
+export function validateDraft(draft: Draft): DraftViolation | undefined {
+  if (!/^https?:\/\/\S+$/.test(draft.serverUrl.trim())) {
+    return { field: 'serverUrl', messageKey: 'serverUrlInvalid' }
+  }
+  if (/["']/.test(draft.cliCommand)) {
+    return { field: 'cliCommand', messageKey: 'cliCommandInvalid' }
+  }
+  if (!/^[A-Za-z0-9_-]*$/.test(draft.namePrefix.trim())) {
+    return { field: 'namePrefix', messageKey: 'namePrefixInvalid' }
+  }
+  return undefined
+}

package/src/client/i18n.ts

@@ -0,0 +1,128 @@
+/**
+ * 配置卡片文案（zh/en）。经 ctx.locale.register 注册、bind 取用。
+ * 公共键（save/discard/unsaved 等）来自 shared 的 common 字典，本文件只维护业务键。
+ *
+ * 两处说明文案是有意为之的「落点」：密钥与高级字段都没有编辑器，必须在卡片内
+ * 写清「为什么没有、该去哪里配」，否则就是留给用户的空承诺。
+ * @module @dsh-plus/actual/client/i18n
+ */
+import { commonEn, commonZh, mergeDict } from '@dsh-plus/shared/client'
+
+export const NS = 'dsh-plus-actual'
+
+const ownZh = {
+  title: 'Actual Budget 连接',
+  description:
+    '配置本机 Actual 同步服务器与 CLI 行为。改动热生效，无需重载：连接相关字段会触发能力重新发现。',
+  summaryLine: 'Actual 服务器地址、预算 Sync ID、CLI 与工具策略。',
+
+  enabled: '启用 actual 预设',
+  enabledHint: '关闭即不注册该预设（等价插件未安装）；已开的会话保持原组合，新会话起不再出现。',
+
+  serverUrl: '同步服务器地址',
+  serverUrlHint:
+    '自托管默认 http://127.0.0.1:5006。服务端版本从 <地址>/info 读取，用于版本一致性告警。',
+  serverUrlInvalid: '必须是 http(s):// 开头的完整地址',
+
+  syncId: '预算 Sync ID',
+  syncIdHint:
+    'Actual 客户端 → 设置 → 显示高级设置 → Sync ID。留空则读环境变量 ACTUAL_SYNC_ID。多数命令都需要它。',
+
+  cliCommand: 'CLI 命令',
+  cliCommandHint:
+    '留空 = 自动探测（ACTUAL_CLI 环境变量 → PATH 上的 actual → 包内 @actual-app/cli）。需要指定具体副本时填完整 argv，如 node /opt/actual/dist/cli.js（空格分隔，不支持引号）。',
+  cliCommandInvalid: '不支持引号：请直接以空格分隔各个参数',
+
+  cliVersionPolicy: '版本不一致处置',
+  cliVersionPolicyHint:
+    'CLI 与服务端 major.minor 不一致时：warn 告警继续（Actual 服务端只做同步中继，通常仍可用）；strict 直接让发现失败。',
+  policyWarn: 'warn —— 告警并继续',
+  policyStrict: 'strict —— 直接失败',
+
+  confirmWrites: '写操作需确认',
+  confirmWritesHint:
+    '经 DSH 审批策略生效：会话为「每次询问」时弹审批窗；「完全权限」下自动通过（绝不静默拒绝）。',
+  auxTools: '挂载辅助工具',
+  auxToolsHint: '额外提供 web 检索、结构化提问与待办跟踪三件套；它们不改动预算数据。',
+
+  namePrefix: '工具名前缀',
+  namePrefixHint:
+    '模型可见的工具名 = 前缀 + 命令族名（如 actual_accounts）。留空则直接用裸族名——query、server 等过于通用，不建议。',
+  namePrefixInvalid: '只允许字母、数字、下划线与连字符',
+
+  secretsTitle: '服务器口令',
+  secretsBody:
+    '口令属密钥：它不进用户层配置，卡片也不提供输入框（写进来会被脱敏遮蔽，等于白填）。请在 profile 的 cordis.patch.yml 里做行级注入，口令本身放环境变量：',
+  secretsSnippet:
+    '- id: dsh-plus-actual\n  config:\n    syncId: !!js process.env.ACTUAL_SYNC_ID\n    password: !!js process.env.ACTUAL_PASSWORD',
+  secretsTail:
+    '把 ACTUAL_PASSWORD 放进 dsh 服务进程的环境（systemd 的 EnvironmentFile）。官方 CLI 还支持 ACTUAL_PASSWORD_FILE——更适合密钥文件；encrypted 预算另需 ACTUAL_ENCRYPTION_PASSWORD。改动环境变量后需重启 dsh 服务。',
+
+  advancedTitle: '其余字段',
+  advancedBody:
+    '以下字段只在 profile 的 cordis.patch.yml 里配置：预算目录与超时（dataDir / cacheTtl / lockTimeout / toolCallTimeoutMs）、工具暴露与读写判定（allow / deny / readActions / alwaysAsk / readTools）、预设显示与提示词（name / description / order / personaPrefix / includeRuntimeContext）。',
+} as const
+
+const ownEn = {
+  title: 'Actual Budget connection',
+  description:
+    'Configure the local Actual sync server and CLI behaviour. Changes apply hot — connection fields trigger a fresh capability discovery.',
+  summaryLine: 'Actual server address, budget sync ID, CLI and tool policy.',
+
+  enabled: 'Enable the actual preset',
+  enabledHint:
+    'Off stops registering the preset (equivalent to not installed). Live sessions keep their composition; new ones will not see it.',
+
+  serverUrl: 'Sync server URL',
+  serverUrlHint:
+    'Self-hosted default is http://127.0.0.1:5006. The server version is read from <url>/info for the version-mismatch warning.',
+  serverUrlInvalid: 'Must be a full http(s):// URL',
+
+  syncId: 'Budget sync ID',
+  syncIdHint:
+    'Actual client → Settings → Show advanced settings → Sync ID. Empty falls back to the ACTUAL_SYNC_ID environment variable. Most commands need it.',
+
+  cliCommand: 'CLI command',
+  cliCommandHint:
+    'Empty = auto-detect (ACTUAL_CLI env → actual on PATH → bundled @actual-app/cli). To pin a specific copy, give the full argv, e.g. node /opt/actual/dist/cli.js (space-separated, no quotes).',
+  cliCommandInvalid: 'Quotes are not supported: separate arguments with spaces',
+
+  cliVersionPolicy: 'On version mismatch',
+  cliVersionPolicyHint:
+    'When CLI and server major.minor differ: warn keeps going (the Actual server is a sync relay, usually still fine); strict fails discovery outright.',
+  policyWarn: 'warn — alert and continue',
+  policyStrict: 'strict — fail outright',
+
+  confirmWrites: 'Confirm write operations',
+  confirmWritesHint:
+    'Routed through the DSH approval policy: prompts when the session asks every time, passes automatically under full permission (never silently denies).',
+  auxTools: 'Mount auxiliary tools',
+  auxToolsHint:
+    'Adds web search, structured questions and todo tracking; none of them touch budget data.',
+
+  namePrefix: 'Tool name prefix',
+  namePrefixHint:
+    'Model-visible tool name = prefix + command family (e.g. actual_accounts). Empty uses bare family names — query, server and tags are too generic, so a prefix is advised.',
+  namePrefixInvalid: 'Letters, digits, underscore and hyphen only',
+
+  secretsTitle: 'Server password',
+  secretsBody:
+    'The password is a secret: it never enters the user-layer configuration, and this card offers no input for it (a value written here is masked away — filling it in would do nothing). Inject it at the profile row in cordis.patch.yml and keep the value in the environment:',
+  secretsSnippet:
+    '- id: dsh-plus-actual\n  config:\n    syncId: !!js process.env.ACTUAL_SYNC_ID\n    password: !!js process.env.ACTUAL_PASSWORD',
+  secretsTail:
+    'Put ACTUAL_PASSWORD into the dsh service process environment (systemd EnvironmentFile). The official CLI also supports ACTUAL_PASSWORD_FILE, which suits secret files better; an encrypted budget additionally needs ACTUAL_ENCRYPTION_PASSWORD. Restart the dsh service after changing environment variables.',
+
+  advancedTitle: 'Remaining fields',
+  advancedBody:
+    'These are configured only in the profile cordis.patch.yml: budget directory and timeouts (dataDir / cacheTtl / lockTimeout / toolCallTimeoutMs), tool exposure and read/write classification (allow / deny / readActions / alwaysAsk / readTools), and preset display and prompt (name / description / order / personaPrefix / includeRuntimeContext).',
+} as const
+
+export type DictKey = keyof typeof commonZh | keyof typeof ownZh
+
+/** 卡片共用的翻译函数类型（slot 注入的 bind 结果按此消费）。 */
+export type Translate = (key: DictKey) => string
+
+// 标注为 Record<DictKey, string>：en 缺任一键即编译期报错（中英强制对齐）。
+export const zh: Record<DictKey, string> = mergeDict(commonZh, ownZh)
+export const en: Record<DictKey, string> = mergeDict(commonEn, ownEn)

package/src/client/styles.ts

@@ -0,0 +1,23 @@
+/**
+ * 配置卡片样式：基础规则走 @dsh-plus/shared/client 的 cardCss('act')，
+ * 本文件只补插件特有规则（说明段落与代码片段）。
+ * 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载）。
+ * @module @dsh-plus/actual/client/styles
+ */
+import { cardCss, injectCardStyle } from '@dsh-plus/shared/client'
+
+export const PLUGIN_ID = '@dsh-plus/actual'
+
+const extraCss = `
+.act-note{margin:14px 0 0;padding:10px 12px;border-radius:8px;background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2)}
+.act-noteTitle{margin:0 0 6px;font-size:13px;font-weight:600}
+.act-noteBody{margin:0;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.6}
+.act-snippet{display:block;margin:8px 0 0;padding:8px 10px;border-radius:6px;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family-mono,monospace);font-size:11px;line-height:1.5;white-space:pre;overflow-x:auto}
+`
+
+export const cardCssAll = cardCss('act', extraCss)
+
+/** 幂等注入样式标签；返回标签（已存在或环境无 document 时为 null）。 */
+export function injectStyle(): HTMLStyleElement | null {
+  return injectCardStyle(PLUGIN_ID, cardCssAll)
+}