v0.2.3

Farside 0.2.3 · Kimi Code 0.31.1 全面适配

本版本将唯一 Runtime 从 Kimi Code 0.29.2 升级到 0.31.1，保持现有桌面交互、会话数据和服务生命周期兼容，建议所有用户升级。

升级亮点

• 跟进 Kimi Code 0.30–0.31.1 的自定义 Agent、插件 system prompt、secondary model 和非阻塞 TaskOutput 等 Runtime 能力。
• 保持现有 /api/v1 REST、/api/v1/ws、实例发现和 shutdown 生命周期兼容，无需迁移本地配置或历史会话。
• 修复空 Runtime 补丁队列被误判为冲突的问题；上游已经吸收的历史补丁不再重复应用。
• 更新存在安全公告的间接依赖，依赖审计结果为 0 漏洞。

Runtime 与兼容性

• 唯一 current Runtime：Kimi Code 0.31.1。
• 固定上游 revision 6b56c11697771fe596099b38bafae539820309a4。
• 锁定 Windows、macOS、Linux 的 x64/arm64 六平台官方产物及 SHA-256。
• 已审查 REST、WebSocket、wire、session、profile、tool、auth、配置、UI/IPC、持久化与构建变化，未发现需要用户迁移的破坏性变更。

下载与安装

• Windows：.exe
• macOS Apple Silicon：.dmg

升级前请结束正在执行的 Agent 任务。安装包不会主动删除本地项目、Kimi 配置或会话数据。

发布验证

• 30/30 自动化测试通过。
• TypeScript 类型检查、生产构建和依赖安全审计通过。
• Kimi Code 0.31.1 正式产物下载、SHA-256 校验及 Server smoke 通过。
• GitHub Actions 负责 Windows 与 macOS 安装包构建和发布。

已知限制

• 暂无新增已知限制。

完整变更

v0.2.2...v0.2.3

安装包校验

• Farside Setup 0.2.3.exe · 128.2 MiB · SHA-256 7a815d30bff3900beba4cdb557097e67e68c8736a885266a9dd1ffab9df706f7
• Farside-0.2.3-arm64.dmg · 165.8 MiB · SHA-256 a6240dc7e2b93e372633be50a199f64ac5466aece2f95ed17650bc814b062e46

v0.2.2

Farside 0.2.2 · Kimi Code 0.29.2 Runtime 升级

本版本将 Farside Runtime 从 Kimi Code 0.27.0 升级到 0.29.2，并完成服务生命周期和运行时完整性适配。

升级亮点

• 锁定 Kimi Code 0.29.2 六平台 runtime、官方 manifest 与 SHA-256。
• 适配 0.28.1+ 前台 kimi web --no-open 生命周期，停止服务不再调用已移除的 kimi web kill/ps。
• 保持现有 /api/v1 REST 与 /api/v1/ws 客户端边界，兼容 0.29.2 的 kap-server 后端。
• 0.27/0.28 的历史 harness 补丁已由上游吸收，升级后不再重复应用。
• 补充 0.29.2 上游差异审查与发布前验证记录。

发布验证

• npm test
• npm run typecheck
• npm run build
• npm run runtime:smoke
• npm run runtime:upstream:check

已知限制

• GitHub Actions 负责 Windows 与 macOS 安装包构建；当前 macOS 产物仍为 Apple Silicon arm64。
• 正式发布使用官方锁定 runtime；后续如生成 Farside 自有 runtime 产物，需要另行完成六平台产物门禁。

完整变更

v0.2.1...v0.2.2

安装包校验

• Farside Setup 0.2.2.exe · 127.9 MiB · SHA-256 fcdee14cacec4afabc584f5cbab1221a18e54379b3c432a1bc10bd54ba641b33
• Farside-0.2.2-arm64.dmg · 165.5 MiB · SHA-256 503e7c73924817beb871657dcee4b23c4bc7590fabeed314238e81b330b5c675

v0.2.1

Farside 0.2.1 · 控制台、远程连接与可靠执行

这一版把设置页扩展为更完整的 Farside 控制台，同时集中修复更新、任务终态和待确认交互中容易让用户失去判断的问题。

升级亮点

• 账户页新增额度加油包、官方 API Key 接入、本机登录设备和模型／工具使用记录。
• 新增“个人资料”，用本机会话统计 Token 活动、连续使用天数、任务纪录、推理偏好及常用技能与工具。
• 配置文件新增按项目管理的 Hooks；新增“连接”模块，可通过 SSH 隧道远程控制另一台机器上的 Kimi 工作区。
• 修复额度耗尽、限流、鉴权失败或服务异常时仍显示“已完成”的问题，并让待确认卡片实时出现。
• 更新系统增加手动检查、版本历史、详细更新日志和安装后自动重启；macOS 更新可自动清除 Farside 的 quarantine 属性。

