2026 年 9 月 30 日 · 星期三DeepSeek Harness 中文社区动态第 44 期
dsh-ai.com 每日简报DEEPSEEK HARNESS OBSERVER
DeepSeek Harness · 每日动态

2026-08-27 动态

逐条人话解读 · 发生了什么 → 对你意味着什么 → 该怎么办 · 更新于 2026-08-28 23:41

📋 6 条官方动态📝 143 条提交💬 29 条讨论⭐ 201,704 stars

📦 官方动态(逐条解读)

📌
**code-mode 正式更名为 PTC mode**模式值、文档和代码注释全面从 code-mode 切到 ptc(会话持久化词汇除外),升级后请检查配置里的 code-mode 是否需要改成 ptc。
📌
**Connection 层接管 RPC 传输契约,ApiProxy 包被移除**连接、下载和 Fetch 路由改为显式注册,内部架构更清晰,对普通用户基本无感,但插件若依赖旧 ApiProxy 接口需要适配。
📌
**修复 file-reference 输出归属与文件搜索不可读子树问题**文件引用产物保留在项目内,同时修复了 file-search 在不可读子目录下的问题,日常文件搜索更不容易踩坑。
📌
**SDK 0.3.241 平台负载行恢复 + 文档链接修正**notices 里 SDK 平台负载行和 RPC 测试文档链接被修好,开发者查文档时不会再看错。
📌
**master rebase 后清理 README 残留并刷新模块图**仓库历史合并后清理了过时链接和描述,对用户无直接功能影响,但让贡献者更容易读懂项目结构。
📌
**修复 Settings 配置目录锚点与原生路径打开行为**设置面板的 catalog 锚点和文件原生打开方式被保留,避免升级后配置跳转或打开行为发生变化。
💡 人话总结:官方今天主要做内部架构整理和改名(code-mode→ptc、Connection 接管 RPC),同时修了文件搜索、文档链接等稳定性问题。普通用户升级后重点是检查旧配置里的 code-mode 是否要改成 ptc,其余大多无感但更稳。

💬 社区热点(分类解读)

🔴 会话持久化与压缩损坏
多起用户报告 Compaction 后残留 .jsonl + .jsonl.zstd 双文件,导致子代理子系统直接挂掉(#4746);模型输出空 id/name 工具调用后 Resume 报 SessionPersistenceCorruptionError(#4704);还有 seq gap 跨 session 串写,手动修复后单文件损坏使 dsh web 启动崩溃(#4767)。
你该怎么办:升级/压缩前先备份 DSH_HOME 下的会话文件;遇到双文件先保留 .jsonl 主文件,用官方恢复流程,别直接删 .zstd。相关讨论 #4767 · #4746 · #4704 ↗
🔴 子代理与多代理任务可靠性
Sub-agent 完成轮询报 unknown job,导致多代理任务中途停止(#4696);Goal rounds 在长时间运行的子代理未结束时空转忙等(#4715);Spawn 子代理丢失 reasoningEffort,依赖思考的端点拒绝委派(#4666)。
你该怎么办:跑大型多代理任务时降低并发并留日志;遇到 unknown job 先重试或降级到单代理,等官方修复。相关讨论 #4696 · #4715 · #4666 ↗
🔴 工具调用与流式兼容
provider 流式返回显式 null 时 tool call id/name 被丢弃,导致所有工具报 unknown tool(#4671);跨 provider 重放丢失 reasoning_content,DeepSeek 兼容路由多轮工具调用 400(#4745);cordis_define/cordis_inspect_query 的 object/oneOf 参数到达时是原始字符串而非对象(#4747);Thinking mode 不支持 tool_choice(#4709);edit 工具把同级权限误判成提权(#4742)。
你该怎么办:工具调用失败先看 provider 是否流式返回 null,尝试关流式或换直连路由;使用 cordis 相关功能时等待参数解析修复或手动转对象。相关讨论 #4671 · #4745 · #4747 · #4709 · #4742 ↗
🔴 Web UI 浏览器兼容与可用性
浏览器 RPC 路径用 crypto.randomUUID,在不安全来源下 Web UI 直接挂(#4756);非 loopback 访问时 Settings 面板报不可用(#4695);DSH 让用户判断的问题太长导致按钮消失(#4748)。
你该怎么办:远程访问务必走 HTTPS 或 localhost;面板按钮消失可缩窗口/换浏览器,并向维护者反馈 UI 响应式问题。相关讨论 #4756 · #4695 · #4748 ↗
💡 会话展示与性能改进
Session Presentation protocol v2 提出客户端兼容地同时展示多个 Session(#4718);session.history 裁剪已关闭消息的 chunk,页面可小 160 倍(#4678);还讨论 CacheScope/Prompt Cache 可观测与输入变化诊断(#4665);token-meter messageTokens 可能下溢为负(#4703)。
你该怎么办:被超长会话页卡住的可以关注 #4678;想要缓存诊断就去 #4665 补充你的场景,推动实现。相关讨论 #4718 · #4678 · #4665 · #4703 ↗
🌱 插件生态与多实例自建
有社区用户做了多实例启动器,可创建不同版本/隔离 DSH_HOME 的 profile(#4698);新 profile 直接 dsh plugin add 缺 -w 会报 ERR_PNPM_ADDING_TO_ROOT(#4680);同时提醒插件可能破坏 wire protocol(#4668),cordis inspect providers 进程级全局导致两个 preset 无法共存(#4675)。
你该怎么办:多实例用户可试用社区启动器;装插件前确认协议兼容,add 失败时加 -w 或先初始化 workspace。相关讨论 #4698 · #4680 · #4668 · #4675 ↗
🧭 去哪继续学:想排查会话损坏和子代理问题,可以去「故障排查」栏目看持久化恢复流程;想体验社区新插件,直接逛「插件精选页」或官方文档的插件章节。

🧩 插件生态

🧩
**新插件 deepseek-harness-genui(⭐106)上线**Code-first 方式生成 React + TypeScript 任务应用,适合不想手搓 UI 的开发者。
🧩
**新插件 dsh-commandcode-provider(⭐103)接入 Command Code 模型**非官方支持,注册 commandcode 模型后可在 dsh 里调用,想尝鲜新模型的可以关注。
🧩
**新插件 dsh-webui-market-plugin(⭐100):Web GUI 内浏览社区插件市场**直接在界面里发现 awesome-dsh 插件,省去翻 GitHub。
🧩
**热门 volcengine/OpenViking 单日 +303 星(总 ⭐33335)**RAG/知识库方向继续升温,需要企业级知识库方案可重点研究。