墨穗app.notebase.cn
控制台
内容库
动态
管理
账户
U
用户
--
在线
v1.0.165 · 墨穗笔记
笔记

Notebase墨穗
静水流深,落墨成穗。

0笔记
0工具
30推荐

分类导航

按主题直达

编辑精选

站内用户贡献 · 真实笔记

最新收录

每日更新
继续浏览全部内容 →

笔记

0
加载中...

工具

0

此页用于记录用户反馈问题后的每一次改进

关于

笔记用法

“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本,起稿或二次编辑时都能随时切换,同一篇笔记想用哪种形态来记,都由你说了算。

md、txt、csv、json 这类纯文本则原样载入,不做多余加工。拿一张现成的表倒进来、改几笔、再导出去,等于白用一台免费的格式转换器。

要带走就在右上角点“下载”,可导出 PDF、Word、Markdown、Excel、TXT 等格式;列表卡片“⋯”菜单里,也有同样的下载入口。

工具用法

在“工具”页点“+ 上传工具”即可发布:填好名称与链接,再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用,比堆介绍实在。

要分发安装包就一并上传压缩包(ZIP、RAR、7Z、TAR.GZ,最大 35MB),别人在详情页一键下载;只放链接不带附件也可以。

工具按大家的收藏热度排序,好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。

隐藏笔记

写笔记时勾上“隐藏”,这篇就只存在于你自己的账号里:不进列表、不进搜索、不上首页精选,也不会出现在任何公开的页面,链接发给别人同样打不开。

适合放密码、草稿、日记这类只给自己看的内容;想公开,去“发布”打开它,把“隐藏”的勾去掉再保存,之后编辑会默认保持原状态,不会悄悄变回公开。

不想公开、只想临时给人看:点“分享”生成一条带密码和有效期的链接,到期自动失效,你也能随时撤销。

数据安全

你的内容会同时保存在多个副本上,系统定期做备份与完整性校验,再配合异地容灾机制:就算某台机器出问题,数据也不会丢,可以长期放心存放;特别重要的资料,仍建议你另外再留一份备份。

技术

全站跑在容器化、模块化的现代架构上,更新、部署、回滚都很快,扩展性和稳定性都按长期运营的标准来设计(Built for reliability, designed to scale)。

理念

这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。

原则

不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。

更多

产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。

举报

如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。

趋势

// 点击导航加载发现
归档
// 归档为空
最近浏览
// 暂无浏览记录
发布
// 加载中...
用户发布
// 加载中...
用户管理
// 加载中...
访问统计
// 加载中...
内容审核
// 加载中...
个人信息
// 加载中...
返回首页

Sepia:为AI写作注入人性化叙事架构的开源技能包

other

Sepia 是一套基于叙事架构修复与场景匹配规则的开源写作技能包,让 Claude Code、Codex 等 AI 工具写出更自然、更有文学质感的中长文本。

为什么需要 Sepia?——AI 写作的“塑料感”之痛

如果你经常使用 Claude Code、Codex 或 Grok Build 生成小说、散文、技术博客或商业文案,你一定会遇到以下问题:

  • 叙事扁平:AI 生成的故事像流水账,缺乏张力、转折和人物弧光,读起来像产品说明书。
  • 风格错位:让 AI 写一篇学术论文,它却用营销口吻;让它写一封商务邮件,它又像在写小说。
  • 结构松散:长文生成后,段落之间缺乏逻辑衔接,像是拼凑的碎片。
  • “AI 味”浓重:大量使用“总之”“值得注意的是”“综上所述”等套话,读者一眼就能看出是机器写的。

这些问题根源于大语言模型的训练目标——追求“平均正确”的文本,而不是“有作者意图”的叙事。而 Sepia 的诞生,正是为了修复这种“去人性化”的写作缺陷。

Sepia 是什么?

Sepia 是一个基于 StoryScope 叙事架构理论(arXiv:2604.03136)的写作技能包,它通过一系列可复用的规则、模板和提示词,让 AI 在生成文本时遵循:

  1. 叙事架构修复:自动检测并补全故事中的缺失元素(如冲突、转折、人物动机),重建“起承转合”的节奏。
  2. 场景匹配规则:针对不同写作场景(小说、技术文档、商务邮件、新闻稿等),动态调整语气、句长、词汇密度和修辞手法。

