功能描述

按人物检索并导入长篇小说《主角》(陈彦著，茅盾文学奖)的相关章节，作为后续任务的背景资料。当用户提到《主角》里的人物——主角忆秦娥(本名易招弟、易青娥)，或胡三元、胡彩香、米兰、廖耀辉、封潇潇、楚嘉禾、刘红兵、秦八娃、石怀玉、苟存忠/古存孝/周存仁/裘存义(存字辈老艺人)、单仰平、薛桂生、朱继儒、黄正大、宋雨、...

使用说明 (SKILL.md)

《主角》人物 → 章节导入器

Name: zhujue-characters
Author: junwugit

小说全文已内置于本 skill 的 txt/ 目录（part0000.html~part0151.html，Calibre 导出），共 151 章正文：上部 55、中部 50、下部 45、后记，外加 part0000.html 目录页。skill 自包含、可整体迁移。本 skill 把"按人物找章节"做成查表 + 取文，只导入相关章节，避免整本塞进上下文。

何时使用 / 不使用

使用：用户提到《主角》中的具体人物，并要对人物/关系/情节做分析、问答、找原文、写作等——本 skill 负责定位并导入背景章节，导入后再完成用户真正的任务。
不使用：用户只泛泛说"主角""男主"等普通词、与本小说无关；或用户已自行给出原文。注意"主角"是普通词，仅当语境指向陈彦这部小说（出现上述人名/书名）时才触发。

数据与脚本

txt/ — 内置的小说全文（151 章 HTML，脚本读取时自动去标签）。
data/characters.json — 37 条人物/角色：规范名、别名(aka)、类别、简介、出现章节列表(已建好索引)。
data/chapters.json — 每个 partXXXX.html → 部/章标签(如 上部·二十四)、字数。
scripts/query.py — 运行时查询/导入工具（主要入口）。
scripts/build_index.py — 一次性重建索引（人物表已人工校准；仅当文本变动或要增改人物时重跑）。
references/characters.md — 人类可读的人物名册（含别名与简介），需要总览时读它。

工作流（每次按需）

第 1 步 · 定位章节。 从用户问题里提取人名（任意叫法皆可，别名会自动归并），调用：

python3 scripts/query.py 人物A 人物B ...

输出会给出：解析到谁、并集/交集章节数、采用的集合及章节清单(带 部·章 标签和文件路径)。

第 2 步 · 选对集合（交集 vs 并集）。 按问题性质选：

问两人/多人之间的关系、对手戏、互动、冲突 → 交集（同时出现）：--all（默认在交集非空时就用交集）。
问任一人各自的经历、或要尽量全的素材 → 并集：--any。
单个人物 → 其全部出现章节。
想聚焦某阶段 → 加 --part 上部|中部|下部|后记。

第 3 步 · 导入正文作背景。 章节不多（≈≤15）时，直接生成干净正文再读入：

python3 scripts/query.py 人物A 人物B --part 中部 --text --out /tmp/zhujue_bg.txt

然后用 Read 读 /tmp/zhujue_bg.txt（已去 HTML 标签、带章节分隔）。也可直接对清单里少数关键章节的 partXXXX.html 逐个 Read。

第 4 步 · 基于导入的原文完成用户的真正任务（分析/问答/找引文/写作等）。回答须依据导入正文，不臆造；正文未覆盖处如实说明，可建议扩大检索（换 --any、去掉 --part、或加共现人物）。

护栏：集合过大怎么办

主角忆秦娥出现在全部 151 章。绝不要因为问题涉及她就导入整本。务必收窄：
- 与另一人物取交集（忆秦娥楚嘉禾 --all → 只看二人对手戏章节）；
- 限定 --part；
- 或只挑清单里最相关的几章读。
query.py 命中超过 25 章会打印提醒。--text 默认最多导出 15 章（--max N 可调），先收窄优于硬调大。

别名（同一人多名）

索引已归并常见别名，用户用任一名字都能命中，例如：

