@wishp3/dsh-friend-persona

角色卡存取、酒馆卡导入、预设注册、人格提示词分区。

Host 入口仍是 src/index.ts（由接线任务挂载）。本包已导出的模块：

数据根目录解析优先级

resolveFriendDataDir({ dshHome?, override?, env?, homedir? }) 是纯函数，不会写死 ~/.dsh。第一个非空值生效：

角色卡路径：/characters//persona.json。

单元测试一律把 override 指到 os.tmpdir()；读取默认回退时传入 env: {}，避免本机真实 DSH_HOME 泄漏进断言。

写入前校验这些字段（手写类型守卫，不引入 zod，也不运行时依赖 @deepseek-ai/schemastery）：

persona 字段	酒馆来源	回退
`name`	`data.name` / `char_name`	`Unnamed Character`
`personality`	`data.personality`	`""`
`background`	`description`/`char_persona` + `scenario`/`world_scenario`	`""`
`speakingStyle`	`system_prompt`，否则 `post_history_instructions`；若有 `mes_example` 则追加	`""`
`language`	`extensions.language` / `speak_language`	`zh-CN`
`nickname`	`extensions.nickname`；`{{user}}` 视为未设	`你`
`greetings`	`first_mes`/`char_greeting` + `alternate_greetings`	`[]`
`live2dModel`	`extensions.live2dModel` / `live2d`	省略
`voice`	`extensions.voice`	省略
`tags`	`data.tags`	`[]`