dsh-lifecard 0.1.2 → 0.2.0

package/README.md

@@ -4,7 +4,15 @@
 
 > **三十秒看懂**：把家里人、老朋友、你自己，一件一件问清楚——他做过什么、怎么说话、你们之间发生过什么——写成一张能一直改的卡。卡就在你自己的文件夹里，用记事本就能打开，换台电脑也能带走。不联网、不上传，也不替你编：每条都要能在你写过的话里找到出处，找不到就丢掉。
 
-**五个入口，两条链路。** 首页那排按钮就是它们：
+**打开先选一扇门。** 三扇门是三件不同的事，进去之后随时能换（右上角「换门」），卡和世界书都在同一个文件夹里，不会因为换门丢掉：
+
+| 门 | 用来做什么 | 里面有什么 |
+|---|---|---|
+| **真实人物记录** | 记现实里的人：家里人、朋友、你自己 | 访谈、材料整理、导角色卡、简历与规划、看工作 |
+| **写小说** | 立虚构角色、写一本书 | 边聊边立角色、大纲、逐章写、盲审（只看正文挑毛病）、把酒馆一场对话或游戏一段变成一章 |
+| **酒馆（角色扮演）** | 拿一张卡，和 TA 你一句我一句地演 | 角色卡 + 世界书命中、开场白、收尾备忘（记到「到这儿为止」）、挑几句进卡的「对话示例」 |
+
+**真实人物记录那扇门里，五个入口组成两条链路：**
 
 ```
 ① 导入        角色卡 PNG / JSON / CHARX → 直接出卡        （纯格式搬运，不调模型）
@@ -152,6 +160,59 @@ dsh plugin --profile desktop add /path/to/LifeCard/plugin
 - **导出 PNG**：`chara`（V2）与 `ccv3`（V3）两个 chunk 来自**同一个源对象**，V3 是 V2 的严格超集。SillyTavern 的 `read()` 以 `ccv3` 优先，两份独立投影会让同一张卡在两个前端里变成两个人。
 - **导出 JSON**：CCv3 格式。
 
+### 写小说
+
+**写小说** 那扇门里先选一本（或新建一本），一本书就是三个文件：
+
+```
+books/<书名>/book.md          书名、题材、一句话
+books/<书名>/outline.md       大纲：主线、结局、第 N 章各写什么（这一个人能直接改）
+books/<书名>/chapters/001.md  正文，一章一个文件
+```
+
+三步：
+
+1. **先想清楚这本书怎么走**——点「让 AI 想大纲」，或者自己在 `outline.md` 里写。大纲是纯文本，你想怎么改就怎么改。
+2. **写第 N 章**——点「让 AI 写这一章」。它一次会拿到四样东西：这一章的计划（大纲里对应的那一句）、整本大纲、上一章结尾、挂在这本书上的角色卡。出来的是一份草稿，你看了点「收下，写进这一章」才落盘。
+3. **挑挑毛病**——只把正文给它，**不给书名、不给大纲、不给「本来想写什么」**。这样它挑的是「写出来是什么」，而不是按你的意图夸你写得对。四条固定要求：卡在哪、哪不信、哪想跳过、哪句是空话（要引原句）。
+
+章号**不重排**：删了第 3 章，第 4 章还是第 4 章。你手里说的「第四章」不会突然变成第三章。
+
+一本书还能挂「文字小说游戏」：挑一章当起点，它写这一刻发生了什么，给你 A/B/C 三个方向，你选一个，它接着往下推。玩出来的东西也能一键变成小说的一章，**你选过的那几步会保住**。
+
+### 酒馆（角色扮演）
+
+**酒馆** 那扇门里挑一张虚构角色卡，点一张就开一场。开场白是第一条，之后你说一句它回一句。
+
+- **世界书按关键词进**：常驻条目每轮都带；其余条目只有最近六句话里出现了它的关键词才带。不像写小说那样整本设定全塞进去——演的时候塞满了，它就只会复述设定。
+- **现实里的卡默认收起来**。真人有真人的记录，拿去演会**复制一份独立的角色卡**（`-role` 后缀），之后你把副本的性格改成完全相反都动不到原来那张。
+- **收个尾**：聊到一段落点「收个尾」，它把到这儿为止发生的事、定下来的事、还没解决的事记成一段备忘，存进这场对话的 `## 到这儿为止`。不满八句不收，因为三句话总结出来的东西比没有更误导。下次接着说，这段备忘每轮都带着。
+- **挑几句进卡里**：演出来好用的说话方式，可以挑 4~8 句写回那张卡的「对话示例」小节，下次演就更像。
+- **变成小说的一章**：一场对话可以整段改写成小说正文，存进某本书的下一章。
+
+对话存在 `chats/` 下，一个 Markdown 文件一场，用记事本就能打开看。
+
+### 简历与规划
+
+**真实人物记录** 门里的工具行有「简历与规划」。两边分开：
+
+- **左半边**是你自己：基本情况、学过什么、做过什么、会用哪些工具、想去哪、还差什么。照这个可以直接写一份简历（它会按你填的「想投哪儿」调重点），也能看「差在哪」。
+- **右半边**是路怎么走：终点长什么样、分几步、现在这一步、可能会卡在哪。
+
+### 不想要某个功能，可以整块删掉
+
+写小说、酒馆、文字游戏、预设、简历与规划，这五块是**可拆卸**的：删掉对应的文件，别的功能照常能用，被删掉的那扇门会自己从界面上消失，别人点进来也不会报错，只会说「这个功能没装」。
+
+```
+plugin/lib/novel.js    删了 = 没有「写小说」（文字游戏也一起没了）
+plugin/lib/tavern.js   删了 = 没有「酒馆」
+plugin/lib/game.js     删了 = 没有文字游戏，「写小说」还在
+plugin/lib/presets.js  删了 = 三种玩法不能挑演法/写法，但都能用
+plugin/lib/career.js   删了 = 没有「简历与规划」
+```
+
+实现上：这五个模块是按需 `await import()` 的，不是文件顶上的静态 import。静态 import 一个不存在的文件会让整个插件起不来，那就不是「能删」而是「删了就全废」。
+
 ### 看工作（求职）
 
 首页点 **看工作**。把一份招聘说明整段贴进来，点 **看看这份工作**。

