@Kfytm

attention-scheduler

Name: attention-scheduler
Availability: InStock
Author: Kfytm

注意力调度与记忆检索规则 | DSH Skill：减轻上下文幻觉（检索触发、注入预算、写回白名单、L0/L1 成本归属），支持 dsh plugin 一键安装

Stars: 0
Language: JavaScript
Created: Oct 6, 2026
Updated: Oct 6, 2026

Memory Skills

GitHub repo

Introduction

attention-scheduler · 注意力调度规则

🎯 本技能旨在减轻、消除 AI 上下文幻觉问题。 上下文幻觉的根因通常是"历史污染"：过期结论、无关片段、未经核实或被误当作事实的旧对话，悄无声息地混进当前推理。本技能用显式规则把这件事管起来——该不该检索、召回多少、保留什么、丢弃什么、写回什么，全部有据可依、可审计、可复现。

一套可复用的 注意力 / 上下文 / 记忆 使用规范，作为 DeepSeek Harness 的 技能（Skill） 分发：让模型在"该记什么、该查什么、该丢什么、该写回什么"上有一致、可审计的行为依据。

适用场景：会话很长、历史挤占上下文、回复被旧信息带偏；或团队希望统一"检索/记忆"的使用纪律。

⚠️ 需要搭配记忆插件：如果没有（未接 MemOS 之类的长期记忆），本技能只有注意力预算、保留优先级、压缩六要素、写回白名单会实际生效；检索触发、召回/注入条数、注入预算等条款将处于空转状态（不报错，但没有检索对象）。

包含内容

模块	说明
检索四级触发	强制 / 禁止 / 强 / 弱 / 抑制，含冲突优先级
跨会话检索约束	会话标签、隐私会话只查当前、项目命名空间
注意力预算	保留轮次、保留优先级、压缩摘要六要素、固定开销公式、压缩触发阈值
L0/L1 成本归属	骨架常驻（计入固定开销）vs 动态召回（计入注入预算）：谁该花 token
记忆注入	召回数 vs 注入数、注入预算（工作记忆 20%–25%）、超限淘汰
冲突与写回	冲突优先级、写回白名单/黑名单、写回格式与版本链（`superseded`）
实测脚本	`scripts/measure-overhead.cjs`：从会话日志分别量出固定开销 / L0 骨架 / L1 动态召回三类成本
配置落点表	`references/config-map.md`：哪些条款只能靠配置强制，以及"注入形态对照表"

安装

方式一：作为插件安装（推荐 · 一条命令）

本仓库同时是标准 DSH 插件（package.json 带 dsh.bundle.patch），插件加载时会把技能注册进技能注册表（ctx.skills.registerProvider()），因此可以直接：

# 从 GitHub 安装（任意 profile）
dsh plugin --profile web add github:Kfytm/attention-scheduler

# 本地开发：用 link 方式，改完即生效
dsh plugin --profile web add link:D:\path\to\attention-scheduler

装完重启该 profile即可用。卸载：dsh plugin --profile web remove dsh-attention-scheduler。

优点：技能随插件版本走（可 dsh plugin update）；SKILL.md 变化会热刷新，无需重启宿主。 rank = 250，低于用户本地文件技能（400）与官方内置技能（600），你放在 ~/.dsh/skills/ 的同名技能会覆盖它。

方式二：作为文件技能安装（脚本 / 手工）

# Windows（Windows PowerShell 5.1 亦可；若装了 PowerShell 7 可把 powershell 换成 pwsh）
git clone https://github.com/Kfytm/attention-scheduler.git
cd attention-scheduler
powershell -ExecutionPolicy Bypass -File scripts\install.ps1            # 复制安装
powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Mode link # 或目录联接，便于开发

# macOS / Linux / WSL
git clone https://github.com/Kfytm/attention-scheduler.git
cd attention-scheduler
bash scripts/install.sh

安装位置：$DSH_HOME/skills/attention-scheduler/（默认 ~/.dsh/skills/）。

方式二：手工复制

把 SKILL.md（以及 references/、scripts/）放进 ~/.dsh/skills/attention-scheduler/：

~/.dsh/skills/attention-scheduler/
├── SKILL.md          ← 必需；DSH 只扫描 depth 1 的 <skill>/SKILL.md
├── references/
└── scripts/

技能名须匹配 ^[a-z0-9]+(?:-[a-z0-9]+)*$（kebab-case）。安装后无需重启，DSH 会热发现。

使用

按需加载：在 DSH 里说"套用注意力调度规则"，或让模型调用 skill 工具加载 attention-scheduler。
全局生效（可选）：把本技能 §一–§九的精简版写入 ~/.dsh/AGENTS.md，每轮自动作为工作区指令注入，无需每次加载。
复测开销：

