Back to Details

knowledge-locator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Table of Contents

目录

Knowledge Locator

Knowledge Locator

A spatial indexing and retrieval system for finding information within and across memory palaces. Enables multi-modal search using spatial, semantic, sensory, and associative queries.
一个用于在单个或多个记忆宫殿中查找信息的空间索引与检索系统。支持通过空间、语义、感官和关联查询进行多模态搜索。

What It Is

是什么

The Knowledge Locator provides efficient information retrieval across your memory palace network by:
  • Building and maintaining spatial indices for fast lookup
  • Supporting multiple search modalities (spatial, semantic, sensory)
  • Mapping cross-references between palaces
  • Tracking access patterns for optimization
Knowledge Locator通过以下方式实现跨记忆宫殿网络的高效信息检索：
  • 构建并维护空间索引以实现快速查找
  • 支持多种搜索模态（空间、语义、感官）
  • 绘制记忆宫殿之间的交叉引用映射
  • 跟踪访问模式以优化性能

Quick Start

快速开始

Search Palaces

搜索记忆宫殿

bash
python scripts/palace_manager.py search "authentication" --type semantic
Verification: Run 
python --version
to verify Python environment.
bash
python scripts/palace_manager.py search "authentication" --type semantic
验证： 运行
python --version
以验证Python环境。

List All Palaces

列出所有记忆宫殿

bash
python scripts/palace_manager.py list
Verification: Run 
python --version
to verify Python environment.
bash
python scripts/palace_manager.py list
验证： 运行
python --version
以验证Python环境。

When To Use

适用场景

  • Finding specific concepts within one or more memory palaces
  • Cross-referencing information across different palaces
  • Discovering connections between stored information
  • Finding information using partial or contextual queries
  • Analyzing access patterns for palace optimization
  • 在一个或多个记忆宫殿中查找特定概念
  • 跨不同记忆宫殿交叉引用信息
  • 发现已存储信息之间的关联关系
  • 使用部分或上下文查询查找信息
  • 分析访问模式以优化记忆宫殿

When NOT To Use

不适用场景

  • Creating new palace structures - use memory-palace-architect
  • Processing new external resources - use knowledge-intake
  • Creating new palace structures - use memory-palace-architect
  • Processing new external resources - use knowledge-intake
  • 创建新记忆宫殿结构时——请使用memory-palace-architect
  • 处理新的外部资源时——请使用knowledge-intake
  • 创建新记忆宫殿结构时——请使用memory-palace-architect
  • 处理新的外部资源时——请使用knowledge-intake

Search Modalities

搜索模态

ModeDescriptionBest For
SpatialQuery by location path"Find concepts in the Workshop"
SemanticSearch by meaning/keywords"Find authentication-related items"
SensoryLocate by sensory attributes"Blue-colored concepts"
AssociativeFollow connection chains"Related to OAuth"
TemporalFind by creation/access date"Recently accessed"
模式描述最佳适用场景
空间通过位置路径查询"查找工坊中的概念"
语义通过含义/关键词搜索"查找与认证相关的内容"
感官通过感官属性定位"蓝色的概念"
关联追踪关联链"与OAuth相关的内容"
时间通过创建/访问日期查找"最近访问的内容"

Core Workflow

核心工作流

  1. Build Index - Create spatial index of all palaces
  2. Optimize Search - Configure search strategies and heuristics
  3. Map Cross-References - Identify inter-palace connections
  4. Test Retrieval - Validate search accuracy and speed
  5. Analyze Patterns - Track and optimize based on usage
  1. 构建索引 - 为所有记忆宫殿创建空间索引
  2. 优化搜索 - 配置搜索策略与启发式规则
  3. 映射交叉引用 - 识别记忆宫殿之间的关联
  4. 测试检索 - 验证搜索的准确性与速度
  5. 分析模式 - 根据使用情况进行跟踪与优化

Target Metrics

