README 自动摘要
根据 README 自动整理于 2026年9月20日,不是本站运行记录。运行步骤和作者声称的效果仍需核验。
这是什么
docfriction 为在线文档页面生成摩擦日志,逐节遍历并询问 TypeSafe Jev 一组固定的类型化问题。它面向希望发现读者卡点的开发者关系人员和文档作者。
它怎么用 Jev
对于每个章节,Jev 回答一个 Choice 问题(涵盖十种摩擦类型以及 no_friction 和 other),一个 Score 问题(四种读者结果,用于评估严重程度),以及若干 Noul(是/否)检查,涉及前提条件、预期结果、未定义术语、代码与正文匹配以及未解释的占位符。概率通过阈值转化为发现项;不确定的答案标记为“需要审查”。
用到的原语:choicescorenoul
值得抄的做法
使用类型化问题(Choice、Score、Noul)结合概率和阈值,将主观的文档摩擦转化为确定性的、可在 CI 中设门的发现项。
怎么试
uv tool install docfriction; docfriction https://docs.example.com/quickstart --dry-run; export TYPESAFE_API_KEY=...; docfriction https://docs.example.com/quickstart
README 片段的模型判断
项目信号使用仓库元信息、已有摘要与 README 前 700 个字符;没有通读完整项目。“未检出”仅表示这些材料中未检出,并不证明项目没有该能力。这里保留原始判断与实际记录的模型、日期,不是源码审计或运行验收。
模型与判定日期
- 收录门禁
jev-1.13.0- 项目信号
jev-1.13.0- 项目分类
jev-1.13.0- 模式标签
jev-1.13.0
证据
这些信号只读取仓库元信息、已有摘要与清理后的 README 前 700 字符。≥ 0.60 表示片段中有提及,≤ 0.40 表示未检出,中间为未判定;都不是源码审查或运行结果。「可运行工具」题排除了研究实验,「推荐」题筛的是学习案例 Top 10,不是内容质量合格与否。
- Jev 是项目的核心在材料中检出0.92
- 展示了 System One 用法在材料中检出0.65
- 写了怎么处理不确定片段中未检出0.04
- 给出了实测数字片段中未检出0.04
- 是能跑起来的工具在材料中检出0.96
- 学习案例 Top 10 候选信号片段中未检出0.21
- 是模型本身的复刻片段中未检出0.04
- 解决的问题够普遍(0–2)按 0–2 打分1.25 / 2
- 与 Jev 相关在材料中检出0.97
无判定区(0.40–0.60)
无判定区(0.40–0.60)
各阶段的 Jev 模型与判定日期见上方记录。简介由 DeepSeek V4.1 Flash 于 2026年9月20日 读 README 写成。