dsh-plan-completion 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -3,6 +3,33 @@
 All notable changes to this project are documented here.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning: SemVer.
 
+## [0.1.6] - 2026-11-02
+
+### Added
+- Model settings page registered at `settings.plugins.tab` (Settings → Plugins → 计划补全):
+  radio group for `default` / `fixed` / `auto` model policy, Provider/Model ID inputs for fixed
+  mode, a `modelCalls` toggle, current host-default route hint, and save/status feedback.
+- Host settings route `GET/POST /plan-completion/settings` (authenticated) persists the policy to
+  `<storageDir>/settings.json` and loads it on apply; `pickModel` honours `default`/`fixed`/`auto`.
+- Client transport test for the settings page (GET/POST, failure handling).
+- Dev-only suggestion log lives outside the release: `research/suggestion-log-local/` keeps a local
+  copy for tuning; the published plugin does not contain or enable suggestion-content logging.
+
+### Changed
+- `npm test` now reports **138/138** tests.
+
+## [0.1.5] - 2026-11-02
+
+### Fixed
+- Detect a plan that stopped tracking the conversation: after **two consecutive `op=none`**
+  generation outcomes (e.g. an edited plan whose coarse step needs splitting), the published
+  suggestion becomes `/replan 按最近进展重排计划，把已完成项标记完成` and the plan is marked
+  stale, so the user can fix the plan with one Tab fill instead of seeing a repeated stale hint.
+- `/reset` and forced `/replan` clear the none-streak counter.
+
+### Changed
+- `npm test` now reports **133/133** tests.
+
 ## [0.1.4] - 2026-11-02
 
 ### Fixed
@@ -124,3 +151,4 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning: Se
 - Debug endpoints (`theme`, `experiment`, `autojob`, `steps`, `reset`) are only registered when
   `enableDebugRoutes: true`; production endpoints are `state`, `debug`, `diag`, `replan`, `warm`.
 - No credentials are stored in the plugin; model calls use the host `llm` service.
+

package/client.js