node scripts/measure-overhead.cjs --session "~/.dsh/sessions/<ws>/<session-id>/session.v4.jsonl.zstd"

输出示例：

系统提示     : 8440 字符  ≈ 2638 tokens
工具定义     : 42 个工具, 32051 字符  ≈ 10016 tokens
固定开销合计 : ≈ 12653 tokens  （按 3.2 字符/token 估算）
上下文窗口   : 1000000

把结果回填 SKILL.md §一.7 —— 不要沿用别人的数字，它随模型与插件组合变化。

目录结构

attention-scheduler/
├── SKILL.md                          # 技能主体（frontmatter: name/description）
├── package.json                      # 插件清单（dsh.bundle.patch → 一键安装）
├── cordis.patch.yml                  # bundle 挂载清单（insert 一行）
├── lib/index.js                      # 插件半边：注册运行期技能 provider（零依赖）
├── README.md
├── LICENSE                           # MIT
├── CHANGELOG.md
├── references/
│   ├── config-map.md                 # 配置落点 + 注入形态对照表（L0/L1）
│   └── overhead-measurement.md       # 三类上下文成本的测量口径与依据
└── scripts/
    ├── install.ps1                   # Windows 文件技能安装
    ├── install.sh                    # macOS/Linux 文件技能安装
    └── measure-overhead.cjs          # 固定开销 / L0 / L1 三类成本实测

参考与依据（References）

技能里关于注入形态与成本的判断都可以复核，来源如下：

DSH 本体（本机安装包实测 + 会话日志）

结论	依据
运行时上下文是 in-history 投放	会话日志 `request/context` 事件含 `systemPromptUpdate: "in-history"`
指令文件是"替换基线"语义（内容不变不新增副本）	`@deepseek-ai/dsh-agent-instructions` 中的 `REPLACEMENT_AGENT_INSTRUCTIONS_INTRO` 与按 SHA-1 去重逻辑
指令文件候选与预算	同包：`AGENTS.md` / `CLAUDE.md`（含 `.local`），用户全局为 `$DSH_HOME/AGENTS.md`，官方默认 `maxBytes: 65536`
技能排序权重	`@deepseek-ai/dsh-skill-filesystem`：project-dsh 100 / project-agents 200 / custom 300 / user-dsh 400 / user-agents 500；`@deepseek-ai/dsh-skill`：runtime 250、bundled 600
运行期技能注册范式	`@deepseek-ai/dsh-skill-office`：`{ name, description, invocation, provider, source, rank, resourceBase, locator }` + `ctx.skills.registerProvider()`

记忆插件（对照样本）

项目	引用要点
LittleBlackTong/dsh-plugin-memory（dshbase 页）	L0 常驻骨架的推荐形态：boot 块经 `ctx.systemPrompt.context()` 注入，按投影去重（不变不重复、变化时新快照取代旧的）；另有 `bootMaxChars` 体积预算
`@memtensor/memos-local-plugin` 2.0.20	L1 动态召回的对照：`dist/adapters/deepseek-harness/bridge.js` 在 `agent/pre-step` 追加消息，无去重；开关与体积为 `recallEnabled` / `contextMaxChars` / `toolResultMaxChars`

同主题项目（选型时的横向参考）

muratcankoylan/Agent-Skills-for-Context-Engineering（含 skills/context-compression）
kimtth/agent-skill-100-lines-or-less（技能正文 ≤100 行的篇幅主张）
monotykamary/dsh-fovea（token 预算化的聚焦/影响分析）、stas130286-blip/dsh-brainagent、dsh-token-headroom（上下文压缩）
目录站：dshbase 插件目录、awesome-dsh-plugin、awesome-dsh-list

本仓库自测数据

会话	轮次	L0 骨架	L1 动态召回
示例会话 A（长会话，自动召回全开）	66	0	47 条 / 169,158 字符 ≈ 52,862 tokens（占上下文成本 95%）
示例会话 B（关闭自动召回，改规则调度）	96	2 条 / 5,830 字符 ≈ 1,822 tokens	4 条 / 6,044 字符 ≈ 1,889 tokens

复现：node scripts/measure-overhead.cjs --session <会话日志>。

依赖与最小配置

没有必须安装的第三方组件——"骨架（L0）"在技能里是一个槽位，不是指定插件。

档位	需要装什么	效果
最小可用	只装技能本身（文件技能或插件形态，二选一）	规则生效；L0 可以为空
推荐（零插件）	技能 + 一个纯文本文件 `~/.dsh/AGENTS.md`	L0 骨架常驻（DSH 内置 `agent-instructions` 提供，本身即"内容不变不新增副本"的去重注入）
完整	再上记忆插件（MemOS / dsh-plugin-memory 一类）	L1 动态召回、L2 写回才有对象

