更新日志

每次版本都写清“改了什么、为什么改、怎么验证”;本页与 /api/changelog 同源,直接读仓库根 CHANGELOG.md,不手抄、不二次编辑。

当前版本 vdesktop-0.6.64 · 发布于 2026-11-20 · JSON
v0.4.3 2026-10-30

一句话:知识库集合分区上线——检索可按「经验/领域知识/语料/学习/自述」集合过滤,引用带稳定可点 URL,写入按 key 自动归位——百万条演进方案(docs/KB-百万条优化方案-20261030.md)P0+P1 落地。

2026-10-30 官网业务工作台与积木统一规则

  • 官网信息结构重整:首页、积木工作台、业务方案、桌面端、能力目录和资源接入分工,视频与支付可直接找到。
  • 方案装配工作台:读取真实能力目录,选择与追加业务组件、合并依赖、标注缺口,支持本机草稿保存恢复、JSON导入导出及带入命令窗口审查;不会自动安装、付款或调用收费模型。
  • 既有资产与遗漏检查:视频变体、注册会话、会员中心及会员组件使用原生身份;源码资产、公开目录与外部连接器分开,不冒充全部可执行。
  • 统一准入:旧能力和新增能力采用同一套身份、契约、依赖、权限、成本、证据与发布规则;兼容索引不授予发布权限,合规原生契约保持原样。
  • 真实部署状态:按实际路由检查执行入口,生产缺新版总指挥/规则预览接口时禁用提交、保留草稿,不以网页200冒充执行接通。
  • danao-guard MCP:完成14工具发现和只读身份核查;治理适配器仍为候选,未自动启用写工具或远端执行。

新增

  • 集合(collection)体系(app/knowledge/coding/collections.py):五集合注册表+ 从 tags/标题族推导的纯函数规则(源自 2026-10-30 体检分类器三轮收敛,误判 <1.3%);KBStore.collection_map() TTL 缓存索引;零 schema 写、零数据迁移。
  • 检索集合过滤:hybrid_search(collection=...) 在排序/簇/多样性之前过滤候选(过滤时池子自动放大到 120 保 k 足额);service.search/answer 透传;检索缓存键纳入collection(防串结果)。每条 hit 携带 collection 标注。
  • API/公开面:/api/v1/kb/search、/public/search、/answer 均接受 collection 参数(非法名 422);/kb 页搜索框加集合下拉、命中条挂「引用定位 →」链接与集合徽标。
  • 引用定位协议:citations 统一携带 url(/kb?src={sid}&c={chunk_id})与collection;新增匿名单源详情端点 GET /api/v1/kb/public/source/{sid}?chunk= (脱敏、限流、404 语义完备);/kb 页支持 ?src=&c= 落点卡片(滚动+高亮)。
  • 写入即归位:配置 knowledge.owner_collections(owner→默认集合),POST /documents 未显式带 collection: tag 时自动补标;单 owner 单日写入量观测告警(每 250 条 WARN,日志关键字 KBBULK)。
  • kb_changes 保留窗脚本(scripts/kb_changes_retention.py):N 天窗删除,删前快照可整表还原,支持 dry-run。

修复

  • 检索缓存键缺 collection 维度的串结果隐患(同查询不同集合共享缓存)——随本批修复。

测试

  • 新增 tests/test_kb_collections.py 8 项:推导规则/端到端过滤/非法名 422/引用 URL/ 写入自动打标/单源详情端点(含 404 语义);kb 全家回归 168 项全绿。
v0.4.2 2026-10-30

一句话:全项目深度体检即修批次——六路地毯审计(A~J 十阶段)落地修复:向量检索从分钟级到亚秒、note 写入防碰撞、/mcp 不再阻塞全服务、学习链补上成本刹车,并完成生产 202.189.22.187 回迁后的首次树级收敛(生产 master 孤儿线收编本地 main)。

