uiu

一个最小可跑的个人 IP agent 骨架。借鉴 Hermes Agent 的 SOUL/skills/memory 模式，但砍到只剩核心。

它能做什么

• 跟你多轮对话，记住上下文（同一会话内；/save 可跨会话 resume）。
• 自动调用 68 个内置工具（文件/shell/后台进程/屏幕 OCR/桌面控制/宏录制回放/系统/微信/输入法/子 agent 派发/联网搜索/浏览器/MCP 动态工具…）。
• skill 渐进披露：system prompt 只带索引，用 skills_list / skill_view 按需取全文。
• cron 定时任务：到点自动跑 agent 并落盘（uiu serve 内每 60s tick）。
• 不确定就反问：clarify 工具阻塞等你回答再干活。
• 你的"人设"写在 workspace/SOUL.md 里——改它，agent 就变样。
• 长记忆写在 workspace/MEMORY.md——对话里 /memory <note> 一键追加。
• 自我学习（Hermes learning loop）：主动记记忆、沉淀技能、改进技能。
• 屏幕自动化（OCR，免视觉模型）：说"点提交按钮"它就能点。
• 完整 CLI：配置模型（34 provider）、加 skill、加 channel（Telegram/飞书/企微/钉钉/Discord/Slack）、更新代码。
• 可发布到 PyPI：uiu publish 一行构建 + 上传，全世界 pip install uiu。

屏幕自动化（OCR 点击，不需要视觉模型）

"帮我点击网页上的提交按钮"     → agent 调 click_text
"屏幕上现在有什么？"           → agent 调 screen_read_text
"输入用户名然后点登录"          → click_text + type_text + click_text

技术链路：PyAutoGUI 截图 → RapidOCR 识别中文文字 → 按文本找坐标 → PyAutoGUI 点击。 不需要视觉模型，纯 OCR 定位——中文识别准确率 99%+。

工具：

工具	干嘛
click_text	点击屏幕上指定文字的按钮/元素
screen_read_text	读取整个屏幕的可见文字
type_text	在当前输入框输入文字
press_key	按键/组合键（enter、ctrl+s）

Windows 桌面控制（通用 GUI 原子操作 + 微信闭环）

"切到微信"                 → agent: window_list + window_focus
"显示桌面"                 → agent: keyboard_shortcut(['win', 'd'])
"打开资源管理器"           → agent: app_launch('explorer')
"点任务栏的 Chrome"        → agent: screen_ocr_find + mouse_click_at
"现在开着什么窗口？"        → agent: window_list
"给文件传输助手发消息"      → agent: send_wechat（8 步闭环，见下）

工具：

工具	干嘛
window_list	列出所有可见窗口（标题/HWND/位置）
window_focus	按标题关键字置顶激活窗口
app_launch	启动程序/打开文件/URL（无 shell 解析，防注入）
screen_ocr_find	屏幕找字返坐标（可滚动查找）
mouse_click_at	按绝对坐标点击（含双击）
mouse_scroll_at	指定位置滚轮
text_paste	剪贴板粘贴中英文（防输入法干扰）
keyboard_shortcut	组合键/单键（校验合法键名）
send_wechat	微信 8 步闭环发送（定位→双击弹窗→标题核对→粘贴→输入区核对→发送→聊天区核对，任一步失败即停）

系统管理（7 个系统工具）

"电脑卡不卡 / 内存多大 / 还有多少电"  → system_info
"帮我关机 / 重启 / 睡眠"              → shutdown（需确认）
"网通不通"                            → check_network
"我复制了什么"                        → clipboard_get
"打开哔哩哔哩 / 搜索今天的新闻"        → open_url
"截个图"                              → take_screenshot

工具	干嘛
system_info	CPU/内存/磁盘/电池/开机时长（实测：31GB 内存、97% 电量、3 磁盘）
shutdown	关机/重启/注销/睡眠（必须先确认）
check_network	ping 测试（实测 baidu 34ms）
clipboard_get/set	读写剪贴板
open_url	浏览器打开网址或搜索
take_screenshot	截屏存桌面

宏录制回放（按键精灵式，AI 可生成宏）

"帮我把这个操作录成宏"          → agent 调 macro_record（F9 结束）
"跑一下填表宏"                   → agent 调 macro_play（执行前确认）
"写个宏：每 5 分钟点一次刷新"    → agent 直接生成宏 JSON 文件再回放

