文献卡与主题卡¶

把你自己 Zotero 里的一篇论文变成一张可校验的文献卡，再把若干文献卡组织成持续演化的主题卡。

产出的是长期可追溯的知识资产（不同于公众号文章、播客这类当期内容）。模型负责读论文、写内容；代码负责身份核对、门禁、校验与安全写入。

怎么用¶

配一次（见前提与配置），之后直接跟 agent 说人话就行：

「把《某某》这篇做成卡」 · 「这几篇都做一下」 · 「看看能聚出哪些主题」

agent 走的是这条链路：

你的 Zotero 论文 → 输入记录 → 主体卡草稿 → 代码校验 → 若干卡 → 候选主题
                   paper-input   evidence-generate  evidence-validate  themes-run

也可以自己敲（命令一律从仓库根执行）：

uv run hydrolitagent cards paper-input --user-library --item-key ABCD1234 --json
uv run hydrolitagent cards evidence-generate --paper-input paper-input.json --ai-provider codex --json
uv run hydrolitagent cards evidence-validate --draft <草稿目录>/draft.json --paper-input paper-input.json --json
uv run hydrolitagent cards themes-run --json
uv run hydrolitagent cards ai-config --json          # 看模型选择与产物落点，不调模型

完整清单：uv run hydrolitagent cards --help（当前 5 个子命令）。

自查（不需要你的论文，也不需要模型）¶

仓库带一份合成示例，装完就能验证入口通了：

uv run python scripts/paper_validate.py \
  --draft hydrolitagent/cards/assets/examples/subject-card-validation/draft.json \
  --paper-input hydrolitagent/cards/assets/examples/subject-card-validation/paper-input.json \
  --report-dir outputs/validation-demo

返回 status: PASS 就说明入口可用。它只验证代码，不代表真实论文能生成。

前提与产物¶

前提：Zotero 里该论文已附好可读的 PDF；一种模型 CLI（Codex 或 Claude）已登录。运行时 Windows-only。

产物：单篇流程写到产物根（默认仓库 outputs/）；主题池写到 themes/。查主题从 themes/index.md 进 —— 那是给人看的总入口。

边界¶

通过校验只表示确定性规则通过，不证明科研内容正确。
正式主题必须人工确认；themes-run 只产出候选，不自动晋级。
平台不下载 PDF；缺 PDF 先走入库那条线。
程序不会自动提交或推送 Git —— 本地保存不等于已完成远端备份。

想看什么	去哪
开工前的公共前提与凭据	前提与配置
单篇：输入 / 草稿 / 校验	单篇论文输入 · 主体卡草稿 · 主体卡校验
主题池	统一主题池
模板	公共模板
运行维护	运行维护
技术实现（开发者向）	项目级设计 · 技术架构

文献卡与主题卡¶

怎么用¶

自查（不需要你的论文，也不需要模型）¶

前提与产物¶

边界¶

相关¶