dsh-file-activity 0.5.10 → 0.5.13

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 本文件记录 dsh-file-activity 的所有版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.5.13] - 2026-09-25
+
+### 变更
+
+- fix: 适配宿主 0.1.7-rc.2 的事件名与席位契约，修正失效文档断言
+
+## [0.5.12] - 2026-09-18
+
+### 变更
+
+- feat(file-activity): 右侧边栏默认宽度配置（默认 20%）
+
+## [0.5.11] - 2026-09-18
+
+### 变更
+
+- feat(file-activity): 右侧边栏默认宽度配置（默认 20%）
+
 ## [0.5.10] - 2026-09-16
 
 ### 变更

package/README.md

@@ -52,6 +52,9 @@ dsh plugin --profile web add link:<仓库路径>/plugins/dsh-file-activity
 | 配置项                                           | 默认 | 作用                                                                       |
 | ------------------------------------------------ | ---- | -------------------------------------------------------------------------- |
 | 会话开始时自动打开（**设置 → 插件 → 文件活动**） | 开   | 每个会话首次打开时自动显示本页；关闭后仍可从侧边栏「新标签页」菜单手动打开 |
+| 右侧边栏默认宽度（**设置 → 插件 → 文件活动**）   | 20%  | 启动时按此比例展开右侧边栏（10%–70%）；手动拖拽过宽度后本次运行不再覆盖    |
+
+> 宽度偏好只在你**尚未拖拽**时生效（宿主自己给的 45% 默认值也算「已拖拽」之外的空档）。宿主右侧栏下限为 300px，窗口窄于约 1500px 时 20% 会被抬高到 300px——这是宿主 clamp，非本插件行为。
 
 ## 相关文档
 

package/lib/client.js

