sn-work-record

蜀宁 OA 工时与报销：填报/修改/查询工时，查看报销申请状态与审批进度；删除与恢复暂禁。

蜀宁 OA 工时与报销

用于工时查询、周度总结、查漏、授权填报/修改及报销审批进度；生产逻辑删除/恢复入口暂禁：服务端无可靠恢复契约，CLI 与 API 均在任何网络请求前拒绝，不提供绕过开关。

破坏性测试门禁： 即使用户授权“删除后补回”，也先验证服务端删除、恢复和审批关联的契约或隔离环境证据，再决定是否执行。完整 JSON 备份不等于可恢复机制，isDeleted=0 不能凭字段名推定有效。未证实可逆时保留原记录、说明缺口，不清除持久提交保护来补填；本地锁与写后核验不提供服务端事务或并发恢复保证。

工具范围：通过执行工具运行本技能 Python 入口；网络仅用于用户指定的 OA origin；本地读取授权凭据、个人设置，写入私有认证缓存和持久保护/备份。子进程仅用于依赖探测、解释器切换和 OpenSSL 加解密。此声明不授予额外工具权限，也不代表宿主已执行权限隔离。删除与恢复即使显式授权也暂禁，不能清理 submission guard 以恢复或重新提交。运行时环境白名单仅约束派生子进程/替换解释器，不净化当前进程；本地锁非服务端 CAS，不承诺隔离或可逆。

删除/恢复维护说明见 保护删除与恢复。以下路径均相对本技能安装目录；使用当前 agent 的执行工具（Hermes 为 terminal）运行。无需自行编写查询驱动或重新探测环境。

必须保留的边界

• 查询、润色、导出不授权写入 OA。 不使用历史聊天补造实时记录；失败、空记录、草稿、已提交记录分开报告。
• 不暴露凭据或内部 ID。 复用已有加密凭据和 OAAuth，不打印账号、密码、token、密钥；默认隐藏项目/记录/流程 ID，仅用户明确要求或操作确需引用时展示。凭据持久保存、个人默认值修改需另行授权。
• 写入前先确认事实与完整字段。 项目、类型、阶段、工作类型须实时验证，时长无 8h 默认，不把某位用户的选择写成通用配置。首次项目由用户选择；只读发现失败不猜代码。
• 提交、撤回重提与删除须区分授权。 同日有记录不新增重复项；审批中撤回影响流程，须专门授权。未知写结果只读核实，不盲重发；不绕过持久写入保护。预览不是提交成功。
• 只润色，不夸大。 保留专名、数量、事实状态；研究不改写成上线、验收。节假日禁止新增填报，但历史查询不能跳过已有记录。

常用只读入口

从技能目录运行；各入口自动选择依赖完整的解释器。可用 --credentials <受保护凭据文件>、--base-url <OA地址> 覆盖现有入口默认值；不要读取秘密正文排错。

bash

# 单日工时
python scripts/query_time_entry.py <YYYY-MM-DD> --json

# 多区间工时：一个调用，包含首尾，重叠日期只查询一次
python scripts/query_time_ranges.py --range <开始日期> <结束日期> --range <开始日期> <结束日期> --json

# 需要保存本地核查证据时，以上批量命令追加 --raw-output <新的私有JSON路径>
# 这里只保存查询证据，不是账号密码；不要把源数据文件主动交付用户。

# 报销及当前审批节点
python scripts/query_fee_requests.py --with-progress

# 项目 / 指定工时详情
python scripts/list_projects.py --json
python scripts/get_time_entry_details.py <record-id>

多区间查询与总结的最短流程

1. 明确用户给定的起止日期；相对日期以实际当前日期、时区解析。批量日期优先上面的现成入口，不逐天发起模型工具往返，不现场编写脚本。
2. 检查退出状态、完整性及逐日失败项。汇总采用脚本计算的 ID 去重记录数、填报日数、十进制工时、状态分布；不能按天数乘固定时长，不能把草稿工时当已审批工时。部分失败只能给已核实部分，不宣称全部完成。
3. 直接使用返回的完整逐日工作描述归并主题，按用户的区间分组。共用项目/审批情况集中写；只有全部记录一致且查询完整才能说“全部已审批”。不同但相似的系统名称不自行统一。
4. 默认在聊天交付，不主动生成附件；用户要求文件再加载相应文档技能。只覆盖指定日期时，不宣称整月已填齐。

简单查询/汇总读取本页即可；遇查漏补填、复杂口径或导出核验再读 工时查询流程。依赖错误或认证失败才读 认证与运行环境，避免每次加载维护细节。

按任务加载，而非整套展开

• 填报、修改、删除、中断续办：必须先读 写入工作流。普通提交另读 提交去重保护；修改另读 撤回重提；首次设置读 个人设置。仅普通工作支持提交，休假及真实草稿写入保持现有限制。
• 报销查询：读 报销查询与展示。金额和状态加粗，节点/审批人分行，默认不展示公司；历史每笔两行并留空行。审批通过不等于到账。
• 报销完成提醒：另读 监控实现，固定指定申请，不追踪“最新一笔”。
• 凭据迁移/首次配置：读 认证与运行环境 和 Hermes凭据存储。
• 开发维护：按需读 脚本目录、接口、发布验证，不要作为常规查询前置步骤。
• 发布与审核：分开报告“已受理、已公开、安全审核结果”；精确版本可读取且 latest 指向目标版本才称最新版已发布。只引用目标版本的安全证据，不把技能级旧版 Clean 当作新版通过。整改须先说明精确改动、影响及回滚方案，未经确认不改业务实现；发布授权不等于真实 OA 写入测试授权。

输出与验证

状态 10=草稿、20=审批中、30=已审批；未知状态不猜。称“填报日”不等于已核对出勤日历。查漏须核对适用工作日历，周末无记录不自动算漏填。

写操作仅以对应保护入口读回核验的结果报告成功；完整执行规则在写入工作流。查询输出保留日期、项目名称、时长、描述及状态等必要事实，隐藏内部标识。原始数据留在受权限保护的本地证据文件中，不整份塞进上下文；不要用省 token 为由省略事实、权限或完整性检查。