把重复性 GUI 劳动变成可复用宏：录制一次人工操作（点击/按键/滚轮），之后随时一键回放。 区别于按键精灵的地方：宏是 workspace/macros/<name>.json 纯文本——AI 可以直接读写生成宏， 你说需求它就写出步骤序列，再自动执行。

工具	干嘛
macro_record	录制宏（F9 停止；只记点击/按键/滚轮 + 间隔，不记鼠标轨迹）
macro_play	回放宏（甩鼠标到左上角或按 F9 可紧急中止）
macro_list	列出宏
macro_remove	删除宏

CLI：uiu macro record 填表 --desc "登录后填表" / uiu macro play 填表 --speed 2 / uiu macro list。

宏文件可直接编辑或由 AI 生成（步骤类型：click/key/type/wait/scroll/hotkey，各带 delay_before 间隔）。

工具全景（68 个，19 组）

类	工具
基础	shell_exec / read_file / write_file / read_spreadsheet
后台进程	proc_run / proc_log / proc_kill / list_procs（耗时命令不阻塞）
自学习	memory_add / memory_recall / memory_replace / memory_remove / skill_create / skill_improve
skill 索引	skills_list / skill_view（渐进披露，按需取全文）
会话检索	session_search（跨已存会话关键词检索，零 token 秒回）
宏录制	macro_record / macro_play / macro_list / macro_remove（按键精灵式，AI 可生成宏）
澄清	clarify（反问用户并阻塞等回答）
屏幕 OCR	click_text / screen_read_text / type_text / press_key / ocr_region / click_in_region
桌面	window_list / window_focus / app_launch / screen_ocr_find / mouse_click_at / mouse_scroll_at / text_paste / keyboard_shortcut
系统	system_info / get_time / shutdown / check_network / clipboard_get/set / open_url / take_screenshot
联网	web_search（DuckDuckGo，零配置） / web_extract（正文抽取）
浏览器	browser_open / browser_navigate / browser_snapshot / browser_click / browser_fill（后四个需 pip install playwright） / browser_use（AI 自主操作，需 pip install uiu[browser]）
微信	send_wechat（UI 自动化，发送不可撤回，调用前确认）
输入法	ime_state / ensure_english_ime（键盘输入前先查输入法，防中文 IME 吃字母）
子 agent	delegate_task（内建隔离派发，可限工具白名单） / delegate_batch（并行最多8个） / delegate + list_agents（外部 claude/codex CLI）
视觉桌面	look / askui_autopilot（需 pip install uiu[desktop] + 模型 key）
语音	speak / listen / voice_state（需 pip install uiu[voice]；STT 另需 whisper 相关包）
向量记忆	add_memory / auto_embed / recall_semantic / memory_state（需 pip install uiu[rag]，拖 torch ~2GB）
MCP	配置 mcp_servers 后启动自动连接并注入（mcp_*），需 pip install uiu[mcp]

安全边界：文件读写走路径沙箱（系统目录 + .env/密钥文件拒绝，单文件 512KB 上限）； shell_exec 拦截关机/格式化等危险命令；网关 webhook 支持 UIU_GATEWAY_TOKEN 鉴权。

自我学习

agent 内建一套"learning loop"，跨会话累积知识：

工具	干嘛	触发时机
memory_add	追加一条记忆（带时间戳）	用户透露持久偏好/事实时主动记
memory_recall	读回长期记忆（含用量表）	需要跨会话知识时
memory_replace	更新已有记忆	信息过时 / 记忆库超预算需合并
memory_remove	删除某条记忆	记忆作废
skill_create	把成功方法沉淀成 SKILL.md	发现可复用流程时
skill_improve	改进已有技能（追加使用记录）	发现更优做法时

• 记忆有界（3000 字符）：system prompt 带用量表；超 80% 时 memory_add 拒绝写入， 先 memory_recall 看全量 + memory_replace 合并同类——记忆永远是精炼的 curated 文件，不会无限膨胀。
• 会话检索：session_search / /search 在已保存会话里做免费关键词检索（含上下文），跨会话回忆不花 token。
• 压缩前记忆落盘：/compact 把旧轮 LLM 摘要时顺带提炼 [MEMORY] 段写入记忆库，旧轮存档为 auto-compact-* 会话。
• 周期 nudge：每 5 轮对话自动提示 agent"这段有什么值得沉淀的"
• 频率感知建议（Hermes /suggestions usage 来源）：回放 ≥3 次的宏、会话里重复出现的请求主题， 由 /suggestions 建议自动化（宏→定时任务、主题→沉淀宏/skill），accept/dismiss 人工确认，绝不自动创建
• 跨会话：记忆和技能都落盘在 workspace，下次启动还在
• 写进了 SOUL.md 人设：agent 知道该主动学，不用你提醒

