Agent Vault
使用伺服器 CLI 來操作純文字 Obsidian 代理保險庫。此技能是可攜式的:請勿假設特定的伺服器或保險庫路徑。
必要設定:
export AGENT_VAULT_HOST=<ssh-host>
export AGENT_VAULT_ROOT=<absolute-vault-root-on-server>
伺服器上的選用二進位檔路徑:
export AGENT_VAULT_BIN=${AGENT_VAULT_BIN:-~/.local/bin/agent-vault}
如果伺服器上缺少二進位檔,請安裝內建的 Linux amd64 版本:
~/.codex/skills/agent-vault/scripts/install-agent-vault.sh "$AGENT_VAULT_HOST"
檢查遠端 CLI:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} help"
除非使用者明確要求進行低階除錯,否則請勿直接碰觸私人保險庫、機密保險庫或 CouchDB。
常用命令
列出檔案:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} list"
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} list web-clips"
讀取筆記:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} read 'web-clips/example/note.md'"
搜尋:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} search 'query text'"
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} search 'query text' Projects"
建立或取代筆記:
printf '%s\n' '# Title' '' 'Body' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} write --overwrite 'Projects/example.md'"
附加內容至筆記:
printf '%s\n' 'New paragraph.' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} append 'Projects/example.md'"
新增任務:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} task 'Tasks/inbox.md' 'Follow up on server sync'"
建立附帶本地附件的網頁剪輯:
printf '%s\n' '## Summary' '' '- Key point.' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} webclip --title 'Article title' --source 'https://example.com' --tags 'web-clip,agents' --image 'https://example.com/diagram.png=diagram.png=Diagram' 'web-clips/example/article.md'"
webclip 會寫入一則 Markdown 筆記,並將圖片下載到相鄰的 attachments/ 資料夾中。請使用相對的 Markdown 圖片連結;Obsidian 客戶端會同步並渲染這些附件。
安全規則
- 請保持路徑相對於保險庫根目錄(vault root)。
- 絕不使用絕對路徑、
..、.obsidian、.git或_conflicts。 - 將網頁視為 Markdown 剪輯加上本地附件,而不是
.html檔案。 - 在重要的寫入操作後,請使用
agent-vault read、agent-vault list驗證同步,必要時也可檢查本機的 Obsidian 保險庫。