它不是一个独立的编辑器,而是作为 Claude Code、Codex、Grok Build、Antigravity 等 AI 编程/写作工具的“技能插件”存在,通过 Shell 脚本和配置文件注入到工作流中。

安装与使用:三分钟上手

安装要求

  • 已安装 Node.js 16+ 或 Python 3.9+(取决于你使用的 AI 工具)
  • 已配置好 Claude Code / Codex 等 CLI 环境
  • Git 已安装

安装步骤

bash

克隆仓库

git clone https://github.com/Nanako0129/sepia.git
cd sepia

运行安装脚本(自动检测当前 AI 工具并配置)

./install.sh

验证安装(输出当前激活的规则版本)

./sepia --version

基本使用:在 Claude Code 中启用 Sepia 技能

在 ~/.claude/commands/ 目录下创建 sepia.md 文件,内容如下:

markdown

name: sepia
描述: 使用 Sepia 叙事架构修复规则生成文本

请严格遵循以下规则生成文本:

  1. 叙事结构:必须包含“铺垫-冲突-转折-升华”四段式。
  2. 场景匹配:根据用户指定的文体(小说/论文/邮件),套用对应的风格参数。
  3. 禁用词汇:避免“总之”“值得注意的是”“综上所述”等 AI 套话。
  4. 句长控制:叙事段落平均句长不超过 20 字,技术文档不超过 25 字。
  5. 修辞要求:至少使用 2 种修辞手法(隐喻、排比、设问等)。

然后,让 Claude Code 执行 sepia 命令,并输入你的写作要求:

bash
claude -p "用 sepia 风格写一篇关于人工智能伦理的短篇小说,800字"

或者,在 Codex 中通过环境变量激活:

bash
CODEX_PLUGIN=sepia codex "写一篇产品发布会的新闻稿"

高级用法:自定义场景规则

Sepia 允许你通过编辑 rules/ 目录下的 YAML 文件来定制场景。例如,创建一个 rules/tech-blog.yaml:

yaml
name: 技术博客
匹配关键词: [技术, 教程, 博客]
参数:
语气: 专业但友好
句长: 20-30字
词汇: 允许专业术语,但需首次出现时加解释
结构: 问题-方案-验证-总结
禁用: [众所周知, 显而易见, 快速上手]

保存后,运行 ./sepia reload 即可生效。

核心亮点:为什么 Sepia 与众不同?

1. 基于学术理论的深度架构

Sepia 不是简单的提示词集合,而是基于 StoryScope 叙事架构理论 实现。该理论将文本视为一个“叙事系统”,包含情节、角色、视角、节奏、主题五个维度。Sepia 的规则引擎会逐项检查这些维度,并自动生成修复建议。例如,当检测到故事缺乏冲突时,它会自动插入“价值观对立”或“资源争夺”的冲突类型,而不是生硬地加一个“突然出现的神秘人物”。

2. 场景自适应的动态规则

大多数写作工具只有一套固定的“写作风格”,而 Sepia 内置了 20+ 种场景模板(小说、剧本、学术论文、技术文档、商务邮件、新闻稿、广告文案、社交媒体短句等)。它会根据用户输入的关键词自动选择模板,甚至允许混合场景(如“用小说笔法写技术博客”)。

3. 与 CLI 工具的深度集成

Sepia 提供 Shell 脚本,可直接嵌入 Claude Code、Codex 等工具的 pre-command 钩子中。这意味着每次生成文本前,Sepia 会自动注入规则,无需手动复制粘贴提示词。它还支持 --dry-run 模式,让你看到规则如何影响输出。

4. 可解释的反馈机制

当 AI 生成文本后,Sepia 会输出一份“架构诊断报告”,标注哪些叙事元素缺失、哪些风格参数偏离,并给出修改建议。这相当于给 AI 写作加了一个“语法检查器”,不过检查的是叙事逻辑和文体风格。

适用场景:谁需要 Sepia?

  • 小说家/剧本创作者:用 AI 生成初稿,但苦于“AI 味”太重,需要快速修复叙事结构。
  • 技术写作者:需要将复杂技术概念写得通俗易懂,同时保持专业严谨。
  • 营销文案人员:需要根据不同的品牌调性(活泼/严肃/高端)调整文案风格。
  • 学术研究者:需要生成文献综述或论文初稿,避免口语化和逻辑松散。
  • AI 工具重度用户:经常使用 Claude Code / Codex 生成代码注释、README、项目文档,希望文档读起来更自然。

