Hindsight 如何用 hindsight fs mount 把银行的 Knowledge Pages 镜像为本地 Markdown 文件【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightHindsight 银行的 Knowledge Pages 是一组会随记忆整理自动重写的 markdown 文档。当这些页面已经建好但你不想每次都用 API 或knowledge-base子命令去读它们时可以用 CLI 的hindsight fs mount把整个知识库镜像到本地磁盘文件夹树变成真实目录每个页面变成一个带 YAML frontmatter 的 markdown 文件并由后台刷新循环持续保持最新。镜像之后ls、cat、grep、rg、fzf和你的编辑器都能直接对真实文件工作不需要 SDK 或 API 客户端。前提是有一个可访问的 Hindsight 服务本地或远程且目标银行里已经存在 Knowledge Pages。准备条件安装 CLI 并配置访问安装 CLI该命令会下载并执行官方安装脚本来安装hindsightcurl -fsSL https://hindsight.vectorize.io/get-cli | bash配置 API 地址与密钥让 CLI 指向你的服务# 交互式配置 hindsight configure # 或直接指定 hindsight configure --api-url http://localhost:8888 --api-key your-api-key也可以用环境变量配置环境变量优先级最高export HINDSIGHT_API_URLhttp://localhost:8888 export HINDSIGHT_API_KEYyour-api-key配置优先级从高到低是环境变量HINDSIGHT_API_URL、HINDSIGHT_API_KEY、命名 profile-p name或$HINDSIGHT_PROFILE、~/.hindsight/config共享配置、默认值http://localhost:8888。先确认银行存在、并且里面已经有知识页面# 列出所有银行 hindsight bank list # 查看该银行的文件夹/页面树落后的页面会标记 stale hindsight knowledge-base tree my-bankmy-bank是文档示例用的银行 ID请替换成hindsight bank list输出中的实际 ID。如果银行里还没有页面可以先用hindsight knowledge-base create-page bank_id 页面名 页面回答的问题创建——内容在后台生成通过返回的operation_id轮询可知道内容是否就绪详见 Knowledge Pages API。前台挂载一条命令镜像知识库hindsight fs mount --bank my-bank这条命令是前台运行先把银行的知识库同步进挂载目录然后进入循环每隔一个刷新间隔默认 30 秒再同步一次直到按 Ctrl-C 停止。每轮同步都会输出一行日志源码 fs/mod.rs 中的格式数值以实际输出为准[2026-09-14 01:30:00] synced 5 pages / 2 folders — 2 updated, 3 unchanged, 0 removed常用选项选项作用位置参数dir或环境变量HINDSIGHT_FS_DIR指定挂载目录默认./hindsight-fs-b, --bank bank_id要镜像的银行也可用环境变量HINDSIGHT_BANK_ID-i, --interval 秒刷新间隔默认 30 秒--once只做一次同步就退出等价于fs sync--writable让镜像文件可编辑默认是只读文件。注意即使开了--writable镜像仍是单向的本地改动会在下次刷新时被还原后台挂载让镜像长期保持最新如果希望镜像在终端关闭后仍然更新用--detach启动后台守护进程等价于hindsight fs starthindsight fs mount --bank my-bank --detach启动成功会打印守护进程 PID 和日志路径并提示停止方式。后台模式下常用的配套命令# 查看守护进程、最近一次同步与健康状态不健康时以非零码退出 hindsight fs status ./hindsight-fs # 查看守护进程日志的末尾最近 40 行 hindsight fs logs ./hindsight-fs # 手动触发一次刷新后退出 hindsight fs sync --bank my-bank # 停止该目录对应的后台守护进程 hindsight fs stop ./hindsight-fsfs status会输出挂载目录、银行、API 地址、模式read-only (edits blocked)或writable (one-way; edits reverted on refresh)、守护进程状态、Last sync时间与Health: ok。它是否健康可以直接用退出码判断适合放进脚本。--stale-after 秒可调“多久没同步算过期”默认是max(interval×3, 15)。验证镜像结果挂载完成后验证方式就是普通文件操作ls -R ./hindsight-fs cat ./hindsight-fs/Operations/Deploying\ the\ API.md rg deploy ./hindsight-fs文件夹树变成真实目录每个页面是一个 markdown 文件文件内容带 YAML frontmatterid、type、title、description、tags、timestamp随后是页面正文——与 API 的GET /knowledge-base/pages/{page_id}返回的markdown字段是同一种文档。判断镜像是否健康前台模式每轮同步打印synced N pages / M folders — ... updated, ... unchanged, ... removed出错时打印sync failed: 原因。后台模式hindsight fs status dir显示Health: ok且Last sync时间持续更新状态异常时退出码非零。银行里根本没有知识库时hindsight fs list --bank my-bank会提示No knowledge base in bank my-bank.——fs list只列出该银行的文件夹和页面不写任何文件。卸载与替代路径卸载会删除本地文件执行前确认挂载目录里只有镜像内容# 停止守护进程并删除镜像文件与本地控制数据 hindsight fs unmount ./hindsight-fs输出会说明删除了多少个镜像文件。镜像只是记忆的投影删掉本地文件不损失任何银行内容下次挂载会重新生成。如果只是一次性导出、不想维持一个长期挂载API 侧有等价路径hindsight knowledge-base export bank_id把整个知识库导出为一组可移植的 markdown 文件一个嵌套index.md、每个页面一个page-id.md重建过的页面附带page-id.log.md刷新历史适合提交到别的仓库或存档。边界说明镜像是单向的银行侧的页面更新consolidation 之后页面自动重写会在下一轮刷新落到本地文件本地文件默认只读--writable也只在本地编辑方便意义上有用改动会在下次刷新被还原。--bank指定的银行若没有知识页面挂载本身可以运行但没有文件可写先用hindsight knowledge-base tree确认。页面内容背后是 mental model默认只从该银行的 observations 增量刷新、不会读取其他页面页面与 API 行为一致的细节见 Knowledge Pages 与 Knowledge Pages API。参考Knowledge Pages 概念文档CLI ReferenceKnowledge Pages APIfs子命令实现【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考