Setup Obsidian arXiv Daily

Overview

Deploy the packaged arXiv collector into a confirmed Obsidian Vault, validate

the installation, and optionally register a Windows daily task. Preserve

generated notes and keep credentials outside project files.

Core Workflow

1. Resolve the target Vault to an absolute path and confirm it exists.
2. Inspect whether \ already exists.
3. Run scripts/install_arxiv_daily.py with --dry-run.
4. For an existing project, explain that --force updates packaged files while

preserving papers, daily, archive, and logs. Obtain explicit approval

before using --force.

1. Install and edit only the requested values in the generated config.yaml.
2. Run the installed unit tests.
3. Run the installed PowerShell wrapper with -DryRun -MaxTotal 1.
4. Register a scheduled task only if the user requested scheduling.
5. Verify exact paths, test counts, task state, next run time, and recent logs.

Read operations.md for exact commands and

configuration details.

Safety Rules

• Never copy historical papers, daily notes, archives, logs, or caches from

another Vault.

• Never write, print, log, or embed DEEPSEEK_API_KEY. Verify only whether it

is present in the execution environment.

• Do not overwrite an existing project without explicit approval.
• Do not replace an existing scheduled task without confirming its exact task

name, action path, target Vault, and receiving explicit approval for -Force.

• Use -WhatIf when validating task registration.
• Treat network dry-run failure separately from installation failure: unit tests

must still run without network access.

• Do not claim success until the fresh installed-copy tests and requested task

inspection have completed.

Configuration Boundaries

Change only keys requested by the user:

• retention_days
• per_field_limit
• lookback_days
• sort_by
• sort_order
• summary_enabled
• summary_provider
• deepseek_model
• deepseek_base_url
• request_timeout_seconds
• fields

Keep deepseek_base_url on https://api.deepseek.com; the collector rejects

other hosts. Dataview is required only for rendering dashboard.md, not for

collection or Markdown generation.

Bundled Resources

• scripts/install_arxiv_daily.py: bounded preview/install/update utility.
• scripts/register_scheduled_task.ps1: guarded Windows task registration.
• assets/arxiv-daily/: tested collector, wrapper, tests, configuration,

dashboard, and templates.

• tests/: installer and task-registration regression tests.