dsh-tokensforce

为 DeepSeek Harness（dsh）接入 TokensForce 词元网关：登录一次，模型即用。不需要手动填 API Key，不需要改配置文件。

安装

dsh plugin --profile web add dsh-tokensforce
dsh web

打开 http://127.0.0.1:3080，登录向导会自动弹出。

如果 dsh plugin add 报 ERR_PNPM_ADDING_TO_ROOT（旧版 pnpm），在
~/.dsh/profiles/web 目录下手动 pnpm add -w dsh-tokensforce，
再把包名加入该目录 package.json 的 dsh.profile.bundles 列表即可。

使用

1. 首跑：dsh 启动且尚未配置任何模型时，自动弹出近全屏的 TokensForce 登录窗口
   （就是 tokensforce.com 的登录页，邮箱验证码登录，与网页版完全一致）：

   

2. 选企业 / 选组：账号属于多个企业或企业下有多个组时让你选，只有一个则自动跳过；

3. 完成：所选组的 API Key 与网关地址自动写入，选个模型就能开始对话。
   每个组在「设置 → 模型」里是一行独立的提供方，可编辑、删除、发现模型。
   每个模型写入显式 1M 上下文（压缩时机、设置页容量显示都以此为准，不会显示成
   dsh 的 256K 占位默认）；网关若披露了某个模型的真实上下文，则按披露值精确到该模型。

之后再添加其他组：打开设置，点右上角的「连接 TokensForce」按钮。
登录态保留 7 天，期间添加新组不用重新登录。

用量仪表盘：会话视图里多一个「TokensForce」标签（与「对话」「轨迹」并列），
点开就是 tokensforce 控制台仪表盘（用量、费用、排行），与网页版一致；
未登录或登录过期时，该标签内直接显示登录窗口，登录后自动进入仪表盘。

常见问题

装上后官方 DeepSeek 提供方去哪了？
本插件会禁用 llm-deepseek 的首跑引导，避免开屏出现两处要 Key 的提示；
模型引擎仍走 dsh 自带的 OpenAI 兼容通道。卸载插件即恢复原状。

我们公司自己部署了 tokensforce，能用吗？
能。安装后把 node_modules/dsh-tokensforce/lib/client.js 里的
SITE_ORIGIN 改成你的站点地址并重启 dsh；站点侧需放行登录页嵌入
（nginx 对 /login 不发 X-Frame-Options 等，可参考 tokensforce 的实现）。
更正式的做法是 fork 本仓库，改 src/client/logic.ts 中的常量后自行构建。

密钥存在哪？
组密钥经 dsh 自带的凭据机制存在你本机（~/.dsh/.credentials.yaml），
浏览器只保留登录态（JWT，7 天有效）。模型请求由 dsh 宿主进程直连网关，
不经过浏览器。

反馈

• 使用问题：Issues
• 维护与二次开发：见 CONTRIBUTING.md

License

MIT