RE:CZ

CZON开发笔记:链接规范与功能规划

技术日志

👤 软件开发者和技术博客作者,特别是对文档管理和AI辅助工具有兴趣的人群
本文记录了作者在2026年2月9日的开发笔记。作者首先反思了因未及时吃药导致感冒加重的个人经历,随后重点讨论了CZON开发中的技术问题:决定全面拒绝使用相对于项目根目录的绝对路径引用,坚持使用相对引用以提高规范性,并计划通过check命令检查并修复无效链接;针对runOpenCode任务超时问题,作者指出即使使用promptAsync + polling status方法,超过10分钟仍会报600s超时,认为是OpenCode本身问题需解决;此外,作者规划了TODO Summary功能,让AI提取博客中的TODO项并自动标记优先级,以提升工作效率。
  • ✨ CZON应全面拒绝使用相对于项目根目录的绝对路径引用,坚持相对引用
  • ✨ 计划添加check命令检查文档链接有效性,支持自动修复
  • ✨ 规划TODO Summary功能,让AI提取博客TODO并自动标记优先级
📅 2026-02-09 · 800 字 · 约 3 分钟阅读
  • CZON
  • 链接引用
  • TODO功能
  • 开发笔记
  • AI应用

现在是 2026 年 2 月 9 日,下午。

今天又有些身体不适,前几天有些感冒的时候,就应该及时吃药,结果这几天不仅疲惫易乏。当时不吃感冒药的原因是觉得吃完感冒药会想睡觉,浪费时间。结果不止损的后果更加严重,这波赌输了。

言归正传,昨天用 CZON + Opus 4.6 做了一版本的博客总结,里面有些链接是失效的,归根结底是我的 prompt 里有 bug,没有给对正确的指令。

不过,我认为不能指望 AI 能够一次性遵循你的所有指令,这是 AI 非强制协调 的物理特性。

我一开始在想,是否要在 CZON 中支持相对于项目根目录的绝对路径引用?但是后来觉得还是不太合适,因为我已经决定 .czon/src/<lang>/ 目录也是一个完全合法的分形目录,里面的每一个文件之间的相互引用都应该完全有效,里面的图片、超链接都应该是有效的。

因此,CZON 应该全面拒绝使用相对于项目根目录的绝对路径引用,坚持使用相对引用。尽管 VSCode 可以支持这种引用方式,但是我认为这不够规范,无法精确地表达引用语义。这是一个不可靠的引用方式,应该被摒弃。

这种拒绝会带来一些兼容问题,比如你会发现一些老的文档中的链接是失效的。不过一个相对好的解决方案是,CZON 提供一个 check 命令,专门用来检查文档中的链接是否有效。如果发现无效链接,可以给出警告,并提供修复建议,甚至执行自动修复 (--fix 选项)。修复建议可以直接喂给 AI Agent 执行修复。修复完了以后重新执行 build 命令即可。

另外,运行长时间的 runOpenCode 任务时,仍然会报错 600s 超时,我已经使用了 promptAsync + polling status 的短方法,但是一个任务如果运行时间超过 10 分钟,仍然会报 600s 超时。我认为这是 OpenCode 本身的一个问题,我接下来会尝试解决这个问题。

再一个,我认为我需要一个 TODO Summary 功能,帮我把我所有博客中的 TODO 都提取出来,生成一个 TODO List 文档,方便我统一查看。这是一个很有意思的功能点,我会让 AI 去阅读所有的博客内容,判断我的 TODO 是否完成,然后我每天可以去查看这个 TODO List,看看我现在应该做什么了。

还有一个好玩的事情,既然 AI 已经可以审视我心里的 价值观排序 了,那么它还可以自动帮我标记出这些 TODO 的优先级,岂不美哉?

See Also

Referenced By