依赖矩阵：

能力	由谁提供	必装？
规则被加载	`skill` 工具 / 技能目录（文件或插件）	二选一
L0 骨架	DSH 内置 `agent-instructions`（读 `AGENTS.md` / `CLAUDE.md`，官方默认 `maxBytes: 65536`）	写文件即可，不必装插件
L1 动态召回	记忆检索引擎（如 `memos_search`）	有记忆库才需要；否则该层为空
L2 沉淀写回	记忆插件的 capture	可选
成本实测	本仓库 `scripts/measure-overhead.cjs`（只读会话日志）	不必装

两条要点：

没有记忆插件时，L0/L1 是"空转但无害"：检索触发/召回条数/注入预算没有对象可施加，而注意力预算、保留优先级、压缩六要素、写回白名单照常生效——先立规矩，接上记忆库即全部生效。
L0 与注入方式解耦（见 SKILL.md §七.4）：L0 可以是手写的 AGENTS.md、可以是 systemPrompt.context() 式插件、也可以是别的 harness 里的等价机制。所以"必装"的从来不是某个项目，而是"你要不要那个能力"。

设计原则

行为归提示词，数字归配置：规则文本能约束"该不该查"；"召回几条、上限多少"必须落到配置。
默认不改配置：需要改记忆系统配置时，先备份、再改、再验证，并明确告知用户改了什么。
数字要实测：任何 token 数字都应可用脚本复现；写进规则的必须是实测值 + 测量日期。

兼容性

技能格式：SKILL.md（YAML frontmatter: name、description）+ 可选 references/、scripts/
配置落点表基于 DSH + MemOS 本地插件；其他环境请对照同类实现调整
宿主破坏性更新后如何重塑本技能：见 references/porting-guide.md （不变量清单、绑定点清单、重塑五步、漂移探针 scripts/probe-assumptions.cjs）

⚠️ 再次提醒：需要搭配记忆插件。如果没有（未接 MemOS 之类的长期记忆），本技能只有 注意力预算、保留优先级、压缩六要素、写回白名单会实际生效；检索触发、召回/注入条数、注入预算等条款将处于空转状态。

安全说明

安装前请自行复核（本仓库刻意保持"可一眼读完"的体量）：

项	现状
依赖	`package.json` 零 dependencies；插件只用 Node 内置模块（`node:fs` / `node:path` / `node:url`）
网络	插件与脚本不发起任何网络请求，无遥测、无外部上报、无自动更新
命令执行	不使用 `child_process` / `exec` / `eval` / `new Function`
文件读取范围	① 插件（`lib/index.js`）：只读本仓库目录下的 `SKILL.md`（及 `skills/*/SKILL.md`），并以只读 provider 注册；② `measure-overhead.cjs` / `probe-assumptions.cjs`：只读会话日志与宿主安装包，不写任何文件
文件写入范围	只有安装脚本会写文件，且仅写 `$DSH_HOME/skills/<技能名>/`：技能名强制 kebab-case 校验 + 路径护栏（目标必须落在技能目录内，否则拒绝）；仅 `-Force` / `--force` 才删除同名既有目录
权限	插件运行在宿主进程内，因此只做技能注册，不注册路由、不注入全局提示词、不改任何配置

发布前自检（可复现的 5 项扫描，本仓库在 v2.4.0 已执行）：

# 1) 密钥与凭据
grep -rInE 'sk-[A-Za-z0-9]{10,}|ghp_[A-Za-z0-9]{10,}|Bearer [A-Za-z0-9._-]{20,}|api[_-]?key\s*[:=]' .
# 2) 个人路径 / 用户名
grep -rInE 'C:\\\\Users|/home/[a-z]+|D:\\\\' .
# 3) 会话 ID / 记忆 ID（隐私痕迹）
grep -rInE 'session-[0-9a-f]{8}|tr_[a-z0-9]{8}' .
# 4) 危险调用
grep -rInE 'child_process|execSync|spawn\(|eval\(|new Function|fetch\(|Invoke-WebRequest' .
# 5) 二进制 / 大文件
find . -type f -size +100k -not -path './.git/*'

结果：5 项均无真实命中（示例数据中的会话标签已匿名化为"示例会话 A/B"）。

注：README.md 本节的命令块与说明文本本身包含上述模式，直接扫描会出现 3 处自匹配；复跑时请加 --exclude=README.md，或把这 3 处视为预期自匹配。

发现问题请开 Issue；涉及安全的问题请标注 security。

License

MIT License

Copyright (c) 2026 Kfytm

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

完整文本见 LICENSE；package.json 中亦声明 "license": "MIT"。版权人：Kfytm（如需变更请同步修改 LICENSE、本节与 package.json）。