账户与个人资料

更完整的账户控制台

• 保留套餐、5 小时窗口与周周期，并新增额度加油包余额、本月消费和额度上限。
• “充值与管理”直接进入 Kimi 官方额度页面。
• 新增 API Keys 卡片，展示已经接入 Farside 的 Kimi 官方 API Provider，并提供官方控制台管理入口。
• 新增登录设备卡片，明确当前 Farside、系统平台、架构、Electron 版本和 Provider 状态；完整设备列表仍由 Kimi 官方控制台管理。
• 新增模型调用与工具调用记录，便于定位近期请求状态和使用来源。

本机个人资料

• 展示累计 Token、单任务峰值 Token、最长任务时长、当前连续天数和最长连续天数。
• Token 活动支持每日、每周和累计视图。
• 汇总快速模式占比、最常用推理强度、任务总数、已探索技能和技能调用次数。
• 展示最常使用的 Skills 与 Tools。
• 统计只读取本机 Kimi 会话，不会上传新的个人分析数据。

配置文件、Hooks 与连接

项目级 Hooks

• 在“设置 → 配置文件”新增 Hooks 管理界面。
• Hooks 以项目为单位保存到 .farside/hooks.json，不同工作区互不影响。
• 支持事件、matcher、command、描述和启停状态，并在保存前校验结构与大小。

Remote / SSH

• 新增 SSH 连接档案，可保存主机、端口、用户、私钥、远程 Kimi 路径、数据目录与服务端口。
• 支持测试握手、建立连接、断开连接、编辑和移除。
• 远程控制通过经过认证的 SSH 隧道工作，两端 Kimi Server 继续只监听回环地址。
• 支持系统 SSH Agent、~/.ssh/config 或指定私钥，不读取和保存 SSH 密码。

执行可靠性与状态反馈

• 区分真正完成与执行中断；服务端未返回完成信号时不再把 Session 标为“已完成”。
• 对额度不足、限流、登录凭据失效和一般服务错误给出可理解的错误说明。
• 服务端暂时不可达时保持“收尾中”，避免根据连接中断反向猜测任务已经完成。
• 审批和问题卡片收到待处理信号后立即同步，并通过短时重试和 Session snapshot 补偿竞态，不再依赖切换页面刷新。
• 短时深空思考显示实际的短时长，不再轻易退化成“时长未知”。

更新与关于

• “设置 → 关于”新增检查更新、仓库地址、当前版本、更新日志与历史版本。
• 启动检查增加 GitHub Release 页面降级通道，匿名 API 受限或网络环境特殊时仍可识别新版本。
• 一键更新显示下载进度并直接打开对应平台安装包。
• Windows 安装器接管后退出旧版本，并在安装完成后启动新版本。
• macOS 会等待 /Applications/Farside.app 完成替换，自动运行 xattr 清除 quarantine；普通权限不足时请求管理员授权，随后自动重启。
• macOS 的一键更新按钮旁会明确说明上述行为。

发布说明改进

• Release 优先读取 releases/vX.Y.Z.md 的手写说明。
• 没有手写说明时，生成器会按功能、修复、性能、兼容性和工程维护分类，并保留提交正文中的有效细节。
• 自动附带安装包名称、文件大小、SHA-256 和完整版本对比链接。

下载与安装

• Windows：Farside.Setup.0.2.1.exe
• macOS Apple Silicon：Farside-0.2.1-arm64.dmg

升级前建议结束正在执行的 Agent 任务。安装包不会主动删除本地项目、Kimi 配置、连接档案或会话数据。

macOS 安装包未使用 Developer ID 签名。一键更新会在安装完成后自动清除 /Applications/Farside.app 的 quarantine 属性；必要时 macOS 会显示管理员授权框。

发布验证

• npm test
• npm run typecheck
• npm run build
• 校验 Release 工作流和详细说明生成器
• Windows 与 macOS 安装包均成功构建后才创建正式 Release

已知限制

• macOS 当前仅提供 Apple Silicon（arm64）安装包。
• Kimi Server 尚未开放完整的云端登录设备和 API Key 管理接口；这两类云端操作会跳转到 Kimi 官方控制台。
• macOS 通过浏览器手动下载和安装时不会启动 Farside 的安装监视器；自动清除 quarantine 与重启仅适用于应用内“一键更新”。

完整变更

v0.2.0...v0.2.1

安装包校验

• Farside Setup 0.2.1.exe · 127.7 MiB · SHA-256 03c421a4d1ea1726dc70eab5eb92cef0df5b62c3d17729bd5612fff604b8450c
• Farside-0.2.1-arm64.dmg · 165.2 MiB · SHA-256 e2efca578fec328e42594c39fffb266c28d30ac3448fd6f6d819d0266e14a05a

