FenrisGe-RIS/dsh-tlock ↗★ 2

dsh-tlock

T约束 —— 每轮生成的 token / 时间双闸:到量即断、超时即断,并自动把已生成内容归档到桌面

套件
dsh-tlock
相容性
待驗證
版本
0.3.2
授權
MIT
最近更新
2026年11月8日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:FenrisGe-RIS/dsh-tlock

T约束 · dsh-tlock

给每一轮生成装上「刹车」:token 到量就断、时间到点就断,断下来的内容自动收进桌面归档。

T约束


为什么要它

问一个简单问题,AI 回了两万字;想让它「写个草稿」,结果它顺手重构了整个项目——你没法在开跑之前说清楚"到这儿就停"。

T约束 就是那道闸:

  • 按 token 限:一轮最多写多少(5 千 ~ 100 万),到量硬断;
  • 按时间限:一轮最多跑多久(1 分钟 ~ 2 小时),到点硬断;
  • 断了不丢:已经生成的内容自动归档到桌面,还能一键「继续生成」接着写。

核心能力

1. 双闸·到量即断

闸量程精度
Token5 千 ~ 100 万 / 轮实时估算 + 尝试结束时精确校准
时间1 分钟 ~ 2 小时 / 轮从你按下发送开始计(含工具调用耗时)

到 80% / 90% 会先问一句「还接着生成吗」,你点「到此为止」立刻断、点「继续」就不打扰你。

2. 滑条·一眼看清

两条黑色滑条,6 个整点把量程均分成 5 段,刻度正好落在 1/5、2/5、3/5、4/5 上,拖到刻度附近自动吸附;不想要整点就点「手动输入」填任意值。

  • token 整点:5 千 / 5 万 / 20 万 / 40 万 / 70 万 / 100 万
  • 时间整点:1 / 10 / 30 分钟 · 1 / 1.5 / 2 小时

用量进度条是绿色的,一眼看出这轮吃掉多少。

3. 归档·两种视角

断了之后自动在桌面建文件夹:桌面\DSH限定生成内容\{token限定版|时间限定版|手动结束}\时间_会话名\

模式产出适合
简洁描述生成说明.md:这轮在说什么、内容骨架、动过哪些文件、几段代码、正文人看,扫一眼就知道写了什么
归档完全记录(推荐)完整记录.md + 完整记录.json:完整思考过程、全部工具参数与返回、正文原文想一字不落地回看/喂模型,选这个
两个都要上面两份 + meta.json既要存档又要喂模型

不想要归档?点「解除归档」,到量照样断,只是不写文件。

4. DSH 里的黑色悬浮球

右下角一颗 46px 的黑色方块(只存在于 DSH 页面里,不在桌面),图案就是 T约束 的斜链锁 T。点开是面板,可拖动、位置会记住;硬断时变成橙框提醒你「有一轮等你决定」。

面板三个页签:

  • 约束模式 —— 滑条、归档模式、本轮进度、继续/结束
  • 查看历史归档记录 —— 面板里直接读归档内容、重命名、在文件夹中显示
  • 查看历史归档记录 —— 每一次断档的清单,点开直接定位文件夹
  • 设置 —— 插件开关、悬浮球开关、开机自启、页面大小、语言(中文 / English)、打开归档目录

5. 输入前先问一句

约束关着的时候,你按下发送会先被拦一下:

要不要开约束?

点「确认约束」→ 开启并弹出面板;不想开 → 再按一次 Enter 直接发送。再也不会"忘了开闸就让它狂写"。

快速上手

# 安装(从 GitHub 拉取,推荐)
dsh plugin --profile desktop add https://codeload.github.com/FenrisGe-RIS/dsh-tlock/tar.gz/v0.3.2

# 也可以直接下压缩包,双击 安装.bat
# https://github.com/FenrisGe-RIS/dsh-tlock/releases/latest

# 本地开发安装
dsh plugin --profile desktop add file:C:/path/to/dsh-tlock
  1. 重启 DSH(或刷新页面)→ 右下角出现黑色方块;
  2. 点开 → 拉滑条设定本轮上限 → 关掉面板;
  3. 正常提问。到量会自动硬断 + 归档 + 问你是否继续。

归档长这样

桌面\DSH限定生成内容\token限定版\20261107-214503_重构登录模块\
├── 生成说明.md      # 人看的
├── 完整记录.md      # 一字不落(推荐)
├── 完整记录.json    # 同上,程序读取用
└── meta.json        # 机器读的(用量、耗时、模型、限制)

