🚀<非官方>【中文版】dsh 0.1.2-alpha.1 特性速览：架构重构 · 新功能 · 插件兼容性提醒（对应英文版 #4867）

[Shizuku-keop]

一句话总结 —— 自 dsh-v0.1.1-rc.2 以来共 1079 个提交（master cd5ef8148）。这是一次大重构：客户端模块系统重写、ApiProxy 退役（全面 Remote 控制器化）、每会话投影缓存、会话格式迁移、code-mode 更名为 PTC 模式。⚠️ 文末是插件开发者必看的破坏性变更清单，凡是维护客户端插件的同学都建议读完。

📌 本文是英文版（#4867）的中文对照版。

📦 发布信息

项目	内容
标签	dsh-v0.1.2-alpha.1（2026-08-27），基线提交 cd5ef81481
范围	相对 dsh-v0.1.1-rc.2 共 1079 个提交
打包	241 个 dsh 家族包 + 9 个 vendor + 1 个 landlock（0.1.1 版本线保持独立）
⚠️ npm	尚未发布到 npm —— release-publish.yml 为 manual-only（workflow_dispatch），从未对该 tag 运行过；GitHub 上仅有 tag（预发布、无附件）

🏗️ 架构重构

领域	变更
客户端模块系统	dsh-client-runtime → dsh-client-modules（lazy-CJS 模块表）；sessions 迁入 dsh-api-session-controller，workspaces 由 dsh-api-workspace-controller 提供
Remote 控制器化	移除 ApiProxy 包：settings / directory-picker / session-export 下载路由 / connection 精确 Fetch 路由全部改走 Remote 控制器；browser control 也迁到 Remote
会话格式	新增格式迁移解码管线（含 legacy compact events 加载）；会话投影缓存改为每会话一个 projection_cache.json（per-record JSON 存储布局、冷读种子化、存储体积显著减小，#3048）
Windows 原生	新增 win32-process 原生原语（句柄/挂起/终止）；CI 增加 MSVC 与 failover standby 的 ABI 探针
命名	code-mode 更名为 PTC 模式（session-persistent 词汇保留旧名）——破坏性变更

✨ 新功能

• Agent Teams（实验性） —— 新增 Web profile 与 CLI profile 两套配置
• SDK / ACP 应用 bundle —— sdk-minimal 独立 profile、ACP application bundle、ACP 标准 v1 自动化控制补全（dsh-workflow-isolate: QuickJS/WASM-isolated workflows for DeepSeek Harness rc.7 #2928）；Python SDK 打包 Windows x64 版 dsh 可执行文件 + CLI/profile 资产；TypeScript 客户端可经 dsh profiles 启动
• Webhook —— 从 GitHub 事件创建工作区会话
• 子代理模型选择 —— 可为 Codex / Claude Code 配置 provider 模型、可选子模型白名单授权、模型路由经 DSH SDK 透传（模型发现默认关闭）
• 会话日志上传 —— 增量上传会话日志 + 插件包元数据（默认 feedback-gated 共享）
• HTTP gzip 支持；websocket 空闲保活；web 请求一次性 fetch 审批（SSRF 防护）
• headless 模式推理进度流式输出到 stderr
• compaction 按路由为图片请求压力计价（[Bug] Agent output enters an infinite repetition loop that runs for ~10 minutes with no circuit breaker — only a manual abort stops it #2848）
• 会话持久化模型选择并共享目录；session-query 新增共享投影观测
• 外部语言注册；自适应内容宽度 + 字号控制；统一次级字体层级；全局 CJK/Latin 自动间距（text-autospace）

🎨 Web UI

• Lexical 编辑器 —— 组合器替换 textarea 栈（chip 节点、span map）
• 乐观提交回显 —— 待处理回合即时渲染在 Chat 流尾，客户端回显与 rpcId 关联
• 每轮 token 精确用量显示（[Showcase] Odai：DSH 的治理运行时与可选 Agent preset #3005）
• Trajectory 中展示图片附件 + 模型可读图片路径
• @ 提及行精简、降低发现成本；输入触发菜单打磨；已加载 Turn 紧凑导航 rail；流式围栏增量高亮；提问卡可读化；会话行按最后活动排序

⚠️ 实测行为变化与插件兼容性（重点）

• 一次性 token 认证 —— dsh web 启动日志打印 http://<host>:<port>/?token=...；无 token 请求 → 401，带 token → 303；每次启动重新生成（--port 0 随机端口、--no-open 不弹浏览器）
• RPC 协议 —— POST /<channel>/<endpoint>；信封 method 必须等于 URL endpoint（否则 bad-request）；裸通道路径（POST /<channel>）→ 404，探测通道注册必须带 endpoint 段
• DOM 变化 —— [data-pane="conversation"] / [data-pane="sidebar"] 选择器已失效，面板改靠 [class*="centerCol"] 匹配
• API 形态 —— 新控制器的 getSnapshot() 是依赖 this 的类方法；把裸方法引用传给 useSyncExternalStore 会导致面板崩溃（例：dsh-mnemon 0.3.2「记忆系统页面消失」bug，本机已打补丁；0.3.4 同样受影响）
• 模块解析 —— 插件从插件目录向上查找 @deepseek-ai/*，够不到全局安装目录；需要 junction/符号链接指向全局 node_modules（已用 @deepseek-ai/dsh-tools 实证）
• 官方 web 三件套（dsh-base + dsh-web-app + dsh-mnemon）在 0.1.2-alpha.1 上运行正常

欢迎反馈、指正，也欢迎插件维护者分享踩坑经验！👋

[denial123789]

For an English, source-pinned upgrade checklist, the handbook keeps alpha.1 migration boundaries separate from the rc.7 baseline: https://sandbaseai.github.io/deepseek-harness-handbook/upgrade-and-rollback.html

It covers plugin ABI changes, provider/configure seams, Session/preset migrations, and artifact provenance. The current Field Status page is here: https://sandbaseai.github.io/deepseek-harness-handbook/field-status.html

[Shizuku-keop]

thank U bro，你给开源社区做出了巨大的贡献，坚持下去，一直支持你们