前言¶
在 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 安装脚本。
