Skip to content

Releases

neko-harness 0.5.6

Choose a tag to compare

@github-actions github-actions released this 13 Nov 08:06

修复

  • 修复技能市场页面报「市场目录加载失败 … Skill list failed with HTTP 404」的问题:默认市场地址 https://skill.kirineko.tech 只含域名时,请求被拼成 //api/skills 而返回 404,导致目录、搜索、预览与安装都不可用。现在市场地址无论是否带结尾 / 或路径前缀,都会拼出正确的接口地址

兼容性

  • 桌面端应用协议与移动端 API 版本均不变,移动端 App 无需更新
  • 已有的 ~/.neko/neko.sqlite 原地沿用,存储格式未变

neko-harness 0.5.5

Choose a tag to compare

@github-actions github-actions released this 13 Nov 07:38

重要:运行时由 Bun 改为 Node.js

从这个版本起,neko 运行在 Node.js 上,用 npm 安装;不再支持 Bun 运行与 bun add --global 安装。

  • 新安装:需要 Node.js 22.19 及以上(推荐 24),然后 npm install -g neko-harness
  • 从 0.5.4 及更早版本升级,请不要运行 neko update,按下面的步骤迁移:
    1. 退出所有 neko 界面与服务
    2. 安装 Node.js 22.19 及以上
    3. 卸载旧安装:bun remove --global neko-harness
    4. 用 npm 安装:npm install -g neko-harness
  • 会话、设置与密钥仍在 ~/.neko/,原样沿用,不需要处理
  • 如果已经在旧版本里运行了 neko update:它会把 Bun 全局安装升级到本版本。macOS / Linux 上没有 Node.js 的机器随后无法启动 neko;装了 Node.js 的机器可以启动,但之后的 neko update 会提示当前安装方式不支持自升级。两种情况都按上面的步骤 3、4 重新安装即可

新增

  • 支持 npm 安装与 Node.js 运行:npm install -g neko-harness 后,neko tui、neko web、neko serve、neko update 均可用
  • Node.js 版本过低时,neko 的任何命令都会直接说明需要的最低版本与当前版本并退出,不再出现难以理解的加载错误
  • neko update 改为升级 npm 全局安装:
    • 源码、项目局部安装、npm link、Bun 或其他包管理器的全局安装不支持自升级,会提示改用 npm install -g neko-harness
    • 当前用户对 npm 全局目录没有写权限时,停止并给出手动命令,不会尝试提权
    • Windows 仍只显示手动升级指引,命令改为 npm install -g neko-harness@latest;TUI 的新版本提示同步修改
  • 网关的 Unix socket 路径超过系统上限时,启动失败的说明会写明路径、字节数与上限,并提示用 --storage 或 --socket-path 换成更短的路径

已知限制

  • macOS / Linux 上,数据目录的路径过长时网关无法启动:Node.js 不能监听超过系统上限的 Unix socket 路径(macOS 103 字节,Linux 107 字节),socket 文件默认在数据目录下。默认的 ~/.neko 不受影响;用 --storage 指到很深目录的用户需要换成更短的路径,或用 --socket-path 另行指定。此前在 Bun 上没有这个限制

兼容性

  • 已有的 ~/.neko/neko.sqlite 原地沿用,存储格式未变
  • 桌面端应用协议与移动端 API 版本均不变,移动端 App 无需更新
  • 安装时不再出现 ws 的 peer 依赖警告

内部

  • 开发工具链由 Bun 迁移到 pnpm 与 Node.js:测试改用 vitest,发布打包改用 rolldown,脚本由 Node.js 直接运行;仓库不再依赖 Bun
  • 发布流水线在 Linux、macOS、Windows 上用 npm 安装打包产物并在 Node.js 上冒烟,Linux 另用最低版本 22.19.0 再验证一次
  • OpenSpec 变更 migrate-runtime-to-node、migrate-toolchain-to-pnpm 已归档

neko-harness 0.5.4

Choose a tag to compare

@github-actions github-actions released this 07 Nov 12:40

新增

  • 运行失败原因与「继续」:一轮运行没有得到回答就结束时(模型请求失败、用户停止、被中断、达到轮次上限等),输入区上方会显示原因与错误详情。Web 提供「继续」按钮,TUI 使用 /continue,在原有上下文上接着运行,不会新增用户消息;移动端只显示原因
  • 配置文件新增可选的 maxTurns:限制新会话及其子 agent 单次运行的工具轮次(≥ 1 的整数,默认不限制)。达到上限的运行会停下,可用「继续」接着运行

