jevbooks

← 全部项目

docfriction

Cyvid7-Darus10/docfriction

使用 TypeSafe Jev 逐节评分,为在线文档自动生成摩擦日志。

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

去 GitHub 看

开始使用 Jev:API key 与第一个请求 →

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
信号
Jev 是项目的核心0.92展示了 System One 用法0.65写了怎么处理不确定0.04给出了实测数字0.04是能跑起来的工具0.96学习案例 Top 10 候选信号0.21是模型本身的复刻0.0400.51解决的问题够普遍(0–2)1.25 / 2012

无判定区(0.40–0.60)

设计模式
信号灯0.97问卷0.96题库0.85灰区0.76验货0.74漏斗0.73记分卡0.59盲审0.45恒温器0.21常开常闭0.2000.51

无判定区(0.40–0.60)

各阶段的 Jev 模型与判定日期见上方记录。简介由 DeepSeek V4.1 Flash 于 2026年9月20日 读 README 写成。