txcodex
← → / Space 切换 · F 全屏
Local AI Coding Agent

让 AI 真正读懂
你的本地源码

面向 Android、AOSP、Vendor、Kernel 与驱动项目的轻量命令行助手。AI 负责判断下一步，本地工具负责搜索、读取、验证与最小化修改。

Windows / Linux · CLI · 人工可控
01
Why txcodex

大型源码，靠一次提问不够

01用户描述问题Bug、现象、日志或目标
02AI 决定取证选择搜索词、文件和范围
03本地执行动作跨平台搜索与分段读取
04结果返回 AI继续追踪调用链和根因
05结论或补丁优先省时间的最小改动

不是把整个工程塞给模型，而是形成可持续的“分析 → 取证 → 决策”循环。

Capabilities

围绕源码排查设计的能力

01 · DISCOVER
工程概况

识别 Android、AOSP、Kernel、Vendor 等目录和关键构建标记。

02 · SEARCH
跨平台搜索

优先使用 ripgrep；没有 rg 时自动回退 Python，Windows 不依赖 grep。

03 · READ
按需读取

只读取关键文件片段，终端仅记录文件名、行号与读取数量。

04 · HISTORY
Git 文件历史

统计修改者、查看提交、追踪指定行作者与某次 commit 的 diff。

05 · PATCH
最小补丁

展示彩色 diff，确认后写入；同一文件仅首次授权。

06 · LOG
Android 日志协作

按崩溃、ANR、Framework、Kernel 场景给出可直接执行的抓 log 指令。

Two Modes

默认稳妥，需要时再动手

默认模式方案 / 复查

AI 可以搜索和读取，但不写文件。它会告诉你在哪段代码下增加或替换什么；你手动改完输入 ok，AI 再读取源码复查。

/plan on不写文件
按需开启自动执行

AI 可以提交最小补丁。txcodex 先展示 diff 与行数统计，首次修改该文件必须由用户确认，随后才会写入并备份。

/plan off修改前确认
Trace the Why

用 Git 历史帮助定位 Bug

  • 这个文件一共有多少人修改过？
  • 最近哪些提交改变了它？
  • 第 120–160 行最后是谁修改的？
  • 某个 commit 对文件具体改了什么？

全部为只读查询，不提交、不切换分支、不修改工作区。

txcodex › 这个文件有多少人改过，主要改了什么？ Git 历史： app_picker_ui.c 历史提交：4 修改者：2 3 次 Jakob Krantz 1 次 David Buxton 需要细节时继续查看 commit diff 或 blame。
Controlled Changes

每次修改都有退路

✓
写入前校验

OLD 必须真实存在且唯一；拒绝嵌套协议文本、异常编码及超过 120 行的大补丁。

↶
可追踪、可回滚

自动备份、保存完整 diff 与 SHA-256；文件被人工继续修改后，回滚会主动停止。

/diff
查看本次会话仍生效的修改
/undo
回滚最近一次补丁，重启后仍可用
Quick Start

三步开始使用

  1. 在传音 AI 页面使用篡改猴导出 txcodex.json。
  2. 将 JSON 放到 txcodex.exe 同目录，或放在工程目录/父目录。
  3. 进入要分析的源码根目录，启动 txcodex。
# Windows PS> C:\tools\txcodex.exe --new-topic # Linux / Python 源码版 $ python3 /opt/txcodex/txcodex.py txcodex › 帮我定位 SystemUI 启动崩溃 txcodex › 搜索 panel probe failed 相关驱动
Daily Commands

常用命令一页掌握

/status工程、模型、topic、模式
/newtopic [标题]新建干净对话
/topics管理 txcodex 远端记录
/plan on | off切换方案/执行模式
/diff [文件]查看生效补丁
/undo [文件]回滚最近修改
/save [报告.md]导出审计报告
/logs查看 Android 抓日志方法

支持多行粘贴：Enter 发送，F2 / Ctrl+O 插入换行。超过 20,000 行时会截断并建议改用 txt/log 文件。

Example Session

一次典型的 Bug 排查

txcodex › 滑动桌面时图标没有随距离缩放，帮我定位 round 1 搜索 app picker、gesture、scale round 2 读取生成布局和业务 UI round 3 查询相关文件 Git 历史 round 4 定位事件回调与缩放 API AI 提议修改： app/src/ui/app_picker/app_picker_ui.c 变更统计：+18 / -3 允许本次会话修改这个文件？ [y/N] 用户： y 结果： 已备份、写入并记录 diff
txcodex

把时间留给判断，
把取证交给工具。

轻量、跨平台、面向大型 Android 源码；默认不改代码，需要时每一步都可见、可控、可回滚。

←→SpaceF 全屏