修复(P0/P1 即修即部署)

  • 向量检索 numpy 矩阵快路径(E/C-P0,app/knowledge/coding/store.py):库长到 74.8 万向量后逐行纯 Python 余弦单次检索分钟级(生产台账均值 181.9s / 最大 649.9s,匿名 /kb 检索 60s 超时)。新增内容代次物化索引(f32 矩阵 + 行范数,懒重建 + 60s 节流),检索退化为一次 BLAS 矩阵向量积(亚秒);无 numpy/维度混杂自动回落原逐行路径,行为不变。新测试 test_kb_vector_fastpath.py(快慢路径结果等价)。当晚 v2:重建挪后台守护线程——请求路径绝不付全表扫描成本(任何 kb 写入后的首次检索不再出现 60~70s 重建墙,先用陈旧索引作答、换轨原子替换;冷启动首查仍同步建一次防回落分钟级逐行)。
  • note 写入 sid 防碰撞(C-P1,app/knowledge/coding/service.py):旧制sha1(title)[:8] 仅 32bit,7.7 万文档量级生日碰撞可致「不同标题静默接管同 sid 条目」。新条目一律 16 位;既有条目(8/16 位)仅同标题按原 sid 稳定更新;sid 被不同标题占用即跳过并告警。新测试 test_kb_note_sid_guard.py(同标题=更新定律不破)。
  • /mcp 不再阻塞全服务(B-P1,app/api/mcp.py):工具处理器是同步重活(LLM 30s/能力轮询 900s),原先在 async 端点内直接跑会卡死事件循环(含 /livez)。改 anyio.to_thread.run_sync 丢线程池;顺带 /mcp 接入 RateLimiter(与 REST 同语义)、admin 口令改常数时间比较(secrets.compare_digest,REST deps.py 同步修)。
  • selfexperiment.revert 条件写(B-P1,app/brain/selfexperiment.py):回退只在该技能正文仍等于实验落盘版本(body==after_body)时执行;已被后续推进则拒绝(stale_body)并留审计,杜绝盲目回退抹掉并发改进。新测试 test_selfexperiment_revert_cas.py。
  • 主学习链接入每-topic 成本刹车(B/C-P1,app/api/service.py):learnroi.spend_brake 此前只挂在 relearn 一条路径,goal.advance/backfill/手动入队不查——同 topic 烧 token 无上限。现 _learn_executor 入口在全局额度闸之后立即查询,被刹 topic 返回topic_spend_brake。新测试 test_learn_spend_brake_wiring.py。
  • LLM 兜底通道可观测(I-P1,app/evolution/llm.py):脚本车道兜底切未知价渠道(如未登记台账的中转)此前完全静默。现每通道一行 LLMCHAN 日志(失败/兜底=WARNING、主力成功=INFO,含 usage,绝不落 key),可直接 grep cron 日志。新测试test_llm_channel_logging.py。
  • .env 进 .gitignore(A-P0):根目录 .env 含真实 key,未 ignore 时一次git add . 就会泄漏入库。
  • /learning 管理口令改 sessionStorage(C-P1,app/web/learning.html):与 /console 安全姿态对齐——admin 口令不再持久落盘 localStorage(跨会话留存即泄露面)。

运维

  • 生产收敛(J 阶段):生产 master(103 时代孤儿快照线 5 提交)经 commit-tree 收编本地 main 树(保留双侧历史、零 reset/force);生产 memory-venv 补装 requirements 缺失依赖(msgpack/jinja2 等 5 项);config.yaml 盘外保全后以未跟踪文件还原。
  • AGENTS.md 服务器现状注(H-P1):仓库与工作区两级 AGENTS.md 的迁移公告模板替换错误(两台老服务器 IP 写成同一个)修正为 2026-10-30 回迁现状。
v0.4.1 2026-10-28

一句话:线上代码进 git 了——0.4.0 整批改动此前只存在于工作区(无版本保护),本批补提交入册;顺带清剿快照遗留的测试代次错配与树内杂物,测试体检恢复可用。

修复(运维闭环,闲时批次 2026-10-28)

  • 补提交 0.4.0 线上状态(0e716fe,28 文件 +6310/-3150):pager.js/about 页/kb 强化等自 10-25 上线以来首次进入 git 历史;生产仓从此工作区干净。
  • 测试套件对齐(9af4c98):快照内 12 个测试文件是比 app 模块更老的孤本(导入从不存在的符号,收集即错),用主仓版对齐恢复收集;0.4.0 关键回归子集36 passed / 1 skipped(分页合同、pager.js、版本链一致、kb 告警转发、内联 JS 语法)。
  • 树内归档:树根 5 个历史 patch、2 个 .bak、5 个 _debug 测试 → _patch_baks/;旧 backup 目录 → backups/(只 mv 零删除)。

已知边界(留给下个版本)

  • 14 个测试文件因主仓↔生产 app API 真分叉(97 文件热修未回流)无法对齐,收敛方案见主仓 docs/部署一页纸-改代码到上生产-20261028.md。

版本号同时出现在 /healthz、/api/version 与控制台状态页;四处读的是同一个常量(app/core/version.py)。