Skip to content

feat: 发布 2.5.0,完善 Memory 能力并统一七包发布 - #273

Merged
clark-fc merged 28 commits into
mainfrom
feat/memory
Oct 20, 2026
Merged

clark-fc merged 28 commits into
mainfrom
feat/memory

Conversation

@clark-fc

Copy link
Copy Markdown
Collaborator

概述

本 PR 完善 Memory CLI 的管理、检索与异步写入能力,新增个人记忆 Skill 和 dsh 个人记忆插件,并准备 2.5.0 整体发布。

七个包统一升级至 2.5.0,中英文 CHANGELOG 已补充功能说明、破坏性变更和迁移方式,Skill 元数据已同步。

主要改动

  • 完善 Memory 节点详情、Skill 记忆导出、画像模板管理、按规则召回及 pro/lite 检索。
  • 新增 bailian-memory Skill,支持经用户授权的个人记忆、召回与画像流程。
  • 新增 dsh 个人记忆插件,提供自动召回、异步整理及记住/遗忘工具;知识库插件适配 dsh 0.2.1。
  • 修复异步写入完成判定、轮询超时、部分失败退出码和输入校验问题。
  • 校验 Workspace 标识,防止请求被发送至非预期主机。
  • 七包统一版本与发布流程。

破坏性变更与迁移

变更 迁移方式
移除 bl knowledge retrieve / kscli retrieve 使用 bl knowledge search / kscli search,并传入检索服务的 --agent-id;旧 index 参数不能直接沿用
Memory 改用 Workspace 专属端点 配置 --workspace-id、BAILIAN_WORKSPACE_ID 或 workspace_id
Memory 记忆库参数调整 在支持该参数的命令中,将 --memory-library-id 改为 --library-id
memory update / memory delete 移除 --user-id 更新调用脚本;确认删除节点时传入 --yes
memory add 改为异步抽取,默认最多等待 120 秒 仅提交使用 --wait 0;JSON 调用方需适配 event_id 和 events,提交回执不代表抽取完成
移除 knowledgeRetrieve 导出;MemoryAddResponse 替换为 MemoryAddAsyncResponse 库调用方更新 import,并适配异步请求与响应契约

--min-score 默认值为 0.3,仅对 pro 检索生效;lite 不按该阈值过滤。

验证

  • 本地 vp check 通过:0 个错误,3 个现有警告。
  • 发布工具测试通过:4 个用例。
  • 七包版本一致性和 README 同步检查通过。
  • 提交 hook 的 Skill 资产同步及 vp check --fix 通过。
  • 此前已完成 Memory 专项测试、live 验收和安装冒烟;合入 main 后的最终检查由 GitHub 自动化流程执行。

验收范围与发布

  • dsh / Skill 实际宿主验收不在本次范围内。
  • 不将 CI 结果视为 Memory 服务 GA、画像精确删除 live 链路或宿主实机验收证明。
  • 本 PR 准备 2.5.0 发布;合并至 main 后通过 GitHub 发布流程执行正式发布。

- 在 CLI 文档中新增记忆 live 场景说明与变量需求
- 扩展 CLI 命令集,添加记忆画像 Profile 的增删改查功能
- 统一所有记忆相关命令加入 workspace 和 library 参数支持
- 记忆添加命令支持自定义 meta_data,完善输入校验和互斥说明
- 记忆删除、列表、获取用户画像等命令增加工作空间参数支持
- 画像模板相关命令新增分页参数及属性操作接口
- 重构知识命令共享模块,移除重复的 workspace 解析实现,统一导出
- 优化命令输出格式,文本模式下显示更多详细信息和异常提示
- 提供完整的示例参数,增强命令使用说明和提示文档
- 在多条命令中统一添加对 userId 和 memoryLibraryId 长度的校验
- 新增 profile schema 名称、描述及属性字段长度断言
- 为 delete 内存节点命令添加高风险删除确认机制及 --yes 标志
- 增加账号级别限流说明,提示遇 HTTP 429 需降低请求频率
- 统一移除分散的长度常量,集中定义并使用共享常量
- 相关 E2E 测试覆盖长度限制和高风险操作确认情况
- 支持内存消息内容多样化,新增 MemoryContentPart 类型定义
- 内存文档中新增限流描述及删除命令风险提示,强调确认操作要求
…age.json and documentation

