Repository navigation
Releases: FIY-pc/vibe-logisim
Release list
v0.6.0-beta.1
Vibe Logisim 0.6.0-beta.1:原生重写预览版
这是 0.6 系列的第一个预览版。应用从 Electron 和 Python 换成了 Rust 宿主、Tauri 窗口和 React 界面,电路的加载、绘制和仿真仍由 Logisim 本体负责。核心路径(打开工程、编辑、仿真、让 AI 修改、保存重开)已经走通,细节仍在打磨,所以先以预览版发布;0.5.0 的应用内更新提示不会指向它,需要手动下载。
和 0.5.0 的主要差别
- AI 直接修改工作文件夹里的工程:改动即时出现在编辑器中,每轮对话记录一次文件夹检查点,可以在对话里查看改动或整体撤销。不再有单独的“方案审阅 → 应用”步骤。
- 模型服务只需要接口地址、密钥和模型名:支持流式 Chat Completions、Responses 和 Anthropic Messages,附带 OpenAI、DeepSeek、Anthropic、OpenRouter 预设。不再依赖 Codex 命令行或 ChatGPT 账号。
- 工作文件夹就是工作区:左栏显示文件夹内容,可以预览文本、图片和 PDF 资料并在对话中引用;文件改动有历史,可以对照任意两个版本并恢复。
- 整理布局按结构识别:寄存器与流水级由电路连接关系判断,不依赖元件或电路的名字;子电路的输入是否已寄存也按其内部网络计算。
- 编辑器:元件移动时预览重连的导线,提交前核对端口连接不变;工具栏删除与 Delete 键一致;下拉列表由应用绘制,不再跟随系统主题。
- 安装包更小:Windows 安装程序约 100 MB(0.5.0 为 160 MB),随包提供 Node.js 与 Java,不再包含 Python。
已知限制
- 在 1 MB 左右的大工程里,移动元件或连线需要 0.6–0.9 秒,正式版前会处理。
- 0.5.0 的应用数据不迁移:模型服务需要重新添加,旧的对话记录不会出现。
- Windows 原生拖放与回收站、更多元件库与插件、Ubuntu 24.04 以外的 Linux 发行版尚未充分验证。
- macOS 暂未提供安装包。
下载
| 系统 | 文件 |
|---|---|
| Windows 10/11 x64 | vibe-logisim-0.6.0-beta.1-win32-x64-setup.exe(安装),或 .zip(便携) |
| Linux x64 | vibe-logisim-0.6.0-beta.1-linux-x64.deb,或 .tar.gz(解压后运行 ./start.sh) |
SHA256SUMS 可用于校验下载文件。Windows 未签名程序可能提示“未知发布者”,选择“更多信息 → 仍要运行”。建议先卸载 0.5.0 再安装;两者的设置互不影响。Linux 包基于 Ubuntu 24.04 构建,需要 GTK3 与 WebKitGTK 4.1。人工编辑和仿真无需连接 AI。
Vibe Logisim 0.5.0:更顺手的编辑与 AI 协作
Vibe Logisim 0.5.0:更顺手的编辑与 AI 协作
本版改进电路编辑、仿真和 AI 对话,让操作反馈更明确,减少在设置和电路之间来回切换。
- 仿真跟随当前操作的电路:浏览其他电路保留原有运行;在当前电路按运行、单步或操作输入,就直接启动对应仿真。进入运行中的子电路实例、返回根电路时保留同一份状态。启动与输入操作都有等待反馈。
- 布线可以分段完成:拖线后在空白处松手即可落下一段,之后从线头继续。支持从空白起笔、折线和闭环;整理时保留未完成及独立导线的几何位置。
- 更清晰的编辑操作:用
1–4切换选择、布线、输入与平移,A打开元件库;在“更多 → 快捷键”中查找、修改或恢复键位。撤销与画布工具放在一起,保存状态显示在文件名旁,Ctrl+S直接保存。 - 模型选择更完整:将服务返回的模型列表与公共模型资料合并展示,补充名称和能力;未知模型仍可手动配置。支持默认、轻度、中、高、极高、最高思考深度,具体选项依模型与接口支持而定。刷新失败保留已有列表与选择。
- 对话过程更易读:保留真实工具输出和错误,清楚显示中断、结果未知与补充消息的加入状态;减少重复角色标签和界面说明。
- 修复工具参数兼容问题:内置运行时通过 Responses 接口调用工具时,正确保留可选参数,避免不需要的字段干扰电路检查。
同一时间保留一个活动仿真;主动启动另一电路会替换原运行的临时状态,已留存的观察记录不受影响。自由画出的导线仍有电气含义,不是绝缘的标注框。
Windows x64 下载 vibe-logisim-0.5.0-win32-x64-setup.exe 后安装;Linux x64 下载 vibe-logisim-0.5.0-linux-x64.tar.xz,解压后运行 vibe-logisim。附件中的 .sha256 可用于校验下载文件。
内置运行时、Python 和 Java 继续随包提供,Codex 首次使用时自动下载。人工编辑与仿真无需连接 AI。
Vibe Logisim 0.4.2:更轻的安装包
Vibe Logisim 0.4.2:更轻的安装包
本版缩小下载与安装体积,让首次安装更快。内置 AI 运行时、Python 和 Java 继续随包提供,人工编辑与仿真无需额外下载。
- 下载包缩小一半以上:Windows 从约 391 MB 降至 161 MB,Linux 从约 363 MB 降至 172 MB。
- Codex 按需下载:首次使用 Codex(包括 ChatGPT 登录)时自动下载,显示实际进度,支持取消和重试。安装后重启可直接复用;下载失败不影响编辑、仿真和查看历史会话。
- Windows 安装程序:支持选择安装位置、开始菜单入口、覆盖安装和卸载;卸载保留账户与会话数据。
- 会话保持统一:切换运行时仍能查看已有会话,各条会话保留原来的运行时和模型服务。
Windows x64 下载 vibe-logisim-0.4.2-win32-x64-setup.exe 后安装;Linux x64 下载 vibe-logisim-0.4.2-linux-x64.tar.xz,解压后运行 vibe-logisim。附件中的 .sha256 可用于校验下载文件。
以上体积为主安装包,不包含首次使用时下载的 Codex。AI 功能仍需自己的账号或 API 接口及相应额度。
Vibe Logisim 0.4.1:更容易开始使用 AI
Vibe Logisim 0.4.1:更容易开始使用 AI
本版加入内置 AI 运行时,并重新整理模型服务配置,让第一次连接与后续管理更直接。
- 内置运行时:使用 API 密钥即可开始,支持 Chat Completions、Responses 和 Anthropic Messages。ChatGPT 账号仍可通过随包附带的 Codex 运行时使用。
- 模型服务管理:保存多个服务、发现模型、检测连接,并为新对话选择默认服务。常用服务优先显示必要字段,自定义地址和协议按需填写。
- 统一会话列表:每条对话保留自己的运行时和模型服务;更改默认设置不影响已有对话。更换已有对话的模型服务时,明确显示历史将发送到哪里。
- 中断更清楚:保留已收到的回答和工具输出,标明结果未知的操作;重新打开后不会自动重复执行。
下载对应系统的完整压缩包,解压运行。Windows、Linux x64 包包含所需运行环境。人工编辑与仿真无需连接 AI;AI 需要自己的账号或接口额度。
Vibe Logisim 0.4.0
Vibe Logisim 0.4.0:构建电路,也让它读得懂
0.4.0 把 AI 构建、图面组织、信号追踪与原生仿真连成了一条完整的电路工作路径:给出需求和初始材料,得到可编辑、可运行的电路,再通过你的反馈继续改好。
复杂电路有了阅读顺序
这次重点解决的是图面整体如何组织。电路可以按功能划分区域,沿主数据流安排阶段,把控制支路放在相关模块附近;寄存器阵列保持规则排列,公共 CLK、复位和使能信号尽量保留清楚的干线与支路。输出端靠近来源,减少只为挂一个标签而绕远的长线。
已有电路里的固定面板、接口和指定结构可以作为整理约束。布局工具会核对连接与接口,并检查声明的保护范围;AI 仍可通过直接编辑和脚本完成任务。把“哪些能动、哪些必须保留”告诉它即可。
内置 AI 的交付要求也覆盖了图面:读懂需求、实现功能之后,还应检查修改过的电路及主要信号路径,处理影响阅读的问题。你不需要先学会描述布局参数,第一版之后仍可继续提出具体偏好。
顺着信号找到来源
Ctrl+点击 隧道、端口或导线,即可在当前子电路中查看上游驱动端、使用位置、分线器与总线位段映射。来源明确时直接跳转;有多个或不完整来源时显示候选。相关元件和导线会高亮,Alt+← 返回先前的位置。
这让隧道密集的译码和控制逻辑更容易阅读,也方便追查“这个字段从哪来”“这个控制信号送到哪里”。
开始你的电路任务
下载下方对应系统的完整压缩包,解压运行。Windows 和 Linux x64 包都内置了所需运行环境;人工编辑与仿真无需连接 AI。AI 可使用你自己的 ChatGPT 登录,或支持流式 Responses API 的自定义接口。
把电路、需求文档、组件库和测试程序放进同一个文件夹,直接告诉 AI:
按需求文档完成这个电路,保留原面板和对外接口。验证关键功能,把电路按功能和数据流组织好,最后说明怎么运行及未验证的部分。
看到首版后,可以接着说:
将输入处理、计算和输出显示按从左到右的顺序组织,对齐相关端口,修改后复查原来的功能。
复杂任务建议使用有较强推理、工具调用和图像理解能力的模型。同时提供测试输入和预期输出,并在实际使用环境中核对结果。
Vibe Logisim 0.3.3
Vibe Logisim v0.3.3
这一版只改 AI 的「整理电路」(arrange_candidate):整理后除了画法,其余都保持不变;连线也比以前直。解压替换旧版即可,AI 接口设置和会话记录保存在用户目录,不受影响。v0.3.2 会在应用里提示这次更新。
下载
| 系统 | 文件 |
|---|---|
| Windows 10/11 x64 | vibe-logisim-0.3.3-win32-x64.zip,解压后双击 vibe-logisim.exe |
| Linux x64 | vibe-logisim-0.3.3-linux-x64.tar.gz,解压后运行 ./vibe-logisim |
每个压缩包旁边有 .sha256 校验文件。首次运行 Windows 可能提示“未知发布者”,选“更多信息 → 仍要运行”。
整理电路只改画法
以前用课程框架做关卡时,AI 整理完电路,往往还要手工修补几处。这一版修好了这些问题:
- 面板上的探针如果接进了主体,整理后连线不再丢失。以前这些线会被悄悄断开,等价检查也发现不了。
- 带自定义外观的子电路,整理后能正常打开,使用它的电路里端口位置不变。以前会报 “Appearance element circ-port not found”,或者端口移位。
- 用默认外观的子电路,同一朝向的引脚保持原来的顺序,使用它的电路里端口不会对调。
- 面板上的导线不再被误删。例如按钮的短引线接在一根导线的端点上,Logisim 载入时会把两段合成一根,以前这种导线会被当成已拆掉的旧线删掉。
- 文件里只改被整理的那个电路,其余电路逐字节不变,检出后不需要再恢复。
- 面板识别:整页都是面板、主体还是空的电路,整页保持不动;辅助电路逻辑上方的一列接口引脚,不再被当成面板冻结。
交付整理结果前,除了原有的逐端口连通性核对,还会核对两件事:别的电路看到的子电路实例(端口位置和对应的引脚)是否不变;目标电路以外的内容是否一个字节都没改。任何一项不符就不交付,并报告原因。
连线更直
- 相邻两列之间,一个元件的输出接另一个元件的输入时,两个元件会尽量对齐,让这根线成为一条水平直线。以前按相邻端口的平均位置摆放,这类线大多要折两次。
- 元件锚点落在网格上,对齐的端口真正等高。以前有的门会偏开半格(5 px),看着对齐的线其实折了两下。
- 同一列里有空隙时,元件会尽量和邻列元件顶边对齐,或者移到能让一根线变直的位置;引脚也参与,但不改变引脚顺序。
- 单周期 CPU 这类没有流水级的电路:按信号深度分列时,没有上游的元件会全挤在最左边,拉出很长的线。现在只要能缩短连线,元件会右移到它所喂部件的前一列。有两种移法,各画一遍,比较交叉、拐弯、线长和 Tunnel 数,保留较好的一张。
- 多路选择器、多输入门的输入端口只相隔 10 px,以前常被先布的线挡住,只能退回 Tunnel。现在布不通的线会优先重布一次。在课程框架原件和一份完成全部关卡的课程工程上,已经没有因布不通而退回 Tunnel 的端口。
已验证
- 新增原生测试:整理前后逐项核对探针连线、自定义外观与默认外观的子电路实例、载入时合并的导线、目标电路以外的字节;另有对照用例,证明默认外观的端口确实按引脚位置排列。两条门电路链整理后每段都是水平直线,元件在网格上,输出引脚顺序和网络不变。
- 课程框架原件和一份完成全部关卡的课程工程里的所有电路都能整理:连通性、子电路实例、目标电路以外的字节全部核对通过。
- 安装包由 CI 的 bundle 工作流打包,在真实 Windows 与 Linux 上冒烟通过后才上传到本 Release。
已知限制
- 整理后的图仍比手画的宽:电路按信号深度分列,单周期 CPU 会有十几列,每列只有几个元件。手画时常见的“主数据通路一行、控制器在上、PC 逻辑在下”这种分块,还做不到。
- 课程面板和主体之间留白很小(不到 40 px)时,面板可能识别不出来,整页(包括面板上的显示件和引脚)会被当成主体重排。连通性不变,但面板会乱。遇到时可以让 AI 传
panelBelowY指定分界,或把面板元件列进pinnedComponentIds。 - 其余同 v0.3.2:新版本提示只负责提示,仍需手动下载、解压替换;Windows 上的“信号仍然断开”尚未复现;自定义接口只支持 Responses API;代理只支持 HTTP 代理;从课程模板一键补成五级流水线 CPU 还不稳定;macOS 暂无安装包。
许可
源码 GPL-3.0。安装包附带 CPython、Temurin JDK、Codex(Apache-2.0)、PDF.js(Apache-2.0)、Logisim-ITA(GPL-3.0,附源码)以及课程发布的 Logisim 运行文件(原样附带,由 Java 加载)。
Vibe Logisim 0.3.2
Vibe Logisim v0.3.2
v0.3.1 之后的版本,补上两件事:遇到问题时一键备好反馈材料;有新版本时在应用里提示。解压替换旧版即可,AI 接口设置和会话记录保存在用户目录,不受影响。
之前的版本不会检查更新,从这一版起才会在有新版本时提示。
下载
| 系统 | 文件 |
|---|---|
| Windows 10/11 x64 | vibe-logisim-0.3.2-win32-x64.zip,解压后双击 vibe-logisim.exe |
| Linux x64 | vibe-logisim-0.3.2-linux-x64.tar.gz,解压后运行 ./vibe-logisim |
每个压缩包旁边有 .sha256 校验文件。首次运行 Windows 可能提示“未知发布者”,选“更多信息 → 仍要运行”。
反馈问题
右上角新增「…」菜单,点「反馈问题…」(AI 回答失败或连接失败时,AI 面板的提示卡上也有「反馈这个问题」)。对话框里先预览要发出去的内容,再选:
- 保存诊断包…:生成一个 zip(默认存到「下载」文件夹),拖进 Issue 的「诊断包与截图」一栏;
- 复制摘要:粘贴到 Issue 的「诊断摘要」一栏;
- 打开 GitHub 反馈页:打开已填好版本、系统和连接方式的「问题反馈」表单,同时把摘要复制好。
诊断包里有:版本、系统、Java 版本、AI 连接方式和网络方式、路径特征(长度、层级、是否含中文或空格、是否在 OneDrive 或网络位置,不含路径本身)、最近失败的电路工具调用及其参数、应用日志。没有:API 密钥、对话内容、ChatGPT 登录信息和你的其他文件。当前电路默认不附,勾选后才附上。
Issue 是公开的,任何人都能看到。写进日志和诊断包的内容会先替换掉 API 密钥、用户目录、用户名、计算机名、工作区位置和学号;诊断包生成后还会再查一遍,发现漏掉的密钥、用户目录或学号就拒绝保存。文件名或元件标签里仍可能有你的名字,发之前在对话框里看一眼预览。
日志写到文件
界面、AI 引擎和电路服务的日志现在写到用户目录,单个文件 2 MB,保留 3 个:Windows 在 %APPDATA%\vibe-logisim\logs,Linux 在 ~/.config/vibe-logisim/logs。「…」→「打开日志文件夹」可以直接打开。之前的版本日志只输出到终端,出了问题事后查不到。
新版本提示
启动几秒后访问一次 GitHub,查询有没有新版本(包括预发布版,6 小时内最多一次)。有就在顶部提示,可以「查看下载」或「忽略此版本」。只提示,不下载、不安装任何东西,也不发送个人信息。
- 在「…」菜单里取消「自动检查更新」,之后启动时不再访问 GitHub;「立即检查更新」随时可用。
- 设置环境变量
VIBE_LOGISIM_NO_UPDATE_CHECK=1可以完全关闭。 - 网络不通时不打扰,下次启动再查。
其他
- README 更新了能用的模型举例(GPT-6 系列、DeepSeek V4 等)。
- 从源码运行测试时,依赖不随仓库分发的样本或课程运行文件的测试会跳过,不再报错。
已验证
- 新增单元测试 25 项:日志脱敏与滚动、诊断包内容与生成后的检查、版本比较与缓存、失败工具调用的记录,所在文件都已加入 CI 的 Windows 单元测试列表。
- 真实 Electron 端到端:新版本提示出现;忽略后重启不再出现;关闭自动检查后重启不再访问 GitHub;手动检查;日志写入文件;诊断包预览与保存;摘要复制;反馈页链接;AI 引擎启动失败时出现「反馈这个问题」。
- Windows 与 Linux 安装包的冒烟测试各导出一次诊断包并检查内容。Linux 安装包用真实接口跑两轮模型回合后导出,诊断包的每个文件和日志文件里都找不到密钥。
- 安装包由 CI 的 bundle 工作流打包,在真实 Windows 与 Linux 上冒烟通过后才上传到本 Release。
已知限制
- 新版本提示只负责提示,仍需手动下载、解压替换。
- Windows 上的“信号仍然断开”尚未复现;再遇到时请用「反馈这个问题」导出诊断包附到 Issue。
- 其余同 v0.3.1:自定义接口只支持 Responses API;代理只支持 HTTP 代理;从课程模板一键补成五级流水线 CPU 还不稳定;整理器的行对齐和等距通道还不如手画;macOS 暂无安装包。
许可
源码 GPL-3.0。安装包附带 CPython、Temurin JDK、Codex(Apache-2.0)、PDF.js(Apache-2.0)、Logisim-ITA(GPL-3.0,附源码)以及课程发布的 Logisim 运行文件(原样附带,由 Java 加载)。
Vibe Logisim 0.3.1
Vibe Logisim v0.3.1
v0.3.0 之后的修正版本,针对第一批同学反馈的两个问题:AI 打开电路文件时的路径报错说不清楚;「批量连接电路」在个别情况下报“信号仍然断开”却没有线索。解压替换旧版即可,AI 接口设置和会话记录保存在用户目录,不受影响。
下载
| 系统 | 文件 |
|---|---|
| Windows 10/11 x64 | vibe-logisim-0.3.1-win32-x64.zip,解压后双击 vibe-logisim.exe |
| Linux x64 | vibe-logisim-0.3.1-linux-x64.tar.gz,解压后运行 ./vibe-logisim |
每个压缩包旁边有 .sha256 校验文件。首次运行 Windows 可能提示“未知发布者”,选“更多信息 → 仍要运行”。
AI 打开电路文件时的路径错误
Linux 上有同学遇到:让 AI 新建一个电路封装后,AI 反复“刷新电路 → 找不到电路定义 → 打开电路 → 文件路径无效”,绕不出来。原因是主机只回了一句“文件路径无效”,AI 不知道该改成什么。现在:
- AI 传绝对路径、但确实指向当前文件夹里的文件时直接接受(AI 的工作目录就是这个文件夹,它很自然会这么写);Linux 上写成反斜杠的路径,若对应文件存在也接受。
- 其余情况返回带说明的结构化错误:
INVALID_PATH(绝对路径或含空字符)、FILE_OUTSIDE_WORKSPACE(解析到了工作区之外)、FILE_NOT_FOUND(工作区里没有这个文件),并附工作区根目录、当前打开的文件、可用的 .circ 列表,以及能推断出来的正确路径(同名文件,或去掉根目录后的相对路径)。 - 工具说明里写清了
path必须是相对工作区根目录的路径。
「批量连接电路」报“信号仍然断开”时给出诊断
Windows 上有同学遇到:让 AI 批量连线,布线写回后的校验报“要求连接的信号仍然断开: AND Gate@(…) bit 0”。我们在 Linux 上用两种运行时(仓库自带的 Logisim-ITA 与课程发布的 2020 运行文件)、CRLF 换行、非格点端口、线中途接端口、Tunnel 引线等情形都没有复现。这一版先把校验失败时的现场带出来:失败端口与它本该同网的端口、重载后两边各在哪个网、这次请求的连接里哪些涉及它、为它画了几段线、端口位置上有哪些导线、布线前后的导线数量,以及操作系统、Java 版本与运行时 jar 的摘要;提示语按“根本没有为该连接画线 / 画了线但重载后仍不通 / 出现未要求的短接”三种情况分别给出下一步。再遇到时请把这段报错原文贴到 Issue 里。
其他
- 文档中指向开发期内部记录的链接改为纯文本,结论保留在正文里。
- 桌面端 README 的运行示例改用占位路径;画布端到端脚本改由环境变量
VIBE_COURSE_PACKAGE指定课程包目录。 - README 截图更新;
package.json补充 license、repository、homepage 字段。
已验证
- 新增单元测试:AI 打开电路的六种路径情形(工作区内绝对路径归一化、反斜杠路径、工作区外、不存在、越界链接、其它错误原样透传);布线后校验失败的五种诊断输出(含“重载结果与写入前一致”的情形)。全部通过,前者已加入 CI 的 Windows 单元测试列表。
- 经真实主进程链路核对,AI 传入的错误路径拿到的是上述结构化错误,不是原始异常文本。
- 安装包由 CI 的 bundle 工作流打包,在真实 Windows 与 Linux 上冒烟通过后才上传到本 Release。
已知限制
- Windows 上的“信号仍然断开”尚未复现,本版只提供诊断,不算修好。
- 其余同 v0.3.0:自定义接口只支持 Responses API;代理只支持 HTTP 代理;从课程模板一键补成五级流水线 CPU 还不稳定;macOS 暂无安装包。
许可
源码 GPL-3.0。安装包附带 CPython、Temurin JDK、Codex(Apache-2.0)、PDF.js(Apache-2.0)、Logisim-ITA(GPL-3.0,附源码)以及课程发布的 Logisim 运行文件(原样附带,由 Java 加载)。
Vibe Logisim 0.3.0
Vibe Logisim v0.3.0
自 v0.2.0 以来面向同学的第二个公开版本。三件事:连 AI 这一步做扎实、能打开往届同学的旧版文件、AI 整理电路的结果按往届手画的画法来。
下载
| 系统 | 文件 |
|---|---|
| Windows 10/11 x64 | vibe-logisim-0.3.0-win32-x64.zip,解压后双击 vibe-logisim.exe |
| Linux x64 | vibe-logisim-0.3.0-linux-x64.tar.gz,解压后运行 ./vibe-logisim |
每个压缩包旁边有 .sha256 校验文件。首次运行 Windows 可能提示“未知发布者”,选“更多信息 → 仍要运行”。
连接 AI 更省事
AI 设置重做(右栏齿轮,或 AI 面板提示卡上的按钮):
- 两个并列页签:ChatGPT 账号 / 自定义接口。没配置过时直接落在「自定义接口」页;已登录 ChatGPT 或已保存接口时落在对应页签。
- 自定义接口:填好地址和密钥后自动读取接口的模型列表(可搜索、可键盘选择;接口不提供列表时可直接输入)。嵌入、语音、图像等不能对话的模型会从列表里去掉。
- 保存前先检测:点「保存并连接」会先向接口发一条与实际请求同形状的流式测试请求。密钥无效、地址不对、模型名不存在、接口只支持 chat/completions、限流、服务端错误、超时——都在保存前用中文说清,并保留接口返回的原话。检测失败时可以「跳过检测直接保存」。
- 重新保存不必再输密钥(输入框提示已保存的密钥尾号,留空即沿用)。
- 接口读到的全部模型进入输入框上方的模型选择器,可以直接切换;「思考深度」新增「关闭」档,给不接受推理参数的模型用。可为接口设置模型上下文窗口(默认 256k),长任务不再因为窄窗口反复压缩上下文丢状态。
- AI 面板提示卡同时给出「登录 ChatGPT」和「填写 API 接口」两个入口。
- 读取系统代理:Clash、v2rayN 等开启「系统代理」后(或设置了
HTTPS_PROXY环境变量),ChatGPT 登录、接口请求和保存前的检测都自动经过该代理。AI 设置右下角显示检测到的代理地址或「直连」,代理设置变化后提示「重新连接」;连不上时的错误提示会说明这次走的是代理还是直连。
已保存的接口设置(provider.toml)无需重新填写,首次打开设置会按旧格式读出。
能打开往届的旧版文件
- 用 Logisim 2.7.1 保存的课设文件(2016–2019 届常见)现在能打开、渲染、仿真。这些文件里的触发器带有新版运行时不认的默认属性,之前要么整份文件打不开,要么被静默丢掉元件;现在按每个电路的元件数逐一核对后放行,凡是会丢元件的情况仍然明确报错,不会给你一张缺零件的图。
- 文件里记录的组件库路径若是作者自己机器上的绝对路径(
cs3410.jar、riscv-probe.jar常见),现在按文件名在电路文件同目录查找;找不到时说明缺哪个文件、该放在哪里,不再卡死或弹空白错误。
AI 整理电路按往届手画的画法
「整理电路」(AI 调用的 arrange_candidate)重写了:什么距离该用导线、什么距离该用 Tunnel、寄存器怎么排、通道留多宽,这些常数全部来自往届同学手画 CPU 的统计,而不是拍脑袋。整理前后网表逐位等价才写回文件,不等价就不动你的图。
在按 129 份往届手画 CPU 校准的可读性评分上,课程模板骨架(全 Tunnel 的 stage2 / stage5)从 0.47 / 0.30 整理到 0.81 / 0.78,往届手画中位数是 0.79。也就是说它能把乱图、全 Tunnel 图和 AI 生成的图整理到交得出去的水平,但不会比认真手画的同学画得更好——把一份已经画得好的手画图再整理,多半反而变差。
AI 改图更少出错
- 元件编号按位置生成,别处的改动不再让编号漂移,AI 改一处不用重读整张图。
- ROM/RAM 的内容可以由 AI 直接写入。
- 写回文件时当场检查位宽短接、无法加载、改到目标电路之外,都写进回执,不会留下打不开的文件。
- 用仿真观察信号时,观察点接错或全程未知会被诊断出来,而不是得出「CPU 跑不起来」的结论。
已验证
- CI 单元测试(12 个文件、37 项)全部通过:接口探测(模型列表、试连、各类错误分型)、接口配置读写、系统代理解析;布局与判分的 Python 单测另行通过。
- 真实 Electron 端到端(AI 设置):提示卡入口 → 错误密钥在保存前被拦下且未写盘 → 正确密钥自动列出模型 → 保存后连接成功、模型选择器列出接口模型 → 重开设置不重输密钥再保存 → 停用接口恢复。
- 真实 Electron 端到端(系统代理):接口放在只有代理才能解析的域名后面,设了代理的实例里模型发现、保存前检测和 AI 子进程的真实回合都经过代理;未设代理的实例页脚显示「直连」,同一接口在保存前失败并提示开启系统代理。
- 打包件(linux-x64,v0.2.1 内部构建)在有、无系统代理两种条件下各跑完两轮真实模型回合(含写回全加器)。
- 整理器回归:11 个固定 case(课程模板、往届手画 CPU、合成测试电路)整理后全部网表等价。
- Windows/Linux 安装包由 CI 的
bundle工作流打包,各自在真实系统上冒烟通过后才上传到本 Release。
已知限制
- 自定义接口仍只支持 Responses API(Codex 0.15x 已移除 chat 模式)。只提供
chat/completions的接口,保存前检测会明确指出。 - 代理只支持 HTTP 代理(Clash/v2rayN 的 HTTP 或混合端口);纯 SOCKS 端口会在设置里提示「代理不支持」。带账号密码的代理:保存前检测会报代理要求认证,可「跳过检测直接保存」,AI 引擎本身能用。
- 从课程模板一键补成五级流水线 CPU 还不能稳定成功。AI 更适合讲解、检查、局部修改、小模块构建,以及把画好的图整理干净。
- 整理器的行对齐和等距通道还不如手画,下个版本改。
- macOS 暂无安装包。Windows 上 AI 进程由 Codex 的 workspace-write 沙箱限制(只能写打开的文件夹和应用配置目录);Linux 上由 systemd 隔离。
许可
源码 GPL-3.0。安装包附带 CPython、Temurin JDK、Codex(Apache-2.0)、PDF.js(Apache-2.0)、Logisim-ITA(GPL-3.0,附源码)以及课程发布的 Logisim 运行文件(原样附带,由 Java 加载)。
Vibe Logisim 0.2.0
Vibe Logisim v0.2.0
第一个面向同学公开的版本。解压即用,不需要装 Java、Python 或任何东西。
下载
| 系统 | 文件 |
|---|---|
| Windows 10/11 x64 | vibe-logisim-0.2.0-win32-x64.zip,解压后双击 vibe-logisim.exe |
| Linux x64 | vibe-logisim-0.2.0-linux-x64.tar.gz,解压后运行 ./vibe-logisim |
每个压缩包旁边有 .sha256 校验文件。首次运行 Windows 可能提示“未知发布者”,选“更多信息 → 仍要运行”。
能做什么
- 打开课程文件夹,直接编辑课程的
.circ(兼容 HUST 2020 版 Logisim 和 Logisim-ITA 2.16),文件可以随时用原版 Logisim 打开核对。 - 画电路:搜索放置元件、端口连线、
P操作输入看信号、Ctrl+T启停仿真、Ctrl+Z撤销、文件树拖动、改动查看与撤销。 - AI 协作:右栏描述需求,AI 直接读写你文件夹里的电路,能观察结构、跑真值表、渲染图片来检查自己的结果。
- 连接 AI 的两种方式:登录 ChatGPT;或在「AI 设置 → 使用自己的 API 接口」填写任意 OpenAI 兼容接口(需支持 Responses API)的地址、密钥和模型。密钥只保存在本机。
已验证
- Windows 和 Linux 安装包都在真实系统上跑通:打开文件夹 → 新建电路 → 放置与门和引脚 → 连线 → 用内置 Java+Logisim 跑四组真值 → 关闭重开。
- 通过 API 接口的真实模型回合:在打开的空电路里构建全加器,模型用结构化工具放置和连线,自行仿真 8 组输入全部通过。
已知限制
- macOS 暂无安装包。
- AI 接口只支持 Responses API;只提供
chat/completions的接口目前不能用。 - Windows 上 AI 进程由 Codex 的 workspace-write 沙箱限制(只能写打开的文件夹和应用配置目录);Linux 上由 systemd 隔离。
- 大型课程电路(如完整 CPU)的 AI 自动构建仍不稳定;AI 更适合讲解、检查、局部修改和小模块构建。
许可
源码 GPL-3.0。安装包附带 CPython、Temurin JDK、Codex(Apache-2.0)、PDF.js(Apache-2.0)、Logisim-ITA(GPL-3.0,附源码)以及课程发布的 Logisim 运行文件(原样附带,由 Java 加载)。
