dsh-quote-annotate-pro 0.0.0-stage → 0.2.0

package/lib/index.js

@@ -0,0 +1,6 @@
+// dsh-quote-annotate-pro —— Host 半区（本插件为纯 Client 插件，Host 侧无操作占位）
+export const name = 'dsh-quote-annotate-pro'
+
+export function apply() {
+  // 全部功能在浏览器端（./client.js）
+}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "dsh-quote-annotate-pro",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "选区引用与锚点批注（增强 fork）：划词 → 批注 → 带精确锚点的引用 chip，点击跳回原文；提交时把轮次/角色/位置写入引用块，让模型精确知道你指的是哪一处。",
+  "keywords": ["dsh", "dsh-plugin", "deepseek-harness", "quote", "annotate", "selection", "reference", "anchor"],
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": ["lib", "tools", "cordis.patch.yml", "README.md", "SUMMARY.md", "CHANGELOG.md", "LICENSE"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhao-guang-ai/dsh-quote-annotate-pro.git"
+  },
+  "homepage": "https://github.com/zhao-guang-ai/dsh-quote-annotate-pro#readme",
+  "bugs": {
+    "url": "https://github.com/zhao-guang-ai/dsh-quote-annotate-pro/issues"
+  },
+  "scripts": {
+    "check": "node tools/check-manifest.mjs",
+    "diag": "node tools/diag-sink.mjs"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": []
+    }
+  }
+}

package/tools/check-manifest.mjs

@@ -0,0 +1,61 @@
+/**
+ * 清单一致性自检（CI 用，无外部依赖）：
+ *   1. package.json 必需字段与 dsh 声明；
+ *   2. exports['./client'] 指向的文件存在，且 bundle 的 `id` 与包名一致；
+ *   3. cordis.patch.yml 确实 insert 了本包名。
+ * 用法：node tools/check-manifest.mjs
+ */
+import { readFileSync, existsSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const fail = (msg) => { console.error(`✗ ${msg}`); process.exitCode = 1 }
+const ok = (msg) => console.log(`✓ ${msg}`)
+
+const pkgPath = resolve(root, 'package.json')
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+
+if (typeof pkg.name === 'string' && pkg.name !== '') ok(`name = ${pkg.name}`)
+else fail('package.json 缺少 name')
+
+if (typeof pkg.version === 'string' && /^\d+\.\d+\.\d+/.test(pkg.version)) ok(`version = ${pkg.version}`)
+else fail('package.json 缺少合法的 version')
+
+if (pkg.type !== 'module') fail('package.json 应为 "type": "module"')
+else ok('type = module')
+
+const clientDecl = pkg.dsh && pkg.dsh.client
+if (!clientDecl) fail('缺少 dsh.client 声明')
+else if (clientDecl.platform !== 'web') fail(`dsh.client.platform 应为 web，实际 ${clientDecl.platform}`)
+else ok('dsh.client.platform = web')
+
+const patchRel = pkg.dsh && pkg.dsh.bundle && pkg.dsh.bundle.patch
+if (!patchRel) fail('缺少 dsh.bundle.patch')
+else if (!existsSync(resolve(root, patchRel))) fail(`patch 文件不存在：${patchRel}`)
+else ok(`dsh.bundle.patch = ${patchRel}`)
+
+const clientRel = pkg.exports && pkg.exports['./client']
+if (!clientRel) fail("缺少 exports['./client']")
+else {
+  const clientPath = resolve(root, clientRel)
+  if (!existsSync(clientPath)) fail(`客户端 bundle 不存在：${clientRel}`)
+  else {
+    const head = readFileSync(clientPath, 'utf8').slice(0, 4000)
+    const idMatch = /__ModuleLoader__\s*\.\s*load\s*\(\s*\{\s*id:\s*'([^']+)'/.exec(head)
+    if (!idMatch) fail(`bundle 未以 window.__ModuleLoader__.load({ id, factory }) 形式注册：${clientRel}`)
+    else if (idMatch[1] !== pkg.name) fail(`bundle 注册的 id (${idMatch[1]}) 与包名 (${pkg.name}) 不一致`)
+    else ok(`bundle id = ${idMatch[1]}`)
+  }
+}
+
+if (patchRel && existsSync(resolve(root, patchRel))) {
+  const patch = readFileSync(resolve(root, patchRel), 'utf8')
+  if (patch.includes(pkg.name)) ok(`patch 引用了 ${pkg.name}`)
+  else fail(`patch 未引用包名 ${pkg.name}`)
+}
+
+if (pkg.main && !existsSync(resolve(root, pkg.main))) fail(`main 不存在：${pkg.main}`)
+else if (pkg.main) ok(`main = ${pkg.main}`)
+
+console.log(process.exitCode === 1 ? '\n自检未通过' : '\n自检通过')

package/tools/diag-sink.mjs

@@ -0,0 +1,56 @@
+/**
+ * 本地诊断接收端（开发期可选）。
+ *
+ * 插件（lib/client.js）在启动时会向 `http://127.0.0.1:47821/dsh-quote-pro` POST 一次 `/ping`
+ * 探测接收端：探测不到就本次运行静默，因此**不开这个脚本插件也能正常工作**。
+ *
+ * 用法：
+ *   node tools/diag-sink.mjs
+ *   # 自定义端口 / 日志文件：
+ *   DIAG_PORT=47821 DIAG_LOG=./diag-sink.log node tools/diag-sink.mjs
+ *
+ * 之后在 DSH 里操作插件，终端会实时打出全链路事件：
+ *   module:materialized / apply:start / register:ok …       插件加载与槽位注册
+ *   selection:show / selection:stage                        划词与「批注」
+ *   insert:chip / insert:fallback-plaintext                 引用插入（chip 或纯文本回退）
+ *   dock:rows / dock:click / jump:ok / toast                导航条与跳回原文
+ *   turnTail:render                                         回合尾部按钮取文
+ */
+import { createServer } from 'node:http'
+import { appendFileSync, mkdirSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+
+const PORT = Number(process.env.DIAG_PORT ?? 47821)
+const LOG = resolve(process.env.DIAG_LOG ?? 'diag-sink.log')
+
+mkdirSync(dirname(LOG), { recursive: true })
+
+const cors = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Methods': 'POST, GET, OPTIONS',
+  'Access-Control-Allow-Headers': '*',
+  'Access-Control-Max-Age': '600',
+}
+
+createServer((req, res) => {
+  if (req.method === 'OPTIONS') {
+    res.writeHead(204, cors)
+    res.end()
+    return
+  }
+  let body = ''
+  req.on('data', (chunk) => {
+    body += chunk
+    if (body.length > 200000) req.destroy()
+  })
+  req.on('end', () => {
+    const line = `${new Date().toISOString()}\t${req.method}\t${req.url}\t${body.replace(/[\r\n]+/g, '\\n')}\n`
+    try { appendFileSync(LOG, line) } catch (error) { console.error('append failed', error) }
+    if (req.url !== '/ping') process.stdout.write(line)
+    res.writeHead(200, { ...cors, 'Content-Type': 'text/plain' })
+    res.end('ok')
+  })
+}).listen(PORT, '127.0.0.1', () => {
+  console.log(`diag sink listening on http://127.0.0.1:${PORT}/  -> ${LOG}`)
+  console.log('插件里对应的常量：const DIAG_URL = `http://127.0.0.1:${PORT}/dsh-quote-pro`')
+})