目标指标

  • Retrieval latency: ≤ 150ms cached, ≤ 500ms cold
  • Top-3 accuracy: ≥ 90% for semantic queries
  • Robustness: ≥ 80% success with incomplete queries
  • 检索延迟：缓存状态下≤150ms，冷启动状态下≤500ms
  • Top-3准确率：语义查询≥90%
  • 鲁棒性：不完整查询的成功率≥80%

Detailed Resources

详细资源

  • Index Structure: See 
    modules/index-structure.md
  • Search Strategies: See 
    modules/search-strategies.md
  • Cross-Reference Mapping: See 
    modules/index-structure.md
  • 索引结构：参见
    modules/index-structure.md
  • 搜索策略：参见
    modules/search-strategies.md
  • 交叉引用映射：参见
    modules/index-structure.md

PR Review Search

PR评审搜索

Search the review chamber within project palaces for past decisions and patterns.
在项目记忆宫殿的评审室中搜索过往决策与模式。

Quick Commands

快速命令

bash
undefined
bash
undefined

Search review chamber by query

按查询内容搜索评审室

python scripts/palace_manager.py search "authentication"
--palace <project_id>
--room review-chamber
python scripts/palace_manager.py search "authentication"
--palace <project_id>
--room review-chamber

List entries in specific room

列出特定房间中的条目

python scripts/palace_manager.py list-reviews
--palace <project_id>
--room decisions
python scripts/palace_manager.py list-reviews
--palace <project_id>
--room decisions

Find by tags

按标签搜索

python scripts/palace_manager.py search-reviews
--tags security,api
--since 2025-01-01
**Verification:** Run `python --version` to verify Python environment.
python scripts/palace_manager.py search-reviews
--tags security,api
--since 2025-01-01
**验证：** 运行`python --version`以验证Python环境。

Review Chamber Rooms

评审室房间

RoomContentExample Query
decisions/
Architectural choices"JWT vs sessions"
patterns/
Recurring solutions"error handling pattern"
standards/
Quality conventions"API error format"
lessons/
Post-mortems"outage learnings"
房间内容示例查询
decisions/
架构选择"JWT vs sessions"
patterns/
常用解决方案"错误处理模式"
standards/
质量规范"API错误格式"
lessons/
事后复盘"故障总结"

Context-Aware Surfacing

上下文感知检索

When starting work in a code area, surface relevant review knowledge:
bash
undefined
当您在某个代码区域开展工作时，自动呈现相关的评审知识：
bash
undefined

When in auth/ directory

当处于auth/目录时

python scripts/palace_manager.py context-search auth/
python scripts/palace_manager.py context-search auth/

Returns:

返回结果：

- Past decisions about authentication

- 过往关于认证的决策

- Known patterns in this area

- 该领域的已知模式

- Relevant standards to follow

- 需要遵循的相关标准

**Verification:** Run `python --version` to verify Python environment.
**验证：** 运行`python --version`以验证Python环境。

Integration

集成

Works with:
  • memory-palace-architect
    - Indexes palaces created by architect
  • session-palace-builder
    - Searches session-specific palaces
  • digital-garden-cultivator
    - Finds garden content and links
  • review-chamber
    - Searches PR review knowledge in project palaces
可与以下工具集成：
  • memory-palace-architect
    - 对由architect创建的记忆宫殿建立索引
  • session-palace-builder
    - 搜索会话专属记忆宫殿
  • digital-garden-cultivator
    - 查找数字花园内容及链接
  • review-chamber
    - 搜索项目记忆宫殿中的PR评审知识

Troubleshooting

故障排查

Common Issues

常见问题

Command not found Ensure all dependencies are installed and in PATH
Permission errors Check file permissions and run with appropriate privileges
Unexpected behavior Enable verbose logging with 
--verbose
flag
命令未找到 确保所有依赖已安装且已添加至PATH环境变量
权限错误 检查文件权限并使用合适的权限运行
异常行为 添加
--verbose
标志启用详细日志