@@ -46,6 +46,8 @@ window.__ModuleLoader__.load({
     const PREVIEW_ID = 'dsh-file-activity-preview'
     const AUTO_OPEN_KEY = 'dsh-file-activity:auto-opened:'
     const AUTO_OPEN_PREF_KEY = 'dsh-file-activity:autoOpen'
+    // Right column default width ratio in percent (issue #384).
+    const RIGHTBAR_PREF_KEY = 'dsh-file-activity:rightbarWidth'
     const POLL_MS = 6000
 
     // ── parts (injected by scripts/build.mjs; keep this exact order — the
@@ -104,6 +106,11 @@ const strings = {
     isZh()
       ? '每个会话首次打开时自动显示本页；关闭后仍可从侧边栏右上角的「新标签页」手动打开。'
       : 'Shows this page once per session. When off, open it from the sidebar new-tab control.',
+  rightbarWidthLabel: () => (isZh() ? '右侧边栏默认宽度' : 'Right sidebar default width'),
+  rightbarWidthHint: () =>
+    isZh()
+      ? '启动时右侧边栏按此比例展开（10%–70%）。手动拖拽过宽度后不再覆盖；宿主最小宽度 300px，窄窗口下实际会更宽。'
+      : 'Opens the right sidebar at this ratio (10%–70%). A manual drag wins for the rest of the run; the host floor is 300px, so narrow windows land wider.',
   tabUnavailable: () => (isZh() ? '侧边栏扩展点不可用' : 'Sidebar extension point unavailable'),
   tabUnavailableHint: () =>
     isZh()
@@ -986,7 +993,7 @@ const STYLES = `
   border:1px solid var(--dsw-alias-state-error-primary); background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 8%, transparent); }
 .dfa-degraded-title { font:var(--dsw-font-xs-13); color:var(--dsw-alias-state-error-primary); }
 .dfa-degraded-hint { margin-top:2px; font:var(--dsw-font-xxs-12); opacity:.8; }
-/* 设置页（settings.plugins.tab）：开关行。 */
+/* 设置页（settings.plugins.tab）：开关行 + 百分比输入行（issue #384）。 */
 .dfa-set { display:flex; flex-direction:column; gap:10px; padding:10px 2px; }
 .dfa-set-title { font:var(--dsw-font-sm-14); }
 .dfa-set-row { display:flex; align-items:center; justify-content:space-between; gap:12px; cursor:pointer; }
@@ -994,6 +1001,12 @@ const STYLES = `
 .dfa-set-label { font:var(--dsw-font-xs-13); }
 .dfa-set-hint { font:var(--dsw-font-xxs-12); opacity:.75; }
 .dfa-set-switch { flex:none; width:16px; height:16px; accent-color:var(--dsw-alias-accent); cursor:pointer; }
+.dfa-set-row-static { cursor:default; }
+.dfa-set-field { flex:none; display:inline-flex; align-items:center; gap:4px; cursor:default; }
+.dfa-set-number { box-sizing:border-box; width:60px; padding:4px 6px; text-align:right; color:inherit;
+  background:transparent; border:1px solid var(--dsw-alias-border-l1); border-radius:6px; font:var(--dsw-font-xs-13); }
+.dfa-set-number:focus { outline:none; border-color:var(--dsw-alias-accent); }
+.dfa-set-unit { font:var(--dsw-font-xs-13); opacity:.75; }
 /* 浮窗正文：Markdown / 代码 / 纯文本 / 图片四种渲染体。 */
 .dfa-fp-md { height:100%; overflow:auto; padding:2px 4px; }
 .dfa-fp-code { height:100%; overflow:auto; }
@@ -1798,6 +1811,183 @@ function PdfPreview({ src, download, title }) {
   )
 }
 
+    'use strict'
+// ── right column default width (issue #384) ───────────────────────────
+//
+// Why this half exists: the host hardcodes the right column's first-open width
+// at 45% of the frame (ui-layout columns.ts RIGHTBAR_DEFAULT_RATIO) and
+// persists nothing, and it exposes NO width face on ctx.layout or
+// ctx.sidebarRight. The one reachable channel is the layout entry's declared
+// store seat: ctx.slots.entries('root') yields the ui-layout registration,
+// whose store.create() returns the very instance AppFrame subscribes to (the
+// framework itself goes through handle.create()).
+//
+// Semantics = DEFAULT, not override: the host fills layoutInfo.rightbar with
+// the 45% value on the panel's first opening (stores.ts rightbar ??= …), so
+// `rightbar === null` means "nothing opened or dragged it in this run". We
+// write ONLY then; a value the user dragged is never touched.
+//
+// Every contract mismatch (no entry, factory-shaped store, no create(), a
+// throwing create()/getSnapshot(), no setRightbar, an unexpected snapshot) is
+// a SILENT skip with at most one debug line. Breaking the tab, the auto-open
+// or the preview over a nicety like this would be far worse than doing
+// nothing, so the whole path is detect-and-degrade.
+/** Allowed ratio range in percent; the ceiling matches the host's own cap (70%). */
+const RIGHTBAR_RATIO_MIN = 10
+const RIGHTBAR_RATIO_MAX = 70
+/** Ratio used when nothing valid is stored: the issue #384 default. */
+const RIGHTBAR_RATIO_DEFAULT = 20
+/** One-shot skip log gate, so a churning root seat cannot flood the console. */
+let rightbarSkipLogged = false
+/** Debug-only skip report; never throws, never warns (degradation is silent). */
+function logRightbarSkip(reason, error) {
+  if (rightbarSkipLogged) return
+  rightbarSkipLogged = true
+  try {
+    if (typeof console !== 'undefined' && typeof console.debug === 'function') {
+      console.debug('[dsh-file-activity] 右侧边栏默认宽度未应用: ' + reason, error ?? '')
+    }
+  } catch {
+    // logging must never break activation
+  }
+}
+/** Whether a raw value is a usable percent ratio (finite, inside the range). */
+function rightbarRatioValid(value) {
+  const ratio = Number(value)
+  return Number.isFinite(ratio) && ratio >= RIGHTBAR_RATIO_MIN && ratio <= RIGHTBAR_RATIO_MAX
+}
+/** Persisted ratio, falling back to the default for missing/illegal values. */
+function storedRightbarRatio() {
+  let raw
+  try {
+    raw = window.localStorage.getItem(RIGHTBAR_PREF_KEY)
+  } catch {
+    return RIGHTBAR_RATIO_DEFAULT
+  }
+  if (raw === null || !rightbarRatioValid(raw)) return RIGHTBAR_RATIO_DEFAULT
+  return Number(raw)
+}
+/** Persist a ratio; an illegal value is rejected instead of poisoning storage. */
+function saveRightbarRatio(value) {
+  if (!rightbarRatioValid(value)) return false
+  try {
+    window.localStorage.setItem(RIGHTBAR_PREF_KEY, String(Number(value)))
+  } catch {
+    // storage unavailable (private mode): the control still shows the value
+  }
+  return true
+}
+/**
+ * The entry's store seat in HANDLE form (create() present), or null.
+ * A factory-shaped seat is deliberately not guessed at: calling it would build
+ * a second, unsubscribed instance instead of the one AppFrame renders.
+ * @param entry - one 'root' seat snapshot.
+ * @returns the handle-shaped seat, or null.
+ */
+function rightbarStoreSeat(entry) {
+  const store = entry && entry.store
+  if (!store || typeof store !== 'object') return null
+  if (typeof store.create !== 'function') return null
+  return store
+}
+/**
+ * The instance's layoutInfo when it is writable, or null.
+ * @param instance - handle-created store instance.
+ * @returns layoutInfo, or null when the shape is foreign or a width exists.
+ */
+function rightbarWritableInfo(instance) {
+  if (typeof instance.getSnapshot !== 'function') return null
+  const snapshot = instance.getSnapshot()
+  const info = snapshot && snapshot.layoutInfo
+  if (!info || typeof info !== 'object') return null
+  // NULL is the only green light: any number means this run already owns a
+  // width (the host's own 45% first-open default, or a user drag).
+  if (info.rightbar !== null) return null
+  return info
+}
+/**
+ * Turn a handle-created instance into a write target, or null.
+ * @param instance - handle-created store instance.
+ * @returns the write target, or null.
+ */
+function rightbarTargetFromInstance(instance) {
+  if (!instance) return null
+  const info = rightbarWritableInfo(instance)
+  if (!info) return null
+  if (!instance.actions || typeof instance.actions.setRightbar !== 'function') return null
+  return { setRightbar: instance.actions.setRightbar, info }
+}
+/**
+ * Resolve the ui-layout instance behind the 'root' seat, or null when the host
+ * contract does not match. The snapshot shape is the test: writing the width
+ * goes through exactly that shape, so a shape we cannot read is a channel we
+ * must not use.
+ * @param ctx - client root context.
+ * @returns the write target, or null (caller stays silent).
+ */
+function rightbarLayoutTarget(ctx) {
+  const slots = ctx && ctx.slots
+  if (!slots || typeof slots.entries !== 'function') {
+    logRightbarSkip('ctx.slots.entries 不可用')
+    return null
+  }
+  const entries = slots.entries('root') || []
+  for (const entry of entries) {
+    try {
+      const target = rightbarTargetFromInstance(rightbarStoreSeat(entry)?.create?.())
+      if (target) return target
+    } catch (error) {
+      logRightbarSkip('读取 root 席位 store 失败', error)
+    }
+  }
+  logRightbarSkip('未找到可写的 ui-layout root 席位')
+  return null
+}
+/**
+ * Apply the configured default width once, if the panel has no width yet.
+ * @param ctx - client root context.
+ */
+function applyRightbarDefaultWidth(ctx) {
+  try {
+    const target = rightbarLayoutTarget(ctx)
+    if (!target) return
+    // The snapshot's own viewportWidth is the value the host's clamp uses, so
+    // prefer it; window.innerWidth only covers a snapshot that omits it.
+    const viewport = Number.isFinite(target.info.viewportWidth) ? target.info.viewportWidth : window.innerWidth
+    if (!Number.isFinite(viewport)) {
+      logRightbarSkip('viewportWidth 不可用')
+      return
+    }
+    const px = Math.round(viewport * (storedRightbarRatio() / 100))
+    if (!Number.isFinite(px) || px <= 0) {
+      logRightbarSkip('计算出的宽度非法')
+      return
+    }
+    target.setRightbar(px)
+  } catch (error) {
+    logRightbarSkip('应用宽度失败', error)
+  }
+}
+/**
+ * Install the preference: apply once at activation, then re-resolve the
+ * instance after a 'root' seat change (HMR / remount must not keep a stale
+ * instance). The returned disposer releases the subscription with the fiber.
+ * @param ctx - client root context.
+ * @returns the subscription disposer, when one was taken.
+ */
+function installRightbarDefaultWidth(ctx) {
+  applyRightbarDefaultWidth(ctx)
+  const slots = ctx && ctx.slots
+  if (!slots || typeof slots.subscribe !== 'function') return undefined
+  try {
+    const dispose = slots.subscribe('root', () => applyRightbarDefaultWidth(ctx))
+    return typeof dispose === 'function' ? () => dispose() : undefined
+  } catch (error) {
+    logRightbarSkip('订阅 root 席位失败', error)
+    return undefined
+  }
+}
+
     'use strict'
 // ── settings tab (replaces 迁移前的 settings.pluginToggles) ────
 //
@@ -1843,9 +2033,40 @@ function settingsRow(label, hint, checked, onChange) {
     }),
   )
 }
