dsh-one-click-polish 1.2.0 → 1.2.2

package/README.md

@@ -1,11 +1,20 @@
 # 一键润色 / 扩写 / 自动驾驶
 
+[![npm](https://img.shields.io/npm/v/dsh-one-click-polish?label=npm)](https://www.npmjs.com/package/dsh-one-click-polish)
+[![license](https://img.shields.io/npm/l/dsh-one-click-polish)](LICENSE)
+
 给 DeepSeek Harness（dsh）桌面端的输入框加一组动作：**润色**、**扩写**、**自动驾驶**。所有模型调用都用**你当前会话正在用的那个模型**，结果直接写回输入框。
 
 - 润色：按三档深度重写草稿
 - 扩写：把一句话扩写成能直接开工的需求说明
 - 自动驾驶：让 AI 读对话、写下一步提示词、发给助手，一轮接一轮推进到你设定的目标
 
+一句安装：
+
+```
+dsh-one-click-polish
+```
+
 装好之后，输入框左下角多一排按钮：
 
 ```
@@ -26,15 +35,40 @@
 
 ## 安装
 
-### 界面里装（最省事）
+两种来源，功能完全一样：
+
+| 来源 | 填什么 | 更新按钮 |
+| --- | --- | --- |
+| **npm** | `dsh-one-click-polish` | ✅ 有「可更新」 |
+| GitHub | `https://github.com/HTRP1486/dsh-one-click-polish` | ❌ 只能看提交 |
+
+### 方式一：npm（推荐）
 
-打开 dsh → 设置 → 插件 → 添加插件，在输入框里粘这个：
+打开 dsh → 设置 → 插件 → 添加插件，输入框里就填**包名**：
+
+```
+dsh-one-click-polish
+```
+
+不用加 `npm:` 前缀，也不用加版本号（默认装 `latest`）。
+
+命令行等价写法：
+
+```bash
+dsh plugin --profile <你的 profile 名> install dsh-one-click-polish
+```
+
+**为什么推荐这个**：npm 上有版本号，dsh 能比对，所以插件列表里会出现「可更新」和「卸载」两个按钮。缺点是更新要走一遍发布流程。
+
+### 方式二：GitHub
+
+输入框里填仓库地址：
 
 ```
 https://github.com/HTRP1486/dsh-one-click-polish
 ```
 
-下面这些写法等价，都行：
+等价写法都行：
 
 ```
 https://github.com/HTRP1486/dsh-one-click-polish
@@ -44,23 +78,35 @@ github:HTRP1486/dsh-one-click-polish
 
 **末尾不要加斜杠**。加了会报 `a URL must point at a git repository or a tarball` —— dsh 的判断规则是 `^https?://主机/用户/仓库(.git)?$`，最后一段不允许出现 `/`。
 
-### 命令行装
-
-```bash
-dsh plugin --profile <你的 profile 名> install github:HTRP1486/dsh-one-click-polish
-```
-
-不知道 profile 名的话，看你 `~/.dsh/profiles/` 下的目录名，常见的是 `desktop`。
+**为什么用它**：跟最新提交走，不用等发版。但没有「可更新」按钮——想更新就是重装一次（`remove` 后 `install`）。
 
 ### 其他方式
 
 | 方式 | 做法 |
 | --- | --- |
-| 本地目录 | target 填仓库的**绝对路径**，如 `D:\Documents\dsh-one-click-polish`（相对路径会被拒绝） |
+| 本地目录 | target 填仓库的**绝对路径**，如 `D:\Documents\dsh-one-click-polish`。改代码即时生效，适合开发 |
 | Release 包 | 从 [Releases](https://github.com/HTRP1486/dsh-one-click-polish/releases) 下 `.tgz`，target 填该文件的绝对路径 |
 
+### 三种方式怎么选
+
+```
+只想用        → npm
+要用最新代码   → GitHub
+自己在改它     → 本地目录（link）
+```
+
 装完**重启 dsh**。判断是否成功：输入框左下角出现 `润色 | 深度 | 扩写 | 自动`，设置里多出「润色 / 扩写」一页。
 
+### 版本号
+
+三个地方保持同步，每次发布一起改：
+
+| 位置 | 当前 |
+| --- | --- |
+| `package.json` 的 `version` | `1.2.0` |
+| npm 的 `latest` 标签 | `1.2.0` |
+| GitHub 的 tag / Release | `v1.2.0` |
+
 ### 装不上时
 
 | 报错 | 原因 |

package/client.js

@@ -41,6 +41,7 @@ window.__ModuleLoader__.load({
     const PROGRESS = ENDPOINT.replace(/\/polish$/, '/progress')
     const PILOT = ENDPOINT.replace(/\/polish$/, '/autopilot')
     const RUNS = ENDPOINT.replace(/\/polish$/, '/runs')
+    const VERSION = ENDPOINT.replace(/\/polish$/, '/version')
 
     /** The in-flight request, so the panel can cancel it. */
     let activeAbort = null
@@ -253,8 +254,8 @@ window.__ModuleLoader__.load({
         'auto.warn.body': '启动后 AI 会自动往这个会话里发送消息：读对话 → 写下一步提示词 → 发给助手，一轮接一轮。它会消耗模型额度，也可能做出你没想到的改动。随时可以中断或结束循环。',
         'auto.warn.cancel': '再想想',
         'auto.warn.confirm': '确认启动',
-        'auto.interrupt': '跳过这一轮',
-        'auto.interrupt.hint': '取消助手正在做的这一轮，循环继续，它会重新判断下一步。',
+        'auto.interrupt': '跳过这一轮',
+        'auto.interrupt.hint': '取消助手正在做的这一轮，循环继续，它会重新判断下一步。',
         'auto.stop.hint': '整个自动驾驶停下。之后可以从这里继续。',
         'auto.stop': '停止自动',
         'auto.running': '运行中',
@@ -281,6 +282,13 @@ window.__ModuleLoader__.load({
         'settings.idleWait': '等待助手完成上一轮的上限',
         'settings.idleWait.hint': '自动驾驶要发下一条时，如果助手还在处理，它会等。超过这个上限就先停下，点「继续」可以接着来。长会话需要更长的时间。',
         'settings.idleWait.unit': '分钟',
+        'version.current': '当前版本',
+        'version.latest': '已是最新',
+        'version.newest': 'npm 上有',
+        'version.checking': '检查更新中…',
+        'version.unknown': '查不到最新版本',
+        'version.how': '怎么更新',
+        'version.recheck': '重新检查',
         'settings.explore': '检索预算',
         'settings.explore.hint': '标准/深度润色时会先查资料。这是查资料总共能用多久、最多查几轮。查完后再改写，两者互不占用。',
         'settings.explore.unit': '秒',
@@ -412,8 +420,8 @@ window.__ModuleLoader__.load({
         'auto.warn.body': 'The AI will send messages into this conversation by itself: read the history, write the next prompt, send it, round after round. It spends model quota and may change things you did not expect. You can interrupt or end the loop at any time.',
         'auto.warn.cancel': 'Not now',
         'auto.warn.confirm': 'Start',
-        'auto.interrupt': 'Skip this round',
-        'auto.interrupt.hint': 'Cancel the turn the assistant is running. The loop stays alive and re-plans the next step.',
+        'auto.interrupt': 'Skip this round',
+        'auto.interrupt.hint': 'Cancel the turn the assistant is running. The loop stays alive and re-plans the next step.',
         'auto.stop.hint': 'End the autopilot. You can continue from here afterwards.',
         'auto.stop': 'Stop autopilot',
         'auto.running': 'Running',
@@ -440,6 +448,13 @@ window.__ModuleLoader__.load({
         'settings.idleWait': 'How long to wait for the assistant',
         'settings.idleWait.hint': 'When the loop is ready to send but the assistant is still working, it waits. Past this limit it parks, and Continue picks it up again. Long conversations need more time.',
         'settings.idleWait.unit': 'minutes',
+        'version.current': 'Version',
+        'version.latest': 'Up to date',
+        'version.newest': 'npm has',
+        'version.checking': 'Checking for updates…',
+        'version.unknown': 'Cannot reach npm',
+        'version.how': 'How to update',
+        'version.recheck': 'Check again',
         'settings.explore': 'Lookup budget',
         'settings.explore.hint': 'A standard or deep polish looks things up first. This is how long that may take in total, and how many rounds it may spend. The rewrite runs separately with its own budget.',
         'settings.explore.unit': 's',
@@ -564,6 +579,21 @@ window.__ModuleLoader__.load({
 .dsh-op-head{margin-bottom:18px}
 .dsh-op-h2{margin:0 0 4px;font-size:17px;font-weight:600;line-height:26px;letter-spacing:-.01em}
 .dsh-op-sub{margin:0;color:var(--dsw-alias-label-secondary);font-size:12.5px;line-height:20px}
+/* Version line: this plugin's own update affordance. dsh's plugin page only
+   computes installTarget for bundles in its official catalogue, so a third-party
+   plugin has no update button there. */
+.dsh-op-version{display:flex;flex-wrap:wrap;align-items:center;gap:8px;margin-top:9px;
+  font-size:11.5px;line-height:17px;color:var(--dsw-alias-label-secondary)}
+.dsh-op-versionNow{font-variant-numeric:tabular-nums;
+  font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;
+  background:var(--dsw-alias-bg-base);border-radius:999px;padding:1px 8px;
+  color:var(--dsw-alias-label-primary)}
+.dsh-op-versionNew{display:flex;flex-wrap:wrap;align-items:center;gap:8px;
+  font-size:11.5px;color:var(--dsw-alias-state-warn-primary)}
+.dsh-op-versionBad{color:var(--dsw-alias-label-tertiary,var(--dsw-alias-label-secondary));opacity:.8}
+/* The busy-wait line: a live counter, so it is monospaced and does not reflow as
+   the seconds tick, and it holds a fixed height so the panel does not jump. */
+.dsh-op-waiting{font-variant-numeric:tabular-nums;min-height:17px}
 .dsh-op-card{display:flex;flex-direction:column;gap:2px;padding:2px 16px;
   background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);
   border-radius:14px}
@@ -2266,6 +2296,8 @@ window.__ModuleLoader__.load({
       const [form, setForm] = useState(null)     // what the user is editing
       const [efforts, setEfforts] = useState({ state: 'idle', list: [], defaultEffort: null })
       const [saveState, setSaveState] = useState({ state: 'idle', message: '' })
+      // null while the first lookup is in flight; afterwards { current, latest, error }
+      const [version, setVersion] = useState(null)
       const [runs, setRuns] = useState([])
       const [runsPick, setRunsPick] = useState(null)
       const [runEntries, setRunEntries] = useState([])
@@ -2317,6 +2349,24 @@ window.__ModuleLoader__.load({
 
       useEffect(() => { load() }, [load])
 
+      /** Read this plugin's version against npm. Cached on the Host for 10 minutes. */
+      const checkVersion = useCallback(async (force) => {
+        try {
+          const response = await fetch(force === true ? `${VERSION}?refresh=1` : VERSION)
+          const payload = await response.json()
+          if (payload?.ok !== true) throw new Error(payload?.error ?? 'HTTP error')
+          setVersion({
+            current: typeof payload.current === 'string' ? payload.current : '',
+            latest: typeof payload.latest === 'string' ? payload.latest : null,
+            error: typeof payload.error === 'string' ? payload.error : null,
+          })
+        } catch (failure) {
+          setVersion({ current: '', latest: null, error: String(failure?.message ?? failure) })
+        }
+      }, [])
+
+      useEffect(() => { void checkVersion(false) }, [checkVersion])
+
       /** Sessions that have an archived run, newest first. */
       const loadRuns = useCallback(async () => {
         try {
@@ -2462,7 +2512,35 @@ window.__ModuleLoader__.load({
       const pageBody = h('div', { className: 'dsh-op-page' },
         h('div', { className: 'dsh-op-head' },
           h('h2', { className: 'dsh-op-h2' }, t('settings.title')),
-          h('p', { className: 'dsh-op-sub' }, t('settings.sub'))),
+          h('p', { className: 'dsh-op-sub' }, t('settings.sub')),
+          // dsh's own plugin page can only offer 更新 for bundles in its official
+          // catalogue, so a third-party plugin gets no update affordance there.
+          // The version line puts that question here instead.
+          h('div', { className: 'dsh-op-version' },
+            h('span', { className: 'dsh-op-versionNow' },
+              `${t('version.current')} ${version.current === '' ? '?' : version.current}`),
+            version === null
+              ? h('span', { className: 'dsh-op-hint dsh-op-hint--inline' }, t('version.checking'))
+              : version.error !== null && version.error !== ''
+                ? h('span', { className: 'dsh-op-versionBad' },
+                  `${t('version.unknown')} · ${version.error}`)
+                : version.latest === null
+                  ? h('span', { className: 'dsh-op-hint dsh-op-hint--inline' }, t('version.unknown'))
+                  : version.latest !== version.current
+                    ? h('div', { className: 'dsh-op-versionNew' },
+                      h('span', null, `${t('version.newest')} ${version.latest}`),
+                      h('a', {
+                        className: 'dsh-op-link',
+                        href: 'https://www.npmjs.com/package/dsh-one-click-polish',
+                        target: '_blank',
+                        rel: 'noreferrer',
+                      }, t('version.how')),
+                      h('button', {
+                        type: 'button',
+                        className: 'dsh-op-link',
+                        onClick: () => { void checkVersion(true) },
+                      }, t('version.recheck')))
+                    : h('span', { className: 'dsh-op-hint dsh-op-hint--inline' }, t('version.latest')))),
         h('div', { className: 'dsh-op-card' },
           h('div', { className: 'dsh-op-cardTitle' }, t('settings.group.model')),
           h('div', { className: 'dsh-op-field' },

package/index.js

@@ -23,7 +23,8 @@ export const name = 'one-click-polish'
 export const inject = ['llm', 'agents', 'webServer']
 
 import { existsSync, readFileSync, writeFileSync } from 'node:fs'
-import { join } from 'node:path'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
 
 const PREFIX = '/plugins/dsh-one-click-polish'
 const DEFAULT_MAX_INPUT_CHARS = 12000
@@ -466,6 +467,61 @@ async function produceRewrite(ctx, settings, mode, strength, research, input, ag
   return text
 }
 
+/**
+ * This plugin's own version, and the newest one on npm.
+ *
+ * dsh's plugin page only offers an update button for bundles in its official
+ * catalogue, because `installTarget` is computed from that catalogue. A third-party
+ * plugin therefore has no update affordance there at all, so the question "is there
+ * a newer version?" is answered here instead, on the plugin's own settings page.
+ */
+const VERSION_TTL_MS = 10 * 60 * 1000
+let versionCache = { at: 0, latest: null, error: null }
+
+async function versionInfo() {
+  let current = ''
+  try {
+    // Resolve from this module rather than the process cwd: the Host may run with
+    // any working directory, and this file sits next to its own manifest.
+    const here = dirname(fileURLToPath(import.meta.url))
+    const manifest = JSON.parse(readFileSync(join(here, 'package.json'), 'utf8'))
+    current = typeof manifest.version === 'string' ? manifest.version : ''
+  } catch { /* a missing manifest just means no version to report */ }
+
+  if (versionCache.latest !== null && Date.now() - versionCache.at < VERSION_TTL_MS) {
+    return { current, latest: versionCache.latest, error: null, checked: versionCache.at }
+  }
+
+  // The registry is the only source of truth for "what is published"; a failed
+  // lookup must not look like "you are up to date".
+  let latest = null
+  let error = null
+  try {
+    const controller = new AbortController()
+    const timer = setTimeout(() => controller.abort(), 8000)
+    const response = await fetch('https://registry.npmjs.org/dsh-one-click-polish/latest', {
+      signal: controller.signal,
+      headers: { accept: 'application/json' },
+    })
+    clearTimeout(timer)
+    if (!response.ok) throw new Error(`HTTP ${response.status}`)
+    const payload = await response.json()
+    latest = typeof payload?.version === 'string' ? payload.version : null
+  } catch (failure) {
+    error = textOf(failure)
+  }
+  versionCache = { at: Date.now(), latest, error }
+  return { current, latest, error, checked: Date.now() }
+}
+
+async function versionRoute(req, res) {
+  // `refresh=1` drops the TTL cache: the panel offers a recheck, and a button that
+  // silently answers from cache would look broken.
+  const url = new URL(req.url ?? '/', 'http://localhost')
+  if (url.searchParams.get('refresh') === '1') versionCache.at = 0
+  sendJson(res, 200, { ok: true, ...(await versionInfo()) })
+}
+
 async function statusRoute(ctx, req, res) {
   const url = new URL(req.url ?? '/', 'http://localhost')
   const sessionId = url.searchParams.get('sessionId') ?? undefined
@@ -2466,6 +2522,13 @@ export function apply(ctx, config) {
   })
 
 
+  ctx.effect(() => server.register({
+    kind: 'exact',
+    path: `${PREFIX}/version`,
+    handler: (req, res) => versionRoute(req, res)
+      .catch(error => sendJson(res, 500, { ok: false, error: textOf(error) })),
+  }), 'one-click-polish: version route')
+
   ctx.effect(() => server.register({
     kind: 'exact',
     path: `${PREFIX}/status`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-one-click-polish",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "One-click polish, expand and autopilot for the DeepSeek Harness composer: rewrite the draft with the model the session is switched to, expand a one-line wish into a task brief, or let an AI drive a goal round after round.",
   "keywords": [
     "dsh",