dsh-anima 0.0.0-stage → 2.2.2

package/lib/wording.mjs

@@ -0,0 +1,139 @@
+// lib/wording.mjs — 档位文案表 + 示例表（纯数据，零依赖）
+//
+// 定位（用户 m06593 拍板「全字段自由文本 + 原档位文案降级为一键填入」）：
+//   人设字段**全部改成自由文本**，原来的档位（专业严谨 / 幽默风趣 / 表格增强 …）
+//   不再是「只能选这几个」的枚举，而是一段**可以一键填入、随后随便改**的文案模板。
+//   于是文案表从「查表渲染」的 lib/prompt.mjs 搬到这里，由另外两个消费者共用：
+//     - lib/config.mjs 的迁移路径：旧配置里存的是档位键（'professional'），
+//       自动翻译成文案。用户升级后注入提示词的内容一字不变 —— 这是刻意的，
+//       否则「升级插件」会等于「偷偷把用户的风格改回默认」。
+//     - host 下发给设置页：每个「一键填入」按钮该填什么。
+//
+//   为什么表不留在这两个消费者各自那边：同一份文案在三处各写一遍，改一处漏两处，
+//   而漏掉的那处正是提示词里实际生效的那份。
+//
+// 文件里的两张表，区别只在「有没有标准答案」：
+//   - WORDING_TABLES：风格字段。改回枚举是说得通的，所以每个档位就是一句定稿的话。
+//   - FIELD_EXAMPLES：身份与背景字段。**没有**标准答案（谁也不能替用户写他是谁），
+//     所以这里给的是**示例**——一段可以直接改成自己情况的现成文字（用户 m08898
+//     要求「每个文本都要有例子或者是一些预设」）。示例的作用是消除「空输入框恐惧」：
+//     面对一个空 textarea，多数人第一反应是跳过，于是这个字段永远空着。
+//
+// 一个已知取舍（不是遗漏）：注入进提示词的文案是中文的（含 en 档的 'Reply in English.'），
+// 英文界面的用户点「一键填入」会得到中文文案。这与改造前完全一致 —— 语言档一向是
+// 「用哪种语言回复」，而不是「插件界面文案用哪种语言」；两者混在一起反而会让
+// 中文用户选 en 之后收到英文的解释段。
+
+/** 风格档位：键 → 注入提示词的完整文案。 */
+export const STYLE_WORDING = {
+  professional: '专业严谨、注重逻辑和准确性；结论先行，术语准确，避免口语化与情绪化表达。',
+  casual: '轻松自然，像朋友之间聊天；语气随和，可以用口语，但技术内容仍要准确。',
+  humorous: '幽默风趣；在保证准确的前提下允许俏皮的比喻与调侃，让回答读起来不枯燥。',
+  roast: '毒舌吐槽；直白指出问题、不留情面，但始终对事不对人，不攻击用户本人。',
+  efficient: '高效干练；走最短路径给答案，能省的字都省，不重复用户已经说过的话。'
+}
+
+/**
+ * 三项特质：键 → 文案。
+ * default 刻意映射为**空串**而不是某句「保持默认」—— 提示词组装会把空串整行丢掉，
+ * 于是「默认」真的等于「不提这件事」，模型按自己的判断来，而不是被一句
+ * 「请按默认方式处理标题」占用注意力。
+ */
+export const TRAIT_WORDING = {
+  headingLists: {
+    default: '',
+    more: '多用标题与列表组织内容，让结构一目了然。',
+    less: '少用标题与列表，以连贯的段落文字为主。'
+  },
+  emoji: {
+    default: '',
+    more: '可以适度使用表情符号增添语气。',
+    less: '尽量不使用表情符号。'
+  },
+  tables: {
+    default: '',
+    more: '需要对比、多字段或结构化信息时，优先使用表格。',
+    less: '避免使用表格，改用列表或段落文本。'
+  }
+}
+
+export const REPLY_LENGTH_WORDING = {
+  concise: '简洁；直击要点，不展开背景与推理过程。',
+  normal: '适中；不额外约束长度。',
+  detailed: '详尽；充分展开背景、步骤与推理过程。'
+}
+
+export const LANGUAGE_WORDING = {
+  zh: '使用简体中文回复。',
+  en: 'Reply in English.'
+}
+
+/**
+ * 字段 → 档位表。键的顺序即设置页「一键填入」按钮的排列顺序
+ * （对象字面量的键序在 JS 里是有保证的，不必另立一份顺序表 —— 两份必然写岔）。
+ */
+export const WORDING_TABLES = {
+  style: STYLE_WORDING,
+  headingLists: TRAIT_WORDING.headingLists,
+  emoji: TRAIT_WORDING.emoji,
+  tables: TRAIT_WORDING.tables,
+  replyLength: REPLY_LENGTH_WORDING,
+  language: LANGUAGE_WORDING
+}
+
+/**
+ * 身份与背景字段的示例（用户 m08898：「每个文本都要有例子或者是一些预设」）。
+ *
+ * 与 WORDING_TABLES 的分工：那边是「档位」，点一下就定稿；这边是「示例」，
+ * 点一下**填进去还要改**（把「三年前端」改成你自己的年限）。因此文案刻意写成
+ * **明显属于别人的第一人称**，而不是一段通用套话 —— 通用套话会被直接保存，
+ * 然后长期误导模型；一看就知道要改的示例才会被改。
+ *
+ * 数组而非单条：同一字段给多个角度，用户挑一个顺眼的改。键序即按钮排列序。
+ * 空数组表示「这个字段不给示例」——不是字段不存在，是示例帮不上忙（见 agentName）。
+ */
+export const FIELD_EXAMPLES = {
+  // 名字不宜给示例：按钮填一个示例名进去，用户很可能忘了改，
+  // 结果 AI 用了别人起的名。这一项靠 placeholder 提示格式即可。
+  agentName: [],
+  agentRole: [
+    '长期 AI 助手，服务对象是学生与研究者。习惯先给结论再解释依据，遇到不确定的事实会先查证而不是猜。',
+    '资深全栈工程师。优先给出能跑的最小方案，再谈扩展；改动会说明影响面与回滚方式。',
+    '写作搭子。先问清读者是谁、要什么效果，再动笔；改稿时说明每一处为什么改。'
+  ],
+  addressUserAs: ['老大', '老师', '直接叫我的名字就行'],
+  userOccupation: ['研究生', '前端开发', '产品经理', '中学教师'],
+  userBio: [
+    '研究生在读，方向是自然语言处理。日常要读论文、跑实验、写代码，对名词的准确性比较敏感。',
+    '三年前端开发，主要写 React。看得懂后端代码但不想深入，解释时可以少讲原理多讲怎么用。',
+    '非技术岗，用 AI 处理文档和数据表格。术语请展开讲，代码能跑就行。'
+  ],
+  customInstructions: [
+    '回答里不要用「首先/其次/最后」这类模板词。\n涉及具体版本号、命令、参数时，先确认再写，不确定就说不确定。',
+    '给方案时最多给三个，并说明你推荐哪个、为什么。\n改动我已有的文件前，先说清改哪里、改成什么。',
+    '每次涉及事实陈述，标出信息来源是记忆、推理还是检索结果。\n我不想看客套话，直接进正题。'
+  ],
+  // 记忆区的示例。键名不是人设字段，但走同一条下发通道（客户端按字段名取表），
+  // 与其为它单开一条路径，不如共用 —— 两张表都只是「一段可改的现成文字」。
+  memory: [
+    '回答先给结论，再展开依据。',
+    '改动我已有文件之前，先说清改哪里、为什么改。',
+    '涉及版本号与命令时不要凭印象写，先确认。'
+  ]
+}
+
+/**
+ * 把「可能是档位键」的值翻译成文案。
+ *
+ * @param {string} key 人设字段名（style / headingLists / …）
+ * @param {unknown} value 配置里的原值
+ * @returns {string|null} 命中档位键时返回文案（**可能是空串**，如 default）；
+ *   不是本字段的档位键、或本字段没有档位表时返回 null —— 调用方据此判断
+ *   「这是旧版存的键」还是「这是用户自己写的句子」。
+ *   注意不能用 `if (result)` 判命中：空串是合法翻译结果。
+ */
+export function translateWording(key, value) {
+  const table = WORDING_TABLES[key]
+  if (!table || typeof value !== 'string') return null
+  return Object.prototype.hasOwnProperty.call(table, value) ? table[value] : null
+}