- Introduced a new .nvmrc file specifying Node.js version 22.
- Updated Node.js version requirements in package.json to support ^22.18 or >=24.11.
- Adjusted related documentation to reflect the new Node.js version requirements for development and installation.
- Changed the parameter name from `--memory-library-id` to `--library-id` across all relevant commands and documentation.
- Updated examples and test cases to reflect the new parameter name.
- Ensured consistency in the CLI interface and improved clarity in the user guide and command references.
…anagement

- Added links to memory documentation in both English and Chinese in the README files.
- Updated the memory capability matrix to reference the user guide and improved clarity in descriptions.
- Introduced new commands for memory node display and skill export, enhancing the CLI's functionality.
- Improved command descriptions and added new flags for better user experience in memory operations.
- Deleted obsolete memory design and backend API documentation files that are no longer relevant.
- Cleaned up the repository by removing files that contained outdated information and design decisions.
- Ensured that the remaining documentation reflects the current state of the memory management system.
- Updated links to the memory capability matrix and user guide in both English and Chinese README files to point to the correct GitHub URLs.
- Ensured consistency across documentation for better accessibility and clarity.
- Updated various documentation files to ensure consistent formatting, particularly in the use of underscores and asterisks.
- Improved clarity in command descriptions and examples across multiple reference files.
- Ensured that all instances of `bailian-*` are uniformly formatted for better readability.
…ement

- Added the new `bailian-memory` skill for personal long-term memory management, including features for user preferences and memory extraction.
- Updated documentation to include new commands and references for the memory skill, ensuring clarity and accessibility.
- Enhanced the CLI with new memory commands and improved existing command descriptions for better user experience.
- Included tests for the new memory skill to ensure functionality and integration with the CLI.
…umentation

- Deleted the `knowledge retrieve` command, which is now deprecated in favor of `knowledge search`.
- Updated relevant documentation to reflect the removal of the retrieve command and to clarify the usage of the search command.
- Adjusted command references in various files to ensure consistency and accuracy in the CLI interface.
- Added tests to verify that attempts to use the removed command are correctly rejected.
…tionality

- Introduced `bailian-memo-dsh` as a new downstream host adapter for personal memory in DeepSeek Harness.
- Updated AGENTS.md to include the new package and its functionalities.
- Modified Vite configuration to include files from the new package.
- Updated publish workflow to handle the new package independently.
- Added necessary documentation and configuration files for the new package.
- Updated dependencies in `bailian-kb-dsh` to align with the new package requirements.
…lugin architecture

- Updated `pnpm-lock.yaml` to reflect new versions for dependencies, including `@deepseek-ai/cordis` and `@deepseek-ai/dsh-agent`.
- Refactored `dsh-plugin.md` documentation to clarify plugin responsibilities and configuration.
- Introduced a new implementation plan for Dsh plugin configuration in `2026-10-09-dsh-config.md`.
- Enhanced `README.md` and `README.zh.md` to provide clearer instructions on plugin setup and usage.
- Added new configuration and credential management files to streamline API key handling and workspace settings.
- Improved error handling and validation for API key and workspace configurations in the plugin.
…ate documentation

- Eliminated pause and resume methods from the MemoCardController and associated UI elements in MemoCard.
- Updated README.md and README.zh.md to reflect changes in plugin control, emphasizing the use of a switch for enabling/disabling the plugin without data loss.
- Removed references to pause/resume in localization files to align with the updated functionality.
- Cleaned up CSS by removing the dangerButton class, streamlining button styles.
…it documents; add comprehensive command usage guide and detailed command manuals
…changes in memory CLI documentation; remove outdated runtime behavior and bundle plan documents
@clark-fc
clark-fc merged commit aa750aa into main Oct 20, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant