---

它解决什么问题

你在会话开头写下一段"人设 / 规则"——用中文回答、先给结论、危险操作要先问、代码只给最小可运行版本。前几轮它很好用。然后：

• 第 40 轮：那段话已经沉在上下文最深处，模型开始忘；
• 一次 /compact 之后：它被摘要吞掉，彻底消失——而摘要不会替你复述"你要求先给结论"；
• 长工具链里：几十条工具结果把它越推越远，风格和纪律一起漂走。

dsh-anchor 就是给这段指令打一口锚：开场注入一次，之后每当会话被压缩、跨过你设定的轮数、或上下文占用升过你设定的 token 数，就把同一段原文重新锚回去。

名字取自航海：锚不是缆绳，不能拖着船走；它只做一件事——让船别漂。这条插件也只做一件事。

特性

特性	说明
🧩 多预设自由组合	预设库随便建（最多 100 条），勾选任意几条，按你排的顺序拼成一段指令注入。
⚓ 压缩后自动重锚	检测到 compaction/summary（自动压力压缩或 /compact）后，在下一个 step 边界（可能是回合中途）立刻重锚，下一次模型请求就带着它。
🔁 按轮数自动重锚	距上次注入满 N 轮（默认 20，可调，0 关闭）后，在下一轮开始时重锚一次。
📈 按 token 压力自动重锚	读官方 token 计量：上下文占用（就是输入框旁边显示的那个数）升到你设定的 token 数（reinjectTokenThreshold，默认 0 关闭）后，在下一轮开始时重锚一次。同一次跨越只触发一次——占用一直很高也不会一轮一轮地重锚；被压缩打回阈值以下则重新计数，下次再升过阈值时再触发一次。
🎯 重锚来源可选	三档：「定锚原文」= 永远重复会话开头那段；「最近一条」= 重复本插件最近一次注入（例如你随后用 /anchor 定的那条）；「按最新组合刷新」= 重锚时用设置页里当前的组合——改了预设或勾选，正在进行的会话下次重锚就换成新文本。
🧠 触发判定可回放	压缩与轮数重锚只读会话日志，是纯函数；重启、续聊、日志回放都得到同样的结论，同一次触发天然不会重复。token 压力触发读的是官方 token 计量（它本身也是对会话日志的回放），并按会话记一个进程内的「已触发位」——见下方「触发时机」。
🚦 上限护卫	单条上限（编辑限长）与合并上限（注入门禁）都在设置页可改，默认 8000 字；超上限拒绝注入并写日志，绝不静默截断你的字。
🐋 子代理默认不锚	被委派出去的子代理会话默认不定锚、也不重锚——人设与纪律是给「你自己在开的会话」的，子代理复述一遍只是白花 token；想在子代理里也生效就在设置页打开。
⚓ /anchor 命令	输入 /anchor 立即把当前组合定锚进本会话：命令在本地执行，不花 token、不开新回合、不延长正在跑的回合（锚握在插件手里，下一条消息的第一个 step 注入——不进输入框、不会自己开回合）。/anchor status 只看状态不注入。
🎛 自带设置页	预设库（分页、多选、固定「不注入」行）、注入顺序（拖拽 / ↑↓ 排序、合并预览）、重锚策略 —— 全是可视化操作，不用改配置文件。
💾 预设可导入 / 导出	整库预设（含当前组合）导出成一份自带格式标记与版本号的 JSON，换机器、备份、分享都行；导入先完整校验再落地，任何一处不合法都以一条明确理由整体拒绝，不会半途写坏你的库。
🔒 绝不外传	纯本地插件：不联网、不埋点、不写任何远端；设置只落在你自己的 ~/.dsh/settings.yaml。

安装

# 需要 DeepSeek Harness（Web profile）
dsh plugin --profile web add @yeastcloud/dsh-anchor

# 重启 profile 后生效（Host 半只在启动时加载）
dsh web

装好后打开 设置 → 定锚：

