PURPOSE

围绕具体任务

页面内容围绕工具用途、操作步骤和结果解释组织。

REVIEW

按改动选择检查

工具测试、浏览器检查与元信息审计的覆盖范围随改动而异。

CORRECTIONS

错误优先处理

结果不正确、描述误导、隐私说明与使用边界问题会优先进入纠错流程。

QUALITY

补充缺失信息

优先补充影响实际使用的案例、适用范围和失败样例。

1. 发布内容与维护主体

ToolsKit 由 Evan 个人开发和维护,发布在线工具、操作指南与开发实践文章。维护者负责内容选择、页面修订和问题反馈处理。

以下原则用于指导新增与修订内容:说明页面用途,并按主题补充使用步骤、输入输出、适用范围、常见错误或资料来源。页面的具体证据和验证范围,以该页列出的条件与限制为准。

2. 内容维护与检查方式

  1. 01

    先定义页面要解决的问题

    明确页面目的、目标用户、关联工具和语言版本。

  2. 02

    补足可执行信息

    在功能介绍之外,优先加入步骤、案例、错误样本、判断边界、修复动作或核对清单。

  3. 03

    选择相关检查并说明范围

    根据改动选择自动化测试、浏览器检查或资料核对;检查通过只代表覆盖的条件,不代表所有工具、浏览器或环境均经过验证。

  4. 04

    根据反馈安排修订

    按已确认问题的影响和可复现情况安排修订。更新时间用于记录内容变更,不代表每项功能都重新测试。

3. 页面质量目标

用途明确

用户能在首屏快速判断:这个页面到底解决什么问题。

过程可执行

至少能看到步骤、输入输出关系、或问题排查路径,而不是只剩定义。

边界可见

页面应说明什么时候适用、什么时候不适用,以及常见误判点。

可复核

关键页面需要更新时间、反馈入口或其他能说明持续维护的迹象。

4. 什么会触发修订

  • 页面只剩工具功能介绍,几乎无法支撑独立完成任务。
  • 不同页面出现大段结构重复,但没有新的案例、判断边界或场景差异。
  • 搜索意图虽明确,但页面没有解决用户最常见的错误输入或失败场景。
  • 工具行为、外部规范或依赖变化后,页面说明已经不再适用。

5. 如何补充不足的内容

内容长度本身不能说明是否有用。修订时关注页面能否回答具体问题:用户该输入什么、如何理解结果、什么情况下不适用,以及下一步如何核对。

  • 指南应围绕主题说明关键操作与判断依据,避免仅重复通用定义。
  • 工具页优先补充失败样例、使用场景、诊断逻辑和结果解释。
  • 已知缺陷需要说明限制或安排修复;无法提供有效帮助的页面应考虑合并或撤下。

6. AI 辅助内容的使用边界

维护过程中可能使用 AI 辅助草稿、代码、结构整理或翻译,发布责任仍由维护者承担。复核重点包括技术事实、引用来源、样例结果和中英文表述。AI 生成的结论本身不作为验证证据;涉及实际体验或评测时,应区分保存的记录、演示样例和作者判断,并说明已知限制。

7. 纠错与责任归属

页面由维护者 Evan 负责。请通过联系页或 [email protected] 提交页面地址、复现步骤与预期结果,避免附带敏感数据。维护时优先处理结果错误、误导性说明、隐私说明和操作阻断问题;修订安排取决于影响与可复现情况,没有固定更新周期。