先交代一件刚查清修好的事：09-02 起 CI 红不是我们的代码问题。litellm 1.98.0 引入的 compact.py 在 Python 3.10 下 from typing import NotRequired 直接 ImportError（NotRequired 是 3.11 才有的名字），1.98.0 到 1.100.0 三个版本的顶层 import litellm 在 3.10 全崩，上游 issue #38892 在案，main 已修但未发版。已在 pyproject 排除这三个版本（回退到 1.97.0，3.10 实测 import 正常、768 测试全绿），等上游出修复版再放宽。这种"上游一个 import 崩掉你整个 CI"的事值得在 README 留个排查笔记。
然后是定位问题，这个得诚实面对。
CodeABC 现在的卖点是"给非程序员的 AI 代码阅读器"：文件导读说人话、悬停注释、术语词典、问答、自然语言改代码。768 个测试全绿，技术是立住的。但 14★ 说明传播和定位没跟上。接下来按这个顺序做：
一、把目标用户钉死。 "非程序员"太宽。先选定一类：要看懂外包/合作方代码的产品经理。README 首屏换成这个场景：他拿到一个从没见过的仓，10 分钟内要回答"这个仓能不能加导出 Excel 功能"。所有功能描述围绕这条主线重写给非技术人员看的话。
二、三分钟可感知的 demo。 录屏：打开一个真实开源仓 -> 点一个文件 -> 人话导读出来 -> 悬停看术语 -> 问一个问题得到带文件引用的回答。放 README 最顶上。现在 README 是功能列表，没有"哇"时刻。
三、术语词典和悬停的覆盖率打磨。 非程序员卡住的第一关不是架构是术语。把 Python/JS 常见术语的注释覆盖率提上来，响应速度压在 200ms 内。
四、差异化写清楚。 对 DeepWiki（给工程师的 wiki）、Code Tour（给工程师的导览）、各类源码导读插件，我们的差异只有一条：假设读者完全不会写代码。README 里放一张对标表，不回避。
技术上没有大重构计划，先把"给谁用、解决什么"讲明白再谈功能扩张。如果你恰好是目标用户（产品/运营/学生），试用后的吐槽最值钱。
先交代一件刚查清修好的事：09-02 起 CI 红不是我们的代码问题。litellm 1.98.0 引入的
compact.py在 Python 3.10 下from typing import NotRequired直接 ImportError（NotRequired 是 3.11 才有的名字），1.98.0 到 1.100.0 三个版本的顶层import litellm在 3.10 全崩，上游 issue #38892 在案，main 已修但未发版。已在 pyproject 排除这三个版本（回退到 1.97.0，3.10 实测 import 正常、768 测试全绿），等上游出修复版再放宽。这种"上游一个 import 崩掉你整个 CI"的事值得在 README 留个排查笔记。然后是定位问题，这个得诚实面对。
CodeABC 现在的卖点是"给非程序员的 AI 代码阅读器"：文件导读说人话、悬停注释、术语词典、问答、自然语言改代码。768 个测试全绿，技术是立住的。但 14★ 说明传播和定位没跟上。接下来按这个顺序做：
一、把目标用户钉死。 "非程序员"太宽。先选定一类：要看懂外包/合作方代码的产品经理。README 首屏换成这个场景：他拿到一个从没见过的仓，10 分钟内要回答"这个仓能不能加导出 Excel 功能"。所有功能描述围绕这条主线重写给非技术人员看的话。
二、三分钟可感知的 demo。 录屏：打开一个真实开源仓 -> 点一个文件 -> 人话导读出来 -> 悬停看术语 -> 问一个问题得到带文件引用的回答。放 README 最顶上。现在 README 是功能列表，没有"哇"时刻。
三、术语词典和悬停的覆盖率打磨。 非程序员卡住的第一关不是架构是术语。把 Python/JS 常见术语的注释覆盖率提上来，响应速度压在 200ms 内。
四、差异化写清楚。 对 DeepWiki（给工程师的 wiki）、Code Tour（给工程师的导览）、各类源码导读插件，我们的差异只有一条：假设读者完全不会写代码。README 里放一张对标表，不回避。
技术上没有大重构计划，先把"给谁用、解决什么"讲明白再谈功能扩张。如果你恰好是目标用户（产品/运营/学生），试用后的吐槽最值钱。