实现说明

  • 计划批准或要求修改,与随后的执行输入在同一次提交中保存:要么都生效,要么都不生效,网关恰好在此时重启也不会出现「已批准却没有开始执行」
  • 进程在模型回答途中崩溃后,不再无限重发同一个请求:按重试策略计为一次失败,重试用尽后该轮以「运行被中断」结束
  • 反复让进程崩溃的任务在第 5 次后直接结束并显示原因,不再卡在忙碌状态
  • 长会话不再因上游视图改为有界窗口而丢失中间条目;上下文占用只按压缩或新上下文之后的内容计算

兼容性

  • 已有的 ~/.neko/neko.sqlite 原地沿用,无需清理。但升级后一旦写入,就不能再用 0.5.3 及更早版本打开,请勿回退;如需回退,请先备份该文件
  • 桌面端应用协议与移动端 API 版本均不变;新字段与 /continue 为可选能力,新旧客户端与网关混用时会自动隐藏不支持的入口

内部

  • 升级到 Pi 1.5.0(pi-durable、pi-ai、chord、pi-env、pi-tui、pi-codemode 均精确锁定),新增 @earendil-works/pi-schema,移除 TypeBox;所有契约、工具参数与移动协议的 JSON 形状保持不变
  • 完成 core、网关、Web、TUI、移动端及发布包测试;OpenSpec 变更 upgrade-pi-sdk-1-5 已归档

neko-harness 0.5.3

Choose a tag to compare

@github-actions github-actions released this 25 Oct 10:36

新增

  • 新增 codemode:模型可以编写 JavaScript 脚本,在 QuickJS 沙箱中批量、链式调用工具,只把脚本筛选后的输出带回对话,减少多轮工具调用和中间结果占用的上下文。脚本在运行中遇到网关重启后可恢复,已完成的嵌套工具调用不会重复执行
  • 提供 off / on / only 三种模式,默认 off。可通过 Web「设置 → Codemode」、TUI /codemode 或配置文件 codemode.mode 修改;on 同时提供普通工具和脚本工具,only 主要由脚本调用其他工具。设置只影响之后新建的会话,已有会话保持不变
  • Web、TUI 和移动端的 codemode 工具卡展示脚本与嵌套调用;Markdown、HTML、JSON 导出同样保留这些内容。脚本中成功的文件编辑也会计入「本次改动」
  • 嵌套调用沿用原有安全边界:plan 模式只读限制和 explore 子 agent 的 Bash 逐次审批仍然生效。沙箱最多同时运行 2 个 worker、每个限 256 MiB,排队等待上限 60 秒

兼容性

  • 桌面端应用协议从 9 升到 10:网关与 Web / TUI 客户端需一同升级,协议不同的连接会被拒绝
  • 移动端 API 保持 v1 不变;移动端只新增 codemode 卡片展示,没有设置入口
  • codemode 默认关闭,未启用时的现有会话和工具行为不变;升级前创建的会话按 off 处理
  • 脚本不提供分类器和图片生成等 models.* 能力,避免绕过模型服务的启用与凭据限制

内部

  • 基于 Pi 1.4.0 的 pi-durable/codemode 与 pi-codemode,新增直接依赖并继续精确锁定版本
  • 完成 core、网关、Web、TUI、移动端及发布包测试;OpenSpec 变更 add-codemode 已归档

neko-harness 0.5.2

Choose a tag to compare

@github-actions github-actions released this 24 Oct 08:56

新增与改进

  • 升级到 Pi 1.4.0(chord / pi-ai / pi-durable / pi-tui / pi-env 同步精确锁定):会话命名的等待改为可跨重启的睡眠,进程在等待期间重启后会按原到期时间继续生成标题;子 agent 排队等待槽位时关闭或中止不再遗留任务
  • 压缩触发百分比(Web「上下文」设置、TUI /context、配置文件 context.compaction.triggerPercent)现在按每个模型自己的上下文窗口计算,不再取所有可选模型里最小的窗口。选定的百分比对任何模型都是「该模型窗口的这个比例」,启用或停用 provider 不再改变阈值
  • 模型请求的 User-Agent 与 provider 归属显式固定为 Pi 的身份(pi/<版本> (...)),兼容只识别 Pi 客户端的模型厂商;请求内容与之前一致
  • 终端界面:退出时由 pi-tui 同步恢复终端模式,Markdown 中 CJK 标点旁的加粗 / 斜体、未闭合的 $$ 块后表格的渲染问题随 pi-tui 一并修复

兼容性

  • 本地数据库不可回退:Pi 1.4 打开 SQLite 存储时自动迁到 schema v2,迁移后 0.5.1 及更早版本无法再打开 ~/.neko/neko.sqlite。升级后如需回退到旧版本,请先备份该文件。自动迁移由 Pi 完成,本版本没有用真实旧数据验证迁移过程
  • 设置了压缩触发百分比的用户:大窗口模型会更早压缩。例如 1M 窗口设 80%,以前约在 99% 才压缩,现在在 80% 压缩;小窗口模型基本不变。没设置百分比(默认)时行为不变
  • 应用协议仍为 9,手机端 API v1 不变,网关与客户端可按原方式配合使用

