@neus117/dsh-anchor 0.0.0-stage → 0.6.1

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# 变更记录
+
+## 0.6.1 — 2026-11-06
+
+**文档**
+
+- README 重写：按「能做什么 / 锚点长什么样 / 安装 / 写到哪 / 填的时候 / 边界」组织，去掉开发过程与内部实现细节。
+
+## 0.6.0 — 2026-11-06
+
+锚点系统合并成一个包（前身：`dsh-anchor-inject` 0.4.0 + `dsh-anchor-form` 0.1.0）。
+
+**新增**
+
+- 工具 `anchor_form`：四栏（做什么 / 为什么 / 还没验证 / 问我）。三行写回锚点，第四栏原样回会话，由智能体按问题范围翻历史回答。
+- 可点候选：取本会话最近两条原话、最近两条失败调用；label 只指路，选中后写完整原文。
+- 打回重填：`做什么` 只写通用动词、或 `为什么` 不带判据 → 打回一次，卡片上写明理由。
+- 压缩注入时，若「下一步」三行还是空位 → 注入里指路「调 `anchor_form` 让用户填」，并点出本文件路径让它核对配置。
+- 客户端半边：问答卡片里题的说明文字改成次级色（`tertiary`）+ 上间距 8px。
+- `test/compat.mjs`：钉死四个宿主内部标识（卡片 bundle、`.wnLwla_detail`、主题变量、`AskUserQuestionItem` 字段），升级后先跑它。
+
+**变更**
+
+- **锚点按会话分文件**：`anchorFile` 留空时解析成 `<anchorDir>\<cwd目录名>\<会话短id>-anchor.md`。
+  表单与注入走同一个 `resolveAnchorPath()`，结构上不可能写到不同文件。
+- 表单首次使用会按 `createIfMissing` 落模板骨架，不再因"文件还没被创建"报错。
+- `traceFile` 超过 256 KB 在 apply 时清空；大会话只扫尾部 400 条事件。
+
+**修复**
+
+- `writeJudgment` 的 `$&` 注入 bug（`replace` 的字符串参数是模板）。
+- 客户端注入改到 factory 执行时，不再依赖 `ctx.effect`；客户端 API 有差异时不会静默失效。
+- `apply` 永不抛：两个半边各自 try/catch 隔离，任一失败不拖垮宿主或预设挂载。
+
+## 更早
+
+- `dsh-anchor-inject` 0.4.0：压缩后重注入锚点；`judge.mode=model` 让模型补三行。
+- `dsh-anchor-form` 0.1.0：`anchor_form` 工具初版。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Neus117
+
+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.

package/README.md

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# dsh-anchor
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+上下文被压缩后，把你自己写的「锚点」重新塞回模型的上下文；三行「下一步」还可以在会话里用表单让人填。
+
+## 它能做什么
+
+| 注入 | 表单 |
+|---|---|
+| 每次上下文压缩后，自动把锚点文件原文追加回上下文，并声明「这不是用户指令」 | 智能体调 `anchor_form` 时，弹出四个空——**做什么 / 为什么 / 还没验证 / 问我** |
+| 触发：`compaction/end` | 触发：智能体主动调用 |
+| 开关：`inject.enabled` | 开关：`form.enabled` |
+
+压缩能保住事实，保不住判断。判断得由人写——表单就是把「让人写」搬进会话里；写回的文件和压缩后注入的是**同一个**。
+
+## 锚点长什么样
+
+一份普通 Markdown，关键是这三行：
+
+```markdown
+## 下一步（做什么 + 为什么）
+- 做什么：把 anchor_form 挂进预设并调一次验收
+- 为什么：跑 test\run.mjs 得到 34 passed
+- 还没验证：真实压缩后的注入还没触发过
+```
+
+只改 `## 下一步` 段：有 `[待填]` 空位就原位替换，已有这三行就原位更新，手写锚点则插在标题之后——其它段一个字节不动。
+
+## 安装
+
+```powershell
+npm i @neus117/dsh-anchor
+```
+
+挂载一行即可（两个半边可以分别关）：
+
+```yaml
+- id: dsh-anchor
+  name: '@neus117/dsh-anchor'
+  config:
+    anchorFile: ''                                  # 留空 = 按会话分文件
+    anchorDir: 'D:\Coding\DeepSeek 开发经验\projects\anchors'
+    inject: { enabled: true }
+    form: { enabled: true }
+```
+
+## 锚点写到哪
+
+- `anchorFile` 留空时按会话分：`<anchorDir>\<工作目录名>\<会话短id>-anchor.md`，**任何会话都不会读到别的项目的锚点**。
+- 文件不存在时自动落一份模板骨架（表单第一次用也会落）。
+- 想固定一份共享锚点：把 `anchorFile` 写成那个路径。
+
+## 填的时候
+
+- **可点候选**：本会话最近两条原话、最近两条失败调用做成选项，选中就写入完整原文。
+- **打回重填**：「做什么」只写「继续推进」这类通用动词、或「为什么」不带判据 → 打回一次，卡片上写明理由。
+- **第四栏「问我」**：写的话不写进锚点，原样回到会话，智能体按问题范围翻历史回答。
+- 判断段还空着时，压缩注入里会指路「调 `anchor_form` 让用户填，别自己编」。
+
+## 边界
+
+- 问人只在**工具执行上下文**里成立；宿主侧拿不到可用的 agent 载体，所以没有"自动弹表单"。
+- `ask` 没有超时：没人回答就一直等，直到会话结束。
+- 一次调用最多 5 张卡（4 栏 + 最多 2 次打回）。
+- 压缩失败也会发 `compaction/end`——注入发生了不等于压缩成功了。
+
+## 开发
+
+```powershell
+$env:ELECTRON_RUN_AS_NODE=1
+$exe = "D:\Coding\DeepSeek Harness\DeepSeek Harness.exe"
+& $exe "…\dsh-anchor\test\run.mjs"      # 表单 / 写盘 / 健壮性
+& $exe "…\dsh-anchor\test\inject.mjs"   # 注入 / 判断层 / 指路
+& $exe "…\dsh-anchor\test\client.mjs"   # 客户端半边
+& $exe "…\dsh-anchor\test\compat.mjs"   # 升级自检：钉死宿主内部标识
+```
+
+变更记录见 [CHANGELOG.md](./CHANGELOG.md)。

