pan123.cn 说明书（纯文本版） ================================================== 整站每个板块干什么、AI 怎么往里写数据。 你只需要读自己要用的那一节。 各节网页版可直接跳：pan123.cn/doc#ledger / #store / #site / #rules ================================================== 01 账单 https://z.pan123.cn/ ================================================== 【这个板块是什么】 记所有 USDT 资金的进出：打新成本、卖出收入、返佣、手续费， 以及押金、退款、转账、充值这类只记不算的流水。 自动算已实现盈亏、未变现，按项目 / 钱包 / 日期汇总。 【页面在哪】 https://z.pan123.cn/ 人看这张表；AI 不用打开页面，直接调接口。 【写到这里 · 不用钥匙不用登录】 POST https://z.pan123.cn/api/ingest 把账单写进去 GET https://z.pan123.cn/api 先读格式、今天日期、今天已记几笔 GET 返回的就是本板块的即时说明：字段、可选值、最近 5 条真账都在里面。 【三步】 1. 先 GET https://z.pan123.cn/api ，拿到「今天」和「今日已记」。 2. 把今天的账逐条列出来，一笔一条，收入正数、支出负数， 不要合并成「今天赚了 100」这种总数。 3. POST 到 https://z.pan123.cn/api/ingest ，放进 entries 数组，一次可多条。 写完再 GET 一次看笔数有没有加上去，然后回一句： 写了几条、收入多少、支出多少、净额多少。 【一条长什么样】 {"entries":[ {"window":"Claude","time":"YYYY-MM-DD 12:00","project":"AGC", "type":"卖出收入","status":"已结","item":"第3轮结算","amount":42.5, "qty":"1750000 AGC","wallet":"大号","chain":"BSC","note":"含2%税"} ]} time 里的 YYYY-MM-DD 换成今天；整条 time 省掉也行，服务端按当前时间记。 【字段】 window 必填 你现在的软件名（Claude / Cursor / 豆包 / ChatGPT…），换窗口写新窗口的 project 必填 项目名，见下面可选值；拿不准填「外部」，并在 note 里写真实项目名 type 必填 收支类型，见下面可选值 amount 必填 USDT 金额，只填数字。正数=盈利/收入，负数=亏损/支出 time 可选 发生时间 YYYY-MM-DD HH:MM，不填按当前 item 可选 一句话说明这一笔是什么 status 可选 已结 / 持仓 / 待领 / 作废，不填算已结 qty 可选 币的数量，如 1,750,000 AGC wallet 可选 哪个钱包，如 大号 / 1-8 chain 可选 BSC 或 ETH note 可选 税率、对手方、滑点、原始金额都写这里 id 可选 同一条固定用同一个 id，重推是覆盖，不会重复记账 【常用值（不是限制，没有的自己加）】 project: AGC / AGD / AGI / JAGENT / CARDS / 外部 type（算盈亏）: 打新成本 / 卖出收入 / 返佣 / 手续费 type（只记流水）: 押金 / 退款 / 转账 / 充值 status: 已结 / 持仓 / 待领 / 作废 没有对应值时直接写新的，不用问： · project 写新名字 → 账本自动多一张分类卡（归到「未分组」）。 大小写要统一，别写 agd 和 AGD 两个。 · type 写新名字 → 默认计入盈亏。如果它其实是「只记流水」的类型 （借款、空投、利息这种），就用四个标准名之一记金额，把新名字写进 note。 · status 写新名字 → 按「已结」处理，会正常显示，不会写进来却看不见。 status 是 持仓 / 待领 / 作废 的记录，不算进盈亏。 【常见情况】 · 「今日账单」= 今天发生的全部资金动作，按发生日期算，不是按你什么时候写。 · 今天没有流水：不要编，回一句「今天没有流水」。 · 写重了：同 id 是覆盖；没带 id 的按「时间+项目+类型+金额+说明」判重。 · 一次最多 200 条。 · 只负责某一个项目：看 pan123.cn/p/ 里对应的页（如 /p/agc/），只有这个项目的规则。 ================================================== 02 通用存储 https://pan123.cn/api/<空间>/items ================================================== 给以后的小工具、脚本、自动化用的键值存储。 一个「空间」= 一个工具的数据，互不干扰。数据在服务器，页面调接口就行。 POST https://pan123.cn/api/<空间>/items 写（带 id 就是覆盖） GET https://pan123.cn/api/<空间>/items 列表 GET https://pan123.cn/api/<空间>/items/ 单条 PUT https://pan123.cn/api/<空间>/items/ 修改 DELETE https://pan123.cn/api/<空间>/items/ 删除 请求头带 X-Space-Key。空间和钥匙需要新建，跟我说一声。 ================================================== 03 站点导航 https://pan123.cn/ ================================================== 个人入口页：547 个收藏站点，按分类排布，带搜索、favicon、深浅两套皮肤。 它只是「往里点」的导航，没有需要 AI 写的数据。 小工具挂在主站下：账单（z.pan123.cn）、主题版导航（/theme/）、像素版（/pixel/）。 ================================================== 04 通用约定 ================================================== · 可以重复调用：写入接口都是幂等的，失败就重试，不会写重。 · 金额单位：账单一律 USDT，不要换算成人民币。 · 只写自己的板块：账单数据只 POST 到 z.pan123.cn/api/ingest。 · 不确定就留空：缺字段不影响记账，编错了要返工对账。 · 写完回报：本次写了几条、金额多少；报错就把返回内容原样贴给我。