package/lib/workspace.mjs

@@ -0,0 +1,168 @@
+// lib/workspace.mjs — 工作区两级覆盖的读写与解析
+//
+// 存储位置：<workspace>/.dsh-anima/override.json
+//   - 跟项目走、可 git、可拷给别人（拍板 ⑦）
+//   - 风险：会进用户的 git，第一次 commit 就可能把私人语气推到远程。
+//     因此本模块额外维护 .gitignore，默认忽略整个目录（可关）。
+//
+// 解析链：会话 cwd → 向上找最近的 override.json → sanitizeOverrides → mergePersona
+
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises'
+import { readFileSync, statSync } from 'node:fs'
+import { dirname, join, resolve, sep } from 'node:path'
+import { sanitizeOverrides } from './config.mjs'
+
+const OVERRIDE_FILE = 'override.json'
+
+export function overrideDirFor(workspacePath, dirName) {
+  return join(workspacePath, dirName || '.dsh-anima')
+}
+
+export function overrideFileFor(workspacePath, dirName) {
+  return join(overrideDirFor(workspacePath, dirName), OVERRIDE_FILE)
+}
+
+async function readJsonIfExists(path) {
+  try {
+    return JSON.parse(await readFile(path, 'utf8'))
+  } catch (err) {
+    if (err && err.code === 'ENOENT') return null
+    if (err instanceof SyntaxError) {
+      const e = new Error(`覆盖文件不是合法 JSON：${path}`)
+      e.code = 'INVALID_JSON'
+      throw e
+    }
+    throw err
+  }
+}
+
+async function writeJsonAtomic(path, value) {
+  await mkdir(dirname(path), { recursive: true })
+  const tmp = `${path}.tmp-${process.pid}-${Date.now()}`
+  await writeFile(tmp, JSON.stringify(value, null, 2), 'utf8')
+  await rename(tmp, path)
+}
+
+/**
+ * 确保工作区目录不需要把覆盖文件提交进 git。
+ * 在覆盖目录内写一个 .gitignore（内容 `*`），该规则只作用于本目录。
+ * 失败不抛错 —— gitignore 只是保险，不该阻断保存。
+ */
+export async function ensureIgnored(workspacePath, dirName) {
+  try {
+    const gitignore = join(overrideDirFor(workspacePath, dirName), '.gitignore')
+    await mkdir(dirname(gitignore), { recursive: true })
+    await readFile(gitignore, 'utf8')
+  } catch (err) {
+    if (err && err.code === 'ENOENT') {
+      try {
+        await writeFile(join(overrideDirFor(workspacePath, dirName), '.gitignore'), '*\n', 'utf8')
+      } catch { /* 忽略 */ }
+    }
+  }
+}
+
+/**
+ * 读取某工作区的覆盖。
+ * @returns {{overrides: object, path: string, exists: boolean, errors: Record<string,string>}}
+ */
+export async function readOverrides(workspacePath, dirName) {
+  const path = overrideFileFor(workspacePath, dirName)
+  let raw = null
+  try {
+    raw = await readJsonIfExists(path)
+  } catch (err) {
+    if (err.code === 'INVALID_JSON') {
+      return { overrides: {}, path, exists: true, errors: { _: err.message } }
+    }
+    throw err
+  }
+  if (raw === null) return { overrides: {}, path, exists: false, errors: {} }
+  const { overrides, errors } = sanitizeOverrides(raw)
+  return { overrides, path, exists: true, errors }
+}
+
+/** 写入某工作区的覆盖；空对象表示清除覆盖（写空文件而不是删文件，便于用户看到）。 */
+export async function writeOverrides(workspacePath, dirName, overrides) {
+  const path = overrideFileFor(workspacePath, dirName)
+  await writeJsonAtomic(path, { overrides })
+  invalidateSyncCache(path)
+  return path
+}
+
+/** 删除覆盖文件；不存在返回 false。 */
+export async function removeOverrides(workspacePath, dirName) {
+  const path = overrideFileFor(workspacePath, dirName)
+  try {
+    const { rm } = await import('node:fs/promises')
+    await rm(path)
+    invalidateSyncCache(path)
+    return true
+  } catch (err) {
+    if (err && err.code === 'ENOENT') return false
+    throw err
+  }
+}
+
+/**
+ * 从会话 cwd 向上寻找最近的覆盖文件（同步版）。
+ *
+ * **为什么需要同步版**：`systemPrompt.section()` 的 `text` 为函数时，
+ * dsh-system-prompt 在装配期是**同步**调用 `section.text(context)`（见
+ * dsh-system-prompt\lib\index.js:342），拿不到 Promise。而 section 必须在
+ * 每一轮装配期重新求值才能反映「此时此会话的工作区」，所以这条读取路径
+ * 只能是同步的。
+ *
+ * 用 mtime 做缓存键：文件没变就不重复解析，避免每个模型 step 都读盘。
+ *
+ * @returns {{workspacePath: string, overrides: object, path: string, errors: object}|null}
+ */
+const syncCache = new Map() // path -> {mtimeMs, size, result}
+
+export function resolveOverridesFromCwdSync(cwd, dirName) {
+  if (!cwd || typeof cwd !== 'string') return null
+  const name = dirName || '.dsh-anima'
+  let current = resolve(cwd)
+  const root = resolve(sep)
+
+  for (let depth = 0; depth < 32; depth += 1) {
+    const candidate = join(current, name, OVERRIDE_FILE)
+    let stat = null
+    try {
+      stat = statSync(candidate)
+    } catch {
+      stat = null
+    }
+    if (stat && stat.isFile()) {
+      const cached = syncCache.get(candidate)
+      if (cached && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) {
+        return cached.result === null ? null : { ...cached.result, workspacePath: current }
+      }
+      let result
+      try {
+        const raw = JSON.parse(readFileSync(candidate, 'utf8'))
+        const { overrides, errors } = sanitizeOverrides(raw)
+        result = { overrides, path: candidate, errors }
+      } catch (err) {
+        result = {
+          overrides: {},
+          path: candidate,
+          errors: { _: err instanceof SyntaxError ? `覆盖文件不是合法 JSON：${candidate}` : String(err?.message || err) }
+        }
+      }
+      syncCache.set(candidate, { mtimeMs: stat.mtimeMs, size: stat.size, result })
+      return { ...result, workspacePath: current }
+    }
+    if (current === root) break
+    const parent = dirname(current)
+    if (parent === current) break
+    current = parent
+  }
+  return null
+}
+
+/** 写入后使同步缓存失效（否则同一 mtime 精度内的连续写入会读到旧值）。 */
+export function invalidateSyncCache(path) {
+  if (path) syncCache.delete(path)
+  else syncCache.clear()
+}