package/cordis.patch.yml

@@ -0,0 +1,34 @@
+# dsh-anchor — 锚点系统（注入 + 表单，一个包）
+#
+# 2026-11-06 合并自 dsh-anchor-inject（0.4.0）+ dsh-anchor-form（0.1.0）。
+# 合并的理由：两份 writeJudgment 里只有一份有 $& 的修复；两份 anchorFile 可以指向不同文件，
+# 于是"人填的"喂不到"压缩后读取的"。现在写盘规则、路径解析、三行文案、配置文件都只有一份。
+#
+# 两个半边可以分别关：inject.enabled / form.enabled。任一边抛错只影响自己（index.js 里各自 try/catch）。
+- insert:
+    - id: dsh-anchor
+      name: '@neus117/dsh-anchor'
+      config:
+        # 注入与表单共用这一份解析：anchorFile 存在就用它，否则退回 anchorDir + 会话 cwd。
+        anchorFile: ''
+        anchorDir: 'D:\Coding\DeepSeek 开发经验\projects\anchors'
+        createIfMissing: true
+        maxChars: 6000
+        # 需要"测试不许覆盖正式锚点"时，把路径加到这里。
+        protectedFiles: []
+        traceFile: 'D:\Coding\DeepSeek 开发经验\projects\anchor-trace.log'
+        inject:
+          enabled: true
+          onceSession: ''
+          onceOnLoad: false
+          judge:
+            # model = 让模型补三行（宿主作用域可用）；
+            # ask   = 宿主侧拿不到 live agent，实测三种传参全失败，只保留失败路径；
+            #         真要问人请让智能体调 anchor_form。
+            enabled: true
+            mode: model
+            minIntervalMs: 1800000
+        form:
+          enabled: true
+          # 第一栏开头的说明句；写 '' 关掉。
+          intro: ''

package/lib/client.js

