@morlay/dsh-reference 0.0.2 → 0.0.3

package/README.md

@@ -1,10 +1,11 @@
 # @morlay/dsh-reference
 
 **引用展开**：用户消息里手打的 `@path` / `skill:name` 引用在 `agent/pre-step` 展开成注入内容——文件走
-`<file_content>` 内容块（窗口与 `read` 一致）、skill 走正文与 `skill` 工具；读不出的引用静默保持普通文本。
+`<file_content>` 内容块（窗口与 `read` 一致），skill 走正文（要 `skill` 工具可见）；读不出的引用静默保持普通
+文本，缺 `ctx.fs` 的部署只做 skill。
 
 它不依赖注入通道（[`@morlay/dsh-context-assembler`](../dsh-context-assembler/README.md) 的
-`ctx.contextAssembler`）：自己挂 `agent/pre-step`、`inject` 只有 `skills`，不依赖通道服务，所以装在哪一层
+`ctx.contextAssembler`）：自己挂 `agent/pre-step`、`inject` 只有 `skills`，所以装在哪一层
 装配面上都成立。装配落在 [`@morlay/better-session`](../../bundles/better-session/cordis.patch.yml)（一行
 `@morlay/dsh-reference`）。
 
@@ -20,9 +21,3 @@
 引用解析（`@a.ts`、`@a.ts#L12-L40`、`@[label](a.ts)`、`skill:name` 等形态与行窗口）复用
 `@morlay/dsh-client-ui-primitives` 的 `reference.ts`——**源码上唯一一份**，构建时内联进本包产物，
 所以发布清单里没有它。
-
-## 文档
-
-- 设计与取舍（窗口、信封、读不出的处理）：[设计 文件引用内容注入](./.agents/designs/20260920-文件引用内容注入.md)
-- 信封形态（`<file_content>` 由谁定）：[设计 上下文注入规则](../dsh-context-assembler/.agents/designs/20260921-上下文注入规则.md)
-- 本包术语：[.agents/CONTEXT.md](./.agents/CONTEXT.md)

package/dist/index.mjs

@@ -4752,7 +4752,6 @@ function parseBareReference(raw) {
 		...column === void 0 ? {} : { column: Number(column) }
 	};
 }
-/** 引号 mention 的起手字符：`@"path with spaces"`。 */
 const QUOTED_PATH = "\"";
 function parseQuotedReference(body) {
 	const end = body.indexOf(QUOTED_PATH, 1);
@@ -4888,10 +4887,6 @@ function sameWindow(left, right) {
 //#region src/index.ts
 const name = "reference";
 const inject = ["skills"];
-/**
-* 内容之外的一条说明（见层级设计「内容之外的说明」）：不说来源，模型会再 read 一遍同一段内容。
-* 与内容同处一条消息，所以同一步有多个引用时它也只说一次。
-*/
 const NOTE = [
 	"<system-reminder>",
 	"这些文件内容是按你消息里的 @ 引用刚读取的，直接用它即可，不必再 read 一遍。",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-reference",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Reference expansion for dsh: `@path` / `skill:name` in a user message expand into injected content at pre-step. Independent of the injection channel; the reference parser it reuses is inlined into the artifact, so this package ships without a client-side dependency.",
   "keywords": [
     "context",
@@ -35,7 +35,7 @@
     "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
     "@deepseek-ai/dsh-session": "0.2.0-rc.1",
     "@deepseek-ai/dsh-skill": "0.2.0-rc.1",
-    "@morlay/dsh-client-ui-primitives": "0.0.4",
+    "@morlay/dsh-client-ui-primitives": "0.0.5",
     "@types/mdast": "^4.0.4"
   },
   "peerDependencies": {

package/src/index.ts

@@ -27,10 +27,8 @@ declare module "@deepseek-ai/dsh-llm" {
   }
 }
 
-/**
- * 内容之外的一条说明（见层级设计「内容之外的说明」）：不说来源，模型会再 read 一遍同一段内容。
- * 与内容同处一条消息，所以同一步有多个引用时它也只说一次。
- */
+// 内容之外的一条说明（见层级设计「内容之外的说明」）：不说来源，模型会再 read 一遍同一段内容。
+// 与内容同处一条消息，所以同一步有多个引用时它也只说一次。
 const NOTE = [
   "<system-reminder>",
   "这些文件内容是按你消息里的 @ 引用刚读取的，直接用它即可，不必再 read 一遍。",
@@ -41,10 +39,8 @@ export function apply(ctx: Context): void {
   ctx.on("agent/pre-step", async ({ agent, messages, signal }, next): Promise<PreStepDecision> => {
     const decision = await next();
     if (decision.kind === "reject") return decision;
-    // 依赖关系：没有对应工具时，注入也没有意义（模型拿到了内容也用不上那条路径）——
-    // 文件引用要有 read 能力，skill 引用要有 skill 工具。是否注入跟着工具走。
-    // 工具服务是可选的（`ctx.get` 在未声明 inject 的 ctx 上会抛，所以这里自己兜住）：
-    // 没有它时不参与判断，按解析结果照常展开。
+    // 注入跟着工具走：文件引用要有 `read` 能力、skill 引用要有 `skill` 工具，没有对应工具时注入也没有意义。
+    // 工具服务是可选的（没声明 `inject` 时 `ctx.get` 会抛，这里自己兜住）：取不到就按解析结果照常展开。
     const tools = ((): unknown => {
       try {
         return ctx.get("tools");