dsh-lifecard 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -199,6 +199,31 @@ books/<书名>/chapters/001.md 正文,一章一个文件
199
199
  - **左半边**是你自己:基本情况、学过什么、做过什么、会用哪些工具、想去哪、还差什么。照这个可以直接写一份简历(它会按你填的「想投哪儿」调重点),也能看「差在哪」。
200
200
  - **右半边**是路怎么走:终点长什么样、分几步、现在这一步、可能会卡在哪。
201
201
 
202
+ 还能**从一张人物卡里读**:挑一张已有的卡,让它把里面「确实写着的事实」摘出来(做过什么、学过什么、会用什么工具、想去哪),每条都带一句原文。摘出来的东西先列给你看,你勾哪些才并进简历。它不改写、不总结、不把「喜欢看书」升格成「阅读量大」——卡记的是这个人是谁,简历记的是他做过什么,这两步中间不许模型自己跨过去。
203
+
204
+ ### 写日记
205
+
206
+ **真实人物记录** 门里的工具行有「写日记」。第一次点会问你日记存在哪个文件夹(默认给你填好一个位置,看不顺眼可以改);之后一天一篇,文件名就是日期。
207
+
208
+ 点中间的按钮会开一个新对话,它按这个顺序带你写:今天哪件事最值得讲 → 情绪往下三层(是什么情绪、指向什么、为此做了什么)→ 落到一个明天真能做的决定。末尾给健康、工作、关系、玩各打一个分,不想打就跳过。收尾是五节:今天最值得讲的一件事、当时在想什么、情绪往下三层、我做了什么决定、下一步(一行一条,是能勾掉的事)。
209
+
210
+ **写进去的每一句都是你的话**,它不替你润色成书面语,也不评价你今天过得好不好。存盘走的是"存好了"那个动作,不是"聊完就算了"——存完会告诉你文件落在哪个绝对路径。
211
+
212
+ 那一屏上还能翻开之前某一天看(点日期就开),也能换文件夹(换之前会问一句,因为旧的那些不会跟过来,它们还在原处)。
213
+
214
+ ### 人物关系网
215
+
216
+ **真实人物记录** 门里的工具行有「人物关系网」。它画一张以「我」为中心的图:中间是你自己,最里面一圈是直接和你有关系的人,外面一圈是只通过别人认识的。旁边按「直接认识」「通过别人」列成名单,每个人后面写着他和你的关系。
217
+
218
+ 两类关系分开记,互不覆盖:
219
+
220
+ - **卡片上那个「和我什么关系」**——一个人只有一个:他是我爸、他是我大学同学。这张网的第一圈就是按它连的。
221
+ - **两个人之间的关系**——可以有很多条,而且分方向:「表姐」和「妈妈」之间是「也是母女」,「爸爸」和「妈妈」之间是「夫妻」。点「连两个人」,选两头、选关系、写一句当时的话,就多一条线。已经连上的能点开看,也能断开(断开后会留在回收目录,不是真删)。
222
+
223
+ 网外还有一栏「卡片在,但还没写出和你是什么关系」——那不是错,只是还没问到。世界书、设定、偏好这些不算人,不会混进这张网。
224
+
225
+ **它只按你写下的东西连。** 你从来没写过「表姐是妈妈的女儿」,它就不会自己猜出来。
226
+
202
227
  ### 不想要某个功能,可以整块删掉
203
228
 
204
229
  写小说、酒馆、文字游戏、预设、简历与规划,这五块是**可拆卸**的:删掉对应的文件,别的功能照常能用,被删掉的那扇门会自己从界面上消失,别人点进来也不会报错,只会说「这个功能没装」。
@@ -289,7 +314,7 @@ plugin/lib/career.js 删了 = 没有「简历与规划」
289
314
  ## 开发
290
315
 
