@weibaohui/experts-management 0.1.4 → 0.3.0

package/client/index.js

@@ -1,14 +1,18 @@
 /**
  * dsh-plugin-experts-management - Browser half.
  *
- * One React app for every surface (sidebar overlay + settings section):
- * expert management page (installed / market views + detail modal + market
+ * One React app for every surface (settings section; the former sidebar
+ *  fullscreen-overlay entry was retired — pair with dsh-settings-ui):
+ * expert management page (mine / built-in views + detail modal + built-in
  * sync settings). Plus the composer integration:
  * - an `expert` input-trigger source on `/` (candidates from the plugin's own
  *   HTTP API; pick inserts the literal `/expert-<name> ` token whose send the
  *   host's user-explicit gesture boundary turns into the expert prompt), and
- * - a `＋专家` button in the composer tool row (`conversation.input.left`)
- *   that opens exactly that source via the per-session `toggleSource`.
+ * - a `＋ 专家` button in the composer tool row (`conversation.input.left`)
+ *   that opens the plugin's own searchable picker popover (the host slash menu
+ *   filters only by a typed query, which a button click cannot provide); the
+ *   pick is written into the draft through the same scoped
+ *   `slash/input-insert-text` event the host menu uses.
  *
  * All interactive controls are host primitives
  * (@deepseek-ai/dsh-client-ui-primitives); all colors come from the ui-theme
@@ -63,13 +67,13 @@ const prim = (name) => P && P[name]
 const NS = 'expertsManagement'
 
 const ZH = {
-  title: '专家市场',
+  title: '专家管理',
   close: '关闭',
-  tabInstalled: '已安装',
-  tabMarket: '市场',
+  tabMine: '我的',
+  tabBuiltin: '内置',
   searchPlaceholder: '搜索专家名称、职业、描述…',
-  installedEmpty: '用户库还没有专家。去「市场」页浏览并安装。',
-  marketEmpty: '市场为空。请在设置中同步市场仓库。',
+  mineEmpty: '用户库还没有专家。去「内置」页浏览并安装。',
+  builtinEmpty: '内置专家为空。请在设置中同步内置仓库。',
   expertTypeAgent: '专家',
   expertTypeTeam: '团队',
   sourceLabel: '来源',
@@ -78,6 +82,34 @@ const ZH = {
   install: '安装',
   installing: '安装中…',
   installedDone: '已安装到用户库',
+  shareBtn: '分享',
+  shareTitle: '分享专家到官方仓库',
+  shareHint: 'AI 将读取本机令牌，fork 官方仓库 → 建分支 → 提交该专家目录 → 创建 PR。确认或修改提示词后，复制到当前会话发送执行。',
+  shareParamName: '专家名',
+  shareParamVersion: '版本',
+  shareParamDir: '本机目录',
+  copyPrompt: '复制提示词',
+  copied: '已复制',
+  runBtn: '执行',
+  running: '执行中…',
+  runDone: '完成',
+  runFailed: '失败',
+  outputLabel: '执行输出',
+  editMeta: '编辑资料',
+  displayName: '显示名',
+  professionLabel: '职业',
+  displayDescription: '描述',
+  defaultInitPrompt: '默认开场',
+  tagsLabel: '标签',
+  edit: '编辑',
+  save: '保存',
+  cancel: '取消',
+  saved: '已保存',
+  attachSkill: '添加技能',
+  detach: '移除',
+  detachConfirm: '仅移除专家的技能副本，不影响技能库本体。确认移除？',
+  uploadAvatar: '更换头像',
+  uploading: '上传中…',
   overwrite: '覆盖安装',
   remove: '删除',
   removing: '删除中…',
@@ -97,10 +129,10 @@ const ZH = {
   filesLabel: '文件',
   versionLabel: '版本',
   sourceReadonly: '只读来源（可在 NTD 中管理，或安装到用户库）',
-  marketSettings: '市场设置',
+  builtinSettings: '内置设置',
   syncNow: '立即同步',
   syncing: '同步中，可能需要一分钟…',
-  syncDoneUpdated: '同步完成，市场已更新',
+  syncDoneUpdated: '同步完成，内置已更新',
   syncDoneLatest: '已是最新版本',
   firstCloneDone: '首次克隆完成',
   repoUrlLabel: '仓库地址',
@@ -123,18 +155,22 @@ const ZH = {
   noDescription: '暂无描述',
   avatarLoadFailed: '头像加载失败',
   menuGroup: '专家',
-  pickExpert: '＋专家',
+  pickExpert: '＋ 专家',
   pickExpertTitle: '选择一位专家，以该专家的身份执行本条任务',
+  pickerLoading: '正在加载专家目录…',
+  pickerEmpty: '没有匹配的专家',
+  pickerTabAgents: '专家',
+  pickerTabTeams: '专家团',
 }
 
 const EN = {
-  title: 'Expert Market',
+  title: 'Expert Management',
   close: 'Close',
-  tabInstalled: 'Installed',
-  tabMarket: 'Market',
+  tabMine: 'Mine',
+  tabBuiltin: 'Built-in',
   searchPlaceholder: 'Search experts by name, profession, description…',
-  installedEmpty: 'No experts in the user library yet. Browse the Market tab and install one.',
-  marketEmpty: 'Market is empty. Sync the market repo in settings.',
+  mineEmpty: 'No experts in the user library yet. Browse the Built-in tab and install one.',
+  builtinEmpty: 'Built-in experts are empty. Sync the built-in repo in settings.',
   expertTypeAgent: 'Expert',
   expertTypeTeam: 'Team',
   sourceLabel: 'Source',
@@ -143,6 +179,34 @@ const EN = {
   install: 'Install',
   installing: 'Installing…',
   installedDone: 'Installed to the user library',
+  shareBtn: 'Share',
+  shareTitle: 'Share expert to the official repo',
+  shareHint: 'AI will read the local token, fork the official repo → create a branch → commit the expert directory → open a PR. Review or edit the prompt, then copy it into the conversation to run.',
+  shareParamName: 'Expert',
+  shareParamVersion: 'Version',
+  shareParamDir: 'Local dir',
+  copyPrompt: 'Copy prompt',
+  copied: 'Copied',
+  runBtn: 'Run',
+  running: 'Running…',
+  runDone: 'Done',
+  runFailed: 'Failed',
+  outputLabel: 'Output',
+  editMeta: 'Edit profile',
+  displayName: 'Display name',
+  professionLabel: 'Profession',
+  displayDescription: 'Description',
+  defaultInitPrompt: 'Default opener',
+  tagsLabel: 'Tags',
+  edit: 'Edit',
+  save: 'Save',
+  cancel: 'Cancel',
+  saved: 'Saved',
+  attachSkill: 'Add skill',
+  detach: 'Remove',
+  detachConfirm: "Only the expert's copy is removed — the skill library is untouched. Remove?",
+  uploadAvatar: 'Change avatar',
+  uploading: 'Uploading…',
   overwrite: 'Overwrite install',
   remove: 'Delete',
   removing: 'Deleting…',
@@ -162,10 +226,10 @@ const EN = {
   filesLabel: 'Files',
   versionLabel: 'Version',
   sourceReadonly: 'Read-only source (manage in NTD, or install into the user library)',
-  marketSettings: 'Market settings',
+  builtinSettings: 'Built-in settings',
   syncNow: 'Sync now',
   syncing: 'Syncing, may take a minute…',
-  syncDoneUpdated: 'Sync complete, market updated',
+  syncDoneUpdated: 'Sync complete, built-in updated',
   syncDoneLatest: 'Already up to date',
   firstCloneDone: 'First clone done',
   repoUrlLabel: 'Repository URL',
@@ -190,11 +254,15 @@ const EN = {
   menuGroup: 'Experts',
   pickExpert: '+ Expert',
   pickExpertTitle: 'Pick an expert to handle this message in their persona',
+  pickerLoading: 'Loading experts…',
+  pickerEmpty: 'No matching experts',
+  pickerTabAgents: 'Experts',
+  pickerTabTeams: 'Teams',
 }
 
 // ── Styles ───────────────────────────────────────────────────────────────
 
-const STYLE = `
+const STYLE = `<style>
 .exp-page{position:relative;display:flex;flex-direction:column;gap:14px;color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family);font-size:var(--dsw-font-sm-14,14px)}
 .exp-toolbar{display:flex;gap:8px;align-items:center;flex-wrap:wrap}
 .exp-tabs{display:flex;gap:4px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:3px}
@@ -238,17 +306,32 @@ const STYLE = `
 .exp-member-avatar{width:32px;height:32px;border-radius:8px;object-fit:cover;background:var(--dsw-alias-bg-layer-3)}
 .exp-skill-row{display:flex;flex-direction:column;gap:2px;padding:8px 0;border-bottom:1px solid var(--dsw-alias-border-l1)}
 .exp-skill-row:last-child{border-bottom:0}
-.exp-settings{display:flex;flex-direction:column;gap:10px;padding:14px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);border-radius:14px}
 .exp-form-row{display:flex;gap:10px;align-items:center;flex-wrap:wrap}
 .exp-form-row label{display:flex;flex-direction:column;gap:4px;font-size:12px;color:var(--dsw-alias-label-secondary);flex:1;min-width:160px}
-.exp-input{background:var(--dsw-alias-specific-input-major);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:6px 10px;color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;width:100%}
+.exp-flash{font-size:12px;color:var(--dsw-alias-state-positive,#3aa76d)}.exp-input{background:var(--dsw-alias-specific-input-major);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:6px 10px;color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;width:100%}
 .exp-status-line{display:flex;gap:14px;flex-wrap:wrap;font-size:12px;color:var(--dsw-alias-label-secondary)}
 .exp-toast{position:fixed;bottom:24px;left:50%;transform:translateX(-50%);background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-primary);border-radius:10px;padding:8px 18px;font-size:13px;z-index:80;box-shadow:0 8px 24px rgba(0,0,0,.25)}
 .exp-checkline{display:flex;gap:6px;align-items:center;font-size:13px;color:var(--dsw-alias-label-secondary)}
 .exp-checkline input{accent-color:var(--dsw-alias-brand-primary)}
 .exp-chip{display:inline-flex;align-items:center;gap:4px;height:26px;padding:0 9px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-secondary);font:inherit;font-size:12px;cursor:pointer;white-space:nowrap}
 .exp-chip:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}
-`
+.exp-picker-backdrop{position:fixed;inset:0;z-index:2147483200}
+.exp-picker{position:fixed;z-index:2147483201;width:400px;max-width:92vw;max-height:360px;display:flex;flex-direction:column;gap:4px;padding:6px;background:var(--dsw-specific-menu);border:1px solid var(--dsw-alias-border-inverted);border-radius:12px;box-shadow:var(--dsw-shadow-lv3)}
+.exp-picker-input{flex:none}
+.exp-picker-tabs{flex:none;align-self:flex-start}
+.exp-picker-list{display:flex;flex-direction:column;min-height:40px;overflow-y:auto}
+.exp-picker-row{display:flex;align-items:center;gap:8px;width:100%;min-height:36px;padding:6px 10px;border:0;border-radius:8px;background:transparent;color:var(--dsw-alias-label-primary);text-align:left;cursor:pointer;font:inherit;font-size:13px}
+.exp-picker-row[data-active="true"]{background:var(--dsw-alias-interactive-bg-hover)}
+.exp-picker-icon{width:18px;flex:none;text-align:center}
+.exp-picker-name{flex:none;max-width:45%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-weight:500}
+.exp-picker-literal{flex:none;max-width:32%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-tertiary);font-size:11px}
+.exp-picker-desc{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-tertiary);font-size:12px}
+.exp-picker-empty{padding:12px 10px;text-align:center;color:var(--dsw-alias-label-dimmed);font-size:13px}
+.exp-overlay{position:fixed;inset:0;z-index:2147483000;background:var(--dsw-alias-bg-base);overflow:auto;padding:20px 26px}
+.exp-head{display:flex;align-items:center;gap:10px;margin-bottom:4px}
+.exp-title{font-weight:600;font-size:16px}
+.exp-spacer{flex:1}
+</style>`
 
 // ── Helpers ──────────────────────────────────────────────────────────────
 
@@ -296,17 +379,51 @@ let expertRosterAt = 0
 const rosterListeners = new Set()
 const ROSTER_TTL = 60_000
 
+/**
+ * Roster row mapping (pure, testable). The host slash menu renders only
+ * name + description per row, so the human-readable displayName is prefixed
+ * into the description — expert teams (👥) and single experts both show
+ * their real name next to the `expert-<id>` literal. The picker popover
+ * renders `displayName` as the primary label and `plainDescription` as the
+ * secondary line instead. Rows come out sorted by displayName（中文按拼音），
+ * the picker splits them into 专家/专家团 tabs by `team`.
+ */
+function toRosterRows(mine, builtin) {
+  const rows = [...(Array.isArray(mine) ? mine : []), ...(Array.isArray(builtin) ? builtin : [])].map((e) => {
+    const displayName = e.displayName || e.name
+    const desc = e.description || e.profession || ''
+    return {
+      name: `expert-${e.name}`,
+      displayName,
+      description: displayName && displayName !== e.name ? (desc === '' ? displayName : `${displayName} · ${desc}`) : desc,
+      plainDescription: desc,
+      team: e.expertType === 'team',
+      icon: e.expertType === 'team' ? '👥' : '🧑‍💼',
+    }
+  })
+  rows.sort((a, b) => String(a.displayName).localeCompare(String(b.displayName), 'zh'))
+  return rows
+}
+
+/** Picker tab split (pure, testable): single experts vs expert teams. */
+function splitRosterByType(rows) {
+  const agents = [], teams = []
+  for (const r of Array.isArray(rows) ? rows : []) (r.team ? teams : agents).push(r)
+  return { agents, teams }
+}
+
+/** Picker filter predicate (pure): match the displayed fields, not the `expert-` prefix. */
+function pickerRowMatch(r, lower) {
+  return matchExpert({ name: r.name.replace(/^expert-/, ''), displayName: r.displayName, description: r.plainDescription }, lower)
+}
+
 async function fetchRoster(force) {
   if (!force && expertRoster !== null && Date.now() - expertRosterAt < ROSTER_TTL) return expertRoster
   try {
     const data = await fetchJson(API)
-    const installed = Array.isArray(data.installed) ? data.installed : []
-    const market = (Array.isArray(data.market) ? data.market : []).filter((e) => !e.installed)
-    expertRoster = [...installed, ...market].map((e) => ({
-      name: `expert-${e.name}`,
-      description: e.description || e.profession || '',
-      icon: e.expertType === 'team' ? '👥' : '🧑‍💼',
-    }))
+    const mine = Array.isArray(data.mine) ? data.mine : []
+    const builtin = (Array.isArray(data.builtin) ? data.builtin : []).filter((e) => !e.installed)
+    expertRoster = toRosterRows(mine, builtin)
     expertRosterAt = Date.now()
     for (const listener of [...rosterListeners]) { try { listener() } catch {} }
   } catch { /* 菜单失败静默：候选组保持 pending/缺席 */ }
@@ -346,6 +463,10 @@ function makeExpertSource(t) {
  * end (host toggleCommandMenu 同款调用形状）。The standard kit exposes no
  * caret, so the pick replaces a collapsed span at draft end — picks die
  * quietly on span-CAS if the draft moved since the click.
+ *
+ * NOTE: the ＋ 专家 button no longer uses this — the host menu cannot offer
+ * a search box, so the button opens ExpertPicker instead. Kept for the
+ * contract tests and as the documented toggleSource path.
  */
 function openTriggerSource(composerScope, sessionId, input, sourceName) {
   const inputTriggers = composerScope && composerScope.inputTriggers
@@ -368,6 +489,115 @@ function openTriggerSource(composerScope, sessionId, input, sourceName) {
   return true
 }
 
+/**
+ * Insert `text` at the end of the session draft through the same scoped
+ * event the host slash menu executes (`slash/input-insert-text`). The span
+ * CAS uses the freshest input snapshot handed to the slot props — while the
+ * picker popover is open the composer draft cannot move (focus is in the
+ * picker), so the splice applies; a stale snapshot quietly no-ops, same as
+ * the host menu's span-CAS.
+ */
+function insertComposerText(scope, sessionId, input, text) {
+  const sessions = scope && scope.sessions
+  if (!sessions) return false
+  let actx
+  try { actx = sessions.scope(sessionId) } catch { return false }
+  if (actx === undefined || actx === null || typeof actx.bail !== 'function') return false
+  const draft = (input && input.draft) || ''
+  const at = draft.length
+  try {
+    return actx.bail(actx, 'slash/input-insert-text', {
+      text,
+      span: { start: at, end: at, draftRev: (input && input.draftRev) || 0 },
+    }) === true
+  } catch { return false }
+}
+
+/** Best-effort refocus of the composer textarea after the picker closes. */
+function refocusComposer() {
+  try {
+    const card = document.querySelector('[data-composer-card]')
+    const ta = card && card.querySelector('textarea')
+    if (ta && typeof ta.focus === 'function') ta.focus()
+  } catch {}
+}
+
+/** Picker popover list cap — beyond this the search input is the filter. */
+const PICKER_ROW_CAP = 200
+
+/**
+ * ＋ 专家 picker：锚定在按钮上方、自带搜索框的候选浮层（portal 到 body）。
+ * 宿主斜杠菜单靠「输入的 query」过滤，按钮打开的菜单没有输入载体——候选
+ * 太多时无从筛选，所以浮层自带搜索框。专家/专家团分两个 tab（tab 标签上的
+ * 计数跟随当前搜索过滤），各 tab 内按显示名排序（toRosterRows 已排好）。
+ * 键盘 ↑/↓/Enter/Esc，鼠标 hover+点击；tab 按钮 mousedown 不抢输入框焦点。
+ */
+function ExpertPicker(props) {
+  const t = props.t
+  const [query, setQuery] = useState('')
+  const [tab, setTab] = useState('agent') // 'agent' | 'team'
+  const [active, setActive] = useState(0)
+  const inputRef = useRef(null)
+  const listRef = useRef(null)
+  useEffect(() => { try { if (inputRef.current) inputRef.current.focus() } catch {} }, [])
+  useEffect(() => {
+    const onKey = (e) => { if (e.key === 'Escape' && !(e.isComposing === true)) props.onClose() }
+    try { document.addEventListener('keydown', onKey) } catch {}
+    return () => { try { document.removeEventListener('keydown', onKey) } catch {} }
+  }, [])
+  const lower = query.trim().toLowerCase()
+  const { agents, teams } = splitRosterByType(props.rows)
+  const filteredAgents = lower === '' ? agents : agents.filter((r) => pickerRowMatch(r, lower))
+  const filteredTeams = lower === '' ? teams : teams.filter((r) => pickerRowMatch(r, lower))
+  const shown = (tab === 'team' ? filteredTeams : filteredAgents).slice(0, PICKER_ROW_CAP)
+  useEffect(() => { setActive(0) }, [lower, tab, props.rows])
+  useEffect(() => {
+    const list = listRef.current
+    const el = list && list.children[active]
+    if (el && typeof el.scrollIntoView === 'function') { try { el.scrollIntoView({ block: 'nearest' }) } catch {} }
+  }, [active])
+  const onKeyDown = (e) => {
+    // IME 组词中的按键不触发选择（回车是选定拼音候选，不是 pick）
+    if (e.nativeEvent && e.nativeEvent.isComposing === true) return
+    if (e.key === 'ArrowDown') { e.preventDefault(); setActive((i) => Math.min(i + 1, shown.length - 1)) }
+    else if (e.key === 'ArrowUp') { e.preventDefault(); setActive((i) => Math.max(i - 1, 0)) }
+    else if (e.key === 'Enter') { e.preventDefault(); const row = shown[active]; if (row) props.onPick(row) }
+  }
+  const width = 400
+  const winW = typeof window !== 'undefined' ? window.innerWidth : 800
+  const winH = typeof window !== 'undefined' ? window.innerHeight : 600
+  const left = Math.max(8, Math.min(props.anchor.left, winW - width - 8))
+  const bottom = Math.max(8, winH - props.anchor.top + 6)
+  const tabBtn = (key, labelKey, count) => h('button', {
+    type: 'button', role: 'tab', className: 'exp-tab', 'data-on': tab === key, 'aria-selected': tab === key,
+    onMouseDown: (e) => { e.preventDefault(); setTab(key) }, onClick: () => setTab(key),
+  }, `${t(labelKey)} (${count})`)
+  return h('div', { className: 'exp-picker-backdrop', onMouseDown: (e) => { if (e.target === e.currentTarget) props.onClose() } },
+    h('div', { className: 'exp-picker', style: { left, bottom, width }, role: 'dialog', 'aria-label': t('pickExpertTitle') },
+      h('input', {
+        ref: inputRef, className: 'exp-input exp-picker-input', value: query,
+        placeholder: t('searchPlaceholder'), onChange: (e) => setQuery(e.target.value), onKeyDown,
+      }),
+      h('div', { className: 'exp-tabs exp-picker-tabs', role: 'tablist' },
+        tabBtn('agent', 'pickerTabAgents', filteredAgents.length),
+        tabBtn('team', 'pickerTabTeams', filteredTeams.length)),
+      h('div', { className: 'exp-picker-list', ref: listRef, role: 'listbox' },
+        props.rows === null
+          ? h('div', { className: 'exp-picker-empty' }, t('pickerLoading'))
+          : shown.length === 0
+            ? h('div', { className: 'exp-picker-empty' }, t('pickerEmpty'))
+            : shown.map((row, i) => h('button', {
+                key: row.name, type: 'button', role: 'option', 'aria-selected': i === active,
+                className: 'exp-picker-row', 'data-active': i === active,
+                onMouseEnter: () => setActive(i),
+                onMouseDown: (e) => { e.preventDefault(); props.onPick(row) },
+              },
+                row.icon ? h('span', { className: 'exp-picker-icon', 'aria-hidden': 'true' }, row.icon) : null,
+                h('span', { className: 'exp-picker-name' }, row.displayName || row.name),
+                row.displayName && row.displayName !== row.name ? h('span', { className: 'exp-picker-literal' }, row.name) : null,
+                h('span', { className: 'exp-picker-desc' }, row.plainDescription || ''))))))
+}
+
 // ── Small components ─────────────────────────────────────────────────────
 
 function Avatar({ expert, size }) {
@@ -442,18 +672,136 @@ function MemberAvatar({ expertName, source, member, t }) {
     : h('div', { className: 'exp-member-avatar', title: t('avatarLoadFailed') }, '👤')
 }
 
-function DetailModal({ name, source, t, onClose, onInstalled, onDeleted }) {
+let shareDialogComponent = null
+function getShareDialogComponent() {
+  if (shareDialogComponent === null) shareDialogComponent = PluginKit.makeActionShareDialog(__React)
+  return shareDialogComponent
+}
+
+/** 专家分享提示词：提交到 ntd-resource 的 experts/ 子树（与技能分享同管线、同 token）。 */
+const EXPERT_SHARE_PROMPT = [
+  '请把本地专家「{{expertName}}」{{version}}打包提交到 GitCode 官方仓库 weibaohui/ntd-resource 的 experts/ 子树，作为一个 PR 供维护者审核。',
+  '',
+  '## 关键信息',
+  '- 专家目录：{{resourceDir}}（~ 表示当前用户家目录，执行前先展开为绝对路径）',
+  '- 官方仓库：weibaohui/ntd-resource（GitCode，API base = https://api.gitcode.com）',
+  '- PAT 位置：{{settingsFile}} 中 skills-management.market 段的 token 字段（由技能市场设置面板保存，与技能分享同源）。',
+  '',
+  '## 执行步骤（严格按顺序）',
+  '1. 读取 PAT：读取 {{settingsFile}}，定位 skills-management.market 段下的 token 字段。token 是敏感凭据，读取后不要把明文打印到输出、日志或最终结果里。',
+  '2. 展开专家目录为绝对路径，遍历该目录（含 agents/、skills/、avatars/ 子目录与 .codebuddy-plugin/plugin.json），收集每个文件的「相对该目录的路径」与内容；跳过 .git 一类同步元数据。',
+  '3. 把第 1 步读到的 token 作为 HTTP 认证令牌（bearer），按顺序调用 GitCode API：',
+  '   a. 验证用户：`GET https://api.gitcode.com/api/v5/user`，拿到 login 字段——后续所有 URL 里的 {owner} 一律用它。',
+  '   b. fork：`POST https://api.gitcode.com/api/v5/repos/weibaohui/ntd-resource/forks`；若返回 409/422 表示已 fork，视为成功。',
+  '   c. 建分支：`POST https://api.gitcode.com/api/v5/repos/{owner}/ntd-resource/branches`，JSON body 为 {"branch_name":"experts/{{expertName}}-<unix 时间戳>","refs":"main"}。',
+  '   d. 写文件：对第 2 步收集的每个文件，`POST https://api.gitcode.com/api/v5/repos/{owner}/ntd-resource/contents/experts/{{该文件相对专家目录的路径}}`。**必须**用 experts/ 前缀，不能写到仓库根目录。表单字段 content=<文件字节的 base64>、message="贡献专家 {{expertName}} {{version}}"、branch=<步骤 c 的分支名>。',
+  '   e. 创建 PR：`POST https://api.gitcode.com/api/v5/repos/weibaohui/ntd-resource/pulls`，JSON body 为 {"title":"[专家] {{expertName}} {{version}}","body":"专家目录 {{resourceDir}} 的文件清单与用途简介","head":"{owner}:{branch}","base":"main"}。',
+  '4. 完成后，最终输出 PR 的网页链接（响应里的 web_url 字段）。',
+  '',
+  '## 注意',
+  '- token 是敏感凭据，任何输出里都不要回显其明文。',
+  '- 如果任一步骤失败，先检查错误信息，不要盲目重试；若 token 失效，提示用户到技能市场的 ⚙ 设置面板重新填写。',
+  '- 全程与最终汇报都使用中文。',
+].join('\n')
+
+function DetailModal({ name, source, t, onClose, onInstalled, onDeleted, onToast }) {
   const [detail, setDetail] = useState(null)
   const [error, setError] = useState('')
   const [busy, setBusy] = useState(false)
   const [agentMd, setAgentMd] = useState(null)
+  const detailUrl = () => `${API}/detail?name=${encodeURIComponent(name)}${source ? `&source=${encodeURIComponent(source)}` : ''}`
+  const loadDetail = () => fetchJson(detailUrl())
+    .then((d) => setDetail(d))
+    .catch((e) => setError(String(e && e.message)))
+  useEffect(() => { loadDetail() }, [name, source])
+  // ── 编辑态（v0.3，仅 dsh 用户库专家）──
+  const [editingMd, setEditingMd] = useState(null)   // {agent, content} | null
+  const [metaEdit, setMetaEdit] = useState(false)
+  const [metaForm, setMetaForm] = useState(null)
+  const [skillsEdit, setSkillsEdit] = useState(false)
+  const [availSkills, setAvailSkills] = useState(null)
+  const [saving, setSaving] = useState(false)
+  const [savedFlash, setSavedFlash] = useState('')
+  const [avatarBusy, setAvatarBusy] = useState(false)
+  const [shareOpen, setShareOpen] = useState(false)
+  const [shareSettingsFile, setShareSettingsFile] = useState('')
+  const avatarInputRef = useRef(null)
   useEffect(() => {
-    let live = true
-    fetchJson(`${API}/detail?name=${encodeURIComponent(name)}${source ? `&source=${encodeURIComponent(source)}` : ''}`)
-      .then((d) => { if (live) setDetail(d) })
-      .catch((e) => { if (live) setError(String(e && e.message)) })
-    return () => { live = false }
-  }, [name, source])
+    if (shareOpen === false) return
+    fetchJson(`${API}/share/status`).then((d) => setShareSettingsFile(d.settingsFile || '')).catch(() => setShareSettingsFile(''))
+  }, [shareOpen])
+  const flash = (text) => { setSavedFlash(text); setTimeout(() => setSavedFlash(''), 1600) }
+  const startEditMd = (agentName) => {
+    fetchJson(`${API}/agent-md?name=${encodeURIComponent(name)}${source ? `&source=${encodeURIComponent(source)}` : ''}&agent=${encodeURIComponent(agentName)}`)
+      .then((r) => setEditingMd({ agent: agentName, content: r.content }))
+      .catch((e) => setError(String(e && e.message)))
+  }
+  const saveMd = async () => {
+    setSaving(true); setError('')
+    try {
+      await fetchJson(`${API}/agent-md`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ name, agent: editingMd.agent, content: editingMd.content }) })
+      setEditingMd(null); flash(t('saved')); loadDetail()
+    } catch (e) { setError(String(e && e.message)) } finally { setSaving(false) }
+  }
+  const startMetaEdit = () => {
+    const p = (detail && detail.pluginJson) || {}
+    const loc = (v) => ({ zh: (v && v.zh) || '', en: (v && v.en) || '' })
+    const tags = Array.isArray(p.tags) ? p.tags : []
+    setMetaForm({
+      displayName: loc(p.displayName), profession: loc(p.profession),
+      displayDescription: loc(p.displayDescription), defaultInitPrompt: loc(p.defaultInitPrompt),
+      tagsZh: tags.map((x) => x.zh || '').filter(Boolean).join(','),
+      tagsEn: tags.map((x) => x.en || '').filter(Boolean).join(','),
+      quickPrompts: Array.isArray(p.quickPrompts) ? p.quickPrompts : [],
+    })
+    setMetaEdit(true)
+  }
+  const saveMeta = async () => {
+    setSaving(true); setError('')
+    const splitList = (v) => String(v || '').split(/[,，]/).map((x) => x.trim()).filter(Boolean)
+    const body = { metadata: {
+      displayName: metaForm.displayName, profession: metaForm.profession,
+      displayDescription: metaForm.displayDescription, defaultInitPrompt: metaForm.defaultInitPrompt,
+      tags: (function () {
+        const zhList = splitList(metaForm.tagsZh); const enList = splitList(metaForm.tagsEn)
+        const len = Math.max(zhList.length, enList.length)
+        return Array.from({ length: len }, (_, i) => ({ zh: zhList[i] || '', en: enList[i] || '' })).filter((t) => t.zh !== '' || t.en !== '')
+      })(),
+      quickPrompts: metaForm.quickPrompts,
+    } }
+    try {
+      await fetchJson(`${API}/metadata`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ name, ...body }) })
+      setMetaEdit(false); flash(t('saved')); loadDetail()
+    } catch (e) { setError(String(e && e.message)) } finally { setSaving(false) }
+  }
+  const detachSkill = (skillName) => {
+    if (!window.confirm(t('detachConfirm'))) return
+    fetchJson(`${API}/expert-skills`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ name, detach: [skillName] }) })
+      .then(() => { flash(t('saved')); loadDetail() })
+      .catch((e) => setError(String(e && e.message)))
+  }
+  const openSkillsEdit = () => {
+    setSkillsEdit(true)
+    if (availSkills === null) {
+      fetchJson(`${API}/available-skills`).then((d) => setAvailSkills(d.skills || [])).catch((e) => setError(String(e && e.message)))
+    }
+  }
+  const attachSkill = (skillName) => {
+    fetchJson(`${API}/expert-skills`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ name, attach: [skillName] }) })
+      .then(() => { flash(t('saved')); loadDetail() })
+      .catch((e) => setError(String(e && e.message)))
+  }
+  const onAvatarFile = async (e) => {
+    const f = e.target.files && e.target.files[0]
+    e.target.value = ''
+    if (!f) return
+    setAvatarBusy(true); setError('')
+    try {
+      const buf = new Uint8Array(await f.arrayBuffer())
+      await fetchJson(`${API}/avatar?name=${encodeURIComponent(name)}`, { method: 'POST', headers: { 'Content-Type': 'application/octet-stream' }, body: buf })
+      flash(t('saved')); loadDetail()
+    } catch (ex) { setError(String(ex && ex.message)) } finally { setAvatarBusy(false) }
+  }
   const loadAgentMd = () => {
     fetchJson(`${API}/agent-md?name=${encodeURIComponent(name)}${source ? `&source=${encodeURIComponent(source)}` : ''}`)
       .then((r) => setAgentMd(r.content))
@@ -495,6 +843,24 @@ function DetailModal({ name, source, t, onClose, onInstalled, onDeleted }) {
           kv(t('filesLabel'), `${detail.fileCount} / ${formatSize(detail.totalSize)}`),
           kv(t('dirLabel'), detail.dir)),
         detail.readOnly ? h('div', { className: 'exp-kv' }, h('span', { style: { color: 'var(--dsw-alias-label-tertiary)' } }, t('sourceReadonly'))) : null,
+        detail.source === 'dsh' ? h('div', { className: 'exp-form-row' },
+          h('button', { className: 'exp-btn', disabled: busy || saving || avatarBusy, onClick: startMetaEdit }, t('editMeta')),
+          h('button', { className: 'exp-btn', disabled: busy || saving || avatarBusy, onClick: () => { if (avatarInputRef.current) avatarInputRef.current.click() } }, avatarBusy ? t('uploading') : t('uploadAvatar')),
+          savedFlash ? h('span', { className: 'exp-flash' }, savedFlash) : null,
+          h('input', { ref: avatarInputRef, type: 'file', accept: 'image/png,image/jpeg,image/gif,image/webp', style: { display: 'none' }, onChange: onAvatarFile })) : null,
+        metaEdit && metaForm ? h('div', { className: 'exp-section' },
+          h('div', { className: 'exp-section-title' }, t('editMeta')),
+          ...['displayName', 'profession', 'displayDescription', 'defaultInitPrompt'].map((key) => h('div', { key, style: { marginBottom: '8px' } },
+            h('div', { className: 'exp-section-title', style: { margin: '4px 0' } }, t(key === 'profession' ? 'professionLabel' : key === 'tags' ? 'tagsLabel' : key)),
+            h('input', { className: 'exp-input', value: metaForm[key].zh, placeholder: 'zh', onChange: (e) => setMetaForm({ ...metaForm, [key]: { ...metaForm[key], zh: e.target.value } }), style: { marginBottom: '4px', width: '100%' } }),
+            h('input', { className: 'exp-input', value: metaForm[key].en, placeholder: 'en', onChange: (e) => setMetaForm({ ...metaForm, [key]: { ...metaForm[key], en: e.target.value } }), style: { width: '100%' } }))),
+          h('div', { style: { marginBottom: '8px' } },
+            h('div', { className: 'exp-section-title', style: { margin: '4px 0' } }, t('tagsLabel')),
+            h('input', { className: 'exp-input', value: metaForm.tagsZh, placeholder: 'zh，逗号分隔', onChange: (e) => setMetaForm({ ...metaForm, tagsZh: e.target.value }), style: { marginBottom: '4px', width: '100%' } }),
+            h('input', { className: 'exp-input', value: metaForm.tagsEn, placeholder: 'en, comma separated', onChange: (e) => setMetaForm({ ...metaForm, tagsEn: e.target.value }), style: { width: '100%' } })),
+          h('div', { className: 'exp-form-row' },
+            h('button', { className: 'exp-btn', 'data-primary': 'true', disabled: saving, onClick: saveMeta }, saving ? '…' : t('save')),
+            h('button', { className: 'exp-btn', disabled: saving, onClick: () => setMetaEdit(false) }, t('cancel')))) : null,
         (detail.quickPromptsZh || []).length > 0 ? h('div', { className: 'exp-section' },
           h('div', { className: 'exp-section-title' }, t('quickPrompts')),
           ...detail.quickPromptsZh.slice(0, 5).map((q, i) => h('div', { className: 'exp-kv', key: i }, '• ', q))) : null,
@@ -510,13 +876,33 @@ function DetailModal({ name, source, t, onClose, onInstalled, onDeleted }) {
           h('div', { className: 'exp-section-title' }, t('skills')),
           ...detail.skillMeta.map((s) => h('div', { className: 'exp-skill-row', key: s.skillName },
             h('div', { style: { fontSize: 13 } }, `${s.emoji ? s.emoji + ' ' : ''}${s.skillName}`),
-            h('div', { className: 'exp-profession' }, s.descriptionZh || s.descriptionEn || s.description || '')))) : null,
+            h('div', { className: 'exp-profession' }, s.descriptionZh || s.descriptionEn || s.description || ''),
+            detail.source === 'dsh' ? h('button', { className: 'exp-btn', style: { marginLeft: 'auto' }, onClick: () => detachSkill(s.skillName) }, t('detach')) : null)),
+          detail.source === 'dsh' ? h('div', { className: 'exp-form-row' },
+            skillsEdit ? null : h('button', { className: 'exp-btn', onClick: openSkillsEdit }, t('attachSkill'))) : null,
+          detail.source === 'dsh' && skillsEdit ? h('div', { className: 'exp-form-row' },
+            availSkills === null ? h('span', { className: 'exp-profession' }, '…')
+              : availSkills.length === 0 ? h('span', { className: 'exp-profession' }, '—')
+                : availSkills.map((sk) => h('button', { key: sk.name, className: 'exp-btn', title: sk.description, onClick: () => attachSkill(sk.name) }, `＋ ${sk.name}`))) : null) : null,
         (detail.agentFiles || []).length > 0 ? h('div', { className: 'exp-section' },
           h('div', { className: 'exp-section-title' }, t('agents')),
           ...detail.agentFiles.map((a) => h('div', { className: 'exp-skill-row', key: a.relPath },
             h('div', { style: { fontSize: 13 } }, `${a.emoji ? a.emoji + ' ' : ''}${a.name}${a.name === detail.leadAgentFile ? ' ★' : ''}`),
-            h('div', { className: 'exp-profession' }, a.description || '')))) : null,
+            h('div', { className: 'exp-profession' }, a.description || ''),
+            detail.source === 'dsh' ? h('button', { className: 'exp-btn', style: { marginLeft: 'auto' }, onClick: () => startEditMd(a.name) }, t('edit')) : null))) : null,
+        editingMd !== null ? h('div', { className: 'exp-section' },
+          h('div', { className: 'exp-section-title' }, `${t('edit')} · ${editingMd.agent}`),
+          h('textarea', {
+            className: 'exp-input', value: editingMd.content,
+            onChange: (e) => setEditingMd({ ...editingMd, content: e.target.value }),
+            spellCheck: false,
+            style: { width: '100%', minHeight: '260px', fontFamily: 'ui-monospace,monospace', fontSize: '12px', lineHeight: 1.6, whiteSpace: 'pre-wrap', background: 'var(--dsw-alias-bg-layer-2,transparent)', color: 'inherit', border: '1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.3))', borderRadius: '8px', padding: '10px', boxSizing: 'border-box' },
+          }),
+          h('div', { className: 'exp-form-row' },
+            h('button', { className: 'exp-btn', 'data-primary': 'true', disabled: saving, onClick: saveMd }, saving ? '…' : t('save')),
+            h('button', { className: 'exp-btn', disabled: saving, onClick: () => setEditingMd(null) }, t('cancel')))) : null,
         h('div', { className: 'exp-form-row' },
+          h('button', { className: 'exp-btn', onClick: () => setShareOpen(true) }, t('shareBtn')),
           h('button', { className: 'exp-btn', onClick: () => (agentMd === null ? loadAgentMd() : setAgentMd(null)) }, agentMd === null ? t('viewAgentMd') : t('hideAgentMd')),
           detail.source !== 'dsh'
             ? h('button', { className: 'exp-btn', 'data-primary': 'true', disabled: busy, onClick: () => install(false) }, busy ? t('installing') : t('install'))
@@ -528,19 +914,28 @@ function DetailModal({ name, source, t, onClose, onInstalled, onDeleted }) {
         detail.plugin ? h('details', null,
           h('summary', { style: { cursor: 'pointer', fontSize: 12, color: 'var(--dsw-alias-label-tertiary)' } }, t('pluginJson')),
           h('pre', { className: 'exp-pre' }, JSON.stringify(detail.plugin, null, 2))) : null,
-      ) : null))
+      ) : null,
+      shareOpen ? h(getShareDialogComponent(), {
+        title: t('shareTitle'), hint: t('shareHint'),
+        rows: [[t('shareParamName'), detail.name], [t('shareParamVersion'), detail.version || '1.0.0'], [t('shareParamDir'), detail.dir]],
+        initialPrompt: PluginKit.substituteParams(EXPERT_SHARE_PROMPT, { expertName: detail.name, version: detail.version || '1.0.0', resourceDir: detail.dir, settingsFile: shareSettingsFile }),
+        labels: { copy: t('copyPrompt'), copied: t('copied'), run: t('runBtn'), running: t('running'), done: t('runDone'), failed: t('runFailed'), outputLabel: t('outputLabel') },
+        run: (prompt) => fetchJson(`${API}/share/run`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ prompt, dir: detail.dir }) }),
+        poll: (id) => fetchJson(`${API}/share/run?id=${encodeURIComponent(id)}`),
+        onClose: () => setShareOpen(false),
+      }) : null))
 }
 
