dsh-code-ui 1.5.2 → 1.6.1

package/README.md

@@ -114,6 +114,8 @@ dsh-code-ui/
 
 | 时间 | 版本 | 修复 / 新增 |
 | --- | --- | --- |
+| 2026-10-10 | v1.6.0 | 里程碑：**契约迁移到 DSH 官方 Typert Remote**——自定义 RPC 通道从 `connection.rpc.handle("/dsh-code-ui")`（0.1.5 起有 Cordis guard 405 bug，靠自挂 webServer 路由兜底）整体迁到 `/api` 通道：Host 侧 `CodeUiService` 经 `bindTypertRemote` + `@Remote` 标记注册并 `ctx.root.reflect.provide` 到宿主 root Context，api-gateway SRC 扫描自动发现（`internal/service` 事件失效缓存，插件后加载有效）；浏览器侧 `rpc.call('/api', 'dsh-code-ui/<端点>', { args: { args: payload } })`，33 个端点名/参数/返回值全部不变；handle 调用、自挂路由、Host/Origin 认证门整套删除。同一套代码兼容宿主 0.1.5-rc.x 与 0.2.0-rc.x。配套：peer 增加 `@deepseek-ai/dsh >=0.1.5-rc.1 <0.3.0`（宿主安装门强制校验）、`dsh-typert-protocol`/`dsh-tools` 补声明，`dsh-settings` 范围扩到 `<0.3.0`（旧 `^0.1.x` 范围在 0.2.0 宿主会被拒载）；`engines.dsh` 同步声明；`client.inject` 移除新版已不存在的 `dsh-client-runtime`；新增 `icon.svg` + `exports["./icon"]`（插件管理器不再回退默认图）；卸载卡 NO_ENDPOINT 识别覆盖 gateway 新错误文案；新增 `tools/typert-smoke.mjs` 冒烟（真实 cordis 4.0.2 + typert-protocol 0.1.5-rc.2 上验证注册全链路 11/11） |
+| 2026-09-18 | v1.5.3 | 新增：**插件自卸载**——配置卡新增「卸载插件」危险区（两击确认防误触，5 秒不点第二下自动回弹）。主路径调官方 CLI（`dsh plugin --profile <p> remove dsh-code-ui`，自动识别三种启动形态：源码入口带 execArgv 再唤起 / POSIX 直装 / Windows .cmd shim 经 cmd.exe 引号包装）；CLI 不可用自动退路 pnpm remove（hoist 漂移先 pnpm install 重建再重试）；全程实时滚动 pnpm 日志；收尾按**磁盘真相**核对依赖行 / bundles 清单行 / node_modules（#65 幽灵清单保护：文件已删而清单未清时原子补删清单行，tmp+rename，防 profile 起不来）。成功绿字明确告知**需重启 DSH 彻底生效**（重启前插件仍运行，浏览器建议 Ctrl+F5）；幂等（已卸载再点显示已是未安装状态）；失败红字留档：错误码（PROFILE_NOT_FOUND / PLUGIN_CMD_FAILED / PNPM_FAILED / TIMEOUT / MANIFEST_LOCKED / FILES_STILL_PRESENT）+ 原因 + 逐条手动处理指导。旧宿主无此端点时给出「先升级插件再卸载」的 NO_ENDPOINT 兜底提示 |
 | 2026-09-11 | v1.5.2 | 修复：停靠面板拖拽分界线不再折行——编辑区去掉 min-width 下限，面板标题/按钮/状态栏等文本全部 nowrap + 省略号截断，拖到多窄只截断、不把文字竖排成一列；停靠面板左缘拖到宽度 < 80px 时自动切回 dsh UI（还原拖前宽度，下次展开不残留细条） |
 | 2026-09-11 | v1.5.0 | 里程碑：**引用体系全面升级——行内引用 chip**。引用/翻译后标签不再挂在输入框上方，而是以 chip 直接嵌入输入框句中（`1:文件名:起行-止行`，翻译带 🌐 前缀），点击跳转编辑器、退格即删；`@` 菜单可把引用插入句中任意位置；发送时 chip 原位展开为 `- 代码引用 / - 翻译引用 文件名:行号（路径）` 引用行，正文由 AI 经 `get_referenced_snippets` 读取。实现：注册宿主 InputTrigger 触发源（candidates/onPick/codec）+ ReferenceChipNode 装饰器直插（shell.insertReference，实时取 `conversation.input.shell(sid).snapshot` 的 draft/draftRev）；chip ref 自包含 JSON（抗刷新/重启）。配套：**引用一次性消耗**——发送即标记已使用、chip 清空、【引用/备注】留档可查；**允许重复引用**（chip 可见可删，取消 host 去重）；**引用编号全链路贯通**——标签/消息指针/引用卡/AI 工具输出同号，对 AI 说「引用N」即指对应条目；【引用/备注】条目右键菜单（复制 / 翻译 / 引用给AI）；消息区引用卡 + chip 文件图标/点击跳转；提示条 ✕ 手动关闭兜底；移除「引用消耗模式」配置项（固定一次性）与输入条上方 tag 条（被行内 chip 取代）。工程：发送补丁改挂 shell.submit 必经点（原生输入条回车/按钮走 keyboard.submit，原 inputActions 补丁只覆盖插件输入卡）；纯 chip 携带的发送同样消耗 |
 | 2026-09-09 | v1.4.1 | 修复：编辑器**每敲一个字符文本抖动一下**。根因：hljs 就绪后，每次击键高亮层经历「tokenizer 顶上 → 60ms 防抖后换 hljs」**两次全量 innerHTML 重写**，浏览器重写 innerHTML 时 `scrollTop`/`scrollLeft` 被重置为 0——凡滚动过（垂直或水平）的文件，每次击键可见文本都会位移。修复：≤32KB 的文件改为**同步走 hljs**（单帧渲染直接出最终结果，无交换帧、工作量减半），>32KB 保留 60ms 防抖路径；并在每次渲染提交后从 textarea 回同步高亮层与行号滚动位（兜底所有 innerHTML 重写场景）。新增：**编辑器状态按会话记忆**——切换对话时快照当前会话的标签页/激活项并恢复目标会话的（此前 `applyRoot` 换根即清空标签与缓冲，切会话打开的文件全消失）；滚动位按文件路径记忆、标签恢复挂载即自动回滚；焦点不恢复，由用户自己点击决定；缓冲/脏标记以绝对路径为键全局保留，切走再切回未保存内容与 ● 状态原样还在，原「有脏文件暂不跟随根」守卫随之退役，根始终跟随新会话；**文件树展开状态同样按会话记忆**——目录展开与已加载子目录随会话快照/恢复（`applyRoot` 仅在 nodes 里没有该根节点时才重建树，同根换会话不再折叠），侧栏不再切一次对话就全部收起 |

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect x="4" y="4" width="56" height="56" rx="12" fill="#1f6feb"/>
+  <path d="M22 20l-8 6 8 6" fill="none" stroke="#fff" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M42 20l8 6-8 6" fill="none" stroke="#fff" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+  <line x1="36" y1="18" x2="28" y2="46" stroke="#fff" stroke-width="4" stroke-linecap="round"/>
+</svg>

package/lib/client.js

@@ -1,6 +1,6 @@
 // Browser half of dsh-code-ui — standard bundle plugin.
 // Hand-written JS, no build. Registered via __ModuleLoader__; host RPC goes