1. 「＋ 新增预设」写几段你要长期生效的指令（人设、纪律、项目规范各一条都行）；
2. 勾选它们，在下方注入顺序里拖成你想要的拼接顺序；
3. 新建一个会话——第一条指令就是这样进来的。

环境要求：Node ^22.19 || >=24；DeepSeek Harness 0.1.5 线（0.1.5-rc.2 起验证）。插件含 Host 半（注入逻辑）与 Client 半（设置页）。

界面语言：设置页与左侧导航跟随 DSH 的语言设置（中文 / English）；/anchor 的输出跟随宿主进程的 LC_ALL / LANG（语言标签首段是 en 时走英文，例如 en、en_US.UTF-8；其余一律走中文）。

命令

在任意会话里输入 /anchor：

命令	做什么
/anchor	把当前组合定锚进本会话：注入一条插件来源的消息，在下一条消息的第一个 step 生效（不进输入框、不会自己开回合，也不会延长正在跑的回合），此后该会话的压缩/轮数重锚都复用它。命令处理器在接收它的 agent 上本地执行，所以不花 token、不产生模型回复。
/anchor status	只读报告：总开关、组合与字数、重锚来源 / 轮数间隔 / token 阈值 / 压缩后开关、本会话的注入历史（首条 / 最近一条各自的 seq 与字数，以及排队中还没落地的那条）与距上次注入过了几轮。不注入任何内容。

被拒绝的情形都会明确报错，而不是"差不多地注入"：总开关关闭、组合为空（「不注入」）、合并字数超上限。

为什么把它做成命令：命令契约明确写着 handler 在 agent 上本地执行、不把命令发给模型——所以它能做到"零副作用地改上下文"，这正是"给会话打锚"该有的样子。也正因为如此，早先那个挂在输入框旁的「发组合」按钮连同它的"内容摘要认领"机制一起删掉了：命令把同样的文本送进会话，却不用花 token、不用开回合，也不用靠比对内容来认出自己。

工作原理

graph TD
  A[新建会话 · turn 1] -->|定锚：注入组合文本| B{会话进行}
  B -->|每个 step 边界判定触发条件| C{触发条件?}
  C -->|日志出现 compaction/summary| D[重锚：下一个 step 边界立即注入]
  C -->|距上次注入满 N 轮| E[重锚：下一轮 step 1 注入]
  C -->|上下文占用升过 token 阈值| G[重锚：下一轮 step 1 注入一次]
  C -->|都没有| B
  D --> B
  E --> B
  G --> B
  B -->|你输 /anchor| F[锚握在插件手里 · 下一条消息的第一个 step 注入]
  F --> B

注入形态：一条 source.kind = "plugin" 的用户消息（模型可见、进日志、与真人发言可区分）；当 loop 没有可挂靠的输入时不会凭空开一轮。

触发时机

触发	时机	注入的文本
定锚（会话首轮）	本会话自己的第一轮第一个有效 step	设置页当前组合
压缩后重锚	compaction/summary 之后的第一个 step 边界（可落在回合中途）	按「重锚来源」取定锚原文或最近一条
按轮数重锚	距上次注入满 N 轮后的下一轮 step 1	同上
按 token 压力重锚	官方 token 计量的上下文占用升过阈值后的下一轮 step 1；同一次跨越只触发一次	同上

为什么压缩与轮数重锚是"无状态"的：这两个判定只看会话日志（session.snapshotEvents()），不看内存计数器。每次注入都会把自己的 seq 推进参考点，所以同一次触发只生效一次；进程重启、会话续聊、日志回放都不会重复注入或漏注入。

token 压力触发是唯一的例外：它读的是官方 token 计量（dsh-token-meter 通过 ctx.sessionProjections 发布的 contextPressure，也就是输入框旁边那个数——同样由日志回放算出），并按会话记一个「已触发位」：读数低于阈值就重新武装，升过阈值触发一次后解除武装，所以占用一直很高也不会一轮一轮地重锚；被压缩打回阈值以下则重新武装，下一次升过阈值再触发。进程重启会把这一位重置为「已武装」：若此时上下文仍高于阈值，下一轮的第一个 step 会再重锚一次，之后规则照旧。