-/** Settings panel body: the auto-open switch plus its explanatory hint. */
+/** One labeled percent row (issue #384: the right column's default width). */
+function settingsPercentRow(label, hint, value, onCommit) {
+  return createElement(
+    'div',
+    { className: 'dfa-set-row dfa-set-row-static' },
+    createElement(
+      'span',
+      { className: 'dfa-set-text' },
+      createElement('span', { className: 'dfa-set-label' }, label),
+      createElement('span', { className: 'dfa-set-hint' }, hint),
+    ),
+    createElement(
+      'span',
+      { className: 'dfa-set-field' },
+      createElement('input', {
+        type: 'number',
+        className: 'dfa-set-number',
+        min: RIGHTBAR_RATIO_MIN,
+        max: RIGHTBAR_RATIO_MAX,
+        step: 1,
+        value,
+        onChange: (event) => onCommit(event?.target?.value),
+      }),
+      createElement('span', { className: 'dfa-set-unit' }, '%'),
+    ),
+  )
+}
+/**
+ * Settings panel body: the auto-open switch, the right-sidebar default width,
+ * and their explanatory hints.
+ */
 function FileActivitySettings() {
   const [enabled, setEnabled] = useState(autoOpenEnabled)
+  const [ratio, setRatio] = useState(storedRightbarRatio)
   return createElement(
     'div',
     { className: 'dfa-set', 'data-dfa-settings': '1' },
@@ -1854,6 +2075,12 @@ function FileActivitySettings() {
       setAutoOpenEnabled(next)
       setEnabled(next)
     }),
+    settingsPercentRow(strings.rightbarWidthLabel(), strings.rightbarWidthHint(), ratio, (raw) => {
+      // An illegal / out-of-range edit is rejected outright: the control keeps
+      // showing the stored preference instead of a value we would not apply.
+      if (!saveRightbarRatio(raw)) return
+      setRatio(Number(raw))
+    }),
   )
 }
 /** Register the settings tab into the settings section's list seat. */
