@weibaohui/dsh-git-server 0.1.2 → 0.1.4

package/README.md

@@ -43,3 +43,14 @@ dsh plugin --profile web add @weibaohui/dsh-git-server -w
 ## 联系我 :飞书群
 
 ![link](https://foruda.gitee.com/images/1774880015525784725/4fd67005_77493.png "link")
+
+## 版本兼容性
+
+本插件与 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`@deepseek-ai/dsh`）的版本对应关系：
+
+| 插件版本 | 适配 dsh 版本 | 备注 |
+|---------|--------------|------|
+| 0.1.4 | 0.1.7-rc.2 | 当前版本，已在 @deepseek-ai/dsh@0.1.7-rc.2 下验证运行 |
+| 0.1.3 | 0.1.7-rc.2 | 已在 @deepseek-ai/dsh@0.1.7-rc.2 下验证运行 |
+
+> **发版约定**：每次发布新版本时，请在上表追加一行，记录该插件版本实际验证所用的 `@deepseek-ai/dsh` 版本。`package.json` 的 `engines.dsh` 声明最低支持版本；本表记录实际验证版本，二者配合使用。

package/client/bundle.js

@@ -12,8 +12,8 @@ window.__ModuleLoader__.load({
      * @weibaohui/dsh-git-server — Browser half（原生 dsh 插件 UI，无 iframe/桥接）。
      *
      * 两个面：
-     *  1. sidebar.footer.action「Git」→ 全屏管理页（仓库列表/建仓/删除 +
-     *     仓库浏览：文件树/文件内容/提交/分支/工单[列表/新建/评论/开关]）。
+     *  1. sidebar.footer.action「Git」→ 中栏接管管理页（taskboard 同款，盖会话列不盖侧栏；
+     *     仓库列表/建仓/删除 + 仓库浏览：文件树/文件内容/提交/分支/工单[列表/新建/评论/开关]）。
      *  2. settings.section「Git 服务器」→ 服务配置（启停/端口/数据目录/兜底密码）。
      *
      * 数据通道：宿主同源路由 /dsh-git-server/api/*（dsh 登录门禁保护，
@@ -37,6 +37,12 @@ window.__ModuleLoader__.load({
     // ── locale ────────────────────────────────────────────────────────────────
 
     const NS = 'dshGitServer'
+    // 中栏接管（taskboard 同款）开合属性 + 互斥协议
+    const DGS_ACTIVE_ATTR = 'data-dsh-git-active'
+    const DGS_PANEL_NAME = 'dsh-git'
+    const DGS_ACTIVATE_EVENT = 'dsh-panel-activate'
+    const DGS_OTHER_ACTIVE_ATTRS = ['data-dsh-atb-active', 'data-dsh-taskboard-active', 'data-dsh-ssh-active', 'data-dsh-prc-active', 'data-dsh-kb-active']
+    const DGS_SIDEBAR_ROW_SELECTOR = '[class*="sessionRow"], [class*="projectRow"], [class*="searchResultRow"], [class*="newSession"]'
     const ZH = {
       nav: 'Git', title: '代码仓库',
       myRepos: '我的仓库', newRepo: '新建仓库', repoName: '仓库名', private: '私有',
@@ -94,7 +100,16 @@ window.__ModuleLoader__.load({
       holder.id = 'dgs-styles'
       holder.style.display = 'none'
       holder.innerHTML = `<style>
-    .dgs-page{position:fixed;inset:0;z-index:2147483000;display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family);font-size:14px}
+    /* 中栏接管视图（taskboard 同款）：容器挂进会话列末尾，html 属性驱动开合，只隐藏列内兄弟。
+     * 三代壳层选择器：dev shell data-pane / 官方 CSS-Module centerCol / Desktop 扩展框。 */
+    .dsh-git-view{display:none}
+    html[data-dsh-git-active] [data-pane="conversation"] > *:not([data-dsh-git-view]),
+    html[data-dsh-git-active] [class*="centerCol"] > *:not([data-dsh-git-view]),
+    html[data-dsh-git-active] .dshDesktopConversationSurface > *:not([data-dsh-git-view]){display:none !important}
+    html[data-dsh-git-active] .dsh-git-view{display:flex;flex-direction:column;height:100%;overflow:hidden}
+    /* 壳层退化（会话列缺席）：容器兜底挂 body 时退回全屏浮层，保证入口点击永远有响应 */
+    .dsh-git-view[data-dsh-git-fallback]{position:fixed;inset:0;z-index:2147483000;display:flex}
+    .dgs-page{position:relative;flex:1;min-height:0;display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family);font-size:14px}
     .dgs-head{display:flex;align-items:center;gap:12px;padding:12px 28px;border-bottom:1px solid var(--dsw-alias-border-l2);flex:none}
     .dgs-h1{font-size:16px;font-weight:700;margin:0}
     .dgs-close{margin-left:auto;cursor:pointer;border:none;background:transparent;color:var(--dsw-alias-label-secondary);font-size:18px;padding:4px 8px;border-radius:8px}
@@ -2050,7 +2065,7 @@ window.__ModuleLoader__.load({
 
     // ── 主页（仓库列表 + 建仓） ────────────────────────────────────────────────
 
-    function GitPage({ onClose, t }) {
+    function GitPage({ onClose, t, standalone }) {
       useEffect(ensureStyles, [])
       const route = useHashRoute()
       const [me, setMe] = useState(null)
@@ -2069,6 +2084,33 @@ window.__ModuleLoader__.load({
         window.addEventListener('keydown', onKey)
         return () => window.removeEventListener('keydown', onKey)
       }, [onClose])
+      // 中栏接管开合：挂载即打开 → html[data-dsh-git-active] + 广播互斥事件；卸载（关闭）时清理。
+      // standalone（__boot 开发挂载）不动全局。
+      useEffect(() => {
+        if (standalone) return undefined
+        for (const attr of DGS_OTHER_ACTIVE_ATTRS) document.documentElement.removeAttribute(attr)
+        document.documentElement.setAttribute(DGS_ACTIVE_ATTR, '')
+        document.dispatchEvent(new CustomEvent(DGS_ACTIVATE_EVENT, { detail: DGS_PANEL_NAME }))
+        return () => { document.documentElement.removeAttribute(DGS_ACTIVE_ATTR) }
+      }, [standalone])
+      useEffect(() => {
+        if (standalone) return undefined
+        const onOther = (e) => { if (e && e.detail !== DGS_PANEL_NAME) onClose() }
+        document.addEventListener(DGS_ACTIVATE_EVENT, onOther)
+        return () => document.removeEventListener(DGS_ACTIVATE_EVENT, onOther)
+      }, [standalone, onClose])
+      // 点侧栏会话行自动关面板（自家入口子树豁免）
+      useEffect(() => {
+        if (standalone) return undefined
+        const onClickRow = (e) => {
+          const target = e.target
+          if (!(target instanceof Element)) return
+          if (target.closest('[' + GIT_ENTRY_ATTR + ']')) return
+          if (target.closest(DGS_SIDEBAR_ROW_SELECTOR)) onClose()
+        }
+        document.addEventListener('click', onClickRow, true)
+        return () => document.removeEventListener('click', onClickRow, true)
+      }, [standalone, onClose])
       const notify = (m) => { setToast(m); setTimeout(() => setToast(''), 1600) }
       const seg = route.split('/').filter(Boolean)
       const view = seg[0] || 'repos'
@@ -2214,10 +2256,21 @@ window.__ModuleLoader__.load({
       try { gitPageHost.el.remove() } catch {}
       gitPageHost = null
     }
+    function gitConversationColumn() {
+      return document.querySelector('[data-pane="conversation"], [class*="centerCol"], .dshDesktopConversationSurface')
+    }
     function openGitPage(t) {
       if (gitPageHost) { closeGitPage(); return }
       const el = document.createElement('div')
-      document.body.appendChild(el)
+      el.setAttribute('data-dsh-git-view', '')
+      el.className = 'dsh-git-view'
+      const column = gitConversationColumn()
+      if (column) {
+        column.appendChild(el)
+      } else {
+        el.setAttribute('data-dsh-git-fallback', '')
+        document.body.appendChild(el)
+      }
       const root = require('react-dom/client').createRoot(el)
       gitPageHost = { el, root }
       root.render(h(GitPage, { onClose: closeGitPage, t }))
@@ -2269,6 +2322,7 @@ window.__ModuleLoader__.load({
     .dsh-git-entry .dsh-git-entry-stats{margin-left:auto;display:inline-flex;align-items:center;gap:4px;font-size:11px;color:var(--dsw-alias-label-secondary,var(--dsw-text-secondary,gray));font-variant-numeric:tabular-nums;white-space:nowrap}
     .dsh-git-entry .dsh-git-entry-dot{width:6px;height:6px;border-radius:6px;background:var(--dsw-alias-state-success-primary);display:inline-block}
     [data-sidebar-collapsed] .dsh-git-entry,[class*="_collapsed"] .dsh-git-entry{width:36px;height:36px;min-width:36px;margin:0 0 12px;padding:0;justify-content:center;gap:0;text-align:center}
+    html[data-dsh-git-active] .dsh-git-entry{background:var(--dsw-active,rgba(128,128,128,.18));color:var(--dsw-text-primary,inherit);font-weight:500}
     [data-sidebar-collapsed] .dsh-git-entry .dsh-git-entry-label,[data-sidebar-collapsed] .dsh-git-entry .dsh-git-entry-stats,[class*="_collapsed"] .dsh-git-entry .dsh-git-entry-label,[class*="_collapsed"] .dsh-git-entry .dsh-git-entry-stats{display:none}
     `
         document.head.appendChild(style)
@@ -2368,7 +2422,7 @@ window.__ModuleLoader__.load({
         ensureStyles()
         let t = opts.t || ((key) => ZH[key] ?? EN[key] ?? key)
         const root = require('react-dom/client').createRoot(container)
-        root.render(h(GitPage, { onClose: () => {}, t }))
+        root.render(h(GitPage, { onClose: () => {}, t, standalone: true }))
         return root
       },
       apply(ctx) {

package/client/index.js

@@ -2,8 +2,8 @@
  * @weibaohui/dsh-git-server — Browser half（原生 dsh 插件 UI，无 iframe/桥接）。
  *
  * 两个面：
- *  1. sidebar.footer.action「Git」→ 全屏管理页（仓库列表/建仓/删除 +
- *     仓库浏览：文件树/文件内容/提交/分支/工单[列表/新建/评论/开关]）。
+ *  1. sidebar.footer.action「Git」→ 中栏接管管理页（taskboard 同款，盖会话列不盖侧栏；
+ *     仓库列表/建仓/删除 + 仓库浏览：文件树/文件内容/提交/分支/工单[列表/新建/评论/开关]）。
  *  2. settings.section「Git 服务器」→ 服务配置（启停/端口/数据目录/兜底密码）。
  *
  * 数据通道：宿主同源路由 /dsh-git-server/api/*（dsh 登录门禁保护，
@@ -27,6 +27,12 @@ const { createElement: h, useState, useEffect, useCallback } = __React
 // ── locale ────────────────────────────────────────────────────────────────
 
 const NS = 'dshGitServer'
+// 中栏接管（taskboard 同款）开合属性 + 互斥协议
+const DGS_ACTIVE_ATTR = 'data-dsh-git-active'
+const DGS_PANEL_NAME = 'dsh-git'
+const DGS_ACTIVATE_EVENT = 'dsh-panel-activate'
+const DGS_OTHER_ACTIVE_ATTRS = ['data-dsh-atb-active', 'data-dsh-taskboard-active', 'data-dsh-ssh-active', 'data-dsh-prc-active', 'data-dsh-kb-active']
+const DGS_SIDEBAR_ROW_SELECTOR = '[class*="sessionRow"], [class*="projectRow"], [class*="searchResultRow"], [class*="newSession"]'
 const ZH = {
   nav: 'Git', title: '代码仓库',
   myRepos: '我的仓库', newRepo: '新建仓库', repoName: '仓库名', private: '私有',
@@ -84,7 +90,16 @@ function ensureStyles() {
   holder.id = 'dgs-styles'
   holder.style.display = 'none'
   holder.innerHTML = `<style>
-.dgs-page{position:fixed;inset:0;z-index:2147483000;display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family);font-size:14px}
+/* 中栏接管视图（taskboard 同款）：容器挂进会话列末尾，html 属性驱动开合，只隐藏列内兄弟。
+ * 三代壳层选择器：dev shell data-pane / 官方 CSS-Module centerCol / Desktop 扩展框。 */
+.dsh-git-view{display:none}
+html[data-dsh-git-active] [data-pane="conversation"] > *:not([data-dsh-git-view]),
+html[data-dsh-git-active] [class*="centerCol"] > *:not([data-dsh-git-view]),
+html[data-dsh-git-active] .dshDesktopConversationSurface > *:not([data-dsh-git-view]){display:none !important}
+html[data-dsh-git-active] .dsh-git-view{display:flex;flex-direction:column;height:100%;overflow:hidden}
+/* 壳层退化（会话列缺席）：容器兜底挂 body 时退回全屏浮层，保证入口点击永远有响应 */
+.dsh-git-view[data-dsh-git-fallback]{position:fixed;inset:0;z-index:2147483000;display:flex}
+.dgs-page{position:relative;flex:1;min-height:0;display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family);font-size:14px}
 .dgs-head{display:flex;align-items:center;gap:12px;padding:12px 28px;border-bottom:1px solid var(--dsw-alias-border-l2);flex:none}
 .dgs-h1{font-size:16px;font-weight:700;margin:0}
 .dgs-close{margin-left:auto;cursor:pointer;border:none;background:transparent;color:var(--dsw-alias-label-secondary);font-size:18px;padding:4px 8px;border-radius:8px}
@@ -2040,7 +2055,7 @@ function Admin({ t }) {
 
 // ── 主页（仓库列表 + 建仓） ────────────────────────────────────────────────
 
-function GitPage({ onClose, t }) {
+function GitPage({ onClose, t, standalone }) {
   useEffect(ensureStyles, [])
   const route = useHashRoute()
   const [me, setMe] = useState(null)
@@ -2059,6 +2074,33 @@ function GitPage({ onClose, t }) {
     window.addEventListener('keydown', onKey)
     return () => window.removeEventListener('keydown', onKey)
   }, [onClose])
+  // 中栏接管开合：挂载即打开 → html[data-dsh-git-active] + 广播互斥事件；卸载（关闭）时清理。
+  // standalone（__boot 开发挂载）不动全局。
+  useEffect(() => {
+    if (standalone) return undefined
+    for (const attr of DGS_OTHER_ACTIVE_ATTRS) document.documentElement.removeAttribute(attr)
+    document.documentElement.setAttribute(DGS_ACTIVE_ATTR, '')
+    document.dispatchEvent(new CustomEvent(DGS_ACTIVATE_EVENT, { detail: DGS_PANEL_NAME }))
+    return () => { document.documentElement.removeAttribute(DGS_ACTIVE_ATTR) }
+  }, [standalone])
+  useEffect(() => {
+    if (standalone) return undefined
+    const onOther = (e) => { if (e && e.detail !== DGS_PANEL_NAME) onClose() }
+    document.addEventListener(DGS_ACTIVATE_EVENT, onOther)
+    return () => document.removeEventListener(DGS_ACTIVATE_EVENT, onOther)
+  }, [standalone, onClose])
+  // 点侧栏会话行自动关面板（自家入口子树豁免）
+  useEffect(() => {
+    if (standalone) return undefined
+    const onClickRow = (e) => {
+      const target = e.target
+      if (!(target instanceof Element)) return
+      if (target.closest('[' + GIT_ENTRY_ATTR + ']')) return
+      if (target.closest(DGS_SIDEBAR_ROW_SELECTOR)) onClose()
+    }
+    document.addEventListener('click', onClickRow, true)
+    return () => document.removeEventListener('click', onClickRow, true)
+  }, [standalone, onClose])
   const notify = (m) => { setToast(m); setTimeout(() => setToast(''), 1600) }
   const seg = route.split('/').filter(Boolean)
   const view = seg[0] || 'repos'
@@ -2204,10 +2246,21 @@ function closeGitPage() {
   try { gitPageHost.el.remove() } catch {}
   gitPageHost = null
 }
+function gitConversationColumn() {
+  return document.querySelector('[data-pane="conversation"], [class*="centerCol"], .dshDesktopConversationSurface')
+}
 function openGitPage(t) {
   if (gitPageHost) { closeGitPage(); return }
   const el = document.createElement('div')
-  document.body.appendChild(el)
+  el.setAttribute('data-dsh-git-view', '')
+  el.className = 'dsh-git-view'
+  const column = gitConversationColumn()
+  if (column) {
+    column.appendChild(el)
+  } else {
+    el.setAttribute('data-dsh-git-fallback', '')
+    document.body.appendChild(el)
+  }
   const root = require('react-dom/client').createRoot(el)
   gitPageHost = { el, root }
   root.render(h(GitPage, { onClose: closeGitPage, t }))
@@ -2259,6 +2312,7 @@ function mountGitSidebarEntry(t) {
 .dsh-git-entry .dsh-git-entry-stats{margin-left:auto;display:inline-flex;align-items:center;gap:4px;font-size:11px;color:var(--dsw-alias-label-secondary,var(--dsw-text-secondary,gray));font-variant-numeric:tabular-nums;white-space:nowrap}
 .dsh-git-entry .dsh-git-entry-dot{width:6px;height:6px;border-radius:6px;background:var(--dsw-alias-state-success-primary);display:inline-block}
 [data-sidebar-collapsed] .dsh-git-entry,[class*="_collapsed"] .dsh-git-entry{width:36px;height:36px;min-width:36px;margin:0 0 12px;padding:0;justify-content:center;gap:0;text-align:center}
+html[data-dsh-git-active] .dsh-git-entry{background:var(--dsw-active,rgba(128,128,128,.18));color:var(--dsw-text-primary,inherit);font-weight:500}
 [data-sidebar-collapsed] .dsh-git-entry .dsh-git-entry-label,[data-sidebar-collapsed] .dsh-git-entry .dsh-git-entry-stats,[class*="_collapsed"] .dsh-git-entry .dsh-git-entry-label,[class*="_collapsed"] .dsh-git-entry .dsh-git-entry-stats{display:none}
 `
     document.head.appendChild(style)
@@ -2358,7 +2412,7 @@ module.exports = {
     ensureStyles()
     let t = opts.t || ((key) => ZH[key] ?? EN[key] ?? key)
     const root = require('react-dom/client').createRoot(container)
-    root.render(h(GitPage, { onClose: () => {}, t }))
+    root.render(h(GitPage, { onClose: () => {}, t, standalone: true }))
     return root
   },
   apply(ctx) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weibaohui/dsh-git-server",
-  "version": "0.1.2",
-  "description": "dsh 插件 · Git 服务器：内嵌 ts-gogs（Gogs 的 TypeScript 平替），独立端口跑完整 Git 服务（HTTP clone/push、网页端、issue/PR/wiki），可复用 user-management 的用户名密码，设置页一键启停。",
+  "version": "0.1.4",
+  "description": "dsh 插件 · Git 服务器：独立端口跑完整 Git 服务（HTTP clone/push、网页端、issue/PR/wiki/发版/标签/里程碑/webhook），可复用 user-management 账号，局域网可 clone，设置页一键启停、崩溃自动拉起。",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/weibaohui/dsh-git-server.git"
@@ -26,7 +26,7 @@
   ],
   "engines": {
     "node": ">=22.5",
-    "dsh": ">=0.1.2-rc.1"
+    "dsh": ">=0.1.7-rc.2"
   },
   "dsh": {
     "bundle": {

package/src/index.js

@@ -29,13 +29,13 @@ const inject = ['webServer', 'settings', 'connection']
 const API_PREFIX = '/' + engine.PLUGIN_ID + '/api'
 const SETTINGS_NS = engine.PLUGIN_ID
 
-// ── schemastery 加载（settings 服务同源；缺席时仅 loader config 生效）──────
+// ── schemastery：从宿主 dsh 全局安装的 vendored 副本同步加载（0.1.7 起
+//    settings 服务通过 entry.fiber.runtime.Config 自动发现 schema，不再支持
+//    ctx.settings.register，故必须在模块顶层同步构建导出的 Config）。加载
+//    失败则 Config 缺席，插件仍可运行（退回进程内兜底）。
 
-const { pathToFileURL } = require('node:url')
 const os = require('node:os')
 
-let schemaPromise = null
-
 function hostCandidatePaths(pkgName, rel) {
   const prefixes = [process.env.DSH_GLOBAL_PREFIX, os.homedir() + '/.local'].filter(Boolean)
   return prefixes.map((prefix) =>
@@ -43,64 +43,54 @@ function hostCandidatePaths(pkgName, rel) {
   )
 }
 
-function startSchemaLoader() {
-  if (!schemaPromise) {
-    schemaPromise = (async () => {
-      const candidates = [
-        ...hostCandidatePaths('schemastery', 'lib/index.cjs'),
-        '@deepseek-ai/schemastery',
-      ]
-      const errors = []
-      for (const target of candidates) {
-        try {
-          const specifier = target.includes('/') && !target.startsWith('@') && target.includes('node_modules')
-            ? pathToFileURL(target).href
-            : target
-          const mod = await import(specifier)
-          return mod
-        } catch (e) {
-          errors.push(`${target}: ${String((e && e.message) || e).slice(0, 160)}`)
-        }
-      }
-      throw new Error(errors.join(' | '))
-    })()
+// 同步加载 schemastery（CJS 副本优先，与宿主 settings 服务同源）。
+function loadSchemaSync() {
+  for (const target of hostCandidatePaths('schemastery', 'lib/index.cjs')) {
+    try { return require(target) } catch {}
   }
-  return schemaPromise
+  try { return require('@deepseek-ai/schemastery') } catch {}
+  return null
 }
 
-async function resolveSchema() {
-  try {
-    const mod = await startSchemaLoader()
-    if (!mod) return null
-    const Schema = mod.default || mod.Schema || (typeof mod === 'function' ? mod : null)
-    return Schema && typeof Schema.object === 'function' ? Schema : null
-  } catch {
-    return null
-  }
+// 测试缝隙：预先注入 Schema，让单测不依赖本机宿主安装
+let __schemaOverride = null
+function __seedSchema(Schema) {
+  __schemaOverride = Schema
+  Config = settingsSchema(Schema)
+  module.exports.Config = Config
 }
 
-function __seedSchema(Schema) {
-  schemaPromise = Promise.resolve(Schema ? { default: Schema } : null)
+// 兼容旧调用方（单测）：异步解析到同一份 Schema 或 null
+async function resolveSchema() {
+  const S = __schemaOverride || loadSchemaSync()
+  return S && typeof S.object === 'function' ? S : null
 }
 
-function settingsSchema(Schema) {
-  if (!Schema || typeof Schema.object !== 'function') return null
-  return Schema.object({
-    enabled: Schema.boolean().default(engine.DEFAULTS.enabled),
-    port: Schema.number().step(1).min(engine.NUM_RANGES.port[0]).max(engine.NUM_RANGES.port[1]).default(engine.DEFAULTS.port),
-    dataDir: Schema.string().default(engine.DEFAULTS.dataDir),
-    adminPassword: Schema.string().default(engine.DEFAULTS.adminPassword),
-    impersonateSecret: Schema.string().default(engine.DEFAULTS.impersonateSecret),
+function settingsSchema(S) {
+  if (!S || typeof S.object !== 'function') return null
+  // 字段标 .volatile()：0.1.7 settings 服务只把 volatile 字段投进设置 UI，
+  // 且只有 volatile 字段可经 ctx.settings.update 在线写回。
+  return S.object({
+    enabled: S.boolean().default(engine.DEFAULTS.enabled).volatile(),
+    port: S.number().step(1).min(engine.NUM_RANGES.port[0]).max(engine.NUM_RANGES.port[1]).default(engine.DEFAULTS.port).volatile(),
+    dataDir: S.string().default(engine.DEFAULTS.dataDir).volatile(),
+    adminPassword: S.string().default(engine.DEFAULTS.adminPassword).volatile(),
+    impersonateSecret: S.string().default(engine.DEFAULTS.impersonateSecret).volatile(),
   })
 }
 
+// 0.1.7 settings 服务自动发现模块导出的 Config（entry.fiber.runtime.Config）。
+const Schema = __schemaOverride || loadSchemaSync()
+let Config = settingsSchema(Schema)
+
 // ── 插件 ─────────────────────────────────────────────────────────────────
 
 module.exports = {
   name,
   inject,
+  Config,
   version: '0.1.0',
-  __internals: { settingsSchema, resolveSchema, __seedSchema, API_PREFIX, SETTINGS_NS },
+  __internals: { settingsSchema, loadSchemaSync, resolveSchema, __seedSchema, API_PREFIX, SETTINGS_NS },
 
   apply(ctx, config) {
     // 宿主可能过滤插件 logger 输出；console.error 走 stderr 保底可见（launchd 下进 err.log）
@@ -113,8 +103,8 @@ module.exports = {
     const webServer = ctx.webServer
 
     const base = engine.normalizeConfig({ ...engine.DEFAULTS, ...(config || {}) })
-    let settingsScope = null
-    let memoryPatch = {}
+    let liveSettings = {} // 0.1.7：settings 文档里的实时 volatile 值（事件驱动刷新）
+    let memoryPatch = {} // settings 写回失败时的进程内兜底
     let pwFileCache = null
 
     const state = { handle: null, fingerprint: '', error: null, restarting: 0, deps: 'ok' }
@@ -155,9 +145,9 @@ module.exports = {
         return
       }
       const pw = engine.generateSecret().slice(0, 20)
-      if (settingsScope && typeof settingsScope.update === 'function') {
+      if (ctx.settings && typeof ctx.settings.update === 'function') {
         try {
-          await settingsScope.update({ adminPassword: pw })
+          await ctx.settings.update(SETTINGS_NS, { adminPassword: pw })
         } catch (e) {
           logger.warn(`dsh-git-server: 管理员密码写入 settings 失败，退回文件: ${(e && e.message) || e}`)
           memoryPatch.adminPassword = pw
@@ -253,8 +243,8 @@ module.exports = {
       memoryPatch.impersonateSecret = pw
       cfg.impersonateSecret = pw
       if (fromFile) return
-      if (settingsScope && typeof settingsScope.update === 'function') {
-        try { await settingsScope.update({ impersonateSecret: pw }) } catch (e) {
+      if (ctx.settings && typeof ctx.settings.update === 'function') {
+        try { await ctx.settings.update(SETTINGS_NS, { impersonateSecret: pw }) } catch (e) {
           logger.warn(`dsh-git-server: impersonate secret 写入 settings 失败，退回文件: ${(e && e.message) || e}`)
           writeImpersonateFile(pw)
         }
@@ -317,11 +307,20 @@ module.exports = {
       }
     }
 
+    // 0.1.7：读取本命名空间在 settings 文档里的实时值（describe 投影后的 volatile 字段）。
+    // 没有 Config 或 settings 服务缺席时返回 {}，effective() 退回 base + memoryPatch。
+    function readLiveSettings() {
+      try {
+        if (!ctx.settings || typeof ctx.settings.describe !== 'function') return {}
+        const d = ctx.settings.describe().find((x) => x.ns === SETTINGS_NS)
+        return d && d.value ? d.value : {}
+      } catch {
+        return {}
+      }
+    }
+
     function effective() {
-      const fromSettings = settingsScope && typeof settingsScope.get === 'function'
-        ? settingsScope.get()
-        : null
-      return engine.normalizeConfig({ ...base, ...(fromSettings || {}), ...memoryPatch })
+      return engine.normalizeConfig({ ...base, ...liveSettings, ...memoryPatch })
     }
 
     let restartTimer = null
@@ -384,21 +383,26 @@ module.exports = {
       return status()
     }
 
-    // ── settings 注册（异步；缺席不阻塞宿主半其余功能）───────────────────
+    // ── settings 接线（0.1.7：导出 Config 即自动注册 schema + 自动生成设置
+    //    页面；这里只订阅文档变更刷新缓存，再 reconcile。settings 服务缺席或
+    //    Config 未构建时退回进程内兜底，不阻塞宿主半其余功能。）──────────────
     ;(async () => {
-      const Schema = await resolveSchema()
-      if (Schema && ctx.settings && typeof ctx.settings.register === 'function') {
-        try {
-          settingsScope = ctx.settings.register(SETTINGS_NS, settingsSchema(Schema), { base })
-          logger.info('dsh-git-server: settings-registered')
-        } catch (e) {
-          logger.warn(`dsh-git-server: settings register 失败（仅 loader config 生效）: ${(e && e.message) || e}`)
-        }
-      } else {
+      liveSettings = readLiveSettings()
+      if (!Config) {
         logger.warn(
-          `dsh-git-server: settings 不可用（Schema=${Boolean(Schema)}, ctx.settings=${Boolean(ctx.settings)}）——配置退回进程内兜底`,
+          `dsh-git-server: Config schema 未构建（schemastery 未加载）——配置退回进程内兜底`,
         )
       }
+      if (ctx.on && typeof ctx.on === 'function') {
+        ctx.effect(() => {
+          const off = ctx.on('settings/document-updated', (ns) => {
+            if (ns !== SETTINGS_NS) return
+            liveSettings = readLiveSettings()
+            reconcile().catch((e) => logger.error(`dsh-git-server: reconcile: ${(e && e.message) || e}`))
+          })
+          return () => { try { off() } catch {} }
+        }, 'dsh-git-server: settings watch')
+      }
       await reconcile()
     })().catch((e) => logger.error(`dsh-git-server: init: ${(e && e.message) || e}`))
 
@@ -654,9 +658,9 @@ module.exports = {
                 const patch = engine.sanitizePatch(patchBody, effective())
                 memoryPatch = { ...memoryPatch, ...patch }
                 if (typeof patch.adminPassword === 'string' && patch.adminPassword) writePasswordFile(patch.adminPassword)
-                if (settingsScope && typeof settingsScope.update === 'function') {
+                if (ctx.settings && typeof ctx.settings.update === 'function') {
                   try {
-                    await settingsScope.update(patch)
+                    await ctx.settings.update(SETTINGS_NS, patch)
                   } catch (e) {
                     logger.warn(`dsh-git-server: settings update 失败（仅本次进程生效）: ${(e && e.message) || e}`)
                   }