已知限制

  • 同一后台任务被进程崩溃连续截断 5 次且没有提交新状态时,会被停放,不再自动重启;停放事件只经宿主错误通道报告一次,界面暂无查看或重试入口(恢复入口留待后续版本)
  • 本版本未在 Windows 上做真机验证(发版流水线会在 Windows 上跑构建、测试与安装冒烟)

内部

  • 所有文档定义显式声明 checkpointWhen(Pi 1.4 要求);新增睡眠重启、崩溃停放、按模型阈值与请求身份的测试
  • AGENTS.md 更新为 Pi 1.4 使用要点;OpenSpec 归档 upgrade-pi-sdk-1-4 与 adopt-pi-1-4-settings

neko-harness 0.5.1

Choose a tag to compare

@github-actions github-actions released this 22 Oct 19:27

修复与改进

  • 英文 README 里的 Web 界面标签改为英文界面的实际名称(Settings → Model services 等),不再引用中文标签;补充 Web「外观」(主题与聊天排版)与「语言」设置的说明
  • 文档按主题重新归位并新增 docs/README.md 索引;删除过时的首次发布与 Pi 1.2 验证清单;核对并修正 AGENTS.md、移动端 README 中不再准确的描述

兼容性

  • 功能与协议不变(应用协议仍为 9,手机端 API v1 不变),可直接升级
  • Bun:开发基线升到 1.4.4,engines 放宽为 >=1.4.0 <1.5.0;推荐 1.4.4,任意 1.4.x 可用(1.4.0 / 1.4.1 未实测)

内部

  • @types/bun 升到 1.4.3(npm 上的最新版,没有 1.4.4);bun.lock 只更新类型包条目
  • 文档路径变更:.github/RELEASING.md → docs/dev/releasing.md,docs/mobile-api-v1.md → docs/mobile/api-v1.md

neko-harness 0.5.0

Choose a tag to compare

@github-actions github-actions released this 22 Oct 18:49

新增

  • Web 工作区移除:切换器里每个项目都有移除按钮(悬停 / 聚焦显示,触屏常驻),点击后确认
    • 只是从列表里隐藏:不删除文件,也不归档会话;该项目的会话随之隐藏,重新添加同一目录即可恢复
    • Web 服务的启动目录(置灰并说明原因)、最后一个项目、有运行中会话(或正在等待回答 / 计划决定)的项目不能移除
    • 移除当前项目后自动切到列表里的下一个
  • Web 右侧面板可调宽:工作区、后台任务、子 agent 三个面板共用一个宽度(320–960px,默认 560px,且不超过视口 60%)
    • 拖拽边缘,或用键盘 ←/→(Home/End 到最小 / 最大),双击恢复默认
    • 宽度记在浏览器本地,刷新和新开标签页保持;窄屏仍是抽屉 / 全屏

实现说明

  • 移除用独立的「已移除路径」记录实现:启动时按已有会话重新登记、fork 这类隐式登记会跳过它,用户显式添加(目录选择、新建会话指定目录、网关启动目录)才会清除,所以不会“复活”
  • 面板宽度偏好只存浏览器 localStorage,不经网关,TUI 与手机端不受影响

已知限制

  • TUI 与手机端没有移除项目的入口,只会正确跟随目录变化
  • 面板宽度不跨浏览器、不跨机器同步

兼容性

  • 应用协议由 8 升到 9(neko.workspaces 契约 v2 新增 remove),不保留旧网关降级:升级后请退出所有 neko 界面与服务再启动,旧版本的界面或网关会得到协议不兼容提示
  • 手机端 API(v1)不变

内部

  • 测试默认多 worker 并行:全量约 85s → 约 12s;bun run test:serial 保留原顺序执行,用于排查时序问题
  • 发布流程合并为单个 release.yml,推送 vX.Y.Z tag 即发版;验证(Linux / macOS / Windows 全量测试与安装冒烟,Android 检查与构建)全部通过后才发布 npm 并创建 Release,发布说明来自 docs/releases/
  • Windows 首次纳入 CI 并作为发布门禁;Linux 改用 Ubuntu 26.04,GitHub Actions 升级到新的主版本,不再有 Node 20 弃用警告
  • 适配 Bun 1.4.4(测试侧):node:http upgrade socket 的行为变化,以及若干 Windows 路径 / 时序问题

neko-harness 0.4.9

Choose a tag to compare

@kirineko kirineko released this 21 Oct 19:13

