书

pan123.cn · 说明书

整站每个板块干什么、AI 怎么往里写数据

打开账本 →

给 AI 的读法

这一页是整个网站的说明书，按板块分节。你只需要读自己要用的那一节：那节里写着这个板块是什么、页面在哪、你该往哪个地址写、字段怎么填。

地址带井号可直接跳到某节，比如 pan123.cn/doc#ledger 就是账单。

唯一硬规矩：不要编数字。没有的、拿不准的留空，比编一个数好。

账单 USDT 收支 · z.pan123.cn

通用存储 给以后的小工具 / 自动化

站点导航 主页那 547 个入口

通用约定 幂等、单位、别串板块

01账单

这个板块是什么　记所有 USDT 资金的进出：打新成本、卖出收入、返佣、手续费，以及押金、退款、转账、充值这类只记不算的流水。自动算已实现盈亏、未变现，并按项目、钱包、日期汇总。

页面在哪　https://z.pan123.cn/　（人看这张表；AI 不用打开页面，直接调接口）

写到这里 · 不用钥匙不用登录

POST https://z.pan123.cn/api/ingest     ← 把账单写进去（JSON 见下）
GET  https://z.pan123.cn/api            ← 先读格式、今天的日期、今天已记几笔

GET 那个地址返回的就是本板块的即时说明：字段、可选值、最近 5 条真账都在里面。

三步

先 GET https://z.pan123.cn/api，拿到 今天（今天的日期）和 今日已记（今天已经记了几笔、多少钱）。
把今天的账逐条列出来，一笔一条，收入正数、支出负数，不要合并成「今天赚了 100」这种总数。
POST 到 https://z.pan123.cn/api/ingest，放进 entries 数组，一次可多条。写完再 GET 一次看笔数有没有加上去，然后回一句：写了几条、收入多少、支出多少、净额多少。

一条长什么样

{
  "entries": [
    {
      "window":  "你现在的软件名",
      "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	必填	项目名。常用值见下，没有的就自己起名，账本会自动多一张分类卡。拿不准填 `外部`。
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

AGCAGDAGI JAGENTCARDS外部＋新项目

类型 type　绿=算盈亏，红=只记流水

打新成本卖出收入返佣手续费押金退款转账充值＋新类型

没有对应值的时候，直接写新的，不用问：

字段	写一个新的会怎样
project	账本自动多一张分类卡（归到「未分组」，我可以手动并进大类）。项目名统一大小写，别写同义重复（`agd` 和 `AGD` 会变成两个）。
type	默认计入盈亏。如果你要加的这个类型本质是「只记流水」（比如借款、空投、利息），就用四个标准名之一记金额，并把新名字写进 `note`。
status	新状态按「已结」处理，会正常出现在默认列表里，不会写进来却看不见。

红色四类只记流水、不进盈亏；status 是持仓 / 待领 / 作废的同样不进。

常见情况

「今日账单」指什么今天发生的全部资金动作：今天卖了多少、付了多少 gas、到账多少返佣、押金进出。按发生日期算，不是按你什么时候写。

今天没有流水不要编，回一句「今天没有流水」就行。

写重了怎么办带同一个 id 就是覆盖；没带 id 的，系统按「时间+项目+类型+金额+说明」判重。

一次写多条放进 entries 数组，一次最多 200 条。

只负责某一个项目可以看该项目的细分页：pan123.cn/p/（如 /p/agc/），里面只有这个项目的规则和以前的记法。

02通用存储

给以后的小工具、脚本、自动化用的键值存储。一个「空间」= 一个工具的数据，互不干扰。数据存在服务器，页面调接口就行，不用自己搭后端。

POST   https://pan123.cn/api/<空间>/items      写（带 id 就是覆盖）
GET    https://pan123.cn/api/<空间>/items      列表
GET    https://pan123.cn/api/<空间>/items/<id> 单条
PUT    https://pan123.cn/api/<空间>/items/<id> 修改
DELETE https://pan123.cn/api/<空间>/items/<id> 删除

请求头带 X-Space-Key。空间和钥匙需要新建，跟我说一声，一分钟的事。目前只有 ledger（账单专用，协议见 01）。

03站点导航

https://pan123.cn/ 是个人入口页：547 个收藏站点，按分类排布，带搜索、favicon、深浅两套皮肤。它只是「往里点」的导航，没有需要 AI 写的数据。

小工具都挂在主站下：账单（z.pan123.cn）、主题版导航（/theme/）、像素版（/pixel/）。以后加工具会在这里补一节。

04通用约定

可以重复调用写入接口都是幂等的：账单按 id 或内容指纹去重，通用存储按 id 覆盖。失败就重试，不会写重。

金额单位账单一律 USDT，不要换算成人民币。

只写自己的板块账单数据只 POST 到 z.pan123.cn/api/ingest，不要往别处塞。

不确定就留空缺字段不影响记账，编错了要返工对账。

写完回报本次写了几条、金额多少；接口报错就把返回内容原样贴给我。