安装

pip install uiu            # Python ≥3.10 直接装（Windows 主推）
uiu                        # 第一次运行自动引导：选模型 → 填 key → 进全屏聊天界面

也可以不装全局直接体验：npx uiu-agent（自动携带 Python 运行时；本轮以 PyPI 主路径为准）。

v1.0 起：首次运行不再需要手动 uiu init / uiu config—— uiu 会自动初始化 workspace（默认 ~/.uiu/workspace）、弹欢迎向导帮你配好模型， 并通过连通性测试后才进入对话。旧工作流（uiu init / uiu config / uiu model）仍完全可用。

从源码安装（开发）

git clone https://github.com/GameSheep/uiu-agent.git
cd uiu-agent
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .                    # 仅核心依赖
pip install -e ".[all]"             # 含重依赖（CV/浏览器/RAG/语音/MCP/全渠道）

快速上手

pip install uiu           # ① 安装
uiu                       # ② 首次运行：欢迎向导自动配置模型（DeepSeek/OpenAI/本地 Ollama…）
                          #    配好后自动进入全屏 TUI

# 已有配置的日常用法
uiu init                                        # 手动初始化 workspace（可选）
uiu config --api-key sk-xxx                     # 手动写 API key（可选）
uiu model --set-model deepseek-chat            # 手动换模型
              --set-base-url https://api.deepseek.com/v1
uiu show                                        # 看当前配置
uiu                                             # 进全屏 TUI 开聊（--no-tui 用经典 REPL）

TUI 常用键：Enter 发送 · Shift+Enter 换行 · Ctrl+N 新会话 · Ctrl+E 命令面板 · F1 帮助

完整 CLI 参考

默认行为

uiu                          # 不带参数 → 进全屏 TUI（textual；--no-tui 回退经典 REPL）

init

第一次跑：创建 workspace/ + .env 模板 + 必要目录。

uiu init

show

打印当前生效的配置（model + channels + secrets 状态）：

uiu show

doctor

诊断并修复 uiu 配置问题（OpenClaw doctor 风格；uiu 起不来时先跑它）：

uiu doctor                    # 诊断并列出问题 + 修复提示
uiu doctor --lint             # 只读检查（不改任何东西），有 error 返回 1
uiu doctor --fix              # 逐项确认后自动修复
uiu doctor --fix --yes        # 全自动修复可修项

检查项覆盖：Python 版本 / PyYAML、workspace 完整性（人设文件）、config.yaml 可解析性与结构、 api_mode 合法性、API key 是否存在（自动识别 ollama 等本地 provider 免 key）、 .env 缺失与坏行、channel token 缺失、可选依赖（MCP 等）缺失。 可自动修复：补全 workspace 文件、重置缺失/损坏的 config.yaml（坏文件先备份 .bak）、 纠正非法 api_mode、创建 .env 模板——每项修复后自动重扫确认。

model

交互式切换模型（Hermes 风格）：

uiu model                          # 进入交互向导：选 provider → 选模型 → 填 key → 测试连接

内置 9 个 provider 预设：OpenAI / DeepSeek / Moonshot(Kimi) / Qwen / Ollama(本地) / vLLM(本地) / OpenRouter / SiliconFlow / 自定义。 也可以非交互设置：

uiu model --set-model deepseek-chat
uiu model --set-base-url https://api.moonshot.cn/v1
uiu model --set-api-key-env MOONSHOT_API_KEY
uiu model --set-api-key sk-xxx     # 写入当前 api_key_env 到 .env
uiu model --set-temperature 0.3
uiu model --set-max-tokens 8192

config

管理 secrets（写入 workspace/.env）：

uiu config --api-key sk-xxx                      # 写到 model.api_key_env 那把 key
uiu config --set-secret TELEGRAM_BOT_TOKEN=...   # 任意 key=value
uiu config --list                                # 列出所有 secret（默认打码）
uiu config --list --show-values                  # 明文列出
uiu config --unset-secret TELEGRAM_BOT_TOKEN
uiu config --agent-name 小刃                     # 改 agent 显示名（TUI 顶栏/状态条即时生效）

skills

