caixun-work-hours

彩讯工时填报

这是一个随 Nexus 发布、可直接从技能选择器启用的彩讯工时模板，来源于 SkillHub 的 @user_ab3d2b8a/richpm-daily-report（version 1.0.2）。首次使用只需接入一次 richpm MCP；没有接入时，按“首次接入”步骤配置，不会凭空提交工时。

你通过 MCP 服务器 richpm 的工具操作 RichPMS 工时系统（工具：get_report_calendar、get_fillable_projects_tasks、get_day_detail、check_can_submit、save_daily_report_draft、submit_daily_report）。 在 Nexus 中优先从左侧“连接器”或智能体“工具”页接入并完成授权；若当前版本没有该入口， 再提示用户按所用外部客户端接入 MCP 服务器 <后端地址>/api/ai/mcp：

• Claude Code：claude mcp add richpm <后端地址>/api/ai/mcp --transport http
• WorkBuddy：设置 → MCP 插件 → 添加 HTTP 服务器，地址同上（鉴权方式以客户端支持为准）
• Codex：~/.codex/config.toml 的 [mcp_servers.richpm] 配置 url 接入后按管理员指引完成授权（PMS 账号），工具名前缀以客户端实际注入为准（如 mcp__richpm__get_report_calendar）。

首次接入

用户说“配置 richpm / 接入日报”，或首次使用且工具不可用时：

1. Nexus 内先引导用户到“连接器”或智能体“工具”页添加 richpm，填写管理员提供的服务地址并完成授权。 Skill 不自行修改 Nexus 配置、凭据或其他客户端的配置文件。
2. 若用户明确选择外部客户端，再由用户主动运行 scripts/setup_mcp.py 完成兼容配置；该脚本会修改外部客户端配置， 运行前应说明影响并确认目标客户端。
3. 授权（均弹浏览器输 PMS 账密）：WorkBuddy 跑 scripts/ai-workbuddy-auth.py、ZCode 跑 scripts/richpm_zcode_auth.py；Claude Code 按客户端的 MCP/OAuth 登录流程完成授权；Codex（CLI） 运行 codex mcp login richpm（自动动态注册后弹浏览器；桌面版对 http 内网授权服务器有安全限制， 需 HTTPS/SSH 隧道，详见对接指导）。
4. 完成后提示重启外部客户端/开新会话，说“查我的日报”验证。

外部客户端兜底接入（Codex stdio bridge）

仅在用户明确选择 Codex 外部客户端且原生登录异常时，使用技能包内置的 stdio 桥接（Mac/Windows 通用）。 这条路径会由用户显式修改 Codex 配置，不是 Nexus 内置接入路径：

1. 一次授权（浏览器输 PMS 账密，凭据缓存在 ~/.codex/richpm/oauth.json 自动刷新）：
   • Mac/Linux：python3 <技能包目录>/scripts/richpm_codex_mcp_client.py --login
   • Windows：py <技能包目录>\scripts\richpm_codex_mcp_client.py --login
2. config.toml 改 command 型 MCP（替换原 url 型 richpm 节点）：

   [mcp_servers.richpm]
   command = "python3"          # Windows 用 "py"
   args = ["<技能包目录>/scripts/richpm_codex_mcp_client.py", "--stdio"]
   

3. 重启 Codex 生效；令牌过期自动刷新（401 自动重试一次），失效时重跑第 1 步。

令牌失效自愈（WorkBuddy 专属，2026-09-20）

调用 MCP 工具返回 401 / "令牌无效"时，在会话内按两级处理，用户无需离开 WorkBuddy：

1. 免密续期（优先，先试这个）：运行技能包内 scripts/ai-workbuddy-refresh.sh （GitBash：bash <技能包目录>/scripts/ai-workbuddy-refresh.sh，环境变量 RICHPM_AI_BASE 可覆盖后端地址， 默认从 mcp.json 的 richpm.url 自动推导）。 成功输出"令牌已续期并回写"→ 提示用户开新会话重试即可。
2. 浏览器重新授权（refresh 失效时，退出码 2）：运行 python <技能包目录>/scripts/ai-workbuddy-auth.py ——会自动弹出系统浏览器到 RichPMS 授权页，请告诉用户"在弹出的页面输入 PMS 账号密码并确认"； 页面显示"RichPMS 授权成功"后脚本自动完成令牌回写。双击 scripts/ai-workbuddy-auth.py 同效（装有 Python 的机器）。
3. 环境缺失（无 python / 无 GitBash）时如实告知用户，勿反复重试。