https://jidzhang.github.io/tags/%E9%A3%9E%E4%B9%A6/Recent content in 飞书 on 疯狂的键盘Hugozh-cnFri, 23 Oct 2026 00:00:00 +0000https://jidzhang.github.io/posts/2026-10-23-safe-zcode-introduction/Fri, 23 Oct 2026 00:00:00 +0000https://jidzhang.github.io/posts/2026-10-23-safe-zcode-introduction/<p>Safe ZCode 是上游 <a href="https://github.com/zai-org/ZCode">ZCode</a> 开源快照的下游分支，围绕隐私、可控性和中文使用场景做了一组补丁，跟随上游更新，代码在 <a href="https://github.com/jidzhang/ZCode">jidzhang/ZCode</a>。</p> <p>九月发布第一版时只支持 Windows；目前基线跟到上游 3.16.2，共发布 10 个版本，Windows、macOS、Linux 的 x64 与 arm64 均有安装包。实现方式与 Edge 之于 Chrome 类似：上游发布快照后合并，逐条重放本地补丁；上游已实现同类功能的，删除本地对应改动。</p> <h2 id="相较于官方版">相较于官方版</h2> <p><strong>隐私默认收紧。</strong> 模型遥测在打包环境写入关闭值；阿里云 ARMS 监控 SDK 换为零网络空实现；官方发行版构建期注入的 OTLP 上报地址，本项目不注入，安装包里没有可上报的目的地。启动时的七类后台请求（更新检查、升级提醒、灰度开关、帮助链接、模型列表、插件市场、远端小图标）默认全部停用，各自回落到本地数据；会话分享发布入口默认关闭。需要恢复时在 <code>~/.zcode/v2/setting.json</code> 里加 <code>&quot;enableStartupOutbound&quot;: true</code> 并重启。</p> <p><strong>日志可配置。</strong> 上游保留期固定 14 天且没有级别开关。现在有两个设置项：<code>logLevel</code>（<code>error</code> / <code>warn</code> / <code>info</code>，默认 <code>info</code>）和 <code>logRetentionDays</code>（0–365，默认 14）。阈值同时作用于主进程、渲染进程转发的日志和 Host 服务层日志，日志只写本地目录、不上传。</p> <p><strong>登录是选项，不是前提。</strong> 上游逐步收紧账号体系：未登录可能被全屏拦截，token 过期弹全屏重登页；3.16.2 的手机远控改成账号 JWT，只用 API key 的用户直接无法使用。本项目过滤掉启动守卫与过期推送，只在用户主动登录、选择需要账号的模型或登出后重连时显示登录页；不登录也能使用全部本地功能。手机远控恢复了 3.15.1 的免登录配对链路（二维码携带 <code>hash</code>/<code>t</code>，relay 匿名注册），手机页版本固定到 3.15.1。更新通道独立，发布包只查本仓库的 GitHub Releases。</p> <p><strong>飞书 / 微信通道更可靠。</strong> 通道是客户端与飞书、微信官方服务器的直连，不经过任何中间域名。在此基础上：飞书 token 被服务端提前作废时自动续期重试，流式卡片熔断改为 60 秒半开可恢复（上游为永久闩锁，一次故障只能重启）；任务运行中发送的消息改为入队而非拒绝，桌面端发起的任务也能正确排队；工具调用摘要、报错、权限申请、状态预览四个出口统一做密钥打码，路径与链接保持原样。两个通道各有独立包，可挂到 <code>zcode --web</code> 后端用于无桌面部署。</p>