显示 HN：CodeAlmanac – 来自您的对话的 Karpathy 风格的代码库 wiki

CodeAlmanac 代码库的动态 wiki，由 AI 编码代理维护。 CodeAlmanac 为 AI 代理提供了仅靠代码无法容纳的上下文：为什么系统是这样形成的、之前发生了什么故障、哪些不变量很重要，以及工作流程如何跨文件和服务。 wiki 是您的存储库中的简单 Markdown，在本地建立索引，并像任何其他代码更改一样在 Git 中进行审核。今日支持：带有 Codex 或 Claude Code 的 macOS。需要 Python 3.12+。快速入门 uv 工具安装 codealmanac@最新 codealmanac 设置 请参阅设置以了解配置选项。一旦 CodeAlmanac 设置完毕： cd your-repo codealmanac init # 创建你的 wiki，如果你没有一个 codealmanac 搜索“入门” # 显示匹配的 wiki 页面。 codealmanac show getting-started # 在终端中打开一个页面 codealmanacserve # 在本地 Web 查看器中显示 wiki。安装程序为您使用的本地工具安装全局代理说明： # 交互式安装 codealmanac setup # 使用推荐的默认值快速安装；使用 Codex 作为 AI 运行器 codealmanac setup --yes # 使用 Claude 作为 AI 运行器进行快速安装 codealmanac setup --yes --runner claude 安装程序会为您选择的工具和三个本地 macOS 启动作业安装代理指令。作业和所有 wiki 工作都在本地运行。作业 默认计划 作用 每 5 小时同步 扫描最近的 Codex 和 Claude 对话，并排队相关注册 wiki 的有用知识。 Garden 每 24 小时 审查每个注册的 wiki 是否有陈旧、重复或关联性较差的知识。每 24 小时更新一次 在安全的情况下检查并安装 CodeAlmanac CLI 更新。这些计划在本地后台运行。使用 codealmanac 自动化状态查看安装的内容。最后的设置步骤询问匿名遥测并建议选择“是”，这样我们就可以看到哪些命令有效以及 CLI 在哪里中断。它会在随机安装 UUID 下发送受控命令和生命周期结果以及已清理的未处理崩溃。它从不发送代码、路径、参数、查询、提示、记录、存储库/运行 ID、本地变量或凭据； GeoIP 已禁用。在 setup 中选择 No，传递 setup --no-telemetry ，将 telemetry.enabled 设置为 false ，或随时使用 DO_NOT_TRACK=1 。如果以后没有登录，UUID 配置文件就没有姓名或电子邮件。如果您没有 Codex 或者更喜欢 Claude，请使用 --runner claude 。 --target 只选择安装哪些全局代理指令文件；它不会选择 AI 运行器： codealmanac setup --yes --target codex codealmanac setup --yes --target claude 在设置过程中自定义自动工作： # 更改扫描最近代理对话的频率 codealmanac setup --yes --sync-every 5h # 不安装自动转录同步 codealmanac setup --yes --sync-off # 不安装自动 wiki 清理 codealmanac setup --yes --garden-off # 不安装自动 CodeAlmanac 更新codealmanac setup --yes --no-auto-update 要卸载 CodeAlmanac 拥有的本地工件： codealmanac uninstall --yes Daily Read Surface 代理和人类使用相同的本地读取命令： codealmanac search " checkout timeout " codealmanac search --mentions src/checkout/ codealmanac show checkout-flow codealmanac Topics codealmanac health codealmanac validate 使用 --wiki 读取另一个已注册的本地 wiki。默认情况下，当当前目录是已注册的存储库根目录时，命令会针对确切的当前目录。更新 Wiki 生命周期命令通过公共 Yoke SDK 运行三个显式代理之一：构建、摄取或花园。现有的打包提示文件仍然是完整的任务说明，并指导代理编辑 almanac/ 下的 wiki。生命周期代理是值得信赖的本地编码代理。它们使用 CodeAlmanac 历史上提供的相同广泛的非交互式文件系统权限运行，因此 almanac/ 边界是指令和提交策略，而不是操作系统沙箱。仅在接受该信任模型的存储库中运行生命周期命令，并在禁用自动提交时查看生成的 Git diff。 codealmanac ingest README.md --使用 codex codealmanac ingest github:pr:123 --使用 claude codealmanac 花园 --使用 codex ingest 将选定的本地材料折叠到 wiki 中。输入可以包括文件、目录、Git diff、提交范围、GitHub PR 或问题、URL 和本地代理记录。 Garden 改进了现有的 wiki 图表：过时的页面、链接、主题、薄弱线索、重复页面和不受支持的声明。无操作有效。如果该材料没有添加持久的 wiki 知识，那么该工具应该使 wiki 保持不变。 init 、 ingest 和 Garden 创建排队运行并启动本地工作线程。要直观地跟踪它们，请运行 codealmanacserve 并选择侧栏中的“作业”。要留在终端中，请使用 codealmanac jobs Attach 。同步和自动化 CodeAlmanac 可以使已注册的 wiki 保持最新状态，而无需您记住维护命令。同步会扫描本地 Codex 和 Claude 转录存储，以查找自上次完成同步以来的活动对话。骗局