兼职项目猎手（Part-time Project Finder）
从权威、可靠来源检索最近的设计 / 软件 / 网站开发类兼职、外包与远程项目，
用透明可复核的评分规则对每条项目打「可靠分」与「性价比分」，按综合分降序输出，
并逐条标注来源平台、发布时间与直链，便于用户自行核验。
何时使用
触发场景（用户原话或意图匹配其一即可）：
- 找兼职 / 外包 / 远程 / 自由职业 / 众包 / 接单项目
- 限定领域：设计（UI/UX、平面、插画）、软件开发（前后端、移动端、算法）、网站开发（建站、前端、全栈）
- 强调「靠谱 / 可靠 / 权威来源 / 不要太水」
- 要求「按性价比 / 可靠程度排序」
默认范围：中国大陆平台优先，国际平台作为高质量补充；默认时效窗口：最近 30 天。
工作流
1. 解析需求
从用户请求中提取并确认（缺失则用默认值，并显式说明默认值）：
- 领域：design / software / website / 全部
- 地域：中国优先 / 全球 / 仅中国（默认中国优先）
- 时效：默认最近 30 天；可放宽到 90 天
- 筛选：预算区间、技能栈、是否仅接「担保交易」项目
- 数量：默认返回 Top 10–15 条
2. 获取「现在」时间
用 Bash 执行 date +%Y-%m-%d 得到今天日期，用于计算每条项目的「发布于 N 天前」，
并作为时效评分（R5）与「最近」判定的基准。不得凭记忆估算日期。
3. 检索权威来源
按 references/sources.md 的来源分级，优先 Tier A / Tier C，必要时补 Tier B / Tier D。
对每一领域构造定向搜索词，例如：
- 软件：
程序员客栈 最新 外包、码市 软件开发 项目、开源众包 接单 - 网站：
网站开发 外包 兼职、前端 远程 项目 近期 - 设计：
站酷 接单 设计、UI 设计 外包 平台、特创易 项目 - 国际：
Upwork recent software freelance、Toptal remote developer
检索与核验工具：
- WebSearch：先用它 broad 检索「平台名 + 领域 + 最近/最新」类词，拿到候选链接与发布时间线索。
- WebFetch：对平台项目列表页 / 具体项目页抽取结构化字段（标题、预算、工期、技能、担保方式、发布时间）。
- 每条候选必须能落到
references/sources.md的某个已知权威来源；匿名论坛帖、无平台背书、无发布时间的散单，
一律归入「未经验证」并在输出中单独标注、不进入主排序。
4. 抽取结构化字段
对每条通过初筛的项目，整理为记录（缺失字段标 null 并降低置信度）：
title, domain(design|software|website), source(平台名),
posted_at(YYYY-MM-DD), budget(数值或null), duration_days(数值或null),
platform_tier(A|B|C|D), escrow(bool|null), employer_verified(bool|null),
review_transparent(bool|null|unknown), link,
ce_budget(0-5), ce_skill_match(0-5), ce_payment_terms(0-5),
ce_flexibility(0-5), ce_repeat(0-5), confidence(high|medium|low), note
成本效益子分（ce_）由代理基于证据主观判定 0–5，需附 1 句理由写入 note 或单独字段。
可靠度子分（R1–R5）由脚本依据 platform_tier / escrow / employer_verified / review_transparent / posted_days_ago
确定性计算*，不依赖主观打分——这是「可靠」二字的可复核保证。
5. 评分与排序
将上一步的结构化记录写入一个 JSON 文件（如 /tmp/projects.json），调用：
python3 ~/.workbuddy/skills/parttime-project-finder/scripts/score_projects.py /tmp/projects.json
脚本会：
- 按
references/scoring.md的规则确定性计算 R1–R5 与可靠分 RS（0–100）、性价比分 CES（0–100）、综合分（默认 0.5·RS + 0.5·CES）。 - 按综合分降序（同分则可靠分降序）排序，输出 Markdown 表格 + CSV（同目录
projects_ranked.csv）。
权重可在脚本顶部 WEIGHTS 调整；若用户更看重「可靠」可改 reliability=0.7。
异常处理（脚本已升级为中文友好报错）：若脚本报错（如「找不到输入文件」「JSON 解析失败（第 N 行第 M 列）」「字段 ce_xxx 不是数字」），
它会打印固定格式的 ❌ 错误标题 / 细节 / 怎么解决 提示，直接把这段提示转给用户即可，不要粘贴原始 Python 报错（traceback）。
常见错误的含义与修法见 references/faq.md 的 Q9；新手端到端样例见 references/example.md。
6. 输出报告
向用户呈现：
- 一句话结论：本次在哪些来源、时效窗口内找到多少条、Top 3 是谁。
- 排序总表（脚本输出的 Markdown 表，含来源、发布时间、预算、可靠分、性价比分、综合分、直链）。
- Top 3 简评：每条为什么上榜、需要注意的坑。
- 来源可信度说明：本次覆盖的 Tier 与各自担保/审核机制。
- 风险提示与免责声明：未进入主排序的散单、需自行二次核验的点、跨境项目的结汇/时差/合同纠纷风险，并强制附上「免责声明与风险提示」章节的完整声明（脚本会在末尾自动输出该声明块，直接复制即可）。
硬规则（继承自用户对「来源权威性」的高敏感偏好）：
- 每条项目必须带 来源平台名 + 发布时间 + 直链；缺任一者不得进入主排序。
- 不编造预算 / 工期；平台未公开则标 null 并在备注说明「平台未公开，需登录查看」。
- 所有数字（预算、工期、评分）附来源与时间戳。
免责声明与风险提示（强制输出）
每次输出报告的末尾必须附上以下声明（脚本自动生成，直接引用即可）。
任何清单与排序均不代表「真实可接 / 雇主信用 / 收益保证」。
> ⚠️ 免责声明
> 1. 本工具仅做公开信息的检索、结构化与排序，不构成就业/接单/投资/法律建议，决策与风险自负。
> 2. 项目数据来自公开检索，预算/工期/时间可能过时或缺失，排名仅反映「来源可靠度+性价比」模型评分，不保证真实有效或收益，请以平台最新页面核验。
> 3. 凡要求「先交保证金/培训费/押金/垫付」或私下转账的，一律视为诈骗，立即远离；坚持平台托管、收款后交源文件。
> 4. 跨境项目注意结汇、税务、时差与纠纷管辖；接单前明确著作权归属并签合同，保管好身份证/银行卡等敏感信息。
进阶用法
- 用户只想看「担保交易」项目：检索时只保留
escrow=true的平台（Tier A 多数满足）。 - 用户有特定技能栈：在 WebSearch 词里加栈名（如
React 外包、Figma 接单）。 - 周期性复跑：可配合自动化（每天/每周）定时执行本 skill，输出当日新项目清单。
参考文件
references/sources.md：权威来源分级清单（Tier A–D）、各平台担保/审核机制、检索建议、黑名单信号。references/scoring.md：可靠分与性价比分详细评分规则、阈值与默认值、黑名单与高风险判定。scripts/score_projects.py：确定性评分与排序脚本（输入 JSON，输出 Markdown+Csv），已升级为中文友好报错。references/faq.md：常见问题解答——哪些不能碰、置信度含义、跨境怎么接、评分怎么算、沉底原因、链接打不开怎么办、报错怎么读等。references/example.md：完整端到端示例——从「用户请求」到「输入 JSON 样板」再到「输出长什么样」，新手可直接照抄。
