@njuptlzf/dsh-ponytail 1.1.0 → 1.2.0

package/README.md

@@ -13,7 +13,7 @@ A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin tha
 ### What it does
 
 1. **Always-on section (lean)** — the compact ruleset (`.agents/rules/ponytail.md`, ~2.5 KB) as a system-prompt section, cached at `~/.dsh/ponytail-cache/compact.md`. Switch the level per session with `/ponytail lite|full|ultra|off`; `off` empties the section so the tokens are actually saved. Default `full`.
-2. **On-demand skills** — the full ruleset (`ponytail`) and the 5 companions (`ponytail-help` / `ponytail-audit` / `ponytail-debt` / `ponytail-gain` / `ponytail-review`) written once to `~/.dsh/skills/<name>/SKILL.md`, invocable from the `/` palette.
+2. **On-demand skills (user-only)** — the full ruleset (`ponytail`) and the 5 companions (`ponytail-help` / `ponytail-audit` / `ponytail-debt` / `ponytail-gain` / `ponytail-review`) written once to `~/.dsh/skills/<name>/SKILL.md`, invocable from the `/` palette. Each file's frontmatter carries `disable-model-invocation: true`, so these skills stay **user-invocable** (shown in `/` with a "user only" tag) but are **not advertised to the model** — no `available_skills` catalog cost, no auto-load on "ANY coding task". The always-on compact section is the only model-facing copy.
 
 ### Install
 
@@ -29,7 +29,7 @@ Restart `dsh web` after install. The first boot fetches once and caches, so late
 ### Usage
 
 - `/ponytail` — report the current level; `/ponytail lite|full|ultra|off` — switch it. Mode is per-session (`agent.id`), so one conversation's `off` does not affect another.
-- The 6 skills stay in the `/` palette; name them (e.g. "audit for over-engineering") and the model loads them on its own.
+- The 6 skills stay in the `/` palette, tagged "user only"; type `/` and pick one (e.g. `/ponytail-review`) to trigger it manually — the model never pulls them in unprompted.
 
 ### dsh-ponytail vs codex-ponytail
 
@@ -77,7 +77,7 @@ Skill content comes from [DietrichGebert/ponytail](https://github.com/DietrichGe
 ### 它做什么
 
 1. **常驻 section（精简）** — 精简规则（`.agents/rules/ponytail.md`，~2.5 KB）作为 system-prompt section，缓存于 `~/.dsh/ponytail-cache/compact.md`。用 `/ponytail lite|full|ultra|off` 按会话切档；`off` 会让 section 渲染为空、真的省回 token。默认 `full`。
-2. **按需 skills** — 全文规则（`ponytail`）和 5 个同伴（`ponytail-help` / `ponytail-audit` / `ponytail-debt` / `ponytail-gain` / `ponytail-review`）写入 `~/.dsh/skills/<name>/SKILL.md`，`/` 面板可调。
+2. **按需 skills（仅用户可用）** — 全文规则（`ponytail`）和 5 个同伴（`ponytail-help` / `ponytail-audit` / `ponytail-debt` / `ponytail-gain` / `ponytail-review`）写入 `~/.dsh/skills/<name>/SKILL.md`，`/` 面板可调。每个 skill 的 frontmatter 都带 `disable-model-invocation: true`：技能保持**仅用户可调用**（在 `/` 里显示、带「仅用户可用」标签），但**不对模型公开**——不进 `available_skills` catalog、不会因描述写着 "ANY coding task" 被自动加载。常驻精简 section 是唯一面向模型的那一份。
 
 ### 安装
 
@@ -93,7 +93,7 @@ npx @deepseek-ai/dsh plugin --profile web add @njuptlzf/dsh-ponytail
 ### 使用
 
 - `/ponytail` — 报告当前档；`/ponytail lite|full|ultra|off` — 切档。档位按会话（`agent.id`）隔离，一个会话的 `off` 不影响其它会话。
-- 6 个技能常驻 `/` 面板；直接说「audit for over-engineering」等关键词，模型会按描述自行加载。
+- 6 个技能常驻 `/` 面板、标「仅用户可用」；打 `/` 看候选、手工选一个（如 `/ponytail-review`）触发——模型不会未经请求就自动加载它们。
 
 ### dsh-ponytail vs codex-ponytail
 

package/index.js

@@ -13,7 +13,10 @@
  *
  *   Layer 2 — on-demand skills: the FULL ruleset
  *     (skills/ponytail/SKILL.md) and the five companions, fetched once directly
- *     into ~/.dsh/skills/<name>/SKILL.md, invocable from the "/" palette.
+ *     into ~/.dsh/skills/<name>/SKILL.md. Manually triggered only: each file's
+ *     frontmatter is marked user-only (disable-model-invocation), so it stays in
+ *     the "/" palette but is never advertised to the model — no catalog cost,
+ *     no auto-load. The always-on compact section is the sole model-facing copy.
  *
  * "只抓一次": fetch only when a disk copy is missing; a present copy is reused
  * forever. Delete a copy to force a refetch.
@@ -72,6 +75,14 @@ function saveFile(target, content) {
   }
 }
 
+function disableModelInvocation(content) {
+  // Keep fetched skills user-only: present in the "/" palette (userInvocable)
+  // but absent from the model catalog / auto-load. Only touches skill files,
+  // which begin with a YAML frontmatter. Idempotent on repeated runs.
+  if (!/^---\r?\n/.test(content) || content.includes('disable-model-invocation:')) return content;
+  return content.replace(/^---\r?\n/, '---\ndisable-model-invocation: true\n');
+}
+
 async function fetchUrl(rel) {
   try {
     var res = await fetch(RAW_BASE + rel);
@@ -129,9 +140,18 @@ export function apply(ctx) {
     var skills = [MAIN].concat(COMPANIONS);
     for (var i = 0; i < skills.length; i++) {
       var name = skills[i];
-      if (existsSync(skillFile(name))) continue;
+      var file = skillFile(name);
+      if (existsSync(file)) {
+        // Idempotent policy normalize: existing files may predate the user-only
+        // flag — add it without re-fetching (keeps the offline, fetch-once promise).
+        var existing = readFileOrNull(file);
+        if (existing !== null && !existing.includes('disable-model-invocation:')) {
+          saveFile(file, disableModelInvocation(existing));
+        }
+        continue;
+      }
       var content = await fetchUrl('skills/' + name + '/SKILL.md');
-      if (content !== null) { saveFile(skillFile(name), content); fetched += 1; }
+      if (content !== null) { saveFile(file, disableModelInvocation(content)); fetched += 1; }
     }
 
     console.log('[dsh-ponytail] ready: compact=' + (compactSpec !== '' ? 'ok' : 'MISSING') + ', skills fetched=' + fetched + ' (rest cached)');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@njuptlzf/dsh-ponytail",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Ponytail (lazy-senior-dev) as a mode-switchable, always-on DSH plugin: injects the COMPACT ruleset every step (off empties it) and mirrors the full ruleset + five companions into ~/.dsh/skills. Attribution: github.com/DietrichGebert/ponytail (MIT).",
   "type": "module",
   "main": "index.js",