前言¶
在 DeepSeek Harness（DSH）生态里，记忆类插件已经不少：有侧重存储与检索的，有侧边栏与自动落盘的。但很多开发者在换模型、开新会话或长期维护同一个 Agent 角色时，仍会卡在另一类问题上——该用哪些文件承载状态、判断写在哪里、何时压缩、交接时带什么。qing-self 针对的是「结构与流程」而不是再做一个向量库或自动抓取器；下面介绍它的定位、能力与典型用法。
这是什么¶
qing-self（维护者 malabananclauss-rgb）是 DSH 社区目录中的「记忆」分类插件：给 Agent 或角色一套可跨模型延续的纯文件骨架——分层记忆、判断卡、交接包、压缩审查，以及可迁移性对比。仓库说明强调：只提供结构，不提供记忆引擎；不自动抓取对话、不做 embedding、不调用模型。实现为零依赖的 Markdown + JSON，各命令支持 --json，磁盘格式在文档中锁定，便于其他插件读取。
项目曾用名 dsh-self，后经 dsh-memory-scaffold（v0.2.0）改名为 qing-self（v0.3.0）；CLI 可执行文件名仍为 dsh-self，斜杠命令、Agent 工具、.dsh-self/ 路径与格式 schema 保持不变。
核心功能¶
插件（及同名 CLI）提供八个确定性操作，均可在无网络、无 LLM 调用的前提下完成：
| 命令 | 作用（据 README） |
|---|---|
init |
创建四层结构：hot/state.md、index.md、judgments.md、judgments-cards.md、decisions.md，并附带模板与 QUICKSTART.md；幂等，只补缺、不覆盖已有内容。 |
judge |
追加一张判断卡（结论 / 原因 / 反例 / 未完成项 / 来源），自动编号（如 J001），同步写入索引表与卡片文件。 |
handoff |
读取记忆，生成交接包与 8 道验证题，并写机器可读的 .json 侧车；换模型或换会话前使用。--compact 产出约 6–10 KB 精简包；--focus 可按主题筛选判断卡。 |
review |
压缩审查：热区体积（>800 字符 / >2 KB 告警）、上下文占比估计、未持久化项、判断与卡片一致性、索引断链、模板漂移等。 |
ruler |
两问尺：把一条判断拆成可延续性、可迁移性两个跟进问题，并给出最大风险与可复制提示词；本地模板与关键词启发，不写盘、不调模型。 |
diff |
A→B 可迁移差异：对比两份评分 JSON，报告总分差、逐项差异率与方向（只读）。 |
recall |
三因子检索：按相关性、近期命中（hits.jsonl）、重要性对 judgments.md 排序，返回 Top N（只读）。 |
check |
Schema 校验：固定 7 列判断表、状态枚举、卡片与指针格式等；违规时退出码为 1（只读）。 |
在 DSH 中，上述能力通过斜杠命令与 Agent 工具暴露（例如初始化用 /self-init，尺规另有 /self-ruler 与 dsh_self_ruler）。
两问尺的典型 CLI 用法如下（与 README 一致）：
dsh-self ruler --situation "我该不该把发布交给青决定？" --context "本周内要给答复。"
dsh-self ruler 我该不该换模型
适合在不可逆决策、有成本的承诺、花钱或让他人承担后果等场景下，先把「情境」与「判断」拆开，再决定是否写入 judge。
明确不是：自动存储/检索插件、带身份内容的资料包、运行时记忆引擎；CLI 也可在纯 Node 环境下单独使用（node bin/dsh-self.mjs init）。
安装与启用¶
推荐在 DSH 中从 Git 引用安装（README 给出的命令与标签为 v0.3.0）：
dsh plugin --profile web add git+https://github.com/malabananclauss-rgb/qing-self#v0.3.0
也可使用 v0.3.0 发布页的预构建包：
dsh plugin --profile web add https://github.com/malabananclauss-rgb/qing-self/releases/download/v0.3.0/qing-self-0.3.0.tgz
安装并启用属于用户在本机 profile 上的授权步骤；仓库只提供可安装 bundle，不会擅自修改你的 profile。按提示重启 DSH 后，在工作区执行 /self-init 即可生成目录结构。
运行环境：package.json 要求 Node >=20，许可证为 MIT。npm 包尚未发布，安装以 GitHub 途径为准。
若只需 CLI、不装插件：
node bin/dsh-self.mjs init
典型用法流程¶
- 安装插件并重启 DSH，在工作区运行
/self-init（或dsh-self init），得到.dsh-self/下的分层文件与快速入门说明。 - 在重要结论固化前，用
ruler或/self-ruler做可迁移性 / 可延续性自检，再视需要judge写入判断卡。 - 会话内用
hot/state.md等维护当前状态；定期review检查体积与一致性。 - 换模型或交接给他人/其他 Agent 前运行
handoff（需要精简上下文时用--compact）。 - 需要对照两次「可迁移评分」时用
diff；回顾历史判断用recall；改表结构或批量编辑后用check验 schema。
所有命令均支持 --json，便于与会话启动、压缩门禁、交接消费类等其它 DSH 插件对接；格式约定见仓库 docs/FORMAT.md 与 docs/ECOSYSTEM.md。
适用场景与注意¶
适合：希望自己掌控记忆内容与格式、需要在不同模型间手工交接、希望判断层与「存对话」类插件分工协作的 DSH 用户。它与存储类插件是叠加关系：存储仍由存储插件负责，判断与仪式化流程在 qing-self 这层完成。
注意：
- 插件在当前 DSH 进程权限下运行，安装前请自行审阅 源码 与 MIT 许可证。
- 模板仅有占位符，身份、关系与具体判断需由你或 Agent 按规范填写；升级模板版本不会覆盖已写文件，
review会提示模板漂移。 - DSH 插件目录（如 SkillHub 目录页）是社区站点，与 DeepSeek / 幻方无官方从属关系；选型时以仓库 README 与发布说明为准。
结尾¶
qing-self 的价值在于用四个核心文件、八个操作和可锁定的格式契约，把「跨模型自我延续」拆成可重复执行的步骤，而不是再争一套私有记忆后端。若你要在 DSH 里搭这套结构，可从目录页了解分类与简介，再到 GitHub 查看完整命令说明与格式文档。
- 目录页：https://www.skillhub.cn/plugins/malabananclauss-rgb/qing-self
- 仓库：https://github.com/malabananclauss-rgb/qing-self
