Persona Forge

工具包 v2.0.0 — 从命令行运行、检查、转换、分析和管理各类实用任务。

命令

所有命令均遵循如下格式：persona-forge [input]

不提供输入时，各命令显示其最近的记录条目；提供输入时，则记录一条带时间戳的新条目。

工作原理

每个领域命令（如 run、check、convert 等）均支持两种模式：

• 读取模式（无参数）：显示其对应日志文件中的最近 20 条记录
• 写入模式（带参数）：向其日志文件追加一行带时间戳的记录，格式为 YYYY-MM-DD HH:MM|，并同时将该操作记录到 history.log

内置工具命令（stats、export 、search、recent、status）则跨所有日志文件聚合数据，用于报告与分析。

数据存储

所有数据均本地存储于 ~/.local/share/persona-forge/ 目录下：

• 每个命令写入各自独立的日志文件（例如：run.log、check.log、generate.log）
• history.log 记录所有写入操作及其时间戳
• 导出文件保存为 export.json、export.csv 或 export.txt
• 不发起任何外部网络请求 — 所有数据均保留在本地磁盘

系统要求

• Bash 4+，且启用 set -euo pipefail
• 标准 Unix 工具： date、wc、du、grep、tail、sed、cat
• 无需额外依赖或软件包安装

适用场景

1. 创建角色档案 — 使用 generate 记录新角色构想，并用 run 执行角色创建流程
2. 分析人格特质 — 使用 analyze 记录特质分析结果，使用 check 记录一致性验证结果
3. 对比角色设定 — 使用 compare 跟踪两个角色的并列评估及差异点
4. 批量生成角色 — 使用 batch 记录批量角色生成任务，并通过 preview 审阅输出结果
5. 导出角色数据 — 将全部角色记录导出为 JSON、CSV 或 TXT 格式，供写作工具或游戏引擎使用

示例

# 生成一个新角色
persona-forge generate "林夜 — protagonist, 武侠 setting, INTJ personality"

# 运行一个创建流程
persona-forge run "Full character sheet for 林夜: backstory + traits + relationships"

# 分析人格特质
persona-forge analyze "林夜: 沉稳 85%, 机敏 90%, 孤傲 70% — INTJ archetype match"

# 检查角色一致性
persona-forge check "林夜 backstory vs personality: no contradictions found"

# 对比两个角色
persona-forge compare "林夜 vs 萧无痕: opposing motivations, complementary skills"

# 预览角色卡
persona-forge preview "林夜 RPG card: STR 14, DEX 18, INT 16, WIS 12"

# 批量处理多个角色
persona-forge batch "Generate 5 NPCs for Act 2 tavern scene"

# 记录配置信息
persona-forge config "Default world: 武侠, output format: markdown"

# 将全部角色数据导出为 JSON
persona-forge export json

# 搜索某个角色
persona-forge search 林夜

# 查看最近活动
persona-forge recent

# 检查系统状态
persona-forge status

输出

所有命令结果均输出至 stdout。如需保存，可重定向至文件：

persona-forge stats > persona-summary.txt
persona-forge export csv

由 BytesAgain 提供支持 | bytesagain.com | hello@bytesagain.com