免安装也能分享评审？Kiri的-x归档功能与kiri-server离线查看完整攻略

免安装也能分享评审Kiri的-x归档功能与kiri-server离线查看完整攻略【免费下载链接】kiriKiri is a visual tool designed for reviewing schematics and layouts of KiCad projects that are version-controlled with Git.项目地址: https://gitcode.com/gh_mirrors/ki/kiriKiriKiCad Revision Inspector是一款面向 Git 版本管理下 KiCad 项目的可视化评审工具能为原理图与 PCB 布局生成逐版本的差异对比页面。它的-x归档功能可把整套评审页打成一个压缩包接收方无需安装 Kiri 或 KiCad解压后一条kiri-server命令即可离线查看整个分享流程不到一分钟。一、Kiri 离线归档解决什么问题Kiri 的常规用法是在项目 Git 仓库中运行kiri它会导出仓库内各版本的原理图与 PCB 层为 SVG 图像并结合 Git 提交历史生成一个网页评审界面入口为 assets/index.html交互逻辑在 assets/kiri.js。但一个非常常见的场景是评审人没有环境——对方可能没装 KiCad甚至不想克隆整个仓库。Kiri 给出的答案就是-x标志把生成的全部评审文件归档为一个独立的 tgz 包。生成方多敲一个参数接收方零安装解压 启动内置 Web 服务器即可二、一条命令生成 Kiri 归档包-x 标志在项目根目录运行kiri时追加-x参数长参数为--archivekiri board.kicad_pro -r -x-r运行前清空上一次生成的输出文件夹-x归档生成文件运行结束后Kiri 会自动把整个输出目录打包生成带时间戳的压缩包命名格式形如kiri-2021.11.18-16h39.tgz打包逻辑位于 bin/kiri 的archive_kiri_website函数中用tar压缩输出目录时间戳由date %Y.%m.%d-%Hh%M生成。压缩包里已经包含按各次 Git 提交生成的评审网页web/index.html入口页以及每个版本的原理图、PCB 层 SVG 图像——发送这一个文件评审材料就齐了。三、快速解压离线查看kiri-server 三步走解压后的文件夹里自带一个轻量 Web 服务器脚本 bin/kiri-server它基于 Python 3 内置的http.server模块实现没有任何第三方依赖。只需三步tar -xvzf kiri-2021.11.18-16h39.tgz cd kiri ./kiri-server .最后的.表示当前文件夹就是站点目录。启动后终端会打印访问地址默认http://127.0.0.1:8080/web/index.html并自动打开浏览器进入评审页面查看完毕按CtrlC退出。 前提文件夹内必须存在web/index.html如果是 KiCad 嵌套项目追加-n参数让服务器修正路径。四、kiri-server 常用命令行参数参数作用-p PORT强制使用指定端口默认从 8080 起自动顺延尝试-r RANGE设置端口尝试范围默认 10 个-S仅启动服务器不自动打开浏览器-i IP覆盖默认地址 127.0.0.1例如绑定局域网 IP 供他人访问-n修正嵌套项目的路径-w禁用 Web 服务器仅生成图像场景-v输出更多调试信息可叠加为-vvv例如在局域网内分享时用-i绑定本机局域网 IP同事的浏览器直接打开 diff 页面即可全程无需任何安装。五、评审界面实际效果进入评审界面后可以按提交、原理图页、PCB 层逐级切换并逐版本对比查看。PCB 布局视图则是逐层对比两个版本之间的走线、焊盘与网络标签变化一目了然当项目从 KiCad 5.sch升级到 KiCad 6.kicad_sch时Kiri 同样能正确导出并对比新旧格式的原理图快速浏览大量版本时键盘快捷键是效率最高的方式——按i即可查看完整快捷键清单在提交、页面与层之间飞速跳转六、Kiri 离线归档适合哪些人跨环境评审评审人电脑没有 KiCad、甚至没有 Git 环境收到 tgz 即可看存档交付把某个项目版本的评审页作为交付资料永久保存会议快速共享现场 30 秒启动kiri-server大屏直接展示差异页面 延伸资料官方说明与使用示例README.md安装指南含 Windows/WSL、macOS 准备INSTALL.md一键安装脚本install_kiri.sh、install_dependencies.sh依赖清单python-requirements.txt【免费下载链接】kiriKiri is a visual tool designed for reviewing schematics and layouts of KiCad projects that are version-controlled with Git.项目地址: https://gitcode.com/gh_mirrors/ki/kiri创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考