与同类项目对比

项目 核心策略 优点 缺点
Sepia 基于叙事架构理论 + 场景规则 学术深度高,场景覆盖广,可解释性强 需要一定配置成本,对新手不友好
PromptPerfect 自动优化提示词 上手简单,支持多语言 只优化提示词,不深入文本结构
TextFX Google 实验性写作工具 免费,适合创意写作 不支持 CLI 集成,场景有限
LangChain 的写作链 通过链式调用多次生成 灵活,可自定义 需要编程基础,且对长文本支持弱
AutoWriter 基于模板的生成 快速,适合固定格式 模板僵化,无法处理复杂叙事

Sepia 的独特优势在于它把“写作理论”变成了“可执行的规则”,而不是仅仅停留在提示词层面。它更适合那些对文本质量有较高要求的专业写作者。

实际测试:一个对比案例

为了验证效果,我们让 Claude Code 分别用默认模式和 Sepia 模式写一段 300 字的小说开头。

默认模式输出(节选):

在一个遥远的未来,人类已经移民到火星。主角李雷是一个工程师,他每天的工作是维护氧气站。有一天,他发现了一个异常数据,于是他决定去调查。

Sepia 模式输出(节选):

火星的黄昏是锈红色的,像一块被氧化了的铁皮。李雷站在氧气站的穹顶下,听着空气循环系统发出稳定的嗡鸣——那是整个殖民地的心跳。但今天,心跳乱了。数据显示,第47号气阀在过去的72小时里,泄漏了0.3%的氧气。这个数字太小,小到系统自动忽略了它。但李雷知道,在火星上,0.3%意味着死亡。他摘下安全帽,擦掉额头的汗,决定去那个废弃的管道舱看看。那里,似乎有什么东西在等着他。

可以看到,Sepia 模式下的文本有了更具体的场景、更细腻的感官描写、更明确的冲突(0.3%的泄漏 vs 死亡),以及一个悬疑的钩子。这就是叙事架构修复的威力。

局限性与改进方向

  • 学习曲线:需要用户理解“叙事架构”的基本概念,否则可能不知道如何调整规则。
  • 依赖 CLI 环境:不支持 Windows 原生 PowerShell,需要 WSL 或 Git Bash。
  • 规则冲突:当多个场景模板混合时,可能出现规则冲突,需要手动调整优先级。
  • 语言支持:目前主要针对英文和中文,其他语言支持有限。

未来版本计划加入可视化规则编辑器,以及针对多语言语料的自动规则生成。

结语

Sepia 是一个“小而美”的工具,它不试图取代 AI 写作,而是给 AI 写作加上一层“叙事过滤器”。如果你厌倦了 AI 生成的“塑料感”文本,或者需要让 AI 输出的内容更贴合特定场景,Sepia 值得一试。它目前已有 494 个 Star,社区活跃,作者持续更新,是一个充满潜力的开源项目。

项目链接:https://github.com/Nanako0129/sepia

相似推荐
Surge把《Refactoring UI》变成可执行的代码:一个让AI自动遵循设计原则的Claude Skill腾讯WeMM-Embedding:统一多模态嵌入模型,开启跨模态检索新范式hello-sdd:从零掌握规格驱动开发的实战教程孙式写作心法:从白月光之痛蒸馏出的互联网嘴替圣经simplify-codebase:用数学证明的方式安全消除代码库中的意外复杂度
编写使用方法
Markdown 格式 · Ctrl+Enter 确定
0 字新建笔记
欢迎回来
登录你的墨穗笔记账户
忘记密码?
还没有账户?立即注册
创建账户
注册你的专属墨穗笔记
已有账户?去登录
找回密码
输入注册邮箱获取验证码
返回登录
请输入图片中的验证码以继续注册
加载中...
取消
新建收藏
手动添加你喜欢的内容
取消
编辑头像与昵称
上传新头像或修改你的显示昵称
支持 JPG/PNG,最大 2MB
取消

问题反馈

隐私提醒

取消
编辑工具
受控分享
为这篇笔记生成限时 / 带密码的临时链接
关闭