jfox-cli 0.7.2__tar.gz → 0.8.0__tar.gz

jfox_cli-0.8.0/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "jfox-skills",
+  "id": "jfox-skills",
+  "owner": { "name": "zhuxixi" },
+  "metadata": {
+    "description": "JFox Zettelkasten 知识管理工具的 Claude Code 集成",
+    "version": "0.1.0"
+  },
+  "plugins": [
+    {
+      "name": "jfox",
+      "source": "./",
+      "description": "JFox 知识管理 CLI 的 Claude Code 集成——搜索、导入、整理、会话总结",
+      "version": "0.1.0",
+      "author": { "name": "zhuxixi" },
+      "keywords": ["zettelkasten", "knowledge-management"],
+      "category": "workflow"
+    }
+  ]
+}

jfox_cli-0.8.0/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "jfox",
+  "description": "JFox 知识管理 CLI 的 Claude Code 集成——搜索、导入、整理、会话总结",
+  "version": "0.1.0",
+  "author": { "name": "zhuxixi" },
+  "license": "MIT",
+  "keywords": ["zettelkasten", "knowledge-management", "cli"],
+  "skills": [
+    "./skills-recommend/claude-code/jfox-common",
+    "./skills-recommend/claude-code/jfox-ingest",
+    "./skills-recommend/claude-code/jfox-organize",
+    "./skills-recommend/claude-code/jfox-search",
+    "./skills-recommend/claude-code/jfox-session-summary"
+  ],
+  "commands": [
+    "./commands/jfox-common",
+    "./commands/jfox-ingest",
+    "./commands/jfox-organize",
+    "./commands/jfox-search",
+    "./commands/jfox-session-summary"
+  ]
+}

{jfox_cli-0.7.2 → jfox_cli-0.8.0}/AGENTS.md

@@ -38,21 +38,25 @@ jfox/
 ├── jfox/                      # 主包
 │   ├── __init__.py
 │   ├── __main__.py            # 入口点
-│   ├── cli.py                 # CLI 主程序（所有命令）
+│   ├── cli.py                 # CLI 主程序（所有命令，~2900 行）
 │   ├── models.py              # 数据模型（Note, NoteType）
 │   ├── config.py              # 配置管理（ZKConfig, use_kb）
 │   ├── global_config.py       # 全局配置管理（多知识库）
 │   ├── note.py                # 笔记 CRUD 操作
 │   ├── kb_manager.py          # 知识库管理器
-│   ├── embedding_backend.py   # 嵌入模型后端
+│   ├── embedding_backend.py   # 嵌入模型后端（支持 daemon 代理）
+│   ├── daemon/                # Embedding 模型 HTTP 守护进程
 │   ├── vector_store.py        # ChromaDB 向量存储
 │   ├── bm25_index.py          # BM25 关键词索引
 │   ├── search_engine.py       # 混合搜索引擎（RRF 融合）
 │   ├── graph.py               # 知识图谱（NetworkX）
-│   ├── indexer.py             # 文件监控和索引
+│   ├── indexer.py             # 文件监控和增量索引
 │   ├── formatters.py          # 多格式输出（JSON/CSV/YAML/Tree）
 │   ├── template.py            # 模板系统
 │   ├── template_cli.py        # 模板 CLI 子命令
+│   ├── git_extractor.py       # Git 仓库数据提取器（ingest 功能）
+│   ├── model_downloader.py    # 嵌入模型下载与缓存管理
+│   ├── note_index.py          # 笔记索引管理（文件名↔ID 映射）
 │   └── performance.py         # 性能优化工具
 ├── tests/                     # 测试目录
 │   ├── conftest.py            # pytest 配置和 fixtures
