cnb-agentic-memory 2.0.2__tar.gz → 2.0.3__tar.gz

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: cnb-agentic-memory
-Version: 2.0.2
-Summary: CNB Agentic Memory 是基于 CNB 平台构建的通用记忆工具，把 CNB 的 issue、知识库、检索能力组合成一个开箱即用的智能体记忆层。
+Version: 2.0.3
+Summary: CNB Issue 智能体记忆系统（cnb-agentic-memory）是基于 CNB 平台构建的通用记忆工具，把 CNB 的 issue、知识库、检索能力组合成一个开箱即用的智能体记忆层。
 Project-URL: Homepage, https://cnb.cool/xqitw/cnb-agentic-memory
 Project-URL: Repository, https://cnb.cool/xqitw/cnb-agentic-memory
 Project-URL: Issues, https://cnb.cool/xqitw/cnb-agentic-memory/-/issues
@@ -34,7 +34,7 @@ Provides-Extra: mcp
 Requires-Dist: mcp<3,>=2.1.1; extra == 'mcp'
 Description-Content-Type: text/markdown
 
-# CNB Agentic Memory
+# CNB Issue 智能体记忆系统
 
 [![Latest Release](https://cnb.cool/xqitw/cnb-agentic-memory/-/badge/release)](https://cnb.cool/xqitw/cnb-agentic-memory/-/badge/release.link)
 [![PyPI](https://img.shields.io/pypi/v/cnb-agentic-memory.svg)](https://pypi.org/project/cnb-agentic-memory/)
@@ -59,7 +59,7 @@ Description-Content-Type: text/markdown
 
 开始使用前需要准备三件事：
 
-1. **创建专用私有仓库**——作为记忆仓库。必须是专用仓库（全部 Issue 均为记忆），检索与列表不做记忆/普通 Issue 区分
+1. **创建专用的 [CNB 平台](https://cnb.cool)私有仓库**——作为记忆仓库。必须是专用仓库（全部 Issue 均为记忆），检索与列表不做记忆/普通 Issue 区分
 2. **获取 CNB 访问令牌**——在 CNB 个人设置中创建，需 `repo-issue:rw`（Issue 读写）+ `repo-code:r`（知识库检索）权限
 3. **配置知识库入库流水线**——在记忆仓库的 `.cnb.yml` 挂载 `knowledge:update` 流水线（`$` 键下），语义检索依赖它；**必须先配置再写入**，错过事件的记忆不会被补录
 

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/README.md

@@ -1,4 +1,4 @@
-# CNB Agentic Memory
+# CNB Issue 智能体记忆系统
 
 [![Latest Release](https://cnb.cool/xqitw/cnb-agentic-memory/-/badge/release)](https://cnb.cool/xqitw/cnb-agentic-memory/-/badge/release.link)
 [![PyPI](https://img.shields.io/pypi/v/cnb-agentic-memory.svg)](https://pypi.org/project/cnb-agentic-memory/)
@@ -23,7 +23,7 @@
 
 开始使用前需要准备三件事：
 
-1. **创建专用私有仓库**——作为记忆仓库。必须是专用仓库（全部 Issue 均为记忆），检索与列表不做记忆/普通 Issue 区分
+1. **创建专用的 [CNB 平台](https://cnb.cool)私有仓库**——作为记忆仓库。必须是专用仓库（全部 Issue 均为记忆），检索与列表不做记忆/普通 Issue 区分
 2. **获取 CNB 访问令牌**——在 CNB 个人设置中创建，需 `repo-issue:rw`（Issue 读写）+ `repo-code:r`（知识库检索）权限
 3. **配置知识库入库流水线**——在记忆仓库的 `.cnb.yml` 挂载 `knowledge:update` 流水线（`$` 键下），语义检索依赖它；**必须先配置再写入**，错过事件的记忆不会被补录
 

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/docs/API.md

@@ -98,7 +98,7 @@ except ApiError as err:
 - **写后回读校验**：写操作 GET 回读确认，短重试（3 次 × 0.5s）后仍不一致才报错；`verify=False` 可跳过（仅测试）
 - **超长拆分**：正文超过 30KB 自动按段落拆为多条，title 带 `(i/n)` 序号关联；`WriteResult.parts` 携带全部分片供循迹
 - **软删除**：无硬删除接口（CNB DELETE 返回 404），`delete` 后可 `restore`
-- **标签约定**：`category` 自动补 `category:` 前缀（对齐 CNB 平台分类约定，选择器中单选），`tags` 为普通标签原样保留；记忆仓库须为专用仓库（全部 Issue 均为记忆）
+- **标签约定**：`category` 自动补 `category:` 前缀（对齐 CNB 平台分类约定，选择器中单选），`tags` 为普通标签原样保留；记忆仓库须为 CNB 平台私有仓库，且为专用仓库（全部 Issue 均为记忆）
 - **检索分层**：语义检索走知识库向量召回（相关度受语料规模、查询内容与切分策略影响，PoC 实测样例中可达 0.98+）；`keyword_search` 是与它并列的第二检索方法（标题检索，无需知识库），供 title 含确切关键词时精准直达
 - **分页参数钳制**：limit / top_k 统一钳制到 1~100（CNB 服务端分页上限），SDK 与 CLI / MCP 入口层口径一致
 
@@ -118,7 +118,7 @@ except ApiError as err:
 
 ## 记忆仓库前置条件
 
-**记忆仓库须为专用仓库**：仓库中全部 Issue 均为记忆，不与普通 Issue 混用（检索与列表不做记忆/非记忆区分）。
+**记忆仓库须为 CNB 平台私有仓库，且为专用仓库**：仓库中全部 Issue 均为记忆，不与普通 Issue 混用（检索与列表不做记忆/非记忆区分）。
 
 知识库检索依赖仓库已配置 Issue 事件同步流水线。`.cnb.yml` 事件必须挂在 `$` 键下（顶层写法静默无效），且**先配置流水线再写入记忆**——错过事件的 Issue 不会被补录：
 
@@ -156,4 +156,4 @@ $:
             issueSyncEnabled: true
 ```
 
-写入到可检索有 1~2 分钟同步时延，属平台预期行为。
+写入到可检索的时延取决于仓库流水线配置：事件触发（实时）通常秒级到分钟级；定时触发（如每小时/每日入库）需等下次流水线运行。实际时延还受网络、记忆数量等因素影响。需立即确认写入结果时，按写入返回的 number 用 `memory_get`（CLI `get`）回查。

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/docs/CLI.md

@@ -51,7 +51,7 @@ cnb-agentic-memory get 12
 cnb-agentic-memory append 12 "追加了 pg_partman 配置示例"
 cnb-agentic-memory delete 12   # 软删除，cnb-agentic-memory restore 12 可恢复
 
-# 语义检索（需仓库配置 knowledge:update 流水线，写入后约 1~2 分钟可检索）
+# 语义检索（需仓库配置 knowledge:update 流水线；实时同步通常秒级到分钟级可检索，定时入库需等下次运行，需立即确认用 get 回查）
 cnb-agentic-memory search "分区表 慢查询" --top-k 3
 
 # 关键词标题检索（与 search 并列，无需知识库；title 含确切关键词时更精准）

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/docs/MCP.md

@@ -84,4 +84,4 @@ pip install "cnb-agentic-memory[mcp]"
 
 ## 记忆仓库前置条件
 
-`memory_search` 依赖仓库配置 Issue 事件同步流水线（`.cnb.yml` 的 `$` 键，见 [SDK 参考](API.md#记忆仓库前置条件)），且**先配置流水线再写入**——错过事件的记忆不会被补录。写入到可检索约 1~2 分钟。
+`memory_search` 依赖仓库配置 Issue 事件同步流水线（`.cnb.yml` 的 `$` 键，见 [SDK 参考](API.md#记忆仓库前置条件)），且**先配置流水线再写入**——错过事件的记忆不会被补录。写入到可检索的时延取决于流水线配置：事件触发（实时）通常秒级到分钟级，定时入库（如每小时/每日）需等下次运行，还受网络、记忆数量影响；需立即确认时用 `memory_get` 按 number 回查。

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cnb-agentic-memory"
-version = "2.0.2"
-description = "CNB Agentic Memory 是基于 CNB 平台构建的通用记忆工具，把 CNB 的 issue、知识库、检索能力组合成一个开箱即用的智能体记忆层。"
+version = "2.0.3"
+description = "CNB Issue 智能体记忆系统（cnb-agentic-memory）是基于 CNB 平台构建的通用记忆工具，把 CNB 的 issue、知识库、检索能力组合成一个开箱即用的智能体记忆层。"
 readme = "README.md"
 requires-python = ">=3.11"
 license = { text = "MIT" }

cnb_agentic_memory-2.0.3/skills/SKILL.md

@@ -0,0 +1,9 @@
+# Skills 索引
+
+根据用户的需求，匹配并调用最合适的子技能。
+
+## 技能列表
+
+### 智能体记忆
+
+- **cnb-agentic-memory** — CNB Issue 智能体记忆系统（基于 CNB 平台，跨会话长期记忆）。把重要信息写入记忆仓库（一条记忆 = 一个 Issue），之后用语义检索（知识库向量，高相关度）、关键词标题检索（`cnb-agentic-memory keyword`，无需知识库）或分类/标签浏览找回。**写入时必须自己撰写 title**——提炼 3~8 个高区分度关键词短语，keyword 标题检索只匹配 title，title 质量决定记忆能否被找回。支持追加更新记录、全量替换正文、软删除与恢复。适合回答"记住这个"、"帮我记一下"、"之前说过什么"、"上次是怎么解决的"、"查一下我们的记忆库"这类跨会话请求。当用户提到记忆、记住、想起、之前、上次、经验、教训、备忘时使用，详见 [cnb-agentic-memory](./cnb-agentic-memory/SKILL.md)。

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/skills/cnb-agentic-memory/SKILL.md

@@ -3,14 +3,14 @@ name: cnb-agentic-memory
 description: 基于 CNB 平台的智能体记忆工具：跨会话写入/检索/管理记忆。写入时必须自己撰写 title（提炼 3~8 个高区分度关键词短语，keyword 检索只匹配 title）。当用户提到记忆、记住、之前、上次、经验、教训时使用。用法：cnb-agentic-memory CLI（write/get/append/update/delete/restore/list/recent/search/keyword）。
 slug: cnb-agentic-memory
 displayName: CNB Issue 智能体记忆系统
-version: 2.0.2
-summary: 基于 CNB 平台的智能体记忆工具：以 Issue 为存储、知识库为语义检索，CLI/MCP/SDK 三入口跨会话记忆。
+version: 2.0.3
+summary: CNB Issue 智能体记忆系统：以 Issue 为存储、知识库为语义检索，CLI/MCP/SDK 三入口跨会话记忆。
 license: MIT
 homepage: https://cnb.cool/xqitw/cnb-agentic-memory
 tags: [记忆, 智能体, MCP, 知识库, CLI]
 ---
 
-# cnb-agentic-memory — 智能体记忆系统
+# CNB Issue 智能体记忆系统（cnb-agentic-memory）
 
 基于 CNB 平台的跨会话记忆：一条记忆 = 一个 Issue，`number` 是记忆唯一标识。写入即持久化，读取走语义检索（知识库向量，高相关度）。记忆仓库中全部 Issue 均为记忆，检索与列表结果不区分记忆与普通 Issue。
 
@@ -35,8 +35,10 @@ tags: [记忆, 智能体, MCP, 知识库, CLI]
    append 续写 > delete 废弃（最后手段）。delete 是软删除——仅从默认检索
    隐藏，内容仍留在知识库向量中（`--include-closed` 可召回），不是内容
    清除；误删重建还会让向量库多一份重复内容。
-5. **写入后约 1~2 分钟才能被语义检索到**（知识库同步时延），这是平台预期，
-   不是故障。写入成功返回的 number 就是永久凭据，可先记录。
+5. **写入后不能立即语义检索不代表失败**：能否/何时可检索取决于仓库流水线
+   配置（实时同步通常秒级到分钟级；定时入库如每小时/每日需等下次运行），
+   还受网络、记忆数量影响。写入成功返回的 number 就是永久凭据，可先记录；
+   需立即确认用 `get` 按 number 回查。
 
 ## 安装与调用
 

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/src/cnb_agentic_memory/__init__.py

@@ -1,4 +1,4 @@
-"""cnb-agentic-memory：基于 CNB 平台的通用智能体记忆工具。
+"""cnb-agentic-memory（CNB Issue 智能体记忆系统）：基于 CNB 平台的通用智能体记忆工具。
 
 以 CNB Issue 为存储、知识库为语义检索，SDK / CLI / MCP / Skill 多形态对外服务。
 一记忆 = 一 Issue，number 是记忆唯一标识。
@@ -8,7 +8,7 @@ from .api import ApiError, CNBApiClient, ConfigError
 from .memory import Memory, MemoryRuleError, SearchResult, WriteResult, normalize_title
 from .models import Comment, Issue, KbChunk, Label
 
-__version__ = "2.0.2"
+__version__ = "2.0.3"
 
 __all__ = [
     "__version__",

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/src/cnb_agentic_memory/cli.py

@@ -21,7 +21,7 @@ from .memory import STATE_CLOSED, STATE_OPEN, Memory, MemoryRuleError
 
 app = typer.Typer(
     name="cnb-agentic-memory",
-    help="CNB Agentic Memory：基于 CNB 平台的通用智能体记忆工具",
+    help="CNB Issue 智能体记忆系统：基于 CNB 平台的通用智能体记忆工具",
     no_args_is_help=False,  # 无参数时由 callback 显示 help，避免拦截 --version
     add_completion=False,
 )

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/src/cnb_agentic_memory/mcp_server.py

@@ -79,7 +79,7 @@ def _version() -> str:
 
 mcp = MCPServer(
     _DIST_NAME,
-    title="CNB Agentic Memory",  # pyproject 无人类可读标题字段，无法单一来源
+    title="CNB Issue 智能体记忆系统",  # pyproject 无人类可读标题字段，无法单一来源
     description=_summary(),
     version=_version(),
     website_url=_homepage_url(),
@@ -91,8 +91,9 @@ mcp = MCPServer(
         "2. 写入失败若返回已落盘分片编号，按错误信息中的建议处理："
         "update 补齐/修正，勿重复 write（会重复创建）。超长内容拆分为"
         "多条时按返回的 parts 逐条处理，勿只处理首条。\n"
-        "3. 刚写入的记忆需 1~2 分钟知识库同步才能被 memory_search 检索到，"
-        "这是平台预期不是故障；精确确认用 memory_get。\n"
+        "3. 写入后能否立即被 memory_search 检索到取决于仓库知识库同步配置"
+        "（实时或定时入库，如每小时/每日），且受网络、记忆数量影响，"
+        "检索不到不是写入失败；需立即确认时用 memory_get 按 number 回查。\n"
         "4. memory_list / memory_keyword_search 不回显正文（body 为 null），"
         "需要全文用 memory_get。"
     ),
@@ -147,7 +148,8 @@ def _issue_out(issue: Any, *, body_echo: bool = True) -> dict:
         "概括性描述；不传 title 则由工具兜底截取正文首行。tags 每个元素一个标签，"
         "不要在一个元素里拼逗号。超长内容自动拆分为多条，返回的 parts 含"
         "全部分片编号。写入失败若返回已落盘分片编号，按错误信息中的建议处理"
-        "（update 补齐/修正），勿重复 write。"
+        "（update 补齐/修正），勿重复 write。写入后需立即确认用 memory_get "
+        "按 number 回查（能否立即语义检索取决于仓库同步配置，可能是定时入库）。"
     )
 )
 async def memory_write(

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/tests/test_guidance.py

@@ -18,7 +18,8 @@ INSTRUCTIONS_ANCHORS = [
     "memory_update",
     "软删除",
     "知识库向量",
-    "1~2 分钟",
+    "定时入库",
+    "回查",
     "memory_get",
 ]
 
@@ -26,7 +27,7 @@ INSTRUCTIONS_ANCHORS = [
 TOOL_DESCRIPTION_ANCHORS: dict[str, list[str]] = {
     "memory_delete": ["知识库向量", "memory_update"],
     "memory_update": ["勿删除重建"],
-    "memory_write": ["逗号", "重复 write"],
+    "memory_write": ["逗号", "重复 write", "回查"],
     "memory_list": ["不回显正文", "memory_get"],
     "memory_keyword_search": ["不回显正文", "memory_get"],
 }
@@ -57,7 +58,7 @@ def test_tool_descriptions_contains_semantic_anchors() -> None:
 def test_skill_md_contains_core_semantics() -> None:
     """SKILL.md（skill 通道）必须包含核心语义锚点（AGENTS.md 同步点 1）。"""
     skill = Path("skills/cnb-agentic-memory/SKILL.md").read_text(encoding="utf-8")
-    for anchor in ["知识库向量", "update", "不回显正文", "逗号"]:
+    for anchor in ["知识库向量", "update", "不回显正文", "逗号", "回查"]:
         assert anchor in skill, f"SKILL.md 缺少锚点：{anchor}"
 
 

{cnb_agentic_memory-2.0.2 → cnb_agentic_memory-2.0.3}/tests/test_mcp_server.py

@@ -51,7 +51,7 @@ def test_server_metadata() -> None:
     from importlib.metadata import metadata
 
     assert mcp.name == _DIST_NAME
-    assert mcp.title == "CNB Agentic Memory"
+    assert mcp.title == "CNB Issue 智能体记忆系统"
     assert mcp.description == str(metadata(_DIST_NAME)["Summary"])
     assert mcp.version == str(metadata(_DIST_NAME)["Version"])
     assert mcp.website_url == "https://cnb.cool/xqitw/cnb-agentic-memory"

cnb_agentic_memory-2.0.2/skills/SKILL.md

@@ -1,9 +0,0 @@
-# Skills 索引
-
-根据用户的需求，匹配并调用最合适的子技能。
-
-## 技能列表
-
-### 智能体记忆
-
-- **cnb-agentic-memory** — 基于 CNB 平台的智能体记忆系统（跨会话长期记忆）。把重要信息写入记忆仓库（一条记忆 = 一个 Issue），之后用语义检索（知识库向量，高相关度）、关键词标题检索（`cnb-agentic-memory keyword`，无需知识库）或分类/标签浏览找回。**写入时必须自己撰写 title**——提炼 3~8 个高区分度关键词短语，keyword 标题检索只匹配 title，title 质量决定记忆能否被找回。支持追加更新记录、全量替换正文、软删除与恢复。适合回答"记住这个"、"帮我记一下"、"之前说过什么"、"上次是怎么解决的"、"查一下我们的记忆库"这类跨会话请求。当用户提到记忆、记住、想起、之前、上次、经验、教训、备忘时使用，详见 [cnb-agentic-memory](./cnb-agentic-memory/SKILL.md)。