uiu skills list                                  # 列出已加载 skill
uiu skills search <query>                        # 在 GitHub 搜 skill
uiu skills inspect <owner/repo | url>            # 预览不安装
uiu skills install <owner/repo | github-url>     # 安装（装完即用）
uiu skills install <...> --force                 # 覆盖已存在
uiu skills add my_skill                          # 按模板新建
uiu skills edit my_skill                         # 用 $EDITOR 打开
uiu skills reload                                # 重载磁盘上的 skills
uiu skills path                                  # 打印 skills 目录

安装 skill（从 GitHub）：

# 从知名 skill 仓库装（比如 openai/skills）
uiu skills install openai/skills
uiu skills install https://github.com/openai/skills

# 装特定子目录的技能
uiu skills install https://github.com/owner/repo/tree/main/skills/foo

# 直接装一个 SKILL.md URL
uiu skills install https://raw.githubusercontent.com/.../SKILL.md

安装到 workspace/skills/<name>/，重启 uiu（或 /skills reload）立即生效，agent 马上能用。

channel

管理外部渠道（Hermes 平台 adapter 风格）。内置 adapter：telegram / feishu(飞书) / wecom(企业微信) / dingtalk(钉钉) / discord / slack。

Telegram / Discord（长连接，无需公网）：

uiu channel add tg-main --type telegram
uiu config --set-secret TELEGRAM_BOT_TOKEN=<BotFather 给的 token>
uiu channel test tg-main                         # 调 getMe 验证

uiu channel add dc-main --type discord
uiu config --set-secret DISCORD_BOT_TOKEN=<Discord Developer Portal token>

钉钉（Stream 模式长连接，无需公网）：

uiu channel add dt-main --type dingtalk \
  -o client_id=dingxxx -o client_secret=xxx
uiu channel test dt-main

Slack（Socket Mode 长连接，无需公网）：

uiu channel add sl-main --type slack -o app_token=xapp-...
uiu config --set-secret SLACK_BOT_TOKEN=xoxb-...

飞书（webhook，需公网回调）：

uiu channel add fs-main --type feishu \
  -o app_id=cli_xxx -o app_secret=xxx [-o verify_token=xxx]
uiu channel test fs-main

企业微信（webhook，需公网回调；自建应用消息默认走官方 AES 加密回调）：

uiu channel add wc-main --type wecom \
  -o corpid=wwxxx -o corpsecret=xxx -o agentid=1000002 \
  -o token=<回调 Token> -o aes_key=<回调 EncodingAESKey>   # 配置后启用官方验签+AES 解密
uiu channel test wc-main

配置 token + aes_key（在企微后台"接收消息"设置里）后，/wecom 回调强制走官方 验签与 AES 解密，伪造消息会被拒绝；不配置则退回明文转发（需网关 token 保护）。

通用操作：

uiu channel list                    # 列出所有 channel
uiu channel disable <name>          # 临时关掉
uiu channel enable <name>
uiu channel remove <name>

serve（gateway——核心）

启动网关：所有 enabled 的 channel 并行跑，消息进来 → agent 回复。

uiu serve                # 默认 webhook 端口 8765
uiu serve --port 9000

• Telegram：长轮询 getUpdates，无需公网
• 飞书 / 企微 / WhatsApp：起本地 HTTP server（/feishu、/wecom、/whatsapp），需要把平台的回调地址指向这里（用内网穿透如 ngrok/frp 暴露公网）
• 通用 webhook：任意系统 POST /generic/<channel名> 即变消息源（chat_field/text_field 配字段路径，secret 配校验）
• api_server：POST /api/send {chat_id, text, channel?} 编程外发，GET /api/channels 看在线通道（设 UIU_GATEWAY_TOKEN 后需带 X-Gateway-Token 头）
• 每个 chat_id 独立会话上下文（落盘 sessions/gw-<chat>.json，重启不丢），支持多人群聊/私聊
• 网关内 slash 命令与 TUI 同款（/cron、/sessions 等直接对聊天发）
• cron tick：serve 内每 60s 自动跑到期定时任务，结果进 cron/output/

加 channel（9 种）：telegram / feishu / wecom / dingtalk / discord / slack / whatsapp / email / webhook，通用操作同下。WhatsApp 需 -o phone_id= + WHATSAPP_TOKEN；邮箱需 -o imap= -o smtp= -o user= + EMAIL_PASSWORD（建议应用专用密码）。

Channel 插件：放 ~/.uiu/channels/<name>/__init__.py（继承 BaseChannelAdapter，实现 check/start/send），uiu serve 自动发现。改平台不用改核心代码。

update