@@ -81,30 +85,32 @@ jfox/
 ### 安装开发环境
 
 ```bash
-# 创建虚拟环境（推荐）
-python -m venv .venv
-source .venv/bin/activate  # Linux/Mac
-.venv\Scripts\activate     # Windows
-
-# 开发模式安装
+# 安装（使用 uv，推荐）
 uv sync --extra dev
+
+# 安装（legacy pip fallback）
+pip install -e ".[dev]"
 ```
 
 ### 运行测试
 
 ```bash
 # 运行所有测试
-pytest tests/ -v
+uv run pytest tests/ -v
 
 # 运行特定测试文件
-pytest tests/test_core_workflow.py -v
+uv run pytest tests/test_core_workflow.py -v
 
 # 运行带标记的测试
-pytest tests/ -m "not slow"      # 排除慢测试
-pytest tests/ -m "integration"   # 仅运行集成测试
+uv run pytest tests/ -m "not slow"                     # 排除慢测试
+uv run pytest tests/ -m "not embedding and not slow"   # 快速测试（不加载模型）
+uv run pytest tests/ -m "integration"                  # 仅运行集成测试
 
 # 保留测试数据（用于调试）
-pytest tests/ --keep-data
+uv run pytest tests/ --keep-data
+
+# 覆盖率
+uv run pytest tests/ --cov=jfox --cov-report=html
 
 # Windows 全量测试（清理 + 测试）
 .\run_full_test.ps1
@@ -117,21 +123,21 @@ pytest tests/ --keep-data
 
 ```bash
 # 使用 black 格式化
-black jfox/ tests/
+uv run black jfox/ tests/
 
 # 使用 ruff 检查
-ruff check jfox/ tests/
+uv run ruff check jfox/ tests/
 ```
 
-### 本地安装和验证
+### 构建和验证
 
 ```bash
-# 安装到本地
-pip install -e .
+# 构建
+uv build
 
-# 验证安装
-jfox --help
-jfox --version
+# 验证 CLI
+uv run jfox --help
+uv run jfox --version
 ```
 
 ## 代码组织
@@ -140,16 +146,21 @@ jfox --version
 
 | 模块 | 职责 |
 |------|------|
-| `cli.py` | 所有 CLI 命令定义和实现（~1000 行） |
+| `cli.py` | 所有 CLI 命令定义和实现（~2900 行） |
 | `models.py` | Note 数据类、NoteType 枚举、Markdown 序列化/反序列化 |
 | `config.py` | ZKConfig 配置类、use_kb 上下文管理器（多知识库切换） |
 | `global_config.py` | GlobalConfigManager，管理 ~/.zk_config.json |
 | `note.py` | 笔记 CRUD：create_note, save_note, load_note, delete_note |
 | `kb_manager.py` | KnowledgeBaseManager，知识库生命周期管理 |
-| `search_engine.py` | HybridSearchEngine，支持 HYBRID/SEMANTIC/KEYWORD 模式 |
+| `search_engine.py` | HybridSearchEngine，支持 HYBRID/SEMANTIC/KEYWORD 模式，RRF 融合 |
 | `bm25_index.py` | BM25Index，本地文件存储的关键词索引 |
 | `vector_store.py` | VectorStore，ChromaDB 封装 |
 | `graph.py` | KnowledgeGraph，NetworkX 图分析和可视化 |
+| `git_extractor.py` | Git 仓库数据提取器（ingest 功能） |
+| `model_downloader.py` | 嵌入模型下载与缓存管理 |
+| `note_index.py` | 笔记索引管理（文件名↔ID 映射） |
+| `indexer.py` | 文件监控（watchdog）+ 增量索引 |
+| `daemon/` | Embedding 模型 HTTP 守护进程（server/client/process） |
 
 ### 笔记类型
 
@@ -158,8 +169,14 @@ class NoteType(Enum):
     FLEETING = "fleeting"       # 闪念笔记 - 快速捕捉
     LITERATURE = "literature"   # 文献笔记 - 读书笔记
     PERMANENT = "permanent"     # 永久笔记 - 整理后的知识
+    SESSION = "session"         # AI Agent 会话记录
 ```
 
+各类型文件名格式：
+- `fleeting`: `YYYYMMDD-HHMMSS.md`
+- `literature`: `YYYYMMDDHHMMSS-{slug}.md`
+- `permanent`: `YYYYMMDDHHMMSS-{slug}.md`
+
 ### 笔记文件格式
 
 每个笔记是一个 Markdown 文件，包含 YAML frontmatter：