生成说明.md 节选:

(未命名会话) · token限定版
======================================

2026-11-07 21:45 用时 43 秒 用量 3643 / 9.86 万 token

这一轮在说什么
--------------------------------------
重构了登录模块的三个文件,把 session 校验抽成中间件……

动过的东西
--------------------------------------
· src/auth.js(3 次)
· src/middleware/session.js(2 次)

设置项

键默认说明
enabledtrue插件总开关
tokenLimit20000每轮 token 上限(5000 ~ 1000000)
timeLimitSec300每轮时间上限(60 ~ 7200 秒)
archiveEnabledtrue是否归档
archiveModebriefbrief / full / both(旧值 ai 自动升级为 full)
warnPct[0.8, 0.9]预警阈值
balltrueDSH 内悬浮球
autoStarttrue开机自启(保留字段,桌面控制台已移除)
panelSizem面板尺寸 s / m / l
langzhzh / en

设置存在 %USERPROFILE%\.dsh\storages\dsh-tlock\settings.json,改完 ≤500ms 生效,不用重启。


隐私与安全

  • 纯本地:不联网、不上报、不读你的对话正文去别处;插件代码只依赖 node:fs / node:os / node:path / node:child_process。
  • 只做三件事:读会话事件算用量、调 agent.cancel() 断生成、把归档写进桌面。
  • 不做的事:不改你的提示词、不动模型输出、不拦截除「发送前询问」以外的任何输入。
  • 所有数据:settings.json / status.json / commands.json / history.json 都在上面那个目录里,删掉即清空。

已知边界(先说清楚)

  1. token 是"准实时":宿主只在一次尝试结束时回报精确 usage,流式过程中用字符数估算。因此实际值可能略超上限一点点(一次尝试的量级),断点之后不会继续涨。
  2. 时间闸包含工具调用:你按下发送就开始计时,跑代码、查文件的时间都算——所以长任务常常是"时间先到"。
  3. 只管当前会话的这一轮:子代理、后台任务不并入父轮计数;对它们单独发消息才会开新一轮。
  4. 硬断在安全点生效:正在执行的工具调用不会被强行截断,会在下一个可中断点停下。

常见问题

Q:设了 20 万,是不是必须生成 20 万? 不是。上限不是配额,写得短就早停;额度按轮重置,下一轮重新算。

Q:断了之后内容会丢吗? 不会。断的那一刻先写一份快照,中断消息回来后再用精确数据覆盖同一份,正文和思考都在。

Q:和 dsh-ration 冲突吗? 不冲突。两者独立计量;你要更严格就同时开,T约束 的闸会先触发。

Q:能只算正文、不算思考吗? V1 没做这个口径——按宿主回报的 outputTokens 统一计。需要的话可以加。


更新日志

  • 0.3.2 — 修掉归档详情反复弹「改名字失败」:读取失败不再每 2 秒重试一次、也不再冒充重命名失败,失败时直接在面板里说明原因
  • 0.3.1 — 移除独立的桌面控制台(TLock.exe);面板已是唯一入口,安装包更小、少一个常驻进程
  • 0.3.0 — 归档体检:面板内直接浏览归档内容(深色主题、可切换文件)、支持重命名归档与文件;「AI联动分析」换成「归档完全记录」(一字不落,含工具参数与返回);简洁描述新增「这份省略了什么」;默认推荐完全记录
  • 0.2.2 — 修「打开归档目录」按钮无效(面板走 /open 专用路由,宿主 /cmd 也接受 open)
  • 0.2.1 — 英文界面完整化(K/M 单位、所有提示中英双语)、滑条 + 吸附、三种归档模式、历史记录页、DSH 悬浮球、输入前拦截、设置页、斜链锁 T 图标、开场动效(已按反馈移除)、桌面控制台重做
  • 0.1.0 — 双闸核心、桌面归档、悬浮提示

元信息

  • 包名:dsh-tlock 显示名:T约束 版本:0.3.2
  • 形态:DSH 插件(宿主 lib/index.mjs + Web 客户端 lib/client.js),无独立桌面程序
  • 许可:MIT 运行环境:DSH ≥ 0.2.1,Node ≥ 22
  • 依赖:无(不引入任何三方运行时依赖)