忆秦娥 = 易招弟 = 招弟 = 易青娥 = 青娥 = 秦娥（改名贯穿全书：易招弟→易青娥→忆秦娥）
楚嘉禾=嘉禾；苟存忠=老苟；古存孝=老古；薛桂生=薛团；石怀玉=怀玉；宋光祖=宋师；胡三元=三元
易辨混的两组（已分开，勿混）：导演"封子/封导" ≠ 小生"封潇潇"；省城名演员"李青娥" ≠ 主角"易青娥"。
不确定某名字指谁：python3 scripts/query.py --resolve 名字；看全部人物：python3 scripts/query.py --list 或读 references/characters.md。

文本来源与重建索引

脚本读取顺序：环境变量 ZHUJUE_TXT > skill 自带 txt/ > /home/jjw/zj/txt。默认即用自带 txt/，无需任何配置。

要增删/修正人物与别名时，编辑 scripts/build_index.py 里的 CHARACTERS，然后

python3 scripts/build_index.py                 # 用自带 txt/
ZHUJUE_TXT=/path/to/other/txt python3 scripts/build_index.py   # 指向别处的文本

安全使用建议

Install only if you want a local reference tool for this specific novel. Be aware it bundles the full text and may retrieve sensitive passages; use content warnings, summarize instead of quoting harmful material by default, and avoid exporting large chapter sets unless needed.

能力评估

ℹ Purpose & Capability

The stated purpose is to locate and import relevant chapters from Chen Yan's novel by character name, and the bundled data, character index, and query script match that purpose. The bundled source text includes mature, hostile, and self-harm-related literary passages.

✓ Instruction Scope

Runtime instructions are scoped to user-directed novel analysis and include practical limits to avoid importing the whole book unnecessarily. I found no hidden prompt override, unrelated agent-control instruction, or automatic execution behavior.

✓ Install Mechanism

The artifact is self-contained: markdown, JSON indexes, HTML text, and two Python stdlib helper scripts. There are no declared external packages, no install-time network activity, and VirusTotal reported 0 malicious or suspicious detections across 65 engines.

✓ Credentials

The scripts read bundled chapter files by default, optionally read a user-selected text directory via ZHUJUE_TXT, and can write a user-requested text export path. That local file access is proportionate to a chapter retrieval/import tool.

✓ Persistence & Privilege

No persistence, privilege escalation, credential access, background worker, network exfiltration, or destructive behavior was found. The index rebuild script can overwrite the skill's generated index files only when deliberately run.

版本历史

v1.0.0

- 首发版本，为陈彦《主角》打造的人物→章节智能导入工具。 - 支持按任意人物姓名（含别名、剧中角色名）检索相关章节，自动查表归并同一人物多种叫法。 - 内置小说全文（151 章），只导入与指定人物相关章节，支持交集/并集及分部筛选。 - 可配合导入后进行人物分析、关系梳理、情节回溯、原文查找、评论写作等任务。 - 提供脚本化工作流，含查找、导出、人物名册等实用功能，方便后续扩展。

元数据

Slug zhujue-characters

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

zhujue-characters 是什么？

按人物检索并导入长篇小说《主角》(陈彦著，茅盾文学奖)的相关章节，作为后续任务的背景资料。当用户提到《主角》里的人物——主角忆秦娥(本名易招弟、易青娥)，或胡三元、胡彩香、米兰、廖耀辉、封潇潇、楚嘉禾、刘红兵、秦八娃、石怀玉、苟存忠/古存孝/周存仁/裘存义(存字辈老艺人)、单仰平、薛桂生、朱继儒、黄正大、宋雨、... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 54 次。

如何安装 zhujue-characters？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install zhujue-characters」即可一键安装，无需额外配置。

zhujue-characters 是免费的吗？

是的，zhujue-characters 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

zhujue-characters 支持哪些平台？

zhujue-characters 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 zhujue-characters？

由 John Do（@junwugit）开发并维护，当前版本 v1.0.0。

zhujue-characters

《主角》人物 → 章节 导入器