package/package.json

@@ -1,6 +1,74 @@
 {
   "name": "dsh-anima",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.2.2",
+  "description": "DSH 助手人格与外挂记忆层：AI 自身的名字与角色、按工作区两级覆盖、带待审缓冲区的长期记忆",
+  "icon": "./assets/icon.svg",
+  "type": "module",
+  "main": "./index.mjs",
+  "license": "MIT",
+  "scripts": {
+    "verify": "node scripts/verify-core.mjs",
+    "smoke": "node scripts/smoke-host.mjs && node scripts/smoke-client.mjs",
+    "acceptance": "node scripts/acceptance.mjs",
+    "review": "node scripts/review.mjs",
+    "check": "node scripts/verify-core.mjs && node scripts/smoke-host.mjs && node scripts/smoke-client.mjs && node scripts/check-client-i18n.mjs"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "persona",
+    "memory",
+    "prompt"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Melody-cx/dsh-anima.git"
+  },
+  "homepage": "https://github.com/Melody-cx/dsh-anima#readme",
+  "bugs": {
+    "url": "https://github.com/Melody-cx/dsh-anima/issues"
+  },
+  "exports": {
+    ".": "./index.mjs",
+    "./client": "./client/index.mjs",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.mjs",
+    "lib",
+    "client",
+    "assets",
+    "cordis.patch.yml",
+    "LICENSE",
+    "README.md",
+    "README_EN.md",
+    "CHANGELOG.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1 || ^4.0.5-alpha.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.1-rc.2 <0.2.0 || >=0.2.0-0 <0.3.0-0",
+    "@deepseek-ai/dsh-storage-domain": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0-0",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6 <0.2.0 || >=0.2.0-0 <0.3.0-0"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0-0"
+  }
+}