吸T神功（XiT）

吸T神功（XiT）是一个帮 AI 编程工作流省 token、减少噪音、提升命中率的 VS Code 插件。

当 go test -v ./...、npm test、docker logs、tsc、eslint 这类命令输出太长时，吸T神功会先对高噪音输出进行压缩，再交给 Claude、Codex、Gemini、Cursor 等 AI 编程工作流使用，避免上下文被无效输出占满。

核心价值

省 token — 把高噪音命令输出压缩后再交给 AI
减少噪音上下文 — 只保留关键信息
提升 AI 回答命中率 — 噪音越少，AI 越容易给出准确答案
支持 Claude Code、Codex、Gemini Code Assist、Cursor、VS Code Chat
本地处理 — 不上传云端
无遥测
无网络请求

安装前提

需要单独安装 XiT CLI。 本插件不内置 XiT 二进制文件。

npm install -g xitsg

或从 GitHub Releases 下载。

插件会自动从以下位置检测 xit：

系统 PATH
~/.local/bin/xit
工作区 ./xit

也可以通过设置 xit.binaryPath 指定自定义路径。

命令

命令	作用
`XiT: Run Command`	检测命令是否高输出，如果是则用 `xit auto` 运行
`XiT: Run with Auto Compression`	始终用 `xit auto` 运行命令
`XiT: Open XiT Terminal`	打开名为 "XiT" 的专用终端
`XiT: Open Dashboard`	打开产品化 Dashboard，首屏展示状态、Latest Saved、Today Saved、Workspace Total、Adapter Health
`XiT: Refresh`	刷新状态栏
`XiT: Show Gain`	弹出累计节省摘要
`XiT: Open Latest Raw Log`	打开工作区 `.xit/runs/` 中最新的原始日志
`XiT: Show Output Channel`	显示 XiT 扩展调试输出
`XiT: Install Workspace AI Rules`	在当前 workspace 的 AI 规则文件里幂等写入 XiT 命令输出规则
`XiT: Diagnose AI Workflow`	输出当前 workspace 的 XiT CLI、最近 run、saved bytes、rules、routing hit rate 报告
`XiT: Verify AI Agent Routing`	验证本地 AI agent 规则文件和最近高噪音命令是否真的通过 XiT 路由

状态栏含义

状态栏	含义
`吸T神功 · 准备就绪`	插件已启动，等待任务
`吸T神功 · 守护你的T`	当前工作区已启用 XiT 规则
`吸T神功 · 正在吸T中`	正在接管高噪音命令输出
`吸T完成 · 省~9k Token`	本次命令已完成，节省约 9k Token
`吸T神功 · 等待下轮发功`	本轮完成，等待下一次任务
`吸T神功 · 无需发功`	当前命令不需要 XiT 介入
`吸T神功 · 未找到 XiT`	没找到本地 XiT CLI

鼠标悬停在状态栏上可查看更多信息，包括最近一次吸T节省、原始日志路径，以及当前工作区是否处于守护状态。运行中主状态栏只显示“正在吸T中”；任何当前输出估算都不会在主状态栏里冒充实际节省结果。

XiT CLI 在运行 xit auto 时还会把当前 active run 写到工作区 .xit/state/current-run.json（兼容保留 .xit/state/current.json）。扩展优先监听这个 state 文件来感知 running / completed 状态，再用 .xit/history.jsonl 做完成态与历史回放兜底。

Dashboard 0.0.17

深色工具风 Dashboard，黑金 accent，本地完全无遥测。默认首屏显示：

Current Status
Latest Saved
Today Saved
Workspace Total
AI Adapter Health 卡片
Top Token-Heavy Commands 表格

没有真实 run 时（或 state 文件为空）显示温和空状态，不会展示测试命令。调试信息如 binary path、workspace cwd、attempted paths、VS Code terminal events 已移入默认折叠的 Advanced / Debug 区域，低层警告也仅在此显示。

边界说明： 吸T神功不会读取 AI 聊天内容，也不会读取私有 Webview。它通过本地命令输出、workspace 规则和 .xit 运行记录帮助 AI coding workflow 降噪。

How to verify Codex integration

运行 XiT: Install Workspace AI Rules
打开 Codex 面板
让 Codex 正常运行项目测试，例如 “Run the project tests and follow workspace instructions.”
不要手动输入 ./xit auto
然后运行 XiT: Verify AI Agent Routing
只有当最近的高噪音命令是通过 XiT 执行时，才算 PASS

这个测试只验证 Codex 是否遵守 workspace rules，不验证 XiT 是否读取 Codex chat 内容。

设置

设置	默认值	说明
`xit.binaryPath`	`""`	`xit` 二进制文件路径。为空时自动检测。
`xit.home`	`""`	XiT 主目录。默认为 `~/.xit`。
`xit.refreshInterval`	`5`	状态栏刷新间隔（秒）。
`xit.enableStatusBar`	`true`	显示吸T神功状态栏。
`xit.enableTerminalListener`	`true`	监听 VS Code 终端命令执行，对高输出命令记录本地元数据并辅助计算 XiT 路由命中率。
`xit.showActiveAiSurface`	`true`	在 tooltip / Dashboard 显示最近的本地 XiT 工具来源记录。

隐私

无遥测
无网络请求
只读取本地 ~/.xit 和工作区 .xit 目录
原始日志仅在手动触发命令时打开
终端监听器只捕获命令元数据（命令行、工作目录、终端名称），不捕获命令输出或环境变量
只展示本地 XiT 事件与终端记录，不读取聊天内容、私有 Webview 或当前对话上下文

Token 估算说明

状态栏、tooltip 和 Dashboard 中的 token 数字默认是估算值
如果 XiT history / gain 已提供 saved_tokens 或 saved_tokens_display，插件会优先使用这些字段
如果没有现成 token 字段，插件会按 bytes / 4 做保守估算
不同 AI 模型的 tokenizer 不同，所以 ~10k Token 应理解为本地近似统计，不是某个模型 API 的精确 billing 数字
这些 token 统计默认只保留在本地工作区和本地 XiT 数据目录，不会上传

从 VSIX 安装

如不从应用商店安装：

npx vsce package

然后在 VS Code / Cursor 中：

命令面板 → Extensions: Install from VSIX...
选择 xit-vscode-*.vsix
重新加载窗口