@@ -0,0 +1,91 @@
+// ============================================================================
+// dsh-anchor — 浏览器半边（只做一件事：问答卡片的说明文字用次级色）
+// ============================================================================
+// 内置卡片（@deepseek-ai/dsh-client-ui-user-questions，0.2.2-rc.1 实测）：
+//   .wnLwla_detail      { flex-shrink: 0; margin: 0 24px 8px }   ← **没有 color**
+//   .wnLwla_description { color: var(--dsw-alias-label-tertiary) }  ← 选项说明有次级色
+// 也就是：选项说明是次级色，题的说明文字却继承卡片主色（和标题同色）。只补这个缺口。
+//
+// **不要覆盖左间距**：0.2.1 是 `margin: 0 2px 8px`（贴选项框）；0.2.2 官方改成 `0 24px 8px`
+// （与标题同边界），用户抱怨的"没距离"已由上游修好。
+//
+// 可靠性：样式在**模块加载时**就注入，不依赖客户端 ctx 的 `effect` 是否存在。
+// 2026-11-06 第一版把注入放在 `apply(ctx)` 的 `ctx.effect(...)` 里，客户端 API 一有差异就
+// 静默不生效（被 try/catch 吃掉），页面上完全看不出来。现在有两条退路：
+//   1. 模块一执行就注入（主路径）；
+//   2. apply(ctx) 时再确保一次，并在 ctx 提供 effect 时登记卸载。
+// 注入成功会打一条 `[dsh-anchor] style injected` 到控制台——排查时先看它。
+//
+// 已知脆弱点：类名带构建期 hash（wnLwla_），升级后选择器可能失效 → 退回原样，不会改坏。
+// **factory id 必须等于包名**（现为 `@neus117/dsh-anchor`；写成别的名字 = web boot 致命失败，见 0.2.1 事故）。
+// ============================================================================
+
+window.__ModuleLoader__.load({
+	id: "@neus117/dsh-anchor",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+
+		const STYLE_ID = "dsh-anchor";
+		const CSS = [
+			// detail 的内容是 MarkdownText，文字挂在更深的子元素上且自带颜色；只给外层上色不生效
+			// （2026-11-06 实测：红框探针证明选择器命中，但颜色不变）。所以覆盖到所有后代。
+			// tertiary 比 secondary 再浅一档，与选项说明同一级。
+			".wnLwla_card .wnLwla_detail, .wnLwla_detail,",
+			".wnLwla_card .wnLwla_detail *, .wnLwla_detail * {",
+			"  color: var(--dsw-alias-label-tertiary) !important;",
+			"}",
+			// 与标题之间再拉开一点（内置是 margin: 0 24px 8px，上边距为 0）。
+			// 只动上边距；左右沿用内置的 24px。
+			".wnLwla_card .wnLwla_detail, .wnLwla_detail {",
+			"  margin-top: 8px !important;",
+			"}"
+		].join("\n");
+
+		/** 幂等注入：已有就返回那一个；没有 head 就落到 documentElement。 */
+		function injectStyle() {
+			if (typeof document === "undefined") return null;
+			try {
+				if (typeof document.querySelector === "function") {
+					const existing = document.querySelector(`style[data-dsh-plugin="${STYLE_ID}"]`);
+					if (existing) return existing;
+				}
+				const style = document.createElement("style");
+				style.dataset.dshPlugin = STYLE_ID;
+				style.textContent = CSS;
+				const host = document.head || document.documentElement;
+				if (!host) return null;
+				host.appendChild(style);
+				return style;
+			} catch (error) {
+				try { console.warn("[dsh-anchor] style inject failed", error); } catch {}
+				return null;
+			}
+		}
+
+		// 模块加载即注入：不等人调用 apply，也不依赖 ctx.effect。
+		const injected = injectStyle();
+		if (injected) {
+			try { console.info("[dsh-anchor] style injected"); } catch {}
+		}
+
+		/**
+		 * 插件入口：再确保一次注入；ctx 提供 effect 时登记卸载。
+		 * 任何异常都不往外抛——客户端样式不该有能力弄坏页面。
+		 * @param ctx - 插件自己的客户端上下文。
+		 */
+		function apply(ctx) {
+			const style = injectStyle();
+			try {
+				ctx?.effect?.(() => () => style?.remove?.(), "dsh-anchor: question card detail color");
+			} catch (error) {
+				try { console.warn("[dsh-anchor] effect unavailable (style 仍已注入)", error); } catch {}
+			}
+		}
+
+		exports.apply = apply;
+
+		return module.exports;
+	}
+});

package/lib/core.js

