Repository navigation
Releases: tsonglew/adhd-md
Releases · tsonglew/adhd-md
Release list
v0.1.2
- 统一阅读页与对话陪读的 JSON 会话书签,分别保存当前查看位置、待读位置、展示范围、跳过范围和待澄清问题。回看前文保留待读位置,跳过不计为读完。
- 阅读页支持复制、下载、粘贴和文件导入书签。同一份原文改变分段大小后仍可恢复;原文内容、书签格式或锚点不匹配时拒绝导入,保留原书签。
read --session bookmark.json可恢复书签;配合--json返回规范化会话及带 UTF-16 偏移的分段,供 agent 核对和更新位置。没有 shell 的对话仍可使用纯文本书签。- 增加
read --open,生成成功后尝试打开阅读页;打开失败会提示手动打开并保留文件。--open与--json互斥。 - 书签通过手动导入导出迁移,不提供自动跨设备同步。浏览器无法保存本地进度时会提示;书签包含短原文锚点和问题,继续阅读仍需原文。
- 同步 Python 与 Node CLI 的版本号,
--version均返回0.1.2。
v0.1.1
新增
- 增加
extract与read的网页、PDF 提取和离线阅读流程;PDF 文本层使用 Poppler,扫描页可选用 Tesseract 与语言包。 - 集中维护评分规则,并生成规则、评分和证据映射表。审计与对比报告会显示规则覆盖范围。
- 增加 Python、Node CLI、npm tarball、安装器和官网构建的独立 CI 检查配置。
改进
-
修复加粗密度统计:排除行内代码、链接目标、转义分隔符和标题,避免跨段误配。
-
明确事实、条件、scope、用户逐字约束及 unknown 回退边界,补齐模型回归与已知失败记录。
-
增加标签版本与发布说明校验,通过复用 CI 后自动创建 GitHub Release。
-
verify使用pass、fail、unknown三态;对不能可靠判断或仍有警告的内容不再报告为通过。 -
fmt --write仅在保护检查通过后原子写回,并拒绝不安全文件类型和并发修改;--strip-emoji明确作为有损操作。 -
审计与报告 JSON 升至 schema 2,加入覆盖统计和 scope 过滤后的 findings。保留既有
findings、scope、hard_failures、warnings与ok字段。 -
安装器按用户级或项目级范围管理资产,并使用归属标记保护无法确认来源的旧目录。
-
改善移动端语言切换、键盘焦点、复制失败反馈、减少动态效果和 OG 资源生成。
调用方迁移说明
verify的退出码为0(pass)、3(fail)、4(unknown)。自动化调用方应处理退出码4;JSON 调用方应检查status,并只把ok: true/status: "pass"视为机器检查通过。旧 JSON 字段仍保留,但ok在 unknown 时为false。audit --json与report --json的schema_version现在为2。既有findings字段仍包含所有适用轴;shown_findings按 scope 过滤。scope 只筛选 findings 和 coverage,脚本分仍按全文所有适用轴计算。score.band在脚本分场景为null,不能再假定始终是字符串。fmt --write遇到校验失败、unknown、符号链接、硬链接、非 UTF-8 文件、并发改动或替换失败时会拒绝写回并返回非零状态。先备份目标文件,再对少量样本运行fmt --check,确认报告后使用--write。--strip-emoji会改变内容,不属于无损格式化。- 卸载器只移除能由软链目标或管理标记确认归属的资产。早期无标记目录会被保留;用户需先检查目录内容,再手动清理。
验证状态与已知限制
- 本地测试和构建记录见
docs/implementation-checklist.md;当前宿主版本和真实执行状态见docs/host-matrix.md。 - 先前托管 CI 与失败注入已验证;本版本标签仍须通过发布工作流中的完整 CI。模型验收采用预标注约束复核:当前 9 例、30 份主回归产物通过门禁,一次服务故障已单独补跑成功。
- 按用户要求排除 H07、H09、H10,相关 UI 事实推断、逐字约束和 scope 问题仍保留为已知限制;未宣称原 12 例全量通过。Cursor、Gemini、opencode、Grok 未完成验证,真实读者试验暂缓。历史原始产物与范围变更见
docs/eval-corpus/README.md和docs/eval-runs/2026-10-14-reacceptance/README.md。 verify只覆盖文档中声明的 Markdown 子集与不变量,不证明语义等价,也不能自动判断所有句内关系或指代。PDF/OCR 结果依赖本机工具和语言包;缺少工具时必须说明未执行。