🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口，低成本玩转 AI
去看看
DeepSeek Harness Hub
MCP兼容手册

时相记忆 dawn-471/foresight

DeepSeek Harness
dawn-4716 天前有提交已提供中文文档扫描：含敏感能力
在 GitHub 查看 ↗

面向 DeepSeek Harnessdsh的时相化长期记忆插件。

31.5/100
综合分
2
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/10/29 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查有告警：未发布到 npm registry，仅可从源码安装。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add dawn-471/foresight
该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位：需留意
是什么
dsh 原生插件 · chat
装得上吗
实装验证未通过（dependency_conflict），装前请到仓库确认最近更新与 issue
安全吗
本站尚未对该插件做风险分级
暂未覆盖，不等同于无风险
还在维护吗
活跃：最近一次提交在 6 天前
档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
⚠︎ 实装验证未通过（dependency_conflict · 2026/9/25） ——可能是验证环境差异，装前建议到 GitHub 仓库确认最近更新与 issue。
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查⚠ 装前注意

未发布到 npm registry，仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包@foresight/memory（未发布到 npm，仅可源码安装）
✓Node 引擎要求 >=22.13 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/10 15:49:24

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描：含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件读取剪贴板或密钥环境变量发起外部网络请求
查看扫描证据（共 106 处，展示前 103 条）
  • 读取本地文件
    eval/adapters/common.mjs:19
    const text = fs.readFileSync(file, 'utf8')
  • 读取本地文件
    eval/adapters/common.mjs:151
    const tpl = fs.readFileSync(policyTemplatePath, 'utf8')
  • 写入本地文件
    eval/adapters/common.mjs:152
    fs.writeFileSync(path.join(dir, 'policy.yaml'), tpl)
  • 读取本地文件
    eval/adapters/locomo.mjs:67
    const raw = JSON.parse(fs.readFileSync(file, 'utf8'))
  • 读取本地文件
    eval/adapters/locomo.mjs:85
    const raw = JSON.parse(fs.readFileSync(file, 'utf8'))
  • 读取本地文件
    eval/adapters/longmemeval.mjs:64
    const raw = JSON.parse(fs.readFileSync(file, 'utf8'))
  • 读取本地文件
    eval/adapters/longmemeval.mjs:79
    for (const it of JSON.parse(fs.readFileSync(file, 'utf8'))) {
  • 写入本地文件
    eval/bench-timesuite/gen.mjs:183
    fs.writeFileSync(OUT, lines.join('\n') + '\n')
  • 写入本地文件
    eval/bench-timesuite/selfcheck.mjs:32
    fs.copyFileSync(TEMPLATE, path.join(dir, 'policy.yaml'))
  • 读取本地文件
    eval/fetch/check.mjs:15
    return fs.existsSync(p) ? JSON.parse(fs.readFileSync(p, 'utf8')) : null
  • 读取本地文件
    eval/fetch/check.mjs:28
    if (!fs.existsSync(p)) {
  • 读取本地文件
    eval/fetch/check.mjs:33
    if (fs.statSync(p).size !== f.bytes) {
  • 读取本地文件
    eval/fetch/check.mjs:48
    if (!fs.existsSync(p)) {
  • 读取本地文件
    eval/fetch/fetch_locomo.mjs:29
    const arr = JSON.parse(fs.readFileSync(file, 'utf8'))
  • 发起网络请求
    eval/fetch/fetch_locomo.mjs:43
    const res = await fetch(url)
  • 写入本地文件
    eval/fetch/fetch_locomo.mjs:46
    fs.mkdirSync(DATA_ROOT, { recursive: true })
  • 写入本地文件
    eval/fetch/fetch_locomo.mjs:47
    fs.writeFileSync(dest, buf)
  • 读取本地文件
    eval/fetch/fetch_locomo.mjs:52
    if (!fs.existsSync(MANIFEST)) {
  • 读取本地文件
    eval/fetch/fetch_locomo.mjs:56
    const m = JSON.parse(fs.readFileSync(MANIFEST, 'utf8'))
  • 读取本地文件
    eval/fetch/fetch_locomo.mjs:59
    if (!fs.existsSync(p)) {
  • 读取本地文件
    eval/fetch/fetch_locomo.mjs:64
    console.log(` ${m.file} ${fs.statSync(p).size} B sha256:${m.sha256.slice(0, 16)}…`)
  • 写入本地文件
    eval/fetch/fetch_locomo.mjs:71
    fs.mkdirSync(DATA_ROOT, { recursive: true })
  • 读取本地文件
    eval/fetch/fetch_locomo.mjs:73
    if (fs.existsSync(dest) && !process.argv.includes('--force')) {
  • 发起网络请求
    eval/fetch/fetch_locomo.mjs:81
    const res = await fetch(URL_LICENSE)
  • 写入本地文件
    eval/fetch/fetch_locomo.mjs:98
    fs.writeFileSync(MANIFEST, JSON.stringify(manifest, null, 2) + '\n')
  • 读取本地文件
    eval/fetch/fetch_longmemeval.mjs:35
    if (fs.existsSync(dest) && !process.argv.includes('--force')) {
  • 写入本地文件
    eval/fetch/fetch_longmemeval.mjs:38
    fs.mkdirSync(DATA_ROOT, { recursive: true })
  • 发起网络请求
    eval/fetch/fetch_longmemeval.mjs:40
    const res = await fetch(url)
  • 写入本地文件
    eval/fetch/fetch_longmemeval.mjs:42
    await pipeline(Readable.fromWeb(res.body), fs.createWriteStream(dest))
  • 读取本地文件
    eval/fetch/fetch_longmemeval.mjs:44
    const buf = fs.readFileSync(dest)
  • 读取本地文件
    eval/fetch/fetch_longmemeval.mjs:51
    if (fs.existsSync(MANIFEST)) manifest = JSON.parse(fs.readFileSync(MANIFEST, 'utf8'))
  • 写入本地文件
    eval/fetch/fetch_longmemeval.mjs:56
    fs.mkdirSync(DATA_ROOT, { recursive: true })
  • 写入本地文件
    eval/fetch/fetch_longmemeval.mjs:57
    fs.writeFileSync(MANIFEST, JSON.stringify(manifest, null, 2) + '\n')
  • 读取本地文件
    eval/fetch/fetch_longmemeval.mjs:61
    const arr = JSON.parse(fs.readFileSync(file, 'utf8'))
  • 读取本地文件
    eval/fetch/fetch_longmemeval.mjs:73
    if (!fs.existsSync(MANIFEST)) {
  • 读取本地文件
    eval/fetch/fetch_longmemeval.mjs:77
    const m = JSON.parse(fs.readFileSync(MANIFEST, 'utf8'))
  • 写入本地文件
    eval/gate-eval/gen.mjs:100
    fs.writeFileSync(out, items.map((i) => JSON.stringify(i)).join('\n') + '\n')
  • 读取密钥环境变量
    eval/gate-eval/report.mjs:61
    if (wantLlm && process.env.DEEPSEEK_API_KEY) {
  • 写入本地文件
    eval/gate-eval/report.mjs:87
    fs.mkdirSync(outDir, { recursive: true })
  • 写入本地文件
    eval/gate-eval/report.mjs:88
    fs.writeFileSync(path.join(outDir, 'report.json'), JSON.stringify(report, null, 2) + '\n')
  • 写入本地文件
    eval/gate-eval/report.mjs:89
    fs.writeFileSync(path.join(outDir, 'report.md'), markdown(report))
  • 执行外部命令固定命令
    eval/lib/bench-run.mjs:23
    return execSync('git rev-parse --short HEAD', { cwd: ROOT, stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim()
  • 读取本地文件
    eval/lib/bench-run.mjs:95
    if (!dataFile || !fs.existsSync(dataFile)) throw new Error(`数据文件不存在: ${dataFile}`)
  • 读取密钥环境变量
    eval/lib/bench-run.mjs:148
    process.env.EVAL_JUDGE_BASE_URL || process.env.EVAL_JUDGE_API_KEY
  • 读取密钥环境变量
    eval/lib/bench-run.mjs:151
    apiKey: process.env.EVAL_JUDGE_API_KEY,
  • 写入本地文件
    eval/lib/bench-run.mjs:242
    fs.appendFileSync(
  • 写入本地文件
    eval/lib/bench-run.mjs:341
    fs.appendFileSync(path.join(ROOT, 'results', 'RUNLOG.md'), runlog)
  • 读取本地文件
    eval/lib/judge.mjs:27
    const content = fs.readFileSync(file, 'utf8')
  • 读取本地文件
    eval/lib/judge.mjs:47
    const content = fs.readFileSync(srcFile, 'utf8')
  • 写入本地文件
    eval/lib/judge.mjs:49
    fs.mkdirSync(outDir, { recursive: true })
  • 写入本地文件
    eval/lib/judge.mjs:51
    fs.writeFileSync(dest, content)
  • 写入本地文件
    eval/lib/judge.mjs:108
    fs.writeFileSync(src, 'Judge prompt v1: output JSON {"label":"correct"|"incorrect"}.')
  • 写入本地文件
    eval/lib/judge.mjs:126
    fs.appendFileSync(tampered, '\nmodified')
  • 读取密钥环境变量
    eval/lib/llm.mjs:49
    this.apiKey = opts.apiKey ?? process.env.DEEPSEEK_API_KEY ?? null
  • 读取本地文件
    eval/lib/llm.mjs:70
    if (!this.noCache && fs.existsSync(file)) {
  • 读取本地文件
    eval/lib/llm.mjs:71
    const hit = JSON.parse(fs.readFileSync(file, 'utf8'))
  • 写入本地文件
    eval/lib/llm.mjs:119
    fs.mkdirSync(this.cacheDir, { recursive: true })
  • 写入本地文件
    eval/lib/llm.mjs:120
    fs.writeFileSync(file, JSON.stringify(out))
  • 读取本地文件
    eval/lib/llm.mjs:223
    assert(!fs.existsSync(path.join(dir, 'e')), '空响应不得写缓存')
  • 读取本地文件
    eval/lib/llm.mjs:243
    assert(!fs.existsSync(path.join(dir, 'f')), '无效 JSON 不得写缓存')
  • 写入本地文件
    eval/lib/trace.mjs:22
    fs.mkdirSync(path.dirname(path.resolve(file)), { recursive: true })
  • 写入本地文件
    eval/lib/trace.mjs:23
    fs.appendFileSync(file, JSON.stringify(trace) + '\n')
  • 写入本地文件
    eval/lib/trace.mjs:28
    fs.mkdirSync(path.dirname(path.resolve(file)), { recursive: true })
  • 写入本地文件
    eval/lib/trace.mjs:29
    fs.writeFileSync(file, traces.map((t) => JSON.stringify(t)).join('\n') + '\n')
  • 读取本地文件
    eval/lib/trace.mjs:33
    const text = fs.readFileSync(file, 'utf8')
  • 读取本地文件
    eval/lib/trace.mjs:104
    const schema = JSON.parse(fs.readFileSync(schemaPath, 'utf8'))
  • 执行外部命令固定命令
    eval/runner.mjs:114
    return execSync('git rev-parse --short HEAD', { cwd: HERE, stdio: ['ignore', 'pipe', 'ignore'] })
  • 写入本地文件
    eval/runner.mjs:155
    fs.copyFileSync(fileURLToPath(new URL('../templates/policy.yaml.example', import.meta.url)), path.join(dir, 'policy.yaml'))
  • 写入本地文件
    eval/runner.mjs:319
    fs.copyFileSync(fileURLToPath(new URL('../templates/policy.yaml.example', import.meta.url)), path.join(dir, 'policy.yaml'))
  • 写入本地文件
    eval/score.mjs:193
    fs.mkdirSync(path.dirname(out), { recursive: true })
  • 写入本地文件
    eval/score.mjs:194
    fs.writeFileSync(out, JSON.stringify({ generated_at: new Date().toISOString(), traces: traceFiles, summary, pairs }, null, 2) + '\n')
  • 写入本地文件
    eval/score.mjs:195
    fs.writeFileSync(md, markdown(summary, pairs))
  • 写入本地文件
    eval/score.mjs:196
    fs.writeFileSync(path.join(path.dirname(md), 'review_sample.md'), reviewSample(traces, 10))
  • 读取密钥环境变量
    eval/smoke.mjs:108
    REAL && (process.env.EVAL_JUDGE_BASE_URL || process.env.EVAL_JUDGE_API_KEY)
  • 读取密钥环境变量
    eval/smoke.mjs:111
    apiKey: process.env.EVAL_JUDGE_API_KEY,
  • 读取密钥环境变量
    eval/smoke.mjs:119
    if (REAL && !process.env.DEEPSEEK_API_KEY) {
  • 执行外部命令固定命令
    eval/smoke.mjs:167
    return execSync('git rev-parse --short HEAD', { cwd: HERE, stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim()
  • 写入本地文件
    eval/smoke.mjs:176
    fs.writeFileSync(path.join(dir, 'policy.yaml'), fs.readFileSync(tpl, 'utf8'))
  • 写入本地文件
    eval/smoke.mjs:286
    fs.mkdirSync(outDir, { recursive: true })
  • 执行外部命令来自配置/变量
    eval/smoke.mjs:294
    execFileSync(process.execPath, [path.join(HERE, 'score.mjs'), '--traces', traceFile, '--out', path.join(outDir, 'summary.json'), '--md', path.join(out
  • 写入本地文件
    eval/smoke.mjs:334
    fs.writeFileSync(path.join(dir, 'policy.yaml'), fs.readFileSync(tpl, 'utf8'))
  • 写入本地文件
    eval/smoke.mjs:352
    fs.writeFileSync(path.join(dir, 'policy.yaml'), fs.readFileSync(tpl, 'utf8'))
  • 读取本地文件
    eval/smoke.mjs:401
    } else if (REAL && fs.existsSync(runlogPath)) {
  • 写入本地文件
    eval/smoke.mjs:403
    fs.writeFileSync(runlogPath, fs.readFileSync(runlogPath, 'utf8').trimEnd() + '\n\n' + section)
  • 写入本地文件
    eval/smoke.mjs:405
    fs.writeFileSync(runlogPath, runlog)
  • 读取本地文件
    src/config.ts:51
    .some((name) => fs.existsSync(path.join(dir, name)))
  • 读取本地文件
    src/config.ts:67
    const hasDb = (dir: string) => fs.existsSync(path.join(dir, 'foresight.db'))
  • 写入本地文件
    src/config.ts:129
    fs.mkdirSync(config.memoryRoot, { recursive: true })
  • 读取本地文件
    src/config.ts:133
    if (fs.existsSync(target)) continue
  • 读取本地文件
    src/config.ts:140
    if (!fs.existsSync(template)) continue
  • 写入本地文件
    src/config.ts:141
    fs.copyFileSync(template, target)
  • 读取本地文件
    src/derive/deriver.ts:328
    const existing = (fs.existsSync(deps.userDocPath) ? fs.readFileSync(deps.userDocPath, 'utf8') : '').replace(/ /g, '\n')
  • 写入本地文件
    src/derive/deriver.ts:354
    fs.writeFileSync(deps.userDocPath, next, 'utf8')
  • 读取本地文件
    src/inject/render.ts:75
    const st = fs.statSync(p)
  • 读取本地文件
    src/inject/render.ts:78
    const content = fs.readFileSync(p, 'utf8')
  • 读取密钥环境变量
    src/llm/provider.ts:33
    this.apiKey = process.env.FORESIGHT_LLM_API_KEY ?? ''
  • 发起网络请求
    src/llm/provider.ts:60
    const resp = await fetch(`${this.backend.baseUrl}/chat/completions`, {
  • 读取本地文件
    src/policy.ts:25
    const raw = yaml.load(fs.readFileSync(TEMPLATE_URL, 'utf8')) as { foresight?: Policy } | undefined
  • 读取本地文件
    src/policy.ts:76
    text = fs.readFileSync(policyPath, 'utf8')
  • 写入本地文件
    src/schema.ts:35
    fs.mkdirSync(path.dirname(dbPath), { recursive: true })
  • 发起网络请求
    src/store/embed.ts:109
    const resp = await fetch(`${this.cfg.baseUrl}/api/embeddings`, {
  • 发起网络请求
    src/store/embed.ts:121
    const resp = await fetch(`${this.cfg.baseUrl}/api/embed`, {
  • 写入本地文件
    src/store.ts:499
    fs.appendFileSync(
扫描于 2026/11/2（1 天前） · 范围 全包扫描（包内未声明入口） · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-llm@deepseek-ai/dsh-session@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools@deepseek-ai/schemastery
给这个插件打分还没有人投票↓
用户评分
还没有人投票，来当第一个
广告精选好物
飞利浦 TAH6519 主动降噪耳机 ¥299
头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。
  • ·anc 主动降噪 · 头戴式无线
  • ·价格与库存以商品页实时为准
去淘宝看看→

功能亮点

  • 时序切面长期记忆

ForeSight：给 DeepSeek Harness（dsh）用的时序切面长期记忆插件

README

由 DeepSeek 最新模型翻译生成
ForeSight 面向 DeepSeek Harness（dsh）的时相化长期记忆插件。 每条记忆都携带显式的时间语义——语言学的体（aspect：进行体 / 完成体 / 未然体 / 恒常体 / 不确定兜底）与锚（anchor：时点 / 区间 / 开放 / 无关）配对。框架机械地执行生命周期：锚到期衰减、TTL 兜底、续期提醒（nudge）、先行体审查、预测到期自动判定，以及基于证据的冲突消解，全部由单一保守/激进系数 β 控制。 0.2.2 更新 - dsh 会话兼容：nudge 提醒改为带 id、使用 producer-owned source kind 的消息，当前 dsh 的会话编码器可以正常持久化，重启后会话也能正常恢复。原地升级即可，无需迁移数据。 - 派生触发修正：session/flush 只作为持久化 checkpoint，不再当作会话结束；会话结束派生改挂 session/disposed，并同时识别 session / session_end 两种触发值。 - 重载安全：nudge 与 inject 的监听器会在插件重载/HMR 时释放；注入的记忆文本不再参与 dsh 的 prompt 变量插值。
展开完整文档（README 剩余 1 节）
ForeSight

面向 DeepSeek Harness（dsh）的时相化长期记忆插件。

每条记忆都携带显式的时间语义——语言学的体（aspect：进行体 / 完成体 / 未然体 / 恒常体 / 不确定兜底）与锚（anchor：时点 / 区间 / 开放 / 无关）配对。框架机械地执行生命周期：锚到期衰减、TTL 兜底、续期提醒（nudge）、先行体审查、预测到期自动判定，以及基于证据的冲突消解，全部由单一保守/激进系数 β 控制。

0.2.2 更新

- dsh 会话兼容：nudge 提醒改为带 id、使用 producer-owned source kind 的消息，当前 dsh 的会话编码器可以正常持久化，重启后会话也能正常恢复。原地升级即可，无需迁移数据。
- 派生触发修正：session/flush 只作为持久化 checkpoint，不再当作会话结束；会话结束派生改挂 session/disposed，并同时识别 session / session_end 两种触发值。
- 重载安全：nudge 与 inject 的监听器会在插件重载/HMR 时释放；注入的记忆文本不再参与 dsh 的 prompt 变量插值。

0.2.1 更新

- dsh 工具 schema 兼容：memory 工具改为注册 object-rooted 原始 JSON Schema，修复新版 dsh 下 memory_delete 报 schema must be a JSON Schema of type: "object" 的问题。原地升级 tarball 即可，无需迁移数据。

0.2.0 更新

- 可安装的 Release tarball：包内包含 lib/、templates/、policy 迁移脚本、CHANGELOG.md 与 dsh bundle patch；scripts/check-pack.mjs 在 CI 中断言包内容。
- 首次启动即可用：缺失的 policy.yaml 会从包内模板播种；新目录或空目录还会播种 SOUL.md/IMPORTANT.md。已存在文件绝不覆盖。
- 数据目录解析修正：显式配置 → FORESIGHT_MEMORY_DIR → 平台默认。Windows 默认改为 %LOCALAPPDATA%/foresight；检测到旧 %APPDATA%/foresight 时继续沿用。
- v3 → v4 兼容：v3 policy 可在内存中映射到 v4；scripts/migrate-policy.mjs 可带备份重写文件。旧 user.md 会合并进 IMPORTANT.md，不再被整体遮蔽。
- 运行时容错：sqlite-vec 加载失败时降级为 FTS + 已存向量精确余弦；Ollama 故障触发 embedding 熔断；Node < 22.13 在导入 node:sqlite 前给出可操作错误。
- 管理与隔离：更新/软删/恢复/续期工具与 HTTP 端点、per-peer scope、per-peer token、精确去重、memory FTS 与 embedding 回填。

问题由来

长期记忆是数据管理问题，而不是提示词工程问题。不加管理的 Agent 记忆通常踩到两个常见的坑：

陈旧注入。 一个月前已结束的项目仍与新鲜信息竞争注入配额，仿佛它仍是当前上下文。

有效时间丢失。 “我昨天做过这件事”被说成“刚才”——没有任何记录标明一条记忆何时为真，更不用说何时不再为真。

为什么存在

与聊天厂商的滚动窗口式记忆不同，ForeSight 把记忆当作调度的第一等数据：已实现的调参项——过期/TTL、续期节奏、激活 β、检索因子权重、注入预算——均从一份结构化策略文件（policy.yaml）读取；尚未接线的字段在 eval/DECISIONS.md §13 显式登记为 reserved（不做静默装饰）。

ForeSight 从语言学借用两个轴来应对：

| 轴 | 取值 | 控制什么 |
| 体 (aspect) | 进行体 / 完成体 / 未然体 / 恒常体 / 不确定兜底 | 生命周期：归位完成、永久、待验证、按检索注入、可再分类 |
| 锚 (anchor) | 无锚 / 时点 / 区间 / 开放 | 语句何时为真（有效时间） |

通俗地说，体回答“这件事处于什么阶段”——进行体：“我正在写报告”（仍在进行，终将结束 → 自动归位为“已完成”并保持可检索，而非隐藏）；完成体：“报告已经提交”（已定论，永久保留）；未然体：“下周要交报告”（尚待发生，到时验证）；恒常体：“我每天喝咖啡”（不随时间变化——与其他体一样写入记忆库、按语义检索注入；只有全局重要的事实才写入始终注入的 IMPORTANT.md）；不确定兜底：无法判定的内容进入兜底桶而不是被丢弃。锚回答“这句话何时为真”——时点（“8月20日”）、区间（“大三期间”）、开放（“自3月以来”）或无锚（与时间无关）。

几个值得注意的设计取舍：

- 体的分类借鉴了成熟的语言学概念，但它是一个刻意保持最小的起点，而非完备理论——schema 可配置（policy.yaml），并预期随使用演化。
- 核心与 Agent 无关：dsh 只是其中一个适配层（src/ 下的 cordis 插件）。embedding 与 LLM 均为可插拔接口——默认本地 Ollama，且规则兜底保证没有模型也能运转整个生命周期。
- 生命周期由机制执行，而非模型判断：过期、注入资格与冲突消解均由策略驱动，可选的 LLM 仅用于分类与推导。这仍是早期探索性实现——分类、策略模型与执行机制都仍在演进。
- 检索是混合式的：SQLite FTS（CJK trigram + Latin）加向量检索，并带精确内容去重；sqlite-vec 不可用时回退到已存向量的精确余弦。

环境要求与兼容性

| 组件 | 要求 |
| Node 运行时 | Node.js ≥ 22.13（node:sqlite 从该版本起不再需要 flag） |
| dsh | DeepSeek Harness 0.2.0-rc.2+，带 cordis 插件系统；桌面端 Electron 运行时需内置 Node ≥ 22.13 |
| Embedding | 默认 Ollama + nomic-embed-text-v2-moe（768 维），或兼容端点；可选——规则兜底可在无模型时运行 |
| LLM | 可选 DeepSeek 兼容 API，用于分类/推导/辩证推理 |
| 向量扩展 | sqlite-vec 预编译包：Windows x64、Linux x64/arm64、macOS x64/arm64；其他平台自动降级为 FTS + 已存向量余弦，不会因扩展加载失败而整体不可用 |

安装（dsh profile）

npm 发布尚未完成；当前支持的安装方式是 GitHub Release tarball。包内自带 bundle patch，会自动插入六个条目（core / tools / inject / nudge / observer / server）。

1. 下载 release tarball

从 Releases 下载：

curl -LO https://github.com/dawn-471/foresight/releases/download/v0.2.2/foresight-memory-0.2.2.tgz

Windows PowerShell：

Invoke-WebRequest
-Uri https://github.com/dawn-471/foresight/releases/download/v0.2.2/foresight-memory-0.2.2.tgz
-OutFile foresight-memory-0.2.2.tgz

2. 安装到 dsh profile

dsh plugin --profile <name> add "file:/绝对路径/foresight-memory-0.2.2.tgz"

不要手工重复添加六个条目：package.json 自带 dsh.bundle.patch。需要自定义数据目录时，只在 profile 级 cordis.patch.yml 覆盖 core：

cordis.patch.yml（profile 级）
- id: foresight-core
config:
memoryRoot: '<绝对数据目录>' # 可选；默认走平台目录

profile patch 会整份替换 foresight-core 的 config（不是深合并），非默认的 dbFile / embedBaseUrl / embedModel 需要一并重复。

3. 从源码构建（可选）

pnpm install # prepare 会编译 lib/
pnpm build
npm pack # tarball 包含 lib/、templates/、迁移脚本与 patch

bundle/config 变更可热加载，但 lib/.js 的代码变更需要重启 dsh 或新会话——不要用正在运行的会话来验证重新构建的插件。

首次启动与数据位置

你的数据存放在仓库之外，自己的数据目录里。插件绝不携带任何用户数据；仓库是纯代码 + 模板。

<memoryRoot>/
├── SOUL.md # 人格设定（首次运行从 templates/SOUL.md.example 播种） ├── IMPORTANT.md # 全局重要事实，始终注入（首次运行播种） ├── policy.yaml # 全部可调参数（首次运行播种；改这里） └── foresight.db # SQLite 存储（自动创建）

首次运行时插件会创建目录，并从包内 templates/ 播种缺失的起始文件——policy.yaml 总是会补（启动必需），SOUL.md/IMPORTANT.md 在新目录或空目录时补。插件会打印创建了哪些文件；已存在的文件绝不覆盖。

解析链

显式选项（adapter）→ 环境变量 → 平台默认值

（policy.yaml 本身位于 memoryRoot 内，因此不能反过来提供 memoryRoot。）

| 设置 | 环境变量 | 默认值 |
| 数据目录 | FORESIGHT_MEMORY_DIR | %LOCALAPPDATA%/foresight（Windows；旧版 %APPDATA% fallback）/ ~/.local/share/foresight（Unix） |
| db 文件 | FORESIGHT_DB_FILE | foresight.db |
| embedding URL | FORESIGHT_EMBED_URL | http://localhost:11434 |
| embedding 模型 | FORESIGHT_EMBED_MODEL | nomic-embed-text-v2-moe |
| embedding 维度 | FORESIGHT_EMBED_DIM | 768 |
| embedding 熔断失败次数 | FORESIGHT_EMBED_FAILURES | 3 |
| embedding 熔断冷却（ms） | FORESIGHT_EMBED_COOLDOWN_MS | 30000 |
| LLM base URL | FORESIGHT_LLM_BASE_URL | https://api.deepseek.com/v1 |
| LLM 模型 | FORESIGHT_LLM_MODEL | deepseek-flash |

Windows 上 SQLite + WAL 不适合放在漫游配置目录。新安装使用 %LOCALAPPDATA%；检测到旧 %APPDATA%/foresight 时会继续沿用而不是静默迁移。需要移动时请先备份并显式设置 memoryRoot。

运行时行为

- 摄入：turn/end 时观察器写入对话记录，并把每条 user/assistant 消息送进同一个写入门：重要度、分类、向量、精确去重、冲突消解。门控失败只记日志，不阻塞会话；derive 每 derive.every_n_turns 轮触发（会话 flush 时也会补跑）。
- 检索：memory FTS + 语义向量的混合检索、生命周期资格、结构化时间过滤；系统提示的 memories 段与检索工具共用同一条排序路径。embedding 调用带熔断：Ollama 连续失败后快速失败，不再让每轮都等 30s 超时；写入继续无向量降级，后续由回填补齐。
- 作用域：dsh / 工具 / 注入 / nudge 使用 global；HTTP server 按 x-foresight-peer 隔离读写，并与 dsh 的 global 池相互隔离。配置 server.peer_tokens 可启用每 peer 独立 token；否则共享 token 是单一信任边界，请只监听 loopback。
- Derive：把会话增量归纳为结构化事实，使用持久化 per-session 游标、精确去重、embedding、生命周期计划与冲突消解。scripts/migrate-policy.mjs 处理 v3→v4 policy 与 user.md 合并。
- Nudge：续期、未然体/预测判定、uncertain 兜底、被抑制冲突、两条都 active 的矛盾都会进入复审；复审动作可通过 memory_update / memory_delete / memory_restore / memory_renew 执行。

工具

| 工具 | 作用 |
| memory_write | 经完整门控、去重、embedding 与冲突路径写入一条事实 |
| memory_update | 修正正文（重新计算向量，保留修订审计） |
| memory_delete | 软删除（可恢复）；硬删除仅通过 Root HTTP API |
| memory_restore | 恢复软删或被抑制的记忆 |
| memory_renew | 延长进行体/未然体窗口 |
| memory_query | 语义 + 词法检索 |
| memory_reason | 基于证据的辩证回答，并标出冲突 |

HTTP API

仅在 policy.server.enabled: true 时启用。

| 端点 | 作用 |
| GET /v1/health | 健康检查（无需认证） |
| POST /v1/memories | 经完整门控写入 |
| POST /v1/memories/search | 混合检索 |
| GET /v1/memories/:id | 读取单条记忆（检查 scope） |
| PATCH /v1/memories/:id | 更新正文 / 体 / 锚 / 激活值 |
| DELETE /v1/memories/:id | 软删；?purge=1 仅 Root 硬删 |
| POST /v1/memories/:id/restore | 恢复 |
| POST /v1/memories/:id/renew | 续期 |
| POST /v1/reason | 辩证推理 |

认证使用 X-ForeSight-Token；peer 身份使用 X-ForeSight-Peer。

策略文件

policy.yaml 是「已实现调参项」的唯一事实来源：权限矩阵、体生命周期（TTL/续期/锚渲染）、gate 分类与重要度过滤、激活 β 与衰减常数、检索因子权重（已冻结：0.40/0.20/0.25/0.15）、注入预算、nudge 频率、服务器端口/token、derive 路由。没有执行者的字段在 eval/DECISIONS.md §13 显式登记为 reserved。你的助手的人格、画像与记忆策略由你决定——没有任何一项被硬编码进代码。

从 0.1.x 升级（policy v3）

v0.2.0 使用 policy_version: 4。v3 policy 仍可启动：loader 会在内存中映射到 v4、打印警告，并用包内模板补齐 v4 新增键（uncertain、transitions、gate.fallback_write）。要显式重写文件（带备份）并把旧 user.md 合并进 IMPORTANT.md：

在仓库里
node scripts/migrate-policy.mjs <memoryRoot> # 预演：只生成 policy.yaml.v4-<ts>
node scripts/migrate-policy.mjs <memoryRoot> --write # 备份 + 替换 + 合并 user.md

在 dsh profile 的已安装包内
node node_modules/@foresight/memory/scripts/migrate-policy.mjs <memoryRoot> --write

运行期也会合并 IMPORTANT.md 与 user.md，因此创建新文件不会让旧画像从注入中消失。v4 把恒常体从旧的 doc/always 语义改为 memory/conditional——请审阅生成的 policy，不要假设默认值符合你的原意。

数据目录变化： 包内 bundle patch 不再写 memoryRoot: './memory'。如果你的旧安装依赖这个 cwd 相对目录，请先在 profile patch 中把 memoryRoot 设为该绝对路径再升级；否则插件会改用平台默认目录。Windows 上若检测到旧的 %APPDATA%/foresight，会继续沿用而不是静默迁移（Roaming 同步可能损坏 SQLite WAL）；需要移动时请先备份并显式设置 memoryRoot。

卸载

1. dsh plugin --profile <name> remove @foresight/memory（或在 profile 里 pnpm remove），同时更新 package.json 与 lockfile。
2. 从 profile 的 dsh.profile.bundles 列表删除该包，并删除 profile 级 cordis.patch.yml 中的 foresight-core 条目。
3. 删除你配置过的 FORESIGHT_ 环境变量与数据目录（%LOCALAPPDATA%/foresight、旧版 %APPDATA%/foresight、$XDG_DATA_HOME/foresight 或自定义绝对 memoryRoot）。目录内含 foresight.db、-wal/-shm，以及启用时的审计日志。
4. 若曾用 dsh plugin allow-version，从 profile 的 compatibility.json 删除对应条目。

保留数据目录是安全的；删除即硬清除。

目录结构

src/
├── types.ts # 领域类型（体×锚） ├── defaults.ts # 默认值唯一的存放处 ├── config.ts # 解析链 + 首次运行播种 ├── policy.ts # policy.yaml 加载器、v3→v4 映射 ├── schema.ts # SQLite DDL + 迁移 + sqlite-vec 降级 ├── store.ts # CRUD、软删除、向量、FTS、审计 ├── runtime-guard.ts # Node ≥ 22.13 守卫 ├── gate/ # 写入门：重要度、分类、校验、去重 ├── govern/ # 权限模型 ├── evolve/ # 时间性过期/TTL、激活、β 冲突消解 ├── retrieve/ # 混合检索 + 可组合评分因子 ├── derive/ # 会话 → 结构化记忆 ├── nudge/ # 时间性/冲突复审问询 ├── server/ # 多 peer HTTP API ├── tools.ts # dsh 工具定义 └── store/embed.ts # embed provider + 熔断器

templates/ # 随 tarball 发布的 policy / SOUL / IMPORTANT 初始文件 scripts/migrate-policy.mjs # 显式 v3→v4 数据迁移（预演或 --write） scripts/check-pack.mjs # CI 使用的 tarball 内容守卫 tests/ # node --test 测试套件（172 项）

开发与验证

pnpm install
pnpm build
pnpm test # 无需 Ollama / API key / 数据目录
node scripts/check-pack.mjs
node eval/smoke.mjs # 离线机制 smoke

测试使用临时存储与假 embedder；release tarball 由 scripts/check-pack.mjs 与 CI 矩阵验证。

文档

- CHANGELOG
- 安装/升级审计
- 策略决策与 reserved 字段

许可证

MIT
广告精选好物
Type-c 采集卡 ¥50
佳能尼康索尼相机直连电脑，视频开发与直播向。
  • ·相机转电脑采集
  • ·价格与库存以商品页实时为准
去淘宝看看→
预览分享卡片长什么样 ↓dawn-471/foresight
分享 · DeepSeek Harness Hub
dawn-471/foresight

面向 DeepSeek Harnessdsh的时相化长期记忆插件。

相关插件 · 对话 / 记忆

上下文中枢oceanbase/powercontext
上下文跟着工作走 —— 跨会话、跨智能体、跨人。
★ 1,487已汉化DSH
73
智能体记忆库plastic-labs/honcho
Honcho 是记忆基础设施，用来构建有状态的智能体。这些智能体能理解不断变化的人、智能体、群组、项目和想法。
★ 7,894已汉化DSH
71.7
长程智能体控制面loopx-project/loopx
给 Agent 一个目标，让工作持续向前。
★ 6,358已汉化DSH
71.3
智能体上下文数据库volcengine/OpenViking
给 AI 智能体用的上下文数据库
★ 41,379已汉化DSH
71.3
长效机器人团队Fei2411/DS-Bot
DS Bot 是一个基于 DeepSeek Harness简称 dsh的 bot 插件，插件将 dsh 改造为 bot…
★ 5,084已汉化DSH
71.1
可携带记忆层EverMind-AI/EverOS
为什么选择 EverOS
★ 13,778已汉化DSH
71.1

这是你的仓库？认领条目

回到顶部