@@ -174,6 +191,7 @@ updated: '2026-03-21T01:15:28'
 tags: [tag1, tag2]
 links: ['20260321011546']      # 正向链接
 backlinks: ['20260321011550']  # 反向链接（自动生成）
+topic: null                    # 会话主题（仅 session 类型）
 ---
 
 # 笔记标题
@@ -184,8 +202,8 @@ backlinks: ['20260321011550']  # 反向链接（自动生成）
 ### 多知识库支持
 
 - 全局配置存储在 `~/.zk_config.json`
-- 默认知识库路径：`~/.zettelkasten`
-- 命名知识库路径：`~/.zettelkasten-{name}`
+- 默认知识库路径：`~/.zettelkasten/default/`
+- 命名知识库路径：`~/.zettelkasten/<name>/`
 - 使用 `use_kb()` 上下文管理器临时切换知识库
 
 ## 代码风格指南
@@ -224,6 +242,13 @@ backlinks: ['20260321011550']  # 反向链接（自动生成）
 2. **集成测试**: 测试完整工作流
 3. **性能测试**: 标记为 `@pytest.mark.performance`
 
+### 测试目录结构
+
+- `tests/unit/` — 纯逻辑单元测试（约 25 个文件）
+- `tests/integration/` — 跨模块集成测试
+- `tests/performance/` — 性能基准测试
+- 根级遗留：`test_config_unit.py`、`test_config_set_unit.py`（与 unit 目录中测试内容不同）
+
 ### 测试工具
 
 - **临时知识库**: `tests/utils/temp_kb.py`
@@ -235,34 +260,49 @@ backlinks: ['20260321011550']  # 反向链接（自动生成）
 ```python
 # conftest.py 中定义的主要 fixtures
 
-def test_example(temp_kb, cli, generator):
+def test_example(temp_kb, cli, cli_fast, generator, mock_embedding_backend):
     """
     temp_kb: 临时知识库路径
     cli: 已初始化的 ZKCLI 实例
+    cli_fast: ZKCLI with mocked embeddings（快速，不加载模型）
     generator: NoteGenerator 数据生成器
+    mock_embedding_backend: mock 嵌入后端
     """
     pass
 ```
 
+### 测试标记（Markers）
+
+| 标记 | 含义 |
+|------|------|
+| `slow` | 慢测试 |
+| `performance` | 性能基准 |
+| `integration` | 集成测试 |
+| `embedding` | 涉及模型加载 |
+| `workflow` | 工作流测试 |
+| `bulk` | 批量操作测试 |
+
+### 测试运行规则
+
+- **全量/集成测试（~50min）不要自主运行**，提供命令让用户手动执行
+- **快速单元测试（几秒内）可以自主运行**，如单个模块的纯逻辑测试，不涉及 embedding 或 ChromaDB
+- `pytest.ini` 配置：`timeout=120`、`--strict-markers`、`-ra`
+- 测试以单进程运行，避免 ChromaDB/模型加载冲突
+
 ### 编写新测试的模板
 
 ```python
 # tests/test_feature.py
 
 import pytest
-from tests.utils.temp_kb import temp_knowledge_base
-from tests.utils.jfox_cli import ZKCLI
 
 
 class TestFeatureName:
     """测试功能名称"""
     
-    def test_basic_functionality(self, temp_kb):
+    def test_basic_functionality(self, temp_kb, cli):
         """测试基本功能"""
-        cli = ZKCLI(temp_kb)
-        cli.init()
-        
-        # 测试代码
+        # 使用 fixture 自动初始化的临时知识库和 CLI 实例
         result = cli.add("测试内容", title="测试笔记")
         
         assert result.success
@@ -343,6 +383,37 @@ def new_command(
 | 图谱构建 | <1s (1000笔记) |
 | 文件监控 | 实时 (<1s 延迟) |
 
+## CI（GitHub Actions）
+
+`.github/workflows/integration-test.yml` 包含四个 job：
+
+- **Fast**（PR/push 触发）：`not embedding and not slow`，Python 3.11，Ubuntu + Windows
+- **Core**（main 分支推送）：Core workflow 测试，使用真实 embedding，Python 3.10 + 3.12
+- **Full**（手动触发）：所有测试、所有 OS、所有 Python 版本
+- **Coverage**（Fast 完成后）：运行覆盖率，上传 HTML/XML 产物
+
+**Release** 工作流（`.github/workflows/publish.yml`）：在 GitHub Release 发布时自动推送到 PyPI。
+
+## Windows 注意事项
+
+- `robocopy` 参数会被 bash 误解析，应使用 `cmd.exe /c "robocopy source dest /E"`
+- 设置 `PYTHONUTF8=1` 和 `chcp 65001` 避免编码问题
+- HuggingFace 国内镜像：`export HF_ENDPOINT=https://hf-mirror.com`
+
+## 分支规则
+
+- **main 是保护分支**，不能直接 commit 或 push
+- 所有改动必须通过**新分支 + PR** 合入
+
+## 发版规则
+
+- 发版时必须同时修改三处版本号：
+  1. `pyproject.toml`
+  2. `jfox/__init__.py`
+  3. `uv.lock`
+- 操作顺序：先改 `pyproject.toml` 和 `__init__.py`，再跑 `uv lock` 更新 lock 文件
+- （曾有 #88 遗漏 `__init__.py` 的教训）
+
 ## 相关资源
 
 - **详细 CLI 文档**: `README.md`
