HKUDS/DeepTutor · error · ValueError

Linked folder is no longer available: {external}

Error message

Linked folder is no longer available: {external}

What it means

Error "Linked folder is no longer available: {external}" thrown in HKUDS/DeepTutor.

Source

Thrown at deeptutor/knowledge/manager.py:1047

    def get_knowledge_base_path(self, name: str | None = None) -> Path:
        """Get path to a knowledge base.

        Connected KBs (Obsidian vaults, linked indexes) live outside
        ``base_dir`` — resolve them to their external pointer so callers that
        ask for "where is this KB's data" reach the right place.
        """
        self.config = self._load_config()
        if name is None:
            name = self.config.get("default")
            if name is None:
                raise ValueError("No default knowledge base set")

        entry = self.config.get("knowledge_bases", {}).get(name, {})
        external = external_root_of(entry)
        if external:
            folder = Path(external).expanduser()
            if not folder.is_dir():
                raise ValueError(f"Linked folder is no longer available: {external}")
            return folder

        kb_dir = self.base_dir / name
        if not kb_dir.exists():
            raise ValueError(f"Knowledge base not found: {name}")

        return kb_dir

    def get_rag_storage_path(self, name: str | None = None) -> Path:
        """Get active index storage path for a knowledge base."""
        kb_dir = self.get_knowledge_base_path(name)
        from deeptutor.services.rag.embedding_signature import signature_from_embedding_config
        from deeptutor.services.rag.index_versioning import (
            resolve_storage_dir_for_read,
        )

        active_storage = resolve_storage_dir_for_read(kb_dir, signature_from_embedding_config())
        legacy_storage = kb_dir / "rag_storage"

View on GitHub (pinned to 3e82f13042)

When it happens

Trigger: Thrown at deeptutor/knowledge/manager.py:1047 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of HKUDS/DeepTutor@3e82f13042 (2026-08-27). Data as JSON: /api/errors/29dc2b0656c02e88. Report an issue: GitHub.