首轮之外的老会话不会被"补"上定锚：一个从来没被定锚过的会话（插件装上之前开的、或当时选着「不注入」），不会在某轮对话中间突然收到一句开场白——没有基线就一直没基线。

配置

在 设置 → 定锚 里改；也可以直接编辑 ~/.dsh/settings.yaml 的 dsh-anchor 段。

字段	默认	说明
enabled	true	总开关：关闭后定锚与重锚全部停止，配置保留
selectedIds	['default']	有序组合；空数组 = 「不注入」（该状态是派生的，不单独存字段）
prompts	1 条	预设库，最多 100 条，名称 ≤ 200 字
reinjectAfterCompaction	true	压缩后自动重锚
reinjectTurnInterval	20	按轮数重锚的间隔（0–10000，0 关闭）
reinjectTokenThreshold	0	按 token 压力重锚的阈值（0–10000000，0 关闭）：读官方 token 计量，这个数就是输入框旁边显示的上下文占用；占用从阈值以下升到阈值以上时，在下一轮 step 1 重锚一次，之后占用一直高于阈值也不会反复重锚
maxPromptChars	8000	单条上限（100–100000 字）：编辑器可输入长度，不会自动截断已存在的长预设
maxCombinedChars	8000	合并上限（100–100000 字）：拼接后超限则定锚与重锚都不注入，并写入 warn
reinjectSource	'first'	重锚取哪一条：first 定锚原文 / latest 最近一条本插件注入 / refresh 按最新组合刷新
anchorSubagents	false	子代理（委派出去的子会话）是否也定锚：默认关闭，只锚你自己开的会话

常见问题

为什么不每轮都注入？ 每轮重复同一段指令会持续占用上下文，也会让模型对这段话脱敏。锚的触发点选在真正会丢信息的时刻：压缩之后、以及跨过你设定的轮数。想更紧就把 reinjectTurnInterval 调小（如 10），想更松就调大或填 0。

不想按轮数估算、想让上下文自己说了算？ 把 reinjectTokenThreshold 设成一个 token 数（例如 120000）：占用（输入框旁边那个数，来自官方 token 计量）升过它的那一次，会在下一轮开始时重锚一次——同一次跨越只触发一次，占用一直在阈值以上不会反复重锚；被压缩打回阈值以下则重新计数。默认 0 = 关闭，此时插件的行为与没有这个功能时完全一致（连计量都不读）。

压缩后重锚和"压缩摘要"冲突吗？ 不冲突。摘要是压缩器写的，重锚是你写的那段原文——两者是不同的东西：摘要负责"发生了什么"，锚负责"你要怎么做事"。

「最近一条」模式下用 /anchor 定锚会发生什么？ 那条锚成为本会话最新的注入，此后压缩/轮数重锚都重复它——相当于在这个会话里换了一次人设；切回「定锚原文」则重新以会话开头那段为准。

什么算本插件的注入？ 只有本插件自己来源的消息：会话开场的自动定锚、压缩/轮数重锚、以及你用 /anchor 定的锚。你亲手敲的、粘贴的任何文本都不算——不需要任何内容比对。

它会往远端发东西吗？ 不会。插件不联网、不埋点；唯一写盘的是 ~/.dsh/settings.yaml 里它自己的命名空间。

它负责什么范围？ 只负责指令：本次会话里要一直生效的人设与纪律。不接管记忆、不做检索、不碰任何跨会话的数据，也不改变模型的任何能力。

开发

pnpm install        # 依赖（prepare 会自动构建一次）
pnpm typecheck      # tsc --noEmit（含 tests）
pnpm test           # vitest：9 个 spec / 112 项
pnpm build          # tsdown：lib/index.js（Host 半）与 lib/client.js（Client 半）
pnpm check          # 三件套：typecheck + test + build

