coding-agents 使用指南
为 DeepSeek Harness 注入 Hindsight 长期项目记忆:每轮会话自动召回知识页和上下文,对话自动入库,按仓库共享记忆银行。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
hindsight
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add @vectorize-io/hindsight-coding-agents
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- Memory Performance & Accuracy
- Quick Start — server · clients · platforms · embedded
- Adding Hindsight to Your Agent — LLM Wrapper · integrations · coding agents · MCP
- Use Cases
- Running in Production
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
安装后还需要跑什么命令初始化记忆吗?
不需要。开启后插件在每个会话开始时自动做冷启动检查、后台拉取 git 历史和代码库结构,记忆在后台持续补充,没有需要手动运行的命令。
数据存在哪里?会上传到云端吗?
默认指向 Hindsight Cloud(需提供 API Token),也可以改为自托管服务或本机守护进程(127.0.0.1:9077)。聊天记录和知识页都写入"记忆银行",按仓库隔离。
多个 DSH 会话(不同项目)会串数据吗?
不会。每个工作区独立解析到一个记忆银行(默认命名 coding-agent::<仓库名>),插件按 session.header.cwd 分别建库。子代理会话也不会重复落库。
安装在哪一层,会影响所有 DSH profile 吗?
通过 cordis.patch.yml 挂载到宿主层,对所有 profile 生效;如果只想在某个 profile 关闭,把那一个 profile 自己的 cordis.patch.yml 里这一行改成 disabled: true 即可。
如何停用某个仓库的记忆?
在 ~/.hindsight/coding-agent.json 的 banks 节里按解析后的银行 id 设 disabled: true,或在 optInPaths 里只列出允许的目录,并把 optInOnly 设为 true。
检索结果会出现在哪?
检索到的内容以 source: { kind: 'plugin', form: 'recall' } 的用户消息追加到模型上下文;模型自己也可以调用 hindsight_search_knowledge_pages、hindsight_reflect 等工具主动查询。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 未声明
- Node: 未声明
- Platforms: macOS, Windows, Linux
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则