zimoliao / workspace

工作区管理

工作区是论文子集管理工具。每个工作区引用主库中的论文（通过 UUID），支持在子集内搜索和导出。

执行逻辑

创建工作区

scholaraio ws init <名称>

添加论文

逐个添加：

scholaraio ws add <名称> <论文标识...>

论文标识可以是：DOI、目录名、UUID。需要按关键词批量添加时，请使用 --search。

批量添加：

scholaraio ws add <名称> --search "<查询词>" [--limit N] [--year YYYY] [--journal 期刊名] [--type 类型]
scholaraio ws add <名称> --topic <主题ID>
scholaraio ws add <名称> --all

• --search：按融合检索结果批量添加，支持 --limit/--year/--journal/--type 过滤
• --topic：按 BERTopic 主题 ID 批量添加该主题下的全部论文
• --all：将主库全部论文加入工作区

三个批量参数互斥。提供批量参数时，位置参数 <论文标识> 被忽略。

移除论文

scholaraio ws remove <名称> <论文标识...>

列出所有工作区

scholaraio ws list

查看工作区论文

scholaraio ws show <名称>

重命名工作区

scholaraio ws rename <旧名称> <新名称>

在工作区内搜索

scholaraio ws search <名称> "<查询词>" [--limit N] [--year YYYY] [--journal 期刊名] [--type 类型] [--mode unified|keyword|semantic]

搜索模式：

• unified（默认）：融合检索（关键词 + 语义 RRF 排序）
• keyword：FTS5 关键词检索
• semantic：FAISS 语义向量检索

范围限定在工作区论文内。

导出工作区 BibTeX

scholaraio ws export <名称> [-o 输出文件] [--year YYYY] [--journal 期刊名] [--type 类型]

Context 管理

• 工作区论文较多时（>30 篇），ws show 的输出应由 subagent 执行并返回摘要（如"工作区包含 N 篇论文，涵盖 XX 方向"），避免直接输出长列表到主 context
• 论文全文（L4）应在 subagent 中阅读，仅将关键结论带回主 context
• 搜索结果超过 20 条时，优先用 subagent 处理并筛选

示例

用户说："帮我建一个 drag reduction 的工作区"
→ 执行 ws init drag-reduction

用户说："把这几篇论文加到工作区"
→ 执行 ws add drag-reduction <DOI或目录名...>

用户说："把搜索到的论文都加到工作区"
→ 执行 ws add drag-reduction --search "turbulent drag reduction" --limit 20

用户说："把主题 3 的论文加到工作区"
→ 执行 ws add drag-reduction --topic 3

用户说："在工作区里搜 turbulent boundary layer"
→ 执行 ws search drag-reduction "turbulent boundary layer"

用户说："用关键词在工作区里搜"
→ 执行 ws search drag-reduction "turbulent boundary layer" --mode keyword

用户说："把工作区改个名"
→ 执行 ws rename drag-reduction turbulence-control

用户说："导出工作区的引用"
→ 执行 ws export drag-reduction

用户说："我有哪些工作区"
→ 执行 ws list