actually-written

中文文档
0.1.12发布于 2026/11/03MITTypeScriptES Module零依赖

记录表格上的答案是如何写的,然后检查每个提交的书面证据。

中文使用文档
文档目录4 节
  1. 反应
  2. JavaScript提交
  3. 链接录音
  4. 隐私

写

记录表格上的答案是如何写出来的。检视已记录的意见书 https://actuallywritten.com/submissions.

npm install actually-written
import { track } from "actually-written";

track(document.querySelector("form"), { key: "aw_pk_…" });

获取您的公钥 https://actuallywritten.com/keys. 承诺是安全的。

SDK将录音直接发送到actual Written进行评分和审查。不需要自定义上传服务器或提供程序集成。

一个可选的 <div class="actually-written-badge"></div> 在表格里面,人们可以看到他们写的东西被记录了下来。

录音在后台上传。原生提交、按钮和导航保持不变。

反应

开始追踪mount并呼叫返回者 session.stop() 在卸载。如果您自己处理提交,请将会话保存在ref中并遵循下面的JavaScript说明。

JavaScript提交

保留返回的会话 track()。呼叫 void session.submit() 在重置或导航之前,在现有的最终提交处理程序中。保留现有的验证和应用程序节省逻辑。永远不要让表单提交依赖于记录的成功。

在后台重试上传。反复打电话给 submit() 重试相同的冻结记录。

存储隐藏的 actually_written_session 字段。对于JSON有效负载,使用current session.id. 调用 form.reset() 为下一个应用程序启动一个新会话。

记录交付

草稿和新编辑定期上传。一个小的提交标记独立于挂起的历史记录发送。会议在提交之前是一份草案。服务器只计算一次提交,并评估收到的证据。

submit() 仍然返回诊断的交付承诺。不要在表单的提交流中等待它。关闭浏览器或失去连接可能会留下不完整的证据;申请仍然可以正常提交。

隐私

在填写表单时,将上传草稿答案和编辑历史记录,包括放弃的表单。在你的隐私声明中告诉别人关于录音的事情。最终答案、行为计数器和编辑历史将随提交一起保留。提交历史不包括在写入数据训练输出中。

完整的文档: https://actuallywritten.com/docs

版本与发布记录

actually-written 共发布 14 个版本,首次发布于 2026/10/23;过去 12 个月发布了 14 个版本。

版本发布日期距今
0.1.12latest2026/11/03今天
0.1.112026/11/03今天
0.1.102026/11/021 天前
0.1.92026/10/313 天前
0.1.82026/10/304 天前
0.1.72026/10/304 天前

关于 actually-written 的常见问题

actually-written 是什么?

记录表格上的答案是如何写的,然后检查每个提交的书面证据。

如何安装 actually-written?

在项目目录运行 npm install actually-written,或使用 pnpm add / yarn add / bun add。

actually-written 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

actually-written 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

actually-written 可以商用吗?

actually-written 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

actually-written 还在维护吗?

最新版本 0.1.12 发布于 2026/11/03(今天);至今共发布 14 个版本,其中过去 12 个月发布了 14 个;首次发布于 2026/10/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。