TC State 是 TC 的“游戏存档”工具,用于在创业推进到一半时保存进度,下次无需从起点重讲。它只处理五类请求:保存当前已确认的创业判断与下一步;读取某项目最近一次存档并从下一步继续;列出本机 TC 项目与存档;将同一项目多次存档合成阶段报告;在用户逐次明确同意后,导出脱敏的本机候选文件交给 tc-knowledge 人工复核。它不负责重新诊断、写文案或替代 tc-action 设计行动;若问题定义尚未确认,应先回到 /tc 或 tc-diagnosis。
存档默认位置为 ~/.tc/projects/<项目名>/,包含 current.md、current.json、sessions/ 与 reports/。只有用户明确表示保存、记住或建立进度时才写文件,保存前须用一句话告知将写入本机 ~/.tc/。默认不保存姓名、手机号、邮箱、账号密码、访问令牌、私聊全文、客户名单、合同原文及未公开商业机密;需保留人物关系时用“合伙人 A”“客户 B”等代号。用户要求保存敏感信息时,先提醒这是明文 Markdown,再让其决定。不自动上传 GitHub、飞书、邮箱等网络服务。“同意保存状态”不等于“同意导出知识候选”,导出须单独取得当次授权。
一份合格存档包含 problem_definition、confirmed_facts、decision、tradeoff、rejected_directions、assumptions、next_action、success_metric、evidence、next_skill。缺少 problem_definition、decision 或 next_action 时不要伪造,应告知用户缺哪一项。脚本仅依赖 Python 标准库,常用命令如 python3 scripts/tc_state.py save --payload /tmp/tc-state.json、list、restore --project 项目代号、report --project 项目代号,以及 export-evidence --project 项目代号 --output /tmp/tc-evidence-candidate.json --consent。在 Agent 环境中应先写入临时 JSON 再传路径,不要把用户原文直接拼进 shell 命令。
恢复后不要倾倒整份 Markdown,先以四行恢复上下文:上次解决的问题、上次决定、未验证假设、下一步,然后只问“这一步做了吗?”。阶段报告需同一项目至少两次存档,重点写变化而非拼接聊天记录。证据导出仅在用户明确要求时执行,先说明只生成本机文件、不上传,导出后须检查是否含姓名、联系方式、客户、链接、账号、合同与商业机密;自动脱敏不能替代人工复核。单个状态或案例不能升级为稳定方法,只有多个独立案例出现相近场景、动作与结果并通过许可、隐私、反例与副作用检查,才可由维护者人工提炼。