前言¶
DeepSeek Harness (dsh) 是一个基于插件的智能体开发框架。在使用第三方网关（如 TokensForce）时，通常需要手动管理 API Key 和配置。dsh-tokensforce 插件旨在通过自动化流程，解决这一繁琐的配置与登录问题。
插件定位¶
dsh-tokensforce 是 DeepSeek Harness 的一个插件，由 spirits001 维护。它集成 TokensForce 词元网关，支持一键登录、自动配置提供方以及用量仪表盘集成。核心价值在于实现“登录一次，模型即用”，无需手动填 Key 或改配置文件。
核心功能¶
插件提供以下核心能力：
- 一键登录与自动注入：首次启动时自动弹出登录窗口，选择企业或组后，API Key 与网关地址自动写入。
- 多企业/组支持：支持在设置页面添加新组，登录态保留 7 天，期间无需重新登录。
- 用量仪表盘：在会话视图新增“TokensForce”标签，可查看用量、费用与排行，与网页版一致。
- 7天登录态保持：浏览器仅保留 JWT 登录态，7 天内有效。
- 安全存储：组密钥存储于本地凭据文件（
~/.dsh/.credentials.yaml），浏览器不存储密钥。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin --profile web add dsh-tokensforce
安装后启动服务：
dsh web
打开浏览器访问 http://127.0.0.1:3080，登录向导会自动弹出。
典型用法¶
- 首次启动：dsh 启动且尚未配置任何模型时，会自动弹出 TokensForce 登录窗口。登录方式与网页版一致（邮箱验证码）。
- 选择组织：如果账号属于多个企业或组，会弹出选择界面；如果只有一个，则自动跳过。
- 自动配置：完成选择后，所选组的 API Key 与网关地址自动配置。模型上下文默认设为 1M（除非网关披露真实值）。
- 添加新组：之后在设置页面点击右上角“连接 TokensForce”按钮，即可添加新组（登录态 7 天内有效）。
- 查看用量：在会话视图点击“TokensForce”标签，即可查看用量与费用仪表盘。
注意事项¶
- 禁用官方引导：插件会禁用官方 DeepSeek 提供方引导，避免开屏出现两处登录提示。模型引擎仍走 dsh 自带的 OpenAI 兼容通道。
- 自定义部署：若公司自行部署了 TokensForce 网关，需修改
node_modules/dsh-tokensforce/lib/client.js中的SITE_ORIGIN为你的站点地址，并重启 dsh。站点需允许登录页嵌入。 - 密钥安全：密钥存储在本地，浏览器只保留 JWT 登录态。模型请求由 dsh 宿主进程直连网关，不经过浏览器。
- 适用场景：适合需要统一管理多个企业/组 API Key，并需要实时查看 TokensForce 用量数据的用户。
总结¶
dsh-tokensforce 通过插件化方式简化了接入 TokensForce 的流程。它将认证、配置和监控集成在 DSH 生态中，适合需要频繁切换组织或关注网关用量统计的开发者。
