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

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

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

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

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

01 用户描述问题 Bug、现象、日志或目标
02 AI 决定取证选择搜索词、文件和范围
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 源码；默认不改代码，需要时每一步都可见、可控、可回滚。

←→Space F 全屏