v2.26.6
最新
修复
- 修复引导页接入 Orosus 时写坏配置:一键接入写入的 hooks 配置块末行与结束标记粘连成一行,Orosus 解析该配置失败、钩子功能整体不生效;现在每行独立换行,写入即可用
- Orosus 触碰记账改挂正确事件:文件写/改的记账钩子从工具执行前挪到执行后——事前跑会把「未遂的写」(工具可能被审批拒绝或执行失败)也记进台账,且执行后才能读到工具结果
说明
- 仅影响 Orosus 接入路径,其余 agent 接入与既有功能无变化;已装上一版并接入 Orosus 的用户升级后下一次提问即自动修正配置,或到引导页重装一次立即生效
v2.26.5
新功能
- 引导页新增 Orosus 卡片:自研模块化 AI 编程助手 CLI 一键接入——知识注入、触碰记账、规则评估三条 hook 自动写入 Orosus 的 hooks 配置,安装/自愈/卸载与 ZCode、Codex 同款;本机装有 Orosus 时自动出现
- OkMeter 用量总览弹窗:趋势图与 Token 活动图按日/周/月/年查看用量,图例点击过滤、按模型下钻,多提供商配色两两可辨
修复
- 修复多端同步空远端首推死锁:远端仓库为空或被重建时拉取永远失败、推送永远执行不到,本地提交无限堆积;现在自动识别该场景降级直推,一次同步自愈
说明
- 无知识库数据与配置格式变化;OkMeter 新增消息轮数计数,旧统计文件兼容(从 0 起计),用量口径不变
v2.26.4
修复
- 升级后配置中心与悬浮条自动回来:此前一键升级会强制关闭配置中心与 Token 监视器,装完只拉起 daemon——两者就此消失需手动重开;现在安装器关闭进程前记录运行快照,装完原样恢复,交互式与静默升级一致,且交互快速升级不会重复打开配置中心
- 修复升级后偶发配置中心未自动打开:等待 daemon 就绪的预算从 3 秒放宽到 30 秒——升级后新程序冷启动常超过 3 秒,旧预算会误判未就绪直接退出
说明
- 升级体验修复小版本,无数据与配置格式变化;从低版本升到本版时执行安装的仍是旧版安装器,恢复行为从本版往更高版本升级时开始生效
v2.26.3
改进
- 升级安装全程零点击:安装版本不低于现有版本时,安装程序自动跟随上次安装的语言、跳过全部向导页、自动关闭占用文件的进程,装完直接打开配置中心并收起向导;首次安装与降级安装流程不变
- 悬浮条收缩态展开方式可配置:设置面板新增「展开方式」——悬停(默认,进入即展开)或单击(左键单击条目才展开);展开后悬停详情卡与离开自动回缩两种模式一致
说明
- 本次为体验改进小版本,无数据与配置格式变化,升级不影响已有的指标映射、吸附边等设置
v2.26.2
新功能
- 悬浮条支持吸附屏幕顶部 / 状态栏上方:吸附边从左/右扩到四边,上/下吸附时为横向居中簇状条;收缩态变换为只显名称与读数的迷你条目排,展开⇄收缩为逐项渐变动画,鼠标离开自动回缩,切换视觉形态全程无闪烁;详情卡、右键菜单、设置面板按吸附方向自动调整弹出方位;波形流横向时恒从左往右流
改进
- 右键「模型」菜单改按真实提供商分组:同一模型被多个 Agent 使用时归到同一提供商下(如月之暗面旗下的 k3、k3-256k),不再按工具名分散成多列;同名模型的三级项标注来源工具(如 k3 · kimi-code)
说明
- 升级不影响已有的指标映射与吸附边配置,原左/右竖条形态的行为逐像素不变
v2.26.1
新功能
- OkMeter 支持九家 Agent 采集:Kimi Code 之外新增 Claude Code、Codex、Qwen Code、ZCode、WorkBuddy、Reasonix、OpenHanako、DeepSeek Harness 八个适配器——各家本地会话日志的 token 用量自动进统计,右键「模型」菜单按工具分组呈现;各目录均有变更监听,有新数据即时刷新
改进
- 波形流形态启动即有全宽平线,不再等历史数据攒够;流向随缘镜像——dock 在屏幕左缘时从右往左流、在右缘时从左往右流,"现在"恒定朝向屏幕中心
- 右键菜单打开期间不再叠加悬停详情卡;设置面板指标映射下拉改用与右键一致的多级级联菜单,修复菜单自行左跑与被设置面板遮挡的问题
说明
- 各家 Agent 的 token 口径已做归一(缓存读/缓存写单独拆分);OpenCode 因用量存在 sqlite 中暂不支持
- DeepSeek Harness 的会话日志为压缩格式,统计走其会话投影缓存,模型名按默认配置近似
v2.26.0
新功能
- 中文名「归藏」:GUI 顶栏品牌区与浏览器标题随中英切换显示「归藏 / Okryptos」,官网与双语 README 补命名词源与定位语「面向 AI-Agent Hooks 的隐性知识库」
- OkMeter token 悬浮条(Windows):桌面边缘常驻的 token 用量监视条,收缩贴边、悬停滑出;总量(当前会话/今日/本周/累计)与按模型双口径,右键级联菜单即点即切;悬停详情卡;六种形态 × 四种材质,液态玻璃带真实背景折射;背板式设置面板;配置中心开关默认开启,托盘菜单可手动拉起
- LLM 本地推理两档:ollama 档免 API key 直连本机 ollama;内置托管档在 GUI 一键下载模型(qwen3 1.7B 首选 / 0.6B 最省 / 4B 非思考最稳,带进度条),下载后全自动本地推理,识别意图过滤零调用费
- 检索相关性 LLM 后置过滤:注入前把候选条目交 LLM 裁决,只删不加;未配置、超时或解析失败一律保留原结果,不影响既有检索
- 识别意图双「使用中」槽位:LLM 配置新增「识别意图」专用槽,过滤调用与通用调用可分别指定模型
改进
- 关键词通道覆盖度准入:短口语查询不再因命中虚词而误注入无关条目——命中词元数须达比例门槛,纯虚词查询跳过关键词通道
- GUI 模型配置弹窗:内置档显示模型体积与资源估算、识别意图说明分行排版、双槽徽标两行展示
说明
- OkMeter 悬浮条仅 Windows 版提供,随安装包分发(绿色版可用但无单实例守护)
- 内置托管模型需本地下载(640MB~2.5GB),运行时内存占用约 1~4GB,介意资源请选 ollama 档或远程 API 档
v2.25.0
改进
- 产品改名 Okryptos:仓库、安装包(
OkryptosSetup-<版本>.exe)、安装目录、数据目录(~/.okryptos)、注入前缀、托盘/窗口标题、官网与文档全面切换;命令行简写 ok/okd/okserver/okdeploy/OkManager 不变 - 升级即自动迁移:数据根
~/.openknowledge整体迁移为~/.okryptos(幂等);各 AI 助手的 hooks 插件/扩展换新名并清除旧件;已安装的 openknowledge-* 技能副本替换为 ok-*;Windows 旧自启项一并清理,无需手工操作 - 服务端镜像新名双发:
z7dream/okryptos-okserver(GHCRghcr.io/zhangxyfs/okryptos/okserver),过渡期旧名续发;已有 NAS 部署在 okdeploy 管理页点「升级」即自动切换,数据卷不受影响
说明
- 存量兼容:旧版安装目录、deb 包名与 Linux 自启文件名保持不变;旧版客户端一键升级渠道继续可用(旧仓库地址自动重定向,新版同时信任新旧两个下载前缀)
v2.21.0
新功能
- wiki 基线读时继承:从基准分支切出的新分支不再误报「尚无基线」——本分支无游标时自动回退继承最近的可达基线(新状态 inherited,附继承来源分支),wiki 内容照常注入且落后追踪立即生效;超过
wiki.stale_commits阈值时注入行合并提示「落后 N commit,建议更新」,不重复提醒;GUI 工具栏当前分支显示绿色「继承基线」徽标,悬停可见继承来源与落后数
说明
- 继承只是检测态,wiki.json 零写入零迁移;所有游标均不可达(如从游离历史切出)仍报「尚无基线」;基准分支上的注入与旧版逐字节一致,直接覆盖升级
v2.20.0
新功能
- 跨轮注入冷却(
retrieve.dedup_turns,默认 3):同一会话里注入过的检索条目冷却 N 轮不再重复注入,到期自然回归;冷却中的条目不占 top_n 名额、由排名靠后的新条目补位;「继续」「好的」类泛化 prompt 轮同样消耗冷却轮次;上下文压缩后冷却台账一并重置;冷却期内按历史指针读取文件仍记采纳、反馈降权统计不被污染。GUI 引导页新增「跨轮注入冷却」卡(0~99,0=关闭);冷却跳过记 ok.log 可按「冷却」过滤,ok search与 GUI 搜索不受影响
改进
- 优化输出上限可配:模型配置卡新增「最大 token」单字段保存(0=默认 8192,或 1024~131072),不动 temperature 等其他高级参数
- AI 优化的参照检索按正文反引号代码片段定位行窗口,不再只看文件头;对照弹窗展示本次入/出 token 消耗;「无需优化」放宽为语义级相同判定(全半角、CJK 标点、空白与连续点号归一)
- GUI 安全加固:项目名形状校验(拒绝路径穿越段名)、浏览器打开外链前校验 URL 安全性
修复
- 推理模型优化结果为空:思考过程与正文共享同一 max_tokens 预算,默认 4096 被长思考烧穿——默认提到 8192,思考里吐答案 JSON 的情况兜底提取
- 输出触顶截断不再笼统报「非合法 JSON」,明确提示调大最大 token(finish 标记 + completion 打满上限双信号)
说明
- 冷却默认开启(3 轮),设
dedup_turns = 0完整恢复旧行为;新会话天然无冷却;无接口破坏,直接覆盖升级
v2.17.0
新功能
- 泛化 prompt 门控:「继续」「好的」「ok」这类无信息量 prompt 不再跑检索——连 embedding 网络往返都省掉;内置 21 条中英常用确认词(随版本演进),GUI 引导页新增「泛化门控」卡片 + 短语管理弹窗可维护自定义短语(与内置取并集、自动去重,单条 ≤64 字符);mandatory/索引/wiki 提醒等其余注入不受影响
- 时效信号:按条目文件 mtime 的新鲜度给检索分乘系数——新鲜窗口内 1.0、陈旧后 0.85、中间线性,窗口按条目类型分(pitfall 90/365 天、note 60/180、rule/reference 180/730);不参与准入,只在近似同分时让位;编辑条目即刷新新鲜度
- 注入→采纳反馈闭环:新增 entry_events 表记录「注入/采纳」事件——采纳 = 本会话注入过的条目被读取(post-tool 不开库,先挂账会话状态、下次 prompt 入账);30 天窗口内注入 ≥4 次且零采纳的条目降权 ×0.8(v1 只降不升)
改进
- 检索融合改 RRF(Reciprocal Rank Fusion,按名次不按分数):换 embedding 模型后余弦分布漂移不再破坏两路平衡;双通道同时命中的条目天然「交叉验证优先」;准入逻辑不变;
ok search分数输出改 4 位小数
说明
- 反馈降权默认关闭(
retrieve.feedback.enabled = false):现行所有宿主的 PostTool 钩子只派发写工具,read 不到达追踪链路,采纳信号暂恒为零,开启会误伤频繁注入的条目;注入/采纳事件照常记录,待 read 派发接通后的版本恢复默认开启 - 要旧排序行为可在配置里显式
fusion = "weighted"(旧 α/β 加权回滚档);时效与门控均可经retrieve.recency.enabled/retrieve.gate.enabled单独关闭
v2.16.2
新功能
- 日志全行时间戳:
daemon.log(含 http.Server 内部错误)与embed-sidecar.log(llama-server 输出)按行加时间戳,后者新增启动/退出分隔标记——多次启动的日志交织后也能对上时间线
改进
- 落盘写入统一原子化(同目录临时文件 + fsync + rename):INDEX.md、registry.toml、config.toml、各宿主 settings、备份导入、知识条目、wiki 游标——崩溃/断电不再留半截文件,宿主也不会读到截断的 JSON
- 注入预算按密度估算:中文按约 1 token/字、拉丁按约 4 字符/token(旧实现统一 2 字符/token,对中文为主的条目低估约 2 倍);
max_tokens误配为负数不再崩溃
修复
- 修复会话状态并发竞态:并行工具调用派发的多个 hook 进程对同一会话状态无锁读改写,互相覆盖丢 Touched(changelog 规则漏拦)、极端时
BaseInjected归零导致 mandatory 全文重复注入——新增跨进程锁 + 锁内合并 + 原子落盘 - 修复强负余弦把已过关键词门槛的命中挤出注入(语义通道不应有单方面否决权,语义分只影响排序)
- 修复
top_n截断先于分支过滤导致的注入欠额:其他分支条目被过滤后本分支条目无补位 - 修复 kimi hook 命令路径含空格时静默失效(exe 补引号,存量配置照常自愈替换);修复版本同步脚本 winres 段 sed 分隔符冲突导致同步中断
说明
- 本版为稳健性批次:注入机制无行为变化,主要修复并发与边界条件缺陷;升级安装器会先自动停止旧 daemon,日志时间戳自新 daemon 拉起后生效
v2.16.0
新功能
- 检索注入按通道独立准入:总分只用于排序,关键词通道归一 BM25 分 ≥ 阈值 或 语义通道余弦 ≥ 语义门槛才注入——宁缺毋滥、不再强行凑
top_n;新增retrieve.min_score(默认 0.5,≤0 关闭),阈值随库规模缩放(<10 条关闭、10→30 线性、≥30 取全值) - 语义门槛模型无关(
SemanticFloor):以本次查询余弦分布为参照,头部相对中位数有显著分离(retrieve.min_gap默认 0.25,可配)才启用 median+0.5·gap,无头部则语义通道整体不准入;四模型 12 场景标定(bge-m3 / bge-large-zh-v1.5 / Qwen3-Embedding-8B / qwen3-emb-0.6b) - GUI 第四标签「日志」页:
GET /api/logs回读 ok / 守护 / embedding 三来源日志尾部,2 秒轮询实时刷新,来源 chips 多选 +「仅语义」开关 + 文本过滤输入框,上滚暂停自动贴底 - 语义诊断可见化:语义通道全部候选被拒时写
prompt semantic日志(样本数/max/median/relGap),ok search同步提示调节指引;语义检索退化(模型身份缺失/切换)时注入末尾每会话一次附提示
改进
- 发布流程加固:
scripts/sync-version.sh现在同步cmd/ok/winres.json的 exe 版本资源(此前 bump 时易漏,v2.9.0 起一直漂移停在 2.8.0.0)
修复
- 修复注入知识与提问无关:CJK 二元组伪词(如"已经验证"切出"经验")命中标题即可注入、同域语料下无关文本的余弦基线(实测 bge-m3 跨域噪声高达 0.52)顶穿总分阈值——准入改按通道独立判定后,无关提问零注入、相关提问精确命中
- 修复 exe 文件版本资源自 v2.9.0 起漂移停在 2.8.0.0 的问题
说明
- 切换 embedding 模型后必须
ok index重建向量(身份守卫会拦旧向量);低对比度自定义模型可调低min_gap(必要时配合min_score)放宽语义准入;极端低对比度下语义通道整体静默关闭(fail-closed,关键词通道兜底),GUI 日志页「仅语义」可观察诊断行
v2.15.0
新功能
- 新增 dsh 适配器(第十个 AI 助手集成,DeepSeek Harness):本地 JS 插件写入
$DSH_HOME/plugins/openknowledge/index.js(头标记 + 指纹管理)+ 家目录级$DSH_HOME/cordis.patch.yml标记块挂载(file://URL,所有 profile 共享);三事件直订 Cordis 总线——agent/pre-step注入 /tools/post-execute追踪 write|edit /agent/turn-stopping经agent.steer()续跑;子进程execFile直 exec(无 shell 层);技能零适配(原生扫描~/.agents/skills)
改进
- 测试全仓 7 个注册表遍历测试文件补
OK_DSH_HOME隔离(20 处),GUI agent 计数 9→10;全仓go test ./...26 包绿
说明
- DeepSeek Harness 为 developer preview,可能有破坏性变更;本地插件必须
file:///URL 挂载(vendored cordis loader 直接import(name),Windows 盘符绝对路径报ERR_UNSUPPORTED_ESM_URL_SCHEME);真实 DeepSeek API 会话已端到端验证 prompt(注入)/ post-tool(触碰追踪)/ stop(stop_count递增)三事件,turn-stopping 续跑因默认turn_interval=5节流未在首轮触发
v2.14.0
新功能
- embedding 多服务配置(多 profile + "使用中"切换)三形态:自定义(OpenAI 兼容,key 可留空适配无鉴权服务)/ Ollama(本机或局域网,免 key,模型列表自动探测)/ 内置本地模型;旧平铺配置自动迁移为"默认"profile,无需手动干预
- 内置 llama.cpp 本地模型(完全离线、知识不出本机):llama-server sidecar 由 daemon 托管(want 拉起 / 空闲 10 分钟回收 / 崩溃有界重启 / 退出回收);模型 GGUF 按清单下载——默认 Qwen3-Embedding-0.6B(639MB,中文+代码强),另有 bge-m3 双档与 nomic 迷你档,repo/size/sha256 钉死校验、默认 hf-mirror 国内镜像、断点续传;运行时随安装包分发(llama.cpp b10405 CPU 版,Windows + Linux);模型目录默认
<安装目录>/models、可配置、弹窗可直接打开文件夹 - GUI 配置弹窗:引导页卡片显示使用中服务单行摘要;"配置…"弹窗左列表右表单(类型创建后锁定、下载进度条、显式"设为使用中"、测试按表单当前内容且 api_key 留空回退已保存)
- CLI:
ok setupembedding 步骤三选一(线上/Ollama/内置,含模型选择与下载进度);ok doctor细分内置形态检查(runtime/模型文件/sidecar 状态)
改进
- 模型身份管理:kb.db meta 记录建索引的模型身份与维度,切换后语义通道显式跳过并提示
ok index(替代以往维度不等静默归零);ok index检测切换自动清向量全量批量重建(32/批);身份不符时 Sync 阻断向量写,杜绝混合模型向量 - embed 接口拆查询/文档双路径(Qwen3 查询侧 Instruct 前缀、nomic 双侧前缀)并支持批量请求;索引/重建路径超时与 hook 查询路径解耦(下限 120s)
说明
- 迁移:≤2.13 配置自动迁移为 profile;历史向量(无身份记录)首次检索会提示并需一次
ok index全量重建。安装包体积约 50MB 级(含 llama.cpp CPU runtime;模型不随包,首次启用下载,约 146MB–639MB/档)。内置形态仅安装版可用(裸 exe 无 runtime);断网物理验证与大规模重建(≥200 条)留待后续实测
v2.13.0
新功能
- 新增 qoder 适配器(第八个 AI 助手集成,Qoder CN 终端 CLI):合并写
~/.qoder-cn/settings.json(备份 + 幂等 + 第三方条目保留),hook 契约逐字兼容 Claude Code(注入hookSpecificOutput.additionalContext、Stopdecision:block),输出协议零改动复用;自动开启hooksConfig.enabled开关(Qoder 默认关闭——不开则 hooks 装好也静默不派发);Windows 命令经ok-hook-*.cmd包装规避cmd /s引号剥离(exe 迁移自愈不重写配置);技能零适配进~/.qoder-cn/skills - 新增 qoder-ide 适配器(第九个 AI 助手集成,Qoder CN IDE 灵码内核):合并写
~/.lingma/settings.json+ 技能进~/.lingma/skills——IDE 与终端 CLI 是两套 hooks(IDE 读 ~/.lingma,不读 ~/.qoder-cn);IDE 仅 5 事件且 Stop/PostToolUse 不可阻断,知识注入与触碰追踪可用、enforce/auto 自省降级;无 enabled 门,改配置需重启 IDE 生效
改进
- 测试套件 Linux 可移植:agentx/setupx 测试夹具改平台双态(ToSlash 期望、.cmd 案例按平台期望、包装断言与 exe 迁移语义分叉),WSL(Ubuntu 22.04 + Go 1.25)Linux 全量
go test ./...与 Windows 双平台回归绿
说明
- CLI 面经官方 hooks-reference 文档与 npm 包源码双向核实;IDE 面经官方 IDE hooks 文档核实。待实测:本机未装终端 CLI(qoderclicn),CLI 版本矩阵待补;IDE 侧 hooks 派发需重启 IDE 实测
v2.12.0
新功能
- 新增 codex 适配器(第七个 AI 助手集成):合并写
~/.codex/hooks.json(备份 + 幂等 + 第三方条目保留),hook 契约逐字兼容 Claude Code(注入hookSpecificOutput.additionalContext、Stopdecision:block),输出协议零改动复用;写盘追踪解析 apply_patch 补丁头(*** Add File:等四标记),auto 自省与 enforce 规则与 Claude 同档;技能零适配——Codex 原生扫描共享~/.agents/skills;注意 Codex 信任门:安装后首次运行会提示信任 hooks(/hooks管理);hooks 在 Codex 0.118 为 under-development 特性(默认关闭)——ok 安装时自动在 config.toml 开启codex_hooks(行级手术编辑+备份),GUI 引导页附 Codex 专属说明卡;安装/自愈自动写入 hooks.state 信任记录(内容变更不再被静默跳过),Windows 命令经ok-hook-*.cmd包装规避上游引号 bug(#38168);桌面端 26.707 与 CLI 0.147+ 均实证可用
v2.11.1
新功能
- 新增 claude 生态适配器(第六个 AI 助手集成):合并写
~/.claude/settings.json的 hooks(备份 + 幂等 + 第三方条目保留),Claude Code 与 CodePilot 等 claude-agent-sdk 兼容宿主共享此文件,装一次多宿主生效;CodePilot 实测 UserPromptSubmit/Stop 均原生执行(agent 内核 settingSources 含 user 层,shadow HOME 只剥 ANTHROPIC_* env 键);技能目录~/.claude/skills
改进
- 修复:
registry.Home()对环境变量重定向免疫(Windows 走SHGetKnownFolderPath真实配置目录,其他平台os/user解析)——CodePilot 等宿主以 DB provider 运行时把子进程HOME/USERPROFILE重定向到 shadow 临时目录做隔离,旧实现跟随重定向会看到空数据根,hook 注入静默失效且无任何日志痕迹(显式覆盖口不变:OK_HOME环境变量仍第一优先)
v2.11.0
新功能
- 新增 opencode 适配器(第五个 AI 助手集成):
ok setup/ GUI 引导页一键安装全局 TypeScript 插件(~/.config/opencode/plugins/openknowledge.ts)——提问时检索注入(synthetic part,不占用界面消息位)、写盘追踪覆盖 write/edit 与 apply_patch(gpt 系模型)、回合空闲时经 SDK 补发沉淀提醒(stop 闭环);幂等安装、过期自愈、卸载干净
改进
- 「未检测到支持的 agent」提示与
ok doctor名单改为动态列举;setup 与引导页「下一步」文案不再写死 kimi
说明
- 技能零适配:opencode 原生扫描共享目录
~/.agents/skills;opencode 无 hooks 配置字段,集成形态为插件 hooks(与 pi 同构)
v2.10.1
修复
- 导出/导入纳入 wiki 状态:
state/wiki.json(基准分支 + 按分支游标 + 合并谱系)随 zip 包备份,导入时原样还原。此前导出范围只有条目与 config——删除项目知识库的「导出 zip 备份」不含谱系,重导入后 GUI 谱系行归零、wiki 游标丢失导致全量重扫
说明
- 旧备份包无 wiki.json 时跳过还原,向后兼容;条目索引仍在导入时自动重建
v2.10.0
新功能
- 新增 Linux 发布线(amd64):
.tar.gz(解压即用)与.deb(装到 /usr/lib/openknowledge/,ok 进 PATH) - Linux 桌面体验补齐:
ok gui经 xdg-open 打开默认浏览器;ok setup自动写入 XDG 登录自启,卸载时移除
说明
- Windows 行为零变化;Linux 二进制纯静态编译(无 CGO),发行版通吃
v2.9.0
新功能
- 其他页新增「删除项目知识库」:永久删除所选项目的全部知识、索引与配置,并注销注册表(hooks 不再注入该项目);项目源码目录不受影响
- 多重确认防误删:影响面明示 → 删除前导出 zip 备份(默认勾选)→「我已了解后果」勾选 + 输入完整项目名双重解锁
- 后端先注销注册表再删目录:任一步失败都偏向「保留数据」
修复
- 删除当前选中项目后不再误弹「项目未注册」错误横幅
v2.8.2
改进
- 项目下拉按最近知识更新排序:最近有写入的项目排最前,打开 GUI 默认即选中
- 刷新按钮改全量刷新:项目列表、状态、条目一次拉齐;带「刷新中… → 已刷新 ✓」反馈,防重复点击
v2.8.1
改进
- GUI 管理页表头中文化:tags → 标签,mandatory → 必注入(悬停保留原字段说明)
- 摘要列最多显示 2 行、超出省略号;悬停浮窗显示完整内容(跟随鼠标、溢出自动翻转、滚动即收起)
- 管理页每页条数 20 → 12,信息密度更适中
v2.8.0
新功能
- 条目级分支溯源(provenance):每条新知识自动记录出生分支(born 标签),GUI 分支列展示「⎇ 出生分支」徽标;
ok backfill-born可回填存量 - 合并谱系落盘:分支并入基准自动记录,GUI 显示「dev → master」
- GUI 分支上下文:工具条显示「基准分支 · 当前分支」,不一致时警示
说明
- born 与 branch 标签正交:branch 管「在哪生效」(注入过滤),born 管「在哪出生」(展示);零迁移,旧知识库开箱即用
v2.7.1
新功能
- GUI「其他」页新增「使用帮助」卡:怎么调用、怎么配置、常见问题——随安装包分发,离线可查
- GUI 条目类型显示中文化(规则/踩坑/笔记/参考;存储值仍为英文)
v2.7.0
新功能
- wiki 分支差异条目:长期并行分支只维护与基准分支的结构差异,注入按当前分支过滤,他分支差异不再误导 agent
- 分支合并感知:dev 并入 master 后提示清理失效差异条目(每会话一次)
- GUI 管理页:分支列 + 分支过滤器 + 操作列固定
修复
- 非基准分支跑 wiki 更新不再污染全量条目(技能流程改为只写差异条目)
- prompt 热路径 git 调用收敛,每次提问少 1-2 次 git 子进程
ok wiki mark对用户传入 rev 先 rev-parse 归一化,修短 hash 游标误判 diverged
v2.6.0
新功能
- wiki 分支感知:游标按分支记录(
state/wiki.json新格式),旧单游标格式按 merge-base 可达性惰性迁移;切到分叉分支时注入附 wiki 出处提示 - 游标被 rebase/squash 改写后显式提示「游标失效」
ok wiki base查看/设置基准分支;ok wiki status输出 branch/base_branch/branch_state
v2.5.0
新功能
- 多 Agent 支持新增 Reasonix 集成:第四个适配器,走 Extension Protocol 插件包 + sidecar(
ok extension-serve),sidecar 崩溃宿主降级不阻断 - 强制检查三档开关(仅 Reasonix):
mixed/soft/hard,GUI 引导页可配,保存即时生效
说明
- sidecar 全面 fail-open:拦截器异常一律放行不阻断输入;
ok off对 reasonix sidecar 同样生效
v2.4.0
新功能
- 多 Agent 支持新增 ZCode 集成:hook 配置合并写
~/.zcode/cli/config.json,保留用户未知字段与自有 hook,写前备份 - hook 输出新增 Claude/ZCode JSON 协议格式:prompt 注入包成 additionalContext,Stop 阻断走 decision:block
- 技能分发启用每 agent 独立目录(ZCode 装到
~/.zcode/skills);ok doctor逐 agent 报告 hooks 状态
说明
- ZCode 侧生效方式:
ok setup --agent zcode后新建会话(ZCode 在会话启动时快照 hook 配置)
v2.3.3
新功能
- 升级后打开 GUI 自动弹出更新日志:跳级升级累计展示所有新版本;「其他」页新增常驻入口,随时回看全部历史
- 新 API:
GET /api/changelog、POST /api/changelog/seen(首次运行、dev 构建、降级安装均不弹窗)
v2.3.2
新功能
- hooks 超时可配置:三条 hook 统一取全局配置
[hooks] timeout_sec;GUI 引导页新增「hook 超时」卡 - 经验沉淀分流「新需求」到 wiki:propose 技能新增「先分类」指引(经验型 → 草稿 / 结构型 → wiki)
修复
- PostToolUse 三个静默返回分支补 ok.log 日志——此前高负载下 touched 记录可能整会话丢失且无任何痕迹
v2.3.0
新功能
- 多 Agent 支持新增 Pi 集成(TypeScript 扩展注入 hook),与 Kimi Code 并列;
internal/agentx适配器注册表,后续 agent 一个文件即可接入 - GUI 引导页新增 agents 下拉:hooks 配置卡随选中 agent 联动;
ok setup --agent <id>只装指定 agent
修复
- hook 安装/卸载改为收集式错误聚合:单个 agent 失败不影响其他 agent
v2.2.4
优化
- 托盘菜单从左键单击改为右键单击触发(左键单击与双击冲突);左键双击打开/聚焦 GUI 不变
v2.2.3
新功能
- 系统托盘:daemon 运行时显示图标;右键弹菜单(版本号 + 退出),双击打开/聚焦唯一 GUI 窗口
修复
- hook 调用不再闪 cmd 黑窗口(子进程静默化)
- 安装器在文件拷贝前自动 daemon stop,避免 ok.exe 被锁导致升级失败
优化
- hook 注入瘦身:默认预算 1500→800、top_n 3→2;检索命中注摘要+文件路径而非全文(mandatory 条目仍全文)
更早
- v1.x 早期开发记录散见于仓库 docs/changelogs/ 的按日期文件