uiu update self                                  # 安全更新
uiu update skills                                # 同步默认 skills 到 workspace

安全更新机制： 更新前自动隔离验证（语法检查 + 模块导入测试），验证通过才真正安装。出问题可一键回滚。

publish

uiu publish                          # 构建 + 上传到 PyPI（需要 PYPI_TOKEN）
uiu publish --test                   # 构建 + 上传到 TestPyPI 试水

plugins（provider 插件，Hermes 风格）

uiu plugins list                     # 列出已安装的用户 provider 插件
uiu plugins new my-provider          # 从模板脚手架一个新 provider 插件
uiu plugins path                     # 打印插件目录（~/.uiu/plugins/model-providers/）

插件机制（对齐 Hermes）：

• 插件放 ~/.uiu/plugins/model-providers/<name>/，含 __init__.py（调 register_provider(profile)）+ plugin.yaml（manifest）
• 首次调用时懒发现（uiu model / uiu show 触发）
• 用户插件覆盖内置（last-writer-wins）——改内置 provider 不用动代码
• 加 provider 三步：uiu plugins new my-provider → 编辑 __init__.py 的 base_url/key 名/模型列表 → uiu model 里就能选

version

uiu version

全屏 TUI（v1.0）

uiu 默认进入 textual 全屏聊天应用（OpenClaw 风格），不是脚本式 REPL：

┌────────────────────────────────────────────────────────────┐
│  小刃 · deepseek-chat  C:\Users\you\.uiu\workspace   tools 68 │
├──────────────────────────────────────┬─────────────────────┤
│  你：帮我看看磁盘                       │  （侧栏 ctrl+s 打开）  │
│  小刃：我来查看…（流式 markdown 渲染）    │  /new /save /sessions │
│  ⚙ system_info → ✓ 摘要（单行折叠）      │  /compact /help       │
├──────────────────────────────────────┴─────────────────────┤
│  输入消息…（Enter 发送 / Shift+Enter 换行）                  │
├────────────────────────────────────────────────────────────┤
│  ● idle  agent · model  turns:5  ctx:[███░…]  tools:68      │
└────────────────────────────────────────────────────────────┘

• 消息区：气泡式对话，回复以 markdown 流式渲染（代码/列表/表格实时高亮）；工具调用折叠为单行 ✓/✗ 工具名 → 摘要。
• 多行输入：Enter 发送、Shift+Enter 换行；输入 / 弹出命令补全。
• 快捷键：Ctrl+N 新会话 · Ctrl+E 命令面板（模糊搜所有 slash 命令）· Ctrl+S 侧栏 · Ctrl+R 历史搜索 · Ctrl+L 清屏 · F1 帮助 · Esc 中断回复。
• 不卡顿：agent 回合在后台线程跑，等待回复时仍可滚动/打字/开命令面板。
• 敏感操作内联确认：send_wechat / shutdown / macro_play 触发时弹确认框，绝不静默执行。
• 非交互终端（管道/CI）自动回退经典 REPL；显式需要旧界面用 uiu --no-tui。

TUI 内置命令

在 TUI 内（uiu 不带参数），slash 命令与网关聊天共用同一注册表：

命令	干嘛
/help	帮助
/skills / /skills reload	列出 / 重载 skill
/tools	列出内置工具
/identity	打印 IDENTITY.md
/memory <内容>	追加一行到 MEMORY.md（有界：超 3000 字符预算拒绝并提示合并）
/soul <内容>	追加一行到 SOUL.md
/save [名] / /resume [名]	保存 / 恢复会话（退出重进自动恢复 default；网关会话自动存）
/sessions	列出已保存会话
/search <关键词>	跨已存会话关键词检索（免费秒回，带上下文）
/compact	压缩旧对话：LLM 摘要 + 提炼 [MEMORY] 记忆落盘，旧轮存档 auto-compact-*
/suggestions	自动化建议：常用宏→定时任务、重复请求→沉淀提示（accept/dismiss 人工确认）
/status	状态（模型/会话轮数/上下文用量/工具数）
/usage	上下文用量条
/new	新会话（旧的自动存快照）
/cron …	定时任务（list/add/rm/on/off/run/tick）
/clear	清空对话上下文
/quit /exit	退出

输入框下方常驻状态条（OpenClaw 式）：● idle 模型 turns:N ctx:% tok≈ tools:N skills:M， idle/running/error 变色；回答 token 级流式输出（卡顿时立刻能看见）；工具调用显示为单行 ⚙ 名 → ✓ 摘要（失败红色 ✗），长输出自动截断。 非 UTF-8 终端（或管道）符号自动降级 ASCII，不会乱码崩溃。

