@neus117/dsh-anchor 0.0.0-stage → 0.6.0

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# 变更记录
+
+## 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,113 @@
-# 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.
+锚点系统只有一个插件，两个半边共用同一个锚点文件：
+
+| 半边 | 做什么 | 开关 |
+|---|---|---|
+| **注入** | 会话出现 `compaction/end` 后，把锚点原文追加回上下文（`user/message`，`source.kind=runtime-context`） | `inject.enabled` |
+| **表单** | 工具 `anchor_form`：让**人在会话里**填三行（做什么 / 为什么 / 还没验证 / 问我），写回同一份锚点 | `form.enabled` |
+
+2026-11-06 合并自 `dsh-anchor-inject` 0.4.0 + `dsh-anchor-form` 0.1.0。
+
+## 为什么合并
+
+两个包各有一份 `writeJudgment`，`$&` 那个写盘 bug 只长在其中一份里（另一份是安全的）；两份 `anchorFile`
+配置还可以指向不同文件，于是"人填的"喂不到"压缩后读取的"。合并后：写盘规则、锚点路径解析、三行文案、
+配置都只有一份，**表单和注入在结构上就不可能写到不同文件**。
+
+## 配置
+
+```yaml
+- id: dsh-anchor
+  name: dsh-anchor
+  config:
+    anchorFile: ''                                          # 留空 = 按会话分文件
+    anchorDir: 'D:\Coding\DeepSeek 开发经验\projects\anchors'  # <cwd目录名>\<会话短id>-anchor.md
+
+    createIfMissing: true
+    maxChars: 6000
+    protectedFiles: []
+    traceFile: ''
+    inject:
+      enabled: true
+      onceSession: ''
+      onceOnLoad: false
+      judge: { enabled: true, mode: model, minIntervalMs: 1800000 }
+    form:
+      enabled: true
+      intro: ''
+```
+
+| 字段 | 作用 |
+|---|---|
+| `anchorFile` | 显式锚点（存在就用它）。留空则**按会话分**：`<anchorDir>\<cwd目录名>\<会话短id>-anchor.md`——用户的会话 cwd 全是 `D:\Coding\workspace`，按 cwd 分不开项目，按会话分是确定性上界。**表单与注入走同一个解析函数**。 |
+| `anchorDir` / `createIfMissing` / `maxChars` | 锚点根目录、缺文件自动落骨架（表单首次使用也会落）、注入上限。 |
+| `protectedFiles` | 这些路径拒写（例如"测试不许碰正式锚点"）。 |
+| `traceFile` | 填路径就记 apply / 注入 / 提问 / 写入状态；留空完全不写盘。**排查先看它**。 |
+| `inject.*` | 注入半边：`judge.mode=model` 让模型补三行；`ask` 在宿主侧不可用（见下）；`onceOnLoad` 是测试通道。 |
+| `form.*` | 表单半边：`intro` 是第一栏开头的说明句，写 `''` 关掉。 |
+
+## 表单怎么引导人填对
+
+1. **每个空都写清怎么填 + 合格/不合格例子**；
+2. **可点候选**：取本会话最近两条真实原话、最近两条失败调用做成选项。label 只负责指路
+   （`刚才说的第 1 条` / `上一轮报错 1`），原文在说明里，**选中后写进锚点的是完整原文**；
+3. **打回重填**：`做什么` 只写「继续推进」这类通用动词、或 `为什么` 不带判据 → 打回一次，
+   卡片上写明打回理由；仍不合格才放行（`why` 追加 `[判据缺失]`）；
+4. **初见说明**：第一栏开头说明「压缩后我只看得见这个文件」，`form.intro` 可覆盖。
+
+## 写入规则（只有一个实现）
+
+只改 `## 下一步` 段：`[待填]` 空位 → 原位替换；已有 `- 做什么：` 行 → 原位更新；手写锚点 → 插在标题之后。
+替换值一律走函数形式（否则 `$&` 会被当成模板吃掉）。这个形状 `anchor-gen.ps1 -Refresh` 认得、会保留。
+
+## 压缩注入长什么样
+
+`<system-reminder>` + 说明「这不是用户指令」+ 来源与写入时间 + 锚点原文 + 「与当前窗口冲突时以窗口为准」。
+判断段还是空位时，额外指路：**调 `anchor_form` 让用户填，不要自己编**，并点出本文件路径让它核对配置。
+
+## 为什么 `judge.mode = ask` 不可用
+
+宿主根插件调 `ctx.userQuestions.ask` 拿不到合法的 agent 载体（活 agent 对象 / 不传 / `{id}` 占位，三种实测全失败）。
+工具执行上下文里的 `exec.agent` 才是唯一入口——所以问人这件事只存在于 `anchor_form` 里。
+
+## 客户端半边
+
+只做一件事：**题的说明文字**改成次级色。内置卡片里选项说明有 `tertiary`，题的说明（`.wnLwla_detail`）没有 `color`。
+
+```css
+.wnLwla_card .wnLwla_detail, .wnLwla_detail,
+.wnLwla_card .wnLwla_detail *, .wnLwla_detail * {   /* 文字在更深的自带颜色的元素里 */
+  color: var(--dsw-alias-label-tertiary) !important;  /* 强制：内置样式会压过普通声明 */
+}
+.wnLwla_card .wnLwla_detail, .wnLwla_detail {
+  margin-top: 8px !important;                         /* 与标题之间再拉开一点；左右沿用内置 24px */
+}
+```
+
+三条踩过的坑：
+
+- **注入必须在 factory 执行时做，不能放在 `apply(ctx)` 的 `ctx.effect` 里**：客户端 API 一有差异就静默失败，
+  页面上看不出任何异常（2026-11-06 连试三次都"改了没反应"）。
+- **验证只能看页面，用二元探针**：`outline: 2px solid red !important` → 问"有没有红框"。
+  有红框=模块加载+选择器命中；没红框=模块没进页面。别用"CSS 文件里写了什么"当证据。
+- 类名带构建期 hash（`wnLwla_`），升级后选择器失效会退回原样；`test/compat.mjs` 每次升级后跑一次。
+- **factory id 必须等于包名 `dsh-anchor`**（2026-11-06 曾因写成别的名字触发 web boot 致命失败）。
+
+## 边界
+
+- `ask` 没有超时：没人回答就一直等，直到会话结束。
+- 一次调用最多 5 张卡（4 栏 + 2 次打回）。
+- 候选来自会话末尾 2 条原话 / 2 条失败调用，不是"总结"。
+- 注入只在 `compaction/end` 后发生一次；压缩失败也会发这个事件（验收时别把"失败也注入"当成"压缩成功"）。
+
+## 开发
+
+```powershell
+$env:ELECTRON_RUN_AS_NODE=1
+$exe = "D:\Coding\DeepSeek Harness\DeepSeek Harness.exe"
+& $exe "D:\Coding\dsh-plugins\dsh-anchor\test\run.mjs"      # 表单/写盘 30
+& $exe "D:\Coding\dsh-plugins\dsh-anchor\test\inject.mjs"   # 注入/判断层/指路 35
+& $exe "D:\Coding\dsh-plugins\dsh-anchor\test\client.mjs"   # 客户端半边 5
+& $exe "D:\Coding\dsh-plugins\dsh-anchor\test\compat.mjs"   # 升级自检 5（钉死宿主内部标识）
+```

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;
+  }
+}