-function MarketSettingsCard({ t, onToast, onSynced }) {
+function BuiltinSettingsDialog({ t, onClose, onToast, onSynced }) {
   const [status, setStatus] = useState(null)
   const [form, setForm] = useState(null)
   const [busy, setBusy] = useState(false)
-  const load = () => fetchJson(`${API}/market/status`).then((s) => { setStatus(s); setForm((f) => f ?? { url: s.url, branch: s.branch, repoDir: s.dir, token: '', autoSync: s.autoSync, syncOnStartup: s.syncOnStartup }) })
+  const load = () => fetchJson(`${API}/builtin/status`).then((s) => { setStatus(s); setForm((f) => f ?? { url: s.url, branch: s.branch, repoDir: s.dir, token: '', autoSync: s.autoSync, syncOnStartup: s.syncOnStartup }) })
   useEffect(() => { load() }, [])
   const sync = async () => {
     setBusy(true)
     try {
-      const r = await fetchJson(`${API}/market/sync`, { method: 'POST' })
+      const r = await fetchJson(`${API}/builtin/sync`, { method: 'POST' })
       onToast(r.isFirstClone ? t('firstCloneDone') : r.hasUpdates ? t('syncDoneUpdated') : t('syncDoneLatest'))
       await load()
       onSynced()
@@ -554,51 +949,72 @@ function MarketSettingsCard({ t, onToast, onSynced }) {
       const dirText = (form.repoDir || '').trim()
       if (dirText !== '' && dirText !== (status && status.dir)) patch.repoDir = dirText
       if (typeof form.token === 'string' && form.token !== '') patch.token = form.token
-      if (form.token === null) patch.token = null
-      await fetchJson(`${API}/market/settings`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(patch) })
+      await fetchJson(`${API}/builtin/settings`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(patch) })
       setForm((f) => ({ ...f, token: '' }))
       onToast(t('saved'))
       await load()
     } catch (e) { onToast(String(e && e.message)) }
     setBusy(false)
   }
-  const field = (label, value, onChange, type) => h('label', null, label,
-    h('input', { className: 'exp-input', type: type || 'text', value: value ?? '', onChange: (e) => onChange(e.target.value) }))
-  if (status === null) return null
-  return h('div', { className: 'exp-settings' },
-    h('div', { className: 'exp-status-line' },
-      h('b', null, t('marketSettings')),
-      h('span', null, `${t('repoDirLabel')}: ${status.dir}`),
-      h('span', null, `${t('lastSyncLabel')}: ${status.lastSyncAt ? formatTime(status.lastSyncAt) : t('never')}`),
-      status.localCommit ? h('span', null, `${t('localCommitLabel')}: ${String(status.localCommit).slice(0, 8)}`) : null,
-      status.remoteCommit ? h('span', null, `${t('remoteCommitLabel')}: ${String(status.remoteCommit).slice(0, 8)}`, status.needsUpdate ? Badge({ kind: 'type', children: t('needsUpdateTag') }) : null) : null,
-      !status.gitAvailable ? h('span', { style: { color: 'var(--dsw-alias-state-error-primary)' } }, t('gitMissing')) : null,
-      status.sparsePaths ? h('span', null, `sparse: ${(status.sparsePaths || []).join(', ')}`) : null),
-    h('div', { className: 'exp-form-row' },
-      field(t('repoUrlLabel'), form.url, (v) => setForm({ ...form, url: v })),
-      field(t('branchLabel'), form.branch, (v) => setForm({ ...form, branch: v }))),
-    h('div', { className: 'exp-form-row' },
-      field(t('repoDirLabel'), form.repoDir, (v) => setForm({ ...form, repoDir: v })),
-      field(`${t('tokenLabel')}${status.hasToken ? ` (${t('tokenConfigured')})` : ''}`, form.token ?? '', (v) => setForm({ ...form, token: v }), 'password')),
-    h('div', { className: 'exp-form-row' },
-      h('label', { className: 'exp-checkline' },
-        h('input', { type: 'checkbox', checked: !!form.autoSync, onChange: (e) => setForm({ ...form, autoSync: e.target.checked }) }), t('autoSyncLabel')),
-      h('label', { className: 'exp-checkline' },
-        h('input', { type: 'checkbox', checked: !!form.syncOnStartup, onChange: (e) => setForm({ ...form, syncOnStartup: e.target.checked }) }), t('syncOnStartupLabel')),
-      h('span', { style: { flex: 1 } }),
-      status.hasToken ? h('button', { className: 'exp-btn', disabled: busy, onClick: () => setForm({ ...form, token: null }) }, t('clearToken')) : null,
-      h('button', { className: 'exp-btn', disabled: busy || status.syncing, onClick: sync }, busy || status.syncing ? t('syncing') : t('syncNow')),
-      h(prim('Button'), { onClick: save, disabled: busy }, t('save'))))
+  const clearToken = async () => {
+    setBusy(true)
+    try {
+      await fetchJson(`${API}/builtin/settings`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ token: null }) })
+      onToast(t('saved'))
+      await load()
+    } catch (e) { onToast(String(e && e.message)) }
+    setBusy(false)
+  }
+  // 布局逐行对齐技能市场的市场设置弹窗：状态区 = 左标签/右值成行；
+  // 输入区 = 全宽堆叠、placeholder 即标签；底部 = 右对齐 保存 + 立即同步(主按钮)。
+  const short = (c) => (c ? String(c).slice(0, 8) : '-')
+  const row = (label, value) => h('div', { style: { display: 'flex', justifyContent: 'space-between', gap: 12, padding: '3px 0' } },
+    h('span', { className: 'exp-profession' }, label), h('span', { style: { wordBreak: 'break-all', textAlign: 'right', fontSize: 12, color: 'var(--dsw-alias-label-secondary)' } }, value))
+  return h('div', { className: 'exp-modal-backdrop', onClick: (e) => { if (e.target === e.currentTarget) onClose() } },
+    h('div', { className: 'exp-modal', style: { maxWidth: 640 } },
+      h('div', { className: 'exp-modal-head' },
+        h('span', { className: 'exp-title' }, t('builtinSettings')),
+        h('button', { className: 'exp-btn exp-modal-close', onClick: onClose }, t('close'))),
+      status === null ? h('div', { className: 'exp-empty' }, '…')
+        : h('div', { style: { display: 'contents' } },
+          !status.gitAvailable ? h('div', { style: { color: 'var(--dsw-alias-state-error-primary)', fontSize: 12 } }, t('gitMissing')) : null,
+          h('div', null,
+            row(t('repoUrlLabel'), status.url),
+            row(t('branchLabel'), status.branch),
+            row(t('localCommitLabel'), short(status.localCommit)),
+            status.remoteCommit ? h('div', { style: { display: 'flex', justifyContent: 'flex-end' } },
+              status.needsUpdate ? Badge({ kind: 'type', children: t('needsUpdateTag') }) : null) : null,
+            row(t('remoteCommitLabel'), short(status.remoteCommit)),
+            row(t('lastSyncLabel'), status.lastSyncAt ? formatTime(status.lastSyncAt) : t('never')),
+            row(t('repoDirLabel'), status.dir),
+            status.sparsePaths ? row('sparse', (status.sparsePaths || []).join(', ')) : null),
+          h('div', { style: { display: 'flex', gap: 16, flexWrap: 'wrap' } },
+            h('label', { className: 'exp-checkline' },
+              h('input', { type: 'checkbox', checked: !!form.autoSync, onChange: (e) => setForm({ ...form, autoSync: e.target.checked }) }), t('autoSyncLabel')),
+            h('label', { className: 'exp-checkline' },
+              h('input', { type: 'checkbox', checked: !!form.syncOnStartup, onChange: (e) => setForm({ ...form, syncOnStartup: e.target.checked }) }), t('syncOnStartupLabel'))),
+          h('div', { style: { display: 'flex', flexDirection: 'column', gap: 6 } },
+            h('input', { className: 'exp-input', value: form.url ?? '', placeholder: t('repoUrlLabel'), onChange: (e) => setForm({ ...form, url: e.target.value }), style: { width: '100%', boxSizing: 'border-box' } }),
+            h('input', { className: 'exp-input', value: form.branch ?? '', placeholder: t('branchLabel'), onChange: (e) => setForm({ ...form, branch: e.target.value }), style: { width: '100%', boxSizing: 'border-box' } }),
+            h('input', { className: 'exp-input', value: form.repoDir ?? '', placeholder: t('repoDirLabel'), onChange: (e) => setForm({ ...form, repoDir: e.target.value }), style: { width: '100%', boxSizing: 'border-box' } }),
+            h('div', { style: { display: 'flex', gap: 6, alignItems: 'center' } },
+              h('input', { className: 'exp-input', type: 'password', value: form.token ?? '', onChange: (e) => setForm({ ...form, token: e.target.value }),
+                placeholder: status.hasToken ? `${t('tokenLabel')} · ${t('tokenConfigured')}` : t('tokenLabel'), style: { flex: 1 } }),
+              status.hasToken ? h('button', { className: 'exp-btn', disabled: busy, onClick: clearToken }, t('clearToken')) : null)),
+          h('div', { style: { display: 'flex', gap: 8, justifyContent: 'flex-end', marginTop: 4 } },
+            h('button', { className: 'exp-btn', disabled: busy, onClick: save }, t('save')),
+            h('button', { className: 'exp-btn', 'data-primary': 'true', disabled: busy || status.syncing, onClick: sync }, busy || status.syncing ? t('syncing') : t('syncNow'))))))
 }
 
 // ── Page ─────────────────────────────────────────────────────────────────
 