@@ -384,6 +455,12 @@ class OutputFormatter:
 # 4. 添加测试
 ```
 
+## 常见陷阱（Gotchas）
+
+- `pytest.ini` 的 `addopts` 已包含 `-v`，手动再加 `-v` 是冗余的
+- 测试目录重组已基本完成，根级 `test_config_unit.py` 和 `test_config_set_unit.py` 与 `tests/unit/` 中对应文件测试内容不同，不是重复
+- `jfox show <id_or_title>` 复用 `find_note_id_by_title_or_id` 定位笔记，只读输出完整 Markdown
+
 ---
 
 ## Session History

{jfox_cli-0.7.2 → jfox_cli-0.8.0}/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to jfox-cli will be documented in this file.
 
+## [0.8.0] - 2026-05-10
+
+### Features
+- add Claude Code plugin packaging for jfox skills (#209) (#210)
+- 新增 session 笔记类型，专存 AI Agent 会话记录 (#202)
+
+### Changes
+- sync AGENTS.md with CLAUDE.md and current codebase (#208)
+
+[0.8.0]: https://github.com/zhuxixi/jfox/compare/v0.7.2...v0.8.0
+
 ## [0.7.2] - 2026-05-07
 
 ### Fixes

{jfox_cli-0.7.2 → jfox_cli-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jfox-cli
-Version: 0.7.2
+Version: 0.8.0
 Summary: JFox - Zettelkasten 知识管理 CLI 工具
 Project-URL: Homepage, https://github.com/zhuxixi/jfox
 Project-URL: Repository, https://github.com/zhuxixi/jfox

jfox_cli-0.8.0/commands/jfox-common.md

@@ -0,0 +1,6 @@
+---
+name: jfox-common
+description: 管理知识库（创建、切换、健康检查）和笔记 CRUD
+---
+
+请调用 jfox-common skill 来完成用户的请求。传递用户提供的参数。

jfox_cli-0.8.0/commands/jfox-ingest.md

@@ -0,0 +1,6 @@
+---
+name: jfox-ingest
+description: 从 Git 仓库导入数据（git log、PR、Issues）为 fleeting 笔记
+---
+
+请调用 jfox-ingest skill 来完成用户的请求。传递用户提供的参数。

jfox_cli-0.8.0/commands/jfox-organize.md

@@ -0,0 +1,6 @@
+---
+name: jfox-organize
+description: 整理知识库、提炼 fleeting 笔记为 permanent、生成 wiki links
+---
+
+请调用 jfox-organize skill 来完成用户的请求。传递用户提供的参数。

jfox_cli-0.8.0/commands/jfox-search.md

@@ -0,0 +1,6 @@
+---
+name: jfox-search
+description: 搜索笔记、图谱查询、链接推荐
+---
+
+请调用 jfox-search skill 来完成用户的请求。传递用户提供的参数。

jfox_cli-0.8.0/commands/jfox-session-summary.md

@@ -0,0 +1,6 @@
+---
+name: jfox-session-summary
+description: 保存会话总结到知识库作为 fleeting 笔记
+---
+
+请调用 jfox-session-summary skill 来完成用户的请求。传递用户提供的参数。

{jfox_cli-0.7.2 → jfox_cli-0.8.0}/jfox/__init__.py

@@ -1,5 +1,5 @@
 """JFox - Zettelkasten 知识管理工具"""
 
-__version__ = "0.7.2"
+__version__ = "0.8.0"
 __author__ = "User"
 __email__ = "user@example.com"

{jfox_cli-0.7.2 → jfox_cli-0.8.0}/jfox/cli.py

@@ -292,6 +292,7 @@ def _add_note_impl(
     source: Optional[str],
     output_format: str,
     template: Optional[str] = None,
+    topic: Optional[str] = None,
 ):
     """添加笔记的内部实现"""
     # 如果指定了模板，使用模板渲染
@@ -305,6 +306,7 @@ def _add_note_impl(
                 "title": title or "",
                 "content": content,
                 "source": source or "",
+                "topic": topic or "",
             }
 
             # 渲染模板
@@ -331,7 +333,13 @@ def _add_note_impl(
     try:
         nt = NoteType(note_type.lower())
     except ValueError:
-        raise ValueError(f"Invalid note type: {note_type}. Use: fleeting, literature, permanent")
+        raise ValueError(
+            f"Invalid note type: {note_type}. Use: fleeting, literature, permanent, session"
+        )
+
+    # session 类型必须提供 --topic
+    if nt == NoteType.SESSION and not topic:
+        raise ValueError("--type session 需要 --topic 参数")
 
     # 从内容中提取维基链接
     wiki_links = extract_wiki_links(content)
@@ -353,6 +361,7 @@ def _add_note_impl(
         tags=tags or [],
         links=resolved_links,
         source=source,
+        topic=topic,
     )
 
     # 保存笔记
@@ -410,7 +419,7 @@ def add(
     content: Optional[str] = typer.Argument(None, help="笔记内容（支持 [[笔记标题]] 格式链接）"),
     title: Optional[str] = typer.Option(None, "--title", "-t", help="笔记标题"),
     note_type: str = typer.Option(
-        "fleeting", "--type", help="笔记类型 (fleeting/literature/permanent)"
+        "fleeting", "--type", help="笔记类型 (fleeting/literature/permanent/session)"
     ),
     tags: Optional[List[str]] = typer.Option(None, "--tag", help="标签（可多次使用）"),
     source: Optional[str] = typer.Option(None, "--source", "-s", help="来源（文献笔记）"),
@@ -420,6 +429,7 @@ def add(
     content_file: Optional[str] = typer.Option(
         None, "--content-file", help="从文件读取内容（用 - 表示 stdin）"
     ),
+    topic: Optional[str] = typer.Option(None, "--topic", help="会话主题（session 类型必填）"),
     kb: Optional[str] = typer.Option(None, "--kb", "-k", help="目标知识库名称"),
     output_format: str = typer.Option("table", "--format", "-f", help="输出格式: json, table"),
     json_output: bool = typer.Option(
@@ -447,7 +457,7 @@ def add(
         from .config import use_kb
 
         with use_kb(kb):
-            _add_note_impl(content, title, note_type, tags, source, output_format, template)
+            _add_note_impl(content, title, note_type, tags, source, output_format, template, topic)
 
     except typer.Exit:
         raise
@@ -783,7 +793,9 @@ def _list_impl(
         try:
             nt = NoteType(note_type.lower())
         except ValueError:
-            raise ValueError(f"Invalid note type: {note_type}")
+            raise ValueError(
+                f"Invalid note type: {note_type}. Use: fleeting, literature, permanent, session"
+            )
 
     notes = note.list_notes(note_type=nt, tags=tags, limit=limit)
     data = [n.to_dict() for n in notes]
@@ -1195,6 +1207,7 @@ def _edit_impl(
     note_type: Optional[str],
     source: Optional[str],
     output_format: str,
+    topic: Optional[str] = None,
 ):
     """编辑笔记的内部实现"""
     # 验证：--content 和 --content-file 互斥
@@ -1206,10 +1219,10 @@ def _edit_impl(
         content = _read_content_file(content_file)
 
     # 验证：至少指定一个编辑字段
-    if all(v is None for v in [content, title, tags, note_type, source]):
+    if all(v is None for v in [content, title, tags, note_type, source, topic]):
         raise ValueError(
             "至少指定一个要编辑的字段 "
-            "(--content, --content-file, --title, --tags, --type, --source)"
+            "(--content, --content-file, --title, --tags, --type, --source, --topic)"
         )
 
     # 加载笔记
@@ -1234,9 +1247,15 @@ def _edit_impl(
             new_type = NoteType(note_type.lower())
         except ValueError:
             raise ValueError(
-                f"Invalid note type: {note_type}. Use: fleeting, literature, permanent"
+                f"Invalid note type: {note_type}. Use: fleeting, literature, permanent, session"
             )
         n.type = new_type
+        # 改为 session 类型时，笔记必须已有 topic 或通过 --topic 设置
+        if new_type == NoteType.SESSION and not n.topic and not topic:
+            raise ValueError("改为 session 类型时需要 --topic 参数")
+
+    if topic is not None:
+        n.topic = topic
 
     # 如果内容被更新，解析 wiki links
     if content is not None:
@@ -1333,9 +1352,10 @@ def edit(
     title: Optional[str] = typer.Option(None, "--title", "-t", help="新标题"),
     tags: Optional[List[str]] = typer.Option(None, "--tag", help="新标签（替换全部）"),
     note_type: Optional[str] = typer.Option(
-        None, "--type", help="新类型 (fleeting/literature/permanent)"
+        None, "--type", help="新类型 (fleeting/literature/permanent/session)"
     ),
     source: Optional[str] = typer.Option(None, "--source", "-s", help="新来源"),
+    topic: Optional[str] = typer.Option(None, "--topic", help="会话主题（session 类型）"),
     kb: Optional[str] = typer.Option(None, "--kb", "-k", help="目标知识库名称"),
     output_format: str = typer.Option("table", "--format", "-f", help="输出格式: json, table"),
     json_output: bool = typer.Option(
@@ -1352,7 +1372,7 @@ def edit(
 
         with use_kb(kb):
             _edit_impl(
-                note_id, content, content_file, title, tags, note_type, source, output_format
+                note_id, content, content_file, title, tags, note_type, source, output_format, topic
             )
     except typer.Exit:
         raise
@@ -1684,28 +1704,36 @@ def _inbox_impl(
     from .note_index import get_note_index
 
     idx = get_note_index()
-    fleeting_notes = idx.list_meta(note_type=NoteType.FLEETING, limit=limit)
+    # 查询 fleeting 和 session 类型笔记（不传 limit，合并后再截断）
+    fleeting_notes = idx.list_meta(note_type=NoteType.FLEETING)
+    session_notes = idx.list_meta(note_type=NoteType.SESSION)
+    all_notes = fleeting_notes + session_notes
+    # Sort by created descending
+    all_notes.sort(key=lambda m: m.created or "", reverse=True)
+    all_notes = all_notes[:limit]
 
     result = {
-        "total": len(fleeting_notes),
+        "total": len(all_notes),
         "notes": [
             {
                 "id": m.id,
                 "title": m.title,
+                "type": m.type.value,
                 "created": m.created,
                 "filepath": m.filepath if m.filepath else None,
             }
-            for m in fleeting_notes
+            for m in all_notes
         ],
     }
 
     if output_format == "json":
         print(output_json(result))
     else:
-        console.print(f"[bold]Fleeting Notes ({len(fleeting_notes)}):[/bold]\n")
-        for m in fleeting_notes:
+        console.print(f"[bold]Inbox ({len(all_notes)}):[/bold]\n")
+        for m in all_notes:
             time_str = m.created[11:16] if m.created and len(m.created) >= 16 else ""
-            console.print(f"- [{time_str}] {m.title}")
+            type_badge = {"fleeting": "fl", "session": "se"}.get(m.type.value, "??")
+            console.print(f"- [{time_str}] [{type_badge}] {m.title}")
 
 
 def _suggest_links_impl(
@@ -1795,7 +1823,7 @@ def inbox(
         False, "--json", help="JSON 输出（快捷方式，等同于 --format json）"
     ),
 ):
-    """查看临时笔记 (Fleeting Notes)"""
+    """查看临时笔记和会话记录 (Fleeting + Session Notes)"""
     try:
         # 处理 --json 快捷方式
         if json_output:

{jfox_cli-0.7.2 → jfox_cli-0.8.0}/jfox/config.py

@@ -58,6 +58,7 @@ class ZKConfig:
             self.notes_dir / "fleeting",
             self.notes_dir / "literature",
             self.notes_dir / "permanent",
+            self.notes_dir / "session",
             self.zk_dir,
             self.chroma_dir,
             self.zk_dir / "cache",

{jfox_cli-0.7.2 → jfox_cli-0.8.0}/jfox/kb_manager.py

@@ -249,12 +249,12 @@ class KnowledgeBaseManager:
 
         # 统计笔记数量
         total = 0
-        by_type = {"fleeting": 0, "literature": 0, "permanent": 0}
+        by_type = {"fleeting": 0, "literature": 0, "permanent": 0, "session": 0}
 
         if path.exists():
             notes_dir = path / "notes"
             if notes_dir.exists():
-                for note_type in ["fleeting", "literature", "permanent"]:
+                for note_type in ["fleeting", "literature", "permanent", "session"]:
                     type_dir = notes_dir / note_type
                     if type_dir.exists():
                         count = len(list(type_dir.glob("*.md")))

{jfox_cli-0.7.2 → jfox_cli-0.8.0}/jfox/models.py

@@ -16,6 +16,7 @@ class NoteType(Enum):
     FLEETING = "fleeting"  # 闪念笔记
     LITERATURE = "literature"  # 文献笔记
     PERMANENT = "permanent"  # 永久笔记
+    SESSION = "session"  # AI Agent 会话记录
 
 
 @dataclass
@@ -32,6 +33,7 @@ class Note:
     links: List[str] = field(default_factory=list)  # 正向链接
     backlinks: List[str] = field(default_factory=list)  # 反向链接
     source: Optional[str] = None  # 来源（文献笔记）
+    topic: Optional[str] = None  # 会话主题（session 类型）
 
     # 运行时字段（不持久化到 frontmatter）
     embedding: Optional[List[float]] = None  # 向量
@@ -48,9 +50,12 @@ class Note:
         """生成文件名"""
         if self.type == NoteType.FLEETING:
             return f"{self.id[:8]}-{self.id[8:]}.md"
+        elif self.type == NoteType.SESSION:
+            source = self.topic or self.title or "untitled"
+            slug = re.sub(r"[^\w\-]", "", source.lower().replace(" ", "-"))[:50]
+            return f"{self.id}-{slug}.md"
         else:
             slug = self.title.lower().replace(" ", "-")[:50]
-            # 移除特殊字符
             slug = re.sub(r"[^\w\-]", "", slug)
             return f"{self.id}-{slug}.md"
 
@@ -80,6 +85,8 @@ class Note:
         }
         if self.source:
             frontmatter["source"] = self.source
+        if self.topic:
+            frontmatter["topic"] = self.topic
 
         fm_yaml = yaml.dump(frontmatter, allow_unicode=True, sort_keys=False)
 
@@ -128,6 +135,7 @@ class Note:
             links=fm.get("links", []),
             backlinks=fm.get("backlinks", []),
             source=fm.get("source"),
+            topic=fm.get("topic"),
         )
 
     def to_dict(self) -> Dict[str, Any]:
@@ -144,4 +152,5 @@ class Note:
             "filepath": str(self.filepath),
             "score": self.score,
             "hop": self.hop,
+            "topic": self.topic,
         }