cron

uiu cron add 早报 "30m" "搜今天的 AI 新闻并摘要"   # 间隔：30m/2h/1d
uiu cron add 晨会 "daily 09:00" "汇总微信未读"      # 每天 09:00
uiu cron add x "0 9 * * 1-5" "任务"                # 完整 5 段 cron（分 时 日 月 周）
                                                   # 支持 */n、范围、列表：*/15、9-11、1-5
uiu cron add once "once 2026-09-05T10:00:00" "任务"  # 单次
uiu cron add 备份 "2h" "xcopy ..." --shell         # shell 任务：跑命令零 token（不调 agent）
uiu cron list / run <名> / tick / on|off|remove <名>

输出进 workspace/cron/output/<id>/<时间>.md；uiu serve 每 60s 自动 tick。 网关/TUI 里 /cron add 备份 2h "!xcopy ..." 等价（任务以 ! 开头即 shell 任务）。

sessions

uiu sessions list              # 已保存会话（含网关的 gw-*）
uiu sessions show <名>         # 看最近 20 轮
uiu sessions search <关键词>   # 跨会话关键词检索（免费秒回）
uiu sessions remove <名>

怎么变成"你的 agent"

1. 改 SOUL.md：写你的价值观、口头禅、不喜欢的东西。这是灵魂。
2. 改 IDENTITY.md：给它起名、定位、调性。
3. 填 USER.md：告诉它你是谁。
4. 加 skill：workspace/skills/<name>/SKILL.md
   • 简单 skill：声明 exec: <内置名>（如 exec: echo），再用 ```tool_schema 块声明参数。
   • 复杂 skill：在 src/uiu/skills_runtime.py 里注册 Python 函数当 builtin。
5. 改 agent 名字：两处可改（TUI 顶栏/状态条//status 即时显示）—— workspace/IDENTITY.md 里 ## 名字 一行，或 uiu config --agent-name 小刃（config 优先）。
6. 加 channel：uiu channel add <name> --type telegram 然后 uiu config --set-secret TELEGRAM_BOT_TOKEN=<botfather 给你的 token>

配置存储

文件	内容	入 git？
workspace/config.yaml	模型参数、channel 列表、agent_name	✅
workspace/.env	API key / bot token 等秘密	❌ 加到 .gitignore
workspace/SOUL.md 等	人设 / 记忆 / skill 定义	✅

秘密走 *.env，配置走 *.yaml——这样你可以把整个 workspace push 到 GitHub 不泄露 token。

目录结构

uiu/
├── pyproject.toml
├── README.md
├── DEVELOPMENT.md               # 完成度评审 + 对标差距 + 路线图
├── cli_smoke.py                  # 离线冒烟（CI 同款）
├── .env.example
├── src/uiu/                       # 核心代码
│   ├── main.py                        # CLI 入口
│   ├── commands.py                    # 子命令实现
│   ├── config.py                      # 配置读写
│   ├── channels*.py                   # channel adapter
│   ├── wecom_crypto.py                # 企微回调 AES 解密/验签
│   ├── gateway.py                     # serve 网关
│   ├── workspace.py                   # SOUL/skills/memory 加载
│   ├── tools.py                       # 工具注册表
│   ├── agent.py                       # 对话 + 工具调用循环
│   ├── tui.py                         # 经典 REPL（降级路径，--no-tui）
│   ├── app/                           # textual 全屏 TUI（消息区/输入区/侧栏/状态条）
│   │   ├── app.py                     # UiuApp 主应用
│   │   ├── widgets/                   # ChatView / Composer / SideBar / StatusBar
│   └── _default_workspace/            # init 模板
├── tests/                             # pytest（200+ 用例）
└── workspace/                         # 你的 IP 在这里
    ├── config.yaml
    ├── .env
    ├── SOUL.md
    ├── IDENTITY.md
    ├── USER.md
    ├── MEMORY.md
    └── skills/

验证

# 冒烟测试（不需要真 LLM/网络）
.\.venv\Scripts\python.exe cli_smoke.py

# 单元测试（含 textual 全屏 TUI 的离线 pilot 测试）
.\.venv\Scripts\python.exe -m pytest tests/ -q

# Windows 安装态验收（构建 wheel → 全新 venv → version/init/doctor/show/TUI 冒烟）
powershell -ExecutionPolicy Bypass -File scripts/verify_windows_install.ps1