终端控制台 · Juhe

一个中文桌面配置工具，支持自定义 API 上游、模型选择、本地代理、Skills 导入、上下文文件和备份恢复。

中转站：https://juhe.pub · QQ 群：1124650434

本仓库是原 0.2.0 程序遗失源码后的 0.3.0 可编辑重建版。主要功能根据原程序的字节码、界面和行为测试重建，包含完整 Python 源码，不需要原 EXE 才能运行或构建。它不是原始源码的逐字恢复，具体差异见 恢复记录。

功能

• 配置自定义服务地址、API Key、模型、推理强度和速度。
• 导入前备份 config.toml、auth.json、上下文文件和选中的 Skills；提供恢复操作。
• 保留无关 TOML 配置和注释，处理历史 provider 别名。
• 本地代理支持模型列表、Responses 和 Chat Completions 请求，以及流式响应。
• 代理可固定模型，并把“上下文”页内容加入请求。
• 从自选目录安装 Skills；不默认打包来源不明的第三方 Skills。
• 主窗口常驻推广栏，支持复制群号和打开中转站。

Windows 用户

从 最新发布版本 下载 Windows ZIP 压缩包，解压后运行 terminal-console-juhe.exe。必须保留同目录的 _internal 文件夹。

1. 填写上游地址和对应 API Key，选择模型。
2. 确认 Codex 目录；默认读取 CODEX_HOME，未设置时使用用户目录下的 .codex。
3. 按需选择 Skills、上下文或本地代理。
4. 点击“一键导入”。如果目标应用正在运行，完全退出后重新打开。

默认地址是 https://juhe.pub。为兼容原程序，导入时无路径的根地址会规范化为 https://juhe.pub/v1；已经填写的 /v1 或其他路径会保留。已保存的配置优先于默认值。

模型菜单是可编辑的，预置名称来自原程序；实际可用模型、推理档位和参数由所选上游决定。“获取模型列表”会请求上游的 /models 接口。

从源码运行

需要 Python 3.11 或更新版本。主要验证平台为 Windows。

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
.\.venv\Scripts\python.exe -m terminal_console_v1

Linux/macOS 可尝试同一源码，在命令中将 .venv\Scripts\python.exe 替换为 .venv/bin/python；尚未验证对应系统的完整桌面体验。

测试与构建

.\.venv\Scripts\python.exe -m pytest
.\.venv\Scripts\python.exe -m terminal_console_v1 --self-test
.\.venv\Scripts\python.exe -m terminal_console_v1 --smoke-shot build\preview.png
.\.venv\Scripts\python.exe scripts\build_source.py

Windows 构建结果位于 dist/source/。构建脚本会用当前源码生成独立程序，执行程序自测和离屏截图，并生成 ZIP、SHA256 校验文件及依赖清单。更多说明见 开发与发布。

GitHub Actions 会在推送和 Pull Request 时执行 Windows 测试。推送 v* 标签后会构建 Windows 包并建立草稿 Release，维护者检查后公开发布。

源代码仓库 · 自动化检查 · 问题反馈

配置、备份与隐私

• 仅在点击“获取模型列表”“测试代理”或实际发起代理请求时连接所选上游；点击推广按钮才会打开网站。
• API Key 按配置格式写入所选目录的 auth.json。该文件和导入前的认证备份应视为私密文件。
• 状态和备份位于所选目录的 .terminal-console-v1/，不应上传 GitHub。
• 代理绑定本机回环地址，不作为局域网或公网服务运行。使用代理时需要保持本工具运行。
• 请求日志记录接口路径、状态和耗时，不记录认证头或请求内容。
• 自动化测试使用临时目录、虚构 Key 和本机模拟上游，不修改真实配置、不调用真实付费接口。

项目结构

terminal_console_v1/
  branding.py       默认地址、群号和版本
  gui.py            Qt 界面
  logic.py          配置导入、备份与恢复
  proxy.py          本地 HTTP 代理
  main.py           启动、自测和截图
  assets/           中文字体及其许可
tests/              回归测试及原程序行为对照样例
scripts/build_source.py
.github/workflows/  测试与 Windows 打包

修改群号、网站或默认模型，可编辑 terminal_console_v1/branding.py 后重新构建。

许可

本仓库应用源码采用 MIT。字体和依赖使用各自的许可证，见 第三方说明。本项目是独立工具，不代表上游 API 服务或目标应用的官方产品。