Repository navigation
Releases
Releases · kirineko/neko-harness
neko-harness 0.5.6
修复
- 修复技能市场页面报「市场目录加载失败 … Skill list failed with HTTP 404」的问题:默认市场地址
https://skill.kirineko.tech只含域名时,请求被拼成//api/skills而返回 404,导致目录、搜索、预览与安装都不可用。现在市场地址无论是否带结尾/或路径前缀,都会拼出正确的接口地址
兼容性
- 桌面端应用协议与移动端 API 版本均不变,移动端 App 无需更新
- 已有的
~/.neko/neko.sqlite原地沿用,存储格式未变
neko-harness 0.5.5
重要:运行时由 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,按下面的步骤迁移:- 退出所有 neko 界面与服务
- 安装 Node.js 22.19 及以上
- 卸载旧安装:
bun remove --global neko-harness - 用 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
新增
- 运行失败原因与「继续」:一轮运行没有得到回答就结束时(模型请求失败、用户停止、被中断、达到轮次上限等),输入区上方会显示原因与错误详情。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
新增
- 新增 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
新增与改进
- 升级到 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
修复与改进
- 英文 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
新增
- 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.Ztag 即发版;验证(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
新增
- 界面语言:Web、TUI、移动端都支持中文 / English,默认中文,三端偏好互相独立,不经网关、不改应用协议
- Web:设置页「语言」(
/settings/language),存浏览器 localStorage,跨标签页同步 - TUI:
--lang zh|en> 环境变量NEKO_LANG> 已保存 > 中文;/language即时切换并保存,neko tui --help随语言输出 - 手机端:设置里的语言选择器(与主题选择器同处),跟随应用而非系统语言
- Web:设置页「语言」(
- Web 外观设置:主题(樱花 / 纸白 / 夜墨)与聊天排版(字体、字号、字重、行高),设置页
/settings/appearance,只存浏览器本地
实现说明
- 三端使用类型化字典,中英文键与占位符一致由测试保证;命令名、工具名、provider / 模型名等受保护术语不翻译
- core 推送的英文状态与错误前缀在前端映射成当前语言,映射不到的原样显示
- 日期按语言使用 zh-CN / en-GB 格式
- 新增防回退扫描测试,阻止在已迁移目录里再写中文字面量
已知限制
- 网关自己拼的中文错误在英文界面下仍是中文
- TUI 英文文案沿用原有写法,句末标点风格尚未统一
内部
- 测试套件去掉真实等待,全量耗时约 165s → 约 79s
neko-harness 0.4.8
新增
- 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
新增
- 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 状态字段,不提升应用协议