package/lib/career.js

@@ -0,0 +1,488 @@
+/**
+ * career —— 写简历、规划以后往哪走。
+ *
+ * 为什么单独一层：简历和「人物卡」不是一回事。卡记的是「一个人是谁」，
+ * 这里记的是「他学过什么、做过什么、下一步去哪」——这些内容会变，而且用户要能自己改。
+ *
+ * 落盘形状（用户拿 Finder 就能看、能改）：
+ * ```
+ * career/
+ *   profile.md    现在有什么：基本情况、学过什么、做过什么、会用哪些工具、想去哪、还差什么
+ *   purpose.md    以后怎么走：终点长什么样、分几步走、现在这一步、可能会卡在哪
+ * ```
+ * 只有两份文件，不按日期分文件夹：简历只有一份，规划也只有一份，改了就覆盖。
+ * 想留旧版本，让用户自己复制一份。
+ *
+ * 这一层只碰磁盘与文字：不调模型、不碰 HTTP。路由在 index.js，界面在 client.js。
+ */
+
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import * as core from './core.js'
+import { localDate } from './store.js'
+
+/** 和简历有关的东西都放在工作区的这个文件夹里。 */
+export const CAREER_DIR = 'career'
+
+/** 「现在有什么」那份文件。路径写死，不从外面接收。 */
+export const PROFILE_REL = 'career/profile.md'
+
+/** 「以后怎么走」那份文件。路径写死，不从外面接收。 */
+export const PURPOSE_REL = 'career/purpose.md'
+
+/** 简历正文的六个小节。这个顺序就是写进文件的顺序。 */
+export const PROFILE_SECTIONS = ['基本情况', '学过什么', '做过什么', '会用哪些工具', '想去哪', '还差什么']
+
+/** 简历里一行一条的那几个小节，其余小节是一段自由文字。 */
+export const PROFILE_LIST_SECTIONS = ['学过什么', '做过什么', '会用哪些工具', '还差什么']
+
+/** 规划正文的四个小节。 */
+export const PLAN_SECTIONS = ['终点长什么样', '分几步走', '现在这一步', '可能会卡在哪']
+
+/** 规划里一行一条的那个小节。 */
+export const PLAN_LIST_SECTIONS = ['分几步走']
+
+/** frontmatter 里的 kind 值。用来分清这个文件到底是简历还是规划。 */
+const PROFILE_KIND = 'career-profile'
+const PLAN_KIND = 'career-plan'
+
+// ── 一行一条的小节：写入 / 读出 ──────────────────────────────────────
+//
+// 一条内容里如果带换行，直接写进文件会被读成两条。所以写入前把换行记成 `\n`
+// 这两个字符，读回来再还原；反斜杠本身也要先转义，否则分不清哪个 `\` 是原来的。
+// 用户自己手写的内容不带这两个字符，写进去就是原样。
+
+function escapeItem(text) {
+  return String(text ?? '')
+    .trim()
+    .replace(/\\/g, '\\\\')
+    .replace(/\r\n|\r|\n/g, '\\n')
+}
+
+function unescapeItem(text) {
+  return String(text ?? '').replace(/\\(\\|n|r)/g, (_, c) => (c === 'n' ? '\n' : c === 'r' ? '\r' : '\\'))
+}
+
+/** 把「学过什么」这类小节的值统一成一个字符串数组。 */
+function asItems(value) {
+  if (Array.isArray(value)) return value.map((v) => String(v ?? '').trim()).filter((v) => v !== '')
+  const text = String(value ?? '').trim()
+  if (text === '') return []
+  return text
+    .split(/\r?\n/)
+    .map((line) => line.replace(/^\s*(?:[-*+]|\d+\s*[.、)．])\s*/, '').trim())
+    .filter((line) => line !== '')
+}
+
+/** 写文件用：每条一行，内容里的换行已经转义过。 */
+function renderList(value) {
+  return asItems(value)
+    .map(escapeItem)
+    .filter((line) => line !== '')
+    .map((line) => `- ${line}`)
+    .join('\n')
+}
+
+/** 拼提示词用：原样输出，不转义，让模型看到的是正常的多行文字。 */
+function plainList(value) {
+  return asItems(value)
+    .map((item) => `- ${item}`)
+    .join('\n')
+}
+
+/** 一段自由文字。多行就原样保留。 */
+function freeText(value) {
+  if (Array.isArray(value)) return value.map((v) => String(v ?? '').trim()).filter((v) => v !== '').join('\n')
+  return String(value ?? '').trim()
+}
+
+/** 读一个「一行一条」的小节：去掉行首的 `-`、`*`、`1.` 这些记号，再还原转义。 */
+function parseList(body) {
+  const out = []
+  for (const raw of String(body ?? '').split(/\r?\n/)) {
+    let line = raw.trim()
+    if (line === '') continue
+    if (/^#{1,6}\s/.test(line)) continue
+    line = line.replace(/^\s*(?:[-*+]|\d+\s*[.、)．])\s*/, '').trim()
+    const text = unescapeItem(line)
+    if (text !== '') out.push(text)
+  }
+  return out
+}
+
+// ── 整份文件：写入 / 读出 ──────────────────────────────────────────
+
+/**
+ * 一份文件：frontmatter + 若干 `## 小节`。
+ *
+ * 空小节也把标题写出来，用户打开文件就知道还能填什么，不用对着空白想字段名。
+ */
+function renderDoc(head, data, order, listSections) {
+  const blocks = order.map((title) => {
+    const body = listSections.includes(title) ? renderList(data?.[title]) : freeText(data?.[title])
+    return body === '' ? `## ${title}` : `## ${title}\n\n${body}`
+  })
+  return `---\n${core.stringifyYaml(head)}\n---\n\n${blocks.join('\n\n')}\n`
+}
+
+/**
+ * 读一份文件。读不成的时候给的是人话，不是解析器的报错。
+ * @param {string} text
+ * @param {{kind: string, sections: string[], listSections: string[], keep: string[], error: string, wrongKind: string}} spec
+ */
+function parseDoc(text, spec) {
+  const parsed = core.parseCard(String(text ?? ''))
+  if (parsed.ok !== true) return { ok: false, error: spec.error }
+  const head = parsed.data ?? {}
+  const kind = String(head.kind ?? '').trim()
+  if (kind !== '' && kind !== spec.kind) return { ok: false, error: spec.wrongKind }
+
+  const data = {}
+  for (const key of spec.keep) {
+    const value = head[key]
+    if (value !== undefined && value !== null) data[key] = String(value).trim()
+  }
+
+  const sections = {}
+  for (const title of spec.sections) {
+    const body = core.sectionBody(parsed.sections ?? [], title)
+    sections[title] = spec.listSections.includes(title) ? parseList(body) : String(body ?? '').trim()
+    data[title] = sections[title]
+  }
+  return { ok: true, data, sections }
+}
+
+/** 读一份文件。找不到是正常状态（还没写过），不报错。 */
+async function readDoc(root, rel, parse, label) {
+  let text
+  try {
+    text = await fs.readFile(path.join(root, rel), 'utf8')
+  } catch (error) {
+    if (error?.code === 'ENOENT') return { ok: true, data: null, sections: null, missing: true }
+    return { ok: false, error: `${label}读不出来。检查一下这个文件夹的权限。` }
+  }
+  const parsed = parse(text)
+  if (parsed.ok !== true) return parsed
+  return { ok: true, path: rel, text, data: parsed.data, sections: parsed.sections }
+}
+
+/**
+ * 写一份文件。
+ *
+ * 先写临时文件再改名：改名是一次替换，掉电或者磁盘写满的时候，
+ * 原来那份要么还是旧的完整版本，要么已经是新的完整版本，不会留下半份。
+ * `rel` 只由本文件里的常量传进来，外面传的路径一律不用。
+ */
+async function writeDoc(root, rel, text, label) {
+  const abs = path.join(root, rel)
+  const tmp = `${abs}.tmp-${process.pid}-${Math.random().toString(36).slice(2, 8)}`
+  try {
+    await fs.mkdir(path.dirname(abs), { recursive: true })
+    await fs.writeFile(tmp, text, 'utf8')
+    await fs.rename(tmp, abs)
+  } catch {
+    await fs.rm(tmp, { force: true }).catch(() => {})
+    return { ok: false, error: `${label}没能存下来。检查一下磁盘是不是满了。` }
+  }
+  return { ok: true, path: rel, chars: text.length }
+}
+
+// ── 简历：profile.md ─────────────────────────────────────────────
+
+/**
+ * 简历写成 Markdown。
+ *
+ * 只写用户自己填进去的东西。没填的小节留一个标题空着，方便他下次接着写。
+ */
+export function renderProfileMarkdown(data) {
+  const d = data !== null && typeof data === 'object' && !Array.isArray(data) ? data : {}
+  const name = String(d.name ?? '').trim()
+  const updated = String(d.updated_at ?? '').trim()
+  const head = {
+    lifecard: core.DATA_VERSION,
+    kind: PROFILE_KIND,
+    name: name === '' ? '未命名' : name,
+    updated_at: updated === '' ? localDate() : updated,
+  }
+  return renderDoc(head, d, PROFILE_SECTIONS, PROFILE_LIST_SECTIONS)
+}
+
+/** 反过来：把 profile.md 读成 `{data, sections}`。 */
+export function parseProfileText(text) {
+  return parseDoc(String(text ?? ''), {
+    kind: PROFILE_KIND,
+    sections: PROFILE_SECTIONS,
+    listSections: PROFILE_LIST_SECTIONS,
+    keep: ['name', 'updated_at'],
+    error: '这份简历读不出来，格式不对',
+    wrongKind: '这个文件不是简历，是别的文件。',
+  })
+}
+
+/** 读简历。还没写过返回 `{ok: true, data: null}`——没简历是正常状态，不是出错。 */
+export async function readProfile(root) {
+  return readDoc(root, PROFILE_REL, parseProfileText, '简历')
+}
+
+/**
+ * 写简历。
+ *
+ * 只收 `root` 和内容，不收路径：路径固定是 `career/profile.md`，
+ * 内容里就算带了 path 也不会被用到，写不到 `career/` 外面去。
+ */
+export async function writeProfile(root, data, now = new Date()) {
+  const input = data !== null && typeof data === 'object' && !Array.isArray(data) ? data : {}
+  const next = { ...input }
+  next.updated_at = localDate(now)
+  const text = renderProfileMarkdown(next)
+  const written = await writeDoc(root, PROFILE_REL, text, '简历')
+  if (written.ok !== true) return written
+  return { ...written, data: next }
+}
+
+// ── 规划：purpose.md ─────────────────────────────────────────────
+
+/** 规划写成 Markdown。`horizon` 是这段规划管多久（3个月、1年、4年这种）。 */
+export function renderPlanMarkdown(data) {
+  const d = data !== null && typeof data === 'object' && !Array.isArray(data) ? data : {}
+  const updated = String(d.updated_at ?? '').trim()
+  const head = {
+    lifecard: core.DATA_VERSION,
+    kind: PLAN_KIND,
+    horizon: String(d.horizon ?? '').trim(),
+    updated_at: updated === '' ? localDate() : updated,
+  }
+  return renderDoc(head, d, PLAN_SECTIONS, PLAN_LIST_SECTIONS)
+}
+
+/** 反过来：把 purpose.md 读成 `{data, sections}`。 */
+export function parsePlanText(text) {
+  return parseDoc(String(text ?? ''), {
+    kind: PLAN_KIND,
+    sections: PLAN_SECTIONS,
+    listSections: PLAN_LIST_SECTIONS,
+    keep: ['horizon', 'updated_at'],
+    error: '这份规划读不出来，格式不对',
+    wrongKind: '这个文件不是规划，是别的文件。',
+  })
+}
+
+/** 读规划。还没写过返回 `{ok: true, data: null}`。 */
+export async function readPlan(root) {
+  return readDoc(root, PURPOSE_REL, parsePlanText, '规划')
+}
+
+/** 写规划。路径同样写死，只写 `career/purpose.md`。 */
+export async function writePlan(root, data, now = new Date()) {
+  const input = data !== null && typeof data === 'object' && !Array.isArray(data) ? data : {}
+  const next = { ...input }
+  next.updated_at = localDate(now)
+  const text = renderPlanMarkdown(next)
+  const written = await writeDoc(root, PURPOSE_REL, text, '规划')
+  if (written.ok !== true) return written
+  return { ...written, data: next }
+}
+
+// ── 让模型干活的三段话 ────────────────────────────────────────────
+
+/** 把简历的各小节排成模型看得懂的一段文字。空的小节不占地方。 */
+function profileBlock(profile) {
+  const lines = []
+  for (const title of PROFILE_SECTIONS) {
+    const body = PROFILE_LIST_SECTIONS.includes(title) ? plainList(profile?.[title]) : freeText(profile?.[title])
+    if (body === '') continue
+    lines.push(`【${title}】`, body, '')
+  }
+  if (lines.length === 0) return '（他还没填任何材料。）'
+  return lines.join('\n').trimEnd()
+}
+
+/** 写简历的那两段话。只准写发生过的事。 */
+export function buildResumePrompt({ profile, target } = {}) {
+  const want = String(target ?? '').trim()
+  const system = [
+    '你在帮一个大学生写简历。',
+    '你只写简历上该有的东西：学校专业、时间、做过的事、做出来的结果、会用哪些工具。',
+    '',
+    '写的时候守这几条：',
+    '- 不许编造没发生过的事。材料里没写的就留空，不要替他补一段听起来不错的经历。',
+    '- 句子要短，一句话说清一件事。',
+    '- 不用「负责」「参与」「协助」这种看不出到底做了什么的话，直接写他做了什么。',
+    '- 能量化就给数：写「改了四稿」「带了 12 个学生」，不写「多次」「大量」。',
+    '- 不写自我评价，不写「学习能力强」「能吃苦」「热爱这一行」。招聘的人不看这些。',
+    '- 没有经历的部分不要硬凑，空着比编一段强。',
+    '',
+    '输出直接用 Markdown，按「教育背景」「课程与成绩」「做过的事」「会用的工具」「想去的方向」分段。',
+    '哪一段没有内容就整段不写，不要写「暂无」。',
+    '不要解释你是怎么写的，不要问我问题，直接给简历。',
+  ].join('\n')
+
+  const user = [
+    '下面是他自己填的材料：',
+    '',
+    profileBlock(profile),
+    '',
+    '【这份简历投给谁】',
+    want === '' ? '（他没填目标。按上面「想去哪」那一段自己判断。）' : want,
+    '',
+    '【要你做什么】',
+    '照上面的目标写一份能直接投出去的简历。他真有的东西写清楚，没有的不要编。',
+  ].join('\n')
+
+  return { system, user }
+}
+
+/** 做长期规划的那两段话。每一步都要能动手，也要能判断做完没做完。 */
+export function buildPathPrompt({ profile, goal, horizon } = {}) {
+  const aim = String(goal ?? '').trim()
+  const span = String(horizon ?? '').trim()
+  const system = [
+    '你在帮一个人规划接下来一段时间怎么走。要的不是愿景，是能照着做的事。',
+    '',
+    '要求：',
+    '- 每一步都要落到「下个月做什么」这个程度。不要写「多读书」「积累经验」「多了解这个行业」这种没法动手的话。',
+    '- 每一步都必须写清楚：做完没做完怎么判断。判断标准要看得见（考了多少分、写完几篇、拿到谁的回复、投出去几份），不能是「有提升」。',
+    '- 不许写鸡汤和大词。「提升自我」「赋能」「沉淀」「破圈」「找到热爱」「成为更好的自己」这类一概不许出现。',
+    '- 如果他的目标和材料明显对不上（比如目标是进地质类院所的技术岗，但学过的课、做过的事全不沾边），要直说这个矛盾，放在最前面，不要绕过去，也不要替他圆场。',
+    '- 步骤之间要有先后：前一步没做完，后一步不该开始，就在后一步里写清楚前置条件。',
+    '- 时间要具体到月份或者「第几个月」，不要写「尽快」「适当时候」。',
+    '',
+    '输出用 Markdown，分四段：',
+    '## 终点长什么样',
+    '## 分几步走',
+    '## 现在这一步',
+    '## 可能会卡在哪',
+    '「分几步走」每行一条，格式是：- 这一步做什么｜大概什么时候｜怎么算做完了。',
+    '不要客套，不要鼓励，直接给规划。',
+  ].join('\n')
+
+  const user = [
+    '【他现在有什么】',
+    '',
+    profileBlock(profile),
+    '',
+    '【他想到哪儿】',
+    aim === '' ? '（他没写清楚要去哪。按上面「想去哪」那一段判断。）' : aim,
+    '',
+    '【这段规划管多久】',
+    span === '' ? '（他没填。按一年算。）' : span,
+    '',
+    '【要你做什么】',
+    '写一份从今天到那个终点的规划，落到下个月做什么。',
+    '如果目标和上面的材料对不上，第一段就把这个矛盾说出来。',
+  ].join('\n')
+
+  return { system, user }
+}
+
+/** 差距分析的那两段话。缺的排前面，每条要具体。 */
+export function buildGapPrompt({ profile, target } = {}) {
+  const want = String(target ?? '').trim()
+  const system = [
+    '你在做一次差距分析：他要去的地方要求什么，他现在有什么，中间差什么。',
+    '',
+    '要求：',
+    '- 把「目标要求的」和「他现在有的」并排列出来，一行一条，能对上的写在同一行。',
+    '- 缺的东西写在最前面，不要藏在后面。',
+    '- 每条必须具体到能看见：写「六级还没过」，不写「需要提升英语」；写「没写过学术论文」，不写「学术能力不足」。',
+    '- 不要写「建议多实习」这种谁都能说的话。要说清楚是哪一类单位、做什么事、大概什么时候开始。',
+    '- 材料里看不出来的地方，就写「看不出来」，不要猜。',
+    '- 只谈事实和差距，不评价他这个人。',
+    '',
+    '输出用 Markdown，三段：',
+    '## 差什么',
+    '## 目标要什么、现在有什么',
+    '## 先补哪一条',
+    '「差什么」按要紧程度排，第一条要是最难绕过去的那一条。',
+    '不要鼓励，不要总结，直接说差距。',
+  ].join('\n')
+
+  const user = [
+    '【他现在有什么】',
+    '',
+    profileBlock(profile),
+    '',
+    '【目标】',
+    want === '' ? '（他没填目标。按上面「想去哪」那一段判断。）' : want,
+    '',
+    '【要你做什么】',
+    '把目标要求的和他现在有的并排列出来，缺的写在最前面。',
+  ].join('\n')
+
+  return { system, user }
+}
+
+// ── 从模型输出里扒步骤 ────────────────────────────────────────────
+
+/** 按 `｜` 或 `|` 切三段，第三段之后的内容原样留在第三段里。 */
+function splitPipes(text) {
+  const parts = []
+  let cur = ''
+  for (const ch of String(text ?? '')) {
+    if (parts.length < 2 && (ch === '｜' || ch === '|')) {
+      parts.push(cur)
+      cur = ''
+      continue
+    }
+    cur += ch
+  }
+  parts.push(cur)
+  return parts.map((part) => part.trim())
+}
+
+/**
+ * 从一段模型输出里抽出步骤。
+ *
+ * 认两种行：
+ *   - 这一步做什么｜大概什么时候｜怎么算做完了
+ *   1. 这一步做什么
+ * 认不出来的行直接跳过，不报错——模型常常在前后写几句解释。
+ * @returns {Array<{text: string, when: string, done: string}>}
+ */
+export function parseSteps(text) {
+  const out = []
+  for (const raw of String(text ?? '').split(/\r?\n/)) {
+    const line = raw.trim()
+    if (line === '') continue
+    if (/^#{1,6}\s/.test(line)) continue
+    if (/^[|｜]/.test(line)) continue
+
+    let body = ''
+    const bullet = /^[-*+]\s+(.+)$/.exec(line)
+    if (bullet !== null) {
+      body = bullet[1].trim()
+    } else {
+      const numbered = /^\d+\s*[.、)．]\s*(.+)$/.exec(line)
+      if (numbered !== null) {
+        body = numbered[1].trim()
+      } else {
+        const chinese = /^第\s*[\d一二三四五六七八九十]+\s*步\s*[:：、.．]?\s*(.+)$/.exec(line)
+        if (chinese === null) continue
+        body = chinese[1].trim()
+      }
+    }
+    if (body === '') continue
+    const [first = '', second = '', third = ''] = splitPipes(body)
+    if (first === '' && second === '' && third === '') continue
+    out.push({ text: first, when: second, done: third })
+  }
+  return out
+}
+
+export default {
+  CAREER_DIR,
+  PROFILE_REL,
+  PURPOSE_REL,
+  renderProfileMarkdown,
+  parseProfileText,
+  renderPlanMarkdown,
+  parsePlanText,
+  readProfile,
+  writeProfile,
+  readPlan,
+  writePlan,
+  buildResumePrompt,
+  buildPathPrompt,
+  buildGapPrompt,
+  parseSteps,
+}