新增

  • 界面语言:Web、TUI、移动端都支持中文 / English,默认中文,三端偏好互相独立,不经网关、不改应用协议
    • Web:设置页「语言」(/settings/language),存浏览器 localStorage,跨标签页同步
    • TUI:--lang zh|en > 环境变量 NEKO_LANG > 已保存 > 中文;/language 即时切换并保存,neko tui --help 随语言输出
    • 手机端:设置里的语言选择器(与主题选择器同处),跟随应用而非系统语言
  • Web 外观设置:主题(樱花 / 纸白 / 夜墨)与聊天排版(字体、字号、字重、行高),设置页 /settings/appearance,只存浏览器本地

实现说明

  • 三端使用类型化字典,中英文键与占位符一致由测试保证;命令名、工具名、provider / 模型名等受保护术语不翻译
  • core 推送的英文状态与错误前缀在前端映射成当前语言,映射不到的原样显示
  • 日期按语言使用 zh-CN / en-GB 格式
  • 新增防回退扫描测试,阻止在已迁移目录里再写中文字面量

已知限制

  • 网关自己拼的中文错误在英文界面下仍是中文
  • TUI 英文文案沿用原有写法,句末标点风格尚未统一

内部

  • 测试套件去掉真实等待,全量耗时约 165s → 约 79s

neko-harness 0.4.8

Choose a tag to compare

@kirineko kirineko released this 21 Oct 16:38

新增

  • Plan 模式(只读规划 + 批准后执行):用 Web 的 /plan、TUI 的 /plan 或 Shift+Tab 把会话切到只读规划模式。agent 先调研(只读工具集 + bash 只读命令白名单),再用新工具 submit_plan 提交结构化计划(标题 / 步骤 / 说明)并结束本轮,会话进入「等待批准」。用户批准后自动退出模式并立即按计划执行;「要求修改」附带反馈时留在 plan 模式重新规划
  • 计划是持久文档 app.neko.plan:按版本幂等结算、首次有效决定生效;停止、归档、离开 plan 模式会把待批准计划置为已取消,重启保留待批准计划。批准后提交的执行输入以 plan-exec:<版本> 受理,投影为带 planDecision 的 system 项
  • 待批准时各处都有标记:Web 输入区模式标识 + 会话列表角标、TUI 页脚 PLAN 标识、移动端会话「等待批准」,新计划到达时 Web 卡片与 TUI 面板自动打开
  • 「取消并退出计划模式」复用普通模式切换:Web 计划卡片、TUI 计划面板(X 键)、移动端 plan.exit(手机只能退出,不能进入 plan 模式)

Web

  • /plan 斜杠命令切换与模式标识、消息流中的计划卡片与历史行(批准 / 要求修改 / 取消并退出);步骤与说明按消毒后的 Markdown 渲染,标题与反馈仍是纯文本

TUI

  • /plan、Shift+Tab 切换;计划面板支持批准 / 反馈修改 / 取消并退出,↑/↓ 选择、X 退出模式;计划到达自动打开(每个版本只一次),与排队区键位冲突已处理,面板与状态栏统一英文

手机端

  • 移动 API v1 新增 plan 能力与 plan.get / plan.respond / plan.exit / plan.changed,App 内新增计划 sheet、会话待批准标记;手机只能查看与决定计划

限制

  • plan 模式只读三层:移除 edit / write / job、扩展 beforeTool 拦截、bash 执行端白名单复核。isSafeCommand 按引号外切段逐段校验并拒绝危险参数,是护栏不是沙箱

兼容性

  • 应用协议不变:ChatView.plan、SessionSummary.awaitingPlan、planGet / planRespond / planMode 均为可选能力,连旧网关的前端自动隐藏入口
  • 移动 API v1 只做增量字段与能力追加,旧版 App 不受影响;排队输入与 steer 会等计划结算后再进入上下文

文档

  • README 改为英文主页并新增 docs/README.zh-CN.md 中文主文档,补充 Plan 模式与手机端说明

neko-harness 0.4.7

Choose a tag to compare

@kirineko kirineko released this 19 Oct 20:23

新增

  • Windows 支持:网关、测试与打包冒烟可在 Windows 上运行
  • Windows 上的 bash 工具、后台任务与子 agent 统一使用 Git Bash(需安装 Git for Windows,neko 自动查找);不使用 WSL 的 bash.exe。没有 Git Bash 时 neko 仍可启动,TUI 与 Web(聊天页横幅、关于页)会提示,命令类工具返回明确错误
  • 网关新增 --stop-on-stdin,Windows 上前端通过关闭 stdin 优雅停止网关,退出时清理端口文件

修复

  • Windows:修复资源管理器无法打开;frontmatter、AGENTS.md、资源读取容忍 BOM;文件重命名带重试;凭据锁残留回收;技能覆盖安装改为备份式替换;TUI /export 支持 ~\
  • 修复 macOS CI 上文件补全测试因枚举整个仓库而超时
  • 修复 WSL 开发机上移动端 e2e 测试全部失败

兼容性

  • 网关应用信息新增可选 shell 状态字段,不提升应用协议