@@ -105,7 +105,22 @@ window.__ModuleLoader__.load({
         'verify.clean': '未发现明显差异。',
         'verify.next': '建议：{value}',
         'verify.failed': '核对失败：{value}',
-        'verify.no-session': '当前还没有可用会话'
+        'verify.no-session': '当前还没有可用会话',
+        'settings.title': '计划补全',
+        'settings.model': '模型选择',
+        'settings.policy.default': '跟随宿主默认',
+        'settings.policy.fixed': '固定模型',
+        'settings.policy.auto': '自动（优先非推理）',
+        'settings.provider': 'Provider',
+        'settings.modelId': 'Model ID',
+        'settings.modelCalls': '允许本插件调用模型',
+        'settings.defaultRoute': '宿主默认：{value}',
+        'settings.save': '保存',
+        'settings.saving': '保存中…',
+        'settings.saved': '已保存',
+        'settings.loading': '加载中…',
+        'settings.error': '设置加载失败',
+        'settings.saveError': '保存失败'
       },
       en: {
         'entry.aria': 'Open the session plan panel',
@@ -148,7 +163,22 @@ window.__ModuleLoader__.load({
         'verify.clean': 'No obvious mismatches found.',
         'verify.next': 'Next: {value}',
         'verify.failed': 'Verification failed: {value}',
-        'verify.no-session': 'No session available yet'
+        'verify.no-session': 'No session available yet',
+        'settings.title': 'Plan Completion',
+        'settings.model': 'Model selection',
+        'settings.policy.default': 'Follow host default',
+        'settings.policy.fixed': 'Fixed model',
+        'settings.policy.auto': 'Auto (prefer non-reasoning)',
+        'settings.provider': 'Provider',
+        'settings.modelId': 'Model ID',
+        'settings.modelCalls': 'Allow this plugin to call models',
+        'settings.defaultRoute': 'Host default: {value}',
+        'settings.save': 'Save',
+        'settings.saving': 'Saving…',
+        'settings.saved': 'Saved',
+        'settings.loading': 'Loading…',
+        'settings.error': 'Failed to load settings',
+        'settings.saveError': 'Save failed'
       }
     };
 
@@ -787,6 +817,52 @@ window.__ModuleLoader__.load({
         });
     }
 
+    /**
+     * Host settings used by the settings page (model policy + modelCalls).
+     */
+    function fetchSettings() {
+      try {
+        return Promise.resolve(fetch('/plan-completion/settings', {
+          method: 'GET',
+          credentials: 'same-origin',
+          headers: { accept: 'application/json' }
+        }))
+          .then(function readResponse(response) {
+            return response && response.ok === true ? Promise.resolve(response.json()) : null;
+          })
+          .then(function parsed(json) {
+            return json && typeof json === 'object' ? json : null;
+          })
+          .catch(function networkError() {
+            return null;
+          });
+      } catch (error) {
+        return Promise.resolve(null);
+      }
+    }
+
+    function saveSettings(payload) {
+      try {
+        return Promise.resolve(fetch('/plan-completion/settings', {
+          method: 'POST',
+          credentials: 'same-origin',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify(payload || {})
+        }))
+          .then(function readResponse(response) {
+            return response && response.ok === true ? Promise.resolve(response.json()) : null;
+          })
+          .then(function parsed(json) {
+            return json && typeof json === 'object' ? json : null;
+          })
+          .catch(function networkError() {
+            return null;
+          });
+      } catch (error) {
+        return Promise.resolve(null);
+      }
+    }
+
     /**
      * P0 boundary: read the current plan state. Keep this signature stable —
      * swapping the transport (HTTP route / projection / wire view) only changes
@@ -2055,6 +2131,184 @@ window.__ModuleLoader__.load({
       );
     }
 
+    // =====================================================================
+    // Settings page (settings.plugins.tab)
+    // =====================================================================
+    const SETTINGS_SLOT = 'settings.plugins.tab';
+    const SETTINGS_ID = 'plan-completion-settings';
+    const SETTINGS_ORDER = 60;
+
+    function settingsCss() {
+      return [
+        '.dpc-settings-panel{display:flex;flex-direction:column;gap:14px;padding:16px 18px;font-size:13px;line-height:20px;color:var(--dsw-alias-label-primary);max-width:560px}',
+        '.dpc-settings-title{font-size:15px;font-weight:600;line-height:24px}',
+        '.dpc-settings-group{display:flex;flex-direction:column;gap:8px}',
+        '.dpc-settings-label{font-size:12px;color:var(--dsw-alias-label-tertiary)}',
+        '.dpc-settings-radio{display:flex;align-items:center;gap:8px;cursor:pointer}',
+        '.dpc-settings-fixed{display:flex;gap:8px;padding:8px 0 0 24px;flex-wrap:wrap}',
+        '.dpc-settings-input{flex:1 1 180px;min-width:140px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:5px 10px;font-size:12px;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-bg-layer-1));color:var(--dsw-alias-label-primary)}',
+        '.dpc-settings-check{display:flex;align-items:center;gap:8px;cursor:pointer}',
+        '.dpc-settings-hint{font-size:11px;color:var(--dsw-alias-label-tertiary)}',
+        '.dpc-settings-error{font-size:12px;color:var(--dsw-alias-state-error-primary,var(--dsw-alias-label-secondary))}',
+        '.dpc-settings-save{align-self:flex-start;border:1px solid var(--dsw-alias-border-l1);border-radius:999px;padding:5px 14px;font-size:12px;line-height:18px;cursor:pointer;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-bg-layer-1));color:var(--dsw-alias-label-primary)}',
+        '.dpc-settings-save:disabled{opacity:.5;cursor:default}',
+        '.dpc-settings-status{padding:16px 18px;font-size:13px;color:var(--dsw-alias-label-secondary)}'
+      ].join('\n');
+    }
+
+    function PlanSettingsPage(props) {
+      const t = makeT(props);
+      const [settings, setSettings] = React.useState(null);
+      const [status, setStatus] = React.useState('loading');
+      const [saving, setSaving] = React.useState(false);
+      const [error, setError] = React.useState('');
+      const [saved, setSaved] = React.useState(false);
+
+      React.useEffect(function loadSettings() {
+        let alive = true;
+        fetchSettings().then(function applySettings(result) {
+          if (!alive) return;
+          if (!result || result.ok !== true || !result.settings) {
+            setStatus('error');
+            return;
+          }
+          setSettings(result.settings);
+          setStatus('ready');
+        });
+        return function cleanup() {
+          alive = false;
+        };
+      }, []);
+
+      function patch(next) {
+        setSaved(false);
+        setSettings(function keep(previous) {
+          return previous ? { ...previous, ...next } : previous;
+        });
+      }
+
+      function save() {
+        if (!settings || saving) return;
+        setSaving(true);
+        setError('');
+        saveSettings({
+          modelPolicy: settings.modelPolicy,
+          fixedProvider: settings.fixedProvider || '',
+          fixedModel: settings.fixedModel || '',
+          modelCalls: settings.modelCalls === true
+        }).then(function applied(result) {
+          setSaving(false);
+          if (!result || result.ok !== true) {
+            const detail = result && typeof result.error === 'string' ? result.error : '';
+            setError(detail ? t('settings.saveError') + ': ' + detail : t('settings.saveError'));
+            return;
+          }
+          setSettings(result.settings || settings);
+          setSaved(true);
+          setError('');
+        });
+      }
+
+      const styleTag = h('style', { key: 'style', 'data-plan-completion-style': 'settings' }, settingsCss());
+
+      if (status === 'loading') {
+        return h(React.Fragment, null, styleTag, h('div', { key: 'loading', className: 'dpc-settings-status' }, t('settings.loading')));
+      }
+      if (status === 'error' || !settings) {
+        return h(
+          React.Fragment,
+          null,
+          styleTag,
+          h('div', { key: 'error', className: 'dpc-settings-status dpc-settings-error' }, t('settings.error'))
+        );
+      }
+
+      const policies = [
+        { value: 'default', label: t('settings.policy.default') },
+        { value: 'fixed', label: t('settings.policy.fixed') },
+        { value: 'auto', label: t('settings.policy.auto') }
+      ];
+      const defaultRoute = settings.defaultSelection
+        ? settings.defaultSelection.provider + '/' + settings.defaultSelection.model
+        : '-';
+
+      return h(
+        React.Fragment,
+        null,
+        styleTag,
+        h(
+          'div',
+          { key: 'panel', className: 'dpc-settings-panel' },
+          h('div', { key: 'title', className: 'dpc-settings-title' }, t('settings.title')),
+          h(
+            'div',
+            { key: 'model', className: 'dpc-settings-group' },
+            h('div', { key: 'label', className: 'dpc-settings-label' }, t('settings.model')),
+            ...policies.map(function renderPolicy(option) {
+              return h(
+                'label',
+                { key: 'policy-' + option.value, className: 'dpc-settings-radio' },
+                h('input', {
+                  type: 'radio',
+                  name: 'dpc-model-policy',
+                  value: option.value,
+                  checked: settings.modelPolicy === option.value,
+                  onChange: function onPolicy() {
+                    patch({ modelPolicy: option.value });
+                  }
+                }),
+                h('span', null, option.label)
+              );
+            }),
+            h('div', { key: 'hint', className: 'dpc-settings-hint' }, t('settings.defaultRoute', { value: defaultRoute })),
+            settings.modelPolicy === 'fixed'
+              ? h(
+                  'div',
+                  { key: 'fixed', className: 'dpc-settings-fixed' },
+                  h('input', {
+                    key: 'provider',
+                    className: 'dpc-settings-input',
+                    placeholder: t('settings.provider'),
+                    value: settings.fixedProvider || '',
+                    onChange: function onProvider(event) {
+                      patch({ fixedProvider: event.target.value });
+                    }
+                  }),
+                  h('input', {
+                    key: 'model',
+                    className: 'dpc-settings-input',
+                    placeholder: t('settings.modelId'),
+                    value: settings.fixedModel || '',
+                    onChange: function onModel(event) {
+                      patch({ fixedModel: event.target.value });
+                    }
+                  })
+                )
+              : null
+          ),
+          h(
+            'label',
+            { key: 'calls', className: 'dpc-settings-check' },
+            h('input', {
+              type: 'checkbox',
+              checked: settings.modelCalls === true,
+              onChange: function onCalls(event) {
+                patch({ modelCalls: event.target.checked });
+              }
+            }),
+            h('span', null, t('settings.modelCalls'))
+          ),
+          error ? h('div', { key: 'error', className: 'dpc-settings-error' }, error) : null,
+          saved && !error ? h('div', { key: 'saved', className: 'dpc-settings-hint' }, t('settings.saved')) : null,
+          h(
+            'button',
+            { key: 'save', type: 'button', className: 'dpc-settings-save', disabled: saving, onClick: save },
+            saving ? t('settings.saving') : t('settings.save')
+          )
+        )
+      );
+    }
+
     // =====================================================================
     // Plugin entry
     // =====================================================================
@@ -2090,6 +2344,13 @@ window.__ModuleLoader__.load({
           return ctx.slots.register({ name: OVERLAY_SLOT, id: OVERLAY_ID, order: OVERLAY_ORDER }, PlanPopover);
         });
 
+        ctx.slots.inject(SETTINGS_SLOT, function registerSettingsPage() {
+          return ctx.slots.register(
+            { name: SETTINGS_SLOT, id: SETTINGS_ID, order: SETTINGS_ORDER, label: '计划补全' },
+            PlanSettingsPage
+          );
+        });
+
         ctx.effect(function installKeyboard() {
           if (typeof window === 'undefined') return undefined;
           const onKeyDown = function onKeyDown(event) {

package/cordis.patch.yml

@@ -1,16 +1,16 @@
-- insert:
-    - id: plan-completion
-      name: 'dsh-plan-completion'
-      config:
-        evidenceChars: 1500
-        maxTokensPatch: 400
-        maxTokensRewrite: 1200
-        warmBackfill: true
-        modelCalls: true # false: heuristic-only; no plugin model requests
-        # Plans + last suggestion are persisted per session so a DSH restart restores the UI.
-        persistPlans: true
-        storageDir: '~/.dsh/plan-completion-data'
-        # Debug endpoints (debug/diag/theme/experiment/autojob/steps/reset) stay off in production.
-        enableDebugRoutes: false
-        # Optional: set a local directory to persist debug logs / experiment data.
-        # debugDir: '<local debug directory>'
+- insert:
+    - id: plan-completion
+      name: 'dsh-plan-completion'
+      config:
+        evidenceChars: 1500
+        maxTokensPatch: 400
+        maxTokensRewrite: 1200
+        warmBackfill: true
+        modelCalls: true # false: heuristic-only; no plugin model requests
+        # Plans + last suggestion are persisted per session so a DSH restart restores the UI.
+        persistPlans: true
+        storageDir: '~/.dsh/plan-completion-data'
+        # Debug endpoints (debug/diag/theme/experiment/autojob/steps/reset) stay off in production.
+        enableDebugRoutes: false
+        # Optional: set a local directory to persist debug logs / experiment data.
+        # debugDir: '<local debug directory>'

package/docs/publish-assessment.md

@@ -1,7 +1,11 @@
 # GitHub 发布评估 · 会话计划补全插件（2026-11-02）
 
-> 历史文档：以下保留 v0.1.0 的交付/评估/计划记录。**当前最新为 v0.1.3**（核对进度 + 本地计划持久化 + 鉴权/状态一致性/隐私边界修复），详见 [security.md](security.md) 与 [CHANGELOG](../CHANGELOG.md)；旧记录中的“无鉴权”、原始诊断字段与独立评审不代表当前实现。
+> 历史文档：以下保留 v0.1.0 的交付/评估/计划记录。**当前最新为 v0.1.5**（计划停更检测 + 建议文本保真 + 核对进度 + 本地计划持久化 + 鉴权/状态一致性/隐私边界修复），详见 [security.md](security.md) 与 [CHANGELOG](../CHANGELOG.md)；旧记录中的“无鉴权”、原始诊断字段与独立评审不代表当前实现。
 >
+> v0.1.5 发布记录（2026-11-02）：计划停更检测——连续 2 次 op=none 后建议变为 `/replan …` 并标记 stale。tag `v0.1.5` + [Release](https://github.com/Xumi0920/dsh-plan-completion/releases/tag/v0.1.5)；Actions [run 41391402601](https://github.com/Xumi0920/dsh-plan-completion/actions/runs/41391402601)（四 job 全绿，133/133 tests）；npm `dsh-plan-completion@0.1.5`（shasum `c53c6d7ef79d8634913054db79fa9e5b1e86b182`）。
+>
+> v0.1.4 发布记录（2026-11-02）：建议文本保真修复（标识符/路径/命令保留 + 语义化截断）。tag `v0.1.4` + [Release](https://github.com/Xumi0920/dsh-plan-completion/releases/tag/v0.1.4)；GitHub Actions [run 41389845733](https://github.com/Xumi0920/dsh-plan-completion/actions/runs/41389845733)（四 job 全绿，132/132 tests）；npm `dsh-plan-completion@0.1.4`（31 files，shasum `a6f8953445e330081243f9f9d6b429fd4402b341`）。
+>
 > v0.1.3 发布记录（2026-11-02）：tag `v0.1.3` + [Release](https://github.com/Xumi0920/dsh-plan-completion/releases/tag/v0.1.3)；GitHub Actions [run 41368609382](https://github.com/Xumi0920/dsh-plan-completion/actions/runs/41368609382)（Ubuntu/Windows × Node20/22 四 job 全绿，126/126 tests）；npm `dsh-plan-completion@0.1.3`（31 files，shasum `11adee0fe9acff199a180be511ca8bc600afdf6f`）；canary 验证 `/plan-completion/verify` 未认证 401、客户端鉴权请求正常。
 >
 > v0.1.1 发布记录（2026-11-02）：tag `v0.1.1` + [Release](https://github.com/Xumi0920/dsh-plan-completion/releases/tag/v0.1.1)；GitHub Actions [run 41366651557](https://github.com/Xumi0920/dsh-plan-completion/actions/runs/41366651557)（Ubuntu/Windows × Node20/22 四 job 全绿）；npm `dsh-plan-completion@0.1.1`（31 files，shasum `18989b0f50b72d5c8c332f3fdee7f43ccb5fd91a`）。
@@ -105,3 +109,5 @@ git tag v0.1.0 && git push --tags
 > 建议：**先把 P0 B1~B8 全部打勾，再公开仓库**；否则许可证与数据问题会成为不可逆的历史提交。
 
 
+
+

package/index.js

@@ -11,7 +11,7 @@
  * The Client half only talks to this half through `/plan-completion/*`
  * (verified contract: same-origin fetch from the Electron page works and the body is readable).
  */
-import { appendFileSync, mkdirSync, writeFileSync } from 'node:fs'
+import { appendFileSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 
 import { DEFAULTS } from './host/config.js'
@@ -63,6 +63,38 @@ function expandStorageDir(value, envValue) {
   return raw
 }
 
+const MODEL_POLICIES = new Set(['default', 'fixed', 'auto'])
+
+function normalizeModelPolicy(value) {
+  const policy = typeof value === 'string' ? value.trim() : ''
+  return MODEL_POLICIES.has(policy) ? policy : 'default'
+}
+
+/** Settings written through the model-settings page (persisted next to the plan store). */
+function readSavedSettings(dir) {
+  if (!dir) return {}
+  try {
+    const data = JSON.parse(readFileSync(join(dir, 'settings.json'), 'utf8'))
+    return data && typeof data === 'object' && !Array.isArray(data) ? data : {}
+  } catch {
+    return {}
+  }
+}
+
+function writeSavedSettings(dir, data) {
+  if (!dir) return false
+  try {
+    mkdirSync(dir, { recursive: true })
+    const target = join(dir, 'settings.json')
+    const tmp = join(dir, `.settings-${process.pid}-${Date.now()}.json.tmp`)
+    writeFileSync(tmp, `${JSON.stringify(data, null, 2)}\n`, 'utf8')
+    renameSync(tmp, target)
+    return true
+  } catch {
+    return false
+  }
+}
+
 function readJsonBody(req) {
   return new Promise(resolve => {
     let size = 0
@@ -154,11 +186,56 @@ function normalizePromptMessages(prompt) {
 /**
  * Use the user's current default route only. Never send session evidence to
  * another configured provider/model just because it may respond faster.
+ *
+ * v0.1.6 model policy:
+ *   default — follow the host's current default model (previous behaviour)
+ *   fixed   — always use `fixedProvider`/`fixedModel` (only if resolvable)
+ *   auto    — within the default provider, prefer a model without reasoning efforts
+ * Without a host default route the generator falls back to heuristics (null).
  */
-async function pickModel(services) {
+async function pickModel(services, policy = null) {
   const llm = services.llm
   const selection = services.agentDefaultModel?.currentSelection?.()
-  if (!llm || !selection?.provider || !selection?.model) return null
+  if (!llm) return null
+  const mode = policy?.modelPolicy === 'fixed' ? 'fixed' : policy?.modelPolicy === 'auto' ? 'auto' : 'default'
+
+  if (mode === 'fixed' && policy?.fixedProvider && policy?.fixedModel) {
+    const route = { provider: policy.fixedProvider, model: policy.fixedModel, source: 'fixed' }
+    try {
+      const info = await llm.resolveModelInfo?.(route.provider, route.model)
+      if (info) {
+        const efforts = info?.reasoning?.efforts
+        if (Array.isArray(efforts) && efforts.length) route.reasoningEffort = efforts[0]?.id
+        return route
+      }
+    } catch {
+      /* fixed route unavailable: fall back to the host default below */
+    }
+  }
+
+  if (!selection?.provider || !selection?.model) return null
+
+  if (mode === 'auto') {
+    try {
+      const models = typeof llm.listModels === 'function' ? await llm.listModels(selection.provider) : []
+      for (const model of Array.isArray(models) ? models : []) {
+        const id = String(model?.id ?? '')
+        if (!id) continue
+        try {
+          const info = await llm.resolveModelInfo?.(selection.provider, id)
+          const efforts = info?.reasoning?.efforts
+          if (!Array.isArray(efforts) || efforts.length === 0) {
+            return { provider: selection.provider, model: id, source: 'auto' }
+          }
+        } catch {
+          /* try the next catalog entry */
+        }
+      }
+    } catch {
+      /* fall back to the host default */
+    }
+  }
+
   const route = { provider: selection.provider, model: selection.model, source: 'session-default' }
   try {
     const info = await llm.resolveModelInfo?.(route.provider, route.model)
@@ -215,7 +292,7 @@ const HOST_GLOBAL_KEY = '__dsh_plan_completion_host__'
  * up with two live handler sets answering different state.
  */
 function hostGlobal() {
-  const fallback = { states: new Map(), sessions: new Map(), handledTurns: new Map(), warmAttempts: new Map(), disposers: [] }
+  const fallback = { states: new Map(), sessions: new Map(), handledTurns: new Map(), warmAttempts: new Map(), noneStreaks: new Map(), disposers: [] }
   if (typeof globalThis === 'undefined') return { ...fallback, store: createMemoryStore() }
   if (!globalThis[HOST_GLOBAL_KEY] || typeof globalThis[HOST_GLOBAL_KEY] !== 'object') {
     globalThis[HOST_GLOBAL_KEY] = fallback
@@ -225,6 +302,7 @@ function hostGlobal() {
   if (!(shared.sessions instanceof Map)) shared.sessions = new Map()
   if (!(shared.handledTurns instanceof Map)) shared.handledTurns = new Map()
   if (!(shared.warmAttempts instanceof Map)) shared.warmAttempts = new Map()
+  if (!(shared.noneStreaks instanceof Map)) shared.noneStreaks = new Map()
   if (!Array.isArray(shared.disposers)) shared.disposers = []
   if (!shared.store || typeof shared.store.get !== 'function' || typeof shared.store.put !== 'function') {
     shared.store = createMemoryStore()
@@ -246,14 +324,19 @@ export function apply(ctx, config = {}) {
     return Math.min(max, Math.max(min, number))
   }
   const rawConfig = config && typeof config === 'object' ? config : {}
+  const storageDir = expandStorageDir(rawConfig.storageDir, process.env.DSH_PLAN_COMPLETION_STORE_DIR)
+  const savedSettings = readSavedSettings(storageDir)
   const settings = {
     evidenceChars: readInt(rawConfig.evidenceChars, 1500, 400, 8000),
     maxTokensPatch: readInt(rawConfig.maxTokensPatch, 400, 120, 4000),
     maxTokensRewrite: readInt(rawConfig.maxTokensRewrite, 1200, 400, 8000),
     warmBackfill: rawConfig.warmBackfill !== false,
-    modelCalls: rawConfig.modelCalls !== false,
+    modelCalls: (typeof savedSettings.modelCalls === 'boolean' ? savedSettings.modelCalls : true) && rawConfig.modelCalls !== false,
+    modelPolicy: normalizeModelPolicy(savedSettings.modelPolicy ?? rawConfig.modelPolicy),
+    fixedProvider: typeof savedSettings.fixedProvider === 'string' ? savedSettings.fixedProvider.trim().slice(0, 120) : '',
+    fixedModel: typeof savedSettings.fixedModel === 'string' ? savedSettings.fixedModel.trim().slice(0, 120) : '',
     persistPlans: rawConfig.persistPlans !== false,
-    storageDir: expandStorageDir(rawConfig.storageDir, process.env.DSH_PLAN_COMPLETION_STORE_DIR),
+    storageDir,
     maxTokensVerify: readInt(rawConfig.maxTokensVerify, DEFAULTS.maxTokensVerify, 200, 2000),
     enableDebugRoutes: rawConfig.enableDebugRoutes === true,
     debugDir: typeof rawConfig.debugDir === 'string' && rawConfig.debugDir.trim() !== ''
@@ -336,6 +419,28 @@ export function apply(ctx, config = {}) {
     }
   }
 
+  function settingsSnapshot() {
+    const selection = services.agentDefaultModel?.currentSelection?.() ?? null
+    let providers = []
+    try {
+      providers = services.llm?.listProviders?.() ?? []
+    } catch {
+      providers = []
+    }
+    return {
+      modelPolicy: settings.modelPolicy,
+      fixedProvider: settings.fixedProvider,
+      fixedModel: settings.fixedModel,
+      modelCalls: settings.modelCalls,
+      defaultSelection: selection && selection.provider && selection.model
+        ? { provider: selection.provider, model: selection.model }
+        : null,
+      providers: Array.isArray(providers)
+        ? providers.map(provider => ({ id: provider?.id ?? '', name: provider?.name ?? provider?.id ?? '' }))
+        : [],
+    }
+  }
+
   function publishState(sessionId, patch) {
     const previous = states.get(sessionId) ?? { plan: null, suggestion: null, stale: false }
     states.set(sessionId, { ...previous, ...patch })
@@ -632,7 +737,7 @@ export function apply(ctx, config = {}) {
           ]
         }
         try {
-          const route = await pickModel(services)
+          const route = await pickModel(services, settings)
           if (!isCurrent()) return
           debug.model = route
           debugLog({ phase: 'model-choice', sessionId, route })
@@ -754,12 +859,22 @@ export function apply(ctx, config = {}) {
       const withinSuggestionDeadline = elapsed <= suggestionDeadline
       const finalSuggestion = withinSuggestionDeadline ? suggestion ?? provisionalSuggestion : provisionalSuggestion
 
+      // A long `op=none` streak means the visible plan stopped tracking the conversation
+      // (edited-by-user plans cannot be rewritten automatically, and one coarse step may need
+      // splitting). Surface an actionable replan suggestion instead of repeating a stale one.
+      const priorNoneStreak = noneStreaks.get(sessionId) ?? 0
+      const nextNoneStreak = force ? 0 : outcome === 'none' && nextPlan ? priorNoneStreak + 1 : 0
+      const replanSuggested = nextNoneStreak >= 2 && Boolean(nextPlan)
+      const publishedSuggestion = replanSuggested
+        ? { text: '/replan 按最近进展重排计划，把已完成项标记完成', alternates: [] }
+        : finalSuggestion
+
       if (nextPlan) {
         try {
           // Check CAS even for an unchanged plan; an old snapshot is never an
           // unconditional write. null also protects the first commit from races.
           // The last suggestion is persisted in the same write so a restart can restore it.
-          const committed = await store.put(nextPlan, { cas: storedVersion, suggestion: finalSuggestion })
+          const committed = await store.put(nextPlan, { cas: storedVersion, suggestion: publishedSuggestion })
           if (!committed) {
             debugLog({ phase: 'store-cas-miss', sessionId })
             const winner = typeof store.getState === 'function'
@@ -779,13 +894,23 @@ export function apply(ctx, config = {}) {
         }
       }
 
+      noneStreaks.set(sessionId, nextNoneStreak)
       publishState(sessionId, {
         plan: nextPlan,
-        suggestion: finalSuggestion,
-        stale: false,
+        suggestion: publishedSuggestion,
+        stale: replanSuggested,
       })
-      debug.lastJob = { sessionId, turn, elapsed, outcome, suggestion: Boolean(suggestion), withinSuggestionDeadline }
-      debugLog({ phase: 'job-done', sessionId, turn, elapsed, outcome, withinSuggestionDeadline })
+      debug.lastJob = {
+        sessionId,
+        turn,
+        elapsed,
+        outcome,
+        suggestion: Boolean(suggestion),
+        withinSuggestionDeadline,
+        noneStreak: nextNoneStreak,
+        replanSuggested,
+      }
+      debugLog({ phase: 'job-done', sessionId, turn, elapsed, outcome, withinSuggestionDeadline, replanSuggested })
     } catch (error) {
       if (!isCurrent()) return
       debugLog({ phase: 'job-failed', sessionId, turn, error: String(error) })
@@ -800,6 +925,7 @@ export function apply(ctx, config = {}) {
 
   // ── Session event subscription: one plan job per completed turn ──────────
   const handledTurns = shared.handledTurns // sessionId -> last handled turn number
+  const noneStreaks = shared.noneStreaks // sessionId -> consecutive op=none outcomes
 
   function triggerTurnEnd(session, seq, turn, source) {
     if (!session?.id || disposed) return
@@ -987,7 +1113,7 @@ export function apply(ctx, config = {}) {
               jsonResponse(res, 200, { ok: false, error: 'in-progress' })
               return
             }
-            const route = await pickModel(services)
+            const route = await pickModel(services, settings)
             if (!route) {
               jsonResponse(res, 200, { ok: false, error: 'no-model-route' })
               return
@@ -1055,6 +1181,54 @@ export function apply(ctx, config = {}) {
             }
             return
           }
+          if (pathname === `${ROUTE_PREFIX}settings` && method === 'GET') {
+            jsonResponse(res, 200, { ok: true, settings: settingsSnapshot() })
+            return
+          }
+          if (pathname === `${ROUTE_PREFIX}settings` && method === 'POST') {
+            const body = (await readJsonBody(req)) ?? {}
+            const next = { ...settingsSnapshot() }
+            if (body.modelPolicy !== undefined) {
+              const policy = normalizeModelPolicy(body.modelPolicy)
+              if (policy !== String(body.modelPolicy).trim()) {
+                jsonResponse(res, 200, { ok: false, error: 'bad-model-policy' })
+                return
+              }
+              next.modelPolicy = policy
+            }
+            if (body.modelCalls !== undefined) {
+              if (typeof body.modelCalls !== 'boolean') {
+                jsonResponse(res, 200, { ok: false, error: 'bad-model-calls' })
+                return
+              }
+              next.modelCalls = body.modelCalls
+            }
+            for (const key of ['fixedProvider', 'fixedModel']) {
+              if (body[key] === undefined) continue
+              if (typeof body[key] !== 'string') {
+                jsonResponse(res, 200, { ok: false, error: 'bad-' + key })
+                return
+              }
+              next[key] = body[key].trim().slice(0, 120)
+            }
+            if (next.modelPolicy === 'fixed' && (!next.fixedProvider || !next.fixedModel)) {
+              jsonResponse(res, 200, { ok: false, error: 'missing-fixed-route' })
+              return
+            }
+            settings.modelPolicy = next.modelPolicy
+            settings.fixedProvider = next.fixedProvider
+            settings.fixedModel = next.fixedModel
+            settings.modelCalls = next.modelCalls
+            const saved = writeSavedSettings(settings.storageDir, {
+              modelPolicy: settings.modelPolicy,
+              fixedProvider: settings.fixedProvider,
+              fixedModel: settings.fixedModel,
+              modelCalls: settings.modelCalls,
+            })
+            debugLog({ phase: 'settings-updated', modelPolicy: settings.modelPolicy, saved })
+            jsonResponse(res, 200, { ok: true, saved, settings: settingsSnapshot() })
+            return
+          }
           if (pathname === `${ROUTE_PREFIX}state` && method === 'GET') {
             const sessionId = url?.searchParams?.get('sessionId') ?? ''
             await hydrateSession(sessionId)
@@ -1161,6 +1335,7 @@ export function apply(ctx, config = {}) {
             states.delete(sessionId)
             warmAttempts.delete(sessionId)
             handledTurns.delete(sessionId)
+            noneStreaks.delete(sessionId)
             debugLog({ phase: 'state-reset', sessionId, existed })
             jsonResponse(res, 200, { ok: true, sessionId, existed })
             return
@@ -1274,7 +1449,7 @@ export function apply(ctx, config = {}) {
             experimentState.error = null
             void (async () => {
               try {
-                const route = await pickModel(services)
+                const route = await pickModel(services, settings)
                 if (!route) throw new Error('no-model-route')
                 const judgeRoute = await pickJudgeRoute(services, route)
                 debugLog({ phase: 'experiment-start', sessionId, route, judgeRoute })
@@ -1367,6 +1542,7 @@ export function apply(ctx, config = {}) {
       `${ROUTE_PREFIX}replan`,
       `${ROUTE_PREFIX}warm`,
       `${ROUTE_PREFIX}verify`,
+      `${ROUTE_PREFIX}settings`,
     ]
     if (settings.enableDebugRoutes) {
       paths.push(
@@ -1471,3 +1647,5 @@ export function apply(ctx, config = {}) {
   })
 }
 
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plan-completion",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "private": false,
   "type": "module",
   "description": "Implicit session plans with Tab-completable next-message suggestions for DeepSeek Harness",