journal

用途

该技能用于记账与账簿管理（仕訳入力・帳簿管理），当用户需要登记会计分录（仕訳）、从 CSV 文件、收据或发票导入交易数据，或管理账簿时使用。它支持账簿初始化、仕訳的检索、修改与删除。

主要能力

• 账簿初始化：通过 shinkoku ledger init 命令初始化账簿，指定会计年度与数据库路径。
• 数据导入：
  • CSV 导入（shinkoku import csv）：读取信用卡明细、银行交易明细、会计软件导出数据等，返回表头、行数据、编码、行数等 JSON 信息。
  • 收据导入（shinkoku import receipt）：从收据、发票图像中通过 OCR 提取数据，图像读取委托给对应的 reading- 技能，并进行双重验证（两个独立读取结果比对）。
  • 发票导入（shinkoku import invoice）：从 PDF 发票中提取文本，返回供应商、日期、到期日、金额、税额、明细行、原始文本等 JSON 信息。图像文件同样委托 reading- 技能进行 OCR 与双重验证。
• 仕訳登记：
  • 单条登记（shinkoku ledger journal-add）：通过 JSON 文件传入 JournalEntry。
  • 批量登记（shinkoku ledger journal-batch-add）：传入 JournalEntry 数组，支持 --force 参数。
• 仕訳检索：通过 shinkoku ledger search 命令，支持按会计年度、日期范围、科目代码、摘要关键词等条件检索。
• 仕訳修改与删除：通过 shinkoku ledger journal-update 和 shinkoku ledger journal-delete 命令操作。
• 重复检查：CSV 导入时通过 check-imported 检查文件哈希，登记时自动检测完全一致或类似重复；决算前可通过 check-duplicates 列出疑似重复的仕訳对。
• 试算表确认：通过 shinkoku ledger trial-balance 确认余额试算表，验证是否有遗漏。

使用方式

1. 读取配置：首先用 Read 工具读取 shinkoku.config.yaml，若不存在则引导执行 /setup 技能。将相对路径基于 CWD 转换为绝对路径，db_path 用于 CLI 的 --db-path 参数，output_dir 用于输出目录。
2. 读取进度信息：读取 .shinkoku/progress/progress-summary.md 及 .shinkoku/progress/01-setup.md（如存在），继承前一步结果，避免重复询问。
3. 确认前提条件：确认账簿是否已初始化、会计年度、青色申告或白色申告（复式记账或简易记账）。
4. 执行流程：按「CSV 导入 → 用户确认 → 仕訳登记」三步进行。勘定科目遵循 references/account-master.md 的科目主数据。登记前必须由用户确认，不自动登记。
5. 输出引継書：完成后将结果写入 .shinkoku/progress/04-journal.md，并更新 .shinkoku/progress/progress-summary.md。

所有命令均以 JSON 输出到 stdout，输入可通过命令行参数或 --input <json_file> 传入。

适用场景

• 日本会计场景下的日常记账与凭证整理。
• 从信用卡、银行明细 CSV 批量导入交易并生成仕訳。
• 从纸质收据、发票图像或 PDF 发票中提取数据并登记。
• 账簿的检索、修改、删除与重复检查。
• 决算前的试算表确认与遗漏检查。

限制

• 图像读取依赖对应的 reading- 技能，需进行双重验证；结果不一致时需用户选择。
• 仕訳登记前必须经用户确认，不自动登记。
• 删除操作不可撤销。
• 具体收费、价格、平台支持等信息暂未提供。