fluffy-context 0.8.0 → 1.0.0-beta.1

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# 发布说明
+
+## 1.0.0-beta.1
+
+这是项目认知层的首个 beta，面向愿意验证新工作流的用户；npm `latest` 保持 0.8.0。本版本不承诺所有 agent 都会自动调用工具，也不将字符估算宣传为真实 token 节省。
+
+### 使用体验
+
+- `ctx init` 完成布局、首次迁移、日志校验、项目指引和运行时启动。保留已有禁用策略；CI 使用 `--no-start --no-integrations`。
+- `ctx inject "当前任务"` 返回默认 2400 字符预算的上下文正文，按任务词选择场景，默认排除文件活动噪声。MCP 使用 `context_inject`；API 使用 `injectContext`。
+- `ctx import` 预览项目内 memory、.claude、.zcode、.cursor、.curcor、.codex 和 agent 文档；`--apply` 去重后保存带来源的候选。候选经核验后才进入普通检索。
+- 已存在 `.claude` 的项目由 init 配置 Hook/MCP，修复旧安装路径与 Hook 输出契约。其它宿主使用项目 AGENTS.md、MCP 或 API。
+- `ctx report` 展示存储、语义事件比例、显式复用及输入/输出估算；缺少数据时不虚构收益或回本日期。
+
+### 数据与正确性
+
+- 实体增量同步，避免读取计数变化重复保存整批历史；过滤 log/tgz 文件活动。
+- 约 1 MiB 的日志段无损 gzip 归档，保留事件字节和哈希链，校验中断产生的双副本；可选观察达到容量预算后拒绝入库，语义写入继续。
+- 修复 UTF-8 尾部恢复、存活进程锁保护、runtime 关闭后定时器残留。
+- 知识诊断遵守同一查询、状态和范围，限制正文预算及冲突组数，不再将全库候选泄漏到普通查询。
+- 修复没有 checkpoint 时无法注入已验证知识的问题；新项目导入并核验旧记忆后即可检索，无需先创建任务快照。
+
+### 从 0.8.0 升级
+
+1. 停止项目 runtime（`ctx runtime stop`），断开所有使用旧版本的 MCP/agent 会话，并备份项目 `.context` 目录。
+2. 安装：`npm install --global fluffy-context@beta`。
+3. 在项目根目录执行 `ctx init`，重新连接 MCP/agent，再执行 `ctx inject "当前任务"`。
+
+归档日志要求本 beta 或 1.0.0-dev.1 及更新读取器；不可用 0.8.0 混写或直接降级。若需回滚，应停止新版进程并恢复升级前的完整备份；升级后的新增记录需要单独保留。v1 Context/Snapshot 文件保持原样。
+
+### 验收证据与限制
+
+Windows 本仓库真实记录：一个日志段从 1,050,216 字节降至 189,044 字节，解压与备份一致；同一条知识查询的 JSON 输出从 51,107 降至 1,211 字符。这是具体操作的存储/输出结果，不能外推为模型 token 或任务正确率收益。
+
+正式版仍需跨平台矩阵、真实宿主触发验收、会话增量注入、部分迁移恢复、多段导入、遥测聚合和 provider token 配对实验。导入为保守文本行抽取，敏感行过滤不是完整秘密检测。场景推断及冲突检测是确定性规则。