目录

src/
  index.ts                     Host 半：设置命名空间 + agent/pre-step 注入决策
  trigger.ts                   纯函数：从会话日志读注入历史、判定重锚触发（含 token 压力的已触发位）
  meter.ts                     读官方 token meter 的 contextPressure（ctx.sessionProjections）
  order.ts                     纯函数：列表移动与拖拽落点换算
  copy.ts                      两端共享的中英文案表 + {name} 插值
  types/anchor-settings.ts     两端共享的设置契约（含容错解码与迁移）
  client/
    index.ts                   注册 settings.section 与 settings.anchor 文案
    AnchorSettingsSection.tsx  设置页：预设库 / 分页器 / 注入顺序 / 重锚策略
    settings-controller.ts     按字段写、乐观更新的控制器
tests/                         112 项单测（含真实 pre-step 监听器行为）

改动的生效范围：Client 半刷新页面即生效（bundle 走 HTTP）；Host 半需要重启 profile（lib/index.js 只在启动时加载）。

发布（维护者）

gh workflow run release.yml -f bump=minor                  # 递增版本并发布
gh workflow run release.yml -f bump=none                   # 不改版本，重发仓库当前版本
gh workflow run release.yml -f bump=patch -f dry_run=true   # 只验证链路，不提交不发版

工作流做完全套：递增版本 → pnpm check（typecheck + 112 项测试 + 构建）→ 提交并打注记 tag → 发布 npm → 建 GitHub Release。发布走 npm 可信发布（Trusted Publishing / OIDC）：仓库里不存任何 npm token，产物自带 provenance 签名（可在 sigstore 查到）。

mode 必须与 npmjs 上该包 Trusted Publisher 的权限一致：

mode	npm 侧需要授予的权限	行为
stage（默认）	npm stage publish	版本在 npm 暂存，维护者用 2FA 确认后才对外可见：npm stage list <pkg> 查 stage id → npm stage approve <stage-id>（或在包页面点批准）
direct	npm publish	工作流跑完即上架，无需再确认

首次发布（npm 侧要求包已存在才能配可信发布者）：

1. npm login 后在本仓库执行 pnpm check && npm publish --access public；
2. 打开 npmjs.com 上该包的 Settings → Trusted Publisher，填 GitHub 仓库 yeastcloud/dsh-anchor 与工作流 release.yml；
3. 此后一律用上面的 gh workflow run，版本号与 tag 由工作流维护。

路线图

已完成的项保留在表里（✅ + 删除线），并记下实装版本与日期。

	计划项	实装版本	实装日期
✅	设置页 i18n：界面与命令输出跟随 DSH 语言（中 / 英）	v0.7.0	2026-09-15
✅	重锚来源增加「按最新组合刷新」策略	v0.9.0	2026-09-15
✅	预设导入 / 导出（跨设备同步自己的指令库）	v0.10.0	2026-09-15
✅	支持按上下文 token 压力触发，作为轮数之外的第二把尺（需先确认官方是否提供 token 计量接缝，没有就撤掉这项）	v0.11.0	2026-09-15

计划项已全部实装，暂无待办。

贡献

欢迎 Issue 与 PR。请先跑通 pnpm check；改动行为时同步补测试与 CHANGELOG.md。版本号由发版工作流递增（release.yml 跑 npm version），PR 里请勿手改 package.json 的 version；但必须为新版本写好 CHANGELOG.md 段落——工作流在找不到该版本段落时会直接拒绝发版，避免发出与上版同内容的空版本。

许可证

CC BY-NC-SA 4.0 © 2026 一笥云工作室 (YiSiYun Studio)

允许：非商业使用、修改、再分发（须以同一协议）。要求：署名（保留版权与许可声明，注明改动）。禁止：任何商业用途；商用请与一笥云工作室单独联系授权。

说明：这是**源码可见（source-available）**的非商业许可，不是 OSI 认定的开源许可；本插件不提供任何担保。