爱意满满的作品展示区。
fankcoder

[codex 插件分享] 让 codex 更快、更省 token 的理解项目

  •  
  •   fankcoder ·
    fankcoder · 21h 53m ago · 398 views

    我在 vibe coding 的过程经常要在同一个项目中增加多个会话,

    比如同一个项目开发不同的功能,或者让专门的会话去做部署运维的相关工作,

    这里就涉及到智能体经常需要反复读取项目代码,尤其是开发的时候,我还会担心新会话会不小改了不相干的代码,把正常的代码改坏。

    然后我习惯在每个新会话里面,在开发功能之前写一句“先熟悉这个项目,熟悉好回复我完成即可”

    但是长期这样依然存在问题:

    1.浪费 token

    2.多个会话开发多次之后依然可能出现乱改代码的情况。

    然后我做个了 codex 插件,让它在省 token 的前提下帮我来管理不同会话对项目的最新理解。

    它的自我介绍:

    Project Map 是一个零依赖的 Codex 插件,可以自动遍历项目目录,分析代码模块关系、入口、类、函数及依赖树,并生成 Markdown 项目地图。

    它会通过 Git commit 和 SHA-256 文件指纹验证地图是否过期,并支持增量更新:只重新分析新增或修改的文件,复用未变化文件的缓存。地图只作为导航索引,修改代码前仍会要求读取当前源码。

    GitHub: https://github.com/fankcoder/project-map

    目前仅支持 Python 、JavaScript 和 TypeScript 后续会更新支持更多的语言


    安装为 Codex 插件的方法

    
    先注册仓库 marketplace:
    
    codex plugin marketplace add https://github.com/fankcoder/project-map.git
    
    查看 marketplace:
    
    codex plugin marketplace list
    
    启动 Codex:
    
    codex
    
    然后输入:
    
    /plugins
    
    找到 Project Map Development ,安装 project-map 。安装后开启新的 Codex 会话。
    
    之后可以明确要求:
    
    使用 project-map 分析当前项目,然后开始任务。
    
    或者显式调用:
    
    $project-map
    
    插件会自动:
    
    1. 检查 .codex/project-map.md 是否存在;
    2. 检查源码哈希和项目版本是否匹配;
    3. 地图不存在时完整生成;
    4. 地图过期时执行增量更新;
    5. 先读取项目摘要和变更摘要;
    6. 再定位相关模块和源码;
    7. 修改前重新读取当前源码,而不是盲目信任地图。
    
    建议把项目地图加入目标仓库的 .gitignore:
    
    .codex/project-map.md
    .codex/project-map.manifest.json
    
    如果团队希望共享架构索引,也可以不忽略它们,提交到 Git 仓库。官方插件安装规则是:通过 marketplace 安装后,需要开启新 Codex 会话才能使用插件技能。
    
    
    No Comments Yet
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   1301 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 19ms · UTC 23:50 · PVG 07:50 · LAX 16:50 · JFK 19:50
    ♥ Do have faith in what you're doing.