@modesto_ma/dsh-channels 0.5.0-beta.4 → 0.5.0-beta.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modesto_ma/dsh-channels",
-  "version": "0.5.0-beta.4",
+  "version": "0.5.0-beta.5",
   "description": "DeepSeek Harness (DSH) 飞书渠道插件：一个 dsh 实例对应一个飞书机器人，私聊/群聊/话题群 @ 触发会话，话题绑定 session，卡片 2.0 流式回复；Web 设置里提供「飞书渠道」状态与常用配置面板",
   "repository": {
     "type": "git",

package/src/client/number-field.ts

@@ -0,0 +1,97 @@
+/**
+ * 浏览器半区的 `number` 字段辅助：按 Host 描述的 `scale` 在显示单位与存储
+ * 单位之间换算、保存前校验上下界，以及字节数的 MiB 读数。
+ *
+ * 不含 JSX/React，便于单测。Host 保存时按 config schema 复核。
+ *
+ * @module dsh-channels/client/number-field
+ */
+
+import { fillCopy, PANEL_COPY } from '../settings/contract.ts'
+import type { ConfigValue, EditableFieldWire } from '../settings/contract.ts'
+
+/** Drop float noise from `stored / scale` (e.g. 0.30000000000000004). */
+function tidy(value: number): number {
+  return Number(value.toPrecision(12))
+}
+
+/**
+ * Value the input shows for one field.
+ *
+ * @param field - The Host descriptor (`kind: 'number'`).
+ * @param value - Draft (the typed string) or effective value (stored units).
+ * @returns The input text.
+ */
+export function numberInputValue(field: EditableFieldWire, value: ConfigValue | undefined): string {
+  if (typeof value === 'string') return value
+  if (typeof value !== 'number') return ''
+  return String(field.scale === undefined ? value : tidy(value / field.scale))
+}
+
+/**
+ * Input `step` in display units.
+ *
+ * @param field - The Host descriptor (`kind: 'number'`).
+ * @returns The step, or `undefined` when the Host gives none.
+ */
+export function numberInputStep(field: EditableFieldWire): number | undefined {
+  if (field.step === undefined) return undefined
+  return field.scale === undefined ? field.step : tidy(field.step / field.scale)
+}
+
+/** One bound in display units with the field's unit appended. */
+function boundLabel(field: EditableFieldWire, stored: number): string {
+  const shown = field.scale === undefined ? stored : tidy(stored / field.scale)
+  return field.unit === undefined ? String(shown) : `${shown} ${field.unit}`
+}
+
+/**
+ * Turn one number draft into its save payload, checking the Host bounds.
+ *
+ * @param field - The Host descriptor (`kind: 'number'`).
+ * @param raw - The draft: the typed string, or a stored-unit number.
+ * @returns The stored-unit value (`''` clears an optional field), or the reason it is rejected.
+ */
+export function numberDraftValue(
+  field: EditableFieldWire,
+  raw: ConfigValue | undefined,
+): { ok: true; value: number | '' } | { ok: false; message: string } {
+  let stored: number
+  if (typeof raw === 'number') {
+    stored = raw
+  } else {
+    const text = typeof raw === 'string' ? raw.trim() : ''
+    if (text === '') {
+      return field.optional === true ? { ok: true, value: '' } : { ok: false, message: PANEL_COPY.numberInvalid }
+    }
+    const parsed = Number(text)
+    if (!Number.isFinite(parsed)) return { ok: false, message: PANEL_COPY.numberInvalid }
+    stored = field.scale === undefined ? parsed : Math.round(parsed * field.scale)
+  }
+  if (field.min !== undefined && stored < field.min) {
+    return { ok: false, message: fillCopy(PANEL_COPY.numberMin, { n: boundLabel(field, field.min) }) }
+  }
+  if (field.max !== undefined && stored > field.max) {
+    return { ok: false, message: fillCopy(PANEL_COPY.numberMax, { n: boundLabel(field, field.max) }) }
+  }
+  return { ok: true, value: stored }
+}
+
+/**
+ * Human reading of a byte count, e.g. `20 MiB`.
+ *
+ * @param text - The input text (bytes).
+ * @returns The reading, or `undefined` when the text is not a positive number.
+ */
+export function bytesReading(text: string): string | undefined {
+  const bytes = Number(text)
+  if (text.trim() === '' || !Number.isFinite(bytes) || bytes <= 0) return undefined
+  const units = ['B', 'KiB', 'MiB', 'GiB', 'TiB']
+  let value = bytes
+  let unit = 0
+  while (value >= 1024 && unit < units.length - 1) {
+    value /= 1024
+    unit += 1
+  }
+  return `${Number(value.toFixed(value >= 100 || unit === 0 ? 0 : 1))} ${units[unit]}`
+}

package/src/client/panel/access-tab.tsx

@@ -1,15 +1,18 @@
 /**
- * 「访问授权」tab：准入与授权字段表单（管理员 user_id / 准入模式 /
- * 申请有效期）+ 白名单与待处理申请卡。表单保存走全局 draft，白名单
- * 增删是独立即时 mutation。
+ * 「访问授权」tab：待处理申请（有才显示，置顶）、准入字段（调试模式 /
+ * 管理员 / 申请有效期）与群、用户白名单。字段保存走全局 draft，白名单增删
+ * 与申请处理是独立即时 mutation。
+ *
+ * `access.loaded === false`（飞书未连接、插件 storage 域未打开）时白名单与
+ * 申请列表是「未知」而不是「空」，因此只渲染连接提示并禁用全部写操作。
  *
  * @module dsh-channels/client/panel/access-tab
  */
 
-import { PANEL_COPY, TAB_FIELD_GROUPS } from '../../settings/contract.ts'
-import { AccessCard } from './access-card.tsx'
-import { FieldsCard, SaveBar, TabHelp } from './shared.tsx'
+import { fillCopy, PANEL_COPY, TAB_FIELD_GROUPS } from '../../settings/contract.ts'
+import { FieldSections, NoticeBar } from './shared.tsx'
 import type { FormView } from './shared.tsx'
+import { RequestList, Whitelist } from './whitelist.tsx'
 
 export interface AccessTabProps {
   form: FormView
@@ -24,22 +27,60 @@ export interface AccessTabProps {
 
 export function AccessTab(props: AccessTabProps): JSX.Element {
   const { form, accessNotice, accessError, onAddGroup, onRemoveGroup, onAddUser, onRemoveUser, onResolveRequest } = props
+  const { access } = form.panel
+  const working = form.busy === 'access'
+  const disabled = form.busy !== null || form.locked || !access.loaded
+  // The administrator row says who is in charge right now when the owner fallback applies.
+  const ownerAdmin = access.mode === 'guarded' && access.admin.source === 'owner' ? access.admin.userId : undefined
+  const fields = ownerAdmin === undefined
+    ? form.fields
+    : form.fields.map(field => field.key === 'adminUserId'
+      ? { ...field, summary: fillCopy(PANEL_COPY.accessAdminOwnerSummary, { id: ownerAdmin }) }
+      : field)
   return (
     <div className="dsh-channels-cfg__tabBody">
-      <TabHelp text={PANEL_COPY.accessTabHelp} />
-      <FieldsCard form={form} groups={TAB_FIELD_GROUPS.access} />
-      <SaveBar form={form} tab="access" />
-      <AccessCard
-        panel={form.panel}
-        busy={form.busy}
-        locked={form.locked}
-        notice={accessNotice}
-        error={accessError}
-        onAddGroup={onAddGroup}
-        onRemoveGroup={onRemoveGroup}
-        onAddUser={onAddUser}
-        onRemoveUser={onRemoveUser}
-        onResolveRequest={onResolveRequest}
+      {accessNotice === null ? null : <NoticeBar kind="ok" text={accessNotice} />}
+      {accessError === null ? null : <NoticeBar kind="error" text={accessError} />}
+      {access.loaded && access.mode === 'guarded' && !access.admin.configured
+        ? (
+            <NoticeBar
+              kind="error"
+              text={access.admin.ownerLookupError === undefined
+                ? PANEL_COPY.accessAdminMissingWarning
+                : `${PANEL_COPY.accessAdminMissingWarning}（${access.admin.ownerLookupError}）`}
+            />
+          )
+        : null}
+      {access.loaded && access.requests.length > 0
+        ? <RequestList requests={access.requests} disabled={disabled} working={working} onResolve={onResolveRequest} />
+        : null}
+      <FieldSections form={{ ...form, fields }} groups={TAB_FIELD_GROUPS.access} />
+      <Whitelist
+        title={PANEL_COPY.accessGroupsTitle}
+        entries={access.groups.map(group => ({ id: group.chatId, name: group.name, source: group.source }))}
+        avatar="群"
+        empty={PANEL_COPY.accessGroupsEmpty}
+        loaded={access.loaded}
+        addLabel={PANEL_COPY.accessAddGroup}
+        idPlaceholder={PANEL_COPY.accessGroupChatIdPlaceholder}
+        namePlaceholder={PANEL_COPY.accessGroupNamePlaceholder}
+        disabled={disabled}
+        working={working}
+        onAdd={onAddGroup}
+        onRemove={onRemoveGroup}
+      />
+      <Whitelist
+        title={PANEL_COPY.accessUsersTitle}
+        entries={access.users.map(user => ({ id: user.userId, name: user.name, source: user.source }))}
+        empty={PANEL_COPY.accessUsersEmpty}
+        loaded={access.loaded}
+        addLabel={PANEL_COPY.accessAddUser}
+        idPlaceholder={PANEL_COPY.accessUserIdPlaceholder}
+        namePlaceholder={PANEL_COPY.accessUserNamePlaceholder}
+        disabled={disabled}
+        working={working}
+        onAdd={onAddUser}
+        onRemove={onRemoveUser}
       />
     </div>
   )

package/src/client/panel/advanced-tab.tsx

@@ -1,80 +1,71 @@
 /**
- * 「高级」tab：流式刷新等低层字段 + 只读部署信息（overlayPath / version /
- * 部署级参数）+ 「清除 Web 覆盖」。清除覆盖是整体动作，不走 draft。
+ * 「高级」tab：日志分析接口（监听地址字段 + 访问令牌凭据行）、SDK 日志级别
+ * 与 Web 覆盖文件（「恢复 profile 配置」删除整个覆盖层，不走 draft）。
  *
  * @module dsh-channels/client/panel/advanced-tab
  */
 
-import { PANEL_COPY, TAB_FIELD_GROUPS } from '../../settings/contract.ts'
-import type { PanelWire } from '../../settings/contract.ts'
-import { FieldsCard, SaveBar, TabHelp } from './shared.tsx'
-import type { BusyAction, FormView } from './shared.tsx'
+import { fillCopy, PANEL_COPY, TAB_FIELD_GROUPS } from '../../settings/contract.ts'
+import { CredentialRow } from './credentials-card.tsx'
+import { FieldSections, Row, Section } from './shared.tsx'
+import type { AnalyzeTokenView, FormView } from './shared.tsx'
 
-export function AdvancedTab(props: { form: FormView; onClear: () => void }): JSX.Element {
-  const { form, onClear } = props
-  return (
-    <div className="dsh-channels-cfg__tabBody">
-      <TabHelp text={PANEL_COPY.advancedTabHelp} />
-      <FieldsCard form={form} groups={TAB_FIELD_GROUPS.advanced} />
-      <SaveBar form={form} tab="advanced" />
-      <AdvancedCard panel={form.panel} busy={form.busy} locked={form.locked} onClear={onClear} />
-    </div>
-  )
-}
-
-/** Read-only deployment facts; the only write action here drops the overlay file. */
-function AdvancedCard(props: {
-  panel: PanelWire
-  busy: BusyAction | null
-  locked: boolean
+export function AdvancedTab(props: {
+  form: FormView
+  analyzeToken: AnalyzeTokenView
   onClear: () => void
 }): JSX.Element {
-  const { panel, busy, locked, onClear } = props
-  const { readOnly } = panel.config
+  const { form, analyzeToken, onClear } = props
+  const { panel, busy, locked } = form
+  const tokenState = panel.config.credentials.analyzeToken
   const overridden = panel.config.overriddenKeys.length
   return (
-    <section className="dsh-channels-cfg__card">
-      <div className="dsh-channels-cfg__cardHead">
-        <span className="dsh-channels-cfg__cardTitle">{PANEL_COPY.advancedCard}</span>
-        <span className="dsh-channels-cfg__cardMeta">
-          {overridden === 0 ? PANEL_COPY.inherited : `${PANEL_COPY.overridden} ${overridden} 项`}
-        </span>
-      </div>
-      <span className="dsh-channels-cfg__help">{PANEL_COPY.advancedHelp}</span>
-      <div className="dsh-channels-cfg__labelRow">
-        <span className="dsh-channels-cfg__cardTitle">{PANEL_COPY.readOnlyCard}</span>
-      </div>
-      <div className="dsh-channels-cfg__readOnly">
-        {readOnly.map(field => (
-          <div className="dsh-channels-cfg__kv" key={field.key}>
-            <span className="dsh-channels-cfg__kvKey">{field.label}</span>
-            <span className="dsh-channels-cfg__kvValue">{field.value}</span>
-            {field.help === undefined ? null : <span className="dsh-channels-cfg__help">{field.help}</span>}
-          </div>
-        ))}
-        <div className="dsh-channels-cfg__kv">
-          <span className="dsh-channels-cfg__kvKey">{PANEL_COPY.overlayPath}</span>
-          <span className="dsh-channels-cfg__kvValue dsh-channels-cfg__mono">{panel.status.overlayPath}</span>
-          <span className="dsh-channels-cfg__help">{PANEL_COPY.overlayPathHelp}</span>
-        </div>
-        <div className="dsh-channels-cfg__kv">
-          <span className="dsh-channels-cfg__kvKey">{PANEL_COPY.version}</span>
-          <span className="dsh-channels-cfg__kvValue dsh-channels-cfg__mono">{panel.status.version}</span>
-        </div>
-      </div>
-      <div className="dsh-channels-cfg__actions">
-        <button
-          type="button"
-          className="dsh-channels-cfg__btn"
-          onClick={onClear}
-          disabled={overridden === 0 || busy !== null || locked}
-        >
-          {busy === 'clear' ? PANEL_COPY.clearing : PANEL_COPY.clear}
-        </button>
-        <span className="dsh-channels-cfg__help">
-          {overridden === 0 ? PANEL_COPY.noOverrides : `${PANEL_COPY.overridden} ${overridden} 项`}
-        </span>
-      </div>
-    </section>
+    <div className="dsh-channels-cfg__tabBody">
+      <FieldSections
+        form={form}
+        groups={TAB_FIELD_GROUPS.advanced}
+        extra={{
+          analyze: (
+            <CredentialRow
+              label={PANEL_COPY.analyzeTokenLabel}
+              summary={PANEL_COPY.analyzeTokenSummary}
+              state={tokenState}
+              value={analyzeToken.value}
+              secret
+              placeholder={PANEL_COPY.analyzeTokenPlaceholder}
+              issue={analyzeToken.issues.find(item => item.key === 'analyzeToken')}
+              busy={analyzeToken.busy}
+              disabled={analyzeToken.busy !== null || analyzeToken.locked || !tokenState.writable}
+              onChange={analyzeToken.onChange}
+              onSave={analyzeToken.onSave}
+              onClear={analyzeToken.onClear}
+            />
+          ),
+        }}
+      />
+      <Section title={PANEL_COPY.overlayTitle}>
+        <Row
+          label={PANEL_COPY.overlayPath}
+          summary={<span className="dsh-channels-cfg__mono">{panel.status.overlayPath}</span>}
+          details={(
+            <>
+              {PANEL_COPY.overlayPathHelp}
+              {' '}
+              {overridden === 0 ? PANEL_COPY.noOverrides : fillCopy(PANEL_COPY.overlayCount, { n: overridden })}
+            </>
+          )}
+          control={(
+            <button
+              type="button"
+              className="dsh-channels-cfg__btn dsh-channels-cfg__btn--danger"
+              onClick={onClear}
+              disabled={overridden === 0 || busy !== null || locked}
+            >
+              {busy === 'clear' ? PANEL_COPY.clearing : PANEL_COPY.clear}
+            </button>
+          )}
+        />
+      </Section>
+    </div>
   )
 }