# 进出入库台账管理员 profile 委派说明

更新时间：2026-06-12 03:02

## 1. Profile

已创建专用 Hermes profile：

```text
goods-ledger-manager
```

中文定位：

```text
进出入库台账管理员 / 货品台账管理员 / 库存台账机器人
```

本地启动方式：

```bash
hermes -p goods-ledger-manager chat
```

或使用已创建 wrapper：

```bash
/Users/bot1/.local/bin/goods-ledger-manager chat
```

当前不配置独立 Feishu 网关，不占用新的飞书机器人身份。其他机器人通过本地 profile 调用或后续 Kanban/MCP 委派给它。

2026-06-12 追加收口：该 profile 已改成单任务执行型，不启用 Hindsight，不维护长期记忆，不开放 skills/file/terminal/delegation/cron/messaging 等自主工具；只保留 `goods_ledger_write` MCP 工具用于受控查询和业务写入。

## 2. 职责边界

它专门管理云端 `goods_ledger` 系统：

- 合同与业务单据
- 上下游采购订单
- 订单明细
- 渠道分配
- 样品库存
- 入库、出库、借出、归还、礼赠、报废、调拨
- 发货签收
- 补货计划
- 校验问题
- 写入审计

它不负责：

- 设计、视频、财务、人事、法务等非台账任务；
- NAS 项目归档；
- 外部正式通知；
- 重启其他 profile/gateway/LaunchAgent；
- 裸 SQL 写入。

## 3. 已配置资源

Profile 路径：

```text
/Users/bot1/.hermes/profiles/goods-ledger-manager
```

本地项目根目录：

```text
/Users/bot1/Volumes/root_for_ai/AI工作区/通用_货品台账系统_数据库表结构设计_20260612_0134
```

云端服务：

```text
wwyl-cloud
/srv/goods-ledger/backend
/srv/goods-ledger/.env
http://127.0.0.1:8791
```

注意：云端 `.env` 保存数据库密码和 `LEDGER_API_KEY`，不得打印。

## 4. 已配置 MCP 写入层

Profile config 中已配置：

```text
mcp_servers.goods_ledger_write
```

它通过 SSH stdio 连接云端 MCP server：

```text
/srv/goods-ledger/backend/app/mcp_server.py
```

可用工具：

```text
ledger_create_party
ledger_create_product
ledger_register_source_file
ledger_create_purchase_order
ledger_add_stock_movement
ledger_create_shipment_signoff
ledger_create_validation_issue
```

已验证 MCP：

```text
Connected
Tools discovered: 7
```

## 5. 已配置专用 Skill / SOUL / Memory

SOUL：

```text
/Users/bot1/.hermes/profiles/goods-ledger-manager/SOUL.md
```

Skill：

```text
/Users/bot1/.hermes/profiles/goods-ledger-manager/skills/productivity/goods-ledger-manager/SKILL.md
```

Memory index：

```text
/Users/bot1/.hermes/profiles/goods-ledger-manager/memories/MEMORY.md
/Users/bot1/.hermes/profiles/goods-ledger-manager/memories/USER.md
```

## 6. 委派方式

其他机器人需要查询或写入台账时，推荐这样调用：

```bash
hermes -p goods-ledger-manager chat -q '请处理这个 goods_ledger 台账任务：<任务说明>。只使用受控写入层，不要裸 SQL。完成后返回写入对象、记录 ID、校验结果和审计状态。'
```

只读查询：

```bash
hermes -p goods-ledger-manager chat -q '只读查询 goods_ledger：<查询范围>。不要写入。'
```

写出入库：

```bash
hermes -p goods-ledger-manager chat -q '请登记一条出入库流水：<商品、数量、方向、日期、经办人、去处/来源、证据路径>。出库前先校验库存，不足则拒绝并创建 validation issue。'
```

## 7. 委派任务应提供的信息

为了减少追问，调用方应提供：

- 业务类型：入库 / 出库 / 借出 / 归还 / 调拨 / 签收 / 采购订单；
- 证据来源：文件路径、表单名、用户确认文本、签收单；
- 主体：我方公司、供应商、客户、渠道、仓库、经办人；
- 产品：标准名、原始名、规格、单位、编码/69码；
- 数量、单价、金额、日期；
- 合同号、订单号、到货时间/区间；
- 物流公司、物流单号、收货人、签收人；
- 是否允许正式写入，还是仅做校验预览。

## 8. 验证记录

已完成验证：

```text
Profile: goods-ledger-manager
Model: gpt-5.5 (openai-codex)
Gateway: stopped
Skills: 91
.env: exists
SOUL.md: exists
Alias: /Users/bot1/.local/bin/goods-ledger-manager
openai-codex: logged in
MCP goods_ledger_write: Connected, 12 tools discovered
one-shot read-only smoke: OK goods_ledger 25 25
memory.provider: none / built-in only
memory.memory_enabled: false
memory.user_profile_enabled: false
Hindsight MCP: removed
Hindsight env keys: removed
Built-in toolsets: disabled except MCP server tools
Static SOUL/SKILL: chmod 444 + macOS uchg flag
```

其中 `OK goods_ledger 25 25` 表示：

- 后端连接到 `goods_ledger`；
- 当前产品数 25；
- 当前库存流水 25。

## 9. 后续可选项

如以后希望它成为独立飞书机器人，需要另行创建 Feishu App 并运行：

```bash
hermes -p goods-ledger-manager gateway setup
```

这会涉及新的 Feishu 凭证和 gateway 启动，需单独确认。目前没有做这一步。