@@ -1902,6 +2129,10 @@ function registerTabType(ctx) {
         // place (host GuideBody → actions.openTab(kind, { replaceTab: true })).
         guide: [
           {
+            // Required by the host guide-entry contract: without it the host hands
+            // `entryId: undefined` to `sidebar.right.tab.guide.entry` and the
+            // per-type duplicate-id check silently stops working.
+            id: TAB_ID,
             order: 20,
             title: () => strings.title(),
             description: () => strings.guideDescription(),
@@ -1967,6 +2198,12 @@ exports.apply = function apply(ctx) {
   registerPreviewOverlay(ctx, dataStore)
   registerSettingsTab(ctx)
   guarded('previews', () => registerDocumentPreviews(ctx))
+  // Right column default width (issue #384) BEFORE the auto-open below: the
+  // host fills its own 45% default the moment the panel first opens
+  // (stores.ts `rightbar ??= …`), so whoever writes first wins. Auto-opening
+  // our tab opens that panel — applying the width afterwards would always
+  // find a non-null preference and never take effect.
+  ctx.effect(() => installRightbarDefaultWidth(ctx), 'dsh-file-activity: rightbar default width')
   // sidebar operations → host record route
   ctx.effect(() => installFetchInterceptor(), 'dsh-file-activity: sidebar fetch observation')
   // auto-open once per session (default on)

package/lib/client.src.js

@@ -46,6 +46,8 @@ window.__ModuleLoader__.load({
     const PREVIEW_ID = 'dsh-file-activity-preview'
     const AUTO_OPEN_KEY = 'dsh-file-activity:auto-opened:'
     const AUTO_OPEN_PREF_KEY = 'dsh-file-activity:autoOpen'
+    // Right column default width ratio in percent (issue #384).
+    const RIGHTBAR_PREF_KEY = 'dsh-file-activity:rightbarWidth'
     const POLL_MS = 6000
 
     // ── parts (injected by scripts/build.mjs; keep this exact order — the
@@ -64,6 +66,7 @@ window.__ModuleLoader__.load({
     __PART_VIEW__
     __PART_PREVIEW_DATA__
     __PART_PREVIEW__
+    __PART_RIGHTBAR_WIDTH__
     __PART_SETTINGS__
     __PART_APPLY__
 

package/lib/parts/apply.part.js

@@ -30,6 +30,10 @@ function registerTabType(ctx) {
         // place (host GuideBody → actions.openTab(kind, { replaceTab: true })).
         guide: [
           {
+            // Required by the host guide-entry contract: without it the host hands
+            // `entryId: undefined` to `sidebar.right.tab.guide.entry` and the
+            // per-type duplicate-id check silently stops working.
+            id: TAB_ID,
             order: 20,
             title: () => strings.title(),
             description: () => strings.guideDescription(),
@@ -95,6 +99,12 @@ exports.apply = function apply(ctx) {
   registerPreviewOverlay(ctx, dataStore)
   registerSettingsTab(ctx)
   guarded('previews', () => registerDocumentPreviews(ctx))
+  // Right column default width (issue #384) BEFORE the auto-open below: the
+  // host fills its own 45% default the moment the panel first opens
+  // (stores.ts `rightbar ??= …`), so whoever writes first wins. Auto-opening
+  // our tab opens that panel — applying the width afterwards would always
+  // find a non-null preference and never take effect.
+  ctx.effect(() => installRightbarDefaultWidth(ctx), 'dsh-file-activity: rightbar default width')
   // sidebar operations → host record route
   ctx.effect(() => installFetchInterceptor(), 'dsh-file-activity: sidebar fetch observation')
   // auto-open once per session (default on)

package/lib/parts/i18n.part.js

@@ -52,6 +52,11 @@ const strings = {
     isZh()
       ? '每个会话首次打开时自动显示本页；关闭后仍可从侧边栏右上角的「新标签页」手动打开。'
       : 'Shows this page once per session. When off, open it from the sidebar new-tab control.',
+  rightbarWidthLabel: () => (isZh() ? '右侧边栏默认宽度' : 'Right sidebar default width'),
+  rightbarWidthHint: () =>
+    isZh()
+      ? '启动时右侧边栏按此比例展开（10%–70%）。手动拖拽过宽度后不再覆盖；宿主最小宽度 300px，窄窗口下实际会更宽。'
+      : 'Opens the right sidebar at this ratio (10%–70%). A manual drag wins for the rest of the run; the host floor is 300px, so narrow windows land wider.',
   tabUnavailable: () => (isZh() ? '侧边栏扩展点不可用' : 'Sidebar extension point unavailable'),
   tabUnavailableHint: () =>
     isZh()

package/lib/parts/rightbar-width.part.js

@@ -0,0 +1,176 @@
+'use strict'
+// ── right column default width (issue #384) ───────────────────────────
+//
+// Why this half exists: the host hardcodes the right column's first-open width
+// at 45% of the frame (ui-layout columns.ts RIGHTBAR_DEFAULT_RATIO) and
+// persists nothing, and it exposes NO width face on ctx.layout or
+// ctx.sidebarRight. The one reachable channel is the layout entry's declared
+// store seat: ctx.slots.entries('root') yields the ui-layout registration,
+// whose store.create() returns the very instance AppFrame subscribes to (the
+// framework itself goes through handle.create()).
+//
+// Semantics = DEFAULT, not override: the host fills layoutInfo.rightbar with
+// the 45% value on the panel's first opening (stores.ts rightbar ??= …), so
+// `rightbar === null` means "nothing opened or dragged it in this run". We
+// write ONLY then; a value the user dragged is never touched.
+//
+// Every contract mismatch (no entry, factory-shaped store, no create(), a
+// throwing create()/getSnapshot(), no setRightbar, an unexpected snapshot) is
+// a SILENT skip with at most one debug line. Breaking the tab, the auto-open
+// or the preview over a nicety like this would be far worse than doing
+// nothing, so the whole path is detect-and-degrade.
+/** Allowed ratio range in percent; the ceiling matches the host's own cap (70%). */
+const RIGHTBAR_RATIO_MIN = 10
+const RIGHTBAR_RATIO_MAX = 70
+/** Ratio used when nothing valid is stored: the issue #384 default. */
+const RIGHTBAR_RATIO_DEFAULT = 20
+/** One-shot skip log gate, so a churning root seat cannot flood the console. */
+let rightbarSkipLogged = false
+/** Debug-only skip report; never throws, never warns (degradation is silent). */
+function logRightbarSkip(reason, error) {
+  if (rightbarSkipLogged) return
+  rightbarSkipLogged = true
+  try {
+    if (typeof console !== 'undefined' && typeof console.debug === 'function') {
+      console.debug('[dsh-file-activity] 右侧边栏默认宽度未应用: ' + reason, error ?? '')
+    }
+  } catch {
+    // logging must never break activation
+  }
+}
+/** Whether a raw value is a usable percent ratio (finite, inside the range). */
+function rightbarRatioValid(value) {
+  const ratio = Number(value)
+  return Number.isFinite(ratio) && ratio >= RIGHTBAR_RATIO_MIN && ratio <= RIGHTBAR_RATIO_MAX
+}
+/** Persisted ratio, falling back to the default for missing/illegal values. */
+function storedRightbarRatio() {
+  let raw
+  try {
+    raw = window.localStorage.getItem(RIGHTBAR_PREF_KEY)
+  } catch {
+    return RIGHTBAR_RATIO_DEFAULT
+  }
+  if (raw === null || !rightbarRatioValid(raw)) return RIGHTBAR_RATIO_DEFAULT
+  return Number(raw)
+}
+/** Persist a ratio; an illegal value is rejected instead of poisoning storage. */
+function saveRightbarRatio(value) {
+  if (!rightbarRatioValid(value)) return false
+  try {
+    window.localStorage.setItem(RIGHTBAR_PREF_KEY, String(Number(value)))
+  } catch {
+    // storage unavailable (private mode): the control still shows the value
+  }
+  return true
+}
+/**
+ * The entry's store seat in HANDLE form (create() present), or null.
+ * A factory-shaped seat is deliberately not guessed at: calling it would build
+ * a second, unsubscribed instance instead of the one AppFrame renders.
+ * @param entry - one 'root' seat snapshot.
+ * @returns the handle-shaped seat, or null.
+ */
+function rightbarStoreSeat(entry) {
+  const store = entry && entry.store
+  if (!store || typeof store !== 'object') return null
+  if (typeof store.create !== 'function') return null
+  return store
+}
+/**
+ * The instance's layoutInfo when it is writable, or null.
+ * @param instance - handle-created store instance.
+ * @returns layoutInfo, or null when the shape is foreign or a width exists.
+ */
+function rightbarWritableInfo(instance) {
+  if (typeof instance.getSnapshot !== 'function') return null
+  const snapshot = instance.getSnapshot()
+  const info = snapshot && snapshot.layoutInfo
+  if (!info || typeof info !== 'object') return null
+  // NULL is the only green light: any number means this run already owns a
+  // width (the host's own 45% first-open default, or a user drag).
+  if (info.rightbar !== null) return null
+  return info
+}
+/**
+ * Turn a handle-created instance into a write target, or null.
+ * @param instance - handle-created store instance.
+ * @returns the write target, or null.
+ */
+function rightbarTargetFromInstance(instance) {
+  if (!instance) return null
+  const info = rightbarWritableInfo(instance)
+  if (!info) return null
+  if (!instance.actions || typeof instance.actions.setRightbar !== 'function') return null
+  return { setRightbar: instance.actions.setRightbar, info }
+}
+/**
+ * Resolve the ui-layout instance behind the 'root' seat, or null when the host
+ * contract does not match. The snapshot shape is the test: writing the width
+ * goes through exactly that shape, so a shape we cannot read is a channel we
+ * must not use.
+ * @param ctx - client root context.
+ * @returns the write target, or null (caller stays silent).
+ */
+function rightbarLayoutTarget(ctx) {
+  const slots = ctx && ctx.slots
+  if (!slots || typeof slots.entries !== 'function') {
+    logRightbarSkip('ctx.slots.entries 不可用')
+    return null
+  }
+  const entries = slots.entries('root') || []
+  for (const entry of entries) {
+    try {
+      const target = rightbarTargetFromInstance(rightbarStoreSeat(entry)?.create?.())
+      if (target) return target
+    } catch (error) {
+      logRightbarSkip('读取 root 席位 store 失败', error)
+    }
+  }
+  logRightbarSkip('未找到可写的 ui-layout root 席位')
+  return null
+}
+/**
+ * Apply the configured default width once, if the panel has no width yet.
+ * @param ctx - client root context.
+ */
+function applyRightbarDefaultWidth(ctx) {
+  try {
+    const target = rightbarLayoutTarget(ctx)
+    if (!target) return
+    // The snapshot's own viewportWidth is the value the host's clamp uses, so
+    // prefer it; window.innerWidth only covers a snapshot that omits it.
+    const viewport = Number.isFinite(target.info.viewportWidth) ? target.info.viewportWidth : window.innerWidth
+    if (!Number.isFinite(viewport)) {
+      logRightbarSkip('viewportWidth 不可用')
+      return
+    }
+    const px = Math.round(viewport * (storedRightbarRatio() / 100))
+    if (!Number.isFinite(px) || px <= 0) {
+      logRightbarSkip('计算出的宽度非法')
+      return
+    }
+    target.setRightbar(px)
+  } catch (error) {
+    logRightbarSkip('应用宽度失败', error)
+  }
+}
+/**
+ * Install the preference: apply once at activation, then re-resolve the
+ * instance after a 'root' seat change (HMR / remount must not keep a stale
+ * instance). The returned disposer releases the subscription with the fiber.
+ * @param ctx - client root context.
+ * @returns the subscription disposer, when one was taken.
+ */
+function installRightbarDefaultWidth(ctx) {
+  applyRightbarDefaultWidth(ctx)
+  const slots = ctx && ctx.slots
+  if (!slots || typeof slots.subscribe !== 'function') return undefined
+  try {
+    const dispose = slots.subscribe('root', () => applyRightbarDefaultWidth(ctx))
+    return typeof dispose === 'function' ? () => dispose() : undefined
+  } catch (error) {
+    logRightbarSkip('订阅 root 席位失败', error)
+    return undefined
+  }
+}

package/lib/parts/settings.part.js

@@ -43,9 +43,40 @@ function settingsRow(label, hint, checked, onChange) {
     }),
   )
 }
-/** Settings panel body: the auto-open switch plus its explanatory hint. */
+/** One labeled percent row (issue #384: the right column's default width). */
+function settingsPercentRow(label, hint, value, onCommit) {
+  return createElement(
+    'div',
+    { className: 'dfa-set-row dfa-set-row-static' },
+    createElement(
+      'span',
+      { className: 'dfa-set-text' },
+      createElement('span', { className: 'dfa-set-label' }, label),
+      createElement('span', { className: 'dfa-set-hint' }, hint),
+    ),
+    createElement(
+      'span',
+      { className: 'dfa-set-field' },
+      createElement('input', {
+        type: 'number',
+        className: 'dfa-set-number',
+        min: RIGHTBAR_RATIO_MIN,
+        max: RIGHTBAR_RATIO_MAX,
+        step: 1,
+        value,
+        onChange: (event) => onCommit(event?.target?.value),
+      }),
+      createElement('span', { className: 'dfa-set-unit' }, '%'),
+    ),
+  )
+}
+/**
+ * Settings panel body: the auto-open switch, the right-sidebar default width,
+ * and their explanatory hints.
+ */
 function FileActivitySettings() {
   const [enabled, setEnabled] = useState(autoOpenEnabled)
+  const [ratio, setRatio] = useState(storedRightbarRatio)
   return createElement(
     'div',
     { className: 'dfa-set', 'data-dfa-settings': '1' },
@@ -54,6 +85,12 @@ function FileActivitySettings() {
       setAutoOpenEnabled(next)
       setEnabled(next)
     }),
+    settingsPercentRow(strings.rightbarWidthLabel(), strings.rightbarWidthHint(), ratio, (raw) => {
+      // An illegal / out-of-range edit is rejected outright: the control keeps
+      // showing the stored preference instead of a value we would not apply.
+      if (!saveRightbarRatio(raw)) return
+      setRatio(Number(raw))
+    }),
   )
 }
 /** Register the settings tab into the settings section's list seat. */

package/lib/parts/styles.part.js

@@ -116,7 +116,7 @@ const STYLES = `
   border:1px solid var(--dsw-alias-state-error-primary); background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 8%, transparent); }
 .dfa-degraded-title { font:var(--dsw-font-xs-13); color:var(--dsw-alias-state-error-primary); }
 .dfa-degraded-hint { margin-top:2px; font:var(--dsw-font-xxs-12); opacity:.8; }
-/* 设置页（settings.plugins.tab）：开关行。 */
+/* 设置页（settings.plugins.tab）：开关行 + 百分比输入行（issue #384）。 */
 .dfa-set { display:flex; flex-direction:column; gap:10px; padding:10px 2px; }
 .dfa-set-title { font:var(--dsw-font-sm-14); }
 .dfa-set-row { display:flex; align-items:center; justify-content:space-between; gap:12px; cursor:pointer; }
@@ -124,6 +124,12 @@ const STYLES = `
 .dfa-set-label { font:var(--dsw-font-xs-13); }
 .dfa-set-hint { font:var(--dsw-font-xxs-12); opacity:.75; }
 .dfa-set-switch { flex:none; width:16px; height:16px; accent-color:var(--dsw-alias-accent); cursor:pointer; }
+.dfa-set-row-static { cursor:default; }
+.dfa-set-field { flex:none; display:inline-flex; align-items:center; gap:4px; cursor:default; }
+.dfa-set-number { box-sizing:border-box; width:60px; padding:4px 6px; text-align:right; color:inherit;
+  background:transparent; border:1px solid var(--dsw-alias-border-l1); border-radius:6px; font:var(--dsw-font-xs-13); }
+.dfa-set-number:focus { outline:none; border-color:var(--dsw-alias-accent); }
+.dfa-set-unit { font:var(--dsw-font-xs-13); opacity:.75; }
 /* 浮窗正文：Markdown / 代码 / 纯文本 / 图片四种渲染体。 */
 .dfa-fp-md { height:100%; overflow:auto; padding:2px 4px; }
 .dfa-fp-code { height:100%; overflow:auto; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-file-activity",
-  "version": "0.5.10",
+  "version": "0.5.13",
   "description": "DSH 侧边栏文件活动插件：按 LRU 记录文件读取/新增/修改事件（最近访问），按绝对路径树形统计（文件统计），点击文件浮窗预览（代码高亮/Markdown/图片/PDF）。DSH web plugin: file activity tracker — LRU recent-access list plus per-file read/create/modify counts in a folder tree, with floating preview.",
   "type": "module",
   "main": "lib/index.js",