-function ExpertsPage({ t, embedded }) {
-  const [tab, setTab] = useState('market')
+function ExpertsPage({ t, embedded, onClose }) {
+  const [tab, setTab] = useState('builtin')
   const [data, setData] = useState(null)
   const [error, setError] = useState('')
   const [search, setSearch] = useState('')
   const [selected, setSelected] = useState(null) // {name, source}
+  const [settingsOpen, setSettingsOpen] = useState(false)
   const [busyName, setBusyName] = useState(null)
   const [toast, setToast] = useState(null)
   const showToast = (text) => { setToast(text); setTimeout(() => setToast(null), 2600) }
@@ -607,7 +1023,7 @@ function ExpertsPage({ t, embedded }) {
   const rows = useMemo(() => {
     if (!data) return []
     const lower = search.trim().toLowerCase()
-    const list = tab === 'installed' ? data.installed : data.market
+    const list = tab === 'mine' ? data.mine : data.builtin
     return list.filter((e) => matchExpert(e, lower))
   }, [data, tab, search])
   const install = async (row) => {
@@ -637,16 +1053,20 @@ function ExpertsPage({ t, embedded }) {
     } catch (e) { showToast(String(e && e.message)) }
     setBusyName(null)
   }
-  return h('div', { className: 'exp-page' },
+  return h('div', { className: 'exp-page' + (embedded ? '' : ' exp-overlay') },
+    !embedded ? h('div', { className: 'exp-head' },
+      h('span', { className: 'exp-title' }, t('title')),
+      h('span', { className: 'exp-spacer' }),
+      h('button', { className: 'exp-btn', onClick: () => { if (onClose) onClose() } }, t('close'))) : null,
     h('div', { className: 'exp-toolbar' },
       h('div', { className: 'exp-tabs' },
-        h('button', { className: 'exp-tab', 'data-on': tab === 'installed', onClick: () => setTab('installed') }, `${t('tabInstalled')}${data ? ` (${data.installed.length})` : ''}`),
-        h('button', { className: 'exp-tab', 'data-on': tab === 'market', onClick: () => setTab('market') }, `${t('tabMarket')}${data ? ` (${data.market.length})` : ''}`)),
+        h('button', { className: 'exp-tab', 'data-on': tab === 'mine', onClick: () => setTab('mine') }, `${t('tabMine')}${data ? ` (${data.mine.length})` : ''}`),
+        h('button', { className: 'exp-tab', 'data-on': tab === 'builtin', onClick: () => setTab('builtin') }, `${t('tabBuiltin')}${data ? ` (${data.builtin.length})` : ''}`)),
       h('input', { className: 'exp-input exp-search', placeholder: t('searchPlaceholder'), value: search, onChange: (e) => setSearch(e.target.value) }),
-      h('span', { className: 'exp-count' }, `${rows.length}`)),
-    tab === 'market' ? h(MarketSettingsCard, { t, onToast: showToast, onSynced: reload }) : null,
+      h('span', { className: 'exp-count' }, `${rows.length}`),
+      tab === 'builtin' ? h('button', { className: 'exp-btn', title: t('builtinSettings'), onClick: () => setSettingsOpen(true) }, t('builtinSettings')) : null),
     error !== '' ? h('div', { className: 'exp-empty' }, `${t('loadFailed')}: ${error}`) : null,
-    data !== null && rows.length === 0 ? h('div', { className: 'exp-empty' }, tab === 'installed' ? t('installedEmpty') : t('marketEmpty')) : null,
+    data !== null && rows.length === 0 ? h('div', { className: 'exp-empty' }, tab === 'mine' ? t('mineEmpty') : t('builtinEmpty')) : null,
     rows.length > 0
       ? h(PagedGrid, {
           items: rows,
@@ -658,6 +1078,9 @@ function ExpertsPage({ t, embedded }) {
       onInstalled: () => { setSelected(null); showToast(t('installedDone')); reload() },
       onDeleted: () => { setSelected(null); showToast(t('removedDone')); reload() },
     }) : null,
+    settingsOpen ? h(BuiltinSettingsDialog, {
+      t, onClose: () => setSettingsOpen(false), onToast: showToast, onSynced: reload,
+    }) : null,
     toast !== null ? h('div', { className: 'exp-toast' }, toast) : null)
 }
 
@@ -669,6 +1092,7 @@ module.exports = {
   __internals: {
     NS, ZH, EN, matchExpert, formatSize, formatTime, avatarUrl,
     EXPERT_SOURCE_NAME, makeExpertSource, openTriggerSource, fetchRoster,
+    toRosterRows, insertComposerText, splitRosterByType, pickerRowMatch,
   },
   /** Test/host helper: mount a standalone page into any container. */
   __boot(container, opts = {}) {
@@ -720,20 +1144,6 @@ module.exports = {
         })
       }
     } catch (e) { try { console.error('[experts-management] composer inject:', e) } catch {} }
-    ctx.effect(() => {
-      try {
-        ctx.slots.inject('sidebar.footer.action', () => ctx.slots.register({
-          name: 'sidebar.footer.action',
-          id: CLIENT_NAME,
-          order: 60,
-          locale: NS,
-          label: () => t('title'),
-          inject: () => ({ t }),
-        }, function FooterSlot(apiProps) {
-          return h(FooterSlotComponent, { __t: t, wide: apiProps && apiProps.wide })
-        }))
-      } catch (e) { (globalThis.__expErrors = globalThis.__expErrors || []).push('footer:' + (e && e.message)); throw e }
-    }, 'experts-management: sidebar footer action')
     ctx.effect(() => {
       try {
         ctx.slots.inject('settings.section', () => ctx.slots.register({
@@ -759,8 +1169,8 @@ module.exports = {
           inject: () => ({ t }),
         }, function ExpertButtonSlot(apiProps) {
           return h(ComposerButtonSlot, {
-            __t: t, icon: '🧑‍💼', label: t('pickExpert'), title: t('pickExpertTitle'),
-            source: EXPERT_SOURCE_NAME, composerScopeRef: () => composerScope,
+            __t: t, label: t('pickExpert'), title: t('pickExpertTitle'),
+            composerScopeRef: () => composerScope,
             sessionId: apiProps && apiProps.sessionId, input: apiProps && apiProps.input,
           })
         }))
@@ -769,34 +1179,46 @@ module.exports = {
   },
 }
 
-/** Footer slot entry: the button, and — when open — the whole experts page
- *  portaled to <body> as a fullscreen overlay (same pattern as the skills
- *  market footer entry). */
-function FooterSlotComponent(props) {
-  const t = props.__t
-  const [open, setOpen] = useState(false)
-  useEffect(ensureStyles, [])
-  if (!open) {
-    return h('button', { className: 'exp-btn', onClick: () => setOpen(true), title: t('title') }, t('title'))
-  }
-  const page = h(ExpertsPage, { t, embedded: false, onClose: () => setOpen(false) })
-  if (RDP && typeof RDP.createPortal === 'function') return RDP.createPortal(page, document.body)
-  return page
-}
-
-/** Composer tool-row button: opens one registered '/' source over the
- *  session's trigger controller. Hidden while the inputTriggers/sessions
- *  services are absent (plugin composed without the trigger pipeline). */
+/** Composer tool-row button: 加号+文字 chip，点击在按钮上方打开自带搜索的
+ *  专家 picker 浮层；pick 经 slash/input-insert-text 写入 `/expert-<name> `。
+ *  浮层面板盖住按钮以外的区域，再点一次按钮会先落在背板上——天然形成开关切换。
+ *  inputTriggers/sessions 服务缺席时按钮隐藏（管理页不受影响）。 */
 function ComposerButtonSlot(props) {
   useEffect(ensureStyles, [])
+  const [picker, setPicker] = useState(null) // {left, top} 锚点快照；null = 关闭
+  const [rows, setRows] = useState(null)     // null = 加载中
+  const btnRef = useRef(null)
+  const liveInput = useRef(props.input)
+  liveInput.current = props.input
   const composerScope = props.composerScopeRef ? props.composerScopeRef() : null
-  const ready = !!(composerScope && composerScope.inputTriggers && composerScope.sessions && props.sessionId)
+  const ready = !!(composerScope && composerScope.sessions && props.sessionId)
   if (!ready) return null
+  const close = () => setPicker(null)
+  const open = () => {
+    let anchor = { left: 16, top: 160 }
+    try { if (btnRef.current) anchor = btnRef.current.getBoundingClientRect() } catch {}
+    setPicker({ left: anchor.left, top: anchor.top })
+    setRows(null)
+    Promise.resolve(fetchRoster())
+      .then((list) => setRows(Array.isArray(list) ? list : []))
+      .catch(() => setRows([]))
+  }
+  const pick = (row) => {
+    insertComposerText(composerScope, props.sessionId, liveInput.current, `/${row.name} `)
+    close()
+    refocusComposer()
+  }
+  const popover = picker !== null && RDP && typeof RDP.createPortal === 'function'
+    ? RDP.createPortal(h(ExpertPicker, { t: props.__t, anchor: picker, rows, onClose: close, onPick: pick }), document.body)
+    : null
   return h('button', {
     className: 'exp-chip',
+    ref: btnRef,
     title: props.title || props.label,
-    onClick: () => { openTriggerSource(composerScope, props.sessionId, props.input, props.source) },
-  }, `${props.icon || ''}${props.icon ? ' ' : ''}${props.label}`)
+    'aria-haspopup': 'dialog',
+    'aria-expanded': picker !== null,
+    onClick: open,
+  }, props.label, popover)
 }
 
 /** Settings section slot entry: render the page directly in the host tree. */