前言¶
在 DeepSeek Harness（DSH）裏做 Agent 開發時，模型提供方通常要單獨配置 API Key，或在多個客戶端之間複製對話。若你已經在 Windows / macOS / Linux 上安裝並登錄了 Today AI 官方桌面客戶端，理論上可以直接複用該登錄態，把 DeepSeek V4.1 Flash、MiniMax M3.1 Flash、GLM 5.3 等模型當作 DSH 的標準 Provider 使用，而不必再維護一套獨立密鑰。
dsh-today（GitHub：xuemei-wintersweet/dsh-today）就是面向這一場景的 DSH 插件，分類屬於「模型推理」。維護者爲 xuemei-wintersweet；項目採用 MIT 許可證，當前 package 版本爲 1.2.2，Node.js 要求 >= 20.0.0。下面介紹它的定位、能力與安裝用法；細節以倉庫 README 與 Release 爲準。
這是什麼¶
dsh-today 是獨立的第三方互操作適配工具：讀取本機 Today 桌面客戶端已有的登錄態，經本地環回 Shim 與 SSE 協議轉換，把上游 Today 雲端推理網關接到 DSH NEXT 的 Cordis / PiAiAdapter 模型路由層。插件不提供賬號破解或繞過計費；每次調用仍按上游規則扣減你個人賬號額度。
與「手動把 Today 窗口裏的回答貼回 IDE」相比，它把會話留在 DSH 工作流內，並儘量對齊 DSH 對思考鏈、工具調用與長任務交付的協議期望。
核心功能¶
以下能力均來自項目 README 與 package 聲明，安裝前可自行對照源碼目錄（如 src/shim.ts、src/credentials.ts、src/auto-pump.ts）。
原生雙軌思考過程（Dual-Track Thinking）¶
適配器解析上游推理流中的思考幀，識別 <think>...</think> 等信號，將內容拆成 DSH 所需的 reasoning_content（摺疊思考氣泡）與 content（正文）。若缺少顯式閉合標籤，會在首個正文或工具調用到達時閉合思考段，避免思考內容污染用戶可見正文。
自驅動 Auto-Pump 任務交付¶
針對長鏈路編碼任務中模型階段性停下來的情況，Auto-Pump 會感知磁盤上的中間產物（腳本輸出、解包文件等），在合適時機補發狀態驅動，推動模型繼續完成閉環，而不是停在「總結已完成、文件未寫完」的狀態。
本地憑據與 DPAPI（Windows 爲一等公民）¶
插件複用官方客戶端寫入的會話文件（SQLite / JSON 加密槽），在 Windows 上通過 DPAPI（CryptUnprotectData）在進程內存中解密，README 明確說明不落地明文 Token、不向第三方上報憑據。macOS 與 Linux 有對應路徑與 Keychain / 環境變量映射說明；Windows 11 爲完整驗證環境。
多模型與配額讀取¶
Provider ID 爲 today 與 today-global，可區分國內 Today CN 與國際 Today Global，並按上游目錄讀取可用模型與倍率。README 列出的主要模型標識包括：
| 模型標識 | 基座 | 計費倍率（README） | 上下文 |
|---|---|---|---|
model.deepseek-v4.1-flash |
DeepSeek V4.1 | 1.0× | 1,000,000 |
model.minimax-m31-flash |
MiniMax M3.1 | 0.0× ~ 0.5× | 1,000,000 |
model.glm-5.3 |
GLM 系列 | 4.0× | 200,000 |
離線安裝與 CLI 診斷¶
Release 提供 dsh-today-setup.bat 等離線一鍵部署路徑；自帶 dsh-today CLI，支持 doctor、status、models，以及在本機 127.0.0.1 啓動 OpenAI 兼容代理（默認示例端口 18421），供 Cursor 等工具通過 http://127.0.0.1:18421/v1 接入（需自行評估合規與賬號風險）。
工作原理（簡述）¶
README 給出的架構可以概括爲：
DSH NEXT → PiAiAdapter → Today Local Loopback Shim → TodayUpstreamClient
↑ CredentialStore（本地會話 / DPAPI）
↓ SSE → api.todayai.cn
環回通信使用動態端口與內存隨機密鑰校驗；上游流中的 reasoning_content 與 content 經適配後進入 DSH 界面。
安裝與啓用¶
DSH 插件市場（推薦）¶
在已配置 DSH 插件註冊表的環境中執行：
dsh plugin --profile desktop add dsh-today
若持有離線包 dsh-today-1.2.1.tgz（README 示例文件名），可本地安裝：
dsh plugin --profile desktop add ./dsh-today-1.2.1.tgz
執行後完全退出並重啓 DSH NEXT。離線 tgz 版本號以你實際下載的 Release 爲準；npm 包當前爲 1.2.2。
Windows 一鍵腳本（全離線）¶
- 從 Release 下載
dsh-today-setup.bat（或倉庫根目錄同名腳本）。 - 雙擊運行；腳本會校驗 Node、定位
~/.dsh/profiles/desktop/、解包預編譯文件、通過link:機制註冊，並追加cordis.yml（帶時間戳備份），最後調用bin.js doctor自檢。 - 重啓 DSH NEXT，在模型列表中選擇例如 Today CN / DeepSeek V4.1 Flash。
宿主版本與平臺¶
| DSH 宿主 | 狀態（README） |
|---|---|
| 0.1.7-rc.1 ~ 0.1.7-rc.2 | 完全兼容 |
| 0.2.x 正式版 | 完全兼容 |
| 0.2.x 預發佈 | 兼容（tgz / 目錄加載） |
| >= 0.3.0-0 | 暫未驗證 |
| <= 0.1.6 | 不受支持 |
思考摺疊氣泡依賴 DSH 0.1.7-rc.1 及以上 的一致性 Provider 接口。
cordis 配置片段¶
若模型下拉中沒有 Today 項，檢查 ~/.dsh/profiles/desktop/cordis.yml 是否包含類似段：
dsh-today:
region: cn
enableNativeDeviceTools: true
responseTimeoutMs: 120000
修改配置或安裝插件後同樣需要重啓 DSH NEXT。
典型用法¶
在 DSH 內選模型對話¶
安裝並重啓後，在 DSH NEXT 模型選擇器中選擇 Today 提供的模型擋位即可；前提是 Today AI 桌面客戶端已啓動且已登錄。若 doctor 報 Auth State: missing，先打開官方客戶端完成登錄再自檢。
命令行自檢與本地代理¶
npx dsh-today doctor
npx dsh-today status
npx dsh-today models
npx dsh-today serve 18421
doctor 爲脫敏自檢；status 可查配額；serve 啓動本地 OpenAI 兼容服務。插件以當前 DSH / Node 進程權限運行，讀取本機會話目錄，安裝前應閱讀 MIT 許可證、DISCLAIMER 與源碼，自行評估賬號條款與非官方接口風險。
適用場景與注意¶
適合誰： 已在本地使用 Today AI 桌面客戶端、希望在 DSH NEXT 內統一使用同一賬號配額與思考鏈展示、並偶爾需要本地 /v1 環回代理的開發者。
不適合或需謹慎： 期望完全脫離 Today 官方客戶端單獨登錄的；宿主版本 >= 0.3.0-0 且未驗證的組合；需要官方授權背書的生產合規場景——README 免責聲明寫明本項目與 Today AI、DeepSeek AI 無商業隸屬或官方合作。
運維提示： HTTP 429 多爲上游頻控或額度問題，可用 npx dsh-today status 查看；超長上下文可能拉長響應，README 建議大型重構時善用壓縮或新會話。DSH 社區插件目錄（SkillHub 等）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；本插件在目錄頁爲 xuemei-wintersweet/dsh-today，源碼與 Issue 見 GitHub 倉庫。
結尾¶
dsh-today 把「本機已登錄的 Today AI」橋接到 DSH：雙軌思考、Auto-Pump 長任務推進、Windows DPAPI 本地解密與會話複用，是模型推理類插件裏偏工程落地的一條路徑。使用前請讀完倉庫風險提示與免責聲明，並在安裝前核對源碼與許可證；需要離線部署時可優先 Release 中的 tgz 或 Windows 安裝腳本。
