chiyulogg-commits / deepseek-harness-sentence-reasoning

DeepSeek Harness 推理摘要逐句顯示版（sentence-by-sentence）／Sentence-by-Sentence Reasoning Summary Edition

讓推理內容「逐句」呈現。 DSH Web GUI 的 Think 列摺疊摘要，streaming 期間一次顯示一個完整句子（未完成部分隱藏），結束後維持首行。

Sentence by sentence. While DSH streams its reasoning, the collapsed Think-row summary reveals one complete sentence at a time (partial sentences stay hidden), then settles on the first line when done.

基於 deepseek-ai/deepseek-harness 官方版本，僅加入「推理摘要逐句顯示」單一行為改動，不含其他修改。

A minimal edition of DeepSeek Harness with a single behavioral change: sentence-gated reasoning summaries. No other modifications.

---

特色 Features

• streaming 期間 Think 摺疊摘要一次顯示一個完整句子，未完成部分不顯示（不再逐字跳動）

• 結束後摘要維持首行（與官方既有行為相容）

• 新增純函式 lastCompleteSentence（packages/client/ui-conversation/src/client/chat/reasoning-sentence-gate.ts），句界規則見其 JSDoc

• 同步更新 lifecycle-chrome e2e 斷言與 connection stress fixture（最後 chunk 以句號結束）

• The collapsed Think-row summary reveals one complete sentence at a time while streaming; partial sentences stay hidden

• After streaming ends, the summary settles on the first line (compatible with the official behavior)

• New pure helper lastCompleteSentence (packages/client/ui-conversation/src/client/chat/reasoning-sentence-gate.ts); sentence-boundary rules in its JSDoc

• Lifecycle e2e assertions and the connection stress fixture updated (final chunk ends with a sentence terminator)

安裝與執行 Install & Run

前置需求 Prerequisites: Node.js ^22.19 || >=24，pnpm（corepack）

pnpm install
pnpm run build
pnpm dsh web

啟動後開啟 http://127.0.0.1:3080，於新會話觸發推理即可看到 Think 列逐句顯示。

Open http://127.0.0.1:3080 after startup and start a new conversation with reasoning to see the Think row reveal sentence by sentence.

本版內容 What's in this edition

相對官方 master（截至 2026-08，upstream commit 47f943859b，DSH 0.1.0-rc.5）新增 4 個 commit：

1. feat: ui-conversation — reasoning summary reveals one complete sentence while streaming — 新增 reasoning-sentence-gate.ts（lastCompleteSentence）並接到 ReasoningRow.tsx
2. test: web e2e — lifecycle live-tail assertion under sentence gating — 更新 lifecycle-chrome.e2e.ts 斷言
3. test: connection fixture — end reasoning stress marker with a sentence terminator — stress fixture 最後 chunk 以句號結束
4. docs: agent note — reasoning summary sentence gating — Agent Note 三件套
5. fix: ui-conversation — sentence gate hardening — 單一 regex pass（連續句號收斂、\p{Nd} Unicode 數字排除）、摘要 span aria-live、summary 記憶化（+reasoning.2）

品質驗證：typecheck、lint、ui-conversation／connection 單元測試與 lifecycle-chrome replay 全數通過。

版本與標籤 Version & Tags

• release tag：0.1.0-rc.5+reasoning.2（對應 DSH 0.1.0-rc.5；upstream 47f943859b；+reasoning.1 為第一版）

• 依 tag 安裝：git clone --branch 0.1.0-rc.5+reasoning.2 https://github.com/chiyulogg-commits/deepseek-harness-sentence-reasoning.git

• Release tag: 0.1.0-rc.5+reasoning.2 (corresponds to DSH 0.1.0-rc.5; +reasoning.1 was the first edition)

• Install by tag: git clone --branch 0.1.0-rc.5+reasoning.2 https://github.com/chiyulogg-commits/deepseek-harness-sentence-reasoning.git

上游與授權 Upstream & License

• 上游：https://github.com/deepseek-ai/deepseek-harness
• 授權：MIT（與上游一致，見 LICENSE）
• 本版本僅加入上述單一行為改動，未修改其他上游功能

聯絡 Contact

由 AI Agent 維護（DeepSeek Harness 本身建置與發布）。聯絡方式（文字展示，勿用於任何帳號操作）：chiyulo.123@gmail.com

Maintained by an AI Agent (built and published by DeepSeek Harness itself). Contact (display only, never for account operations): chiyulo.123@gmail.com