Overview
dsh-workbench
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- 界面观感只过了组件树自检,**未做人工视觉验证**;浅色/深色都做了适配但与真实主题的贴合度可能还要调。 - **记录要靠产出方写。** 插件不会替你写记录 —— 它只做两件事:显示 `.versions/produced.jsonl` 里已有的, 以及把「目录里有、记录里没有」的那些**列出来**(【未入记录】),由你点一下才收编成一版。 收编写进去的摘要就是你那一句话,插件不猜内容。 - 「还没进记录」的**生成命令是靠会话日志反推的**,只在两种情况下给得出:那次产出发生在 DSH 会话里、 且命令里带着输出路径(`--out` / `-o` / 重定向 / 构建脚本 + 文件名)。别的工具改的(WordBuddy、手动另存) 一律显示「没找到生成命令」——**宁可不给,也不编**。 - 历史上已经同名覆盖掉的版本,**找不回来**(快照是从设了记录器之后才开始存的); 但【未入记录】至少能把「现在这一版」先收编下来,从这一刻起它就有了快照。 - 「产物过期」按**文件修改时间**判定,不看内容。生成脚本若先 touch 产物再写内容,判定会偏乐观。 - 「和上一版比」只解 **docx / xlsx(含 xlsm)** 与纯文本(md/tex/qmd/txt/csv/html)。 pdf / pptx / 老的 `.xls` 读不出正文,那一轮的按钮是灰的;超长文档只比前面 4000 段(面板上会说明被截断了)。 段落级 diff 用 LCS,序列过大时退化成「整段全删 + 全增」——宁可粗,也不把浏览器卡住。 表格里的**日期**按数字显示:判它是不是日期要看 styles.xml 的数字格式,那一步容易猜错,不如不猜。 - 目录扫描不递归,只扫一层;一次最多返回 1000 轮。 - 自动检测是**定时重读记录文件**(默认 10 秒一次,可在档位按钮里放慢或关掉),不是操作系统的文件监听; 浏览器标签页在后台时那一拍会跳过,所以切回来可能要等一拍才提示。 - 审批写的是记录文件,**不会**真的去改动或回滚你的 Word。 - 「上一步/下一步」的历史只在面板活着的时候有效:刷新页面、或工作台被切走再切回来,那条历史就空了 (但**位置**会记住——目录落在 localStorage 里,技能库打开的技能、筛选、选中轮次也随面板状态保留)。