@@ -0,0 +1,127 @@
+/**
+ * dsh-anchor — 共享核心：读锚点、写三行、判据判定。
+ *
+ * 这里只放**两个入口（注入 / 表单）都要用的东西**，避免同一件事写两遍：
+ * 2026-11-06 之前 `writeJudgment` 在两个包里各有一份，`$&` 那个 bug 只长在其中一份里。
+ *
+ * @module dsh-anchor/core
+ */
+
+import { readFileSync, writeFileSync } from "node:fs";
+
+export function readText(file) {
+  const text = readFileSync(file, "utf8");
+  return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+
+/** 判据：命令、路径、读数、报错原文、用户原话——压缩后的我能拿去重跑的东西。 */
+export function looksLikeEvidence(text) {
+  return /(\d|[\\/]|`|FAIL|exit|→|原话|第\s*\d+\s*轮)/.test(String(text || ""));
+}
+
+// 「做什么」只写一个通用动词时，换个人（或压缩后的自己）不知道要动哪里。
+const VAGUE_WHAT = /^(继续|继续推进|继续做|继续工作|推进|往下做|往下走|优化|改进|完善|修复|修复问题|完成|收尾|测试一下|看看|跟进|开始|处理)[。.!！]?$/;
+
+export function isVagueWhat(text) {
+  return VAGUE_WHAT.test(String(text || "").trim());
+}
+
+/** 压成一行、截断，给选项 label 用（label 会被原样写成答案，所以要短）。 */
+export function clip(text, max = 48) {
+  const flat = String(text || "").replace(/\s+/g, " ").trim();
+  return flat.length > max ? `${flat.slice(0, max)}…` : flat;
+}
+
+export function normalizePath(file) {
+  return String(file || "").replace(/\//g, "\\").replace(/\\+$/, "").toLowerCase();
+}
+
+export function isProtected(file, protectedFiles) {
+  const target = normalizePath(file);
+  return (Array.isArray(protectedFiles) ? protectedFiles : []).some((entry) => normalizePath(entry) === target);
+}
+
+const LINE = {
+  what: { todo: /- \[待填\] 做什么：[^\r\n]*/, filled: /- 做什么：[^\r\n]*/, label: "做什么" },
+  why: { todo: /- \[待填\] 为什么（[^）]*）：[^\r\n]*/, filled: /- 为什么：[^\r\n]*/, label: "为什么" },
+  pending: { todo: /- \[待填\] 还没验证：[^\r\n]*/, filled: /- 还没验证：[^\r\n]*/, label: "还没验证" },
+};
+
+function applySection(section, judgment) {
+  let next = section;
+  let touched = false;
+  for (const key of Object.keys(LINE)) {
+    const value = judgment[key];
+    if (!value) continue;
+    const spec = LINE[key];
+    const line = `- ${spec.label}：${value}`;
+    if (spec.todo.test(next)) {
+      next = next.replace(spec.todo, () => line);
+      touched = true;
+    } else if (spec.filled.test(next)) {
+      next = next.replace(spec.filled, () => line);
+      touched = true;
+    }
+  }
+  if (touched) return { text: next, touched: true };
+  const insert = Object.keys(LINE)
+    .filter((key) => judgment[key])
+    .map((key) => `- ${LINE[key].label}：${judgment[key]}`)
+    .join("\n");
+  if (!insert) return { text: next, touched: false };
+  const lead = /^(?:\r?\n)+/.exec(next)?.[0] ?? "";
+  return { text: `${lead}${insert}\n${next.slice(lead.length)}`, touched: true };
+}
+
+/**
+ * 把三行写进「下一步」段；只动这一段，其它段一个字节不碰。
+ *   1. 有 `- [待填] 做什么：` 空位 → 原位替换；
+ *   2. 已有 `- 做什么：` 行 → 原位更新（重复填写不堆行）；
+ *   3. 两样都没有（手写锚点）→ 插在 `## 下一步` 标题之后。
+ * 替换值一律走函数形式：`replace` 的字符串参数里 `$&`、`` $` ``、`$'` 是模板，会被吃掉。
+ * @returns {{status: "written"|"no-change"|"failed", detail: string}}
+ */
+export function writeJudgment(file, judgment) {
+  let text;
+  try {
+    text = readText(file);
+  } catch (error) {
+    return { status: "failed", detail: `读不到锚点文件：${error?.message || error}` };
+  }
+  const heading = /^## 下一步[^\r\n]*$/m.exec(text);
+  if (!heading) {
+    return { status: "failed", detail: "锚点文件里没有 `## 下一步` 段，拒绝写入（不猜位置）" };
+  }
+  const start = heading.index + heading[0].length;
+  const rest = text.slice(start);
+  const endRel = rest.search(/^\r?\n## /m);
+  const end = endRel >= 0 ? start + endRel : text.length;
+  const result = applySection(text.slice(start, end), judgment);
+  if (!result.touched) return { status: "no-change", detail: "没有可写的行" };
+  const next = text.slice(0, start) + result.text + text.slice(end);
+  if (next === text) return { status: "no-change", detail: "内容未变" };
+  try {
+    writeFileSync(file, next, "utf8");
+  } catch (error) {
+    return { status: "failed", detail: `写入失败：${error?.message || error}` };
+  }
+  return { status: "written", detail: "" };
+}
+
+/** 判断段是否还是空位（给压缩注入决定要不要指路）。 */
+export function judgmentEmpty(file) {
+  try {
+    const text = readText(file);
+    if (text.includes("- [待填] 做什么：") || text.includes("- [待填] 为什么")) return true;
+    const after = text.split(/^## 下一步[^\r\n]*$/m)[1];
+    if (after === undefined) return false;
+    const section = after.split(/^## /m)[0] || "";
+    const meaningful = section
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter((line) => line && !line.startsWith("- [指针]") && !line.startsWith("- [待填]"));
+    return meaningful.length === 0;
+  } catch {
+    return false;
+  }
+}