v0.2.0

Farside 0.2.0 · 交互与稳定性升级

这一版集中改善长任务操作、会话回溯与 Runtime 稳定性，并将随包 Kimi Code Runtime 统一适配到 0.28 系列。

升级亮点

• 新增请求队列：Agent 正在执行时仍可继续编写和安排下一条请求，不再因为输入时机丢失工作。
• 新增 Plan 审阅卡：计划型任务可在继续执行前集中查看并确认计划。
• 新增逐轮文件变更与选择性撤销：每轮完成后能看到具体改动，并按范围回退。
• 新增环境摘要：把工作区、Git、Runtime 和会话上下文集中到任务轨迹中。
• 统一 Runtime 供应链并适配 Kimi Code 0.28，增强协议兼容性、校验和异常恢复。

交互与会话

请求队列

• Agent 忙碌时，新请求会进入可见队列。
• 队列项目可以重新编辑或移除，避免用户不知道下一条请求是否已经提交。
• 会话列表和输入区的执行状态进一步统一。

Plan 审阅

• 新增独立的 Plan Review 卡片。
• 权限确认、Agent 提问与计划审阅采用一致的待处理交互模式。

变更回溯

• 新增每轮文件变更卡片，区分新增、修改与删除。
• 新增选择性撤销界面，可按具体改动范围恢复，而不是只能整体回退一轮。
• 非 Git 工作目录会显示可理解的说明，不再直接暴露原始 Git 错误。

任务轨迹

• 新增环境摘要，集中显示工作区和运行环境信息。
• 丰富子代理状态和任务进度显示。
• 优化会话标题栏、终端入口和轨迹布局。

账户与更新

• 账户弹层新增“检查更新”，有新版本时直接打开更新弹窗，已是最新版时显示明确结果。
• 更新状态进入共享 Store，避免不同入口显示不一致。
• 设置页默认进入账户模块，减少首次配置后的查找成本。
• 改进 OAuth 登录状态恢复，降低授权流程被刷新或重启打断后的异常概率。

Runtime 与兼容性

• 随包 Runtime 统一适配 Kimi Code 0.28。
• Runtime 锁文件、上游版本检查和产物校验流程重新整理。
• 增强实际 daemon 地址识别，不再依赖固定端口。
• Runtime 补丁覆盖工具结果 token 预算、REST harness 控制与渐进式内置工具加载。
• 新增上游兼容性检查和 Runtime smoke 验证，协议不匹配时会明确失败。

界面细节

• macOS 无边框窗口不再重复显示系统交通灯。
• 优化标题栏、任务输入区、Session 列表与 Diff 面板的状态表达。

下载与安装

• Windows：Farside.Setup.0.2.0.exe
• macOS Apple Silicon：Farside-0.2.0-arm64.dmg

升级前请先结束正在执行的 Agent 任务。安装包不会主动删除本地项目、Kimi 配置或会话数据。

当前安装包未进行商业代码签名，Windows 或 macOS 可能显示系统安全提示。

发布验证

• Windows 与 macOS 均执行自动化测试和 TypeScript 类型检查。
• 验证 Runtime 锁文件、manifest、上游版本与补丁应用。
• 验证 Kimi Server endpoint 发现、OAuth 状态与逐轮文件变更。
• 两个平台安装包均成功构建并上传后才发布 Release。

已知限制

• macOS 当前仅提供 Apple Silicon（arm64）安装包。
• 自动更新仍依赖客户端能够访问 GitHub Releases。
• 未签名安装包首次启动时可能需要在系统安全设置中确认。

完整变更

v0.1.3...v0.2.0

v0.1.3

更新内容

• 修复长对话历史被截断：加载会话时自动补齐完整聊天记录
• 修复「改动」页空白与切换卡顿，并增加加载状态提示
• 修复「遥测」页速率、API 估算等读数时有时无
• 多段深空思考产生的遥测行折叠为单行实时更新，不再顶走对话
• Swarm 子代理卡片改为紧凑的横向滑动布局
• 一键更新改为应用内直接下载并自动打开安装包（带进度条），不再跳转浏览器
• 修复 AI 执行期间切换权限模式不生效的问题，切换即时同步到当前会话
• 修复审批同步的「Invalid input: expected "pending"」链路警告

Full Changelog: v0.1.2...v0.1.3

v0.1.2

Full Changelog: v0.1.1...v0.1.2

v0.1.1

Full Changelog: v0.1.0...v0.1.1

v0.1.0

Full Changelog: https://github.com/dandandujie/Farside/commits/v0.1.0