291
316
  ```bash
292
- node test/all.mjs # 全部测试(1494 项)
317
+ node test/all.mjs # 全部测试(4006 项)
293
318
  node test/roundtrip.mjs # YAML ↔ Markdown 往返
294
319
  node test/codec-test.mjs # 酒馆卡编解码 + 双 chunk 同源
295
320
  node test/store-test.mjs # 文件层:墓碑、提案、引文门、采纳
@@ -304,6 +329,8 @@ node test/client-smoke.mjs # 浏览器 bundle:加载、注册、渲染
304
329
  | `lib/codec.js` | CCv2/V3/PNG tEXt/CHARX 编解码,保真,双 chunk 同源 |
305
330
  | `lib/store.js` | 工作区读写、快照、墓碑、提案、采纳、doctor |
306
331
  | `lib/prompts.js` | 访谈问题库、分析提示词 |
332
+ | `lib/diary.js` | 日记:一天一篇、往返不丢用户手写的东西 |
333
+ | `lib/career.js` | 简历与规划、从卡里摘经历 |
307
334
  | `lib/index.js` | 宿主路由 |
308
335
  | `lib/client.js` | 侧边栏界面(`__ModuleLoader__` 格式) |
309
336
 
package/lib/client.js CHANGED
@@ -1962,6 +1962,7 @@ function LifeCardTab(props) {
1962
1962
  openCard(hit)
1963
1963
  },
1964
1964
  onTalk: (name) => startInterview({ about: name, mode }),
1965
+ relations: state?.relations ?? [],
1965
1966
  })
1966
1967
  case VIEWS.career:
1967
1968
  return h(CareerView, { flash, cards: listing?.cards ?? [], onOpenCard: openCard, onBack: () => setView(VIEWS.home) })
@@ -3582,10 +3583,19 @@ function keepButton(busy, dir, keep) {
3582
3583
  * 我有关系的人,2 圈是只和 1 圈里的人有关系的人。没有任何关系线索的
3583
3584
  * 人不进网,收在底下那一行——不收进来的话,他们会像凭空消失了一样。
3584
3585
  */
3585
- function NetView({ onBack, onOpen, onTalk }) {
3586
+ function NetView({ onBack, onOpen, onTalk, relations }) {
3586
3587
  const [net, setNet] = useState(null)
3587
3588
  const [err, setErr] = useState(null)
3588
3589
  const [showOutside, setShowOutside] = useState(false)
3590
+ // 连两个人这件事以前完全没有入口:网画得出来,却没法往里加一条线。
3591
+ // addOpen 是那一小块表单收没收起来;a/b 是选中的两端(存 id);
3592
+ // rtype 是关系叫法,note 是「当时那句话」。
3593
+ const [addOpen, setAddOpen] = useState(false)
3594
+ const [a, setA] = useState('')
3595
+ const [b, setB] = useState('')
3596
+ const [rtype, setRtype] = useState('')
3597
+ const [note, setNote] = useState('')
3598
+ const [saving, setSaving] = useState(false)
3589
3599
 
3590
3600
  useEffect(() => {
3591
3601
  let alive = true
@@ -3597,6 +3607,55 @@ function NetView({ onBack, onOpen, onTalk }) {
3597
3607
  return () => { alive = false }
3598
3608
  }, [])
3599
3609
 
3610
+ /** 改完一条边要重画:新连上的人可能从「网外」挪进圈里。 */
3611
+ const reload = async () => {
3612
+ const r = await call('relations.net', {}).catch((e) => ({ ok: false, error: humanizeError(e) }))
3613
+ if (r?.ok !== true) { setErr(r?.error ?? '这张网没读出来'); return false }
3614
+ setNet(r)
3615
+ setErr(null)
3616
+ return true
3617
+ }
3618
+
3619
+ /** 把选中的两个人连起来。存完顺手收起表单、清空,下一次连不用重新选。 */
3620
+ const connect = async () => {
3621
+ if (saving === true) return
3622
+ if (a === '' || b === '') { setErr('两头都得挑一个人。'); return }
3623
+ setSaving(true)
3624
+ try {
3625
+ const r = await call('relations.save', { from: a, to: b, type: rtype, note })
3626
+ if (r?.ok !== true) { setErr(r?.error ?? '这条关系没连上'); return }
3627
+ const ok = await reload()
3628
+ if (ok !== true) return
3629
+ setAddOpen(false)
3630
+ setA('')
3631
+ setB('')
3632
+ setRtype('')
3633
+ setNote('')
3634
+ } catch (e) {
3635
+ setErr(humanizeError(e))
3636
+ } finally {
3637
+ setSaving(false)
3638
+ }
3639
+ }
3640
+
3641
+ /** 断开一条。会先问一句——断开是搬走不是抹掉,但仍然不该手滑就没。 */
3642
+ const cut = async (edgePath) => {
3643
+ const sure = typeof window !== 'undefined' && typeof window.confirm === 'function'
3644
+ ? window.confirm('断开这条关系?断开以后那两个人不一定还在圈里,原来的那份会留在回收目录里。')
3645
+ : true
3646
+ if (sure !== true) return
3647
+ setSaving(true)
3648
+ try {
3649
+ const r = await call('relations.delete', { path: edgePath })
3650
+ if (r?.ok !== true) { setErr(r?.error ?? '这条关系没断开'); return }
3651
+ await reload()
3652
+ } catch (e) {
3653
+ setErr(humanizeError(e))
3654
+ } finally {
3655
+ setSaving(false)
3656
+ }
3657
+ }
3658
+
3600
3659
  if (net === null) {
3601
3660
  return h('div', { className: 'lc-pad lc-stack' },
3602
3661
  err === null
@@ -3703,6 +3762,81 @@ function NetView({ onBack, onOpen, onTalk }) {
3703
3762
  tone === undefined ? null : h(Tag, { tone }, tone === 'ok' ? '直接认识' : '通过别人'),
3704
3763
  )
3705
3764
 
3765
+ // 连两个人都得先有人:只有一张卡的时候连不起来。
3766
+ const people = [
3767
+ ...(self === null ? [] : [self]),
3768
+ ...inner,
3769
+ ...outer,
3770
+ ...outside.map((one) => ({ ...one, kind: one.kind ?? 'real', relationLabel: '' })),
3771
+ ]
3772
+ const catalogue = (relations?.length ?? 0) > 0 ? relations : RELATION_FALLBACK
3773
+ const nameOfId = (id) => {
3774
+ const hit = people.find((one) => String(one.id ?? '') === String(id ?? ''))
3775
+ return hit === undefined ? String(id ?? '') : String(hit.name ?? '')
3776
+ }
3777
+ const typeLabel = (edge) => {
3778
+ if (String(edge?.label ?? '').trim() !== '') return String(edge.label)
3779
+ const hit = catalogue.find((one) => String(one.id ?? '') === String(edge?.type ?? ''))
3780
+ return hit === undefined ? String(edge?.type ?? '没有分类') : String(hit.label ?? hit.id)
3781
+ }
3782
+ const edges = Array.isArray(net.edges) ? net.edges : []
3783
+ const edgeRow = (edge) => h('div', {
3784
+ key: String(edge.path ?? `${edge.from}-${edge.to}`),
3785
+ className: 'lc-listrow',
3786
+ style: { display: 'flex', alignItems: 'center', gap: 9 },
3787
+ },
3788
+ h('span', { className: 'lc-grow' },
3789
+ h('div', null, `${nameOfId(edge.from)} → ${nameOfId(edge.to)}`),
3790
+ h('div', { className: 'lc-meta' },
3791
+ typeLabel(edge),
3792
+ String(edge.note ?? '').trim() === '' ? '' : ` · ${String(edge.note).trim()}`),
3793
+ ),
3794
+ h(Btn, { tone: 'ghost', size: 'sm', disabled: saving === true, onClick: () => cut(edge.path) }, '断开'),
3795
+ )
3796
+
3797
+ const picker = (value, set, label) => h('label', { className: 'lc-fitem' },
3798
+ h('span', { className: 'lc-flabel' }, label),
3799
+ h('select', {
3800
+ className: 'lc-select', value, style: { flex: 1, minWidth: 0 },
3801
+ onChange: (e) => set(e.target.value),
3802
+ },
3803
+ h('option', { value: '' }, '(挑一个人)'),
3804
+ ...people.map((one) => h('option', { key: one.id, value: String(one.id) }, String(one.name ?? one.id))),
3805
+ ),
3806
+ )
3807
+
3808
+ const connectForm = addOpen !== true
3809
+ ? null
3810
+ : h('div', { className: 'lc-stack', style: { marginTop: 8 } },
3811
+ h('div', { className: 'lc-meta' }, '把两个人连起来。比如「表姐」和「妈妈」之间是「也是母女」。'),
3812
+ picker(a, setA, '谁'),
3813
+ picker(b, setB, '和谁'),
3814
+ h('label', { className: 'lc-fitem' },
3815
+ h('span', { className: 'lc-flabel' }, '是什么关系'),
3816
+ h('select', {
3817
+ className: 'lc-select', value: rtype, style: { flex: 1, minWidth: 0 },
3818
+ onChange: (e) => setRtype(e.target.value),
3819
+ },
3820
+ h('option', { value: '' }, '(还没想好也行)'),
3821
+ ...catalogue.map((one) => h('option', { key: one.id, value: one.id }, String(one.label ?? one.id))),
3822
+ ),
3823
+ ),
3824
+ h('label', { className: 'lc-fitem' },
3825
+ h('span', { className: 'lc-flabel' }, '一句当时的话(可以不写)'),
3826
+ h('input', {
3827
+ className: 'lc-input', value: note, placeholder: '比如:她俩其实一直不太对付',
3828
+ onChange: (e) => setNote(e.target.value),
3829
+ }),
3830
+ ),
3831
+ h('div', { className: 'lc-row' },
3832
+ h(Btn, {
3833
+ tone: 'primary', disabled: saving === true || a === '' || b === '',
3834
+ onClick: connect,
3835
+ }, saving === true ? '正在记…' : '连起来'),
3836
+ h(Btn, { onClick: () => { setAddOpen(false); setErr(null) } }, '先不连'),
3837
+ ),
3838
+ )
3839
+
3706
3840
  return h('div', { className: 'lc-pad lc-stack' },
3707
3841
  h('div', { className: 'lc-meta' },
3708
3842
  self === null
@@ -3746,6 +3880,27 @@ function NetView({ onBack, onOpen, onTalk }) {
3746
3880
  ),
3747
3881
  ),
3748
3882
 
3883
+ // 已经连上的那些线。网的图里只画「谁带谁进来」的那一条,这里列的是
3884
+ // 全部——同一个人身上可以有好几条(我妈和我表姐之间也有关系)。
3885
+ edges.length === 0
3886
+ ? null
3887
+ : h('div', { className: 'lc-sec' },
3888
+ h(GroupTitle, { icon: 'relation' }, `已经连上的(${edges.length})`),
3889
+ h('div', { className: 'lc-stack' }, edges.map(edgeRow)),
3890
+ ),
3891
+
3892
+ people.length < 2
3893
+ ? null
3894
+ : h('div', { className: 'lc-sec' },
3895
+ addOpen === true
3896
+ ? null
3897
+ : h(Btn, {
3898
+ tone: 'doctor', icon: 'plus', disabled: saving === true,
3899
+ onClick: () => { setAddOpen(true); setErr(null) },
3900
+ }, '连两个人'),
3901
+ connectForm,
3902
+ ),
3903
+
3749
3904
  err === null ? null : h(Err, { text: err }),
3750
3905
 
3751
3906
  h('div', { className: 'lc-row' },
@@ -3755,8 +3910,12 @@ function NetView({ onBack, onOpen, onTalk }) {
3755
3910
  h('div', { className: 'lc-grow' }),
3756
3911
  h(Btn, { onClick: onBack }, '回去'),
3757
3912
  ),
3758
- h('div', { className: 'lc-meta' },
3759
- '这张网只按卡片上写的关系连。想连得更细(谁和谁也有关系),现在还没有地方能写——那要一段一段自己填。'),
3913
+ // 只有一个人的时候没有「连两个人」那个按钮,这句话就不能再说它,
3914
+ // 否则读起来像界面上有个不存在的东西。
3915
+ people.length < 2
3916
+ ? null
3917
+ : h('div', { className: 'lc-meta' },
3918
+ '卡片上写的那个关系是「他和我」。谁和谁之间还有别的关系(表姐也是妈妈的女儿),用上面的「连两个人」加一条线。'),
3760
3919
  )
3761
3920
  }
3762
3921
 
package/lib/core.js CHANGED
@@ -772,8 +772,12 @@ export function validateCard(data, options = {}) {
772
772
  if (data?.system !== undefined) {
773
773
  add('warn', '卡上不应有 system 字段;系统在调用时用 --system 指定(见 SPEC §5)', 'system')
774
774
  }
775
- // affect 挂在关系边上,不在卡上
776
- if (data?.affect !== undefined) {
775
+ // affect 挂在关系边上,不在卡上。
776
+ // 所以「有 affect」这件事本身,只有在一张**人物的**卡上才值得提醒:
777
+ // 关系边(kind: relation)本来就该有 affect,那是它唯一该在的地方。
778
+ // 以前不判 kind,于是每存一条边都跳一句「不该出现在卡上」——写边的
779
+ // 界面刚一上线,用户第一次点保存就会被自己的插件告一次状。
780
+ if (data?.affect !== undefined && kind !== 'relation') {
777
781
  add('warn', 'affect 属于关系边(relations/*.relation.md),不该出现在卡上', 'affect')
778
782
  }
779
783
  if (kind === 'real' || kind === 'fictional' || kind === 'hybrid') {
@@ -1069,10 +1073,14 @@ export function relationEdge(data) {
1069
1073
  from: String(data?.from ?? ''),
1070
1074
  to: String(data?.to ?? ''),
1071
1075
  type: String(data?.structure?.type ?? ''),
1076
+ // 类型是那十几种固定叫法时,界面上显示的是类型;用户自己写的那句话
1077
+ // 存在 label 里,否则「隔壁王叔」这种关系只能显示成「自己填」。
1078
+ label: String(data?.structure?.label ?? ''),
1072
1079
  affinity: latest?.affinity,
1073
1080
  trust: latest?.trust,
1074
1081
  authority: numOr(data?.power?.authority, undefined),
1075
1082
  dependency: numOr(data?.power?.dependency, undefined),
1083
+ note: String(latest?.note ?? ''),
1076
1084
  at: latest?.at,
1077
1085
  }
1078
1086
  }
package/lib/index.js CHANGED
@@ -1176,11 +1176,88 @@ function buildApi(ctx, workspace, config, options) {
1176
1176
  ok: true,
1177
1177
  self: selfCard === null ? null : nodeOf(selfCard),
1178
1178
  rings: { self: rings[0], inner: rings[1], outer: rings[2] },
1179
- edges: edges.map((e) => ({ from: String(e.from ?? ''), to: String(e.to ?? ''), type: String(e.type ?? '') })),
1179
+ // 边不只要「谁连谁」,还要能拿回去编辑:路径是它在磁盘上的位置,
1180
+ // 点开一条边要能读到类型、亲疏、当时那句话。
1181
+ edges: edges.map((e) => ({
1182
+ path: String(e.path ?? ''),
1183
+ from: String(e.from ?? ''),
1184
+ to: String(e.to ?? ''),
1185
+ type: String(e.type ?? ''),
1186
+ label: String(e.label ?? ''),
1187
+ affinity: e.affinity,
1188
+ trust: e.trust,
1189
+ authority: e.authority,
1190
+ dependency: e.dependency,
1191
+ note: String(e.note ?? ''),
1192
+ at: String(e.at ?? ''),
1193
+ })),
1180
1194
  counts: { self: rings[0].length, inner: rings[1].length, outer: rings[2].length, outside: outside.length },
1181
1195
  outside,
1182
1196
  }
1183
1197
  },
1198
+
1199
+ /**
1200
+ * 写一条关系边:谁和谁是什么关系。
1201
+ *
1202
+ * 这一屏以前只能看图不能改——「我表姐也是我妈的女儿」这件事,
1203
+ * 用户只能自己去 relations/ 里手写 YAML。这里补上那条路。
1204
+ *
1205
+ * 只写一条边,不同时改两张卡:卡片上那个 `relation` 是「他和我」
1206
+ * 的关系(一对一),边是「谁和谁」(可以有很多条)。混在一起写,
1207
+ * 一次点保存会同时动两处,出错时说不清是哪一步坏的。
1208
+ */
1209
+ 'relations.save': async (body) => {
1210
+ const ws = await root(body)
1211
+ const all = await store.listAll(ws)
1212
+ const cards = Array.isArray(all.cards) ? all.cards : []
1213
+ // 两端都可以给 id 或名字——界面上拿到的往往是名字,硬要求 id
1214
+ // 等于让用户自己去看文件名。
1215
+ const findId = (want) => {
1216
+ const key = String(want ?? '').trim()
1217
+ if (key === '') return null
1218
+ const hit = cards.find((c) => String(c.id ?? '') === key)
1219
+ ?? cards.find((c) => String(c.name ?? '').trim() === key)
1220
+ return hit === undefined ? null : hit
1221
+ }
1222
+ const fromCard = findId(body?.from)
1223
+ const toCard = findId(body?.to)
1224
+ if (fromCard === null) return { ok: false, error: `没找到「${String(body?.from ?? '').trim()}」这个人。先在卡片里建好,再来连。` }
1225
+ if (toCard === null) return { ok: false, error: `没找到「${String(body?.to ?? '').trim()}」这个人。先在卡片里建好,再来连。` }
1226
+ if (String(fromCard.id) === String(toCard.id)) {
1227
+ return { ok: false, error: '这两个是同一张卡。关系要连两个不同的人。' }
1228
+ }
1229
+ const saved = await store.writeRelation(ws, {
1230
+ from: fromCard.id,
1231
+ to: toCard.id,
1232
+ type: body?.type,
1233
+ label: body?.label,
1234
+ since: body?.since,
1235
+ affinity: body?.affinity,
1236
+ trust: body?.trust,
1237
+ note: body?.note,
1238
+ authority: body?.authority,
1239
+ dependency: body?.dependency,
1240
+ })
1241
+ if (saved.ok !== true) return saved
1242
+ return {
1243
+ ok: true,
1244
+ path: saved.path,
1245
+ created: saved.created === true,
1246
+ note: saved.created === true
1247
+ ? `连上了:「${fromCard.name || fromCard.id}」对「${toCard.name || toCard.id}」是什么,已经记下来。`
1248
+ : '改好了。',
1249
+ }
1250
+ },
1251
+
1252
+ /** 断开一条关系。搬进回收目录,不直接抹掉(和删卡一样能反悔)。 */
1253
+ 'relations.delete': async (body) => {
1254
+ const ws = await root(body)
1255
+ const safe = await insideWorkspace(ws, body?.path)
1256
+ if (safe.ok !== true) return { ok: false, error: safe.error }
1257
+ const gone = await store.deleteRelation(ws, safe.rel)
1258
+ if (gone.ok !== true) return gone
1259
+ return { ok: true, path: gone.path, note: '这条关系断开了。原来的那份还在回收目录里,需要的话能找回来。' }
1260
+ },
1184
1261
  /**
1185
1262
  * 把一扇门从界面上收起来 / 装回来。
1186
1263
  *
package/lib/store.js CHANGED
@@ -712,6 +712,122 @@ export function cardRelPath(id, world) {
712
712
  return path.posix.join('worlds', core.safeId(world), 'cards', fileName)
713
713
  }
714
714
 
715
+ /**
716
+ * 一条关系边落在 `relations/` 下的相对路径。
717
+ *
718
+ * 文件名只是给人看的;读的时候一律以 frontmatter 里的 from / to 为准
719
+ * (SPEC §4)。所以这里改了命名规则也不会读错老文件。
720
+ */
721
+ export function relationRelPath(from, to) {
722
+ return path.posix.join('relations', core.relationFileName(from, to))
723
+ }
724
+
725
+ /**
726
+ * 写一条关系边(谁和谁是什么关系)。
727
+ *
728
+ * 为什么要有这个函数:`relations/*.relation.md` 这套格式从一开始就在读、
729
+ * 在关系网里画,但**从来没有一条路能把它写出来**——界面上能看见第二圈是
730
+ * 空的,却没有任何地方能填。于是「我表姐也是我妈的女儿」这件事,只能靠
731
+ * 用户自己去 `relations/` 里手写 YAML。
732
+ *
733
+ * 写盘一律走 `writeCard`:那边有快照、有按路径排队、有「读不出来就别写」。
734
+ * 关系边和卡是同一类文件,保护逻辑没理由分两套。
735
+ *
736
+ * @param {object} edge - `{from, to, type, label, since, affinity, trust, note, authority, dependency}`
737
+ * @returns {Promise<{ok: boolean, path?: string, text?: string, error?: string}>}
738
+ */
739
+ export async function writeRelation(root, edge, options = {}) {
740
+ const from = String(edge?.from ?? '').trim()
741
+ const to = String(edge?.to ?? '').trim()
742
+ if (from === '') return { ok: false, error: '这条关系缺了「谁」。' }
743
+ if (to === '') return { ok: false, error: '这条关系缺了「和谁」。' }
744
+ if (from === to) return { ok: false, error: '一个人跟自己的关系,这张网画不出来。换一个人。' }
745
+ const rel = relationRelPath(from, to)
746
+ // 老的那一份要读出来:只改「亲疏」的时候,类型与起始年份得留着,
747
+ // 不然一次保存会把「是我妈」改成空白。
748
+ const existing = await readCard(root, rel)
749
+ if (existing.ok !== true && existing.error !== '文件不存在') return existing
750
+ const old = existing.ok === true ? (existing.data ?? {}) : {}
751
+ const oldStructure = old?.structure !== null && typeof old?.structure === 'object' ? old.structure : {}
752
+ const pick = (next, prev) => (String(next ?? '').trim() === '' ? String(prev ?? '').trim() : String(next).trim())
753
+
754
+ const type = pick(edge?.type, oldStructure.type)
755
+ const label = pick(edge?.label, oldStructure.label)
756
+ const since = pick(edge?.since, oldStructure.since)
757
+ const structure = {}
758
+ if (type !== '') structure.type = type
759
+ if (label !== '') structure.label = label
760
+ if (since !== '') structure.since = since
761
+
762
+ // affect 是「一条一条按时间记下来的感受」,不是当前的数值。
763
+ // 所以有新的才往上追加一条,没有就把老的整段带回去——
764
+ // 覆盖掉等于把「去年夏天开始没那么亲了」这段历史抹平。
765
+ const affects = Array.isArray(old?.affect) ? old.affect.filter((a) => a !== null && typeof a === 'object') : []
766
+ const affinity = clampInt(edge?.affinity, -5, 5)
767
+ const trust = clampFloat(edge?.trust, 0, 1)
768
+ const affinityGiven = edge?.affinity !== undefined && edge?.affinity !== null && String(edge.affinity).trim() !== ''
769
+ const trustGiven = edge?.trust !== undefined && edge?.trust !== null && String(edge.trust).trim() !== ''
770
+ const note = String(edge?.note ?? '').trim()
771
+ if (affinityGiven || trustGiven || note !== '') {
772
+ const one = { at: localDate() }
773
+ if (affinityGiven) one.affinity = affinity
774
+ if (trustGiven) one.trust = trust
775
+ if (note !== '') one.note = note
776
+ affects.push(one)
777
+ }
778
+
779
+ const power = {}
780
+ const oldPower = old?.power !== null && typeof old?.power === 'object' ? old.power : {}
781
+ for (const key of ['authority', 'dependency']) {
782
+ const given = clampFloat(edge?.[key], 0, 1)
783
+ const has = edge?.[key] !== undefined && edge?.[key] !== null && String(edge[key]).trim() !== ''
784
+ const prev = Number(oldPower[key])
785
+ if (has) power[key] = given
786
+ else if (Number.isFinite(prev)) power[key] = prev
787
+ }
788
+
789
+ const data = { lifecard: core.DATA_VERSION, id: `${core.safeId(from)}--${core.safeId(to)}`, kind: 'relation', from: core.safeId(from), to: core.safeId(to) }
790
+ if (Object.keys(structure).length > 0) data.structure = structure
791
+ if (affects.length > 0) data.affect = affects
792
+ if (Object.keys(power).length > 0) data.power = power
793
+
794
+ // `force` 是给「关系边没有正文」这一件事留的:writeCard 的校验只管
795
+ // frontmatter,关系边本来就该是空的正文段,不该因为这个拒写。
796
+ const saved = await writeCard(root, rel, data, [], { ...options, force: options?.force ?? true })
797
+ if (saved.ok !== true) return saved
798
+ return { ok: true, path: rel, text: saved.text, data, created: existing.ok !== true }
799
+ }
800
+
801
+ /** 删掉一条关系边:搬到回收目录,不直接抹掉。 */
802
+ export async function deleteRelation(root, relPath) {
803
+ const rel = String(relPath ?? '')
804
+ if (!rel.endsWith('.relation.md')) return { ok: false, error: '这个位置不是一条关系。' }
805
+ const at = await resolveIn(root, rel)
806
+ if (!at.ok) return { ok: false, error: at.error }
807
+ const exists = await fs.stat(at.abs).then((s) => s.isFile()).catch(() => false)
808
+ if (!exists) return { ok: false, error: '磁盘上找不到这条关系。' }
809
+ const dirAbs = path.join(root, REDACTED_DIR, 'relations')
810
+ await fs.mkdir(dirAbs, { recursive: true })
811
+ const base = path.posix.basename(rel)
812
+ let name = base
813
+ const taken = await fs.access(path.join(dirAbs, name)).then(() => true).catch(() => false)
814
+ if (taken) name = `${base}.${new Date().toISOString().replace(/[:.]/g, '-')}`
815
+ await fs.rename(at.abs, path.join(dirAbs, name))
816
+ return { ok: true, path: rel, redacted: path.posix.join(REDACTED_DIR, 'relations', name) }
817
+ }
818
+
819
+ function clampInt(value, min, max) {
820
+ const n = Math.round(Number(value))
821
+ if (!Number.isFinite(n)) return min
822
+ return Math.max(min, Math.min(max, n))
823
+ }
824
+
825
+ function clampFloat(value, min, max) {
826
+ const n = Number(value)
827
+ if (!Number.isFinite(n)) return min
828
+ return Math.max(min, Math.min(max, n))
829
+ }
830
+
715
831
  /**
716
832
  * 读一张卡(已过墓碑过滤)。
717
833
  *
@@ -2328,6 +2444,9 @@ export default {
2328
2444
  sha256,
2329
2445
  moveCardToRedacted,
2330
2446
  cardRelPath,
2447
+ relationRelPath,
2448
+ writeRelation,
2449
+ deleteRelation,
2331
2450
  readCard,
2332
2451
  writeCard,
2333
2452
  updateCard,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-lifecard",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "description": "Life Cards — 把你认识的人和虚构角色写成档案。在对话里问出来,或导入酒馆角色卡;数据是你自己文件夹里的一组 Markdown 文件。",
5
5
  "type": "module",
6
6
  "icon": "icon.svg",