-// through the shared Connection service channel "/dsh-code-ui".
+// through the official Typert Remote channel "/api" (namespace dsh-code-ui).
 window.__ModuleLoader__.load({
   id: "dsh-code-ui",
   factory: (require) => {
@@ -15,7 +15,6 @@ window.__ModuleLoader__.load({
       const primitives = require("@deepseek-ai/dsh-client-ui-primitives");
       if (primitives && primitives.IconChevronDownOutline14) IconChevronDown = primitives.IconChevronDownOutline14;
     } catch (e) {}
-    const CHANNEL = "/dsh-code-ui";
 
     function __apply(ctx) {
 // --- begin original apply body ---
@@ -26,10 +25,10 @@ window.__ModuleLoader__.load({
     // 协议失败不会 reject（只有传输层 HTTP 失败才 throw）。这里统一解包成「裸值」，
     // 协议错误折叠为 { error: message }，让下方各调用点沿用自己的 res.error 判断
     // （对齐 dsh-updater 的 res.ok / res.value 消费约定）。
-    // 修复：迁移期版本直接读 res.entries / res.root 等字段，在封套下恒为 undefined，
-    // 导致 get-root / 文件树 / 路径跳转（stat-path）全部静默失效。
+    // 端点名映射：方法只收单个 args 对象（Typert Remote SRC 约定：参数名即 wire 字段名），
+    // 所以 payload 再包一层 { args: payload } 作为 wire 字段的值。
     function callHost(endpoint, payload) {
-      return rpc.call(CHANNEL, endpoint, payload === undefined ? null : payload)
+      return rpc.call('/api', 'dsh-code-ui/' + endpoint, { args: payload === undefined ? {} : { args: payload } })
         .then((res) => {
           if (!res || typeof res !== 'object') return { error: 'RPC 返回异常' }
           if (res.ok === false) {
@@ -45,6 +44,9 @@ window.__ModuleLoader__.load({
     const slots = ctx.get('slots');
     if (slots === undefined) return
     const timer = ctx.get('timer')
+    // 宿主主题服务（cordis 键 theme，0.1.5-rc.2 起）：snapshot.active.colorScheme 是当前
+    // 明暗权威，theme/change 事件（上方已监听）驱动重渲染；老宿主缺失时各处回退 body 属性
+    const themeService = ctx.get('theme')
     const h = React.createElement
     const vw = (typeof window !== 'undefined' && window.innerWidth) ? window.innerWidth : 1200
     const vh = (typeof window !== 'undefined' && window.innerHeight) ? window.innerHeight : 800
@@ -254,7 +256,7 @@ window.__ModuleLoader__.load({
       .cdex-dock-toggle.active{color:var(--dsw-alias-label-primary,#d4d4d4);border-color:var(--dsw-alias-label-dimmed,#6a6a70);}
       /* dsh 模式（不挂调色板）时的反色按钮与 token 色：
          反色按钮直接用 DSH 的 brand-primary（浅色=黑 / 深色=白），文字色取 bg-base（自动反色）；
-         token 色由 tokensClass() 检测 body[data-ds-dark-theme] 后挂 .cdex-tokens-light/dark */
+         token 色由 tokensClass() 读宿主 theme 服务 snapshot 后挂 .cdex-tokens-light/dark */
       .cdex-workbench,.cdex-modebar{--cdex-accent-bg:var(--dsw-alias-brand-primary,#0f1115);--cdex-accent-fg:var(--dsw-alias-bg-base,#ffffff);}
       .cdex-tokens-light{--cdex-tk-kw:#af00db;--cdex-tk-str:#a31515;--cdex-tk-com:#008000;--cdex-tk-num:#098658;--cdex-tk-fn:#795e26;--cdex-tk-punc:#555555;}
       .cdex-tokens-dark{--cdex-tk-kw:#c586c0;--cdex-tk-str:#ce9178;--cdex-tk-com:#6a9955;--cdex-tk-num:#b5cea8;--cdex-tk-fn:#dcdcaa;--cdex-tk-punc:#808080;}
@@ -412,12 +414,18 @@ window.__ModuleLoader__.load({
     // system 模式用 matchMedia 监听操作系统外观切换，实时换肤。
     let themeMode = 'dsh'
     let mqDispose = null
-    let bodyObs = null
     function systemPrefersDark() {
       try { return !!(window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) } catch (e) { return true }
     }
-    // DSH 自身外观：body[data-ds-dark-theme] 由 DSH 主题系统维护
+    // DSH 自身外观：优先读宿主 theme 服务 snapshot 的 active.colorScheme（契约路径）；
+    // 服务缺失时回退 body[data-ds-dark-theme]（旧版宿主）
     function dshPrefersDark() {
+      try {
+        const snap = themeService && (typeof themeService.getSnapshot === 'function' ? themeService.getSnapshot() : themeService.snapshot)
+        if (snap && snap.active && (snap.active.colorScheme === 'dark' || snap.active.colorScheme === 'light')) {
+          return snap.active.colorScheme === 'dark'
+        }
+      } catch (e) {}
       try { return !!(document.body && document.body.hasAttribute && document.body.hasAttribute('data-ds-dark-theme')) } catch (e) { return true }
     }
     function themeClass() {
@@ -446,12 +454,7 @@ window.__ModuleLoader__.load({
             mqDispose = () => mq.removeListener(onChange)
           }
         }
-        // dsh 模式监听宿主外观切换（token 色需要跟着翻）；其余模式断开
-        if (bodyObs) { try { bodyObs.disconnect() } catch (e) {} bodyObs = null }
-        if (themeMode === 'dsh' && typeof MutationObserver !== 'undefined' && document.body) {
-          bodyObs = new MutationObserver(() => emit())
-          bodyObs.observe(document.body, { attributes: true, attributeFilter: ['data-ds-dark-theme'] })
-        }
+        // dsh 模式跟随宿主外观：theme/change 事件（§1 已监听）驱动重渲染，无需再观察 body 属性
       } catch (e) {}
       emit()
     }
@@ -935,6 +938,38 @@ window.__ModuleLoader__.load({
       } else { emit() }
     }
     // —— 标签页 / 编辑 / 保存 ——
+    // read-file 新契约（dsh ≥ 0.1.7-rc.1 二进制 Remote 结果）：res.bytes 为 Uint8Array，
+    // 经 multipart 附件通道下发；0.1.5/0.1.6 老宿主无投影，bytes 走 JSON 落成下标对象，
+    // 这里重建为 Uint8Array，同一份代码两端兼容。content 字段为更老服务端的兼容退路。
+    // 返回 readOnly/reason：截断加载（>4MB 只取前 4MB）或二进制内容都禁写，防写坏磁盘文件。
+    function decodeReadFileRes(res) {
+      let bytes = res && res.bytes
+      if (bytes && !(bytes instanceof Uint8Array)) {
+        if (Array.isArray(bytes)) bytes = Uint8Array.from(bytes)
+        else if (typeof bytes === 'object') {
+          const keys = Object.keys(bytes)
+          const u = new Uint8Array(keys.length)
+          for (let k = 0; k < keys.length; k++) u[k] = Number(bytes[keys[k]]) & 255
+          bytes = u
+        } else bytes = null
+      }
+      let text
+      let readOnly = false
+      let reason = null
+      if (bytes) {
+        text = new TextDecoder('utf-8', { fatal: false }).decode(bytes)
+        if (res.truncated) {
+          readOnly = true
+          reason = '文件超过 4MB，已只读加载前 4MB（保存已禁用）'
+        } else if (text.indexOf('�') !== -1) {
+          readOnly = true
+          reason = '二进制文件，仅只读预览（保存已禁用）'
+        }
+      } else {
+        text = res && typeof res.content === 'string' ? res.content : ''
+      }
+      return { text, readOnly, reason }
+    }
     async function openFile(path) {
       const name = baseName(path)
       if (!store.tabs.some((t) => t.path === path)) {
@@ -949,11 +984,17 @@ window.__ModuleLoader__.load({
         emit()
         const res = await callHost('read-file', { path })
         if (res && res.error) { store.error = res.error; emit(); return }
-        store.buffers[path] = res.content
-        store.savedContent[path] = res.content
+        const decoded = decodeReadFileRes(res)
+        store.buffers[path] = decoded.text
+        store.savedContent[path] = decoded.text
+        store.readOnly = store.readOnly || {}
+        store.readOnly[path] = decoded.readOnly
+        store.readOnlyReason = store.readOnlyReason || {}
+        store.readOnlyReason[path] = decoded.reason
         store.loadSeq[path] = (store.loadSeq[path] || 0) + 1
         store.externalChanged[path] = false
         emit()
+        if (decoded.reason) showToast(decoded.reason)
         // 通知 host 建 fs.watch：外部修改进事件队列，编辑器 1 秒内自动同步
         callHost('watch-file', { path }).then(() => {})
       } else {
@@ -1053,12 +1094,18 @@ window.__ModuleLoader__.load({
     async function reloadFromFile(path) {
       const res = await callHost('read-file', { path })
       if (res && res.error) { showToast('读取失败：' + res.error); return }
-      store.buffers[path] = res.content
-      store.savedContent[path] = res.content
+      const decoded = decodeReadFileRes(res)
+      store.buffers[path] = decoded.text
+      store.savedContent[path] = decoded.text
       store.dirty[path] = false
       store.externalChanged[path] = false
+      store.readOnly = store.readOnly || {}
+      store.readOnly[path] = decoded.readOnly
+      store.readOnlyReason = store.readOnlyReason || {}
+      store.readOnlyReason[path] = decoded.reason
       store.loadSeq[path] = (store.loadSeq[path] || 0) + 1
       emit()
+      if (decoded.reason) showToast(decoded.reason)
     }
     // 每秒拉一次 host 的事件队列（fs.watch 真事件；无变化时返回空数组，开销极小）
     async function drainFileEvents() {
@@ -1081,6 +1128,10 @@ window.__ModuleLoader__.load({
     async function saveFile(path) {
       const p = path || store.activePath
       if (!p) return
+      if (store.readOnly && store.readOnly[p]) {
+        showToast('只读：' + (store.readOnlyReason[p] || '该文件不可写'))
+        return
+      }
       const content = store.buffers[p]
       const res = await callHost('write-file', { path: p, content })
       if (res && res.error) { showToast('保存失败：' + res.error); return }
@@ -1829,7 +1880,7 @@ window.__ModuleLoader__.load({
       if (!n.lineStart) return { path: n.path, language: langOf(n.path), lineStart: null, lineEnd: null, text: '' } // 整文件备注：按整文件引用处理
       const res = await callHost('read-file', { path: n.path })
       if (!res || res.error) { showToast('读取原文件失败：' + ((res && res.error) || '未知错误')); return null }
-      const lines = String(res.content || '').split('\n')
+      const lines = decodeReadFileRes(res).text.split('\n')
       const s = Math.max(1, n.lineStart)
       const t = Math.min(lines.length, Math.max(s, n.lineEnd || s))
       return { path: n.path, language: langOf(n.path), lineStart: s, lineEnd: t, text: lines.slice(s - 1, t).join('\n') }
@@ -1956,6 +2007,7 @@ window.__ModuleLoader__.load({
               defaultValue: content,
               spellCheck: false,
               wrap: 'off',
+              readOnly: !!(st.readOnly && st.readOnly[p]),
               ref: (el) => {
                 if (!el) return
                 // 仅在真正挂载时恢复滚动（换标签/内容重挂）；不抢焦点，光标由用户自己点击决定
@@ -2007,6 +2059,7 @@ window.__ModuleLoader__.load({
         h('span', null, lines ? (lines + ' 行') : ''),
         h('span', null, '引用 ' + st.references.length),
         dirty ? h('span', { className: 'cdex-dirty' }, '● 未保存') : null,
+        st.readOnly && st.readOnly[p] ? h('span', { className: 'cdex-dirty', title: st.readOnlyReason[p] || '' }, '🔒 只读') : null,
       )
     }
     function ContextMenu() {
@@ -2723,6 +2776,63 @@ window.__ModuleLoader__.load({
         })
       }
 
+      // —— 危险区：卸载插件（两击确认 → uninstall-self → 轮询 get-uninstall-progress）——
+      const [uninst, setUninst] = React.useState(null)
+      const [uninstBusy, setUninstBusy] = React.useState(false)
+      const [uninstConfirm, setUninstConfirm] = React.useState(false)
+      const uninstPollRef = React.useRef(null)
+      function stopUninstPoll() {
+        if (uninstPollRef.current) { try { uninstPollRef.current() } catch (e) {} uninstPollRef.current = null }
+      }
+      React.useEffect(() => stopUninstPoll, [])
+      function pollUninstall() {
+        callHost('get-uninstall-progress').then((r) => {
+          if (!r || r.error) return
+          setUninst(r)
+          if (r.active) {
+            if (timer && typeof timer.timeout === 'function') {
+              stopUninstPoll()
+              const d = timer.timeout(pollUninstall, 1200)
+              uninstPollRef.current = (typeof d === 'function') ? d : null
+            }
+          } else {
+            stopUninstPoll()
+            setUninstBusy(false)
+            if (r.done && r.ok && !r.alreadyGone) showToast('已从 profile 移除 dsh-code-ui，重启 DSH 后彻底生效')
+          }
+        })
+      }
+      function startUninstall() {
+        if (uninstBusy) return
+        setUninstBusy(true)
+        setUninst({ active: true, done: false, phase: 'starting', lines: [] })
+        callHost('uninstall-self').then((r) => {
+          if (!r || r.error) {
+            const msg = (r && r.error) || '无法启动卸载'
+            const noEp = /未知端点|no active Remote method exports|invalid RPC target|invocation-unavailable/.test(msg)
+            setUninst({ active: false, done: true, ok: false, code: noEp ? 'NO_ENDPOINT' : 'START_FAILED',
+              error: msg,
+              hint: noEp ? '运行中的 host 端是旧版本（无自卸载端点）。请先用「检查更新」升级插件（或本地包装新版），重启 DSH 后再卸载。' : '',
+              manualSteps: noEp
+                ? ['先用本卡片的更新功能升级到 v1.5.3+，重启 DSH', '或手动卸载：dsh plugin --profile web remove dsh-code-ui']
+                : ['稍后重试；反复失败请重启 DSH 后再试'] })
+            setUninstBusy(false)
+            return
+          }
+          pollUninstall()
+        })
+      }
+      function onUninstallClick() {
+        if (uninstBusy) return
+        if (!uninstConfirm) {
+          setUninstConfirm(true)
+          setTimeout(() => setUninstConfirm(false), 5000) // 5 秒不点第二下自动回弹
+          return
+        }
+        setUninstConfirm(false)
+        startUninstall()
+      }
+
       const cur = (self && self.version) || (chk && chk.current) || '?'
       const started = !!(run && !run.done)
       // 更新已成功、等待重启：更新类按钮文案临时改为「需重启 DSH 生效」，用户一眼可见
@@ -2882,6 +2992,30 @@ window.__ModuleLoader__.load({
               h('button', { type: 'button', className: 'cdx-pc-btn cdx-pc-btn-primary', onClick: () => { if (lastPayloadRef.current) startUpdate(lastPayloadRef.current) } }, '重试'),
             ),
           ) : null,
+          // 危险区：卸载插件
+          h('div', { className: 'cdx-pc-field' },
+            h('div', { className: 'cdx-pc-head' },
+              h('span', { className: 'cdx-pc-label' }, '卸载插件'),
+              h('button', {
+                type: 'button',
+                className: 'cdx-pc-btn ' + (uninstConfirm ? 'cdx-pc-btn-primary' : 'cdx-pc-btn-outline'),
+                disabled: uninstBusy || !!(uninst && uninst.done && uninst.ok),
+                onClick: onUninstallClick,
+              }, uninstBusy ? '正在卸载…'
+                : (uninst && uninst.done && uninst.ok) ? '已卸载 · 重启 DSH 生效'
+                : uninstConfirm ? '确认卸载（再点一次执行）' : '卸载插件…'),
+            ),
+            h('p', { className: 'cdx-pc-note' }, '从当前 profile 移除 dsh-code-ui（依赖 + bundles 清单 + node_modules）。卸载完成后插件在本进程内仍运行到重启为止——需重启 DSH 彻底生效。'),
+            uninst && ((uninst.lines || []).length || uninst.active) ? h('div', { className: 'cdx-pc-log' }, ((uninst.lines || []).slice(-14).join('\n')) || '正在启动…') : null,
+            uninst && uninst.done && uninst.ok && uninst.alreadyGone ? h('p', { className: 'cdx-pc-note' }, '当前已是未安装状态（profile 中无此插件）。') : null,
+            uninst && uninst.done && uninst.ok && !uninst.alreadyGone ? h('p', { className: 'cdx-pc-ok' },
+              '✓ 卸载完成（' + (uninst.cliUsed === 'dsh' ? '官方 CLI' : 'pnpm') + ' 通道' + (uninst.manifestReconciled ? '，清单已按磁盘收尾' : '') + '）。请重启 DSH 彻底生效——重启前插件仍在运行；浏览器端建议 Ctrl+F5。') : null,
+            uninst && uninst.done && !uninst.ok ? [
+              h('p', { className: 'cdx-pc-err' }, '✗ 卸载失败' + (uninst.code ? '（' + uninst.code + '）' : '') + '：' + (uninst.error || '未知错误')),
+              uninst.hint ? h('p', { className: 'cdx-pc-note' }, uninst.hint) : null,
+              Array.isArray(uninst.manualSteps) && uninst.manualSteps.length ? h('div', { className: 'cdx-pc-log' }, '手动处理步骤：\n' + uninst.manualSteps.map((s, i) => (i + 1) + '. ' + s).join('\n')) : null,
+            ] : null,
+          ),
           // 底部信息
           h('div', { className: 'cdx-pc-field' },
             self && self.profileRoot ? h('p', { className: 'cdx-pc-note' }, 'profile：' + self.profileRoot + ' · 检查源：' + (self.updateRegistry || 'https://registry.npmjs.org')) : null,

package/lib/index.js

@@ -1,17 +1,17 @@
 // Host half of dsh-code-ui.
 // Standard DeepSeek Harness bundle plugin — hand-written JS, no build step.
-// Registers an RPC channel (via the shared Connection service) for the editor
-// UI's file / reference / note operations, and a model tool get_referenced_snippets.
+// Exposes the editor UI's file / reference / note operations as a Typert Remote
+// service (namespace dsh-code-ui on the official /api RPC channel), and a model
+// tool get_referenced_snippets.
 
+import { Remote, bindTypertRemote } from "@deepseek-ai/dsh-typert-protocol";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import z from "@deepseek-ai/schemastery";
 import { spawn } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, watch, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join } from "node:path";
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
-const CHANNEL = "/dsh-code-ui";
-
 // 引用与备注：模块级内存存储，由 RPC 读写。
 const references = [];
 const notes = [];
@@ -235,7 +235,8 @@ function feedLine(text) {
 // pnpm --reporter=ndjson 逐行事件 -> 可读文本。字段名以 pnpm 11 实测为准：
 // progress/fetching-progress 用 packageId，pnpm:stage 用 stage，_dependency_resolved 用 resolution；
 // scope/context/execution-time 等无信息量 debug 事件直接丢弃；非 JSON 行（老版 pnpm）原样保留。
-function makeLineFeeder() {
+function makeLineFeeder(push) {
+  const emit = push || feedLine;
   let buffer = "";
   return (chunk) => {
     buffer += chunk;
@@ -263,11 +264,11 @@ function makeLineFeeder() {
           else if (n === "pnpm:summary") t = "[统计] 安装流程结束";
         } catch (_) {}
         if (parsed) {
-          if (t !== null) feedLine(t);
+          if (t !== null) emit(t);
           continue;
         }
       }
-      feedLine(line);
+      emit(line);
     }
   };
 }
@@ -383,6 +384,282 @@ async function runSelfUpdate(spec, profileRoot, source) {
   updateRun.phase = updateRun.ok ? "done" : "failed";
 }
 
+// —— 自卸载（v1.5.3）：配置卡「卸载插件」——
+// 官方依据：DSH 0.1.6-alpha.2「插件管理支持运行时卸载，请开发者检查插件加载和卸载逻辑」。
+// 宿主 0.1.5-rc.2 无运行时卸载 → 卸载 = 从 profile 移除依赖 + dsh.profile.bundles 清单 + node_modules，
+// 完成后必须告知用户重启 DSH（当前进程内插件仍运行到重启为止，这是预期行为不是 bug）。
+// 策略：优先官方 CLI（dsh plugin --profile <p> remove <name>，exit 0 时官方 CLI 自己同步清单）；
+// CLI 不可用退 pnpm remove + 手动补删 bundles 行；失败按磁盘真相 reconcile
+//（#65 写序保护：pnpm 可能在删完 node_modules 后、写 package.json 前被文件锁打断，留下幽灵清单行
+// 会让整个 profile 下次起不来——所以磁盘已删而清单未清时必须补删清单行）。
+const uninstallRun = {
+  active: false, startedAt: 0, phase: "idle", lines: [],
+  done: false, ok: false, timedOut: false, exitCode: null,
+  alreadyGone: false, cliUsed: null, manifestReconciled: false, filesGone: false,
+  error: null, code: null, hint: null, manualSteps: null,
+};
+function uFeedLine(text) {
+  uninstallRun.lines.push(String(text).slice(0, 300));
+  if (uninstallRun.lines.length > 150) uninstallRun.lines.shift();
+  uninstallRun.phase = String(text).slice(0, 160);
+}
+function pnpmRemove(profileRoot, extraArgs) {
+  return new Promise((resolveP) => {
+    const workspace = existsSync(join(profileRoot, "pnpm-workspace.yaml"));
+    const args = ["remove"].concat(workspace ? ["-w"] : [], [SELF_NAME, "--reporter=ndjson"], extraArgs);
+    uFeedLine("$ pnpm " + args.join(" "));
+    const stdio = ["ignore", "pipe", "pipe"];
+    let child;
+    if (!WIN_CMD) {
+      child = spawn("pnpm", args, { cwd: profileRoot, env: selfSpawnEnv(), stdio, shell: false });
+    } else {
+      const cmdline = ["pnpm"].concat(args).map(quoteCmdArg).join(" ");
+      child = spawn(COMSPEC, ["/d", "/s", "/c", '"' + cmdline + '"'], {
+        cwd: profileRoot, env: selfSpawnEnv(), stdio, shell: false, windowsVerbatimArguments: true,
+      });
+    }
+    let timedOut = false;
+    const timer = setTimeout(() => { timedOut = true; killTree(child); }, 10 * 60 * 1000);
+    const feed = makeLineFeeder(uFeedLine);
+    if (child.stdout) child.stdout.on("data", feed);
+    if (child.stderr) child.stderr.on("data", feed);
+    child.on("error", (err) => {
+      clearTimeout(timer);
+      uFeedLine("[spawn-error] " + err.message);
+      resolveP({ ok: false, exitCode: 127, timedOut: false });
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolveP({ ok: code === 0 && !timedOut, exitCode: code == null ? -1 : code, timedOut });
+    });
+  });
+}
+// 再唤起启动本宿主的 CLI 执行官方卸载。三种启动形态（照 dshmarket dshArgv 实战）：
+// ① 源码/本地入口启动（pnpm dsh web 等，argv[1] 指向 bin）→ node <execArgv> <entry> plugin --profile ...
+//    （必须带 execArgv 且 cwd=入口目录，否则 tsx/esm 导入解析不到，MODULE_NOT_FOUND）
+// ② POSIX 直装 → 裸 dsh
+// ③ Windows 直装 → dsh 是 .cmd shim，必须 cmd.exe /d /s /c + 逐 token 引号（同更新器 pnpm 套路）
+function dshPluginRemove(profileName) {
+  return new Promise((resolveP) => {
+    const pluginArgs = ["plugin", "--profile", profileName, "remove", SELF_NAME];
+    const entry = process.argv[1];
+    let child;
+    if (entry && /[\\/](?:bin\.(?:js|ts)|dsh)$/.test(entry)) {
+      uFeedLine("$ node " + basename(entry) + " " + pluginArgs.join(" "));
+      child = spawn(process.execPath, process.execArgv.concat([resolve(entry)], pluginArgs), {
+        cwd: dirname(entry), env: selfSpawnEnv(), stdio: ["ignore", "pipe", "pipe"], shell: false,
+      });
+    } else if (!WIN_CMD) {
+      uFeedLine("$ dsh " + pluginArgs.join(" "));
+      child = spawn("dsh", pluginArgs, { env: selfSpawnEnv(), stdio: ["ignore", "pipe", "pipe"], shell: false });
+    } else {
+      const cmdline = ["dsh"].concat(pluginArgs).map(quoteCmdArg).join(" ");
+      uFeedLine("$ dsh " + pluginArgs.join(" ") + "    (windows cmd shim)");
+      child = spawn(COMSPEC, ["/d", "/s", "/c", '"' + cmdline + '"'], {
+        env: selfSpawnEnv(), stdio: ["ignore", "pipe", "pipe"], shell: false, windowsVerbatimArguments: true,
+      });
+    }
+    let timedOut = false;
+    let out = "";
+    const collect = (chunk) => { out = (out + chunk.toString()).slice(-8192); };
+    const timer = setTimeout(() => { timedOut = true; killTree(child); }, 10 * 60 * 1000);
+    const feed = makeLineFeeder(uFeedLine);
+    if (child.stdout) child.stdout.on("data", (c) => { collect(c); feed(c); });
+    if (child.stderr) child.stderr.on("data", (c) => { collect(c); feed(c); });
+    child.on("error", (err) => {
+      clearTimeout(timer);
+      uFeedLine("[spawn-error] " + err.message);
+      resolveP({ ok: false, exitCode: 127, timedOut: false, output: (out + "\n" + err.message).slice(-8192) });
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolveP({ ok: code === 0 && !timedOut, exitCode: code == null ? -1 : code, timedOut, output: out });
+    });
+  });
+}
+// 磁盘真相：dep 有无 / bundles 有无 / node_modules 有无
+function manifestUninstallState(profileRoot) {
+  const m = readJsonSafe(join(profileRoot, "package.json"));
+  const depPresent = !!(m && m.dependencies && Object.prototype.hasOwnProperty.call(m.dependencies, SELF_NAME));
+  const bundles = m && m.dsh && m.dsh.profile && Array.isArray(m.dsh.profile.bundles) ? m.dsh.profile.bundles : null;
+  const bundlePresent = !!bundles && bundles.indexOf(SELF_NAME) >= 0;
+  const filesPresent = existsSync(join(profileRoot, "node_modules", SELF_NAME, "package.json"));
+  return { manifestOk: !!m, depPresent: depPresent, bundlePresent: bundlePresent, filesPresent: filesPresent };
+}
+// 清单收尾（原子写：tmp + rename；Windows 目标被锁 → "locked"）。dropDep=false 只删 bundles 行。
+function dropManifestRows(profileRoot, dropDep) {
+  const file = join(profileRoot, "package.json");
+  const m = readJsonSafe(file);
+  if (!m) return "unreadable";
+  let touched = false;
+  if (dropDep && m.dependencies && m.dependencies[SELF_NAME] !== undefined) {
+    delete m.dependencies[SELF_NAME];
+    touched = true;
+  }
+  const bundles = m.dsh && m.dsh.profile && Array.isArray(m.dsh.profile.bundles) ? m.dsh.profile.bundles : null;
+  if (bundles && bundles.indexOf(SELF_NAME) >= 0) {
+    m.dsh.profile.bundles = bundles.filter((b) => b !== SELF_NAME);
+    touched = true;
+  }
+  if (!touched) return "clean";
+  try {
+    const tmp = file + ".code-ui-uninstall.tmp";
+    writeFileSync(tmp, JSON.stringify(m, null, 2) + "\n", "utf8");
+    renameSync(tmp, file);
+    return "removed";
+  } catch (_) {
+    return "locked";
+  }
+}
+// 每个错误码对应可执行的手动处理步骤（用户照做就能完成卸载）
+function manualStepsFor(code, profileName) {
+  const cli = "dsh plugin --profile " + profileName + " remove " + SELF_NAME;
+  const table = {
+    PROFILE_NOT_FOUND: [
+      "确认 DSH_HOME 位置（默认 ~/.dsh，Windows 为 C:\\Users\\<你>\\.dsh）",
+      "检查 profiles/web/package.json 是否存在且含 dsh.profile.bundles",
+    ],
+    PLUGIN_CMD_FAILED: [
+      "关闭 DSH（文件被运行中的进程占用是最常见原因）",
+      "终端执行：" + cli,
+      "仍失败则进入 profile 目录执行：pnpm remove " + SELF_NAME,
+      "完成后重启 DSH",
+    ],
+    PNPM_FAILED: [
+      "关闭 DSH（文件占用是最常见原因）",
+      "进入 profile 目录执行：pnpm remove " + SELF_NAME,
+      "若报 EPERM/EBUSY：结束所有 node 进程或重启电脑后重试",
+      "完成后重启 DSH",
+    ],
+    TIMEOUT: [
+      "pnpm 卡住（锁/网络），稍后重试一次",
+      "仍卡住：删除 profile/node_modules/.pnpm 下的锁残留后重试",
+      "或手动执行：" + cli,
+    ],
+    MANIFEST_LOCKED: [
+      "关闭 DSH",
+      "手动编辑 profile/package.json：删除 dependencies 里的 \"" + SELF_NAME + "\" 行，以及 dsh.profile.bundles 数组里的 \"" + SELF_NAME + "\" 项",
+      "进入 profile 目录执行：pnpm install",
+      "重启 DSH",
+    ],
+    FILES_STILL_PRESENT: [
+      "清单已清但文件仍在（被运行中进程占用）：关闭 DSH",
+      "手动删除 node_modules 下的 " + SELF_NAME + " 目录（及 node_modules/.pnpm 内对应目录）",
+      "或重启 DSH 后再卸载一次",
+    ],
+  };
+  return table[code] || ["终端执行：" + cli, "或进入 profile 目录执行：pnpm remove " + SELF_NAME, "完成后重启 DSH"];
+}
+async function runSelfUninstall(profileRoot) {
+  const profileName = basename(profileRoot);
+  Object.assign(uninstallRun, {
+    active: true, startedAt: Date.now(), phase: "starting", lines: [],
+    done: false, ok: false, timedOut: false, exitCode: null,
+    alreadyGone: false, cliUsed: null, manifestReconciled: false, filesGone: false,
+    error: null, code: null, hint: null, manualSteps: null,
+  });
+  const verdict = (okFlag, code, message, hint) => {
+    uninstallRun.ok = okFlag;
+    if (code) {
+      uninstallRun.code = code;
+      uninstallRun.error = message || "";
+      uninstallRun.hint = hint || "";
+      uninstallRun.manualSteps = manualStepsFor(code, profileName);
+    }
+    uninstallRun.done = true;
+    uninstallRun.active = false;
+    uninstallRun.phase = okFlag ? "done" : "failed";
+    uFeedLine(okFlag ? "[完成] 已从 profile 移除，重启 DSH 后彻底生效" : "[失败] " + code + " " + (message || ""));
+  };
+  try {
+    let st = manifestUninstallState(profileRoot);
+    if (!st.manifestOk) return verdict(false, "PROFILE_NOT_FOUND", "profile package.json 不可读", "profile 目录异常");
+    if (!st.depPresent && !st.bundlePresent && !st.filesPresent) {
+      uninstallRun.alreadyGone = true;
+      uFeedLine("[code-ui] profile 中已无本插件，无需卸载");
+      return verdict(true, null, null);
+    }
+    // 主路径：官方 CLI（exit 0 时官方自己同步 dependencies + bundles）
+    let cli = await dshPluginRemove(profileName);
+    uninstallRun.exitCode = cli.exitCode;
+    uninstallRun.timedOut = cli.timedOut;
+    if (cli.ok) {
+      uninstallRun.cliUsed = "dsh";
+    } else if (cli.timedOut) {
+      return verdict(false, "TIMEOUT", "dsh plugin remove 超时，已终止", "可重试或按手动步骤执行");
+    } else if (cli.exitCode === 127 || /not recognized|不是内部或外部命令|command not found|cannot find/i.test(cli.output || "")) {
+      // CLI 不可用（拿不到 dsh 命令）→ 退路：pnpm remove
+      uFeedLine("[code-ui] dsh CLI 不可用，退路：pnpm remove");
+      let r = await pnpmRemove(profileRoot, []);
+      let out = uninstallRun.lines.join("\n");
+      if (!r.ok && !r.timedOut && /ERR_PNPM_PUBLIC_HOIST_PATTERN_DIFF|hoist/i.test(out)) {
+        uFeedLine("[code-ui] node_modules 由旧版 pnpm 创建，先重建再重试");
+        const rb = await spawnPnpmInstallRebuild(profileRoot);
+        if (rb.ok) r = await pnpmRemove(profileRoot, []);
+      }
+      uninstallRun.exitCode = r.exitCode;
+      uninstallRun.timedOut = r.timedOut;
+      if (r.ok) {
+        uninstallRun.cliUsed = "pnpm";
+      } else if (r.timedOut) {
+        return verdict(false, "TIMEOUT", "pnpm remove 超时，已终止", "可重试或按手动步骤执行");
+      } else {
+        return verdict(false, "PNPM_FAILED", "pnpm remove 失败（退出码 " + r.exitCode + "）", "详见输出与手动步骤");
+      }
+    } else {
+      // CLI 在但执行失败：多为文件占用；按磁盘真相收尾，能救则救
+      uFeedLine("[code-ui] CLI 退出码 " + cli.exitCode + "，按磁盘真相收尾");
+    }
+    // 收尾：按磁盘真相 reconcile（#65 幽灵清单保护）
+    st = manifestUninstallState(profileRoot);
+    if (!st.filesPresent && (st.depPresent || st.bundlePresent)) {
+      const r = dropManifestRows(profileRoot, st.depPresent);
+      uninstallRun.manifestReconciled = r === "removed";
+      if (r === "locked") return verdict(false, "MANIFEST_LOCKED", "清单写入失败（文件被占用）", "按手动步骤编辑 package.json");
+      if (r === "unreadable") return verdict(false, "MANIFEST_LOCKED", "package.json 不可读", "按手动步骤检查 profile");
+      st = manifestUninstallState(profileRoot);
+    } else if (st.filesPresent && uninstallRun.cliUsed === "pnpm") {
+      // pnpm 路径成功但 bundles 行只有官方 CLI 会同步——pnpm 路径需手动删 bundles 行
+      //（注意此时文件应已删除；若文件还在说明 pnpm 实际没删掉，走 FILES_STILL_PRESENT 判定）
+      const r = dropManifestRows(profileRoot, false);
+      uninstallRun.manifestReconciled = r === "removed";
+    }
+    st = manifestUninstallState(profileRoot);
+    uninstallRun.filesGone = !st.filesPresent;
+    if (!st.filesPresent && !st.depPresent && !st.bundlePresent) {
+      return verdict(true, null, null);
+    }
+    if (st.filesPresent) {
+      return verdict(false, "FILES_STILL_PRESENT", "插件文件仍在磁盘（多半被运行中的 DSH 占用）", "关闭 DSH 后按手动步骤删除，或重启后再试一次");
+    }
+    return verdict(false, "MANIFEST_LOCKED", "清单仍有残留", "按手动步骤编辑 package.json");
+  } catch (err) {
+    return verdict(false, "PLUGIN_CMD_FAILED", String((err && err.message) || err), "执行异常");
+  }
+}
+// hoist 漂移重建（node_modules 由旧版 pnpm 创建时）：pnpm install --no-frozen-lockfile（尽力而为）
+function spawnPnpmInstallRebuild(profileRoot) {
+  return new Promise((resolveP) => {
+    const args = ["install", "--no-frozen-lockfile"];
+    uFeedLine("$ pnpm " + args.join(" ") + "    (rebuild node_modules)");
+    let child;
+    if (!WIN_CMD) {
+      child = spawn("pnpm", args, { cwd: profileRoot, env: selfSpawnEnv(), stdio: ["ignore", "pipe", "pipe"], shell: false });
+    } else {
+      const cmdline = ["pnpm"].concat(args).map(quoteCmdArg).join(" ");
+      child = spawn(COMSPEC, ["/d", "/s", "/c", '"' + cmdline + '"'], {
+        cwd: profileRoot, env: selfSpawnEnv(), stdio: ["ignore", "pipe", "pipe"], shell: false, windowsVerbatimArguments: true,
+      });
+    }
+    const timer = setTimeout(() => killTree(child), 10 * 60 * 1000);
+    const feed = makeLineFeeder(uFeedLine);
+    if (child.stdout) child.stdout.on("data", feed);
+    if (child.stderr) child.stderr.on("data", feed);
+    child.on("error", () => { clearTimeout(timer); resolveP({ ok: false }); });
+    child.on("close", (code) => { clearTimeout(timer); resolveP({ ok: code === 0 }); });
+  });
+}
+
 // —— RPC 处理：文件系统 + 引用/备注 ——
 // -- 文件监听：对 Code UI 已打开的文件建 fs.watch，外部修改记入事件队列 --
 // client 每 1 秒 take-file-events 拉空队列（插件 RPC 是单向请求/响应，没有 host->浏览器推送通道，
@@ -419,7 +696,48 @@ function unwatchAllFiles() {
 }
 
 function rpcHandler(ctx) {
-  const fs = ctx.get("fs");
+  // fs 服务延迟获取：插件 apply 可能早于 base bundle 的 fs-sandbox 行挂载，
+  // apply 时一次性 ctx.get("fs") 会永久取到 undefined（0.2.0-rc.2 实测：
+  // list-dir/stat-path/read-file 全部抛 "Cannot read properties of
+  // undefined (reading 'resolve')"）。改为 inject 等待 + 调用时解析。
+  let fsSvc = null;
+  try { fsSvc = ctx.get("fs") || null; } catch (_) {}
+  try {
+    ctx.inject(["fs"], (c) => { fsSvc = c.fs || fsSvc; });
+  } catch (_) {}
+  // 宿主组合始终无 fs 服务时的原生兜底：与 fs-mkdir/write-file 等磁盘端点
+  // 同一权限模型（编辑器是用户显式操作面，本就读写真实磁盘）。
+  const nativeFsShim = {
+    resolve: async (p) => p,
+    stat: async (p) => {
+      try {
+        const s = statSync(p);
+        return { type: s.isDirectory() ? "directory" : s.isFile() ? "file" : "other" };
+      } catch (_) { return null; }
+    },
+    listDir: async (p) => {
+      const sep = String(p).includes("\\") ? "\\" : "/";
+      return readdirSync(p, { withFileTypes: true }).map((d) => ({
+        name: d.name,
+        path: String(p).replace(/[\\/]+$/, "") + sep + d.name,
+        isDir: d.isDirectory(),
+      }));
+    },
+    readBytes: async (p, _signal, maxBytes) => {
+      const b = readFileSync(p);
+      if (b.length > maxBytes) {
+        const e = new Error("file too large");
+        e.code = "FS_TOO_LARGE";
+        throw e;
+      }
+      return new Uint8Array(b.buffer, b.byteOffset, b.byteLength);
+    },
+    readByteRange: async (p, range) => {
+      const b = readFileSync(p);
+      return new Uint8Array(b.buffer, b.byteOffset, b.byteLength).slice(range.offset, range.offset + range.length);
+    },
+  };
+  const getFs = () => fsSvc || nativeFsShim;
   let currentRootRef = detectWorkspaceRoot(ctx); // 最近一次解析的根：list-dir 的兜底
   // 每会话根目录记忆：sessionId -> 手动设置的根（「以此文件夹为根」）。
   // 按会话隔离——手动根只影响设置它的那个会话，不再全局污染其它会话的自动解析；
@@ -515,8 +833,9 @@ function rpcHandler(ctx) {
       if (endpoint === "list-dir") {
         const path = args.path || currentRootRef;
         if (!path) return ok({ error: "no-root" });
-        const target = await fs.resolve(path);
-        const entries = await fs.listDir(target);
+        const fsvc = getFs();
+        const target = await fsvc.resolve(path);
+        const entries = await fsvc.listDir(target);
         const sep = String(path).includes("\\") ? "\\" : "/";
         const list = entries.map((e) => {
           let name = null;
@@ -543,8 +862,9 @@ function rpcHandler(ctx) {
 
       if (endpoint === "stat-path") {
         if (!args.path) return ok({ error: "no-path" });
-        const target = await fs.resolve(args.path);
-        const info = await fs.stat(target);
+        const fsvc = getFs();
+        const target = await fsvc.resolve(args.path);
+        const info = await fsvc.stat(target);
         // DSH fs.stat 返回 FsInfo { type: 'file' | 'directory' | 'other' }，
         // 没有 isDirectory/isFile 布尔字段；必须按 type 判定（原实现恒为 false，
         // 导致目录路径被误报为「不存在」）。保留遗留字段兼容。
@@ -556,11 +876,22 @@ function rpcHandler(ctx) {
 
       if (endpoint === "read-file") {
         if (!args.path) return ok({ error: "no-path" });
-        const target = await fs.resolve(args.path);
-        const text = await fs.readText(target);
-        const MAX = 600000;
-        const truncated = text.length > MAX;
-        return ok({ path: args.path, content: truncated ? text.slice(0, MAX) : text, truncated });
+        const fsvc = getFs();
+        const target = await fsvc.resolve(args.path);
+        // 对齐 dsh ≥ 0.1.7-rc.1 的二进制 Remote 结果契约：字节经 Uint8Array 字段返回，
+        // gateway 自动投影为 multipart 附件下发；0.1.5/0.1.6 老宿主无投影则走 JSON
+        // （Uint8Array 落成下标对象，客户端负责重建），同一份代码两端兼容。
+        // 取代旧的 60 万字符文本截断——截断内容若被 Ctrl+S 原样写回会写坏大文件。
+        const MAX = 4 * 1024 * 1024; // 单次读取上限 4MB
+        try {
+          const bytes = await fsvc.readBytes(target, undefined, MAX);
+          return ok({ path: args.path, bytes, truncated: false, size: bytes.length });
+        } catch (err) {
+          if (!err || err.code !== "FS_TOO_LARGE" || typeof fsvc.readByteRange !== "function") throw err;
+          // 超限文件读前 4MB，标记 truncated；客户端据此禁写并提示
+          const bytes = await fsvc.readByteRange(target, { offset: 0, length: MAX });
+          return ok({ path: args.path, bytes, truncated: true });
+        }
       }
 
       if (endpoint === "write-file") {
@@ -894,6 +1225,28 @@ function rpcHandler(ctx) {
         });
       }
 
+      if (endpoint === "uninstall-self") {
+        if (uninstallRun.active) return ok({ error: "卸载任务已在进行中" });
+        const profileRoot = findProfileRoot();
+        if (!profileRoot) {
+          return ok({ ok: false, code: "PROFILE_NOT_FOUND", error: "未找到 profile 根目录（package.json 缺少 dsh.profile.bundles）", manualSteps: manualStepsFor("PROFILE_NOT_FOUND", "web") });
+        }
+        runSelfUninstall(profileRoot); // 异步执行；进度经 get-uninstall-progress 轮询（与更新同一模式）
+        return ok({ started: true });
+      }
+
+      if (endpoint === "get-uninstall-progress") {
+        return ok({
+          active: uninstallRun.active, done: uninstallRun.done, ok: uninstallRun.ok,
+          phase: uninstallRun.phase, alreadyGone: uninstallRun.alreadyGone,
+          cliUsed: uninstallRun.cliUsed, manifestReconciled: uninstallRun.manifestReconciled,
+          filesGone: uninstallRun.filesGone,
+          error: uninstallRun.error, code: uninstallRun.code, hint: uninstallRun.hint,
+          manualSteps: uninstallRun.manualSteps,
+          lines: uninstallRun.lines.slice(-40),
+        });
+      }
+
       return fail("未知端点: " + endpoint);
     } catch (err) {
       return fail(String((err && err.message) || err));
@@ -908,6 +1261,57 @@ function fail(message) {
   return { ok: false, error: { code: "internal", message, details: {} } };
 }
 
+// —— Typert Remote 服务：经官方 /api 通道对浏览器暴露上列全部端点 ——
+// api-gateway 扫描宿主 root Context 的 reflect.props，发现带 typertRemote 绑定且原型上有
+// Remote 方法标记的服务（SRC 发现模式，0.1.5-rc.2 与 0.2.0-rc.2 机制一致），把
+// 「dsh-code-ui/<端点>」分发到对应方法；gateway 监听 internal/service 事件做缓存失效，
+// 插件晚于 gateway 加载也能被发现。方法签名约束（SRC 派生）：参数必须是简单标识符、
+// 不能解构/默认值/rest，参数名即 wire 字段名；客户端 call('/api', ep, { args: {...} }) 的
+// 内层对象按参数名取字段。本服务所有方法只收单个 args 对象，逐个委托给 rpcHandler 闭包，
+// 端点逻辑零改动。
+function applyRemote(cls, methodName, exportName) {
+  // 无装饰器语法的手动调用：Remote(exportName) 返回标准方法装饰器，
+  // addInitializer 里以 cls.prototype 为原型造对象，让标记写到类原型上。
+  Remote(exportName)(cls.prototype[methodName], {
+    kind: "method", name: methodName, static: false, private: false,
+    addInitializer(fn) { fn.call(Object.create(cls.prototype)); },
+  });
+}
+
+class CodeUiService {
+  constructor(invoke) {
+    this.typertRemote = bindTypertRemote(this, "dsh-code-ui");
+    this.__invoke = invoke;
+  }
+}
+
+// 端点清单（kebab-case，与 lib/client.js 调用点、rpcHandler 分支一一对应）
+const CODE_UI_ENDPOINTS = [
+  "get-root", "set-root", "list-dir", "stat-path",
+  "read-file", "write-file", "watch-file", "unwatch-file", "take-file-events",
+  "fs-mkdir", "fs-createfile", "fs-rename", "fs-delete", "fs-reveal",
+  "add-reference", "list-references", "use-references", "delete-reference",
+  "add-note", "list-notes", "delete-note",
+  "get-self", "set-toggle", "set-uimode", "set-layout", "set-theme",
+  "set-syn-theme", "set-enabled",
+  "check-update", "perform-update", "get-update-progress",
+  "uninstall-self", "get-uninstall-progress",
+];
+for (const endpoint of CODE_UI_ENDPOINTS) {
+  const method = endpoint.replace(/-([a-z])/g, (_, ch) => ch.toUpperCase());
+  // 委托约定：rpcHandler 返回 RpcResult 封套；ok:false 抛出 Error 让 gateway 转成
+  // { ok: false, error: { code: 'gateway/internal', message } }，客户端 callHost 折叠为
+  // { error: message }（与 handler 内 fail() 走到客户端的错误形态一致）；ok:true 解出 value 原样返回。
+  CodeUiService.prototype[method] = async function (args) {
+    const r = await this.__invoke(endpoint, args && typeof args === "object" ? args : {});
+    if (r && typeof r === "object" && r.ok === false) {
+      throw new Error((r.error && (r.error.message || r.error.code)) || "RPC 调用失败");
+    }
+    return r && typeof r === "object" && "value" in r ? r.value : r;
+  };
+  applyRemote(CodeUiService, method, endpoint);
+}
+
 // —— 模型工具：读取用户标记的代码片段 ——
 function registerSnippetsTool(tools) {
   if (!tools || typeof tools.register !== "function") return;
@@ -952,69 +1356,6 @@ function registerSnippetsTool(tools) {
 export const name = "dsh-code-ui";
 export const inject = ["tools"];
 
-// —— 兼容兜底：宿主 connection.rpc.handle 不可用时的自挂通道路由 ——
-// 背景（2026-09-11 405 事故）：宿主 connection 的 rpc-host.ts register() 直接访问 owner.webServer，
-// 而 owner 是 connection 插件自己的 ctx（inject 只有 credentials），Cordis guard 抛
-// "cannot get property webServer without inject" → 插件通道路由永不注册 → 客户端全部 405
-//（POST 落 webServer 的 SPA 静态兜底），文件树/更新器等 RPC 功能全挂。
-// 宿主修复前的版本上，插件侧唯一可行的适配就是自己挂同路径前缀路由：
-//  ① 信任/认证门复用宿主公开 API connection.requestRejection（HostConnectionHandle 文档明示
-//     用于「Apply Connection's Host/Origin checks and browser authentication to another Web route」），
-//     因此 Host/Origin 围栏与浏览器会话 cookie 校验和宿主通道完全同策略，不降低安全性；
-//  ② 信封协议（client-request / server-response + rpcId 关联）按 Connection 契约复刻。
-// 宿主修复上线后此兜底不再触发（仅当 handle() 抛错时才启用），可随最低支持版本提升而删除。
-function selfHostedChannelRoute(connection, channel, handler) {
-  const ENDPOINT_SEGMENT = /^[A-Za-z0-9_$.-]+$/;
-  return async (req, res) => {
-    try {
-      const rejection = connection.requestRejection(req);
-      if (rejection !== undefined) {
-        res.writeHead(rejection);
-        res.end(rejection === 401 ? "unauthorized" : "forbidden");
-        return;
-      }
-      const url = new URL(req.url || "/", "http://dsh.invalid");
-      const endpoint = url.pathname.startsWith(channel + "/") ? url.pathname.slice(channel.length + 1) : null;
-      const segments = endpoint === null ? [] : endpoint.split("/");
-      if (req.method !== "POST" || !endpoint
-        || segments.some((s) => !s || s === "." || s === ".." || !ENDPOINT_SEGMENT.test(s))) {
-        res.writeHead(404);
-        res.end("not found");
-        return;
-      }
-      if (String(req.headers["content-type"] || "").split(";")[0].trim().toLowerCase() !== "application/json") {
-        res.writeHead(415);
-        res.end("content type must be application/json");
-        return;
-      }
-      const chunks = [];
-      for await (const chunk of req) chunks.push(chunk);
-      let message;
-      try { message = JSON.parse(Buffer.concat(chunks).toString("utf8")); }
-      catch (_) { res.writeHead(400); res.end("body is not JSON"); return; }
-      const rpcId = message && typeof message.rpcId === "string" ? message.rpcId : "invalid-request";
-      const send = (result) => {
-        res.writeHead(200, { "content-type": "application/json" });
-        res.end(JSON.stringify({ type: "server-response", rpcId, result }));
-      };
-      if (!message || message.type !== "client-request" || typeof message.method !== "string") {
-        send({ ok: false, error: { code: "gateway/bad-request", message: "invalid client-request message", details: {} } });
-        return;
-      }
-      if (message.method !== endpoint) {
-        send({ ok: false, error: { code: "gateway/bad-request", message: "method does not match endpoint", details: {} } });
-        return;
-      }
-      let result;
-      try { result = await handler(endpoint, message.payload, undefined); }
-      catch (err) { res.writeHead(500); res.end("handler failure: " + String(err)); return; }
-      send(result);
-    } catch (err) {
-      try { res.writeHead(500); res.end("channel failure: " + String(err)); } catch (_) {}
-    }
-  };
-}
-
 export function apply(ctx) {
   // 注册 settings 命名空间（插件配置页按命名空间分发卡片；内部自带 ctx.inject(['settings'])，
   // 无 settings 服务的宿主上静默不运行，不影响其它功能）
@@ -1029,61 +1370,19 @@ export function apply(ctx) {
     registerSnippetsTool(c.tools);
   });
 
-  // 等待 Connection 服务就绪后注册 RPC 通道。
-  // 注：2026-09-11 的 405 事故根因在宿主侧——connection 的 rpc-host.ts register() 曾直接访问
-  //   owner.webServer，而 owner 是 connection 插件自己的 ctx（inject 列表只有 credentials），
-  //   Cordis guard 抛 "cannot get property webServer without inject" → 前缀路由永不注册 →
-  //   所有插件 RPC 405（POST 落到 SPA 静态兜底；dsh-context 等其它插件同样中招）。
-  //   宿主已修：改经 connection 自己的 webServer 作用域挂载（与 /api 路由同路），
-  //   因此插件侧无需注入 webServer（实测调用方声明也救不了）。
-  // 防御性注册：不同 dsh-client-connection 版本的 handle() 对第三参（options）宽容度不同
-  //（0.1.5-rc.2 为 (channel, handler) 两参、多余参数被忽略；其它版本可能校验/依赖 options）。
-  // 带参注册抛错时回退两参注册；仍失败则向宿主控制台大声报错——通道注册失败时客户端
-  // 所有 RPC 都会 405（POST 落到 SPA 静态兜底），不留日志极难定位。
-  ctx.inject(["connection"], (c) => {
-    const connection = c.connection;
-    if (connection === undefined) return;
-    const handler = rpcHandler(ctx);
-    let dispose;
-    let hostChannel = false;
-    try {
-      dispose = connection.rpc.handle(CHANNEL, handler, { authority: "loopback" });
-      hostChannel = true;
-    } catch (err) {
-      console.error("[dsh-code-ui] 带 options 注册 RPC 通道失败，回退无 options 注册：" + ((err && err.message) || err));
-      try {
-        dispose = connection.rpc.handle(CHANNEL, handler);
-        hostChannel = true;
-      } catch (err2) {
-        console.error("[dsh-code-ui] 宿主 RPC 通道注册失败（将启用插件自挂路由兜底）：" + ((err2 && err2.message) || err2));
-      }
-    }
-    if (hostChannel) {
-      console.log("[dsh-code-ui] RPC 通道已注册（宿主 connection 通道）：" + CHANNEL);
-      c.effect(() => dispose, "dsh-code-ui: rpc channel");
-    } else if (typeof connection.requestRejection !== "function") {
-      // 安全护栏：拿不到宿主的信任/认证门就绝不自挂路由——否则等于开一条绕过
-      // Host/Origin 围栏与浏览器会话校验的裸路由。
-      console.error("[dsh-code-ui] 宿主通道不可用且无 requestRejection，已放弃自挂路由兜底；请更新 DSH 宿主以修复通道注册 bug");
-    } else {
-      // 兜底：自挂同路径前缀路由（与 vendor 静态路由同款机制），复用 requestRejection 认证门。
-      // 仅在宿主通道不可用时启用，宿主修复后不会走到这里。
-      c.inject(["webServer"], (w) => {
-        try {
-          const disposeSelf = w.webServer.register({
-            kind: "prefix",
-            path: CHANNEL,
-            handler: selfHostedChannelRoute(connection, CHANNEL, handler),
-          });
-          c.effect(() => disposeSelf, "dsh-code-ui: self-hosted rpc channel");
-          console.log("[dsh-code-ui] 已启用插件自挂路由兜底：" + CHANNEL);
-        } catch (err3) {
-          console.error("[dsh-code-ui] 兜底通道路由注册失败：" + ((err3 && err3.message) || err3));
-        }
-      });
-    }
-    c.effect(() => () => unwatchAllFiles(), "dsh-code-ui: file watchers");
-  });
+  // 注册 Typert Remote 服务到宿主 root Context（api-gateway 只扫描它所在 Context 的
+  // reflect.props；root 与 gateway 同层，0.1.5-rc.2 / 0.2.0-rc.2 一致）。服务生命周期
+  // 挂到本插件 fiber：卸载时自动从 root 摘除，gateway 经 internal/service 事件失效缓存。
+  const invoke = rpcHandler(ctx);
+  ctx.effect(() => {
+    const service = new CodeUiService(invoke);
+    const dispose = ctx.root.reflect.provide("dsh-code-ui", service);
+    console.log("[dsh-code-ui] Typert Remote 服务已注册（/api 通道）：dsh-code-ui");
+    return () => { Promise.resolve(dispose()).catch(() => {}); };
+  }, "dsh-code-ui: typert remote service");
+
+  // 文件监听随插件卸载清理
+  ctx.effect(() => () => unwatchAllFiles(), "dsh-code-ui: file watchers");
 }
 
 export default apply;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-code-ui",
-  "version": "1.5.2",
+  "version": "1.6.1",
   "description": "Cursor 风格的 AI 代码编辑器工作台插件（DSH）：文件树、多标签页编辑、语法高亮、引用/翻译行内标签给 AI、右侧停靠/悬浮窗口双布局",
   "type": "module",
   "main": "lib/index.js",
@@ -20,21 +20,25 @@
       "default": "./lib/client.js"
     },
     "./cordis.patch.yml": "./cordis.patch.yml",
+    "./icon": "./icon.svg",
     "./package.json": "./package.json"
   },
   "files": [
     "lib",
     "cordis.patch.yml",
+    "icon.svg",
     "README.md",
     "LICENSE"
   ],
+  "engines": {
+    "dsh": ">=0.1.5-rc.1 <0.3.0"
+  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-slots",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-settings",
@@ -45,10 +49,19 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
+    "@deepseek-ai/dsh": ">=0.1.5-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.7 <0.3.0",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-typert-protocol": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-settings": {
       "optional": true
     }
@@ -57,7 +70,7 @@
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-typert-protocol": "^0.2.0-rc.2",
     "@types/node": "^26.2.0",
     "@types/react": "~18.3.1",
     "react": "^18.3.1",